@productbrain/mcp 0.0.1-beta.8845 → 0.0.1-beta.8855

package/dist/{chunk-LPG7TJRX.js → chunk-OEONSR7Q.js}

@@ -42,7 +42,7 @@ import {
   trackSessionCaptureRate,
   trackZeroCaptureAuditFired,
   validateCallerSession
-} from "./chunk-NT3NE6V5.js";
+} from "./chunk-VZNA24SX.js";
 
 // src/server.ts
 import { McpServer as McpServer2 } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -357,7 +357,6 @@ var TOOL_NAME_MIGRATIONS = /* @__PURE__ */ new Map([
   ["relate-entries", 'relations action="create"'],
   ["batch-relate", 'relations action="batch-create"'],
   ["find-related", 'relations action="find"'],
-  ["suggest-links", 'relations action="suggest"'],
   ["gather-context", 'context action="gather"'],
   ["get-build-context", 'context action="build"'],
   ["list-collections", 'collections action="list"'],
@@ -405,7 +404,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|suggest" (same action names)'],
+  ["graph", 'relations 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)'],
@@ -2302,7 +2301,7 @@ Use \`entries action=get\` to inspect the existing entry, or \`entries action=up
   if (isBetOrGoal && !hasStrategyLink) {
     lines.push("");
     lines.push(
-      `**Strategy link:** This ${isWorkPackageOrBetCapture ? "work package" : "goal"} doesn't connect to any strategy entry. Consider linking before accepting. Use \`relations action=suggest entryId="${finalEntryId}"\` to find strategy entries to connect to.`
+      `**Strategy link:** This ${isWorkPackageOrBetCapture ? "work package" : "goal"} doesn't connect to any strategy entry. Consider linking before accepting. Find one with \`entries action=search\` and link it with \`relations action=create\`.`
     );
     await recordSessionActivity({ strategyLinkWarnedForEntryId: internalId });
   }
@@ -2334,13 +2333,13 @@ Use \`entries action=get\` to inspect the existing entry, or \`entries action=up
   lines.push("## Next Steps");
   const eid = finalEntryId || "(check entry ID)";
   if (finalStatus === "committed") {
-    lines.push(`1. **Connect it:** \`relations action=suggest entryId="${eid}"\` \u2014 discover additional links`);
+    lines.push(`1. **Connect it:** find related entries with \`entries action=search\`, then \`relations action=create from="${eid}" to="<ID>" type="<verb>"\``);
     if (hasQualityGaps) {
       lines.push(`2. **Improve quality:** \`entries action=update entryId="${eid}"\` \u2014 fill missing fields`);
     }
   } else {
     if (userLinkResults.length === 0) {
-      lines.push(`1. **Connect it:** \`relations action=suggest entryId="${eid}"\` \u2014 discover what this should link to`);
+      lines.push(`1. **Connect it:** find related entries with \`entries action=search\`, then \`relations action=create from="${eid}" to="<ID>" type="<verb>"\``);
     }
     lines.push(`${userLinkResults.length === 0 ? "2" : "1"}. **Review the possibility:** Keep this visible draft while it is an alternative. Accept only when commitment is intended and your role is authorized. Types reserved for human acceptance require human ratification. An audit advisory is not a reason to accept it.`);
     if (hasQualityGaps) {
@@ -2363,11 +2362,8 @@ Use \`entries action=get\` to inspect the existing entry, or \`entries action=up
   }
   const next = [];
   if (finalStatus === "committed") {
-    next.push({ tool: "relations", description: "Discover connections", parameters: { action: "suggest", entryId: finalEntryId } });
+    next.push({ tool: "relations", description: "See its connections", parameters: { action: "find", entryId: finalEntryId } });
   } else {
-    if (userLinkResults.length === 0) {
-      next.push({ tool: "relations", description: "Discover links", parameters: { action: "suggest", entryId: finalEntryId } });
-    }
     next.push({ tool: "entries", description: "Review the draft alternative", parameters: { action: "get", entryId: finalEntryId } });
     next.push({ tool: "entries", description: "Accept onto Chain", parameters: { action: "commit", entryId: finalEntryId } });
   }
@@ -2925,7 +2921,7 @@ No DB writes \u2014 call without \`preview:true\` to accept for real.` }],
   } catch {
   }
   const next = [
-    { tool: "relations", description: "Discover connections", parameters: { action: "suggest", entryId } },
+    { tool: "relations", description: "See its connections", parameters: { action: "find", entryId } },
     { tool: "entries", description: "View accepted entry", parameters: { action: "get", entryId } }
   ];
   const summary = `Accepted ${entryId} (${entry.name}) onto the Chain.`;
@@ -3832,7 +3828,7 @@ async function handleGet(entryId) {
       `Found ${entryId}: ${String(e.name)} [${String(e.collectionSlug ?? "")}].`,
       entryData,
       [
-        { tool: "relations", description: "Explore connections", parameters: { action: "suggest", entryId } },
+        { tool: "relations", description: "See its connections", parameters: { action: "find", entryId } },
         { tool: "context", description: "Gather related context", parameters: { action: "gather", entryId } }
       ]
     )
@@ -4080,15 +4076,13 @@ import { z as z13 } from "zod/v3";
 
 // src/tools/graph.ts
 import { z as z12 } from "zod/v3";
-var GRAPH_ACTIONS = ["find", "suggest"];
+var GRAPH_ACTIONS = ["find"];
 var graphSchema = z12.object({
   action: z12.enum(GRAPH_ACTIONS).describe(
-    "'find': traverse relations from an entry (graph walk). 'suggest': discover potential connections for an entry."
+    "'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"),
-  limit: z12.number().min(1).max(20).default(10).optional().describe("For suggest: max suggestions to return"),
-  depth: z12.number().min(1).max(3).default(2).optional().describe("For suggest: graph traversal depth")
+  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(),
@@ -4100,18 +4094,6 @@ var graphFindOutputSchema = z12.object({
   })),
   total: z12.number()
 });
-var graphSuggestOutputSchema = z12.object({
-  entryId: z12.string(),
-  suggestions: z12.array(z12.object({
-    targetEntryId: z12.string().optional(),
-    targetName: z12.string(),
-    relationType: z12.string(),
-    direction: z12.string(),
-    confidence: z12.number(),
-    reason: z12.string()
-  })),
-  total: z12.number()
-});
 async function handleFind(entryId, direction) {
   const relations = await kernelQuery("chain.listEntryRelations", { entryId });
   if (relations.length === 0) {
@@ -4121,8 +4103,7 @@ async function handleFind(entryId, direction) {
         `No relations found for '${entryId}'.`,
         { entryId, relations: [], nodes: [], edges: [], total: 0 },
         [
-          { tool: "relations", description: "Create a relation", parameters: { action: "create", from: entryId } },
-          { tool: "relations", description: "Get suggestions", parameters: { action: "suggest", entryId } }
+          { tool: "relations", description: "Create a relation", parameters: { action: "create", from: entryId } }
         ]
       )
     };
@@ -4210,97 +4191,9 @@ async function handleFind(entryId, direction) {
     )
   };
 }
-async function handleSuggest(entryId, limit, depth) {
-  const result2 = await kernelQuery("chain.graphSuggestLinks", {
-    entryId,
-    maxHops: depth,
-    limit
-  });
-  if (!result2?.suggestions || result2.suggestions.length === 0) {
-    return failureResult(
-      `No suggestions found for '${entryId}' \u2014 it may already be well-connected, or no similar entries exist.`,
-      "NOT_FOUND",
-      `No suggestions found for '${entryId}'.`,
-      "Entry may already be well-connected.",
-      [{ tool: "relations", description: "Check existing relations", parameters: { action: "find", entryId } }]
-    );
-  }
-  const resolved = result2.resolvedEntry;
-  const resolvedLabel = resolved ? `\`${resolved.entryId ?? resolved.name}\` (${resolved.name})` : `\`${entryId}\``;
-  const suggestions = result2.suggestions;
-  const graphCount = suggestions.filter((s) => s.graphDistance > 0).length;
-  const textCount = suggestions.filter((s) => s.graphDistance === -1).length;
-  const sourceId = resolved?.entryId ?? entryId;
-  const lines = [
-    `## Suggest Result`,
-    "",
-    `# Link Suggestions for ${resolvedLabel}`,
-    `_${suggestions.length} potential connections (${graphCount} via graph, ${textCount} via text similarity)._`,
-    ""
-  ];
-  const top3 = suggestions.slice(0, 3);
-  lines.push("## Quick Wins (top 3)");
-  const batchArgs = [];
-  for (const s of top3) {
-    const tid = s.entryId ?? "(no ID)";
-    const relType = s.recommendedRelationType || "related_to";
-    lines.push(`- **${tid}**: ${s.name} [${s.collectionSlug}] \u2014 ${s.score}/100 \u2192 \`${relType}\``);
-    if (s.entryId) batchArgs.push(`{from:"${sourceId}",to:"${tid}",type:"${relType}"}`);
-  }
-  lines.push("");
-  if (batchArgs.length > 0) {
-    lines.push(`**Link all 3:** \`relations action=batch-create relations=[${batchArgs.join(",")}]\``);
-    lines.push("");
-  }
-  if (suggestions.length > 3) {
-    lines.push("## All Suggestions");
-    for (let i = 0; i < suggestions.length; i++) {
-      const s = suggestions[i];
-      const scoreBar = "\u2588".repeat(Math.round(s.score / 10)) + "\u2591".repeat(10 - Math.round(s.score / 10));
-      const hopLabel = s.graphDistance > 0 ? `${s.graphDistance}-hop` : "text";
-      const recType = s.recommendedRelationType !== "related_to" ? ` \u2192 \`${s.recommendedRelationType}\`` : "";
-      lines.push(`${i + 1}. **${s.entryId ?? "(no ID)"}**: ${s.name} [${s.collectionSlug}] (${hopLabel})`);
-      lines.push(`   ${scoreBar} ${s.score}/100${recType}`);
-      if (s.preview) lines.push(`   ${s.preview}`);
-      lines.push(`   _${s.reasoning}_`);
-    }
-  }
-  lines.push("");
-  lines.push(`**To link one:** \`relations action=create from="${sourceId}" to="{target_id}" type="{type}"\``);
-  lines.push(`**To dismiss:** \`relations action=dismiss from="${sourceId}" to="{target_id}" type="{type}"\``);
-  const structuredSuggestions = suggestions.map((s) => ({
-    targetEntryId: s.entryId,
-    targetName: s.name,
-    relationType: s.recommendedRelationType || "related_to",
-    direction: "outgoing",
-    confidence: s.score,
-    reason: s.reasoning
-  }));
-  const nodes = [
-    { id: sourceId, name: resolved?.name ?? entryId, collectionName: "" },
-    ...suggestions.map((s) => ({
-      id: s.entryId ?? String(Math.random()),
-      name: s.name,
-      collectionName: s.collectionSlug
-    }))
-  ];
-  const edges = suggestions.filter((s) => s.entryId).map((s) => ({
-    source: sourceId,
-    target: s.entryId,
-    type: s.recommendedRelationType || "suggested"
-  }));
-  return {
-    content: [{ type: "text", text: lines.join("\n") }],
-    structuredContent: success(
-      `Found ${suggestions.length} link suggestions for ${resolvedLabel}.`,
-      { entryId: sourceId, suggestions: structuredSuggestions, nodes, edges, total: suggestions.length },
-      [{ tool: "relations", description: "Create links", parameters: { action: "batch-create" } }]
-    )
-  };
-}
 
 // src/tools/relations.ts
-var RELATIONS_ACTIONS = ["create", "batch-create", "dismiss", "delete", "find", "suggest"];
+var RELATIONS_ACTIONS = ["create", "batch-create", "delete", "find"];
 var relationItemSchema = z13.object({
   from: z13.string().max(200),
   to: z13.string().max(200),
@@ -4308,39 +4201,28 @@ var relationItemSchema = z13.object({
 });
 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). 'dismiss': record that a suggestion was not relevant. 'delete': remove a relation. 'find': traverse relations from an entry (graph walk, absorbs graph action=find). 'suggest': discover potential connections for an entry (absorbs graph action=suggest)."
+    "'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)."
   ),
-  from: z13.string().max(200).optional().describe("For 'create'/'dismiss'/'delete': source entry ID."),
-  to: z13.string().max(200).optional().describe("For 'create'/'dismiss'/'delete': target entry ID."),
-  type: z13.string().max(200).optional().describe("For 'create'/'dismiss'/'delete': relation type."),
-  score: z13.number().optional().describe("For 'dismiss': suggestion score from action=suggest."),
+  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}."),
   // 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'/'suggest': 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'."),
-  limit: z13.number().min(1).max(20).optional().describe("For 'suggest': max suggestions to return. Default 10."),
-  depth: z13.number().min(1).max(3).optional().describe("For 'suggest': graph traversal depth. Default 2.")
+  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'.")
 });
 var relationsCreateVariant = z13.object({
   action: z13.literal("create"),
   from: z13.string().max(200),
   to: z13.string().max(200),
   type: z13.string().max(200),
-  score: z13.number().optional(),
   preview: z13.boolean().optional()
 });
 var relationsBatchCreateVariant = z13.object({
   action: z13.literal("batch-create"),
   relations: z13.array(relationItemSchema).min(1).max(RELATION_BATCH_MAX)
 });
-var relationsDismissVariant = z13.object({
-  action: z13.literal("dismiss"),
-  from: z13.string().max(200),
-  to: z13.string().max(200),
-  type: z13.string().max(200).optional(),
-  score: z13.number().optional()
-});
 var relationsDeleteVariant = z13.object({
   action: z13.literal("delete"),
   from: z13.string().max(200),
@@ -4352,44 +4234,32 @@ var relationsFindVariant = z13.object({
   entryId: z13.string().max(200),
   direction: z13.enum(["incoming", "outgoing", "both"]).optional().default("both")
 });
-var relationsSuggestVariant = z13.object({
-  action: z13.literal("suggest"),
-  entryId: z13.string().max(200),
-  limit: z13.number().min(1).max(20).optional().default(10),
-  depth: z13.number().min(1).max(3).optional().default(2)
-});
 var relationsActionUnion = z13.discriminatedUnion("action", [
   relationsCreateVariant,
   relationsBatchCreateVariant,
-  relationsDismissVariant,
   relationsDeleteVariant,
-  relationsFindVariant,
-  relationsSuggestVariant
+  relationsFindVariant
 ]);
 var RELATIONS_ACTION_SPECS = {
-  create: { params: ["from", "to", "type", "score", "preview"], description: "from, to, and type are required." },
+  create: { params: ["from", "to", "type", "preview"], description: "from, to, and type are required." },
   "batch-create": { params: ["relations"], description: "relations (1-20 items) is required." },
-  dismiss: { params: ["from", "to", "type", "score"], description: "from and to are required." },
   delete: { params: ["from", "to", "type"], description: "from, to, and type are required." },
-  find: { params: ["entryId", "direction"], description: "entryId is required." },
-  suggest: { params: ["entryId", "limit", "depth"], description: "entryId is required." }
+  find: { params: ["entryId", "direction"], description: "entryId is required." }
 };
 function registerRelationsTools(server) {
   const relationsHandlers = {
-    create: (data) => handleCreate(data.from, data.to, data.type, data.score, data.preview),
+    create: (data) => handleCreate(data.from, data.to, data.type, data.preview),
     "batch-create": (data) => handleBatchCreate(data.relations),
-    dismiss: (data) => handleDismiss(data.from, data.to, data.type ?? "related_to", data.score),
     delete: (data) => handleDelete(data.from, data.to, data.type),
-    find: (data) => handleFind(data.entryId, data.direction ?? "both"),
-    suggest: (data) => handleSuggest(data.entryId, data.limit ?? 10, data.depth ?? 2)
+    find: (data) => handleFind(data.entryId, data.direction ?? "both")
   };
   server.registerTool(
     "relations",
     {
       title: "Relations",
-      description: "Create, manage, and discover relations between entries.\n\n- **create**: Link two entries with a typed relation. Use action=suggest to discover connections.\n- **batch-create**: Create multiple relations in one call (validates every item before writing any). Use after action=suggest.\n- **dismiss**: Record that a suggested link was not relevant. Improves future suggestion quality.\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 entries action=search).\n- **suggest**: Discover potential relations for an entry using graph-aware intelligence. Returns ranked suggestions with confidence scores.",
+      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 entries action=search).",
       inputSchema: relationsSchema,
-      // Mixed read/write noun (§3 R3): find/suggest are read-only, create/batch-create/dismiss/delete write.
+      // Mixed read/write noun (§3 R3): find is read-only, create/batch-create/delete write.
       annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false }
     },
     thinWrapper(async (args) => {
@@ -4403,16 +4273,14 @@ function registerRelationsTools(server) {
     })
   );
 }
-async function handleCreate(from, to, type, score, preview) {
+async function handleCreate(from, to, type, preview) {
   requireWriteAccess();
   const agentSessionId = getAgentSessionId();
   const result2 = await kernelMutation("chain.createEntryRelation", {
     fromEntryId: from,
     toEntryId: to,
     type,
-    suggestionScore: score ?? void 0,
-    // WP-474 E4-REWIRE: explicit relate = human/agent-CHOSEN type → mark "user"
-    // (DEC-1399: out of gate scope, but positively marked so the judge never keys off absence).
+    // Explicit relate = the caller chose the verb; DEC-1915 / TASK-601: it is written exactly as sent.
     proposedBy: "user",
     sessionId: agentSessionId ?? void 0,
     ...preview ? { preview: true } : {}
@@ -4478,16 +4346,13 @@ ${result2.blockingReason ?? "This relation would be rejected."}` }],
         )
       };
     }
-    const suggested2 = result2.suggestedType;
     const advisoryText = (result2.advisories ?? []).map((a) => `
 
 \u26A0 **${a.ruleId}** (org stage: ${a.stage}): ${a.ruleText}`).join("");
     return {
       content: [{ type: "text", text: `# Preview: would relate ${from} \u2192 ${to} (${type})
 
-No DB writes \u2014 call without \`preview:true\` to create for real.${suggested2 ? `
-
-**Type suggestion:** \`${suggested2.type}\` may be more precise (${suggested2.confidence}% confidence).` : ""}${advisoryText}` }],
+No DB writes \u2014 call without \`preview:true\` to create for real.${advisoryText}` }],
       structuredContent: success(
         `Preview: would relate ${from} \u2192 ${to} (${type}) \u2014 no DB writes`,
         {
@@ -4495,7 +4360,6 @@ No DB writes \u2014 call without \`preview:true\` to create for real.${suggested
           from,
           to,
           type,
-          ...suggested2 && { suggestedType: suggested2 },
           ...result2.advisories && result2.advisories.length > 0 && { advisories: result2.advisories }
         },
         [{ tool: "relations", description: "Create for real", parameters: { action: "create", from, to, type } }]
@@ -4509,13 +4373,6 @@ No DB writes \u2014 call without \`preview:true\` to create for real.${suggested
     `**${from}** \u2014[${type}]\u2192 **${to}**`,
     `**Workspace:** ${wsCtx.workspaceSlug} (${wsCtx.workspaceId})`
   ];
-  const suggested = result2?.suggestedType;
-  if (suggested) {
-    lines.push("");
-    lines.push(`**Type suggestion:** \`${suggested.type}\` may be more precise (${suggested.confidence}% confidence).`);
-    lines.push(`_${suggested.reasoning}_`);
-    lines.push(`To use instead: \`relations action=create from="${from}" to="${to}" type="${suggested.type}"\``);
-  }
   for (const a of result2?.advisories ?? []) {
     lines.push("");
     lines.push(`\u26A0 Written anyway (org stage: ${a.stage}): ${a.ruleText}`);
@@ -4529,7 +4386,6 @@ No DB writes \u2014 call without \`preview:true\` to create for real.${suggested
         from,
         to,
         type,
-        ...suggested && { suggestedType: suggested },
         ...result2?.advisories && result2.advisories.length > 0 && { advisories: result2.advisories }
       },
       [{ tool: "relations", description: "See connections", parameters: { action: "find", entryId: from } }]
@@ -4587,28 +4443,6 @@ async function handleBatchCreate(relations) {
     )
   };
 }
-async function handleDismiss(from, to, type, score) {
-  requireWriteAccess();
-  const fromEntry = await kernelQuery("chain.getEntry", { entryId: from });
-  if (!fromEntry) {
-    return notFoundResult(from);
-  }
-  const toEntry = await kernelQuery("chain.getEntry", { entryId: to });
-  if (!toEntry) {
-    return notFoundResult(to);
-  }
-  await kernelMutation("chain.dismissSuggestion", {
-    fromEntryId: fromEntry._id,
-    suggestedEntryId: toEntry._id,
-    recommendedType: type,
-    score: score ?? 0
-  });
-  return successResult(
-    `Dismissed suggestion: ${from} \u2192 ${to} (${type}). Feedback recorded for scoring improvements.`,
-    `Dismissed suggestion ${from} \u2192 ${to} (${type}). Feedback recorded.`,
-    { from, to, type }
-  );
-}
 async function handleDelete(from, to, type) {
   requireWriteAccess();
   await kernelMutation("chain.removeEntryRelation", {
@@ -4892,12 +4726,12 @@ async function handleGather(server, entryId, task, mode, maxHops, maxResults, st
 
 _No relations found._ This entry is not yet connected to the knowledge graph.
 
-Use \`relations action=suggest\` to discover potential connections.`
+Use \`relations action=create\` to link it to the entries it relates to.`
         }],
         structuredContent: success(
           `No relations found for ${root2.entryId}. Entry not yet connected.`,
           { root: root2, context: [], totalFound: 0 },
-          [{ tool: "relations", description: "Discover connections", parameters: { action: "suggest", entryId: root2.entryId } }]
+          [{ tool: "relations", description: "Link it", parameters: { action: "create", from: root2.entryId } }]
         )
       };
     }
@@ -5124,12 +4958,12 @@ _This helps future sessions start with better constraints and context._`
 
 _No relations found._ This entry is not yet connected to the knowledge graph.
 
-Use \`relations action=suggest\` to discover potential connections, or \`relations action=create\` to link manually.`
+Use \`relations action=create\` to link it.`
       }],
       structuredContent: success(
         `No relations found for ${root.entryId}. Entry not yet connected.`,
         { root, related: [], totalRelations: 0 },
-        [{ tool: "relations", description: "Discover connections", parameters: { action: "suggest", entryId: root.entryId } }]
+        [{ tool: "relations", description: "Link it", parameters: { action: "create", from: root.entryId } }]
       )
     };
   }
@@ -5312,14 +5146,14 @@ async function handleNeighborhood(entryId) {
   const isEmpty = result2.blockingChain.length === 0 && result2.dependencyChain.length === 0 && !result2.parentContext && result2.relatedTensions.length === 0;
   if (isEmpty) {
     lines.push(`_No neighborhood data found. Entry may not exist or has no graph connections._`);
-    lines.push(`Use \`relations action=suggest\` to discover potential connections.`);
+    lines.push(`Use \`relations action=create\` to link it to the entries it relates to.`);
   }
   return {
     content: [{ type: "text", text: lines.join("\n") }],
     structuredContent: success(
       `Neighborhood for ${entryId}: ${result2.blockingChain.length} blocking, ${result2.dependencyChain.length} dependencies, ${result2.relatedTensions.length} tensions.`,
       result2,
-      isEmpty ? [{ tool: "relations", description: "Discover connections", parameters: { action: "suggest", entryId } }] : void 0
+      isEmpty ? [{ tool: "relations", description: "Link it", parameters: { action: "create", from: entryId } }] : void 0
     )
   };
 }
@@ -7289,11 +7123,11 @@ function buildOrientBriefingLines(view, opts) {
   lines.splice(pull < 0 ? lines.length : pull, 0, RULE_LISTS_EVERYONE_ONLY_LABEL, "(none currently served)", "");
   return lines;
 }
-async function fetchAndRenderOpenerDirection(kernelQuery2, errors, session) {
+async function fetchAndRenderOpenerDirection(kernelQuery3, errors, session) {
   let view = null;
   let fetchFailed = false;
   try {
-    view = await kernelQuery2("chain.getOrientView", {
+    view = await kernelQuery3("chain.getOrientView", {
       tier: "standard",
       invocationPath: session?.invocationPath ?? "session-start",
       // Stamps this call onto the current session/conversation/task (same as every other
@@ -7308,9 +7142,9 @@ async function fetchAndRenderOpenerDirection(kernelQuery2, errors, session) {
   }
   return { lines: [...buildOrientBriefingLines(view), ...buildRitualsSurfaceLines(view, { fetchFailed: fetchFailed || view?.fetchFailed === true })], view };
 }
-async function buildAlreadyOrientedResult(kernelQuery2, agentSessionId, taskGroundingWarningLines2) {
+async function buildAlreadyOrientedResult(kernelQuery3, agentSessionId, taskGroundingWarningLines2) {
   const errors = [];
-  const { lines, view } = await fetchAndRenderOpenerDirection(kernelQuery2, errors, { agentSessionId, invocationPath: "manual-orient" });
+  const { lines, view } = await fetchAndRenderOpenerDirection(kernelQuery3, errors, { agentSessionId, invocationPath: "manual-orient" });
   return {
     content: [{
       type: "text",
@@ -8979,7 +8813,7 @@ Use \`workflows action=checkpoint\` after each round to persist progress to the
       label: "Capture & Accept",
       type: "close",
       instruction: "Capture the pitch to the Chain. Accept draft entries. Connect the constellation.",
-      facilitatorGuidance: "List all draft entries created during shaping (elements, risks, decisions, glossary terms). Ask the user to confirm: 'Ready to accept these onto the Chain?' Call `session action=commit-constellation` to accept the work package and all linked entries \u2014 sequentially, best-effort per entry; check failedIds and conflictIds. Then `relations action=suggest entryId='<betId>'` to discover connections. Create the top 3 suggested relations via `relations action=batch-create`. Thank the user. State: what was shaped, how many constellation entries captured, what the implementer inherits.",
+      facilitatorGuidance: "List all draft entries created during shaping (elements, risks, decisions, glossary terms). Ask the user to confirm: 'Ready to accept these onto the Chain?' Call `session action=commit-constellation` to accept the work package and all linked entries \u2014 sequentially, best-effort per entry; check failedIds and conflictIds. Then link the work package to the entries it relates to via `relations action=batch-create`. Thank the user. State: what was shaped, how many constellation entries captured, what the implementer inherits.",
       outputSchema: {
         field: "capture",
         description: "Final capture summary \u2014 entries accepted, relations created",
@@ -9171,7 +9005,7 @@ This block is the final deliverable of the review. Everything else is supporting
       label: "Capture & Close",
       type: "close",
       instruction: "Finalize the review as an insight draft. Connect new entries from learning extraction. Use session action=wrapup-review. Thank the participant.",
-      facilitatorGuidance: "Summarize the review for finalization. Complete the terminal round through `workflows action=checkpoint` with `isFinal=true` so the workflow substrate creates the draft insight record. Include: BET/feature IDs, verdict, key findings, fixes applied, and the structured verdict block from Round 05. The insight description MUST include the 5-item verdict block (verdict Y/N, what shipped, why it matters, user benefit, how to validate). If learnings were captured in Round 04: run relations action=suggest for each new entry, then relations action=batch-create. Run session action=wrapup-review before closing. Thank the participant. State what was fixed, what was captured, what was deferred.",
+      facilitatorGuidance: "Summarize the review for finalization. Complete the terminal round through `workflows action=checkpoint` with `isFinal=true` so the workflow substrate creates the draft insight record. Include: BET/feature IDs, verdict, key findings, fixes applied, and the structured verdict block from Round 05. The insight description MUST include the 5-item verdict block (verdict Y/N, what shipped, why it matters, user benefit, how to validate). If learnings were captured in Round 04: link each new entry to what it relates to with relations action=batch-create. Run session action=wrapup-review before closing. Thank the participant. State what was fixed, what was captured, what was deferred.",
       outputSchema: {
         field: "capture",
         description: "Insight entry created, WP IDs referenced, learnings connected",
@@ -9236,7 +9070,6 @@ var PROCESS_CHANGE_WORKFLOW_DESCRIPTOR = {
 - \`orient\` \u2014 load workspace context (governance, active work packages, stale entries)
 - \`entries action=search\` \u2014 find related entries
 - \`capture\` \u2014 manual fallback only if workflow finalization cannot safely route the entry
-- \`relations action=suggest\` \u2014 discover connections
 - \`relations action=create\` or \`relations action=batch-create\` \u2014 link to related entries
 - \`entries action=commit\` \u2014 promote to SSOT (only on user confirmation)
 - \`workflows action=checkpoint\` \u2014 save progress if needed
@@ -9296,7 +9129,7 @@ var PROCESS_CHANGE_WORKFLOW_DESCRIPTOR = {
       label: "Capture & Close",
       type: "close",
       instruction: "Capture to the Chain. Link to related entries. Confirm with the user.",
-      facilitatorGuidance: "Finalize through workflows action=checkpoint with isFinal=true, passing a summaryName when you have a clean title. The workflow substrate will create the primary record as a draft and attach it to the durable run. After finalization, call relations action=suggest to find connections. Create the top 2-3 relevant relations. Show the user what was captured: entry ID, collection it landed in, relations created. Ask if they want to accept now or leave as draft. If they confirm, use entries action=commit. If there are stale entries to reconfirm, mention them. Thank the user briefly and exit \u2014 don't linger.",
+      facilitatorGuidance: "Finalize through workflows action=checkpoint with isFinal=true, passing a summaryName when you have a clean title. The workflow substrate will create the primary record as a draft and attach it to the durable run. After finalization, link the entry to the 2-3 entries it relates to with relations action=create. Show the user what was captured: entry ID, collection it landed in, relations created. Ask if they want to accept now or leave as draft. If they confirm, use entries action=commit. If there are stale entries to reconfirm, mention them. Thank the user briefly and exit \u2014 don't linger.",
       outputSchema: {
         field: "capture",
         description: "Entry captured, relations created, accept status",
@@ -9746,8 +9579,8 @@ async function handleGetRun(runId, workflowId) {
       run.summary ? [
         {
           tool: "relations",
-          description: "Discover connections for the summary entry",
-          parameters: { action: "suggest", entryId: run.summary.entryId }
+          description: "See the summary entry's connections",
+          parameters: { action: "find", entryId: run.summary.entryId }
         }
       ] : void 0
     )
@@ -9928,7 +9761,7 @@ This checkpoint was NOT saved. The conversation context is preserved \u2014 cont
         `Name: ${result2.summary.name}`,
         "",
         `The summary is captured as a draft. Use \`entries action=commit entryId="${result2.summary.entryId}"\` to promote it to the Chain.`,
-        `Use \`relations action=suggest entryId="${result2.summary.entryId}"\` to discover connections.`
+        `Use \`relations action=create\` to link it to the entries it relates to.`
       );
       return {
         content: [{ type: "text", text: lines.join("\n") }],
@@ -9951,8 +9784,8 @@ This checkpoint was NOT saved. The conversation context is preserved \u2014 cont
             },
             {
               tool: "relations",
-              description: "Discover connections",
-              parameters: { action: "suggest", entryId: result2.summary.entryId }
+              description: "See its connections",
+              parameters: { action: "find", entryId: result2.summary.entryId }
             }
           ]
         )
@@ -10127,8 +9960,8 @@ async function handleFacilitatedFinalization(wf, descriptor, roundId, normalized
         [
           {
             tool: "relations",
-            description: "Discover connections",
-            parameters: { action: "suggest", entryId: summaryEntryId }
+            description: "See its connections",
+            parameters: { action: "find", entryId: summaryEntryId }
           }
         ]
       )
@@ -10433,7 +10266,7 @@ function registerQualityTools(server) {
     "quality",
     {
       title: "Quality",
-      description: "Assess, re-evaluate, and verify entry/work package quality. Four actions:\n\n- **check**: Read the entry's server quality verdict (tier + criteria) \u2014 it does not re-score. Suggests links when the entry has no relations.\n- **re-evaluate**: Trigger a fresh quality evaluation. Returns heuristic verdict immediately, schedules LLM evaluation in background.\n- **verify-chain**: Verify knowledge entries against the actual codebase (codeMapping drift, cross-references) \u2014 absorbs `verify`. Produces a trust report with a trust score.\n- **spine-check**: Structural completeness of the purpose+vision+strategy spine \u2014 duplicate singletons, connectedness, per-strategy refusal heuristic; story:true also runs the on-demand one-story LLM judgment (never scheduled, result labelled [unvalidated]). Async: a plain call reads back the latest stored verdict and auto-schedules a new run ONLY when none is already in flight AND the stored one is absent/stale/missing the requested story pass \u2014 repeated polling never re-triggers work. Pass refresh:true to force a fresh run regardless.",
+      description: "Assess, re-evaluate, and verify entry/work package quality. Four actions:\n\n- **check**: Read the entry's server quality verdict (tier + criteria) \u2014 it does not re-score.\n- **re-evaluate**: Trigger a fresh quality evaluation. Returns heuristic verdict immediately, schedules LLM evaluation in background.\n- **verify-chain**: Verify knowledge entries against the actual codebase (codeMapping drift, cross-references) \u2014 absorbs `verify`. Produces a trust report with a trust score.\n- **spine-check**: Structural completeness of the purpose+vision+strategy spine \u2014 duplicate singletons, connectedness, per-strategy refusal heuristic; story:true also runs the on-demand one-story LLM judgment (never scheduled, result labelled [unvalidated]). Async: a plain call reads back the latest stored verdict and auto-schedules a new run ONLY when none is already in flight AND the stored one is absent/stale/missing the requested story pass \u2014 repeated polling never re-triggers work. Pass refresh:true to force a fresh run regardless.",
       inputSchema: qualitySchema,
       annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false }
     },
@@ -10448,30 +10281,6 @@ function registerQualityTools(server) {
     })
   );
 }
-async function appendLinkSuggestions(entryId, lines) {
-  let relationCount = -1;
-  try {
-    const relations = await kernelQuery("chain.listEntryRelations", { entryId });
-    relationCount = relations?.length ?? 0;
-  } catch {
-    return;
-  }
-  if (relationCount !== 0) return;
-  try {
-    const suggestions = await kernelQuery("chain.graphSuggestLinks", {
-      entryId,
-      maxHops: 2,
-      limit: 3
-    });
-    if ((suggestions?.suggestions?.length ?? 0) > 0) {
-      const linkHints = (suggestions.suggestions ?? []).map((s) => `  \u2192 \`relations action=create from="${entryId}" to="${s.entryId}" type="${s.recommendedRelationType}"\` \u2014 ${s.name} [${s.collectionSlug}] (${s.score}/100)`).join("\n");
-      lines.push(`
-## Suggested Links to Improve Quality
-${linkHints}`);
-    }
-  } catch {
-  }
-}
 async function handleCheck(entryId) {
   const res = await kernelQuery("quality.getLatestVerdictForEntry", { entryId });
   if (!res || !res.entryFound) {
@@ -10491,7 +10300,6 @@ Entry \`${entryId}\` not found. Use \`search\` to find the right ID.`,
       "",
       `No quality verdict yet for \`${entryId}\`. Run \`quality action=re-evaluate entryId="${entryId}"\` to evaluate it.`
     ];
-    await appendLinkSuggestions(entryId, lines2);
     return successResult(
       lines2.join("\n"),
       `No quality verdict yet for ${entryId} \u2014 re-evaluate to produce one.`,
@@ -10512,7 +10320,6 @@ Entry \`${entryId}\` not found. Use \`search\` to find the right ID.`,
     const verdictSection = formatRubricVerdictSection(verdict);
     lines.push(verdictSection || `Verdict tier \`${verdict.tier ?? "unknown"}\` for \`${entryId}\` \u2014 no rubric criteria to report.`);
   }
-  await appendLinkSuggestions(entryId, lines);
   try {
     const wsForTracking = await getWorkspaceContext();
     trackQualityCheck(wsForTracking.workspaceId, {
@@ -10541,9 +10348,7 @@ Entry \`${entryId}\` not found. Use \`search\` to find the right ID.`,
       ...res.stale ? {} : { passed: verdict.passed },
       criteria: res.stale ? [] : criteria.map((c) => ({ id: c.id, passed: c.passed, hint: c.hint }))
     },
-    [
-      { tool: "relations", description: "Suggest connections", parameters: { action: "suggest", entryId } }
-    ]
+    []
   );
 }
 async function handleReEvaluate(entryId, context) {
@@ -10632,25 +10437,6 @@ function composeWrapupView(raw) {
 }
 
 // src/tools/wrapup.ts
-async function mapWithConcurrency(items, mapper, concurrency = 3) {
-  const results = new Array(items.length);
-  let index = 0;
-  async function runNext() {
-    while (index < items.length) {
-      const i = index++;
-      try {
-        const value = await mapper(items[i]);
-        results[i] = { status: "fulfilled", value };
-      } catch (reason) {
-        results[i] = { status: "rejected", reason };
-      }
-    }
-  }
-  await Promise.all(
-    Array.from({ length: Math.min(concurrency, items.length) }, () => runNext())
-  );
-  return results;
-}
 function isValidTopGap(g) {
   if (typeof g !== "object" || g === null) return false;
   const obj = g;
@@ -10672,40 +10458,13 @@ async function fetchSessionCoherenceSnapshot(sessionId) {
   }
   return null;
 }
-async function suggestLinksForEntries(entries) {
-  const suggestions = [];
-  const results = await mapWithConcurrency(
-    entries,
-    async (entry) => {
-      const result2 = await kernelQuery("chain.graphSuggestLinks", {
-        entryId: entry.entryId,
-        limit: 3
-      });
-      return { entry, suggestions: result2.suggestions ?? [] };
-    },
-    3
-  );
-  for (const result2 of results) {
-    if (result2.status !== "fulfilled") continue;
-    const { entry, suggestions: entrySuggestions } = result2.value;
-    for (const s of entrySuggestions.filter((x) => x.entryId != null).slice(0, 2)) {
-      suggestions.push({
-        fromEntryId: entry.entryId,
-        toEntryId: s.entryId,
-        type: s.recommendedRelationType,
-        label: `${entry.entryId} \u2192 ${s.entryId} (${s.name}) [${s.recommendedRelationType}]`
-      });
-    }
-  }
-  return suggestions;
-}
 async function runWrapupReview() {
   const sessionId = getAgentSessionId();
   if (!sessionId) {
-    return { text: "No active agent session. Call `session action=start` first.", data: null, suggestions: [], failureCode: "SESSION_REQUIRED" };
+    return { text: "No active agent session. Call `session action=start` first.", data: null, failureCode: "SESSION_REQUIRED" };
   }
   if (getApiKeyScope() === "read") {
-    return { text: "Read-only session \u2014 nothing to review.", data: null, suggestions: [], failureCode: "READONLY_SCOPE" };
+    return { text: "Read-only session \u2014 nothing to review.", data: null, failureCode: "READONLY_SCOPE" };
   }
   const { workspaceId } = await getWorkspaceContext();
   const kernelEnvelope = await kernelCallEnvelope("agentKnowledge.wrapupEnvelope", {
@@ -10718,10 +10477,10 @@ async function runWrapupReview() {
   const overflowUnscanned = data.overflowUnscanned ?? 0;
   const loopEmpty = data.drafts.length === 0 && overflowDraftCount === 0 && overflowUnscanned === 0;
   if (data.wrapupCompletedAt && loopEmpty) {
-    return { text: "Wrapup already completed this session.", data, suggestions: [], failureCode: "ALREADY_COMPLETED" };
+    return { text: "Wrapup already completed this session.", data, failureCode: "ALREADY_COMPLETED" };
   }
   if (data.drafts.length === 0 && data.committed.length === 0 && overflowDraftCount === 0 && (data.overflowCommitted ?? []).length === 0) {
-    return { text: "Empty session \u2014 no entries to review.", data, suggestions: [], failureCode: "NOT_FOUND" };
+    return { text: "Empty session \u2014 no entries to review.", data, failureCode: "NOT_FOUND" };
   }
   const lines = [];
   lines.push(
@@ -10766,17 +10525,6 @@ async function runWrapupReview() {
     }
     lines.push("");
   }
-  const lowConnEntries = [...data.drafts, ...data.committed].filter(
-    (e) => (data.connectionCounts[e.entryId] ?? 0) < 2
-  );
-  const suggestions = lowConnEntries.length > 0 ? await suggestLinksForEntries(lowConnEntries.slice(0, 10)) : [];
-  if (suggestions.length > 0) {
-    lines.push("### Suggested Links (not written; wrapup-commit writes none \u2014 create the ones you want with `relations action=create`)", "");
-    for (const s of suggestions) {
-      lines.push(`- ${s.label}`);
-    }
-    lines.push("");
-  }
   const topGaps = getTopGaps(5);
   if (topGaps.length > 0) {
     lines.push("### Learning Opportunities", "");
@@ -10875,7 +10623,6 @@ async function runWrapupReview() {
   return {
     text: lines.join("\n"),
     data,
-    suggestions,
     gapCount,
     coherenceVerdict,
     persistentGaps,
@@ -11008,7 +10755,7 @@ function createWrapupHandler() {
         commitNext
       );
     }
-    const { text, data, suggestions, failureCode, gapCount, coherenceVerdict, persistentGaps, kernelSummary, kernelNext, kernelMeta } = await runWrapupReview();
+    const { text, data, failureCode, gapCount, coherenceVerdict, persistentGaps, kernelSummary, kernelNext, kernelMeta } = await runWrapupReview();
     lastReviewData = data;
     lastReviewSessionId = getAgentSessionId();
     const composed = data ? composeWrapupView(data) : null;
@@ -11025,7 +10772,7 @@ ${text}` : text;
     const persistentSummary = persistentGaps?.length ? `, ${persistentGaps.length} persistent coherence gaps` : "";
     const draftsCount = composed?.drafts.length ?? data.drafts.length;
     const committedCount = composed?.committed.length ?? data.committed.length;
-    const summaryText = `Session review: ${draftsCount} uncommitted, ${committedCount} committed, ${suggestions.length} link suggestions${gapsSummary}${coherenceSummary}${persistentSummary}.`;
+    const summaryText = `Session review: ${draftsCount} uncommitted, ${committedCount} committed${gapsSummary}${coherenceSummary}${persistentSummary}.`;
     return {
       content: [{ type: "text", text: fullText }],
       structuredContent: {
@@ -11035,7 +10782,6 @@ ${text}` : text;
           drafts: draftsCount,
           committed: committedCount,
           uncommitted: data.summary.uncommitted,
-          suggestedLinks: suggestions.length,
           knowledgeGaps: gapCount ?? 0,
           ...coherenceVerdict ? { coherenceVerdict } : {},
           ...persistentGaps?.length ? { persistentCoherenceGaps: persistentGaps.length } : {}
@@ -11408,7 +11154,7 @@ function registerSessionTools(server) {
     "session",
     {
       title: "Session \u2014 Lifecycle & Facilitation",
-      description: "Session lifecycle, wrapup review, and work package facilitation.\n\n- **start**: Begin a tracked write session for attribution. **This is the ONLY call that creates a session** \u2014 write tools (capture, entries action=update/commit, relations) require it. `orient action=start` orients an existing session and loads stage-aware context, but does NOT create one: call `session action=start` first, then `orient action=start`.\n- **close**: End the current session. Records structured data (entries created, modified, relations). Run `session action=wrapup-review` before closing.\n- **status**: Check current session \u2014 active or not, oriented, activity counts.\n- **wrapup-review**: Review uncommitted drafts with quality scores, suggested links. Run before close.\n- **wrapup-commit**: Accept all uncommitted drafts. Writes no relations; create the ones you want with relations action=create.\n- **resume**: Load session state (work package data, constellation, drafts) from an existing work package entry.\n- **commit-constellation**: Atomically accept a work package and all its linked draft entries in one call.",
+      description: "Session lifecycle, wrapup review, and work package facilitation.\n\n- **start**: Begin a tracked write session for attribution. **This is the ONLY call that creates a session** \u2014 write tools (capture, entries action=update/commit, relations) require it. `orient action=start` orients an existing session and loads stage-aware context, but does NOT create one: call `session action=start` first, then `orient action=start`.\n- **close**: End the current session. Records structured data (entries created, modified, relations). Run `session action=wrapup-review` before closing.\n- **status**: Check current session \u2014 active or not, oriented, activity counts.\n- **wrapup-review**: Review uncommitted drafts with quality scores. Run before close.\n- **wrapup-commit**: Accept all uncommitted drafts. Writes no relations; create the ones you want with relations action=create.\n- **resume**: Load session state (work package data, constellation, drafts) from an existing work package entry.\n- **commit-constellation**: Atomically accept a work package and all its linked draft entries in one call.",
       inputSchema: sessionSchema,
       // Mixed read/write noun (§3 R3): wrapup-commit/resume/commit-constellation write.
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
@@ -13147,7 +12893,7 @@ 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\` | Read and write entries | \`action\`: list, get, batch, search, update, commit, history, move, verify, preflight, still-true |
-| \`relations\` | Link entries, dismiss suggestions and delete links, find and suggest | \`action\`: create, batch-create, dismiss, delete, find, suggest |
+| \`relations\` | Link entries, delete links, find connections | \`action\`: create, batch-create, delete, find |
 | \`context\` | Gather related knowledge, last-verified brief | \`action\`: 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 |
@@ -13184,7 +12930,7 @@ Write via \`update\`: \`draft\` | \`archived\` (\`accepted\` via \`commit\`, nev
 - A rule on no list binds nobody; a full list refuses a new rule until one retires, and a list over its cap is served whole.
 
 ## Key Patterns
-- **Capture flow:** \`capture\` \u2192 \`relations action=suggest\` \u2192 \`relations action=batch-create\` \u2192 \`entries action=commit\`
+- **Capture flow:** \`capture\` \u2192 \`relations action=batch-create\` \u2192 \`entries action=commit\`
 - Use \`workflowStatus\` (not \`status\`) for domain workflow state
 - \`data\` param is merged (not replaced) \u2014 safe for partial updates
 `;
@@ -13226,13 +12972,13 @@ 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: `entries action=get entryId="<ID>"`. Find one: `entries 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=suggest` \u2014 discover potential connections for an entry\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:** When creating or updating entries in governed collections, always use `relations action=suggest` to discover and create relevant relations."
+    "## 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`."
   );
   sections.push(
     `## Creating Knowledge
 **Entries:** Use \`capture\` as the primary tool for creating new entries. It handles the full workflow in one call:
 1. Creates the entry with collection-aware defaults (auto-fills dates, infers domains, sets priority)
-2. Writes the relations you pass in \`links\` \u2014 and no others; use \`relations action=suggest\` then \`relations action=create\` to add more
+2. Writes the relations you pass in \`links\` \u2014 and no others; use \`relations action=create\` to add more
 3. Returns the server's quality verdict with improvement hints
 
 **Smart profiles** exist for: ${SMART_PROFILE_COLLECTIONS.map((c) => `\`${c}\``).join(", ")}.
@@ -13249,14 +12995,14 @@ Use \`quality action=check\` to score existing entries retroactively.
 Use \`entries action=update\` for post-creation adjustments (status changes, field updates, deprecation).`
   );
   sections.push(
-    "## Where to Go Next\n- **Create entry** \u2192 `capture` tool (entry, the links you pass, and a quality verdict in one call)\n- **Full context** \u2192 `context action=gather` (by entry ID or task description)\n- **Discover links** \u2192 `relations action=suggest`\n- **Quality audit** \u2192 `quality action=check`\n- **Terminology** \u2192 `name-check` prompt or `productbrain://terminology` resource\n- **Schema details** \u2192 `productbrain://collections` resource or `collections action=list`\n- **Labels** \u2192 `productbrain://labels` resource or `collections action=label-list`\n- **Any collection** \u2192 `productbrain://{slug}/entries` resource\n- **Log a decision** \u2192 `draft-decision-record` prompt\n- **Growth funnel** \u2192 `productbrain://growth-funnel` resource or `entries action=list collection=strategy status=draft`\n- **Session identity** \u2192 `workspace action=whoami`\n- **Health check** \u2192 `workspace action=check`\n- **Debug MCP calls** \u2192 `workspace action=audit`"
+    "## Where to Go Next\n- **Create entry** \u2192 `capture` tool (entry, the links you pass, and a quality verdict in one call)\n- **Full context** \u2192 `context action=gather` (by entry ID or task description)\n- **Link entries** \u2192 `relations action=create`\n- **Quality audit** \u2192 `quality action=check`\n- **Terminology** \u2192 `name-check` prompt or `productbrain://terminology` resource\n- **Schema details** \u2192 `productbrain://collections` resource or `collections action=list`\n- **Labels** \u2192 `productbrain://labels` resource or `collections action=label-list`\n- **Any collection** \u2192 `productbrain://{slug}/entries` resource\n- **Log a decision** \u2192 `draft-decision-record` prompt\n- **Growth funnel** \u2192 `productbrain://growth-funnel` resource or `entries action=list collection=strategy status=draft`\n- **Session identity** \u2192 `workspace action=whoami`\n- **Health check** \u2192 `workspace action=check`\n- **Debug MCP calls** \u2192 `workspace action=audit`"
   );
   return sections.join("\n\n---\n\n");
 }
-async function buildOrientationResourceText(kernelQuery2, agentSessionId) {
+async function buildOrientationResourceText(kernelQuery3, agentSessionId) {
   const [collectionsResult, orientViewResult] = await Promise.allSettled([
-    kernelQuery2("chain.listCollections"),
-    kernelQuery2("chain.getOrientView", {
+    kernelQuery3("chain.listCollections"),
+    kernelQuery3("chain.getOrientView", {
       tier: "summary",
       invocationPath: "unknown",
       ...agentSessionId ? { sessionId: agentSessionId } : {}
@@ -13837,10 +13583,10 @@ var INSTRUCTIONS = [
   "",
   "## Writing",
   "",
-  "Write actions (capture, entries update and commit, relations create, batch-create, dismiss and delete) need an active session and a readwrite key.",
+  "Write actions (capture, entries update and commit, relations create, batch-create and delete) need an active session and a readwrite key.",
   "Pass the `sessionId` that `session action=start` returned on every write: the connection does not remember it.",
   "Use `capture` to create an entry and read its reply: an entry that came back accepted needs no `entries action=commit`.",
-  "Link with `relations action=suggest`, then `relations action=create`.",
+  "Link entries with `relations action=create` \u2014 a relation is written only when you ask, with exactly the verb you send.",
   "Finish with `session action=wrapup-review`, then `session action=close`.",
   "If the work falls outside the active work packages, name the gap and ask the user before designing it.",
   "",
@@ -13938,4 +13684,4 @@ export {
   createProductBrainServer,
   initFeatureFlags
 };
-//# sourceMappingURL=chunk-LPG7TJRX.js.map
+//# sourceMappingURL=chunk-OEONSR7Q.js.map