jaz-cli 2.5.0 → 2.6.0

package/assets/skills/api/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: api
-version: 2.5.0
+version: 2.6.0
 description: Complete reference for the Jaz/Juan REST API — the accounting platform backend. Use this skill whenever building, modifying, debugging, or extending any code that calls the API — including API clients, integrations, data seeding, test data, or new endpoint work. Contains every field name, response shape, error, gotcha, and edge case discovered through live production testing.
 license: MIT
 compatibility: Requires Jaz/Juan API key (x-jk-api-key header). Works with Claude Code, Claude Cowork, Claude.ai, and any agent that reads markdown.

package/assets/skills/api/references/feature-glossary.md

@@ -66,7 +66,7 @@ There is no dedicated `/deposits` endpoint (returns 404). Deposits are managed t
 
 Manual accounting entries for non-payment transactions. Three types: Manual Journals (multi-line debit/credit entries), Cash Journals (2-line cash transfers between bank accounts with cross-currency support), and Transfer Journals (year-end trial balance transfers, non-editable).
 
-Manual journals support multi-currency — set `currency: { sourceCurrency: "USD" }` (same object form as invoices/bills) to create a journal in a foreign currency. Omit for base currency. Foreign currency journal restrictions: (1) no controlled accounts (AR/AP — use invoices/bills instead), (2) no FX system accounts (Unrealized Gain/Loss/Rounding), (3) bank accounts must match the journal's currency (e.g., USD journal → USD bank only).
+Manual journals support multi-currency — the entire journal can be in the org's base currency or any enabled foreign currency. Foreign currency journal restrictions: (1) no controlled accounts (AR/AP — use invoices/bills instead), (2) no FX system accounts (Unrealized Gain/Loss/Rounding), (3) bank accounts must match the journal's currency (e.g., USD journal → USD bank only).
 
 Minimum 2 balanced entries required. Cash journals are restricted to exactly 2 lines. Bank/cash/current asset/equity/liability accounts cannot have tax profiles applied. Supports scheduled/recurring journals with dynamic scheduler strings (`{{YEAR}}`, `{{MONTH}}`).
 

package/assets/skills/conversion/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: conversion
-version: 2.5.0
+version: 2.6.0
 description: Accounting data conversion skill — migrates customer data from Xero, QuickBooks, Sage, MYOB, and Excel exports to Jaz. Covers config, quick, and full conversion workflows, Excel parsing, CoA/contact/tax/items mapping, clearing accounts, TTB, and TB verification.
 ---
 

package/assets/skills/transaction-recipes/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: transaction-recipes
-version: 2.5.0
-description: 13 IFRS-compliant recipes for modeling complex multi-step accounting scenarios in Jaz — from prepaid amortization and loan schedules to FX revaluation, ECL provisioning, dividend declarations, and intercompany transactions. Each recipe includes journal entries, capsule structure, and verification steps. Paired with 8 financial calculators that produce execution-ready blueprints.
+version: 2.6.0
+description: 16 IFRS-compliant recipes for complex multi-step accounting in Jaz — prepaid amortization, deferred revenue, loan schedules, IFRS 16 leases, hire purchase, fixed deposits, asset disposal, FX revaluation, ECL provisioning, IAS 37 provisions, dividends, intercompany, and capital WIP. Each recipe includes journal entries, capsule structure, and verification steps. Paired with 10 financial calculators that produce execution-ready blueprints with workings.
 license: MIT
 compatibility: Works with Claude Code, Claude Cowork, Claude.ai, and any agent that reads markdown. For API payloads, load the jaz-api skill alongside this one.
 ---
@@ -17,7 +17,10 @@ You are modeling **complex multi-step accounting scenarios** in Jaz — transact
 - Setting up prepaid expenses, deferred revenue, or accrued liabilities
 - Modeling loan repayment schedules with amortization tables
 - Implementing IFRS 16 lease accounting (right-of-use assets + lease liabilities)
+- Recording hire purchase agreements (ownership transfers, depreciate over useful life)
 - Recording depreciation using methods Jaz doesn't natively support (declining balance, 150DB)
+- Managing fixed deposit placements with interest accrual schedules (IFRS 9)
+- Disposing of fixed assets — sale, scrap, or write-off with gain/loss calculation (IAS 16)
 - FX revaluation of non-AR/AP monetary items at period-end (IAS 21)
 - Calculating expected credit loss provisions on aged receivables (IFRS 9)
 - Accruing employee leave and bonus obligations (IAS 19)
@@ -61,7 +64,10 @@ Jaz schedulers generate **fixed-amount** recurring entries. This determines whic
 | Declining Balance | Manual journals + capsule | Depreciation changes as book value reduces |
 | FX Revaluation | Manual journals + capsule | Rates change each period |
 | ECL Provision | Manual journals + capsule | Receivables and rates change each quarter |
-| Provisions (IAS 37) | Manual journals + capsule | Unwinding amount changes each month |
+| Fixed Deposit | Cash-out + manual journals + cash-in + capsule | Placement, monthly accruals, maturity |
+| Hire Purchase | Manual journals + FA registration + capsule | Like IFRS 16 but depreciate over useful life |
+| Asset Disposal | Manual journal + FA deregistration | One-off compound entry + FA update |
+| Provisions (IAS 37) | Manual journals + cash-out + capsule | Unwinding amount changes each month |
 | Bonus Accrual | Manual journals + capsule | Revenue/profit changes each quarter |
 | Dividends | Manual journals + capsule | One-off: declaration + payment |
 | Intercompany | Invoices/bills + capsule | Mirrored entries in two entities |
@@ -87,23 +93,29 @@ Each recipe includes: scenario description, accounts involved, journal entries,
 
 6. **[Declining Balance Depreciation](references/declining-balance.md)** — DDB/150DB methods with switch-to-straight-line logic, for assets where Jaz's native SL isn't appropriate.
 
+7. **[Fixed Deposit](references/fixed-deposit.md)** — Placement, monthly interest accrual (simple or compound), and maturity settlement. IFRS 9 amortized cost. *Paired calculator: `jaz calc fixed-deposit`*
+
+8. **[Hire Purchase](references/hire-purchase.md)** — Like IFRS 16 lease but ownership transfers — ROU depreciation over useful life (not lease term). *Paired calculator: `jaz calc lease --useful-life <months>`*
+
+9. **[Asset Disposal](references/asset-disposal.md)** — Sale at gain, sale at loss, or scrap/write-off. Computes accumulated depreciation to disposal date and gain/loss. *Paired calculator: `jaz calc asset-disposal`*
+
 ### Tier 3 — Month-End Close Recipes
 
-7. **[FX Revaluation — Non-AR/AP Items](references/fx-revaluation.md)** — IAS 21 revaluation of non-AR/AP foreign currency monetary items (intercompany loans, term deposits, FX provisions) with Day 1 reversal. *Paired calculator: `jaz calc fx-reval`*
+10. **[FX Revaluation — Non-AR/AP Items](references/fx-revaluation.md)** — IAS 21 revaluation of non-AR/AP foreign currency monetary items (intercompany loans, term deposits, FX provisions) with Day 1 reversal. *Paired calculator: `jaz calc fx-reval`*
 
-8. **[Bad Debt Provision / ECL](references/bad-debt-provision.md)** — IFRS 9 simplified approach provision matrix using aged receivables and historical loss rates. *Paired calculator: `jaz calc ecl`*
+11. **[Bad Debt Provision / ECL](references/bad-debt-provision.md)** — IFRS 9 simplified approach provision matrix using aged receivables and historical loss rates. *Paired calculator: `jaz calc ecl`*
 
-9. **[Employee Benefit Accruals](references/employee-accruals.md)** — IAS 19 leave accrual (scheduler, fixed monthly) and bonus accrual (manual journals, variable quarterly) with year-end true-up.
+12. **[Employee Benefit Accruals](references/employee-accruals.md)** — IAS 19 leave accrual (scheduler, fixed monthly) and bonus accrual (manual journals, variable quarterly) with year-end true-up.
 
 ### Tier 4 — Corporate Events & Structures
 
-10. **[Provisions with PV Unwinding](references/provisions.md)** — IAS 37 provision recognized at PV, with monthly discount unwinding schedule. For warranties, legal claims, decommissioning, restructuring. *Paired calculator: `jaz calc provision`*
+13. **[Provisions with PV Unwinding](references/provisions.md)** — IAS 37 provision recognized at PV, with monthly discount unwinding schedule. For warranties, legal claims, decommissioning, restructuring. *Paired calculator: `jaz calc provision`*
 
-11. **[Dividend Declaration & Payment](references/dividend.md)** — Board-declared dividend: two journals (declaration reducing retained earnings, then payment).
+14. **[Dividend Declaration & Payment](references/dividend.md)** — Board-declared dividend: two journals (declaration reducing retained earnings, then payment).
 
-12. **[Intercompany Transactions](references/intercompany.md)** — Mirrored invoices/bills or journals across two Jaz entities with matching intercompany reference, quarterly settlement.
+15. **[Intercompany Transactions](references/intercompany.md)** — Mirrored invoices/bills or journals across two Jaz entities with matching intercompany reference, quarterly settlement.
 
-13. **[Capital WIP to Fixed Asset](references/capital-wip.md)** — Cost accumulation in CIP account during construction/development, transfer to FA on completion, auto-depreciation via Jaz FA module.
+16. **[Capital WIP to Fixed Asset](references/capital-wip.md)** — Cost accumulation in CIP account during construction/development, transfer to FA on completion, auto-depreciation via Jaz FA module.
 
 ## How to Use These Recipes
 
@@ -118,19 +130,22 @@ Each recipe includes: scenario description, accounts involved, journal entries,
 
 ## Financial Calculators (CLI)
 
-The `jaz-cli` includes 8 IFRS-compliant financial calculators. Each produces a formatted schedule table with per-period journal entries. Use `--json` for structured output with a complete **blueprint** — an execution plan containing capsule type, name, tags, custom fields, and every journal entry with dates, accounts, and amounts.
+The `jaz-cli` includes 10 IFRS-compliant financial calculators. Each produces a formatted schedule + per-period journal entries + human-readable workings. Use `--json` for structured output with a complete **blueprint** — capsule type/name, tags, custom fields, workings (capsuleDescription), and every step with action type, date, accounts, and amounts.
 
-All calculators support `--currency <code>` for currency labeling and `--json` for agent-parseable output.
+All calculators support `--currency <code>` and `--json`.
 
 ```bash
 # ── Tier 2 Calculators ──────────────────────────────────────────
 
-# Loan amortization schedule (PMT, interest/principal split)
+# Loan amortization (PMT, interest/principal split)
 jaz calc loan --principal 100000 --rate 6 --term 60 [--start-date 2025-01-01] [--currency SGD] [--json]
 
 # IFRS 16 lease (PV, liability unwinding, ROU depreciation)
 jaz calc lease --payment 5000 --term 36 --rate 5 [--start-date 2025-01-01] [--currency SGD] [--json]
 
+# Hire purchase (lease + ownership transfer — depreciate over useful life)
+jaz calc lease --payment 5000 --term 36 --rate 5 --useful-life 60 [--start-date 2025-01-01] [--currency SGD] [--json]
+
 # Depreciation (DDB, 150DB, or straight-line)
 jaz calc depreciation --cost 50000 --salvage 5000 --life 5 [--method ddb|150db|sl] [--frequency annual|monthly] [--currency SGD] [--json]
 
@@ -140,6 +155,12 @@ jaz calc prepaid-expense --amount 12000 --periods 12 [--frequency monthly|quarte
 # Deferred revenue recognition
 jaz calc deferred-revenue --amount 36000 --periods 12 [--frequency monthly|quarterly] [--start-date 2025-01-01] [--currency SGD] [--json]
 
+# Fixed deposit — simple or compound interest accrual (IFRS 9)
+jaz calc fixed-deposit --principal 100000 --rate 3.5 --term 12 [--compound monthly|quarterly|annually] [--start-date 2025-01-01] [--currency SGD] [--json]
+
+# Asset disposal — gain/loss on sale or scrap (IAS 16)
+jaz calc asset-disposal --cost 50000 --salvage 5000 --life 5 --acquired 2022-01-01 --disposed 2025-06-15 --proceeds 20000 [--method sl|ddb|150db] [--currency SGD] [--json]
+
 # ── Tier 3 Calculators ──────────────────────────────────────────
 
 # FX revaluation — unrealized gain/loss on non-AR/AP items (IAS 21)
@@ -156,7 +177,7 @@ jaz calc provision --amount 500000 --rate 4 --term 60 [--start-date 2025-01-01]
 
 ### Blueprint Output (`--json`)
 
-Every calculator's `--json` output includes a `blueprint` object — a complete execution plan that an AI agent or human can follow to create the capsule and post all transactions in Jaz:
+Every calculator's `--json` output includes a `blueprint` object — a complete execution plan for creating the capsule and posting all transactions in Jaz:
 
 ```json
 {
@@ -165,13 +186,14 @@ Every calculator's `--json` output includes a `blueprint` object — a complete
   "blueprint": {
     "capsuleType": "Loan Repayment",
     "capsuleName": "Bank Loan — SGD 100,000 — 6% — 60 months",
+    "capsuleDescription": "Loan Amortization Workings\nPrincipal: SGD 100,000.00 | Rate: 6% p.a. ...",
     "tags": ["Bank Loan"],
     "customFields": { "Loan Reference": null },
     "steps": [
       {
         "step": 1,
-        "action": "journal",
-        "description": "Loan disbursement",
+        "action": "cash-in",
+        "description": "Record loan proceeds received from bank",
         "date": "2025-01-01",
         "lines": [
           { "account": "Cash / Bank Account", "debit": 100000, "credit": 0 },
@@ -183,12 +205,24 @@ Every calculator's `--json` output includes a `blueprint` object — a complete
 }
 ```
 
+**Blueprint action types** — each step tells you HOW to execute it in Jaz:
+
+| Action | When used | Jaz module |
+|---|---|---|
+| `bill` | Supplier document (prepaid expense) | Bills |
+| `invoice` | Customer document (deferred revenue) | Invoices |
+| `cash-in` | Cash arrives in bank (loan disbursement, FD maturity) | Bank / Manual Journal |
+| `cash-out` | Cash leaves bank (FD placement, provision settlement) | Bank / Manual Journal |
+| `journal` | No cash movement (accrual, depreciation, unwinding, reval) | Manual Journals |
+| `fixed-asset` | Register/update FA module (ROU asset, capital project) | Fixed Assets |
+| `note` | Instruction only (deregister FA on disposal) | N/A |
+
 **Math guarantees:**
-- Uses `financial` npm package (TypeScript port of numpy-financial) for PV, PMT — no hand-rolled TVM
-- 2 decimal places per period, final period closes balance to exactly $0.00
+- `financial` npm package (TypeScript port of numpy-financial) for PV, PMT — no hand-rolled TVM
+- 2dp per period, final period closes balance to exactly $0.00
 - Input validation with clear error messages (negative values, invalid dates, salvage > cost)
 - DDB→SL switch when straight-line >= declining balance or when DDB would breach salvage floor
-- Journal entries balanced (sum of debits = sum of credits in every step)
+- All journal entries balanced (debits = credits in every step)
 
 ## Cross-References
 

package/assets/skills/transaction-recipes/references/asset-disposal.md

@@ -0,0 +1,174 @@
+# Recipe: Asset Disposal
+
+## Scenario
+
+Your company disposes of a fixed asset — either selling it, trading it in, or scrapping it. IAS 16.67-72 requires derecognition on disposal or when no future economic benefits are expected. The gain or loss is the difference between net disposal proceeds and the carrying amount (IAS 16.68), and gains are NOT classified as revenue (IAS 16.71) — they appear separately in the P&L under Other Income.
+
+**Pattern:** One-shot calculator (not a schedule) — computes accumulated depreciation to disposal date, net book value, and gain/loss, then produces a single disposal journal
+
+**Why manual:** Jaz's fixed asset register tracks depreciation automatically, but the disposal journal (removing cost + accumulated depreciation + recognizing gain/loss) must be recorded manually. After the journal, the asset is marked as sold or discarded in the FA register.
+
+---
+
+## Accounts Involved
+
+| Account | Type | Subtype | Role |
+|---|---|---|---|
+| Fixed Asset (at cost) | Asset | Non-Current Asset | Original cost being removed |
+| Accumulated Depreciation | Asset | Non-Current Asset (contra) | Contra-asset being cleared |
+| Gain on Disposal | Revenue | Other Income | If proceeds > NBV |
+| Loss on Disposal | Expense | Other Expense | If proceeds < NBV |
+| Cash / Bank Account | Asset | Bank | Receives sale proceeds |
+
+> **Note:** Gain on Disposal is NOT revenue — IAS 16.71 requires it to be classified separately. Use an "Other Income" account, not a sales revenue account.
+
+---
+
+## Journal Entries
+
+### Scenario A: Sale at a Gain (Proceeds > NBV)
+
+Proceeds $12,000, NBV $10,000 — Gain of $2,000:
+
+| Line | Account | Debit | Credit |
+|---|---|---|---|
+| 1 | Cash / Bank Account | $12,000 | |
+| 2 | Accumulated Depreciation | $40,000 | |
+| 3 | Fixed Asset (at cost) | | $50,000 |
+| 4 | Gain on Disposal | | $2,000 |
+
+### Scenario B: Sale at a Loss (Proceeds < NBV)
+
+Proceeds $8,000, NBV $10,000 — Loss of $2,000:
+
+| Line | Account | Debit | Credit |
+|---|---|---|---|
+| 1 | Cash / Bank Account | $8,000 | |
+| 2 | Accumulated Depreciation | $40,000 | |
+| 3 | Loss on Disposal | $2,000 | |
+| 4 | Fixed Asset (at cost) | | $50,000 |
+
+### Scenario C: Scrap / Write-Off (Zero Proceeds)
+
+No proceeds, NBV $10,000 — Loss of $10,000:
+
+| Line | Account | Debit | Credit |
+|---|---|---|---|
+| 1 | Accumulated Depreciation | $40,000 | |
+| 2 | Loss on Disposal | $10,000 | |
+| 3 | Fixed Asset (at cost) | | $50,000 |
+
+**In all scenarios:** Debits = Credits = Original cost ($50,000).
+
+---
+
+## Capsule Structure
+
+**Capsule:** "Asset Disposal — Delivery Van VH-1234"
+**Capsule Type:** "Asset Disposal"
+
+Contents:
+- 1 disposal journal (removing cost, clearing accumulated depreciation, recognizing gain/loss)
+- **Total entries:** 1
+
+> **Note:** After recording the disposal journal, update the Jaz FA register to mark the asset as sold or discarded. This is a separate step — the register update does not create a journal entry but ensures the asset stops depreciating.
+
+---
+
+## Worked Example
+
+**Asset details:**
+- Asset: Delivery Van VH-1234
+- Original cost: $50,000
+- Salvage value: $5,000
+- Useful life: 5 years (60 months)
+- Depreciation method: Straight-line
+- Acquired: January 1, 2022
+- Disposed: June 15, 2025
+- Sale proceeds: $12,000
+
+**Step 1 — Calculate months held:**
+```
+Acquired:  Jan 1, 2022
+Disposed:  Jun 15, 2025
+Months held: 42 months (Jan 2022 through Jun 2025)
+```
+
+**Step 2 — Calculate monthly depreciation (straight-line):**
+```
+Depreciable base = Cost − Salvage = $50,000 − $5,000 = $45,000
+Monthly depreciation = $45,000 / 60 months = $750.00/month
+```
+
+**Step 3 — Calculate accumulated depreciation to disposal date:**
+```
+Accumulated depreciation = $750.00 × 42 months = $31,500.00
+```
+
+**Step 4 — Calculate net book value (NBV):**
+```
+NBV = Cost − Accumulated depreciation
+NBV = $50,000 − $31,500 = $18,500.00
+```
+
+**Step 5 — Calculate gain or loss:**
+```
+Gain/(Loss) = Proceeds − NBV
+Gain/(Loss) = $12,000 − $18,500 = −$6,500.00  (Loss)
+```
+
+**Disposal journal (Jun 15, 2025):**
+- Dr Cash $12,000.00
+- Dr Accumulated Depreciation $31,500.00
+- Dr Loss on Disposal $6,500.00
+- Cr Fixed Asset (at cost) $50,000.00
+- Description: "Disposal of Delivery Van VH-1234 — sold at loss"
+- Assign to capsule
+
+**Verification of debits = credits:**
+```
+Debits:  $12,000 + $31,500 + $6,500 = $50,000
+Credits: $50,000
+Balanced: Yes
+```
+
+**Use the calculator:** `jaz calc asset-disposal --cost 50000 --salvage 5000 --life 5 --acquired 2022-01-01 --disposed 2025-06-15 --proceeds 12000`
+
+The CLI generates a `capsuleDescription` with full workings (cost, accumulated depreciation, NBV, gain/loss breakdown) that can be attached to the capsule for audit trail.
+
+---
+
+## Enrichment Suggestions
+
+| Enrichment | Value | Why |
+|---|---|---|
+| Tracking Tag | "Asset Disposal" | Filter all disposal transactions in reports |
+| Nano Classifier | Disposal Type → "Sale" or "Scrap" | Distinguish sales from write-offs |
+| Custom Field | "Asset Description" → "Delivery Van VH-1234" | Identify the specific asset disposed |
+
+---
+
+## Verification
+
+1. **Fixed Asset account** → The original cost for this asset is fully removed (zeroed out).
+2. **Accumulated Depreciation account** → The accumulated depreciation for this asset is fully cleared (zeroed out).
+3. **P&L** → Gain or Loss on Disposal appears under "Other Income" or "Other Expense" (not revenue).
+4. **FA register** → Asset is marked as sold or discarded. No further depreciation is posted.
+
+---
+
+## Variations
+
+**DDB/150DB depreciation:** If the asset uses declining balance instead of straight-line, use `--method ddb` or `--method 150db` in the calculator. The accumulated depreciation will differ, changing the NBV and gain/loss.
+
+**Partial-year depreciation:** The calculator pro-rates automatically based on the acquisition and disposal dates. No manual adjustment needed for mid-month or mid-year disposals.
+
+**Fully depreciated asset:** If the asset is fully depreciated, NBV = salvage value. Gain = proceeds − salvage. If scrapped, loss = salvage value (the remaining book value written off).
+
+**Trade-in:** Record as a disposal (this recipe) plus a new asset acquisition in the same capsule. The trade-in allowance is the "proceeds" for the old asset. The new asset is recorded at its full cost, with the trade-in reducing the cash paid.
+
+**Insurance claim (involuntary disposal):** If the asset is destroyed (fire, theft, accident), the insurance payout is the "proceeds." Same journal structure — the only difference is the source of cash (insurer instead of buyer).
+
+**Jaz FA register update:** After recording the disposal journal, update the FA register:
+- Sold: `POST /mark-as-sold/fixed-assets` — marks the asset as sold with the disposal date
+- Scrapped: `POST /discard-fixed-assets/:id` — marks the asset as discarded

package/assets/skills/transaction-recipes/references/fixed-deposit.md

@@ -0,0 +1,164 @@
+# Recipe: Fixed Deposit
+
+## Scenario
+
+Your company places $100,000 in a 12-month fixed deposit at 3.5% annual interest. Under IFRS 9, this is classified as a financial asset at amortized cost (hold-to-collect business model, passes the SPPI test — solely payments of principal and interest). Interest is accrued monthly using the effective interest rate method and recognized in profit or loss. At maturity, the bank returns the principal plus accumulated interest.
+
+**Pattern:** Manual journals + capsule (monthly accrual, single maturity settlement)
+
+---
+
+## Accounts Involved
+
+| Account | Type | Subtype | Role |
+|---|---|---|---|
+| Fixed Deposit | Asset | Current Asset | Carries the principal for the deposit term |
+| Accrued Interest Receivable | Asset | Current Asset | Accumulates monthly interest accruals |
+| Interest Income | Revenue | Other Income | P&L recognition of interest earned |
+| Cash / Bank Account | Asset | Bank | Outflow on placement, inflow at maturity |
+
+---
+
+## Journal Entries
+
+### Step 1: Placement (Day 1) — cash-out
+
+Record the transfer from operating account to the fixed deposit. This is a **cash-out** entry in Jaz (cash leaves the bank account):
+
+| Line | Account | Debit | Credit |
+|---|---|---|---|
+| 1 | Fixed Deposit | $100,000 | |
+| 2 | Cash / Bank Account | | $100,000 |
+
+> In Jaz, record this via the bank module (match the outgoing bank feed entry) or as a manual journal.
+
+### Step 2: Monthly Interest Accrual (each month)
+
+**Simple interest (default):** Equal monthly accrual amount.
+
+| Line | Account | Debit | Credit |
+|---|---|---|---|
+| 1 | Accrued Interest Receivable | $291.67 | |
+| 2 | Interest Income | | $291.67 |
+
+**Calculation:**
+- Annual interest = $100,000 × 3.5% = $3,500
+- Monthly accrual = $3,500 / 12 = $291.67
+
+**Compound interest:** Interest is calculated on the carrying amount (principal + previously accrued interest) using the effective interest rate. Each month's accrual is slightly higher than the last. Use `jaz calc fixed-deposit --principal 100000 --rate 3.5 --term 12 --compound monthly` to generate the exact schedule.
+
+### Step 3: Maturity (final day) — cash-in
+
+Principal plus accrued interest returns to the bank account. This is a **cash-in** entry in Jaz (cash arrives in the bank account):
+
+| Line | Account | Debit | Credit |
+|---|---|---|---|
+| 1 | Cash / Bank Account | $103,500 | |
+| 2 | Fixed Deposit | | $100,000 |
+| 3 | Accrued Interest Receivable | | $3,500 |
+
+> After this entry, Fixed Deposit and Accrued Interest Receivable both zero out. The net P&L impact is $3,500 of Interest Income recognized over the 12 months. In Jaz, record via the bank module (match the incoming bank feed entry) or as a manual journal.
+
+---
+
+## Capsule Structure
+
+**Capsule:** "Fixed Deposit — DBS — 2025"
+**Capsule Type:** "Fixed Deposit"
+
+Contents:
+- 1 placement journal
+- 12 monthly interest accrual journals
+- 1 maturity journal
+- **Total entries:** 14
+
+The CLI generates a `capsuleDescription` field with full workings — including the interest calculation method, per-period accrual amounts, and maturity value — so the capsule is self-documenting.
+
+---
+
+## Worked Example
+
+**Deposit terms:**
+- Principal: $100,000
+- Annual rate: 3.5%
+- Term: 12 months (simple interest)
+- Monthly accrual: $100,000 × 3.5% / 12 = $291.67
+- Total interest: $3,500.00
+- Maturity value: $103,500.00
+
+**CLI command:**
+```
+jaz calc fixed-deposit --principal 100000 --rate 3.5 --term 12 --currency SGD
+```
+
+### Accrual Schedule (first 3 months + last month)
+
+| Month | Accrual Amount | Cumulative Interest | Accrued Interest Receivable |
+|---|---|---|---|
+| 1 | $291.67 | $291.67 | $291.67 |
+| 2 | $291.67 | $583.34 | $583.34 |
+| 3 | $291.67 | $875.01 | $875.01 |
+| ... | ... | ... | ... |
+| 12 | $291.63* | $3,500.00 | $3,500.00 |
+
+> *Final month adjusted by $0.04 to close the balance exactly to $3,500.00 (rounding correction).
+
+**Month 1 journal entry:**
+- Dr Accrued Interest Receivable $291.67
+- Cr Interest Income $291.67
+- Description: "FD interest accrual — Month 1 of 12 (DBS)"
+- Assign to capsule
+
+**Month 3 journal entry:**
+- Dr Accrued Interest Receivable $291.67
+- Cr Interest Income $291.67
+- Description: "FD interest accrual — Month 3 of 12 (DBS)"
+- Assign to capsule
+
+**Maturity journal entry:**
+- Dr Cash $103,500.00
+- Cr Fixed Deposit $100,000.00
+- Cr Accrued Interest Receivable $3,500.00
+- Description: "FD maturity — principal + interest received (DBS)"
+- Assign to capsule
+
+**Totals over 12 months:**
+- Total interest income: $3,500.00
+- Net cash impact: −$100,000 at placement, +$103,500 at maturity = +$3,500
+
+---
+
+## Enrichment Suggestions
+
+| Enrichment | Value | Why |
+|---|---|---|
+| Tracking Tag | "Fixed Deposit" | Filter all FD-related transactions in reports |
+| Nano Classifier | Instrument → "Term Deposit" | Distinguish from savings accounts or money market funds |
+| Custom Field | "Deposit Reference" → "TD-2025-001" | Record the bank's deposit certificate number |
+| Custom Field | "Bank Name" → "DBS" | Identify the issuing bank for multi-bank portfolios |
+
+Set the tag and nano classifier on each accrual journal. Custom fields go on the placement journal (the capsule groups everything together).
+
+---
+
+## Verification
+
+1. **Accrued Interest Receivable should accumulate monthly** → Trial Balance at month 6 should show $1,750.02 (6 × $291.67). The balance grows each month until maturity.
+2. **Interest Income P&L line = total accrual to date** → P&L at any date should equal the sum of accrual entries posted up to that date.
+3. **At maturity, Fixed Deposit account zeros out** → After the maturity journal, Fixed Deposit balance = $0 and Accrued Interest Receivable balance = $0.
+4. **Cash flow: Cash decreased by principal on placement, increased by maturity value at end** → Net cash movement over the 12 months = +$3,500 (the interest earned).
+5. **Group General Ledger by Capsule** → "Fixed Deposit — DBS — 2025" should show all 14 entries. Fixed Deposit nets to $0 and Interest Income totals $3,500.
+
+---
+
+## Variations
+
+**Compound interest:** Use `jaz calc fixed-deposit --principal 100000 --rate 3.5 --term 12 --compound monthly` to generate a schedule where each month's interest is calculated on the carrying amount (principal + accrued interest to date). Total interest will be slightly higher than simple interest ($3,556.46 vs $3,500.00 for monthly compounding). The effective interest rate method applies the same logic — each period's income = carrying amount × periodic rate.
+
+**FX-denominated deposit:** If the deposit is in USD but your base currency is SGD, record the placement journal with `currency: { sourceCurrency: "USD" }`. Monthly accruals should use the spot rate at each month-end. At maturity, any difference between the cumulative translated amounts and the actual SGD received is an FX gain/loss. Cross-reference the fx-revaluation recipe for month-end revaluation of the outstanding balance.
+
+**Premature withdrawal:** The bank may impose a penalty (reduced interest rate or flat fee). Record the maturity journal with the reduced interest amount. If interest already accrued exceeds the actual payout, reverse the excess: Dr Interest Income / Cr Accrued Interest Receivable. Note the penalty in the journal description.
+
+**Auto-rollover:** When the bank automatically rolls over the deposit at maturity, close the original capsule with a maturity journal (Dr Fixed Deposit New / Cr Fixed Deposit Old + Cr Accrued Interest Receivable), then create a new capsule for the rolled deposit. The new principal may include the prior interest if the bank compounds on rollover.
+
+**PH withholding tax (20% final WHT on interest income):** In jurisdictions that withhold tax on interest at source, the maturity cash received is net of WHT. Record: Dr Cash (net) + Dr WHT Receivable or Tax Expense / Cr Fixed Deposit + Cr Accrued Interest Receivable. This variation is deferred to a future recipe update.