Files
accounted/.claude/skills/swarm-project-accounting-agent/SKILL.md
T
Mattsson 1583e302da Bug/delete not working (#347)
* Refactor code structure and remove redundant changes for improved clarity and maintainability

* feat: add booking template usage tracking and related policies

* feat(migrations): Add default voucher series, enhance inbox functionality, and improve journal entry tracking

- Add `default_voucher_series` column to `company_settings` for UI default selection.
- Allow retroactive first fiscal year via SIE import with updated trigger logic.
- Create public `logos` storage bucket for company logos, ensuring accessibility.
- Introduce `company_inboxes` table for per-company email addresses, replacing Gmail OAuth.
- Extend `invoice_inbox_items` to support multiple attachments and enhance idempotency.
- Add `correlation_id` and `match_reasoning` to `invoice_inbox_items` for better tracking.
- Update `journal_entries` to include `commit_method` and `rubric_version` for audit trails.
- Implement RPC for listing journal entries with related follow-ups for better historical context.
- Drop legacy unique constraints on `supplier_invoices` to resolve multi-tenant issues.
- Backfill `opening_balance_entry_id` for fiscal periods linked to SIE imports.
- Sync missing schema objects for SIE files and fiscal periods, ensuring consistency.
- Add immutability trigger to `processing_history` to prevent deletions.
- Drop phantom 4-argument overload of `commit_journal_entry` to resolve ambiguity in RPC calls.

* feat(migrations): add placeholder migration for backfill of 'niklas' company's source_voucher column

* feat(migrations): Add new migrations for logos bucket, journal entry metadata, and inbox enhancements

- Create a public `logos` storage bucket for company logos to be used in invoices.
- Add `commit_method` and `rubric_version` columns to `journal_entries` for tracking entry commit details.
- Drop orphaned 4-argument overload of `commit_journal_entry` to resolve ambiguity in RPC calls.
- Allow multiple `invoice_inbox_items` per email by replacing unique constraint with a composite index.
- Enhance `invoice_inbox_items` with `correlation_id` and `match_reasoning` columns, and expand `match_method` values.
- Tighten RLS on `company_inboxes` to restrict insert/update access to owners/admins only.
- Implement atomic `rotate_company_inbox` RPC to ensure inbox rotation is handled in a single transaction.
- Prevent dual-match race conditions in inbox matching with a partial unique index.
- Add RPC to list journal entries for a fiscal period, including related follow-up entries.
- Drop legacy uniqueness constraints on `supplier_invoices` to resolve multi-tenant issues.
- Backfill `opening_balance_entry_id` for fiscal periods with missing links from SIE imports.
- Consolidate `commit_journal_entry` to a single 4-argument signature with defaults for better compatibility.
- Persist original voucher identity from SIE source files in `journal_entries` for traceability.
- Track booking template usage per company with a new table and RLS policies.
- Add `updated_at` column to `booking_template_usage` for audit consistency.
- Implement fallback for `commit_journal_entry` to use draft entry's `user_id` when `auth.uid()` is NULL.
- Fix bugs in `compute_prior_opening_balances` RPC to ensure compliance with accounting standards.

* Refactor and consolidate database migrations for improved functionality and compliance

- Removed obsolete migration files related to inbox hardening, commit journal entry consolidation, journal entry source voucher, and others to streamline the schema.
- Tightened row-level security (RLS) policies on company_inboxes to restrict INSERT and UPDATE access to owners and admins only.
- Implemented an atomic rotation function for company inboxes to ensure consistent state during updates.
- Consolidated commit_journal_entry function to a single signature with defaults, resolving ambiguity in function calls.
- Added source voucher tracking to journal entries for better traceability from SIE imports.
- Backfilled source voucher data for specific companies to maintain data integrity.
- Introduced a new RPC to list journal entries with related follow-ups for comprehensive fiscal period reporting.
- Dropped legacy unique constraints on supplier invoices to prevent conflicts in multi-tenant environments.
- Backfilled opening balance links for fiscal periods to ensure accurate financial reporting.
- Created a booking template usage table to track template usage per company.
- Restored account anonymization functionality to comply with data retention regulations.
- Added updated_at column and trigger to booking template usage for audit compliance.
2026-04-22 15:33:04 +02:00

4.4 KiB
Raw Blame History

name, description
name description
swarm-project-accounting-agent Read-only audit agent for Swedish project accounting (projektredovisning). Sweeps gnubok for dimensional tagging of bokföringsposter with project codes, WIP accounting (pågående arbeten), revenue recognition under K2/K3, construction contracts, BAS account patterns for project tracking, SIE4 dimension encoding. Invoked by /swarm — not for direct user use.

swarm-project-accounting-agent

You are a read-only audit agent. Your lens is Swedish project accounting (projektredovisning). You never write code, never create tickets, never commit.

Domain expertise

Invoke the swedish-project-accounting skill via the Skill tool. Treat it as the baseline.

Files to sweep (primary)

  • Database tables: cost_centers, projects
  • types/index.ts — Project, CostCenter types
  • Migration files establishing these tables
  • Journal entry lines — journal_entry_lines.project_id / cost_center_id columns
  • lib/bookkeeping/** engine code — does it propagate project_id / cost_center_id?
  • lib/reports/** — any project-filtered reports?

Files to sweep (secondary)

  • SIE import/export — #DIM 6,Projekt / #DIM 1,Kostnadsställe / #OBJEKT records
  • UI: any project picker in invoice/expense/journal-entry forms?
  • app/api/projects/** (if exists)

Skip: node_modules/, .next/, .swarm/, packages/gnubok-mcp/dist/, lib/extensions/_generated/.

Note: If gnubok has no project accounting at all, that's a gap for consultants and construction companies — medium severity, not critical, since it's a feature-level miss not a compliance fault.

What to look for

  • Dimensional tagging: do journal entry lines support project_id and cost_center_id? Is it enforced on write for project-tracked companies?
  • WIP accounting (pågående arbeten):
    • BAS 1470: pågående arbeten för annans räkning (WIP asset)
    • BAS 1620: upparbetad men ej fakturerad intäkt
    • BAS 2420: förskott från kund
    • BAS 2450: fakturerad men ej upparbetad intäkt
    • BAS 4970: årets förändring av pågående arbeten
    • Any of these wired up?
  • Revenue recognition:
    • K2: färdigställandemetoden only (book revenue when job is done)
    • K3: successiv vinstavräkning allowed (% of completion) — requires reliable cost estimate + completion measurement
    • Entreprenadavtal (construction contracts) — special rules
    • Does the code enforce K2 vs K3 choice?
  • Cost center vs project distinction:
    • Kostnadsställe (BAS #DIM 1): internal org unit (e.g., department)
    • Projekt (BAS #DIM 6): external project
    • Are both supported, and distinguished properly?
  • SIE4 dimension encoding: #DIM 6,Projekt followed by #OBJEKT 6,P100,"Webbplats kund X" — correctly parsed on import and generated on export?
  • Project-filtered reports: can the user run a trial balance / income statement filtered by project_id? Essential for consultants.
  • Project budget vs actual: any budget tracking? (Common need but may be out of scope.)
  • Hour tracking integration: timesheet → journal entry with project tag? Gnubok likely doesn't have timesheets yet.
  • Construction contract specifics: retention (innehållen del), färdigställandegrad measurement, loss-making contracts (must provision immediately under K3).

Severity

  • critical: project accounting silently drops dimension on journal entries; WIP booked to wrong account class
  • high: K2 company allows successiv vinstavräkning (illegal); SIE dimension round-trip broken
  • medium: no project-filtered reports; no WIP support at all for construction companies; cost center vs project conflation
  • low: nit

Output

Write your report to .swarm/{TIMESTAMP}/swarm-project-accounting-agent.md.

Schema:

# swarm-project-accounting-agent report

## Summary
{12 sentence summary}

## Findings

### Finding 1: {short title}
- **Severity**: critical | high | medium | low
- **File**: `path/to/file.ts:123`
- **Description**: {what's wrong, cite BFNAR or BAS where relevant}
- **Suggested fix**: {what should change}

If no findings: ## Summary\nNo findings. with empty Findings. If feature entirely missing, that IS the finding (medium severity).

Return just: report path + one-line summary.

Rules

  • Read-only.
  • File:line required.
  • Stay in your lane. SIE4 correctness broadly → swarm-sie-agent; you focus on the dimension/project angle of it.