@productbrain/cli 0.1.0-beta.1419 → 0.1.0-beta.14193

package/dist/commands/questions.js

@@ -0,0 +1,261 @@
+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 { copy } from '../lib/style.js';
+import { QUESTION_SEAT_WORDS, QUESTION_TEAM_NEXT, questionSeatName } from '../lib/seatSentence.js';
+import { formatQuestionCreate, formatQuestionAssignReassign, 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). 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.
+ *
+ * D1c+D2a+D2b (TASK-413/414/416, WP-781): `adopt`/`snooze`/`decline` are deleted, and `assign` is
+ * reassign-to-a-role only now (DEC-1707/§10: no domain lookup anywhere; only assign/answer/
+ * forceClose remain). TASK-1334 (RULE-706): `create --to-role` births the question assigned to the
+ * role asked; without it the asking team's Team Lead holds it until an `assign` (the asker may make one, once).
+ * DEC-2577: `--team` beside `--to-role` names the team whose Team Lead holds it.
+ *
+ * A "why it matters" tip (§3.3): a question created 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(copy.noSession, {
+            code: ErrorCode.SESSION_REQUIRED,
+            category: 'session',
+            guidance: copy.noSessionGuidance,
+        });
+    }
+    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)`;
+}
+/** DEC-2577: the seat a question is with, as the receipt names it: "Team Lead of <team>" for Team Lead, the role alone for any other.
+ *  The team's name is one more chain.getEntry; a lookup that fails leaves the role alone, as the role's own does. */
+async function ownerSeatName(roleName, owner) {
+    const teamName = owner.ownerIsTeamLead && owner.ownerTeamId ? await displayName(owner.ownerTeamId) : undefined;
+    return questionSeatName(roleName, teamName, Boolean(owner.ownerIsTeamLead));
+}
+/** A team named without its role is refused before any call, in the kernel's words with this command's form. */
+function requireRoleWithTeam(toRole, team) {
+    if (team && !toRole) {
+        throw new CLIError(QUESTION_SEAT_WORDS.nameRoleWithTeam, { code: ErrorCode.VALIDATION_FAILED, category: 'validation', guidance: QUESTION_TEAM_NEXT.cli });
+    }
+}
+// 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 with an aux-state
+// closure variable OUTSIDE runCliCommand, set inside fn(),
+// read by formatPretty — fn() returns ONLY the real result.
+//
+// D1c (TASK-416, WP-781): `--domain` is deleted along with the domain judge (DEC-1707: no
+// domain lookup anywhere). TASK-1334 (RULE-706): `--to-role` births it assigned to that role.
+export async function runQuestionCreateVerb(text, options) {
+    requireRoleWithTeam(options.toRole, options.team);
+    await getConfigOrGuide();
+    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 toRoleId = options.toRole ? await resolveEntryRef(options.toRole, 'Role') : undefined;
+            const toTeamId = options.team ? await resolveEntryRef(options.team, 'Team') : undefined;
+            const result = await kernelCallWithSession('question.create', {
+                text,
+                blocks: resolvedBlocks,
+                ...(toRoleId ? { toRoleId } : {}),
+                ...(toTeamId ? { toTeamId } : {}),
+                sessionId: session.sessionId,
+            });
+            roleOrLeadName = await ownerSeatName(await displayRoleOrLeadName(result.ownerRoleId), result);
+            return result;
+        },
+        formatPretty: (result) => formatQuestionCreate(result, roleOrLeadName),
+    });
+}
+export async function runQuestionAssign(entryId, options) {
+    await getConfigOrGuide();
+    const session = requireQuestionSession();
+    let targetName;
+    await runCliCommand({
+        fn: async () => {
+            const resolvedEntryId = await resolveEntryRef(entryId, 'Entry');
+            const resolvedToRoleId = await resolveEntryRef(options.toRole, 'Role');
+            const resolvedToTeamId = options.team ? await resolveEntryRef(options.team, 'Team') : undefined;
+            const result = await kernelCallWithSession('question.assign', {
+                entryId: resolvedEntryId,
+                toRoleId: resolvedToRoleId,
+                ...(resolvedToTeamId ? { toTeamId: resolvedToTeamId } : {}),
+                sessionId: session.sessionId,
+            });
+            targetName = await ownerSeatName((await displayName(result.ownerRoleId)) ?? result.ownerRoleId, result);
+            return result;
+        },
+        formatPretty: () => formatQuestionAssignReassign(entryId, targetName ?? 'the target'),
+    });
+}
+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>',
+        });
+    }
+    await getConfigOrGuide();
+    const session = 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,
+                sessionId: session.sessionId,
+            });
+        },
+        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>".',
+        });
+    }
+    await getConfigOrGuide();
+    const session = requireQuestionSession();
+    await runCliCommand({
+        fn: async () => {
+            const resolvedEntryId = await resolveEntryRef(entryId, 'Entry');
+            return kernelCallWithSession('question.forceClose', {
+                entryId: resolvedEntryId,
+                reason: options.reason,
+                sessionId: session.sessionId,
+            });
+        },
+        formatPretty: (result) => formatQuestionForceClose(entryId, result),
+    });
+}
+export async function runQuestionList(options) {
+    await getConfigOrGuide();
+    await runCliCommand({
+        fn: async () => {
+            const args = { mine: options.mine, ...(options.role !== undefined ? { role: options.role } : {}) };
+            return (await kernelCall('question.list', args));
+        },
+        formatPretty: (result) => formatQuestionList(result, Boolean(options.mine)),
+    });
+}
+// ─── command registration ────────────────────────────────────────────────────────────────────
+export function createQuestionCommand() {
+    const command = new Command('question').description('Routed questions — ask a role with `create --to-role <roleId>` and the question is born assigned to it; ' +
+        `${QUESTION_SEAT_WORDS.withoutTeam} ` +
+        'Ask another team\'s Team Lead with `--team <team-id>` beside `--to-role`. ' +
+        '`--blocks <entry-id>` (repeatable, on create) records what a question is holding up. ' +
+        '`assign --to-role <roleId>` reassigns it to a role (and, for Team Lead, `--team`); the asker may do this once while a Team Lead holds it. ' +
+        '`list` shows what you owe; `list --mine` shows every question you asked, including closed ones, with its outcome; ' +
+        '`list --role <roleId>` shows the open questions waiting on that role.');
+    command.command('create <text>')
+        .description(`Ask a question; with --to-role it goes to that role. ${QUESTION_SEAT_WORDS.withoutTeam} ${QUESTION_SEAT_WORDS.holdsDraft}`)
+        .option('--blocks <entryId...>', 'Entry ids this question is blocking (repeatable)')
+        .option('--to-role <roleId>', 'Ask this role: the question is born assigned to it (human ROL-nnn form or a raw entry id)')
+        .option('--team <teamId>', QUESTION_SEAT_WORDS.teamHelp + ' (human TEAM-nnn form or a raw entry id)')
+        .action(runQuestionCreateVerb);
+    command.command('assign <id>')
+        .description('Reassign this question to a role')
+        .requiredOption('--to-role <roleId>', 'Reassign to this role (human ROL-nnn form or a raw entry id)')
+        .option('--team <teamId>', QUESTION_SEAT_WORDS.teamHelp + ' (human TEAM-nnn form or a raw entry id)')
+        .action((entryId, opts) => runQuestionAssign(entryId, opts));
+    command.command('answer <id> [text]')
+        .description('Write the answer on the question and move it to answered; --entry links an existing decision instead')
+        .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; with --role, what waits on that role)')
+        .option('--mine', 'Show every question you asked, including closed ones, with its outcome')
+        .option('--role <roleId>', "Show the open questions waiting on this role, read-only and for any member (human ROL-nnn form or a raw entry id); not with --mine")
+        .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,238 @@
+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, runQuestionAssign, runQuestionAnswer, runQuestionForceClose, runQuestionList, displayRoleOrLeadName, } from './questions.js';
+/**
+ * `pb question` command surface tests (WP-638 S3). Shape:
+ * every write 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.
+ *
+ * D1c+D2a+D2b (TASK-413/414/416, WP-781): `adopt`/`snooze`/`decline` are deleted, and `assign`
+ * is reassign-to-a-role only now (DEC-1707/§10: no domain lookup anywhere; only assign/answer/
+ * forceClose remain).
+ */
+/** The receipt the last command would print for `result`. */
+const lastReceipt = (result) => runCliCommand.mock.calls.at(-1)[0].formatPretty(result);
+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: 'escalated', ownerRoleId: 'ROL-lead', routingReason: 'no_domain' });
+    });
+    it('exposes the four write subcommands plus `list`', () => {
+        const command = createQuestionCommand();
+        const names = command.commands.map((item) => item.name());
+        expect(names).toEqual(['create', 'assign', '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(runQuestionAssign('TEN-1', { toRole: 'ROL-1' })).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/blocks straight through — no domainSlug (D1c: no domain lookup anywhere)', async () => {
+        await runQuestionCreateVerb('a question', {});
+        expect(kernelCallWithSession).toHaveBeenCalledWith('question.create', { text: 'a question', 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', blocks: ['raw-doc-id-1'], sessionId: 'session-1' });
+    });
+    it('create: a raw (non human-id-shaped) --blocks target passes through unresolved, no --blocks lookup', async () => {
+        await runQuestionCreateVerb('a question', { blocks: ['j5712abcxyz'] });
+        // The only kernelCall this makes is displayRoleOrLeadName's own chain.getEntry lookup for
+        // the born-escalated ownerRoleId (every question is born escalated now, D1c) — never a
+        // --blocks resolution, since 'j5712abcxyz' doesn't match the human-id pattern.
+        expect(kernelCall).not.toHaveBeenCalledWith('chain.getEntry', { entryId: 'j5712abcxyz' });
+        expect(kernelCallWithSession).toHaveBeenCalledWith('question.create', { text: 'a question', blocks: ['j5712abcxyz'], sessionId: 'session-1' });
+    });
+    it('create --to-role: resolves the role id and asks it in the one create call', async () => {
+        kernelCall.mockResolvedValueOnce({ _id: 'raw-role-id-7' }); // --to-role resolution
+        await runQuestionCreateVerb('a question', { toRole: 'ROL-7' });
+        expect(kernelCall).toHaveBeenCalledWith('chain.getEntry', { entryId: 'ROL-7' });
+        expect(kernelCallWithSession).toHaveBeenCalledTimes(1);
+        expect(kernelCallWithSession).toHaveBeenCalledWith('question.create', { text: 'a question', blocks: undefined, toRoleId: 'raw-role-id-7', sessionId: 'session-1' });
+    });
+    it('create --to-role: the option parses on the create subcommand', async () => {
+        const create = createQuestionCommand().commands.find((c) => c.name() === 'create');
+        expect(create.options.map((o) => o.long)).toContain('--to-role');
+        create.parseOptions(['--to-role', 'ROL-7']);
+        expect(create.opts()).toMatchObject({ toRole: 'ROL-7' });
+    });
+    it('create --team: the option parses on create and assign, and carries the kernel help sentence', () => {
+        for (const name of ['create', 'assign']) {
+            const sub = createQuestionCommand().commands.find((c) => c.name() === name);
+            const team = sub.options.find((o) => o.long === '--team');
+            expect(team.description).toContain('The team whose Team Lead holds it; only for Team Lead, which is held in every team');
+            sub.parseOptions(['--team', 'TEAM-9', '--to-role', 'ROL-23']);
+            expect(sub.opts()).toMatchObject({ team: 'TEAM-9', toRole: 'ROL-23' });
+        }
+    });
+    it('create --to-role --team: resolves both ids through chain.getEntry and sends toTeamId with toRoleId', async () => {
+        kernelCall.mockResolvedValueOnce({ _id: 'raw-role-23' });
+        kernelCall.mockResolvedValueOnce({ _id: 'raw-team-9' });
+        await runQuestionCreateVerb('a question', { toRole: 'ROL-23', team: 'TEAM-9' });
+        expect(kernelCall).toHaveBeenCalledWith('chain.getEntry', { entryId: 'TEAM-9' });
+        expect(kernelCallWithSession).toHaveBeenCalledWith('question.create', { text: 'a question', blocks: undefined, toRoleId: 'raw-role-23', toTeamId: 'raw-team-9', sessionId: 'session-1' });
+    });
+    it('create --team without --to-role: refused before any call, in the kernel sentence with the command form', async () => {
+        await expect(runQuestionCreateVerb('a question', { team: 'TEAM-9' })).rejects.toMatchObject({
+            message: 'Name the role too: a team alone does not say who holds it.',
+            guidance: 'Next: pb question create "<your ask>" --to-role ROL-n --team TEAM-n',
+        });
+        expect(kernelCall).not.toHaveBeenCalled();
+        expect(kernelCallWithSession).not.toHaveBeenCalled();
+    });
+    it('the receipt names the seat: "Team Lead of <team>" for Team Lead, the role alone for any other role', async () => {
+        const names = { 'lead-doc': 'Team Lead', 'media-doc': 'Media', 'design-doc': 'Product Design', 'root-doc': 'Product Team' };
+        kernelCall.mockImplementation(async (_fn, args) => ({ _id: args.entryId ?? args.id, name: names[args.id ?? ''] }));
+        kernelCallWithSession.mockResolvedValueOnce({ entryId: 'q1', questionId: 'QUE-7', facetId: 'f', status: 'routed', ownerRoleId: 'lead-doc', ownerTeamId: 'media-doc', ownerIsTeamLead: true, routingReason: 'manual_assignment' });
+        await runQuestionCreateVerb('a question', { toRole: 'ROL-23', team: 'TEAM-9' });
+        expect(lastReceipt(await runCliCommand.mock.results.at(-1).value)).toContain('Asked as QUE-7. It is with Team Lead of Media.');
+        kernelCallWithSession.mockResolvedValueOnce({ entryId: 'q2', questionId: 'QUE-8', facetId: 'f', status: 'routed', ownerRoleId: 'design-doc', ownerTeamId: 'root-doc', ownerIsTeamLead: false, routingReason: 'manual_assignment' });
+        await runQuestionCreateVerb('a question', { toRole: 'ROL-9' });
+        expect(lastReceipt(await runCliCommand.mock.results.at(-1).value)).toContain('Asked as QUE-8. It is with Product Design.');
+    });
+    it('assign --team: resolves the team and sends toTeamId; the receipt names the seat', async () => {
+        kernelCall.mockImplementation(async (_fn, args) => ({ _id: args.entryId === 'TEAM-9' ? 'raw-team-9' : (args.entryId ?? args.id), name: args.id === 'media-doc' ? 'Media' : 'Team Lead' }));
+        kernelCallWithSession.mockResolvedValueOnce({ entryId: 'TEN-1', status: 'routed', ownerRoleId: 'lead-doc', ownerTeamId: 'media-doc', ownerIsTeamLead: true });
+        await runQuestionAssign('QUE-1', { toRole: 'ROL-23', team: 'TEAM-9' });
+        expect(kernelCallWithSession).toHaveBeenCalledWith('question.assign', { entryId: 'QUE-1', toRoleId: 'ROL-23', toTeamId: 'raw-team-9', sessionId: 'session-1' });
+        expect(lastReceipt()).toContain('QUE-1 reassigned to Team Lead of Media.');
+    });
+    it('assign: resolves both entryId and --to-role via chain.getEntry (R43), calls question.assign with toRoleId only', async () => {
+        kernelCall.mockResolvedValueOnce({ _id: 'raw-doc-id-1' }); // entryId resolution
+        kernelCall.mockResolvedValueOnce({ _id: 'raw-role-id-1' }); // toRole resolution
+        kernelCallWithSession.mockResolvedValueOnce({ entryId: 'TEN-1', status: 'routed', ownerRoleId: 'raw-role-id-1' });
+        await runQuestionAssign('TEN-1', { toRole: 'ROL-2' });
+        expect(kernelCall).toHaveBeenCalledWith('chain.getEntry', { entryId: 'TEN-1' });
+        expect(kernelCall).toHaveBeenCalledWith('chain.getEntry', { entryId: 'ROL-2' });
+        expect(kernelCallWithSession).toHaveBeenCalledWith('question.assign', { entryId: 'raw-doc-id-1', toRoleId: 'raw-role-id-1', sessionId: 'session-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/assign/answer: runCliCommand receives fn() returning the FLAT mutation result, never a {result, ...} wrapper', async () => {
+        const flatCreate = { entryId: 'TEN-1', facetId: 'facet-1', status: 'escalated', ownerRoleId: 'ROL-lead', routingReason: 'no_domain' };
+        kernelCallWithSession.mockResolvedValue(flatCreate);
+        await runQuestionCreateVerb('a question', {});
+        await expect(runCliCommand.mock.calls.at(-1)[0].fn()).resolves.toEqual(flatCreate);
+        const flatAssign = { entryId: 'TEN-1', status: 'routed', ownerRoleId: 'ROL-2' };
+        kernelCallWithSession.mockResolvedValue(flatAssign);
+        await runQuestionAssign('TEN-1', { toRole: 'ROL-2' });
+        await expect(runCliCommand.mock.calls.at(-1)[0].fn()).resolves.toEqual(flatAssign);
+        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('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', answer: 'the answer' });
+        await runQuestionAnswer('TEN-1', 'the answer', {});
+        expect(kernelCallWithSession).toHaveBeenCalledWith('question.answer', { entryId: 'TEN-1', text: 'the answer', answerEntryId: undefined, sessionId: 'session-1' });
+    });
+    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', sessionId: 'session-1' });
+    });
+    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', sessionId: 'session-1' });
+    });
+    it('parses the Commander create surface end to end', async () => {
+        const command = createQuestionCommand();
+        command.exitOverride();
+        await command.parseAsync(['create', 'a real question'], { from: 'user' });
+        expect(kernelCallWithSession).toHaveBeenCalledWith('question.create', { text: 'a real question', blocks: undefined, sessionId: 'session-1' });
+    });
+    it('parses the Commander assign surface end to end', async () => {
+        kernelCallWithSession.mockResolvedValueOnce({ entryId: 'TEN-1', status: 'routed', ownerRoleId: 'ROL-2' });
+        const command = createQuestionCommand();
+        command.exitOverride();
+        await command.parseAsync(['assign', 'TEN-1', '--to-role', 'ROL-2'], { from: 'user' });
+        expect(kernelCallWithSession).toHaveBeenCalledWith('question.assign', { entryId: 'TEN-1', toRoleId: 'ROL-2', 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', sessionId: 'session-1' });
+    });
+    // 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();
+    });
+    // TASK-1416 (DEC-2507): `list --role` is a plain read; the server resolves the id and refuses --role with --mine in its own words.
+    it('list --role: the option parses and the id goes to question.list unresolved, with no session needed', async () => {
+        const list = createQuestionCommand().commands.find((c) => c.name() === 'list');
+        expect(list.options.map((o) => o.long)).toEqual(['--mine', '--role']);
+        list.parseOptions(['--role', 'ROL-7']);
+        expect(list.opts()).toMatchObject({ role: 'ROL-7' });
+        readSession.mockReturnValue(null);
+        kernelCall.mockResolvedValue({ role: { entryId: 'ROL-7', name: 'Backend', live: true }, questions: [], viewerPersonId: 'p1' });
+        await runQuestionList({ role: 'ROL-7' });
+        expect(kernelCall).toHaveBeenCalledTimes(1);
+        expect(kernelCall).toHaveBeenCalledWith('question.list', { mine: undefined, role: 'ROL-7' });
+    });
+    it('list --role with --mine: both go to the server, which refuses the pair; the CLI keeps no second copy of the words', async () => {
+        kernelCall.mockRejectedValue(new Error("Choose one: a role's open questions, or the ones you asked."));
+        await expect(runQuestionList({ role: 'ROL-7', mine: true }).then(() => runCliCommand.mock.calls.at(-1)[0].fn())).rejects.toThrow("Choose one: a role's open questions");
+        expect(kernelCall).toHaveBeenCalledWith('question.list', { mine: true, role: 'ROL-7' });
+    });
+    it('list without --role sends no role key', async () => {
+        kernelCall.mockResolvedValue({ questions: [], viewerPersonId: 'p1' });
+        await runQuestionList({ mine: true });
+        expect(kernelCall).toHaveBeenCalledWith('question.list', { mine: true });
+        expect(kernelCall.mock.calls.at(-1)[1]).not.toHaveProperty('role');
+    });
+});
+//# 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/relate.d.ts

@@ -9,8 +9,18 @@ interface RelateOptions {
     type: string;
     toId: string;
     ifMissing?: boolean;
+    dryRun?: boolean;
+    /** TASK-1164 (DEC-2295 addendum): move the entry off the parent it already hangs on, in the same write. */
+    move?: boolean;
 }
 export declare function runRelate(options: RelateOptions): Promise<void>;
+/** TASK-1028 (TEN-5450): after the receipt, the rung the link joined (the kernel's rungLine), then the accept it unblocks. */
+export declare function relateSpineLines(result: {
+    spineLink?: {
+        line: string;
+        nextAccept?: string;
+    };
+}): string;
 export declare function runUnrelate(options: RelateOptions): Promise<void>;
 export {};
 //# sourceMappingURL=relate.d.ts.map

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,CAyErE;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAsCvE"}
+{"version":3,"file":"relate.d.ts","sourceRoot":"","sources":["../../src/commands/relate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,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;IACjB,2GAA2G;IAC3G,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAmBD,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAqKrE;AAED,8HAA8H;AAC9H,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IAAE,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAAG,MAAM,CAGtG;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAuCvE"}