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

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

@@ -43,7 +43,7 @@ import {
   trackQualityVerdict,
   trackSessionCaptureRate,
   trackZeroCaptureAuditFired
-} from "./chunk-J2ZAJCHH.js";
+} from "./chunk-WD2HD54Z.js";
 
 // src/server.ts
 import { McpServer as McpServer2 } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -101,8 +101,8 @@ function notFound(id, hint) {
   return failure(
     "NOT_FOUND",
     `Entry '${id}' not found.`,
-    hint ?? "Use entries action=search to find the correct ID.",
-    [{ tool: "entries", description: "Search entries", parameters: { action: "search", query: id } }]
+    hint ?? "Use context action=search to find the correct ID.",
+    [{ tool: "context", description: "Search entries", parameters: { action: "search", query: id } }]
   );
 }
 function validationError(message) {
@@ -392,7 +392,7 @@ var TOOL_NAME_MIGRATIONS = /* @__PURE__ */ new Map([
   ["list-entries", 'context action="list"'],
   ["get-entry", 'context action="get"'],
   ["batch-get", 'context action="batch"'],
-  ["search", 'entries action="search"'],
+  ["search", 'context action="search"'],
   ["relate-entries", 'relations action="create"'],
   ["batch-relate", 'relations action="batch-create"'],
   ["find-related", 'relations action="find"'],
@@ -639,7 +639,7 @@ ${msg}
       "CAPTURE_OUTCOME_UNKNOWN",
       msg,
       recovery,
-      [{ tool: "entries", description: "Search for the entry before retrying", parameters: { action: "search", query: name } }],
+      [{ tool: "context", description: "Search for the entry before retrying", parameters: { action: "search", query: name } }],
       {
         // Structured so a caller can branch on this without parsing prose — the
         // reconciliation signal TEN-1126 says the capture path never had.
@@ -2001,7 +2001,7 @@ Use \`context 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. Find one with \`entries action=search\` and link it with \`relations action=create\`.`
+      `**Strategy link:** This ${isWorkPackageOrBetCapture ? "work package" : "goal"} doesn't connect to any strategy entry. Consider linking before accepting. Find one with \`context action=search\` and link it with \`relations action=create\`.`
     );
     await recordSessionActivity({ strategyLinkWarnedForEntryId: internalId });
   }
@@ -2025,13 +2025,13 @@ Use \`context 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:** find related entries with \`entries action=search\`, then \`relations action=create from="${eid}" to="<ID>" type="<verb>"\``);
+    lines.push(`1. **Connect it:** find related entries with \`context 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:** find related entries with \`entries action=search\`, then \`relations action=create from="${eid}" to="<ID>" type="<verb>"\``);
+      lines.push(`1. **Connect it:** find related entries with \`context 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) {
@@ -3145,7 +3145,7 @@ ${recovery}`,
       "MOVE_FAILED",
       msg,
       "Check the entry ID and target collection slug, then retry.",
-      [{ tool: "entries", description: "Search for entry", parameters: { action: "search", query: entryId } }]
+      [{ tool: "context", description: "Search for entry", parameters: { action: "search", query: entryId } }]
     );
   }
 }
@@ -3182,7 +3182,6 @@ function platformGlossarySearch(query, collection, status2) {
 // src/tools/entriesContract.ts
 import { z as z10 } from "zod/v3";
 var ENTRIES_ACTIONS = [
-  "search",
   "update",
   "commit",
   "move",
@@ -3190,7 +3189,6 @@ var ENTRIES_ACTIONS = [
   "preflight",
   "still-true"
 ];
-var entriesStatusFilterSchema = z10.union([z10.string().max(200), z10.array(z10.enum(ENTRY_STATUS_READ_WORDS)).max(5)]);
 var coherencyAcknowledgementFlatSchema = z10.object({
   response: z10.enum(["linked", "accepted-fix", "diverged"]).describe("Explicit response to an acknowledge-required coherency challenge."),
   entryId: z10.string().max(200).optional().describe("Authorizing entry being linked/accepted (required for 'linked' and 'accepted-fix')."),
@@ -3200,16 +3198,15 @@ var preflightLinks = z10.array(z10.object({ type: z10.string().max(200), entryId
 var entriesSchema = z10.object({
   links: preflightLinks.describe("For preflight: proposed context links; saves nothing."),
   action: z10.enum(ENTRIES_ACTIONS).describe(
-    "'preflight': inspect structural requirements before composing (requires collection). 'search': full-text search. 'update': change fields on an existing entry (draft by default). 'commit': accept a draft entry onto the Chain. 'move': relocate an entry to a different collection (pass `canonicalKey` too for an atomic move+retype). 'verify': mark an entry as verified (lightweight \u2014 no codebase scan; see `quality action=verify-chain` for that). 'still-true': confirm accuracy (the holder of the owning role, else the nearest seated Team Lead) \u2014 distinct from 'verify'; no content, version, or updatedAt change."
+    "'preflight': inspect structural requirements before composing (requires collection). 'update': change fields on an existing entry (draft by default). 'commit': accept a draft entry onto the Chain. 'move': relocate an entry to a different collection (pass `canonicalKey` too for an atomic move+retype). 'verify': mark an entry as verified (lightweight \u2014 no codebase scan; see `quality action=verify-chain` for that). 'still-true': confirm accuracy (the holder of the owning role, else the nearest seated Team Lead) \u2014 distinct from 'verify'; no content, version, or updatedAt change."
   ),
   entryId: z10.string().max(200).optional().describe(
     "Entry ID, e.g. '<PREFIX>-<n>'. Required for: update, commit, move, verify, still-true."
   ),
-  collection: z10.string().max(200).optional().describe("Collection slug \u2014 for 'search': scope filter, e.g. 'glossary', 'tracking-events'. For 'preflight': the collection the entry would be composed into (required)."),
-  status: entriesStatusFilterSchema.optional().describe(
-    `For 'search': one lifecycle or category value (${ENTRY_STATUS_READ_WORDS.join("|")}) OR an array of up to 5 (e.g. ['active','accepted']). For 'update': draft|archived ONLY \u2014 'accepted' is set via 'commit', never 'update'; 'active'/'deprecated' are legacy read-only words, refused on write. Workflow values use \`workflowStatus\` instead.`
+  collection: z10.string().max(200).optional().describe("For 'preflight': the collection slug the entry would be composed into (required)."),
+  status: z10.string().max(200).optional().describe(
+    "For 'update': draft|archived ONLY \u2014 'accepted' is set via 'commit', never 'update'; 'active'/'deprecated' are legacy read-only words, refused on write. Workflow values use `workflowStatus` instead."
   ),
-  query: z10.string().min(2).max(500).optional().describe("For 'search': search text (min 2 characters)."),
   name: z10.string().max(ENTRY_NAME_MAX_CHARS).optional().describe("For 'update': new display name."),
   workflowStatus: z10.string().max(200).optional().describe(
     "For 'update': collection workflow state. Valid values are collection-specific and server-owned \u2014 discover via `collections action=describe`. Invalid values are rejected with the valid set."
@@ -3246,13 +3243,6 @@ var entriesSchema = z10.object({
   ),
   toCollection: z10.string().max(200).optional().describe("For 'move': target collection slug, e.g. 'decisions', 'architecture'.")
 });
-var entriesSearchVariant = z10.object({
-  action: z10.literal("search"),
-  query: z10.string().min(2).max(500),
-  collection: z10.string().max(200).optional(),
-  status: entriesStatusFilterSchema.optional()
-  // PR #660 R1 Zqh1K: string|array.
-});
 var entriesUpdateVariant = updateEntrySchema.extend({ action: z10.literal("update") });
 var entriesCommitVariant = commitEntrySchema.extend({ action: z10.literal("commit") });
 var entriesMoveVariant = z10.object({
@@ -3266,7 +3256,6 @@ var entriesVerifyVariant = verifyEntrySchema.extend({ action: z10.literal("verif
 var entriesStillTrueVariant = stillTrueEntrySchema.extend({ action: z10.literal("still-true") });
 var entriesActionUnion = z10.discriminatedUnion("action", [
   z10.object({ action: z10.literal("preflight"), collection: z10.string().max(200), canonicalKey: z10.string().max(200).optional(), links: preflightLinks }),
-  entriesSearchVariant,
   entriesUpdateVariant,
   entriesCommitVariant,
   entriesMoveVariant,
@@ -3275,7 +3264,6 @@ var entriesActionUnion = z10.discriminatedUnion("action", [
 ]);
 var ENTRIES_ACTION_SPECS = {
   preflight: { params: ["collection", "canonicalKey", "links"], description: "Inspect structure before composition; no writes or permission grant." },
-  search: { params: ["query", "collection", "status"], description: "Full-text search; query is required (min 2 chars)." },
   update: { params: ["entryId", "name", "status", "workflowStatus", "data", "order", "canonicalKey", "autoPublish", "changeNote", "changeReason", "sourceRef", "sourceExcerpt", "steeringOverrideReason", "coherencyAcknowledgement"], description: "entryId is required; every other field is optional." },
   commit: { params: ["entryId", "preview", "steeringOverrideReason", "coherencyAcknowledgement"], description: "entryId is required." },
   move: { params: ["entryId", "toCollection", "canonicalKey"], description: "entryId and toCollection are required; canonicalKey is optional (atomic move+retype)." },
@@ -3429,7 +3417,6 @@ function registerEntriesTools(server) {
       const result2 = await kernelQuery("chain.preflightEntry", { collectionSlug: data.collection, canonicalKey: data.canonicalKey, links: data.links });
       return { content: [{ type: "text", text: renderEntryPreflight(result2).join("\n") }], structuredContent: success("Structural requirements checked; nothing saved.", result2) };
     },
-    search: (data) => handleSearch(server, data.query, data.collection, data.status),
     // update/commit reuse knowledge.ts's extracted handlers — "entries" routes
     // `next` at itself (toolName="entries") instead of the legacy tool names.
     update: (data) => handleUpdateEntry(data, "entries"),
@@ -3442,10 +3429,10 @@ function registerEntriesTools(server) {
     "entries",
     {
       title: "Entries",
-      description: 'Read and manage entries on the Chain. One tool for the entry lifecycle.\n\n- **preflight**: Inspect a type and selected context before composing. No writes, capacity reservation or authority grant.\n- **search**: Full-text search across entries. Scope by collection or filter by status.\n- **update**: Change fields on an existing entry (publishes whenever the entry is not draft \u2014 includes archived, not just accepted/active; autoPublish is accepted but ignored).\n- **commit**: Accept a draft entry onto the Chain (SSOT). Runs the contradiction preflight first.\n- **move**: Relocate an entry to a different collection; pass canonicalKey too for an atomic move+retype.\n- **verify**: Mark verified (lightweight, no scan \u2014 see `quality action=verify-chain`).\n- **still-true**: confirm accuracy (the holder of the owning role; if that role is empty, the nearest seated Team Lead up the team tree).\n\nOpen, list and trace entries with the read-only `context` tool: `context action=get entryId="..."`. Use `entries action=search query="..."` to discover.',
+      description: 'Write entries on the Chain: the entry lifecycle after capture. Reads live on `context`.\n\n- **preflight**: Inspect a type and selected context before composing. No writes, capacity reservation or authority grant.\n- **update**: Change fields on an existing entry (publishes whenever the entry is not draft \u2014 includes archived, not just accepted/active; autoPublish is accepted but ignored).\n- **commit**: Accept a draft entry onto the Chain (SSOT). Runs the contradiction preflight first.\n- **move**: Relocate an entry to a different collection; pass canonicalKey too for an atomic move+retype.\n- **verify**: Mark verified (lightweight, no scan \u2014 see `quality action=verify-chain`).\n- **still-true**: confirm accuracy (the holder of the owning role; if that role is empty, the nearest seated Team Lead up the team tree).\n\nRead entries with the read-only `context` tool: `context action=get entryId="..."`, `context action=search query="..."`.',
       inputSchema: entriesSchema,
-      // Mixed read/write noun (§3 R3): can't be marked read-only once update/commit/move
-      // live here too — accepted for the 11-tool default (§9 R3).
+      // DEC-1894 / DEC-74: every look-up lives on the read-only `context` tool, so this
+      // annotation tells hosts the truth about the writes left here.
       annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false }
     },
     thinWrapper(async (args) => {
@@ -3728,9 +3715,9 @@ async function handleSearch(server, query, collection, status2) {
   const platform = platformGlossarySearch(query, collection, status2);
   const matches = results.length + platform.count;
   if (matches === 0) {
-    const recorded = recordGap({ query, tool: "entries", action: "search", gapType: "search_zero", collectionScope: collection });
+    const recorded = recordGap({ query, tool: "context", action: "search", gapType: "search_zero", collectionScope: collection });
     if (recorded) {
-      getWorkspaceId().then((wsId) => trackKnowledgeGap(wsId, { query, tool: "entries", action: "search", gap_type: "search_zero", collection_scope: collection })).catch(() => {
+      getWorkspaceId().then((wsId) => trackKnowledgeGap(wsId, { query, tool: "context", action: "search", gap_type: "search_zero", collection_scope: collection })).catch(() => {
       });
     }
     return {
@@ -3742,7 +3729,7 @@ async function handleSearch(server, query, collection, status2) {
         `'${query}' is not yet on the Chain${scope}.`,
         { entries: [], total: 0, query },
         [
-          { tool: "entries", description: "Try a broader search", parameters: { action: "search", query: query.split(" ")[0] } },
+          { tool: "context", description: "Try a broader search", parameters: { action: "search", query: query.split(" ")[0] } },
           { tool: "collections", description: "Browse available collections", parameters: { action: "list" } }
         ]
       )
@@ -3842,7 +3829,7 @@ async function handleFind(entryId, direction) {
   }
   const sourceEntry = await kernelQuery("chain.getEntry", { entryId });
   if (!sourceEntry) {
-    return notFoundResult(entryId, `Entry '${entryId}' not found. Try entries action=search to find the right ID.`);
+    return notFoundResult(entryId, `Entry '${entryId}' not found. Try context action=search to find the right ID.`);
   }
   const sourceInternalId = sourceEntry._id;
   const MAX_RELATIONS = 25;
@@ -3989,7 +3976,7 @@ function registerRelationsTools(server) {
     "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 entries action=search).",
+      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).",
       inputSchema: relationsSchema,
       // Mixed read/write noun (§3 R3): find is read-only, create/batch-create/delete write.
       annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false }
@@ -4273,14 +4260,16 @@ This row pre-dates snapshot capture (legacy backfill), so no summary is availabl
 
 // src/tools/contextLookups.ts
 import { z as z15 } from "zod/v3";
-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). ";
-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";
+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 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': collection slug, e.g. 'glossary', 'tracking-events'."),
+  collection: z15.string().max(200).optional().describe("For 'list'/'search': collection slug, e.g. 'glossary', 'tracking-events'."),
+  query: z15.string().min(2).max(500).optional().describe("For 'search': search text (min 2 characters)."),
   // 'active'/'accepted'/'current' are the same trust level (DEC-1575/DEC-1788) — all enumerated, never one substituted.
-  status: z15.string().max(200).optional().describe(
-    `For 'list': defaults to accepted entries (active/accepted/current); use status='draft' to discover drafts. One lifecycle or category value (${ENTRY_STATUS_READ_WORDS.join("|")}).`
+  status: statusFilterSchema.optional().describe(
+    `For 'list': defaults to accepted entries (active/accepted/current); use status='draft' to discover drafts. One lifecycle or category value (${ENTRY_STATUS_READ_WORDS.join("|")}). For 'search': one value OR an array of up to 5 (e.g. ['active','accepted']).`
   ),
   tag: z15.string().max(200).optional().describe("For 'list': filter by internal tag."),
   label: z15.string().max(200).optional().describe("For 'list': filter by label slug \u2014 matches entries across all collections.")
@@ -4293,23 +4282,34 @@ var lookupVariants = [
     action: z15.literal("list"),
     collection: z15.string().max(200).optional(),
     status: z15.string().max(200).optional(),
-    // one status word: the flat schema advertises exactly this
+    // one status word; the flat union serves search
     tag: z15.string().max(200).optional(),
     label: z15.string().max(200).optional()
+  }),
+  z15.object({
+    action: z15.literal("search"),
+    query: z15.string().min(2).max(500),
+    collection: z15.string().max(200).optional(),
+    status: statusFilterSchema.optional()
   })
 ];
 var LOOKUP_ACTION_SPECS = {
   get: { params: ["entryId"], description: "entryId is required." },
   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. All params optional." }
-};
-var lookupHandlers = {
-  get: (data) => handleGet(data.entryId),
-  batch: (data) => handleBatch(data.entryIds),
-  history: (data) => handleGetHistory(data),
-  list: (data) => handleList(data.collection, data.status, data.tag, data.label)
+  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)." }
 };
+function lookupHandlers(server) {
+  return {
+    get: (data) => handleGet(data.entryId),
+    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)
+    // logs progress to the client
+  };
+}
 
 // src/tools/context.ts
 function annotateStaleNames(text) {
@@ -4322,7 +4322,7 @@ function epistemicCollectionHint(collectionName) {
   if (lc === "assumptions") return " \u2014 _check evidence strength with `context action=get`_";
   return "";
 }
-var CONTEXT_ACTIONS = ["get", "batch", "history", "list", "gather", "build", "neighborhood", "changes", "chain", "cross-cut", "incremental", "brief", "last-verified-brief"];
+var CONTEXT_ACTIONS = ["get", "batch", "history", "list", "search", "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(
@@ -4432,7 +4432,7 @@ var CONTEXT_ACTION_SPECS = {
 };
 function registerContextTools(server) {
   const contextHandlers = {
-    ...lookupHandlers,
+    ...lookupHandlers(server),
     gather: (data) => data.mapEntryId ? handleJourneyGather(server, data.mapEntryId, data.maxHops ?? 2, data.maxResults ?? 20) : handleGather(server, data.entryId, data.task, data.mode ?? "search", data.maxHops ?? 2, data.maxResults ?? 10, data.strategy ?? "keyword"),
     build: (data) => handleBuild(server, data.entryId, data.maxHops ?? 2),
     neighborhood: (data) => handleNeighborhood(data.entryId),
@@ -4600,7 +4600,7 @@ _This helps future sessions start with better constraints and context._`
           "NOT_FOUND",
           "No task-relevant governance or supporting context was found yet.",
           "If you discover relevant knowledge during this task, capture it with a name and description.",
-          [{ tool: "entries", description: "Search for related terms", parameters: { action: "search", query: task.split(" ").slice(0, 3).join(" ") } }]
+          [{ tool: "context", description: "Search for related terms", parameters: { action: "search", query: task.split(" ").slice(0, 3).join(" ") } }]
         )
       };
     }
@@ -6567,7 +6567,7 @@ function buildTaskAlignmentLines(ta) {
   return lines;
 }
 var CORE_PROTOCOL_BASE = [
-  '**Search before proposing.** Before suggesting new features, architecture, or changes, search the Chain: `entries action=search query="<relevant terms>"`. Build on what exists.',
+  '**Search before proposing.** Before suggesting new features, architecture, or changes, search the Chain: `context action=search query="<relevant terms>"`. Build on what exists.',
   "**Reference by ID.** When discussing a topic that has Chain entries, cite them by entry ID (e.g. `DEC-50`, `PRI-3`). This keeps conversations grounded in shared knowledge.",
   "**Check scope.** If the proposed work doesn't fall under an active work package, stop and say so. Do not design implementation for out-of-scope work without explicit user go-ahead.",
   `**Capture continuously.** When a decision, tension, insight, or new term surfaces during work, capture it as a draft immediately. Don't defer to "later."`
@@ -6798,7 +6798,7 @@ var WORKING_WITH_PEOPLE_LINES = [
 var TITLES_LINE = "These are titles: read an entry in full before you explain or judge it.";
 var BRIEFING_PULL_COMMANDS = {
   cli: 'pb orient --task "<what you are doing>" \xB7 pb get <ID> \xB7 pb search <query>',
-  mcp: 'orient task="<what you are doing>" \xB7 context action=get entryId=<ID> \xB7 entries action=search query=<query>'
+  mcp: 'orient task="<what you are doing>" \xB7 context action=get entryId=<ID> \xB7 context action=search query=<query>'
 };
 var BRIEFING_ANSWER_COMMANDS = {
   cli: 'pb question answer <ID> "<answer>"',
@@ -8481,7 +8481,7 @@ Use \`workflows action=checkpoint\` after each round to persist progress to the
       label: "Gather Context",
       type: "open",
       instruction: "Before shaping, let's see what the Chain already knows. Search for related entries, business rules, and existing decisions.",
-      facilitatorGuidance: "**Investigate proactively.** Spawn sub-agents in parallel: (1) `explore` agent to search the codebase for code related to the work package topic \u2014 find modules, patterns, and pain points. (2) `generalPurpose` agent to search the Chain: call `orient`, use `entries action=search` with keywords, surface related tensions, active work packages, and applicable business rules. Synthesize both into a 3-5 line context brief: what the codebase reveals, what the Chain knows, what governance applies. Present with IDs and file paths. Build a system map: what modules, data flows, and contracts exist in this area today? Check governance: do any principles, standards, or business rules constrain this design space? Then transition: 'Here's what I found. Does this match the problem you're seeing?'",
+      facilitatorGuidance: "**Investigate proactively.** Spawn sub-agents in parallel: (1) `explore` agent to search the codebase for code related to the work package topic \u2014 find modules, patterns, and pain points. (2) `generalPurpose` agent to search the Chain: call `orient`, use `context action=search` with keywords, surface related tensions, active work packages, and applicable business rules. Synthesize both into a 3-5 line context brief: what the codebase reveals, what the Chain knows, what governance applies. Present with IDs and file paths. Build a system map: what modules, data flows, and contracts exist in this area today? Check governance: do any principles, standards, or business rules constrain this design space? Then transition: 'Here's what I found. Does this match the problem you're seeing?'",
       outputSchema: {
         field: "context",
         description: "System map, Chain context, governance constraints, related entries",
@@ -8669,7 +8669,7 @@ var IMPLEMENTATION_REVIEW_WORKFLOW_DESCRIPTOR = {
 1. **Tool-heavy, not chat-heavy.** Each round calls specific tools: orient, quality, verify, context action=gather, review-against-rules. Use Context7 **CLI** (\`npx ctx7 library\` then \`npx ctx7 docs\` \u2014 project-local after \`npm install\`; avoid cold \`npx ctx7@latest\` in short-timeout shells) for relevant testing and framework docs \u2014 not for Chain truth. Do not use Context7 MCP.
 2. **Spawn sub-agents** for parallel review: (a) code/architecture review, (b) test honesty (did we edit tests to pass or do they validate real behavior?). Max 2 agents in parallel, 30s budget each. **Constrain each sub-agent to the stated review scope only.**
 3. **Fix-as-you-go (FEAT-172).** When you find a HIGH or MEDIUM issue: fix it immediately, verify (lints, types), then proceed. The user sees clean work, not a list of issues. Only defer if estimated >5 min \u2014 capture deferred items as tensions. If user says "skip", capture as tension and continue.
-4. **Chain is SSOT.** Call orient or start first. Use entries action=search and context action=gather to load relevant BETs, DECs, BRs. If findings conflict with Chain entries, report the conflict and cite the entry ID.
+4. **Chain is SSOT.** Call orient or start first. Use context action=search and context action=gather to load relevant BETs, DECs, BRs. If findings conflict with Chain entries, report the conflict and cite the entry ID.
 5. **One round at a time.** Complete each round before moving to the next. Checkpoint progress.
 6. **Extract learnings (FEAT-174).** After fixing issues, ask: is this a recurring pattern? Offer to capture structural patterns as standards or business rules so future reviews check automatically.
 7. **CRITICAL: End with BET/chain IDs.** The final output MUST include a single sentence: "BET/feature IDs reviewed: [IDs]. [One-line summary of findings]."
@@ -8839,7 +8839,7 @@ var PROCESS_CHANGE_WORKFLOW_DESCRIPTOR = {
 ## Tool Usage
 
 - \`orient\` \u2014 load workspace context (governance, active work packages, stale entries)
-- \`entries action=search\` \u2014 find related entries
+- \`context action=search\` \u2014 find related entries
 - \`capture\` \u2014 manual fallback only if workflow finalization cannot safely route the entry
 - \`relations action=create\` or \`relations action=batch-create\` \u2014 link to related entries
 - \`entries action=commit\` \u2014 promote to SSOT (only on user confirmation)
@@ -8858,7 +8858,7 @@ var PROCESS_CHANGE_WORKFLOW_DESCRIPTOR = {
       label: "Quick Context",
       type: "open",
       instruction: "What are you working on? Orient to load relevant Chain context.",
-      facilitatorGuidance: "Call orient to get workspace context. Ask what the user is changing \u2014 or infer from their initial message. Search the Chain for related entries: entries action=search with keywords from their description. Present only the 2-3 most relevant entries, not a full briefing. If the user already described the change, skip the question and confirm what you understood.",
+      facilitatorGuidance: "Call orient to get workspace context. Ask what the user is changing \u2014 or infer from their initial message. Search the Chain for related entries: context action=search with keywords from their description. Present only the 2-3 most relevant entries, not a full briefing. If the user already described the change, skip the question and confirm what you understood.",
       outputSchema: {
         field: "context",
         description: "What's being changed and relevant Chain context",
@@ -8886,7 +8886,7 @@ var PROCESS_CHANGE_WORKFLOW_DESCRIPTOR = {
       label: "Impact & Links",
       type: "synthesis",
       instruction: "What's affected? Are there existing Chain entries that relate to this change?",
-      facilitatorGuidance: "Search the Chain for entries that should be linked: entries action=search with keywords from the change. Check: does this change affect an active work package? Does it resolve a known tension? Does it supersede an existing decision? If the change is small and self-contained, this round can be brief \u2014 just confirm there's nothing obvious to link. If there are stale entries that this change invalidates, flag them for reconfirmation.",
+      facilitatorGuidance: "Search the Chain for entries that should be linked: context action=search with keywords from the change. Check: does this change affect an active work package? Does it resolve a known tension? Does it supersede an existing decision? If the change is small and self-contained, this round can be brief \u2014 just confirm there's nothing obvious to link. If there are stale entries that this change invalidates, flag them for reconfirmation.",
       outputSchema: {
         field: "impact",
         description: "Affected entries and proposed links",
@@ -10132,8 +10132,8 @@ async function handleReEvaluate(entryId, context) {
       `Entry '${entryId}' not found or has no rubric.`,
       "NOT_FOUND",
       `Entry '${entryId}' not found or has no rubric.`,
-      "Use entries action=search to find the correct ID.",
-      [{ tool: "entries", description: "Search entries", parameters: { action: "search", query: entryId } }]
+      "Use context action=search to find the correct ID.",
+      [{ tool: "context", description: "Search entries", parameters: { action: "search", query: entryId } }]
     );
   }
   const llmScheduled = result2.verdict.tier !== "passive";
@@ -12769,9 +12769,9 @@ 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\` | Find and write entries | \`action\`: search, update, commit, move, verify, preflight, still-true |
+| \`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, gather, build, neighborhood, changes, chain, cross-cut, incremental, brief, last-verified-brief |
+| \`context\` | Reads; only incremental writes | \`action\`: get, batch, history, list, search, 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 |
@@ -12846,7 +12846,7 @@ Tags for filtering (e.g. \`severity:high\`), relations via \`entryRelations\`, v
     );
   }
   sections.push(
-    '## 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: `entries action=search query="<noun>"`.\nDraft a new rule: use the `draft-rule-from-context` prompt.'
+    '## 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`."
@@ -13445,7 +13445,7 @@ var INSTRUCTIONS = [
   "",
   '- `orient action=task task="<what you are doing>"`: context shaped to the task, with the rules for your team and role.',
   '- `context action=get entryId="<ID>"`: one entry in full, with data, relations and history.',
-  '- `entries action=search query="<noun>"`: find entries by what they are about.',
+  '- `context action=search query="<noun>"`: find entries by what they are about.',
   "",
   "## Writing",
   "",
@@ -13552,4 +13552,4 @@ export {
   createProductBrainServer,
   initFeatureFlags
 };
-//# sourceMappingURL=chunk-QJ6KOXG6.js.map
+//# sourceMappingURL=chunk-O6HEYDXJ.js.map