@productbrain/cli 0.1.0-beta.5 → 0.1.0-beta.5060

package/dist/commands/shape.js

@@ -0,0 +1,149 @@
+import { Command } from 'commander';
+import { getConfigOrGuide } from '../lib/config.js';
+import { kernelCall, kernelCallEnvelope, kernelCallWithSession } from '../lib/client.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
+import { runCliCommand } from '../lib/runner.js';
+import { readSession } from '../lib/session.js';
+import { formatShapeAdvisoriesList, formatShapeAdvisoryShow, formatShapeDispositionReceipt, } from '../formatters/shape.js';
+/**
+ * `pb shape` — the disposition ledger surface (WP-559, Slice 2 of WP-557, TEN-2532).
+ * Structurally mirrors packages/cli/src/commands/conflicts.ts: `list`/`show` are plain reads
+ * (kernelCall, no session), `agree`/`dismiss` are workspace writes that are session-attributed
+ * (kernelCallWithSession + a requireShapeSession-style gate) — same shape as conflicts'
+ * list/resolve split. Identity for the write itself is gateway-derived
+ * (workspaceId/personId/apiKeyId injection, `chain.dispositionShapeAdvisory`), never sessionId.
+ */
+function requireShapeSession() {
+    const session = readSession();
+    if (!session) {
+        throw new CLIError('No active session.', {
+            code: ErrorCode.SESSION_REQUIRED,
+            category: 'session',
+            guidance: 'Run `pb session start` before dispositioning a shape advisory.',
+        });
+    }
+    return session;
+}
+const LIST_DISPOSITIONS = ['pending', 'agreed', 'dismissed', 'expired'];
+const LIST_OUTCOMES = ['not_candidate', 'atomic', 'compound', 'unavailable'];
+export async function runShapeList(options) {
+    if (options.disposition && !LIST_DISPOSITIONS.includes(options.disposition)) {
+        throw new CLIError(`--disposition must be one of ${LIST_DISPOSITIONS.join(', ')} (got "${options.disposition}").`, {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+            guidance: 'Usage: pb shape list [--disposition <disposition>] [--outcome <outcome>]',
+        });
+    }
+    if (options.outcome && !LIST_OUTCOMES.includes(options.outcome)) {
+        throw new CLIError(`--outcome must be one of ${LIST_OUTCOMES.join(', ')} (got "${options.outcome}").`, {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+            guidance: 'Usage: pb shape list [--disposition <disposition>] [--outcome <outcome>]',
+        });
+    }
+    const config = await getConfigOrGuide(() => runShapeList(options));
+    if (!config)
+        return;
+    // Review round 4 (Codex P2, mirrors the MCP `shape` tool's own S4 fix): a bare `pb shape
+    // list` — the normal first call of the documented list/show/agree flow — requests every
+    // ledger outcome; the backend returns only the newest 50 subjects, so recent
+    // not_candidate/atomic/unavailable rows can push an older PENDING COMPOUND row (the only
+    // outcome the disposition mutation can actually act on) out of the page. Default a
+    // fully-unfiltered call to the actionable set; any explicitly requested --disposition/--outcome
+    // is honored as-is, with no override.
+    const noFiltersGiven = options.disposition === undefined && options.outcome === undefined;
+    const effectiveDisposition = options.disposition ?? (noFiltersGiven ? 'pending' : undefined);
+    const effectiveOutcome = options.outcome ?? (noFiltersGiven ? 'compound' : undefined);
+    // WP-571 sweep fix (P1 review finding on PR #520): `chain.shapeAdvisories` was ALREADY
+    // live (auto-deployed/published on every merge to main) returning a BARE ARRAY — both as
+    // the HTTP wire `data` AND as this command's own `--json` stdout shape (a separate,
+    // ALSO-already-published contract scripts/agents may pipe). Both stay a bare array.
+    // The LIST_SCAN_CAP truncation signal rides `_meta.truncated` on the wire
+    // (convex/lib/envelopeContract.ts) and is surfaced ONLY in pretty/TTY mode here via the
+    // closure variable below — kernelCallEnvelope (not kernelCall, which strips to `.data`
+    // only) is needed to read `_meta` back.
+    let truncated = false;
+    await runCliCommand({
+        fn: async () => {
+            const envelope = await kernelCallEnvelope('chain.shapeAdvisories', {
+                ...(effectiveDisposition ? { disposition: effectiveDisposition } : {}),
+                ...(effectiveOutcome ? { outcome: effectiveOutcome } : {}),
+                ...(options.limit ? { limit: Number(options.limit) } : {}),
+            });
+            truncated = Boolean(envelope._meta?.truncated);
+            return envelope.data;
+        },
+        formatPretty: (value) => formatShapeAdvisoriesList(value, undefined, truncated),
+    });
+}
+export async function runShapeShow(rowId) {
+    const config = await getConfigOrGuide(() => runShapeShow(rowId));
+    if (!config)
+        return;
+    await runCliCommand({
+        fn: async () => {
+            const value = await kernelCall('chain.showShapeAdvisory', { rowId });
+            // Review round 1 (Codex P2): a missing/cross-workspace row must fail the command (exit
+            // non-zero), not print "not found" and exit 0 — matches the MCP show action's structured
+            // failure, and lets scripts/agents distinguish "found" from "doesn't exist" reliably.
+            if (!value) {
+                throw new CLIError(`Advisory '${rowId}' not found (missing, or belongs to a different workspace).`, {
+                    code: ErrorCode.VALIDATION_FAILED,
+                    category: 'validation',
+                    guidance: 'Use `pb shape list` to find valid ids.',
+                });
+            }
+            return value;
+        },
+        formatPretty: (value) => formatShapeAdvisoryShow(value),
+    });
+}
+const DISPOSITION_ALIASES = {
+    agree: 'agreed',
+    dismiss: 'dismissed',
+};
+async function runShapeDisposition(verb, rowId, options) {
+    const config = await getConfigOrGuide(() => runShapeDisposition(verb, rowId, options));
+    if (!config)
+        return;
+    // Client-side session gate only (matches requireConflictsSession's discipline) — identity
+    // for the write itself is gateway-derived, never sessionId.
+    requireShapeSession();
+    const disposition = DISPOSITION_ALIASES[verb];
+    await runCliCommand({
+        fn: () => kernelCallWithSession('chain.dispositionShapeAdvisory', {
+            rowId,
+            disposition,
+            ...(options.reason ? { dispositionReason: options.reason } : {}),
+        }),
+        formatPretty: (value) => formatShapeDispositionReceipt(value),
+    });
+}
+export async function runShapeAgree(rowId, options) {
+    await runShapeDisposition('agree', rowId, options);
+}
+export async function runShapeDismiss(rowId, options) {
+    await runShapeDisposition('dismiss', rowId, options);
+}
+export function createShapeCommand() {
+    const command = new Command('shape').description('Review and disposition shape-advisory (single-concern) suggestions (WP-559, TEN-2532)');
+    command.command('list')
+        .description('List shape advisories for this workspace, latest per subject (no filters defaults to disposition:pending + outcome:compound)')
+        .option('--disposition <disposition>', `Filter by disposition (${LIST_DISPOSITIONS.join('|')}); omitting both filters defaults to pending`)
+        .option('--outcome <outcome>', `Filter by outcome (${LIST_OUTCOMES.join('|')}); omitting both filters defaults to compound`)
+        .option('--limit <limit>', 'Max rows to return (default 50, max 200)')
+        .action(runShapeList);
+    command.command('show <id>')
+        .description('Show one shape advisory by id')
+        .action(runShapeShow);
+    command.command('agree <id>')
+        .description('Agree with a compound advisory\'s split verdict')
+        .option('--reason <reason>', 'Optional reason (capped at 1000 chars)')
+        .action(runShapeAgree);
+    command.command('dismiss <id>')
+        .description('Dismiss a compound advisory\'s split verdict')
+        .option('--reason <reason>', 'Optional reason (capped at 1000 chars)')
+        .action(runShapeDismiss);
+    return command;
+}
+//# sourceMappingURL=shape.js.map

package/dist/commands/shape.js.map

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

package/dist/commands/shape.test.d.ts

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

package/dist/commands/shape.test.d.ts.map

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

package/dist/commands/shape.test.js

@@ -0,0 +1,148 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+const { getConfigOrGuide, kernelCall, kernelCallEnvelope, kernelCallWithSession, readSession, runCliCommand } = vi.hoisted(() => ({
+    getConfigOrGuide: vi.fn(),
+    kernelCall: vi.fn(),
+    // WP-571 sweep fix (P1, PR #520): runShapeList now reads chain.shapeAdvisories via
+    // kernelCallEnvelope (not kernelCall) so it can see `_meta.truncated` without changing
+    // the route's published bare-array `data` shape.
+    kernelCallEnvelope: vi.fn(),
+    kernelCallWithSession: vi.fn(),
+    readSession: vi.fn(),
+    runCliCommand: vi.fn(async ({ fn }) => fn()),
+}));
+vi.mock('../lib/config.js', () => ({ getConfigOrGuide }));
+vi.mock('../lib/client.js', () => ({ kernelCall, kernelCallEnvelope, kernelCallWithSession }));
+vi.mock('../lib/runner.js', () => ({ runCliCommand }));
+vi.mock('../lib/session.js', () => ({ readSession }));
+import { createShapeCommand, runShapeList, runShapeShow, runShapeAgree, runShapeDismiss } from './shape.js';
+describe('pb shape command surface (WP-559, TEN-2532)', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        getConfigOrGuide.mockResolvedValue({ apiKey: 'pb_sk_test', siteUrl: 'https://example.test' });
+        kernelCall.mockResolvedValue([]);
+        kernelCallEnvelope.mockResolvedValue({ data: [], _meta: { truncated: false } });
+        kernelCallWithSession.mockResolvedValue({ ok: true });
+        readSession.mockReturnValue(null);
+    });
+    it('exposes list, show, agree, and dismiss in help metadata', () => {
+        const command = createShapeCommand();
+        expect(command.commands.map((item) => item.name())).toEqual(['list', 'show', 'agree', 'dismiss']);
+    });
+    it('routes list/show/agree/dismiss through the guided config flow (Codex P2 pattern) — an unconfigured caller gets the guided setup, not a raw AUTH_MISSING', async () => {
+        readSession.mockReturnValue({ sessionId: 'session-1' });
+        getConfigOrGuide.mockResolvedValueOnce(null);
+        await runShapeList({});
+        expect(kernelCall).not.toHaveBeenCalled();
+        getConfigOrGuide.mockResolvedValueOnce(null);
+        await runShapeShow('row-1');
+        expect(kernelCall).not.toHaveBeenCalled();
+        getConfigOrGuide.mockResolvedValueOnce(null);
+        await runShapeAgree('row-1', {});
+        expect(kernelCallWithSession).not.toHaveBeenCalled();
+        getConfigOrGuide.mockResolvedValueOnce(null);
+        await runShapeDismiss('row-1', {});
+        expect(kernelCallWithSession).not.toHaveBeenCalled();
+    });
+    it('lists shape advisories via a plain read — no session required', async () => {
+        await runShapeList({});
+        expect(kernelCallEnvelope).toHaveBeenCalledWith('chain.shapeAdvisories', { disposition: 'pending', outcome: 'compound' });
+        expect(kernelCallWithSession).not.toHaveBeenCalled();
+    });
+    it('forwards --disposition/--outcome/--limit filters', async () => {
+        await runShapeList({ disposition: 'pending', outcome: 'compound', limit: '10' });
+        expect(kernelCallEnvelope).toHaveBeenCalledWith('chain.shapeAdvisories', {
+            disposition: 'pending', outcome: 'compound', limit: 10,
+        });
+    });
+    it('review round 4 (Codex P2 fix): a no-filter call defaults to the actionable set (disposition:pending, outcome:compound)', async () => {
+        await runShapeList({});
+        expect(kernelCallEnvelope).toHaveBeenCalledWith('chain.shapeAdvisories', { disposition: 'pending', outcome: 'compound' });
+    });
+    it('review round 4 (Codex P2 fix): an explicit --disposition-only filter is honored as-is, without the --outcome default applied', async () => {
+        await runShapeList({ disposition: 'agreed' });
+        expect(kernelCallEnvelope).toHaveBeenCalledWith('chain.shapeAdvisories', { disposition: 'agreed' });
+    });
+    it('review round 4 (Codex P2 fix): an explicit --outcome-only filter is honored as-is, without the --disposition default applied', async () => {
+        await runShapeList({ outcome: 'not_candidate' });
+        expect(kernelCallEnvelope).toHaveBeenCalledWith('chain.shapeAdvisories', { outcome: 'not_candidate' });
+    });
+    // WP-571 sweep, P1 revision (PR #520): chain.shapeAdvisories' `data` stays a bare array
+    // (already-published/deployed shape) — `truncated` now rides `_meta`, read via
+    // kernelCallEnvelope, and is still surfaced in pretty/TTY output via a closure variable.
+    it('surfaces a truncation note in pretty output when _meta.truncated is true', async () => {
+        kernelCallEnvelope.mockResolvedValue({
+            data: [{ id: 'row-1', outcome: 'compound', disposition: 'pending', subjectEntryId: 'INB-1', collectionSlug: 'inbox', source: 'cli', at: Date.now() }],
+            _meta: { truncated: true },
+        });
+        await runShapeList({});
+        expect(runCliCommand).toHaveBeenCalled();
+        const options = runCliCommand.mock.calls[0][0];
+        const rendered = options.formatPretty([{ id: 'row-1', outcome: 'compound', disposition: 'pending', subjectEntryId: 'INB-1', collectionSlug: 'inbox', source: 'cli', at: Date.now() }]);
+        expect(rendered).toMatch(/incomplete/i);
+    });
+    it('rejects an unsupported --disposition value client-side before calling the gateway', async () => {
+        await expect(runShapeList({ disposition: 'bogus' })).rejects.toThrow(/pending|agreed|dismissed|expired/);
+        expect(kernelCallEnvelope).not.toHaveBeenCalled();
+    });
+    it('rejects an unsupported --outcome value client-side before calling the gateway', async () => {
+        await expect(runShapeList({ outcome: 'bogus' })).rejects.toThrow(/not_candidate|atomic|compound|unavailable/);
+        expect(kernelCallEnvelope).not.toHaveBeenCalled();
+    });
+    it('shows a single advisory via a plain read — no session required', async () => {
+        await runShapeShow('row-1');
+        expect(kernelCall).toHaveBeenCalledWith('chain.showShapeAdvisory', { rowId: 'row-1' });
+        expect(kernelCallWithSession).not.toHaveBeenCalled();
+    });
+    it('review round 1 (Codex P2 fix): a missing/cross-workspace advisory FAILS the command (throws) rather than printing "not found" and exiting 0', async () => {
+        kernelCall.mockResolvedValueOnce(null);
+        await expect(runShapeShow('row-missing')).rejects.toThrow(/not found/i);
+    });
+    it('requires an active session before agreeing (workspace write, session-attributed)', async () => {
+        await expect(runShapeAgree('row-1', {})).rejects.toMatchObject({ code: 'SESSION_REQUIRED' });
+        expect(kernelCallWithSession).not.toHaveBeenCalled();
+    });
+    it('requires an active session before dismissing (workspace write, session-attributed)', async () => {
+        await expect(runShapeDismiss('row-1', {})).rejects.toMatchObject({ code: 'SESSION_REQUIRED' });
+        expect(kernelCallWithSession).not.toHaveBeenCalled();
+    });
+    it('agrees, forwarding disposition:agreed — never forwards sessionId as a wire arg (dispositionShapeAdvisory declares no such field; kernelCallWithSession touches the session internally via readSession())', async () => {
+        readSession.mockReturnValue({ sessionId: 'session-1' });
+        await runShapeAgree('row-1', {});
+        expect(kernelCallWithSession).toHaveBeenCalledWith('chain.dispositionShapeAdvisory', {
+            rowId: 'row-1', disposition: 'agreed',
+        });
+    });
+    it('dismisses, forwarding disposition:dismissed', async () => {
+        readSession.mockReturnValue({ sessionId: 'session-1' });
+        await runShapeDismiss('row-1', {});
+        expect(kernelCallWithSession).toHaveBeenCalledWith('chain.dispositionShapeAdvisory', {
+            rowId: 'row-1', disposition: 'dismissed',
+        });
+    });
+    it('forwards an optional --reason on agree/dismiss', async () => {
+        readSession.mockReturnValue({ sessionId: 'session-1' });
+        await runShapeAgree('row-1', { reason: 'looks right' });
+        expect(kernelCallWithSession).toHaveBeenCalledWith('chain.dispositionShapeAdvisory', {
+            rowId: 'row-1', disposition: 'agreed', dispositionReason: 'looks right',
+        });
+    });
+    it('parses the Commander agree surface and forwards the mapped disposition', async () => {
+        readSession.mockReturnValue({ sessionId: 'session-1' });
+        const command = createShapeCommand();
+        command.exitOverride();
+        await command.parseAsync(['agree', 'row-42', '--reason', 'yep'], { from: 'user' });
+        expect(kernelCallWithSession).toHaveBeenCalledWith('chain.dispositionShapeAdvisory', {
+            rowId: 'row-42', disposition: 'agreed', dispositionReason: 'yep',
+        });
+    });
+    it('parses the Commander dismiss surface and forwards the mapped disposition', async () => {
+        readSession.mockReturnValue({ sessionId: 'session-1' });
+        const command = createShapeCommand();
+        command.exitOverride();
+        await command.parseAsync(['dismiss', 'row-42'], { from: 'user' });
+        expect(kernelCallWithSession).toHaveBeenCalledWith('chain.dispositionShapeAdvisory', {
+            rowId: 'row-42', disposition: 'dismissed',
+        });
+    });
+});
+//# sourceMappingURL=shape.test.js.map

package/dist/commands/shape.test.js.map

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

package/dist/commands/status.d.ts

@@ -0,0 +1,7 @@
+/** No-argument CLI status surface, shared across JSON, plain, and Ink render tiers. */
+export interface StatusOptions {
+    args: string[];
+    version: string;
+}
+export declare function runStatus({ args, version }: StatusOptions): Promise<void>;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAUvF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAiDD,wBAAsB,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAgD/E"}

package/dist/commands/status.js

@@ -0,0 +1,102 @@
+/** No-argument CLI status surface, shared across JSON, plain, and Ink render tiers. */
+import { getConfigSafe } from '../lib/config.js';
+import { detectRenderTier, resolveSetupState } from '../lib/state.js';
+import { readSession } from '../lib/session.js';
+import { probeWorkspace } from '../lib/workspace-probe.js';
+import { setQuietMode } from '../lib/runner.js';
+import { bold, dim, green, heading, hint, icons } from '../lib/style.js';
+import { runSessionClose, runSessionStart } from './session.js';
+function renderPlain(state) {
+    process.stdout.write('\n');
+    if (state.stage === 'unconfigured') {
+        if (state.configurationIssue?.kind !== 'missing-key') {
+            process.stdout.write(`${bold('Product Brain')} ${dim('— configuration needs attention')}\n\n`);
+            process.stdout.write(`  ${state.configurationIssue?.reason ?? state.missingSteps[0]}\n\n`);
+            hint(state.nextAction);
+            hint('pb doctor           Diagnose configuration');
+            process.stdout.write('\n');
+            return;
+        }
+        process.stdout.write(`${bold('Product Brain')} ${dim('— not connected')}\n\n`);
+        process.stdout.write(`${heading('Get started')}\n\n`);
+        hint('1. pb login      Save your API key');
+        hint('2. pb connect    Connect a workspace');
+        hint('3. pb orient -b  See what\'s happening');
+        process.stdout.write('\n');
+        hint('pb --help        Show all commands');
+        process.stdout.write('\n');
+        return;
+    }
+    if (state.stage === 'authenticated') {
+        process.stdout.write(`${bold('Product Brain')} ${dim('— server unreachable')}\n\n`);
+        process.stdout.write(`  ${green(icons.pass)} Key: configured\n`);
+        process.stdout.write('  ! Server: unreachable — run pb doctor to diagnose\n\n');
+        hint('pb session start    Start a write session');
+        hint('pb doctor           Diagnose connection issues');
+        hint('pb --help           Show all commands');
+        process.stdout.write('\n');
+        return;
+    }
+    const workspaceName = state.workspaceName ?? 'unknown';
+    const entryCount = state.entryCount ?? 0;
+    process.stdout.write(`${bold('Product Brain')} ${dim('—')} ${bold(workspaceName)}\n\n`);
+    process.stdout.write(`  ${green(icons.pass)} Key: configured\n`);
+    process.stdout.write(`  ${green(icons.pass)} Workspace: ${workspaceName}  (${entryCount} entries)\n`);
+    process.stdout.write(state.sessionActive
+        ? `  ${green(icons.pass)} Session: active\n`
+        : `  ${dim('- Session: none')}\n`);
+    process.stdout.write('\n');
+    if (!state.sessionActive)
+        hint('pb session start    Start a write session');
+    hint('pb orient -b        Workspace overview');
+    hint('pb --help           Show all commands');
+    process.stdout.write('\n');
+}
+export async function runStatus({ args, version }) {
+    if (args.length > 0) {
+        if (args[0] === 'start')
+            return runSessionStart();
+        if (args[0] === 'close')
+            return runSessionClose({});
+        process.stderr.write(`error: unknown command '${args[0]}'\n`);
+        process.stderr.write("Run 'pb --help' to see available commands.\n");
+        process.exit(1);
+        return;
+    }
+    const tier = detectRenderTier();
+    if (tier === 'json') {
+        const config = getConfigSafe();
+        if (!config.ok) {
+            process.stdout.write(JSON.stringify({
+                configured: false,
+                hint: config.kind === 'missing-key'
+                    ? 'Run pb login to configure your API key.'
+                    : `${config.reason} ${config.guidance}`,
+            }) + '\n');
+            return;
+        }
+        const session = readSession();
+        const wsInfo = await probeWorkspace();
+        process.stdout.write(JSON.stringify({
+            configured: true,
+            workspace: wsInfo?.name ?? null,
+            session: session ? { id: session.sessionId, startedAt: session.startedAt } : null,
+            entryCount: wsInfo?.entryCount ?? null,
+            hint: 'Run pb --help for available commands.',
+        }) + '\n');
+        return;
+    }
+    if (tier === 'ink')
+        setQuietMode(true);
+    const state = await resolveSetupState();
+    if (tier === 'plain') {
+        renderPlain(state);
+        return;
+    }
+    const { render } = await import('ink');
+    const { WelcomeCockpit } = await import('./welcome.js');
+    const React = await import('react');
+    const { waitUntilExit, unmount } = render(React.default.createElement(WelcomeCockpit, { state, version, onExit: () => unmount() }));
+    await waitUntilExit();
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

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

package/dist/commands/status.test.d.ts

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

package/dist/commands/status.test.d.ts.map

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

package/dist/commands/status.test.js

@@ -0,0 +1,75 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+const mocks = vi.hoisted(() => ({
+    tier: 'json',
+    config: {
+        ok: false,
+        kind: 'profile-pin',
+        reason: 'This repo is pinned to profile "deleted-workspace".',
+        guidance: 'Run `pb profile use --local <profile>` to fix the repo pin.',
+        nextCommand: 'pb profile use --local <profile>',
+    },
+    render: vi.fn((_element) => ({ waitUntilExit: vi.fn(async () => { }), unmount: vi.fn() })),
+    quiet: vi.fn(),
+}));
+vi.mock('../lib/config.js', () => ({ getConfigSafe: () => mocks.config }));
+vi.mock('../lib/state.js', () => ({
+    detectRenderTier: () => mocks.tier,
+    resolveSetupState: vi.fn(async () => ({
+        stage: 'unconfigured',
+        missingSteps: [mocks.config.reason],
+        nextAction: mocks.config.nextCommand,
+        configurationIssue: {
+            kind: mocks.config.kind,
+            reason: mocks.config.reason,
+            guidance: mocks.config.guidance,
+        },
+    })),
+}));
+vi.mock('../lib/session.js', () => ({ readSession: vi.fn(), runSessionStart: vi.fn(), runSessionClose: vi.fn() }));
+vi.mock('../lib/workspace-probe.js', () => ({ probeWorkspace: vi.fn() }));
+vi.mock('../lib/runner.js', () => ({
+    setQuietMode: (value) => mocks.quiet(value),
+    isQuietMode: () => false,
+}));
+vi.mock('ink', () => ({ render: (element) => mocks.render(element) }));
+vi.mock('./welcome.js', () => ({ WelcomeCockpit: () => null }));
+import { runStatus } from './status.js';
+describe('runStatus S5 diagnostics', () => {
+    let stdout = '';
+    let stdoutSpy;
+    beforeEach(() => {
+        stdout = '';
+        mocks.render.mockClear();
+        mocks.quiet.mockClear();
+        stdoutSpy = vi.spyOn(process.stdout, 'write').mockImplementation((chunk) => {
+            stdout += String(chunk);
+            return true;
+        });
+    });
+    afterEach(() => stdoutSpy.mockRestore());
+    it('preserves configured and hint JSON fields while naming the broken pin', async () => {
+        mocks.tier = 'json';
+        await runStatus({ args: [], version: 'test' });
+        expect(JSON.parse(stdout.trim())).toEqual({
+            configured: false,
+            hint: expect.stringContaining('deleted-workspace'),
+        });
+        expect(stdout).toContain('pb profile use --local <profile>');
+        expect(stdout).not.toContain('pb login');
+    });
+    it('names the pin and repair command in plain output', async () => {
+        mocks.tier = 'plain';
+        await runStatus({ args: [], version: 'test' });
+        expect(stdout).toContain('deleted-workspace');
+        expect(stdout).toContain('pb profile use --local <profile>');
+        expect(stdout).not.toContain('pb login');
+    });
+    it('hands the exact configuration issue to the Ink cockpit', async () => {
+        mocks.tier = 'ink';
+        await runStatus({ args: [], version: 'test' });
+        expect(mocks.quiet).toHaveBeenCalledWith(true);
+        const element = mocks.render.mock.calls[0][0];
+        expect(element.props.state.configurationIssue.reason).toContain('deleted-workspace');
+    });
+});
+//# sourceMappingURL=status.test.js.map

package/dist/commands/status.test.js.map

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

package/dist/commands/update.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 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;
+    workflowStatus?: string;
+    /**
+     * S5 of WP-634 (TASK-45) — reclassify a DRAFT entry's canonicalKey. Relay-only (BR-104): the
+     * typeMap membership check, BR-55, the cardinality guards and the post-commit immutability
+     * guard all already live behind `chain.updateEntry`, and their text must reach the operator
+     * verbatim. Deliberately NO client-side "is it committed?" pre-check — a second copy of that
+     * rule here would drift from `convex/lib/guards.ts` and reword the refusal it is supposed to
+     * surface untouched.
+     */
+    type?: string;
+    note?: string;
+    /** Typed override that clears a steering coherency block (recorded with author). */
+    overrideReason?: string;
+    /** Acknowledgement response to a coherency challenge: linked | accepted-fix | diverged. */
+    acknowledge?: string;
+    /** Authorizing entry for --acknowledge linked / accepted-fix. */
+    ackEntry?: string;
+    /** Divergence rationale for --acknowledge diverged. */
+    ackReason?: string;
+    /** WP-640 S4 (`pb entry archive --reason`): DEC-1572 archive reason — a dedicated arg,
+     *  never routed through --field (archivedReason is platform-owned; see entryArchive.ts). */
+    archivedReason?: 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;AAgBH,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,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,oFAAoF;IACpF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2FAA2F;IAC3F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;gGAC4F;IAC5F,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AA0BD,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA4OrE"}