@longtable/mcp 0.1.45 → 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

@@ -116,6 +116,9 @@ export function buildResearchSpecificationQuestion(specification) {
 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.45",
+  "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.45",
-    "@longtable/cli": "0.1.45",
-    "@longtable/core": "0.1.45",
-    "@longtable/provider-claude": "0.1.45",
-    "@longtable/provider-codex": "0.1.45",
-    "@longtable/setup": "0.1.45",
+    "@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"
   },