jaz-clio 5.20.26 → 5.20.27

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/README.md CHANGED
@@ -7,7 +7,7 @@
7
7
  <a href="https://github.com/teamtinvio/jaz-ai/blob/main/LICENSE"><img src="https://img.shields.io/github/license/teamtinvio/jaz-ai?style=for-the-badge&color=green" alt="License"></a>
8
8
  </p>
9
9
 
10
- 305 tools. 59 command groups. 13 calculators. 12 job playbooks. 158 API rules. 16 IFRS recipes.
10
+ 305 tools. 60 command groups. 13 calculators. 12 job playbooks. 158 API rules. 16 IFRS recipes.
11
11
 
12
12
  ```bash
13
13
  npm install -g jaz-clio
@@ -18,7 +18,7 @@ Requires **Node.js 18+** ([nodejs.org](https://nodejs.org)). Also fully compatib
18
18
  ## Contents
19
19
 
20
20
  - [Three Ways In](#three-ways-in) · CLI, MCP, Skills
21
- - [CLI](#cli) · 59 command groups
21
+ - [CLI](#cli) · 60 command groups
22
22
  - [MCP Server](#mcp-server) · 305 tools for AI agents
23
23
  - [Skills](#skills) · Teach any AI the Jaz API
24
24
  - [Setup](#setup) · Auth, multi-org, automation
@@ -47,7 +47,7 @@ clio invoices search --query 'status:unpaid AND $500+' # Structured per-entity
47
47
  clio invoices search --query 'status:unpaid' --view lean # Compact summary rows (id + key fields), then drill in with get
48
48
  ```
49
49
 
50
- 59 command groups. 16 report types. 13 calculators. 12 job playbooks. Every command supports `--json`. Run `clio --help` for the full list.
50
+ 60 command groups. 16 report types. 13 calculators. 12 job playbooks. Every command supports `--json`. Run `clio --help` for the full list.
51
51
 
52
52
  ---
53
53
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: jaz-api
3
- version: 5.20.26
3
+ version: 5.20.27
4
4
  description: >-
5
5
  Use this skill whenever you call, debug, or review code that touches the Jaz
6
6
  REST API. Covers field names, response shapes, 158 production gotchas, error
@@ -1,14 +1,14 @@
1
1
  ---
2
2
  name: jaz-cli
3
- version: 5.20.26
3
+ version: 5.20.27
4
4
  description: >-
5
5
  Use this skill when running Clio CLI commands, building shell scripts with
6
6
  Clio, debugging auth issues, understanding --json output, paginating results,
7
- or chaining multi-step accounting workflows from the terminal. Covers all 48
7
+ or chaining multi-step accounting workflows from the terminal. Covers all 60
8
8
  command groups, auth precedence, output formats, entity resolution, and common
9
9
  workflow patterns. Also use when the user asks how to use clio, what commands
10
10
  are available, or how to automate accounting tasks from the command line.
11
- Covers all 59 command groups and 305 tools.
11
+ Covers all 60 command groups and 305 tools.
12
12
  license: MIT
13
13
  compatibility: Requires Node.js >= 18.0.0. Install via npm install -g jaz-clio.
14
14
  ---
@@ -17,7 +17,7 @@ compatibility: Requires Node.js >= 18.0.0. Install via npm install -g jaz-clio.
17
17
 
18
18
  > **Audience note:** for power users and CI/automation. Load this skill only when you're scripting from a terminal, building shell pipelines, or debugging from `clio --json` output. For day-to-day accounting inside Claude Desktop / Cowork, the MCP tools cover the common flows without dropping to the CLI.
19
19
 
20
- You are working with **Clio** (`jaz-clio`) — the CLI for the Jaz accounting platform. 59 command groups, 13 calculators, 12 job blueprints, 305 tools. Also fully compatible with Juan Accounting (same API, same endpoints).
20
+ You are working with **Clio** (`jaz-clio`) — the CLI for the Jaz accounting platform. 60 command groups, 13 calculators, 12 job blueprints, 305 tools. Also fully compatible with Juan Accounting (same API, same endpoints).
21
21
 
22
22
  ## When to Use This Skill
23
23
 
@@ -110,6 +110,15 @@ clio journals create --account "1000" # Resolves by account code
110
110
 
111
111
  > **IMPORTANT for agents:** Fuzzy matching works for `--contact` and top-level `--account` flags. It does NOT work inside `--lines` JSON arrays. Line item `accountResourceId` must be a UUID or exact account name.
112
112
 
113
+ **Resolve a name to a resourceId without writing anything:**
114
+ ```bash
115
+ clio resolve account "Operating Expense" --json # → {"resourceId":"...","displayName":"..."}
116
+ clio resolve bank "DBS Current" --json
117
+ clio resolve contact "Acme" --json
118
+ clio resolve tax-profile "Standard GST" --json
119
+ ```
120
+ `clio resolve <account|contact|bank|tax-profile> <name>` runs the **same** resolver the write flags use (UUID→exact→fuzzy) and exits non-zero with candidates on an ambiguous/no match. Prefer it over `accounts search … | jq` when you just need the id: search is fuzzy and paginated (an exact name can be buried on a polluted org), whereas `resolve` fetches the full set and prefers an exact hit.
121
+
113
122
  ## Pagination
114
123
 
115
124
  All list/search commands support pagination. Two modes:
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: jaz-conversion
3
- version: 5.20.26
3
+ version: 5.20.27
4
4
  description: >-
5
5
  Use this skill when migrating accounting data into Jaz — importing from Xero,
6
6
  QuickBooks, Sage, MYOB, or Excel exports. Covers the full conversion pipeline:
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: jaz-pseudo-sql
3
- version: 5.20.26
3
+ version: 5.20.27
4
4
  description: >-
5
5
  Use this skill when answering ad-hoc data questions that aren't covered by
6
6
  download_export (canonical reports — anomaly, audit, aging, P&L, BS, GL,
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: jaz-jobs
3
- version: 5.20.26
3
+ version: 5.20.27
4
4
  description: >-
5
5
  Use this skill for recurring accounting workflows — month/quarter/year-end
6
6
  close, bank reconciliation, GST/VAT filing, payment runs, credit control,
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: jaz-recipes
3
- version: 5.20.26
3
+ version: 5.20.27
4
4
  description: >-
5
5
  Use this skill when modeling complex multi-step accounting transactions —
6
6
  anything that spans multiple periods, involves changing amounts, or requires