@longtable/cli 0.1.38 → 0.1.40

package/README.md

@@ -156,16 +156,21 @@ longtable codex install-skills
 longtable claude install-skills
 ```
 
-Codex skills include `longtable`, `longtable-panel`, and generated role-specific
-skills such as `longtable-methods-critic`. If your Codex build exposes explicit
-skill shortcuts, `$longtable-interview` is the research-start entry and
-`$longtable` is the general router. Do not depend on `/prompts`; current Codex
-builds may reject it.
-
-Claude Code skills include `longtable`, `longtable-panel`, and generated
-role-specific skills such as `longtable-methods-critic`. They also include
-`longtable-interview` for the First Research Shape workflow. They are adapter
-files generated from the LongTable role registry.
+By default, provider skills use the compact surface: `longtable`,
+`longtable-interview`, and five short role shortcuts: `longtable-methods`,
+`longtable-measure`, `longtable-theory`, `longtable-reviewer`, and
+`longtable-voice`. `$longtable` remains the general router and can still invoke
+editor, ethics, venue, panel, explore, or review behavior when the request calls
+for it.
+
+Power users can install the legacy full surface explicitly:
+
+```bash
+longtable codex install-skills --surface full
+longtable claude install-skills --surface full
+```
+
+Do not depend on `/prompts`; current Codex builds may reject it.
 
 ## Panel Orchestration
 

package/dist/cli.js

@@ -17,7 +17,7 @@ import { buildPersonaGuidance, parseInvocationDirective } from "./persona-router
 import { PERSONA_DEFINITIONS, listRoleDefinitions } from "./personas.js";
 import { buildPanelFallback, renderPanelSummary } from "./panel.js";
 import { LONGTABLE_MANAGED_HOOK_EVENTS, codexHooksEnabled, enableCodexHooksFeature, getMissingManagedCodexHookEvents, mergeManagedCodexHooksConfig, removeManagedCodexHooks } from "./codex-hooks.js";
-import { appendInvocationRecordToWorkspace, assertWorkspaceNotBlocked, answerWorkspaceQuestion, buildQuestionOpportunitySpecs, clearWorkspaceQuestion, createWorkspaceFollowUpQuestions, createWorkspaceQuestion, createOrUpdateProjectWorkspace, inspectProjectWorkspace, loadWorkspaceState, loadProjectContextFromDirectory, repairWorkspaceStateConsistency, renderProjectWorkspaceSummary, syncCurrentWorkspaceView } from "./project-session.js";
+import { appendInvocationRecordToWorkspace, assertWorkspaceNotBlocked, answerWorkspaceQuestion, buildQuestionOpportunitySpecs, clearWorkspaceQuestion, createWorkspaceFollowUpQuestions, createWorkspaceQuestion, createOrUpdateProjectWorkspace, inspectProjectWorkspace, loadWorkspaceState, loadProjectContextFromDirectory, pruneWorkspaceQuestions, repairWorkspaceStateConsistency, renderProjectWorkspaceSummary, syncCurrentWorkspaceView } from "./project-session.js";
 import { buildTeamDebate, buildTeamReview, renderTeamDebateSummary } from "./debate.js";
 import { createPromptRenderer } from "./prompt-renderer.js";
 const VALID_MODES = new Set([
@@ -45,7 +45,7 @@ const ANSI = {
     green: "\u001B[32m"
 };
 const LONGTABLE_MCP_SERVER_NAME = "longtable-state";
-const LONGTABLE_MCP_PACKAGE_VERSION = "0.1.38";
+const LONGTABLE_MCP_PACKAGE_VERSION = "0.1.39";
 const LONGTABLE_MCP_MARKER_START = "# LongTable state MCP START";
 const LONGTABLE_MCP_MARKER_END = "# LongTable state MCP END";
 function style(text, prefix) {
@@ -120,16 +120,17 @@ function usage() {
         "  longtable decide [--question <id>] --answer <value-or-text> [--rationale <text>] [--provider codex|claude] [--cwd <path>] [--json]",
         "  longtable explore|review|critique|draft|commit|submit [--prompt <text>] [--role <role[,role]>] [--panel] [--show-conflicts] [--show-deliberation] [--print] [--json] [--stage <stage>] [--setup <path>] [--cwd <path>]",
         "  longtable codex persist-init [--answers-json <json> | --stdin | full setup flags] [--install-skills] [--install-prompts] [--json]",
-        "  longtable codex install-skills [--dir <path>]",
+        "  longtable codex install-skills [--surface compact|full] [--dir <path>]",
         "  longtable codex remove-skills [--dir <path>]",
         "  longtable codex install-prompts [--dir <path>]",
         "  longtable codex remove-prompts [--dir <path>]",
         "  longtable codex install-hooks [--codex-config <path>] [--hooks-path <path>] [--json]",
         "  longtable codex remove-hooks [--codex-config <path>] [--hooks-path <path>] [--json]",
-        "  longtable codex status [--dir <path>] [--codex-config <path>] [--hooks-path <path>] [--json]",
-        "  longtable claude install-skills [--dir <path>]",
+        "  longtable codex status [--surface compact|full] [--dir <path>] [--codex-config <path>] [--hooks-path <path>] [--json]",
+        "  longtable claude install-skills [--surface compact|full] [--dir <path>]",
         "  longtable claude remove-skills [--dir <path>]",
-        "  longtable claude status [--dir <path>] [--json]",
+        "  longtable claude status [--surface compact|full] [--dir <path>] [--json]",
+        "  longtable prune-questions [--cwd <path>] [--dry-run] [--json]",
         "  longtable mcp install --provider all",
         "",
         "Examples:",
@@ -150,7 +151,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", "audit", "roles", "show", "install", "mcp", "codex", "claude", "ask", "clarify", "question", "clear-question", "panel", "decide", "sentinel", "team", "search"].includes(command);
+    const directCommand = command && ["init", "setup", "start", "resume", "doctor", "status", "audit", "roles", "show", "install", "mcp", "codex", "claude", "ask", "clarify", "question", "clear-question", "prune-questions", "panel", "decide", "sentinel", "team", "search"].includes(command);
     let startIndex = 1;
     if (modeCommand) {
         subcommand = undefined;
@@ -238,6 +239,16 @@ function questionSection(questionId) {
 function formatModeLabel(mode) {
     return `${mode[0].toUpperCase()}${mode.slice(1)}`;
 }
+function parseSkillSurface(args) {
+    const value = args.surface;
+    if (value === undefined || value === true) {
+        return "compact";
+    }
+    if (value === "compact" || value === "full") {
+        return value;
+    }
+    throw new Error("Invalid --surface value. Use compact or full.");
+}
 function stripWrappingQuotes(value) {
     const trimmed = value.trim();
     if ((trimmed.startsWith("\"") && trimmed.endsWith("\"")) ||
@@ -1416,6 +1427,7 @@ function setupForProvider(setup, provider) {
 }
 async function collectDoctorStatus(args) {
     const roles = listRoleDefinitions();
+    const skillSurface = parseSkillSurface(args);
     const setupOverride = typeof args.setup === "string"
         ? args.setup
         : typeof args.path === "string"
@@ -1458,11 +1470,11 @@ async function collectDoctorStatus(args) {
     const missingManagedHookEvents = codexHooksContent
         ? (getMissingManagedCodexHookEvents(codexHooksContent) ?? [...LONGTABLE_MANAGED_HOOK_EVENTS])
         : [...LONGTABLE_MANAGED_HOOK_EVENTS];
-    const expectedCodexSkills = buildCodexSkillSpecs(roles).map((skill) => skill.name);
-    const expectedClaudeSkills = buildClaudeSkillSpecs(roles).map((skill) => skill.name);
+    const expectedCodexSkills = buildCodexSkillSpecs(roles, skillSurface).map((skill) => skill.name);
+    const expectedClaudeSkills = buildClaudeSkillSpecs(roles, skillSurface).map((skill) => skill.name);
     const [codexSkills, claudeSkills, codexAliases, workspace] = await Promise.all([
-        listInstalledCodexSkills(roles, codexDir),
-        listInstalledClaudeSkills(roles, claudeDir),
+        listInstalledCodexSkills(roles, codexDir, skillSurface),
+        listInstalledClaudeSkills(roles, claudeDir, skillSurface),
         listInstalledCodexPromptAliases(codexPromptsDir),
         inspectProjectWorkspace(typeof args.cwd === "string" ? args.cwd : cwd())
     ]);
@@ -1646,6 +1658,7 @@ function renderRepairSummary(repair) {
 }
 async function repairDoctorStatus(args, status) {
     const roles = listRoleDefinitions();
+    const skillSurface = parseSkillSurface(args);
     const codexDir = typeof args["codex-dir"] === "string"
         ? args["codex-dir"]
         : typeof args.dir === "string"
@@ -1684,10 +1697,10 @@ async function repairDoctorStatus(args, status) {
         skipped: []
     };
     if (status.providers.codex.missingSkills.length > 0) {
-        repair.installedCodexSkills = (await installCodexSkills(roles, codexDir)).map((skill) => skill.name);
+        repair.installedCodexSkills = (await installCodexSkills(roles, codexDir, skillSurface)).map((skill) => skill.name);
     }
     if (status.providers.claude.missingSkills.length > 0) {
-        repair.installedClaudeSkills = (await installClaudeSkills(roles, claudeDir)).map((skill) => skill.name);
+        repair.installedClaudeSkills = (await installClaudeSkills(roles, claudeDir, skillSurface)).map((skill) => skill.name);
     }
     if (status.providers.codex.legacyPromptFilesInstalled.length > 0) {
         repair.removedLegacyPromptFiles = await removeCodexPromptAliases(codexPromptsDir);
@@ -1851,10 +1864,10 @@ function runRoleAudit() {
         "longtable-review"
     ]);
     const roles = [
-        ...buildCodexSkillSpecs(listRoleDefinitions())
+        ...buildCodexSkillSpecs(listRoleDefinitions(), "full")
             .filter((spec) => !baseSkillNames.has(spec.name))
             .map((spec) => buildRoleAuditEntry("codex", spec)),
-        ...buildClaudeSkillSpecs(listRoleDefinitions())
+        ...buildClaudeSkillSpecs(listRoleDefinitions(), "full")
             .filter((spec) => !baseSkillNames.has(spec.name))
             .map((spec) => buildRoleAuditEntry("claude", spec))
     ];
@@ -2671,6 +2684,41 @@ async function runClearQuestion(args) {
     console.log(`- state: ${context.stateFilePath}`);
     console.log(`- current: ${context.currentFilePath}`);
 }
+async function runPruneQuestions(args) {
+    const workingDirectory = typeof args.cwd === "string" ? args.cwd : cwd();
+    const context = await loadProjectContextFromDirectory(workingDirectory);
+    if (!context) {
+        throw new Error("No LongTable project workspace was found here. Run this inside a project or pass --cwd.");
+    }
+    const dryRun = args["dry-run"] === true;
+    const result = await pruneWorkspaceQuestions({
+        context,
+        dryRun
+    });
+    if (args.json === true) {
+        console.log(JSON.stringify({
+            dryRun,
+            removedCount: result.removedQuestions.length,
+            removedQuestions: result.removedQuestions.map((question) => ({
+                id: question.id,
+                title: question.prompt.title,
+                reason: question.clearedReason
+            })),
+            files: {
+                state: context.stateFilePath,
+                current: context.currentFilePath
+            }
+        }, null, 2));
+        return;
+    }
+    console.log(dryRun ? "LongTable question prune preview" : "LongTable questions pruned");
+    console.log(`- removed false-positive cleared questions: ${result.removedQuestions.length}`);
+    for (const question of result.removedQuestions) {
+        console.log(`  - ${question.id}: ${question.prompt.title}`);
+    }
+    console.log(`- state: ${context.stateFilePath}`);
+    console.log(`- current: ${context.currentFilePath}`);
+}
 function isInteractiveTerminal() {
     return Boolean(input.isTTY && output.isTTY);
 }
@@ -2805,10 +2853,24 @@ async function runClarify(args) {
     console.log(`- state: ${context.stateFilePath}`);
     console.log(`- current: ${context.currentFilePath}`);
 }
+function looksLikeProductOrToolingPrompt(prompt) {
+    return /\b(longlongtable|hook|checkpoint|mcp|agents?|skills?|ux|interface|setup|install|cli|npm|version|global|release|deploy|git|github|readme|docs?|documentation|workflow|package|router|autocomplete|simulation test)\b/i.test(prompt)
+        || /롱테이블|훅|체크포인트|에이전트|스킬|사용성|인터페이스|설치|세팅|글로벌|배포|버전|릴리즈|깃|깃허브|문서화된\s*절차|패키지|라우터|자동완성|시뮬레이션\s*테스트/.test(prompt);
+}
+function looksLikeResearchCommitmentPrompt(prompt) {
+    const researchCue = /\b(research|study|paper|manuscript|journal|article|method|methodology|measurement|construct|theory|analysis|model|data|participant|sample|scale|survey|instrument|validity|hypothesis|literature|meta[- ]?analysis|gold standard|coding|trust|reliance|calibration)\b/i.test(prompt)
+        || /연구|논문|원고|저널|방법론|방법|연구\s*설계|측정|구성개념|개념|이론|분석|모형|모델|데이터|참가자|표본|샘플|척도|설문|도구|타당도|가설|문헌|메타\s*분석|골드\s*스탠더드|코딩|신뢰|의존|캘리브레이션|교정|보정/.test(prompt);
+    const closureCue = /\b(final|finalize|commit|ship|submit|publish|freeze|settle|decide|lock|record|apply|incorporate)\b/i.test(prompt)
+        || /최종|확정|커밋|제출|투고|고정|결정|기록|반영/.test(prompt);
+    return researchCue && closureCue;
+}
 async function runAutomaticFollowUpIfNeeded(prompt, args) {
     if (args["no-clarify"] === true || args.print === true || args.json === true) {
         return false;
     }
+    if (looksLikeProductOrToolingPrompt(prompt) || !looksLikeResearchCommitmentPrompt(prompt)) {
+        return false;
+    }
     const workingDirectory = typeof args.cwd === "string" ? args.cwd : cwd();
     const context = await loadProjectContextFromDirectory(workingDirectory);
     if (!context) {
@@ -2820,7 +2882,8 @@ async function runAutomaticFollowUpIfNeeded(prompt, args) {
         prompt,
         provider,
         required: true,
-        auto: true
+        auto: true,
+        requiredOnly: true
     });
     if (result.questions.length === 0) {
         return false;
@@ -3241,11 +3304,12 @@ async function runResume(args) {
 async function runCodexSubcommand(subcommand, args) {
     const customDir = typeof args.dir === "string" ? args.dir : undefined;
     const roles = listRoleDefinitions();
+    const skillSurface = parseSkillSurface(args);
     if (subcommand === "install-skills") {
-        const installed = await installCodexSkills(roles, customDir);
-        console.log(`Installed ${installed.length} LongTable Codex skills in ${resolveCodexSkillsDir(customDir)}`);
+        const installed = await installCodexSkills(roles, customDir, skillSurface);
+        console.log(`Installed ${installed.length} LongTable Codex skills in ${resolveCodexSkillsDir(customDir)} (${skillSurface} surface)`);
         console.log("Use them inside Codex with natural-language triggers such as `lt explore: ...` or `lt panel: ...`.");
-        console.log("If you want an explicit trigger, use `$longtable` when your Codex build exposes skills that way.");
+        console.log("Use `$longtable` as the general router; compact installs expose only the most common role shortcuts.");
         for (const skill of installed) {
             console.log(`- ${skill.name}`);
         }
@@ -3295,7 +3359,7 @@ async function runCodexSubcommand(subcommand, args) {
     }
     if (subcommand === "status") {
         const aliases = await listInstalledCodexPromptAliases(customDir);
-        const skills = await listInstalledCodexSkills(roles, customDir);
+        const skills = await listInstalledCodexSkills(roles, customDir, skillSurface);
         const setupPath = resolveDefaultSetupPath(typeof args.path === "string" ? args.path : undefined).path;
         const runtimePath = resolveDefaultRuntimeConfigPath("codex", typeof args["runtime-path"] === "string" ? args["runtime-path"] : undefined).path;
         const configPath = resolveCodexMcpConfigPath(args);
@@ -3308,6 +3372,7 @@ async function runCodexSubcommand(subcommand, args) {
             runtimePath,
             runtimeExists: existsSync(runtimePath),
             skillsDir: resolveCodexSkillsDir(customDir),
+            skillSurface,
             skillsInstalled: skills.map((skill) => skill.name),
             promptsDir: resolveCodexPromptsDir(customDir),
             legacyPromptFilesInstalled: aliases.map((alias) => alias.name),
@@ -3327,6 +3392,7 @@ async function runCodexSubcommand(subcommand, args) {
         console.log(`- setup: ${status.setupExists ? "present" : "missing"} (${setupPath})`);
         console.log(`- codex runtime artifact: ${status.runtimeExists ? "present" : "missing"} (${runtimePath})`);
         console.log(`- skills dir: ${status.skillsDir}`);
+        console.log(`- skill surface: ${status.skillSurface}`);
         if (skills.length === 0) {
             console.log("- skills: none");
         }
@@ -3358,9 +3424,10 @@ async function runCodexSubcommand(subcommand, args) {
 async function runClaudeSubcommand(subcommand, args) {
     const customDir = typeof args.dir === "string" ? args.dir : undefined;
     const roles = listRoleDefinitions();
+    const skillSurface = parseSkillSurface(args);
     if (subcommand === "install-skills") {
-        const installed = await installClaudeSkills(roles, customDir);
-        console.log(`Installed ${installed.length} LongTable Claude skills in ${resolveClaudeSkillsDir(customDir)}`);
+        const installed = await installClaudeSkills(roles, customDir, skillSurface);
+        console.log(`Installed ${installed.length} LongTable Claude skills in ${resolveClaudeSkillsDir(customDir)} (${skillSurface} surface)`);
         console.log("Use them inside Claude Code with natural-language triggers such as `lt explore: ...` or `lt panel: ...`.");
         for (const skill of installed) {
             console.log(`- ${skill.name}`);
@@ -3373,7 +3440,7 @@ async function runClaudeSubcommand(subcommand, args) {
         return;
     }
     if (subcommand === "status") {
-        const skills = await listInstalledClaudeSkills(roles, customDir);
+        const skills = await listInstalledClaudeSkills(roles, customDir, skillSurface);
         const setupPath = resolveDefaultSetupPath(typeof args.path === "string" ? args.path : undefined).path;
         const runtimePath = resolveDefaultRuntimeConfigPath("claude", typeof args["runtime-path"] === "string" ? args["runtime-path"] : undefined).path;
         const status = {
@@ -3382,6 +3449,7 @@ async function runClaudeSubcommand(subcommand, args) {
             runtimePath,
             runtimeExists: existsSync(runtimePath),
             skillsDir: resolveClaudeSkillsDir(customDir),
+            skillSurface,
             skillsInstalled: skills.map((skill) => skill.name)
         };
         if (args.json === true) {
@@ -3392,6 +3460,7 @@ async function runClaudeSubcommand(subcommand, args) {
         console.log(`- setup: ${status.setupExists ? "present" : "missing"} (${setupPath})`);
         console.log(`- claude runtime artifact: ${status.runtimeExists ? "present" : "missing"} (${runtimePath})`);
         console.log(`- skills dir: ${status.skillsDir}`);
+        console.log(`- skill surface: ${status.skillSurface}`);
         if (skills.length === 0) {
             console.log("- skills: none");
         }
@@ -3472,6 +3541,10 @@ async function main() {
         await runClearQuestion(values);
         return;
     }
+    if (command === "prune-questions") {
+        await runPruneQuestions(values);
+        return;
+    }
     if (command === "panel") {
         await runPanelCommand(values);
         return;

package/dist/longtable-codex-native-hook.js

@@ -1,5 +1,5 @@
 import { pathToFileURL } from "node:url";
-import { createWorkspaceFollowUpQuestions, loadProjectContextFromDirectory, loadWorkspaceState, pendingQuestionObligations } from "./index.js";
+import { buildQuestionOpportunitySpecs, createWorkspaceFollowUpQuestions, loadProjectContextFromDirectory, loadWorkspaceState, pendingQuestionObligations } from "./index.js";
 function safeString(value) {
     return typeof value === "string" ? value : "";
 }
@@ -107,43 +107,50 @@ function looksLikeClosurePrompt(prompt) {
     if (!normalized) {
         return false;
     }
-    return /\b(final|finalize|commit|ship|submit|revise|rewrite|draft|publish|implement|fix)\b/i.test(normalized)
-        || /최종|확정|커밋|제출|수정|초안|구현|진행|고쳐/.test(normalized);
+    return /\b(final|finalize|commit|ship|submit|publish|freeze|settle|decide|lock|record|apply|incorporate)\b/i.test(normalized)
+        || /최종|확정|커밋|제출|투고|고정|결정|기록|반영/.test(normalized);
 }
-function looksLikeExecutionDirective(prompt) {
+function looksLikeLongTableProductOrToolingPrompt(prompt) {
     const normalized = prompt.trim();
     if (!normalized) {
         return false;
     }
-    return /\b(proceed|implement|fix|publish|release|deploy|tag|push|ship)\b/i.test(normalized)
-        || /진행|구현|수정|고쳐|배포|릴리즈|태그|푸시|출시/.test(normalized);
+    return /\b(longlongtable|hook|checkpoint|mcp|agents?|skills?|ux|interface|setup|install|cli|npm|version|global|release|deploy|git|github|readme|docs?|documentation|workflow|package|router|autocomplete|simulation test)\b/i.test(normalized)
+        || /롱테이블|훅|체크포인트|에이전트|스킬|사용성|인터페이스|설치|세팅|글로벌|배포|버전|릴리즈|깃|깃허브|문서화된\s*절차|패키지|라우터|자동완성|시뮬레이션\s*테스트/.test(normalized);
 }
-function looksLikeLongTableEngineeringPrompt(prompt) {
+function looksLikeResearchDomainPrompt(prompt) {
     const normalized = prompt.trim();
     if (!normalized) {
         return false;
     }
-    return /\b(longtable|hook|checkpoint|mcp|agent|npm|version|global|publish|release|deploy|git)\b/i.test(normalized)
-        || /롱테이블|훅|체크포인트|에이전트|글로벌|배포|버전|릴리즈|깃|깃허브/.test(normalized);
+    return /\b(research|study|paper|manuscript|journal|article|method|methodology|measurement|construct|theory|analysis|model|data|participant|sample|scale|survey|instrument|validity|hypothesis|literature|meta[- ]?analysis|gold standard|coding|trust|reliance|calibration)\b/i.test(normalized)
+        || /연구|논문|원고|저널|방법론|방법|연구\s*설계|측정|구성개념|개념|이론|분석|모형|모델|데이터|참가자|표본|샘플|척도|설문|도구|타당도|가설|문헌|메타\s*분석|골드\s*스탠더드|코딩|신뢰|의존|캘리브레이션|교정|보정/.test(normalized);
 }
-function looksLikeDiagnosticOrExplanatoryPrompt(prompt) {
-    const normalized = prompt.trim();
-    if (!normalized) {
-        return false;
-    }
-    return /\b(explain|why|how|diagnos(?:e|is)|debug|inspect|check|verify|status|simulate|simulation|test|logs?)\b/i.test(normalized)
-        || /설명|왜|어떻게|진단|디버그|확인|점검|상태|시뮬레이션|테스트|로그|불필요/.test(normalized);
+function looksLikeResearchCommitmentPrompt(prompt) {
+    return looksLikeResearchDomainPrompt(prompt) && looksLikeClosurePrompt(prompt);
 }
-function shouldAutoCreateQuestionsForPrompt(prompt) {
-    if (!looksLikeLongTableEngineeringPrompt(prompt)) {
-        return true;
+function buildResponseOnlyAdvisoryQuestions(prompt) {
+    if (looksLikeLongTableProductOrToolingPrompt(prompt)) {
+        return [];
     }
-    return !looksLikeExecutionDirective(prompt) && !looksLikeDiagnosticOrExplanatoryPrompt(prompt);
+    const opportunities = buildQuestionOpportunitySpecs(prompt, {
+        includeFallback: false,
+        autoOnly: true
+    });
+    if (opportunities.length === 0) {
+        return [];
+    }
+    if (!looksLikeResearchDomainPrompt(prompt) && !/\b(needed questions?|necessary questions?|clarifying questions?|question generation|assumptions?|uncertain|not sure|gap|tension|trade[- ]?off)\b/i.test(prompt) && !/필요한\s*질문|질문\s*생성|물어봐|질문해|전제|가정|불확실|모르겠|공백|긴장|상충|균형/.test(prompt)) {
+        return [];
+    }
+    return opportunities.slice(0, 3);
+}
+function shouldCreateRequiredQuestionsForPrompt(prompt) {
+    return !looksLikeLongTableProductOrToolingPrompt(prompt) && looksLikeResearchCommitmentPrompt(prompt);
 }
 function shouldApplyProtectedDecisionClosure(runtime, prompt) {
     return Boolean(runtime.context.session.protectedDecision) &&
-        looksLikeClosurePrompt(prompt) &&
-        !looksLikeLongTableEngineeringPrompt(prompt);
+        shouldCreateRequiredQuestionsForPrompt(prompt);
 }
 function protectedDecisionClosurePrompt(prompt) {
     return [
@@ -213,6 +220,16 @@ function buildGeneratedQuestionsContext(questions, created) {
     lines.push("Do not choose or record answers for these checkpoints unless the researcher explicitly provides the selections.");
     return lines.join("\n");
 }
+function buildAdvisoryQuestionsContext(questions) {
+    const lines = [
+        `LongTable surfaced ${questions.length} response-only advisory question${questions.length === 1 ? "" : "s"} for this prompt.`,
+        "Use these only if they help the reply. Do not create QuestionRecord entries, call longtable decide, or answer for the researcher unless the prompt explicitly asks to commit a research decision."
+    ];
+    for (const question of questions) {
+        lines.push(`- ${question.title}: ${question.question}`);
+    }
+    return lines.join("\n");
+}
 function buildPendingObligationContext(obligation) {
     return [
         `Pending LongTable research obligation: ${obligation.prompt}`,
@@ -264,13 +281,14 @@ async function userPromptSubmitContext(runtime, prompt) {
     }
     const generatedQuestions = [];
     let createdQuestions = false;
-    if (shouldAutoCreateQuestionsForPrompt(prompt)) {
+    if (shouldCreateRequiredQuestionsForPrompt(prompt)) {
         const generated = await createWorkspaceFollowUpQuestions({
             context: runtime.context,
             prompt,
             provider: "codex",
             required: true,
-            auto: true
+            auto: true,
+            requiredOnly: true
         });
         generatedQuestions.push(...generated.questions);
         createdQuestions = createdQuestions || generated.created;
@@ -281,7 +299,8 @@ async function userPromptSubmitContext(runtime, prompt) {
             prompt: protectedDecisionClosurePrompt(prompt),
             provider: "codex",
             required: true,
-            auto: true
+            auto: true,
+            requiredOnly: true
         });
         generatedQuestions.push(...protectedGenerated.questions.filter((question) => !generatedQuestions.some((existing) => existing.id === question.id)));
         createdQuestions = createdQuestions || protectedGenerated.created;
@@ -289,11 +308,9 @@ async function userPromptSubmitContext(runtime, prompt) {
     if (generatedQuestions.length > 0) {
         return buildGeneratedQuestionsContext(generatedQuestions, createdQuestions);
     }
-    if (shouldApplyProtectedDecisionClosure(runtime, prompt)) {
-        return [
-            `This workspace marks ${runtime.context.session.protectedDecision} as a protected decision.`,
-            "Before you settle it through drafting, revision, or closure, surface one researcher-facing checkpoint grounded in the current blocker or open questions."
-        ].join("\n");
+    const advisoryQuestions = buildResponseOnlyAdvisoryQuestions(prompt);
+    if (advisoryQuestions.length > 0) {
+        return buildAdvisoryQuestionsContext(advisoryQuestions);
     }
     return null;
 }

package/dist/project-session.d.ts

@@ -227,6 +227,7 @@ type FollowUpQuestionSpec = QuestionOpportunity;
 interface BuildFollowUpQuestionOptions {
     includeFallback?: boolean;
     autoOnly?: boolean;
+    requiredOnly?: boolean;
 }
 export declare function buildQuestionOpportunitySpecs(prompt: string, options?: BuildFollowUpQuestionOptions): FollowUpQuestionSpec[];
 export declare function generateQuestionOpportunities(prompt: string, options?: BuildFollowUpQuestionOptions): QuestionGenerationResult;
@@ -237,6 +238,7 @@ export declare function createWorkspaceFollowUpQuestions(options: {
     required?: boolean;
     force?: boolean;
     auto?: boolean;
+    requiredOnly?: boolean;
 }): Promise<{
     questions: QuestionRecord[];
     state: ResearchState;
@@ -277,6 +279,13 @@ export declare function clearWorkspaceQuestion(options: {
     question: QuestionRecord;
     state: ResearchState;
 }>;
+export declare function pruneWorkspaceQuestions(options: {
+    context: LongTableProjectContext;
+    dryRun?: boolean;
+}): Promise<{
+    removedQuestions: QuestionRecord[];
+    state: ResearchState;
+}>;
 export declare function repairWorkspaceStateConsistency(options: {
     context: LongTableProjectContext;
 }): Promise<{

package/dist/project-session.js

@@ -990,7 +990,7 @@ export function buildQuestionOpportunitySpecs(prompt, options = {}) {
     function push(spec) {
         if (!specs.some((candidate) => candidate.key === spec.key)) {
             specs.push({
-                required: true,
+                required: false,
                 confidence: "medium",
                 autoEligible: false,
                 cues: [],
@@ -1076,6 +1076,7 @@ export function buildQuestionOpportunitySpecs(prompt, options = {}) {
             options: followUpQuestionOptions({ value: "keep_open", label: "Keep it open", description: "Do not treat the decision as settled; preserve it as an explicit blocker.", recommended: true }, { value: "ask_researcher", label: "Ask the researcher now", description: "Pause execution until the researcher chooses the decision boundary." }, { value: "proceed_with_record", label: "Proceed with record", description: "Continue only after recording the assumption and residual risk." }),
             confidence: "high",
             autoEligible: true,
+            required: true,
             cues: ["protected_decision", "closure_pressure"]
         });
     }
@@ -1226,7 +1227,11 @@ export function buildQuestionOpportunitySpecs(prompt, options = {}) {
             options: followUpQuestionOptions({ value: "scope", label: "Clarify scope first", description: "Ask what is included and excluded before acting.", recommended: true }, { value: "criteria", label: "Clarify success criteria", description: "Ask what would count as a good result." }, { value: "proceed", label: "Proceed with visible assumptions", description: "Continue, but make assumptions explicit." })
         });
     }
-    return options.autoOnly === true ? specs.filter((spec) => spec.autoEligible) : specs;
+    let selected = options.autoOnly === true ? specs.filter((spec) => spec.autoEligible) : specs;
+    if (options.requiredOnly === true) {
+        selected = selected.filter((spec) => spec.kind === "research_commitment");
+    }
+    return selected;
 }
 function buildFollowUpQuestionSpecs(prompt) {
     return buildQuestionOpportunitySpecs(prompt);
@@ -1261,7 +1266,8 @@ export async function createWorkspaceFollowUpQuestions(options) {
         : ["mcp_elicitation", "terminal_selector", "numbered"];
     const specs = buildQuestionOpportunitySpecs(options.prompt, {
         includeFallback: options.force === true ? true : options.auto !== true,
-        autoOnly: options.auto === true
+        autoOnly: options.auto === true,
+        requiredOnly: options.requiredOnly === true
     });
     if (specs.length === 0) {
         return { questions: [], state, created: false, alreadyAnswered: false };
@@ -1513,6 +1519,53 @@ export async function clearWorkspaceQuestion(options) {
         state: updated
     };
 }
+function isPrunableFalsePositiveQuestion(record) {
+    if (record.status !== "cleared") {
+        return false;
+    }
+    return /false-positive|duplicated automatic hook/i.test(record.clearedReason ?? "");
+}
+export async function pruneWorkspaceQuestions(options) {
+    const state = await loadResearchState(options.context.stateFilePath);
+    const removedQuestions = (state.questionLog ?? []).filter(isPrunableFalsePositiveQuestion);
+    if (removedQuestions.length === 0 || options.dryRun) {
+        return {
+            removedQuestions,
+            state
+        };
+    }
+    const removedIds = new Set(removedQuestions.map((question) => question.id));
+    const updated = {
+        ...state,
+        questionLog: (state.questionLog ?? []).filter((question) => !removedIds.has(question.id)),
+        questionObligations: (state.questionObligations ?? []).filter((obligation) => !obligation.questionId || !removedIds.has(obligation.questionId)),
+        invocationLog: (state.invocationLog ?? []).map((record) => ({
+            ...record,
+            ...(record.panelResult
+                ? {
+                    panelResult: {
+                        ...record.panelResult,
+                        linkedQuestionRecordIds: record.panelResult.linkedQuestionRecordIds.filter((id) => !removedIds.has(id))
+                    }
+                }
+                : {}),
+            ...(record.teamDebateRun
+                ? {
+                    teamDebateRun: {
+                        ...record.teamDebateRun,
+                        linkedQuestionRecordIds: record.teamDebateRun.linkedQuestionRecordIds.filter((id) => !removedIds.has(id))
+                    }
+                }
+                : {})
+        }))
+    };
+    await writeFile(options.context.stateFilePath, JSON.stringify(updated, null, 2), "utf8");
+    await syncCurrentWorkspaceView(options.context);
+    return {
+        removedQuestions,
+        state: updated
+    };
+}
 export async function repairWorkspaceStateConsistency(options) {
     const state = await loadResearchState(options.context.stateFilePath);
     const repaired = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longtable/cli",
-  "version": "0.1.38",
+  "version": "0.1.40",
   "private": false,
   "description": "Researcher-facing LongTable CLI",
   "type": "module",
@@ -29,12 +29,12 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.2.0",
-    "@longtable/checkpoints": "0.1.38",
-    "@longtable/core": "0.1.38",
-    "@longtable/memory": "0.1.38",
-    "@longtable/provider-claude": "0.1.38",
-    "@longtable/provider-codex": "0.1.38",
-    "@longtable/setup": "0.1.38"
+    "@longtable/checkpoints": "0.1.40",
+    "@longtable/core": "0.1.40",
+    "@longtable/memory": "0.1.40",
+    "@longtable/provider-claude": "0.1.40",
+    "@longtable/provider-codex": "0.1.40",
+    "@longtable/setup": "0.1.40"
   },
   "devDependencies": {
     "@types/node": "^22.10.1",