@productbrain/cli 0.1.0-beta.9 → 0.1.0-beta.9000

package/dist/formatters/search.test.js

@@ -0,0 +1,57 @@
+/**
+ * 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 { 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');
+    });
+});
+//# 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,133 @@
+import { describe, expect, it, vi } from 'vitest';
+import { FEEDBACK_SUBMIT_HINT, formatSessionStart } from './session.js';
+describe('session feedback discovery', () => {
+    it('always shows the write hint; the vendor triage-queue condition renders as a spine notice, never the old plain-text line', () => {
+        vi.useFakeTimers();
+        vi.setSystemTime(new Date('2026-07-16T12:00:00Z'));
+        const base = {
+            sessionId: 'session-1', workspaceId: 'workspace-1', workspaceName: 'Product Brain',
+            startedAt: '2026-07-16T12:00:00Z', entriesCaptured: [],
+        };
+        const ordinary = formatSessionStart(base);
+        expect(ordinary).toContain('pb feedback submit -c <bug|friction|idea|praise|other>');
+        expect(ordinary).not.toContain('Feedback queue:');
+        // WP-584 S4 (FEAT-1412 / TEN-2971): the legacy "Feedback queue: N new (oldest Xd) — pb
+        // feedback queue" line is retired — `formatSessionStart` no longer accepts
+        // feedbackQueueNew/feedbackOldestNewAt at all (2nd param is `activeProfile` now). The SAME
+        // condition renders structurally as a `feedback-queue` notice through the shared
+        // `formatSessionNoticeLines` path every other spine notice already uses.
+        const vendor = formatSessionStart(base, null, {
+            notices: [{
+                    source: 'feedback-queue', type: 'feedback.queue-nonempty', severity: 'advisory',
+                    subject: 'Feedback queue: 4 new', change: 'oldest 3d',
+                    occurredAt: Date.now() - 3 * 86_400_000,
+                    action: { verb: 'feedback.queue', args: { count: 4, oldestNewAt: Date.now() - 3 * 86_400_000 } },
+                }],
+        });
+        expect(vendor).toContain('Notices:');
+        // The bulleted, notice-rendered form — NOT the old bare/headerless line (no leading bullet,
+        // no "Notices:" section) the legacy formatter used to emit directly under the banner.
+        expect(vendor).toContain('  • Feedback queue: 4 new (oldest 3d) — pb feedback queue');
+        vi.useRealTimers();
+    });
+    it('serves the invite from one constant so the pretty and JSON paths cannot drift', () => {
+        // Agents pipe stdout and never render the pretty block; the JSON payloads carry this same
+        // string as `feedbackHint`. A second literal anywhere is how the two silently diverge.
+        const base = {
+            sessionId: 'session-1', workspaceId: 'workspace-1', workspaceName: 'Product Brain',
+            startedAt: '2026-07-16T12:00:00Z', entriesCaptured: [],
+        };
+        // The enum rides in the hint because agents compose the command from this line alone
+        // (model-behavior test 2026-07-17: 6/8 agents invented invalid categories from `-c <category>`),
+        // and the behaviour-not-content clause is the §4-redaction-can't-filter-content privacy control.
+        expect(FEEDBACK_SUBMIT_HINT).toContain('pb feedback submit -c <bug|friction|idea|praise|other>');
+        expect(FEEDBACK_SUBMIT_HINT).toContain('not your workspace content');
+        expect(formatSessionStart(base)).toContain(FEEDBACK_SUBMIT_HINT);
+    });
+    // TASK-436: session start renders the three rule lists when the server serves them; absent
+    // when the workspace has none yet — never an empty "Rules:" header.
+    it('renders the three rule lists when served, nothing when ruleLists is absent', () => {
+        const base = {
+            sessionId: 'session-1', workspaceId: 'workspace-1', workspaceName: 'Product Brain',
+            startedAt: '2026-07-16T12:00:00Z', entriesCaptured: [],
+        };
+        const withRules = formatSessionStart(base, null, {
+            ruleLists: {
+                everyone: { rows: [{ entryId: 'RULE-1', bucket: 'everyone', ownerRoleId: 'ROLE-1' }], overCap: 0 },
+                team: { rows: [{ entryId: 'RULE-2', bucket: 'team', ownerRoleId: 'ROLE-2', teamId: 'TEAM-1' }], overCap: 0 },
+                role: { rows: [], overCap: 0 },
+                unassigned: 0,
+                truncated: false,
+            },
+        });
+        expect(withRules).toContain('Rules:');
+        expect(withRules).toContain('RULE-1 — owner ROLE-1');
+        expect(withRules).toContain('RULE-2 — owner ROLE-2 (team TEAM-1)');
+        expect(formatSessionStart(base)).not.toContain('Rules:');
+    });
+    // TASK-551 (DEC-1888): the live serve prints each rule as one sentence with its why and names
+    // the rules the cap left out.
+    it('renders each served rule as one sentence with its why, and an over-cap list whole with one overflow line', () => {
+        const out = formatSessionStart({
+            sessionId: 'session-1', workspaceId: 'workspace-1', workspaceName: 'Product Brain',
+            startedAt: '2026-07-16T12:00:00Z', entriesCaptured: [],
+        }, null, {
+            ruleLists: {
+                everyone: {
+                    rows: [
+                        { entryId: 'RULE-3', bucket: 'everyone', ownerRoleId: 'ROL-23', ownerRoleName: 'Team Lead', name: 'Every write names its owner', why: 'An unowned write has nobody to ask.', date: '2026-10-01', confirmedBy: 'Randy' },
+                        { entryId: 'RULE-657', bucket: 'everyone', ownerRoleId: 'ROL-23', ownerRoleName: 'Team Lead', name: 'Ship small', date: '2026-10-02' },
+                    ],
+                    overCap: 1,
+                },
+                team: null,
+                role: { rows: [], overCap: 0 },
+                unassigned: 0,
+                truncated: false,
+            },
+        });
+        expect(out).toContain('Rules:\nEveryone:\n  - RULE-3 — Every write names its owner. Why: An unowned write has nobody to ask. — Team Lead, 2026-10-01\n  - RULE-657 — Ship small. — Team Lead, 2026-10-02\n  (2 rules on a list capped at 1: retire 1 to fit; until then accept refuses new rules here.)');
+    });
+    // TASK-552 (DEC-1888): session start renders the one briefing; open questions move into it.
+    it('renders the briefing with the spine and open questions, and does not repeat the question notice', () => {
+        const out = formatSessionStart({
+            sessionId: 'session-1', workspaceId: 'workspace-1', workspaceName: 'Product Brain',
+            startedAt: '2026-07-16T12:00:00Z', entriesCaptured: [],
+        }, null, {
+            roleName: 'Team Lead',
+            briefing: { purpose: 'One truth for people and agents.', currentWorkPackage: { entryId: 'WP-777', name: 'Rules handed to agents' } },
+            notices: [{
+                    source: 'question-ack-gate', type: 'question.ack-gate.open', severity: 'warning', subject: 's', change: 'c', occurredAt: 0,
+                    action: { verb: 'answer', args: {} },
+                    payload: { questions: [{ name: 'Audience', question: 'Who is this for?', asker: 'Randy', sourcePointer: 'QUE-26', domain: 'd', whyYou: 'w', ageDays: 21, dependents: { count: 0, named: [] }, actions: [] }] },
+                }],
+        });
+        expect(out).toContain('Workspace: Product Brain — acting as Team Lead');
+        expect(out).toContain('Purpose: One truth for people and agents.');
+        expect(out).toContain('Current work package (WP-777): Rules handed to agents');
+        expect(out).toContain('  - QUE-26 — Audience (21d)');
+        expect(out).not.toContain('open question need you');
+        expect(out).toContain('Pull more: pb orient --task');
+    });
+    // WP-777, DEC-1888, INS-2674: a resumed session start (after a compaction) serves the same briefing.
+    it('renders the full briefing under the already-active heading, with the invite', () => {
+        const out = formatSessionStart({
+            sessionId: 'session-1', workspaceId: 'workspace-1', workspaceName: 'Product Brain',
+            startedAt: '2026-07-16T12:00:00Z', entriesCaptured: ['DEC-1'],
+        }, null, {
+            roleName: 'Team Lead',
+            ruleLists: {
+                everyone: { rows: [{ entryId: 'RULE-3', bucket: 'everyone', ownerRoleId: 'ROL-23', ownerRoleName: 'Team Lead', name: 'Every write names its owner' }], overCap: 0 },
+                team: null, role: { rows: [], overCap: 0 }, unassigned: 0, truncated: false,
+            },
+        }, 'already-active');
+        expect(out).toContain('Session already active: session-1');
+        expect(out).toContain('Entries captured: 1');
+        expect(out).not.toContain('Session started:');
+        expect(out).toContain('Workspace: Product Brain — acting as Team Lead');
+        expect(out).toContain('RULE-3 — Every write names its owner.');
+        expect(out).toContain(FEEDBACK_SUBMIT_HINT);
+        expect(out).toContain('pb session close');
+    });
+});
+//# 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,129 @@
 /**
  * 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 } 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[];
+    /**
+     * 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;
+    /** WP-660 S2 review fix (round 2, P1-A): was previously read by MCP only — advertised must
+     *  equal enforced, so the CLI now renders it too (silent when the cohort is empty). */
+    acceptIndependenceDigest?: {
+        header: string;
+        lines: 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.";
+/**
+ * WP-584 S4 (FEAT-1412 / TEN-2971): the legacy plain-text "Feedback queue: N new..." line lived
+ * here — an agent skimming stdout read right past it (dogfood 2026-08-02: the agent never told
+ * the user). It is now the `feedback-queue` spine notice (until-resolved, standing state
+ * — see convex/lib/notices/feedbackQueueProducer.ts), rendered structurally through the SAME
+ * `notices` block below every other spine notice already uses. The raw `feedbackQueueNew` /
+ * `feedbackOldestNewAt` fields stay on the wire response (S1 contract item 7, published
+ * clients) — this formatter just no longer RENDERS a bespoke line from them.
+ */
+export declare function formatSessionStart(session: SessionState, activeProfile?: string | null, feedback?: {
+    notices?: SessionNotice[];
+    ruleLists?: OrientView['ruleLists'];
+    briefing?: BriefingFactsView;
+    roleName?: string;
+}, 
+/** WP-777 (INS-2674): an already-active session gets the same briefing, under its own heading. */
+mode?: 'started' | 'already-active'): string;
+export declare function formatSessionClose(session: SessionState, wrapup: SessionCloseWrapup | null, workspaceSlug?: string | null, appUrl?: string | null, rituals?: SessionCloseRituals | 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;
-}): string;
-export declare function formatSessionClose(session: SessionState): 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,GACjF,MAAM,CAmBR;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAqBhE"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/formatters/session.ts"],"names":[],"mappings":"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"}