@productbrain/cli 0.1.0-beta.7 → 0.1.0-beta.9

package/dist/__tests__/strip.test.js

@@ -0,0 +1,136 @@
+/**
+ * stripConvexInternals — unit tests.
+ * BET-181 Slice 0: TEN-340 (Convex internal exposure), DEC-299 (JSON-default output).
+ *
+ * Verifies: removes _id and _creationTime, preserves entryId and all other fields,
+ * handles nested objects and arrays, does not mutate input.
+ */
+import { describe, expect, it } from 'vitest';
+import { stripConvexInternals } from '../lib/strip.js';
+describe('stripConvexInternals', () => {
+    it('removes _id from a flat object', () => {
+        const input = { _id: 'j57abc', entryId: 'BET-181', name: 'Test' };
+        const result = stripConvexInternals(input);
+        expect(result).not.toHaveProperty('_id');
+        expect(result).toHaveProperty('entryId', 'BET-181');
+        expect(result).toHaveProperty('name', 'Test');
+    });
+    it('removes _creationTime from a flat object', () => {
+        const input = { _creationTime: 1700000000000, entryId: 'BET-181', name: 'Test' };
+        const result = stripConvexInternals(input);
+        expect(result).not.toHaveProperty('_creationTime');
+        expect(result).toHaveProperty('entryId', 'BET-181');
+    });
+    it('removes both _id and _creationTime simultaneously', () => {
+        const input = {
+            _id: 'j57abc',
+            _creationTime: 1700000000000,
+            entryId: 'BET-181',
+            name: 'Test',
+            status: 'active',
+        };
+        const result = stripConvexInternals(input);
+        expect(result).not.toHaveProperty('_id');
+        expect(result).not.toHaveProperty('_creationTime');
+        expect(result).toEqual({ entryId: 'BET-181', name: 'Test', status: 'active' });
+    });
+    it('preserves entryId (human-readable) unconditionally', () => {
+        const input = { _id: 'sys1', _creationTime: 123, entryId: 'DEC-299' };
+        const result = stripConvexInternals(input);
+        expect(result).toHaveProperty('entryId', 'DEC-299');
+    });
+    it('preserves all other fields untouched', () => {
+        const input = {
+            _id: 'sys1',
+            name: 'My entry',
+            status: 'draft',
+            collectionSlug: 'bets',
+            data: { description: 'hello' },
+        };
+        const result = stripConvexInternals(input);
+        expect(result).toEqual({
+            name: 'My entry',
+            status: 'draft',
+            collectionSlug: 'bets',
+            data: { description: 'hello' },
+        });
+    });
+    it('recursively strips _id and _creationTime from nested objects', () => {
+        const input = {
+            entryId: 'BET-181',
+            relations: [
+                { _id: 'rel1', _creationTime: 111, type: 'part_of', otherEntryId: 'INI-1' },
+            ],
+            data: {
+                _id: 'should-be-removed',
+                description: 'keep this',
+            },
+        };
+        const result = stripConvexInternals(input);
+        // Top level
+        expect(result).toHaveProperty('entryId', 'BET-181');
+        // Nested in array
+        const rel = result.relations[0];
+        expect(rel).not.toHaveProperty('_id');
+        expect(rel).not.toHaveProperty('_creationTime');
+        expect(rel).toHaveProperty('type', 'part_of');
+        expect(rel).toHaveProperty('otherEntryId', 'INI-1');
+        // Nested in object
+        const data = result.data;
+        expect(data).not.toHaveProperty('_id');
+        expect(data).toHaveProperty('description', 'keep this');
+    });
+    it('handles arrays of objects', () => {
+        const input = [
+            { _id: 'a', entryId: 'BET-1', name: 'Bet 1' },
+            { _id: 'b', _creationTime: 999, entryId: 'TEN-1', name: 'Tension 1' },
+        ];
+        const result = stripConvexInternals(input);
+        expect(result).toHaveLength(2);
+        expect(result[0]).not.toHaveProperty('_id');
+        expect(result[0]).toHaveProperty('entryId', 'BET-1');
+        expect(result[1]).not.toHaveProperty('_id');
+        expect(result[1]).not.toHaveProperty('_creationTime');
+        expect(result[1]).toHaveProperty('entryId', 'TEN-1');
+    });
+    it('handles null values without error', () => {
+        const result = stripConvexInternals(null);
+        expect(result).toBeNull();
+    });
+    it('handles primitive values (string, number, boolean) as pass-through', () => {
+        expect(stripConvexInternals('hello')).toBe('hello');
+        expect(stripConvexInternals(42)).toBe(42);
+        expect(stripConvexInternals(true)).toBe(true);
+    });
+    it('does not mutate the input object', () => {
+        const input = { _id: 'sys1', entryId: 'BET-1', name: 'Test' };
+        const inputCopy = { ...input };
+        stripConvexInternals(input);
+        expect(input).toEqual(inputCopy);
+    });
+    it('handles empty objects and arrays', () => {
+        expect(stripConvexInternals({})).toEqual({});
+        expect(stripConvexInternals([])).toEqual([]);
+    });
+    it('handles deeply nested structures', () => {
+        const input = {
+            _id: 'top',
+            level1: {
+                _id: 'l1',
+                level2: {
+                    _id: 'l2',
+                    _creationTime: 123,
+                    value: 'deep',
+                },
+            },
+        };
+        const result = stripConvexInternals(input);
+        expect(result).not.toHaveProperty('_id');
+        const r = result;
+        expect(r.level1).not.toHaveProperty('_id');
+        expect(r.level1.level2).not.toHaveProperty('_id');
+        expect(r.level1.level2).not.toHaveProperty('_creationTime');
+        expect(r.level1.level2['value']).toBe('deep');
+    });
+});
+//# sourceMappingURL=strip.test.js.map

package/dist/__tests__/strip.test.js.map

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

package/dist/__tests__/update.test.d.ts

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

package/dist/__tests__/update.test.d.ts.map

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

package/dist/__tests__/update.test.js

@@ -0,0 +1,148 @@
+/**
+ * pb update — verify mcpCallWithSession sequence and args.
+ * TEN-341 test contract: happy path, no session, empty entryId.
+ */
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { runUpdate } from '../commands/update.js';
+const mcpCallWithSessionMock = vi.fn();
+vi.mock('../lib/client.js', () => ({
+    mcpCallWithSession: (...args) => mcpCallWithSessionMock(...args),
+}));
+vi.mock('../lib/config.js', () => ({
+    getConfigOrGuide: vi.fn(() => Promise.resolve({ apiKey: 'pb_sk_test', siteUrl: 'https://test.convex.site' })),
+}));
+// Force pretty mode for all tests so formatUpdateReceipt output is tested (not JSON)
+vi.mock('../lib/runner.js', () => ({
+    isJsonMode: () => false,
+}));
+// Session mock — controlled per test
+let mockSession = { sessionId: 'sess-test' };
+vi.mock('../lib/session.js', () => ({
+    readSession: () => mockSession,
+}));
+describe('runUpdate', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockSession = { sessionId: 'sess-test' };
+        // BET-192: updateEntry returns warnings + normalization breakdown (symmetric with createEntry)
+        mcpCallWithSessionMock.mockResolvedValue({
+            id: 'j571abc123def456',
+            warnings: [],
+            normalization: { remapped: {}, rejected: [], accepted: [] },
+            normalizationWarnings: [],
+            validationWarnings: [],
+        });
+    });
+    it('calls chain.updateEntry with correct args (happy path)', async () => {
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        await runUpdate({
+            entryId: 'BET-151',
+            field: ['description=new description'],
+            note: 'Updated description',
+        });
+        writeSpy.mockRestore();
+        expect(mcpCallWithSessionMock).toHaveBeenCalledWith('chain.updateEntry', {
+            entryId: 'BET-151',
+            data: { description: 'new description' },
+            changeNote: 'Updated description',
+        });
+    });
+    it('passes name and status when provided', async () => {
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        await runUpdate({
+            entryId: 'TEN-703',
+            name: 'New name',
+            status: 'active',
+            note: 'Resolved',
+        });
+        writeSpy.mockRestore();
+        expect(mcpCallWithSessionMock).toHaveBeenCalledWith('chain.updateEntry', {
+            entryId: 'TEN-703',
+            name: 'New name',
+            status: 'active',
+            changeNote: 'Resolved',
+        });
+    });
+    it('handles --field values containing = signs', async () => {
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        await runUpdate({
+            entryId: 'DEC-264',
+            field: ['rationale=a=b=c'],
+        });
+        writeSpy.mockRestore();
+        expect(mcpCallWithSessionMock).toHaveBeenCalledWith('chain.updateEntry', {
+            entryId: 'DEC-264',
+            data: { rationale: 'a=b=c' },
+        });
+    });
+    it('exits 1 with no active session', async () => {
+        mockSession = null;
+        const exitSpy = vi.spyOn(process, 'exit').mockImplementation(() => { throw new Error('exit'); });
+        const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+        await expect(runUpdate({ entryId: 'BET-151', field: ['x=1'] })).rejects.toThrow('exit');
+        expect(exitSpy).toHaveBeenCalledWith(1);
+        const stderrOutput = stderrSpy.mock.calls.map(c => String(c[0])).join('');
+        expect(stderrOutput).toContain('No active session');
+        expect(mcpCallWithSessionMock).not.toHaveBeenCalled();
+        exitSpy.mockRestore();
+        stderrSpy.mockRestore();
+    });
+    it('exits 1 with empty entryId', async () => {
+        const exitSpy = vi.spyOn(process, 'exit').mockImplementation(() => { throw new Error('exit'); });
+        const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+        await expect(runUpdate({ entryId: '  ', field: ['x=1'] })).rejects.toThrow('exit');
+        expect(exitSpy).toHaveBeenCalledWith(1);
+        expect(mcpCallWithSessionMock).not.toHaveBeenCalled();
+        exitSpy.mockRestore();
+        stderrSpy.mockRestore();
+    });
+    it('exits 1 when nothing to update', async () => {
+        const exitSpy = vi.spyOn(process, 'exit').mockImplementation(() => { throw new Error('exit'); });
+        const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+        await expect(runUpdate({ entryId: 'BET-151' })).rejects.toThrow('exit');
+        expect(exitSpy).toHaveBeenCalledWith(1);
+        const stderrOutput = stderrSpy.mock.calls.map(c => String(c[0])).join('');
+        expect(stderrOutput).toContain('Nothing to update');
+        expect(mcpCallWithSessionMock).not.toHaveBeenCalled();
+        exitSpy.mockRestore();
+        stderrSpy.mockRestore();
+    });
+    // ── BET-192 / FEAT-575: Normalization warning tests ──────────────────────
+    it('displays normalization warnings when fields are rejected (BET-192)', async () => {
+        mcpCallWithSessionMock.mockResolvedValue({
+            id: 'j571abc123def456',
+            warnings: ['Unknown field "foo" dropped. Available fields: description, doneWhen'],
+            normalization: { remapped: {}, rejected: ['foo'], accepted: ['description'] },
+            normalizationWarnings: ['Unknown field "foo" dropped. Available fields: description, doneWhen'],
+            validationWarnings: [],
+        });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        await runUpdate({
+            entryId: 'BET-192',
+            field: ['foo=bar'],
+        });
+        const output = writeSpy.mock.calls.map(c => String(c[0])).join('');
+        writeSpy.mockRestore();
+        expect(output).toContain('Normalization warnings');
+        expect(output).toContain('foo');
+    });
+    it('displays no warnings when all fields are valid (BET-192)', async () => {
+        mcpCallWithSessionMock.mockResolvedValue({
+            id: 'j571abc123def456',
+            warnings: [],
+            normalization: { remapped: {}, rejected: [], accepted: ['description'] },
+            normalizationWarnings: [],
+            validationWarnings: [],
+        });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        await runUpdate({
+            entryId: 'BET-192',
+            field: ['description=valid value'],
+        });
+        const output = writeSpy.mock.calls.map(c => String(c[0])).join('');
+        writeSpy.mockRestore();
+        expect(output).not.toContain('Normalization warnings');
+        expect(output).not.toContain('Validation warnings');
+    });
+});
+//# sourceMappingURL=update.test.js.map

package/dist/__tests__/update.test.js.map

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

package/dist/commands/capture.d.ts

@@ -0,0 +1,21 @@
+/**
+ * pb capture — write knowledge to the Chain during a CLI session.
+ * Calls resolveCollection (classification) → createEntry (draft).
+ * Shows rich receipt per FEAT-126 (capture receipts with correction affordance).
+ * Requires active session (DEC-9, BR-8).
+ * BET-181 Slice 0: uses isJsonMode() for output branching. Existing --json flag
+ * is preserved for backward compatibility (it sets output mode via the runner).
+ */
+interface CaptureOptions {
+    text: string;
+    name?: string;
+    description?: string;
+    collection?: string;
+    link?: string;
+    type?: string;
+    /** @deprecated Use global --json flag instead. Preserved for backward compatibility. */
+    json?: boolean;
+}
+export declare function runCapture(options: CaptureOptions): Promise<void>;
+export {};
+//# sourceMappingURL=capture.d.ts.map

package/dist/commands/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/commands/capture.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA4BH,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA4FvE"}

package/dist/commands/capture.js

@@ -0,0 +1,100 @@
+/**
+ * pb capture — write knowledge to the Chain during a CLI session.
+ * Calls resolveCollection (classification) → createEntry (draft).
+ * Shows rich receipt per FEAT-126 (capture receipts with correction affordance).
+ * Requires active session (DEC-9, BR-8).
+ * BET-181 Slice 0: uses isJsonMode() for output branching. Existing --json flag
+ * is preserved for backward compatibility (it sets output mode via the runner).
+ */
+import { getConfigOrGuide } from '../lib/config.js';
+import { mcpCallWithSession } from '../lib/client.js';
+import { readSession, addCapturedEntry } from '../lib/session.js';
+import { isJsonMode } from '../lib/runner.js';
+import { formatCaptureReceipt } from '../formatters/capture.js';
+export async function runCapture(options) {
+    const config = await getConfigOrGuide(() => runCapture(options));
+    if (!config)
+        return;
+    // Support both legacy --json flag and global output mode (DEC-299, backward compat)
+    const json = isJsonMode() || options.json === true;
+    // Require active session (DEC-9, BR-8)
+    const session = readSession();
+    if (!session) {
+        process.stderr.write('No active session. Run `pb session start` first.\n');
+        process.stderr.write('Write access requires a tracked session (DEC-9).\n');
+        process.exit(1);
+    }
+    const entryName = options.name ?? options.text;
+    const entryDescription = options.description ?? options.text;
+    // Phase 1: Resolve collection (classification)
+    let collectionSlug;
+    let classification = null;
+    if (options.collection) {
+        // Explicit collection — skip classification
+        collectionSlug = options.collection;
+    }
+    else {
+        if (!json)
+            process.stdout.write('Classifying...\n');
+        classification = await mcpCallWithSession('chain.resolveCollection', {
+            entryName,
+            entryDescription,
+        });
+        collectionSlug = classification.collection;
+    }
+    // Phase 2: Create entry as draft
+    if (!json)
+        process.stdout.write(`Capturing to ${collectionSlug}...\n`);
+    const data = { description: entryDescription };
+    // Add date for collections that use it
+    const datedCollections = ['tensions', 'decisions', 'insights', 'standards', 'business-rules'];
+    if (datedCollections.includes(collectionSlug)) {
+        data.date = new Date().toISOString().split('T')[0];
+    }
+    const result = await mcpCallWithSession('chain.createEntry', {
+        collectionSlug,
+        name: entryName,
+        status: 'draft',
+        data,
+        sessionId: session.sessionId,
+        createdBy: `agent:${session.sessionId}`,
+    });
+    // Track in session state
+    addCapturedEntry(result.entryId);
+    // Phase 3: Link to existing entry if --link provided (TEN-705)
+    if (options.link) {
+        const linkTarget = options.link.trim();
+        const relationType = options.type ?? 'surfaces_tension_in';
+        if (linkTarget) {
+            await mcpCallWithSession('chain.createEntryRelation', {
+                fromEntryId: result.entryId,
+                toEntryId: linkTarget,
+                type: relationType,
+            });
+        }
+    }
+    // Output
+    if (json) {
+        // Machine-readable output (TEN-709, DEC-299)
+        process.stdout.write(JSON.stringify({
+            id: result.entryId,
+            collection: collectionSlug,
+            confidence: classification?.tier ?? 'explicit',
+        }) + '\n');
+    }
+    else {
+        process.stdout.write('\n');
+        process.stdout.write(formatCaptureReceipt({
+            entryId: result.entryId,
+            name: entryName,
+            collection: collectionSlug,
+            status: 'draft',
+            classification,
+            warnings: result.warnings,
+            normalization: result.normalization,
+            linkedTo: options.link,
+            relationType: options.link ? (options.type ?? 'surfaces_tension_in') : undefined,
+        }) + '\n');
+    }
+}
+//# sourceMappingURL=capture.js.map

package/dist/commands/capture.js.map

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

package/dist/commands/constellation.d.ts

@@ -0,0 +1,11 @@
+/**
+ * pb constellation <entry-id> — compound view: entry + grouped relations.
+ * BET-181 Slice 3: agents can assess a shaped bet from this single output.
+ *
+ * Chain: DEC-299 (agent-native, JSON-default), STD-65 (structured, parseable, minimal),
+ * ARCH-25 (orient view model pattern), DEC-99 (ALLOWED_RELATION_TYPES as SSOT)
+ */
+export declare function runConstellation(options: {
+    entryId: string;
+}): Promise<void>;
+//# sourceMappingURL=constellation.d.ts.map

package/dist/commands/constellation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constellation.d.ts","sourceRoot":"","sources":["../../src/commands/constellation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBlF"}

package/dist/commands/constellation.js

@@ -0,0 +1,28 @@
+/**
+ * pb constellation <entry-id> — compound view: entry + grouped relations.
+ * BET-181 Slice 3: agents can assess a shaped bet from this single output.
+ *
+ * Chain: DEC-299 (agent-native, JSON-default), STD-65 (structured, parseable, minimal),
+ * ARCH-25 (orient view model pattern), DEC-99 (ALLOWED_RELATION_TYPES as SSOT)
+ */
+import { getConfigOrGuide } from '../lib/config.js';
+import { mcpCall } from '../lib/client.js';
+import { runCliCommand } from '../lib/runner.js';
+import { formatConstellation } from '../formatters/constellation.js';
+export async function runConstellation(options) {
+    const config = await getConfigOrGuide(() => runConstellation(options));
+    if (!config)
+        return;
+    await runCliCommand({
+        fn: () => mcpCall('chain.getConstellation', {
+            entryId: options.entryId,
+        }),
+        formatPretty: (result) => {
+            if (!result?.entry) {
+                throw new Error(`Entry "${options.entryId}" not found.`);
+            }
+            return formatConstellation(result);
+        },
+    });
+}
+//# sourceMappingURL=constellation.js.map

package/dist/commands/constellation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constellation.js","sourceRoot":"","sources":["../../src/commands/constellation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAA4B,MAAM,gCAAgC,CAAC;AAE/F,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAA4B;IACjE,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IACvE,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,aAAa,CAAsB;QACvC,EAAE,EAAE,GAAG,EAAE,CACP,OAAO,CAAsB,wBAAwB,EAAE;YACrD,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC;QACJ,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;YACvB,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;gBACnB,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,CAAC,OAAO,cAAc,CAAC,CAAC;YAC3D,CAAC;YACD,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/context.d.ts

@@ -1,6 +1,7 @@
 /**
  * pb context <entry-id> — gather and display constellation context.
- * Pipe-friendly: when stdout is not a TTY, output clean markdown (no ANSI codes).
+ * BET-181 Slice 0: routes through runCliCommand for JSON-default output.
+ * Previously: pipe-friendly via process.stdout.isTTY — now delegated to runner.
  */
 export declare function runContext(options: {
     entryId: string;

package/dist/commands/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,wBAAsB,UAAU,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAe5E"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,wBAAsB,UAAU,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB5E"}

package/dist/commands/context.js

@@ -1,22 +1,28 @@
 /**
  * pb context <entry-id> — gather and display constellation context.
- * Pipe-friendly: when stdout is not a TTY, output clean markdown (no ANSI codes).
+ * BET-181 Slice 0: routes through runCliCommand for JSON-default output.
+ * Previously: pipe-friendly via process.stdout.isTTY — now delegated to runner.
  */
 import { getConfigOrGuide } from '../lib/config.js';
 import { mcpCall } from '../lib/client.js';
+import { runCliCommand, isJsonMode } from '../lib/runner.js';
 import { formatContext } from '../formatters/context.js';
 export async function runContext(options) {
     const config = await getConfigOrGuide(() => runContext(options));
     if (!config)
         return;
-    const result = await mcpCall('chain.gatherContext', {
-        entryId: options.entryId,
-        maxHops: 2,
+    await runCliCommand({
+        fn: () => mcpCall('chain.gatherContext', {
+            entryId: options.entryId,
+            maxHops: 2,
+        }),
+        formatPretty: (result) => {
+            if (!result?.root) {
+                throw new Error(`Entry "${options.entryId}" not found.`);
+            }
+            // In pretty mode, use tty: true for rich terminal output
+            return formatContext(result, { tty: !isJsonMode() });
+        },
     });
-    if (!result?.root) {
-        throw new Error(`Entry "${options.entryId}" not found.`);
-    }
-    const tty = Boolean(process.stdout.isTTY);
-    console.log(formatContext(result, { tty }));
 }
 //# sourceMappingURL=context.js.map

package/dist/commands/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAsB,MAAM,0BAA0B,CAAC;AAE7E,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAA4B;IAC3D,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IACjE,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAgB,qBAAqB,EAAE;QACjE,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,OAAO,EAAE,CAAC;KACX,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,CAAC,OAAO,cAAc,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAsB,MAAM,0BAA0B,CAAC;AAE7E,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAA4B;IAC3D,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IACjE,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,aAAa,CAAgB;QACjC,EAAE,EAAE,GAAG,EAAE,CAAC,OAAO,CAAgB,qBAAqB,EAAE;YACtD,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,OAAO,EAAE,CAAC;SACX,CAAC;QACF,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;YACvB,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;gBAClB,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,CAAC,OAAO,cAAc,CAAC,CAAC;YAC3D,CAAC;YACD,yDAAyD;YACzD,OAAO,aAAa,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACvD,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/fields.d.ts

@@ -0,0 +1,9 @@
+/**
+ * pb fields <collection> — display all field definitions for a collection.
+ * BET-181 Slice 2: Schema discovery for CLI agents (DEC-299).
+ * Chain: BET-181, STD-101 (SSOT — fields derive from collection doc, no hardcoded lists)
+ */
+export declare function runFields(options: {
+    collectionSlug: string;
+}): Promise<void>;
+//# sourceMappingURL=fields.d.ts.map

package/dist/commands/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/commands/fields.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,wBAAsB,SAAS,CAAC,OAAO,EAAE;IAAE,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBlF"}

package/dist/commands/fields.js

@@ -0,0 +1,26 @@
+/**
+ * pb fields <collection> — display all field definitions for a collection.
+ * BET-181 Slice 2: Schema discovery for CLI agents (DEC-299).
+ * Chain: BET-181, STD-101 (SSOT — fields derive from collection doc, no hardcoded lists)
+ */
+import { getConfigOrGuide } from '../lib/config.js';
+import { mcpCall } from '../lib/client.js';
+import { runCliCommand } from '../lib/runner.js';
+import { formatFields } from '../formatters/fields.js';
+export async function runFields(options) {
+    const config = await getConfigOrGuide(() => runFields(options));
+    if (!config)
+        return;
+    await runCliCommand({
+        fn: async () => {
+            const result = await mcpCall('chain.getCollectionFields', { slug: options.collectionSlug });
+            if (!result) {
+                throw new Error(`Collection '${options.collectionSlug}' not found. ` +
+                    `Run 'pb fields' with a valid collection slug (e.g. bets, decisions, tensions).`);
+            }
+            return result;
+        },
+        formatPretty: (result) => formatFields(result),
+    });
+}
+//# sourceMappingURL=fields.js.map

package/dist/commands/fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../src/commands/fields.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAA+B,MAAM,yBAAyB,CAAC;AAEpF,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAmC;IACjE,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,aAAa,CAAyB;QAC1C,EAAE,EAAE,KAAK,IAAI,EAAE;YACb,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,2BAA2B,EAC3B,EAAE,IAAI,EAAE,OAAO,CAAC,cAAc,EAAE,CACjC,CAAC;YACF,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CACb,eAAe,OAAO,CAAC,cAAc,eAAe;oBACpD,gFAAgF,CACjF,CAAC;YACJ,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC;KAC/C,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/get.d.ts

@@ -1,8 +1,15 @@
 /**
  * pb get — display full entry by ID (data, relations, last 10 history events).
- * BET-108 Slice 3.
+ * BET-108 Slice 3. BET-181 Slice 0: routes through runCliCommand for JSON-default output.
  */
 export declare function runGet(options: {
     entryId: string;
 }): Promise<void>;
+/**
+ * pb get-many — fetch multiple entries in parallel.
+ * Resolves TEN-703 context-loading gap for multi-agent orchestration startup.
+ */
+export declare function runGetMany(options: {
+    entryIds: string[];
+}): Promise<void>;
 //# sourceMappingURL=get.d.ts.map

package/dist/commands/get.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../src/commands/get.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,wBAAsB,MAAM,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAcxE"}
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../src/commands/get.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,wBAAsB,MAAM,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAcxE;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA2C/E"}