jaz-cli 2.2.1 → 2.5.0

package/assets/skills/transaction-recipes/references/declining-balance.md

@@ -0,0 +1,190 @@
+# Recipe: Declining Balance Depreciation
+
+## Scenario
+
+Your company purchases a delivery vehicle for $50,000 with a 5-year useful life and $5,000 salvage value. Management wants to use **double declining balance (DDB)** depreciation instead of straight-line because the vehicle loses more value in early years. Jaz only supports straight-line natively, so you record depreciation manually.
+
+**Pattern:** Manual journals + capsule (depreciation amount changes each period)
+
+**Why manual:** Jaz's fixed asset register only supports straight-line depreciation. Declining balance produces different amounts each period as the book value decreases, so a scheduler (fixed-amount) won't work either.
+
+---
+
+## Accounts Involved
+
+| Account | Type | Subtype | Role |
+|---|---|---|---|
+| Vehicles | Asset | Non-Current Asset | The asset at cost |
+| Accumulated Depreciation — Vehicles | Asset | Non-Current Asset | Contra-asset reducing net book value |
+| Depreciation Expense | Expense | Expense | Monthly/annual depreciation charge |
+
+> **Do NOT register the asset in Jaz's fixed asset register** — that would trigger automatic straight-line depreciation. Track the asset in the CoA only.
+
+---
+
+## DDB Method — How It Works
+
+**Double Declining Balance Rate:**
+```
+DDB Rate = 2 / Useful Life = 2 / 5 = 40% per year
+```
+
+**Each period:**
+```
+Depreciation = Book Value at Start of Period × DDB Rate
+```
+
+**Key constraint:** Book value can never go below salvage value. When the declining balance amount would push book value below salvage, **switch to straight-line** for the remaining life.
+
+**Switch-to-straight-line rule:** At the start of each period, compare:
+- DDB depreciation = Book value × DDB rate
+- Straight-line for remaining life = (Book value − Salvage value) / Remaining years
+
+When straight-line ≥ DDB, switch to straight-line for all remaining periods.
+
+---
+
+## Journal Entry (Each Period)
+
+| Line | Account | Debit | Credit |
+|---|---|---|---|
+| 1 | Depreciation Expense | *calculated amount* | |
+| 2 | Accumulated Depreciation — Vehicles | | *calculated amount* |
+
+---
+
+## Capsule Structure
+
+**Capsule:** "Depreciation — Delivery Vehicle VH-001"
+**Capsule Type:** "Depreciation (Non-Standard)"
+
+Contents:
+- 5 annual depreciation journals (or 60 monthly if recording monthly)
+- **Total entries:** 5 (annual) or 60 (monthly)
+
+---
+
+## Worked Example — Annual
+
+**Asset details:**
+- Cost: $50,000
+- Salvage value: $5,000
+- Useful life: 5 years
+- DDB rate: 40%
+- Depreciable base: $45,000
+
+### Annual Depreciation Schedule
+
+| Year | Opening Book Value | DDB (40%) | SL for Remaining | Use | Depreciation | Closing Book Value |
+|---|---|---|---|---|---|---|
+| 1 | $50,000 | $20,000 | $9,000 (45k/5) | DDB | **$20,000** | $30,000 |
+| 2 | $30,000 | $12,000 | $6,250 (25k/4) | DDB | **$12,000** | $18,000 |
+| 3 | $18,000 | $7,200 | $4,333 (13k/3) | DDB | **$7,200** | $10,800 |
+| 4 | $10,800 | $4,320 | $2,900 (5.8k/2) | DDB | **$4,320** | $6,480 |
+| 5 | $6,480 | $2,592 | $1,480 (1.48k/1) | **Switch** | **$1,480** | $5,000 |
+
+**Year 5 switch logic:**
+- DDB = $6,480 × 40% = $2,592 → would give closing BV of $3,888 (below salvage)
+- SL = ($6,480 − $5,000) / 1 = $1,480
+- Since we can't go below salvage, depreciate only $1,480
+
+**Total depreciation:** $20,000 + $12,000 + $7,200 + $4,320 + $1,480 = **$45,000** ✓
+
+### Year 1 Journal Entry
+
+- Dr Depreciation Expense $20,000
+- Cr Accumulated Depreciation — Vehicles $20,000
+- Description: "DDB depreciation — Delivery Vehicle VH-001 — Year 1 of 5"
+- Assign to capsule
+
+### Year 4 Journal Entry
+
+- Dr Depreciation Expense $4,320
+- Cr Accumulated Depreciation — Vehicles $4,320
+- Description: "DDB depreciation — Delivery Vehicle VH-001 — Year 4 of 5"
+- Assign to capsule
+
+### Year 5 Journal Entry (Switched to SL)
+
+- Dr Depreciation Expense $1,480
+- Cr Accumulated Depreciation — Vehicles $1,480
+- Description: "SL depreciation (switched from DDB) — Delivery Vehicle VH-001 — Year 5 of 5"
+- Assign to capsule
+
+---
+
+## Worked Example — Monthly
+
+For monthly recording, divide each year's depreciation by 12:
+
+| Year | Annual Depreciation | Monthly Depreciation |
+|---|---|---|
+| 1 | $20,000 | $1,666.67 |
+| 2 | $12,000 | $1,000.00 |
+| 3 | $7,200 | $600.00 |
+| 4 | $4,320 | $360.00 |
+| 5 | $1,480 | $123.33 |
+
+**Month 1 (Year 1) journal:**
+- Dr Depreciation Expense $1,666.67
+- Cr Accumulated Depreciation — Vehicles $1,666.67
+- Description: "DDB depreciation — Delivery Vehicle VH-001 — Month 1 of 60"
+
+**Month 13 (Year 2, Month 1) journal:**
+- Dr Depreciation Expense $1,000.00
+- Cr Accumulated Depreciation — Vehicles $1,000.00
+- Description: "DDB depreciation — Delivery Vehicle VH-001 — Month 13 of 60"
+
+> The monthly amount changes at the start of each year, not each month. Within a year, the monthly amount is constant.
+
+---
+
+## Enrichment Suggestions
+
+| Enrichment | Value | Why |
+|---|---|---|
+| Tracking Tag | "Vehicle Depreciation" | Filter all vehicle depreciation entries |
+| Nano Classifier | Asset Class → "Motor Vehicles" | Break down depreciation by asset class |
+| Custom Field | "Asset ID" → "VH-001" | Record the internal asset tracking number |
+
+---
+
+## Verification
+
+1. **Group General Ledger by Capsule** → Shows all depreciation entries. Accumulated Depreciation should sum to $45,000 at end of Year 5.
+2. **Trial Balance at any date** → Vehicles account shows $50,000 (cost, unchanged). Accumulated Depreciation shows the running total. Net book value = Cost − Accumulated Depreciation.
+3. **Net book value check:**
+   - End of Year 1: $50,000 − $20,000 = $30,000
+   - End of Year 3: $50,000 − $39,200 = $10,800
+   - End of Year 5: $50,000 − $45,000 = $5,000 (= salvage value) ✓
+4. **P&L per year** → Depreciation Expense matches the annual schedule: $20K, $12K, $7.2K, $4.32K, $1.48K.
+
+---
+
+## Variations
+
+**150% declining balance:** Use rate = 1.5 / Useful Life instead of 2 / Useful Life. Same switch-to-SL logic applies.
+
+**No salvage value:** If salvage = $0, the switch-to-SL happens when SL depreciation ≥ DDB. The entire cost is depreciated.
+
+**Mid-year acquisition:** If the vehicle is purchased in July, Year 1 gets 6/12 of the annual DDB amount. The remaining 6/12 rolls into a 6th partial year. Adjust the schedule accordingly.
+
+**Disposal before end of life:** If the vehicle is sold in Year 3:
+1. Record depreciation up to the disposal date (prorated if mid-year)
+2. Remove the asset: Dr Cash (proceeds) + Dr Accumulated Depreciation + Dr/Cr Gain or Loss on Disposal / Cr Vehicles (cost)
+3. All entries stay in the same capsule for audit trail
+
+**Multiple assets:** Create a separate capsule per asset. Use the same "Depreciation (Non-Standard)" capsule type. Tags and nano classifiers help aggregate across assets in reports.
+
+### Comparison: DDB vs Straight-Line
+
+| Year | DDB | Straight-Line ($9,000/yr) | Difference |
+|---|---|---|---|
+| 1 | $20,000 | $9,000 | +$11,000 |
+| 2 | $12,000 | $9,000 | +$3,000 |
+| 3 | $7,200 | $9,000 | −$1,800 |
+| 4 | $4,320 | $9,000 | −$4,680 |
+| 5 | $1,480 | $9,000 | −$7,520 |
+| **Total** | **$45,000** | **$45,000** | **$0** |
+
+Both methods depreciate the same total ($45,000). DDB front-loads the expense — higher expense in early years, lower in later years.

package/assets/skills/transaction-recipes/references/deferred-revenue.md

@@ -0,0 +1,125 @@
+# Recipe: Deferred Revenue
+
+## Scenario
+
+A customer pays $24,000 upfront for a 12-month SaaS subscription (Jan 1 to Dec 31, 2025). The cash is a liability on day one (you owe the service), then recognized as revenue evenly over 12 months at $2,000/month.
+
+**Pattern:** Scheduler + capsule (fixed monthly amount)
+
+---
+
+## Accounts Involved
+
+| Account | Type | Subtype | Role |
+|---|---|---|---|
+| Deferred Revenue | Liability | Current Liability | Holds unearned revenue |
+| Subscription Revenue | Revenue | Revenue | Receives monthly recognition |
+| Cash / Bank Account | Asset | Bank | Receives the upfront payment |
+| Accounts Receivable | Asset | Current Asset | If recorded as an invoice first |
+
+---
+
+## Journal Entries
+
+### Step 1: Record the Upfront Payment
+
+**Option A — Invoice (with or without payment):**
+
+Create an invoice to the customer for $24,000 with the line item coded to **Deferred Revenue** (not Subscription Revenue). Record payment on the invoice when ready.
+
+**Option B — Cash-in entry:**
+
+| Line | Account | Debit | Credit |
+|---|---|---|---|
+| 1 | Cash / Bank Account | $24,000 | |
+| 2 | Deferred Revenue | | $24,000 |
+
+### Step 2: Monthly Revenue Recognition (Scheduler)
+
+Create a journal scheduler that runs monthly for 12 periods:
+
+| Line | Account | Debit | Credit |
+|---|---|---|---|
+| 1 | Deferred Revenue | $2,000 | |
+| 2 | Subscription Revenue | | $2,000 |
+
+**Scheduler settings:**
+- Frequency: Monthly
+- Start date: 2025-01-31 (end of first month)
+- **End date: 2025-12-31** — the end date is what ensures the deferred balance fully unwinds to zero. After the 12th entry, the scheduler stops and the Deferred Revenue account is cleared.
+- Capsule: "FY2025 SaaS — Acme Corp"
+- Description: `Revenue recognition — {{MONTH_NAME}} {{YEAR}}`
+
+---
+
+## Capsule Structure
+
+**Capsule:** "FY2025 SaaS — Acme Corp"
+**Capsule Type:** "Deferred Revenue"
+
+Contents:
+- 1 invoice (or cash-in entry) — the initial $24,000 payment
+- 12 journal entries — generated by the scheduler ($2,000/month)
+- **Total entries:** 13
+
+---
+
+## Worked Example
+
+**Setup (Jan 1, 2025):**
+- Record invoice to customer: Dr AR $24,000 / Cr Deferred Revenue $24,000
+- Record payment on invoice: Dr Cash $24,000 / Cr AR $24,000
+- Assign invoice to capsule "FY2025 SaaS — Acme Corp"
+- Create scheduler with same capsule
+
+**Month 1 (Jan 31, 2025) — auto-generated:**
+- Dr Deferred Revenue $2,000 / Cr Subscription Revenue $2,000
+- Deferred balance: $22,000
+
+**Month 6 (Jun 30, 2025) — auto-generated:**
+- Dr Deferred Revenue $2,000 / Cr Subscription Revenue $2,000
+- Deferred balance: $12,000
+
+**Month 12 (Dec 31, 2025) — auto-generated:**
+- Dr Deferred Revenue $2,000 / Cr Subscription Revenue $2,000
+- Deferred balance: $0
+
+**Year-end totals:**
+- Subscription Revenue P&L: $24,000
+- Deferred Revenue balance: $0
+- Cash increased by: $24,000
+
+---
+
+## Enrichment Suggestions
+
+| Enrichment | Value | Why |
+|---|---|---|
+| Tracking Tag | "SaaS Revenue" | Filter all subscription revenue entries |
+| Nano Classifier | Product → "Enterprise Plan" | Break down revenue by product tier |
+| Custom Field | "Contract Number" → "CTR-2025-042" | Record contract reference on the invoice |
+
+Set the tag and nano classifier on the scheduler — all 12 generated journals inherit them automatically.
+
+---
+
+## Verification
+
+1. **Group General Ledger by Capsule** → "FY2025 SaaS — Acme Corp" should show all 13 entries with Deferred Revenue netting to zero.
+2. **Trial Balance at Dec 31** → Deferred Revenue balance should be $0. Subscription Revenue should show $24,000.
+3. **Trial Balance at Jun 30** → Deferred Revenue balance should be $12,000. Subscription Revenue should show $12,000.
+4. **P&L for Q1** → Subscription Revenue = $6,000 (3 months × $2,000).
+
+---
+
+## Variations
+
+**Quarterly recognition:** $6,000/quarter for 4 quarters. Change scheduler frequency to quarterly.
+
+**Mid-month start:** If the subscription starts Feb 15, prorate February ($24,000 / 365 × 14 days ≈ $921), recognize the remainder over 11 full months at $2,098/month. Use a manual journal for the prorated first period, then a scheduler for remaining full months — both in the same capsule.
+
+**Multi-customer:** Create a separate capsule per customer contract. Tags can span all customers (e.g., "SaaS Revenue" tag across all capsules).
+
+**Early termination:** If the customer cancels after month 8, remaining deferred revenue ($8,000) is recognized immediately via a manual journal in the capsule. Delete or end the scheduler.
+
+**Multi-currency:** If the customer pays in USD but your base currency is SGD, record the invoice using `currency: { sourceCurrency: "USD" }`. Monthly recognition journals should be in SGD at the rate locked on the invoice date.

package/assets/skills/transaction-recipes/references/dividend.md

@@ -0,0 +1,111 @@
+# Recipe: Dividend Declaration and Payment
+
+## Scenario
+
+Your company's board declares a final dividend of $200,000 for FY2025, payable on March 15, 2026. Two journal entries are needed: one at the declaration date (creating the obligation) and one at the payment date (settling it). The dividend reduces retained earnings, not current-year profit.
+
+**Pattern:** Two manual journals + capsule (declaration + payment)
+
+---
+
+## Accounts Involved
+
+| Account | Type | Subtype | Role |
+|---|---|---|---|
+| Retained Earnings | Equity | Retained Earnings | Reduced by declared dividend |
+| Dividends Payable | Liability | Current Liability | Obligation from declaration to payment |
+| Cash / Bank Account | Asset | Bank | Settlement on payment date |
+
+> **Note:** Some companies use an "Dividends Declared" equity contra account instead of debiting Retained Earnings directly. Either approach is acceptable — the effect on equity is the same.
+
+---
+
+## Journal Entries
+
+### Step 1: Declaration (board resolution date)
+
+| Line | Account | Debit | Credit |
+|---|---|---|---|
+| 1 | Retained Earnings | $200,000 | |
+| 2 | Dividends Payable | | $200,000 |
+
+### Step 2: Payment (settlement date)
+
+| Line | Account | Debit | Credit |
+|---|---|---|---|
+| 1 | Dividends Payable | $200,000 | |
+| 2 | Cash / Bank Account | | $200,000 |
+
+---
+
+## Capsule Structure
+
+**Capsule:** "FY2025 Final Dividend"
+**Capsule Type:** "Dividends"
+
+Contents:
+- 1 declaration journal
+- 1 payment journal
+- **Total entries:** 2
+
+---
+
+## Worked Example
+
+**Setup:**
+- Declared amount: $200,000
+- Declaration date: February 15, 2026 (board resolution)
+- Payment date: March 15, 2026
+
+**Feb 15, 2026 — Declaration:**
+- Dr Retained Earnings $200,000
+- Cr Dividends Payable $200,000
+- Description: "FY2025 final dividend declared — Board Resolution #BR-2026-003"
+- Assign to capsule
+
+**Mar 15, 2026 — Payment:**
+- Dr Dividends Payable $200,000
+- Cr Cash / Bank Account $200,000
+- Description: "FY2025 final dividend payment"
+- Assign to same capsule
+
+**After both entries:**
+- Retained Earnings reduced by $200,000
+- Dividends Payable cleared to $0
+- Cash reduced by $200,000
+
+---
+
+## Enrichment Suggestions
+
+| Enrichment | Value | Why |
+|---|---|---|
+| Tracking Tag | "Dividend" | Filter all dividend-related entries |
+| Custom Field | "Board Resolution #" → "BR-2026-003" | Audit trail to authorization |
+| Custom Field | "Fiscal Year" → "FY2025" | Link to the year the dividend relates to |
+
+---
+
+## Verification
+
+1. **Trial Balance at Feb 28 (after declaration, before payment)** → Dividends Payable shows $200,000 credit. Retained Earnings reduced by $200,000.
+2. **Trial Balance at Mar 31 (after payment)** → Dividends Payable shows $0. Cash reduced by $200,000.
+3. **Statement of Changes in Equity** → Shows the $200,000 dividend reducing retained earnings.
+4. **Group General Ledger by Capsule** → Both entries visible under "FY2025 Final Dividend."
+
+---
+
+## Variations
+
+**Interim dividend:** Same structure, just declared mid-year (e.g., after H1 results). Use a separate capsule: "FY2025 Interim Dividend." Some jurisdictions require interim dividends to be based on audited interim accounts.
+
+**Dividend in specie (non-cash):** If the dividend is settled with assets (e.g., property, shares in a subsidiary), replace the Cash credit with the appropriate asset account. Record any gain/loss on the asset transfer in the same journal.
+
+**Withholding tax:** If your jurisdiction requires dividend withholding tax, the payment journal splits into net payment + tax payable:
+- Dr Dividends Payable $200,000
+- Cr Cash $170,000 (net to shareholders)
+- Cr Withholding Tax Payable $30,000 (15% tax)
+
+Then a separate payment when tax is remitted: Dr WHT Payable $30,000 / Cr Cash $30,000.
+
+**Multiple shareholders:** If dividends are paid pro-rata to multiple shareholders, use one multi-line payment journal with a line per shareholder's bank account, or record separate payment journals per shareholder — all in the same capsule.

package/assets/skills/transaction-recipes/references/employee-accruals.md

@@ -0,0 +1,154 @@
+# Recipe: Employee Benefit Accruals — Leave + Bonus (IAS 19)
+
+## Scenario
+
+Your company has 20 employees, each entitled to 14 days annual leave. Total annual leave cost is $84,000. IAS 19.13 requires the leave obligation to be accrued over the year as employees earn it. Separately, you accrue a quarterly bonus of 5% of revenue, settled annually after year-end performance review.
+
+**Pattern:** Scheduler (leave — fixed monthly) + manual journals (bonus — variable quarterly)
+
+---
+
+## Accounts Involved
+
+| Account | Type | Subtype | Role |
+|---|---|---|---|
+| Leave Expense | Expense | Expense | Monthly leave accrual charge |
+| Accrued Leave Liability | Liability | Current Liability | Obligation for earned but unused leave |
+| Bonus Expense | Expense | Expense | Quarterly bonus accrual charge |
+| Accrued Bonus Liability | Liability | Current Liability | Obligation for estimated bonus |
+| Cash / Bank Account | Asset | Bank | Settlement on payout |
+
+---
+
+## Journal Entries
+
+### Part A: Annual Leave Accrual (Monthly — Scheduler)
+
+**Monthly amount:** Total annual leave cost / 12
+
+```
+$84,000 / 12 = $7,000 per month
+```
+
+| Line | Account | Debit | Credit |
+|---|---|---|---|
+| 1 | Leave Expense | $7,000 | |
+| 2 | Accrued Leave Liability | | $7,000 |
+
+**Scheduler settings:**
+- Frequency: Monthly
+- Start date: 2025-01-31
+- End date: 2025-12-31
+- Description: `Annual leave accrual — {{MONTH_NAME}} {{YEAR}}`
+- Capsule: "FY2025 Annual Leave Accrual"
+
+### Part A — Year-End True-Up
+
+At year-end, compare the accrued balance ($84,000) against actual leave liability:
+- If employees used less leave than expected → liability stays higher, no adjustment needed (or reduce if policy allows forfeit)
+- If employees used more leave → reduce the liability with an adjustment journal
+
+**Payout on resignation/termination:**
+| Line | Account | Debit | Credit |
+|---|---|---|---|
+| 1 | Accrued Leave Liability | *payout amount* | |
+| 2 | Cash / Bank Account | | *payout amount* |
+
+### Part B: Bonus Accrual (Quarterly — Manual Journals)
+
+**Quarterly calculation:** 5% × quarterly revenue
+
+| Line | Account | Debit | Credit |
+|---|---|---|---|
+| 1 | Bonus Expense | *estimated bonus* | |
+| 2 | Accrued Bonus Liability | | *estimated bonus* |
+
+### Part B — Year-End True-Up and Settlement
+
+When the actual bonus is determined (e.g., board approves $180,000 against $200,000 accrued):
+
+**Reversal of over-accrual:**
+| Line | Account | Debit | Credit |
+|---|---|---|---|
+| 1 | Accrued Bonus Liability | $20,000 | |
+| 2 | Bonus Expense | | $20,000 |
+
+**Payment:**
+| Line | Account | Debit | Credit |
+|---|---|---|---|
+| 1 | Accrued Bonus Liability | $180,000 | |
+| 2 | Cash / Bank Account | | $180,000 |
+
+---
+
+## Capsule Structure
+
+**Leave Capsule:** "FY2025 Annual Leave Accrual"
+**Capsule Type:** "Employee Benefits"
+
+Contents:
+- 12 monthly accrual journals (from scheduler)
+- Year-end true-up journal (if needed)
+- Payout journals for resignations
+- **Total entries:** 12-15
+
+**Bonus Capsule:** "FY2025 Performance Bonus"
+**Capsule Type:** "Employee Benefits"
+
+Contents:
+- 4 quarterly accrual journals
+- Year-end true-up journal
+- Settlement payment journal
+- **Total entries:** 6
+
+---
+
+## Worked Example
+
+**Leave accrual setup:**
+- 20 employees × 14 days × $300/day = $84,000 annual leave cost
+- Monthly accrual: $7,000
+- Create scheduler: Dr Leave Expense $7,000 / Cr Accrued Leave $7,000, monthly Jan-Dec
+
+**Bonus accrual by quarter:**
+
+| Quarter | Revenue | Bonus (5%) | Journal |
+|---|---|---|---|
+| Q1 | $800,000 | $40,000 | Dr Bonus Expense $40,000 / Cr Accrued Bonus $40,000 |
+| Q2 | $950,000 | $47,500 | Dr Bonus Expense $47,500 / Cr Accrued Bonus $47,500 |
+| Q3 | $1,100,000 | $55,000 | Dr Bonus Expense $55,000 / Cr Accrued Bonus $55,000 |
+| Q4 | $1,150,000 | $57,500 | Dr Bonus Expense $57,500 / Cr Accrued Bonus $57,500 |
+| **Total** | **$4,000,000** | **$200,000** | |
+
+**Year-end true-up:** Board approves $180,000 bonus → reverse $20,000 over-accrual, then pay $180,000.
+
+---
+
+## Enrichment Suggestions
+
+| Enrichment | Value | Why |
+|---|---|---|
+| Tracking Tag | "Employee Benefits" | Filter all leave + bonus entries |
+| Nano Classifier | Department → "Engineering" / "Sales" / etc. | Allocate leave/bonus cost by department |
+| Custom Field | "Fiscal Year" → "FY2025" | Link to fiscal year |
+
+---
+
+## Verification
+
+1. **Trial Balance at Jun 30** → Accrued Leave Liability shows $42,000 credit (6 months × $7,000). Accrued Bonus shows $87,500 (Q1 + Q2).
+2. **P&L for Q2** → Leave Expense: $21,000 (3 months). Bonus Expense: $47,500.
+3. **Trial Balance at Dec 31 (before true-up)** → Accrued Leave: $84,000. Accrued Bonus: $200,000.
+4. **After true-up and payment** → Accrued Bonus clears to $0. Bonus Expense net = $180,000.
+
+---
+
+## Variations
+
+**Proportional leave by hire date:** New employees hired mid-year get prorated leave. Adjust the scheduler amount per employee or use manual journals for partial-year hires.
+
+**Bonus based on profit (not revenue):** Same structure, but the quarterly estimate uses profit before bonus. The true-up at year-end adjusts for the circular reference (bonus reduces profit which reduces bonus).
+
+**13th month salary (Philippines / Juan):** Similar to leave accrual — fixed monthly accrual of 1/12 of annual salary, settled in December. Use the scheduler pattern.
+
+**Leave encashment policy:** If unused leave can be cashed out, the accrued liability stays on the balance sheet until encashment or termination. No year-end reversal — only adjustment for forfeited leave (if policy allows).