@productbrain/cli 0.1.0-beta.989 → 0.1.0-beta.9895

package/dist/commands/role.d.ts

@@ -0,0 +1,67 @@
+export interface RoleAccountableOptions {
+    canonicalKey?: string;
+    limit?: string;
+    cursor?: string;
+    json?: boolean;
+}
+/** Mirrors `chain.listByRole`'s row shape (convex/agentKnowledge/entriesByRole.ts's
+ *  `RoleEntrySummary`) with a PLAIN `id: string` — the door returns a Convex document id over
+ *  the wire as a bare string, and this interface (not the raw gateway type's branded
+ *  `Id<'entries'>`) is what argv-facing code and its own tests actually handle, same pattern
+ *  `outcome.ts`'s own `ReadingRow`/`ListReadingsResult` use. The call site below still derives
+ *  from `GatewayRouteReturnByName<'chain.listByRole'>` (review PRRT_kwDORS4ils6gQAqu) so a
+ *  route-shape drift fails the `as` cast at compile time — the branded id only blocks the
+ *  OPPOSITE direction (a plain-string test fixture claiming to BE the branded type), which never
+ *  happens here: the widening cast below (branded -> plain) is always legal. */
+export interface RoleEntryRow {
+    id: string;
+    entryId?: string;
+    name: string;
+    canonicalKey?: string;
+    collectionSlug?: string;
+    status: string;
+    workflowStatus?: string;
+}
+export interface ListByRoleResult {
+    role: {
+        id: string;
+        entryId?: string;
+        name: string;
+    };
+    explicit: RoleEntryRow[];
+    explicitTruncated: boolean;
+    nextCursor: number | null;
+    reporting: RoleEntryRow[];
+    reportingTruncated: boolean;
+    inherited: RoleEntryRow[];
+    inheritedResolution: 'not-computed';
+    inheritedNotComputedReason: string;
+    truncated: boolean;
+    /** TASK-636 (DEC-1810): who holds the role; status is active, invited or placeholder. */
+    holders: {
+        personId: string;
+        displayName: string;
+        status: string;
+        teamName: string | null;
+    }[];
+    holdersTruncated: boolean;
+}
+/**
+ * Pretty rendering for `pb role accountable`. Exported so door-parity content-equality against
+ * the MCP tool's own rendering (`packages/mcp-server/src/tools/role.ts`) is assertable directly,
+ * not only through a live walk — both read the SAME `chain.listByRole` JSON shape and both print
+ * the SAME three sections in the SAME order.
+ */
+export declare function formatRoleAccountable(result: ListByRoleResult | null): string;
+export declare function runRoleAccountable(roleId: string, options: RoleAccountableOptions): Promise<void>;
+export interface RoleSeatOptions {
+    person?: string;
+    newPerson?: string;
+    team?: string;
+}
+export declare function runRoleSeat(roleId: string, options: RoleSeatOptions): Promise<void>;
+export declare function runRoleUnseat(roleId: string, options: {
+    person: string;
+    team?: string;
+}): Promise<void>;
+//# sourceMappingURL=role.d.ts.map

package/dist/commands/role.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role.d.ts","sourceRoot":"","sources":["../../src/commands/role.ts"],"names":[],"mappings":"AAkCA,MAAM,WAAW,sBAAsB;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;;;;;;;gFAQgF;AAChF,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IAItB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,mBAAmB,EAAE,cAAc,CAAC;IACpC,0BAA0B,EAAE,MAAM,CAAC;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,yFAAyF;IACzF,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,EAAE,CAAC;IAC9F,gBAAgB,EAAE,OAAO,CAAC;CAC1B;AAsGD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,GAAG,MAAM,CAkB7E;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBvG;AAED,MAAM,WAAW,eAAe;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAMD,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAazF;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAM7G"}

package/dist/commands/role.js

@@ -0,0 +1,164 @@
+import { getConfigOrGuide } from '../lib/config.js';
+import { kernelCall, kernelCallWithSession } from '../lib/client.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
+import { runCliCommand } from '../lib/runner.js';
+import { formatSeatSentence } from '../lib/seatSentence.js';
+import { sanitizeSingleLineField } from '../lib/strip.js';
+import { runOrganisationWrite } from './organisationWrite.js';
+/** Holders first: who answers for the role, a non-active holder tagged with their status. */
+function formatHolders(result) {
+    if (result.holders.length === 0)
+        return [`  holders: none${result.holdersTruncated ? ' found, but the membership scan is incomplete' : ''}`];
+    return [
+        '  holders:',
+        ...result.holders.map((h) => {
+            const tag = h.status === 'active' ? '' : ` (${sanitizeSingleLineField(h.status)})`;
+            const team = h.teamName ? `  in ${sanitizeSingleLineField(h.teamName)}` : '';
+            return `    ${sanitizeSingleLineField(h.displayName)}${tag}${team}`;
+        }),
+        ...(result.holdersTruncated ? ['    (membership scan cut at 500 rows, more holders may exist)'] : []),
+    ];
+}
+const validation = (message, guidance) => new CLIError(message, { code: ErrorCode.VALIDATION_FAILED, category: 'validation', guidance });
+/** argv is a string; `--limit`/`--cursor` want whole numbers. Refused HERE, before any network
+ *  call, naming the flag — same shape `outcome.ts`'s own `requireNumber` and `shape.ts`'s enum
+ *  checks use (CLIError + code: VALIDATION_FAILED + category: 'validation'), so an invalid flag
+ *  reports category=validation in JSON mode rather than falling through to `runCliCommand`'s
+ *  generic unknown-error wrap (code: INTERNAL). Un-refused, `Number('abc')` is NaN, which
+ *  `JSON.stringify` silently turns into `null` on the wire — a validation bug disguised as a
+ *  present-but-empty value, not caught until the gateway's own (differently-worded) refusal.
+ */
+function requireInteger(raw, flag, range) {
+    const trimmed = raw.trim();
+    const parsed = Number(trimmed);
+    if (trimmed === '' || !Number.isInteger(parsed)) {
+        throw validation(`${flag} must be a whole number (got "${raw}").`, 'Usage: pb role accountable <role-id> [--limit <n>] [--cursor <n>]');
+    }
+    // PR #856 review round 3 (Codex P2, PRRT_kwDORS4ils6gQrZI): `requireInteger` checked only
+    // integrality, so `--limit 0`, a negative value, or anything above 200 reached the network
+    // call and was silently clamped server-side (convex/agentKnowledge/entriesByRole.ts:1-200
+    // range) to a page size the caller never asked for. Reject the advertised 1-200 range here,
+    // matching the MCP tool's own schema (packages/mcp-server/src/tools/role.ts), before the call.
+    if (range && (parsed < range.min || parsed > range.max)) {
+        throw validation(`${flag} must be between ${range.min} and ${range.max} (got ${parsed}).`, 'Usage: pb role accountable <role-id> [--limit <n>] [--cursor <n>]');
+    }
+    return parsed;
+}
+/** One row, terminal-safe. `name` is stored content any connector with write access can set —
+ *  sanitized for the same reason `outcome.ts`'s `formatReadingsList` sanitizes `note`/`valueText`:
+ *  this rendering is a plain-text sink, and an embedded newline would forge an extra row. */
+function formatRow(row) {
+    const id = row.entryId ?? row.id;
+    // PR #856 review round 3 (Codex P2, PRRT_kwDORS4ils6gQrZW): `chain.listByRole` deliberately
+    // includes each row's domain `workflowStatus` (convex/agentKnowledge/entriesByRole.ts:73-90)
+    // separately from `status` (the TRUST status, e.g. 'accepted') — a tension's `open` vs
+    // `closed` is exactly the distinction between a current obligation and a completed one.
+    // Dropping it here made both render identically as `[tension/accepted]`; render it, mirroring
+    // `packages/mcp-server/src/tools/entries.ts:697-700`'s existing formatter.
+    // PR #872 review round 3 (Codex P2): workflowStatus is stored content read from a workspace
+    // collection's `validWorkflowStatuses` declaration — vocabulary-checked by guardWorkflowStatus,
+    // never terminal-safety-checked, so a value containing a newline/control sequence could still
+    // forge an extra row. Sanitized the same way `row.name` already is.
+    const statusDisplay = row.workflowStatus ? `${row.status} / ${sanitizeSingleLineField(row.workflowStatus)}` : row.status;
+    // WP-771 S1b round 2 (Codex P2, PRRT_kwDORS4ils6lGWJ0): render the real collection slug,
+    // matching the MCP `role` tool's formatRow fixed this round — same sanitization, same '?'
+    // fallback for a row whose collection couldn't be resolved.
+    const collectionSlug = row.collectionSlug ? sanitizeSingleLineField(row.collectionSlug) : '?';
+    return `    ${id}  ${sanitizeSingleLineField(row.name)}  [${collectionSlug}/${statusDisplay}]`;
+}
+/** One labelled section — `explicit` or `reporting`. Empty prints the shared empty-state text
+ *  rather than an ambiguous blank, and a truncated page says so with an ACTIONABLE hint rather
+ *  than a vague "more exist" (review PRRT_kwDORS4ils6gQAqo, §13: cap every read AND surface
+ *  truncation to the caller — a claim of "continue with the printed cursor" that never printed
+ *  one is the failure this fixes). `cursorHint` is `undefined` for a section the gateway cannot
+ *  page (`reporting` — PR-1's own design: only `explicit` accepts a cursor) — that section
+ *  states the cap plainly instead of pointing at a flag that would silently be ignored. */
+function formatSection(label, rows, truncated, cursorHint) {
+    // PR #856 review round 3 (Codex P2, PRRT_kwDORS4ils6gQrY9): `canonicalKey` filtering can
+    // legitimately return `rows: []` with `truncated: true` and a usable cursor — the backend's
+    // raw scan window was exhausted without confirming no more matches exist beyond it
+    // (convex/agentKnowledge/entriesByRole.ts). Printing "not recorded yet" for that response
+    // falsely presents the role as having no matching entries at all and swallows the cursor that
+    // would let the caller keep looking. Check truncation BEFORE the empty-state early return.
+    if (rows.length === 0 && !truncated)
+        return [`  ${label}: not recorded yet`];
+    const lines = rows.length === 0 ? [`  ${label}: not recorded yet, but the scan is incomplete`] : [`  ${label}:`, ...rows.map(formatRow)];
+    // PR #872 review round 3 (Codex P2): `truncated` can be true purely because the raw scan
+    // budget (MAX_SCAN_BATCHES batches, entriesByRole.ts) was exhausted without confirming the
+    // true end of the index range — NOT because a filtered match beyond this page was actually
+    // found. "more exist" overclaimed a fact the backend never established; "scan incomplete"
+    // states only what is actually known (keep paging to find out), never asserts a match exists.
+    if (truncated)
+        lines.push(`    (scan incomplete, more may exist — ${cursorHint ?? 'raise --limit (capped at 200, no cursor for this list)'})`);
+    return lines;
+}
+/**
+ * Pretty rendering for `pb role accountable`. Exported so door-parity content-equality against
+ * the MCP tool's own rendering (`packages/mcp-server/src/tools/role.ts`) is assertable directly,
+ * not only through a live walk — both read the SAME `chain.listByRole` JSON shape and both print
+ * the SAME three sections in the SAME order.
+ */
+export function formatRoleAccountable(result) {
+    if (!result)
+        return 'Role not found.';
+    const roleLabel = `${sanitizeSingleLineField(result.role.name)} (${result.role.entryId ?? result.role.id})`;
+    // `explicit` is the only cursor-able list (PR-1's design) — print the REAL next cursor when
+    // truncated, never a bare claim that one exists.
+    const explicitCursorHint = result.nextCursor !== null
+        ? `raise --limit or continue with --cursor ${result.nextCursor}`
+        : 'raise --limit';
+    return [
+        `${roleLabel} — accountability:`,
+        ...formatHolders(result),
+        ...formatSection('explicit (owns)', result.explicit, result.explicitTruncated, explicitCursorHint),
+        ...formatSection('reporting (reports on)', result.reporting, result.reportingTruncated),
+        // DEC-1587 Team-Lead vacancy coverage — always not-computed today (see
+        // convex/agentKnowledge/entriesByRole.ts's own header for why); named, never faked as an
+        // empty computed list.
+        `  inherited: not-computed — ${result.inheritedNotComputedReason}`,
+    ].join('\n');
+}
+export async function runRoleAccountable(roleId, options) {
+    // Refuse everything refusable BEFORE the network call — same discipline outcome.ts's
+    // requireNumber and shape.ts's enum checks use.
+    const limit = options.limit !== undefined ? requireInteger(options.limit, '--limit', { min: 1, max: 200 }) : undefined;
+    const cursor = options.cursor !== undefined ? requireInteger(options.cursor, '--cursor') : undefined;
+    const config = await getConfigOrGuide(() => runRoleAccountable(roleId, options));
+    if (!config)
+        return;
+    await runCliCommand({
+        // A read: no session required, same posture as `pb outcome list`.
+        fn: async () => {
+            const raw = await kernelCall('chain.listByRole', {
+                roleId,
+                ...(options.canonicalKey ? { canonicalKey: options.canonicalKey } : {}),
+                ...(limit !== undefined ? { limit } : {}),
+                ...(cursor !== undefined ? { cursor } : {}),
+            });
+            return raw;
+        },
+        formatPretty: (value_) => formatRoleAccountable(value_),
+    });
+}
+const seatSentence = (action) => (result) => formatSeatSentence(action, result, sanitizeSingleLineField);
+export async function runRoleSeat(roleId, options) {
+    // Exactly one of an existing person or --new-person; refused before any network call.
+    if ((options.person === undefined) === (options.newPerson === undefined)) {
+        throw validation(options.person === undefined ? 'Say who to seat: --person <id-or-email>, or --new-person <name>.' : 'Give --person or --new-person, not both.', 'Usage: pb role seat <role-id> (--person <id-or-email> | --new-person <name>) [--team <team-id>]');
+    }
+    const config = await getConfigOrGuide(() => runRoleSeat(roleId, options));
+    if (!config)
+        return;
+    await runOrganisationWrite((context) => kernelCallWithSession('organisation.seatInRole', {
+        roleRef: roleId, targetPersonRef: options.person, newPersonName: options.newPerson, teamRef: options.team, sessionId: context.sessionId,
+    }), seatSentence('seat'));
+}
+export async function runRoleUnseat(roleId, options) {
+    const config = await getConfigOrGuide(() => runRoleUnseat(roleId, options));
+    if (!config)
+        return;
+    await runOrganisationWrite((context) => kernelCallWithSession('organisation.unseatFromRole', {
+        roleRef: roleId, targetPersonRef: options.person, teamRef: options.team, sessionId: context.sessionId,
+    }), seatSentence('unseat'));
+}
+//# sourceMappingURL=role.js.map

package/dist/commands/role.js.map

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

package/dist/commands/role.test.d.ts

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

package/dist/commands/role.test.d.ts.map

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

package/dist/commands/role.test.js

@@ -0,0 +1,290 @@
+/**
+ * WP-730 S2 — `pb role accountable <role-id>`.
+ *
+ * The surface is thin on purpose: every rule that matters (fail-closed roleId resolution,
+ * canonical-key restriction, the explicit/reporting split) lives behind the gateway and was
+ * proven in S1 (`convex/agentKnowledge/entriesByRole.ts`). What THIS slice can get wrong is the
+ * wire shape and the rendering — dropping a flag, or printing an empty section as a blank
+ * instead of the shared "not recorded yet" text.
+ */
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+const { getConfigOrGuide, kernelCall, kernelCallWithSession, runCliCommand, isJsonMode, readSession } = vi.hoisted(() => ({
+    getConfigOrGuide: vi.fn(),
+    kernelCall: vi.fn(),
+    kernelCallWithSession: vi.fn(),
+    runCliCommand: vi.fn(async ({ fn }) => fn()),
+    isJsonMode: vi.fn(() => false),
+    readSession: vi.fn(),
+}));
+vi.mock('../lib/config.js', () => ({ getConfigOrGuide }));
+vi.mock('../lib/client.js', () => ({ kernelCall, kernelCallWithSession }));
+vi.mock('../lib/runner.js', () => ({ runCliCommand, isJsonMode }));
+vi.mock('../lib/session.js', () => ({ readSession }));
+vi.mock('../lib/workspaceNotice.js', () => ({ emitEffectiveTenantNotice: vi.fn(async () => undefined) }));
+import { runRoleAccountable, runRoleSeat, runRoleUnseat, formatRoleAccountable } from './role.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
+const ROLE = { id: 'doc-role-1', entryId: 'ROL-2', name: 'Data Steward' };
+const OWNED = { id: 'doc-obj-1', entryId: 'OBJ-1', name: 'An owned objective', canonicalKey: 'objective', collectionSlug: 'objectives', status: 'accepted' };
+const REPORTED = { id: 'doc-kr-1', entryId: 'KR-1', name: 'A reported key result', canonicalKey: 'key_result', collectionSlug: 'key-results', status: 'accepted' };
+const emptyResult = {
+    role: ROLE,
+    explicit: [], explicitTruncated: false, nextCursor: null,
+    reporting: [], reportingTruncated: false,
+    inherited: [], inheritedResolution: 'not-computed',
+    inheritedNotComputedReason: 'What a Team Lead covers for its empty roles is not computed per role yet, so this list is never shown as empty.',
+    truncated: false,
+    holders: [],
+    holdersTruncated: false,
+};
+describe('pb role accountable', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        getConfigOrGuide.mockResolvedValue({ apiKey: 'pb_sk_test', siteUrl: 'https://example.test' });
+        kernelCall.mockResolvedValue(emptyResult);
+    });
+    it('calls chain.listByRole with roleId, no session required', async () => {
+        await runRoleAccountable('ROL-2', {});
+        expect(kernelCall).toHaveBeenCalledWith('chain.listByRole', { roleId: 'ROL-2' });
+    });
+    it('forwards canonicalKey, limit, and cursor only when supplied', async () => {
+        await runRoleAccountable('ROL-2', { canonicalKey: 'objective', limit: '5', cursor: '1700000000000' });
+        expect(kernelCall).toHaveBeenCalledWith('chain.listByRole', {
+            roleId: 'ROL-2', canonicalKey: 'objective', limit: 5, cursor: 1700000000000,
+        });
+    });
+    it('sends limit/cursor as NUMBERS, not the raw argv strings', async () => {
+        await runRoleAccountable('ROL-2', { limit: '5' });
+        const [, args] = kernelCall.mock.calls[0];
+        expect(args.limit).toBe(5);
+        expect(args.limit).not.toBe('5');
+    });
+    // PRRT_kwDORS4ils6gP8P9 (review): a non-numeric --limit/--cursor must refuse with
+    // CLIError/VALIDATION_FAILED (category: 'validation') BEFORE any network call — not fall
+    // through to runCliCommand's generic unknown-error wrap (code: INTERNAL), and never reach
+    // the gateway as `NaN` (which JSON.stringify silently turns into `null`).
+    it('refuses a non-numeric --limit with CLIError/VALIDATION_FAILED, before any network call', async () => {
+        await expect(runRoleAccountable('ROL-2', { limit: 'abc' })).rejects.toMatchObject({
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+        });
+        expect(kernelCall).not.toHaveBeenCalled();
+    });
+    it('refuses a non-numeric --cursor with CLIError/VALIDATION_FAILED, before any network call', async () => {
+        await expect(runRoleAccountable('ROL-2', { cursor: 'not-a-timestamp' })).rejects.toBeInstanceOf(CLIError);
+        expect(kernelCall).not.toHaveBeenCalled();
+    });
+    it('refuses a fractional --limit (not a whole number)', async () => {
+        await expect(runRoleAccountable('ROL-2', { limit: '1.5' })).rejects.toMatchObject({
+            code: ErrorCode.VALIDATION_FAILED,
+        });
+        expect(kernelCall).not.toHaveBeenCalled();
+    });
+    // PR #856 review round 3 (Codex P2, PRRT_kwDORS4ils6gQrZI): a whole number outside the
+    // advertised 1-200 range must be refused HERE, before the network call, not silently
+    // clamped server-side to a different page size than the caller asked for.
+    it.each(['0', '-1', '201'])('refuses --limit %s (outside the advertised 1-200 range)', async (limit) => {
+        await expect(runRoleAccountable('ROL-2', { limit })).rejects.toMatchObject({
+            code: ErrorCode.VALIDATION_FAILED,
+        });
+        expect(kernelCall).not.toHaveBeenCalled();
+    });
+    it('accepts the boundary values --limit 1 and --limit 200', async () => {
+        await runRoleAccountable('ROL-2', { limit: '1' });
+        await runRoleAccountable('ROL-2', { limit: '200' });
+        expect(kernelCall).toHaveBeenCalledTimes(2);
+    });
+});
+describe('formatRoleAccountable', () => {
+    it('prints "not recorded yet" for an empty explicit and reporting section', () => {
+        const text = formatRoleAccountable(emptyResult);
+        expect(text).toContain('explicit (owns): not recorded yet');
+        expect(text).toContain('reporting (reports on): not recorded yet');
+    });
+    it('lists explicit and reporting rows separately, never merged', () => {
+        const text = formatRoleAccountable({
+            ...emptyResult,
+            explicit: [OWNED], reporting: [REPORTED],
+        });
+        expect(text).toContain('explicit (owns):');
+        expect(text).toContain('OBJ-1');
+        expect(text).toContain('reporting (reports on):');
+        expect(text).toContain('KR-1');
+        // Never merged: OBJ-1 must not appear in the reporting section's own lines.
+        const reportingSection = text.split('reporting (reports on):')[1] ?? '';
+        expect(reportingSection).not.toContain('OBJ-1');
+    });
+    it('names the holders, tagging a placeholder or invited holder with that word (TASK-636)', () => {
+        expect(formatRoleAccountable(emptyResult)).toContain('holders: none');
+        const text = formatRoleAccountable({
+            ...emptyResult,
+            holders: [
+                { personId: 'p1', displayName: 'Ann', status: 'active', teamName: 'Core' },
+                { personId: 'p2', displayName: 'Jan Jansen', status: 'placeholder', teamName: 'Core' },
+                { personId: 'p3', displayName: 'Mathijs', status: 'invited', teamName: null },
+            ],
+        });
+        expect(text).toContain('    Ann  in Core');
+        expect(text).toContain('    Jan Jansen (placeholder)  in Core');
+        expect(text).toContain('    Mathijs (invited)');
+    });
+    it('always reports inherited as not-computed, with the reason, never faked as empty', () => {
+        const text = formatRoleAccountable(emptyResult);
+        expect(text).toContain('inherited: not-computed');
+        expect(text).toContain(emptyResult.inheritedNotComputedReason);
+    });
+    it('notes truncation on the relevant section only', () => {
+        const text = formatRoleAccountable({ ...emptyResult, explicit: [OWNED], explicitTruncated: true });
+        const explicitSection = text.split('reporting (reports on):')[0] ?? '';
+        expect(explicitSection).toContain('scan incomplete, more may exist');
+    });
+    // PRRT_kwDORS4ils6gQAqo (review): the truncation hint used to CLAIM a cursor was printed
+    // without ever printing one. `nextCursor` must actually appear so a caller (human or agent)
+    // can literally copy it into --cursor.
+    it('renders the REAL nextCursor value when explicit is truncated, not just a bare claim', () => {
+        const text = formatRoleAccountable({
+            ...emptyResult, explicit: [OWNED], explicitTruncated: true, nextCursor: 1700000000000,
+        });
+        expect(text).toContain('--cursor 1700000000000');
+    });
+    // reporting has no cursor support (PR-1's own design — only `explicit` accepts one). A
+    // truncated reporting page must say so plainly, never point at a flag the gateway ignores.
+    it('states plainly that reporting has NO cursor when truncated, never a fake cursor hint', () => {
+        const text = formatRoleAccountable({
+            ...emptyResult, reporting: [REPORTED], reportingTruncated: true,
+        });
+        const reportingSection = text.split('reporting (reports on):')[1] ?? '';
+        expect(reportingSection).toContain('no cursor');
+        expect(reportingSection).not.toContain('--cursor');
+    });
+    it('returns "Role not found." for a null result', () => {
+        expect(formatRoleAccountable(null)).toBe('Role not found.');
+    });
+    // PR #856 review round 3 (Codex P2, PRRT_kwDORS4ils6gQrY9): an empty-but-truncated response
+    // (canonicalKey narrowing filtered out every row on this page, but the scan is incomplete and
+    // a real cursor exists) must never print the plain "not recorded yet" empty state — that
+    // swallows the cursor and falsely claims the role has no matching entries at all.
+    it('shows truncation and the cursor even when the page is empty (empty-but-truncated)', () => {
+        const text = formatRoleAccountable({
+            ...emptyResult, explicit: [], explicitTruncated: true, nextCursor: 1700000000000,
+        });
+        const explicitSection = text.split('reporting (reports on):')[0] ?? '';
+        expect(explicitSection).not.toContain('explicit (owns): not recorded yet\n');
+        expect(explicitSection).toContain('--cursor 1700000000000');
+    });
+    // PR #856 review round 3 (Codex P2, PRRT_kwDORS4ils6gQrZW): a tension's domain workflowStatus
+    // (open/closed) must render distinctly from its trust status, or two very different rows both
+    // print as `[tension/accepted]`.
+    it('renders the workflow status carried by a row, distinguishing open from closed', () => {
+        const openTension = { id: 'doc-ten-1', entryId: 'TEN-1', name: 'An open tension', canonicalKey: 'tension', collectionSlug: 'tensions', status: 'accepted', workflowStatus: 'open' };
+        const closedTension = { id: 'doc-ten-2', entryId: 'TEN-2', name: 'A closed tension', canonicalKey: 'tension', collectionSlug: 'tensions', status: 'accepted', workflowStatus: 'closed' };
+        const text = formatRoleAccountable({ ...emptyResult, explicit: [openTension, closedTension] });
+        expect(text).toContain('[tensions/accepted / open]');
+        expect(text).toContain('[tensions/accepted / closed]');
+    });
+    // WP-771 S1b round 2 (Codex P2, PRRT_kwDORS4ils6lGWJ0): the bracket must show the real
+    // collection slug, not canonicalKey (the semantic type) — door parity with the MCP `role`
+    // tool's own formatRow fix this round (packages/mcp-server/src/tools/role.ts), and with
+    // `pb get`'s own bracket fix (packages/cli/src/formatters/entry.ts).
+    it("prints the row's collectionSlug in the bracket, never canonicalKey", () => {
+        const text = formatRoleAccountable({ ...emptyResult, explicit: [OWNED] });
+        expect(text).toContain('[objectives/accepted]');
+        expect(text).not.toContain('[objective/accepted]');
+    });
+    it('falls back to "?" when a row has no collectionSlug', () => {
+        const rowWithoutSlug = { id: 'doc-obj-2', entryId: 'OBJ-2', name: 'Unresolved', canonicalKey: 'objective', status: 'accepted' };
+        const text = formatRoleAccountable({ ...emptyResult, explicit: [rowWithoutSlug] });
+        expect(text).toContain('[?/accepted]');
+    });
+    // WP-771 S1b round 2 (Codex P2, PRRT_kwDORS4ils6lGWJs class): a collectionSlug with an
+    // embedded newline must not forge an extra row, same treatment as name/workflowStatus above.
+    it('sanitizes an embedded newline in collectionSlug instead of forging an extra row', () => {
+        const evilRow = { ...OWNED, collectionSlug: 'objectives\nFAKE ROW: nothing to see here' };
+        const text = formatRoleAccountable({ ...emptyResult, explicit: [evilRow] });
+        expect(text.split('\n')).not.toContain('    FAKE ROW: nothing to see here');
+        expect(text).toContain('objectives FAKE ROW: nothing to see here');
+    });
+    // PR #872 review round 3 (Codex P2): workflowStatus is stored content (a workspace
+    // collection's validWorkflowStatuses declaration), vocabulary-checked but never
+    // terminal-safety-checked — an embedded newline must not forge an extra row.
+    it('sanitizes an embedded newline in workflowStatus instead of forging an extra row', () => {
+        const evilRow = { id: 'doc-ten-1', entryId: 'TEN-1', name: 'A tension', canonicalKey: 'tension', status: 'accepted', workflowStatus: 'open\nFAKE ROW: nothing to see here' };
+        const text = formatRoleAccountable({ ...emptyResult, explicit: [evilRow] });
+        expect(text.split('\n')).not.toContain('    FAKE ROW: nothing to see here');
+        expect(text).toContain('open FAKE ROW: nothing to see here');
+    });
+});
+// TASK-633 S3c (WP-808, DEC-1954): `pb role seat` / `pb role unseat` call the same kernel doors as the
+// MCP role tool and print the same sentence (packages/mcp-server/src/tools/__tests__/role.test.ts).
+describe('pb role seat / unseat', () => {
+    const seated = {
+        outcome: 'applied', operation: 'role.seat', created: true, person: 'Jan Jansen', personId: 'p1', personStatus: 'placeholder',
+        role: 'ROL-8', roleName: 'Product Analyst', team: 'TEAM-1', teamName: 'Product',
+    };
+    let printed;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        getConfigOrGuide.mockResolvedValue({ apiKey: 'pb_sk_test', siteUrl: 'https://example.test' });
+        readSession.mockReturnValue({ sessionId: 'sess-1' });
+        isJsonMode.mockReturnValue(false);
+        printed = [];
+        vi.spyOn(process.stdout, 'write').mockImplementation((chunk) => { printed.push(String(chunk)); return true; });
+    });
+    it('seat: a new person by name calls organisation.seatInRole with the session and prints who was seated as what', async () => {
+        kernelCallWithSession.mockResolvedValue(seated);
+        await runRoleSeat('ROL-8', { newPerson: 'Jan Jansen' });
+        expect(kernelCallWithSession).toHaveBeenCalledWith('organisation.seatInRole', {
+            roleRef: 'ROL-8', targetPersonRef: undefined, newPersonName: 'Jan Jansen', teamRef: undefined, sessionId: 'sess-1',
+        });
+        expect(printed.join('')).toBe('Seated Jan Jansen (placeholder) [p1] as Product Analyst (ROL-8) in Product.\n');
+    });
+    it('seat: the same placeholder again reads as confirmed (the kernel reuses the person by exact name)', async () => {
+        kernelCallWithSession.mockResolvedValue({ ...seated, created: false });
+        await runRoleSeat('ROL-8', { newPerson: 'Jan Jansen' });
+        expect(printed.join('')).toBe('Confirmed Jan Jansen (placeholder) [p1] as Product Analyst (ROL-8) in Product.\n');
+    });
+    it('seat: an existing person with --team (Team Lead) forwards the team, and an active person carries no status tag', async () => {
+        kernelCallWithSession.mockResolvedValue({ ...seated, created: false, person: 'Ada', personStatus: 'active', roleName: 'Team Lead', role: 'ROL-1' });
+        await runRoleSeat('ROL-1', { person: 'ada@example.test', team: 'TEAM-1' });
+        expect(kernelCallWithSession).toHaveBeenCalledWith('organisation.seatInRole', expect.objectContaining({ roleRef: 'ROL-1', targetPersonRef: 'ada@example.test', teamRef: 'TEAM-1' }));
+        expect(printed.join('')).toBe('Confirmed Ada [p1] as Team Lead (ROL-1) in Product.\n');
+    });
+    it('seat: refuses both or neither person before any call', async () => {
+        await expect(runRoleSeat('ROL-8', { person: 'p1', newPerson: 'Jan' })).rejects.toThrow('not both');
+        await expect(runRoleSeat('ROL-8', {})).rejects.toMatchObject({ code: ErrorCode.VALIDATION_FAILED, message: expect.stringContaining('Say who to seat') });
+        expect(kernelCallWithSession).not.toHaveBeenCalled();
+    });
+    it('seat: a kernel refusal fails the command with its reason, and the required action as guidance', async () => {
+        kernelCallWithSession.mockResolvedValue({ outcome: 'refused', refusal: { code: 'team_lead_required', reason: "Only the team's Team Lead can change its seats.", requiredAction: 'Ask the Team Lead.' } });
+        await expect(runRoleSeat('ROL-8', { person: 'p1' })).rejects.toMatchObject({
+            message: "Only the team's Team Lead can change its seats.", code: ErrorCode.AUTH_DENIED, guidance: 'Ask the Team Lead.',
+        });
+        expect(printed.join('')).toBe('');
+    });
+    it('seat and unseat refuse without an active session, before any call', async () => {
+        readSession.mockReturnValue(null);
+        await expect(runRoleSeat('ROL-8', { person: 'p1' })).rejects.toThrow('No active session');
+        await expect(runRoleUnseat('ROL-8', { person: 'p1' })).rejects.toThrow('No active session');
+        expect(kernelCallWithSession).not.toHaveBeenCalled();
+    });
+    it('unseat: calls organisation.unseatFromRole and says who lost which role, or that nothing changed', async () => {
+        kernelCallWithSession.mockResolvedValue({ ...seated, operation: 'role.unseat', removed: true, personStatus: undefined });
+        await runRoleUnseat('ROL-8', { person: 'p1' });
+        expect(kernelCallWithSession).toHaveBeenCalledWith('organisation.unseatFromRole', { roleRef: 'ROL-8', targetPersonRef: 'p1', teamRef: undefined, sessionId: 'sess-1' });
+        kernelCallWithSession.mockResolvedValue({ ...seated, operation: 'role.unseat', removed: false, personStatus: undefined });
+        await runRoleUnseat('ROL-8', { person: 'p1' });
+        expect(printed.join('')).toBe('Unseated Jan Jansen from Product Analyst (ROL-8) in Product.\nJan Jansen did not hold Product Analyst (ROL-8) in Product; nothing changed.\n');
+    });
+    it('unseat: the last active Team Lead refusal is a validation failure naming the reason', async () => {
+        kernelCallWithSession.mockResolvedValue({ outcome: 'refused', refusal: { code: 'last_team_lead', reason: 'Product needs an active Team Lead.' } });
+        await expect(runRoleUnseat('ROL-1', { person: 'p1', team: 'TEAM-1' })).rejects.toMatchObject({
+            message: 'Product needs an active Team Lead.', code: ErrorCode.VALIDATION_FAILED,
+        });
+    });
+    it('--json prints the kernel result as it came', async () => {
+        isJsonMode.mockReturnValue(true);
+        kernelCallWithSession.mockResolvedValue(seated);
+        await runRoleSeat('ROL-8', { newPerson: 'Jan Jansen' });
+        expect(JSON.parse(printed.join(''))).toEqual(seated);
+    });
+});
+//# sourceMappingURL=role.test.js.map

package/dist/commands/role.test.js.map

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

package/dist/commands/scoreboard.d.ts

@@ -0,0 +1,26 @@
+/**
+ * pb scoreboard — the AGENT-PRIMARY flywheel scoreboard surface (spec §2d).
+ *
+ * The point of this board is NOT a dashboard a human watches — it is telemetry the AGENT reads
+ * to track the flywheel, diagnose what's degrading, and drive the fix without the human looking.
+ * So:
+ *   - `--json`: emits the structured M3/M4/materialization payload (from the ONE internal
+ *     `scoreboard` action, via the AKI `scoreboard.get` route) PLUS the diagnosis layer (A4) and
+ *     the CLI-computed M5 local-pull drift (A5). This is the agent's structured consumption shape.
+ *   - pretty: a compact human-readable board with per-metric status + next action.
+ *
+ * The diagnosis layer is honest by design: unpinned-threshold flips render `awaiting` (never an
+ * invented number), M4 is a standing `awaiting` tile (deferred, TEN-2433), and coaching/moat
+ * quality is a standing `unmeasured` line (TEN-2377) so four green tiles ≠ a healthy moat.
+ */
+import { type ScoreboardPayload, type ScoreboardDiagnosis } from '../scoreboard/diagnose.js';
+import type { LocalDriftM5 } from '../scoreboard/diagnose.js';
+/** The full structured shape `pb scoreboard --json` emits (agent consumption surface). */
+export interface ScoreboardCliView {
+    payload: ScoreboardPayload;
+    /** M5 local-pull drift — computed at the CLI (DEC-1284), NOT in the data payload. */
+    localDrift: LocalDriftM5;
+    diagnosis: ScoreboardDiagnosis;
+}
+export declare function runScoreboard(): Promise<void>;
+//# sourceMappingURL=scoreboard.d.ts.map

package/dist/commands/scoreboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoreboard.d.ts","sourceRoot":"","sources":["../../src/commands/scoreboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,EAAY,KAAK,iBAAiB,EAAE,KAAK,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEvG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D,0FAA0F;AAC1F,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,qFAAqF;IACrF,UAAU,EAAE,YAAY,CAAC;IACzB,SAAS,EAAE,mBAAmB,CAAC;CAChC;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAiBnD"}