@longtable/mcp 0.1.44 → 0.1.47

package/README.md

@@ -15,7 +15,7 @@ longtable-state
 Run:
 
 ```bash
-npx -y @longtable/mcp@0.1.41
+npx -y @longtable/mcp@0.1.47
 ```
 
 Self-test:

package/dist/research-specification.d.ts

@@ -62,4 +62,5 @@ export interface ResearchSpecificationQuestionSpec {
 export declare function renderResearchSpecificationPreview(specification: ResearchSpecification): string;
 export declare function buildResearchSpecificationQuestion(specification: ResearchSpecification): ResearchSpecificationQuestionSpec;
 export declare function researchSpecificationAnswerConfirms(answer: string): boolean;
+export declare function researchSpecificationAnswerNeedsFollowUp(answer: string): boolean;
 export declare function researchSpecificationAnswerStatus(answer: string): "confirmed" | "active" | "deferred";

package/dist/research-specification.js

@@ -34,6 +34,8 @@ export function renderResearchSpecificationPreview(specification) {
         `${korean ? "이론 앵커" : "Theory anchors"}: ${compactList(specification.theoryAndFraming.anchors)}`,
         `${korean ? "코딩 규칙" : "Coding rules"}: ${compactList(specification.measurementCoding.codingRules)}`,
         `${korean ? "분석 옵션" : "Analysis options"}: ${compactList(specification.methodAnalysis.analysisOptions)}`,
+        `${korean ? "Corpus and Access Plan" : "Corpus and Access Plan"}: ${compactList(specification.evidenceAccess.accessRequirements ?? [])}`,
+        `${korean ? "근거 기준" : "Evidence standards"}: ${compactList(specification.evidenceAccess.evidenceStandards ?? [])}`,
         specification.epistemicAlignment.conflictResolutionRule
             ? `${korean ? "충돌 조정" : "Conflict rule"}: ${specification.epistemicAlignment.conflictResolutionRule}`
             : undefined,
@@ -43,6 +45,22 @@ export function renderResearchSpecificationPreview(specification) {
     ].filter(Boolean);
     return lines.join("\n");
 }
+function renderResearchSpecificationDecisionContext(specification) {
+    const korean = usesKorean(specification);
+    const lines = [
+        korean ? "Research Specification Preview" : "Research Specification Preview",
+        `${korean ? "제목" : "Title"}: ${specification.title}`,
+        `${korean ? "목적" : "Purpose"}: ${specification.researchDirection.purpose}`,
+        `${korean ? "핵심 construct" : "Core constructs"}: ${compactList(specification.constructOntology.coreConstructs, 2)}`,
+        `${korean ? "접근 계획" : "Access plan"}: ${compactList(specification.evidenceAccess.accessRequirements ?? [], 1)}`,
+        `${korean ? "열린 질문" : "Open questions"}: ${compactList(specification.openQuestions, 1)}`,
+        `${korean ? "다음 행동" : "Next actions"}: ${compactList(specification.nextActions, 1)}`,
+        korean
+            ? "전체 명세는 tool output과 저장 후 CURRENT.md에서 확인합니다."
+            : "The full specification remains in the tool output and, after saving, CURRENT.md."
+    ];
+    return lines.join("\n");
+}
 function baseOptions(specification) {
     const korean = usesKorean(specification);
     return [
@@ -81,6 +99,7 @@ function baseOptions(specification) {
 export function buildResearchSpecificationQuestion(specification) {
     const korean = usesKorean(specification);
     const preview = renderResearchSpecificationPreview(specification);
+    const decisionContext = renderResearchSpecificationDecisionContext(specification);
     return {
         prompt: preview,
         title: korean ? "Research Specification 확인" : "Research Specification Confirmation",
@@ -90,13 +109,16 @@ export function buildResearchSpecificationQuestion(specification) {
         checkpointKey: "research_specification_confirmation",
         options: baseOptions(specification),
         displayReason: korean
-            ? `${preview}\n\n인터뷰가 단순한 방향 요약을 넘어 연구 명세를 만들 만큼 구체화되었습니다. 저장 전에 범위, construct, 이론, 코딩, 방법, 접근, 정렬을 명시적으로 확인해야 합니다.`
-            : `${preview}\n\nThe interview has moved beyond a short direction summary into a research specification. Scope, constructs, theory, coding, method, access, and epistemic alignment should be explicit before saving.`
+            ? `${decisionContext}\n\n인터뷰가 연구 명세를 만들 만큼 구체화되었습니다. 저장 전 핵심 범위와 다음 행동만 UI에서 확인합니다.`
+            : `${decisionContext}\n\nThe interview is ready for a research specification. The UI shows only the core scope and next action before saving.`
     };
 }
 export function researchSpecificationAnswerConfirms(answer) {
     return answer === "confirm_specification";
 }
+export function researchSpecificationAnswerNeedsFollowUp(answer) {
+    return answer === "ask_one_more" || answer === "revise_section";
+}
 export function researchSpecificationAnswerStatus(answer) {
     if (researchSpecificationAnswerConfirms(answer)) {
         return "confirmed";

package/dist/server.js

@@ -13,7 +13,7 @@ import { renderQuestionRecordPrompt } from "@longtable/provider-codex";
 import { loadSetupOutput } from "@longtable/setup";
 import { answerWorkspaceQuestion, clearWorkspaceQuestion, createOrUpdateProjectWorkspace, createWorkspaceQuestion, inspectProjectWorkspace, loadProjectContextFromDirectory, loadWorkspaceState, syncCurrentWorkspaceView } from "@longtable/cli";
 import { buildFirstResearchShapeQuestion, firstResearchShapeAnswerConfirms, firstResearchShapeAnswerStatus } from "./first-research-shape.js";
-import { buildResearchSpecificationQuestion, renderResearchSpecificationPreview, researchSpecificationAnswerConfirms, researchSpecificationAnswerStatus } from "./research-specification.js";
+import { buildResearchSpecificationQuestion, renderResearchSpecificationPreview, researchSpecificationAnswerConfirms, researchSpecificationAnswerNeedsFollowUp, researchSpecificationAnswerStatus } from "./research-specification.js";
 const SERVER_NAME = "longtable-state";
 const require = createRequire(import.meta.url);
 const SERVER_VERSION = String(require("../package.json").version ?? "0.0.0");
@@ -47,6 +47,22 @@ const questionOptionSchema = z.object({
     description: z.string().optional(),
     recommended: z.boolean().optional()
 });
+const commitmentFamilySchema = z.enum([
+    "scope",
+    "construct",
+    "coding",
+    "method",
+    "evidence",
+    "epistemic_authority",
+    "product_policy"
+]);
+const epistemicBasisSchema = z.enum([
+    "researcher_knowledge",
+    "project_state",
+    "external_evidence",
+    "ai_inference",
+    "mixed"
+]);
 const firstResearchShapeSchema = z.object({
     handle: z.string().min(1),
     currentGoal: z.string().min(1),
@@ -228,6 +244,57 @@ function resolveFirstResearchShapeObligation(state, options) {
         })
     };
 }
+function researchSpecificationFollowUpReason(answer) {
+    if (answer === "ask_one_more") {
+        return "The researcher chose one more question before saving; after that answer, LongTable must update or read the Research Specification and return to confirmation.";
+    }
+    if (answer === "revise_section") {
+        return "The researcher chose section revision; after the section is revised, LongTable must return to the Research Specification Preview for confirmation.";
+    }
+    return "Research Specification confirmation remains open.";
+}
+function ensureResearchSpecificationConfirmationObligation(state, specification, options) {
+    const existing = (state.questionObligations ?? []).find((obligation) => obligation.kind === "research_specification_confirmation" &&
+        obligation.status === "pending" &&
+        ((specification.sourceHookId && obligation.sourceHookId === specification.sourceHookId) ||
+            (!specification.sourceHookId && obligation.prompt.includes(specification.title))));
+    const timestamp = new Date().toISOString();
+    const next = {
+        ...(existing ?? {
+            id: createId("question_obligation"),
+            kind: "research_specification_confirmation",
+            status: "pending",
+            createdAt: timestamp
+        }),
+        updatedAt: timestamp,
+        prompt: `Return to Research Specification Preview before ending the interview: ${specification.title}`,
+        reason: researchSpecificationFollowUpReason(options.answer),
+        ...(specification.sourceHookId ? { sourceHookId: specification.sourceHookId } : {}),
+        ...(options.questionId ? { questionId: options.questionId } : existing?.questionId ? { questionId: existing.questionId } : {}),
+        ...(options.decisionId ? { decisionId: options.decisionId } : existing?.decisionId ? { decisionId: existing.decisionId } : {})
+    };
+    return upsertQuestionObligation(state, next);
+}
+function resolveResearchSpecificationConfirmationObligation(state, specification, options = {}) {
+    return {
+        ...state,
+        questionObligations: (state.questionObligations ?? []).map((obligation) => {
+            const matches = obligation.kind === "research_specification_confirmation" && ((specification.sourceHookId && obligation.sourceHookId === specification.sourceHookId) ||
+                (options.questionId && obligation.questionId === options.questionId) ||
+                (!specification.sourceHookId && obligation.prompt.includes(specification.title)));
+            if (!matches || obligation.status !== "pending") {
+                return obligation;
+            }
+            return {
+                ...obligation,
+                status: options.status ?? "satisfied",
+                updatedAt: new Date().toISOString(),
+                ...(options.questionId ? { questionId: options.questionId } : obligation.questionId ? { questionId: obligation.questionId } : {}),
+                ...(options.decisionId ? { decisionId: options.decisionId } : obligation.decisionId ? { decisionId: obligation.decisionId } : {})
+            };
+        })
+    };
+}
 function interviewDepth(turns) {
     if (turns.some((turn) => turn.readyToSummarize === true && turn.quality !== "thin")) {
         return "ready_to_summarize";
@@ -794,6 +861,23 @@ async function markResearchSpecificationConfirmation(context, specification, ans
                 : hook.linkedDecisionRecordIds
         };
     });
+    const nextState = researchSpecificationAnswerConfirms(answer)
+        ? resolveResearchSpecificationConfirmationObligation(state, confirmedSpecification, {
+            questionId,
+            decisionId,
+            status: "satisfied"
+        })
+        : researchSpecificationAnswerNeedsFollowUp(answer)
+            ? ensureResearchSpecificationConfirmationObligation(state, confirmedSpecification, {
+                answer,
+                questionId,
+                decisionId
+            })
+            : resolveResearchSpecificationConfirmationObligation(state, confirmedSpecification, {
+                questionId,
+                decisionId,
+                status: "cleared"
+            });
     const session = {
         ...context.session,
         researchSpecification: confirmedSpecification,
@@ -801,9 +885,9 @@ async function markResearchSpecificationConfirmation(context, specification, ans
     };
     context.session = session;
     await writeFile(context.sessionFilePath, JSON.stringify(session, null, 2), "utf8");
-    await writeFile(context.stateFilePath, JSON.stringify(state, null, 2), "utf8");
+    await writeFile(context.stateFilePath, JSON.stringify(nextState, null, 2), "utf8");
     await syncCurrentWorkspaceView(context);
-    return { state, session, specification: confirmedSpecification };
+    return { state: nextState, session, specification: confirmedSpecification };
 }
 async function markAlreadyConfirmedResearchSpecification(context, specification) {
     const state = asInterviewState(await loadWorkspaceState(context));
@@ -832,6 +916,9 @@ async function markAlreadyConfirmedResearchSpecification(context, specification)
             researchSpecification: confirmedSpecification
         };
     });
+    const nextState = resolveResearchSpecificationConfirmationObligation(state, confirmedSpecification, {
+        status: "satisfied"
+    });
     const session = {
         ...context.session,
         researchSpecification: confirmedSpecification,
@@ -839,9 +926,9 @@ async function markAlreadyConfirmedResearchSpecification(context, specification)
     };
     context.session = session;
     await writeFile(context.sessionFilePath, JSON.stringify(session, null, 2), "utf8");
-    await writeFile(context.stateFilePath, JSON.stringify(state, null, 2), "utf8");
+    await writeFile(context.stateFilePath, JSON.stringify(nextState, null, 2), "utf8");
     await syncCurrentWorkspaceView(context);
-    return { state, session, specification: confirmedSpecification };
+    return { state: nextState, session, specification: confirmedSpecification };
 }
 function statusForElicitationError(error) {
     const message = error instanceof Error ? error.message : String(error);
@@ -1428,9 +1515,11 @@ export function createLongTableMcpServer() {
             options: z.array(questionOptionSchema).optional(),
             displayReason: z.string().optional(),
             provider: z.enum(["codex", "claude"]).optional(),
-            required: z.boolean().optional()
+            required: z.boolean().optional(),
+            commitmentFamily: commitmentFamilySchema.optional(),
+            epistemicBasis: epistemicBasisSchema.optional()
         })
-    }, async ({ cwd: inputCwd, prompt, title, question, checkpointKey, options, displayReason, provider, required }) => {
+    }, async ({ cwd: inputCwd, prompt, title, question, checkpointKey, options, displayReason, provider, required, commitmentFamily, epistemicBasis }) => {
         try {
             const context = await requireContext(inputCwd);
             const result = await createWorkspaceQuestion({
@@ -1442,7 +1531,9 @@ export function createLongTableMcpServer() {
                 questionOptions: options,
                 displayReason,
                 provider,
-                required
+                required,
+                commitmentFamily: commitmentFamily,
+                epistemicBasis: epistemicBasis
             });
             return textResult({
                 question: result.question,
@@ -1465,9 +1556,11 @@ export function createLongTableMcpServer() {
             displayReason: z.string().optional(),
             provider: z.enum(["codex", "claude"]).default("codex"),
             required: z.boolean().optional(),
+            commitmentFamily: commitmentFamilySchema.optional(),
+            epistemicBasis: epistemicBasisSchema.optional(),
             fallbackOnly: z.boolean().default(false).describe("Create and render the checkpoint without calling MCP elicitation.")
         })
-    }, async ({ cwd: inputCwd, prompt, title, question, checkpointKey, options, displayReason, provider, required, fallbackOnly }) => {
+    }, async ({ cwd: inputCwd, prompt, title, question, checkpointKey, options, displayReason, provider, required, commitmentFamily, epistemicBasis, fallbackOnly }) => {
         try {
             const context = await requireContext(inputCwd);
             const created = await createWorkspaceQuestion({
@@ -1479,7 +1572,9 @@ export function createLongTableMcpServer() {
                 questionOptions: options,
                 displayReason,
                 provider,
-                required
+                required,
+                commitmentFamily: commitmentFamily,
+                epistemicBasis: epistemicBasis
             });
             const fallback = renderQuestionFallback(created.question, provider);
             if (fallbackOnly) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longtable/mcp",
-  "version": "0.1.44",
+  "version": "0.1.47",
   "private": false,
   "description": "LongTable MCP transport for workspace state and Researcher Checkpoints",
   "type": "module",
@@ -26,12 +26,12 @@
     "self-test": "node ./dist/server.js --self-test"
   },
   "dependencies": {
-    "@longtable/checkpoints": "0.1.44",
-    "@longtable/cli": "0.1.44",
-    "@longtable/core": "0.1.44",
-    "@longtable/provider-claude": "0.1.44",
-    "@longtable/provider-codex": "0.1.44",
-    "@longtable/setup": "0.1.44",
+    "@longtable/checkpoints": "0.1.47",
+    "@longtable/cli": "0.1.47",
+    "@longtable/core": "0.1.47",
+    "@longtable/provider-claude": "0.1.47",
+    "@longtable/provider-codex": "0.1.47",
+    "@longtable/setup": "0.1.47",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^4.0.0"
   },