@productbrain/mcp 0.0.1-beta.25 → 0.0.1-beta.27

package/dist/{chunk-E75NDP6K.js → chunk-R4LVIGFQ.js}

@@ -10,10 +10,11 @@ import {
   mcpQuery,
   recordSessionActivity,
   registerSmartCaptureTools,
+  requireActiveSession,
   requireWriteAccess,
   setSessionOriented,
   startAgentSession
-} from "./chunk-EVF3CYZN.js";
+} from "./chunk-YCHKN75N.js";
 
 // src/server.ts
 import { McpServer as McpServer2 } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -429,6 +430,9 @@ The relation was **not applied** \u2014 it will be created when the proposal is
       const created = results.filter((r) => r.ok && !r.proposalCreated);
       const proposals = results.filter((r) => r.ok && r.proposalCreated);
       const failed = results.filter((r) => !r.ok);
+      for (let i = 0; i < created.length; i++) {
+        await recordSessionActivity({ relationCreated: true });
+      }
       const lines = [`# Batch Link Results
 `];
       lines.push(`**${created.length}** created, **${proposals.length}** proposals, **${failed.length}** failed out of ${relations.length} total.
@@ -690,6 +694,82 @@ Use \`suggest-links\` to discover potential connections, or \`relate-entries\` t
       return { content: [{ type: "text", text: lines.join("\n") }] };
     }
   );
+  server.registerTool(
+    "get-build-context",
+    {
+      title: "Get Build Context",
+      description: "Assemble a structured build spec for any entry. Collection-agnostic: works with bets, features, epics, or any collection type. Returns the entry data, related entries by collection, applicable business rules, glossary terms, and chain refs to consult. Use this when starting a build to get full context in one call \u2014 no need to call orient, gather-context, and search separately.\n\nPass an entry ID (e.g. 'ENT-wc7u71', 'BET-001') or name. The output adapts to the entry's collection schema.",
+      inputSchema: {
+        entryId: z.string().describe("Entry ID or name (e.g. 'ENT-wc7u71', 'PB as Shared Memory')"),
+        maxHops: z.number().min(1).max(3).default(2).optional().describe("Relation traversal depth (default 2)")
+      },
+      annotations: { readOnlyHint: true }
+    },
+    async ({ entryId, maxHops }) => {
+      requireActiveSession();
+      const result = await mcpQuery("chain.assembleBuildContext", {
+        entryId,
+        maxHops: maxHops ?? 2
+      });
+      const { entry, relatedByCollection, businessRules, glossaryTerms, rulesToHonor, chainRefs, contextTruncated } = result;
+      const lines = [
+        `# Build Context: ${entry.name}`,
+        `**Entry:** ${entry.entryId ?? entry.name} [${entry.collectionSlug}]`,
+        `**Status:** ${entry.status}`,
+        ""
+      ];
+      if (Object.keys(entry.data).length > 0) {
+        lines.push("## Entry Data");
+        for (const [key, val] of Object.entries(entry.data)) {
+          const str = typeof val === "string" ? val : JSON.stringify(val);
+          if (str.length > 200) {
+            lines.push(`- **${key}:** ${str.slice(0, 200)}...`);
+          } else {
+            lines.push(`- **${key}:** ${str}`);
+          }
+        }
+        lines.push("");
+      }
+      if (businessRules.length > 0) {
+        lines.push("## Business Rules to Honor");
+        for (const r of businessRules) {
+          const id = r.entryId ?? r.name;
+          lines.push(`- **${id}:** ${r.name}`);
+          if (r.description) lines.push(`  ${r.description.slice(0, 150)}${r.description.length > 150 ? "..." : ""}`);
+        }
+        lines.push("");
+      }
+      if (glossaryTerms.length > 0) {
+        lines.push("## Glossary Terms");
+        for (const t of glossaryTerms.slice(0, 15)) {
+          const id = t.entryId ?? t.name;
+          lines.push(`- **${id}:** ${t.name}`);
+          if (t.definition) lines.push(`  ${t.definition.slice(0, 120)}${t.definition.length > 120 ? "..." : ""}`);
+        }
+        if (glossaryTerms.length > 15) lines.push(`  _...and ${glossaryTerms.length - 15} more_`);
+        lines.push("");
+      }
+      const relatedCount = Object.values(relatedByCollection).reduce((sum, arr) => sum + arr.length, 0);
+      if (relatedCount > 0) {
+        lines.push("## Related Entries");
+        for (const [coll, entries] of Object.entries(relatedByCollection)) {
+          lines.push(`### ${coll} (${entries.length})`);
+          for (const e of entries.slice(0, 5)) {
+            lines.push(`- ${e.entryId ?? e.name}: ${e.name} [${e.relationType}]`);
+          }
+          if (entries.length > 5) lines.push(`  _...and ${entries.length - 5} more_`);
+        }
+        lines.push("");
+      }
+      lines.push("## Chain Refs to Consult");
+      lines.push(chainRefs.slice(0, 15).map((r) => `- ${r}`).join("\n"));
+      if (contextTruncated) {
+        lines.push("");
+        lines.push("_Context was truncated (limits: 50 related, 20 rules, 30 glossary). Use get-entry for full details._");
+      }
+      return { content: [{ type: "text", text: lines.join("\n") }] };
+    }
+  );
   server.registerTool(
     "suggest-links",
     {
@@ -920,7 +1000,7 @@ Use \`list-collections\` to verify the result.`
     },
     async ({ entryId }) => {
       requireWriteAccess();
-      const { runContradictionCheck } = await import("./smart-capture-NX4QDLLY.js");
+      const { runContradictionCheck } = await import("./smart-capture-WWGVXMQ2.js");
       const entry = await mcpQuery("chain.getEntry", { entryId });
       if (!entry) {
         return {
@@ -1103,7 +1183,21 @@ async function queryPlannedWork() {
 function hasPlannedWork(work) {
   return work.uncommittedDrafts.length > 0 || work.inProgressEntries.length > 0 || work.openTensions.length > 0;
 }
-function buildPlannedWorkSection(work, priorSessions) {
+function formatRecoveryBlock(block) {
+  const fmt = (items, overflow) => items.map((e) => `${e.entryId} [${e.collection}] ${e.name}`).join(", ") + (overflow && overflow > 0 ? ` (+${overflow} more)` : "");
+  const lines = [
+    "## Previous Session Recovery",
+    "",
+    `Session ${block.sessionId} \u2014 ${block.date}, ${block.duration}, status: ${block.status}`,
+    `Created (${block.created.length + (block.createdOverflow ?? 0)}): ${fmt(block.created, block.createdOverflow)}`,
+    `Modified (${block.modified.length + (block.modifiedOverflow ?? 0)}): ${fmt(block.modified, block.modifiedOverflow)}`,
+    `Drafts needing attention (${block.draftsNeedingAttention.length + (block.draftsOverflow ?? 0)}): ${fmt(block.draftsNeedingAttention, block.draftsOverflow)}`,
+    `Relations created: ${block.relationsCreated}`,
+    ""
+  ];
+  return lines;
+}
+function buildPlannedWorkSection(work, priorSessions, recoveryBlock) {
   if (!hasPlannedWork(work) && priorSessions.length === 0) return [];
   const lines = [];
   lines.push("## Continue from where you left off");
@@ -1133,7 +1227,7 @@ function buildPlannedWorkSection(work, priorSessions) {
       lines.push(`- **${count} open tensions** \u2014 top: ${top.name}`);
     }
   }
-  if (priorSessions.length > 0 && !hasPlannedWork(work)) {
+  if (priorSessions.length > 0 && !hasPlannedWork(work) && !recoveryBlock) {
     const last = priorSessions[0];
     const date = new Date(last.startedAt).toISOString().split("T")[0];
     const created = Array.isArray(last.entriesCreated) ? last.entriesCreated.length : last.entriesCreated ?? 0;
@@ -1142,6 +1236,10 @@ function buildPlannedWorkSection(work, priorSessions) {
       lines.push(`- **Last session** (${date}): ${created} created, ${modified} modified`);
     }
   }
+  if (recoveryBlock) {
+    lines.push("");
+    lines.push(...formatRecoveryBlock(recoveryBlock));
+  }
   lines.push("");
   return lines;
 }
@@ -1222,6 +1320,27 @@ function buildSessionSummary(log) {
   }
   return lines.join("\n");
 }
+function extractSessionEntryIds(priorSessions) {
+  const allSeen = /* @__PURE__ */ new Set();
+  const all = [];
+  let lastSessionOnly = [];
+  for (let i = 0; i < priorSessions.length; i++) {
+    const s = priorSessions[i];
+    const ids = [...s.entriesCreated ?? [], ...s.entriesModified ?? []].filter((id) => id);
+    if (i === 0) {
+      lastSessionOnly = [...new Set(ids)].slice(0, 5);
+    }
+    for (const id of ids) {
+      if (!allSeen.has(id)) {
+        allSeen.add(id);
+        all.push(id);
+        if (all.length >= 10) break;
+      }
+    }
+    if (all.length >= 10) break;
+  }
+  return { all, lastSessionOnly };
+}
 function registerHealthTools(server) {
   server.registerTool(
     "health",
@@ -1362,15 +1481,23 @@ function registerHealthTools(server) {
         errors.push(`Workspace: ${e.message}`);
       }
       let priorSessions = [];
+      let recoveryBlock = null;
       if (wsCtx) {
         try {
-          priorSessions = await mcpQuery("agent.recentSessions", { limit: 3 });
+          const sessionsResult = await mcpQuery("agent.recentSessions", { limit: 3 });
+          priorSessions = sessionsResult?.sessions ?? [];
+          recoveryBlock = sessionsResult?.recoveryBlock ?? null;
         } catch {
         }
       }
+      const { all: sessionEntryIds, lastSessionOnly } = extractSessionEntryIds(priorSessions);
       let orientEntries = null;
       try {
-        orientEntries = await mcpQuery("chain.getOrientEntries", task ? { task } : {});
+        const orientArgs = {};
+        if (task) orientArgs.task = task;
+        if (sessionEntryIds.length > 0) orientArgs.sessionEntryIds = sessionEntryIds;
+        if (lastSessionOnly.length > 0) orientArgs.lastSessionEntryIds = lastSessionOnly;
+        orientEntries = await mcpQuery("chain.getOrientEntries", orientArgs);
       } catch {
       }
       let openTensions = [];
@@ -1415,7 +1542,10 @@ function registerHealthTools(server) {
             lines.push(`- \`${e.entryId ?? e._id}\` ${e.name}${tensionPart}`);
           }
         }
-        if (priorSessions.length > 0) {
+        if (recoveryBlock) {
+          lines.push("");
+          lines.push(...formatRecoveryBlock(recoveryBlock));
+        } else if (priorSessions.length > 0) {
           const last = priorSessions[0];
           const date = new Date(last.startedAt).toISOString().split("T")[0];
           const created = Array.isArray(last.entriesCreated) ? last.entriesCreated.length : last.entriesCreated ?? 0;
@@ -1492,6 +1622,31 @@ function registerHealthTools(server) {
           lines.push(`${betLine} ${sc.activeTensionCount} open tension(s).`);
           lines.push("");
         }
+        if (orientEntries?.continuingFrom && orientEntries.continuingFrom.length > 0) {
+          lines.push("## Continuing from");
+          lines.push("_Prior-session entries most relevant to your task._");
+          lines.push("");
+          for (const e of orientEntries.continuingFrom) {
+            const id = e.entryId ?? e.name;
+            const type = e.canonicalKey ?? "generic";
+            const coll = e.collectionSlug ? ` [${e.collectionSlug}]` : "";
+            lines.push(`- \`${id}\` (score ${e.score}) [${type}]${coll} \u2014 ${e.name}`);
+            if (e.reasoning) lines.push(`  _${e.reasoning}_`);
+          }
+          lines.push("");
+        }
+        if (orientEntries?.lastSessionTouched && orientEntries.lastSessionTouched.length > 0) {
+          lines.push("## Last session touched");
+          lines.push("_Entries created or modified in your most recent session._");
+          lines.push("");
+          for (const e of orientEntries.lastSessionTouched) {
+            const id = e.entryId ?? e.name;
+            const type = e.canonicalKey ?? "generic";
+            const coll = e.collectionSlug ? ` [${e.collectionSlug}]` : "";
+            lines.push(`- \`${id}\` [${type}]${coll} \u2014 ${e.name}`);
+          }
+          lines.push("");
+        }
         if (orientEntries?.taskContext && orientEntries.taskContext.context.length > 0) {
           const tc = orientEntries.taskContext;
           lines.push("## Task Context");
@@ -1561,10 +1716,10 @@ function registerHealthTools(server) {
         }
         const plannedWork = await queryPlannedWork();
         if (hasPlannedWork(plannedWork)) {
-          lines.push(...buildPlannedWorkSection(plannedWork, priorSessions));
+          lines.push(...buildPlannedWorkSection(plannedWork, priorSessions, recoveryBlock));
         } else {
           const briefingItems = [];
-          if (priorSessions.length > 0) {
+          if (priorSessions.length > 0 && !recoveryBlock) {
             const last = priorSessions[0];
             const date = new Date(last.startedAt).toISOString().split("T")[0];
             const created = Array.isArray(last.entriesCreated) ? last.entriesCreated.length : last.entriesCreated ?? 0;
@@ -1581,6 +1736,10 @@ function registerHealthTools(server) {
             }
             lines.push("");
           }
+          if (recoveryBlock) {
+            lines.push("");
+            lines.push(...formatRecoveryBlock(recoveryBlock));
+          }
         }
         lines.push("What would you like to work on?");
         lines.push("");
@@ -4030,8 +4189,11 @@ async function buildOrientResponse(wsCtx, agentSessionId, errors) {
   const wsFullCtx = await getWorkspaceContext();
   const { ageDays, isNeglected } = computeWorkspaceAge(wsFullCtx.createdAt);
   let priorSessions = [];
+  let recoveryBlock = null;
   try {
-    priorSessions = await mcpQuery("agent.recentSessions", { limit: 3 });
+    const sessionsResult = await mcpQuery("agent.recentSessions", { limit: 3 });
+    priorSessions = sessionsResult?.sessions ?? [];
+    recoveryBlock = sessionsResult?.recoveryBlock ?? null;
   } catch {
   }
   let openTensions = [];
@@ -4086,10 +4248,10 @@ async function buildOrientResponse(wsCtx, agentSessionId, errors) {
     const plannedWork = await queryPlannedWork();
     if (hasPlannedWork(plannedWork)) {
       lines.push("");
-      lines.push(...buildPlannedWorkSection(plannedWork, priorSessions));
+      lines.push(...buildPlannedWorkSection(plannedWork, priorSessions, recoveryBlock));
     } else {
       const briefingItems = [];
-      if (priorSessions.length > 0) {
+      if (priorSessions.length > 0 && !recoveryBlock) {
         const last = priorSessions[0];
         const date = new Date(last.startedAt).toISOString().split("T")[0];
         const created = Array.isArray(last.entriesCreated) ? last.entriesCreated.length : last.entriesCreated ?? 0;
@@ -4107,6 +4269,10 @@ async function buildOrientResponse(wsCtx, agentSessionId, errors) {
         }
         lines.push("");
       }
+      if (recoveryBlock) {
+        lines.push("");
+        lines.push(...formatRecoveryBlock(recoveryBlock));
+      }
     }
     lines.push("What would you like to work on?");
     lines.push("");
@@ -4692,4 +4858,4 @@ export {
   SERVER_VERSION,
   createProductBrainServer
 };
-//# sourceMappingURL=chunk-E75NDP6K.js.map
+//# sourceMappingURL=chunk-R4LVIGFQ.js.map