@productbrain/mcp 0.0.1-beta.9574 → 0.0.1-beta.9584

package/dist/{chunk-O6HEYDXJ.js → chunk-DT756ONZ.js}

@@ -395,7 +395,7 @@ var TOOL_NAME_MIGRATIONS = /* @__PURE__ */ new Map([
   ["search", 'context action="search"'],
   ["relate-entries", 'relations action="create"'],
   ["batch-relate", 'relations action="batch-create"'],
-  ["find-related", 'relations action="find"'],
+  ["find-related", 'context action="find"'],
   ["gather-context", 'context action="gather"'],
   ["get-build-context", 'context action="build"'],
   ["list-collections", 'collections action="list"'],
@@ -443,7 +443,7 @@ var TOOL_NAME_MIGRATIONS = /* @__PURE__ */ new Map([
   ["move-entry", 'entries action="move"'],
   ["session-wrapup", 'session action="wrapup-review|wrapup-commit" (review \u2192 wrapup-review, commit-all \u2192 wrapup-commit)'],
   ["facilitate", 'session action="resume|commit-constellation" (same action names)'],
-  ["graph", 'relations action="find" (same action name)'],
+  ["graph", 'context action="find" (same action name)'],
   ["documents", 'context action="last-verified-brief"'],
   ["labels", 'collections action="label-*" (list/create/update/delete/apply/remove \u2192 label-<same>)'],
   ["health", 'workspace action="check|whoami|status|audit|self-test" (same action names)'],
@@ -2054,7 +2054,7 @@ Use \`context action=get\` to inspect the existing entry, or \`entries action=up
   }
   const next = [];
   if (finalStatus === "committed") {
-    next.push({ tool: "relations", description: "See its connections", parameters: { action: "find", entryId: finalEntryId } });
+    next.push({ tool: "context", description: "See its connections", parameters: { action: "find", entryId: finalEntryId } });
   } else {
     next.push({ tool: "context", description: "Review the draft alternative", parameters: { action: "get", entryId: finalEntryId } });
     next.push({ tool: "entries", description: "Accept onto Chain", parameters: { action: "commit", entryId: finalEntryId } });
@@ -2653,7 +2653,7 @@ No DB writes \u2014 call without \`preview:true\` to accept for real.` }],
   } catch {
   }
   const next = [
-    { tool: "relations", description: "See its connections", parameters: { action: "find", entryId } },
+    { tool: "context", description: "See its connections", parameters: { action: "find", entryId } },
     { tool: "context", description: "View accepted entry", parameters: { action: "get", entryId } }
   ];
   const summary = `Accepted ${entryId} (${entry.name}) onto the Chain.`;
@@ -3543,7 +3543,7 @@ async function handleGet(entryId) {
       `Found ${entryId}: ${String(e.name)} [${String(e.collectionSlug ?? "")}].`,
       entryData,
       [
-        { tool: "relations", description: "See its connections", parameters: { action: "find", entryId } },
+        { tool: "context", description: "See its connections", parameters: { action: "find", entryId } },
         { tool: "context", description: "Gather related context", parameters: { action: "gather", entryId } }
       ]
     )
@@ -3791,194 +3791,64 @@ ${footer}` }],
 }
 
 // src/tools/relations.ts
-import { z as z13 } from "zod/v3";
-
-// src/tools/graph.ts
 import { z as z12 } from "zod/v3";
-var GRAPH_ACTIONS = ["find"];
-var graphSchema = z12.object({
-  action: z12.enum(GRAPH_ACTIONS).describe(
-    "'find': traverse relations from an entry (graph walk)."
-  ),
-  entryId: z12.string().max(200).describe("Entry ID, e.g. '<PREFIX>-<n>'"),
-  direction: z12.enum(["incoming", "outgoing", "both"]).default("both").optional().describe("For find: 'incoming' = what references this, 'outgoing' = what this references")
-});
-var graphFindOutputSchema = z12.object({
-  entryId: z12.string(),
-  relations: z12.array(z12.object({
-    entryId: z12.string().optional(),
-    name: z12.string(),
-    type: z12.string(),
-    direction: z12.enum(["outgoing", "incoming"])
-  })),
-  total: z12.number()
+var RELATIONS_ACTIONS = ["create", "batch-create", "delete"];
+var relationItemSchema = z12.object({
+  from: z12.string().max(200),
+  to: z12.string().max(200),
+  type: z12.string().max(200)
 });
-async function handleFind(entryId, direction) {
-  const relations = await kernelQuery("chain.listEntryRelations", { entryId });
-  if (relations.length === 0) {
-    return {
-      content: [{ type: "text", text: `No relations found for \`${entryId}\`. Use relations action=create to create connections.` }],
-      structuredContent: success(
-        `No relations found for '${entryId}'.`,
-        { entryId, relations: [], nodes: [], edges: [], total: 0 },
-        [
-          { tool: "relations", description: "Create a relation", parameters: { action: "create", from: entryId } }
-        ]
-      )
-    };
-  }
-  const sourceEntry = await kernelQuery("chain.getEntry", { entryId });
-  if (!sourceEntry) {
-    return notFoundResult(entryId, `Entry '${entryId}' not found. Try context action=search to find the right ID.`);
-  }
-  const sourceInternalId = sourceEntry._id;
-  const MAX_RELATIONS = 25;
-  const truncated = relations.length > MAX_RELATIONS;
-  const capped = relations.slice(0, MAX_RELATIONS);
-  const otherIds = /* @__PURE__ */ new Set();
-  for (const r of capped) {
-    const otherId = r.fromId === sourceInternalId ? r.toId : r.fromId;
-    otherIds.add(otherId);
-  }
-  const otherEntries = /* @__PURE__ */ new Map();
-  for (const id of otherIds) {
-    const entry = await kernelQuery("chain.getEntry", { id });
-    if (entry) {
-      otherEntries.set(entry._id, { entryId: entry.entryId, name: entry.name, collectionId: entry.collectionId });
-    }
-  }
-  const collections = await kernelQuery("chain.listCollections");
-  const collMap = /* @__PURE__ */ new Map();
-  for (const c of collections) collMap.set(c._id, c.slug);
-  const lines = [`## Find Result`, "", `# Relations for ${entryId}: ${sourceEntry.name}`, ""];
-  const enriched = capped.map((r) => {
-    const isOutgoing = r.fromId === sourceInternalId;
-    const otherId = isOutgoing ? r.toId : r.fromId;
-    const other = otherEntries.get(otherId);
-    const otherLabel = other?.entryId ? `${other.entryId}: ${other.name}` : other?.name ?? "(deleted)";
-    const colSlug = other ? collMap.get(other.collectionId) ?? "unknown" : "unknown";
-    return { isOutgoing, type: r.type, otherLabel, colSlug, otherEntryId: other?.entryId, otherName: other?.name ?? "(deleted)" };
-  });
-  const outgoing = enriched.filter((r) => r.isOutgoing);
-  const incoming = enriched.filter((r) => !r.isOutgoing);
-  if ((direction === "outgoing" || direction === "both") && outgoing.length > 0) {
-    lines.push(`## Outgoing (${outgoing.length})`);
-    for (const r of outgoing) {
-      lines.push(`- \u2192 **${r.type}** ${r.otherLabel} [${r.colSlug}]`);
-    }
-    lines.push("");
-  }
-  if ((direction === "incoming" || direction === "both") && incoming.length > 0) {
-    lines.push(`## Incoming (${incoming.length})`);
-    for (const r of incoming) {
-      lines.push(`- \u2190 **${r.type}** ${r.otherLabel} [${r.colSlug}]`);
-    }
-    lines.push("");
-  }
-  const shown = direction === "outgoing" ? outgoing : direction === "incoming" ? incoming : enriched;
-  if (shown.length === 0) {
-    lines.push(`No ${direction} relations found for \`${entryId}\`.`);
-  }
-  if (truncated) {
-    lines.push(`_Showing first ${MAX_RELATIONS} of ${relations.length} relations. Use context action=get for the full picture._`);
-  }
-  const structuredRelations = shown.map((r) => ({
-    entryId: r.otherEntryId,
-    name: r.otherName,
-    type: r.type,
-    direction: r.isOutgoing ? "outgoing" : "incoming"
-  }));
-  const nodes = [
-    { id: entryId, name: sourceEntry.name, collectionName: "" },
-    ...shown.map((r) => ({
-      id: r.otherEntryId ?? String(Math.random()),
-      name: r.otherName,
-      collectionName: r.colSlug
-    }))
-  ];
-  const edges = shown.filter((r) => r.otherEntryId).map((r) => ({
-    source: entryId,
-    target: r.otherEntryId,
-    type: r.type
-  }));
-  return {
-    content: [{ type: "text", text: lines.join("\n") }],
-    structuredContent: success(
-      `Found ${relations.length} relations for ${entryId}.`,
-      { entryId, relations: structuredRelations, nodes, edges, total: relations.length },
-      [{ tool: "context", description: "View entry details", parameters: { action: "get", entryId } }]
-    )
-  };
-}
-
-// src/tools/relations.ts
-var RELATIONS_ACTIONS = ["create", "batch-create", "delete", "find"];
-var relationItemSchema = z13.object({
-  from: z13.string().max(200),
-  to: z13.string().max(200),
-  type: z13.string().max(200)
-});
-var relationsSchema = z13.object({
-  action: z13.enum(RELATIONS_ACTIONS).describe(
-    "'create': link two entries. 'batch-create': create multiple relations (validates every item before writing any). 'delete': remove a relation. 'find': traverse relations from an entry (graph walk, absorbs graph action=find)."
+var relationsSchema = z12.object({
+  action: z12.enum(RELATIONS_ACTIONS).describe(
+    "'create': link two entries. 'batch-create': create multiple relations (validates every item before writing any). 'delete': remove a relation."
   ),
-  from: z13.string().max(200).optional().describe("For 'create'/'delete': source entry ID."),
-  to: z13.string().max(200).optional().describe("For 'create'/'delete': target entry ID."),
-  type: z13.string().max(200).optional().describe("For 'create'/'delete': relation type."),
-  relations: z13.array(relationItemSchema).min(1).max(RELATION_BATCH_MAX).optional().describe("For 'batch-create': array of {from, to, type}."),
+  from: z12.string().max(200).optional().describe("For 'create'/'delete': source entry ID."),
+  to: z12.string().max(200).optional().describe("For 'create'/'delete': target entry ID."),
+  type: z12.string().max(200).optional().describe("For 'create'/'delete': relation type."),
+  relations: z12.array(relationItemSchema).min(1).max(RELATION_BATCH_MAX).optional().describe("For 'batch-create': array of {from, to, type}."),
   // WP-316 S3: Preview gate — dry-run mode for action=create.
-  preview: z13.boolean().optional().describe("For 'create': if true, validates the relation without writing. Returns what would happen. Default false."),
-  entryId: z13.string().max(200).optional().describe("For 'find': entry ID, e.g. '<PREFIX>-<n>'."),
-  direction: z13.enum(["incoming", "outgoing", "both"]).optional().describe("For 'find': 'incoming' = what references this, 'outgoing' = what this references. Default 'both'.")
+  preview: z12.boolean().optional().describe("For 'create': if true, validates the relation without writing. Returns what would happen. Default false.")
 });
-var relationsCreateVariant = z13.object({
-  action: z13.literal("create"),
-  from: z13.string().max(200),
-  to: z13.string().max(200),
-  type: z13.string().max(200),
-  preview: z13.boolean().optional()
+var relationsCreateVariant = z12.object({
+  action: z12.literal("create"),
+  from: z12.string().max(200),
+  to: z12.string().max(200),
+  type: z12.string().max(200),
+  preview: z12.boolean().optional()
 });
-var relationsBatchCreateVariant = z13.object({
-  action: z13.literal("batch-create"),
-  relations: z13.array(relationItemSchema).min(1).max(RELATION_BATCH_MAX)
+var relationsBatchCreateVariant = z12.object({
+  action: z12.literal("batch-create"),
+  relations: z12.array(relationItemSchema).min(1).max(RELATION_BATCH_MAX)
 });
-var relationsDeleteVariant = z13.object({
-  action: z13.literal("delete"),
-  from: z13.string().max(200),
-  to: z13.string().max(200),
-  type: z13.string().max(200)
+var relationsDeleteVariant = z12.object({
+  action: z12.literal("delete"),
+  from: z12.string().max(200),
+  to: z12.string().max(200),
+  type: z12.string().max(200)
 });
-var relationsFindVariant = z13.object({
-  action: z13.literal("find"),
-  entryId: z13.string().max(200),
-  direction: z13.enum(["incoming", "outgoing", "both"]).optional().default("both")
-});
-var relationsActionUnion = z13.discriminatedUnion("action", [
+var relationsActionUnion = z12.discriminatedUnion("action", [
   relationsCreateVariant,
   relationsBatchCreateVariant,
-  relationsDeleteVariant,
-  relationsFindVariant
+  relationsDeleteVariant
 ]);
 var RELATIONS_ACTION_SPECS = {
   create: { params: ["from", "to", "type", "preview"], description: "from, to, and type are required." },
   "batch-create": { params: ["relations"], description: "relations (1-20 items) is required." },
-  delete: { params: ["from", "to", "type"], description: "from, to, and type are required." },
-  find: { params: ["entryId", "direction"], description: "entryId is required." }
+  delete: { params: ["from", "to", "type"], description: "from, to, and type are required." }
 };
 function registerRelationsTools(server) {
   const relationsHandlers = {
     create: (data) => handleCreate(data.from, data.to, data.type, data.preview),
     "batch-create": (data) => handleBatchCreate(data.relations),
-    delete: (data) => handleDelete(data.from, data.to, data.type),
-    find: (data) => handleFind(data.entryId, data.direction ?? "both")
+    delete: (data) => handleDelete(data.from, data.to, data.type)
   };
   server.registerTool(
     "relations",
     {
       title: "Relations",
-      description: "Create, manage, and read relations between entries. A relation is written only when you ask for it, with exactly the verb you send.\n\n- **create**: Link two entries with a typed relation.\n- **batch-create**: Create multiple relations in one call (validates every item before writing any).\n- **delete**: Remove a relation by from, to, and type.\n- **find**: Traverse relations from a specific entry \u2014 shows incoming/outgoing connections. NOT full-text search (use context action=search).",
+      description: "Create and delete relations between entries. A relation is written only when you ask for it, with exactly the verb you send. Read an entry's relations with the read-only `context action=find`.\n\n- **create**: Link two entries with a typed relation.\n- **batch-create**: Create multiple relations in one call (validates every item before writing any).\n- **delete**: Remove a relation by from, to, and type.",
       inputSchema: relationsSchema,
-      // Mixed read/write noun (§3 R3): find is read-only, create/batch-create/delete write.
+      // DEC-1894 / DEC-74: find lives on the read-only `context` tool; every action left here writes.
       annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false }
     },
     thinWrapper(async (args) => {
@@ -4107,7 +3977,7 @@ No DB writes \u2014 call without \`preview:true\` to create for real.${advisoryT
         type,
         ...result2?.advisories && result2.advisories.length > 0 && { advisories: result2.advisories }
       },
-      [{ tool: "relations", description: "See connections", parameters: { action: "find", entryId: from } }]
+      [{ tool: "context", description: "See connections", parameters: { action: "find", entryId: from } }]
     )
   };
 }
@@ -4152,7 +4022,7 @@ async function handleBatchCreate(relations) {
       lines.push(`- **${r.from}** \u2192 **${r.to}** (${r.type}): _${r.error}_`);
     }
   }
-  const next = failed.length === 0 ? [{ tool: "relations", description: "Check connections", parameters: { action: "find", entryId: relations[0].from } }] : [];
+  const next = failed.length === 0 ? [{ tool: "context", description: "Check connections", parameters: { action: "find", entryId: relations[0].from } }] : [];
   return {
     content: [{ type: "text", text: lines.join("\n") }],
     structuredContent: success(
@@ -4173,7 +4043,7 @@ async function handleDelete(from, to, type) {
     `Removed relation: ${from} \u2014[${type}]\u2192 ${to}.`,
     `Relation ${from} \u2192 ${to} (${type}) removed.`,
     { from, to, type },
-    [{ tool: "relations", description: "Check remaining connections", parameters: { action: "find", entryId: from } }]
+    [{ tool: "context", description: "Check remaining connections", parameters: { action: "find", entryId: from } }]
   );
 }
 
@@ -4181,16 +4051,16 @@ async function handleDelete(from, to, type) {
 import { z as z16 } from "zod/v3";
 
 // src/tools/documents.ts
-import { z as z14 } from "zod/v3";
+import { z as z13 } from "zod/v3";
 var DOCUMENTS_ACTIONS = ["get-last-verified-brief"];
-var documentsSchema = z14.object({
-  action: z14.enum(DOCUMENTS_ACTIONS).describe(
+var documentsSchema = z13.object({
+  action: z13.enum(DOCUMENTS_ACTIONS).describe(
     "'get-last-verified-brief': fetch the most recent verified brief snapshot for a (templateId, scopeKey) pair. Returns the verified summary so agents can build delta narratives ('since you last verified, X workstreams advanced')."
   ),
-  templateId: z14.string().max(200).describe(
+  templateId: z13.string().max(200).describe(
     "Brief template identifier \u2014 currently 'steering-brief' is the only registered template."
   ),
-  scopeKey: z14.string().max(200).describe(
+  scopeKey: z13.string().max(200).describe(
     "Canonical scope key. Use 'workspace:<workspaceId>' for the full workspace brief, or 'initiative:<INI-ID>' for an initiative-scoped brief. The same formula is applied at write time (chainwork/docKernel/scopeKey.ts), so passing the wrong shape returns exists:false."
   )
 });
@@ -4260,9 +4130,130 @@ This row pre-dates snapshot capture (legacy backfill), so no summary is availabl
 
 // src/tools/contextLookups.ts
 import { z as z15 } from "zod/v3";
+
+// src/tools/graph.ts
+import { z as z14 } from "zod/v3";
+var GRAPH_ACTIONS = ["find"];
+var graphSchema = z14.object({
+  action: z14.enum(GRAPH_ACTIONS).describe(
+    "'find': traverse relations from an entry (graph walk)."
+  ),
+  entryId: z14.string().max(200).describe("Entry ID, e.g. '<PREFIX>-<n>'"),
+  direction: z14.enum(["incoming", "outgoing", "both"]).default("both").optional().describe("For find: 'incoming' = what references this, 'outgoing' = what this references")
+});
+var graphFindOutputSchema = z14.object({
+  entryId: z14.string(),
+  relations: z14.array(z14.object({
+    entryId: z14.string().optional(),
+    name: z14.string(),
+    type: z14.string(),
+    direction: z14.enum(["outgoing", "incoming"])
+  })),
+  total: z14.number()
+});
+async function handleFind(entryId, direction) {
+  const relations = await kernelQuery("chain.listEntryRelations", { entryId });
+  if (relations.length === 0) {
+    return {
+      content: [{ type: "text", text: `No relations found for \`${entryId}\`. Use relations action=create to create connections.` }],
+      structuredContent: success(
+        `No relations found for '${entryId}'.`,
+        { entryId, relations: [], nodes: [], edges: [], total: 0 },
+        [
+          { tool: "relations", description: "Create a relation", parameters: { action: "create", from: entryId } }
+        ]
+      )
+    };
+  }
+  const sourceEntry = await kernelQuery("chain.getEntry", { entryId });
+  if (!sourceEntry) {
+    return notFoundResult(entryId, `Entry '${entryId}' not found. Try context action=search to find the right ID.`);
+  }
+  const sourceInternalId = sourceEntry._id;
+  const MAX_RELATIONS = 25;
+  const truncated = relations.length > MAX_RELATIONS;
+  const capped = relations.slice(0, MAX_RELATIONS);
+  const otherIds = /* @__PURE__ */ new Set();
+  for (const r of capped) {
+    const otherId = r.fromId === sourceInternalId ? r.toId : r.fromId;
+    otherIds.add(otherId);
+  }
+  const otherEntries = /* @__PURE__ */ new Map();
+  for (const id of otherIds) {
+    const entry = await kernelQuery("chain.getEntry", { id });
+    if (entry) {
+      otherEntries.set(entry._id, { entryId: entry.entryId, name: entry.name, collectionId: entry.collectionId });
+    }
+  }
+  const collections = await kernelQuery("chain.listCollections");
+  const collMap = /* @__PURE__ */ new Map();
+  for (const c of collections) collMap.set(c._id, c.slug);
+  const lines = [`## Find Result`, "", `# Relations for ${entryId}: ${sourceEntry.name}`, ""];
+  const enriched = capped.map((r) => {
+    const isOutgoing = r.fromId === sourceInternalId;
+    const otherId = isOutgoing ? r.toId : r.fromId;
+    const other = otherEntries.get(otherId);
+    const otherLabel = other?.entryId ? `${other.entryId}: ${other.name}` : other?.name ?? "(deleted)";
+    const colSlug = other ? collMap.get(other.collectionId) ?? "unknown" : "unknown";
+    return { isOutgoing, type: r.type, otherLabel, colSlug, otherEntryId: other?.entryId, otherName: other?.name ?? "(deleted)" };
+  });
+  const outgoing = enriched.filter((r) => r.isOutgoing);
+  const incoming = enriched.filter((r) => !r.isOutgoing);
+  if ((direction === "outgoing" || direction === "both") && outgoing.length > 0) {
+    lines.push(`## Outgoing (${outgoing.length})`);
+    for (const r of outgoing) {
+      lines.push(`- \u2192 **${r.type}** ${r.otherLabel} [${r.colSlug}]`);
+    }
+    lines.push("");
+  }
+  if ((direction === "incoming" || direction === "both") && incoming.length > 0) {
+    lines.push(`## Incoming (${incoming.length})`);
+    for (const r of incoming) {
+      lines.push(`- \u2190 **${r.type}** ${r.otherLabel} [${r.colSlug}]`);
+    }
+    lines.push("");
+  }
+  const shown = direction === "outgoing" ? outgoing : direction === "incoming" ? incoming : enriched;
+  if (shown.length === 0) {
+    lines.push(`No ${direction} relations found for \`${entryId}\`.`);
+  }
+  if (truncated) {
+    lines.push(`_Showing first ${MAX_RELATIONS} of ${relations.length} relations. Use context action=get for the full picture._`);
+  }
+  const structuredRelations = shown.map((r) => ({
+    entryId: r.otherEntryId,
+    name: r.otherName,
+    type: r.type,
+    direction: r.isOutgoing ? "outgoing" : "incoming"
+  }));
+  const nodes = [
+    { id: entryId, name: sourceEntry.name, collectionName: "" },
+    ...shown.map((r) => ({
+      id: r.otherEntryId ?? String(Math.random()),
+      name: r.otherName,
+      collectionName: r.colSlug
+    }))
+  ];
+  const edges = shown.filter((r) => r.otherEntryId).map((r) => ({
+    source: entryId,
+    target: r.otherEntryId,
+    type: r.type
+  }));
+  return {
+    content: [{ type: "text", text: lines.join("\n") }],
+    structuredContent: success(
+      `Found ${relations.length} relations for ${entryId}.`,
+      { entryId, relations: structuredRelations, nodes, edges, total: relations.length },
+      [{ tool: "context", description: "View entry details", parameters: { action: "get", entryId } }]
+    )
+  };
+}
+
+// src/tools/contextLookups.ts
+var LOOKUP_ACTIONS = ["get", "batch", "history", "list", "search", "find"];
 var statusFilterSchema = z15.union([z15.string().max(200), z15.array(z15.enum(ENTRY_STATUS_READ_WORDS)).max(5)]);
-var LOOKUP_ACTION_DESCRIBE = "'get': one entry in full by ID. 'batch': up to 20 entries by ID. 'history': audit trail for an entry. 'list': browse entries with filters (accepted by default). 'search': full-text search across entries. ";
-var LOOKUP_TOOL_LINES = "- **get**: Fetch a single entry by ID \u2014 full record with data, labels, relations, history.\n- **batch**: Fetch multiple entries (max 20) in one call. Same shape as get per entry.\n- **history**: Audit trail for an entry.\n- **list**: Browse entries with optional filters (collection, status, tag, label). Use collections action=list first to discover slugs.\n- **search**: Full-text search across entries. Scope by collection or filter by status.\n";
+var LOOKUP_ACTION_DESCRIBE = "'get': one entry in full by ID. 'batch': up to 20 entries by ID. 'history': audit trail for an entry. 'list': browse entries with filters (accepted by default). 'search': full-text search across entries. 'find': an entry's direct relations (direction: incoming|outgoing|both, default both). ";
+var LOOKUP_TOOL_LINES = "- **get**: Fetch a single entry by ID \u2014 full record with data, labels, relations, history.\n- **batch**: Fetch multiple entries (max 20) in one call. Same shape as get per entry.\n- **history**: Audit trail for an entry.\n- **list**: Browse entries with optional filters (collection, status, tag, label). Use collections action=list first to discover slugs.\n- **search**: Full-text search across entries. Scope by collection or filter by status.\n- **find**: An entry's direct relations, incoming and outgoing. NOT full-text search (use search).\n";
 var lookupParams = {
   entryIds: z15.array(z15.string().max(200)).min(1).max(20).optional().describe("For 'batch': entry IDs, e.g. ['TYPE-strategy', 'STR-jljeg7']"),
   collection: z15.string().max(200).optional().describe("For 'list'/'search': collection slug, e.g. 'glossary', 'tracking-events'."),
@@ -4291,6 +4282,11 @@ var lookupVariants = [
     query: z15.string().min(2).max(500),
     collection: z15.string().max(200).optional(),
     status: statusFilterSchema.optional()
+  }),
+  z15.object({
+    action: z15.literal("find"),
+    entryId: z15.string().max(200),
+    direction: z15.enum(["incoming", "outgoing", "both"]).optional().default("both")
   })
 ];
 var LOOKUP_ACTION_SPECS = {
@@ -4298,7 +4294,8 @@ var LOOKUP_ACTION_SPECS = {
   batch: { params: ["entryIds"], description: "entryIds (1-20) is required." },
   history: { params: ["entryId"], description: "entryId is required." },
   list: { params: ["collection", "status", "tag", "label"], description: "Browse accepted entries by default; status='draft' lists drafts; status is one word. All params optional." },
-  search: { params: ["query", "collection", "status"], description: "Full-text search; query is required (min 2 chars)." }
+  search: { params: ["query", "collection", "status"], description: "Full-text search; query is required (min 2 chars)." },
+  find: { params: ["entryId", "direction"], description: "entryId is required." }
 };
 function lookupHandlers(server) {
   return {
@@ -4306,8 +4303,9 @@ function lookupHandlers(server) {
     batch: (data) => handleBatch(data.entryIds),
     history: (data) => handleGetHistory(data),
     list: (data) => handleList(data.collection, data.status, data.tag, data.label),
-    search: (data) => handleSearch(server, data.query, data.collection, data.status)
+    search: (data) => handleSearch(server, data.query, data.collection, data.status),
     // logs progress to the client
+    find: (data) => handleFind(data.entryId, data.direction ?? "both")
   };
 }
 
@@ -4322,13 +4320,13 @@ function epistemicCollectionHint(collectionName) {
   if (lc === "assumptions") return " \u2014 _check evidence strength with `context action=get`_";
   return "";
 }
-var CONTEXT_ACTIONS = ["get", "batch", "history", "list", "search", "gather", "build", "neighborhood", "changes", "chain", "cross-cut", "incremental", "brief", "last-verified-brief"];
+var CONTEXT_ACTIONS = [...LOOKUP_ACTIONS, "gather", "build", "neighborhood", "changes", "chain", "cross-cut", "incremental", "brief", "last-verified-brief"];
 var contextSchema = z16.object({
   // provenance: neighborhood BET-142; changes/chain/cross-cut/incremental/brief BET-239 (E4, E6)
   action: z16.enum(CONTEXT_ACTIONS).describe(
     LOOKUP_ACTION_DESCRIBE + "'gather': assemble knowledge context (entry graph, task auto-load, journey mode, or graph mode). 'build': structured build spec for an entry. 'neighborhood': typed graph neighborhood for an entry \u2014 blocking chain, dependencies, parent context, tensions, staleness. 'changes': entries modified and relations created since a timestamp. Requires 'since' parameter. 'chain': directed traversal along one relation type to depth 4. Requires entryId. Optional: direction, relationType, maxHops (1-4). 'cross-cut': structural aggregation \u2014 all relations of a given type grouped by source collection. Requires 'relationType' parameter. 'incremental': delta since last brief run for a skill. Requires 'skill' parameter. Returns only entries changed since the skill's last brief. 'brief': compound intelligence query. Requires 'briefType' parameter: 'steering' (changes + structure + delta + readiness), 'confidence' (changes + active bets \u2014 use the pb CLI's `tensions list` for tensions), or 'delta' (changes + relations since timestamp). Optional 'since' for delta type. 'last-verified-brief': fetch the most recent verified brief snapshot for a (templateId, scopeKey) pair (absorbs documents action=get-last-verified-brief). Requires templateId and scopeKey."
   ),
-  entryId: z16.string().max(200).optional().describe("For 'get'/'history'/'build'/'neighborhood'/'chain': entry ID, e.g. '<PREFIX>-<n>'. For 'gather': optional entry ID for entry-graph mode."),
+  entryId: z16.string().max(200).optional().describe("For 'get'/'history'/'find'/'build'/'neighborhood'/'chain': entry ID, e.g. '<PREFIX>-<n>'. For 'gather': optional (entry-graph mode)."),
   ...lookupParams,
   mapEntryId: z16.string().max(200).optional().describe(
     "For 'gather': journey map entry ID for journey-aware context. Returns context organised by journey stage. Takes precedence over entryId when both are supplied. Example: '<PREFIX>-<n>'."
@@ -4337,7 +4335,7 @@ var contextSchema = z16.object({
   since: z16.string().max(200).optional().describe(
     "For 'changes': ISO 8601 timestamp \u2014 returns entries/relations modified since this time. For 'brief' briefType='delta': optional custom timestamp. Example: '2026-03-24T00:00:00Z'."
   ),
-  direction: z16.enum(["outgoing", "incoming"]).default("outgoing").optional().describe("For 'chain' action: traversal direction. 'outgoing' follows relations from source, 'incoming' follows relations to source. Default: outgoing."),
+  direction: z16.enum(["outgoing", "incoming", "both"]).optional().describe("For 'chain': 'outgoing' follows relations from source, 'incoming' to source (default outgoing). For 'find': incoming|outgoing|both (default both)."),
   relationType: z16.string().max(200).optional().describe(
     "Relation type filter. For 'chain': optional filter to traverse only this relation type. For 'cross-cut': required \u2014 scans all relations of this type across the workspace. Examples: 'part_of', 'informs', 'governs', 'depends_on'."
   ),
@@ -9347,7 +9345,7 @@ async function handleGetRun(runId, workflowId) {
       run,
       run.summary ? [
         {
-          tool: "relations",
+          tool: "context",
           description: "See the summary entry's connections",
           parameters: { action: "find", entryId: run.summary.entryId }
         }
@@ -9552,7 +9550,7 @@ This checkpoint was NOT saved. The conversation context is preserved \u2014 cont
               parameters: { action: "commit", entryId: result2.summary.entryId }
             },
             {
-              tool: "relations",
+              tool: "context",
               description: "See its connections",
               parameters: { action: "find", entryId: result2.summary.entryId }
             }
@@ -9728,7 +9726,7 @@ async function handleFacilitatedFinalization(wf, descriptor, roundId, normalized
         },
         [
           {
-            tool: "relations",
+            tool: "context",
             description: "See its connections",
             parameters: { action: "find", entryId: summaryEntryId }
           }
@@ -12770,8 +12768,8 @@ var AGENT_CHEATSHEET = `# Product Brain \u2014 Agent Cheatsheet
 | \`orient\` | Workspace context, governance, active work packages, session start | \`action\`: start, task |
 | \`capture\` | Create entry | \`action\`: capture |
 | \`entries\` | Write entries | \`action\`: update, commit, move, verify, preflight, still-true |
-| \`relations\` | Link entries, delete links, find connections | \`action\`: create, batch-create, delete, find |
-| \`context\` | Reads; only incremental writes | \`action\`: get, batch, history, list, search, gather, build, neighborhood, changes, chain, cross-cut, incremental, brief, last-verified-brief |
+| \`relations\` | Link entries, delete links | \`action\`: create, batch-create, delete |
+| \`context\` | Reads; only incremental writes | \`action\`: get, batch, history, list, search, find, gather, build, neighborhood, changes, chain, cross-cut, incremental, brief, last-verified-brief |
 | \`collections\` | Browse, describe, audit and export collections; manage labels | \`action\`: list, update, describe, audit, export, label-* |
 | \`quality\` | Score an entry, verify the Chain, spine check | \`action\`: check, re-evaluate, verify-chain, spine-check |
 | \`session\` | Start / close, wrapup, resume, constellation accept | \`action\`: start, close, status, wrapup-review, wrapup-commit, resume, commit-constellation |
@@ -12849,7 +12847,7 @@ Tags for filtering (e.g. \`severity:high\`), relations via \`entryRelations\`, v
     '## Rules\nThe rules that bind you are in the briefing above, each with its why. A rule on no list binds nobody.\nOpen one: `context action=get entryId="<ID>"`. Find one: `context action=search query="<noun>"`.\nDraft a new rule: use the `draft-rule-from-context` prompt.'
   );
   sections.push(
-    "## Knowledge Graph\nEntries are connected via typed relations (`entryRelations` table). Relations are bidirectional and collection-agnostic \u2014 any entry can link to any other entry.\n\n**Recommended relation types** (extensible \u2014 any string accepted):\n- `governs` \u2014 a rule constrains behavior of a feature\n- `defines_term_for` \u2014 a glossary term is canonical vocabulary for a feature/area\n- `belongs_to` \u2014 a feature belongs to a product area or parent concept (typed successor: `anchored_to`)\n- `informs` \u2014 a decision or insight informs a feature\n- `surfaces_tension_in` \u2014 a tension exists within a feature area\n- `related_to`, `depends_on`, `replaces`, `conflicts_with`, `references`, `confused_with`\n\nEach relation type is defined as a glossary entry (prefix `GT-REL-*`) to prevent terminology drift.\n\n**Tools:**\n- `context action=gather` \u2014 get the full context around any entry (multi-hop graph traversal)\n- `relations action=create` \u2014 create a typed link between two entries\n- `relations action=find` \u2014 list direct relations for an entry\n\n**Convention:** A relation is written only when you ask for it, with exactly the verb you send \u2014 link the entries you know are related with `relations action=create`."
+    "## Knowledge Graph\nEntries are connected via typed relations (`entryRelations` table). Relations are bidirectional and collection-agnostic \u2014 any entry can link to any other entry.\n\n**Recommended relation types** (extensible \u2014 any string accepted):\n- `governs` \u2014 a rule constrains behavior of a feature\n- `defines_term_for` \u2014 a glossary term is canonical vocabulary for a feature/area\n- `belongs_to` \u2014 a feature belongs to a product area or parent concept (typed successor: `anchored_to`)\n- `informs` \u2014 a decision or insight informs a feature\n- `surfaces_tension_in` \u2014 a tension exists within a feature area\n- `related_to`, `depends_on`, `replaces`, `conflicts_with`, `references`, `confused_with`\n\nEach relation type is defined as a glossary entry (prefix `GT-REL-*`) to prevent terminology drift.\n\n**Tools:**\n- `context action=gather` \u2014 get the full context around any entry (multi-hop graph traversal)\n- `relations action=create` \u2014 create a typed link between two entries\n- `context action=find` \u2014 list direct relations for an entry\n\n**Convention:** A relation is written only when you ask for it, with exactly the verb you send \u2014 link the entries you know are related with `relations action=create`."
   );
   sections.push(
     `## Creating Knowledge
@@ -13552,4 +13550,4 @@ export {
   createProductBrainServer,
   initFeatureFlags
 };
-//# sourceMappingURL=chunk-O6HEYDXJ.js.map
+//# sourceMappingURL=chunk-DT756ONZ.js.map