@productbrain/cli 0.1.0-beta.66 → 0.1.0-beta.6606

package/dist/commands/questions.js

@@ -0,0 +1,318 @@
+import { Command } from 'commander';
+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 { readSession } from '../lib/session.js';
+import { formatQuestionCreate, formatQuestionAdopt, formatQuestionAssignConfirm, formatQuestionAssignReassign, formatQuestionSnooze, formatQuestionDecline, formatQuestionAnswer, formatQuestionForceClose, formatQuestionList, } from '../formatters/questions.js';
+/**
+ * `pb question` — routed-questions connector surface (WP-638 S3/S4, §4.4 of the routed-questions
+ * design spec: docs/superpowers/specs/2026-08-10-routed-questions-design.md). Modeled on
+ * `conflicts.ts`'s read/write split: every write verb is session-attributed
+ * (kernelCallWithSession + a session gate, matching conflicts.resolve/shape.agree); `list`
+ * (WP-638 S4, §4.1's slice-boundary fix) is a plain read (`kernelCall`, no session gate) over
+ * its own read model (ackGateFacts.ts) — the same split `conflicts.list` uses.
+ *
+ * A "why it matters" tip (§3.3): a question created/adopted below the 80-char nudge threshold
+ * already carries the nudge text in the mutation's own return — appended verbatim, never
+ * reworded here.
+ */
+function requireQuestionSession() {
+    const session = readSession();
+    if (!session) {
+        throw new CLIError('No active session.', {
+            code: ErrorCode.SESSION_REQUIRED,
+            category: 'session',
+            guidance: 'Run `pb session start` before acting on a routed question.',
+        });
+    }
+    return session;
+}
+// ─── Human-id resolution (R43) ──────────────────────────────────────────────────────────────
+// The question write verbs declare entryId/toRoleId as v.id('entries') — a raw Convex doc id,
+// never a string parser of their own. `chain.getEntry` is the real, already-registered
+// gateway route that resolves either form (STD-102) — this command routes through it instead
+// of inventing a private parser, satisfying R43 without touching the verbs' argument shapes.
+const HUMAN_ID_PATTERN = /^[A-Za-z]+-\d+$/;
+async function resolveEntryRef(raw, label) {
+    if (!HUMAN_ID_PATTERN.test(raw))
+        return raw;
+    const entry = await kernelCall('chain.getEntry', { entryId: raw });
+    if (!entry) {
+        throw new CLIError(`${label} '${raw}' not found.`, {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+            guidance: 'Check the id — this workspace has no entry matching it.',
+        });
+    }
+    return entry._id;
+}
+// `chain.getEntry`'s `id` param is `v.id('entries')` — it can resolve a role/domain id (both
+// live in `entries`) but NOT a `people`-table id (e.g. `askerPersonId`, `ownerPersonId`), which
+// throws an ArgumentValidationError. Caught here so a name-resolution failure (wrong table, or
+// any other lookup miss) never breaks the write confirmation it decorates — degrades to the raw
+// id/undefined, never a crash. Bug found live (S3 build's own live-proof run against the seeded
+// preview): the first `answer` proof call surfaced exactly this cross-table mismatch.
+async function displayName(id) {
+    if (!id)
+        return undefined;
+    try {
+        const entry = await kernelCall('chain.getEntry', { id });
+        return entry?.name;
+    }
+    catch {
+        return undefined;
+    }
+}
+// WP-747: create/adopt need to tell "nobody owns this yet" (no id at all -> 'someone') apart from
+// "a role was routed to but its lookup failed or returned no name" (a PRESENT id `displayName`
+// still degrades to undefined for, per its own bare catch above — kept as-is, other callers below
+// rely on that same degrade-to-undefined shape). Falling through to the raw document id or the
+// SAME 'someone' string in the second case is indistinguishable from "no owner" — the four-states
+// defect this fixes (design spec §5).
+// Exported for a direct unit test (late review, PR #907 done-audit) — the CLI twin of
+// unresolvableRoleFallback below is otherwise reachable only through the full create/adopt
+// command plumbing, which the test harness's runCliCommand mock does not render through.
+export async function displayRoleOrLeadName(id) {
+    if (!id)
+        return 'someone';
+    // Review round 1 (PR #905): a NOUN PHRASE, not a full clause — every caller interpolates this
+    // after "suggested to " / "gone to ", so a sentence here reads "suggested to routed to a role…".
+    return (await displayName(id)) ?? `an unresolved role (\`${id}\` — reassign it)`;
+}
+// The role/team-lead NAME needed for §7.7's confirmation string requires a second read
+// (chain.getEntry) after the write. PRRT_kwDORS4ils6YnqKe (round 2): runCliCommand's JSON mode
+// serializes whatever fn() RETURNS, so bundling the resolved name into that return value
+// (the earlier shape) leaked a `{result, roleOrLeadName}` wrapper into JSON-mode/scripted
+// output instead of the flat mutation result. Fixed the way formatters/shape.ts's own
+// `truncated` aux state does it: a closure variable OUTSIDE runCliCommand, set inside fn(),
+// read by formatPretty — fn() returns ONLY the real result.
+export async function runQuestionCreateVerb(text, options) {
+    const config = await getConfigOrGuide(() => runQuestionCreateVerb(text, options));
+    if (!config)
+        return;
+    const session = requireQuestionSession(); // WP-753 O1c: routes from this session's acting role's team
+    let roleOrLeadName = 'someone';
+    await runCliCommand({
+        fn: async () => {
+            const resolvedBlocks = options.blocks ? await Promise.all(options.blocks.map((b) => resolveEntryRef(b, 'Blocked entry'))) : undefined;
+            const result = await kernelCallWithSession('question.create', {
+                text,
+                domainSlug: options.domain,
+                blocks: resolvedBlocks,
+                sessionId: session.sessionId,
+            });
+            roleOrLeadName = await displayRoleOrLeadName(result.suggestedRoleId ?? result.ownerRoleId);
+            return result;
+        },
+        formatPretty: (result) => formatQuestionCreate(result, roleOrLeadName),
+    });
+}
+export async function runQuestionAdopt(entryId, options) {
+    const config = await getConfigOrGuide(() => runQuestionAdopt(entryId, options));
+    if (!config)
+        return;
+    const session = requireQuestionSession(); // WP-753 O1c: routes from this session's acting role's team
+    let roleOrLeadName = 'someone';
+    await runCliCommand({
+        fn: async () => {
+            const resolvedEntryId = await resolveEntryRef(entryId, 'Entry');
+            const resolvedBlocks = options.blocks ? await Promise.all(options.blocks.map((b) => resolveEntryRef(b, 'Blocked entry'))) : undefined;
+            const result = await kernelCallWithSession('question.adopt', {
+                entryId: resolvedEntryId,
+                domainSlug: options.domain,
+                blocks: resolvedBlocks,
+                sessionId: session.sessionId,
+            });
+            roleOrLeadName = await displayRoleOrLeadName(result.suggestedRoleId ?? result.ownerRoleId);
+            return result;
+        },
+        formatPretty: (result) => formatQuestionAdopt(result, roleOrLeadName),
+    });
+}
+export async function runQuestionAssign(entryId, options) {
+    const config = await getConfigOrGuide(() => runQuestionAssign(entryId, options));
+    if (!config)
+        return;
+    requireQuestionSession();
+    const isReassign = Boolean(options.toRole || options.toPerson);
+    let targetName;
+    await runCliCommand({
+        fn: async () => {
+            const resolvedEntryId = await resolveEntryRef(entryId, 'Entry');
+            const resolvedToRoleId = options.toRole ? await resolveEntryRef(options.toRole, 'Role') : undefined;
+            const result = await kernelCallWithSession('question.assign', {
+                entryId: resolvedEntryId,
+                toRoleId: resolvedToRoleId,
+                toPersonId: options.toPerson,
+            });
+            // PRRT_kwDORS4ils6YnqKM (round 2): people are a separate table from entries —
+            // chain.getEntry cannot resolve a personId (throws ArgumentValidationError, caught by
+            // displayName() below and degraded to undefined). The mutation already resolves the
+            // person server-side (a plain ctx.db.get) when --to-person names one — prefer that
+            // real name over a client-side lookup that structurally cannot succeed for a person.
+            targetName = options.toPerson ? (result.ownerPersonName ?? result.ownerPersonId) : ((await displayName(result.ownerRoleId)) ?? result.ownerRoleId);
+            return result;
+        },
+        formatPretty: () => (isReassign ? formatQuestionAssignReassign(entryId, targetName ?? 'the target') : formatQuestionAssignConfirm(entryId)),
+    });
+}
+// ─── snooze ──────────────────────────────────────────────────────────────────────────────────
+export async function runQuestionSnooze(entryId) {
+    const config = await getConfigOrGuide(() => runQuestionSnooze(entryId));
+    if (!config)
+        return;
+    requireQuestionSession();
+    let leadName;
+    await runCliCommand({
+        fn: async () => {
+            const resolvedEntryId = await resolveEntryRef(entryId, 'Entry');
+            const result = await kernelCallWithSession('question.snooze', { entryId: resolvedEntryId });
+            leadName = result.status === 'escalated' ? await displayName(result.ownerRoleId) : undefined;
+            return result;
+        },
+        formatPretty: (result) => formatQuestionSnooze(result, leadName),
+    });
+}
+// ─── decline ─────────────────────────────────────────────────────────────────────────────────
+export async function runQuestionDecline(entryId, options) {
+    if (!options.reason?.trim()) {
+        throw new CLIError('A reason is required — say why it isn\'t yours (or why you\'re declining it).', {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+            guidance: 'Pass --reason "<why>".',
+        });
+    }
+    const config = await getConfigOrGuide(() => runQuestionDecline(entryId, options));
+    if (!config)
+        return;
+    requireQuestionSession();
+    let roleOrLeadName;
+    await runCliCommand({
+        fn: async () => {
+            const resolvedEntryId = await resolveEntryRef(entryId, 'Entry');
+            const result = await kernelCallWithSession('question.decline', {
+                entryId: resolvedEntryId,
+                reason: options.reason,
+            });
+            roleOrLeadName = await displayName(result.suggestedRoleId ?? result.ownerRoleId);
+            return result;
+        },
+        formatPretty: (result) => formatQuestionDecline(entryId, result, roleOrLeadName),
+    });
+}
+export async function runQuestionAnswer(entryId, text, options) {
+    // §7.7's two distinct declared refusal strings — matches the MCP tool's equivalent
+    // tool-boundary check (packages/mcp-server/src/tools/question.ts's handleQuestionAnswer).
+    if (text === undefined && options.entry === undefined) {
+        throw new CLIError('Give the answer as text, or point at an entry with --entry <id>.', {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+            guidance: 'pb question answer <id> "<text>"  OR  pb question answer <id> --entry <entryId>',
+        });
+    }
+    if (text !== undefined && options.entry !== undefined) {
+        throw new CLIError('Use either answer text or --entry, not both.', {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+            guidance: 'pb question answer <id> "<text>"  OR  pb question answer <id> --entry <entryId>',
+        });
+    }
+    const config = await getConfigOrGuide(() => runQuestionAnswer(entryId, text, options));
+    if (!config)
+        return;
+    requireQuestionSession();
+    await runCliCommand({
+        fn: async () => {
+            const resolvedEntryId = await resolveEntryRef(entryId, 'Entry');
+            const resolvedAnswerEntryId = options.entry ? await resolveEntryRef(options.entry, 'Answer entry') : undefined;
+            // PRRT_kwDORS4ils6YnqKM (round 2): the mutation already resolves the asker's display
+            // name server-side (answerCore does a plain ctx.db.get on facet.createdByPersonId) —
+            // no client-side people lookup is attempted (chain.getEntry cannot reach the people
+            // table at all, unlike the role/domain lookups elsewhere in this file).
+            return await kernelCallWithSession('question.answer', {
+                entryId: resolvedEntryId,
+                text,
+                answerEntryId: resolvedAnswerEntryId,
+            });
+        },
+        formatPretty: (result) => formatQuestionAnswer(entryId, result, result.askerName),
+    });
+}
+// ─── force-close ─────────────────────────────────────────────────────────────────────────────
+export async function runQuestionForceClose(entryId, options) {
+    if (!options.reason?.trim()) {
+        throw new CLIError('A reason is required to force-close a question.', {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+            guidance: 'Pass --reason "<why>".',
+        });
+    }
+    const config = await getConfigOrGuide(() => runQuestionForceClose(entryId, options));
+    if (!config)
+        return;
+    requireQuestionSession();
+    await runCliCommand({
+        fn: async () => {
+            const resolvedEntryId = await resolveEntryRef(entryId, 'Entry');
+            return kernelCallWithSession('question.forceClose', {
+                entryId: resolvedEntryId,
+                reason: options.reason,
+            });
+        },
+        formatPretty: (result) => formatQuestionForceClose(entryId, result),
+    });
+}
+export async function runQuestionList(options) {
+    const config = await getConfigOrGuide(() => runQuestionList(options));
+    if (!config)
+        return;
+    await runCliCommand({
+        fn: async () => (await kernelCall('question.list', { mine: options.mine })),
+        formatPretty: (result) => formatQuestionList(result, Boolean(options.mine)),
+    });
+}
+// ─── command registration ────────────────────────────────────────────────────────────────────
+export function createQuestionCommand() {
+    const command = new Command('question').description('Routed questions (WP-638) — a question with no owner routes itself: to the owning role when clear, to the team lead when ambiguous, up the chain until someone owns it. ' +
+        'Domains are discovered by using this tool (an unresolvable --domain refusal lists the real slugs — never hardcoded). ' +
+        'adopt attaches routing to an existing tension or repairs a facet-less question — create is the birth path. ' +
+        '`--blocks <entry-id>` (repeatable, on create/adopt) records what a question is holding up. ' +
+        '`list` shows what you owe; `list --mine` shows every question you asked, including closed ones, with its outcome.');
+    command.command('create <text>')
+        .description('Create a new routed question from text')
+        .option('--domain <slug>', 'Domain slug (see the refusal for the live list if omitted/unknown)')
+        .option('--blocks <entryId...>', 'Entry ids this question is blocking (repeatable)')
+        .action(runQuestionCreateVerb);
+    command.command('adopt <entry-id>')
+        .description('Attach routing to a tension already captured (e.g. via `pb capture "TEN: ..."`)')
+        .option('--domain <slug>', 'Domain slug (see the refusal for the live list if omitted/unknown)')
+        .option('--blocks <entryId...>', 'Entry ids this question is blocking (repeatable)')
+        .action(runQuestionAdopt);
+    command.command('assign <id>')
+        .description('Confirm ("take it", no flags) or reassign (--to-role/--to-person) ownership')
+        .option('--to-role <roleId>', 'Reassign to this role (human ROL-nnn form or a raw entry id)')
+        .option('--to-person <personId>', 'Reassign to this person')
+        .action((entryId, opts) => runQuestionAssign(entryId, opts));
+    command.command('snooze <id>')
+        .description('Defer a routed/escalated question (max 2, then it escalates to the team lead)')
+        .action(runQuestionSnooze);
+    command.command('decline <id>')
+        .description('Pass on a suggested question (never closes it), or — as owner/team lead — decline an owned one')
+        .requiredOption('--reason <reason>', 'Why it isn\'t yours, or why you\'re declining it')
+        .action((entryId, opts) => runQuestionDecline(entryId, opts));
+    command.command('answer <id> [text]')
+        .description('Close the loop — creates the answering entry itself unless --entry is given')
+        .option('--entry <entryId>', 'Point at an already-written entry instead of supplying text')
+        .action((entryId, text, opts) => runQuestionAnswer(entryId, text, opts));
+    command.command('force-close <id>')
+        .description('Team-Lead-only escape hatch for a question that cannot otherwise be resolved')
+        .requiredOption('--reason <reason>', 'Why this is being force-closed')
+        .action((entryId, opts) => runQuestionForceClose(entryId, opts));
+    command.command('list')
+        .description('List open questions you owe (or, with --mine, every question you asked, including closed ones)')
+        .option('--mine', 'Show every question you asked, including closed ones, with its outcome')
+        .action((opts) => runQuestionList(opts));
+    return command;
+}
+//# sourceMappingURL=questions.js.map

package/dist/commands/questions.js.map

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

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

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

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

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

package/dist/commands/questions.test.js

@@ -0,0 +1,186 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+const { getConfigOrGuide, kernelCall, kernelCallWithSession, readSession, runCliCommand } = vi.hoisted(() => ({
+    getConfigOrGuide: vi.fn(),
+    kernelCall: vi.fn(),
+    kernelCallWithSession: vi.fn(),
+    readSession: vi.fn(),
+    runCliCommand: vi.fn(async ({ fn }) => fn()),
+}));
+vi.mock('../lib/config.js', () => ({ getConfigOrGuide }));
+vi.mock('../lib/client.js', () => ({ kernelCall, kernelCallWithSession }));
+vi.mock('../lib/runner.js', () => ({ runCliCommand }));
+vi.mock('../lib/session.js', () => ({ readSession }));
+import { createQuestionCommand, runQuestionCreateVerb, runQuestionAdopt, runQuestionAssign, runQuestionSnooze, runQuestionDecline, runQuestionAnswer, runQuestionForceClose, displayRoleOrLeadName, } from './questions.js';
+/**
+ * `pb question` command surface tests (WP-638 S3). Mirrors commands/shape.test.ts's shape:
+ * every verb here is a workspace WRITE (session-attributed, kernelCallWithSession), and
+ * human-id (TEN-nnn) args are resolved via `chain.getEntry` (a plain read, kernelCall) before
+ * the write — the R43 resolution layer this file builds instead of a private parser.
+ */
+describe('pb question command surface (WP-638 S3)', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        getConfigOrGuide.mockResolvedValue({ apiKey: 'pb_sk_test', siteUrl: 'https://example.test' });
+        readSession.mockReturnValue({ sessionId: 'session-1' });
+        // Default: chain.getEntry resolves any human id to itself as _id — tests that need a
+        // DIFFERENT resolved doc id override with mockResolvedValueOnce.
+        kernelCall.mockImplementation(async (_fn, args) => ({ _id: args.entryId ?? args.id }));
+        kernelCallWithSession.mockResolvedValue({ entryId: 'TEN-100', facetId: 'facet-1', status: 'unrouted', routingReason: 'single_domain_owner', domainSlugs: [] });
+    });
+    // WP-638 S4 ships `list` (§4.1's slice-boundary fix) — the S3-era placeholder asserting its
+    // absence is retired in favor of the real, now-complete eight-command surface.
+    it('exposes all seven write subcommands plus `list` (WP-638 S4)', () => {
+        const command = createQuestionCommand();
+        const names = command.commands.map((item) => item.name());
+        expect(names).toEqual(['create', 'adopt', 'assign', 'snooze', 'decline', 'answer', 'force-close', 'list']);
+    });
+    it('requires an active session before every write verb (workspace write, session-attributed)', async () => {
+        readSession.mockReturnValue(null);
+        await expect(runQuestionCreateVerb('a question', {})).rejects.toMatchObject({ code: 'SESSION_REQUIRED' });
+        await expect(runQuestionAdopt('TEN-1', {})).rejects.toMatchObject({ code: 'SESSION_REQUIRED' });
+        await expect(runQuestionAssign('TEN-1', {})).rejects.toMatchObject({ code: 'SESSION_REQUIRED' });
+        await expect(runQuestionSnooze('TEN-1')).rejects.toMatchObject({ code: 'SESSION_REQUIRED' });
+        await expect(runQuestionDecline('TEN-1', { reason: 'not mine' })).rejects.toMatchObject({ code: 'SESSION_REQUIRED' });
+        await expect(runQuestionAnswer('TEN-1', 'the answer', {})).rejects.toMatchObject({ code: 'SESSION_REQUIRED' });
+        await expect(runQuestionForceClose('TEN-1', { reason: 'stuck' })).rejects.toMatchObject({ code: 'SESSION_REQUIRED' });
+        expect(kernelCallWithSession).not.toHaveBeenCalled();
+    });
+    it('create: sends text/domainSlug/blocks straight through when no --blocks are human ids', async () => {
+        await runQuestionCreateVerb('a question', { domain: 'delivery' });
+        expect(kernelCallWithSession).toHaveBeenCalledWith('question.create', { text: 'a question', domainSlug: 'delivery', blocks: undefined, sessionId: 'session-1' });
+    });
+    it('create: resolves human-id --blocks targets via chain.getEntry before the write (R43)', async () => {
+        kernelCall.mockResolvedValueOnce({ _id: 'raw-doc-id-1' });
+        await runQuestionCreateVerb('a question', { blocks: ['TEN-42'] });
+        expect(kernelCall).toHaveBeenCalledWith('chain.getEntry', { entryId: 'TEN-42' });
+        expect(kernelCallWithSession).toHaveBeenCalledWith('question.create', { text: 'a question', domainSlug: undefined, blocks: ['raw-doc-id-1'], sessionId: 'session-1' });
+    });
+    it('create: a raw (non human-id-shaped) --blocks target passes through unresolved, no lookup', async () => {
+        await runQuestionCreateVerb('a question', { blocks: ['j5712abcxyz'] });
+        expect(kernelCall).not.toHaveBeenCalled();
+        expect(kernelCallWithSession).toHaveBeenCalledWith('question.create', { text: 'a question', domainSlug: undefined, blocks: ['j5712abcxyz'], sessionId: 'session-1' });
+    });
+    it('adopt: resolves the target entryId via chain.getEntry (R43) then calls question.adopt', async () => {
+        kernelCall.mockResolvedValueOnce({ _id: 'raw-doc-id-1' });
+        kernelCallWithSession.mockResolvedValueOnce({ entryId: 'TEN-42', facetId: 'facet-1', status: 'unrouted', routingReason: 'single_domain_owner', domainSlugs: [] });
+        await runQuestionAdopt('TEN-42', {});
+        expect(kernelCall).toHaveBeenCalledWith('chain.getEntry', { entryId: 'TEN-42' });
+        expect(kernelCallWithSession).toHaveBeenCalledWith('question.adopt', { entryId: 'raw-doc-id-1', domainSlug: undefined, blocks: undefined, sessionId: 'session-1' });
+    });
+    it('assign: bare form sends no toRoleId/toPersonId ("take it")', async () => {
+        kernelCallWithSession.mockResolvedValueOnce({ entryId: 'TEN-1', status: 'routed' });
+        await runQuestionAssign('TEN-1', {});
+        expect(kernelCallWithSession).toHaveBeenCalledWith('question.assign', { entryId: 'TEN-1', toRoleId: undefined, toPersonId: undefined });
+    });
+    it('assign: --to-role resolves via chain.getEntry, --to-person passes through raw', async () => {
+        kernelCallWithSession.mockResolvedValueOnce({ entryId: 'TEN-1', status: 'routed', ownerRoleId: 'ROL-2', ownerPersonId: 'person-1' });
+        await runQuestionAssign('TEN-1', { toRole: 'ROL-2', toPerson: 'person-1' });
+        expect(kernelCall).toHaveBeenCalledWith('chain.getEntry', { entryId: 'ROL-2' });
+        // Default mock echoes the human id back as _id (beforeEach) — the point under test is
+        // that toRole goes through resolveEntryRef (a chain.getEntry call happened) while
+        // toPerson does NOT (no matching chain.getEntry call for 'person-1').
+        expect(kernelCallWithSession).toHaveBeenCalledWith('question.assign', { entryId: 'TEN-1', toRoleId: 'ROL-2', toPersonId: 'person-1' });
+        expect(kernelCall).not.toHaveBeenCalledWith('chain.getEntry', { entryId: 'person-1' });
+    });
+    // PRRT_kwDORS4ils6YnqKM (round 2 review): people are a separate table from entries —
+    // chain.getEntry cannot resolve a personId. --to-person alone must render via the
+    // mutation's own server-resolved ownerPersonName, never attempt a chain.getEntry({id})
+    // lookup on a people-table id.
+    it('assign: --to-person alone renders via the mutation\'s server-resolved ownerPersonName, never chain.getEntry({id})', async () => {
+        kernelCallWithSession.mockResolvedValueOnce({ entryId: 'TEN-1', status: 'routed', ownerPersonId: 'person-1', ownerPersonName: 'Sylvie' });
+        await runQuestionAssign('TEN-1', { toPerson: 'person-1' });
+        expect(kernelCall).not.toHaveBeenCalledWith('chain.getEntry', { id: 'person-1' });
+    });
+    // PRRT_kwDORS4ils6YnqKe (round 2 review): fn() must return the FLAT mutation result — the
+    // exact value runCliCommand serializes to stdout in JSON/non-TTY mode. An earlier shape
+    // wrapped it as {result, roleOrLeadName}/{result, targetName}/etc., breaking scripted
+    // consumers expecting entryId/status at the top level.
+    it('create/adopt/assign/snooze/decline/answer: runCliCommand receives fn() returning the FLAT mutation result, never a {result, ...} wrapper', async () => {
+        const flatCreate = { entryId: 'TEN-1', facetId: 'facet-1', status: 'unrouted', routingReason: 'single_domain_owner', domainSlugs: [] };
+        kernelCallWithSession.mockResolvedValue(flatCreate);
+        await runQuestionCreateVerb('a question', {});
+        await expect(runCliCommand.mock.calls.at(-1)[0].fn()).resolves.toEqual(flatCreate);
+        const flatSnooze = { entryId: 'TEN-1', status: 'routed', snoozeCount: 1, snoozeUntil: Date.now() };
+        kernelCallWithSession.mockResolvedValue(flatSnooze);
+        await runQuestionSnooze('TEN-1');
+        await expect(runCliCommand.mock.calls.at(-1)[0].fn()).resolves.toEqual(flatSnooze);
+        const flatAnswer = { entryId: 'TEN-1', status: 'processed', askerName: 'Mathijs' };
+        kernelCallWithSession.mockResolvedValue(flatAnswer);
+        await runQuestionAnswer('TEN-1', 'the answer', {});
+        await expect(runCliCommand.mock.calls.at(-1)[0].fn()).resolves.toEqual(flatAnswer);
+    });
+    it('snooze: calls question.snooze with the resolved entryId', async () => {
+        kernelCallWithSession.mockResolvedValueOnce({ entryId: 'TEN-1', status: 'routed', snoozeCount: 1, snoozeUntil: Date.now() });
+        await runQuestionSnooze('TEN-1');
+        expect(kernelCallWithSession).toHaveBeenCalledWith('question.snooze', { entryId: 'TEN-1' });
+    });
+    it('decline: requires --reason client-side before calling the gateway', async () => {
+        await expect(runQuestionDecline('TEN-1', { reason: '' })).rejects.toMatchObject({ code: 'VALIDATION_FAILED' });
+        expect(kernelCallWithSession).not.toHaveBeenCalled();
+    });
+    it('decline: forwards the reason', async () => {
+        kernelCallWithSession.mockResolvedValueOnce({ entryId: 'TEN-1', status: 'processed' });
+        await runQuestionDecline('TEN-1', { reason: 'not mine' });
+        expect(kernelCallWithSession).toHaveBeenCalledWith('question.decline', { entryId: 'TEN-1', reason: 'not mine' });
+    });
+    it('answer: neither text nor --entry is a client-side refusal, §7.7\'s exact string', async () => {
+        await expect(runQuestionAnswer('TEN-1', undefined, {})).rejects.toMatchObject({
+            code: 'VALIDATION_FAILED',
+            message: 'Give the answer as text, or point at an entry with --entry <id>.',
+        });
+        expect(kernelCallWithSession).not.toHaveBeenCalled();
+    });
+    it('answer: both text and --entry is a client-side refusal, §7.7\'s exact string', async () => {
+        await expect(runQuestionAnswer('TEN-1', 'the answer', { entry: 'DEC-5' })).rejects.toMatchObject({
+            code: 'VALIDATION_FAILED',
+            message: 'Use either answer text or --entry, not both.',
+        });
+        expect(kernelCallWithSession).not.toHaveBeenCalled();
+    });
+    it('answer: text form forwards text, no answerEntryId', async () => {
+        kernelCallWithSession.mockResolvedValueOnce({ entryId: 'TEN-1', status: 'processed', answerEntryId: 'DEC-9', answerPending: true });
+        await runQuestionAnswer('TEN-1', 'the answer', {});
+        expect(kernelCallWithSession).toHaveBeenCalledWith('question.answer', { entryId: 'TEN-1', text: 'the answer', answerEntryId: undefined });
+    });
+    it('answer: --entry form resolves the target via chain.getEntry, forwards no text', async () => {
+        kernelCallWithSession.mockResolvedValueOnce({ entryId: 'TEN-1', status: 'processed', answerEntryId: 'DEC-9' });
+        await runQuestionAnswer('TEN-1', undefined, { entry: 'DEC-9' });
+        expect(kernelCall).toHaveBeenCalledWith('chain.getEntry', { entryId: 'DEC-9' });
+        // Default mock echoes the human id back as _id (beforeEach).
+        expect(kernelCallWithSession).toHaveBeenCalledWith('question.answer', { entryId: 'TEN-1', text: undefined, answerEntryId: 'DEC-9' });
+    });
+    it('force-close: requires --reason client-side before calling the gateway', async () => {
+        await expect(runQuestionForceClose('TEN-1', { reason: '' })).rejects.toMatchObject({ code: 'VALIDATION_FAILED' });
+        expect(kernelCallWithSession).not.toHaveBeenCalled();
+    });
+    it('force-close: forwards the reason', async () => {
+        kernelCallWithSession.mockResolvedValueOnce({ entryId: 'TEN-1', status: 'processed' });
+        await runQuestionForceClose('TEN-1', { reason: 'stuck forever' });
+        expect(kernelCallWithSession).toHaveBeenCalledWith('question.forceClose', { entryId: 'TEN-1', reason: 'stuck forever' });
+    });
+    it('parses the Commander create surface end to end', async () => {
+        const command = createQuestionCommand();
+        command.exitOverride();
+        await command.parseAsync(['create', 'a real question', '--domain', 'delivery'], { from: 'user' });
+        expect(kernelCallWithSession).toHaveBeenCalledWith('question.create', { text: 'a real question', domainSlug: 'delivery', blocks: undefined, sessionId: 'session-1' });
+    });
+    it('parses the Commander force-close surface end to end', async () => {
+        kernelCallWithSession.mockResolvedValueOnce({ entryId: 'TEN-1', status: 'processed' });
+        const command = createQuestionCommand();
+        command.exitOverride();
+        await command.parseAsync(['force-close', 'TEN-1', '--reason', 'stuck'], { from: 'user' });
+        expect(kernelCallWithSession).toHaveBeenCalledWith('question.forceClose', { entryId: 'TEN-1', reason: 'stuck' });
+    });
+    // Late review (PR #907 done-audit, TEN-3600): the "present but unresolvable" twin shipped
+    // with no test — pin the rendered phrase directly, stubbing the underlying chain.getEntry
+    // lookup (kernelCall) to fail the way displayName's own bare catch degrades to undefined.
+    it('displayRoleOrLeadName renders a noun phrase, never a raw id or "someone", when the role lookup fails', async () => {
+        kernelCall.mockRejectedValueOnce(new Error('not found'));
+        await expect(displayRoleOrLeadName('role-doc-1')).resolves.toBe('an unresolved role (`role-doc-1` — reassign it)');
+    });
+    it('displayRoleOrLeadName still renders "someone" when no id was ever suggested (the true no-owner case)', async () => {
+        await expect(displayRoleOrLeadName(undefined)).resolves.toBe('someone');
+        expect(kernelCall).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=questions.test.js.map

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"reject.d.ts","sourceRoot":"","sources":["../../src/commands/reject.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,UAAU,aAAa;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BrE"}
+{"version":3,"file":"reject.d.ts","sourceRoot":"","sources":["../../src/commands/reject.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,UAAU,aAAa;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAgCrE"}

package/dist/commands/reject.js

@@ -6,7 +6,7 @@
  * Reason is mandatory — objections must be explained (BR-7).
  */
 import { getConfigOrGuide } from '../lib/config.js';
-import { mcpCall } from '../lib/client.js';
+import { kernelCall } from '../lib/client.js';
 import { runCliCommand } from '../lib/runner.js';
 import { formatRejectReceipt } from '../formatters/proposals.js';
 import { CLIError, ErrorCode } from '../lib/errors.js';
@@ -19,19 +19,20 @@ export async function runReject(options) {
         throw new CLIError('Proposal ID is required.', {
             code: ErrorCode.VALIDATION_FAILED,
             category: 'validation',
-            guidance: 'Usage: pb reject <id> --reason "..."',
+            guidance: 'Usage: pb proposal reject <id> --reason "..."',
         });
     }
     if (!options.reason?.trim()) {
         throw new CLIError('A reason is required when rejecting.', {
             code: ErrorCode.VALIDATION_FAILED,
             category: 'validation',
-            guidance: 'Governance requires that objections are explained (BR-7). Usage: pb reject <id> --reason "..."',
+            // BR-7
+            guidance: 'Governance requires that objections are explained. Usage: pb proposal reject <id> --reason "..."',
         });
     }
     await runCliCommand({
         fn: async () => {
-            return await mcpCall('governance.respondToProposal', {
+            return await kernelCall('governance.respondToProposal', {
                 proposalId,
                 verdict: 'reject',
                 reason: options.reason.trim(),

package/dist/commands/reject.js.map

@@ -1 +1 @@
-{"version":3,"file":"reject.js","sourceRoot":"","sources":["../../src/commands/reject.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAA0B,MAAM,4BAA4B,CAAC;AACzF,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAOvD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAsB;IACpD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC;IAC9C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,QAAQ,CAAC,0BAA0B,EAAE;YAC7C,IAAI,EAAE,SAAS,CAAC,iBAAiB;YACjC,QAAQ,EAAE,YAAY;YACtB,QAAQ,EAAE,sCAAsC;SACjD,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,QAAQ,CAAC,sCAAsC,EAAE;YACzD,IAAI,EAAE,SAAS,CAAC,iBAAiB;YACjC,QAAQ,EAAE,YAAY;YACtB,QAAQ,EAAE,gGAAgG;SAC3G,CAAC,CAAC;IACL,CAAC;IAED,MAAM,aAAa,CAAoB;QACrC,EAAE,EAAE,KAAK,IAAI,EAAE;YACb,OAAO,MAAM,OAAO,CAAoB,8BAA8B,EAAE;gBACtE,UAAU;gBACV,OAAO,EAAE,QAAQ;gBACjB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE;aAC9B,CAAC,CAAC;QACL,CAAC;QACD,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC;KAClD,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"reject.js","sourceRoot":"","sources":["../../src/commands/reject.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAA0B,MAAM,4BAA4B,CAAC;AACzF,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAOvD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAsB;IACpD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC;IAC9C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,QAAQ,CAAC,0BAA0B,EAAE;YAC7C,IAAI,EAAE,SAAS,CAAC,iBAAiB;YACjC,QAAQ,EAAE,YAAY;YACtB,QAAQ,EAAE,+CAA+C;SAC1D,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,QAAQ,CAAC,sCAAsC,EAAE;YACzD,IAAI,EAAE,SAAS,CAAC,iBAAiB;YACjC,QAAQ,EAAE,YAAY;YACtB,OAAO;YACP,QAAQ,EAAE,kGAAkG;SAC7G,CAAC,CAAC;IACL,CAAC;IAED,MAAM,aAAa,CAAoB;QACrC,EAAE,EAAE,KAAK,IAAI,EAAE;YACb,OAAO,MAAM,UAAU,CAA2D,8BAA8B,EAAE;gBAChH,UAAU;gBACV,OAAO,EAAE,QAAQ;gBACjB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE;aAC9B,CAAC,CAAC;QACL,CAAC;QACD,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC;KAClD,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/relate.d.ts

@@ -9,6 +9,7 @@ interface RelateOptions {
     type: string;
     toId: string;
     ifMissing?: boolean;
+    dryRun?: boolean;
 }
 export declare function runRelate(options: RelateOptions): Promise<void>;
 export declare function runUnrelate(options: RelateOptions): Promise<void>;

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

@@ -1 +1 @@
-{"version":3,"file":"relate.d.ts","sourceRoot":"","sources":["../../src/commands/relate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,UAAU,aAAa;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAWD,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAsDrE;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCvE"}
+{"version":3,"file":"relate.d.ts","sourceRoot":"","sources":["../../src/commands/relate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,UAAU,aAAa;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAsBD,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAqKrE;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAyCvE"}