Update to Briefcase

{
  "name": "ledger-reports",
  "description": "Read and explain a Briefcase Ledger client's profit and loss, balance sheet, aged creditors and aged debtors, compare periods, and drill from a report line into the journals and source documents behind it. Use when the user asks how a client is doing, what makes up a balance, why a figure moved, or who owes or is owed money.",
  "included_files": [],
  "skill_md_contents": "---\nname: ledger-reports\ndescription: Read and explain a Briefcase Ledger client's profit and loss, balance sheet, aged creditors and aged debtors, compare periods, and drill from a report line into the journals and source documents behind it. Use when the user asks how a client is doing, what makes up a balance, why a figure moved, or who owes or is owed money.\n---\n\n# Ledger reports in Briefcase\n\nThese tools only work for Briefcase Ledger clients. Check `ledger_type` from `briefcase_list_clients` or `briefcase_get_client`; for a Xero or QuickBooks client they return `UNSUPPORTED_CAPABILITY`, so tell the user to read the reports in that ledger instead. Everything here needs the Ledger view permission; `FORBIDDEN` means the user lacks it.\n\n## Pick the report\n\n- **Profit and loss:** `briefcase_get_profit_and_loss` with `start_date` and `end_date`. Add `comparison_start_date` and `comparison_end_date` for \"this month against last month\" or \"this year against last year\". Filter with `business_id` or `property_id` only when the user asks about one business or property (`briefcase_get_reference_data` with `kind: businesses` or `properties`).\n- **Balance sheet:** `briefcase_get_balance_sheet` with `as_at` (defaults to today) and optionally `comparison_as_at`. Retained earnings is the profit to date shown within equity, so `total_equity` equals `net_assets`.\n- **Aged creditors or debtors:** `briefcase_get_aged_report` with `subledger: ACCOUNTS_PAYABLE` (creditors) or `ACCOUNTS_RECEIVABLE` (debtors) and `as_at`. Totals cover every contact; contacts come largest balance first, 25 per page with up to 10 invoices each. Page with `after` for more contacts, and set `contact_id` to see one contact's invoices in full.\n\nResolve relative periods (\"last quarter\", \"year to date\") to explicit dates, and say which dates you used. Ask for the financial year end when the user says \"this year\" and it matters.\n\n## Report the numbers faithfully\n\n- Amounts are decimal strings in the report's `currency`. Quote them as returned and follow the `sign_convention` in each result; do not recompute totals or re-sign figures.\n- Accounts with no movement or a zero balance are left out, so an account missing from the list means it is nil for that range.\n- Lead with the few lines that explain the answer (largest movements, biggest balances, oldest debts) rather than reading out every account.\n\n## Drill down\n\n1. Take the account `id` from a report line.\n2. `briefcase_list_journals` with `account_id` and the same date range shows that account's activity; its `debit`, `credit` and `totals` cover that account only.\n3. `briefcase_get_journal` for one entry shows every line and `source_links`, such as `sales_invoice_id` or `transaction_id`. Follow them with `briefcase_get_sales_invoice` or `briefcase_get_transaction`.\n\nFor an aged report line, the invoice `source` tells you which tool opens it (`SALES_INVOICE` → `briefcase_get_sales_invoice`, `TRANSACTION` → `briefcase_get_transaction`).\n\n## Limits\n\nThese reports read Briefcase's own ledger. There is no trial balance, VAT return or bank reconciliation tool; point the user to the Briefcase app for those. For how-to questions about the reports, use `briefcase_search_help` rather than guessing.\n"
}