13 Commits

Author SHA1 Message Date
5693d7b451 Add year-end tax report queries for period-specific reporting
Adds date-parameterized SQL queries for Income Statement, Expense
Detail, Vendor Payment Summary, and General Ledger. These filter
TransactionLines by date range instead of using cumulative balances,
enabling tax year and other period-specific financial reports.
2026-02-22 18:26:19 -05:00
fdb813d647 Add bank reconciliation workflow and templates
New capability for importing bank transactions (Schwab JSON), matching
against existing ledger entries, creating missing transactions, and
reconciling balances. Includes two new Grist tables (Reconciliations,
BankRules), two bank-import templates, and reference documentation.
2026-02-19 20:26:48 -05:00
357d1aadc8 Add JSON templates for transaction entry
Introduces templates/ directory with pre-built record structures that only
include writable fields, preventing 400 errors from formula column writes.

Templates:
- bill-paid-credit-card.json: Invoice paid by business credit card
- bill-paid-owner.json: Invoice paid by owner (reimbursement)
- bill-paid-checking.json: Invoice paid from checking account
- bill-unpaid.json: Invoice recorded but not yet paid
- pay-existing-bill.json: Payment for existing open bill
- direct-expense.json: Bank fees and minor expenses

Also adds references/templates.md usage guide and updates SKILL.md with
template references and formula column warnings.
2026-01-14 19:16:28 -05:00
c53f533d2b Add schema reference and sample payloads to workflows
- Add note to consult schema.md for writable fields before add_records
- Add sample JSON payloads for common transactions:
  - Owner equity contribution
  - Owner draw
  - Direct expense (no bill)
  - Revenue receipt
- Include quick reference table for key account IDs
2026-01-14 18:04:37 -05:00
4ebc19408c Add audit subagent and restructure skill for progressive disclosure
- Add audit subagent that runs automatically after bill entries
- Create download-attachment.sh for retrieving invoice/receipt PDFs
- Create verify-pdf.py for PDF extraction with OCR fallback
- Restructure SKILL.md from 856 to 177 lines using reference files
- Move detailed content to references/:
  - schema.md: table schemas
  - workflows.md: code examples
  - queries.md: SQL queries and financial reports
  - audit.md: audit queries and remediation steps
2026-01-12 12:45:32 -05:00
70ac6be681 Add decision guide for when to create Bills vs Transactions
Adds a quick-reference section near the top of the skill that clarifies:
- Invoice/bill PDFs should always create Bill records
- Receipts attach to existing Bills via BillPayment
- Bank entries and journal adjustments are Transaction-only

Includes step-by-step checklist for common "vendor invoice paid by owner" workflow.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-11 21:46:34 -05:00
a83f436a08 Split Attachment column into Invoice and Receipt fields
- Add separate Invoice and Receipt columns to Bills table for clearer
  document organization
- Update upload-attachment.sh to accept column parameter (defaults to
  Invoice, use Receipt for payment confirmations)
- Update all documentation examples and workflows
- Add receipt upload step to payment workflows
- Update validation checklist to verify both fields

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-04 21:11:04 -05:00
e468c5bc3b Document invoice attachment uploads in bill entry workflow
- Add Step 5 to bill entry: upload invoice attachment if available
- Add batch attachment upload guidance to Batch Operations
- Add validation checklist item for missing attachments
- Add common mistake entry for missing invoice attachments
2026-01-03 21:20:05 -05:00
3c8444dc0c Add financial reports section with balance sheet, income statement, trial balance, and AP aging
Includes queries that properly handle parent-child account hierarchy to avoid double-counting balances.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-03 21:07:04 -05:00
aa528d2843 Extract upload-attachment script to separate file
- Move embedded bash script to scripts/upload-attachment.sh
- Update SKILL.md to reference external script with usage examples
- Follows skill best practice: separate reusable tools from documentation
2026-01-03 20:36:23 -05:00
7002060aa5 docs: add attachment upload workflow and script 2026-01-03 20:32:06 -05:00
9dd2000aec Expand skill with complete schemas, workflows, and examples
- Add MCP tools reference with actual tool names
- Document Unix timestamp requirement for dates
- Add complete table schemas for all 8 tables
- Add key account IDs quick reference
- Add step-by-step workflows for bill entry, payments, owner reimbursements
- Add batch operations guidance for efficient multi-record entry
- Add common SQL queries for reporting
- Add validation checklist and expanded common mistakes
2026-01-03 19:20:34 -05:00
32d7da4f5e Initial commit: Grist double-entry accounting skill 2026-01-03 17:06:48 -05:00