feat: add --toon output format for token-optimized CLI output

package.json

@@ -37,6 +37,7 @@
   "dependencies": {
     "@clack/prompts": "^0.9.1",
     "@insforge/shared-schemas": "^1.1.58",
+    "@toon-format/toon": "^4.1.0",
     "archiver": "^7.0.1",
     "cli-table3": "^0.6.5",
     "commander": "^13.1.0",

src/index.ts

@@ -5,7 +5,7 @@ import { Command } from 'commander';
 import * as clack from '@clack/prompts';
 import * as prompts from './lib/prompts.js';
 import { getCredentials, getProjectConfig } from './lib/config.js';
-import { outputJson } from './lib/output.js';
+import { outputJson, setToonMode } from './lib/output.js';
 import { registerLoginCommand } from './commands/login.js';
 import { registerLogoutCommand } from './commands/logout.js';
 import { registerWhoamiCommand } from './commands/whoami.js';
@@ -116,6 +116,7 @@ program
 // Global options
 program
   .option('--json', 'Output in JSON format')
+  .option('--toon', 'Output in TOON format (token-optimized notation, see toonformat.dev)')
   .option('--forger', 'Play the Forger animation (root command only) and return to the interactive menu')
   .option('--api-url <url>', 'Override Platform API URL')
   .option('-y, --yes', 'Skip confirmation prompts')
@@ -153,6 +154,12 @@ program.hook('preAction', async (_thisCommand, actionCommand) => {
 // (Claude Code, Cursor, scripts, CI, humans) automatically.
 program.hook('preAction', guardHook);
 
+// TOON output format: set module-level flag before any action runs
+program.hook('preAction', (thisCommand: Command, actionCommand: Command) => {
+  const opts = actionCommand.optsWithGlobals() as { toon?: boolean };
+  setToonMode(!!opts.toon);
+});
+
 // Top-level commands
 registerLoginCommand(program);
 registerLogoutCommand(program);

src/lib/errors.ts

@@ -126,7 +126,7 @@ export function getRootOpts(cmd: Command): { json: boolean; apiUrl?: string; yes
   }
   const opts = root.opts();
   return {
-    json: opts.json ?? false,
+    json: opts.json ?? opts.toon ?? false,
     apiUrl: opts.apiUrl,
     yes: opts.yes ?? false,
   };

src/lib/output.ts

@@ -1,10 +1,28 @@
 import Table from 'cli-table3';
+import { encode } from '@toon-format/toon';
+
+// Module-level state set by preAction hook
+let toonMode = false;
+
+export function setToonMode(enabled: boolean): void {
+  toonMode = enabled;
+}
+
+// ── Public output functions ──────────────────────────────────────────────
 
 export function outputJson(data: unknown): void {
+  if (toonMode) {
+    console.log(encode(data));
+    return;
+  }
   console.log(JSON.stringify(data, null, 2));
 }
 
 export function outputTable(headers: string[], rows: string[][]): void {
+  if (toonMode) {
+    outputToon(headers, rows);
+    return;
+  }
   const table = new Table({
     head: headers,
     style: { head: ['cyan'] },
@@ -16,9 +34,69 @@ export function outputTable(headers: string[], rows: string[][]): void {
 }
 
 export function outputSuccess(message: string): void {
+  if (toonMode) {
+    // Emit structured TOON instead of suppressing
+    console.log(encode({ type: 'success', message }));
+    return;
+  }
   console.log(`✓ ${message}`);
 }
 
 export function outputInfo(message: string): void {
+  if (toonMode) {
+    // Emit structured TOON instead of suppressing
+    console.log(encode({ type: 'info', message }));
+    return;
+  }
   console.log(message);
 }
+
+// ── TOON output implementations ──────────────────────────────────────────
+
+function toonEscapeKey(k: string): string {
+  if (/^[A-Za-z_][A-Za-z0-9_.]*$/.test(k)) return k;
+  return '"' + k
+    .replace(/\\/g, '\\\\')
+    .replace(/"/g, '\\"')
+    .replace(/\n/g, '\\n')
+    .replace(/\r/g, '\\r')
+    .replace(/\t/g, '\\t') + '"';
+}
+
+function toonEscapeValue(v: unknown): string {
+  if (v === null || v === undefined || (typeof v === 'number' && !isFinite(v))) return 'null';
+  if (typeof v === 'boolean') return v ? 'true' : 'false';
+  if (typeof v === 'number') return String(v);
+  const s = String(v);
+  const needsQuoting =
+    s === '' ||
+    s === 'true' || s === 'false' || s === 'null' ||
+    /^[+-]?[0-9]+(\.[0-9]+)?([eE][+-]?[0-9]+)?$/.test(s) ||
+    /^[ \t]|[ \t]$/.test(s) ||
+    /^[-#]/.test(s) ||
+    /[:,\\"{}\\[\\]]/.test(s) ||
+    // eslint-disable-next-line no-control-regex
+    /[\x00-\x1f]/.test(s);
+  if (!needsQuoting) return s;
+  return '"' + s
+    .replace(/\\/g, '\\\\')
+    .replace(/"/g, '\\"')
+    .replace(/\n/g, '\\n')
+    .replace(/\r/g, '\\r')
+    .replace(/\t/g, '\\t')
+    // eslint-disable-next-line no-control-regex
+    .replace(/[\x00-\x08\x0b\x0c\x0e-\x1f]/g, c => '\\u' + c.charCodeAt(0).toString(16).padStart(4, '0')) + '"';
+}
+
+function outputToon(headers: string[], rows: string[][]): void {
+  if (headers && rows && rows.length > 0) {
+    const keyStr = headers.map(toonEscapeKey).join(',');
+    let out = `[${rows.length}]{${keyStr}}:`;
+    for (const row of rows) {
+      out += '\n  ' + row.map(toonEscapeValue).join(',');
+    }
+    console.log(out);
+  } else if (headers && headers.length > 0) {
+    console.log(`[0]{${headers.map(toonEscapeKey).join(',')}}:`);
+  }
+}