jaz-clio 5.55.1 → 5.55.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/assets/skills/api/SKILL.md +1 -1
- package/assets/skills/cli/SKILL.md +1 -1
- package/assets/skills/conversion/SKILL.md +1 -1
- package/assets/skills/jaz-kit/SKILL.md +1 -1
- package/assets/skills/jaz-pseudo-sql/SKILL.md +1 -1
- package/assets/skills/jobs/SKILL.md +1 -1
- package/assets/skills/jobs/references/audit-prep.md +1 -1
- package/assets/skills/jobs/references/bank-recon.md +5 -4
- package/assets/skills/jobs/references/building-blocks.md +31 -3
- package/assets/skills/jobs/references/fa-review.md +3 -3
- package/assets/skills/jobs/references/gst-vat-filing.md +4 -4
- package/assets/skills/jobs/references/month-end-close.md +7 -7
- package/assets/skills/jobs/references/payment-run.md +6 -4
- package/assets/skills/jobs/references/quarter-end-close.md +13 -9
- package/assets/skills/jobs/references/supplier-recon.md +20 -7
- package/assets/skills/jobs/references/year-end-close.md +8 -8
- package/assets/skills/transaction-recipes/SKILL.md +1 -1
- package/assets/skills/transaction-recipes/references/accrued-expenses.md +6 -6
- package/assets/skills/transaction-recipes/references/asset-disposal.md +5 -5
- package/assets/skills/transaction-recipes/references/bad-debt-provision.md +2 -2
- package/assets/skills/transaction-recipes/references/bank-loan.md +4 -4
- package/assets/skills/transaction-recipes/references/building-blocks.md +3 -3
- package/assets/skills/transaction-recipes/references/capital-wip.md +4 -4
- package/assets/skills/transaction-recipes/references/declining-balance.md +4 -4
- package/assets/skills/transaction-recipes/references/deferred-revenue.md +3 -3
- package/assets/skills/transaction-recipes/references/dividend.md +2 -2
- package/assets/skills/transaction-recipes/references/employee-accruals.md +7 -7
- package/assets/skills/transaction-recipes/references/fixed-deposit.md +5 -5
- package/assets/skills/transaction-recipes/references/ifrs16-lease.md +4 -4
- package/assets/skills/transaction-recipes/references/intercompany.md +2 -2
- package/assets/skills/transaction-recipes/references/prepaid-amortization.md +2 -2
- package/assets/skills/transaction-recipes/references/provisions.md +4 -4
- package/cli.mjs +356 -356
- package/package.json +1 -1
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
### Tools (jaz-api / direct)
|
|
15
15
|
- **`get_fixed_asset(resourceId: <id>)`** — step 1: pull the asset's actual `cost`, `acquisitionDate`, `usefulLifeMonths`, `depreciationMethod`, `salvageValue` to feed the calculator (use the live FA-register values — auditor wants those, not a cached estimate).
|
|
16
16
|
- **`generate_fa_summary(period_end: <disposalDate>)`** — step 1 alt: pull NBV directly from Jaz's running FA register. If this matches your independent calc, use it as the authoritative NBV. If they diverge: investigate (likely a missing depreciation journal).
|
|
17
|
-
- **`search_capsules(filter: {
|
|
17
|
+
- **`search_capsules(filter: {title: {eq: <capsule.name>}})`** — step 0 idempotency check. Each disposal is unique; duplicate disposal journals would corrupt the FA register reconciliation.
|
|
18
18
|
- **`search_accounts(filter: {name: {in: ['Vehicles', 'Accumulated Depreciation — Vehicles', 'Gain on Disposal', 'Loss on Disposal']}})`** — step 3.
|
|
19
19
|
- **`update_fixed_asset(resourceId: <id>, status: 'DISPOSED' | 'WRITTEN_OFF')`** OR **`POST /api/v1/mark-as-sold/fixed-assets`** OR **`POST /api/v1/discard-fixed-assets/{id}`** — step 5 manual FA-register update (the engine-skipped note step).
|
|
20
20
|
- **`generate_trial_balance(period_end: <disposalDate>)`** — step 6: verify cost + accumulated depreciation cleared; gain/loss in P&L.
|
|
@@ -31,7 +31,7 @@
|
|
|
31
31
|
### Step 0 — Idempotency check
|
|
32
32
|
|
|
33
33
|
```
|
|
34
|
-
search_capsules(filter: {
|
|
34
|
+
search_capsules(filter: {title: {eq: 'Disposal — Delivery Vehicle (Truck-001) — 2026-03-15'}})
|
|
35
35
|
```
|
|
36
36
|
|
|
37
37
|
If a result returns: halt. Disposal capsules are unique per asset+date — duplicates would double-book the disposal.
|
|
@@ -54,7 +54,7 @@ Cross-check with Jaz FA register:
|
|
|
54
54
|
```
|
|
55
55
|
generate_fa_summary(period_end: '2026-03-15', fixedAssetResourceId: <FA UUID>)
|
|
56
56
|
```
|
|
57
|
-
Should report `accumulatedDepreciation: 28500, netBookValue: 21500` matching the independent calc within 1 cent. Variance investigation: missing monthly depreciation journals (search via
|
|
57
|
+
Should report `accumulatedDepreciation: 28500, netBookValue: 21500` matching the independent calc within 1 cent. Variance investigation: missing monthly depreciation journals (search via **STOP — not selectable by filter.** Journals carry no capsule or fixed-asset link in either direction (`JournalFilter` declares neither; a journal row has no such field even at `view: 'full'`; `GET /capsules/{id}` returns only a `totalTransactions` count — measured 2026-09-07). A date+status search returns every matching DRAFT in the org, so it must never feed `bulk_update_journals` or `delete_journal`. Surface the capsule and its expected count to the practitioner and let them identify the journals.); finalize them BEFORE disposal recipe.
|
|
58
58
|
|
|
59
59
|
### Step 2 — Plan the recipe
|
|
60
60
|
|
|
@@ -174,7 +174,7 @@ Should reflect the disposal in the year's movement: `openingNbv − depreciation
|
|
|
174
174
|
| `plan_recipe` | 422 `acquisition_after_disposal` | Inputs swapped. Verify and re-run. |
|
|
175
175
|
| `execute_recipe` | 422 `account_not_found` for `Gain on Disposal` / `Loss on Disposal` | Step 3 incomplete. Create via `create_account(accountType: 'Other Revenue' / 'Other Expense', ...)`. |
|
|
176
176
|
| Step 5 manual update missed | (process error — Jaz FA continues auto-depreciating) | Surface to practitioner: "Asset `<name>` (resourceId `<id>`) is still ACTIVE in FA register but disposal journal posted. Auto-depreciation will continue. Run `update_fixed_asset(status: 'DISPOSED')` immediately." |
|
|
177
|
-
| `update_fixed_asset` to DISPOSED | 422 `pending_depreciation_journals` | DRAFT depreciation journals exist for periods after disposal date. Delete them:
|
|
177
|
+
| `update_fixed_asset` to DISPOSED | 422 `pending_depreciation_journals` | DRAFT depreciation journals exist for periods after disposal date. Delete them: **STOP — not selectable by filter.** Journals carry no capsule or fixed-asset link in either direction (`JournalFilter` declares neither; a journal row has no such field even at `view: 'full'`; `GET /capsules/{id}` returns only a `totalTransactions` count — measured 2026-09-07). A date+status search returns every matching DRAFT in the org, so it must never feed `bulk_update_journals` or `delete_journal`. Surface the capsule and its expected count to the practitioner and let them identify the journals. then `delete_journal` per result. |
|
|
178
178
|
| Cross-check | Calculator NBV ≠ FA register NBV | Investigate missing depreciation journals (recipe pre-emitted DRAFTs that weren't finalized monthly). Finalize all up to disposal date BEFORE running this recipe. |
|
|
179
179
|
| Recipe NBV ≠ TB Vehicles − TB Accum Dep | (audit failure) | Likely a manual journal touched Vehicles or Accum Dep without going through the recipe. Audit `generate_general_ledger(accountResourceId: <Vehicles>, period_end: <today>)`. |
|
|
180
180
|
|
|
@@ -196,6 +196,6 @@ Should reflect the disposal in the year's movement: `openingNbv − depreciation
|
|
|
196
196
|
|
|
197
197
|
- Year-end close — FA disposals discovered during the year-end review trigger this recipe per asset.
|
|
198
198
|
- Month-end close — ad-hoc invocation when a disposal happens mid-period.
|
|
199
|
-
- `audit-prep.md` step 8 — supporting schedule via `search_capsules(filter: {
|
|
199
|
+
- `audit-prep.md` step 8 — supporting schedule via `search_capsules(filter: {status: {eq: 'ACTIVE'}})` then narrow by date on the rows — **do not filter capsules by date**: `startDate`/`endDate` are declared on `CapsuleFilter` and pass validation, but every form of them answers `500 Internal Server Error` (measured 2026-09-07: `{gte}`, `{between}`, and `{gte}`+`{lte}` all 500) plus per-capsule recompute via `clio calc asset-disposal`. Auditor tests proceeds against bank statements, NBV against FA register.
|
|
200
200
|
- `fa-review.md` job — annual FA register review identifies candidates for disposal (assets fully depreciated, assets no longer in use, assets damaged) → invoke this recipe per identified disposal.
|
|
201
201
|
- Sibling recipe `declining-balance.md` — depreciation up to the disposal date; complete all DRAFT depreciation finalizations BEFORE running this recipe to ensure NBV is correct.
|
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
- **`generate_aged_ar(period_end: <date>)`** — step 1 input: pull AR aged into the same 5 buckets the calculator expects (current, 30d, 60d, 90d, 120d+).
|
|
16
16
|
- **`search_accounts(filter: {name: {in: ['Allowance for Doubtful Debts', 'Bad Debt Expense']}})`** — step 3.
|
|
17
17
|
- **`generate_trial_balance(period_end: <date>)`** — step 1 input: pull `existingProvision` from current `Allowance for Doubtful Debts` balance; step 5 verify post-journal balance matches calculated ECL.
|
|
18
|
-
- **`search_capsules(filter: {
|
|
18
|
+
- **`search_capsules(filter: {title: {eq: <capsule.name>}})`** — step 0 idempotency check (one ECL capsule per period; quarterly = 4 per FY).
|
|
19
19
|
- **`apply_credit_to_invoice(...)` / `create_customer_credit_note(...)`** — step 6 specific write-off pattern: when individual invoices are deemed unrecoverable, write them off via credit note OR direct payment with `paymentMethod: 'DEBT_WRITE_OFF'` (per memory rule).
|
|
20
20
|
|
|
21
21
|
### Cross-references
|
|
@@ -30,7 +30,7 @@
|
|
|
30
30
|
### Step 0 — Idempotency check
|
|
31
31
|
|
|
32
32
|
```
|
|
33
|
-
search_capsules(filter: {
|
|
33
|
+
search_capsules(filter: {title: {eq: 'FY2025 Year-End ECL True-Up'}})
|
|
34
34
|
```
|
|
35
35
|
|
|
36
36
|
If a result returns: halt. ECL is one-shot per period; duplicate would double-recognize.
|
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
### Tools (jaz-api / direct)
|
|
15
15
|
- **`list_bank_accounts()`** — used in step 3: resolve the disbursement target bank account by `name + currency` if the bank account resourceId isn't already known.
|
|
16
16
|
- **`search_accounts(filter: {name: {in: ['Loan Payable', 'Interest Expense']}})`** — used in step 3: confirm liability + expense GL accounts exist.
|
|
17
|
-
- **`search_capsules(filter: {
|
|
17
|
+
- **`search_capsules(filter: {title: {eq: <capsuleName>}})`** — used in step 0: detect duplicate setup before re-running. Loan capsules are unique per facility — duplicate creation is almost always an agent error.
|
|
18
18
|
- **`generate_trial_balance(period_end: <date>)`** — used in step 5: verify the loan liability balance matches the schedule's `closingBalance` column.
|
|
19
19
|
- **`update_journal(resourceId: <id>, saveAsDraft: false)`** — used in step 4 verification: lift draft journals to ACTIVE once practitioner confirms.
|
|
20
20
|
|
|
@@ -30,7 +30,7 @@
|
|
|
30
30
|
### Step 0 — Idempotency check
|
|
31
31
|
|
|
32
32
|
```
|
|
33
|
-
search_capsules(filter: {
|
|
33
|
+
search_capsules(filter: {title: {eq: 'Bank Loan — ABC Bank — 2025'}})
|
|
34
34
|
```
|
|
35
35
|
|
|
36
36
|
If a result returns: halt and surface "Loan capsule `<name>` already exists (resourceId `<id>`). Re-running the recipe would create a duplicate disbursement. Confirm the practitioner intent — if extending an existing loan, use `update_capsule` not `execute_recipe`."
|
|
@@ -95,7 +95,7 @@ Note: This is NOT the Jaz scheduler primitive. The recipe pre-emits all 60 journ
|
|
|
95
95
|
After the actual bank payment posts each month, the corresponding repayment journal already exists in the capsule as DRAFT. Monthly close action:
|
|
96
96
|
|
|
97
97
|
```
|
|
98
|
-
|
|
98
|
+
**STOP — not selectable by filter.** Journals carry no capsule or fixed-asset link in either direction (`JournalFilter` declares neither; a journal row has no such field even at `view: 'full'`; `GET /capsules/{id}` returns only a `totalTransactions` count — measured 2026-09-07). A date+status search returns every matching DRAFT in the org, so it must never feed `bulk_update_journals` or `delete_journal`. Surface the capsule and its expected count to the practitioner and let them identify the journals.
|
|
99
99
|
```
|
|
100
100
|
|
|
101
101
|
Returns the one DRAFT for that period (the engine pre-emitted it). Finalize:
|
|
@@ -131,7 +131,7 @@ After the FINAL period (60th repayment) is finalized:
|
|
|
131
131
|
| `execute_recipe` | 422 `currency_mismatch_bank_account` | Loan currency ≠ bank account currency. Either pass a `currencyAccount` for FX-on-disbursement, or pick a bank account in the loan's source currency (per `jaz-api/SKILL.md` rule 24). |
|
|
132
132
|
| `execute_recipe` | 409 `capsule_already_exists` | Duplicate setup. Step 0 idempotency check should have caught this — go back to step 0. |
|
|
133
133
|
| Scheduler | Repayment journal posts but interest amount is off by cents | Engine uses effective interest method per period; if the entity's materiality threshold is below 1 cent, narrow the assertion. Otherwise expected behavior. |
|
|
134
|
-
| Scheduler | Repayment journal does NOT post on expected date | `update_scheduler` may have paused it.
|
|
134
|
+
| Scheduler | Repayment journal does NOT post on expected date | `update_scheduler` may have paused it. **STOP — not selectable by filter.** Journals carry no capsule or fixed-asset link in either direction (`JournalFilter` declares neither; a journal row has no such field even at `view: 'full'`; `GET /capsules/{id}` returns only a `totalTransactions` count — measured 2026-09-07). A date+status search returns every matching DRAFT in the org, so it must never feed `bulk_update_journals` or `delete_journal`. Surface the capsule and its expected count to the practitioner and let them identify the journals. — if empty, check scheduler status. Resume or document the pause in your working notes. |
|
|
135
135
|
| `update_capsule` | 422 `capsule_locked` | The capsule is in a closed period (lock date passed). Lift the lock first via `update_account` lock_date OR add the new entry in the next open period. |
|
|
136
136
|
|
|
137
137
|
---
|
|
@@ -61,7 +61,7 @@ The recipe engine uses capsules automatically. But capsules also enable advanced
|
|
|
61
61
|
|
|
62
62
|
1. **One capsule per LIFECYCLE, not per period.** A 5-year loan = ONE capsule (not 12 per year). A construction project = ONE capsule (not one per contractor bill). The capsule's job is to span the full lifecycle.
|
|
63
63
|
|
|
64
|
-
2. **Use Capsule Types as the search axis, not Capsule Name.** Capsule names are unique per instance ("FY2025 Office Insurance"); types are reusable ("Prepaid Expenses"). `search_capsules(filter: {
|
|
64
|
+
2. **Use Capsule Types as the search axis, not Capsule Name.** Capsule names are unique per instance ("FY2025 Office Insurance"); types are reusable ("Prepaid Expenses"). `search_capsules(filter: {status: {eq: 'ACTIVE'}}) (capsule type is not filterable — see `jobs/references/building-blocks.md` § Filter limits)` returns ALL prepaid capsules across history.
|
|
65
65
|
|
|
66
66
|
3. **Tie capsule entries back for the auditor.** `generate_general_ledger` does NOT group by capsule -- `groupBy` is ACCOUNT, CONTACT, TRANSACTION or RELATIONSHIP, and `CAPSULE` returns 422 (verified live 2026-09-01). Auditor sample-test: pick 3 capsules per type, read each with `get_capsule` to get its transaction resource ids, then pull those documents (bills, invoices, journals) directly. Same evidence, one more hop.
|
|
67
67
|
|
|
@@ -87,9 +87,9 @@ create_cash_out_entry(..., capsuleResourceId: <capsule id>)
|
|
|
87
87
|
**Search and audit patterns:**
|
|
88
88
|
|
|
89
89
|
```
|
|
90
|
-
search_capsules(filter: {
|
|
90
|
+
search_capsules(filter: {status: {eq: 'ACTIVE'}}) # capsule type is not filterable — narrow on the row's `type` / `capsuleType.name`
|
|
91
91
|
# All open loan capsules — feed into year-end-close.md Y6 reclassification
|
|
92
|
-
|
|
92
|
+
**STOP — not selectable by filter.** Journals carry no capsule or fixed-asset link in either direction (`JournalFilter` declares neither; a journal row has no such field even at `view: 'full'`; `GET /capsules/{id}` returns only a `totalTransactions` count — measured 2026-09-07). A date+status search returns every matching DRAFT in the org, so it must never feed `bulk_update_journals` or `delete_journal`. Surface the capsule and its expected count to the practitioner and let them identify the journals.
|
|
93
93
|
# Full GL for one capsule — the auditor's view
|
|
94
94
|
get_capsule(resourceId) # returns the capsule's transactions; GL cannot group by capsule
|
|
95
95
|
# Period activity grouped by capsule — the practitioner's view
|
|
@@ -15,10 +15,10 @@ CWIP costs accumulate as construction progresses — multiple bills from contrac
|
|
|
15
15
|
- **`create_fixed_asset(...)`** — step 4: register the completed asset in Jaz native FA register; from this point forward, Jaz auto-posts SL depreciation.
|
|
16
16
|
|
|
17
17
|
### Tools (jaz-api / direct)
|
|
18
|
-
- **`search_capsules(filter: {
|
|
18
|
+
- **`search_capsules(filter: {title: {eq: <project>}})`** — step 1 idempotency check.
|
|
19
19
|
- **`search_accounts(filter: {name: {in: ['Capital Work-in-Progress', '<target FA category>', '<target Accumulated Depreciation>']}})`** — step 0 + step 4.
|
|
20
20
|
- **`generate_general_ledger(accountResourceId: <CWIP id>, period_start: <project start>, period_end: <today>)`** — step 3: pull all CWIP entries to confirm the accumulated cost.
|
|
21
|
-
-
|
|
21
|
+
- ****STOP — not selectable by filter.** Journals carry no capsule or fixed-asset link in either direction (`JournalFilter` declares neither; a journal row has no such field even at `view: 'full'`; `GET /capsules/{id}` returns only a `totalTransactions` count — measured 2026-09-07). A date+status search returns every matching DRAFT in the org, so it must never feed `bulk_update_journals` or `delete_journal`. Surface the capsule and its expected count to the practitioner and let them identify the journals.** — step 3 alt: pull all bills attached to the project capsule.
|
|
22
22
|
- **`generate_trial_balance(period_end: <date>)`** — step 5 verify CWIP balance is zero post-transfer; FA balance reflects new asset.
|
|
23
23
|
|
|
24
24
|
### Cross-references
|
|
@@ -50,7 +50,7 @@ create_capsule(
|
|
|
50
50
|
)
|
|
51
51
|
```
|
|
52
52
|
|
|
53
|
-
Each construction project gets its own capsule. The capsule is the audit trail — every bill paid for this project, plus the eventual transfer journal, attaches to it. Auditor can pull
|
|
53
|
+
Each construction project gets its own capsule. The capsule is the audit trail — every bill paid for this project, plus the eventual transfer journal, attaches to it. Auditor can pull **STOP — not selectable by filter.** Journals carry no capsule or fixed-asset link in either direction (`JournalFilter` declares neither; a journal row has no such field even at `view: 'full'`; `GET /capsules/{id}` returns only a `totalTransactions` count — measured 2026-09-07). A date+status search returns every matching DRAFT in the org, so it must never feed `bulk_update_journals` or `delete_journal`. Surface the capsule and its expected count to the practitioner and let them identify the journals. and see the full cost build.
|
|
54
54
|
|
|
55
55
|
### Step 2 — Accumulate construction costs (multiple bills over months)
|
|
56
56
|
|
|
@@ -98,7 +98,7 @@ generate_general_ledger(accountResourceId: <CWIP GL>, period_start: <project sta
|
|
|
98
98
|
Confirm the accumulated CWIP balance matches expectations vs the project's estimated cost. Variance > 10% → flag for budget review.
|
|
99
99
|
|
|
100
100
|
```
|
|
101
|
-
|
|
101
|
+
**STOP — not selectable by filter.** Journals carry no capsule or fixed-asset link in either direction (`JournalFilter` declares neither; a journal row has no such field even at `view: 'full'`; `GET /capsules/{id}` returns only a `totalTransactions` count — measured 2026-09-07). A date+status search returns every matching DRAFT in the org, so it must never feed `bulk_update_journals` or `delete_journal`. Surface the capsule and its expected count to the practitioner and let them identify the journals.
|
|
102
102
|
```
|
|
103
103
|
|
|
104
104
|
Identify unpaid bills attached to the project — payment timing matters for cash-flow planning.
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
- **`clio calc depreciation --cost <c> --salvage <s> --life <years> --method <ddb|150db|sl> --frequency <annual|monthly> --json`** — used in step 1: full depreciation schedule. Returns `{ totalDepreciation, schedule[n] }` where each row carries `period`, `openingBookValue`, `depreciationAmount`, `accumulatedDepreciation`, `closingBookValue`. Final period absorbs rounding to land at salvage value exactly.
|
|
13
13
|
|
|
14
14
|
### Tools (jaz-api / direct)
|
|
15
|
-
- **`search_capsules(filter: {
|
|
15
|
+
- **`search_capsules(filter: {title: {eq: <capsule.name>}})`** — step 0 idempotency check. One depreciation capsule per asset; duplicate setup is almost always an error.
|
|
16
16
|
- **`search_accounts(filter: {name: {in: ['Vehicles', 'Accumulated Depreciation — Vehicles', 'Depreciation Expense']}})`** — step 3: confirm the asset, contra-asset, and expense GL accounts exist.
|
|
17
17
|
- **`generate_trial_balance(period_end: <date>)`** — step 5: verify NBV matches schedule.
|
|
18
18
|
- **`bulk_update_journals(items: [{resourceId: <id>, saveAsDraft: false}, ...])`** — step 5 monthly: finalize this period's pre-emitted DRAFT depreciation journal.
|
|
@@ -29,7 +29,7 @@
|
|
|
29
29
|
### Step 0 — Idempotency check
|
|
30
30
|
|
|
31
31
|
```
|
|
32
|
-
search_capsules(filter: {
|
|
32
|
+
search_capsules(filter: {title: {eq: 'DDB Depreciation — 5 years (Delivery Vehicle FY2025)'}})
|
|
33
33
|
```
|
|
34
34
|
|
|
35
35
|
If a result returns: halt and surface "Depreciation capsule for asset `<name>` already exists. Re-running would create duplicate depreciation journals. Confirm — if revising the depreciation schedule (changed useful life or salvage), close the existing capsule, reverse remaining DRAFT journals via `delete_journal`, then re-execute."
|
|
@@ -93,7 +93,7 @@ If the asset MUST be in the FA register for reporting reasons (e.g. fixed-assets
|
|
|
93
93
|
For each month after recipe execution, this period's DRAFT depreciation journal already exists. Monthly close action:
|
|
94
94
|
|
|
95
95
|
```
|
|
96
|
-
|
|
96
|
+
**STOP — not selectable by filter.** Journals carry no capsule or fixed-asset link in either direction (`JournalFilter` declares neither; a journal row has no such field even at `view: 'full'`; `GET /capsules/{id}` returns only a `totalTransactions` count — measured 2026-09-07). A date+status search returns every matching DRAFT in the org, so it must never feed `bulk_update_journals` or `delete_journal`. Surface the capsule and its expected count to the practitioner and let them identify the journals.
|
|
97
97
|
update_journal(resourceId: <journal id>, saveAsDraft: false)
|
|
98
98
|
```
|
|
99
99
|
|
|
@@ -140,4 +140,4 @@ After the FINAL period (month 60):
|
|
|
140
140
|
- Year-end close — full FY-end depreciation reconciliation: sum 12 monthly journals against `clio calc depreciation --frequency annual` cross-check; auditor will sample-test.
|
|
141
141
|
- Data migration — opening accumulated depreciation loaded via conversion (Conversion Clearing > Accumulated Depreciation account); recipe runs forward from the migration date with `cost: <NBV at migration>` instead of original cost. Useful-life-years should be `remaining life`, not original.
|
|
142
142
|
- Sibling recipe `asset-disposal.md` — end-of-life de-recognition.
|
|
143
|
-
- `audit-prep.md` step 8 — supporting schedule via `search_capsules(filter: {
|
|
143
|
+
- `audit-prep.md` step 8 — supporting schedule via `search_capsules(filter: {status: {eq: 'ACTIVE'}}) (capsule type is not filterable — see `jobs/references/building-blocks.md` § Filter limits)` + per-capsule `clio calc depreciation` recompute.
|
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
- **`create_contact(...)` with `customer: true`** — step 3 fallback: create the customer if `search_contacts` returns empty.
|
|
17
17
|
- **`search_accounts(filter: {name: {in: ['<deferred liability GL>', '<revenue GL>']}})`** — step 3: confirm both GL accounts exist.
|
|
18
18
|
- **`generate_trial_balance(period_end: <date>)`** — step 5: verify Deferred Revenue balance unwinds correctly.
|
|
19
|
-
- **`search_capsules(filter: {
|
|
19
|
+
- **`search_capsules(filter: {title: {eq: <capsule.name>}})`** — step 0 idempotency check.
|
|
20
20
|
- **`finalize_invoice(resourceId: <id>)`** — step 4 fallback: lift the upfront invoice from DRAFT to ACTIVE once practitioner confirms the engagement is genuinely starting.
|
|
21
21
|
- **`bulk_update_journals(items: [{resourceId: <id>, saveAsDraft: false}, ...])`** — step 5 monthly: finalize this period's pre-emitted DRAFT recognition journal.
|
|
22
22
|
|
|
@@ -32,7 +32,7 @@
|
|
|
32
32
|
### Step 0 — Idempotency check
|
|
33
33
|
|
|
34
34
|
```
|
|
35
|
-
search_capsules(filter: {
|
|
35
|
+
search_capsules(filter: {title: {eq: 'FY2025 Acme Annual License'}})
|
|
36
36
|
```
|
|
37
37
|
|
|
38
38
|
If a result returns: halt and surface "Deferred revenue capsule `<name>` already exists. Re-running would create a duplicate upfront invoice. Confirm intent — if extending an existing arrangement, use `update_capsule` not `execute_recipe`."
|
|
@@ -94,7 +94,7 @@ All N journals attach to the same capsule. Customer payment: handled separately
|
|
|
94
94
|
For each month after recipe execution, the corresponding DRAFT recognition journal already exists in the capsule. Monthly close action:
|
|
95
95
|
|
|
96
96
|
```
|
|
97
|
-
|
|
97
|
+
**STOP — not selectable by filter.** Journals carry no capsule or fixed-asset link in either direction (`JournalFilter` declares neither; a journal row has no such field even at `view: 'full'`; `GET /capsules/{id}` returns only a `totalTransactions` count — measured 2026-09-07). A date+status search returns every matching DRAFT in the org, so it must never feed `bulk_update_journals` or `delete_journal`. Surface the capsule and its expected count to the practitioner and let them identify the journals.
|
|
98
98
|
update_journal(resourceId: <journal id>, saveAsDraft: false)
|
|
99
99
|
```
|
|
100
100
|
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
- **`clio calc dividend --amount <gross> --withholding-rate <%> --currency <code> --json`** — used in step 1: computes net dividend payable to shareholder + withholding tax to remit. Returns `{ grossAmount, withholdingTax, netToShareholder }`.
|
|
13
13
|
|
|
14
14
|
### Tools (jaz-api / direct)
|
|
15
|
-
- **`search_capsules(filter: {
|
|
15
|
+
- **`search_capsules(filter: {title: {eq: <capsule.name>}})`** — step 0 idempotency check. Each declared dividend gets its own capsule; duplicate setup means double-declaration.
|
|
16
16
|
- **`search_accounts(filter: {name: {in: ['Retained Earnings', 'Dividends Payable', 'Withholding Tax Payable']}})`** — step 3.
|
|
17
17
|
- **`search_contacts(filter: {name: {eq: <shareholder>}})`** — step 3 (the payee — typically a shareholder or a holding entity).
|
|
18
18
|
- **`generate_balance_sheet(period_end: <date>)`** — step 5 verification: Retained Earnings reduced; Dividends Payable nil after payment.
|
|
@@ -30,7 +30,7 @@
|
|
|
30
30
|
### Step 0 — Idempotency check
|
|
31
31
|
|
|
32
32
|
```
|
|
33
|
-
search_capsules(filter: {
|
|
33
|
+
search_capsules(filter: {title: {eq: 'FY2025 Final Dividend'}})
|
|
34
34
|
```
|
|
35
35
|
|
|
36
36
|
If a result returns: halt and surface "Dividend capsule `<name>` already exists. Re-running would create a duplicate declaration. Confirm — if posting an interim dividend, use a different capsule name (e.g., `Q3 2025 Interim Dividend`)."
|
|
@@ -25,9 +25,9 @@ The two patterns share the same `Employee Benefits` capsule type but use differe
|
|
|
25
25
|
- **`clio calc accrued-expense --amount <quarterly bonus> --periods 1 --json`** — bonus cross-check.
|
|
26
26
|
|
|
27
27
|
### Tools (jaz-api / direct)
|
|
28
|
-
- **`search_capsules(filter: {
|
|
28
|
+
- **`search_capsules(filter: {status: {eq: 'ACTIVE'}}) (capsule type is not filterable — see `jobs/references/building-blocks.md` § Filter limits)`** — step 0: discover existing leave + bonus capsules.
|
|
29
29
|
- **`search_accounts(filter: {name: {in: ['Leave Expense', 'Leave Liability', 'Bonus Expense', 'Bonus Payable']}})`** — step 3.
|
|
30
|
-
- **`search_journals(filter: {
|
|
30
|
+
- **`search_journals(filter: {tags: {eq: 'leave-accrual'}, valueDate: {between: [<period-start>, <period-end>]}, status: {eq: 'DRAFT'}})`** — step 5 monthly: pull this period's pre-emitted leave DRAFT.
|
|
31
31
|
- **`bulk_update_journals(items: [{resourceId: <id>, saveAsDraft: false}, ...])`** — monthly finalize.
|
|
32
32
|
- **`generate_trial_balance(period_end: <date>)`** — verification.
|
|
33
33
|
- For year-end true-up: see `year-end-close.md` Y2 — manual journal pattern with HR-supplied actuals.
|
|
@@ -44,7 +44,7 @@ The two patterns share the same `Employee Benefits` capsule type but use differe
|
|
|
44
44
|
### Step 0A — Idempotency check
|
|
45
45
|
|
|
46
46
|
```
|
|
47
|
-
search_capsules(filter: {
|
|
47
|
+
search_capsules(filter: {title: {eq: 'Annual Leave Accrual — FY2025'}})
|
|
48
48
|
```
|
|
49
49
|
|
|
50
50
|
If returns: halt. One leave capsule per FY.
|
|
@@ -82,7 +82,7 @@ Engine emits **12 future-dated DRAFT journals** (one per month, fixed $7,000 eac
|
|
|
82
82
|
### Step 5A — Monthly action
|
|
83
83
|
|
|
84
84
|
```
|
|
85
|
-
|
|
85
|
+
**STOP — not selectable by filter.** Journals carry no capsule or fixed-asset link in either direction (`JournalFilter` declares neither; a journal row has no such field even at `view: 'full'`; `GET /capsules/{id}` returns only a `totalTransactions` count — measured 2026-09-07). A date+status search returns every matching DRAFT in the org, so it must never feed `bulk_update_journals` or `delete_journal`. Surface the capsule and its expected count to the practitioner and let them identify the journals.
|
|
86
86
|
update_journal(resourceId: <journal id>, saveAsDraft: false)
|
|
87
87
|
```
|
|
88
88
|
|
|
@@ -99,7 +99,7 @@ Year-end true-up: see `year-end-close.md` Y2a. Compare actual unused-leave-balan
|
|
|
99
99
|
### Step 0B — Idempotency check
|
|
100
100
|
|
|
101
101
|
```
|
|
102
|
-
search_capsules(filter: {
|
|
102
|
+
search_capsules(filter: {title: {startWith: 'Bonus Accrual — Q'}})
|
|
103
103
|
```
|
|
104
104
|
|
|
105
105
|
If a current-quarter result returns: halt. One bonus capsule per quarter.
|
|
@@ -108,7 +108,7 @@ If a current-quarter result returns: halt. One bonus capsule per quarter.
|
|
|
108
108
|
|
|
109
109
|
Estimate quarterly bonus per the entity's bonus policy estimation method:
|
|
110
110
|
- `revenue_pct` (e.g., 5% of quarterly revenue): pull `generate_profit_and_loss(period_start: <quarter-start>, period_end: <quarter-end>)`, multiply Operating Revenue by the percentage.
|
|
111
|
-
- `prior_quarter`: pull last quarter's posted bonus journal via `search_journals(filter: {
|
|
111
|
+
- `prior_quarter`: pull last quarter's posted bonus journal via `search_journals(filter: {tags: {eq: 'bonus-accrual'}, valueDate: <prior-quarter>-end})`.
|
|
112
112
|
- `fixed_amount`: use the bonus policy's fixed amount per quarter.
|
|
113
113
|
|
|
114
114
|
```
|
|
@@ -157,7 +157,7 @@ Per quarter-end-close (`quarter-end-close.md`):
|
|
|
157
157
|
| `plan_recipe` (bonus) | 422 `unsupported_recipe` | Use `accrued-expense` for bonus — leave is `leave-accrual`. |
|
|
158
158
|
| `execute_recipe` | 422 `account_not_found` | Step 3 incomplete. Common gap: `Bonus Payable` (most CoAs lack); create via `create_account(accountType: 'Current Liability')`. |
|
|
159
159
|
| Verification | Leave Liability balance > expected | Practitioner posted manual leave-utilization journals against the wrong account, OR the original recipe estimate was high. Year-end Y2a true-up will catch this. |
|
|
160
|
-
| Verification | Bonus accrual nonzero after quarterly reversal posts | Reversal didn't finalize.
|
|
160
|
+
| Verification | Bonus accrual nonzero after quarterly reversal posts | Reversal didn't finalize. **STOP — not selectable by filter.** Journals carry no capsule or fixed-asset link in either direction (`JournalFilter` declares neither; a journal row has no such field even at `view: 'full'`; `GET /capsules/{id}` returns only a `totalTransactions` count — measured 2026-09-07). A date+status search returns every matching DRAFT in the org, so it must never feed `bulk_update_journals` or `delete_journal`. Surface the capsule and its expected count to the practitioner and let them identify the journals. then `bulk_finalize_drafts`. |
|
|
161
161
|
| 13th-month bonus (PH-specific) | (process — separate from Q4 bonus) | Use `accrued-expense` recipe with `amount: <annual base / 12>`, `periods: 12`, accruing throughout FY. Settle in December via Dr Bonus Payable / Cr Cash. |
|
|
162
162
|
|
|
163
163
|
---
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
- **`clio calc fixed-deposit --principal <p> --rate <annual %> --term <months> --start-date <YYYY-MM-DD> --currency <code> [--compound monthly|annually] --json`** — used in step 1: compute monthly accrual amounts. Default simple interest; `--compound` for compound interest. Returns `{ totalInterest, schedule[n] }` where each row carries `period`, `accrualDate`, `accrualAmount`, `accruedToDate`, `journal`.
|
|
13
13
|
|
|
14
14
|
### Tools (jaz-api / direct)
|
|
15
|
-
- **`search_capsules(filter: {
|
|
15
|
+
- **`search_capsules(filter: {title: {eq: <capsule.name>}})`** — step 0 idempotency check.
|
|
16
16
|
- **`search_accounts(filter: {name: {in: ['Fixed Deposit Receivable', 'Accrued Interest Receivable', 'Interest Income']}})`** — step 3.
|
|
17
17
|
- **`search_contacts(filter: {supplier: true, name: {eq: <bank>}})`** — step 3 optional: bank contact for narrative.
|
|
18
18
|
- **`generate_trial_balance(period_end: <date>)`** — step 5 verify accrued interest unwinds; FD principal stays at carrying amount until maturity.
|
|
@@ -30,7 +30,7 @@
|
|
|
30
30
|
### Step 0 — Idempotency check
|
|
31
31
|
|
|
32
32
|
```
|
|
33
|
-
search_capsules(filter: {
|
|
33
|
+
search_capsules(filter: {title: {eq: 'DBS FD — SGD 100,000 — 12 months — 3.5% (FY2025)'}})
|
|
34
34
|
```
|
|
35
35
|
|
|
36
36
|
If a result returns: halt. Each FD placement is unique; duplicate setup means double-counted financial asset.
|
|
@@ -90,7 +90,7 @@ Returns: `{ capsule: {resourceId, type, title}, steps: [{step, action, status, r
|
|
|
90
90
|
For each month after recipe execution, this period's DRAFT accrual journal already exists. Monthly close action:
|
|
91
91
|
|
|
92
92
|
```
|
|
93
|
-
|
|
93
|
+
**STOP — not selectable by filter.** Journals carry no capsule or fixed-asset link in either direction (`JournalFilter` declares neither; a journal row has no such field even at `view: 'full'`; `GET /capsules/{id}` returns only a `totalTransactions` count — measured 2026-09-07). A date+status search returns every matching DRAFT in the org, so it must never feed `bulk_update_journals` or `delete_journal`. Surface the capsule and its expected count to the practitioner and let them identify the journals.
|
|
94
94
|
update_journal(resourceId: <journal id>, saveAsDraft: false)
|
|
95
95
|
```
|
|
96
96
|
|
|
@@ -102,7 +102,7 @@ Verify after finalize:
|
|
|
102
102
|
|
|
103
103
|
At maturity (month 12), finalize the maturity cash-in:
|
|
104
104
|
```
|
|
105
|
-
|
|
105
|
+
**STOP — not selectable by filter.** Journals carry no capsule or fixed-asset link in either direction (`JournalFilter` declares neither; a journal row has no such field even at `view: 'full'`; `GET /capsules/{id}` returns only a `totalTransactions` count — measured 2026-09-07). A date+status search returns every matching DRAFT in the org, so it must never feed `bulk_update_journals` or `delete_journal`. Surface the capsule and its expected count to the practitioner and let them identify the journals.
|
|
106
106
|
update_cash_in(resourceId: <cash-in id>, saveAsDraft: false)
|
|
107
107
|
```
|
|
108
108
|
|
|
@@ -145,5 +145,5 @@ If the bank auto-rolls the FD at maturity: do NOT close the capsule. Instead, po
|
|
|
145
145
|
|
|
146
146
|
- Month-end close — invoked monthly to finalize this period's pre-emitted accrual DRAFT for each existing FD capsule. New FD placements during the period: invoke recipe; this period's accrual auto-included in the bulk_finalize queue.
|
|
147
147
|
- Year-end close — final FY accrual cross-check + classification (current vs non-current depending on remaining term at FY-end).
|
|
148
|
-
- `audit-prep.md` step 8 — supporting schedule via `search_capsules(filter: {
|
|
148
|
+
- `audit-prep.md` step 8 — supporting schedule via `search_capsules(filter: {status: {eq: 'ACTIVE'}}) (capsule type is not filterable — see `jobs/references/building-blocks.md` § Filter limits)` + per-capsule recompute via `clio calc fixed-deposit`. Auditor reconciles to bank confirmation letters.
|
|
149
149
|
- `bank-loan.md` — mirror pattern (money out instead of in, expense vs income).
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
- **`clio calc lease --payment <monthly> --term <months> --rate <annual %> --start-date <YYYY-MM-DD> --currency <code> --json`** — used in step 1: independently produce `{ presentValue, totalInterest, schedule[n] }` (monthly payment splits into interest + principal portions, principal reducing the liability).
|
|
13
13
|
|
|
14
14
|
### Tools (jaz-api / direct)
|
|
15
|
-
- **`search_capsules(filter: {
|
|
15
|
+
- **`search_capsules(filter: {title: {eq: <capsuleName>}})`** — step 0 idempotency check.
|
|
16
16
|
- **`search_accounts(filter: {name: {in: ['Right-of-Use Asset', 'Lease Liability', 'Interest Expense — Leases']}})`** — step 3.
|
|
17
17
|
- **`search_contacts(filter: {supplier: true, name: {eq: <lessor>}})`** — step 3 (lease counterparty).
|
|
18
18
|
- **`create_fixed_asset(...)`** — step 4 manual: register the ROU asset in Jaz native FA. `cost` = PV from calculator, `usefulLifeMonths` = lease term, `depreciationMethod` = 'sl' (straight-line). Jaz auto-posts monthly depreciation thereafter.
|
|
@@ -32,7 +32,7 @@
|
|
|
32
32
|
### Step 0 — Idempotency check
|
|
33
33
|
|
|
34
34
|
```
|
|
35
|
-
search_capsules(filter: {
|
|
35
|
+
search_capsules(filter: {title: {eq: 'Office Lease — Marina One — 36 months'}})
|
|
36
36
|
```
|
|
37
37
|
|
|
38
38
|
If a result returns: halt and surface "Lease capsule `<name>` already exists. Re-running would create a duplicate ROU + Lease Liability. Confirm intent — if modifying lease terms (rent revision, term extension), use the IFRS 16 lease re-measurement pattern (manual journal); do NOT re-execute the recipe."
|
|
@@ -116,7 +116,7 @@ For each month after recipe execution:
|
|
|
116
116
|
**5a — Finalize this period's unwinding journal (3-line, lease payment):**
|
|
117
117
|
|
|
118
118
|
```
|
|
119
|
-
|
|
119
|
+
**STOP — not selectable by filter.** Journals carry no capsule or fixed-asset link in either direction (`JournalFilter` declares neither; a journal row has no such field even at `view: 'full'`; `GET /capsules/{id}` returns only a `totalTransactions` count — measured 2026-09-07). A date+status search returns every matching DRAFT in the org, so it must never feed `bulk_update_journals` or `delete_journal`. Surface the capsule and its expected count to the practitioner and let them identify the journals.
|
|
120
120
|
update_journal(resourceId: <journal id>, saveAsDraft: false)
|
|
121
121
|
```
|
|
122
122
|
|
|
@@ -173,5 +173,5 @@ After the FINAL period (month 36):
|
|
|
173
173
|
- Month-end close — invoked monthly to finalize this period's pre-emitted unwinding DRAFT (5a) + verify Jaz auto-posted ROU depreciation (5b).
|
|
174
174
|
- `jobs/references/year-end-close.md` Y6 — current/non-current reclassification (manual annual journal) + auditor sample-test of the lease schedule via `clio calc lease`.
|
|
175
175
|
- Data migration — opening lease balances loaded via conversion (`jaz-conversion/SKILL.md § Option 2` with the Conversion Clearing > Lease account); recipe runs forward only from migration date.
|
|
176
|
-
- `audit-prep.md` step 8 — supporting schedule via `search_capsules(filter: {
|
|
176
|
+
- `audit-prep.md` step 8 — supporting schedule via `search_capsules(filter: {status: {eq: 'ACTIVE'}}) (capsule type is not filterable — see `jobs/references/building-blocks.md` § Filter limits)` + per-capsule `clio calc lease` recompute. Auditor reconciles to TB Lease Liability + ROU Asset NBV.
|
|
177
177
|
- Sibling recipe `hire-purchase.md` — same engine, different useful-life parameter.
|
|
@@ -16,8 +16,8 @@ Intercompany requires posting MIRRORED entries in TWO different Jaz orgs (Entity
|
|
|
16
16
|
- **`apply_credit_to_invoice(...)` / `apply_credit_to_bill(...)`** — netting if both entities owe each other (one entity's invoice clears against the other's bill via credit note).
|
|
17
17
|
|
|
18
18
|
### Search tools for reconciliation
|
|
19
|
-
-
|
|
20
|
-
-
|
|
19
|
+
- ****STOP — not selectable by filter.** Journals carry no capsule or fixed-asset link in either direction (`JournalFilter` declares neither; a journal row has no such field even at `view: 'full'`; `GET /capsules/{id}` returns only a `totalTransactions` count — measured 2026-09-07). A date+status search returns every matching DRAFT in the org, so it must never feed `bulk_update_journals` or `delete_journal`. Surface the capsule and its expected count to the practitioner and let them identify the journals.** — pull all Entity A intercompany invoices.
|
|
20
|
+
- ****STOP — not selectable by filter.** Journals carry no capsule or fixed-asset link in either direction (`JournalFilter` declares neither; a journal row has no such field even at `view: 'full'`; `GET /capsules/{id}` returns only a `totalTransactions` count — measured 2026-09-07). A date+status search returns every matching DRAFT in the org, so it must never feed `bulk_update_journals` or `delete_journal`. Surface the capsule and its expected count to the practitioner and let them identify the journals.** — pull all Entity B intercompany bills.
|
|
21
21
|
- **`generate_general_ledger(accountResourceId: <Intercompany Receivable>, period_end: <date>)` / same for Intercompany Payable** — eliminate at consolidation.
|
|
22
22
|
|
|
23
23
|
### Multi-org targeting (CRITICAL)
|
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
- **`create_contact(...)`** — used in step 3 fallback: create the supplier if `search_contacts` returns empty.
|
|
17
17
|
- **`search_accounts(filter: {name: {in: ['<asset GL>', '<expense GL>']}})`** — used in step 3: confirm the prepaid asset and expense GL accounts exist; if missing, surface to practitioner before retry.
|
|
18
18
|
- **`generate_trial_balance(period_end: <date>)`** — used in step 5: verify the recognition has unwound the prepaid balance correctly.
|
|
19
|
-
- **`search_capsules(filter: {
|
|
19
|
+
- **`search_capsules(filter: {title: {eq: <capsule.name>}})`** — used to detect duplicate setup in re-runs.
|
|
20
20
|
|
|
21
21
|
### Cross-references
|
|
22
22
|
- Operational context: invoked during month-end close (initial setup of new prepaids; ongoing recognition runs from the scheduler created here).
|
|
@@ -86,7 +86,7 @@ Note: This is NOT the Jaz scheduler primitive (`create_scheduled_journal`). The
|
|
|
86
86
|
For each month after recipe execution, the corresponding DRAFT journal already exists in the capsule. Monthly close action:
|
|
87
87
|
|
|
88
88
|
```
|
|
89
|
-
|
|
89
|
+
**STOP — not selectable by filter.** Journals carry no capsule or fixed-asset link in either direction (`JournalFilter` declares neither; a journal row has no such field even at `view: 'full'`; `GET /capsules/{id}` returns only a `totalTransactions` count — measured 2026-09-07). A date+status search returns every matching DRAFT in the org, so it must never feed `bulk_update_journals` or `delete_journal`. Surface the capsule and its expected count to the practitioner and let them identify the journals.
|
|
90
90
|
```
|
|
91
91
|
|
|
92
92
|
Returns the one DRAFT for that period. Finalize:
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
- **`clio calc provision --amount <undiscounted total> --rate <annual %> --term <months> --start-date <YYYY-MM-DD> --currency <code> --json`** — used in step 1: compute PV at recognition + per-period unwinding charge. Returns `{ presentValue, totalUnwindingCharge, schedule[n] }` where each row has `period`, `openingProvision`, `unwindingCharge`, `closingProvision`.
|
|
13
13
|
|
|
14
14
|
### Tools (jaz-api / direct)
|
|
15
|
-
- **`search_capsules(filter: {
|
|
15
|
+
- **`search_capsules(filter: {title: {eq: <capsule.name>}})`** — step 0 idempotency check.
|
|
16
16
|
- **`search_accounts(filter: {name: {in: ['Provision for Warranties', 'Finance Cost', 'Warranty Expense']}})`** — step 3.
|
|
17
17
|
- **`generate_trial_balance(period_end: <date>)`** — step 5 verify provision balance matches schedule's `closingProvision`.
|
|
18
18
|
- **`bulk_update_journals(items: [{resourceId: <id>, saveAsDraft: false}, ...])`** — step 5 monthly finalize.
|
|
@@ -29,7 +29,7 @@
|
|
|
29
29
|
### Step 0 — Idempotency check
|
|
30
30
|
|
|
31
31
|
```
|
|
32
|
-
search_capsules(filter: {
|
|
32
|
+
search_capsules(filter: {title: {eq: 'Warranty Provision — FY2025-FY2029'}})
|
|
33
33
|
```
|
|
34
34
|
|
|
35
35
|
If a result returns: halt. Provision capsules are unique per obligation; duplicate setup means double-recognition.
|
|
@@ -90,7 +90,7 @@ Returns: `{ capsule: {resourceId, type, title}, steps: [{step, action, status, r
|
|
|
90
90
|
For each month after recipe execution:
|
|
91
91
|
|
|
92
92
|
```
|
|
93
|
-
|
|
93
|
+
**STOP — not selectable by filter.** Journals carry no capsule or fixed-asset link in either direction (`JournalFilter` declares neither; a journal row has no such field even at `view: 'full'`; `GET /capsules/{id}` returns only a `totalTransactions` count — measured 2026-09-07). A date+status search returns every matching DRAFT in the org, so it must never feed `bulk_update_journals` or `delete_journal`. Surface the capsule and its expected count to the practitioner and let them identify the journals.
|
|
94
94
|
update_journal(resourceId: <journal id>, saveAsDraft: false)
|
|
95
95
|
```
|
|
96
96
|
|
|
@@ -156,5 +156,5 @@ If actual settlement amount differs from estimated $500,000 (highly likely for w
|
|
|
156
156
|
|
|
157
157
|
- Year-end close (Y5) — year-end provision remeasurement per IAS 37.59. Review each `Provisions` capsule's underlying assumptions vs current data; trigger manual remeasurement if needed.
|
|
158
158
|
- Month-end close — finalize this period's pre-emitted unwinding DRAFT for each existing provision capsule.
|
|
159
|
-
- `audit-prep.md` step 8 — supporting schedule via `search_capsules(filter: {
|
|
159
|
+
- `audit-prep.md` step 8 — supporting schedule via `search_capsules(filter: {status: {eq: 'ACTIVE'}}) (capsule type is not filterable — see `jobs/references/building-blocks.md` § Filter limits)` + per-capsule recompute via `clio calc provision`. Auditor tests assumptions (cash flow estimate, discount rate, term).
|
|
160
160
|
- Sibling `bad-debt-provision.md` (engine name `ecl`) — much simpler IFRS 9 ECL pattern, no PV unwinding.
|