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

package/dist/commands/orient.js

@@ -1,8 +1,10 @@
 /**
  * pb orient — prints workspace stage and all orient sections per ARCH-25.
+ * BET-181 Slice 0: routes through runCliCommand for JSON-default output.
  */
 import { getConfigOrGuide } from '../lib/config.js';
 import { mcpCall } from '../lib/client.js';
+import { runCliCommand } from '../lib/runner.js';
 import { formatOrient, formatOrientBrief } from '../formatters/orient.js';
 function normalizeView(raw) {
     return {
@@ -29,13 +31,16 @@ export async function runOrient(options = {}) {
     const config = await getConfigOrGuide(() => runOrient(options));
     if (!config)
         return;
-    const raw = await mcpCall('chain.getOrientView', {});
-    const view = normalizeView(raw);
-    if (options.brief) {
-        console.log(formatOrientBrief(view));
-    }
-    else {
-        console.log(formatOrient(view));
-    }
+    await runCliCommand({
+        fn: async () => {
+            const raw = await mcpCall('chain.getOrientView', {});
+            // Normalize before output in any mode — ensures JSON keys are stable
+            // for agent consumers (optional sections become empty arrays, not absent).
+            return normalizeView(raw);
+        },
+        formatPretty: (view) => {
+            return options.brief ? formatOrientBrief(view) : formatOrient(view);
+        },
+    });
 }
 //# sourceMappingURL=orient.js.map

package/dist/commands/orient.js.map

@@ -1 +1 @@
-{"version":3,"file":"orient.js","sourceRoot":"","sources":["../../src/commands/orient.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AA4D1E,SAAS,aAAa,CAAC,GAAsB;IAC3C,OAAO;QACL,GAAG,GAAG;QACN,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI;YAC5B,UAAU,EAAE,EAAE;YACd,SAAS,EAAE,EAAE;YACb,aAAa,EAAE,EAAE;SAClB;QACD,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE;QAC5B,iBAAiB,EAAE,GAAG,CAAC,iBAAiB,IAAI,EAAE;QAC9C,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE;QAC9B,cAAc,EAAE,GAAG,CAAC,cAAc,IAAI,EAAE;QACxC,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI;YAC9B,iBAAiB,EAAE,EAAE;YACrB,iBAAiB,EAAE,EAAE;YACrB,YAAY,EAAE,EAAE;SACjB;QACD,aAAa,EAAE,GAAG,CAAC,aAAa,IAAI,EAAE;QACtC,aAAa,EAAE,GAAG,CAAC,aAAa,IAAI,IAAI;KACzC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,UAA+B,EAAE;IAC/D,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,GAAG,GAAG,MAAM,OAAO,CAAoB,qBAAqB,EAAE,EAAE,CAAC,CAAC;IACxE,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAEhC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;IACvC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;IAClC,CAAC;AACH,CAAC"}
+{"version":3,"file":"orient.js","sourceRoot":"","sources":["../../src/commands/orient.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,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAmB,MAAM,yBAAyB,CAAC;AA4D3F,SAAS,aAAa,CAAC,GAAsB;IAC3C,OAAO;QACL,GAAG,GAAG;QACN,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI;YAC5B,UAAU,EAAE,EAAE;YACd,SAAS,EAAE,EAAE;YACb,aAAa,EAAE,EAAE;SAClB;QACD,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE;QAC5B,iBAAiB,EAAE,GAAG,CAAC,iBAAiB,IAAI,EAAE;QAC9C,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE;QAC9B,cAAc,EAAE,GAAG,CAAC,cAAc,IAAI,EAAE;QACxC,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI;YAC9B,iBAAiB,EAAE,EAAE;YACrB,iBAAiB,EAAE,EAAE;YACrB,YAAY,EAAE,EAAE;SACjB;QACD,aAAa,EAAE,GAAG,CAAC,aAAa,IAAI,EAAE;QACtC,aAAa,EAAE,GAAG,CAAC,aAAa,IAAI,IAAI;KACzC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,UAA+B,EAAE;IAC/D,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,aAAa,CAAa;QAC9B,EAAE,EAAE,KAAK,IAAI,EAAE;YACb,MAAM,GAAG,GAAG,MAAM,OAAO,CAAoB,qBAAqB,EAAE,EAAE,CAAC,CAAC;YACxE,qEAAqE;YACrE,2EAA2E;YAC3E,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;QACD,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE;YACrB,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACtE,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/relate.d.ts

@@ -0,0 +1,15 @@
+/**
+ * pb relate / pb unrelate — manage typed relations between Chain entries.
+ * Resolves TEN-704. Requires active session (DEC-9, BR-8).
+ * BET-181 Slice 0: routes through runCliCommand for JSON-default output.
+ * Thin client: relation type validation lives in Convex (BR-104).
+ */
+interface RelateOptions {
+    fromId: string;
+    type: string;
+    toId: string;
+}
+export declare function runRelate(options: RelateOptions): Promise<void>;
+export declare function runUnrelate(options: RelateOptions): Promise<void>;
+export {};
+//# sourceMappingURL=relate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"relate.d.ts","sourceRoot":"","sources":["../../src/commands/relate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,UAAU,aAAa;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AASD,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAgCrE;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAgCvE"}

package/dist/commands/relate.js

@@ -0,0 +1,72 @@
+/**
+ * pb relate / pb unrelate — manage typed relations between Chain entries.
+ * Resolves TEN-704. Requires active session (DEC-9, BR-8).
+ * BET-181 Slice 0: routes through runCliCommand for JSON-default output.
+ * Thin client: relation type validation lives in Convex (BR-104).
+ */
+import { getConfigOrGuide } from '../lib/config.js';
+import { mcpCallWithSession } from '../lib/client.js';
+import { readSession } from '../lib/session.js';
+import { runCliCommand } from '../lib/runner.js';
+import { formatRelateReceipt, formatUnrelateReceipt } from '../formatters/relate.js';
+export async function runRelate(options) {
+    const config = await getConfigOrGuide(() => runRelate(options));
+    if (!config)
+        return;
+    // Require active session
+    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 fromId = options.fromId.trim();
+    const type = options.type.trim();
+    const toId = options.toId.trim();
+    if (!fromId || !type || !toId) {
+        process.stderr.write('All arguments required. Usage: pb relate <from-id> <type> <to-id>\n');
+        process.exit(1);
+    }
+    await runCliCommand({
+        fn: async () => {
+            await mcpCallWithSession('chain.createEntryRelation', {
+                fromEntryId: fromId,
+                toEntryId: toId,
+                type,
+            });
+            return { fromId, type, toId, action: 'related' };
+        },
+        formatPretty: (result) => formatRelateReceipt(result),
+    });
+}
+export async function runUnrelate(options) {
+    const config = await getConfigOrGuide(() => runUnrelate(options));
+    if (!config)
+        return;
+    // Require active session
+    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 fromId = options.fromId.trim();
+    const type = options.type.trim();
+    const toId = options.toId.trim();
+    if (!fromId || !type || !toId) {
+        process.stderr.write('All arguments required. Usage: pb unrelate <from-id> <type> <to-id>\n');
+        process.exit(1);
+    }
+    await runCliCommand({
+        fn: async () => {
+            await mcpCallWithSession('chain.removeEntryRelation', {
+                fromEntryId: fromId,
+                toEntryId: toId,
+                type,
+            });
+            return { fromId, type, toId, action: 'unrelated' };
+        },
+        formatPretty: (result) => formatUnrelateReceipt(result),
+    });
+}
+//# sourceMappingURL=relate.js.map

package/dist/commands/relate.js.map

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

package/dist/commands/search.d.ts

@@ -1,5 +1,6 @@
 /**
  * pb search — full-text search across all collections via chain.searchEntries.
+ * BET-181 Slice 0: routes through runCliCommand for JSON-default output.
  */
 export declare function runSearch(options: {
     query: string;

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

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,wBAAsB,SAAS,CAAC,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAQzE"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,wBAAsB,SAAS,CAAC,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAQzE"}

package/dist/commands/search.js

@@ -1,16 +1,18 @@
 /**
  * pb search — full-text search across all collections via chain.searchEntries.
+ * BET-181 Slice 0: routes through runCliCommand for JSON-default output.
  */
 import { getConfigOrGuide } from '../lib/config.js';
 import { mcpCall } from '../lib/client.js';
+import { runCliCommand } from '../lib/runner.js';
 import { formatSearchResults } from '../formatters/search.js';
 export async function runSearch(options) {
     const config = await getConfigOrGuide(() => runSearch(options));
     if (!config)
         return;
-    const results = await mcpCall('chain.searchEntries', {
-        query: options.query,
+    await runCliCommand({
+        fn: () => mcpCall('chain.searchEntries', { query: options.query }),
+        formatPretty: (results) => formatSearchResults(results ?? []),
     });
-    console.log(formatSearchResults(results ?? []));
 }
 //# sourceMappingURL=search.js.map

package/dist/commands/search.js.map

@@ -1 +1 @@
-{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAqB,MAAM,yBAAyB,CAAC;AAEjF,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAA0B;IACxD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAiB,qBAAqB,EAAE;QACnE,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;AAClD,CAAC"}
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/commands/search.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,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAqB,MAAM,yBAAyB,CAAC;AAEjF,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAA0B;IACxD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,aAAa,CAAiB;QAClC,EAAE,EAAE,GAAG,EAAE,CAAC,OAAO,CAAiB,qBAAqB,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QAClF,YAAY,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,mBAAmB,CAAC,OAAO,IAAI,EAAE,CAAC;KAC9D,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/session.d.ts

@@ -0,0 +1,20 @@
+/**
+ * pb session start / close — CLI write session lifecycle.
+ * Opens a tracked agent session (DEC-9, BR-8) with clientKind: 'cli' (DEC-184).
+ * Session ID persisted to .productbrain/session.json (TEN-264 option 1).
+ * BET-181 Slice 0: uses isJsonMode() for output branching. Existing --json flag
+ * on session start preserved for backward compatibility.
+ */
+export declare function runSessionStart(options?: {
+    /** @deprecated Use global --json flag instead. Preserved for backward compatibility. */
+    json?: boolean;
+}): Promise<void>;
+/**
+ * pb session id — print current session ID bare to stdout (machine-readable).
+ * Resolves TEN-707. Zero network call — reads local session.json only.
+ */
+export declare function runSessionId(): void;
+export declare function runSessionClose(options?: {
+    force?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/commands/session.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0BH,wBAAsB,eAAe,CAAC,OAAO,GAAE;IAC7C,wFAAwF;IACxF,IAAI,CAAC,EAAE,OAAO,CAAA;CACV,GAAG,OAAO,CAAC,IAAI,CAAC,CAsErB;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAOnC;AAED,wBAAsB,eAAe,CAAC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDtF"}

package/dist/commands/session.js

@@ -0,0 +1,134 @@
+/**
+ * pb session start / close — CLI write session lifecycle.
+ * Opens a tracked agent session (DEC-9, BR-8) with clientKind: 'cli' (DEC-184).
+ * Session ID persisted to .productbrain/session.json (TEN-264 option 1).
+ * BET-181 Slice 0: uses isJsonMode() for output branching. Existing --json flag
+ * on session start preserved for backward compatibility.
+ */
+import { getConfigOrGuide } from '../lib/config.js';
+import { mcpCall } from '../lib/client.js';
+import { readSession, writeSession, clearSession } from '../lib/session.js';
+import { isJsonMode } from '../lib/runner.js';
+import { formatSessionStart, formatSessionClose } from '../formatters/session.js';
+import { runHandshake } from './handshake.js';
+export async function runSessionStart(options = {}) {
+    const config = await getConfigOrGuide(() => runSessionStart(options));
+    if (!config)
+        return;
+    // Support both legacy --json flag and global output mode (DEC-299, backward compat)
+    const json = isJsonMode() || options.json === true;
+    // Check for existing session
+    const existing = readSession();
+    if (existing) {
+        if (json) {
+            process.stdout.write(JSON.stringify({
+                sessionId: existing.sessionId,
+                workspaceName: existing.workspaceName,
+                startedAt: existing.startedAt,
+                alreadyActive: true,
+            }) + '\n');
+            return;
+        }
+        process.stdout.write(`Session already active: ${existing.sessionId}\n`);
+        process.stdout.write(`Started: ${existing.startedAt}\n`);
+        process.stdout.write(`Entries captured: ${existing.entriesCaptured.length}\n`);
+        process.stdout.write('\n');
+        process.stdout.write('Run `pb session close` to end it, or `pb session close --force` to force-close.\n');
+        return;
+    }
+    // Resolve workspace + keyId
+    const workspace = await mcpCall('resolveWorkspace', {});
+    if (!workspace?.keyId) {
+        throw new Error('API key has read-only scope. Write operations require a readwrite key.\n' +
+            'Generate one: Product Brain app → Settings → API Keys.');
+    }
+    // Start agent session with clientKind attribution (DEC-184)
+    if (!json)
+        process.stdout.write('Starting session...\n');
+    const result = await mcpCall('agent.startSession', {
+        workspaceId: workspace._id,
+        apiKeyId: workspace.keyId,
+        clientKind: 'cli',
+    });
+    // Persist session state
+    const state = {
+        sessionId: result.sessionId,
+        workspaceId: workspace._id,
+        workspaceName: result.workspaceName,
+        startedAt: new Date().toISOString(),
+        entriesCaptured: [],
+    };
+    writeSession(state);
+    if (json) {
+        process.stdout.write(JSON.stringify({
+            sessionId: state.sessionId,
+            workspaceName: state.workspaceName,
+            startedAt: state.startedAt,
+        }) + '\n');
+        // Refresh silently in JSON mode
+        await runHandshake({ force: false, dryRun: false, quiet: true });
+        return;
+    }
+    process.stdout.write(formatSessionStart(state, result.superseded) + '\n');
+    // Refresh context files
+    process.stdout.write('Refreshing context...\n');
+    await runHandshake({ force: false, dryRun: false });
+}
+/**
+ * pb session id — print current session ID bare to stdout (machine-readable).
+ * Resolves TEN-707. Zero network call — reads local session.json only.
+ */
+export function runSessionId() {
+    const session = readSession();
+    if (!session) {
+        process.stderr.write('No active session. Run `pb session start` first.\n');
+        process.exit(1);
+    }
+    process.stdout.write(session.sessionId + '\n');
+}
+export async function runSessionClose(options = {}) {
+    const config = await getConfigOrGuide(() => runSessionClose(options));
+    if (!config)
+        return;
+    const session = readSession();
+    if (!session) {
+        process.stdout.write('No active session. Run `pb session start` to begin.\n');
+        return;
+    }
+    // Record wrapup metrics
+    const entriesCount = session.entriesCaptured.length;
+    if (entriesCount > 0) {
+        try {
+            await mcpCall('agent.recordWrapup', {
+                sessionId: session.sessionId,
+                draftsReviewed: entriesCount,
+                draftsCommitted: 0, // CLI captures are drafts; user commits in Studio
+                linksCreated: 0,
+            });
+        }
+        catch (err) {
+            // Wrapup recording is non-critical — don't block close
+            process.stdout.write(`Note: wrapup recording skipped (${err instanceof Error ? err.message : 'unknown error'})\n`);
+        }
+    }
+    // Close the session
+    try {
+        await mcpCall('agent.closeSession', {
+            sessionId: session.sessionId,
+            status: 'closed',
+        });
+    }
+    catch (err) {
+        if (!options.force) {
+            throw new Error(`Failed to close session: ${err instanceof Error ? err.message : String(err)}\n` +
+                'Use `pb session close --force` to clear local state anyway.');
+        }
+    }
+    process.stdout.write(formatSessionClose(session) + '\n');
+    // Clear local state
+    clearSession();
+    // Refresh context files so next session starts with updated knowledge
+    process.stdout.write('Refreshing context...\n');
+    await runHandshake({ force: false, dryRun: false });
+}
+//# sourceMappingURL=session.js.map

package/dist/commands/session.js.map

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

package/dist/commands/update.d.ts

@@ -0,0 +1,16 @@
+/**
+ * pb update <entry-id> — update fields on existing Chain entries.
+ * Resolves TEN-703. Requires active session (DEC-9, BR-8).
+ * BET-181 Slice 0: uses isJsonMode() for output branching.
+ * Thin client: validation lives in Convex (BR-104).
+ */
+interface UpdateOptions {
+    entryId: string;
+    field?: string[];
+    name?: string;
+    status?: string;
+    note?: string;
+}
+export declare function runUpdate(options: UpdateOptions): Promise<void>;
+export {};
+//# sourceMappingURL=update.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,UAAU,aAAa;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAiCD,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAgErE"}

package/dist/commands/update.js

@@ -0,0 +1,89 @@
+/**
+ * pb update <entry-id> — update fields on existing Chain entries.
+ * Resolves TEN-703. Requires active session (DEC-9, BR-8).
+ * BET-181 Slice 0: uses isJsonMode() for output branching.
+ * Thin client: validation lives in Convex (BR-104).
+ */
+import { getConfigOrGuide } from '../lib/config.js';
+import { mcpCallWithSession } from '../lib/client.js';
+import { readSession } from '../lib/session.js';
+import { isJsonMode } from '../lib/runner.js';
+import { stripConvexInternals } from '../lib/strip.js';
+import { formatUpdateReceipt } from '../formatters/update.js';
+/**
+ * Parse --field key=value pairs into a data object.
+ * Splits on first `=` only to handle values containing `=`.
+ */
+function parseFields(fields) {
+    const data = {};
+    for (const f of fields) {
+        const eqIndex = f.indexOf('=');
+        if (eqIndex === -1) {
+            throw new Error(`Invalid --field format: "${f}". Expected key=value.`);
+        }
+        const key = f.slice(0, eqIndex).trim();
+        const value = f.slice(eqIndex + 1).trim();
+        if (!key) {
+            throw new Error(`Invalid --field format: "${f}". Key cannot be empty.`);
+        }
+        data[key] = value;
+    }
+    return data;
+}
+export async function runUpdate(options) {
+    const config = await getConfigOrGuide(() => runUpdate(options));
+    if (!config)
+        return;
+    const json = isJsonMode();
+    // 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);
+    }
+    // Validate entryId
+    const entryId = options.entryId.trim();
+    if (!entryId) {
+        process.stderr.write('Entry ID is required. Usage: pb update <entry-id> [options]\n');
+        process.exit(1);
+    }
+    // Build update args
+    const args = { entryId };
+    if (options.name) {
+        args.name = options.name;
+    }
+    if (options.status) {
+        args.status = options.status;
+    }
+    if (options.field && options.field.length > 0) {
+        args.data = parseFields(options.field);
+    }
+    if (options.note) {
+        args.changeNote = options.note;
+    }
+    // Must have at least one thing to update
+    if (!options.name && !options.status && (!options.field || options.field.length === 0)) {
+        process.stderr.write('Nothing to update. Provide at least one of: --field, --name, --status\n');
+        process.exit(1);
+    }
+    if (!json)
+        process.stdout.write(`Updating ${entryId}...\n`);
+    const result = await mcpCallWithSession('chain.updateEntry', args);
+    if (json) {
+        process.stdout.write(JSON.stringify(stripConvexInternals(result)) + '\n');
+    }
+    else {
+        process.stdout.write('\n');
+        process.stdout.write(formatUpdateReceipt({
+            entryId,
+            changeNote: options.note,
+            fieldsChanged: options.field ?? [],
+            name: options.name,
+            status: options.status,
+            normalizationWarnings: result.normalizationWarnings ?? [],
+            validationWarnings: result.validationWarnings ?? [],
+        }) + '\n');
+    }
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/update.js.map

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

package/dist/formatters/capture.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Capture receipt formatter — rich feedback per FEAT-126.
+ * Shows entry ID, collection, confidence, warnings, and correction hint.
+ */
+export interface CaptureReceiptData {
+    entryId: string;
+    name: string;
+    collection: string;
+    status: string;
+    classification: {
+        collection: string;
+        confidence: number;
+        tier: string;
+        alternatives?: Array<{
+            collection: string;
+            confidence: number;
+        }>;
+        reasoning?: string;
+    } | null;
+    warnings?: string[];
+    normalization?: {
+        remapped: Record<string, unknown>;
+        rejected: Record<string, unknown>;
+        accepted: Record<string, unknown>;
+    };
+    linkedTo?: string;
+    relationType?: string;
+}
+export declare function formatCaptureReceipt(data: CaptureReceiptData): string;
+//# sourceMappingURL=capture.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/formatters/capture.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,CAAC,EAAE,KAAK,CAAC;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACjE,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,IAAI,CAAC;IACT,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,CAAC,EAAE;QACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CA2DrE"}

package/dist/formatters/capture.js

@@ -0,0 +1,58 @@
+/**
+ * Capture receipt formatter — rich feedback per FEAT-126.
+ * Shows entry ID, collection, confidence, warnings, and correction hint.
+ */
+export function formatCaptureReceipt(data) {
+    const lines = [];
+    // Entry ID and status
+    lines.push(`→ ${data.entryId} captured as ${data.status}`);
+    // Collection and classification
+    if (data.classification) {
+        const conf = data.classification.tier ?? 'unknown';
+        lines.push(`  Collection: ${data.collection} (confidence: ${conf})`);
+        if (data.classification.reasoning) {
+            lines.push(`  Reasoning: ${data.classification.reasoning.slice(0, 120)}${data.classification.reasoning.length > 120 ? '…' : ''}`);
+        }
+        if (data.classification.alternatives && data.classification.alternatives.length > 0) {
+            const alts = data.classification.alternatives
+                .slice(0, 3)
+                .map((a) => a.collection)
+                .join(', ');
+            lines.push(`  Alternatives: ${alts}`);
+        }
+    }
+    else {
+        lines.push(`  Collection: ${data.collection} (explicit)`);
+    }
+    // Name
+    lines.push(`  Name: ${data.name.slice(0, 100)}${data.name.length > 100 ? '…' : ''}`);
+    // Warnings
+    if (data.warnings && data.warnings.length > 0) {
+        lines.push('');
+        for (const w of data.warnings) {
+            lines.push(`  Warning: ${w}`);
+        }
+    }
+    // Normalization info
+    if (data.normalization) {
+        const remapped = Object.keys(data.normalization.remapped ?? {});
+        const rejected = Object.keys(data.normalization.rejected ?? {});
+        if (remapped.length > 0) {
+            lines.push(`  Remapped fields: ${remapped.join(', ')}`);
+        }
+        if (rejected.length > 0) {
+            lines.push(`  Rejected fields: ${rejected.join(', ')}`);
+        }
+    }
+    // Link info
+    if (data.linkedTo) {
+        lines.push('');
+        lines.push(`  Linked: → ${data.linkedTo} (${data.relationType ?? 'surfaces_tension_in'})`);
+    }
+    // Correction hint
+    lines.push('');
+    lines.push(`  View: pb get ${data.entryId}`);
+    lines.push(`  Wrong collection? Recapture with: pb capture --collection <slug> --name "..." --description "..."`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=capture.js.map

package/dist/formatters/capture.js.map

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

package/dist/formatters/constellation.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Constellation formatter — grouped relation view for pb constellation <entry-id>.
+ * BET-181 Slice 3: human-readable grouped view for TTY; JSON handled by runner.
+ *
+ * Chain: STD-65 (structured, parseable, minimal), DEC-299 (agent-native output)
+ *
+ * Relation types are derived from the server response — never hardcoded here.
+ * The formatter renders whatever relation types the query returns.
+ */
+export interface ConstellationRelatedEntry {
+    entryId: string | null;
+    name: string;
+    collectionSlug: string;
+    collectionName: string;
+    direction: 'outgoing' | 'incoming';
+}
+export interface ConstellationResult {
+    entry: {
+        entryId: string | null;
+        name: string;
+        collectionSlug: string;
+        collectionName: string;
+        status: string;
+    };
+    /** Keys are relation type strings (e.g. 'part_of', 'informed_by'). Derived from server. */
+    relations: Record<string, ConstellationRelatedEntry[]>;
+    summary: {
+        totalRelations: number;
+        relationTypes: string[];
+    };
+}
+/** Format constellation for terminal (readable grouped output). */
+export declare function formatConstellation(result: ConstellationResult): string;
+//# sourceMappingURL=constellation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constellation.d.ts","sourceRoot":"","sources":["../../src/formatters/constellation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,UAAU,GAAG,UAAU,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE;QACL,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,2FAA2F;IAC3F,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,EAAE,CAAC,CAAC;IACvD,OAAO,EAAE;QACP,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;CACH;AAED,mEAAmE;AACnE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CA+BvE"}