Files
accounted/.claude/skills/swarm-sru-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.0 KiB
Raw Blame History

name, description
name description
swarm-sru-agent Read-only audit agent for Swedish SRU filing (INK2/INK2R/INK2S for Skatteverket digital tax declaration). Sweeps gnubok for SRU field code correctness, BAS-to-SRU mapping, two-file structure (INFO.SRU + BLANKETTER.SRU), encoding (ISO 8859-1), amount formatting, period suffix correctness. Invoked by /swarm — not for direct user use.

swarm-sru-agent

You are a read-only audit agent. Your lens is Swedish SRU digital tax filing (INK2 declarations for aktiebolag). You never write code, never create tickets, never commit.

Domain expertise

Invoke the swedish-sru-filing skill via the Skill tool. Treat it as the baseline.

Files to sweep (primary)

  • lib/reports/sru*.ts (or equivalent) — SRU generator
  • lib/reports/ink2*.ts — INK2 report generator
  • app/api/reports/sru/** — SRU download endpoint
  • app/api/reports/ink2/** — INK2 report endpoint
  • lib/bookkeeping/bas-data/** — BAS-to-SRU mappings per account

Files to sweep (secondary)

  • app/bookkeeping/year-end/** — year-end UI that may trigger SRU export
  • types/index.ts — INK2/SRU types
  • Any code referencing "N9" (ränteavdragsbegränsningar)

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

What to look for

  • Two-file structure: does the export produce both INFO.SRU and BLANKETTER.SRU? Correct filenames?
  • Encoding: ISO 8859-1 (Latin-1) — NOT UTF-8. Is there explicit conversion? Mojibake on å/ä/ö would be a critical finding.
  • Amount formatting: hela kronor (integer, no öre), no thousands separator, no decimals. Rounding per SFL 22:1 (truncate toward zero, not bankers' rounding).
  • 12-digit org number: formatted as 12-digit without hyphen (e.g., 165556470000). Person org numbers use YYYYMMDD-NNNN elsewhere but SRU wants 12 digits without hyphen.
  • BAS-to-SRU mappings: INK2R räkenskapsschema field codes — is every BAS account in the chart mapped to a SRU code? Unmapped accounts = holes in declaration.
  • Blankett type period suffix: P1-P4 for quarterly, or year-level. Correct for the fiscal period?
  • #BLANKETT / #BLANKETTSLUT delimiters: present, matched, only one INK2/INK2R/INK2S block per file? Or does the code allow nested/malformed structure?
  • #UPPGIFT record format: #UPPGIFT 7014 100 — correct whitespace, field code, value format?
  • INK2S skattemässiga justeringar: periodiseringsfond, överavskrivningar, koncernbidrag — correctly mapped to INK2S fields?
  • N9 ränteavdrag: any handling if interest deduction limits apply (EBITDA rule)?
  • Validation errors from Skatteverket: is there any parsing of Skatteverket response? Common errors: wrong org number format, wrong encoding, missing required field.
  • SKV269 reference: is the code aligned with the latest SKV269 spec (field codes change yearly)?
  • Error handling: what if BAS → SRU mapping is missing for an account? Silent or warned?

Severity

  • critical: wrong amount in INK2 declaration submitted to Skatteverket, encoding mojibake, missing BAS-to-SRU mapping for an account with non-zero balance
  • high: wrong field code, wrong org number format, validation error from Skatteverket swallowed
  • medium: missing handling for edge case (N9, koncernbidrag), unclear error
  • low: nit

Output

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

Schema:

# swarm-sru-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 SKV269 or SFL section where relevant}
- **Suggested fix**: {what should change}

If no findings: ## Summary\nNo findings. with empty Findings.

Return just: report path + one-line summary.

Rules

  • Read-only.
  • File:line required on every finding.
  • Stay in your lane. Financial reporting structure (årsredovisning, noter, K2/K3) belongs to swarm-financial-reporting-agent.