@longtable/cli 0.1.21 → 0.1.22

package/dist/cli.js

@@ -42,7 +42,7 @@ const ANSI = {
     green: "\u001B[32m"
 };
 const LONGTABLE_MCP_SERVER_NAME = "longtable-state";
-const LONGTABLE_MCP_PACKAGE_VERSION = "0.1.21";
+const LONGTABLE_MCP_PACKAGE_VERSION = "0.1.22";
 const LONGTABLE_MCP_MARKER_START = "# LongTable state MCP START";
 const LONGTABLE_MCP_MARKER_END = "# LongTable state MCP END";
 function style(text, prefix) {
@@ -78,17 +78,16 @@ function usage() {
         "  Run `longtable ...` in your terminal, not inside the Codex chat box.",
         "  After `longtable start`, move into the created project directory and open `codex` there.",
         "",
-        "  longtable setup [--provider codex|claude] [--install-scope user|project|none] [--surfaces cli_only|skills|skills_mcp|skills_mcp_sentinel] [--intervention advisory|balanced|strong] [--workspace create|later] [--project-dir <path>] [--json] [--dir <path>] [--skills-dir <path>] [--runtime-path <file>] [--setup-path <file>]",
+        "  longtable setup [--provider codex|claude] [--install-scope user|project|none] [--surfaces cli_only|skills|skills_mcp|skills_mcp_sentinel] [--intervention advisory|balanced|strong] [--checkpoint-ui off|interactive|strong] [--workspace create|later] [--project-dir <path>] [--json] [--dir <path>] [--skills-dir <path>] [--runtime-path <file>] [--setup-path <file>]",
         "  longtable init [deprecated alias for setup; full legacy flags still supported for automation]",
         "  longtable start [--path <dir>] [--name <project>] [--goal <text>] [--blocker <text>] [--research-object research_question|theory_framework|measurement_instrument|study_design|analysis_plan|manuscript] [--gap-risk known_gap|suspected_tacit_assumptions|diagnose] [--protected-decision theory|measurement|method|evidence_citation|authorship_voice|submission_public_sharing] [--perspectives <role[,role]>] [--disagreement synthesis_only|show_on_conflict|always_visible] [--setup <path>] [--json]",
         "  longtable resume [--cwd <path>] [--json]",
-        "  longtable doctor [--cwd <path>] [--fix] [--json] [--codex-dir <path>] [--claude-dir <path>] [--codex-prompts-dir <path>] [--codex-runtime-path <file>] [--claude-runtime-path <file>]",
-        "  longtable status [--cwd <path>] [--fix] [--json] [--codex-dir <path>] [--claude-dir <path>] [--codex-prompts-dir <path>] [--codex-runtime-path <file>] [--claude-runtime-path <file>]",
+        "  longtable doctor [--cwd <path>] [--fix] [--json] [--codex-dir <path>] [--codex-config <path>] [--claude-dir <path>] [--codex-prompts-dir <path>] [--codex-runtime-path <file>] [--claude-runtime-path <file>]",
+        "  longtable status [--cwd <path>] [--fix] [--json] [--codex-dir <path>] [--codex-config <path>] [--claude-dir <path>] [--codex-prompts-dir <path>] [--codex-runtime-path <file>] [--claude-runtime-path <file>]",
         "  longtable roles [--json]",
         "  longtable show [--json] [--path <file>]",
         "  longtable install [--json] [--path <file>] [--runtime-path <file>]",
-        "  longtable mcp install [--provider codex|claude|all] [--write] [--json] [--codex-config <path>] [--claude-settings <path>] [--package <spec>]",
-        "  longtable hud [--watch] [--tmux] [--preset minimal|full] [--cwd <path>] [--json]",
+        "  longtable mcp install [--provider codex|claude|all] [--write] [--checkpoint-ui off|interactive|strong] [--json] [--codex-config <path>] [--claude-settings <path>] [--package <spec>]",
         "  longtable sentinel --prompt <text> [--cwd <path>] [--json] [--record]",
         "  longtable team --prompt <text> [--role <role[,role]>] [--tmux] [--debate] [--rounds 5] [--cwd <path>] [--json]",
         "  longtable ask [--prompt <text>] [--print] [--json] [--setup <path>] [--cwd <path>]",
@@ -126,7 +125,7 @@ function parseArgs(argv) {
     const values = {};
     let subcommand = maybeSubcommand;
     const modeCommand = command && VALID_MODES.has(command);
-    const directCommand = command && ["init", "setup", "start", "resume", "doctor", "status", "roles", "show", "install", "mcp", "codex", "claude", "ask", "clarify", "question", "panel", "decide", "hud", "sentinel", "team"].includes(command);
+    const directCommand = command && ["init", "setup", "start", "resume", "doctor", "status", "roles", "show", "install", "mcp", "codex", "claude", "ask", "clarify", "question", "panel", "decide", "sentinel", "team"].includes(command);
     let startIndex = 1;
     if (modeCommand) {
         subcommand = undefined;
@@ -619,6 +618,23 @@ function buildPermissionSetupChoices() {
                 description: "Why: maximizes judgment protection. What you get: stricter checkpoints. Tradeoff: more interruption before closure."
             }
         ],
+        checkpointUi: [
+            {
+                id: "strong",
+                label: "Strong Researcher Checkpoint UI",
+                description: "Why: uses Codex MCP elicitation for high-responsibility research decisions. What you get: clickable checkpoints with other/rationale. Tradeoff: requires Codex MCP elicitation approval."
+            },
+            {
+                id: "interactive",
+                label: "Interactive checkpoint UI",
+                description: "Why: keeps UI prompts available for required checkpoints. What you get: MCP form checkpoints when supported. Tradeoff: requires Codex MCP elicitation approval."
+            },
+            {
+                id: "off",
+                label: "Text fallback only",
+                description: "Why: safest transport boundary. What you get: numbered checkpoints and terminal selectors only. Tradeoff: no Codex UI form prompts."
+            }
+        ],
         workspace: [
             {
                 id: "create",
@@ -696,9 +712,18 @@ function parseSetupSurface(value) {
 function parseSetupIntervention(value) {
     return value === "advisory" || value === "balanced" || value === "strong" ? value : undefined;
 }
+function parseSetupCheckpointUi(value) {
+    return value === "off" || value === "interactive" || value === "strong" ? value : undefined;
+}
 function parseSetupWorkspace(value) {
     return value === "create" || value === "later" ? value : undefined;
 }
+function checkpointUiRequiresMcp(choice) {
+    return choice === "interactive" || choice === "strong";
+}
+function checkpointUiIntervention(intervention, checkpointUi) {
+    return checkpointUi === "strong" ? "strong" : intervention;
+}
 async function runSetup(args) {
     const json = args.json === true;
     const rl = createInterface({ input, output });
@@ -713,13 +738,26 @@ async function runSetup(args) {
             "This is a permission choice because skills, MCP, and sentinel support write provider-facing runtime files."
         ].join("\n"), choices.surfaces);
         const intervention = parseSetupIntervention(args.intervention) ?? await promptChoice(rl, "How strongly may LongTable interrupt research decisions?", choices.intervention);
+        const parsedCheckpointUi = parseSetupCheckpointUi(args["checkpoint-ui"]);
+        const checkpointUiEligible = provider === "codex" && installScope !== "none" && shouldInstallMcp(installScope, surfaces);
+        if (parsedCheckpointUi && checkpointUiRequiresMcp(parsedCheckpointUi) && !checkpointUiEligible) {
+            throw new Error("`--checkpoint-ui interactive|strong` requires Codex with an MCP runtime surface.");
+        }
+        const checkpointUi = parsedCheckpointUi ?? (checkpointUiEligible
+            ? await promptChoice(rl, [
+                "Should Codex use UI Researcher Checkpoints when MCP elicitation is available?",
+                "This writes Codex MCP elicitation approval only when you choose an interactive mode."
+            ].join("\n"), choices.checkpointUi)
+            : "off");
         const workspacePreference = parseSetupWorkspace(args.workspace) ?? await promptChoice(rl, "Should LongTable create a project workspace now?", choices.workspace);
         const projectRoot = setupProjectRoot(args);
+        const effectiveIntervention = checkpointUiIntervention(intervention, checkpointUi);
         const outputValue = createPersistedSetupOutput({
             field: "unspecified",
             careerStage: "unspecified",
             experienceLevel: "advanced",
-            preferredCheckpointIntensity: checkpointIntensityFromIntervention(intervention),
+            preferredCheckpointIntensity: checkpointIntensityFromIntervention(effectiveIntervention),
+            checkpointUiMode: checkpointUi,
             preferredEntryMode: "explore",
             panelPreference: "show_on_conflict"
         }, provider, "quickstart");
@@ -727,7 +765,8 @@ async function runSetup(args) {
             ...outputValue.initialState.explicitState,
             installScope,
             runtimeSurfaces: surfaces,
-            interventionPosture: intervention,
+            interventionPosture: effectiveIntervention,
+            checkpointUiMode: checkpointUi,
             workspaceCreationPreference: workspacePreference,
             tmuxMode: "standard",
             teamMode: "panel"
@@ -759,7 +798,12 @@ async function runSetup(args) {
                 : await installClaudeSkills(listRoleDefinitions(), scopedInstallDir);
         let mcpInstall;
         if (shouldInstallMcp(installScope, surfaces)) {
-            mcpInstall = await installMcpForSetup(provider, mcpArgsForScope(provider, installScope, args, projectRoot));
+            mcpInstall = await installMcpForSetup(provider, {
+                ...mcpArgsForScope(provider, installScope, args, projectRoot),
+                ...(provider === "codex" && checkpointUiRequiresMcp(checkpointUi)
+                    ? { "checkpoint-ui": checkpointUi }
+                    : {})
+            });
         }
         if (json) {
             console.log(JSON.stringify({
@@ -786,6 +830,10 @@ async function runSetup(args) {
         if (mcpInstall) {
             console.log("");
             console.log(renderMcpInstallSummary(mcpInstall));
+            if (provider === "codex" && checkpointUiRequiresMcp(checkpointUi)) {
+                console.log("");
+                console.log("Restart Codex after this config change, then run `longtable doctor` in the project workspace.");
+            }
         }
         if (surfaces === "skills_mcp_sentinel") {
             console.log("");
@@ -1112,15 +1160,36 @@ function renderCodexMcpBlock(serverName, command, mcpArgs) {
         LONGTABLE_MCP_MARKER_END
     ].join("\n");
 }
+function codexElicitationApprovalLine() {
+    return "approval_policy = { granular = { mcp_elicitations = true } }";
+}
+function enableCodexMcpElicitations(existing) {
+    const line = codexElicitationApprovalLine();
+    if (/approval_policy\s*=\s*\{[^\n]*mcp_elicitations\s*=\s*true[^\n]*\}/m.test(existing)) {
+        return existing;
+    }
+    if (/^approval_policy\s*=.*$/m.test(existing)) {
+        return existing.replace(/^approval_policy\s*=.*$/m, line);
+    }
+    const trimmed = existing.trimEnd();
+    return trimmed ? `${line}\n${trimmed}\n` : `${line}\n`;
+}
+function codexMcpElicitationsAllowed(config) {
+    return /approval_policy\s*=\s*\{[^\n]*mcp_elicitations\s*=\s*true[^\n]*\}/m.test(config);
+}
+function codexLongTableMcpConfigured(config) {
+    return new RegExp(`\\[mcp_servers\\.${LONGTABLE_MCP_SERVER_NAME.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\]`).test(config);
+}
 function replaceMarkedCodexMcpBlock(existing, block, serverName) {
     const markerPattern = new RegExp(`${LONGTABLE_MCP_MARKER_START.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}[\\s\\S]*?${LONGTABLE_MCP_MARKER_END.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\n?`, "m");
     const serverPattern = new RegExp(`\\n?\\[mcp_servers\\.${serverName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\][\\s\\S]*?(?=\\n\\[|$)`, "m");
     const trimmed = existing.replace(markerPattern, "").replace(serverPattern, "").trimEnd();
     return trimmed ? `${trimmed}\n\n${block}\n` : `${block}\n`;
 }
-async function writeCodexMcpConfig(path, block, serverName) {
+async function writeCodexMcpConfig(path, block, serverName, options = {}) {
     const existing = existsSync(path) ? await readFile(path, "utf8") : "";
-    const updated = replaceMarkedCodexMcpBlock(existing, block, serverName);
+    const withMcp = replaceMarkedCodexMcpBlock(existing, block, serverName);
+    const updated = options.enableElicitations ? enableCodexMcpElicitations(withMcp) : withMcp;
     await mkdir(dirname(path), { recursive: true });
     await writeFile(path, updated, "utf8");
     return updated;
@@ -1163,6 +1232,9 @@ function renderMcpInstallSummary(result) {
         `- package: ${result.packageSpec}`,
         `- command: ${result.command} ${result.args.join(" ")}`,
         `- mode: ${result.write ? "wrote provider config" : "printed config only"}`,
+        ...(result.checkpointUi && checkpointUiRequiresMcp(result.checkpointUi)
+            ? [`- Codex checkpoint UI: ${result.checkpointUi} (MCP elicitations allowed)`]
+            : []),
         ""
     ];
     for (const target of result.targets) {
@@ -1175,6 +1247,9 @@ function renderMcpInstallSummary(result) {
     if (!result.write) {
         lines.push("Run again with `--write` to update these provider config files.");
     }
+    if (result.checkpointUi && checkpointUiRequiresMcp(result.checkpointUi)) {
+        lines.push("Restart Codex after changing MCP elicitation approval, then run `longtable doctor`.");
+    }
     return lines.join("\n").trimEnd();
 }
 async function installMcpForSetup(provider, args) {
@@ -1184,11 +1259,14 @@ async function installMcpForSetup(provider, args) {
     const packageSpec = resolveMcpPackageSpec(args);
     const command = typeof args.command === "string" && args.command.trim() ? args.command.trim() : "npx";
     const mcpArgs = command === "npx" ? ["-y", packageSpec] : [packageSpec];
+    const checkpointUi = parseSetupCheckpointUi(args["checkpoint-ui"]) ?? "off";
     const targets = [];
     if (provider === "codex") {
         const path = resolveCodexMcpConfigPath(args);
         const block = renderCodexMcpBlock(serverName, command, mcpArgs);
-        const content = await writeCodexMcpConfig(path, block, serverName);
+        const content = await writeCodexMcpConfig(path, block, serverName, {
+            enableElicitations: checkpointUiRequiresMcp(checkpointUi)
+        });
         targets.push({ provider, path, format: "toml", content });
     }
     if (provider === "claude") {
@@ -1202,6 +1280,7 @@ async function installMcpForSetup(provider, args) {
         command,
         args: mcpArgs,
         write: true,
+        checkpointUi,
         targets
     };
 }
@@ -1215,12 +1294,22 @@ async function runMcpSubcommand(subcommand, args) {
         const mcpArgs = command === "npx" ? ["-y", packageSpec] : [packageSpec];
         const providers = resolveMcpProviders(args.provider);
         const write = args.write === true;
+        const checkpointUi = parseSetupCheckpointUi(args["checkpoint-ui"]) ?? "off";
+        if (checkpointUiRequiresMcp(checkpointUi) && !providers.includes("codex")) {
+            throw new Error("`--checkpoint-ui interactive|strong` applies only to the Codex MCP provider.");
+        }
         const targets = [];
         for (const provider of providers) {
             if (provider === "codex") {
                 const path = resolveCodexMcpConfigPath(args);
                 const block = renderCodexMcpBlock(serverName, command, mcpArgs);
-                const content = write ? await writeCodexMcpConfig(path, block, serverName) : block;
+                const content = write
+                    ? await writeCodexMcpConfig(path, block, serverName, {
+                        enableElicitations: checkpointUiRequiresMcp(checkpointUi)
+                    })
+                    : checkpointUiRequiresMcp(checkpointUi)
+                        ? enableCodexMcpElicitations(block)
+                        : block;
                 targets.push({ provider, path, format: "toml", content });
             }
             if (provider === "claude") {
@@ -1237,6 +1326,7 @@ async function runMcpSubcommand(subcommand, args) {
             command,
             args: mcpArgs,
             write,
+            checkpointUi,
             targets
         };
         if (args.json === true) {
@@ -1261,6 +1351,13 @@ function missingNames(expected, installed) {
     const installedSet = new Set(installed);
     return expected.filter((name) => !installedSet.has(name));
 }
+function resolveDoctorCodexMcpConfigPath(args) {
+    if (typeof args["codex-config"] === "string" && args["codex-config"].trim()) {
+        return resolve(normalizeUserPath(args["codex-config"].trim()));
+    }
+    const projectScoped = join(typeof args.cwd === "string" ? resolve(args.cwd) : cwd(), ".codex", "config.toml");
+    return existsSync(projectScoped) ? projectScoped : resolveCodexMcpConfigPath(args);
+}
 function setupForProvider(setup, provider) {
     return {
         ...setup,
@@ -1310,6 +1407,10 @@ async function collectDoctorStatus(args) {
             : undefined;
     const codexRuntimePath = resolveDefaultRuntimeConfigPath("codex", codexRuntimeOverride).path;
     const claudeRuntimePath = resolveDefaultRuntimeConfigPath("claude", claudeRuntimeOverride).path;
+    const codexMcpConfigPath = resolveDoctorCodexMcpConfigPath(args);
+    const codexMcpConfig = existsSync(codexMcpConfigPath)
+        ? await readFile(codexMcpConfigPath, "utf8")
+        : "";
     const expectedCodexSkills = buildCodexSkillSpecs(roles).map((skill) => skill.name);
     const expectedClaudeSkills = buildClaudeSkillSpecs(roles).map((skill) => skill.name);
     const [codexSkills, claudeSkills, codexAliases, workspace] = await Promise.all([
@@ -1334,7 +1435,11 @@ async function collectDoctorStatus(args) {
                 installedSkills: installedCodexSkills,
                 missingSkills: missingNames(expectedCodexSkills, installedCodexSkills),
                 promptsDir: resolveCodexPromptsDir(codexPromptsDir),
-                legacyPromptFilesInstalled: codexAliases.map((alias) => alias.name)
+                legacyPromptFilesInstalled: codexAliases.map((alias) => alias.name),
+                mcpConfigPath: codexMcpConfigPath,
+                mcpConfigExists: existsSync(codexMcpConfigPath),
+                longtableMcpConfigured: codexLongTableMcpConfigured(codexMcpConfig),
+                mcpElicitationsAllowed: codexMcpElicitationsAllowed(codexMcpConfig)
             },
             claude: {
                 command: "claude",
@@ -1373,6 +1478,9 @@ function renderDoctorStatus(status) {
         ...(status.providers.codex.legacyPromptFilesInstalled.length > 0
             ? [`- legacy prompt names: ${status.providers.codex.legacyPromptFilesInstalled.join(", ")}`]
             : []),
+        `- MCP config: ${status.providers.codex.mcpConfigExists ? "present" : "missing"} (${status.providers.codex.mcpConfigPath})`,
+        `- LongTable MCP: ${status.providers.codex.longtableMcpConfigured ? "configured" : "missing"}`,
+        `- MCP elicitation approval: ${status.providers.codex.mcpElicitationsAllowed ? "allowed" : "not allowed"}`,
         "",
         ...renderProviderDoctorBlock("Claude", status.providers.claude),
         "",
@@ -2130,6 +2238,9 @@ function sentinelSummary(prompt, workingDirectory) {
     if (/method|design|sample|participant|방법|설계|표본|참여자/.test(normalized)) {
         signals.push("method/design gap");
     }
+    if (/knowledge gap|unknown|uncertain|not sure|don't know|dont know|지식의 공백|지식 공백|모르겠|불확실/.test(normalized)) {
+        signals.push("knowledge gap");
+    }
     if (/citation|reference|source|evidence|doi|문헌|인용|근거|출처/.test(normalized)) {
         signals.push("evidence gap");
     }
@@ -2188,63 +2299,6 @@ async function runSentinel(args) {
         console.log(context ? `- recorded in: ${context.stateFilePath}` : "- record skipped: no LongTable workspace found");
     }
 }
-function renderHudText(inspection, preset) {
-    if (!inspection.found) {
-        return [
-            "LongTable HUD",
-            "- workspace: not found",
-            "- run `longtable start` for durable research state"
-        ].join("\n");
-    }
-    const lines = [
-        "LongTable HUD",
-        `- project: ${inspection.project?.name}`,
-        `- goal: ${inspection.session?.currentGoal}`,
-        ...(inspection.session?.currentBlocker ? [`- blocker: ${inspection.session.currentBlocker}`] : []),
-        `- questions: ${inspection.counts?.pendingQuestions ?? 0} pending / ${inspection.counts?.questions ?? 0} total`,
-        `- decisions: ${inspection.counts?.decisions ?? 0}`,
-        `- invocations: ${inspection.counts?.invocations ?? 0}`
-    ];
-    if (preset !== "minimal") {
-        lines.push("- pending checkpoints:");
-        for (const question of inspection.pendingQuestions ?? []) {
-            lines.push(`  - ${question.required ? "required" : "advisory"}: ${question.question}`);
-        }
-        lines.push("- recent decisions:");
-        for (const decision of inspection.recentDecisions ?? []) {
-            lines.push(`  - ${decision.summary}`);
-        }
-    }
-    return lines.join("\n");
-}
-async function runHud(args) {
-    const workingDirectory = typeof args.cwd === "string" ? args.cwd : cwd();
-    const preset = typeof args.preset === "string" ? args.preset : "full";
-    if (args.tmux === true) {
-        if (!process.env.TMUX) {
-            throw new Error("`longtable hud --tmux` must be run inside an existing tmux session.");
-        }
-        const launcher = process.argv[1] ?? "longtable";
-        const command = `node ${shellEscape(launcher)} hud --watch --preset ${shellEscape(preset)} --cwd ${shellEscape(workingDirectory)}`;
-        execFileSync("tmux", ["split-window", "-v", "-l", "10", command], { stdio: "inherit" });
-        return;
-    }
-    while (true) {
-        const inspection = await inspectProjectWorkspace(workingDirectory);
-        if (args.json === true) {
-            console.log(JSON.stringify(inspection, null, 2));
-            return;
-        }
-        if (args.watch === true) {
-            process.stdout.write("\u001Bc");
-        }
-        console.log(renderHudText(inspection, preset));
-        if (args.watch !== true) {
-            return;
-        }
-        await new Promise((resolvePromise) => setTimeout(resolvePromise, 1500));
-    }
-}
 async function runTeam(args) {
     const workingDirectory = typeof args.cwd === "string" ? args.cwd : cwd();
     const prompt = await resolvePrompt(typeof args.prompt === "string" ? args.prompt : undefined);
@@ -2722,10 +2776,6 @@ async function main() {
         await runPanelCommand(values);
         return;
     }
-    if (command === "hud") {
-        await runHud(values);
-        return;
-    }
     if (command === "sentinel") {
         await runSentinel(values);
         return;

package/dist/project-session.js

@@ -466,7 +466,13 @@ export async function assertWorkspaceNotBlocked(context) {
         `Record an answer with: longtable decide --question ${first.id} --answer <value>`
     ].join("\n"));
 }
-function questionTitleForCheckpoint(family) {
+function questionTitleForCheckpoint(family, checkpointKey) {
+    if (checkpointKey === "knowledge_gap_probe") {
+        return "Knowledge-gap checkpoint";
+    }
+    if (checkpointKey === "tacit_assumption_probe") {
+        return "Tacit-assumption checkpoint";
+    }
     switch (family) {
         case "meta_decision":
             return "Meta-decision checkpoint";
@@ -486,7 +492,13 @@ function questionTitleForCheckpoint(family) {
             return "Researcher Checkpoint";
     }
 }
-function questionTextForCheckpoint(family, prompt) {
+function questionTextForCheckpoint(family, prompt, checkpointKey) {
+    if (checkpointKey === "knowledge_gap_probe") {
+        return "What knowledge gap should LongTable make explicit before narrowing or recommending a direction?";
+    }
+    if (checkpointKey === "tacit_assumption_probe") {
+        return "What tacit assumption should LongTable surface before treating this direction as acceptable?";
+    }
     switch (family) {
         case "meta_decision":
             return "What should LongTable do before treating this platform decision as settled?";
@@ -505,6 +517,22 @@ function questionTextForCheckpoint(family, prompt) {
     }
 }
 function optionsForCheckpointTrigger(family, checkpointKey) {
+    if (checkpointKey === "knowledge_gap_probe") {
+        return [
+            { value: "ask_first", label: "Ask the gap question first", description: "Pause synthesis and make the missing knowledge explicit." },
+            { value: "gather_context", label: "Gather context first", description: "Inspect sources, files, or constraints before narrowing." },
+            { value: "proceed_tentatively", label: "Proceed tentatively", description: "Continue, but keep the knowledge gap visible as an open tension." },
+            { value: "defer", label: "Keep the gap open", description: "Do not convert the uncertainty into a recommendation yet." }
+        ];
+    }
+    if (checkpointKey === "tacit_assumption_probe") {
+        return [
+            { value: "surface_assumption", label: "Surface the assumption first", description: "Name the implicit premise before accepting the direction." },
+            { value: "test_assumption", label: "Test the assumption first", description: "Look for evidence or counterexamples before proceeding." },
+            { value: "proceed_with_risk", label: "Proceed while logging the risk", description: "Continue, but record the assumption as unresolved." },
+            { value: "defer", label: "Keep the assumption open", description: "Do not treat this framing as settled yet." }
+        ];
+    }
     if (family === "evidence") {
         return [
             { value: "verify", label: "Verify evidence first", description: "Check whether the source supports the specific claim." },
@@ -744,8 +772,8 @@ export async function createWorkspaceQuestion(options) {
         prompt: {
             id: createId("question_prompt"),
             checkpointKey: trigger.signal.checkpointKey,
-            title: options.title ?? questionTitleForCheckpoint(trigger.family),
-            question: options.question ?? questionTextForCheckpoint(trigger.family, options.prompt),
+            title: options.title ?? questionTitleForCheckpoint(trigger.family, trigger.signal.checkpointKey),
+            question: options.question ?? questionTextForCheckpoint(trigger.family, options.prompt, trigger.signal.checkpointKey),
             type: "single_choice",
             options: optionsForCheckpointTrigger(trigger.family, trigger.signal.checkpointKey),
             allowOther: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longtable/cli",
-  "version": "0.1.21",
+  "version": "0.1.22",
   "private": false,
   "description": "Researcher-facing LongTable CLI",
   "type": "module",
@@ -28,12 +28,12 @@
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@longtable/checkpoints": "0.1.21",
-    "@longtable/core": "0.1.21",
-    "@longtable/memory": "0.1.21",
-    "@longtable/provider-claude": "0.1.21",
-    "@longtable/provider-codex": "0.1.21",
-    "@longtable/setup": "0.1.21"
+    "@longtable/checkpoints": "0.1.22",
+    "@longtable/core": "0.1.22",
+    "@longtable/memory": "0.1.22",
+    "@longtable/provider-claude": "0.1.22",
+    "@longtable/provider-codex": "0.1.22",
+    "@longtable/setup": "0.1.22"
   },
   "devDependencies": {
     "@types/node": "^22.10.1",