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

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 { convexCall } 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: () => convexCall('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: () => convexCall('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 convexCall('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"}

package/dist/formatters/audit.js

@@ -0,0 +1,81 @@
+/**
+ * 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 function formatAudit(result, options = {}) {
+    const { verbose = false, gateFilter } = options;
+    const lines = [];
+    const { entryId, entryName, phase, verdict, gates, summary, elapsed_ms } = result;
+    // Apply gate filter if specified
+    const displayGates = gateFilter && gateFilter.length > 0
+        ? gates.filter((g) => gateFilter.includes(g.gate))
+        : gates;
+    const verdictIcon = verdict === 'pass' ? '\u2713' : verdict === 'fail' ? '\u2717' : '\u26A0';
+    const verdictLabel = verdict.toUpperCase();
+    lines.push(`${verdictIcon} ${entryId} — ${entryName}`);
+    lines.push(`  Phase: ${phase} | Verdict: ${verdictLabel} | ${elapsed_ms}ms`);
+    lines.push(`  Gates: ${summary.passed}/${summary.total} passed, ${summary.failed} failed, ${summary.warned} warned`);
+    lines.push('');
+    // Group by status
+    const failed = displayGates.filter((g) => g.status === 'fail');
+    const warned = displayGates.filter((g) => g.status === 'warn');
+    const passed = displayGates.filter((g) => g.status === 'pass');
+    // Always expand FAIL gates
+    if (failed.length > 0) {
+        lines.push('FAIL:');
+        for (const gate of failed) {
+            lines.push(`  \u2717 ${gate.gate}: ${gate.detail}`);
+            if (gate.fix) {
+                const fixLabel = gate.fixType === 'exact' ? '[auto-fixable]' : gate.fixType === 'template' ? '[template]' : '';
+                lines.push(`    Fix${fixLabel ? ' ' + fixLabel : ''}: ${gate.fix}`);
+            }
+            if (gate.hint)
+                lines.push(`    Note: ${gate.hint}`);
+        }
+        lines.push('');
+    }
+    // Always expand WARN gates
+    if (warned.length > 0) {
+        lines.push('WARN:');
+        for (const gate of warned) {
+            lines.push(`  \u26A0 ${gate.gate}: ${gate.detail}`);
+            if (gate.fix) {
+                const fixLabel = gate.fixType === 'exact' ? '[auto-fixable]' : gate.fixType === 'template' ? '[template]' : '';
+                lines.push(`    Fix${fixLabel ? ' ' + fixLabel : ''}: ${gate.fix}`);
+            }
+            if (gate.hint)
+                lines.push(`    Note: ${gate.hint}`);
+        }
+        lines.push('');
+    }
+    // PASS gates: collapsed by default, expanded with --verbose
+    if (passed.length > 0) {
+        if (verbose) {
+            lines.push('PASS:');
+            for (const gate of passed) {
+                lines.push(`  \u2713 ${gate.gate}: ${gate.detail}`);
+            }
+        }
+        else {
+            lines.push(`PASS: ${passed.length} gate(s) — ${passed.map((g) => g.gate).join(', ')}`);
+        }
+    }
+    return lines.join('\n').trimEnd();
+}
+/**
+ * Format a batch audit summary line for multiple results.
+ */
+export function formatBatchSummary(results) {
+    const passed = results.filter((r) => r.verdict === 'pass').length;
+    const failed = results.filter((r) => r.verdict === 'fail').length;
+    const warned = results.filter((r) => r.verdict === 'warn').length;
+    return `\nBatch: ${results.length} bet(s) audited — ${passed} passed, ${failed} failed, ${warned} warned`;
+}
+//# sourceMappingURL=audit.js.map

package/dist/formatters/audit.js.map

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

package/dist/formatters/brief.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Brief formatter — human-readable output for `pb brief`.
+ * BET-239 Slice 4 (incremental) + Slice 5 (compound queries).
+ *
+ * Chain: STD-65 (structured, parseable, minimal), DEC-299 (agent-native output)
+ */
+export interface BriefResult {
+    newEntries: Array<{
+        entryId: string | null;
+        name: string;
+        collectionSlug: string;
+        updatedAt: number;
+    }>;
+    counts: Record<string, number>;
+    relations: Array<{
+        fromEntryId: string | null;
+        toEntryId: string | null;
+        type: string;
+        createdAt: number;
+    }>;
+    truncated: boolean;
+    previousRunTimestamp: number | null;
+    isFirstRun: boolean;
+}
+/** Compound brief result — covers steering, confidence, and delta types. */
+export type CompoundBriefResult = SteeringBriefResult | ConfidenceBriefResult | DeltaBriefResult;
+interface ChangeDetectionResult {
+    entries: Array<{
+        entryId: string | null;
+        name: string;
+        collectionSlug: string;
+        updatedAt: number;
+    }>;
+    relations: Array<{
+        fromEntryId: string | null;
+        toEntryId: string | null;
+        type: string;
+        createdAt: number;
+    }>;
+    counts: Record<string, number>;
+    truncated: boolean;
+}
+interface StructuralAggregationResult {
+    groups: Record<string, Array<{
+        fromEntryId: string | null;
+        fromName: string;
+        toEntryId: string | null;
+        toName: string;
+    }>>;
+    totalCount: number;
+    truncated: boolean;
+}
+interface IncrementalDelta {
+    newEntries: Array<{
+        entryId: string | null;
+        name: string;
+        collectionSlug: string;
+        updatedAt: number;
+    }>;
+    counts: Record<string, number>;
+    truncated: boolean;
+    isFirstRun: boolean;
+    previousRunTimestamp: number | null;
+}
+interface ReadinessResult {
+    score: number;
+    totalChecks: number;
+    passedChecks: number;
+    gaps: Array<{
+        label: string;
+        current: number;
+        required: number;
+        guidance?: string;
+    }>;
+}
+export interface SteeringBriefResult {
+    type: 'steering';
+    changes: ChangeDetectionResult;
+    structure: Record<string, StructuralAggregationResult>;
+    delta: IncrementalDelta;
+    readiness: ReadinessResult;
+    isFirstRun: boolean;
+    snapshotWarning: boolean;
+}
+export interface ConfidenceBriefResult {
+    type: 'confidence';
+    changes: ChangeDetectionResult;
+    activeBets: Array<{
+        entryId: string | null;
+        name: string;
+        status: string;
+    }>;
+    activeTensions: Array<{
+        entryId: string | null;
+        name: string;
+    }>;
+    betCount: number;
+    tensionCount: number;
+    snapshotWarning: boolean;
+}
+export interface DeltaBriefResult {
+    type: 'delta';
+    changes: ChangeDetectionResult;
+    since: number;
+    snapshotWarning: boolean;
+}
+/** Format incremental brief result for terminal output (E4). */
+export declare function formatBrief(result: BriefResult, skill: string): string;
+/** Format compound brief result for terminal output (E6). */
+export declare function formatCompoundBrief(result: CompoundBriefResult): string;
+export {};
+//# sourceMappingURL=brief.d.ts.map

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

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