jaz-clio 5.4.20 → 5.4.24

package/assets/skills/api/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: jaz-api
-version: 5.4.20
+version: 5.4.24
 description: >-
   Use this skill whenever you call, debug, or review code that touches the Jaz
   REST API. Covers field names, response shapes, 141 production gotchas, error

package/assets/skills/cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: jaz-cli
-version: 5.4.20
+version: 5.4.24
 description: >-
   Use this skill when running Clio CLI commands, building shell scripts with
   Clio, debugging auth issues, understanding --json output, paginating results,

package/assets/skills/conversion/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: jaz-conversion
-version: 5.4.20
+version: 5.4.24
 description: >-
   Use this skill when migrating accounting data into Jaz — importing from Xero,
   QuickBooks, Sage, MYOB, or Excel exports. Covers the full conversion pipeline:

package/assets/skills/jobs/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: jaz-jobs
-version: 5.4.20
+version: 5.4.24
 description: >-
   Use this skill for recurring accounting workflows — month/quarter/year-end
   close, bank reconciliation, GST/VAT filing, payment runs, credit control,

package/assets/skills/practice/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: jaz-practice
-version: 5.4.20
+version: 5.4.24
 description: >-
   Use this skill whenever an accounting practitioner is doing client work in
   Jaz — closing the books, filing GST, year-end statutory, onboarding a new
@@ -25,6 +25,12 @@ compatibility:
 
 Practitioner-side scaffolding. The agent's entry point when an accountant is doing client work in Jaz.
 
+## When to Use This Skill
+
+Load `jaz-practice` when the user's intent is practitioner-shaped — closing the books, filing GST/VAT, year-end statutory, onboarding a new client, mid-quarter review for a specific client. The skill's job is to LOAD CONTEXT (CLIENT.md + ENGAGEMENT.md) before routing the actual accounting work to `jaz-jobs` (close playbooks), `jaz-recipes` (IFRS recipes), `jaz-conversion` (data migration), or `jaz-api` (raw endpoints).
+
+Trigger phrases: "close the books for X", "file GST for Y", "onboard new client Z", "what's outstanding for Acme this month", "Acme — quarterly close", "year-end statutory for X". When in doubt: if the user names a client or an engagement-type ("monthly close", "GST", "year-end"), load this skill first.
+
 ## Mental model
 
 | Engineer (cct-toolkit) | Practitioner (jaz-practice) |

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

@@ -1,6 +1,6 @@
 ---
 name: jaz-recipes
-version: 5.4.20
+version: 5.4.24
 description: >-
   Use this skill when modeling complex multi-step accounting transactions —
   anything that spans multiple periods, involves changing amounts, or requires
@@ -278,7 +278,7 @@ Both tools accept all 13 recipe types: loan, lease, depreciation, prepaid-expens
 
 Scheduler creation tools are also available: `create_scheduled_journal`, `create_scheduled_invoice`, `create_scheduled_bill`.
 
-## Cross-References
+## See Also
 
 - **API field names and payloads**: Load the `jaz-api` skill — see `references/endpoints.md` and `references/field-map.md`
 - **Capsule API**: `POST /capsules`, `POST /capsuleTypes` — see api skill's `references/full-api-surface.md`

package/assets/skills/transaction-recipes/references/building-blocks.md

@@ -135,21 +135,30 @@ The recipe engine creates one capsule per `execute_recipe` call. The pattern:
 - All bill / invoice / journal / cash entries the recipe creates get the new capsule's resourceId
 - Manual journal recipes (intercompany, capital-wip) follow the same pattern but you create the capsule + assign journals manually
 
-**Capsule Types** are labels that categorize capsules. Create types that match your recipes:
-- Prepaid Expenses
-- Deferred Revenue
-- Accrued Expenses
-- Loan Repayment
-- Lease Accounting (IFRS 16)
-- Depreciation (Non-Standard)
-- FX Revaluation
-- ECL Provision
-- Employee Benefits
-- Provisions
-- Dividends
+**Capsule Types** are labels that categorize capsules. Pass these exact strings — the engine and `search_capsules` filter rely on character-for-character match.
+
+Engine-emitted (canonical strings — match exactly):
+- Accrued Expenses (accrued-expense recipe)
+- Asset Disposal (asset-disposal recipe)
+- Deferred Revenue (deferred-revenue recipe)
+- Depreciation (depreciation recipe — covers SL, DDB, 150DB)
+- Dividends (dividend recipe)
+- ECL Provision (ecl recipe)
+- Employee Benefits (leave-accrual recipe)
+- Fixed Deposit (fixed-deposit recipe)
+- FX Revaluation (fx-reval recipe — verification only, do not execute_recipe)
+- Hire Purchase (lease recipe with `usefulLifeMonths > termMonths`)
+- Lease Accounting (lease recipe — IFRS 16)
+- Loan Repayment (loan recipe)
+- Prepaid Expenses (prepaid-expense recipe)
+- Provisions (provision recipe)
+
+Practitioner-created (manual `create_capsule(capsuleType: 'X')` — no engine):
 - Intercompany
 - Capital Projects
 
+> **Naming drift to watch for:** the file `accrued-expenses.md` (plural) covers the engine recipe `'accrued-expense'` (singular) which emits the capsule type `'Accrued Expenses'` (plural). Same content; the recipe name follows the engine convention while the file + capsule type follow the accounting convention. Pass capsule type strings exactly as listed above.
+
 **Reporting:** Capsules are the **only enrichment that supports group-by** in the General Ledger. Grouping by capsule shows the complete lifecycle of a multi-step transaction in one view.
 
 **API:** `POST /capsules`, `POST /capsuleTypes`, `POST /capsuleTypes/search`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jaz-clio",
-  "version": "5.4.20",
+  "version": "5.4.24",
   "description": "Clio: Command Line Interface Operator for Jaz AI.",
   "type": "module",
   "bin": {