jaz-clio 5.48.2 → 5.49.0

package/assets/skills/api/SKILL.md

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

package/assets/skills/cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: jaz-cli
-version: 5.48.2
+version: 5.49.0
 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/cli/references/error-recovery.md

@@ -23,7 +23,7 @@
 | Error | Cause | Fix |
 |-------|-------|-----|
 | `Multiple contacts match 'Acme'` | Fuzzy match found 2+ candidates above threshold | Use exact billingName or UUID |
-| `Contact not found: 'xyz'` | No match in org's contact list | Run `clio contacts search xyz` to check spelling |
+| `Contact not found: 'xyz'` | No match in org's contact list | Run `clio contacts search --name xyz` to check spelling |
 | `Account not found: 'xyz'` | No matching account name or code | Run `clio accounts list --json` to see available accounts |
 | `Bank account not found` | Name doesn't match any bank-type account | Run `clio bank accounts --json` for exact names |
 | `Tax profile not found` | No match on tax profile name or code | Run `clio tax-profiles list --json` for available profiles |
@@ -98,7 +98,7 @@ echo $JAZ_ORG             # Check for pinned org
 
 **Entity not found?** Search before creating:
 ```bash
-clio contacts search "partial name" --json | jq '.data[] | {name, resourceId}'
+clio contacts search --name "partial name" --json | jq '.data[] | {name, resourceId}'
 clio accounts list --json | jq '.data[] | {name, code: .accountCode, id: .resourceId}'
 ```
 

package/assets/skills/conversion/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: jaz-conversion
-version: 5.48.2
+version: 5.49.0
 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/jaz-kit/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: jaz-kit
-version: 5.48.2
+version: 5.49.0
 description: >-
   Use this skill when an accountant, bookkeeper, or owner is running real books
   in Jaz across one or more organizations from the terminal — setting up a

package/assets/skills/jaz-pseudo-sql/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: jaz-pseudo-sql
-version: 5.48.2
+version: 5.49.0
 description: >-
   Use this skill when answering ad-hoc data questions that aren't covered by
   download_export (canonical reports — anomaly, audit, aging, P&L, BS, GL,

package/assets/skills/jaz-pseudo-sql/references/error-catalog.md

@@ -31,6 +31,28 @@ Surfaces when the query is syntactically valid but semantically rejected — wro
 | `a query must SELECT FROM at least one table` | `SELECT 1` (constant-only) | Add `FROM <table>` from the curated set. |
 | `unknown table "<name>"` (note: lowercased) | Table not in curated schema | Call `get_pseudo_sql_schema` for the live inventory. Common typos: plural vs singular (`invoice` vs `invoices`), wrong case. |
 
+## `PSEUDOSQL_DISABLED` (engine switched off)
+
+Surfaces on **both** `/sql-query/preview` and `/sql-query/export` when the query engine is not
+running. Delivered as a **422**, which reads like a validation failure and is not one.
+
+| Message | Trigger | Recovery |
+|---|---|---|
+| `The SQL query feature is not available.` | The reporting service has no read-only query pool: its connection string is unset for this deployment, or the pool failed to build, ping, or match the catalog at startup | None available to you. Do not rewrite the query. Use the report tools (`generate_report`, the operational report family) and tell the user the engine is off. |
+
+**The catalog stays readable while the engine is off.** `get_pseudo_sql_schema` is served from a
+static in-process snapshot and never touches the query pool, so it keeps returning the full table,
+join and function list. Measured on 2026-09-06: the schema endpoint returned 79 tables / 104 joins
+/ 47 functions in the same run where every preview and export returned `PSEUDOSQL_DISABLED`.
+
+So **a table appearing in the catalog is not evidence you can query it.** Confirming a table exists
+before querying is a reasonable habit and it will not detect this state. The only signal is the
+error itself.
+
+This is not an organization setting and not a plan entitlement — it is a platform deployment
+change, so neither you, the user, nor an organization admin can turn it on. Retrying later is only
+worth it if someone has said the engine is being re-enabled.
+
 ## Export-specific terminal states
 
 The `export_pseudo_sql` + `get_pseudo_sql_export` flow uses status enums (NOT error codes). Terminal states:

package/assets/skills/jobs/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: jaz-jobs
-version: 5.48.2
+version: 5.49.0
 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/transaction-recipes/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: jaz-recipes
-version: 5.48.2
+version: 5.49.0
 description: >-
   Use this skill when modeling complex multi-step accounting transactions —
   anything that spans multiple periods, involves changing amounts, or requires