@productbrain/cli 0.1.0-beta.1131 → 0.1.0-beta.11318

package/dist/formatters/search.d.ts

@@ -1,8 +1,32 @@
+/** TASK-854: who decides the row, as the Chain list names it (convex/inbox.chainList.ts ChainOwner). */
+export type SearchOwner = {
+    kind: 'role';
+    role: string;
+    team: string;
+    covering: boolean;
+} | {
+    kind: 'home';
+    team: string;
+} | {
+    kind: 'unreadable';
+    text: string;
+};
 export interface SearchResult {
     entryId?: string | null;
     name: string;
     collectionSlug?: string | null;
     status?: string;
+    owner?: SearchOwner;
+}
+/** chain.search's answer: the platform glossary terms first (no entry id), the rows, and the cut sentence when cut. */
+export interface SearchResponse {
+    platform: {
+        name: string;
+        definition: string;
+    }[];
+    rows: SearchResult[];
+    cutLine: string | null;
 }
 export declare function formatSearchResults(results: SearchResult[]): string;
+export declare function formatSearchResponse(response: SearchResponse): string;
 //# sourceMappingURL=search.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/formatters/search.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAcnE"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/formatters/search.ts"],"names":[],"mappings":"AASA,wGAAwG;AACxG,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,uHAAuH;AACvH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjD,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAaD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CASnE;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAIrE"}

package/dist/formatters/search.js

@@ -1,20 +1,35 @@
 /**
- * Search formatter — scannable terminal output for chain.searchEntries results.
+ * Search formatter — scannable terminal output for chain.search results.
  * Chain: DEC-186 (CLI uses Convex view model with CLI-native formatting).
  */
 import { stripControlChars } from '../lib/strip.js';
+import { displayEntryStatus } from '../lib/statusCategories.js'; // T8 (TASK-393, WP-779): generated from kernel/entries/statusCategories.ts
+import { PLATFORM_TERM_LABEL } from '../lib/platformGlossary.js'; // RULE-664: generated from kernel/governance/platformGlossary.ts
+import { PLACED_WORD } from '../lib/ownerLine.js'; // DEC-2064, RULE-664: the one word for where a role lives, GENERATED copy of kernel/organisationalAuthority/ownerLine.ts
+/** Status column display word — empty-string guard around the generated
+ *  `displayEntryStatus` fold (kernel/entries/statusCategories.ts). */
+function displayStatus(status) {
+    if (!status)
+        return '';
+    return displayEntryStatus(status);
+}
+function ownerWords(owner) {
+    return owner.kind === 'role' ? owner.role : owner.kind === 'home' ? `${PLACED_WORD} ${owner.team}` : owner.text;
+}
 export function formatSearchResults(results) {
-    if (results.length === 0) {
-        return 'No results found.';
-    }
     // BET-269 C3: stripControlChars on all user-controlled strings before terminal output
     const s = stripControlChars;
-    const lines = [];
-    for (const r of results) {
-        const id = r.entryId ?? r.name;
-        const coll = r.collectionSlug ?? '—';
-        lines.push(`  ${s(id)}  [${s(coll)}]  ${s(r.name)}`);
-    }
-    return lines.join('\n');
+    return results.map((r) => {
+        const status = displayStatus(r.status);
+        const statusSuffix = status ? `  (${s(status)})` : '';
+        const ownerSuffix = r.owner ? `  · ${s(ownerWords(r.owner))}` : '';
+        return `  ${s(r.entryId ?? r.name)}  [${s(r.collectionSlug ?? '—')}]  ${s(r.name)}${statusSuffix}${ownerSuffix}`;
+    }).join('\n');
+}
+export function formatSearchResponse(response) {
+    if (response.platform.length === 0 && response.rows.length === 0)
+        return 'No results found.';
+    const platform = response.platform.map((t) => `  ${PLATFORM_TERM_LABEL}  [glossary]  ${t.name}  ${t.definition}`);
+    return [...platform, formatSearchResults(response.rows), response.cutLine ?? ''].filter(Boolean).join('\n');
 }
 //# sourceMappingURL=search.js.map

package/dist/formatters/search.js.map

@@ -1 +1 @@
-{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/formatters/search.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AASpD,MAAM,UAAU,mBAAmB,CAAC,OAAuB;IACzD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,sFAAsF;IACtF,MAAM,CAAC,GAAG,iBAAiB,CAAC;IAC5B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,CAAC;QAC/B,MAAM,IAAI,GAAG,CAAC,CAAC,cAAc,IAAI,GAAG,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/formatters/search.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC,CAAC,2EAA2E;AAC5I,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC,CAAC,iEAAiE;AACnI,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC,CAAC,yHAAyH;AAuB5K;sEACsE;AACtE,SAAS,aAAa,CAAC,MAA0B;IAC/C,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,UAAU,CAAC,KAAkB;IACpC,OAAO,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,WAAW,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;AAClH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAuB;IACzD,sFAAsF;IACtF,MAAM,CAAC,GAAG,iBAAiB,CAAC;IAC5B,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACvB,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,YAAY,GAAG,WAAW,EAAE,CAAC;IACnH,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAwB;IAC3D,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,mBAAmB,CAAC;IAC7F,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,mBAAmB,iBAAiB,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;IAClH,OAAO,CAAC,GAAG,QAAQ,EAAE,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9G,CAAC"}

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

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

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

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

package/dist/formatters/search.test.js

@@ -0,0 +1,86 @@
+/**
+ * WP-644 S2 (TASK-74): formatSearchResults gains a status column. 'active' displays as the
+ * canonical 'accepted' word (DEC-1575 — the two are the same trust level); every other word
+ * (including 'accepted' itself, and any non-vocabulary word a caller passes) displays as
+ * stored. A missing status renders nothing, never the literal string "undefined".
+ */
+import { describe, expect, it } from 'vitest';
+import { formatSearchResponse, formatSearchResults } from './search.js';
+describe('formatSearchResults — status column trust-word display (WP-644 S2)', () => {
+    it("a legacy 'active' row displays as 'accepted'", () => {
+        const output = formatSearchResults([
+            { entryId: 'WP-1', name: 'Legacy row', collectionSlug: 'work-packages', status: 'active' },
+        ]);
+        expect(output).toContain('accepted');
+        expect(output).not.toContain('(active)');
+    });
+    it("a canonical 'accepted' row displays as 'accepted' (unchanged)", () => {
+        const output = formatSearchResults([
+            { entryId: 'WP-2', name: 'Canonical row', collectionSlug: 'work-packages', status: 'accepted' },
+        ]);
+        expect(output).toContain('accepted');
+    });
+    // F2 (PR review, TASK-393, WP-779): 'current' is a CATEGORY, not the 'accepted' LABEL one
+    // collection's own statusList happens to use for its live state (kickoff-final §5) —
+    // formatters/entry.ts's `pb get` shows the raw stored word ("Status: current"), so folding
+    // it here would make `search` disagree with `get` for the same entry. Shows as-is.
+    it("a category-derived 'current' row displays as 'current', not folded", () => {
+        const output = formatSearchResults([
+            { entryId: 'WP-7', name: 'Current row', collectionSlug: 'work-packages', status: 'current' },
+        ]);
+        expect(output).toContain('current');
+        expect(output).not.toContain('(accepted)');
+    });
+    it("a non-vocabulary status word ('published') displays as stored, not remapped", () => {
+        const output = formatSearchResults([
+            { entryId: 'DEC-1', name: 'Unrelated word', collectionSlug: 'decisions', status: 'published' },
+        ]);
+        expect(output).toContain('published');
+    });
+    it('a missing status renders nothing — never the literal "undefined"', () => {
+        const output = formatSearchResults([
+            { entryId: 'WP-3', name: 'No status', collectionSlug: 'work-packages' },
+        ]);
+        expect(output).not.toContain('undefined');
+    });
+    it("a 'draft'/'archived'/'deprecated' row displays as stored, not folded into another word", () => {
+        const output = formatSearchResults([
+            { entryId: 'WP-4', name: 'Draft row', collectionSlug: 'work-packages', status: 'draft' },
+            { entryId: 'WP-5', name: 'Deprecated row', collectionSlug: 'work-packages', status: 'deprecated' },
+            { entryId: 'WP-6', name: 'Archived row', collectionSlug: 'work-packages', status: 'archived' },
+        ]);
+        expect(output).toContain('draft');
+        expect(output).toContain('deprecated');
+        expect(output).toContain('archived');
+    });
+});
+describe('pb search — the kernel answer (TASK-854, DEC-1958)', () => {
+    const platform = [{ name: 'Team Lead', definition: 'The role accountable for a team’s purpose.' }];
+    it('prints the platform term first, marked Platform, then the rows with their owner, then the cut sentence', () => {
+        const output = formatSearchResponse({
+            platform,
+            rows: [{ entryId: 'GLO-9', name: 'Team Lead', collectionSlug: 'glossary', status: 'accepted', owner: { kind: 'role', role: 'Product Design', team: 'Product Brain', covering: false } }],
+            cutLine: 'Showing the first 50 matches; more exist. Add a word to narrow the search.',
+        });
+        expect(output.split('\n')).toEqual([
+            '  Platform  [glossary]  Team Lead  The role accountable for a team’s purpose.',
+            '  GLO-9  [glossary]  Team Lead  (accepted)  · Product Design',
+            'Showing the first 50 matches; more exist. Add a word to narrow the search.',
+        ]);
+    });
+    it('names a home team or an unreadable owner in the kernel words, and prints no cut line when nothing was cut', () => {
+        const output = formatSearchResponse({
+            platform: [],
+            rows: [
+                { entryId: 'ROL-1', name: 'Builder', collectionSlug: 'roles', owner: { kind: 'home', team: 'Agent Engineering' } },
+                { entryId: 'DEC-1', name: 'A decision', collectionSlug: 'decisions', owner: { kind: 'unreadable', text: 'Owner can’t be read' } },
+            ],
+            cutLine: null,
+        });
+        expect(output).toBe('  ROL-1  [roles]  Builder  · Team: Agent Engineering\n  DEC-1  [decisions]  A decision  · Owner can’t be read');
+    });
+    it('says so when nothing matched', () => {
+        expect(formatSearchResponse({ platform: [], rows: [], cutLine: null })).toBe('No results found.');
+    });
+});
+//# sourceMappingURL=search.test.js.map

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

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

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

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

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

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

package/dist/formatters/session-feedback.test.js

@@ -0,0 +1,124 @@
+import { describe, expect, it } from 'vitest';
+import { FEEDBACK_SUBMIT_HINT, START_ORIENT_LINE, formatSessionStart } from './session.js';
+import { GOVERNANCE_HERE_LINES, WORKING_WITH_PEOPLE_LINES } from '../lib/ruleListRender.js';
+const base = {
+    sessionId: 'session-1', workspaceId: 'workspace-1', workspaceName: 'Product Brain',
+    startedAt: '2026-07-16T12:00:00Z', entriesCaptured: [],
+};
+const notice = (source, subject, args = {}, verb = 'feedback.list') => ({
+    source, type: `${source}.x`, severity: 'advisory', subject, change: 'c', occurredAt: 0, action: { verb, args },
+});
+const rule = (n, bucket, name) => ({
+    entryId: `RULE-${n}`, bucket, ownerRoleId: 'ROL-23', ownerRoleName: 'Team Lead', name, why: 'A long reason that start never prints.', date: '2026-10-01',
+});
+describe('session start (TASK-763, INS-2760): who you act as, every rule as one line, two counts, one door', () => {
+    it('prints the lines in order: session, workspace, role, team, rules, counts, the orient door last', () => {
+        const out = formatSessionStart(base, 'product-brain', {
+            briefing: {
+                purpose: 'One truth for people and agents.', currentWorkPackage: { entryId: 'WP-777', name: 'Rules handed to agents' },
+                role: { name: 'Builder', entryId: 'ROL-20', team: 'Agent Engineering', body: 'Purpose: build one slice.' },
+            },
+            ruleLists: {
+                everyone: { rows: [rule(3, 'everyone', 'Every write names its owner')], overCap: 0 },
+                team: { rows: [rule(4, 'team', 'Ship small.')], overCap: 0 },
+                role: { rows: [{ entryId: 'RULE-5', bucket: 'role', ownerRoleId: 'ROL-20' }], overCap: 0 },
+                unassigned: 0, truncated: false,
+            },
+        });
+        expect(out.split('\n')).toEqual([
+            'Session started: session-1',
+            'Workspace: Product Brain (profile product-brain)',
+            'Acting as role: Builder (ROL-20)',
+            'Team: Agent Engineering',
+            'Role body: pb get ROL-20',
+            'RULE-3: Every write names its owner',
+            'RULE-4: Ship small.',
+            'RULE-5', // a served-log row carries no title, so its id alone
+            'Open questions: 0', // TASK-923: no drafts line when none wait; the kernel's notice says when some do
+            '', ...GOVERNANCE_HERE_LINES, '', ...WORKING_WITH_PEOPLE_LINES, '', // DEC-1947, TASK-669: after the rules
+            START_ORIENT_LINE,
+        ]);
+        // The spine, the role body and the rule reasons are not start's.
+        for (const gone of ['Purpose: build', 'One truth', 'WP-777', 'Why:', FEEDBACK_SUBMIT_HINT]) {
+            expect(out).not.toContain(gone);
+        }
+    });
+    it('TASK-655 (DEC-1973): a covered role prints the covering headline, its team, then the roles held and covered on one line', () => {
+        const out = formatSessionStart(base, 'product-brain', {
+            briefing: {
+                role: { name: 'Researcher', entryId: 'ROL-7', team: 'Product', coveringAs: 'Root' },
+                seats: { seated: [{ name: 'Team Lead', entryId: 'ROL-1', team: 'Root' }], covered: [{ name: 'Researcher', entryId: 'ROL-7', team: 'Product' }] },
+            },
+        });
+        expect(out.split('\n').slice(2, 6)).toEqual([
+            'Acting as role: Researcher (ROL-7), covering as Team Lead of Root',
+            'Team: Product',
+            'Roles you hold: Team Lead (ROL-1, Root). You cover as Team Lead: 1, Researcher (ROL-7, Product).',
+            'Role body: pb get ROL-7',
+        ]);
+    });
+    it('fits a 20-rule workspace with long titles under 6,000 bytes, with the first rule before byte 2,048 and every rule before the prose', () => {
+        const long = 'Every independent region of the shell renders inside its own error boundary that reports to Sentry, and the client polls for a new build and reloads on the next navigation';
+        const rows = Array.from({ length: 20 }, (_, i) => rule(600 + i, i < 15 ? 'everyone' : 'role', long));
+        const out = formatSessionStart(base, 'product-brain', {
+            briefing: { role: { name: 'Builder', entryId: 'ROL-20', team: 'Agent Engineering', body: 'x'.repeat(4000) } },
+            ruleLists: { everyone: { rows: rows.slice(0, 15), overCap: 0 }, team: null, role: { rows: rows.slice(15), overCap: 0 }, unassigned: 0, truncated: false },
+            notices: [notice('drafts-waiting', '15 drafts wait', { count: 15 }, 'bridge.open')],
+        });
+        const bytes = Buffer.from(out, 'utf8');
+        expect(bytes.length).toBeLessThan(6000);
+        expect(bytes.indexOf('RULE-')).toBeLessThan(2048);
+        expect(out.lastIndexOf('RULE-6')).toBeLessThan(out.indexOf(GOVERNANCE_HERE_LINES[0]));
+        expect(out.match(/^RULE-\d+: /gm)).toHaveLength(20);
+        // A title past the cap is cut at a word and says so.
+        expect(out).toContain('RULE-600: Every independent region of the shell renders inside its own error boundary that reports to Sentry, and the…\n');
+    });
+    it('counts open questions, saying "at least" when the read was capped', () => {
+        const asked = {
+            ...notice('question-ack-gate', 's', {}, 'answer'),
+            payload: { truncated: true, questions: [{ name: 'Audience', question: 'q', asker: 'a', sourcePointer: 'QUE-26', domain: 'd', whyYou: 'w', ageDays: 21, dependents: { count: 0, named: [] }, actions: [] }] },
+        };
+        const out = formatSessionStart(base, null, { notices: [asked] });
+        // A nonzero count names its door (RULE-662): the question list.
+        expect(out).toContain('Open questions: at least 1 (pb question list)\n');
+        expect(out).not.toContain('QUE-26');
+    });
+    it('TASK-923: prints the drafts-waiting notice as the kernel wrote it, one draft a line under the head, with no sum of its own', () => {
+        const subject = [
+            'Voice: 2 drafts wait for your accept (2 of 2 shown). Decide each now.',
+            '  TEN-1 Headline: pb entry accept TEN-1, or pb entry discard TEN-1',
+            '  TEN-2 Pricing: pb entry accept TEN-2, or pb entry discard TEN-2',
+        ].join('\n');
+        const waiting = { ...notice('drafts-waiting', subject, { count: 2, shown: 2, atLeast: false }, 'bridge.open'), change: 'open /w/acme/bridge' };
+        const out = formatSessionStart(base, null, { notices: [waiting] });
+        expect(out).toContain([
+            '  • Voice: 2 drafts wait for your accept (2 of 2 shown). Decide each now. (open /w/acme/bridge)',
+            '    TEN-1 Headline: pb entry accept TEN-1, or pb entry discard TEN-1',
+            '    TEN-2 Pricing: pb entry accept TEN-2, or pb entry discard TEN-2',
+        ].join('\n'));
+        expect(out).not.toContain('Drafts awaiting your accept');
+    });
+    it('keeps a per-person notice as one line, drops the vendor feedback-queue notice, and never leads with either', () => {
+        const out = formatSessionStart(base, null, {
+            notices: [notice('feedback-status', 'Your report has an answer'), notice('feedback-queue', 'Feedback queue: 4 new', { count: 4 }, 'feedback.queue')],
+        });
+        expect(out).toContain('  • Your report has an answer (c) — pb feedback list');
+        expect(out).not.toContain('Feedback queue');
+        expect(out.indexOf('Session started:')).toBe(0);
+        expect(out.endsWith(START_ORIENT_LINE)).toBe(true);
+    });
+    it('a resumed start keeps its own heading and the same lines', () => {
+        const out = formatSessionStart({ ...base, entriesCaptured: ['DEC-1'] }, null, {
+            briefing: { role: { name: 'Team Lead', entryId: 'ROL-23' } },
+            ruleLists: { everyone: { rows: [rule(3, 'everyone', 'Every write names its owner')], overCap: 0 }, team: null, role: { rows: [], overCap: 0 }, unassigned: 0, truncated: true, actingRoleBound: true },
+        }, 'already-active');
+        expect(out).toContain('Session already active: session-1\nEntries captured: 1\nWorkspace: Product Brain\nActing as role: Team Lead (ROL-23)\nRole body: pb get ROL-23\nRULE-3: Every write names its owner\n(Some rules may be missing: the rule read was truncated.)');
+        expect(out).not.toContain('Session started:');
+    });
+    it('keeps the feedback invite in one constant for the JSON payload', () => {
+        // model-behavior test 2026-07-17: 6/8 agents invented invalid categories from `-c <category>`.
+        expect(FEEDBACK_SUBMIT_HINT).toContain('pb feedback submit -c <bug|friction|idea|praise|other>');
+        expect(FEEDBACK_SUBMIT_HINT).toContain('not your workspace content');
+    });
+});
+//# sourceMappingURL=session-feedback.test.js.map

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

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

package/dist/formatters/session.d.ts

@@ -1,11 +1,127 @@
 /**
  * Session formatters — terminal output for session start / close.
+ *
+ * TEN-2370: session close must reflect the *server's* post-promote truth, not the
+ * local capture-time snapshot. `formatSessionClose` takes a `SessionCloseWrapup`
+ * (committed vs still-draft, from `agent.getSessionWrapup`) and renders the real
+ * loop status. `formatLoopUnfinished` renders the enforcement nudge when drafts
+ * remain (ASM-40) — the session is intentionally left open so the agent can
+ * promote and re-close.
  */
 import type { SessionState } from '../lib/session.js';
-export declare function formatSessionStart(session: SessionState, superseded?: {
-    previousSessionId: string;
-    startedAt: string;
+import { type SessionNotice } from '../lib/sessionNotices.js';
+import { type OrientView } from './orient.js';
+import { type BriefingFactsView, type RuleListsRenderView } from '../lib/ruleListRender.js';
+/** WP-582 B2 round 1 (Codex P2 review, PR #532, T10): the same three-line rituals surface orient
+ *  renders, reused verbatim (`buildRitualsSurfaceLines`) so close never invents its own copy. */
+export type SessionCloseRituals = Pick<OrientView, 'directionLine' | 'verdictAskLine' | 'spineLine'>;
+/** One entry as the server reports it in the wrapup (committed or draft). */
+export interface WrapupEntryRef {
+    entryId: string;
+    name: string;
+}
+/**
+ * Server-truth view of the session at close time. `null` when the wrapup read
+ * failed — callers fall back to the legacy local-snapshot rendering so an infra
+ * blip never blocks a close.
+ */
+export interface SessionCloseWrapup {
+    committed: WrapupEntryRef[];
+    drafts: WrapupEntryRef[];
+    /** TASK-743 (TEN-4624): discarded/archived/resolved this session — named, never counted as committed or draft. */
+    discarded: Array<WrapupEntryRef & {
+        label: string;
+    }>;
+    /**
+     * Entries past OVERFLOW_SCAN_CAP the server did not enumerate (TEN-2370). A nonzero
+     * value means the draft set could not be fully read, so the gate fails CLOSED.
+     */
+    overflowUnscanned?: number;
+    /** TASK-923 (DEC-2130 B): role-held drafts with the kernel's line; listed as left for their owner, never promoted. */
+    held?: Array<WrapupEntryRef & {
+        line: string;
+    }>;
+}
+/** The exact, copy-pasteable batch accept command for a set of draft IDs. WP-640 S4
+ *  (DEC-1578): `pb promote` retired — this is now `pb entry accept`, same server route. */
+export declare function buildPromoteCommand(entryIds: string[]): string;
+/**
+ * The session-start invite to send feedback. Agents pipe stdout, so they never see the pretty
+ * block this line lives in — every session-start JSON payload carries it as `feedbackHint` too.
+ * One constant, because a hint that reaches only TTY users reaches ~1% of this CLI's callers.
+ */
+export declare const FEEDBACK_SUBMIT_HINT = "Friction or ideas? `pb feedback submit -c <bug|friction|idea|praise|other> \"<message>\"` \u2014 describe how pb behaved, not your workspace content. Once screening completes, it enters the builders' triage queue.";
+/** TASK-763 (INS-2760): a SessionStart hook shows the model only the first 2 KB of a long output, so start
+ *  prints who you act as and every served rule as one line first; the governance prose follows (under 6 KB). */
+export declare const START_ORIENT_LINE = "Spine, rule reasons and notices: pb orient --task \"<what you are doing>\"";
+export declare function formatSessionStart(session: SessionState, activeProfile?: string | null, feedback?: {
+    notices?: SessionNotice[];
+    ruleLists?: RuleListsRenderView;
+    briefing?: BriefingFactsView;
+}, mode?: 'started' | 'already-active'): string;
+export declare function formatSessionClose(session: SessionState, wrapup: SessionCloseWrapup | null, workspaceSlug?: string | null, appUrl?: string | null, rituals?: SessionCloseRituals | null, counts?: {
+    created: number;
+    modified: number;
+    relationsCreated: number;
+    capLine: string | null;
+} | null): string;
+/**
+ * The enforcement nudge (ASM-40 / TEN-2370): drafts remain and the operator did
+ * not pass --force. The session is left OPEN — this output tells them how to
+ * finish the loop (promote) and how to escape (--force). It must never imply the
+ * session was closed.
+ */
+export declare function formatLoopUnfinished(wrapup: SessionCloseWrapup): string;
+/** One session row as returned by `agent.listSessions` / carried in `agent.showConversation`. */
+export interface SessionListRow {
+    sessionId: string;
+    conversationId: string | null;
+    label: string | null;
+    clientKind: string | null;
     initiatedBy: string;
-}, activeProfile?: string | null): string;
-export declare function formatSessionClose(session: SessionState, workspaceSlug?: string | null, appUrl?: string | null): string;
+    status: string;
+    startedAt: number;
+    lastToolCallAt: number;
+    entriesCreatedCount: number;
+    entriesModifiedCount: number;
+    purpose: string | null;
+}
+export interface SessionListData {
+    active: SessionListRow[];
+    recent: SessionListRow[];
+    quota: {
+        activeCount: number;
+        cap: number;
+    };
+}
+/** A lineage row as returned by `agent.showConversation` — SessionListRow plus per-session activity detail. */
+export interface ShowLineageRow extends SessionListRow {
+    entriesCreated: string[];
+    entriesModified: string[];
+    relationsCreated: number;
+    gateFailures: number;
+    contradictionWarnings: number;
+}
+/** One governanceServedLog row surfaced by `agent.showConversation`. TASK-436: `bucket`/
+ *  `ownerRoleId`/`teamId` match `RuleListServedRow`'s field names (`@productbrain/kernel-client`)
+ *  for a rule-list serve; `bucket: null` for an old-bucket (principles/standards/businessRules)
+ *  serve, which carries no owner/team here. */
+export interface ShowServeRow {
+    servedAt: number;
+    entryId: string;
+    surface: string;
+    renderMode: string | null;
+    task: string | null;
+    sessionId: string | null;
+    bucket: 'everyone' | 'team' | 'role' | null;
+    ownerRoleId: string | null;
+    teamId: string | null;
+}
+export interface ShowConversationData {
+    conversationId: string | null;
+    sessions: ShowLineageRow[];
+    serves: ShowServeRow[];
+}
+export declare function formatSessionList(data: SessionListData): string;
+export declare function formatSessionShow(data: ShowConversationData): string;
 //# sourceMappingURL=session.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/formatters/session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,YAAY,EACrB,UAAU,CAAC,EAAE;IAAE,iBAAiB,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAClF,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAC5B,MAAM,CAoBR;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,YAAY,EACrB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,EAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GACrB,MAAM,CAiCR"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/formatters/session.ts"],"names":[],"mappings":"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"}