@longtable/mcp 0.1.47 → 0.1.48

package/dist/server.js

@@ -11,7 +11,7 @@ import { classifyCheckpointTrigger } from "@longtable/checkpoints";
 import { renderQuestionRecordInput } from "@longtable/provider-claude";
 import { renderQuestionRecordPrompt } from "@longtable/provider-codex";
 import { loadSetupOutput } from "@longtable/setup";
-import { answerWorkspaceQuestion, clearWorkspaceQuestion, createOrUpdateProjectWorkspace, createWorkspaceQuestion, inspectProjectWorkspace, loadProjectContextFromDirectory, loadWorkspaceState, syncCurrentWorkspaceView } from "@longtable/cli";
+import { answerWorkspaceQuestion, applyResearchSpecificationAuditUpdate, applyResearchSpecificationPatch, clearWorkspaceQuestion, createOrUpdateProjectWorkspace, createWorkspaceQuestion, diffResearchSpecifications, findUnincorporatedResearchEvidence, inspectProjectWorkspace, loadProjectContextFromDirectory, loadWorkspaceState, proposeResearchSpecificationPatch, readResearchSpecificationHistory, syncCurrentWorkspaceView } from "@longtable/cli";
 import { buildFirstResearchShapeQuestion, firstResearchShapeAnswerConfirms, firstResearchShapeAnswerStatus } from "./first-research-shape.js";
 import { buildResearchSpecificationQuestion, renderResearchSpecificationPreview, researchSpecificationAnswerConfirms, researchSpecificationAnswerNeedsFollowUp, researchSpecificationAnswerStatus } from "./research-specification.js";
 const SERVER_NAME = "longtable-state";
@@ -27,6 +27,11 @@ const TOOL_NAMES = [
     "summarize_interview",
     "summarize_research_specification",
     "read_research_specification",
+    "propose_research_spec_patch",
+    "apply_research_spec_patch",
+    "diff_research_specification",
+    "read_research_spec_history",
+    "find_unincorporated_evidence",
     "cancel_interview",
     "confirm_first_research_shape",
     "confirm_research_specification",
@@ -83,6 +88,9 @@ const researchSpecificationSchema = z.object({
     createdAt: z.string().optional(),
     updatedAt: z.string().optional(),
     sourceHookId: z.string().optional(),
+    latestRevisionId: z.string().optional(),
+    sourceEvidenceIds: z.array(z.string()).optional(),
+    sectionEvidence: z.record(z.string(), z.array(z.string())).optional(),
     researchDirection: z.object({
         question: z.string().optional(),
         purpose: z.string().min(1),
@@ -129,6 +137,15 @@ const researchSpecificationSchema = z.object({
     confidence: z.enum(["low", "medium", "high"]).default("medium"),
     confirmedAt: z.string().optional()
 });
+const researchSpecificationPatchSourceSchema = z.enum([
+    "interview",
+    "panel",
+    "critic",
+    "reviewer",
+    "decision",
+    "manual",
+    "system"
+]);
 function textResult(structuredContent) {
     return {
         content: [
@@ -839,11 +856,6 @@ async function markResearchSpecificationConfirmation(context, specification, ans
             status: researchSpecificationAnswerStatus(answer) === "deferred" ? "deferred" : "draft",
             updatedAt: timestamp
         };
-    state.researchSpecification = confirmedSpecification;
-    state.workingState = {
-        ...state.workingState,
-        researchSpecification: confirmedSpecification
-    };
     state.hooks = (state.hooks ?? []).map((hook) => {
         if (hook.id !== specification.sourceHookId || !isInterviewHookRun(hook)) {
             return hook;
@@ -861,19 +873,33 @@ async function markResearchSpecificationConfirmation(context, specification, ans
                 : hook.linkedDecisionRecordIds
         };
     });
+    const sourceEvidenceIds = (state.evidenceRecords ?? [])
+        .filter((record) => record.sourceHookId && record.sourceHookId === specification.sourceHookId)
+        .map((record) => record.id);
+    const audited = applyResearchSpecificationAuditUpdate(state, {
+        specification: confirmedSpecification,
+        timestamp,
+        source: "decision",
+        title: `Research Specification confirmation: ${confirmedSpecification.title}`,
+        rationale: `Research Specification confirmation answer: ${answer}`,
+        sourceEvidenceIds,
+        questionRecordId: questionId,
+        decisionRecordId: decisionId,
+        createDecisionRecord: false
+    });
     const nextState = researchSpecificationAnswerConfirms(answer)
-        ? resolveResearchSpecificationConfirmationObligation(state, confirmedSpecification, {
+        ? resolveResearchSpecificationConfirmationObligation(audited.state, confirmedSpecification, {
             questionId,
             decisionId,
             status: "satisfied"
         })
         : researchSpecificationAnswerNeedsFollowUp(answer)
-            ? ensureResearchSpecificationConfirmationObligation(state, confirmedSpecification, {
+            ? ensureResearchSpecificationConfirmationObligation(audited.state, confirmedSpecification, {
                 answer,
                 questionId,
                 decisionId
             })
-            : resolveResearchSpecificationConfirmationObligation(state, confirmedSpecification, {
+            : resolveResearchSpecificationConfirmationObligation(audited.state, confirmedSpecification, {
                 questionId,
                 decisionId,
                 status: "cleared"
@@ -1219,6 +1245,126 @@ export function createLongTableMcpServer() {
             return errorResult(error instanceof Error ? error.message : String(error));
         }
     });
+    server.registerTool("propose_research_spec_patch", {
+        title: "Propose Research Specification Patch",
+        description: "Store a reviewable Research Specification patch without applying it.",
+        inputSchema: cwdSchema.extend({
+            specification: researchSpecificationSchema,
+            source: researchSpecificationPatchSourceSchema.default("manual"),
+            rationale: z.string().optional(),
+            sourceEvidenceIds: z.array(z.string()).optional()
+        })
+    }, async ({ cwd: inputCwd, specification, source, rationale, sourceEvidenceIds }) => {
+        try {
+            const context = await requireContext(inputCwd);
+            const result = await proposeResearchSpecificationPatch({
+                context,
+                specification: specification,
+                source,
+                rationale,
+                sourceEvidenceIds
+            });
+            return textResult({
+                patch: result.patch,
+                changes: result.changes,
+                nextAction: `apply_research_spec_patch patchId=${result.patch.id}`
+            });
+        }
+        catch (error) {
+            return errorResult(error instanceof Error ? error.message : String(error));
+        }
+    });
+    server.registerTool("apply_research_spec_patch", {
+        title: "Apply Research Specification Patch",
+        description: "Automatically apply a proposed or inline Research Specification update and record a revision.",
+        inputSchema: cwdSchema.extend({
+            patchId: z.string().optional(),
+            specification: researchSpecificationSchema.optional(),
+            source: researchSpecificationPatchSourceSchema.default("manual"),
+            rationale: z.string().optional(),
+            sourceEvidenceIds: z.array(z.string()).optional(),
+            questionRecordId: z.string().optional(),
+            decisionRecordId: z.string().optional()
+        })
+    }, async ({ cwd: inputCwd, patchId, specification, source, rationale, sourceEvidenceIds, questionRecordId, decisionRecordId }) => {
+        try {
+            const context = await requireContext(inputCwd);
+            const result = await applyResearchSpecificationPatch({
+                context,
+                patchId,
+                specification: specification,
+                source,
+                rationale,
+                sourceEvidenceIds,
+                questionRecordId,
+                decisionRecordId
+            });
+            return textResult({
+                patch: result.patch,
+                revision: result.revision,
+                specification: result.specification,
+                decision: result.decision,
+                session: {
+                    currentGoal: result.session.currentGoal,
+                    researchSpecification: result.session.researchSpecification
+                }
+            });
+        }
+        catch (error) {
+            return errorResult(error instanceof Error ? error.message : String(error));
+        }
+    });
+    server.registerTool("diff_research_specification", {
+        title: "Diff Research Specification",
+        description: "Compare an inline Research Specification against the current workspace specification without writing state.",
+        inputSchema: cwdSchema.extend({
+            specification: researchSpecificationSchema
+        }),
+        annotations: { readOnlyHint: true }
+    }, async ({ cwd: inputCwd, specification }) => {
+        try {
+            const context = await requireContext(inputCwd);
+            const state = asInterviewState(await loadWorkspaceState(context));
+            const current = state.researchSpecification ?? context.session.researchSpecification;
+            return textResult({
+                current,
+                changes: diffResearchSpecifications(current, specification)
+            });
+        }
+        catch (error) {
+            return errorResult(error instanceof Error ? error.message : String(error));
+        }
+    });
+    server.registerTool("read_research_spec_history", {
+        title: "Read Research Specification History",
+        description: "Read specification revisions, patches, and evidence records for audit or resume.",
+        inputSchema: cwdSchema,
+        annotations: { readOnlyHint: true }
+    }, async ({ cwd: inputCwd }) => {
+        try {
+            const context = await requireContext(inputCwd);
+            return textResult(await readResearchSpecificationHistory(context));
+        }
+        catch (error) {
+            return errorResult(error instanceof Error ? error.message : String(error));
+        }
+    });
+    server.registerTool("find_unincorporated_evidence", {
+        title: "Find Unincorporated Research Evidence",
+        description: "List interview, panel, critic, reviewer, or invocation evidence not yet incorporated into a Research Specification revision.",
+        inputSchema: cwdSchema,
+        annotations: { readOnlyHint: true }
+    }, async ({ cwd: inputCwd }) => {
+        try {
+            const context = await requireContext(inputCwd);
+            return textResult({
+                evidenceRecords: await findUnincorporatedResearchEvidence(context)
+            });
+        }
+        catch (error) {
+            return errorResult(error instanceof Error ? error.message : String(error));
+        }
+    });
     server.registerTool("cancel_interview", {
         title: "Cancel LongTable Interview",
         description: "Explicitly cancel the active $longtable-interview hook without confirming a First Research Shape.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longtable/mcp",
-  "version": "0.1.47",
+  "version": "0.1.48",
   "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.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",
+    "@longtable/checkpoints": "0.1.48",
+    "@longtable/cli": "0.1.48",
+    "@longtable/core": "0.1.48",
+    "@longtable/provider-claude": "0.1.48",
+    "@longtable/provider-codex": "0.1.48",
+    "@longtable/setup": "0.1.48",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^4.0.0"
   },