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

package/dist/commands/update.js

@@ -0,0 +1,178 @@
+/**
+ * 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 { mcpCall, 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';
+import { formatEntry } from '../formatters/entry.js';
+import { CLIError, ErrorCode } from '../lib/errors.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 CLIError(`Invalid --field format: "${f}". Expected key=value.`, {
+                code: ErrorCode.VALIDATION_FAILED,
+                category: 'validation',
+                guidance: 'Use --field key=value (split on first "=").',
+            });
+        }
+        const key = f.slice(0, eqIndex).trim();
+        const value = f.slice(eqIndex + 1).trim();
+        if (!key) {
+            throw new CLIError(`Invalid --field format: "${f}". Key cannot be empty.`, {
+                code: ErrorCode.VALIDATION_FAILED,
+                category: 'validation',
+                guidance: 'Provide a non-empty key before the "=" sign.',
+            });
+        }
+        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) {
+        throw new CLIError('No active session.', {
+            code: ErrorCode.SESSION_REQUIRED,
+            category: 'session',
+            guidance: 'Run `pb session start` first. Write access requires a tracked session (DEC-9).',
+        });
+    }
+    // Validate entryId
+    const entryId = options.entryId.trim();
+    if (!entryId) {
+        throw new CLIError('Entry ID is required.', {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+            guidance: 'Usage: pb update <entry-id> [options]',
+        });
+    }
+    // Build update args
+    const args = { entryId };
+    args.changedBy = `agent:${session.sessionId}`;
+    if (options.name) {
+        args.name = options.name;
+    }
+    if (options.status) {
+        args.status = options.status;
+    }
+    if (options.workflowStatus) {
+        args.workflowStatus = options.workflowStatus;
+    }
+    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.workflowStatus && (!options.field || options.field.length === 0)) {
+        throw new CLIError('Nothing to update.', {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+            guidance: 'Provide at least one of: --field, --name, --status, --workflow-status',
+        });
+    }
+    if (!json)
+        process.stdout.write(`Updating ${entryId}...\n`);
+    let result;
+    try {
+        result = await mcpCallWithSession('chain.updateEntry', args);
+    }
+    catch (err) {
+        // McpError carries code + details from the server. Check by name to avoid
+        // class identity issues across module boundaries.
+        const mcpErr = err;
+        if (err instanceof Error && err.name === 'McpError') {
+            // Render structured validation errors for select/multi-select fields.
+            if (mcpErr.details && mcpErr.details.length > 0) {
+                const selectErrors = mcpErr.details.filter((d) => d.errorType === 'invalid_option' && d.validOptions);
+                if (selectErrors.length > 0) {
+                    const fieldMessages = selectErrors.map((d) => {
+                        const got = typeof d.invalidValue === 'string' ? d.invalidValue : JSON.stringify(d.invalidValue);
+                        return `Field '${d.fieldLabel}' must be one of: ${d.validOptions.join(', ')}. Got: '${got}'`;
+                    });
+                    throw new CLIError(`Validation failed: ${fieldMessages.join('; ')}`, {
+                        code: ErrorCode.VALIDATION_FAILED,
+                        category: 'validation',
+                    });
+                }
+            }
+            // Fallback: plain MCP error
+            throw new CLIError(mcpErr.message, {
+                code: ErrorCode.VALIDATION_FAILED,
+                category: 'validation',
+            });
+        }
+        throw err;
+    }
+    // Fetch the refreshed entry so the user sees current state, not just a receipt.
+    // Graceful degradation: if the get fails, still show the update receipt.
+    let refreshedEntry = null;
+    try {
+        refreshedEntry = await mcpCall('chain.getEntry', { entryId });
+    }
+    catch {
+        // Non-fatal — display issue, not a write failure
+    }
+    // BET-271 S1: Determine if any fields were rejected by normalization.
+    const rejectedFields = result.normalization?.rejected ?? [];
+    const hasRejected = rejectedFields.length > 0;
+    // Note: EntryFromApi has canonicalKey (e.g. "bet") but pb fields expects
+    // the collection slug (e.g. "bets"). Since the slug isn't available here,
+    // omit the collection hint — the user knows their entry type.
+    const collectionHint = '';
+    if (json) {
+        // Spread existing result fields flat (preserves backward compat with scripts
+        // that read .id / .warnings / etc.) and add `entry` alongside when available.
+        const output = { ...stripConvexInternals(result) };
+        if (refreshedEntry) {
+            output.entry = stripConvexInternals(refreshedEntry);
+        }
+        if (hasRejected) {
+            output.fieldsRejected = true;
+        }
+        process.stdout.write(JSON.stringify(output) + '\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');
+        if (refreshedEntry) {
+            process.stdout.write('\n');
+            process.stdout.write(formatEntry(refreshedEntry) + '\n');
+        }
+    }
+    // BET-271 S1: Throw when fields were rejected — signals "not everything you asked for happened."
+    if (hasRejected) {
+        throw new CLIError(`Fields rejected: ${rejectedFields.join(', ')}.`, {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+            guidance: `Run \`pb fields${collectionHint}\` to see valid fields.`,
+        });
+    }
+}
+//# 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/commands/verify.d.ts

@@ -0,0 +1,13 @@
+/**
+ * pb verify <entry-id> — mark a chain entry as verified.
+ * Calls chain.verifyEntry. Requires active session (DEC-9).
+ * Thin client: verification logic lives in Convex.
+ *
+ * Chain: BET-240 (Source Fidelity), FEAT-785 (E1: Verification Status Schema)
+ */
+interface VerifyOptions {
+    entryId: string;
+}
+export declare function runVerify(options: VerifyOptions): Promise<void>;
+export {};
+//# sourceMappingURL=verify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/commands/verify.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,UAAU,aAAa;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCrE"}

package/dist/commands/verify.js

@@ -0,0 +1,49 @@
+/**
+ * pb verify <entry-id> — mark a chain entry as verified.
+ * Calls chain.verifyEntry. Requires active session (DEC-9).
+ * Thin client: verification logic lives in Convex.
+ *
+ * Chain: BET-240 (Source Fidelity), FEAT-785 (E1: Verification Status Schema)
+ */
+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 { formatVerifyReceipt } from '../formatters/verify.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
+export async function runVerify(options) {
+    const config = await getConfigOrGuide(() => runVerify(options));
+    if (!config)
+        return;
+    // Require active session (DEC-9, BR-8)
+    const session = readSession();
+    if (!session) {
+        throw new CLIError('No active session.', {
+            code: ErrorCode.SESSION_REQUIRED,
+            category: 'session',
+            guidance: 'Run `pb session start` first. Write access requires a tracked session (DEC-9).',
+        });
+    }
+    const entryId = options.entryId.trim();
+    if (!entryId) {
+        throw new CLIError('Entry ID is required.', {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+            guidance: 'Usage: pb verify <entry-id>',
+        });
+    }
+    await runCliCommand({
+        fn: async () => {
+            const result = await mcpCallWithSession('chain.verifyEntry', {
+                entryId,
+            });
+            return {
+                entryId: result.entryId ?? entryId,
+                verificationStatus: result.verificationStatus,
+                alreadyVerified: result.alreadyVerified,
+            };
+        },
+        formatPretty: (data) => formatVerifyReceipt(data),
+    });
+}
+//# sourceMappingURL=verify.js.map

package/dist/commands/verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../src/commands/verify.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAA0B,MAAM,yBAAyB,CAAC;AACtF,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAMvD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAsB;IACpD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,uCAAuC;IACvC,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,QAAQ,CAAC,oBAAoB,EAAE;YACvC,IAAI,EAAE,SAAS,CAAC,gBAAgB;YAChC,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,gFAAgF;SAC3F,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACvC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,QAAQ,CAAC,uBAAuB,EAAE;YAC1C,IAAI,EAAE,SAAS,CAAC,iBAAiB;YACjC,QAAQ,EAAE,YAAY;YACtB,QAAQ,EAAE,6BAA6B;SACxC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,aAAa,CAAoB;QACrC,EAAE,EAAE,KAAK,IAAI,EAAE;YACb,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAoB,mBAAmB,EAAE;gBAC9E,OAAO;aACR,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,OAAO;gBAClC,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;gBAC7C,eAAe,EAAE,MAAM,CAAC,eAAe;aACxC,CAAC;QACJ,CAAC;QACD,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC;KAClD,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/workspace.d.ts

@@ -0,0 +1,41 @@
+/**
+ * pb workspace — operator commands for workspace health and repair.
+ * pb definitions diff — compare local collection definitions against server.
+ *
+ * WP-305 Slice 4: CLI operator surface for workspace parity checks.
+ * Chain: WP-305, STD-101 (derive from system, never hardcode).
+ *
+ * Subcommands:
+ *   pb workspace verify        — health check for the active workspace
+ *   pb workspace repair        — backfill missing seeds for the active workspace
+ *   pb definitions diff [file] — compare local dev-system-collections.json vs server
+ */
+export interface WorkspaceHealthResult {
+    workspaceId: string;
+    workspaceName: string;
+    collectionsAligned: boolean;
+    glossarySeeded: boolean;
+    semanticTypesSeeded: boolean;
+    defaultCircleSeeded: boolean;
+    gaps: string[];
+    status: 'healthy' | 'incomplete' | 'missing-seeds';
+}
+export interface BackfillResult {
+    workspaceId: string;
+    workspaceName: string;
+    scheduled: string[];
+    skipped: string[];
+    alreadyHealthy: boolean;
+}
+export interface DefinitionsDiffResult {
+    onlyLocal: string[];
+    onlyServer: string[];
+    different: string[];
+    identical: string[];
+}
+export declare function runWorkspaceVerify(): Promise<void>;
+export declare function runWorkspaceRepair(): Promise<void>;
+export declare function runDefinitionsDiff(options: {
+    file?: string;
+}): Promise<void>;
+//# sourceMappingURL=workspace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/commands/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAsBH,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,SAAS,GAAG,YAAY,GAAG,eAAe,CAAC;CACpD;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAiDD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAQxD;AAyCD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAQxD;AA+ED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+ElF"}

package/dist/commands/workspace.js

@@ -0,0 +1,239 @@
+/**
+ * pb workspace — operator commands for workspace health and repair.
+ * pb definitions diff — compare local collection definitions against server.
+ *
+ * WP-305 Slice 4: CLI operator surface for workspace parity checks.
+ * Chain: WP-305, STD-101 (derive from system, never hardcode).
+ *
+ * Subcommands:
+ *   pb workspace verify        — health check for the active workspace
+ *   pb workspace repair        — backfill missing seeds for the active workspace
+ *   pb definitions diff [file] — compare local dev-system-collections.json vs server
+ */
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { getConfigOrGuide } from '../lib/config.js';
+import { mcpCall } from '../lib/client.js';
+import { runCliCommand } from '../lib/runner.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
+import { bold, dim, green, red, yellow, cyan, heading, icons, formatCheck, } from '../lib/style.js';
+// ── pb workspace verify ────────────────────────────────────────────────────────
+function formatWorkspaceVerify(result) {
+    const lines = [];
+    lines.push('');
+    lines.push(`${bold('Workspace Health')} ${dim('—')} ${bold(result.workspaceName)}`);
+    lines.push('');
+    // Status badge
+    const statusIcon = result.status === 'healthy'
+        ? green(icons.pass)
+        : result.status === 'incomplete'
+            ? yellow(icons.warn)
+            : red(icons.fail);
+    const statusLabel = result.status === 'healthy'
+        ? green('healthy')
+        : result.status === 'incomplete'
+            ? yellow('incomplete')
+            : red('missing-seeds');
+    lines.push(`${statusIcon} Status: ${statusLabel}`);
+    lines.push('');
+    // Individual checks
+    lines.push(heading('Checks'));
+    lines.push('');
+    lines.push(formatCheck(result.collectionsAligned ? 'pass' : 'fail', 'Collections aligned', ''));
+    lines.push(formatCheck(result.glossarySeeded ? 'pass' : 'fail', 'Glossary seeded', ''));
+    lines.push(formatCheck(result.semanticTypesSeeded ? 'pass' : 'fail', 'Semantic types', ''));
+    lines.push(formatCheck(result.defaultCircleSeeded ? 'pass' : 'fail', 'Default circle', ''));
+    if (result.gaps.length > 0) {
+        lines.push('');
+        lines.push(heading('Gaps'));
+        lines.push('');
+        for (const gap of result.gaps) {
+            lines.push(`  ${red(icons.arrow)} ${gap}`);
+        }
+        lines.push('');
+        lines.push(dim('  Run: pb workspace repair'));
+    }
+    return lines.join('\n');
+}
+export async function runWorkspaceVerify() {
+    const config = await getConfigOrGuide(() => runWorkspaceVerify());
+    if (!config)
+        return;
+    await runCliCommand({
+        fn: () => mcpCall('workspace.health', {}),
+        formatPretty: (result) => formatWorkspaceVerify(result),
+    });
+}
+// ── pb workspace repair ────────────────────────────────────────────────────────
+function formatWorkspaceRepair(result) {
+    const lines = [];
+    lines.push('');
+    lines.push(`${bold('Workspace Repair')} ${dim('—')} ${bold(result.workspaceName)}`);
+    lines.push('');
+    if (result.alreadyHealthy) {
+        lines.push(`${green(icons.pass)} Workspace is already healthy — nothing to repair.`);
+        return lines.join('\n');
+    }
+    if (result.scheduled.length > 0) {
+        lines.push(heading('Scheduled'));
+        lines.push('');
+        for (const job of result.scheduled) {
+            lines.push(`  ${green(icons.pass)} ${job}`);
+        }
+        lines.push('');
+    }
+    if (result.skipped.length > 0) {
+        lines.push(heading('Skipped (already present)'));
+        lines.push('');
+        for (const job of result.skipped) {
+            lines.push(`  ${dim(`${icons.dot} ${job}`)}`);
+        }
+        lines.push('');
+    }
+    if (result.scheduled.length > 0) {
+        lines.push(dim('Seeds run asynchronously — re-run `pb workspace verify` in a moment to confirm.'));
+    }
+    return lines.join('\n');
+}
+export async function runWorkspaceRepair() {
+    const config = await getConfigOrGuide(() => runWorkspaceRepair());
+    if (!config)
+        return;
+    await runCliCommand({
+        fn: () => mcpCall('workspace.backfill', {}),
+        formatPretty: (result) => formatWorkspaceRepair(result),
+    });
+}
+// ── pb definitions diff ────────────────────────────────────────────────────────
+function stripConvexMeta(obj) {
+    const { _id, _creationTime, ...rest } = obj;
+    void _id;
+    void _creationTime;
+    return rest;
+}
+/** Deep equality via JSON serialization — sufficient for flat definition objects. */
+function deepEqual(a, b) {
+    return JSON.stringify(a) === JSON.stringify(b);
+}
+function formatDefinitionsDiff(result) {
+    const lines = [];
+    const total = result.onlyLocal.length +
+        result.onlyServer.length +
+        result.different.length +
+        result.identical.length;
+    lines.push('');
+    lines.push(bold('Definitions Diff'));
+    lines.push('');
+    if (total === 0) {
+        lines.push(dim('No definitions found on either side.'));
+        return lines.join('\n');
+    }
+    if (result.identical.length > 0) {
+        lines.push(`${green(icons.pass)} ${bold(`Identical (${result.identical.length})`)}`);
+        for (const slug of result.identical) {
+            lines.push(`    ${dim(slug)}`);
+        }
+        lines.push('');
+    }
+    if (result.different.length > 0) {
+        lines.push(`${yellow(icons.warn)} ${bold(`Different (${result.different.length})`)}`);
+        for (const slug of result.different) {
+            lines.push(`    ${yellow(slug)}`);
+        }
+        lines.push('');
+    }
+    if (result.onlyLocal.length > 0) {
+        lines.push(`${red(icons.fail)} ${bold(`Only local (${result.onlyLocal.length})`)}`);
+        for (const slug of result.onlyLocal) {
+            lines.push(`    ${red(slug)}`);
+        }
+        lines.push('');
+    }
+    if (result.onlyServer.length > 0) {
+        lines.push(`${cyan(icons.arrow)} ${bold(`Only server (${result.onlyServer.length})`)}`);
+        for (const slug of result.onlyServer) {
+            lines.push(`    ${cyan(slug)}`);
+        }
+        lines.push('');
+    }
+    const hasIssues = result.onlyLocal.length > 0 ||
+        result.onlyServer.length > 0 ||
+        result.different.length > 0;
+    if (!hasIssues) {
+        lines.push(green('All definitions match.'));
+    }
+    else {
+        lines.push(dim(`${result.identical.length}/${total} definitions identical`));
+    }
+    return lines.join('\n');
+}
+export async function runDefinitionsDiff(options) {
+    const config = await getConfigOrGuide(() => runDefinitionsDiff(options));
+    if (!config)
+        return;
+    await runCliCommand({
+        fn: async () => {
+            // 1. Read local JSON file
+            const localPath = options.file ?? join(process.cwd(), 'dev-system-collections.json');
+            let localDefs;
+            try {
+                const raw = readFileSync(localPath, 'utf8');
+                localDefs = JSON.parse(raw);
+                if (!Array.isArray(localDefs)) {
+                    throw new CLIError(`Expected an array in ${localPath} but got ${typeof localDefs}`, { code: ErrorCode.VALIDATION_FAILED, category: 'validation' });
+                }
+            }
+            catch (err) {
+                if (err instanceof CLIError)
+                    throw err;
+                throw new CLIError(`Could not read local definitions file: ${localPath}\n${err instanceof Error ? err.message : String(err)}`, { code: ErrorCode.VALIDATION_FAILED, category: 'validation' });
+            }
+            // 2. Fetch server definitions
+            const serverDefs = await mcpCall('chain.exportDefinitions', {});
+            // 3. Build slug maps
+            const localBySlug = new Map();
+            for (const def of localDefs) {
+                const slug = typeof def.slug === 'string' ? def.slug : null;
+                if (slug)
+                    localBySlug.set(slug, stripConvexMeta(def));
+            }
+            const serverBySlug = new Map();
+            for (const def of serverDefs ?? []) {
+                const slug = typeof def.slug === 'string' ? def.slug : null;
+                if (slug)
+                    serverBySlug.set(slug, stripConvexMeta(def));
+            }
+            const onlyLocal = [];
+            const onlyServer = [];
+            const different = [];
+            const identical = [];
+            for (const [slug, localDef] of localBySlug) {
+                if (!serverBySlug.has(slug)) {
+                    onlyLocal.push(slug);
+                }
+                else {
+                    const serverDef = serverBySlug.get(slug);
+                    if (deepEqual(localDef, serverDef)) {
+                        identical.push(slug);
+                    }
+                    else {
+                        different.push(slug);
+                    }
+                }
+            }
+            for (const slug of serverBySlug.keys()) {
+                if (!localBySlug.has(slug)) {
+                    onlyServer.push(slug);
+                }
+            }
+            // Deterministic output
+            onlyLocal.sort();
+            onlyServer.sort();
+            different.sort();
+            identical.sort();
+            return { onlyLocal, onlyServer, different, identical };
+        },
+        formatPretty: (result) => formatDefinitionsDiff(result),
+    });
+}
+//# sourceMappingURL=workspace.js.map

package/dist/commands/workspace.js.map

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

package/dist/formatters/audit.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Audit formatter — human-readable TTY output for pb audit.
+ * BET-182 Slice 2: CLI Command + Auto-Fix.
+ *
+ * TTY behavior:
+ * - PASS gates are collapsed by default (shown as count summary)
+ * - FAIL/WARN gates are expanded with detail + fix suggestions
+ * - --verbose shows all gates including PASS detail
+ *
+ * Chain: BET-182, STD-65 (structured, parseable, minimal), STD-113
+ */
+export interface GateResult {
+    gate: string;
+    status: 'pass' | 'fail' | 'warn';
+    blocking: boolean;
+    detail: string;
+    fix?: string;
+    fixType?: 'exact' | 'template' | 'manual';
+    hint?: string;
+}
+export interface AuditResult {
+    entryId: string;
+    entryName: string;
+    phase: string;
+    clean: boolean;
+    verdict: 'pass' | 'fail' | 'warn';
+    gates: GateResult[];
+    summary: {
+        total: number;
+        passed: number;
+        failed: number;
+        warned: number;
+    };
+    elapsed_ms: number;
+}
+export interface FormatAuditOptions {
+    verbose?: boolean;
+    /** When set, only show these gate names. */
+    gateFilter?: string[];
+}
+export declare function formatAudit(result: AuditResult, options?: FormatAuditOptions): string;
+/**
+ * Format a batch audit summary line for multiple results.
+ */
+export declare function formatBatchSummary(results: AuditResult[]): string;
+//# sourceMappingURL=audit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/formatters/audit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAClC,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,GAAE,kBAAuB,GAAG,MAAM,CAiEzF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAMjE"}