@longtable/cli 0.1.51 → 0.1.53

package/README.md

@@ -4,7 +4,8 @@ Researcher-facing CLI for LongTable.
 
 LongTable keeps scholarly project state in `.longtable/` and exposes generated
 provider skills for Codex and Claude Code. The CLI installs setup, state,
-checkpoint, search, and diagnostic tooling. It does not replace the provider.
+checkpoint, search, panel, and diagnostic tooling. It does not replace the
+provider.
 
 ## Install
 
@@ -74,14 +75,53 @@ longtable question --prompt "<decision context>"
 longtable decide --question <id> --answer <value>
 longtable spec read --cwd "<project-path>"
 longtable search --query "<topic>"
+longtable panel --prompt "review this measurement plan" --json
 ```
 
 `longtable start` remains available for scripted workspace creation with
 `--no-interview --json`, but it is not the primary research-start surface.
 
+## Panel Orchestration
+
+Panel orchestration is for moments where disagreement matters: methods risk,
+measurement validity, theory fit, literature positioning, and claims that need
+challenge before they become project memory.
+
+The CLI creates a provider-neutral `PanelPlan` and returns a planned
+`PanelResult`. When native subagents are unavailable, LongTable uses a stable
+sequential fallback prompt. That keeps the same research semantics available in
+Codex and Claude Code without making either provider's native question or agent
+tool the source of truth.
+
+```bash
+longtable panel --prompt "Review this measurement plan." --role editor,measurement_auditor --json
+longtable panel --visibility always_visible --prompt "Keep unresolved disagreement visible." --json
+longtable ask --prompt "lt debate: Review this design before I commit it." --json
+```
+
+Team-style requests route through panel. Explicit debate-language requests write
+panel debate records under `.longtable/panel/`; LongTable team execution is
+disabled for new work.
+
 ## Development
 
 ```bash
 npm run build --workspace @longtable/cli
 npm run typecheck --workspace @longtable/cli
 ```
+
+## Codex hard-stop diagnostics
+
+Codex `Stop` blocks only active LongTable hard-stop blockers: unresolved
+Research Specification question, scope, construct, method, evidence, or protected
+decision commitments. Use:
+
+```bash
+longtable codex hook-doctor --json
+longtable codex status --json
+longtable doctor --json
+```
+
+to inspect hook coverage/trust plus `stopWouldBlock`, `activeBlockers`, stale
+pending-question counts, and next actions. Tmux remains an optional terminal
+transport; LongTable state and hooks own the behavior.

package/dist/cli.js

@@ -8,6 +8,7 @@ import { stdin as input, stdout as output, cwd, env, exit } from "node:process";
 import { dirname, join, resolve } from "node:path";
 import { homedir } from "node:os";
 import { fileURLToPath } from "node:url";
+import { collectHardStopBlockers } from "@longtable/core";
 import { classifyCheckpointTrigger } from "@longtable/checkpoints";
 import { assessSearchSourceCapabilities, buildResearchSearchIntent, parsePublisherTarget, probePublisherAccess, publisherConfigs, runResearchSearch, SEARCH_SOURCES, summarizeConfiguredPublisherAccess } from "./search/index.js";
 import { buildProviderChoices, buildQuickSetupFlow, createPersistedSetupOutput, installRuntimeConfigFromStoredSetup, loadSetupOutput, renderInstallSummary, renderSetupSummary, resolveDefaultRuntimeConfigPath, resolveDefaultSetupPath, saveSetupOutput, saveSetupAndRuntimeConfig, serializeSetupOutput, writeRuntimeConfig } from "@longtable/setup";
@@ -19,7 +20,7 @@ import { PERSONA_DEFINITIONS, listRoleDefinitions } from "./personas.js";
 import { buildPanelFallback, renderPanelSummary } from "./panel.js";
 import { LONGTABLE_MANAGED_HOOK_EVENTS, codexHooksEnabled, enableCodexHooksFeature, getMissingManagedCodexHookEvents, getMissingManagedCodexHookTrustState, mergeCodexHookTrustState, mergeManagedCodexHooksConfig, removeCodexHookTrustState, removeManagedCodexHooks } from "./codex-hooks.js";
 import { appendInvocationRecordToWorkspace, applyResearchSpecificationPatch, assertWorkspaceNotBlocked, answerWorkspaceQuestion, buildQuestionOpportunitySpecs, clearWorkspaceQuestion, createWorkspaceFollowUpQuestions, createWorkspaceQuestion, createOrUpdateProjectWorkspace, diffResearchSpecifications, inspectProjectWorkspace, loadWorkspaceState, loadProjectContextFromDirectory, findUnincorporatedResearchEvidence, proposeResearchSpecificationPatch, pruneWorkspaceQuestions, readResearchSpecificationHistory, repairWorkspaceStateConsistency, renderProjectWorkspaceSummary, syncCurrentWorkspaceView } from "./project-session.js";
-import { buildTeamDebate, buildTeamReview, renderTeamDebateSummary } from "./debate.js";
+import { buildTeamDebate } from "./debate.js";
 import { createPromptRenderer } from "./prompt-renderer.js";
 const VALID_MODES = new Set([
     "explore",
@@ -153,7 +154,6 @@ function usage() {
         "  longtable access probe --doi <doi> [--publisher auto|elsevier|springer_nature|wiley|taylor_francis] [--json]",
         "  longtable search --query <text> [--intent literature|theory|measurement|citation|metadata|venue] [--field <text>] [--source all|crossref,arxiv,openalex,semantic_scholar,pubmed,eric,doaj,unpaywall] [--must <term[,term]>] [--exclude <term[,term]>] [--limit <n>] [--allow-partial] [--publisher-access] [--record] [--cwd <path>] [--json]",
         "  longtable sentinel --prompt <text> [--cwd <path>] [--json] [--record]",
-        "  longtable team --prompt <text> [--role <role[,role]>] [--debate] [--rounds 3|5] [--cwd <path>] [--json]",
         "  longtable ask [--prompt <text>] [--print] [--json] [--setup <path>] [--cwd <path>]",
         "  longtable clarify --prompt <task-context> [--provider codex|claude] [--required|--advisory] [--print] [--cwd <path>] [--json] [--force]",
         "  longtable question --prompt <decision-context> [--title <text>] [--text <question>] [--provider codex|claude] [--required|--advisory] [--print] [--cwd <path>] [--json]",
@@ -169,6 +169,7 @@ function usage() {
         "  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 [--surface compact|full] [--dir <path>] [--codex-config <path>] [--hooks-path <path>] [--json]",
+        "  longtable codex hook-doctor [--cwd <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 [--surface compact|full] [--dir <path>] [--json]",
@@ -1527,6 +1528,22 @@ function setupForProvider(setup, provider) {
             }
     };
 }
+async function collectHardStopDiagnostics(startPath) {
+    const empty = {
+        stopWouldBlock: false,
+        activeBlockers: [],
+        staleOrUnrelatedPendingQuestionCount: 0,
+        stalePendingQuestionCount: 0,
+        stalePendingObligationCount: 0,
+        nextActions: []
+    };
+    const context = await loadProjectContextFromDirectory(startPath);
+    if (!context) {
+        return empty;
+    }
+    const state = await loadWorkspaceState(context);
+    return collectHardStopBlockers(state);
+}
 async function collectDoctorStatus(args) {
     const roles = listRoleDefinitions();
     const skillSurface = parseSkillSurface(args);
@@ -1579,11 +1596,13 @@ async function collectDoctorStatus(args) {
         : [];
     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([
+    const workspacePath = typeof args.cwd === "string" ? args.cwd : cwd();
+    const [codexSkills, claudeSkills, codexAliases, workspace, hardStop] = await Promise.all([
         listInstalledCodexSkills(roles, codexDir, skillSurface),
         listInstalledClaudeSkills(roles, claudeDir, skillSurface),
         listInstalledCodexPromptAliases(codexPromptsDir),
-        inspectProjectWorkspace(typeof args.cwd === "string" ? args.cwd : cwd())
+        inspectProjectWorkspace(workspacePath),
+        collectHardStopDiagnostics(workspacePath)
     ]);
     const installedCodexSkills = codexSkills.map((skill) => skill.name);
     const installedClaudeSkills = claudeSkills.map((skill) => skill.name);
@@ -1614,7 +1633,12 @@ async function collectDoctorStatus(args) {
                 hooksExists: existsSync(codexHooksPath),
                 codexHooksEnabled: codexHooksEnabled(codexMcpConfig),
                 missingManagedHookEvents,
-                missingManagedHookTrustState
+                missingManagedHookTrustState,
+                stopWouldBlock: hardStop.stopWouldBlock,
+                activeBlockers: hardStop.activeBlockers,
+                stalePendingQuestionCount: hardStop.stalePendingQuestionCount,
+                stalePendingObligationCount: hardStop.stalePendingObligationCount,
+                nextActions: hardStop.nextActions
             },
             claude: {
                 command: "claude",
@@ -1627,7 +1651,8 @@ async function collectDoctorStatus(args) {
                 missingSkills: missingNames(expectedClaudeSkills, installedClaudeSkills)
             }
         },
-        workspace
+        workspace,
+        hardStop
     };
 }
 function renderProviderDoctorBlock(label, provider) {
@@ -1665,6 +1690,9 @@ function renderDoctorStatus(status) {
         `- hooks feature: ${status.providers.codex.codexHooksEnabled ? "enabled" : "missing"}`,
         `- managed hook coverage: ${status.providers.codex.missingManagedHookEvents.length === 0 ? "complete" : `missing ${status.providers.codex.missingManagedHookEvents.join(", ")}`}`,
         `- managed hook trust: ${status.providers.codex.missingManagedHookTrustState.length === 0 ? "current" : `missing/stale ${status.providers.codex.missingManagedHookTrustState.length}`}`,
+        `- Stop would block now: ${status.hardStop.stopWouldBlock ? "yes" : "no"}`,
+        `- active hard-stop blockers: ${status.hardStop.activeBlockers.length}`,
+        `- stale/unrelated pending questions: ${status.hardStop.staleOrUnrelatedPendingQuestionCount}`,
         "",
         ...renderProviderDoctorBlock("Claude", status.providers.claude),
         "",
@@ -1675,7 +1703,7 @@ function renderDoctorStatus(status) {
     }
     else {
         const workspace = status.workspace;
-        lines.push(`- project: ${workspace.project?.name ?? "unknown"}`, `- root: ${workspace.rootPath ?? "unknown"}`, `- goal: ${workspace.session?.currentGoal ?? "unknown"}`, `- invocations: ${workspace.counts?.invocations ?? 0}`, `- questions: ${workspace.counts?.questions ?? 0} (${workspace.counts?.pendingQuestions ?? 0} pending, ${workspace.counts?.answeredQuestions ?? 0} answered)`, `- obligations: ${workspace.counts?.pendingObligations ?? 0} pending`, `- decisions: ${workspace.counts?.decisions ?? 0}`);
+        lines.push(`- project: ${workspace.project?.name ?? "unknown"}`, `- root: ${workspace.rootPath ?? "unknown"}`, `- goal: ${workspace.session?.currentGoal ?? "unknown"}`, `- invocations: ${workspace.counts?.invocations ?? 0}`, `- questions: ${workspace.counts?.questions ?? 0} (${workspace.counts?.pendingQuestions ?? 0} pending, ${workspace.counts?.answeredQuestions ?? 0} answered)`, `- obligations: ${workspace.counts?.pendingObligations ?? 0} pending`, `- Stop hard-stop: ${workspace.hardStop?.stopWouldBlock ? "would block" : "clear"}`, `- stale/unrelated pending: ${workspace.hardStop?.stalePendingQuestionCount ?? 0} questions, ${workspace.hardStop?.stalePendingObligationCount ?? 0} obligations`, `- decisions: ${workspace.counts?.decisions ?? 0}`);
         if ((workspace.recentInvocations ?? []).length > 0) {
             lines.push("- recent invocations:");
             for (const invocation of workspace.recentInvocations ?? []) {
@@ -1689,12 +1717,25 @@ function renderDoctorStatus(status) {
                 lines.push(`  - ${question.id}: ${question.question} (${question.options.join("/")})`);
             }
         }
+        if (status.hardStop.activeBlockers.length > 0) {
+            lines.push("- active hard-stop blockers:");
+            for (const blocker of status.hardStop.activeBlockers) {
+                lines.push(`  - ${blocker.id}: ${blocker.scope} (${blocker.type})`);
+            }
+        }
         if ((workspace.pendingObligations ?? []).length > 0) {
             lines.push("- pending obligations:");
             for (const obligation of workspace.pendingObligations ?? []) {
                 lines.push(`  - ${obligation.id}: ${obligation.prompt}`);
             }
         }
+        if ((workspace.hardStop?.activeBlockers ?? []).length > 0) {
+            lines.push("- hard-stop blockers:");
+            for (const blocker of workspace.hardStop?.activeBlockers ?? []) {
+                lines.push(`  - ${blocker.id} [${blocker.scope}]: ${blocker.prompt}`);
+                lines.push(`    next: ${blocker.commandHint}`);
+            }
+        }
         if ((workspace.answerWarnings ?? []).length > 0) {
             lines.push("- answer warnings:");
             for (const warning of workspace.answerWarnings ?? []) {
@@ -1736,10 +1777,16 @@ function renderDoctorStatus(status) {
     if (!status.workspace.found) {
         nextActions.push("longtable start");
     }
+    nextActions.push(...status.hardStop.nextActions);
     const firstQuestion = status.workspace.pendingQuestions?.[0];
-    if (firstQuestion) {
+    if (firstQuestion && status.hardStop.nextActions.length === 0) {
         nextActions.push(`longtable decide --question ${firstQuestion.id} --answer <value>`);
     }
+    for (const action of status.workspace.hardStop?.nextActions ?? []) {
+        if (!nextActions.includes(action)) {
+            nextActions.push(action);
+        }
+    }
     if (nextActions.length > 0) {
         lines.push("", "Next actions:");
         for (const action of nextActions) {
@@ -2216,10 +2263,10 @@ function inferCollaborationRoute(prompt) {
     if (explicitDebate) {
         return "debate";
     }
-    const explicitTeam = /\bagent team\b|\bresearch team\b|\bteam review\b|\bteam-style\b|\buse a team\b/i.test(prompt) ||
+    const explicitPanelTeam = /\bagent team\b|\bresearch team\b|\bteam review\b|\bteam-style\b|\buse a team\b/i.test(prompt) ||
         /에이전트\s*팀|연구\s*팀|팀\s*(리뷰|검토)|팀으로/.test(prompt);
-    if (explicitTeam) {
-        return "team";
+    if (explicitPanelTeam) {
+        return "panel";
     }
     const panelCue = /\bpanel\b|\bmulti[- ]?role\b|\bmultiple perspectives\b|\brole disagreement\b|\bdisagreement\b|\bconflict\b/i.test(prompt) ||
         /패널|여러\s*관점|복수\s*관점|역할.*불일치|불일치|충돌/.test(prompt);
@@ -2234,10 +2281,10 @@ function inferCollaborationRoute(prompt) {
         trigger.signal.artifactStakes === "study_protocol" ||
         trigger.requiresQuestionBeforeClosure;
     if (panelCue && trigger.signal.artifactStakes === "external_submission") {
-        return "debate";
+        return "panel";
     }
     if (highStakes) {
-        return "team";
+        return "panel";
     }
     return "panel";
 }
@@ -2813,7 +2860,7 @@ async function runAccess(subcommand, args) {
         await runAccessSetup(args);
         return;
     }
-    if (subcommand === "status") {
+    if (subcommand === "status" || subcommand === "hook-doctor") {
         await runAccessStatus(args);
         return;
     }
@@ -3338,10 +3385,10 @@ async function runAsk(args) {
         (directive.panel || delegatedArgs.panel === true
             ? "panel"
             : inferCollaborationRoute(effectivePrompt) ?? (inferred === "panel" ? "panel" : null));
-    if (collaborationRoute === "team" || collaborationRoute === "debate") {
-        await runTeam({
+    if (collaborationRoute === "debate") {
+        await runPanelDebateCommand({
             ...delegatedArgs,
-            debate: collaborationRoute === "debate"
+            debate: true
         });
         return;
     }
@@ -3360,21 +3407,21 @@ function localId(prefix) {
 async function writeJsonFile(path, value) {
     await writeFile(path, `${JSON.stringify(value, null, 2)}\n`, "utf8");
 }
-async function writeTeamDebateArtifacts(bundle, teamDir, prompt) {
-    await mkdir(teamDir, { recursive: true });
-    await writeFile(join(teamDir, "prompt.txt"), prompt, "utf8");
-    await writeJsonFile(join(teamDir, "plan.json"), bundle.plan);
-    await writeJsonFile(join(teamDir, "run.json"), bundle.run);
+async function writePanelDebateArtifacts(bundle, panelDir, prompt) {
+    await mkdir(panelDir, { recursive: true });
+    await writeFile(join(panelDir, "prompt.txt"), prompt, "utf8");
+    await writeJsonFile(join(panelDir, "plan.json"), bundle.plan);
+    await writeJsonFile(join(panelDir, "run.json"), bundle.run);
     for (const round of bundle.run.rounds) {
         await mkdir(round.artifactDir, { recursive: true });
         await writeJsonFile(join(round.artifactDir, "round.json"), round);
         for (const contribution of round.contributions) {
-            await writeJsonFile(join(teamDir, contribution.artifactPath), contribution);
+            await writeJsonFile(join(panelDir, contribution.artifactPath), contribution);
         }
     }
-    await writeJsonFile(join(teamDir, "synthesis.json"), bundle.run.synthesis);
-    await writeJsonFile(join(teamDir, "checkpoint.json"), bundle.questionRecord);
-    await writeJsonFile(join(teamDir, "invocation.json"), bundle.invocationRecord);
+    await writeJsonFile(join(panelDir, "synthesis.json"), bundle.run.synthesis);
+    await writeJsonFile(join(panelDir, "checkpoint.json"), bundle.questionRecord);
+    await writeJsonFile(join(panelDir, "invocation.json"), bundle.invocationRecord);
 }
 function sentinelSummary(prompt, workingDirectory) {
     const trigger = classifyCheckpointTrigger(prompt, {
@@ -3453,19 +3500,15 @@ async function runSentinel(args) {
         console.log(context ? `- recorded in: ${context.stateFilePath}` : "- record skipped: no LongTable workspace found");
     }
 }
-async function runTeam(args) {
+async function runPanelDebateCommand(args) {
     const workingDirectory = typeof args.cwd === "string" ? args.cwd : cwd();
     const prompt = await resolvePrompt(typeof args.prompt === "string" ? args.prompt : undefined);
     if (!prompt) {
         throw new Error("A prompt is required.");
     }
-    const isDebate = args.debate === true;
-    const expectedRounds = isDebate ? 5 : 3;
-    const rounds = typeof args.rounds === "string" ? Number(args.rounds) : expectedRounds;
-    if (!Number.isInteger(rounds) || rounds !== expectedRounds) {
-        throw new Error(isDebate
-            ? "LongTable team debate v1 supports `--rounds 5` only."
-            : "LongTable team v1 supports `--rounds 3` cross-review only.");
+    const rounds = typeof args.rounds === "string" ? Number(args.rounds) : 5;
+    if (!Number.isInteger(rounds) || rounds !== 5) {
+        throw new Error("LongTable panel debate v1 supports `--rounds 5` only.");
     }
     const setup = await loadOptionalSetup(typeof args.setup === "string" ? args.setup : undefined);
     const projectContext = await loadProjectContextFromDirectory(workingDirectory);
@@ -3473,78 +3516,47 @@ async function runTeam(args) {
         await assertWorkspaceNotBlocked(projectContext);
     }
     const projectAware = await buildProjectAwarePrompt(prompt, workingDirectory);
-    const teamId = localId("team");
-    const teamDir = join(workingDirectory, ".longtable", "team", teamId);
-    if (isDebate) {
-        const debate = buildTeamDebate({
-            teamId,
-            teamDir,
-            prompt: projectAware.prompt,
-            roleFlag: typeof args.role === "string" ? args.role : undefined,
-            provider: setup?.providerSelection.provider,
-            visibility: "always_visible",
-            roundCount: rounds
-        });
-        await writeTeamDebateArtifacts(debate, teamDir, prompt);
-        const canRecordWorkspace = projectAware.projectContextFound && projectContext && existsSync(projectContext.stateFilePath);
-        if (canRecordWorkspace) {
-            await appendInvocationRecordToWorkspace(projectContext, debate.invocationRecord, [debate.questionRecord]);
-        }
-        if (args.json === true) {
-            console.log(JSON.stringify({
-                teamId,
-                teamDir,
-                plan: debate.plan,
-                run: debate.run,
-                questionRecord: debate.questionRecord,
-                invocationRecord: debate.invocationRecord,
-                execution: {
-                    status: "completed",
-                    surface: debate.run.surface,
-                    projectContextFound: projectAware.projectContextFound,
-                    invocationLogged: canRecordWorkspace
-                }
-            }, null, 2));
-            return;
-        }
-        console.log(renderTeamDebateSummary(debate.run));
-        console.log(`- checkpoint: ${debate.questionRecord.id}`);
-        return;
-    }
-    const team = buildTeamReview({
-        teamId,
-        teamDir,
+    const panelId = localId("panel_debate");
+    const panelDir = join(workingDirectory, ".longtable", "panel", panelId);
+    const debate = buildTeamDebate({
+        teamId: panelId,
+        teamDir: panelDir,
         prompt: projectAware.prompt,
         roleFlag: typeof args.role === "string" ? args.role : undefined,
         provider: setup?.providerSelection.provider,
         visibility: "always_visible",
         roundCount: rounds
     });
-    await writeTeamDebateArtifacts(team, teamDir, prompt);
+    await writePanelDebateArtifacts(debate, panelDir, prompt);
     const canRecordWorkspace = projectAware.projectContextFound && projectContext && existsSync(projectContext.stateFilePath);
     if (canRecordWorkspace) {
-        await appendInvocationRecordToWorkspace(projectContext, team.invocationRecord, [team.questionRecord]);
+        await appendInvocationRecordToWorkspace(projectContext, debate.invocationRecord, [debate.questionRecord]);
     }
     if (args.json === true) {
         console.log(JSON.stringify({
-            teamId,
-            teamDir,
-            plan: team.plan,
-            run: team.run,
-            questionRecord: team.questionRecord,
-            invocationRecord: team.invocationRecord,
+            panelId,
+            panelDir,
+            plan: debate.plan,
+            run: debate.run,
+            questionRecord: debate.questionRecord,
+            invocationRecord: debate.invocationRecord,
             execution: {
                 status: "completed",
-                surface: team.run.surface,
-                interactionDepth: team.run.interactionDepth,
+                surface: debate.run.surface,
                 projectContextFound: projectAware.projectContextFound,
                 invocationLogged: canRecordWorkspace
             }
         }, null, 2));
         return;
     }
-    console.log(renderTeamDebateSummary(team.run));
-    console.log(`- checkpoint: ${team.questionRecord.id}`);
+    console.log("LongTable Panel Debate");
+    console.log(`- panel: ${panelId}`);
+    console.log(`- interaction depth: ${debate.run.interactionDepth}`);
+    console.log(`- rounds: ${debate.run.roundCount}`);
+    console.log(`- checkpoint: ${debate.questionRecord.id}`);
+}
+function disabledTeamCommandError() {
+    return new Error("`longtable team` is disabled. Use `longtable panel --prompt <text>` for visible multi-role review, or `longtable ask --prompt \"lt debate: <text>\"` when debate is explicitly requested.");
 }
 async function runDecide(args) {
     const workingDirectory = typeof args.cwd === "string" ? args.cwd : cwd();
@@ -3768,7 +3780,7 @@ async function runCodexSubcommand(subcommand, args) {
         console.log(renderCodexHookInstallSummary(result));
         return;
     }
-    if (subcommand === "status") {
+    if (subcommand === "status" || subcommand === "hook-doctor") {
         const aliases = await listInstalledCodexPromptAliases(customDir);
         const skills = await listInstalledCodexSkills(roles, customDir, skillSurface);
         const setupPath = resolveDefaultSetupPath(typeof args.path === "string" ? args.path : undefined).path;
@@ -3777,6 +3789,7 @@ async function runCodexSubcommand(subcommand, args) {
         const configContent = existsSync(configPath) ? await readFile(configPath, "utf8") : "";
         const hooksPath = resolveCodexHooksPath(args);
         const hooksContent = existsSync(hooksPath) ? await readFile(hooksPath, "utf8") : "";
+        const workspace = await inspectProjectWorkspace(typeof args.cwd === "string" ? args.cwd : cwd());
         const status = {
             setupPath,
             setupExists: existsSync(setupPath),
@@ -3796,13 +3809,21 @@ async function runCodexSubcommand(subcommand, args) {
                 : [...LONGTABLE_MANAGED_HOOK_EVENTS],
             missingManagedHookTrustState: hooksContent
                 ? getMissingManagedCodexHookTrustState(configContent, hooksPath, hooksContent)
-                : []
+                : [],
+            workspaceHardStop: workspace.hardStop ?? {
+                stopWouldBlock: false,
+                activeBlockers: [],
+                staleOrUnrelatedPendingQuestionCount: 0,
+                stalePendingQuestionCount: 0,
+                stalePendingObligationCount: 0,
+                nextActions: []
+            }
         };
         if (args.json === true) {
             console.log(JSON.stringify(status, null, 2));
             return;
         }
-        console.log("LongTable Codex status");
+        console.log(subcommand === "hook-doctor" ? "LongTable Codex hook doctor" : "LongTable Codex status");
         console.log(`- setup: ${status.setupExists ? "present" : "missing"} (${setupPath})`);
         console.log(`- codex runtime artifact: ${status.runtimeExists ? "present" : "missing"} (${runtimePath})`);
         console.log(`- skills dir: ${status.skillsDir}`);
@@ -3832,6 +3853,9 @@ async function runCodexSubcommand(subcommand, args) {
         console.log(`- hooks file: ${status.hooksExists ? "present" : "missing"} (${status.hooksPath})`);
         console.log(`- managed hook coverage: ${status.missingManagedHookEvents.length === 0 ? "complete" : `missing ${status.missingManagedHookEvents.join(", ")}`}`);
         console.log(`- managed hook trust: ${status.missingManagedHookTrustState.length === 0 ? "current" : `missing/stale ${status.missingManagedHookTrustState.length}`}`);
+        console.log(`- Stop hard-stop: ${status.workspaceHardStop.stopWouldBlock ? "would block" : "clear"}`);
+        console.log(`- active hard-stop blockers: ${status.workspaceHardStop.activeBlockers.length}`);
+        console.log(`- stale/unrelated pending: ${status.workspaceHardStop.stalePendingQuestionCount} questions, ${status.workspaceHardStop.stalePendingObligationCount} obligations`);
         return;
     }
     throw new Error("Unknown codex subcommand.");
@@ -3977,8 +4001,7 @@ async function main() {
         return;
     }
     if (command === "team") {
-        await runTeam(values);
-        return;
+        throw disabledTeamCommandError();
     }
     if (command === "decide") {
         await runDecide(values);

package/dist/codex-hooks.js

@@ -48,14 +48,12 @@ export function buildManagedCodexHooksConfig(packageRoot) {
             ],
             PreToolUse: [
                 buildCommandHook(command, {
-                    matcher: "Bash",
-                    statusMessage: "Running LongTable checkpoint guard"
+                    matcher: "Bash"
                 })
             ],
             PostToolUse: [
                 buildCommandHook(command, {
-                    matcher: "Bash",
-                    statusMessage: "Reviewing LongTable post-tool state"
+                    matcher: "Bash"
                 })
             ],
             UserPromptSubmit: [

package/dist/debate.js

@@ -166,7 +166,7 @@ function convergenceContribution(roundId, plan, role, label, artifactPath) {
 function buildSynthesis(plan, artifactPath, kind) {
     const labels = plan.members.map((member) => member.label);
     const highSensitivity = plan.checkpointSensitivity === "high";
-    const runLabel = kind === "debate" ? "debate" : "team review";
+    const runLabel = kind === "debate" ? "panel debate" : "panel review";
     return {
         artifactPath,
         summary: `The ${runLabel} completed across ${labels.join(", ")}. It should slow closure by turning role disagreement into an explicit researcher decision.`,
@@ -201,8 +201,8 @@ export function createTeamDebateQuestionRecord(run, provider) {
         status: "pending",
         prompt: {
             id: createId("question_prompt"),
-            checkpointKey: "team_debate_next_decision",
-            title: isDebate ? "Team debate follow-up decision" : "Agent team follow-up decision",
+            checkpointKey: "panel_debate_next_decision",
+            title: isDebate ? "Panel debate follow-up decision" : "Panel review follow-up decision",
             question: run.synthesis.recommendedCheckpoint,
             type: "single_choice",
             options: [
@@ -238,11 +238,11 @@ export function createTeamDebateQuestionRecord(run, provider) {
                 ? "Role rebuttals and convergence should connect to an explicit researcher decision."
                 : "Cross-review created role disagreement that should connect to an explicit researcher decision.",
             rationale: [
-                "Agent team orchestration is a research harness surface, not a substitute for researcher judgment.",
+                "LongTable panel orchestration is a research harness surface, not a substitute for researcher judgment.",
                 isDebate
                     ? "The fixed debate rounds created disagreement that should connect to an explicit researcher decision."
                     : "The cross-review round created disagreement that should connect to an explicit researcher decision.",
-                `Agent team run: ${run.id}.`
+                `LongTable panel run: ${run.id}.`
             ],
             preferredSurfaces: provider === "claude"
                 ? ["native_structured", "numbered"]
@@ -255,8 +255,8 @@ function buildTeamBundle(options, kind) {
     const expectedRounds = kind === "debate" ? 5 : 3;
     if (roundCount !== expectedRounds) {
         throw new Error(kind === "debate"
-            ? "LongTable debate v1 supports fixed 5-round debate only."
-            : "LongTable team v1 supports fixed 3-round cross-review only.");
+            ? "LongTable panel debate v1 supports fixed 5-round debate only."
+            : "LongTable panel review v1 supports fixed 3-round cross-review only.");
     }
     const createdAt = nowIso();
     const plan = buildPanelPlan({
@@ -267,7 +267,7 @@ function buildTeamBundle(options, kind) {
         visibility: options.visibility ?? "always_visible"
     });
     const rounds = [];
-    const round1Id = createId("team_round");
+    const round1Id = createId("panel_round");
     const independentContributions = plan.members.map((member) => independentContribution(round1Id, plan, member.role, member.label, join("round-1-independent", `${member.role}.json`)));
     rounds.push({
         id: round1Id,
@@ -278,7 +278,7 @@ function buildTeamBundle(options, kind) {
         artifactDir: join(options.teamDir, "round-1-independent"),
         contributions: independentContributions
     });
-    const round2Id = createId("team_round");
+    const round2Id = createId("panel_round");
     const crossContributions = plan.members.flatMap((member) => plan.members
         .filter((target) => target.role !== member.role)
         .map((target) => crossReviewContribution(round2Id, plan, member.role, member.label, target.role, target.label, independentContributions.find((contribution) => contribution.role === target.role), join("round-2-cross-review", `${member.role}-on-${target.role}.json`))));
@@ -292,7 +292,7 @@ function buildTeamBundle(options, kind) {
         contributions: crossContributions
     });
     if (kind === "debate") {
-        const round3Id = createId("team_round");
+        const round3Id = createId("panel_round");
         rounds.push({
             id: round3Id,
             index: 3,
@@ -302,7 +302,7 @@ function buildTeamBundle(options, kind) {
             artifactDir: join(options.teamDir, "round-3-rebuttal"),
             contributions: plan.members.map((member) => rebuttalContribution(round3Id, member.role, member.label, join("round-3-rebuttal", `${member.role}.json`)))
         });
-        const round4Id = createId("team_round");
+        const round4Id = createId("panel_round");
         rounds.push({
             id: round4Id,
             index: 4,
@@ -315,22 +315,22 @@ function buildTeamBundle(options, kind) {
     }
     const synthesis = buildSynthesis(plan, "synthesis.json", kind);
     const run = {
-        id: createId("team_debate_run"),
+        id: createId("panel_debate_run"),
         teamId: options.teamId,
         createdAt,
         updatedAt: createdAt,
         prompt: options.prompt,
         roles: plan.members,
         status: "completed",
-        surface: "file_backed_debate",
+        surface: "file_backed_panel_debate",
         interactionDepth: kind === "debate" ? "debated" : "cross_reviewed",
-        roundPolicy: kind === "debate" ? "fixed" : "team_cross_review",
+        roundPolicy: kind === "debate" ? "fixed" : "panel_cross_review",
         roundCount,
         artifactRoot: options.teamDir,
         rounds: [
             ...rounds,
             {
-                id: createId("team_round"),
+                id: createId("panel_round"),
                 index: roundCount,
                 kind: "synthesis",
                 title: "Coordinator synthesis and checkpoint",
@@ -353,12 +353,12 @@ function buildTeamBundle(options, kind) {
         checkpointSensitivity: plan.checkpointSensitivity,
         rationale: [
             kind === "debate"
-                ? "Autonomous debate requested through LongTable team orchestration."
-                : "Agent team cross-review requested through LongTable team orchestration.",
+                ? "Autonomous debate requested through LongTable panel orchestration."
+                : "Cross-role review requested through LongTable panel orchestration.",
             "File-backed rounds keep disagreement inspectable before researcher closure."
         ]
     });
-    intent.kind = kind === "debate" ? "team_debate" : "team";
+    intent.kind = kind === "debate" ? "panel_debate" : "panel";
     intent.requestedSurface = run.surface;
     const invocationRecord = {
         id: createId("invocation_record"),
@@ -371,7 +371,7 @@ function buildTeamBundle(options, kind) {
         interactionDepth: run.interactionDepth,
         panelPlan: plan,
         teamDebateRun: run,
-        degradationReason: "File-backed team artifacts are the canonical execution record."
+        degradationReason: "File-backed panel artifacts are the canonical execution record."
     };
     return {
         plan,
@@ -389,8 +389,8 @@ export function buildTeamDebate(options) {
 }
 export function renderTeamDebateSummary(run) {
     return [
-        "LongTable Team Debate",
-        `- team: ${run.teamId}`,
+        "LongTable Panel Debate",
+        `- panel: ${run.teamId}`,
         `- surface: ${run.surface}`,
         `- interaction depth: ${run.interactionDepth}`,
         `- rounds: ${run.roundCount} ${run.roundPolicy}`,

package/dist/hard-stop.d.ts

@@ -0,0 +1,2 @@
+export { collectHardStopBlockers } from "@longtable/core";
+export type { HardStopBlocker, HardStopBlockerType, HardStopVerdict } from "@longtable/core";

package/dist/hard-stop.js

@@ -0,0 +1 @@
+export { collectHardStopBlockers } from "@longtable/core";

package/dist/index.d.ts

@@ -5,3 +5,4 @@ export * from "./persona-router.js";
 export * from "./panel.js";
 export * from "./project-session.js";
 export * from "./question-obligations.js";
+export * from "./hard-stop.js";

package/dist/index.js

@@ -5,3 +5,4 @@ export * from "./persona-router.js";
 export * from "./panel.js";
 export * from "./project-session.js";
 export * from "./question-obligations.js";
+export * from "./hard-stop.js";

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

@@ -1,4 +1,5 @@
 import { pathToFileURL } from "node:url";
+import { collectHardStopBlockers } from "@longtable/core";
 import { createWorkspaceFollowUpQuestions, loadProjectContextFromDirectory, loadWorkspaceState, pendingQuestionObligations } from "./index.js";
 function safeString(value) {
     return typeof value === "string" ? value : "";
@@ -66,6 +67,9 @@ function formatQuestionOptions(question) {
 function pendingRequiredQuestions(state) {
     return (state.questionLog ?? []).filter((question) => question.status === "pending" && question.prompt.required);
 }
+function hardStopBlockers(state) {
+    return collectHardStopBlockers(state).activeBlockers;
+}
 function pendingObligations(state) {
     return pendingQuestionObligations(state);
 }
@@ -221,7 +225,7 @@ function mutatesLongTableResearchState(command) {
         return false;
     }
     return /\.longtable(?:\/|\b)|\bCURRENT\.md\b/.test(normalized)
-        || /\blongtable\s+(?:start|question|clear-question|prune-questions|ask|clarify|panel|team)\b/.test(normalized);
+        || /\blongtable\s+(?:start|question|clear-question|prune-questions|ask|clarify|panel)\b/.test(normalized);
 }
 async function loadLongTableRuntime(startPath) {
     const context = await loadProjectContextFromDirectory(startPath);
@@ -283,6 +287,22 @@ 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 buildHardStopBlockerContext(blocker) {
+    return [
+        `LongTable hard-stop blocker ${blocker.id} affects ${blocker.scope.replace(/_/g, " ")}.`,
+        blocker.prompt,
+        blocker.reason,
+        `Next action: ${blocker.commandHints[0] ?? "decide, clear, or defer with rationale"}`
+    ].join("\n");
+}
+function buildStopBlockerReason(blocker, count) {
+    const suffix = count > 1 ? ` (${count} active blockers total)` : "";
+    return [
+        `LongTable hard-stop ${blocker.id}${suffix}: ${blocker.scope.replace(/_/g, " ")}.`,
+        compactContextValue(blocker.prompt, 120),
+        `Required next action: ${blocker.commandHints[0] ?? "decide, clear, or defer with rationale"}.`
+    ].join(" ");
+}
 function buildPendingObligationContext(obligation) {
     return [
         `Pending LongTable research obligation: ${obligation.prompt}`,
@@ -298,6 +318,21 @@ function buildSeparatePendingObligationNotice(obligation) {
         "This is not part of the active interview. Keep it visible only when the researcher is settling or saving the research direction."
     ].join("\n");
 }
+function buildHardStopContext(runtime) {
+    const verdict = collectHardStopBlockers(runtime.state);
+    const blocker = verdict.activeBlockers[0];
+    if (!blocker) {
+        return null;
+    }
+    return [
+        `Hard-stop Researcher Checkpoint is still pending: ${blocker.id}`,
+        `Affected Research Specification area: ${blocker.scope}`,
+        `Question/obligation: ${blocker.prompt}`,
+        `Reason: ${blocker.reason}`,
+        `Required next action: ${blocker.commandHint}; or clear/defer it with an explicit rationale.`,
+        verdict.activeBlockers.length > 1 ? `Additional hard-stop blockers: ${verdict.activeBlockers.length - 1}` : ""
+    ].filter(Boolean).join("\n");
+}
 function buildActiveInterviewContext(hook) {
     const turnCount = hook.turns?.length ?? 0;
     return [
@@ -421,13 +456,9 @@ function preToolUseOutput(runtime, payload) {
     if (!stateChangingCommand) {
         return null;
     }
-    const blockingQuestion = pendingRequiredQuestions(runtime.state)[0];
-    if (blockingQuestion && mutatesLongTableResearchState(command)) {
-        return buildBlockOutput("PreToolUse", "A required LongTable checkpoint is still pending before a research-state Bash command.", buildPendingQuestionContext(blockingQuestion));
-    }
-    const blockingObligation = pendingObligations(runtime.state)[0];
-    if (blockingObligation && mutatesLongTableResearchState(command)) {
-        return buildBlockOutput("PreToolUse", "A LongTable research obligation is still pending before a research-state Bash command.", buildPendingObligationContext(blockingObligation));
+    const hardStopContext = buildHardStopContext(runtime);
+    if (hardStopContext && mutatesLongTableResearchState(command)) {
+        return buildBlockOutput("PreToolUse", "A LongTable hard-stop is pending before a research-state Bash command.", hardStopContext);
     }
     return null;
 }
@@ -438,21 +469,18 @@ function postToolUseOutput(runtime, payload) {
     const command = readCommandText(payload);
     const exitCode = readExitCode(payload);
     const output = readCombinedOutput(payload);
-    const blockingQuestion = pendingRequiredQuestions(runtime.state)[0];
-    const blockingObligation = pendingObligations(runtime.state)[0];
-    if ((blockingQuestion || blockingObligation) && mutatesLongTableResearchState(command)) {
-        return buildBlockOutput("PostToolUse", "A research-state Bash command completed while LongTable still had an unresolved checkpoint or obligation.", blockingQuestion
-            ? buildPendingQuestionContext(blockingQuestion)
-            : buildPendingObligationContext(blockingObligation));
+    const hardStopContext = buildHardStopContext(runtime);
+    if (hardStopContext && mutatesLongTableResearchState(command)) {
+        return buildBlockOutput("PostToolUse", "A research-state Bash command completed while LongTable still had an unresolved hard-stop.", hardStopContext);
     }
-    if (exitCode !== null && exitCode !== 0 && output) {
-        return buildBlockOutput("PostToolUse", "The Bash command returned a non-zero exit code and should be reviewed before LongTable continues.", "Review the command output and explain what failed before retrying or continuing.");
+    if (exitCode !== null && exitCode !== 0 && output && mutatesLongTableResearchState(command)) {
+        return buildBlockOutput("PostToolUse", "A LongTable-relevant Bash command returned a non-zero exit code and should be reviewed before LongTable continues.", "Review the command output and explain what failed before retrying or continuing.");
     }
     return null;
 }
 function stopOutput(runtime) {
-    void runtime;
-    return null;
+    const hardStopContext = buildHardStopContext(runtime);
+    return hardStopContext ? buildStopBlockOutput(hardStopContext) : null;
 }
 export async function dispatchCodexHook(payload, cwdOverride) {
     const hookEventName = readHookEventName(payload);

package/dist/panel.js

@@ -183,7 +183,7 @@ export function createPlannedInvocationRecord(options) {
         interactionDepth: "independent",
         panelPlan: options.plan,
         panelResult: options.result,
-        degradationReason: "Native provider team execution is optional; sequential fallback is the stable LongTable surface."
+        degradationReason: "Sequential fallback is the stable LongTable panel surface."
     };
 }
 function roleInstruction(member) {

package/dist/persona-router.d.ts

@@ -12,7 +12,7 @@ export interface LongTableInvocationDirective {
     explicit: boolean;
     cleanedPrompt: string;
     mode?: InteractionMode | "panel" | "status";
-    collaboration?: "panel" | "team" | "debate";
+    collaboration?: "panel" | "debate";
     roles: CanonicalPersona[];
     panel: boolean;
     showConflicts: boolean;

package/dist/persona-router.js

@@ -8,8 +8,8 @@ const DIRECTIVE_MAP = [
     { key: "draft", mode: "draft" },
     { key: "commit", mode: "commit" },
     { key: "panel", mode: "panel", collaboration: "panel", panel: true, showConflicts: true },
-    { key: "team", mode: "review", collaboration: "team", panel: true, showConflicts: true },
-    { key: "debate", mode: "review", collaboration: "debate", panel: true, showConflicts: true },
+    { key: "team", mode: "panel", collaboration: "panel", panel: true, showConflicts: true },
+    { key: "debate", mode: "panel", collaboration: "debate", panel: true, showConflicts: true },
     { key: "status", mode: "status" },
     { key: "editor", mode: "review", roles: ["editor"] },
     { key: "reviewer", mode: "review", roles: ["reviewer"] },

package/dist/project-session.d.ts

@@ -1,5 +1,6 @@
-import type { DecisionRecord, EvidenceRecord, InvocationRecord, LongTableQuestionObligation, ProviderKind, QuestionOption, QuestionCommitmentFamily, QuestionEpistemicBasis, QuestionGenerationResult, QuestionOpportunity, QuestionSurface, QuestionPromptType, QuestionRecord, ResearchSpecificationChange, ResearchSpecificationPatch, ResearchSpecificationPatchSource, ResearchSpecificationRevision, ResearchState } from "@longtable/core";
+import type { DecisionRecord, EvidenceRecord, InvocationRecord, LongTableQuestionObligation, ProviderKind, QuestionOption, HardStopScope, QuestionCommitmentFamily, QuestionEpistemicBasis, QuestionGenerationResult, QuestionOpportunity, QuestionSurface, QuestionPromptType, QuestionRecord, ResearchSpecificationChange, ResearchSpecificationPatch, ResearchSpecificationPatchSource, ResearchSpecificationRevision, ResearchState } from "@longtable/core";
 import type { SetupPersistedOutput } from "@longtable/setup";
+import { type HardStopVerdict } from "@longtable/core";
 export type ProjectDisagreementPreference = "synthesis_only" | "show_on_conflict" | "always_visible";
 export type StartInterviewSignal = "phenomenon" | "audience" | "artifact" | "evidence" | "assumption" | "decision_risk" | "voice";
 export interface StartInterviewTurn {
@@ -211,6 +212,8 @@ export interface LongTableWorkspaceInspection {
         questions: number;
         pendingQuestions: number;
         pendingObligations: number;
+        stalePendingQuestions?: number;
+        stalePendingObligations?: number;
         answeredQuestions: number;
         decisions: number;
         interviewTurns?: number;
@@ -218,6 +221,7 @@ export interface LongTableWorkspaceInspection {
         specPatches?: number;
         specRevisions?: number;
     };
+    hardStop?: HardStopVerdict;
     recentInvocations?: Array<{
         id: string;
         kind: string;
@@ -234,6 +238,8 @@ export interface LongTableWorkspaceInspection {
         question: string;
         commitmentFamily?: QuestionCommitmentFamily;
         epistemicBasis?: QuestionEpistemicBasis;
+        hardStop?: boolean;
+        hardStopScope?: string;
         options: string[];
         required: boolean;
     }>;
@@ -242,6 +248,8 @@ export interface LongTableWorkspaceInspection {
         kind: string;
         prompt: string;
         reason: string;
+        hardStop?: boolean;
+        hardStopScope?: string;
         questionId?: string;
     }>;
     recentDecisions?: Array<{
@@ -379,6 +387,8 @@ export declare function createWorkspaceFollowUpQuestions(options: {
     prompt: string;
     provider?: ProviderKind;
     required?: boolean;
+    hardStop?: boolean;
+    hardStopScope?: HardStopScope;
     force?: boolean;
     auto?: boolean;
     requiredOnly?: boolean;
@@ -401,6 +411,8 @@ export declare function createWorkspaceQuestion(options: {
     displayReason?: string;
     provider?: ProviderKind;
     required?: boolean;
+    hardStop?: boolean;
+    hardStopScope?: HardStopScope;
     commitmentFamily?: QuestionCommitmentFamily;
     epistemicBasis?: QuestionEpistemicBasis;
 }): Promise<{

package/dist/project-session.js

@@ -4,6 +4,7 @@ import { execSync } from "node:child_process";
 import { dirname, join, resolve } from "node:path";
 import { appendDecisionRecord as appendDecisionToResearchState, appendInvocationRecord as appendInvocationToResearchState, appendQuestionRecords, createEmptyResearchState } from "@longtable/memory";
 import { classifyCheckpointTrigger } from "@longtable/checkpoints";
+import { collectHardStopBlockers } from "@longtable/core";
 import { ensureRequiredQuestionObligation, pendingQuestionObligations, resolveQuestionObligationByQuestionId } from "./question-obligations.js";
 const CURRENT_FILE_NAME = "CURRENT.md";
 const LEGACY_ROOT_FILES = ["LONGTABLE.md", "START-HERE.md", "NEXT-STEPS.md", "SESSION-SNAPSHOT.md"];
@@ -765,6 +766,7 @@ function summarizeWorkspaceInspection(context, state) {
     const pendingQuestions = questions.filter((record) => record.status === "pending");
     const answeredQuestions = questions.filter((record) => record.status === "answered");
     const pendingObligations = visiblePendingObligations(state);
+    const hardStop = collectHardStopBlockers(state);
     return {
         found: true,
         rootPath: context.project.projectPath,
@@ -803,6 +805,8 @@ function summarizeWorkspaceInspection(context, state) {
             questions: questions.length,
             pendingQuestions: pendingQuestions.length,
             pendingObligations: pendingObligations.length,
+            stalePendingQuestions: hardStop.stalePendingQuestionCount,
+            stalePendingObligations: hardStop.stalePendingObligationCount,
             answeredQuestions: answeredQuestions.length,
             decisions: (state.decisionLog ?? []).length,
             interviewTurns: (state.interviewTurns ?? []).length,
@@ -810,6 +814,7 @@ function summarizeWorkspaceInspection(context, state) {
             specPatches: (state.specPatches ?? []).length,
             specRevisions: (state.specRevisions ?? []).length
         },
+        hardStop,
         recentInvocations: recentInvocationRecords(state, 5).map((record) => ({
             id: record.id,
             kind: record.intent.kind,
@@ -826,6 +831,8 @@ function summarizeWorkspaceInspection(context, state) {
             question: record.prompt.question,
             ...(record.commitmentFamily ? { commitmentFamily: record.commitmentFamily } : {}),
             ...(record.epistemicBasis ? { epistemicBasis: record.epistemicBasis } : {}),
+            ...(typeof record.hardStop === "boolean" ? { hardStop: record.hardStop } : {}),
+            ...(record.hardStopScope ? { hardStopScope: record.hardStopScope } : {}),
             options: formatQuestionOptionValues(record),
             required: record.prompt.required
         })),
@@ -834,6 +841,8 @@ function summarizeWorkspaceInspection(context, state) {
             kind: obligation.kind,
             prompt: obligation.prompt,
             reason: obligation.reason,
+            ...(typeof obligation.hardStop === "boolean" ? { hardStop: obligation.hardStop } : {}),
+            ...(obligation.hardStopScope ? { hardStopScope: obligation.hardStopScope } : {}),
             ...(obligation.questionId ? { questionId: obligation.questionId } : {})
         })),
         recentDecisions: (state.decisionLog ?? []).slice(-5).reverse().map((record) => ({
@@ -2266,7 +2275,7 @@ const COMMITMENT_FAMILY_BY_CHECKPOINT = [
     [/research_question|research_direction|scope|boundary|inclusion|exclusion/, "scope"],
     [/theory|construct|conceptual/, "construct"],
     [/measurement|coding|codebook|extraction/, "coding"],
-    [/method|analysis|panel_disagreement|team_debate|review/, "method"],
+    [/method|analysis|panel_disagreement|panel_debate|team_debate|review/, "method"],
     [/evidence|scholarly_access|source_authority/, "evidence"],
     [/knowledge_gap|tacit_assumption|epistemic/, "epistemic_authority"]
 ];
@@ -2305,12 +2314,45 @@ function inferEpistemicBasis(input) {
         return "mixed";
     return unique[0];
 }
+function inferHardStopScope(input, commitmentFamily) {
+    if (commitmentFamily === "product_policy")
+        return undefined;
+    if (commitmentFamily === "scope")
+        return "scope";
+    if (commitmentFamily === "construct" || commitmentFamily === "coding")
+        return "construct";
+    if (commitmentFamily === "method")
+        return "method";
+    if (commitmentFamily === "evidence")
+        return "evidence";
+    if (commitmentFamily === "epistemic_authority")
+        return "protected_decision";
+    const text = compactMetadataText([input.checkpointKey, input.title, input.question, input.prompt, input.rationale]);
+    if (textMatchesAny(text, [/product_runtime|checkpoint policy|hook ux|setup|install|cli|npm|release|git|github|docs?|readme|package|workflow/])) {
+        return undefined;
+    }
+    if (textMatchesAny(text, [/protected_decision|closure/]))
+        return "protected_decision";
+    if (textMatchesAny(text, [/research_question|research direction|question_freeze/]))
+        return "research_question";
+    if (textMatchesAny(text, [/scope|boundary|inclusion|exclusion/]))
+        return "scope";
+    if (textMatchesAny(text, [/construct|theory|frame|ontology|measurement|coding|validity/]))
+        return "construct";
+    if (textMatchesAny(text, [/method|design|sample|analysis|strategy|model/]))
+        return "method";
+    if (textMatchesAny(text, [/evidence|access|source|corpus|pdf|full[-_ ]?text|scholarly/]))
+        return "evidence";
+    return undefined;
+}
 function resolveQuestionRecordMetadata(input) {
     const commitmentFamily = input.commitmentFamily ?? inferCommitmentFamily(input);
     const epistemicBasis = input.epistemicBasis ?? inferEpistemicBasis(input);
+    const hardStopScope = inferHardStopScope(input, commitmentFamily);
     return {
         ...(commitmentFamily ? { commitmentFamily } : {}),
-        ...(epistemicBasis ? { epistemicBasis } : {})
+        ...(epistemicBasis ? { epistemicBasis } : {}),
+        ...(hardStopScope ? { hardStop: true, hardStopScope } : {})
     };
 }
 function hasFollowUpPrompt(record, prompt) {
@@ -2371,6 +2413,8 @@ export async function createWorkspaceFollowUpQuestions(options) {
             updatedAt: createdAt,
             status: "pending",
             ...metadata,
+            ...(typeof options.hardStop === "boolean" ? { hardStop: options.hardStop } : {}),
+            ...(options.hardStopScope ? { hardStopScope: options.hardStopScope } : {}),
             prompt: {
                 id: createId("question_prompt"),
                 checkpointKey,
@@ -2425,6 +2469,8 @@ export async function createWorkspaceQuestion(options) {
         updatedAt: createdAt,
         status: "pending",
         ...metadata,
+        ...(typeof options.hardStop === "boolean" ? { hardStop: options.hardStop } : {}),
+        ...(options.hardStopScope ? { hardStopScope: options.hardStopScope } : {}),
         prompt: {
             id: createId("question_prompt"),
             checkpointKey,

package/dist/question-obligations.js

@@ -17,6 +17,8 @@ export function createRequiredQuestionObligation(question) {
         updatedAt: timestamp,
         prompt: question.prompt.question,
         reason: question.prompt.displayReason ?? "A required LongTable checkpoint is pending.",
+        ...(question.hardStop !== undefined ? { hardStop: question.hardStop } : {}),
+        ...(question.hardStopScope ? { hardStopScope: question.hardStopScope } : {}),
         questionId: question.id
     };
 }

package/package.json

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