feat(history): expose terminal outcome MCP tool

Author: root

universal-refiner/src/core/server.ts

@@ -309,6 +309,20 @@ Output ONLY the JSON array. If no gaps, return [].`,
           description: "Lists review-gated lesson and prompt-template candidates for the current repository.",
           inputSchema: { type: "object", properties: {} }
         },
+        {
+          name: "record_terminal_outcome",
+          description: "Records one evidence-backed terminal goal outcome and an optional review-gated lesson candidate.",
+          inputSchema: {
+            type: "object",
+            properties: {
+              goal_id: { type: "string" },
+              status: { type: "string", enum: ["completed", "failed", "cancelled", "blocked", "budget_exhausted"] },
+              evidence: { type: "array", items: { type: "string" }, minItems: 1 },
+              summary: { type: "string" }
+            },
+            required: ["goal_id", "status", "evidence", "summary"]
+          }
+        },
         {
           name: "review_lesson",
           description: "Approves or rejects a proposed lesson before it can influence future prompts.",
@@ -552,6 +566,19 @@ Output ONLY the JSON array. If no gaps, return [].`,
             const candidates = this.eventStore.getLearningCandidates(this.repository.id);
             return { content: [{ type: "text", text: JSON.stringify(candidates) }] };
           }
+          case "record_terminal_outcome": {
+            const outcome = z.object({
+              goal_id: z.string().min(1),
+              status: z.enum(["completed", "failed", "cancelled", "blocked", "budget_exhausted"]),
+              evidence: z.array(z.string().min(1)).min(1),
+              summary: z.string().min(1),
+            }).parse(request.params.arguments);
+            const recorded = this.eventStore.recordTerminalOutcome({
+              ...outcome,
+              repo_id: this.repository.id,
+            });
+            return { content: [{ type: "text", text: JSON.stringify({ recorded, goal_id: outcome.goal_id }) }] };
+          }
           case "review_lesson": {
             const { id, approved } = z.object({ id: z.string(), approved: z.boolean() }).parse(request.params.arguments);
             const changed = this.eventStore.reviewLesson(this.repository.id, id, approved);

universal-refiner/tests/acceptance/mcp-tools.acceptance.test.ts

@@ -41,7 +41,7 @@ describe("MCP all-tool acceptance", () => {
     const names = listResponse.tools.map(tool => tool.name);
 
     expect(new Set(names).size).toBe(names.length);
-    expect(names).toHaveLength(19);
+    expect(names).toHaveLength(20);
     for (const tool of listResponse.tools) {
       expect(tool.description.length).toBeGreaterThan(10);
       expect(tool.inputSchema.type).toBe("object");
@@ -142,6 +142,12 @@ describe("MCP all-tool acceptance", () => {
       discover_rules: {},
       approve_rule: { id: "missing-rule" },
       list_learning_candidates: {},
+      record_terminal_outcome: {
+        goal_id: "acceptance-goal",
+        status: "completed",
+        evidence: ["cas://evidence/acceptance"],
+        summary: "Acceptance outcome",
+      },
       review_lesson: { id: "pending-lesson", approved: true },
       review_template: { id: "pending-template", approved: true },
       ingest_pattern: { id: "pattern", category: "quality", description: "Verify changes." },
@@ -163,5 +169,5 @@ describe("MCP all-tool acceptance", () => {
       await expect(dispatch({ params: { name: tool.name, arguments: args[tool.name] } }))
         .resolves.toHaveProperty("content");
     }
-  });
+  }, 15_000);
 });