@vpxa/kb 0.1.13 → 0.1.15

package/packages/server/dist/tools/audit.tool.js

@@ -1,4 +1,2 @@
-import{audit as c}from"../../../tools/dist/index.js";import{z as t}from"zod";function l(s,o,n){s.registerTool("audit",{description:"Run a unified audit: structure, dependencies, patterns, health, dead_symbols, check, entry_points. Returns synthesized report with score, recommendations, and next steps. 6 round-trips \u2192 1.",inputSchema:{path:t.string().default(".").describe("Root path to audit"),checks:t.array(t.enum(["structure","dependencies","patterns","health","dead_symbols","check","entry_points"])).optional().describe("Which checks to run (default: all)"),detail:t.enum(["summary","full"]).default("summary").describe("'summary' for overview (~500 tokens), 'full' includes pattern table")}},async({path:i,checks:d,detail:a})=>{try{const e=await c(o,n,{path:i,checks:d,detail:a});return{content:[{type:"text",text:e.ok?`${e.summary}
-
----
-_Audit score: ${e.data?.score}/100 | ${e.meta.durationMs}ms${e.next&&e.next.length>0?` | Next: ${e.next.map(r=>`\`${r.tool}\` (${r.reason})`).join(", ")}`:""}_`:e.error?.message??"Audit failed"}],isError:!e.ok}}catch(e){return{content:[{type:"text",text:`Audit failed: ${e.message}`}],isError:!0}}})}export{l as registerAuditTool};
+import{createLogger as e,serializeError as t}from"../../../core/dist/index.js";import{audit as n}from"../../../tools/dist/index.js";import{z as r}from"zod";const i=e(`tools`);function a(e,a,o){e.registerTool(`audit`,{description:`Run a unified audit: structure, dependencies, patterns, health, dead_symbols, check, entry_points. Returns synthesized report with score, recommendations, and next steps. 6 round-trips → 1.`,inputSchema:{path:r.string().default(`.`).describe(`Root path to audit`),checks:r.array(r.enum([`structure`,`dependencies`,`patterns`,`health`,`dead_symbols`,`check`,`entry_points`])).optional().describe(`Which checks to run (default: all)`),detail:r.enum([`summary`,`full`]).default(`summary`).describe(`'summary' for overview (~500 tokens), 'full' includes pattern table`)}},async({path:e,checks:r,detail:s})=>{try{let t=await n(a,o,{path:e,checks:r,detail:s});return{content:[{type:`text`,text:t.ok?`${t.summary}\n\n---\n_Audit score: ${t.data?.score}/100 | ${t.meta.durationMs}ms${t.next&&t.next.length>0?` | Next: ${t.next.map(e=>`\`${e.tool}\` (${e.reason})`).join(`, `)}`:``}_`:t.error?.message??`Audit failed`}],isError:!t.ok}}catch(e){return i.error(`Audit failed`,t(e)),{content:[{type:`text`,text:`Audit failed. Check server logs for details.`}],isError:!0}}})}export{a as registerAuditTool};
+//# sourceMappingURL=audit.tool.js.map

package/packages/server/dist/tools/bridge.tools.d.ts

@@ -0,0 +1,35 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ERBridgeConfig, ERCache, ERClient, EvolutionCollector, PushAdapter } from "@kb/enterprise-bridge";
+
+//#region packages/server/src/tools/bridge.tools.d.ts
+/** Resolve ER bridge config from KBConfig.er + env */
+declare function resolveErBridgeConfig(erConfig?: {
+  enabled: boolean;
+  baseUrl: string;
+  timeoutMs?: number;
+  cacheTtlMs?: number;
+  cacheMaxEntries?: number;
+  fallbackThreshold?: number;
+}): ERBridgeConfig | undefined;
+/** Shared bridge components (initialized once, reused across tools) */
+interface BridgeComponents {
+  client: ERClient;
+  cache: ERCache;
+  pushAdapter: PushAdapter;
+  config: ERBridgeConfig;
+}
+/** Initialize bridge components from config. Returns undefined if ER disabled or init fails. */
+declare function initBridgeComponents(erConfig?: {
+  enabled: boolean;
+  baseUrl: string;
+  timeoutMs?: number;
+  cacheTtlMs?: number;
+  cacheMaxEntries?: number;
+  fallbackThreshold?: number;
+}): BridgeComponents | undefined;
+declare function registerErPushTool(server: McpServer, bridge: BridgeComponents, evolutionCollector?: EvolutionCollector): void;
+declare function registerErPullTool(server: McpServer, bridge: BridgeComponents): void;
+declare function registerErSyncStatusTool(server: McpServer, bridge: BridgeComponents): void;
+//#endregion
+export { BridgeComponents, initBridgeComponents, registerErPullTool, registerErPushTool, registerErSyncStatusTool, resolveErBridgeConfig };
+//# sourceMappingURL=bridge.tools.d.ts.map

package/packages/server/dist/tools/bridge.tools.js

@@ -0,0 +1,16 @@
+import{createLogger as e,serializeError as t}from"../../../core/dist/index.js";import{z as n}from"zod";import{ERCache as r,ERClient as i,PushAdapter as a}from"../../../enterprise-bridge/dist/index.js";const o=e(`tools`);function s(e){if(!e?.enabled)return;let t=process.env.KB_ER_API_KEY;if(!t){o.warn(`ER bridge enabled but KB_ER_API_KEY not set; disabling`);return}return{enabled:!0,baseUrl:e.baseUrl,apiKey:t,timeoutMs:e.timeoutMs??5e3,cacheTtlMs:e.cacheTtlMs??360*60*1e3,cacheMaxEntries:e.cacheMaxEntries??100,fallbackThreshold:e.fallbackThreshold??.45}}function c(e){let n=s(e);if(n)try{let e=new i(n),t=new r({maxEntries:n.cacheMaxEntries,defaultTtl:n.cacheTtlMs}),s=new a(e);try{let e=new URL(n.baseUrl).hostname;o.info(`ER bridge initialized`,{host:e})}catch{o.info(`ER bridge initialized`)}return{client:e,cache:t,pushAdapter:s,config:n}}catch(e){o.warn(`ER bridge initialization failed`,t(e));return}}function l(e,r,i){e.registerTool(`er_push`,{description:`Push a curated knowledge entry to Enterprise RAG. The entry is stored via ER's curated_remember tool and becomes immediately searchable in the enterprise knowledge base.`,inputSchema:{title:n.string().min(3).max(120).describe(`Title for the knowledge entry`),content:n.string().min(10).max(1e5).describe(`Markdown content to push (max 100KB)`),category:n.string().regex(/^[a-z][a-z0-9-]*$/).default(`conventions`).describe(`Category slug (e.g., "decisions", "patterns", "conventions")`),tags:n.array(n.string()).default([]).describe(`Optional tags`),rule_id:n.string().optional().describe(`ID of the classification rule that motivated this push (from remember classification signals). Improves rule effectiveness tracking.`)}},async({title:e,content:n,category:a,tags:s,rule_id:c})=>{try{let t=`${a}/${e.toLowerCase().replace(/[^a-z0-9]+/g,`-`)}`,o=await r.pushAdapter.push(t,{title:e,content:n,category:a,tags:s});return o.pushed?(i&&i.recordPush(t,o.pushed,c),{content:[{type:`text`,text:`Pushed to ER: **${e}**\n\nRemote path: \`${o.remotePath??`unknown`}\`\nTimestamp: ${o.timestamp}\n\n---\n_Next: Use \`er_pull\` to verify the entry is searchable in ER, or \`er_sync_status\` to see push history._`}]}):(i&&i.recordPush(t,!1,c),{content:[{type:`text`,text:`ER push failed: ${o.error??`Unknown error`}\n\n_The local KB is unaffected. You can retry or check ER health with \`er_sync_status\`._`}],isError:!0})}catch(n){if(o.error(`ER push failed`,t(n)),i){let t=`${a}/${e.toLowerCase().replace(/[^a-z0-9]+/g,`-`)}`;i.recordPush(t,!1,c)}return{content:[{type:`text`,text:`ER push failed: operation unsuccessful
+
+_The local KB is unaffected. You can retry or check ER health with \`er_sync_status\`._`}],isError:!0}}})}function u(e,r){e.registerTool(`er_pull`,{description:`Explicitly search the Enterprise RAG knowledge base. Returns results from the enterprise system only (not local KB). Uses a cache with 6-hour TTL to reduce API calls.`,inputSchema:{query:n.string().min(1).max(2e3).describe(`Search query for ER knowledge base (max 2000 chars)`),max_results:n.number().min(1).max(20).default(5).describe(`Maximum results to return`),bypass_cache:n.boolean().default(!0).describe(`Skip cache and fetch fresh results from ER (default: true per DR-001)`)}},async({query:e,max_results:n,bypass_cache:i})=>{try{if(!i){let t=r.cache.get(e);if(t)return{content:[{type:`text`,text:`${t.slice(0,n).map((e,t)=>`### Result ${t+1} (score: ${e.score.toFixed(3)}, source: ER cached)\n- **Source**: ${e.sourcePath}\n\n${e.content}`).join(`
+
+---
+
+`)}\n\n---\n_Source: ER cache (${t.length} cached results) | Use \`bypass_cache: true\` for fresh results_`}]}}let t=await r.client.pull(e,n);return t.length>0&&r.cache.set(e,t),t.length===0?{content:[{type:`text`,text:`No results found in Enterprise RAG for the given query.`}]}:{content:[{type:`text`,text:`${t.map((e,t)=>`### Result ${t+1} (score: ${e.score.toFixed(3)}, source: ER)\n- **Source**: ${e.sourcePath}\n\n${e.content}`).join(`
+
+---
+
+`)}\n\n---\n_Source: Enterprise RAG (${t.length} results) | Results cached for ${Math.floor(r.config.cacheTtlMs/36e5)}h_`}]}}catch(e){return o.error(`ER pull failed`,t(e)),{content:[{type:`text`,text:`ER pull failed: search request unsuccessful
+
+_Enterprise RAG may be unavailable. Local KB search is unaffected._`}],isError:!0}}})}function d(e,r){e.registerTool(`er_sync_status`,{description:`Show the status of the Enterprise RAG bridge: health, cache stats, and push history.`,inputSchema:{check_health:n.boolean().default(!0).describe(`Whether to ping ER health endpoint (adds latency)`)}},async({check_health:e})=>{try{let t=r.cache.stats(),n=r.pushAdapter.getStatus(),i=new URL(r.config.baseUrl),a=`${i.protocol}//${i.hostname}${i.port?`:${i.port}`:``}`,o=`_Health check skipped_`;if(e){let e=await r.client.health();o=e.healthy?`✅ Healthy (HTTP ${e.status})`:`❌ Unhealthy${e.status?` (HTTP ${e.status})`:``}`}let s=[`## ER Bridge Status
+`,`**Endpoint**: \`${a}\``,`**Health**: ${o}`,`**Threshold**: ${r.config.fallbackThreshold} (vector similarity for auto-fallback)`,``,`### Cache`,`- Entries: ${t.size} / ${t.maxEntries}`,`- TTL: ${Math.floor(t.defaultTtlMs/36e5)}h`,``,`### Push History`,`- Total pushed: ${n.totalPushed}`,`- Successful: ${n.successCount}`,`- Failed: ${n.failCount}`];return n.lastPush&&s.push(`- Last push: "${n.lastPush.title}" at ${n.lastPush.pushedAt} (${n.lastPush.status})`),s.push("\n---\n_Next: Use `er_push` to send knowledge to ER, or `er_pull` to search ER._"),{content:[{type:`text`,text:s.join(`
+`)}]}}catch(e){return o.error(`ER sync status failed`,t(e)),{content:[{type:`text`,text:`ER sync status failed. Check server logs for details.`}],isError:!0}}})}export{c as initBridgeComponents,u as registerErPullTool,l as registerErPushTool,d as registerErSyncStatusTool,s as resolveErBridgeConfig};
+//# sourceMappingURL=bridge.tools.js.map

package/packages/server/dist/tools/evolution.tools.d.ts

@@ -0,0 +1,8 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { EvolutionCollector } from "@kb/enterprise-bridge";
+
+//#region packages/server/src/tools/evolution.tools.d.ts
+declare function registerErEvolveReviewTool(server: McpServer, collector: EvolutionCollector): void;
+//#endregion
+export { registerErEvolveReviewTool };
+//# sourceMappingURL=evolution.tools.d.ts.map

package/packages/server/dist/tools/evolution.tools.js

@@ -0,0 +1,6 @@
+import{createLogger as e,serializeError as t}from"../../../core/dist/index.js";import{z as n}from"zod";const r=e(`tools`);function i(e,i){e.registerTool(`er_evolve_review`,{description:`Review evolution metrics for the KB ↔ ER bridge. Shows local miss rates, push acceptance, rule effectiveness, and top missed queries. Use this to reason about improving classification rules and knowledge flow.`,inputSchema:{include_details:n.boolean().default(!0).describe(`Include detailed breakdowns (top missed queries, rule stats)`),reset_after:n.boolean().default(!1).describe(`Reset collected metrics after review`)}},async({include_details:e,reset_after:n})=>{try{let t=i.getMetrics(),a=[`## ER Evolution Review
+`,`**Period**: ${t.period.startedAt} → ${t.period.queriedAt}`,`**Total events**: ${t.period.totalEvents}\n`,`### Search`,`- Total searches: ${t.search.totalSearches}`,`- ER fallback triggered: ${t.search.erFallbackCount} (${(t.search.erFallbackRate*100).toFixed(1)}%)`,`- ER cache hits: ${t.search.erCacheHitCount} (${(t.search.erCacheHitRate*100).toFixed(1)}% of fallbacks)`];if(e&&t.search.topMissedQueries.length>0){a.push(`
+**Top missed queries** (triggered ER fallback):`);for(let e of t.search.topMissedQueries.slice(0,10)){let t=e.query.length>60?`${e.query.slice(0,57)}...`:e.query;a.push(`  - "${t}" (${e.count}x)`)}}if(a.push(``,`### Push`,`- Total pushes: ${t.push.totalPushes} (${t.push.successCount} ok, ${t.push.failCount} failed)`,`- Classification match rate: ${(t.push.classificationMatchRate*100).toFixed(1)}%`,`- Push acceptance rate: ${(t.push.pushAcceptanceRate*100).toFixed(1)}%`),a.push(``,`### Rule Effectiveness`),Object.keys(t.rules.matchCounts).length>0)for(let[e,n]of Object.entries(t.rules.matchCounts)){let r=t.rules.pushCounts[e]??0,i=n>0?(r/n*100).toFixed(0):`0`;a.push(`- **${e}**: ${n} matches → ${r} pushes (${i}% conversion)`)}else a.push(`- _No rule activity recorded yet_`);if(e&&t.rules.lowConversionRules.length>0){a.push(``,`### ⚠️ Low Conversion Rules (potential false positives)`);for(let e of t.rules.lowConversionRules)a.push(`- **${e.ruleId}**: ${e.matchCount} matches, ${e.pushCount} pushes (${(e.conversionRate*100).toFixed(0)}% conversion) — consider tightening patterns`)}return a.push(``,`---`,"_Next: Use `er_update_policy` to refine rules based on these metrics, or `er_push` to share high-value knowledge._"),n&&(r.info(`Evolution metrics reset requested`,{requestedAt:new Date().toISOString(),clearedEvents:t.period.totalEvents}),i.reset(),a.push(`
+_Metrics have been reset._`)),{content:[{type:`text`,text:a.join(`
+`)}]}}catch(e){return r.error(`Evolution review failed`,t(e)),{content:[{type:`text`,text:`Evolution review failed: unable to compute metrics`}],isError:!0}}})}export{i as registerErEvolveReviewTool};
+//# sourceMappingURL=evolution.tools.js.map

package/packages/server/dist/tools/forge.tools.d.ts

@@ -1,12 +1,14 @@
-/**
- * MCP tool registrations for FORGE/STRATUM protocol tools.
- */
-import type { IEmbedder } from '@kb/embeddings';
-import type { IKnowledgeStore } from '@kb/store';
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare function registerEvidenceMapTool(server: McpServer): void;
-export declare function registerDigestTool(server: McpServer, embedder: IEmbedder): void;
-export declare function registerForgeClassifyTool(server: McpServer): void;
-export declare function registerStratumCardTool(server: McpServer, embedder: IEmbedder): void;
-export declare function registerForgeGroundTool(server: McpServer, embedder: IEmbedder, store: IKnowledgeStore): void;
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { IEmbedder } from "@kb/embeddings";
+import { IKnowledgeStore } from "@kb/store";
+import { FileCache } from "@kb/tools";
+
+//#region packages/server/src/tools/forge.tools.d.ts
+declare function registerEvidenceMapTool(server: McpServer): void;
+declare function registerDigestTool(server: McpServer, embedder: IEmbedder): void;
+declare function registerForgeClassifyTool(server: McpServer): void;
+declare function registerStratumCardTool(server: McpServer, embedder: IEmbedder, cache: FileCache): void;
+declare function registerForgeGroundTool(server: McpServer, embedder: IEmbedder, store: IKnowledgeStore): void;
+//#endregion
+export { registerDigestTool, registerEvidenceMapTool, registerForgeClassifyTool, registerForgeGroundTool, registerStratumCardTool };
 //# sourceMappingURL=forge.tools.d.ts.map

package/packages/server/dist/tools/forge.tools.js

@@ -1,13 +1,11 @@
-import{digest as x,evidenceMap as g,forgeClassify as y,forgeGround as b,stratumCard as v}from"../../../tools/dist/index.js";import{z as t}from"zod";function T(m){m.registerTool("evidence_map",{description:"FORGE Evidence Map \u2014 track critical-path claims as Verified/Assumed/Unresolved with receipts. Supports CRUD operations and deterministic Gate evaluation (YIELD/HOLD/HARD_BLOCK/FORCED_DELIVERY). Persists across tool calls.",inputSchema:{action:t.enum(["create","add","update","get","gate","list","delete"]).describe("Operation to perform"),task_id:t.string().optional().describe("Task identifier (required for all except list)"),tier:t.enum(["floor","standard","critical"]).optional().describe("FORGE tier (required for create)"),claim:t.string().optional().describe("Critical-path claim text (for add)"),status:t.enum(["V","A","U"]).optional().describe("Evidence status: V=Verified, A=Assumed, U=Unresolved"),receipt:t.string().optional().describe("Evidence receipt: tool\u2192ref for V, reasoning for A, attempts for U"),id:t.number().optional().describe("Entry ID (for update)"),critical_path:t.boolean().default(!0).describe("Whether this claim is on the critical path"),unknown_type:t.enum(["contract","convention","freshness","runtime","data-flow","impact"]).optional().describe("Typed unknown classification"),retry_count:t.number().default(0).describe("Retry count for gate evaluation (0 = first attempt)"),cwd:t.string().optional().describe("Working directory for evidence map storage (default: server cwd). Use root_path from forge_ground to match.")}},async({action:h,task_id:s,tier:l,claim:c,status:i,receipt:d,id:o,critical_path:p,unknown_type:n,retry_count:r,cwd:u})=>{try{switch(h){case"create":{if(!s)throw new Error("task_id required for create");if(!l)throw new Error("tier required for create");return g({action:"create",taskId:s,tier:l},u),{content:[{type:"text",text:`Created evidence map "${s}" (tier: ${l}).
-
----
-_Next: Use \`evidence_map\` with action "add" to record critical-path claims._`}]}}case"add":{if(!s)throw new Error("task_id required for add");if(!c)throw new Error("claim required for add");if(!i)throw new Error("status required for add");const e=g({action:"add",taskId:s,claim:c,status:i,receipt:d??"",criticalPath:p,unknownType:n},u),a=[`Added entry #${e.entry?.id} to "${s}": [${i}] ${c}`];return e.formattedMap&&a.push("",e.formattedMap),{content:[{type:"text",text:a.join(`
-`)}]}}case"update":{if(!s)throw new Error("task_id required for update");if(o===void 0)throw new Error("id required for update");if(!i)throw new Error("status required for update");const e=g({action:"update",taskId:s,id:o,status:i,receipt:d??""},u),a=[`Updated entry #${o} in "${s}" \u2192 ${i}`];return e.formattedMap&&a.push("",e.formattedMap),{content:[{type:"text",text:a.join(`
-`)}]}}case"get":{if(!s)throw new Error("task_id required for get");const e=g({action:"get",taskId:s},u);return e.state?{content:[{type:"text",text:[`## Evidence Map: ${s} (${e.state.tier})`,"",e.formattedMap??"No entries.","",`_${e.state.entries.length} entries \u2014 created ${e.state.createdAt}_`].join(`
-`)}]}:{content:[{type:"text",text:`Evidence map "${s}" not found.`}]}}case"gate":{if(!s)throw new Error("task_id required for gate");const e=g({action:"gate",taskId:s,retryCount:r},u);if(!e.gate)return{content:[{type:"text",text:`Evidence map "${s}" not found.`}]};const a=e.gate,f=[`## FORGE Gate: **${a.decision}**`,"",`**Reason:** ${a.reason}`,"",`**Stats:** ${a.stats.verified}V / ${a.stats.assumed}A / ${a.stats.unresolved}U (${a.stats.total} total)`];return a.warnings.length>0&&f.push("","**Warnings:**",...a.warnings.map($=>`- \u26A0\uFE0F ${$}`)),a.unresolvedCritical.length>0&&f.push("","**Blocking entries:**",...a.unresolvedCritical.map($=>`- #${$.id}: ${$.claim} [${$.unknownType??"untyped"}]`)),a.annotation&&f.push("","**Annotation:**",a.annotation),e.formattedMap&&f.push("","---","",e.formattedMap),f.push("","---",`_Next: ${a.decision==="YIELD"?"Proceed to implementation.":a.decision==="HOLD"?"Resolve blocking entries, then re-run gate.":a.decision==="HARD_BLOCK"?"Contract unknowns MUST be resolved. Use search or schema_validate.":"Proceed with annotation \u2014 document unresolved items in delivery."}_`),{content:[{type:"text",text:f.join(`
-`)}]}}case"list":{const e=g({action:"list"},u);return!e.states||e.states.length===0?{content:[{type:"text",text:"No evidence maps found."}]}:{content:[{type:"text",text:e.states.map(f=>`- **${f.taskId}** (${f.tier}) \u2014 ${f.entries.length} entries \u2014 ${f.updatedAt}`).join(`
-`)}]}}case"delete":{if(!s)throw new Error("task_id required for delete");return{content:[{type:"text",text:g({action:"delete",taskId:s},u).deleted?`Deleted evidence map "${s}".`:`Evidence map "${s}" not found.`}]}}}}catch(e){return{content:[{type:"text",text:`Evidence map error: ${e.message}`}],isError:!0}}})}function w(m,h){m.registerTool("digest",{description:"Compress multiple text sources (handoffs, debates, phase summaries) into a token-budgeted digest. Jointly ranks across all sources, pins structured fields (status, files, decisions, blockers), and allocates budget by priority weight.",inputSchema:{sources:t.array(t.object({id:t.string().describe('Source identifier (e.g., "phase-2-handoff")'),text:t.string().describe("Source text to compress"),weight:t.number().min(0).default(1).describe("Priority weight (higher = more budget)")})).min(1).describe("Text sources to compress"),query:t.string().describe("Focus query \u2014 what matters for the next step?"),max_chars:t.number().min(100).max(5e4).default(4e3).describe("Target budget in characters"),pin_fields:t.array(t.string()).optional().describe("Key fields to always extract (default: status, files, decisions, blockers, next)"),segmentation:t.enum(["paragraph","sentence","line"]).default("paragraph").describe("How to split text for scoring")}},async({sources:s,query:l,max_chars:c,pin_fields:i,segmentation:d})=>{try{const o=await x(h,{sources:s,query:l,maxChars:c,pinFields:i,segmentation:d}),p=[`## Digest (${o.totalOriginalChars} \u2192 ${o.totalCompressedChars} chars, ${(o.ratio*100).toFixed(0)}%)`,""],n=Object.keys(o.fields);if(n.length>0){p.push("### Extracted Fields");for(const r of n){const u=o.fields[r];p.push(`**${r}:**`);for(const e of u)p.push(`  - [${e.sourceId}] ${e.value}`)}p.push("")}p.push("### Compressed Content","",o.text),p.push("","### Source Stats");for(const r of o.sourceStats)p.push(`- **${r.id}**: ${r.originalChars} \u2192 ${r.keptChars} chars (${r.segmentsKept}/${r.segmentsTotal} segments)`);return p.push("","---","_Next: Use the digest as compressed context for the next phase. Use `stash` to persist it if needed._"),{content:[{type:"text",text:p.join(`
-`)}]}}catch(o){return{content:[{type:"text",text:`Digest failed: ${o.message}`}],isError:!0}}})}function C(m){m.registerTool("forge_classify",{description:"Classify FORGE tier (Floor/Standard/Critical) from target files and task description. Checks blast radius, cross-package boundaries, schema/contract patterns, and security signals. Returns tier, triggers, typed unknown seeds, and ceremony guidance.",inputSchema:{files:t.array(t.string()).min(1).describe("Files being modified (paths)"),task:t.string().describe("Task description"),root_path:t.string().describe("Root path of the codebase")}},async({files:h,task:s,root_path:l})=>{try{const c=await y({files:h,task:s,rootPath:l}),i=[`## FORGE Classification: **${c.tier.toUpperCase()}**`,""];if(c.triggers.length>0){i.push("### Triggers");for(const o of c.triggers)i.push(`- **${o.rule}** (${o.source}): ${o.detail}`);i.push("")}if(c.packagesCrossed.length>0&&i.push(`**Packages crossed:** ${c.packagesCrossed.join(", ")}`),c.typedUnknownSeeds.length>0){i.push("","### Typed Unknown Seeds");for(const o of c.typedUnknownSeeds)i.push(`- [${o.type}] ${o.description} \u2192 use \`${o.suggestedTool}\``)}i.push("","### Ceremony");const d=c.ceremony;return i.push(`- **Ground:** ${d.ground}`,`- **Build:** ${d.build}`,`- **Break:** ${d.break}`,`- **Evidence Map:** ${d.evidenceMap}`,`- **Gate:** ${d.gate}`),i.push("","---",`_Next: ${c.tier==="floor"?"Proceed directly to implementation.":"Run `forge_ground` to execute the full Ground phase."}_`),{content:[{type:"text",text:i.join(`
-`)}]}}catch(c){return{content:[{type:"text",text:`FORGE classify failed: ${c.message}`}],isError:!0}}})}function M(m,h){m.registerTool("stratum_card",{description:"Generate STRATUM context cards from files. T1 = structural metadata (~100 tokens/file). T2 = T1 + compressed content (~300 tokens/file). Replaces reading full files \u2014 10-100x token reduction.",inputSchema:{files:t.array(t.string()).min(1).describe("Absolute file paths to generate cards for"),query:t.string().describe("Current task query \u2014 guides relevance scoring"),tier:t.enum(["T1","T2"]).default("T1").describe("Card tier: T1 = structural only, T2 = T1 + compressed content"),max_content_chars:t.number().min(100).max(5e3).default(800).describe("For T2: max chars for compressed content section")}},async({files:s,query:l,tier:c,max_content_chars:i})=>{try{const d=await v(h,{files:s,query:l,tier:c,maxContentChars:i}),o=[`## STRATUM Cards (${c}) \u2014 ${d.cards.length} files`,`Total: ~${d.totalTokenEstimate} tokens (was ~${d.totalOriginalTokenEstimate}, ${(d.compressionRatio*100).toFixed(0)}% of original)`,""];for(const p of d.cards)o.push(p.card,"");return o.push("---","_Next: Use these cards as context instead of reading full files. Use `compact` for deeper content extraction on specific files._"),{content:[{type:"text",text:o.join(`
-`)}]}}catch(d){return{content:[{type:"text",text:`STRATUM cards failed: ${d.message}`}],isError:!0}}})}function S(m,h,s){m.registerTool("forge_ground",{description:"Execute the complete FORGE Ground phase in a single call. Chains: tier classification \u2192 scope map \u2192 typed unknown seeds \u2192 constraint loading \u2192 file summaries \u2192 evidence map creation. Replaces 5-15 manual tool calls.",inputSchema:{task:t.string().describe("Task description"),files:t.array(t.string()).min(1).describe("Target files being modified (absolute paths)"),root_path:t.string().describe("Root path of the codebase"),max_constraints:t.number().min(0).max(10).default(3).describe("Max constraint entries to load from KB"),force_tier:t.enum(["floor","standard","critical"]).optional().describe("Force a specific tier (skips auto-classification)"),task_id:t.string().optional().describe("Custom task ID for evidence map (auto-generated if omitted)")}},async({task:l,files:c,root_path:i,max_constraints:d,force_tier:o,task_id:p})=>{try{const n=await b(h,s,{task:l,files:c,rootPath:i,maxConstraints:d,forceTier:o,taskId:p}),r=[`## FORGE Ground: **${n.tier.toUpperCase()}**`,`Estimated output: ~${n.estimatedTokens} tokens`,""];if(n.classifyTriggers.length>0){r.push("### Classification Triggers");for(const e of n.classifyTriggers)r.push(`- **${e.rule}** (${e.source}): ${e.detail}`);r.push("")}if(n.fileSummaries.length>0){r.push("### Target Files");for(const e of n.fileSummaries)r.push(`- **${e.path}** (${e.lines} lines) \u2014 exports: ${e.exports.join(", ")||"none"} \u2014 functions: ${e.functions.join(", ")||"none"}`);r.push("")}if(n.typedUnknownSeeds.length>0){r.push("### Typed Unknown Seeds");for(const e of n.typedUnknownSeeds)r.push(`- [${e.type}] ${e.description} \u2192 \`${e.suggestedTool}\``);r.push("")}if(n.constraints.length>0){r.push("### Constraint Seed");for(const e of n.constraints)r.push(`- **${e.source}** (${(e.relevance*100).toFixed(0)}%): ${e.snippet}`);r.push("")}if(n.scopeMap){r.push(`### Scope Map: ${n.scopeMap.files.length} files (~${n.scopeMap.totalEstimatedTokens} tokens)`);for(const e of n.scopeMap.files.slice(0,5))r.push(`- ${e.path} (${(e.relevance*100).toFixed(0)}%) \u2014 ${e.reason}`);n.scopeMap.files.length>5&&r.push(`- _...and ${n.scopeMap.files.length-5} more_`),r.push("")}n.evidenceMapTaskId&&(r.push(`**Evidence Map:** \`${n.evidenceMapTaskId}\` (initialized)`),r.push("")),r.push("### Ceremony Guidance");const u=n.ceremony;return r.push(`- **Ground:** ${u.ground}`,`- **Build:** ${u.build}`,`- **Break:** ${u.break}`,`- **Evidence Map:** ${u.evidenceMap}`,`- **Gate:** ${u.gate}`),r.push("","---",`_Next: ${n.tier==="floor"?"Proceed to Build phase.":"Use `evidence_map` to track claims during Build, then `evidence_map` gate after Break."}_`),{content:[{type:"text",text:r.join(`
-`)}]}}catch(n){return{content:[{type:"text",text:`FORGE Ground failed: ${n.message}`}],isError:!0}}})}export{w as registerDigestTool,T as registerEvidenceMapTool,C as registerForgeClassifyTool,S as registerForgeGroundTool,M as registerStratumCardTool};
+import{createLogger as e,serializeError as t}from"../../../core/dist/index.js";import{digest as n,evidenceMap as r,forgeClassify as i,forgeGround as a,stratumCard as o}from"../../../tools/dist/index.js";import{z as s}from"zod";const c=e(`tools`);function l(e){e.registerTool(`evidence_map`,{description:`FORGE Evidence Map — track critical-path claims as Verified/Assumed/Unresolved with receipts. Supports CRUD operations and deterministic Gate evaluation (YIELD/HOLD/HARD_BLOCK/FORCED_DELIVERY). Persists across tool calls.`,inputSchema:{action:s.enum([`create`,`add`,`update`,`get`,`gate`,`list`,`delete`]).describe(`Operation to perform`),task_id:s.string().optional().describe(`Task identifier (required for all except list)`),tier:s.enum([`floor`,`standard`,`critical`]).optional().describe(`FORGE tier (required for create)`),claim:s.string().optional().describe(`Critical-path claim text (for add)`),status:s.enum([`V`,`A`,`U`]).optional().describe(`Evidence status: V=Verified, A=Assumed, U=Unresolved`),receipt:s.string().optional().describe(`Evidence receipt: tool→ref for V, reasoning for A, attempts for U`),id:s.number().optional().describe(`Entry ID (for update)`),critical_path:s.boolean().default(!0).describe(`Whether this claim is on the critical path`),unknown_type:s.enum([`contract`,`convention`,`freshness`,`runtime`,`data-flow`,`impact`]).optional().describe(`Typed unknown classification`),retry_count:s.number().default(0).describe(`Retry count for gate evaluation (0 = first attempt)`),cwd:s.string().optional().describe(`Working directory for evidence map storage (default: server cwd). Use root_path from forge_ground to match.`)}},async({action:e,task_id:n,tier:i,claim:a,status:o,receipt:s,id:l,critical_path:u,unknown_type:d,retry_count:f,cwd:p})=>{try{switch(e){case`create`:if(!n)throw Error(`task_id required for create`);if(!i)throw Error(`tier required for create`);return r({action:`create`,taskId:n,tier:i},p),{content:[{type:`text`,text:`Created evidence map "${n}" (tier: ${i}).\n\n---\n_Next: Use \`evidence_map\` with action "add" to record critical-path claims._`}]};case`add`:{if(!n)throw Error(`task_id required for add`);if(!a)throw Error(`claim required for add`);if(!o)throw Error(`status required for add`);let e=r({action:`add`,taskId:n,claim:a,status:o,receipt:s??``,criticalPath:u,unknownType:d},p),t=[`Added entry #${e.entry?.id} to "${n}": [${o}] ${a}`];return e.formattedMap&&t.push(``,e.formattedMap),{content:[{type:`text`,text:t.join(`
+`)}]}}case`update`:{if(!n)throw Error(`task_id required for update`);if(l===void 0)throw Error(`id required for update`);if(!o)throw Error(`status required for update`);let e=r({action:`update`,taskId:n,id:l,status:o,receipt:s??``},p),t=[`Updated entry #${l} in "${n}" → ${o}`];return e.formattedMap&&t.push(``,e.formattedMap),{content:[{type:`text`,text:t.join(`
+`)}]}}case`get`:{if(!n)throw Error(`task_id required for get`);let e=r({action:`get`,taskId:n},p);return e.state?{content:[{type:`text`,text:[`## Evidence Map: ${n} (${e.state.tier})`,``,e.formattedMap??`No entries.`,``,`_${e.state.entries.length} entries — created ${e.state.createdAt}_`].join(`
+`)}]}:{content:[{type:`text`,text:`Evidence map "${n}" not found.`}]}}case`gate`:{if(!n)throw Error(`task_id required for gate`);let e=r({action:`gate`,taskId:n,retryCount:f},p);if(!e.gate)return{content:[{type:`text`,text:`Evidence map "${n}" not found.`}]};let t=e.gate,i=[`## FORGE Gate: **${t.decision}**`,``,`**Reason:** ${t.reason}`,``,`**Stats:** ${t.stats.verified}V / ${t.stats.assumed}A / ${t.stats.unresolved}U (${t.stats.total} total)`];return t.warnings.length>0&&i.push(``,`**Warnings:**`,...t.warnings.map(e=>`- ⚠️ ${e}`)),t.unresolvedCritical.length>0&&i.push(``,`**Blocking entries:**`,...t.unresolvedCritical.map(e=>`- #${e.id}: ${e.claim} [${e.unknownType??`untyped`}]`)),t.annotation&&i.push(``,`**Annotation:**`,t.annotation),e.formattedMap&&i.push(``,`---`,``,e.formattedMap),i.push(``,`---`,`_Next: ${t.decision===`YIELD`?`Proceed to implementation.`:t.decision===`HOLD`?`Resolve blocking entries, then re-run gate.`:t.decision===`HARD_BLOCK`?`Contract unknowns MUST be resolved. Use search or schema_validate.`:`Proceed with annotation — document unresolved items in delivery.`}_`),{content:[{type:`text`,text:i.join(`
+`)}]}}case`list`:{let e=r({action:`list`},p);return!e.states||e.states.length===0?{content:[{type:`text`,text:`No evidence maps found.`}]}:{content:[{type:`text`,text:e.states.map(e=>`- **${e.taskId}** (${e.tier}) — ${e.entries.length} entries — ${e.updatedAt}`).join(`
+`)}]}}case`delete`:if(!n)throw Error(`task_id required for delete`);return{content:[{type:`text`,text:r({action:`delete`,taskId:n},p).deleted?`Deleted evidence map "${n}".`:`Evidence map "${n}" not found.`}]}}}catch(e){return c.error(`Evidence map error`,t(e)),{content:[{type:`text`,text:`Evidence map error. Check server logs for details.`}],isError:!0}}})}function u(e,r){e.registerTool(`digest`,{description:`Compress multiple text sources (handoffs, debates, phase summaries) into a token-budgeted digest. Jointly ranks across all sources, pins structured fields (status, files, decisions, blockers), and allocates budget by priority weight.`,inputSchema:{sources:s.array(s.object({id:s.string().describe(`Source identifier (e.g., "phase-2-handoff")`),text:s.string().max(5e5).describe(`Source text to compress`),weight:s.number().min(0).default(1).describe(`Priority weight (higher = more budget)`)})).min(1).max(20).describe(`Text sources to compress`),query:s.string().describe(`Focus query — what matters for the next step?`),max_chars:s.number().min(100).max(5e4).default(4e3).describe(`Target budget in characters`),pin_fields:s.array(s.string()).optional().describe(`Key fields to always extract (default: status, files, decisions, blockers, next)`),segmentation:s.enum([`paragraph`,`sentence`,`line`]).default(`paragraph`).describe(`How to split text for scoring`)}},async({sources:e,query:i,max_chars:a,pin_fields:o,segmentation:s})=>{try{let t=await n(r,{sources:e,query:i,maxChars:a,pinFields:o,segmentation:s}),c=[`## Digest (${t.totalOriginalChars} → ${t.totalCompressedChars} chars, ${(t.ratio*100).toFixed(0)}%)`,``],l=Object.keys(t.fields);if(l.length>0){c.push(`### Extracted Fields`);for(let e of l){let n=t.fields[e];c.push(`**${e}:**`);for(let e of n)c.push(`  - [${e.sourceId}] ${e.value}`)}c.push(``)}c.push(`### Compressed Content`,``,t.text),c.push(``,`### Source Stats`);for(let e of t.sourceStats)c.push(`- **${e.id}**: ${e.originalChars} → ${e.keptChars} chars (${e.segmentsKept}/${e.segmentsTotal} segments)`);return c.push(``,`---`,"_Next: Use the digest as compressed context for the next phase. Use `stash` to persist it if needed._"),{content:[{type:`text`,text:c.join(`
+`)}]}}catch(e){return c.error(`Digest failed`,t(e)),{content:[{type:`text`,text:`Digest failed. Check server logs for details.`}],isError:!0}}})}function d(e){e.registerTool(`forge_classify`,{description:`Classify FORGE tier (Floor/Standard/Critical) from target files and task description. Checks blast radius, cross-package boundaries, schema/contract patterns, and security signals. Returns tier, triggers, typed unknown seeds, and ceremony guidance.`,inputSchema:{files:s.array(s.string()).min(1).max(100).describe(`Files being modified (paths)`),task:s.string().describe(`Task description`),root_path:s.string().describe(`Root path of the codebase`)}},async({files:e,task:n,root_path:r})=>{try{let t=await i({files:e,task:n,rootPath:r}),a=[`## FORGE Classification: **${t.tier.toUpperCase()}**`,``];if(t.triggers.length>0){a.push(`### Triggers`);for(let e of t.triggers)a.push(`- **${e.rule}** (${e.source}): ${e.detail}`);a.push(``)}if(t.packagesCrossed.length>0&&a.push(`**Packages crossed:** ${t.packagesCrossed.join(`, `)}`),t.typedUnknownSeeds.length>0){a.push(``,`### Typed Unknown Seeds`);for(let e of t.typedUnknownSeeds)a.push(`- [${e.type}] ${e.description} → use \`${e.suggestedTool}\``)}a.push(``,`### Ceremony`);let o=t.ceremony;return a.push(`- **Ground:** ${o.ground}`,`- **Build:** ${o.build}`,`- **Break:** ${o.break}`,`- **Evidence Map:** ${o.evidenceMap}`,`- **Gate:** ${o.gate}`),a.push(``,`---`,`_Next: ${t.tier===`floor`?`Proceed directly to implementation.`:"Run `forge_ground` to execute the full Ground phase."}_`),{content:[{type:`text`,text:a.join(`
+`)}]}}catch(e){return c.error(`FORGE classify failed`,t(e)),{content:[{type:`text`,text:`FORGE classify failed. Check server logs for details.`}],isError:!0}}})}function f(e,n,r){e.registerTool(`stratum_card`,{description:`Generate STRATUM context cards from files. T1 = structural metadata (~100 tokens/file). T2 = T1 + compressed content (~300 tokens/file). Replaces reading full files — 10-100x token reduction.`,inputSchema:{files:s.array(s.string()).min(1).max(50).describe(`Absolute file paths to generate cards for`),query:s.string().describe(`Current task query — guides relevance scoring`),tier:s.enum([`T1`,`T2`]).default(`T1`).describe(`Card tier: T1 = structural only, T2 = T1 + compressed content`),max_content_chars:s.number().min(100).max(5e3).default(800).describe(`For T2: max chars for compressed content section`)}},async({files:e,query:i,tier:a,max_content_chars:s})=>{try{let t=await o(n,{files:e,query:i,tier:a,maxContentChars:s,cache:r}),c=[`## STRATUM Cards (${a}) — ${t.cards.length} files`,`Total: ~${t.totalTokenEstimate} tokens (was ~${t.totalOriginalTokenEstimate}, ${(t.compressionRatio*100).toFixed(0)}% of original)`,``];for(let e of t.cards)c.push(e.card,``);return c.push(`---`,"_Next: Use these cards as context instead of reading full files. Use `compact` for deeper content extraction on specific files._"),{content:[{type:`text`,text:c.join(`
+`)}]}}catch(e){return c.error(`STRATUM cards failed`,t(e)),{content:[{type:`text`,text:`STRATUM cards failed. Check server logs for details.`}],isError:!0}}})}function p(e,n,r){e.registerTool(`forge_ground`,{description:`Execute the complete FORGE Ground phase in a single call. Chains: tier classification → scope map → typed unknown seeds → constraint loading → file summaries → evidence map creation. Replaces 5-15 manual tool calls.`,inputSchema:{task:s.string().describe(`Task description`),files:s.array(s.string()).min(1).max(100).describe(`Target files being modified (absolute paths)`),root_path:s.string().describe(`Root path of the codebase`),max_constraints:s.number().min(0).max(10).default(3).describe(`Max constraint entries to load from KB`),force_tier:s.enum([`floor`,`standard`,`critical`]).optional().describe(`Force a specific tier (skips auto-classification)`),task_id:s.string().optional().describe(`Custom task ID for evidence map (auto-generated if omitted)`)}},async({task:e,files:i,root_path:o,max_constraints:s,force_tier:l,task_id:u})=>{try{let t=await a(n,r,{task:e,files:i,rootPath:o,maxConstraints:s,forceTier:l,taskId:u}),c=[`## FORGE Ground: **${t.tier.toUpperCase()}**`,`Estimated output: ~${t.estimatedTokens} tokens`,``];if(t.classifyTriggers.length>0){c.push(`### Classification Triggers`);for(let e of t.classifyTriggers)c.push(`- **${e.rule}** (${e.source}): ${e.detail}`);c.push(``)}if(t.fileSummaries.length>0){c.push(`### Target Files`);for(let e of t.fileSummaries)c.push(`- **${e.path}** (${e.lines} lines) — exports: ${e.exports.join(`, `)||`none`} — functions: ${e.functions.join(`, `)||`none`}`);c.push(``)}if(t.typedUnknownSeeds.length>0){c.push(`### Typed Unknown Seeds`);for(let e of t.typedUnknownSeeds)c.push(`- [${e.type}] ${e.description} → \`${e.suggestedTool}\``);c.push(``)}if(t.constraints.length>0){c.push(`### Constraint Seed`);for(let e of t.constraints)c.push(`- **${e.source}** (${(e.relevance*100).toFixed(0)}%): ${e.snippet}`);c.push(``)}if(t.scopeMap){c.push(`### Scope Map: ${t.scopeMap.files.length} files (~${t.scopeMap.totalEstimatedTokens} tokens)`);for(let e of t.scopeMap.files.slice(0,5))c.push(`- ${e.path} (${(e.relevance*100).toFixed(0)}%) — ${e.reason}`);t.scopeMap.files.length>5&&c.push(`- _...and ${t.scopeMap.files.length-5} more_`),c.push(``)}t.evidenceMapTaskId&&(c.push(`**Evidence Map:** \`${t.evidenceMapTaskId}\` (initialized)`),c.push(``)),c.push(`### Ceremony Guidance`);let d=t.ceremony;return c.push(`- **Ground:** ${d.ground}`,`- **Build:** ${d.build}`,`- **Break:** ${d.break}`,`- **Evidence Map:** ${d.evidenceMap}`,`- **Gate:** ${d.gate}`),c.push(``,`---`,`_Next: ${t.tier===`floor`?`Proceed to Build phase.`:"Use `evidence_map` to track claims during Build, then `evidence_map` gate after Break."}_`),{content:[{type:`text`,text:c.join(`
+`)}]}}catch(e){return c.error(`FORGE Ground failed`,t(e)),{content:[{type:`text`,text:`FORGE Ground failed. Check server logs for details.`}],isError:!0}}})}export{u as registerDigestTool,l as registerEvidenceMapTool,d as registerForgeClassifyTool,p as registerForgeGroundTool,f as registerStratumCardTool};
+//# sourceMappingURL=forge.tools.js.map

package/packages/server/dist/tools/forget.tool.d.ts

@@ -1,4 +1,8 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { CuratedKnowledgeManager } from '../curated-manager.js';
-export declare function registerForgetTool(server: McpServer, curated: CuratedKnowledgeManager): void;
+import { CuratedKnowledgeManager } from "../curated-manager.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region packages/server/src/tools/forget.tool.d.ts
+declare function registerForgetTool(server: McpServer, curated: CuratedKnowledgeManager): void;
+//#endregion
+export { registerForgetTool };
 //# sourceMappingURL=forget.tool.d.ts.map

package/packages/server/dist/tools/forget.tool.js

@@ -1,7 +1,2 @@
-import{z as t}from"zod";function i(o,n){o.registerTool("forget",{description:"Remove a curated knowledge entry. Deletes the file and removes it from the vector store.",inputSchema:{path:t.string().describe('Relative path within curated/ (e.g., "decisions/deprecated-approach.md")'),reason:t.string().min(3).describe("Why this entry is being removed")}},async({path:s,reason:r})=>{try{const e=await n.forget(s,r);return console.error(`[KB] Forgot: ${e.path} \u2014 reason: ${r}`),{content:[{type:"text",text:`Forgotten: \`curated/${e.path}\`
-
-Removed from disk and vector store.
-Reason: ${r}
-
----
-_Next: Use \`list\` to verify removal, or \`search\` to confirm the entry is no longer returned._`}]}}catch(e){return console.error("[KB] Forget failed:",e),{content:[{type:"text",text:`Forget failed: ${e.message}`}],isError:!0}}})}export{i as registerForgetTool};
+import{createLogger as e,serializeError as t}from"../../../core/dist/index.js";import{z as n}from"zod";const r=e(`tools`);function i(e,i){e.registerTool(`forget`,{description:`Remove a curated knowledge entry. Deletes the file and removes it from the vector store.`,inputSchema:{path:n.string().describe(`Relative path within curated/ (e.g., "decisions/deprecated-approach.md")`),reason:n.string().min(3).describe(`Why this entry is being removed`)}},async({path:e,reason:n})=>{try{let t=await i.forget(e,n);return r.info(`Forgot entry`,{path:t.path,reason:n}),{content:[{type:`text`,text:`Forgotten: \`curated/${t.path}\`\n\nRemoved from disk and vector store.\nReason: ${n}\n\n---\n_Next: Use \`list\` to verify removal, or \`search\` to confirm the entry is no longer returned._`}]}}catch(e){return r.error(`Forget failed`,t(e)),{content:[{type:`text`,text:`Forget failed. Check server logs for details.`}],isError:!0}}})}export{i as registerForgetTool};
+//# sourceMappingURL=forget.tool.js.map

package/packages/server/dist/tools/graph.tool.d.ts

@@ -1,4 +1,8 @@
-import type { IGraphStore } from '@kb/store';
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare function registerGraphTool(server: McpServer, graphStore: IGraphStore): void;
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { IGraphStore } from "@kb/store";
+
+//#region packages/server/src/tools/graph.tool.d.ts
+declare function registerGraphTool(server: McpServer, graphStore: IGraphStore): void;
+//#endregion
+export { registerGraphTool };
 //# sourceMappingURL=graph.tool.d.ts.map

package/packages/server/dist/tools/graph.tool.js

@@ -1,5 +1,5 @@
-import{graphQuery as a}from"../../../tools/dist/index.js";import{z as e}from"zod";const p=e.object({id:e.string().optional().describe("Node ID (auto-generated if omitted)"),type:e.string().describe("Node type (entity, service, api, concept, decision)"),name:e.string().describe("Display name"),properties:e.record(e.string(),e.unknown()).optional().describe("Arbitrary properties"),sourceRecordId:e.string().optional().describe("Back-link to knowledge record ID"),sourcePath:e.string().optional().describe("Source file path")}),c=e.object({id:e.string().optional().describe("Edge ID (auto-generated if omitted)"),fromId:e.string().describe("Source node ID"),toId:e.string().describe("Target node ID"),type:e.string().describe("Relationship type (depends-on, implements, calls, affects)"),weight:e.number().min(0).max(1).optional().describe("Relationship weight"),properties:e.record(e.string(),e.unknown()).optional().describe("Arbitrary properties")});function h(n,s){n.registerTool("graph",{description:"Query and manage the knowledge graph. Find nodes/edges, traverse connections, add entities and relationships. The graph captures structural relationships between concepts discovered in the codebase.",inputSchema:{action:e.enum(["find_nodes","find_edges","neighbors","traverse","stats","add","delete","clear"]).describe("Action: find_nodes (search nodes), find_edges (search edges), neighbors (direct connections), traverse (multi-hop), stats (graph overview), add (insert nodes/edges), delete (remove nodes), clear (remove all)"),node_type:e.string().optional().describe("Node type filter (for find_nodes)"),name_pattern:e.string().optional().describe("Name substring match (for find_nodes)"),source_path:e.string().optional().describe("Source path filter"),node_id:e.string().optional().describe("Node ID (for neighbors, traverse, delete)"),edge_type:e.string().optional().describe("Edge type filter"),from_id:e.string().optional().describe("Source node ID (for find_edges)"),to_id:e.string().optional().describe("Target node ID (for find_edges)"),direction:e.enum(["outgoing","incoming","both"]).default("both").describe("Traversal direction"),max_depth:e.number().min(1).max(5).default(2).describe("Max traversal depth"),limit:e.number().min(1).max(100).default(50).describe("Max results"),nodes:e.array(p).optional().describe("Nodes to add (for action=add)"),edges:e.array(c).optional().describe("Edges to add (for action=add)")}},async t=>{try{const r=await a(s,{action:t.action,nodeType:t.node_type,namePattern:t.name_pattern,sourcePath:t.source_path,nodeId:t.node_id,edgeType:t.edge_type,fromId:t.from_id,toId:t.to_id,direction:t.direction,maxDepth:t.max_depth,limit:t.limit,nodes:t.nodes,edges:t.edges}),i=[r.summary];if(r.nodes&&r.nodes.length>0){i.push(`
-### Nodes`);for(const o of r.nodes){const d=Object.keys(o.properties).length>0?` \u2014 ${JSON.stringify(o.properties)}`:"";i.push(`- **${o.name}** (${o.type}, id: \`${o.id}\`)${d}`)}}if(r.edges&&r.edges.length>0){i.push(`
-### Edges`);for(const o of r.edges)i.push(`- \`${o.fromId}\` \u2014[${o.type}]\u2192 \`${o.toId}\`${o.weight!==1?` (weight: ${o.weight})`:""}`)}return r.stats&&(i.push(`
-Node types: ${JSON.stringify(r.stats.nodeTypes)}`),i.push(`Edge types: ${JSON.stringify(r.stats.edgeTypes)}`)),i.push("\n---\n_Next: Use `graph(traverse)` to explore connections, `graph(add)` to insert entities, or `search` with graph-augmented results._"),{content:[{type:"text",text:i.join(`
-`)}]}}catch(r){return console.error("[KB] Graph query failed:",r),{content:[{type:"text",text:`Graph query failed: ${r.message}`}],isError:!0}}})}export{h as registerGraphTool};
+import{createLogger as e,serializeError as t}from"../../../core/dist/index.js";import{graphQuery as n}from"../../../tools/dist/index.js";import{z as r}from"zod";const i=e(`tools`),a=r.object({id:r.string().optional().describe(`Node ID (auto-generated if omitted)`),type:r.string().describe(`Node type (entity, service, api, concept, decision)`),name:r.string().describe(`Display name`),properties:r.record(r.string(),r.unknown()).optional().describe(`Arbitrary properties`),sourceRecordId:r.string().optional().describe(`Back-link to knowledge record ID`),sourcePath:r.string().optional().describe(`Source file path`)}),o=r.object({id:r.string().optional().describe(`Edge ID (auto-generated if omitted)`),fromId:r.string().describe(`Source node ID`),toId:r.string().describe(`Target node ID`),type:r.string().describe(`Relationship type (depends-on, implements, calls, affects)`),weight:r.number().min(0).max(1).optional().describe(`Relationship weight`),properties:r.record(r.string(),r.unknown()).optional().describe(`Arbitrary properties`)});function s(e,s){e.registerTool(`graph`,{description:`Query and manage the knowledge graph. Find nodes/edges, traverse connections, add entities and relationships. The graph captures structural relationships between concepts discovered in the codebase.`,inputSchema:{action:r.enum([`find_nodes`,`find_edges`,`neighbors`,`traverse`,`stats`,`add`,`delete`,`clear`]).describe(`Action: find_nodes (search nodes), find_edges (search edges), neighbors (direct connections), traverse (multi-hop), stats (graph overview), add (insert nodes/edges), delete (remove nodes), clear (remove all)`),node_type:r.string().optional().describe(`Node type filter (for find_nodes)`),name_pattern:r.string().optional().describe(`Name substring match (for find_nodes)`),source_path:r.string().optional().describe(`Source path filter`),node_id:r.string().optional().describe(`Node ID (for neighbors, traverse, delete)`),edge_type:r.string().optional().describe(`Edge type filter`),from_id:r.string().optional().describe(`Source node ID (for find_edges)`),to_id:r.string().optional().describe(`Target node ID (for find_edges)`),direction:r.enum([`outgoing`,`incoming`,`both`]).default(`both`).describe(`Traversal direction`),max_depth:r.number().min(1).max(5).default(2).describe(`Max traversal depth`),limit:r.number().min(1).max(100).default(50).describe(`Max results`),nodes:r.array(a).max(500).optional().describe(`Nodes to add (for action=add)`),edges:r.array(o).max(500).optional().describe(`Edges to add (for action=add)`)}},async e=>{try{let t=await n(s,{action:e.action,nodeType:e.node_type,namePattern:e.name_pattern,sourcePath:e.source_path,nodeId:e.node_id,edgeType:e.edge_type,fromId:e.from_id,toId:e.to_id,direction:e.direction,maxDepth:e.max_depth,limit:e.limit,nodes:e.nodes,edges:e.edges}),r=[t.summary];if(t.nodes&&t.nodes.length>0){r.push(`
+### Nodes`);for(let e of t.nodes){let t=Object.keys(e.properties).length>0?` — ${JSON.stringify(e.properties)}`:``;r.push(`- **${e.name}** (${e.type}, id: \`${e.id}\`)${t}`)}}if(t.edges&&t.edges.length>0){r.push(`
+### Edges`);for(let e of t.edges)r.push(`- \`${e.fromId}\` —[${e.type}]→ \`${e.toId}\`${e.weight===1?``:` (weight: ${e.weight})`}`)}return t.stats&&(r.push(`\nNode types: ${JSON.stringify(t.stats.nodeTypes)}`),r.push(`Edge types: ${JSON.stringify(t.stats.edgeTypes)}`)),r.push("\n---\n_Next: Use `graph(traverse)` to explore connections, `graph(add)` to insert entities, or `search` with graph-augmented results._"),{content:[{type:`text`,text:r.join(`
+`)}]}}catch(e){return i.error(`Graph query failed`,t(e)),{content:[{type:`text`,text:`Graph query failed. Check server logs for details.`}],isError:!0}}})}export{s as registerGraphTool};
+//# sourceMappingURL=graph.tool.js.map

package/packages/server/dist/tools/list.tool.d.ts

@@ -1,4 +1,8 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { CuratedKnowledgeManager } from '../curated-manager.js';
-export declare function registerListTool(server: McpServer, curated: CuratedKnowledgeManager): void;
+import { CuratedKnowledgeManager } from "../curated-manager.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region packages/server/src/tools/list.tool.d.ts
+declare function registerListTool(server: McpServer, curated: CuratedKnowledgeManager): void;
+//#endregion
+export { registerListTool };
 //# sourceMappingURL=list.tool.d.ts.map

package/packages/server/dist/tools/list.tool.js

@@ -1,8 +1,3 @@
-import{z as o}from"zod";function g(s,i){s.registerTool("list",{description:"List curated knowledge entries. Optionally filter by category or tag.",inputSchema:{category:o.string().optional().describe('Filter by category (e.g., "decisions", "patterns")'),tag:o.string().optional().describe("Filter by tag")}},async({category:r,tag:n})=>{try{const t=await i.list({category:r,tag:n});if(t.length===0)return{content:[{type:"text",text:"No curated knowledge entries found."+(r?` (category: ${r})`:"")+(n?` (tag: ${n})`:"")}]};const a=t.map(e=>{const c=e.tags.length>0?` [${e.tags.join(", ")}]`:"";return`- **${e.title}** (v${e.version})${c}
-  \`${e.path}\` \u2014 ${e.contentPreview.slice(0,80)}\u2026`}).join(`
-`);return{content:[{type:"text",text:`## Curated Knowledge (${t.length} entries)
-
-${a}
-
----
-_Next: Use \`read\` to view full content of any entry, or \`remember\` to store new knowledge._`}]}}catch(t){return console.error("[KB] List failed:",t),{content:[{type:"text",text:`List failed: ${t.message}`}],isError:!0}}})}export{g as registerListTool};
+import{createLogger as e,serializeError as t}from"../../../core/dist/index.js";import{z as n}from"zod";const r=e(`tools`);function i(e,i){e.registerTool(`list`,{description:`List curated knowledge entries. Optionally filter by category or tag.`,inputSchema:{category:n.string().optional().describe(`Filter by category (e.g., "decisions", "patterns")`),tag:n.string().optional().describe(`Filter by tag`)}},async({category:e,tag:n})=>{try{let t=await i.list({category:e,tag:n});if(t.length===0)return{content:[{type:`text`,text:`No curated knowledge entries found.`+(e?` (category: ${e})`:``)+(n?` (tag: ${n})`:``)}]};let r=t.map(e=>{let t=e.tags.length>0?` [${e.tags.join(`, `)}]`:``;return`- **${e.title}** (v${e.version})${t}\n  \`${e.path}\` — ${e.contentPreview.slice(0,80)}…`}).join(`
+`);return{content:[{type:`text`,text:`## Curated Knowledge (${t.length} entries)\n\n${r}\n\n---\n_Next: Use \`read\` to view full content of any entry, or \`remember\` to store new knowledge._`}]}}catch(e){return r.error(`List failed`,t(e)),{content:[{type:`text`,text:`List failed. Check server logs for details.`}],isError:!0}}})}export{i as registerListTool};
+//# sourceMappingURL=list.tool.js.map

package/packages/server/dist/tools/lookup.tool.d.ts

@@ -1,4 +1,8 @@
-import type { IKnowledgeStore } from '@kb/store';
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare function registerLookupTool(server: McpServer, store: IKnowledgeStore): void;
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { IKnowledgeStore } from "@kb/store";
+
+//#region packages/server/src/tools/lookup.tool.d.ts
+declare function registerLookupTool(server: McpServer, store: IKnowledgeStore): void;
+//#endregion
+export { registerLookupTool };
 //# sourceMappingURL=lookup.tool.d.ts.map

package/packages/server/dist/tools/lookup.tool.js

@@ -1,10 +1,4 @@
-import{z as p}from"zod";function d(r,s){r.registerTool("lookup",{description:"Look up all indexed chunks for a specific file path. Returns all chunks sorted by position.",inputSchema:{path:p.string().describe('Relative file path to look up (e.g., "src/index.ts")')}},async({path:n})=>{try{const e=await s.getBySourcePath(n);if(e.length===0)return{content:[{type:"text",text:`No indexed content found for: ${n}`}]};e.sort((t,o)=>t.chunkIndex-o.chunkIndex);const c=`## ${n}
-**Chunks**: ${e.length} | **Type**: ${e[0].contentType}
-`,i=e.map(t=>{const o=t.startLine?` (lines ${t.startLine}-${t.endLine})`:"";return`### Chunk ${t.chunkIndex+1}/${t.totalChunks}${o}
-${t.content}`}).join(`
+import{createLogger as e,serializeError as t}from"../../../core/dist/index.js";import{z as n}from"zod";const r=e(`tools`);function i(e,i){e.registerTool(`lookup`,{description:`Look up all indexed chunks for a specific file path. Returns all chunks sorted by position.`,inputSchema:{path:n.string().describe(`Relative file path to look up (e.g., "src/index.ts")`)}},async({path:e})=>{try{let t=await i.getBySourcePath(e);return t.length===0?{content:[{type:`text`,text:`No indexed content found for: ${e}`}]}:(t.sort((e,t)=>e.chunkIndex-t.chunkIndex),{content:[{type:`text`,text:`${`## ${e}\n**Chunks**: ${t.length} | **Type**: ${t[0].contentType}\n`}\n${t.map(e=>{let t=e.startLine?` (lines ${e.startLine}-${e.endLine})`:``;return`### Chunk ${e.chunkIndex+1}/${e.totalChunks}${t}\n${e.content}`}).join(`
 
-`);return{content:[{type:"text",text:`${c}
-${i}
-
----
-_Next: Use \`search\` to find related content, or \`analyze_dependencies\` to see what this file imports._`}]}}catch(e){return console.error("[KB] Lookup failed:",e),{content:[{type:"text",text:`Lookup failed: ${e.message}`}],isError:!0}}})}export{d as registerLookupTool};
+`)}\n\n---\n_Next: Use \`search\` to find related content, or \`analyze_dependencies\` to see what this file imports._`}]})}catch(e){return r.error(`Lookup failed`,t(e)),{content:[{type:`text`,text:`Lookup failed. Check server logs for details.`}],isError:!0}}})}export{i as registerLookupTool};
+//# sourceMappingURL=lookup.tool.js.map

package/packages/server/dist/tools/onboard.tool.d.ts

@@ -1,5 +1,9 @@
-import type { IEmbedder } from '@kb/embeddings';
-import type { IKnowledgeStore } from '@kb/store';
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare function registerOnboardTool(server: McpServer, store: IKnowledgeStore, embedder: IEmbedder): void;
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { IEmbedder } from "@kb/embeddings";
+import { IKnowledgeStore } from "@kb/store";
+
+//#region packages/server/src/tools/onboard.tool.d.ts
+declare function registerOnboardTool(server: McpServer, store: IKnowledgeStore, embedder: IEmbedder): void;
+//#endregion
+export { registerOnboardTool };
 //# sourceMappingURL=onboard.tool.d.ts.map

package/packages/server/dist/tools/onboard.tool.js

@@ -1,2 +1,3 @@
-import{createHash as m}from"node:crypto";import{onboard as g}from"../../../tools/dist/index.js";import{z as l}from"zod";async function f(c,p,d){for(const t of d.steps)if(!(t.status!=="success"||!t.output))try{const r=m("sha256").update(d.path).digest("hex").slice(0,12),u=`produced/onboard/${t.name}/${r}.md`,e=m("sha256").update(t.output).digest("hex").slice(0,16),s=new Date().toISOString(),a=t.output.length>2e3?t.output.split(/(?=^## )/m).filter(i=>i.trim().length>0):[t.output],n=a.map((i,h)=>({id:m("sha256").update(`${u}::${h}`).digest("hex").slice(0,16),content:i.trim(),sourcePath:u,contentType:"produced-knowledge",chunkIndex:h,totalChunks:a.length,startLine:0,endLine:0,fileHash:e,indexedAt:s,origin:"produced",tags:["onboard",t.name],category:"analysis",version:1})),o=await p.embedBatch(n.map(i=>i.content));await c.upsert(n,o)}catch(r){console.error(`[KB] Auto-persist onboard/${t.name} failed:`,r)}}function w(c,p,d){c.registerTool("onboard",{description:"First-time codebase onboarding: runs all analysis tools (structure, dependencies, entry-points, symbols, patterns, diagram) in one command. Results are auto-persisted to KB. Use mode=generate to also write structured output to .ai/kb/ directory.",inputSchema:{path:l.string().describe("Root path of the codebase to onboard"),mode:l.enum(["memory","generate"]).default("memory").describe("Output mode: memory = KB vector store only; generate = also write to .ai/kb/ directory"),out_dir:l.string().optional().describe("Custom output directory for generate mode (default: <path>/.ai/kb)")}},async({path:t,mode:r,out_dir:u})=>{try{console.error(`[KB] Starting onboard for: ${t} (mode: ${r})`);const e=await g({path:t,mode:r,outDir:u});f(p,d,e);const s=["## Onboard Complete","",`**Path:** \`${e.path}\``,`**Mode:** ${e.mode}`,`**Duration:** ${e.totalDurationMs}ms`,""];e.outDir&&(s.push(`**Output directory:** \`${e.outDir}\``),s.push("")),s.push("### Analysis Results","");const a=[],n=[];for(const o of e.steps)o.status==="success"?a.push(`- \u2713 **${o.name}** (${o.durationMs}ms) \u2014 ${o.output.length} chars`):n.push(`- \u2717 **${o.name}** \u2014 ${o.error}`);s.push(...a),n.length>0&&s.push("","### Failed","",...n),s.push("","---","");for(const o of e.steps)o.status==="success"&&s.push(`### ${o.name}`,"",o.output,"","---","");return s.push("_All results auto-saved to KB.",e.mode==="generate"?` Files written to \`${e.outDir}\`.`:""," Next: Use `search` to query the knowledge, or `remember` to add custom insights._"),{content:[{type:"text",text:s.join(`
-`)}]}}catch(e){return console.error("[KB] Onboard failed:",e),{content:[{type:"text",text:`Onboard failed: ${e.message}`}],isError:!0}}})}export{w as registerOnboardTool};
+import{createHash as e}from"node:crypto";import{createLogger as t,serializeError as n}from"../../../core/dist/index.js";import{onboard as r}from"../../../tools/dist/index.js";import{z as i}from"zod";const a=t(`tools`);async function o(t,r,i){for(let o of i.steps)if(!(o.status!==`success`||!o.output))try{let n=e(`sha256`).update(i.path).digest(`hex`).slice(0,12),a=`produced/onboard/${o.name}/${n}.md`,s=e(`sha256`).update(o.output).digest(`hex`).slice(0,16),c=new Date().toISOString(),l=o.output.length>2e3?o.output.split(/(?=^## )/m).filter(e=>e.trim().length>0):[o.output],u=l.map((t,n)=>({id:e(`sha256`).update(`${a}::${n}`).digest(`hex`).slice(0,16),content:t.trim(),sourcePath:a,contentType:`produced-knowledge`,chunkIndex:n,totalChunks:l.length,startLine:0,endLine:0,fileHash:s,indexedAt:c,origin:`produced`,tags:[`onboard`,o.name],category:`analysis`,version:1})),d=await r.embedBatch(u.map(e=>e.content));await t.upsert(u,d)}catch(e){a.warn(`Auto-persist onboard step failed`,{stepName:o.name,...n(e)})}}function s(e,t,s){e.registerTool(`onboard`,{description:`First-time codebase onboarding: runs all analysis tools (structure, dependencies, entry-points, symbols, patterns, diagram) in one command. Results are auto-persisted to KB. Use mode=generate to also write structured output to .ai/kb/ directory.`,inputSchema:{path:i.string().describe(`Root path of the codebase to onboard`),mode:i.enum([`memory`,`generate`]).default(`memory`).describe(`Output mode: memory = KB vector store only; generate = also write to .ai/kb/ directory`),out_dir:i.string().optional().describe(`Custom output directory for generate mode (default: <path>/.ai/kb)`)}},async({path:e,mode:i,out_dir:c})=>{try{a.info(`Starting onboard`,{path:e,mode:i});let n=await r({path:e,mode:i,outDir:c});o(t,s,n);let l=[`## Onboard Complete`,``,`**Path:** \`${n.path}\``,`**Mode:** ${n.mode}`,`**Duration:** ${n.totalDurationMs}ms`,``];n.outDir&&(l.push(`**Output directory:** \`${n.outDir}\``),l.push(``)),l.push(`### Analysis Results`,``);let u=[],d=[];for(let e of n.steps)e.status===`success`?u.push(`- ✓ **${e.name}** (${e.durationMs}ms) — ${e.output.length} chars`):d.push(`- ✗ **${e.name}** — ${e.error}`);l.push(...u),d.length>0&&l.push(``,`### Failed`,``,...d),l.push(``,`---`,``);for(let e of n.steps)e.status===`success`&&l.push(`### ${e.name}`,``,e.output,``,`---`,``);return l.push(`_All results auto-saved to KB.`,n.mode===`generate`?` Files written to \`${n.outDir}\`.`:``," Next: Use `search` to query the knowledge, or `remember` to add custom insights._"),{content:[{type:`text`,text:l.join(`
+`)}]}}catch(e){return a.error(`Onboard failed`,n(e)),{content:[{type:`text`,text:`Onboard failed. Check server logs for details.`}],isError:!0}}})}export{s as registerOnboardTool};
+//# sourceMappingURL=onboard.tool.js.map

package/packages/server/dist/tools/policy.tools.d.ts

@@ -0,0 +1,8 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { PolicyStore } from "@kb/enterprise-bridge";
+
+//#region packages/server/src/tools/policy.tools.d.ts
+declare function registerErUpdatePolicyTool(server: McpServer, policyStore: PolicyStore): void;
+//#endregion
+export { registerErUpdatePolicyTool };
+//# sourceMappingURL=policy.tools.d.ts.map

package/packages/server/dist/tools/policy.tools.js

@@ -0,0 +1,3 @@
+import{createLogger as e,serializeError as t}from"../../../core/dist/index.js";import{z as n}from"zod";const r=e(`tools`);function i(e,i){e.registerTool(`er_update_policy`,{description:`Manage ER push classification rules. Supports listing, updating, creating, and deleting rules that determine when knowledge should be pushed to Enterprise RAG.`,inputSchema:{action:n.enum([`list`,`get`,`update`,`create`,`delete`]).describe(`Action to perform on classification rules`),rule_id:n.string().optional().describe(`Rule ID (required for get, update, delete)`),changes:n.object({patterns:n.array(n.string()).optional(),category:n.string().optional(),pushWeight:n.number().min(0).max(1).optional(),description:n.string().optional(),examples:n.array(n.string()).optional(),enabled:n.boolean().optional()}).optional().describe(`Changes to apply (for update action)`),new_rule:n.object({id:n.string().regex(/^[a-z][a-z0-9-]*$/),patterns:n.array(n.string()).min(1),category:n.string(),pushWeight:n.number().min(0).max(1),description:n.string(),examples:n.array(n.string()).default([]),enabled:n.boolean().default(!0)}).optional().describe(`New rule definition (for create action)`)}},async({action:e,rule_id:n,changes:a,new_rule:o})=>{try{if(e===`list`){let e=i.getRules();return{content:[{type:`text`,text:`## Classification Rules\n\n${e.map(e=>`- **${e.id}** (${e.enabled?`enabled`:`disabled`}) — ${e.description}\n  Category: ${e.category} | Weight: ${e.pushWeight} | Patterns: ${e.patterns.join(`, `)}`).join(`
+`)}\n\n---\n_${e.length} rules total. Use \`action: "update"\` to modify a rule._`}]}}if(e===`get`){if(!n)return{content:[{type:`text`,text:'`rule_id` is required for "get" action.'}],isError:!0};let e=i.getRule(n);return e?{content:[{type:`text`,text:`## Rule: ${e.id}\n\n${JSON.stringify(e,null,2)}`}]}:{content:[{type:`text`,text:`Rule "${n}" not found.`}],isError:!0}}if(e===`update`){if(!n||!a)return{content:[{type:`text`,text:'`rule_id` and `changes` are required for "update" action.'}],isError:!0};let e=i.updateRule(n,a);return e?{content:[{type:`text`,text:`Updated rule **${n}**.\n\n${JSON.stringify(e,null,2)}\n\n---\n_Next: Use \`action: "list"\` to verify all rules._`}]}:{content:[{type:`text`,text:`Rule "${n}" not found.`}],isError:!0}}if(e===`create`){if(!o)return{content:[{type:`text`,text:'`new_rule` is required for "create" action.'}],isError:!0};let e=i.addRule(o);return{content:[{type:`text`,text:`Created rule **${e.id}**.\n\n${JSON.stringify(e,null,2)}\n\n---\n_Next: Test classification with \`remember\` and check signals._`}]}}return e===`delete`?n?i.deleteRule(n)?{content:[{type:`text`,text:`Deleted rule **${n}**.\n\n---\n_Next: Use \`action: "list"\` to verify._`}]}:{content:[{type:`text`,text:`Rule "${n}" not found.`}],isError:!0}:{content:[{type:`text`,text:'`rule_id` is required for "delete" action.'}],isError:!0}:{content:[{type:`text`,text:`Unknown action: ${e}`}],isError:!0}}catch(e){return r.error(`Policy update failed`,t(e)),{content:[{type:`text`,text:`Policy update failed. Check server logs for details.`}],isError:!0}}})}export{i as registerErUpdatePolicyTool};
+//# sourceMappingURL=policy.tools.js.map

package/packages/server/dist/tools/produce.tool.d.ts

@@ -1,3 +1,7 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare function registerProduceKnowledgeTool(server: McpServer): void;
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region packages/server/src/tools/produce.tool.d.ts
+declare function registerProduceKnowledgeTool(server: McpServer): void;
+//#endregion
+export { registerProduceKnowledgeTool };
 //# sourceMappingURL=produce.tool.d.ts.map

package/packages/server/dist/tools/produce.tool.js

@@ -1,4 +1,5 @@
-import{DependencyAnalyzer as c,DiagramGenerator as d,EntryPointAnalyzer as l,KnowledgeProducer as u,PatternAnalyzer as p,StructureAnalyzer as y,SymbolAnalyzer as m}from"../../../analyzers/dist/index.js";import{z as n}from"zod";function h(o){const s={structure:new y,dependencies:new c,symbols:new m,patterns:new p,entryPoints:new l,diagrams:new d},r=new u(s);o.registerTool("produce_knowledge",{description:"Run automated codebase analysis and produce synthesis instructions. Executes Tier 1 deterministic analyzers, then returns structured baselines and instructions for you to synthesize knowledge using remember.",inputSchema:{scope:n.string().optional().describe("Root path to analyze (defaults to workspace root)"),aspects:n.array(n.enum(["all","structure","dependencies","symbols","patterns","entry-points","diagrams"])).default(["all"]).describe("Which analysis aspects to run")}},async({scope:i,aspects:t})=>{try{const e=i??".";console.error(`[KB] Running knowledge production for: ${e}, aspects: ${t.join(", ")}`);const a=await r.runExtraction(e,t);return{content:[{type:"text",text:r.buildSynthesisInstructions(a,t)+`
+import{DependencyAnalyzer as e,DiagramGenerator as t,EntryPointAnalyzer as n,KnowledgeProducer as r,PatternAnalyzer as i,StructureAnalyzer as a,SymbolAnalyzer as o}from"../../../analyzers/dist/index.js";import{createLogger as s,serializeError as c}from"../../../core/dist/index.js";import{z as l}from"zod";const u=s(`tools`);function d(s){let d=new r({structure:new a,dependencies:new e,symbols:new o,patterns:new i,entryPoints:new n,diagrams:new t});s.registerTool(`produce_knowledge`,{description:`Run automated codebase analysis and produce synthesis instructions. Executes Tier 1 deterministic analyzers, then returns structured baselines and instructions for you to synthesize knowledge using remember.`,inputSchema:{scope:l.string().optional().describe(`Root path to analyze (defaults to workspace root)`),aspects:l.array(l.enum([`all`,`structure`,`dependencies`,`symbols`,`patterns`,`entry-points`,`diagrams`])).default([`all`]).describe(`Which analysis aspects to run`)}},async({scope:e,aspects:t})=>{try{let n=e??`.`;u.info(`Running knowledge production`,{rootPath:n,aspects:t});let r=await d.runExtraction(n,t);return{content:[{type:`text`,text:d.buildSynthesisInstructions(r,t)+`
 
 ---
-_Next: Review the baselines above and use \`remember\` to store synthesized knowledge entries._`}]}}catch(e){return console.error("[KB] Knowledge production failed:",e),{content:[{type:"text",text:`Knowledge production failed: ${e.message}`}],isError:!0}}})}export{h as registerProduceKnowledgeTool};
+_Next: Review the baselines above and use \`remember\` to store synthesized knowledge entries._`}]}}catch(e){return u.error(`Knowledge production failed`,c(e)),{content:[{type:`text`,text:`Knowledge production failed. Check server logs for details.`}],isError:!0}}})}export{d as registerProduceKnowledgeTool};
+//# sourceMappingURL=produce.tool.js.map

package/packages/server/dist/tools/read.tool.d.ts

@@ -1,4 +1,8 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { CuratedKnowledgeManager } from '../curated-manager.js';
-export declare function registerReadTool(server: McpServer, curated: CuratedKnowledgeManager): void;
+import { CuratedKnowledgeManager } from "../curated-manager.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region packages/server/src/tools/read.tool.d.ts
+declare function registerReadTool(server: McpServer, curated: CuratedKnowledgeManager): void;
+//#endregion
+export { registerReadTool };
 //# sourceMappingURL=read.tool.d.ts.map

package/packages/server/dist/tools/read.tool.js

@@ -1,6 +1,3 @@
-import{z as o}from"zod";function i(r,a){r.registerTool("read",{description:"Read the full content of a specific curated knowledge entry by its path. Use list first to discover available entries.",inputSchema:{path:o.string().describe('Relative path within curated/ (e.g., "decisions/use-lancedb.md")')}},async({path:t})=>{try{const e=await a.read(t);return{content:[{type:"text",text:`${[`## ${e.title}`,`- **Path**: curated/${t}`,`- **Category**: ${e.category}`,e.tags.length?`- **Tags**: ${e.tags.join(", ")}`:null,`- **Version**: ${e.version}`,`- **Created**: ${e.created}`,e.updated!==e.created?`- **Updated**: ${e.updated}`:null,""].filter(n=>n!==null).join(`
-`)}
-${e.content}
-
----
-_Next: Use \`update\` to modify this entry, or \`search\` to find related entries._`}]}}catch(e){return console.error("[KB] Read failed:",e),{content:[{type:"text",text:`Read failed: ${e.message}`}],isError:!0}}})}export{i as registerReadTool};
+import{createLogger as e,serializeError as t}from"../../../core/dist/index.js";import{z as n}from"zod";const r=e(`tools`);function i(e,i){e.registerTool(`read`,{description:`Read the full content of a specific curated knowledge entry by its path. Use list first to discover available entries.`,inputSchema:{path:n.string().describe(`Relative path within curated/ (e.g., "decisions/use-lancedb.md")`)}},async({path:e})=>{try{let t=await i.read(e);return{content:[{type:`text`,text:`${[`## ${t.title}`,`- **Path**: curated/${e}`,`- **Category**: ${t.category}`,t.tags.length?`- **Tags**: ${t.tags.join(`, `)}`:null,`- **Version**: ${t.version}`,`- **Created**: ${t.created}`,t.updated===t.created?null:`- **Updated**: ${t.updated}`,``].filter(e=>e!==null).join(`
+`)}\n${t.content}\n\n---\n_Next: Use \`update\` to modify this entry, or \`search\` to find related entries._`}]}}catch(e){return r.error(`Read failed`,t(e)),{content:[{type:`text`,text:`Read failed. Check server logs for details.`}],isError:!0}}})}export{i as registerReadTool};
+//# sourceMappingURL=read.tool.js.map

package/packages/server/dist/tools/reindex.tool.d.ts

@@ -1,7 +1,11 @@
-import type { KBConfig } from '@kb/core';
-import type { IncrementalIndexer } from '@kb/indexer';
-import type { IKnowledgeStore } from '@kb/store';
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { CuratedKnowledgeManager } from '../curated-manager.js';
-export declare function registerReindexTool(server: McpServer, indexer: IncrementalIndexer, config: KBConfig, curated: CuratedKnowledgeManager, store?: IKnowledgeStore): void;
+import { CuratedKnowledgeManager } from "../curated-manager.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { KBConfig } from "@kb/core";
+import { IncrementalIndexer } from "@kb/indexer";
+import { IKnowledgeStore } from "@kb/store";
+
+//#region packages/server/src/tools/reindex.tool.d.ts
+declare function registerReindexTool(server: McpServer, indexer: IncrementalIndexer, config: KBConfig, curated: CuratedKnowledgeManager, store?: IKnowledgeStore): void;
+//#endregion
+export { registerReindexTool };
 //# sourceMappingURL=reindex.tool.d.ts.map

package/packages/server/dist/tools/reindex.tool.js

@@ -1,2 +1,3 @@
-import{z as u}from"zod";function f(l,i,o,c,d){l.registerTool("reindex",{description:"Trigger re-indexing of the knowledge base. Can do incremental (only changed files) or full re-index.",inputSchema:{full:u.boolean().default(!1).describe("If true, force full re-index ignoring file hashes")}},async({full:a})=>{try{console.error(`[KB] Starting ${a?"full":"incremental"} re-index...`);const r=e=>s=>{s.phase==="chunking"&&s.currentFile&&console.error(`[KB] ${e} [${s.filesProcessed+1}/${s.filesTotal}] ${s.currentFile}`)},t=a?await i.reindexAll(o,r("Reindex")):await i.index(o,r("Index")),n=["## Re-index Complete","",`- **Files Processed**: ${t.filesProcessed}`,`- **Files Skipped** (unchanged): ${t.filesSkipped}`,`- **Chunks Created**: ${t.chunksCreated}`,`- **Files Removed**: ${t.filesRemoved}`,`- **Duration**: ${(t.durationMs/1e3).toFixed(1)}s`];if(d)try{await d.createFtsIndex()}catch(e){n.push("",`- **FTS Index Failed**: ${e.message}`)}try{const e=await c.reindexAll();n.push("",`- **Curated Entries Re-indexed**: ${e.indexed}`),e.errors.length>0&&n.push(`- **Curated Errors**: ${e.errors.length}`),console.error(`[KB] Curated re-index: ${e.indexed} entries`)}catch(e){n.push("",`- **Curated Re-index Failed**: ${e.message}`),console.error("[KB] Curated re-index failed:",e)}return{content:[{type:"text",text:n.join(`
-`)+"\n\n---\n_Next: Use `search` to query the refreshed index, or `status` to verify index stats._"}]}}catch(r){return console.error("[KB] Reindex failed:",r),{content:[{type:"text",text:`Reindex failed: ${r.message}`}],isError:!0}}})}export{f as registerReindexTool};
+import{createLogger as e,serializeError as t}from"../../../core/dist/index.js";import{z as n}from"zod";const r=e(`tools`);function i(e,i,a,o,s){e.registerTool(`reindex`,{description:`Trigger re-indexing of the knowledge base. Can do incremental (only changed files) or full re-index.`,inputSchema:{full:n.boolean().default(!1).describe(`If true, force full re-index ignoring file hashes`)}},async({full:e})=>{try{r.info(`Starting re-index`,{mode:e?`full`:`incremental`});let n=e=>t=>{t.phase===`chunking`&&t.currentFile&&r.debug(`Re-index progress`,{prefix:e,current:t.filesProcessed+1,total:t.filesTotal,file:t.currentFile})},c=e?await i.reindexAll(a,n(`Reindex`)):await i.index(a,n(`Index`)),l=[`## Re-index Complete`,``,`- **Files Processed**: ${c.filesProcessed}`,`- **Files Skipped** (unchanged): ${c.filesSkipped}`,`- **Chunks Created**: ${c.chunksCreated}`,`- **Files Removed**: ${c.filesRemoved}`,`- **Duration**: ${(c.durationMs/1e3).toFixed(1)}s`];if(s)try{await s.createFtsIndex()}catch(e){l.push(``,`- **FTS Index Failed**: ${e.message}`)}try{let e=await o.reindexAll();l.push(``,`- **Curated Entries Re-indexed**: ${e.indexed}`),e.errors.length>0&&l.push(`- **Curated Errors**: ${e.errors.length}`),r.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){l.push(``,`- **Curated Re-index Failed**: ${e.message}`),r.warn(`Curated re-index failed`,t(e))}return{content:[{type:`text`,text:l.join(`
+`)+"\n\n---\n_Next: Use `search` to query the refreshed index, or `status` to verify index stats._"}]}}catch(e){return r.error(`Reindex failed`,t(e)),{content:[{type:`text`,text:`Reindex failed. Check server logs for details.`}],isError:!0}}})}export{i as registerReindexTool};
+//# sourceMappingURL=reindex.tool.js.map

package/packages/server/dist/tools/remember.tool.d.ts

@@ -1,4 +1,9 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { CuratedKnowledgeManager } from '../curated-manager.js';
-export declare function registerRememberTool(server: McpServer, curated: CuratedKnowledgeManager): void;
+import { CuratedKnowledgeManager } from "../curated-manager.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { EvolutionCollector, PolicyStore } from "@kb/enterprise-bridge";
+
+//#region packages/server/src/tools/remember.tool.d.ts
+declare function registerRememberTool(server: McpServer, curated: CuratedKnowledgeManager, policyStore?: PolicyStore, evolutionCollector?: EvolutionCollector): void;
+//#endregion
+export { registerRememberTool };
 //# sourceMappingURL=remember.tool.d.ts.map

package/packages/server/dist/tools/remember.tool.js

@@ -1,6 +1,5 @@
-import{z as e}from"zod";function d(n,o){n.registerTool("remember",{description:"Store a new piece of curated knowledge. Use this to persist decisions, patterns, conventions, or any insight worth remembering across sessions.",inputSchema:{title:e.string().min(3).max(120).describe("Short descriptive title for the knowledge entry"),content:e.string().min(10).describe("The markdown content to store"),category:e.string().regex(/^[a-z][a-z0-9-]*$/).describe('Category slug (e.g., "decisions", "patterns", "conventions", "api-contracts")'),tags:e.array(e.string()).default([]).describe("Optional tags for filtering")}},async({title:t,content:s,category:i,tags:a})=>{try{const r=await o.remember(t,s,i,a);return{content:[{type:"text",text:`Remembered: **${t}**
+import{createLogger as e,serializeError as t}from"../../../core/dist/index.js";import{z as n}from"zod";const r=e(`tools`);function i(e,i,a,o){e.registerTool(`remember`,{description:`Store a new piece of curated knowledge. Use this to persist decisions, patterns, conventions, or any insight worth remembering across sessions.`,inputSchema:{title:n.string().min(3).max(120).describe(`Short descriptive title for the knowledge entry`),content:n.string().min(10).max(1e5).describe(`The markdown content to store`),category:n.string().regex(/^[a-z][a-z0-9-]*$/).describe(`Category slug (e.g., "decisions", "patterns", "conventions", "api-contracts")`),tags:n.array(n.string()).default([]).describe(`Optional tags for filtering`)}},async({title:e,content:n,category:s,tags:c})=>{try{let t=await i.remember(e,n,s,c),r=``;if(a){let t=a.classify(e,n,c);o&&o.recordClassification(e,t.matchingRules.map(e=>e.ruleId),t.pushRecommended),t.matchingRules.length>0&&(r=`\n\n### Classification Signals\n${t.matchingRules.map(e=>`  - **${e.ruleId}** (${e.category}, weight: ${e.pushWeight}) — matched: ${e.matchedPatterns.join(`, `)}`).join(`
+`)}\n- **Push recommended**: ${t.pushRecommended?`yes`:`no`} (max weight: ${t.maxPushWeight})`,t.pushRecommended&&(r+=`
 
-Stored at \`curated/${r.path}\` and indexed for semantic search.
-
----
-_Next: Use \`search\` to verify the entry is findable, or \`list\` to see all curated entries._`}]}}catch(r){return console.error("[KB] Remember failed:",r),{content:[{type:"text",text:`Remember failed: ${r.message}`}],isError:!0}}})}export{d as registerRememberTool};
+> 💡 This entry matches push rules. Consider \`er_push\` to share with Enterprise RAG.`))}return{content:[{type:`text`,text:`Remembered: **${e}**\n\nStored at \`curated/${t.path}\` and indexed for semantic search.${r}\n\n---\n_Next: Use \`search\` to verify the entry is findable, or \`list\` to see all curated entries._`}]}}catch(e){return r.error(`Remember failed`,t(e)),{content:[{type:`text`,text:`Remember failed. Check server logs for details.`}],isError:!0}}})}export{i as registerRememberTool};
+//# sourceMappingURL=remember.tool.js.map