jaz-clio 4.35.1 → 4.35.2

package/assets/skills/api/SKILL.md

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

package/assets/skills/cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: jaz-cli
-version: 4.35.1
+version: 4.35.2
 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: 4.35.1
+version: 4.35.2
 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: 4.35.1
+version: 4.35.2
 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: 4.35.1
+version: 4.35.2
 description: >-
   Use this skill when modeling complex multi-step accounting transactions —
   anything that spans multiple periods, involves changing amounts, or requires

package/dist/commands/picker.js

@@ -1,13 +1,6 @@
-/**
- * Interactive command picker for bare `clio` and bare `clio <group>` invocations.
- *
- * Uses `@clack/prompts` select with numbered choices and inline category tags.
- * Activates only in TTY terminals — non-interactive usage (pipes, --json, CI)
- * is unaffected.
- */
-import * as p from '@clack/prompts';
-import { muted } from './ui/theme.js';
-// ── Category map (keyed by top-level command name) ──────────────────
+import { showPicker, isCancel } from './ui/picker.js';
+import { accent, muted } from './ui/theme.js';
+// ── Category map ────────────────────────────────────────────────────
 const CATEGORIES = {
     invoices: 'AR',
     'customer-credit-notes': 'AR',
@@ -50,9 +43,21 @@ const CATEGORY_ORDER = [
     'AR', 'AP', 'Acctg', 'Banking', 'Jobs', 'Calc', 'Recipes',
     'Reports', 'Data', 'AI', 'Setup',
 ];
-/** Commands excluded from the picker. */
+const CATEGORY_HINTS = {
+    AR: 'Invoices, credit notes, payments',
+    AP: 'Bills, supplier credit notes',
+    Acctg: 'Journals, cash in/out/transfer',
+    Banking: 'Bank, reconciliation, cashflow',
+    Jobs: 'Month-end, recon, tax filing',
+    Calc: 'Loan, lease, depreciation, ECL',
+    Recipes: 'Capsule transactions (IFRS)',
+    Reports: 'TB, P&L, balance sheet, exports',
+    Data: 'Contacts, accounts, items, tags',
+    AI: 'Magic extraction, help center',
+    Setup: 'Auth, org, init, update',
+};
 const SKIP = new Set(['serve', 'mcp', 'help']);
-// ── Collect leaf commands recursively ───────────────────────────────
+// ── Collect leaf commands ───────────────────────────────────────────
 function collectLeaves(commands, prefix, category) {
     const leaves = [];
     for (const cmd of commands) {
@@ -64,11 +69,8 @@ function collectLeaves(commands, prefix, category) {
         const subs = cmd.commands.filter(c => !SKIP.has(c.name()));
         const hasOwnAction = cmd._actionHandler != null;
         if (subs.length > 0) {
-            // Commands with own action + subcommands (e.g. jobs bank-recon)
-            // appear as both a leaf AND parent
-            if (hasOwnAction) {
+            if (hasOwnAction)
                 leaves.push({ path, description: cmd.description(), category: cat });
-            }
             leaves.push(...collectLeaves(subs, path, cat));
         }
         else {
@@ -77,28 +79,9 @@ function collectLeaves(commands, prefix, category) {
     }
     return leaves;
 }
-// ── Build select options ───────────────────────────────────────────
-function buildOptions(leaves) {
-    // Sort by category order, then alphabetically within category
-    const sorted = [...leaves].sort((a, b) => {
-        const idxA = CATEGORY_ORDER.indexOf(a.category);
-        const idxB = CATEGORY_ORDER.indexOf(b.category);
-        const catA = idxA === -1 ? 999 : idxA;
-        const catB = idxB === -1 ? 999 : idxB;
-        if (catA !== catB)
-            return catA - catB;
-        return a.path.localeCompare(b.path);
-    });
-    const maxPath = Math.min(Math.max(...sorted.map(l => l.path.length)), 38);
-    return sorted.map((leaf, i) => {
-        const num = String(i + 1).padStart(3);
-        const cmd = leaf.path.padEnd(maxPath);
-        return {
-            label: `${num}. ${cmd}`,
-            value: leaf.path,
-            hint: `${leaf.description}  [${leaf.category}]`,
-        };
-    });
+function truncateDesc(desc, max) {
+    const short = desc.split(/[.;—]/).shift()?.trim() ?? desc;
+    return short.length <= max ? short : short.slice(0, max - 1) + '…';
 }
 // ── TTY guard ───────────────────────────────────────────────────────
 export function shouldShowPicker() {
@@ -111,52 +94,78 @@ export function shouldShowPicker() {
 // ── Top-level picker ────────────────────────────────────────────────
 export async function showCommandPicker(program, authInfo) {
     const leaves = collectLeaves(program.commands, '', '');
-    const options = buildOptions(leaves);
     const version = program.version() ?? '';
-    // Strip control chars / ANSI sequences from untrusted strings
     const safe = (s) => s.replace(/[\x00-\x1F\x7F]/g, '').replace(/\x1B\[[0-9;]*[A-Za-z]/g, '');
-    // Merged header: version + org info (if authenticated) + help hints
-    let header = `  Clio v${version}`;
+    // Build header
+    let headerText = `Clio v${version}`;
     if (authInfo) {
-        header += ` · ${safe(authInfo.label)} · ${safe(authInfo.orgName)} (${safe(authInfo.currency)})`;
-        if (authInfo.otherOrgCount > 0) {
-            header += ` + ${authInfo.otherOrgCount} other org${authInfo.otherOrgCount > 1 ? 's' : ''}`;
-        }
+        headerText += ` ${muted('·')} ${safe(authInfo.label)} ${muted('·')} ${safe(authInfo.orgName)} (${safe(authInfo.currency)})`;
+        if (authInfo.otherOrgCount > 0)
+            headerText += ` ${muted(`+${authInfo.otherOrgCount} more`)}`;
+    }
+    // ── Level 1: Categories ──
+    while (true) {
+        const categoryItems = CATEGORY_ORDER.map(cat => {
+            const count = leaves.filter(l => l.category === cat).length;
+            return {
+                label: cat,
+                value: cat,
+                hint: `${String(count).padStart(3)} commands   ${CATEGORY_HINTS[cat] ?? ''}`,
+            };
+        });
+        const category = await showPicker({
+            header: headerText,
+            items: categoryItems,
+        });
+        if (isCancel(category))
+            process.exit(0);
+        // ── Level 2: Commands in category ──
+        const catLeaves = leaves
+            .filter(l => l.category === category)
+            .sort((a, b) => a.path.localeCompare(b.path));
+        const descBudget = Math.max(20, (process.stdout.columns || 80) - 44);
+        const commandItems = [
+            { label: '← Back', value: '__back__', hint: 'Return to categories' },
+            ...catLeaves.map(leaf => ({
+                label: leaf.path,
+                value: leaf.path,
+                hint: truncateDesc(leaf.description, descBudget),
+            })),
+        ];
+        const selected = await showPicker({
+            header: `${accent(String(category))} ${muted('·')} ${catLeaves.length} commands`,
+            items: commandItems,
+            filterable: true,
+        });
+        if (isCancel(selected))
+            process.exit(0);
+        if (selected === '__back__')
+            continue;
+        return selected;
     }
-    header += ` — ${options.length} commands`;
-    process.stderr.write(muted(header + '\n'));
-    process.stderr.write(muted('  Type to search, ↑↓ navigate, Enter select, Esc quit\n\n'));
-    const result = await p.autocomplete({
-        message: 'clio',
-        options,
-    });
-    if (p.isCancel(result))
-        process.exit(0);
-    return result ?? null;
 }
 // ── Subcommand picker ───────────────────────────────────────────────
 async function showSubcommandPicker(parent, parentPath) {
     const topLevel = parentPath.split(' ')[0];
     const category = CATEGORIES[topLevel] ?? 'Other';
-    const leaves = collectLeaves(parent.commands, parentPath, category);
-    const options = buildOptions(leaves);
-    process.stderr.write(muted(`  ${options.length} subcommands — ↑↓ navigate, Enter select, Esc quit\n\n`));
-    const result = await p.autocomplete({
-        message: `clio ${parentPath}`,
-        options,
+    const leaves = collectLeaves(parent.commands, parentPath, category)
+        .sort((a, b) => a.path.localeCompare(b.path));
+    const descBudget = Math.max(20, (process.stdout.columns || 80) - 44);
+    const items = leaves.map(leaf => ({
+        label: leaf.path,
+        value: leaf.path,
+        hint: truncateDesc(leaf.description, descBudget),
+    }));
+    const result = await showPicker({
+        header: `clio ${parentPath}`,
+        items,
+        filterable: items.length > 10,
     });
-    if (p.isCancel(result))
+    if (isCancel(result))
         process.exit(0);
     return result ?? null;
 }
-// ── Attach subcommand pickers to group commands ─────────────────────
-/**
- * Recursively attach interactive pickers to group commands that have
- * subcommands but no default action of their own.
- *
- * After this, bare `clio invoices` or `clio invoices draft` show a picker
- * instead of the Commander help dump.
- */
+// ── Attach subcommand pickers ───────────────────────────────────────
 export function attachSubcommandPickers(program) {
     function recurse(parent, parentPath) {
         for (const cmd of parent.commands) {
@@ -176,39 +185,29 @@ export function attachSubcommandPickers(program) {
                     });
                 }
                 else if (process.stdin.isTTY && process.stdout.isTTY) {
-                    // Parent has both own action AND subcommands (e.g. jobs payment-run).
-                    // Wrap action to show disambiguation when invoked bare from picker.
                     const originalAction = cmd._actionHandler;
                     let inDisambiguation = false;
                     cmd._actionHandler = async (...args) => {
-                        // Re-entrancy guard: if we're already in disambiguation (e.g. parseAsync
-                        // re-invoked this handler), run the original action directly.
                         if (inDisambiguation)
                             return originalAction.call(cmd, ...args);
                         inDisambiguation = true;
                         try {
-                            const disambigOptions = [
-                                {
-                                    label: `${name} (default blueprint)`,
-                                    value: '__default__',
-                                    hint: cmd.description(),
-                                },
+                            const items = [
+                                { label: `${name} (default)`, value: '__default__', hint: truncateDesc(cmd.description(), 50) },
                                 ...subs.map(sub => ({
                                     label: `${name} ${sub.name()}`,
                                     value: sub.name(),
-                                    hint: sub.description(),
+                                    hint: truncateDesc(sub.description(), 50),
                                 })),
                             ];
-                            process.stderr.write(muted(`\n  ${name} has subcommands — pick one:\n\n`));
-                            const action = await p.select({
-                                message: `clio ${path}`,
-                                options: disambigOptions,
+                            const action = await showPicker({
+                                header: `clio ${path}`,
+                                items,
                             });
-                            if (p.isCancel(action))
+                            if (isCancel(action))
                                 process.exit(0);
-                            if (action === '__default__') {
+                            if (action === '__default__')
                                 return originalAction.call(cmd, ...args);
-                            }
                             await program.parseAsync(['node', 'clio', ...path.split(' '), action]);
                         }
                         finally {
@@ -216,7 +215,6 @@ export function attachSubcommandPickers(program) {
                         }
                     };
                 }
-                // Recurse deeper (invoices > draft, capsules > types, etc.)
                 recurse(cmd, path);
             }
         }

package/dist/commands/ui/index.js

@@ -5,3 +5,4 @@ export { formatApiError, formatAuthError, formatGenericError, formatWarning } fr
 export { renderOrgBanner } from './banner.js';
 export { createProgress } from './progress.js';
 export { formatRecord } from './record.js';
+export { showPicker, isCancel } from './picker.js';

package/dist/commands/ui/picker.js

@@ -0,0 +1,180 @@
+/**
+ * Custom-built interactive picker — branded for Clio.
+ *
+ * Built with raw readline for full visual control.
+ * Features: type-to-filter, arrow navigation, scrollable viewport,
+ * rounded borders, brand colors, compact single-line items.
+ */
+import readline from 'node:readline';
+import { accent, muted, highlight, subtle, box, sym, INDENT } from './theme.js';
+const CANCEL = Symbol('cancel');
+export function isCancel(value) {
+    return value === CANCEL;
+}
+// ── Helpers ──────────────────────────────────────────────────────
+function stripAnsi(str) {
+    // eslint-disable-next-line no-control-regex
+    return str.replace(/\x1b\[[0-9;]*m/g, '');
+}
+function fuzzyMatch(query, target) {
+    const q = query.toLowerCase();
+    const t = target.toLowerCase();
+    let qi = 0;
+    for (let ti = 0; ti < t.length && qi < q.length; ti++) {
+        if (t[ti] === q[qi])
+            qi++;
+    }
+    return qi === q.length;
+}
+function truncate(str, max) {
+    const plain = stripAnsi(str);
+    if (plain.length <= max)
+        return str;
+    return str.slice(0, max - 1) + '…';
+}
+// ── Render Frame ─────────────────────────────────────────────────
+function renderFrame(header, items, cursor, filter, filterable, maxVisible) {
+    const termWidth = process.stdout.columns || 80;
+    const contentWidth = Math.min(termWidth - 4, 72);
+    const lines = [];
+    // Header box
+    const hr = box.horizontal.repeat(contentWidth);
+    lines.push(muted(`${INDENT}${box.topLeft}${hr}${box.topRight}`));
+    const headerPlain = stripAnsi(header);
+    const headerPad = Math.max(0, contentWidth - headerPlain.length - 1);
+    lines.push(muted(`${INDENT}${box.vertical}`) + ` ${header}${' '.repeat(headerPad)}` + muted(box.vertical));
+    lines.push(muted(`${INDENT}${box.bottomLeft}${hr}${box.bottomRight}`));
+    // Filter input
+    if (filterable) {
+        const display = filter ? highlight(filter) : subtle('type to filter...');
+        lines.push(`${INDENT}  ${muted(sym.pointerSmall)} ${display}`);
+        lines.push('');
+    }
+    else {
+        lines.push('');
+    }
+    // Items viewport
+    if (items.length === 0) {
+        lines.push(`${INDENT}  ${muted('No matching commands')}`);
+    }
+    else {
+        const total = items.length;
+        const viewSize = Math.min(maxVisible, total);
+        let start = 0;
+        if (total > viewSize) {
+            start = Math.max(0, cursor - Math.floor(viewSize / 2));
+            start = Math.min(start, total - viewSize);
+        }
+        const end = start + viewSize;
+        const visibleItems = items.slice(start, end);
+        const maxLabel = Math.min(Math.max(...visibleItems.map(i => stripAnsi(i.label).length), 8), 36);
+        const hintBudget = Math.max(10, contentWidth - maxLabel - 8);
+        if (start > 0)
+            lines.push(`${INDENT}  ${muted('↑')}`);
+        for (let i = start; i < end; i++) {
+            const item = items[i];
+            const isSelected = i === cursor;
+            const label = stripAnsi(item.label).padEnd(maxLabel);
+            const hint = item.hint ? truncate(item.hint, hintBudget) : '';
+            if (isSelected) {
+                lines.push(`${INDENT}${accent(sym.pointer)} ${highlight(label)}  ${muted(hint)}`);
+            }
+            else {
+                lines.push(`${INDENT}  ${label}  ${subtle(hint)}`);
+            }
+        }
+        if (end < total)
+            lines.push(`${INDENT}  ${muted('↓')} ${subtle(`+${total - end} more`)}`);
+    }
+    // Footer
+    lines.push('');
+    lines.push(`${INDENT}${muted('↑↓')} ${subtle('navigate')}  ${muted('·')}  ${muted('enter')} ${subtle('select')}  ${muted('·')}  ${muted('esc')} ${subtle('quit')}`);
+    return lines.join('\n');
+}
+// ── Interactive Picker ───────────────────────────────────────────
+export function showPicker(opts) {
+    return new Promise((resolve) => {
+        const { header, items, filterable = false } = opts;
+        const termRows = process.stdout.rows || 24;
+        const maxVisible = opts.maxVisible ?? Math.max(8, termRows - 10);
+        let filter = '';
+        let cursor = 0;
+        let prevLineCount = 0;
+        const getFiltered = () => {
+            if (!filter)
+                return items;
+            return items.filter(i => fuzzyMatch(filter, i.label) || (i.hint ? fuzzyMatch(filter, i.hint) : false));
+        };
+        const draw = () => {
+            const filtered = getFiltered();
+            if (cursor >= filtered.length)
+                cursor = Math.max(0, filtered.length - 1);
+            const frame = renderFrame(header, filtered, cursor, filter, filterable, maxVisible);
+            const frameLines = frame.split('\n').length;
+            // Clear previous frame
+            if (prevLineCount > 0) {
+                process.stdout.write(`\x1b[${prevLineCount}A`); // Move up
+                process.stdout.write('\x1b[J'); // Clear to end of screen
+            }
+            process.stdout.write(frame + '\n');
+            prevLineCount = frameLines;
+        };
+        // Setup readline in raw mode
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout, terminal: true });
+        if (process.stdin.isTTY)
+            process.stdin.setRawMode(true);
+        readline.emitKeypressEvents(process.stdin, rl);
+        // Hide cursor
+        process.stdout.write('\x1b[?25l');
+        const cleanup = () => {
+            process.stdout.write('\x1b[?25h'); // Show cursor
+            if (process.stdin.isTTY)
+                process.stdin.setRawMode(false);
+            process.stdin.removeListener('keypress', onKey);
+            rl.close();
+        };
+        const onKey = (_char, key) => {
+            const filtered = getFiltered();
+            if (key?.name === 'up') {
+                cursor = cursor > 0 ? cursor - 1 : filtered.length - 1;
+                draw();
+            }
+            else if (key?.name === 'down') {
+                cursor = cursor < filtered.length - 1 ? cursor + 1 : 0;
+                draw();
+            }
+            else if (key?.name === 'return') {
+                if (filtered.length > 0) {
+                    cleanup();
+                    // Clear the picker output
+                    if (prevLineCount > 0) {
+                        process.stdout.write(`\x1b[${prevLineCount}A\x1b[J`);
+                    }
+                    resolve(filtered[cursor].value);
+                }
+            }
+            else if (key?.name === 'escape' || (key?.ctrl && key?.name === 'c')) {
+                cleanup();
+                if (prevLineCount > 0) {
+                    process.stdout.write(`\x1b[${prevLineCount}A\x1b[J`);
+                }
+                resolve(CANCEL);
+            }
+            else if (key?.name === 'backspace') {
+                if (filterable && filter.length > 0) {
+                    filter = filter.slice(0, -1);
+                    cursor = 0;
+                    draw();
+                }
+            }
+            else if (filterable && key?.sequence && key.sequence.length === 1 && !key.ctrl) {
+                filter += key.sequence;
+                cursor = 0;
+                draw();
+            }
+        };
+        process.stdin.on('keypress', onKey);
+        // Initial draw
+        draw();
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jaz-clio",
-  "version": "4.35.1",
+  "version": "4.35.2",
   "description": "Clio — Command Line Interface Orchestrator for Jaz AI.",
   "type": "module",
   "bin": {