@longtable/cli 0.1.40 → 0.1.42

package/dist/cli.js

@@ -3,6 +3,7 @@ import { existsSync, readFileSync, statSync } from "node:fs";
 import { mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
 import { execSync } from "node:child_process";
 import { createInterface } from "node:readline/promises";
+import { createRequire } from "node:module";
 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";
@@ -44,8 +45,10 @@ const ANSI = {
     cyan: "\u001B[36m",
     green: "\u001B[32m"
 };
+const require = createRequire(import.meta.url);
+const LONGTABLE_PACKAGE_VERSION = String(require("../package.json").version ?? "0.0.0");
 const LONGTABLE_MCP_SERVER_NAME = "longtable-state";
-const LONGTABLE_MCP_PACKAGE_VERSION = "0.1.39";
+const LONGTABLE_MCP_PACKAGE_VERSION = LONGTABLE_PACKAGE_VERSION;
 const LONGTABLE_MCP_MARKER_START = "# LongTable state MCP START";
 const LONGTABLE_MCP_MARKER_END = "# LongTable state MCP END";
 function style(text, prefix) {

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

@@ -129,6 +129,33 @@ function looksLikeResearchDomainPrompt(prompt) {
 function looksLikeResearchCommitmentPrompt(prompt) {
     return looksLikeResearchDomainPrompt(prompt) && looksLikeClosurePrompt(prompt);
 }
+function looksLikeExplicitInterviewPrompt(prompt) {
+    const normalized = prompt.trim();
+    if (!normalized) {
+        return false;
+    }
+    if (/\$longtable-interview\b/i.test(normalized)) {
+        return true;
+    }
+    if (looksLikeLongTableProductOrToolingPrompt(normalized)) {
+        return false;
+    }
+    return /\bLongTable\b.*\binterview\b/i.test(normalized)
+        || /\bfirst research shape\b/i.test(normalized)
+        || /롱테이블.*인터뷰|LongTable.*인터뷰|First Research Shape/i.test(normalized);
+}
+function looksLikeResearchStateConfirmationPrompt(prompt) {
+    if (looksLikeLongTableProductOrToolingPrompt(prompt) && !looksLikeExplicitInterviewPrompt(prompt)) {
+        return false;
+    }
+    return looksLikeResearchCommitmentPrompt(prompt)
+        || (looksLikeExplicitInterviewPrompt(prompt) && looksLikeClosurePrompt(prompt))
+        || /\b(confirm|summarize|save|store|record)\b.*\b(first research shape|research direction|research shape)\b/i.test(prompt)
+        || /(First Research Shape|연구\s*방향|연구\s*형태).*(확정|저장|기록|요약)/.test(prompt);
+}
+function shouldSurfaceInterviewContext(prompt) {
+    return looksLikeExplicitInterviewPrompt(prompt) || looksLikeResearchStateConfirmationPrompt(prompt);
+}
 function buildResponseOnlyAdvisoryQuestions(prompt) {
     if (looksLikeLongTableProductOrToolingPrompt(prompt)) {
         return [];
@@ -167,6 +194,14 @@ function isStateChangingBash(command) {
     return /\b(git\s+commit|npm\s+version|mv|cp|rm|sed\s+-i|perl\s+-i|tee|touch|mkdir|rmdir|apply_patch|patch)\b/.test(normalized)
         || />\s*\S+/.test(normalized);
 }
+function mutatesLongTableResearchState(command) {
+    const normalized = command.trim();
+    if (!normalized) {
+        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);
+}
 async function loadLongTableRuntime(startPath) {
     const context = await loadProjectContextFromDirectory(startPath);
     if (!context) {
@@ -206,6 +241,13 @@ function buildPendingQuestionContext(question) {
         "Do not choose or record an answer unless the researcher explicitly provides the selection."
     ].join("\n");
 }
+function buildSeparatePendingQuestionNotice(question) {
+    return [
+        `Separate unresolved Researcher Checkpoint: ${question.prompt.title}.`,
+        `Question: ${question.prompt.question}`,
+        "This is not part of the active interview. Keep it visible, but do not answer or record it unless the researcher explicitly provides the selection."
+    ].join("\n");
+}
 function buildGeneratedQuestionsContext(questions, created) {
     const lines = [
         created
@@ -239,6 +281,12 @@ function buildPendingObligationContext(obligation) {
             : "Resume the LongTable interview and let it ask the next research-facing checkpoint before settling the direction."
     ].join("\n");
 }
+function buildSeparatePendingObligationNotice(obligation) {
+    return [
+        `Separate unresolved LongTable obligation: ${obligation.prompt}`,
+        "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 buildActiveInterviewContext(hook) {
     const turnCount = hook.turns?.length ?? 0;
     return [
@@ -254,30 +302,48 @@ function sessionStartContext(runtime) {
     const interview = activeInterviewHook(runtime.state);
     const needsDetailedSummary = Boolean(blockingQuestion || blockingObligation);
     const sections = [buildWorkspaceSummary(runtime, needsDetailedSummary ? "full" : "compact").join("\n")];
-    if (blockingQuestion) {
+    if (interview) {
+        sections.push(buildActiveInterviewContext(interview));
+        if (blockingQuestion) {
+            sections.push(buildSeparatePendingQuestionNotice(blockingQuestion));
+        }
+        else if (blockingObligation) {
+            sections.push(buildSeparatePendingObligationNotice(blockingObligation));
+        }
+    }
+    else if (blockingQuestion) {
         sections.push(buildPendingQuestionContext(blockingQuestion));
     }
     else if (blockingObligation) {
         sections.push(buildPendingObligationContext(blockingObligation));
     }
-    else if (interview) {
-        sections.push(buildActiveInterviewContext(interview));
-    }
     sections.push("Treat `.longtable/` state and `CURRENT.md` as the source of truth for this workspace.");
     return sections.filter(Boolean).join("\n\n");
 }
 async function userPromptSubmitContext(runtime, prompt) {
     const blockingQuestion = pendingRequiredQuestions(runtime.state)[0];
-    if (blockingQuestion) {
+    const blockingObligation = pendingObligations(runtime.state)[0];
+    const interview = activeInterviewHook(runtime.state);
+    const shouldSurfaceInterview = shouldSurfaceInterviewContext(prompt);
+    const shouldSurfaceBlockingState = looksLikeResearchStateConfirmationPrompt(prompt);
+    if (interview && shouldSurfaceInterview) {
+        const sections = [buildActiveInterviewContext(interview)];
+        if (blockingQuestion) {
+            sections.push(buildSeparatePendingQuestionNotice(blockingQuestion));
+        }
+        else if (blockingObligation) {
+            sections.push(buildSeparatePendingObligationNotice(blockingObligation));
+        }
+        return sections.join("\n\n");
+    }
+    if (blockingQuestion && shouldSurfaceBlockingState) {
         return buildPendingQuestionContext(blockingQuestion);
     }
-    const blockingObligation = pendingObligations(runtime.state)[0];
-    if (blockingObligation) {
+    if (blockingObligation && shouldSurfaceBlockingState) {
         return buildPendingObligationContext(blockingObligation);
     }
-    const interview = activeInterviewHook(runtime.state);
     if (interview) {
-        return buildActiveInterviewContext(interview);
+        return null;
     }
     const generatedQuestions = [];
     let createdQuestions = false;
@@ -319,16 +385,17 @@ function preToolUseOutput(runtime, payload) {
         return null;
     }
     const command = readCommandText(payload);
-    if (!isStateChangingBash(command)) {
+    const stateChangingCommand = isStateChangingBash(command) || mutatesLongTableResearchState(command);
+    if (!stateChangingCommand) {
         return null;
     }
     const blockingQuestion = pendingRequiredQuestions(runtime.state)[0];
-    if (blockingQuestion) {
-        return buildBlockOutput("PreToolUse", "A required LongTable checkpoint is still pending before a state-changing Bash command.", buildPendingQuestionContext(blockingQuestion));
+    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) {
-        return buildBlockOutput("PreToolUse", "A LongTable research obligation is still pending before a state-changing Bash command.", buildPendingObligationContext(blockingObligation));
+    if (blockingObligation && mutatesLongTableResearchState(command)) {
+        return buildBlockOutput("PreToolUse", "A LongTable research obligation is still pending before a research-state Bash command.", buildPendingObligationContext(blockingObligation));
     }
     return null;
 }
@@ -341,8 +408,8 @@ function postToolUseOutput(runtime, payload) {
     const output = readCombinedOutput(payload);
     const blockingQuestion = pendingRequiredQuestions(runtime.state)[0];
     const blockingObligation = pendingObligations(runtime.state)[0];
-    if ((blockingQuestion || blockingObligation) && isStateChangingBash(command)) {
-        return buildBlockOutput("PostToolUse", "A state-changing Bash command completed while LongTable still had an unresolved checkpoint or obligation.", blockingQuestion
+    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));
     }

package/dist/project-session.d.ts

@@ -44,6 +44,8 @@ export interface LongTableInterviewTurn {
     quality: InterviewTurnQuality;
     needsFollowUp: boolean;
     followUpQuestion?: string;
+    readyToSummarize?: boolean;
+    readinessRationale?: string[];
     rationale?: string[];
 }
 export interface LongTableHookRun {
@@ -204,6 +206,8 @@ export declare function appendLongTableInterviewTurn(options: {
     quality?: InterviewTurnQuality;
     needsFollowUp?: boolean;
     followUpQuestion?: string;
+    readyToSummarize?: boolean;
+    readinessRationale?: string[];
     rationale?: string[];
 }): Promise<{
     hook: LongTableHookRun;

package/dist/project-session.js

@@ -420,7 +420,9 @@ function buildProjectAgentsMd(project, session) {
         "",
         "## Research Behavior",
         "- Begin exploratory work with clarifying or tension questions before recommending a direction.",
-        "- For `$longtable-interview`, ask one natural-language question at a time, reflect with `LongTable hears: ...`, and avoid early reader/reviewer or theory/method/measurement classification.",
+        "- For `$longtable-interview`, ask one natural-language question at a time, reflect with `LongTable hears: ...`, record turns when MCP is available, and avoid early reader/reviewer or theory/method/measurement classification.",
+        "- Do not summarize `$longtable-interview` because a fixed number of turns has passed; wait for content-based readiness around research object, focal uncertainty, boundary, evidence/material, protected decision, and next action.",
+        "- Do not let unrelated pending Researcher Checkpoints interrupt `$longtable-interview`; mention them only as separate unresolved checkpoints unless the researcher is confirming, saving, or recording a research decision.",
         "- Use structured options only at the final First Research Shape confirmation or at true checkpoint boundaries.",
         "- If you foreground role perspectives, disclose them with `LongTable consulted: ...`.",
         "- Keep one accountable synthesis, but do not hide meaningful disagreement.",
@@ -580,10 +582,10 @@ function defaultFollowUpQuestion(answer) {
     return "What concrete scene, case, material, text, dataset, or decision would make that problem easier to inspect first?";
 }
 function depthForInterview(turns = []) {
-    const usableTurns = turns.filter((turn) => turn.quality !== "thin").length;
-    if (usableTurns >= 3) {
+    if (turns.some((turn) => turn.readyToSummarize === true && turn.quality !== "thin")) {
         return "ready_to_summarize";
     }
+    const usableTurns = turns.filter((turn) => turn.quality !== "thin").length;
     if (usableTurns >= 1) {
         return "forming_first_handle";
     }
@@ -614,6 +616,15 @@ export async function beginLongTableInterview(options) {
     if (existing) {
         return { hook: existing, state };
     }
+    const confirmedShape = state.firstResearchShape?.confirmedAt ? state.firstResearchShape : undefined;
+    if (confirmedShape) {
+        const confirmedHook = [...(state.hooks ?? [])].reverse().find((hook) => hook.kind === "longtable_interview" &&
+            hook.status === "confirmed" &&
+            hook.firstResearchShape?.handle === confirmedShape.handle);
+        if (confirmedHook) {
+            return { hook: confirmedHook, state };
+        }
+    }
     const timestamp = nowIso();
     const hook = {
         id: createId("hook_interview"),
@@ -654,6 +665,10 @@ export async function appendLongTableInterviewTurn(options) {
     const followUpQuestion = needsFollowUp
         ? options.followUpQuestion ?? defaultFollowUpQuestion(options.answer)
         : options.followUpQuestion;
+    const readyToSummarize = options.readyToSummarize === true && quality !== "thin";
+    const readinessRationale = options.readinessRationale
+        ?.map((rationale) => rationale.trim())
+        .filter(Boolean);
     const timestamp = nowIso();
     const turns = existing.turns ?? [];
     const turn = {
@@ -666,6 +681,8 @@ export async function appendLongTableInterviewTurn(options) {
         quality,
         needsFollowUp,
         ...(followUpQuestion?.trim() ? { followUpQuestion: followUpQuestion.trim() } : {}),
+        ...(readyToSummarize ? { readyToSummarize } : {}),
+        ...(readinessRationale && readinessRationale.length > 0 ? { readinessRationale } : {}),
         ...(options.rationale && options.rationale.length > 0 ? { rationale: options.rationale } : {})
     };
     const nextTurns = [...turns, turn];
@@ -678,7 +695,10 @@ export async function appendLongTableInterviewTurn(options) {
         turns: nextTurns,
         qualityNotes: [
             ...(existing.qualityNotes ?? []),
-            ...(needsFollowUp ? [`Turn ${turn.index} needs follow-up: ${followUpQuestion}`] : [])
+            ...(needsFollowUp ? [`Turn ${turn.index} needs follow-up: ${followUpQuestion}`] : []),
+            ...(readyToSummarize
+                ? [`Turn ${turn.index} marked ready to summarize: ${(readinessRationale ?? ["content-based readiness signal"]).join("; ")}`]
+                : [])
         ]
     };
     const updated = upsertHook(state, hook);

package/package.json

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