@productbrain/cli 0.1.0-beta.978 → 0.1.0-beta.9784

package/dist/formatters/entryAccept.js.map

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

package/dist/formatters/feedback.d.ts

@@ -0,0 +1,58 @@
+/** Sanitized submission context — round 12 review fix, see `formatFeedbackItem` below. */
+export interface FeedbackContext {
+    appVersion?: string;
+    command?: string;
+    route?: string;
+    client?: string;
+}
+/**
+ * WP-494 §5: own-workspace read-back rows (`feedback.listOwn`, via `serializeOwnFeedback`)
+ * carry NO `workspaceId` (always the caller's own workspace — redundant), `groupId`, or
+ * `triageNote` (vendor working state). Vendor queue rows (`feedback.list`) carry all of
+ * them. `formatFeedbackItem` renders either shape, omitting absent fields cleanly.
+ */
+export interface FeedbackItem {
+    id: string;
+    workspaceId?: string;
+    category: string;
+    status: string;
+    surface: string;
+    actor: string;
+    message: string;
+    createdAt: number;
+    statusUpdatedAt?: number;
+    /** TASK-666 (DEC-1987): why the kernel left a 'screening' row held; printed as `held:`. */
+    screeningHoldReason?: string;
+    groupId?: string;
+    triageNote?: string;
+    context?: FeedbackContext;
+}
+/** Paged list response (Codex P2, PR #372): the kernel serves cursor pagination. */
+export interface FeedbackPage {
+    items: FeedbackItem[];
+    continueCursor: string | null;
+    isDone: boolean;
+}
+/** The CLI requests the paged shape, but a pre-cursor kernel may still answer plain rows. */
+export type FeedbackListResult = FeedbackItem[] | FeedbackPage;
+/** The list filters the operator passed, echoed into the next-page footer command. */
+export interface FeedbackListFilters {
+    status?: string;
+    category?: string;
+    groupId?: string;
+    workspaceId?: string;
+    since?: string;
+    before?: string;
+    limit?: string;
+}
+export type FeedbackMutationAction = 'submit' | 'note' | 'group' | 'status';
+/**
+ * Which client verb printed this page (WP-494 §5 verb-rename sweep) — the pagination
+ * footer must echo the SAME verb the operator ran, `pb feedback list` (own read-back)
+ * or `pb feedback queue` (vendor triage), never a hardcoded one.
+ */
+export type FeedbackListVerb = 'list' | 'queue';
+export declare function formatFeedbackItem(item: FeedbackItem): string;
+export declare function formatFeedbackList(value: FeedbackListResult, filters: FeedbackListFilters | undefined, verb: FeedbackListVerb): string;
+export declare function formatFeedbackMutation(value: unknown, action?: FeedbackMutationAction): string;
+//# sourceMappingURL=feedback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../../src/formatters/feedback.ts"],"names":[],"mappings":"AAEA,0FAA0F;AAC1F,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2FAA2F;IAC3F,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IAIpB,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAED,oFAAoF;AACpF,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,6FAA6F;AAC7F,MAAM,MAAM,kBAAkB,GAAG,YAAY,EAAE,GAAG,YAAY,CAAC;AAE/D,sFAAsF;AACtF,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE5E;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,CAAC;AAMhD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAqC7D;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,mBAAmB,YAAK,EAAE,IAAI,EAAE,gBAAgB,GAAG,MAAM,CA0B/H;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,GAAE,sBAAiC,GAAG,MAAM,CAaxG"}

package/dist/formatters/feedback.js

@@ -0,0 +1,91 @@
+import { stripControlChars } from '../lib/strip.js';
+function singleLine(value) {
+    return stripControlChars(value).replace(/\s+/g, ' ').trim();
+}
+export function formatFeedbackItem(item) {
+    // Grouping and prior triage reasoning must be visible to the operator following the
+    // session-start queue hint (Codex P2, PR #372): the group as a copyable id suffix on the
+    // row head, the note as one indented follow-up line. Rows stay one-to-two lines.
+    // `workspace …` is vendor-queue-only (own-workspace rows never carry `workspaceId` —
+    // it's always the caller's own workspace, so the segment is omitted, not printed as
+    // "undefined").
+    // Review fix (Codex P2, PR #396 round 4): `serializeOwnFeedback` provides `actor` and
+    // `createdAt` specifically for transparent read-back (WP-494 §5) — the formatter was
+    // discarding both, so a multi-member workspace's `pb feedback list` output carried no
+    // indication of who submitted a row or when. Date-only (YYYY-MM-DD, same compact
+    // convention as formatters/entry.ts's history rendering) to keep rows one-to-two lines.
+    const group = item.groupId ? ` [group: ${singleLine(item.groupId)}]` : '';
+    const workspace = item.workspaceId ? ` workspace ${singleLine(item.workspaceId)} ·` : '';
+    const date = new Date(item.createdAt).toISOString().split('T')[0];
+    // Review fix (P2, finding 3): the Cortex read-back panel (FeedbackReadBackPanel.svelte)
+    // now renders `statusUpdatedAt` as a distinct "Status updated <time>" element beside the
+    // submission time — without a CLI sibling, `pb feedback list` paired a possibly-later
+    // status with only the original submission date. Same date-only convention as `date`
+    // above; both timestamps are Date-derived (never raw user input), so — like `date` — this
+    // is not passed through `singleLine()`.
+    const statusUpdated = item.statusUpdatedAt
+        ? ` (status updated ${new Date(item.statusUpdatedAt).toISOString().split('T')[0]})`
+        : '';
+    const head = `[${singleLine(item.status)}] ${singleLine(item.id)} · ${singleLine(item.category)}/${singleLine(item.surface)} ·${workspace} ${singleLine(item.actor)} · ${date}${statusUpdated} · ${singleLine(item.message)}${group}`;
+    const lines = [head];
+    if (item.screeningHoldReason)
+        lines.push(`  held: ${singleLine(item.screeningHoldReason)}`);
+    if (item.triageNote)
+        lines.push(`  note: ${singleLine(item.triageNote)}`);
+    // Round 12 review fix (P2): sanitized submission context (route/command/client/version) —
+    // an indented follow-up line, same convention as `note` above, omitting absent fields.
+    const contextParts = [];
+    if (item.context?.route)
+        contextParts.push(`route ${singleLine(item.context.route)}`);
+    if (item.context?.command)
+        contextParts.push(`command ${singleLine(item.context.command)}`);
+    if (item.context?.client)
+        contextParts.push(`client ${singleLine(item.context.client)}`);
+    if (item.context?.appVersion)
+        contextParts.push(`version ${singleLine(item.context.appVersion)}`);
+    if (contextParts.length)
+        lines.push(`  context: ${contextParts.join(' · ')}`);
+    return lines.join('\n');
+}
+export function formatFeedbackList(value, filters = {}, verb) {
+    const page = Array.isArray(value)
+        ? { items: value, continueCursor: null, isDone: true }
+        : { items: value.items ?? [], continueCursor: value.continueCursor ?? null, isDone: value.isDone !== false };
+    const lines = page.items.length
+        ? [`Feedback (${page.items.length})`, '', ...page.items.map(formatFeedbackItem)]
+        : [verb === 'queue' ? 'No feedback matched this queue view.' : 'No feedback matched this view.'];
+    // More rows remain: print the ready-to-run next-page command, echoing the filters the
+    // operator passed AND the verb they ran (WP-494 §5 verb-rename sweep — `list` for own
+    // read-back, `queue` for the vendor triage queue) so the next page keeps the same view.
+    if (!page.isDone && page.continueCursor) {
+        const filterFlags = [
+            ['--status', filters.status],
+            ['--category', filters.category],
+            ['--group-id', filters.groupId],
+            ['--workspace-id', filters.workspaceId],
+            ['--since', filters.since],
+            ['--before', filters.before],
+            ['--limit', filters.limit],
+        ];
+        const echoed = filterFlags
+            .filter(([, flagValue]) => flagValue !== undefined && flagValue !== '')
+            .map(([flag, flagValue]) => `${flag} ${singleLine(flagValue)}`);
+        lines.push('', `next page: pb feedback ${verb} ${[...echoed, `--cursor ${singleLine(page.continueCursor)}`].join(' ')}`);
+    }
+    return lines.join('\n');
+}
+export function formatFeedbackMutation(value, action = 'submit') {
+    if (value && typeof value === 'object' && 'id' in value) {
+        const id = singleLine(String(value.id));
+        const label = action === 'submit'
+            ? 'Feedback submitted'
+            : action === 'note'
+                ? 'Feedback note updated'
+                : action === 'status'
+                    ? 'Feedback status updated'
+                    : 'Feedback group updated';
+        return `${label}: ${id}`;
+    }
+    return JSON.stringify(value, null, 2);
+}
+//# sourceMappingURL=feedback.js.map

package/dist/formatters/feedback.js.map

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

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

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

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

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

package/dist/formatters/feedback.test.js

@@ -0,0 +1,123 @@
+import { describe, expect, it } from 'vitest';
+import { formatFeedbackList, formatFeedbackMutation } from './feedback.js';
+describe('feedback formatters', () => {
+    it('renders an empty first-run queue cleanly', () => {
+        expect(formatFeedbackList([], {}, 'queue')).toBe('No feedback matched this queue view.');
+    });
+    it('renders an empty own-workspace read-back cleanly (WP-494 §5)', () => {
+        expect(formatFeedbackList([], {}, 'list')).toBe('No feedback matched this view.');
+    });
+    it('renders workspace-aware, terminal-safe queue rows and action-specific receipts', () => {
+        const output = formatFeedbackList([{
+                id: 'feedback-1', workspaceId: 'workspace-1', category: 'bug', status: 'new',
+                surface: 'mcp', actor: 'agent', message: 'Could not finish\n\u001b]0;spoofed title\u0007the import', createdAt: 1,
+            }], {}, 'queue');
+        expect(output).toContain('[new] feedback-1 · bug/mcp · workspace workspace-1 · agent · 1970-01-01 · Could not finish the import');
+        expect(output).not.toContain('\u001b');
+        expect(output.split('\n')).toHaveLength(3);
+        expect(formatFeedbackMutation({ id: 'feedback-1' })).toBe('Feedback submitted: feedback-1');
+        expect(formatFeedbackMutation({ id: 'feedback-1' }, 'note')).toBe('Feedback note updated: feedback-1');
+        expect(formatFeedbackMutation({ id: 'feedback-1' }, 'status')).toBe('Feedback status updated: feedback-1');
+    });
+    it('renders own-workspace rows WITHOUT a workspace segment (WP-494 §5: no workspaceId, no triageNote/groupId)', () => {
+        const output = formatFeedbackList([{
+                id: 'feedback-1', category: 'bug', status: 'screening',
+                surface: 'mcp', actor: 'agent', message: 'Could not finish the import', createdAt: 1,
+            }], {}, 'list');
+        // Review fix (Codex P2, PR #396 round 4): actor + createdAt (date-only) now render so
+        // a multi-member workspace's read-back shows provenance, matching the Cortex panel.
+        expect(output).toContain('[screening] feedback-1 · bug/mcp · agent · 1970-01-01 · Could not finish the import');
+        expect(output).not.toContain('workspace');
+        expect(output).not.toContain('undefined');
+    });
+    it('prints a ready-to-run next-page command command-aware to the verb (WP-494 §5 verb-rename sweep)', () => {
+        const row = {
+            id: 'feedback-1', workspaceId: 'workspace-1', category: 'bug', status: 'new',
+            surface: 'mcp', actor: 'agent', message: 'first page row', createdAt: 1,
+        };
+        const output = formatFeedbackList({ items: [row], continueCursor: 'cursor-token-1', isDone: false }, { status: 'new', category: 'bug', limit: '1' }, 'queue');
+        const lines = output.split('\n');
+        // The footer echoes the operator's filters AND the verb they ran so the next page
+        // keeps the same view.
+        expect(lines[lines.length - 1]).toBe('next page: pb feedback queue --status new --category bug --limit 1 --cursor cursor-token-1');
+        expect(lines[lines.length - 2]).toBe('');
+        // Done pages and legacy plain-rows responses print no footer.
+        expect(formatFeedbackList({ items: [row], continueCursor: 'cursor-token-1', isDone: true }, {}, 'queue')).not.toContain('next page');
+        expect(formatFeedbackList([row], {}, 'queue')).not.toContain('next page');
+        // A terminal-unsafe cursor is sanitized before it lands in a copy-paste command.
+        const unsafe = formatFeedbackList({ items: [row], continueCursor: 'evil\u001b]0;spoof\u0007cursor', isDone: false }, {}, 'queue');
+        expect(unsafe).not.toContain('\u001b');
+        expect(unsafe).toContain('next page: pb feedback queue --cursor');
+        // The own-workspace read-back verb prints its own command name in the footer.
+        const ownOutput = formatFeedbackList({ items: [row], continueCursor: 'cursor-token-2', isDone: false }, { status: 'new', limit: '1' }, 'list');
+        expect(ownOutput).toContain('next page: pb feedback list --status new --limit 1 --cursor cursor-token-2');
+    });
+    it('renders statusUpdatedAt as a status-transition date alongside createdAt (P2 finding 3, CLI sibling of the Cortex panel)', () => {
+        const withTransition = formatFeedbackList([{
+                id: 'feedback-1', category: 'bug', status: 'new',
+                surface: 'mcp', actor: 'agent', message: 'Could not finish the import',
+                createdAt: 1, statusUpdatedAt: 172_800_000, // 1970-01-03
+            }], {}, 'list');
+        expect(withTransition).toContain('1970-01-01 (status updated 1970-01-03) · Could not finish the import');
+        // Absent statusUpdatedAt (e.g. a row still 'screening') renders exactly like before —
+        // no stray "(status updated …)" segment.
+        const withoutTransition = formatFeedbackList([{
+                id: 'feedback-2', category: 'bug', status: 'screening',
+                surface: 'mcp', actor: 'agent', message: 'still screening', createdAt: 1,
+            }], {}, 'list');
+        expect(withoutTransition).not.toContain('status updated');
+    });
+    // TASK-666 (DEC-1987): a held row says why, on both `pb feedback list` and `pb feedback queue`.
+    it('prints a held row\'s hold reason as an indented line under the row, for list and queue', () => {
+        const row = {
+            id: 'feedback-3', category: 'bug', status: 'screening', surface: 'cli', actor: 'agent',
+            message: 'held row', createdAt: 1, screeningHoldReason: 'The rewrite call failed (unknown); the sweep retries later.',
+        };
+        for (const verb of ['list', 'queue']) {
+            expect(formatFeedbackList([row], {}, verb)).toContain('\n  held: The rewrite call failed (unknown); the sweep retries later.');
+        }
+        expect(formatFeedbackList([{ ...row, screeningHoldReason: undefined }], {}, 'list')).not.toContain('held:');
+    });
+    // Round 12 review fix (P2): serializeOwnFeedback now returns `context` (sanitized
+    // route/command/client/appVersion) — the CLI sibling of the Cortex panel's rendering.
+    it('surfaces sanitized submission context as an indented line, omitting absent fields', () => {
+        const output = formatFeedbackList([{
+                id: 'feedback-1', category: 'bug', status: 'new',
+                surface: 'mcp', actor: 'agent', message: 'context check', createdAt: 1,
+                context: { route: '/w/:workspace/settings', command: 'pb feedback submit', client: 'cli', appVersion: 'v1.2.3' },
+            }], {}, 'list');
+        const lines = output.split('\n');
+        expect(lines[3]).toBe('  context: route /w/:workspace/settings · command pb feedback submit · client cli · version v1.2.3');
+        expect(lines).toHaveLength(4);
+        // A row carrying no context prints no context line at all.
+        const withoutContext = formatFeedbackList([{
+                id: 'feedback-2', category: 'bug', status: 'new',
+                surface: 'mcp', actor: 'agent', message: 'no context', createdAt: 1,
+            }], {}, 'list');
+        expect(withoutContext).not.toContain('context:');
+        // A partially-populated context omits the missing fields rather than printing a
+        // placeholder for them.
+        const partial = formatFeedbackList([{
+                id: 'feedback-3', category: 'bug', status: 'new',
+                surface: 'mcp', actor: 'agent', message: 'partial context', createdAt: 1,
+                context: { route: '/w/:workspace/settings' },
+            }], {}, 'list');
+        expect(partial).toContain('  context: route /w/:workspace/settings');
+        expect(partial).not.toContain('undefined');
+    });
+    it('surfaces the triage note and group on queue rows (Codex P2, PR #372)', () => {
+        const output = formatFeedbackList([{
+                id: 'feedback-2', workspaceId: 'workspace-1', category: 'friction', status: 'triaged',
+                surface: 'cli', actor: 'agent', message: 'grouped row', createdAt: 2,
+                groupId: 'feedback-parent', triageNote: 'dup of\nfeedback-parent \u001b[31mseen twice\u001b[0m',
+            }], {}, 'queue');
+        const lines = output.split('\n');
+        // Row head keeps its one-line shape with the group suffixed…
+        expect(lines[2]).toBe('[triaged] feedback-2 · friction/cli · workspace workspace-1 · agent · 1970-01-01 · grouped row [group: feedback-parent]');
+        // …and the prior triage reasoning follows as one indented, terminal-safe line.
+        expect(lines[3]).toBe('  note: dup of feedback-parent seen twice');
+        expect(lines).toHaveLength(4);
+        expect(output).not.toContain('\u001b');
+    });
+});
+//# sourceMappingURL=feedback.test.js.map

package/dist/formatters/feedback.test.js.map

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

package/dist/formatters/fields.d.ts

@@ -18,14 +18,20 @@ export interface CollectionField {
     colorMap?: unknown;
     accentSource?: boolean;
     iconMap?: Record<string, string>;
-    helpText?: string;
     optionDescriptions?: unknown;
     semanticRole?: string;
 }
+/** WP-770 B1a round-1 review (PRRT_kwDORS4ils6l0qHb, real): the body's starting heading+guidance
+ *  skeleton (see convex/lib/collectionShapeValidators.ts's bodyTemplateValidator doc comment). */
+export interface CollectionBodyTemplateEntry {
+    heading: string;
+    guidance: string;
+}
 export interface CollectionFieldsResult {
     slug: string;
     name: string;
     fields: CollectionField[];
+    bodyTemplate?: readonly CollectionBodyTemplateEntry[] | null;
 }
 /** Format collection fields as a human-readable table for TTY output. */
 export declare function formatFields(result: CollectionFieldsResult): string;

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

@@ -1 +1 @@
-{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/formatters/fields.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAsDnE"}
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/formatters/fields.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;kGACkG;AAClG,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,SAAS,2BAA2B,EAAE,GAAG,IAAI,CAAC;CAC9D;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CA4DnE"}

package/dist/formatters/fields.js

@@ -8,6 +8,15 @@ export function formatFields(result) {
     const lines = [];
     lines.push(`Collection: ${result.name} (${result.slug})`);
     lines.push('');
+    if (result.bodyTemplate && result.bodyTemplate.length > 0) {
+        lines.push(`Body template (${result.bodyTemplate.length}):`);
+        lines.push('');
+        for (const entry of result.bodyTemplate) {
+            lines.push(`  ${entry.heading}`);
+            lines.push(`    ${entry.guidance}`);
+        }
+        lines.push('');
+    }
     if (!result.fields || result.fields.length === 0) {
         lines.push('No fields defined.');
         return lines.join('\n');
@@ -23,9 +32,6 @@ export function formatFields(result) {
         if (field.options && field.options.length > 0) {
             lines.push(`    options: ${field.options.join(', ')}`);
         }
-        if (field.helpText) {
-            lines.push(`    help:    ${field.helpText}`);
-        }
         if (field.displayHint) {
             lines.push(`    display: ${field.displayHint}`);
         }

package/dist/formatters/fields.js.map

@@ -1 +1 @@
-{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../src/formatters/fields.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA4BH,yEAAyE;AACzE,MAAM,UAAU,YAAY,CAAC,MAA8B;IACzD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;IAC1D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACjC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,MAAM,cAAc,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,GAAG,GAAG,YAAY,GAAG,cAAc,EAAE,CAAC,CAAC;QAC7D,KAAK,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAEzC,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9C,KAAK,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QAClD,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACrC,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,6BAA6B;IAC7B,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;QAC1D,KAAK,CAAC,GAAG,EAAE,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../src/formatters/fields.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmCH,yEAAyE;AACzE,MAAM,UAAU,YAAY,CAAC,MAA8B;IACzD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;IAC1D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,YAAY,CAAC,MAAM,IAAI,CAAC,CAAC;QAC7D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QACtC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACjC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,MAAM,cAAc,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,GAAG,GAAG,YAAY,GAAG,cAAc,EAAE,CAAC,CAAC;QAC7D,KAAK,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAEzC,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9C,KAAK,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QAClD,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACrC,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,6BAA6B;IAC7B,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;QAC1D,KAAK,CAAC,GAAG,EAAE,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

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

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

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

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

package/dist/formatters/fields.test.js

@@ -0,0 +1,42 @@
+import { describe, expect, it } from 'vitest';
+import { formatFields } from './fields.js';
+describe('fields formatter', () => {
+    it('renders the body template above the fields list (WP-770 B1a round-1 review, real)', () => {
+        const output = formatFields({
+            slug: 'decisions',
+            name: 'Decisions',
+            bodyTemplate: [
+                { heading: 'Context', guidance: 'Why this option was chosen.' },
+                { heading: 'Alternatives considered', guidance: 'What else was evaluated.' },
+            ],
+            fields: [
+                { key: 'rationale', label: 'Rationale', type: 'string' },
+            ],
+        });
+        expect(output).toContain('Body template (2):');
+        expect(output).toContain('  Context');
+        expect(output).toContain('    Why this option was chosen.');
+        expect(output).toContain('  Alternatives considered');
+        expect(output).toContain('    What else was evaluated.');
+        // Renders above the fields section, not mixed into it.
+        expect(output.indexOf('Body template')).toBeLessThan(output.indexOf('Fields (1):'));
+    });
+    it('omits the body template section entirely when there is none', () => {
+        const output = formatFields({
+            slug: 'purpose',
+            name: 'Purpose',
+            fields: [{ key: 'description', label: 'Description', type: 'string' }],
+        });
+        expect(output).not.toContain('Body template');
+    });
+    it('omits the body template section when the array is empty, not a heading with nothing under it', () => {
+        const output = formatFields({
+            slug: 'purpose',
+            name: 'Purpose',
+            bodyTemplate: [],
+            fields: [{ key: 'description', label: 'Description', type: 'string' }],
+        });
+        expect(output).not.toContain('Body template');
+    });
+});
+//# sourceMappingURL=fields.test.js.map

package/dist/formatters/fields.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.test.js","sourceRoot":"","sources":["../../src/formatters/fields.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,mFAAmF,EAAE,GAAG,EAAE;QAC3F,MAAM,MAAM,GAAG,YAAY,CAAC;YAC1B,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,WAAW;YACjB,YAAY,EAAE;gBACZ,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,6BAA6B,EAAE;gBAC/D,EAAE,OAAO,EAAE,yBAAyB,EAAE,QAAQ,EAAE,0BAA0B,EAAE;aAC7E;YACD,MAAM,EAAE;gBACN,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE;aACzD;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,iCAAiC,CAAC,CAAC;QAC5D,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,2BAA2B,CAAC,CAAC;QACtD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,8BAA8B,CAAC,CAAC;QACzD,uDAAuD;QACvD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,MAAM,GAAG,YAAY,CAAC;YAC1B,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;SACvE,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8FAA8F,EAAE,GAAG,EAAE;QACtG,MAAM,MAAM,GAAG,YAAY,CAAC;YAC1B,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,SAAS;YACf,YAAY,EAAE,EAAE;YAChB,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;SACvE,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/formatters/handshake.d.ts

@@ -4,7 +4,6 @@
 import type { SearchResult } from './search.js';
 import type { RepoContext } from '../lib/repo-detect.js';
 import type { CodexValidationWarning } from '../generators/portable-knowledge.js';
-import type { ChainRulesStats } from '../generators/chain-rules.js';
 export type PreviewStatus = 'would-write' | 'would-update' | 'unchanged' | 'user-owned' | 'filtered' | 'would-augment' | 'needs-attention';
 export interface HandshakeReport {
     filesWritten: string[];
@@ -16,10 +15,6 @@ export interface HandshakeReport {
     searchQueries: string[];
     repo: RepoContext;
     codexWarnings?: CodexValidationWarning[];
-    /** Present when --generate was used and the Chain MCP call succeeded. */
-    chainRulesStats?: ChainRulesStats;
-    /** Governance function keys that had no matching entries (when --generate was used). */
-    chainGaps?: string[];
     /** Rules that passed the adopted allowlist filter (when manifest.yaml present). */
     adoptedCount?: number;
     /** Rules excluded by the rejected denylist (when manifest.yaml present). */
@@ -29,7 +24,8 @@ export interface HandshakeReport {
     /** Number of personal skills loaded from .productbrain/.local/skills/ (local only, never committed). */
     personalSkillCount?: number;
     /** Source the method registry was loaded from (present when manifest is set). */
-    registrySource?: 'chain' | 'bundled';
+    /** Always 'bundled' — the Chain registry path was removed (TEN-2783). */
+    registrySource?: 'bundled';
     /** true when registrySource is 'bundled' and the snapshot is older than 7 days. */
     registryStale?: boolean;
     /** true when running in preview mode (no files written — run with --apply to write). */
@@ -57,6 +53,28 @@ export interface HandshakeReport {
     adoptedTamperedPaths?: string[];
     /** Tampered projection paths the user chose to REVERT (overwritten with canonical content). */
     revertedTamperedPaths?: string[];
+    /**
+     * REPORT-ONLY (coordinator ruling, PR #912 round 10): marker-bearing projection files that
+     * look stale — orphaned, a stale case/punctuation variant, or a leftover `.dormant` copy.
+     * `pb handshake` never unlinks, renames, or recreates any of these; the human removes them.
+     */
+    leftoverFiles?: Array<{
+        path: string;
+        reason: string;
+    }>;
+    /** Round 13: true when the scanner stopped early (LEFTOVER_FILES_MAX) — the exact total beyond
+     *  what's shown is unknown by design (round 12 stops enumerating, it doesn't keep counting). */
+    leftoverFilesTruncated?: boolean;
+    /**
+     * REPORT-ONLY (WP-759/TASK-234, DEC-1736): rules/skills whose `targets` frontmatter names only
+     * surfaces that no longer project that asset kind (today: `claude` alone, since the rule/skill
+     * router projection was deleted). pb handshake does not re-target or drop these — the asset
+     * silently projects nowhere until a human re-targets it in Cortex.
+     */
+    noProjectionAssets?: Array<{
+        name: string;
+        targets: string[];
+    }>;
 }
 export declare function formatHandshakeReport(report: HandshakeReport): string;
 //# sourceMappingURL=handshake.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"handshake.d.ts","sourceRoot":"","sources":["../../src/formatters/handshake.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,cAAc,GAAG,WAAW,GAAG,YAAY,GAAG,UAAU,GAAG,eAAe,GAAG,iBAAiB,CAAC;AAE3I,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,cAAc,EAAE,YAAY,EAAE,CAAC;IAC/B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,EAAE,WAAW,CAAC;IAClB,aAAa,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACzC,yEAAyE;IACzE,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sGAAsG;IACtG,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wGAAwG;IACxG,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iFAAiF;IACjF,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC,mFAAmF;IACnF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,wFAAwF;IACxF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,aAAa,CAAA;KAAE,CAAC,CAAC;IAC7D;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B,+FAA+F;IAC/F,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6FAA6F;IAC7F,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClF,8FAA8F;IAC9F,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,+FAA+F;IAC/F,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;CAClC;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CA2MrE"}
+{"version":3,"file":"handshake.d.ts","sourceRoot":"","sources":["../../src/formatters/handshake.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAGlF,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,cAAc,GAAG,WAAW,GAAG,YAAY,GAAG,UAAU,GAAG,eAAe,GAAG,iBAAiB,CAAC;AAE3I,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,cAAc,EAAE,YAAY,EAAE,CAAC;IAC/B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,EAAE,WAAW,CAAC;IAClB,aAAa,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACzC,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sGAAsG;IACtG,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wGAAwG;IACxG,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iFAAiF;IACjF,yEAAyE;IACzE,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,mFAAmF;IACnF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,wFAAwF;IACxF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,aAAa,CAAA;KAAE,CAAC,CAAC;IAC7D;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B,+FAA+F;IAC/F,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6FAA6F;IAC7F,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClF,8FAA8F;IAC9F,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,+FAA+F;IAC/F,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC;;;;OAIG;IACH,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD;oGACgG;IAChG,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CACjE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CA+NrE"}

package/dist/formatters/handshake.js

@@ -1,6 +1,7 @@
 /**
  * Handshake formatter — console report after file generation.
  */
+import { renderFilesystemPath } from '../lib/strip.js';
 export function formatHandshakeReport(report) {
     const lines = [];
     const name = report.repo.name ?? 'unknown';
@@ -99,15 +100,6 @@ export function formatHandshakeReport(report) {
         }
         lines.push('');
     }
-    // Chain-derived rules stats (--generate)
-    if (report.chainRulesStats) {
-        const { generatedRules, suppressedByManual, suppressedByZeroEntries, totalEntries } = report.chainRulesStats;
-        lines.push(`Chain-derived rules: ${generatedRules} generated, ${suppressedByManual} suppressed by manual, ${suppressedByZeroEntries} gaps (from ${totalEntries} governance entries)`);
-        if (report.chainGaps && report.chainGaps.length > 0) {
-            lines.push(`Gaps (no matching governance entries): ${report.chainGaps.join(', ')}`);
-        }
-        lines.push('');
-    }
     // Codex dead-reference warnings
     if (report.codexWarnings && report.codexWarnings.length > 0) {
         lines.push(`Codex warnings (${report.codexWarnings.length} dead reference(s) in projected skills):`);
@@ -141,13 +133,14 @@ export function formatHandshakeReport(report) {
         lines.push(`Personal layer (local only): ${personalItems.join(', ')}`);
         lines.push('');
     }
-    // Method registry
+    // Method registry (bundled-only since TEN-2783). The registry ships INSIDE the pb CLI package
+    // (templates/method-registry.json), so the only way to refresh it is to update the CLI — NOT
+    // `pb handshake`, which just re-reads the same bundled snapshot (that guidance was a dead-end
+    // left over from the removed Chain path). The staleness signal is kept as an "your CLI is old"
+    // nudge, now pointing at the real refresh path.
     if (report.registrySource !== undefined) {
-        if (report.registrySource === 'chain') {
-            lines.push('✓ Method registry: live from Chain');
-        }
-        else if (report.registryStale) {
-            lines.push('⚠ Method registry: bundled (>7 days old — run pb handshake to refresh)');
+        if (report.registryStale) {
+            lines.push('⚠ Method registry: bundled snapshot >7 days old — update the pb CLI to refresh (it ships with the package)');
         }
         else {
             lines.push('✓ Method registry: bundled');
@@ -189,6 +182,32 @@ export function formatHandshakeReport(report) {
         }
         lines.push('');
     }
+    // REPORT-ONLY (coordinator ruling, PR #912 round 10) — pb handshake never unlinks, renames, or
+    // recreates any of these; the human removes them.
+    if (report.leftoverFiles && report.leftoverFiles.length > 0) {
+        lines.push('Leftover files:');
+        for (const f of report.leftoverFiles) {
+            // Round 15 (Codex P2): f.path is a readdirSync-derived filesystem name a user is told to
+            // go find and remove — sanitizeSingleLineField is lossy (collapses whitespace, deletes
+            // \r) for that use, so this uses the reversible filesystem-identifier escaper instead
+            // (lib/strip.ts), the one owner of this rule for all three leftover-render sites.
+            lines.push(`  ${renderFilesystemPath(f.path)} — ${renderFilesystemPath(f.reason)}`);
+        }
+        if (report.leftoverFilesTruncated) {
+            // Round 13 (Codex P2): don't promise this same, equally-capped command shows "the full
+            // list" — it never will in one run. Tell the user what to do with what's actually shown.
+            lines.push('  ...more may exist beyond this batch — review/remove these, then run `pb handshake` again.');
+        }
+        lines.push('');
+    }
+    // REPORT-ONLY (WP-759/TASK-234, DEC-1736) — pb handshake never re-targets these; the human
+    // re-targets them in Cortex.
+    if (report.noProjectionAssets && report.noProjectionAssets.length > 0) {
+        for (const a of report.noProjectionAssets) {
+            lines.push(`${a.name}: targets [${a.targets.join(', ')}] have no projection since DEC-1736; re-target in Cortex`);
+        }
+        lines.push('');
+    }
     lines.push('Tip: Add .productbrain/ to .gitignore (contains workspace-specific context).');
     lines.push('     Adapter files are local-only — never commit them. Regenerate on demand with `pb handshake --apply`.');
     lines.push('');