name: Share/ETF Investor
layer: additional
description: |
  Share and ETF portfolio tracking with dividend income and CGT events.
  Includes franking credit extraction and wash sale detection.

categories:
  - name: "Dividends:Franked"
    parent: null
    description: "Fully franked dividend income"

  - name: "Dividends:Unfranked"
    parent: null
    description: "Unfranked dividend income"

  - name: "Share Sales"
    parent: null
    description: "Capital gains/losses from share sales"

  - name: "Brokerage Fees"
    parent: null
    description: "Trading and brokerage fees"

rules:
  - id: franked-dividends
    pattern: "dividend.*franked|franking.*credit|DRP|dividend.*reinvestment"
    category: "Dividends:Franked"
    confidence: high
    labels: ["Franked Dividend"]
    description: "Detect franked dividend payments"

  - id: unfranked-dividends
    pattern: "dividend.*unfranked|distribution.*trust"
    category: "Dividends:Unfranked"
    confidence: high
    description: "Detect unfranked dividend payments"

  - id: share-sale
    pattern: "share.*sale|stock.*sale|sold.*shares|CGT.*event"
    category: "Share Sales"
    confidence: medium
    labels: ["Capital Gain"]
    description: "Detect share sale transactions (CGT event)"

  - id: brokerage
    pattern: "CommSec|SelfWealth|Stake|brokerage|trading.*fee"
    category: "Brokerage Fees"
    confidence: high
    labels: ["Tax Deductible"]
    description: "Detect brokerage and trading fees"

tax_tracking:
  dividend_tracking: true
  franking_credit_extraction: true
  cgt_tracking: true
  cgt_discount_eligible: true
  cgt_discount_holding_period: 365
  wash_sale_detection: true
  wash_sale_period: 30

alerts:
  - type: dividend_income_summary
    schedule: quarterly
    message: "Quarterly dividend income summary with franking credits"

  - type: cgt_event_detected
    trigger: share_sale_detected
    message: "Share sale detected - track CGT event and holding period"

  - type: wash_sale_warning
    trigger: repurchase_within_30_days
    message: "Warning: Share repurchased within 30 days - potential wash sale"

labels:
  - name: "Tax Deductible"
    description: "Share trading expense claimable"
    color: "green"
    auto_apply: false

  - name: "Capital Gain"
    description: "Capital gains event (CGT applicable)"
    color: "gold"
    auto_apply: true

  - name: "Capital Loss"
    description: "Capital loss (offset against gains)"
    color: "brown"
    auto_apply: false

  - name: "Franked Dividend"
    description: "Dividend with franking credits attached"
    color: "teal"
    auto_apply: true

dependencies:
  requires: []
  conflicts_with: []

metadata:
  created: "2025-11-22"
  version: "1.0.0"
  author: "Agent Smith"
  priority: 3