@namzu/cli 0.0.3 → 0.1.0

package/dist/integrations/updates.js

@@ -0,0 +1,99 @@
+/**
+ * Update checks for namzu (npm) and clawtool (`clawtool upgrade --check`),
+ * surfaced in the TUI so the user knows when a newer version is out. Both are
+ * best-effort with short timeouts: offline / unpublished / no-clawtool just
+ * yields `null`, never an error or a hang.
+ */
+import { execFile } from 'node:child_process';
+import { findBinary } from './clawtool/binary.js';
+const NPM_TIMEOUT_MS = 2_500;
+const CLAWTOOL_TIMEOUT_MS = 5_000;
+/** Compare dotted numeric versions; >0 if a>b, <0 if a<b, 0 if equal. */
+export function compareVersions(a, b) {
+    const parse = (v) => v
+        .replace(/^v/, '')
+        .split('-')[0] // drop pre-release suffix
+        ?.split('.')
+        .map((n) => Number.parseInt(n, 10) || 0) ?? [];
+    const pa = parse(a);
+    const pb = parse(b);
+    for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+        const d = (pa[i] ?? 0) - (pb[i] ?? 0);
+        if (d !== 0)
+            return d;
+    }
+    return 0;
+}
+/** Newer @namzu/cli on npm, or null when up to date / unreachable. */
+export async function checkNamzuUpdate(current) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), NPM_TIMEOUT_MS);
+    try {
+        const res = await fetch('https://registry.npmjs.org/@namzu/cli/latest', {
+            signal: controller.signal,
+            headers: { accept: 'application/json' },
+        });
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        const latest = typeof data.version === 'string' ? data.version : null;
+        if (!latest || compareVersions(latest, current) <= 0)
+            return null;
+        return { name: 'namzu', current, latest, how: 'npm i -g @namzu/cli' };
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function run(bin, args) {
+    return new Promise((resolve) => {
+        execFile(bin, args, { timeout: CLAWTOOL_TIMEOUT_MS }, (_err, stdout) => resolve(stdout ?? ''));
+    });
+}
+/**
+ * Newer clawtool, or null. Prefers the machine-readable
+ * `upgrade --check --json` (newer binaries); falls back to parsing the
+ * `current -> latest` line in the plain `upgrade --check` output (older
+ * binaries that predate `--json`).
+ */
+export async function checkClawtoolUpdate() {
+    let bin;
+    try {
+        bin = findBinary();
+    }
+    catch {
+        return null;
+    }
+    const how = 'clawtool upgrade';
+    // JSON path (preferred).
+    try {
+        const data = JSON.parse(await run(bin, ['upgrade', '--check', '--json']));
+        if (data.update_available && data.current && data.latest) {
+            return { name: 'clawtool', current: data.current, latest: data.latest, how };
+        }
+        if (data.current)
+            return null; // valid JSON, no update
+    }
+    catch {
+        // fall through to plain parsing
+    }
+    // Plain-output fallback: a line like `0.22.159 -> 0.22.160`.
+    const plain = await run(bin, ['upgrade', '--check']);
+    const m = plain.match(/(\d+\.\d+\.\d+)\s*->\s*(\d+\.\d+\.\d+)/);
+    if (m?.[1] && m[2] && compareVersions(m[2], m[1]) > 0) {
+        return { name: 'clawtool', current: m[1], latest: m[2], how };
+    }
+    return null;
+}
+/** Run both checks in parallel; returns whichever have an update available. */
+export async function checkUpdates(namzuVersion) {
+    const [namzu, clawtool] = await Promise.all([
+        checkNamzuUpdate(namzuVersion),
+        checkClawtoolUpdate(),
+    ]);
+    return [namzu, clawtool].filter((u) => u !== null);
+}
+//# sourceMappingURL=updates.js.map

package/dist/integrations/updates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updates.js","sourceRoot":"","sources":["../../src/integrations/updates.ts"],"names":[],"mappings":"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"}

package/dist/memory/store.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Persistent memory under `~/.namzu/` — Hermes-parity flat markdown.
+ *
+ * - `USER.md`   — durable facts about the user (role, preferences).
+ * - `MEMORY.md` — durable facts/decisions the agent should carry across
+ *   sessions.
+ *
+ * Both are plain markdown the user and agent can read and edit. The TUI
+ * injects their contents into the agent's system prompt on every turn so
+ * namzu remembers across runs, and `/remember` appends to `MEMORY.md`.
+ */
+export declare function memoryDir(home?: string): string;
+export declare function userFilePath(home?: string): string;
+export declare function memoryFilePath(home?: string): string;
+export interface MemoryContent {
+    readonly user: string | null;
+    readonly memory: string | null;
+}
+/** Read USER.md + MEMORY.md, returning null for absent/empty files. */
+export declare function readMemory(home?: string): MemoryContent;
+/**
+ * Compose the memory system-prompt block, or `null` when there's nothing
+ * to inject. The block is framed so the model treats it as background
+ * knowledge, not as a user instruction for the current turn.
+ */
+export declare function composeMemoryPrompt(content: MemoryContent): string | null;
+/** Append a fact to MEMORY.md as a markdown bullet, creating the file. */
+export declare function appendMemory(text: string, home?: string): void;
+//# sourceMappingURL=store.d.ts.map

package/dist/memory/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/memory/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,wBAAgB,SAAS,CAAC,IAAI,GAAE,MAAkB,GAAG,MAAM,CAE1D;AAED,wBAAgB,YAAY,CAAC,IAAI,GAAE,MAAkB,GAAG,MAAM,CAE7D;AAED,wBAAgB,cAAc,CAAC,IAAI,GAAE,MAAkB,GAAG,MAAM,CAE/D;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B;AAWD,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,IAAI,GAAE,MAAkB,GAAG,aAAa,CAKlE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAgBzE;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAkB,GAAG,IAAI,CAMzE"}

package/dist/memory/store.js

@@ -0,0 +1,74 @@
+/**
+ * Persistent memory under `~/.namzu/` — Hermes-parity flat markdown.
+ *
+ * - `USER.md`   — durable facts about the user (role, preferences).
+ * - `MEMORY.md` — durable facts/decisions the agent should carry across
+ *   sessions.
+ *
+ * Both are plain markdown the user and agent can read and edit. The TUI
+ * injects their contents into the agent's system prompt on every turn so
+ * namzu remembers across runs, and `/remember` appends to `MEMORY.md`.
+ */
+import { appendFileSync, mkdirSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+const DIR_MODE = 0o700;
+const FILE_MODE = 0o600;
+export function memoryDir(home = homedir()) {
+    return join(home, '.namzu');
+}
+export function userFilePath(home = homedir()) {
+    return join(memoryDir(home), 'USER.md');
+}
+export function memoryFilePath(home = homedir()) {
+    return join(memoryDir(home), 'MEMORY.md');
+}
+function readIfPresent(path) {
+    try {
+        const text = readFileSync(path, 'utf8').trim();
+        return text.length > 0 ? text : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Read USER.md + MEMORY.md, returning null for absent/empty files. */
+export function readMemory(home = homedir()) {
+    return {
+        user: readIfPresent(userFilePath(home)),
+        memory: readIfPresent(memoryFilePath(home)),
+    };
+}
+/**
+ * Compose the memory system-prompt block, or `null` when there's nothing
+ * to inject. The block is framed so the model treats it as background
+ * knowledge, not as a user instruction for the current turn.
+ */
+export function composeMemoryPrompt(content) {
+    const sections = [];
+    if (content.user) {
+        sections.push(`## About the user\n\n${content.user}`);
+    }
+    if (content.memory) {
+        sections.push(`## Durable memory\n\n${content.memory}`);
+    }
+    if (sections.length === 0)
+        return null;
+    return [
+        'The following is persistent context carried across sessions. Treat it as',
+        'background knowledge about the user and prior work. Do not repeat it back',
+        'verbatim unless asked.',
+        '',
+        sections.join('\n\n'),
+    ].join('\n');
+}
+/** Append a fact to MEMORY.md as a markdown bullet, creating the file. */
+export function appendMemory(text, home = homedir()) {
+    const trimmed = text.trim();
+    if (trimmed.length === 0)
+        return;
+    const path = memoryFilePath(home);
+    mkdirSync(dirname(path), { recursive: true, mode: DIR_MODE });
+    appendFileSync(path, `- ${trimmed}\n`, { mode: FILE_MODE });
+}
+//# sourceMappingURL=store.js.map

package/dist/memory/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/memory/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEzC,MAAM,QAAQ,GAAG,KAAK,CAAA;AACtB,MAAM,SAAS,GAAG,KAAK,CAAA;AAEvB,MAAM,UAAU,SAAS,CAAC,OAAe,OAAO,EAAE;IACjD,OAAO,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;AAC5B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe,OAAO,EAAE;IACpD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,CAAA;AACxC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAe,OAAO,EAAE;IACtD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,CAAA;AAC1C,CAAC;AAOD,SAAS,aAAa,CAAC,IAAY;IAClC,IAAI,CAAC;QACJ,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAA;QAC9C,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;IACrC,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAA;IACZ,CAAC;AACF,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,UAAU,CAAC,OAAe,OAAO,EAAE;IAClD,OAAO;QACN,IAAI,EAAE,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,EAAE,aAAa,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;KAC3C,CAAA;AACF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAsB;IACzD,MAAM,QAAQ,GAAa,EAAE,CAAA;IAC7B,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,wBAAwB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;IACtD,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,wBAAwB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACxD,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACtC,OAAO;QACN,0EAA0E;QAC1E,2EAA2E;QAC3E,wBAAwB;QACxB,EAAE;QACF,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;KACrB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACb,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,OAAe,OAAO,EAAE;IAClE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;IAC3B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAM;IAChC,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,CAAA;IACjC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAA;IAC7D,cAAc,CAAC,IAAI,EAAE,KAAK,OAAO,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAA;AAC5D,CAAC"}

package/dist/memory/store.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=store.test.d.ts.map

package/dist/memory/store.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.test.d.ts","sourceRoot":"","sources":["../../src/memory/store.test.ts"],"names":[],"mappings":""}

package/dist/memory/store.test.js

@@ -0,0 +1,63 @@
+import { mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { mkdirSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { appendMemory, composeMemoryPrompt, memoryFilePath, readMemory, userFilePath, } from './store.js';
+let home;
+beforeEach(() => {
+    home = mkdtempSync(join(tmpdir(), 'namzu-mem-'));
+    mkdirSync(join(home, '.namzu'), { recursive: true });
+});
+afterEach(() => {
+    rmSync(home, { recursive: true, force: true });
+});
+describe('readMemory', () => {
+    it('returns nulls when nothing is stored', () => {
+        expect(readMemory(home)).toEqual({ user: null, memory: null });
+    });
+    it('reads USER.md and MEMORY.md and trims', () => {
+        writeFileSync(userFilePath(home), '  I am Bahadir, a TS dev.\n');
+        writeFileSync(memoryFilePath(home), '- prefers tabs\n');
+        expect(readMemory(home)).toEqual({
+            user: 'I am Bahadir, a TS dev.',
+            memory: '- prefers tabs',
+        });
+    });
+    it('treats whitespace-only files as empty', () => {
+        writeFileSync(memoryFilePath(home), '   \n\n');
+        expect(readMemory(home).memory).toBeNull();
+    });
+});
+describe('composeMemoryPrompt', () => {
+    it('returns null when there is nothing to inject', () => {
+        expect(composeMemoryPrompt({ user: null, memory: null })).toBeNull();
+    });
+    it('includes only the sections that have content', () => {
+        const onlyUser = composeMemoryPrompt({ user: 'role: dev', memory: null });
+        expect(onlyUser).toContain('## About the user');
+        expect(onlyUser).toContain('role: dev');
+        expect(onlyUser).not.toContain('## Durable memory');
+        const both = composeMemoryPrompt({ user: 'role: dev', memory: '- likes tabs' });
+        expect(both).toContain('## About the user');
+        expect(both).toContain('## Durable memory');
+        expect(both).toContain('- likes tabs');
+    });
+});
+describe('appendMemory', () => {
+    it('appends a bullet, creating the file', () => {
+        appendMemory('first fact', home);
+        appendMemory('second fact', home);
+        expect(readFileSync(memoryFilePath(home), 'utf8')).toBe('- first fact\n- second fact\n');
+    });
+    it('ignores empty input', () => {
+        appendMemory('   ', home);
+        expect(readMemory(home).memory).toBeNull();
+    });
+    it('round-trips into the injected prompt', () => {
+        appendMemory('namzu is built on @namzu/sdk', home);
+        const prompt = composeMemoryPrompt(readMemory(home));
+        expect(prompt).toContain('namzu is built on @namzu/sdk');
+    });
+});
+//# sourceMappingURL=store.test.js.map

package/dist/memory/store.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.test.js","sourceRoot":"","sources":["../../src/memory/store.test.ts"],"names":[],"mappings":"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"}

package/dist/output/formatter.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Output formatter abstraction for the @namzu/cli binary.
+ *
+ * Commands write structured data through a Formatter rather than building
+ * strings directly. The active formatter is selected by the global
+ * `--format` flag (default `text`). `--quiet` suppresses non-essential
+ * (info/notice) output but always lets errors through.
+ *
+ * The doctor command predates this abstraction and continues to format its
+ * own output via its `--json` flag; future milestones will unify when the
+ * doctor JSON shape is reviewed as part of a deliberate session.
+ */
+export type FormatName = 'text' | 'json' | 'yaml';
+export interface FormatterOptions {
+    readonly quiet: boolean;
+}
+export interface Formatter {
+    readonly name: FormatName;
+    /** Emit a structured success payload to stdout. */
+    print(data: unknown): void;
+    /** Emit a non-essential message; suppressed in quiet mode. */
+    info(message: string): void;
+    /** Emit a structured error payload to stderr; never suppressed. */
+    error(payload: {
+        message: string;
+        details?: unknown;
+    }): void;
+}
+export declare function isFormatName(value: string): value is FormatName;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/output/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/output/formatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;AAEjD,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,mDAAmD;IACnD,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;IAC1B,8DAA8D;IAC9D,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,mEAAmE;IACnE,KAAK,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAA;CAC5D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,UAAU,CAE/D"}

package/dist/output/formatter.js

@@ -0,0 +1,16 @@
+/**
+ * Output formatter abstraction for the @namzu/cli binary.
+ *
+ * Commands write structured data through a Formatter rather than building
+ * strings directly. The active formatter is selected by the global
+ * `--format` flag (default `text`). `--quiet` suppresses non-essential
+ * (info/notice) output but always lets errors through.
+ *
+ * The doctor command predates this abstraction and continues to format its
+ * own output via its `--json` flag; future milestones will unify when the
+ * doctor JSON shape is reviewed as part of a deliberate session.
+ */
+export function isFormatName(value) {
+    return value === 'text' || value === 'json' || value === 'yaml';
+}
+//# sourceMappingURL=formatter.js.map

package/dist/output/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../../src/output/formatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAkBH,MAAM,UAAU,YAAY,CAAC,KAAa;IACzC,OAAO,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,MAAM,CAAA;AAChE,CAAC"}

package/dist/output/formatter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=formatter.test.d.ts.map

package/dist/output/formatter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.test.d.ts","sourceRoot":"","sources":["../../src/output/formatter.test.ts"],"names":[],"mappings":""}

package/dist/output/formatter.test.js

@@ -0,0 +1,88 @@
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { createFormatter, isFormatName } from './index.js';
+describe('formatter factory', () => {
+    let stdout;
+    let stderr;
+    let originalStdoutWrite;
+    let originalStderrWrite;
+    beforeEach(() => {
+        stdout = '';
+        stderr = '';
+        originalStdoutWrite = process.stdout.write.bind(process.stdout);
+        originalStderrWrite = process.stderr.write.bind(process.stderr);
+        process.stdout.write = ((chunk) => {
+            stdout += typeof chunk === 'string' ? chunk : Buffer.from(chunk).toString('utf8');
+            return true;
+        });
+        process.stderr.write = ((chunk) => {
+            stderr += typeof chunk === 'string' ? chunk : Buffer.from(chunk).toString('utf8');
+            return true;
+        });
+    });
+    afterEach(() => {
+        process.stdout.write = originalStdoutWrite;
+        process.stderr.write = originalStderrWrite;
+    });
+    it('isFormatName narrows known names', () => {
+        expect(isFormatName('text')).toBe(true);
+        expect(isFormatName('json')).toBe(true);
+        expect(isFormatName('yaml')).toBe(true);
+        expect(isFormatName('xml')).toBe(false);
+    });
+    it('json formatter emits parseable JSON to stdout', () => {
+        const f = createFormatter('json', { quiet: false });
+        f.print({ hello: 'world', n: 1 });
+        const parsed = JSON.parse(stdout);
+        expect(parsed.hello).toBe('world');
+        expect(parsed.n).toBe(1);
+    });
+    it('yaml formatter emits yaml to stdout', () => {
+        const f = createFormatter('yaml', { quiet: false });
+        f.print({ hello: 'world' });
+        expect(stdout).toContain('hello: world');
+    });
+    it('text formatter passes strings through verbatim', () => {
+        const f = createFormatter('text', { quiet: false });
+        f.print('hello');
+        expect(stdout).toBe('hello\n');
+    });
+    it('info is suppressed in quiet mode for every format', () => {
+        for (const name of ['text', 'json', 'yaml']) {
+            stdout = '';
+            stderr = '';
+            const f = createFormatter(name, { quiet: true });
+            f.info('this should not appear');
+            expect(stderr).toBe('');
+        }
+    });
+    it('errors are never suppressed by quiet mode', () => {
+        for (const name of ['text', 'json', 'yaml']) {
+            stdout = '';
+            stderr = '';
+            const f = createFormatter(name, { quiet: true });
+            f.error({ message: 'boom' });
+            expect(stderr).toContain('boom');
+        }
+    });
+    it('json formatter does not crash on circular references', () => {
+        const f = createFormatter('json', { quiet: false });
+        const obj = { a: 1 };
+        obj.self = obj;
+        f.print(obj);
+        expect(stdout).toContain('"a": 1');
+        expect(stdout).toContain('[Circular]');
+    });
+    it('text formatter does not blow the stack on circular references', () => {
+        const f = createFormatter('text', { quiet: false });
+        const obj = { a: 1 };
+        obj.self = obj;
+        f.print(obj);
+        expect(stdout).toContain('Circular');
+    });
+    it('json formatter serializes bigint via toString instead of throwing', () => {
+        const f = createFormatter('json', { quiet: false });
+        f.print({ big: 12345678901234567890n });
+        expect(stdout).toContain('12345678901234567890');
+    });
+});
+//# sourceMappingURL=formatter.test.js.map

package/dist/output/formatter.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.test.js","sourceRoot":"","sources":["../../src/output/formatter.test.ts"],"names":[],"mappings":"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"}

package/dist/output/index.d.ts

@@ -0,0 +1,5 @@
+import { type FormatName, type Formatter, type FormatterOptions, isFormatName } from './formatter.js';
+export { isFormatName };
+export type { FormatName, Formatter, FormatterOptions };
+export declare function createFormatter(name: FormatName, opts: FormatterOptions): Formatter;
+//# sourceMappingURL=index.d.ts.map

package/dist/output/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/output/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,YAAY,EACZ,MAAM,gBAAgB,CAAA;AAKvB,OAAO,EAAE,YAAY,EAAE,CAAA;AACvB,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAA;AAEvD,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,gBAAgB,GAAG,SAAS,CAenF"}

package/dist/output/index.js

@@ -0,0 +1,22 @@
+import { isFormatName, } from './formatter.js';
+import { JsonFormatter } from './json.js';
+import { TextFormatter } from './text.js';
+import { YamlFormatter } from './yaml.js';
+export { isFormatName };
+export function createFormatter(name, opts) {
+    switch (name) {
+        case 'text':
+            return new TextFormatter(opts);
+        case 'json':
+            return new JsonFormatter(opts);
+        case 'yaml':
+            return new YamlFormatter(opts);
+        default: {
+            // Exhaustiveness: TS will fail to compile this assignment if a new
+            // FormatName variant is added without updating the switch.
+            const _exhaustive = name;
+            throw new Error(`Unknown format: ${String(_exhaustive)}`);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/output/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/output/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAIN,YAAY,GACZ,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAEzC,OAAO,EAAE,YAAY,EAAE,CAAA;AAGvB,MAAM,UAAU,eAAe,CAAC,IAAgB,EAAE,IAAsB;IACvE,QAAQ,IAAI,EAAE,CAAC;QACd,KAAK,MAAM;YACV,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,CAAA;QAC/B,KAAK,MAAM;YACV,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,CAAA;QAC/B,KAAK,MAAM;YACV,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,CAAA;QAC/B,OAAO,CAAC,CAAC,CAAC;YACT,mEAAmE;YACnE,2DAA2D;YAC3D,MAAM,WAAW,GAAU,IAAI,CAAA;YAC/B,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;QAC1D,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/output/json.d.ts

@@ -0,0 +1,13 @@
+import type { Formatter, FormatterOptions } from './formatter.js';
+export declare class JsonFormatter implements Formatter {
+    private readonly opts;
+    readonly name: "json";
+    constructor(opts: FormatterOptions);
+    print(data: unknown): void;
+    info(message: string): void;
+    error(payload: {
+        message: string;
+        details?: unknown;
+    }): void;
+}
+//# sourceMappingURL=json.d.ts.map

package/dist/output/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/output/json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEjE,qBAAa,aAAc,YAAW,SAAS;IAGlC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAS;gBAEF,IAAI,EAAE,gBAAgB;IAEnD,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAI1B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK3B,KAAK,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;CAQ5D"}

package/dist/output/json.js

@@ -0,0 +1,51 @@
+export class JsonFormatter {
+    opts;
+    name = 'json';
+    constructor(opts) {
+        this.opts = opts;
+    }
+    print(data) {
+        process.stdout.write(`${safeStringify(data)}\n`);
+    }
+    info(message) {
+        if (this.opts.quiet)
+            return;
+        process.stderr.write(`${JSON.stringify({ level: 'info', message })}\n`);
+    }
+    error(payload) {
+        const out = {
+            level: 'error',
+            message: payload.message,
+        };
+        if (payload.details !== undefined)
+            out.details = payload.details;
+        process.stderr.write(`${safeStringify(out)}\n`);
+    }
+}
+/**
+ * `JSON.stringify` throws on circular references. The CLI must never crash
+ * a command in the middle of emitting structured output, so we substitute
+ * a sentinel for cycles and fall back to a safe shape on serializer error.
+ */
+function safeStringify(data) {
+    const seen = new WeakSet();
+    try {
+        return JSON.stringify(data, (_key, value) => {
+            if (typeof value === 'object' && value !== null) {
+                if (seen.has(value))
+                    return '[Circular]';
+                seen.add(value);
+            }
+            if (typeof value === 'bigint')
+                return value.toString();
+            return value;
+        }, 2);
+    }
+    catch (err) {
+        return JSON.stringify({
+            error: 'unserializable',
+            detail: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+//# sourceMappingURL=json.js.map

package/dist/output/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/output/json.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,aAAa;IAGI;IAFpB,IAAI,GAAG,MAAe,CAAA;IAE/B,YAA6B,IAAsB;QAAtB,SAAI,GAAJ,IAAI,CAAkB;IAAG,CAAC;IAEvD,KAAK,CAAC,IAAa;QAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACjD,CAAC;IAED,IAAI,CAAC,OAAe;QACnB,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAM;QAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,CAAA;IACxE,CAAC;IAED,KAAK,CAAC,OAA+C;QACpD,MAAM,GAAG,GAA4B;YACpC,KAAK,EAAE,OAAO;YACd,OAAO,EAAE,OAAO,CAAC,OAAO;SACxB,CAAA;QACD,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;YAAE,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAA;QAChE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAChD,CAAC;CACD;AAED;;;;GAIG;AACH,SAAS,aAAa,CAAC,IAAa;IACnC,MAAM,IAAI,GAAG,IAAI,OAAO,EAAU,CAAA;IAClC,IAAI,CAAC;QACJ,OAAO,IAAI,CAAC,SAAS,CACpB,IAAI,EACJ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YACf,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACjD,IAAI,IAAI,CAAC,GAAG,CAAC,KAAe,CAAC;oBAAE,OAAO,YAAY,CAAA;gBAClD,IAAI,CAAC,GAAG,CAAC,KAAe,CAAC,CAAA;YAC1B,CAAC;YACD,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAA;YACtD,OAAO,KAAK,CAAA;QACb,CAAC,EACD,CAAC,CACD,CAAA;IACF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,OAAO,IAAI,CAAC,SAAS,CAAC;YACrB,KAAK,EAAE,gBAAgB;YACvB,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CAAC,CAAA;IACH,CAAC;AACF,CAAC"}

package/dist/output/text.d.ts

@@ -0,0 +1,13 @@
+import type { Formatter, FormatterOptions } from './formatter.js';
+export declare class TextFormatter implements Formatter {
+    private readonly opts;
+    readonly name: "text";
+    constructor(opts: FormatterOptions);
+    print(data: unknown): void;
+    info(message: string): void;
+    error(payload: {
+        message: string;
+        details?: unknown;
+    }): void;
+}
+//# sourceMappingURL=text.d.ts.map

package/dist/output/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/output/text.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEjE,qBAAa,aAAc,YAAW,SAAS;IAGlC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAS;gBAEF,IAAI,EAAE,gBAAgB;IAEnD,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAI1B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK3B,KAAK,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;CAM5D"}

package/dist/output/text.js

@@ -0,0 +1,36 @@
+import { inspect } from 'node:util';
+export class TextFormatter {
+    opts;
+    name = 'text';
+    constructor(opts) {
+        this.opts = opts;
+    }
+    print(data) {
+        process.stdout.write(`${renderText(data)}\n`);
+    }
+    info(message) {
+        if (this.opts.quiet)
+            return;
+        process.stderr.write(`${message}\n`);
+    }
+    error(payload) {
+        process.stderr.write(`Error: ${payload.message}\n`);
+        if (payload.details !== undefined) {
+            process.stderr.write(`${renderText(payload.details)}\n`);
+        }
+    }
+}
+function renderText(data) {
+    if (data === null || data === undefined)
+        return '';
+    if (typeof data === 'string')
+        return data;
+    if (typeof data === 'number' || typeof data === 'boolean' || typeof data === 'bigint') {
+        return String(data);
+    }
+    // `depth: 6` is generous for CLI payloads while keeping pathological
+    // (deeply nested or self-referencing) graphs from exhausting stack/heap.
+    // `inspect` already marks already-seen objects as `[Circular]`.
+    return inspect(data, { depth: 6, colors: false, compact: false });
+}
+//# sourceMappingURL=text.js.map

package/dist/output/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/output/text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAInC,MAAM,OAAO,aAAa;IAGI;IAFpB,IAAI,GAAG,MAAe,CAAA;IAE/B,YAA6B,IAAsB;QAAtB,SAAI,GAAJ,IAAI,CAAkB;IAAG,CAAC;IAEvD,KAAK,CAAC,IAAa;QAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC9C,CAAC;IAED,IAAI,CAAC,OAAe;QACnB,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAM;QAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAA;IACrC,CAAC;IAED,KAAK,CAAC,OAA+C;QACpD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,CAAC,OAAO,IAAI,CAAC,CAAA;QACnD,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACzD,CAAC;IACF,CAAC;CACD;AAED,SAAS,UAAU,CAAC,IAAa;IAChC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,CAAA;IAClD,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IACzC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,SAAS,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACvF,OAAO,MAAM,CAAC,IAAI,CAAC,CAAA;IACpB,CAAC;IACD,qEAAqE;IACrE,yEAAyE;IACzE,gEAAgE;IAChE,OAAO,OAAO,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;AAClE,CAAC"}