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

package/dist/formatters/changes.js

@@ -0,0 +1,60 @@
+/**
+ * Changes formatter — human-readable output for `pb changes --since <duration>`.
+ * BET-239 Slice 0: change detection pipeline.
+ *
+ * Chain: STD-65 (structured, parseable, minimal), DEC-299 (agent-native output)
+ */
+/** Format a timestamp as a human-readable relative time. */
+function formatTimeAgo(ms) {
+    const diff = Date.now() - ms;
+    if (diff < 60_000)
+        return 'just now';
+    if (diff < 3_600_000)
+        return `${Math.floor(diff / 60_000)}m ago`;
+    if (diff < 86_400_000)
+        return `${Math.floor(diff / 3_600_000)}h ago`;
+    return `${Math.floor(diff / 86_400_000)}d ago`;
+}
+/** Format changes result for terminal output. */
+export function formatChanges(result, sinceLabel) {
+    const lines = [];
+    const totalEntries = result.entries.length;
+    const totalRelations = result.relations.length;
+    if (totalEntries === 0 && totalRelations === 0) {
+        lines.push(`No changes since ${sinceLabel}.`);
+        return lines.join('\n');
+    }
+    lines.push(`Changes since ${sinceLabel}`);
+    lines.push(`${totalEntries} entries modified, ${totalRelations} relations created${result.truncated ? ' (TRUNCATED)' : ''}`);
+    lines.push('');
+    // Entries grouped by collection
+    if (totalEntries > 0) {
+        const sortedCounts = Object.entries(result.counts).sort((a, b) => b[1] - a[1]);
+        for (const [slug, count] of sortedCounts) {
+            lines.push(`${slug} (${count})`);
+            const slugEntries = result.entries.filter((e) => e.collectionSlug === slug);
+            for (const e of slugEntries) {
+                const id = e.entryId ? `${e.entryId}: ` : '';
+                const ago = formatTimeAgo(e.updatedAt);
+                lines.push(`  ${id}${e.name} (${ago})`);
+            }
+            lines.push('');
+        }
+    }
+    // Relations
+    if (totalRelations > 0) {
+        lines.push('New Relations');
+        for (const r of result.relations) {
+            const from = r.fromEntryId ?? '?';
+            const to = r.toEntryId ?? '?';
+            const ago = formatTimeAgo(r.createdAt);
+            lines.push(`  ${from} ${r.type} ${to} (${ago})`);
+        }
+        lines.push('');
+    }
+    if (result.truncated) {
+        lines.push('Results truncated at 200 entries. Use a shorter duration.');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=changes.js.map

package/dist/formatters/changes.js.map

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

package/dist/formatters/coaching.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Quality-coaching section formatter — shared by capture + update receipts.
+ * WP-475 E1 (FEAT-1346): the write response now carries the heuristic rubric
+ * verdict; render it natively for the terminal (BR-144: informs, never blocks).
+ *
+ * Types are local structural mirrors of kernel/quality/types.ts — the CLI
+ * package cannot import kernel/ (same precedent as QualityHint /
+ * RelationSuggestion in formatters/capture.ts). Drift is pinned by
+ * src/__tests__/coaching-mirror-drift.test.ts (content-hash of the kernel
+ * source declarations, same idea as the canonicalRefs drift check).
+ *
+ * No rogerMartin field on purpose: the write response carries HEURISTIC
+ * verdicts only ({ verdict, source } — see HeuristicCoachingResult in
+ * convex/intelligence/qualityCoaching.ts); the Roger Martin probe exists only
+ * on LLM-evaluated results, which never reach this formatter.
+ */
+export interface CoachingCriterion {
+    id: string;
+    passed: boolean;
+    weight: number;
+    hint: string;
+    questionTemplate: string;
+    /** WP-680 (TEN-3205): concrete absent element on an LLM fail; empty/absent otherwise. */
+    missing?: string;
+    /** WP-680 (TEN-3205): true when an unsupported LLM fail was discarded and this pass survived. */
+    llmInvalid?: boolean;
+}
+export interface CoachingVerdict {
+    entryId: string;
+    canonicalKey: string;
+    tier: 'assertive' | 'nudge' | 'passive';
+    context: string;
+    passed: boolean;
+    criteria: CoachingCriterion[];
+    weakest: {
+        criterion: string;
+        hint: string;
+        questionTemplate: string;
+    } | null;
+    overridden: boolean;
+    /** WP-475 E3: rubric methodology that produced the verdict (v1-vs-v2 seam). */
+    methodologyVersion?: string;
+}
+/** Shape of the `coaching` field on chain.createEntry / chain.updateEntry responses. */
+export interface CoachingResult {
+    verdict: CoachingVerdict;
+    source: string;
+}
+/**
+ * Render the coaching verdict as receipt lines (two-space indented, no trailing
+ * newline). Mirrors the CONTENT of mcp-server's formatRubricCoaching: passive
+ * tiers and empty rubrics render nothing (zero-noise floor).
+ */
+export declare function formatCoachingSection(coaching: CoachingResult | null | undefined): string[];
+//# sourceMappingURL=coaching.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coaching.d.ts","sourceRoot":"","sources":["../../src/formatters/coaching.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,yFAAyF;IACzF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iGAAiG;IACjG,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,gBAAgB,EAAE,MAAM,CAAC;KAC1B,GAAG,IAAI,CAAC;IACT,UAAU,EAAE,OAAO,CAAC;IACpB,+EAA+E;IAC/E,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,wFAAwF;AACxF,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,eAAe,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE,CAwB3F"}

package/dist/formatters/coaching.js

@@ -0,0 +1,46 @@
+/**
+ * Quality-coaching section formatter — shared by capture + update receipts.
+ * WP-475 E1 (FEAT-1346): the write response now carries the heuristic rubric
+ * verdict; render it natively for the terminal (BR-144: informs, never blocks).
+ *
+ * Types are local structural mirrors of kernel/quality/types.ts — the CLI
+ * package cannot import kernel/ (same precedent as QualityHint /
+ * RelationSuggestion in formatters/capture.ts). Drift is pinned by
+ * src/__tests__/coaching-mirror-drift.test.ts (content-hash of the kernel
+ * source declarations, same idea as the canonicalRefs drift check).
+ *
+ * No rogerMartin field on purpose: the write response carries HEURISTIC
+ * verdicts only ({ verdict, source } — see HeuristicCoachingResult in
+ * convex/intelligence/qualityCoaching.ts); the Roger Martin probe exists only
+ * on LLM-evaluated results, which never reach this formatter.
+ */
+/**
+ * Render the coaching verdict as receipt lines (two-space indented, no trailing
+ * newline). Mirrors the CONTENT of mcp-server's formatRubricCoaching: passive
+ * tiers and empty rubrics render nothing (zero-noise floor).
+ */
+export function formatCoachingSection(coaching) {
+    const verdict = coaching?.verdict;
+    if (!verdict || verdict.tier === 'passive' || verdict.criteria.length === 0)
+        return [];
+    const lines = [''];
+    const total = verdict.criteria.length;
+    const passedCount = verdict.criteria.filter((c) => c.passed).length;
+    if (verdict.passed) {
+        lines.push(`  Semantic quality: all ${total} rubric criteria pass for ${verdict.canonicalKey} (${verdict.tier} tier).`);
+    }
+    else {
+        lines.push(`  Semantic quality: ${passedCount}/${total} criteria pass for ${verdict.canonicalKey} (${verdict.tier} tier)`);
+        for (const c of verdict.criteria) {
+            const icon = c.passed ? '[x]' : '[ ]';
+            const extra = c.passed ? '' : ` — ${c.hint}`;
+            lines.push(`    ${icon} ${c.id}${extra}`);
+        }
+        if (verdict.weakest) {
+            lines.push(`    Coaching hint: ${verdict.weakest.hint}`);
+            lines.push(`    Consider: ${verdict.weakest.questionTemplate}`);
+        }
+    }
+    return lines;
+}
+//# sourceMappingURL=coaching.js.map

package/dist/formatters/coaching.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coaching.js","sourceRoot":"","sources":["../../src/formatters/coaching.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAqCH;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAA2C;IAC/E,MAAM,OAAO,GAAG,QAAQ,EAAE,OAAO,CAAC;IAClC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEvF,MAAM,KAAK,GAAa,CAAC,EAAE,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IACtC,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;IAEpE,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,2BAA2B,KAAK,6BAA6B,OAAO,CAAC,YAAY,KAAK,OAAO,CAAC,IAAI,SAAS,CAAC,CAAC;IAC1H,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,uBAAuB,WAAW,IAAI,KAAK,sBAAsB,OAAO,CAAC,YAAY,KAAK,OAAO,CAAC,IAAI,QAAQ,CAAC,CAAC;QAC3H,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;YACtC,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YAC7C,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,sBAAsB,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACzD,KAAK,CAAC,IAAI,CAAC,iBAAiB,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/formatters/collections.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Collections formatter — human-readable output for pb collections commands.
+ * BET-280 Slice 1: CLI surface for collection registry (STD-101 SSOT, DEC-299).
+ */
+export interface CollectionListItem {
+    slug: string;
+    name: string;
+    description?: string;
+    fieldCount: number;
+    icon?: string;
+}
+export interface CollectionListResult {
+    collections: CollectionListItem[];
+    total: number;
+}
+export interface CollectionAuditIssue {
+    code: string;
+    message: string;
+    fieldKey?: string;
+}
+export interface CollectionAuditItem {
+    slug: string;
+    name: string;
+    icon?: string;
+    fieldCount: number;
+    issues: CollectionAuditIssue[];
+}
+export interface CollectionAuditResult {
+    total: number;
+    healthy: number;
+    withIssues: number;
+    collections: CollectionAuditItem[];
+}
+/** Format collection list as a human-readable table. */
+export declare function formatCollectionList(result: CollectionListResult): string;
+/** Format full collection detail (describe output) as human-readable text. */
+export declare function formatCollectionDescribe(col: Record<string, unknown>): string;
+/** Format collection audit result as a human-readable health report. */
+export declare function formatCollectionAudit(result: CollectionAuditResult): string;
+//# sourceMappingURL=collections.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../../src/formatters/collections.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,oBAAoB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,mBAAmB,EAAE,CAAC;CACpC;AAED,wDAAwD;AACxD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CA+BzE;AAED,8EAA8E;AAC9E,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAmC7E;AAED,wEAAwE;AACxE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CA8B3E"}

package/dist/formatters/collections.js

@@ -0,0 +1,93 @@
+/**
+ * Collections formatter — human-readable output for pb collections commands.
+ * BET-280 Slice 1: CLI surface for collection registry (STD-101 SSOT, DEC-299).
+ */
+/** Format collection list as a human-readable table. */
+export function formatCollectionList(result) {
+    if (result.total === 0) {
+        return 'No collections found in this workspace.';
+    }
+    const lines = [];
+    lines.push(`Collections (${result.total}):`);
+    lines.push('');
+    // Column widths
+    const maxSlug = Math.max(...result.collections.map((c) => c.slug.length), 4);
+    const maxName = Math.max(...result.collections.map((c) => c.name.length), 4);
+    const header = [
+        'Icon'.padEnd(4),
+        'Slug'.padEnd(maxSlug),
+        'Name'.padEnd(maxName),
+        'Fields',
+    ].join('  ');
+    lines.push(`  ${header}`);
+    lines.push(`  ${'-'.repeat(header.length)}`);
+    for (const col of result.collections) {
+        const icon = (col.icon ?? '—').padEnd(4);
+        const slug = col.slug.padEnd(maxSlug);
+        const name = col.name.padEnd(maxName);
+        const fields = String(col.fieldCount);
+        lines.push(`  ${icon}  ${slug}  ${name}  ${fields}`);
+    }
+    return lines.join('\n');
+}
+/** Format full collection detail (describe output) as human-readable text. */
+export function formatCollectionDescribe(col) {
+    const lines = [];
+    const icon = col.icon ?? '';
+    lines.push(`${icon ? icon + ' ' : ''}${col.name} (${col.slug})`);
+    if (col.description) {
+        lines.push('');
+        lines.push(String(col.description));
+    }
+    if (col.usageGuidance) {
+        lines.push('');
+        lines.push('When to use:');
+        lines.push(String(col.usageGuidance));
+    }
+    else if (col.purpose) {
+        lines.push('');
+        lines.push('Purpose:');
+        lines.push(String(col.purpose));
+    }
+    const fields = col.fields;
+    if (fields && fields.length > 0) {
+        lines.push('');
+        lines.push(`Fields (${fields.length}):`);
+        for (const f of fields) {
+            const req = f.required ? ' *' : '';
+            lines.push(`  ${f.key}${req}  (${f.type})`);
+            if (f.helpText) {
+                lines.push(`    ${f.helpText}`);
+            }
+        }
+    }
+    return lines.join('\n');
+}
+/** Format collection audit result as a human-readable health report. */
+export function formatCollectionAudit(result) {
+    const lines = [];
+    lines.push(`Collection Audit`);
+    lines.push(`Total: ${result.total}  Healthy: ${result.healthy}  With issues: ${result.withIssues}`);
+    lines.push('');
+    if (result.withIssues === 0) {
+        lines.push('All collections are healthy.');
+        return lines.join('\n');
+    }
+    const withIssues = result.collections.filter((c) => c.issues.length > 0);
+    lines.push('Collections with issues:');
+    lines.push('');
+    for (const col of withIssues) {
+        const icon = col.icon ?? '—';
+        lines.push(`  ${icon} ${col.name} (${col.slug})`);
+        for (const issue of col.issues) {
+            lines.push(`    [${issue.code}] ${issue.message}`);
+        }
+        lines.push('');
+    }
+    const healthy = result.collections.filter((c) => c.issues.length === 0);
+    if (healthy.length > 0) {
+        lines.push(`Healthy: ${healthy.map((c) => c.slug).join(', ')}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=collections.js.map

package/dist/formatters/collections.js.map

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

package/dist/formatters/conflicts.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Human-formatted rendering for the `pb conflicts` verb group (WP-499 Slice A, TEN-2744).
+ * Mirrors formatters/feedback.ts's shape: one entry point per verb, kernel purity —
+ * no Wilson math here, `summary`'s humanBar fields are rendered exactly as
+ * readVerdictSummary returns them (kernel/coherency/healSweepPolicy.ts owns that math).
+ */
+export interface ConflictListItem {
+    /**
+     * Non-underscore twin of the row's `_id` (TEN-340: the CLI's JSON envelope
+     * unconditionally strips any `_id`-keyed field via stripConvexInternals) — this is
+     * the field `pb conflicts resolve <id>` targets.
+     */
+    id: string;
+    entryAId: string | null;
+    entryAName: string;
+    entryBId: string | null;
+    entryBName: string;
+    conflictType: string;
+    confidence: number;
+    explanation: string;
+    createdAt: number;
+    dangling: boolean;
+    /** C2 (WP-468): review fix (PR #528 P2) — the API has returned these since C2 shipped;
+     *  the pretty renderer never rendered them. `null` = unverdicted / not currently snoozed. */
+    humanVerdict?: 'real' | 'false_alarm' | null;
+    snoozedUntil?: number | null;
+    /** Present only in `--all` mode — per-row debt guidance for a verdicted/snoozed row. */
+    guidance?: string | null;
+    /** Review fix (PR #528 round 2, P2): stamped on every row in `--all` mode — true when the
+     *  server's 200-row debt-pile scan was capped, so lower-confidence rows beyond it are hidden.
+     *  Was previously undisclosed: the header rendered an exact-looking "Open conflicts (200)"
+     *  with no way for an operator to know more debt existed past the cap. */
+    listTruncated?: boolean;
+}
+/** Which server-side view produced the list — threads through to the empty-state message and
+ *  per-row guidance rendering (review fix, PR #528 P2). */
+export type ConflictListMode = 'actionable' | 'all';
+/** Age is derived at render time from the existing createdAt field — never a stored field. */
+export declare function formatConflictAge(createdAt: number, now?: number): string;
+export declare function formatConflictItem(item: ConflictListItem, now?: number): string;
+export declare function formatConflictsList(items: ConflictListItem[], options?: {
+    mode?: ConflictListMode;
+    now?: number;
+}): string;
+export type ConflictVerdict = 'real' | 'false_alarm';
+export declare function formatConflictResolve(value: unknown, verdict: ConflictVerdict): string;
+/** `pb conflicts snooze` render — bounded, logged debt (Q6: never phrased as a dismissal). */
+export declare function formatConflictSnooze(value: unknown): string;
+/** `pb conflicts reverdict` render — a logged amendment, names the prior value (point 3). */
+export declare function formatConflictReverdict(value: unknown, verdict: ConflictVerdict): string;
+export interface HumanBar {
+    meets: boolean;
+    lowerBound: number | null;
+    reviewed: number;
+}
+/** Shape returned by readVerdictSummary (convex/telemetry/healSweepRuns.ts) — rendered as-is. */
+export interface ConflictsSummary {
+    reviewed: number;
+    real: number;
+    falseAlarm: number;
+    humanBar: HumanBar;
+    /** Review fix (PR #528 round 3, P2): true when the resolved/open-verdicted scan truncated —
+     *  reviewed/real/falseAlarm/humanBar then describe a SAMPLE, not the full population, the same
+     *  honesty rule already applied to the scoreboard panel and getContradictionEnforcementStatus. */
+    truncated?: boolean;
+    [key: string]: unknown;
+}
+export declare function formatConflictsSummary(value: ConflictsSummary): string;
+//# sourceMappingURL=conflicts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conflicts.d.ts","sourceRoot":"","sources":["../../src/formatters/conflicts.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB;iGAC6F;IAC7F,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAAC;IAC7C,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,wFAAwF;IACxF,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;8EAG0E;IAC1E,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;2DAC2D;AAC3D,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,KAAK,CAAC;AAMpD,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,CAUrF;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ/E;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,gBAAgB,EAAE,EACzB,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,gBAAgB,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GACtD,MAAM,CAsBR;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,aAAa,CAAC;AAErD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,CAOtF;AAED,8FAA8F;AAC9F,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAM3D;AAED,6FAA6F;AAC7F,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,CAMxF;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,iGAAiG;AACjG,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;IACnB;;sGAEkG;IAClG,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAStE"}

package/dist/formatters/conflicts.js

@@ -0,0 +1,87 @@
+import { stripControlChars } from '../lib/strip.js';
+function singleLine(value) {
+    return stripControlChars(value).replace(/\s+/g, ' ').trim();
+}
+/** Age is derived at render time from the existing createdAt field — never a stored field. */
+export function formatConflictAge(createdAt, now = Date.now()) {
+    const deltaMs = Math.max(0, now - createdAt);
+    const deltaSec = Math.floor(deltaMs / 1000);
+    if (deltaSec < 60)
+        return `${deltaSec}s ago`;
+    const deltaMin = Math.floor(deltaSec / 60);
+    if (deltaMin < 60)
+        return `${deltaMin}m ago`;
+    const deltaHour = Math.floor(deltaMin / 60);
+    if (deltaHour < 24)
+        return `${deltaHour}h ago`;
+    const deltaDay = Math.floor(deltaHour / 24);
+    return `${deltaDay}d ago`;
+}
+export function formatConflictItem(item, now) {
+    const dangle = item.dangling ? ' [dangling]' : '';
+    const base = `[${item.confidence.toFixed(2)}] ${singleLine(item.id)} · ${singleLine(item.entryAName)} ↔ ${singleLine(item.entryBName)} · ${singleLine(item.conflictType)} · ${formatConflictAge(item.createdAt, now)}${dangle}`;
+    // Review fix (PR #528 P2): the API has returned guidance/humanVerdict/snoozedUntil since C2
+    // shipped — render them so a verdicted-real or snoozed debt row reads as debt, not as a
+    // plain unreviewed advisory (the `--all` guidance text was computed server-side and dropped).
+    if (item.guidance)
+        return `${base}\n      ↳ ${singleLine(item.guidance)}`;
+    return base;
+}
+export function formatConflictsList(items, options = {}) {
+    const { mode = 'actionable', now } = options;
+    if (items.length === 0) {
+        // Review fix (PR #528 P2): an empty ACTIONABLE result must never claim "no open conflicts"
+        // when snoozed/verdicted debt rows still exist — only the 'all' read means the workspace is
+        // genuinely clean of every open row.
+        return mode === 'all'
+            ? 'No open conflicts.'
+            : 'No actionable conflicts (open, unverdicted, unsnoozed). Run `pb conflicts list --all` to see verdicted/snoozed debt.';
+    }
+    // Review fix (PR #528 round 2, P2): every row carries the SAME listTruncated stamp (checking
+    // [0] is sufficient, never re-derived per-row). D1 residue fix (named item a): actionable
+    // mode's own scan can ALSO stop before exhausting the cohort (crowded out by enough
+    // snoozed/verdicted rows) — disclosed the same way 'all' mode already discloses its cap. Known
+    // residual gap (declared, not silently dropped): a scan that finds ZERO actionable rows AND
+    // was truncated has no row left to carry the stamp — the wire shape (a bare array) has no slot
+    // for that edge case; closing it needs a response-shape change, out of this fix's scope.
+    const truncated = items[0]?.listTruncated === true;
+    const header = mode === 'all'
+        ? `Open conflicts (${items.length}${truncated ? '+' : ''})`
+        : `Actionable conflicts (${items.length}${truncated ? '+' : ''})`;
+    return [header, '', ...items.map((item) => formatConflictItem(item, now))].join('\n');
+}
+export function formatConflictResolve(value, verdict) {
+    if (value && typeof value === 'object' && 'ok' in value && value.ok === true) {
+        return verdict === 'real'
+            ? 'Verdict recorded: real — the row stays open (visible until the content changes).'
+            : 'Verdict recorded: noise — the row is resolved.';
+    }
+    return JSON.stringify(value, null, 2);
+}
+/** `pb conflicts snooze` render — bounded, logged debt (Q6: never phrased as a dismissal). */
+export function formatConflictSnooze(value) {
+    if (value && typeof value === 'object' && 'snoozedUntil' in value) {
+        const v = value;
+        return `Snoozed until ${new Date(v.snoozedUntil).toISOString()} (snooze #${v.snoozeCount}) — this is logged debt, not a verdict.`;
+    }
+    return JSON.stringify(value, null, 2);
+}
+/** `pb conflicts reverdict` render — a logged amendment, names the prior value (point 3). */
+export function formatConflictReverdict(value, verdict) {
+    if (value && typeof value === 'object' && 'priorVerdict' in value) {
+        const v = value;
+        return `Reverdicted: ${v.priorVerdict} → ${verdict} (logged amendment).`;
+    }
+    return JSON.stringify(value, null, 2);
+}
+export function formatConflictsSummary(value) {
+    const lowerBoundText = value.humanBar.lowerBound === null
+        ? 'null (no reviewed rows yet)'
+        : value.humanBar.lowerBound.toFixed(3);
+    const sampledSuffix = value.truncated ? ' (sampled — scan cap reached)' : '';
+    return [
+        `Verdict summary: reviewed ${value.reviewed}, real ${value.real}, falseAlarm ${value.falseAlarm}${sampledSuffix}`,
+        `Wilson bar (human cohort): lowerBound ${lowerBoundText}, meets ${value.humanBar.meets}${sampledSuffix}`,
+    ].join('\n');
+}
+//# sourceMappingURL=conflicts.js.map

package/dist/formatters/conflicts.js.map

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

package/dist/formatters/conflicts.test.d.ts

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

package/dist/formatters/conflicts.test.d.ts.map

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

package/dist/formatters/conflicts.test.js

@@ -0,0 +1,136 @@
+import { describe, expect, it } from 'vitest';
+import { formatConflictAge, formatConflictsList, formatConflictResolve, formatConflictsSummary, } from './conflicts.js';
+const NOW = 1_800_000_000_000;
+function item(overrides = {}) {
+    return {
+        id: 'issue-1',
+        entryAId: 'DEC-1',
+        entryAName: 'DEC-1',
+        entryBId: 'DEC-2',
+        entryBName: 'DEC-2',
+        conflictType: 'contradiction',
+        confidence: 0.85,
+        explanation: 'Test conflict',
+        createdAt: NOW - 3 * 24 * 60 * 60 * 1000,
+        dangling: false,
+        ...overrides,
+    };
+}
+describe('conflicts formatters', () => {
+    // Review fix (PR #528 P2): the empty-state message is now MODE-AWARE — an empty ACTIONABLE
+    // result must never claim "no open conflicts" when verdicted/snoozed debt rows still exist.
+    it('renders an honest empty state for the actionable (default) mode — never "no open conflicts" when debt may still exist', () => {
+        expect(formatConflictsList([], { now: NOW })).toContain('No actionable conflicts');
+        expect(formatConflictsList([], { now: NOW })).not.toBe('No open conflicts.');
+    });
+    it('renders "No open conflicts." only for the all-mode empty state (the workspace is genuinely clean)', () => {
+        expect(formatConflictsList([], { mode: 'all', now: NOW })).toBe('No open conflicts.');
+    });
+    it('renders workspace rows with entry names, confidence, and relative age', () => {
+        const output = formatConflictsList([item()], { now: NOW });
+        expect(output).toContain('Actionable conflicts (1)');
+        expect(output).toContain('DEC-1');
+        expect(output).toContain('DEC-2');
+        expect(output).toContain('0.85');
+        expect(output).toContain('3d ago');
+    });
+    it('marks dangling rows (a partner entry was deleted)', () => {
+        const output = formatConflictsList([item({ dangling: true })], { now: NOW });
+        expect(output).toContain('[dangling]');
+    });
+    it('renders the non-underscore id — the field that survives the CLI JSON envelope\'s stripConvexInternals (TEN-340)', () => {
+        const output = formatConflictsList([item({ id: 'issue-target-1' })], { now: NOW });
+        expect(output).toContain('issue-target-1');
+    });
+    // C2 (WP-468) review fix (PR #528 P2): the server-computed per-row guidance for a
+    // verdicted/snoozed debt row must actually render in the `--all` pretty output.
+    it('renders per-row guidance text for a verdicted/snoozed debt row in --all mode', () => {
+        const output = formatConflictsList([item({ humanVerdict: 'real', guidance: 'confirmed contradiction (real) — supersede or archive one side' })], { mode: 'all', now: NOW });
+        expect(output).toContain('Open conflicts (1)');
+        expect(output).toContain('confirmed contradiction (real)');
+    });
+    it('renders a plain row (no guidance line) for an actionable row with no guidance field', () => {
+        const output = formatConflictsList([item()], { now: NOW });
+        expect(output).not.toContain('↳');
+    });
+    it('derives age purely from createdAt at render time — sub-minute, sub-hour, sub-day tiers', () => {
+        expect(formatConflictAge(NOW - 30_000, NOW)).toBe('30s ago');
+        expect(formatConflictAge(NOW - 5 * 60_000, NOW)).toBe('5m ago');
+        expect(formatConflictAge(NOW - 2 * 60 * 60_000, NOW)).toBe('2h ago');
+        expect(formatConflictAge(NOW - 4 * 24 * 60 * 60_000, NOW)).toBe('4d ago');
+    });
+    it('renders a resolve receipt naming the recorded CLI-vocabulary verdict — real stays open, noise resolves (C2)', () => {
+        expect(formatConflictResolve({ ok: true }, 'real')).toContain('real');
+        expect(formatConflictResolve({ ok: true }, 'real')).toContain('stays open');
+        expect(formatConflictResolve({ ok: true }, 'false_alarm')).toContain('noise');
+        expect(formatConflictResolve({ ok: true }, 'false_alarm')).toContain('resolved');
+    });
+    it('renders the summary with raw counts and the humanBar Wilson-bound fields exactly as returned', () => {
+        const output = formatConflictsSummary({
+            reviewed: 2,
+            real: 1,
+            falseAlarm: 1,
+            open: 0,
+            resolvedWithoutVerdict: 0,
+            precision: 0.5,
+            truncated: false,
+            humanBar: { meets: false, lowerBound: 0.05, reviewed: 2 },
+            escalatedCohort: { byModel: {}, crossTab: [] },
+        });
+        expect(output).toContain('reviewed 2');
+        expect(output).toContain('real 1');
+        expect(output).toContain('falseAlarm 1');
+        expect(output).toContain('meets false');
+        expect(output).toContain('0.05'.slice(0, 4));
+    });
+    it('renders humanBar.lowerBound === null as an explicit, honest empty state — never a blank or "0"', () => {
+        const output = formatConflictsSummary({
+            reviewed: 0,
+            real: 0,
+            falseAlarm: 0,
+            open: 0,
+            resolvedWithoutVerdict: 0,
+            precision: 0,
+            truncated: false,
+            humanBar: { meets: false, lowerBound: null, reviewed: 0 },
+            escalatedCohort: { byModel: {}, crossTab: [] },
+        });
+        expect(output).toContain('null');
+        expect(output).not.toContain('lowerBound 0,');
+    });
+    // Review fix (PR #528 round 3, P2): when the verdict scan truncated, reviewed/real/falseAlarm
+    // and the Wilson bar describe only the SAMPLED cohort — must render a qualifier, matching the
+    // scoreboard panel's existing verdictsSuffix pattern.
+    it('renders a truncation qualifier on both lines when the verdict scan truncated', () => {
+        const output = formatConflictsSummary({
+            reviewed: 1300,
+            real: 1200,
+            falseAlarm: 100,
+            open: 0,
+            resolvedWithoutVerdict: 0,
+            precision: 0.92,
+            truncated: true,
+            humanBar: { meets: true, lowerBound: 0.9, reviewed: 1300 },
+            escalatedCohort: { byModel: {}, crossTab: [] },
+        });
+        expect(output).toContain('sampled — scan cap reached');
+        const lines = output.split('\n');
+        expect(lines[0]).toContain('sampled — scan cap reached');
+        expect(lines[1]).toContain('sampled — scan cap reached');
+    });
+    it('renders NO truncation qualifier when the verdict scan did not truncate', () => {
+        const output = formatConflictsSummary({
+            reviewed: 2,
+            real: 1,
+            falseAlarm: 1,
+            open: 0,
+            resolvedWithoutVerdict: 0,
+            precision: 0.5,
+            truncated: false,
+            humanBar: { meets: false, lowerBound: 0.05, reviewed: 2 },
+            escalatedCohort: { byModel: {}, crossTab: [] },
+        });
+        expect(output).not.toContain('sampled');
+    });
+});
+//# sourceMappingURL=conflicts.test.js.map