@productbrain/mcp 0.0.1-beta.8779 → 0.0.1-beta.8789

package/dist/{chunk-USZ2527R.js → chunk-X2VLEDPS.js}

@@ -1303,8 +1303,7 @@ var GENERIC_PROFILE = {
   governedDraft: false,
   descriptionField: null,
   // TEN-3704 F4: never a hard-coded "description" — see resolveGenericDescriptionField
-  defaults: [],
-  recommendedRelationTypes: ["related_to", "references"]
+  defaults: []
 };
 async function buildRuntimeProfile(slug, fieldsOverride) {
   const col = await getCollectionBySlug(slug);
@@ -1313,8 +1312,7 @@ async function buildRuntimeProfile(slug, fieldsOverride) {
   return {
     governedDraft: col.governed === true,
     descriptionField,
-    defaults: [],
-    recommendedRelationTypes: GENERIC_PROFILE.recommendedRelationTypes
+    defaults: []
   };
 }
 var profileCache = new ScopedCache(COLLECTION_CACHE_TTL_MS);
@@ -1334,41 +1332,6 @@ async function getProfile(slug, fieldsOverride) {
 function invalidateProfileCacheForScope() {
   profileCache.delete(cacheScope());
 }
-function extractSearchTerms(name, description) {
-  const text = `${name} ${description}`;
-  return text.replace(/[^\w\s]/g, " ").split(/\s+/).filter((w) => w.length > 3).slice(0, 8).join(" ");
-}
-var hubCache = new ScopedCache(COLLECTION_CACHE_TTL_MS);
-async function populateHubCache() {
-  const scope = cacheScope();
-  const hit = hubCache.get(scope);
-  if (hit) return hit;
-  const cols = await getCollections();
-  const set = new Set(
-    cols.filter((c) => c.governanceRole === "steering" || c.thinkingLayer === "strategy").map((c) => c.slug)
-  );
-  hubCache.set(scope, set);
-  return set;
-}
-function invalidateHubCacheForScope() {
-  hubCache.delete(cacheScope());
-}
-function buildScoreLinkCandidatesJob(candidates, sourceName, sourceDescription, sourceCollection) {
-  return {
-    candidates: candidates.map((c) => ({ name: c.name, collectionId: c.collectionId })),
-    sourceName,
-    sourceDescription,
-    sourceCollection
-  };
-}
-function inferRelationType(_sourceCollection, _targetCollection, profile) {
-  const type = profile.recommendedRelationTypes[0] ?? "related_to";
-  const reason = `profile default (${type})`;
-  return { type, reason };
-}
-var AUTO_LINK_CONFIDENCE_THRESHOLD = 35;
-var MAX_AUTO_LINKS = 5;
-var MAX_SUGGESTIONS = 5;
 var SPINE_FLOOR_SENTENCE = "kept as a draft; it can be accepted once its spine above is accepted \u2014 the promote door checks the whole spine and names the first missing rung.";
 var SPINE_FLOOR_EXEMPT_SENTENCE = "kept as a draft, though this workspace is not yet enforcing the spine above it \u2014 it can be accepted as-is.";
 var BR_STD_ENTRY_ID_REGEX = /^(BR|STD)-\d+$/;
@@ -1386,7 +1349,7 @@ var captureSchema = z4.object({
   links: z4.array(z4.object({
     to: z4.string().describe("Target entry ID (e.g. '<PREFIX>-<n>')"),
     type: z4.string().describe("Relation type (e.g. 'governs', 'related_to', 'informs')")
-  })).optional().describe("Relations to create after capture. Skips auto-link discovery when provided."),
+  })).optional().describe("Relations to create after capture. Without links, a capture writes no relations."),
   sourceRef: z4.string().optional().describe("URI or path of the source document backing this entry (e.g. 'meeting-2026-03-28.md', 'import://batch-5'). Stored as top-level entry field, not in data."),
   sourceExcerpt: z4.string().optional().describe("Verbatim excerpt from the source that backs this entry's claims. Stored as top-level entry field, not in data."),
   // WP-316 S3: Preview gate — dry-run mode. Returns what would happen, no DB writes.
@@ -1702,7 +1665,7 @@ var captureCompoundSchema = z4.object({
   links: z4.array(z4.object({
     to: z4.string().max(200).describe("Target entry ID (e.g. '<PREFIX>-<n>')"),
     type: z4.string().max(200).describe("Relation type (e.g. 'governs', 'related_to', 'informs')")
-  })).max(RELATION_BATCH_MAX).optional().describe("Relations to create after capture. Skips auto-link discovery when provided."),
+  })).max(RELATION_BATCH_MAX).optional().describe("Relations to create after capture. Without links, a capture writes no relations."),
   sourceRef: z4.string().max(2e3).optional().describe("URI or path of the source document backing this entry."),
   sourceExcerpt: z4.string().max(SOURCE_EXCERPT_MAX_CHARS).optional().describe("Verbatim excerpt from the source backing this entry's claims."),
   preview: z4.boolean().optional().describe("If true, validates without writing."),
@@ -1730,14 +1693,14 @@ function registerSmartCaptureTools(server) {
     "capture",
     {
       title: "Capture",
-      description: `The tool for creating a single knowledge entry. Creates an entry, auto-links related entries, and returns a quality scorecard \u2014 all in one call. Provide a name and description; \`collection\` is optional \u2014 the classifier auto-routes when omitted. An agent capturing several atoms from one text calls this once per atom.
+      description: `The tool for creating a single knowledge entry. Creates an entry and returns a quality scorecard \u2014 all in one call. Provide a name and description; \`collection\` is optional \u2014 the classifier auto-routes when omitted. An agent capturing several atoms from one text calls this once per atom.
 
 Supported collections with smart profiles: ${SMART_PROFILE_COLLECTIONS.join(", ")}.
 All other collections get an ENT-{random} ID and sensible defaults.
 
 **Explicit data:** When you know the schema, pass \`data: { field: value }\` to set fields directly. Top-level \`name\`/\`description\` win for those fields; \`data\` wins over inference for the rest. Governance entries also require a top-level \`why\`.
 
-**Compound capture:** Pass \`links\` to create relations in the same call (skips auto-link discovery). Entries are always created as \`draft\` \u2014 use \`entries action=commit\` to promote when ready.`,
+**Compound capture:** Pass \`links\` to create relations in the same call; a capture writes no other relations. Entries are always created as \`draft\` \u2014 use \`entries action=commit\` to promote when ready.`,
       inputSchema: captureCompoundSchema,
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
     },
@@ -1916,7 +1879,6 @@ ${groundingReport.duplicates.map((d) => `- **${d.entryId}** ${d.name} [${d.colle
       data,
       entryId: "",
       linksCreated: [],
-      linksSuggested: [],
       collectionFields: col.fields ?? []
     });
     for (const [key, val] of Object.entries(inferred)) {
@@ -1989,9 +1951,7 @@ ${groundingReport.duplicates.map((d) => `- **${d.entryId}** ${d.name} [${d.colle
       // WP-475 E1 (Codex P2 — CLI parity): user links are known UPFRONT, so the
       // post-relations re-evaluation below owns the single LLM run — defer the
       // create-time LLM schedule (deterministic, mirrors `pb capture --link`).
-      // Auto-discovered links are unknown here: zero-user-link captures do NOT
-      // defer (a link-less capture must keep its LLM run); the supersession
-      // guard bounds the auto-link double-run race when timing allows.
+      // A capture without links writes no relations (TASK-599): no defer, it keeps its LLM run.
       // Fail-safe: if the relations batch then creates nothing, the deferred row
       // keeps its delivered heuristic verdict with llmStatus 'skipped' (same
       // accepted shape as the CLI dying between create and re-eval).
@@ -2111,87 +2071,10 @@ Use \`entries action=get\` to inspect the existing entry, or \`entries action=up
     grounding_ms: groundingElapsedMs
   }).catch(() => void 0);
   const linksCreated = [];
-  const linksSuggested = [];
   const userLinkResults = [];
-  const advisedLinks = [];
   const pendingRelations = [];
-  const skipAutoDiscovery = links && links.length > 0;
-  const searchQuery = extractSearchTerms(name, description);
-  if (searchQuery && !skipAutoDiscovery) {
-    const hubSlugs = await populateHubCache();
-    const [searchResults, allCollections] = await Promise.all([
-      kernelQuery("chain.searchEntries", { query: searchQuery }),
-      getCollections()
-    ]);
-    const collMap = /* @__PURE__ */ new Map();
-    for (const c of allCollections) collMap.set(c._id, c.slug);
-    const candidatesFiltered = (searchResults ?? []).filter((r) => r.entryId !== finalEntryId && r._id !== internalId).map((r) => ({
-      name: r.name,
-      entryId: r.entryId,
-      collectionId: r.collectionId,
-      preview: extractPreview(r.data, 80)
-    }));
-    let scores = [];
-    if (candidatesFiltered.length > 0) {
-      try {
-        const scoreJobResults = await kernelQuery("chain.scoreLinkCandidates", {
-          collMap: Object.fromEntries(collMap),
-          hubSlugs: [...hubSlugs],
-          jobs: [
-            buildScoreLinkCandidatesJob(
-              candidatesFiltered.map((r) => ({ name: r.name, collectionId: r.collectionId })),
-              name,
-              description,
-              resolvedCollection
-            )
-          ]
-        });
-        scores = scoreJobResults[0] ?? [];
-      } catch {
-      }
-    }
-    const candidates = scores.map((s) => {
-      const r = candidatesFiltered[s.index];
-      return {
-        ...r,
-        collSlug: collMap.get(r.collectionId) ?? "unknown",
-        confidence: s.score,
-        confidenceReason: s.reason
-      };
-    });
-    let autoCount = 0;
-    for (const c of candidates) {
-      if (autoCount >= MAX_AUTO_LINKS) break;
-      if (c.confidence < AUTO_LINK_CONFIDENCE_THRESHOLD) break;
-      if (!c.entryId || !finalEntryId) continue;
-      const { type: relationType, reason: relationReason } = inferRelationType(resolvedCollection, c.collSlug, profile);
-      pendingRelations.push({
-        fromEntryId: finalEntryId,
-        toEntryId: c.entryId,
-        type: relationType,
-        // WP-474 E4-REWIRE: auto-defaulted relation (no one chose the type) — mark it
-        // as auto-link and carry the numeric confidence structurally.
-        proposedBy: "auto-link",
-        confidence: c.confidence,
-        meta: {
-          source: "auto",
-          targetName: c.name,
-          targetCollection: c.collSlug,
-          linkReason: `confidence ${c.confidence} (${c.confidenceReason}) + ${relationReason}`
-        }
-      });
-      autoCount++;
-    }
-    const autoTargetIds = new Set(pendingRelations.map((r) => r.toEntryId));
-    for (const c of candidates) {
-      if (linksSuggested.length >= MAX_SUGGESTIONS) break;
-      if (c.entryId !== void 0 && autoTargetIds.has(c.entryId)) continue;
-      if (c.confidence < 10) continue;
-      const reason = c.confidence >= AUTO_LINK_CONFIDENCE_THRESHOLD ? "high relevance (already linked)" : `"${c.name.toLowerCase().split(/\s+/).filter((w) => `${name} ${description}`.toLowerCase().includes(w) && w.length > 3).slice(0, 2).join('", "')}" appears in content`;
-      linksSuggested.push({ entryId: c.entryId, name: c.name, collection: c.collSlug, reason, preview: c.preview });
-    }
-  }
   if (links && links.length > 0 && finalEntryId) {
+    const slugByPrefix = new Map((await getCollections()).filter((c) => c.idPrefix).map((c) => [c.idPrefix, c.slug]));
     for (const link of links) {
       pendingRelations.push({
         fromEntryId: finalEntryId,
@@ -2199,7 +2082,7 @@ Use \`entries action=get\` to inspect the existing entry, or \`entries action=up
         type: link.type,
         // WP-474 E4-REWIRE: user-chosen type — mark provenance, NO confidence (human-chosen).
         proposedBy: "user",
-        meta: { source: "user", targetName: link.to, targetCollection: "unknown" }
+        meta: { targetName: link.to, targetCollection: slugByPrefix.get(link.to.split("-")[0]) ?? "unknown" }
       });
     }
   }
@@ -2207,18 +2090,17 @@ Use \`entries action=get\` to inspect the existing entry, or \`entries action=up
   const batchRelationsPromise = pendingRelations.length > 0 ? kernelMutation(
     "chain.createEntryRelations",
     {
-      // WP-474 E4-REWIRE: carry provenance + confidence through to the server seam.
+      // WP-474 E4-REWIRE: carry provenance through to the server seam.
       relations: pendingRelations.slice(0, 25).map((r) => ({
         fromEntryId: r.fromEntryId,
         toEntryId: r.toEntryId,
         type: r.type,
-        ...r.proposedBy !== void 0 ? { proposedBy: r.proposedBy } : {},
-        ...r.confidence !== void 0 ? { confidence: r.confidence } : {}
+        ...r.proposedBy !== void 0 ? { proposedBy: r.proposedBy } : {}
       })),
       sessionId: agentId ?? void 0
     }
   ).catch((err) => {
-    entryWarnings.push(`Auto-linking partially failed: ${err instanceof Error ? err.message : "unknown error"}`);
+    entryWarnings.push(`Linking partially failed: ${err instanceof Error ? err.message : "unknown error"}`);
     return null;
   }) : Promise.resolve(null);
   const cardinalityPromise = resolvedCK ? kernelQuery("chain.checkCardinalityWarning", { canonicalKey: resolvedCK, excludeEntryId: internalId }).catch(() => null) : Promise.resolve(null);
@@ -2247,40 +2129,19 @@ Use \`entries action=get\` to inspect the existing entry, or \`entries action=up
       const pending = pendingRelations[i];
       const result2 = batchResult.results[i];
       if (!result2) continue;
-      if (pending.meta.source === "auto") {
-        if (result2.ok) {
-          linksCreated.push({
-            targetEntryId: pending.toEntryId,
-            targetName: pending.meta.targetName,
-            targetCollection: pending.meta.targetCollection,
-            relationType: pending.type,
-            linkReason: pending.meta.linkReason
-          });
-        } else if (result2.status === "advised") {
-          advisedLinks.push({
-            targetName: pending.meta.targetName,
-            targetCollection: pending.meta.targetCollection,
-            relationType: pending.type
-          });
-        }
+      if (result2.ok) {
+        userLinkResults.push({ label: `\u2713 ${pending.type} \u2192 ${pending.toEntryId}`, ok: true });
+        linksCreated.push({
+          targetEntryId: pending.toEntryId,
+          targetName: pending.meta.targetName,
+          targetCollection: pending.meta.targetCollection,
+          relationType: pending.type
+        });
       } else {
-        if (result2.ok) {
-          userLinkResults.push({ label: `\u2713 ${pending.type} \u2192 ${pending.toEntryId}`, ok: true });
-          linksCreated.push({
-            targetEntryId: pending.toEntryId,
-            targetName: pending.meta.targetName,
-            targetCollection: pending.meta.targetCollection,
-            relationType: pending.type
-          });
-        } else {
-          userLinkResults.push({ label: `\u2717 ${pending.type} \u2192 ${pending.toEntryId}: ${result2.error ?? "failed"}`, ok: false });
-        }
+        userLinkResults.push({ label: `\u2717 ${pending.type} \u2192 ${pending.toEntryId}: ${result2.error ?? "failed"}`, ok: false });
       }
     }
   }
-  if (advisedLinks.length > 0) {
-    entryWarnings.push(`${advisedLinks.length} auto-link(s) advised, not written (untypeable) \u2014 accept with \`relations action=create\` to promote.`);
-  }
   const tAfterQuality = Date.now();
   const cardinalityWarning = cardinalityCheck?.warning ?? null;
   if (contradictionWarnings.length > 0) {
@@ -2358,14 +2219,6 @@ Use \`entries action=get\` to inspect the existing entry, or \`entries action=up
     lines.push("");
     lines.push(`**View in Cortex:** ${studioUrl}`);
   }
-  if (linksCreated.length > 0) {
-    lines.push("");
-    lines.push(`## Auto-linked (${linksCreated.length})`);
-    for (const link of linksCreated) {
-      const reason = link.linkReason ? ` \u2014 because ${link.linkReason}` : "";
-      lines.push(`- -> **${link.relationType}** ${link.targetEntryId}: ${link.targetName} [${link.targetCollection}]${reason}`);
-    }
-  }
   if (userLinkResults.length > 0) {
     lines.push("");
     lines.push("## Requested links");
@@ -2384,15 +2237,6 @@ Use \`entries action=get\` to inspect the existing entry, or \`entries action=up
     lines.push(`**${name}** ${spineFloor.exempt ? SPINE_FLOOR_EXEMPT_SENTENCE : SPINE_FLOOR_SENTENCE}`);
     lines.push(`Next: \`entries action=commit entryId="${finalEntryId}"\`.`);
   }
-  if (linksSuggested.length > 0) {
-    lines.push("");
-    lines.push("## Suggested links (review and use `relations action=create`)");
-    for (let i = 0; i < linksSuggested.length; i++) {
-      const s = linksSuggested[i];
-      const preview2 = s.preview ? ` \u2014 ${s.preview}` : "";
-      lines.push(`${i + 1}. **${s.entryId ?? "(no ID)"}**: ${s.name} [${s.collection}]${preview2}`);
-    }
-  }
   if (groundingCaveat) lines.push("", groundingCaveat);
   if (format === "human") {
     const hasDuplicates = groundingReport.duplicates.length > 0;
@@ -6389,7 +6233,6 @@ async function handleUpdate(slug, name, description, purpose, icon, navGroup, fi
   });
   invalidateCollectionCacheForScope();
   invalidateProfileCacheForScope();
-  invalidateHubCacheForScope();
   const changes = [name && "name", description && "description", purpose && "purpose", icon && "icon", navGroup && "navGroup", fields && "fields", meta.axis !== void 0 && "axis", meta.stageLabelMap !== void 0 && "stageLabelMap", meta.defaultCanonicalKey !== void 0 && "defaultCanonicalKey", meta.defaultWorkflowStatus !== void 0 && "defaultWorkflowStatus", meta.validWorkflowStatuses !== void 0 && "validWorkflowStatuses", meta.classificationCheck !== void 0 && "classificationCheck", meta.classificationPriority !== void 0 && "classificationPriority", meta.qualityCriteria !== void 0 && "qualityCriteria", meta.usageGuidance !== void 0 && "usageGuidance", meta.statusList !== void 0 && "statusList"].filter(Boolean).join(", ");
   return {
     content: [{
@@ -13427,8 +13270,8 @@ Tags for filtering (e.g. \`severity:high\`), relations via \`entryRelations\`, v
     `## 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. Auto-links related entries from across the chain (up to 5 confident matches)
-3. Returns a quality scorecard (X/10) with actionable improvement suggestions
+2. Writes the relations you pass in \`links\` \u2014 and no others; use \`relations action=suggest\` then \`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(", ")}.
 All other collections use the \`ENT-{random}\` fallback profile.
@@ -13444,7 +13287,7 @@ 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 (auto-links + quality score 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- **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`"
   );
   return sections.join("\n\n---\n\n");
 }
@@ -14133,4 +13976,4 @@ export {
   createProductBrainServer,
   initFeatureFlags
 };
-//# sourceMappingURL=chunk-USZ2527R.js.map
+//# sourceMappingURL=chunk-X2VLEDPS.js.map