module.yaml

name: accounting
version: 1.0.0
description: Datafund accounting integration with e-racuni.com - financial overview, invoice tracking, payment planning, and spend analysis

author: datafund
repository: https://github.com/datafund/module-accounting
license: MIT

# Required dependencies
dependencies:
  - core@>=1.0.0

# Optional integrations
optional:
  - gtd  # Integrate with GTD workflow via :AI:accounting: tags

# What this module provides
provides:
  commands:
    - accounting              # Single entry point - routes to agents

  agents:
    - accounting-sync         # Pull latest data from e-racuni API
    - accounting-overview     # Financial snapshot (balances, receivables, payables)
    - pending-payments        # Outstanding invoices grouped by vendor
    - payment-planner         # Payment prioritization suggestions
    - spend-analyzer          # Spend analysis by cost center/category/project
    - invoice-classifier      # Classify paid invoices for analysis

# API integrations
integrations:
  - name: e-racuni
    description: e-racuni.com accounting software API (Slovenia)
    required_env:
      - ERACUNI_USERNAME
      - ERACUNI_SECRET_KEY
      - ERACUNI_ORG_TOKEN
    optional_env:
      - ERACUNI_ENDPOINT  # Defaults to https://e-racuni.com/WebServicesSI/API

# Output locations (relative to space root)
outputs:
  balances: knowledge/accounting/balances.json
  invoices: knowledge/accounting/invoices/
  payables: knowledge/accounting/payables/
  vendors: knowledge/accounting/vendors/
  analysis: knowledge/accounting/analysis/
  sync_log: knowledge/accounting/sync-log.json

# Personal settings integration
settings:
  daily:
    include_accounting:
      enabled: false  # Opt-in, configured in personal settings.local.yaml
      description: Include financial summary in /today briefing