@longtable/cli 0.1.51 → 0.1.52

package/README.md

@@ -85,3 +85,19 @@ longtable search --query "<topic>"
 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";
@@ -169,6 +170,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 +1529,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 +1597,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 +1634,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 +1652,8 @@ async function collectDoctorStatus(args) {
                 missingSkills: missingNames(expectedClaudeSkills, installedClaudeSkills)
             }
         },
-        workspace
+        workspace,
+        hardStop
     };
 }
 function renderProviderDoctorBlock(label, provider) {
@@ -1665,6 +1691,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 +1704,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 +1718,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 +1778,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) {
@@ -2813,7 +2861,7 @@ async function runAccess(subcommand, args) {
         await runAccessSetup(args);
         return;
     }
-    if (subcommand === "status") {
+    if (subcommand === "status" || subcommand === "hook-doctor") {
         await runAccessStatus(args);
         return;
     }
@@ -3768,7 +3816,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 +3825,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 +3845,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 +3889,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.");

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/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);
 }
@@ -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/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) => ({
@@ -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.52",
   "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.52",
+    "@longtable/core": "0.1.52",
+    "@longtable/memory": "0.1.52",
+    "@longtable/provider-claude": "0.1.52",
+    "@longtable/provider-codex": "0.1.52",
+    "@longtable/setup": "0.1.52"
   },
   "devDependencies": {
     "@types/node": "^22.10.1",