@productbrain/cli 0.1.0-beta.14 → 0.1.0-beta.14010

package/dist/commands/proof-run.js.map

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

package/dist/commands/quality.d.ts

@@ -0,0 +1,38 @@
+/**
+ * pb quality spine-check [--story] — A2, WP-581/FEAT-1402.
+ *
+ * Deterministic core (structural completeness + duplicate-singleton finding +
+ * per-strategy refusal heuristic + Roger Martin probe) ALWAYS runs. The
+ * one-story LLM pass (vision_serves_purpose/strategy_serves_vision/
+ * strategy_refuses) runs ONLY with --story — never scheduled, on-demand only.
+ *
+ * Renders from an INDEPENDENT read-back (quality.getLatestSpineVerdict), not
+ * the write action's own return value — the store-then-read-back proof
+ * discipline this codebase applies everywhere a verdict is claimed stored.
+ */
+import type { Command } from 'commander';
+export declare function runQualitySpineCheck(options: {
+    story?: boolean;
+}): Promise<void>;
+/**
+ * pb quality checks (TASK-740): each write-door check's hold, suggestion, timeout, hand-back and override rates with denominators.
+ * --role-suggestions (TASK-921): every role-check suggestion and hold, row by row, with where the entry ended up.
+ * --rows <check> (TASK-1328): one check's door rows over a window, the frame with its denominators, and a seeded sample.
+ */
+export interface CheckRowsOptions {
+    rows?: string;
+    since?: string;
+    until?: string;
+    kind?: string;
+    outcome?: string;
+    sample?: string;
+    seed?: string;
+}
+/** The --rows call's args: the window in ms, the filters as given, and a seed drawn here when --sample has none, so it is echoed. */
+export declare function checkRowsArgs(o: CheckRowsOptions, now?: number, draw?: () => number): Record<string, unknown>;
+export declare function runQualityChecks(options?: {
+    roleSuggestions?: boolean;
+} & CheckRowsOptions): Promise<void>;
+/** The `pb quality` subcommands, registered here so index.ts (shrink-only) holds one line. */
+export declare function registerQualityCommands(qualityCmd: Command): void;
+//# sourceMappingURL=quality.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"quality.d.ts","sourceRoot":"","sources":["../../src/commands/quality.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC,wBAAsB,oBAAoB,CAAC,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAUtF;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CAChH;AAcD,qIAAqI;AACrI,wBAAgB,aAAa,CAAC,CAAC,EAAE,gBAAgB,EAAE,GAAG,SAAa,EAAE,IAAI,eAA4C,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAS9I;AAED,wBAAsB,gBAAgB,CAAC,OAAO,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,gBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBpH;AAED,8FAA8F;AAC9F,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI,CAoBjE"}

package/dist/commands/quality.js

@@ -0,0 +1,99 @@
+/**
+ * pb quality spine-check [--story] — A2, WP-581/FEAT-1402.
+ *
+ * Deterministic core (structural completeness + duplicate-singleton finding +
+ * per-strategy refusal heuristic + Roger Martin probe) ALWAYS runs. The
+ * one-story LLM pass (vision_serves_purpose/strategy_serves_vision/
+ * strategy_refuses) runs ONLY with --story — never scheduled, on-demand only.
+ *
+ * Renders from an INDEPENDENT read-back (quality.getLatestSpineVerdict), not
+ * the write action's own return value — the store-then-read-back proof
+ * discipline this codebase applies everywhere a verdict is claimed stored.
+ */
+import { getConfigOrGuide } from '../lib/config.js';
+import { kernelCall } from '../lib/client.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
+import { runCliCommand } from '../lib/runner.js';
+import { formatSpineVerdict } from '../formatters/spineCheck.js';
+import { formatCheckRows, formatQualityChecks, formatRoleSuggestions, } from '../formatters/qualityChecks.js';
+export async function runQualitySpineCheck(options) {
+    await getConfigOrGuide();
+    await runCliCommand({
+        fn: async () => {
+            await kernelCall('quality.spineCheck', { includeStory: Boolean(options.story) });
+            return await kernelCall('quality.getLatestSpineVerdict', {});
+        },
+        formatPretty: (row) => formatSpineVerdict(row),
+    });
+}
+const invalid = (message) => new CLIError(message, { code: ErrorCode.VALIDATION_FAILED, category: 'validation' });
+/** A date or a full timestamp; a bare date is that day's UTC midnight. */
+function parseWhen(flag, value) {
+    const at = Date.parse(value);
+    if (!Number.isFinite(at))
+        throw invalid(`${flag} takes a date like 2026-09-27 or 2026-09-27T12:00Z, not "${value}".`);
+    return at;
+}
+function parseWhole(flag, value) {
+    if (!/^\d+$/.test(value))
+        throw invalid(`${flag} takes a whole number, not "${value}".`);
+    return Number(value);
+}
+/** The --rows call's args: the window in ms, the filters as given, and a seed drawn here when --sample has none, so it is echoed. */
+export function checkRowsArgs(o, now = Date.now(), draw = () => Math.floor(Math.random() * 2 ** 32)) {
+    if (!o.since)
+        throw invalid('--rows needs --since <date>: the first day of the window.');
+    const sample = o.sample !== undefined ? parseWhole('--sample', o.sample) : undefined;
+    if (o.seed !== undefined && sample === undefined)
+        throw invalid('--seed draws a sample: add --sample <n>.');
+    return {
+        checkKey: o.rows, since: parseWhen('--since', o.since), until: o.until !== undefined ? parseWhen('--until', o.until) : now,
+        ...(o.kind !== undefined ? { kind: o.kind } : {}), ...(o.outcome !== undefined ? { outcome: o.outcome } : {}),
+        ...(sample !== undefined ? { sample, seed: o.seed !== undefined ? parseWhole('--seed', o.seed) : draw() } : {}),
+    };
+}
+export async function runQualityChecks(options = {}) {
+    await getConfigOrGuide();
+    if (options.rows !== undefined) {
+        const args = checkRowsArgs(options);
+        await runCliCommand({
+            fn: () => kernelCall('quality.checkRows', args),
+            formatPretty: (result) => formatCheckRows(result),
+        });
+        return;
+    }
+    if (options.roleSuggestions) {
+        await runCliCommand({
+            fn: () => kernelCall('quality.roleSuggestions', {}),
+            formatPretty: (result) => formatRoleSuggestions(result),
+        });
+        return;
+    }
+    await runCliCommand({
+        fn: () => kernelCall('quality.checks', {}),
+        formatPretty: (result) => formatQualityChecks(result),
+    });
+}
+/** The `pb quality` subcommands, registered here so index.ts (shrink-only) holds one line. */
+export function registerQualityCommands(qualityCmd) {
+    qualityCmd
+        .command('spine-check')
+        .description('Check the direction, purpose to key results, for duplicates, unlinked entries and a strategy that refuses nothing; --story adds the one-story judgment')
+        .option('--story', 'Also run the on-demand one-story judgment (never scheduled; result labelled [unvalidated])')
+        .action(async (opts) => { await runQualitySpineCheck({ story: opts.story }); });
+    qualityCmd
+        .command('checks')
+        .description("Each write-door check's hold, suggestion, timeout, hand-back and override rates, with denominators")
+        .option('--role-suggestions', 'List every role-check suggestion and hold with the role it named, the owner today and the outcome')
+        .option('--rows <check>', "List one check's rows from --since (to --until or now): counts by outcome and kind first, then the newest 50 or a --sample")
+        .option('--since <date>', 'With --rows: the first day of the window')
+        .option('--until <date>', 'With --rows: the day after the window (default now)')
+        .option('--kind <kind>', 'With --rows: one kind only, such as tension')
+        .option('--outcome <word>', 'With --rows: one outcome only, a word the counts line prints')
+        .option('--sample <n>', 'With --rows: draw n rows at random from the matching rows (at most 200)')
+        .option('--seed <s>', 'With --sample: the seed, so the same draw comes back; printed when left out')
+        .action(async (opts) => {
+        await runQualityChecks(opts);
+    });
+}
+//# sourceMappingURL=quality.js.map

package/dist/commands/quality.js.map

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

package/dist/commands/questions.d.ts

@@ -0,0 +1,27 @@
+import { Command } from 'commander';
+export declare function displayRoleOrLeadName(id: string | undefined): Promise<string>;
+export interface QuestionCreateOptions {
+    blocks?: string[];
+    toRole?: string;
+    team?: string;
+}
+export declare function runQuestionCreateVerb(text: string, options: QuestionCreateOptions): Promise<void>;
+export interface QuestionAssignOptions {
+    toRole: string;
+    team?: string;
+}
+export declare function runQuestionAssign(entryId: string, options: QuestionAssignOptions): Promise<void>;
+export interface QuestionAnswerOptions {
+    entry?: string;
+}
+export declare function runQuestionAnswer(entryId: string, text: string | undefined, options: QuestionAnswerOptions): Promise<void>;
+export declare function runQuestionForceClose(entryId: string, options: {
+    reason: string;
+}): Promise<void>;
+export interface QuestionListOptions {
+    mine?: boolean;
+    role?: string;
+}
+export declare function runQuestionList(options: QuestionListOptions): Promise<void>;
+export declare function createQuestionCommand(): Command;
+//# sourceMappingURL=questions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"questions.d.ts","sourceRoot":"","sources":["../../src/commands/questions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkGpC,wBAAsB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAKnF;AAkBD,MAAM,WAAW,qBAAqB;IAAG,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;AAY5F,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBvG;AAID,MAAM,WAAW,qBAAqB;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;AAExE,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBtG;AAID,MAAM,WAAW,qBAAqB;IAAG,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;AAEzD,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoChI;AAID,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBvG;AAMD,MAAM,WAAW,mBAAmB;IAAG,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;AAEtE,wBAAsB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CASjF;AAID,wBAAgB,qBAAqB,IAAI,OAAO,CAyC/C"}

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":""}