@vpxa/kb 0.1.13 → 0.1.16

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

@@ -1,31 +1,43 @@
-import type { KBConfig } from '@kb/core';
-import { OnnxEmbedder } from '@kb/embeddings';
-import { IncrementalIndexer } from '@kb/indexer';
-import type { IGraphStore } from '@kb/store';
-import { createStore } from '@kb/store';
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { CuratedKnowledgeManager } from './curated-manager.js';
-export interface KnowledgeBaseComponents {
-    embedder: OnnxEmbedder;
-    store: Awaited<ReturnType<typeof createStore>>;
-    indexer: IncrementalIndexer;
-    curated: CuratedKnowledgeManager;
-    graphStore: IGraphStore;
+import { CuratedKnowledgeManager } from "./curated-manager.js";
+import { BridgeComponents } from "./tools/bridge.tools.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { KBConfig } from "@kb/core";
+import { OnnxEmbedder } from "@kb/embeddings";
+import { EvolutionCollector, PolicyStore } from "@kb/enterprise-bridge";
+import { IncrementalIndexer } from "@kb/indexer";
+import { IGraphStore, createStore } from "@kb/store";
+import { FileCache } from "@kb/tools";
+
+//#region packages/server/src/server.d.ts
+interface KnowledgeBaseComponents {
+  embedder: OnnxEmbedder;
+  store: Awaited<ReturnType<typeof createStore>>;
+  indexer: IncrementalIndexer;
+  curated: CuratedKnowledgeManager;
+  graphStore: IGraphStore;
+  fileCache: FileCache;
+  bridge?: BridgeComponents;
+  policyStore?: PolicyStore;
+  evolutionCollector?: EvolutionCollector;
+  onboardComplete: boolean;
+  onboardTimestamp?: string;
 }
-export declare function initializeKnowledgeBase(config: KBConfig): Promise<KnowledgeBaseComponents>;
-export declare function createMcpServer(kb: KnowledgeBaseComponents, config: KBConfig): McpServer;
-export declare function registerMcpTools(server: McpServer, kb: KnowledgeBaseComponents, config: KBConfig): void;
+declare function initializeKnowledgeBase(config: KBConfig): Promise<KnowledgeBaseComponents>;
+declare function createMcpServer(kb: KnowledgeBaseComponents, config: KBConfig): McpServer;
+declare function registerMcpTools(server: McpServer, kb: KnowledgeBaseComponents, config: KBConfig): void;
 /**
  * Create a fully-initialized server (HTTP mode or when immediate readiness is needed).
  */
-export declare function createServer(config: KBConfig): Promise<{
-    server: McpServer;
-    runInitialIndex: () => Promise<void>;
-    shutdown: () => Promise<void>;
+declare function createServer(config: KBConfig): Promise<{
+  server: McpServer;
+  runInitialIndex: () => Promise<void>;
+  shutdown: () => Promise<void>;
 }>;
-export declare function createLazyServer(config: KBConfig): {
-    server: McpServer;
-    ready: Promise<void>;
-    runInitialIndex: () => Promise<void>;
+declare const ALL_TOOL_NAMES: readonly ["analyze_dependencies", "analyze_diagram", "analyze_entry_points", "analyze_patterns", "analyze_structure", "analyze_symbols", "audit", "batch", "blast_radius", "changelog", "check", "checkpoint", "codemod", "compact", "data_transform", "dead_symbols", "delegate", "diff_parse", "digest", "encode", "env", "eval", "evidence_map", "file_summary", "find", "forge_classify", "forge_ground", "forget", "git_context", "graph", "guide", "health", "http", "lane", "list", "lookup", "measure", "onboard", "parse_output", "process", "produce_knowledge", "queue", "read", "regex_test", "reindex", "remember", "rename", "replay", "schema_validate", "scope_map", "search", "snippet", "stash", "status", "stratum_card", "symbol", "test_run", "time", "trace", "update", "watch", "web_fetch", "web_search", "workset"];
+declare function createLazyServer(config: KBConfig): {
+  server: McpServer;
+  ready: Promise<void>;
+  runInitialIndex: () => Promise<void>;
 };
-//# sourceMappingURL=server.d.ts.map
+//#endregion
+export { ALL_TOOL_NAMES, KnowledgeBaseComponents, createLazyServer, createMcpServer, createServer, initializeKnowledgeBase, registerMcpTools };

package/packages/server/dist/server.js

@@ -1 +1 @@
-import{initializeTreeSitter as x}from"../../chunker/dist/index.js";import{OnnxEmbedder as y}from"../../embeddings/dist/index.js";import{IncrementalIndexer as w}from"../../indexer/dist/index.js";import{createStore as K,SqliteGraphStore as S}from"../../store/dist/index.js";import{McpServer as h}from"@modelcontextprotocol/sdk/server/mcp.js";import{CuratedKnowledgeManager as B}from"./curated-manager.js";import{installReplayInterceptor as C}from"./replay-interceptor.js";import{registerResources as I}from"./resources/resources.js";import{registerAnalyzeDependenciesTool as P,registerAnalyzeDiagramTool as _,registerAnalyzeEntryPointsTool as z,registerAnalyzePatternsTool as $,registerAnalyzeStructureTool as M,registerAnalyzeSymbolsTool as F,registerBlastRadiusTool as R}from"./tools/analyze.tools.js";import{registerAuditTool as b}from"./tools/audit.tool.js";import{registerDigestTool as E,registerEvidenceMapTool as A,registerForgeClassifyTool as G,registerForgeGroundTool as D,registerStratumCardTool as L}from"./tools/forge.tools.js";import{registerForgetTool as O}from"./tools/forget.tool.js";import{registerGraphTool as j}from"./tools/graph.tool.js";import{registerListTool as W}from"./tools/list.tool.js";import{registerLookupTool as q}from"./tools/lookup.tool.js";import{registerOnboardTool as H}from"./tools/onboard.tool.js";import{registerProduceKnowledgeTool as N}from"./tools/produce.tool.js";import{registerReadTool as Q}from"./tools/read.tool.js";import{registerReindexTool as U}from"./tools/reindex.tool.js";import{registerRememberTool as V}from"./tools/remember.tool.js";import{registerReplayTool as J}from"./tools/replay.tool.js";import{registerSearchTool as X}from"./tools/search.tool.js";import{registerStatusTool as Y}from"./tools/status.tool.js";import{registerBatchTool as Z,registerCheckpointTool as k,registerCheckTool as v,registerCodemodTool as ee,registerCompactTool as oe,registerDataTransformTool as re,registerDeadSymbolsTool as te,registerDelegateTool as ie,registerDiffParseTool as ne,registerEvalTool as se,registerFileSummaryTool as ae,registerFindTool as le,registerGitContextTool as de,registerGuideTool as ce,registerHealthTool as me,registerLaneTool as pe,registerParseOutputTool as ge,registerProcessTool as ue,registerQueueTool as he,registerRenameTool as Te,registerScopeMapTool as fe,registerStashTool as xe,registerSymbolTool as ye,registerTestRunTool as we,registerTraceTool as Ke,registerWatchTool as Se,registerWebFetchTool as Be,registerWorksetTool as Ce}from"./tools/toolkit.tools.js";import{registerUpdateTool as Ie}from"./tools/update.tool.js";import{registerChangelogTool as Pe,registerEncodeTool as _e,registerEnvTool as ze,registerHttpTool as $e,registerMeasureTool as Me,registerRegexTestTool as Fe,registerSchemaValidateTool as Re,registerSnippetTool as be,registerTimeTool as Ee,registerWebSearchTool as Ae}from"./tools/utility.tools.js";async function T(e){console.error("[KB] Initializing knowledge base components...");const o=new y({model:e.embedding.model,dimensions:e.embedding.dimensions});await o.initialize(),console.error(`[KB] Embedder loaded: ${o.modelId} (${o.dimensions}d)`);const n=await K({backend:e.store.backend,path:e.store.path});await n.initialize(),console.error("[KB] Store initialized");const d=new w(o,n),a=e.curated.path,c=new B(a,n,o),s=new S({path:e.store.path});await s.initialize(),console.error("[KB] Graph store initialized"),d.setGraphStore(s);const l=await x();return console.error(l?"[KB] Tree-sitter chunking enabled":"[KB] Tree-sitter not available \u2014 using regex-based code chunking"),{embedder:o,store:n,indexer:d,curated:c,graphStore:s}}function Ge(e,o){const n=new h({name:"kb",version:"0.1.0"});return f(n,e,o),n}function f(e,o,n){C(e),X(e,o.embedder,o.store,o.graphStore),q(e,o.store),Y(e,o.store,o.graphStore),U(e,o.indexer,n,o.curated,o.store),V(e,o.curated),Ie(e,o.curated),O(e,o.curated),Q(e,o.curated),W(e,o.curated),M(e,o.store,o.embedder),P(e,o.store,o.embedder),F(e,o.store,o.embedder),$(e,o.store,o.embedder),z(e,o.store,o.embedder),_(e,o.store,o.embedder),R(e,o.store,o.embedder),N(e),H(e,o.store,o.embedder),j(e,o.graphStore),b(e,o.store,o.embedder),oe(e,o.embedder),fe(e,o.embedder,o.store),le(e,o.embedder,o.store),ge(e),Ce(e),v(e),Z(e,o.embedder,o.store),ye(e,o.embedder,o.store),se(e),we(e),xe(e),de(e),ne(e),Te(e),ee(e),ae(e),k(e),re(e),Ke(e,o.embedder,o.store),ue(e),Se(e),te(e,o.embedder,o.store),ie(e),me(e),pe(e),he(e),Be(e),ce(e),A(e),E(e,o.embedder),G(e),L(e,o.embedder),D(e,o.embedder,o.store),Ae(e),$e(e),Fe(e),_e(e),Me(e),Pe(e),Re(e),be(e),ze(e),Ee(e),I(e,o.store),J(e)}async function mo(e){const o=await T(e),n=Ge(o,e);console.error("[KB] MCP server configured with 64 tools and 2 resources");const d=async()=>{try{const l=e.sources.map(r=>r.path).join(", ");console.error(`[KB] Running initial index for sources: ${l}`);const m=await o.indexer.index(e,r=>{r.phase==="crawling"||r.phase==="done"||(r.phase==="chunking"&&r.currentFile&&console.error(`[KB]   [${r.filesProcessed+1}/${r.filesTotal}] ${r.currentFile}`),r.phase==="cleanup"&&console.error(`[KB]   cleanup: removing ${r.filesTotal-r.filesProcessed} stale entries`))});console.error(`[KB] Indexed ${m.filesProcessed} files (${m.filesSkipped} skipped, ${m.chunksCreated} chunks) in ${(m.durationMs/1e3).toFixed(1)}s`);try{await o.store.createFtsIndex()}catch(r){console.error("[KB] FTS index creation failed (non-fatal):",r)}try{const r=await o.curated.reindexAll();console.error(`[KB] Curated re-index: ${r.indexed} entries restored to vector store`)}catch(r){console.error("[KB] Curated re-index failed:",r)}}catch(l){console.error("[KB] Initial index failed (will retry on kb_reindex):",l)}},a=async()=>{console.error("[KB] Shutting down..."),await o.graphStore.close().catch(()=>{}),await o.store.close(),process.exit(0)};process.on("SIGINT",a),process.on("SIGTERM",a);const c=process.ppid,s=setInterval(()=>{try{process.kill(c,0)}catch{console.error("[KB] Parent process died \u2014 orphan detected, shutting down..."),clearInterval(s),a()}},5e3);return s.unref(),{server:n,runInitialIndex:d,shutdown:a}}const De=["analyze_dependencies","analyze_diagram","analyze_entry_points","analyze_patterns","analyze_structure","analyze_symbols","batch","blast_radius","changelog","check","checkpoint","codemod","compact","data_transform","dead_symbols","delegate","diff_parse","digest","encode","env","eval","evidence_map","file_summary","find","forge_classify","forge_ground","forget","git_context","graph","guide","health","http","lane","list","lookup","measure","onboard","parse_output","process","produce_knowledge","queue","read","regex_test","reindex","remember","rename","replay","schema_validate","scope_map","search","snippet","stash","status","stratum_card","symbol","test_run","time","trace","update","watch","web_fetch","web_search","workset"];function po(e){const o=new h({name:"kb",version:"0.1.0"}),n="KB is still initializing, please retry in a few seconds.",d=De.map(i=>o.registerTool(i,{description:`${i} (initializing...)`,inputSchema:{}},async()=>({content:[{type:"text",text:n}]}))),a=o.resource("kb-status","kb://status",{description:"Knowledge base status (initializing...)",mimeType:"text/plain"},async()=>({contents:[{uri:"kb://status",text:"KB is initializing...",mimeType:"text/plain"}]}));let c;const s=new Promise(i=>{c=i}),l=(async()=>{const i=await T(e);for(const p of d)p.remove();a.remove(),f(o,i,e),console.error("[KB] MCP server configured with 64 tools and 2 resources"),c?.(i)})(),m=async()=>{const i=await s;try{const p=e.sources.map(t=>t.path).join(", ");console.error(`[KB] Running initial index for sources: ${p}`);const g=await i.indexer.index(e,t=>{t.phase==="crawling"||t.phase==="done"||(t.phase==="chunking"&&t.currentFile&&console.error(`[KB]   [${t.filesProcessed+1}/${t.filesTotal}] ${t.currentFile}`),t.phase==="cleanup"&&console.error(`[KB]   cleanup: removing ${t.filesTotal-t.filesProcessed} stale entries`))});console.error(`[KB] Indexed ${g.filesProcessed} files (${g.filesSkipped} skipped, ${g.chunksCreated} chunks) in ${(g.durationMs/1e3).toFixed(1)}s`);try{await i.store.createFtsIndex()}catch(t){console.error("[KB] FTS index creation failed (non-fatal):",t)}try{const t=await i.curated.reindexAll();console.error(`[KB] Curated re-index: ${t.indexed} entries restored to vector store`)}catch(t){console.error("[KB] Curated re-index failed:",t)}}catch(p){console.error("[KB] Initial index failed (will retry on kb_reindex):",p)}},r=process.ppid,u=setInterval(()=>{try{process.kill(r,0)}catch{console.error("[KB] Parent process died \u2014 orphan detected, shutting down..."),clearInterval(u),s.then(i=>{i.graphStore.close().catch(()=>{}),i.store.close()}).catch(()=>{}),process.exit(0)}},5e3);return u.unref(),{server:o,ready:l,runInitialIndex:m}}export{po as createLazyServer,Ge as createMcpServer,mo as createServer,T as initializeKnowledgeBase,f as registerMcpTools};
+import{CuratedKnowledgeManager as e}from"./curated-manager.js";import{installReplayInterceptor as t}from"./replay-interceptor.js";import{registerResources as n}from"./resources/resources.js";import{registerAnalyzeDependenciesTool as r,registerAnalyzeDiagramTool as i,registerAnalyzeEntryPointsTool as a,registerAnalyzePatternsTool as o,registerAnalyzeStructureTool as s,registerAnalyzeSymbolsTool as c,registerBlastRadiusTool as l}from"./tools/analyze.tools.js";import{registerAuditTool as u}from"./tools/audit.tool.js";import{initBridgeComponents as d,registerErPullTool as f,registerErPushTool as p,registerErSyncStatusTool as m}from"./tools/bridge.tools.js";import{registerErEvolveReviewTool as ee}from"./tools/evolution.tools.js";import{registerDigestTool as te,registerEvidenceMapTool as ne,registerForgeClassifyTool as re,registerForgeGroundTool as ie,registerStratumCardTool as ae}from"./tools/forge.tools.js";import{registerForgetTool as oe}from"./tools/forget.tool.js";import{registerGraphTool as se}from"./tools/graph.tool.js";import{registerListTool as ce}from"./tools/list.tool.js";import{registerLookupTool as le}from"./tools/lookup.tool.js";import{registerOnboardTool as ue}from"./tools/onboard.tool.js";import{registerErUpdatePolicyTool as h}from"./tools/policy.tools.js";import{registerProduceKnowledgeTool as g}from"./tools/produce.tool.js";import{registerReadTool as _}from"./tools/read.tool.js";import{registerReindexTool as v}from"./tools/reindex.tool.js";import{registerRememberTool as y}from"./tools/remember.tool.js";import{registerReplayTool as b}from"./tools/replay.tool.js";import{registerSearchTool as x}from"./tools/search.tool.js";import{registerStatusTool as S}from"./tools/status.tool.js";import{registerBatchTool as C,registerCheckTool as w,registerCheckpointTool as T,registerCodemodTool as E,registerCompactTool as D,registerDataTransformTool as O,registerDeadSymbolsTool as k,registerDelegateTool as A,registerDiffParseTool as j,registerEvalTool as M,registerFileSummaryTool as N,registerFindTool as P,registerGitContextTool as F,registerGuideTool as I,registerHealthTool as L,registerLaneTool as R,registerParseOutputTool as z,registerProcessTool as B,registerQueueTool as V,registerRenameTool as H,registerScopeMapTool as U,registerStashTool as de,registerSymbolTool as fe,registerTestRunTool as pe,registerTraceTool as me,registerWatchTool as he,registerWebFetchTool as ge,registerWorksetTool as _e}from"./tools/toolkit.tools.js";import{registerUpdateTool as W}from"./tools/update.tool.js";import{registerChangelogTool as ve,registerEncodeTool as ye,registerEnvTool as be,registerHttpTool as xe,registerMeasureTool as Se,registerRegexTestTool as Ce,registerSchemaValidateTool as we,registerSnippetTool as Te,registerTimeTool as Ee,registerWebSearchTool as De}from"./tools/utility.tools.js";import{getCurrentVersion as G}from"./version-check.js";import{existsSync as Oe,statSync as ke}from"node:fs";import{resolve as Ae}from"node:path";import{KB_PATHS as je,createLogger as Me,serializeError as K}from"../../core/dist/index.js";import{initializeWasm as Ne}from"../../chunker/dist/index.js";import{OnnxEmbedder as Pe}from"../../embeddings/dist/index.js";import{EvolutionCollector as Fe,PolicyStore as Ie}from"../../enterprise-bridge/dist/index.js";import{IncrementalIndexer as Le}from"../../indexer/dist/index.js";import{SqliteGraphStore as Re,createStore as ze}from"../../store/dist/index.js";import{FileCache as Be}from"../../tools/dist/index.js";import{McpServer as q}from"@modelcontextprotocol/sdk/server/mcp.js";const J=Me(`server`);async function Y(t){J.info(`Initializing knowledge base components`);let n=new Pe({model:t.embedding.model,dimensions:t.embedding.dimensions});await n.initialize(),J.info(`Embedder loaded`,{modelId:n.modelId,dimensions:n.dimensions});let r=await ze({backend:t.store.backend,path:t.store.path});await r.initialize(),J.info(`Store initialized`);let i=new Le(n,r),a=t.curated.path,o=new e(a,r,n),s=new Re({path:t.store.path});await s.initialize(),J.info(`Graph store initialized`),i.setGraphStore(s),await Ne()?J.info(`WASM tree-sitter enabled for AST analysis`):J.warn(`WASM tree-sitter not available; analyzers will use regex fallback`);let c=d(t.er),l=c?new Ie(t.curated.path):void 0;l&&J.info(`Policy store initialized`,{ruleCount:l.getRules().length});let u=c?new Fe:void 0,f=Ae(process.cwd(),je.aiKb),p=Oe(f),m;if(p)try{m=ke(f).mtime.toISOString()}catch{}return J.info(`Onboard state detected`,{onboardComplete:p,onboardTimestamp:m}),{embedder:n,store:r,indexer:i,curated:o,graphStore:s,fileCache:new Be,bridge:c,policyStore:l,evolutionCollector:u,onboardComplete:p,onboardTimestamp:m}}function X(e,t){let n=new q({name:t.serverName??`knowledge-base`,version:G()});return Z(n,e,t),n}function Z(e,d,G){t(e),x(e,d.embedder,d.store,d.graphStore,d.bridge,d.evolutionCollector),le(e,d.store),S(e,d.store,d.graphStore,d.curated,{onboardComplete:d.onboardComplete,onboardTimestamp:d.onboardTimestamp}),v(e,d.indexer,G,d.curated,d.store),y(e,d.curated,d.policyStore,d.evolutionCollector),W(e,d.curated),oe(e,d.curated),_(e,d.curated),ce(e,d.curated),s(e,d.store,d.embedder),r(e,d.store,d.embedder),c(e,d.store,d.embedder),o(e,d.store,d.embedder),a(e,d.store,d.embedder),i(e,d.store,d.embedder),l(e,d.store,d.embedder),g(e),ue(e,d.store,d.embedder),se(e,d.graphStore),u(e,d.store,d.embedder),D(e,d.embedder,d.fileCache),U(e,d.embedder,d.store),P(e,d.embedder,d.store),z(e),_e(e),w(e),C(e,d.embedder,d.store),fe(e,d.embedder,d.store),M(e),pe(e),de(e),F(e),j(e),H(e),E(e),N(e,d.fileCache),T(e),O(e),me(e,d.embedder,d.store),B(e),he(e),k(e,d.embedder,d.store),A(e),L(e),R(e),V(e),ge(e),I(e),ne(e),te(e,d.embedder),re(e),ae(e,d.embedder,d.fileCache),ie(e,d.embedder,d.store),De(e),xe(e),Ce(e),ye(e),Se(e),ve(e),we(e),Te(e),be(e),Ee(e),d.bridge&&(p(e,d.bridge,d.evolutionCollector),f(e,d.bridge),m(e,d.bridge)),d.policyStore&&h(e,d.policyStore),d.evolutionCollector&&ee(e,d.evolutionCollector),n(e,d.store),b(e)}async function Ve(e){let t=await Y(e),n=X(t,e);J.info(`MCP server configured`,{toolCount:$.length,resourceCount:2});let r=async()=>{try{let n=e.sources.map(e=>e.path).join(`, `);J.info(`Running initial index`,{sourcePaths:n});let r=await t.indexer.index(e,e=>{e.phase===`crawling`||e.phase===`done`||(e.phase===`chunking`&&e.currentFile&&J.debug(`Indexing file`,{current:e.filesProcessed+1,total:e.filesTotal,file:e.currentFile}),e.phase===`cleanup`&&J.debug(`Index cleanup`,{staleEntries:e.filesTotal-e.filesProcessed}))});J.info(`Initial index complete`,{filesProcessed:r.filesProcessed,filesSkipped:r.filesSkipped,chunksCreated:r.chunksCreated,durationMs:r.durationMs});try{await t.store.createFtsIndex()}catch(e){J.warn(`FTS index creation failed`,K(e))}try{let e=await t.curated.reindexAll();J.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){J.error(`Curated re-index failed`,K(e))}}catch(e){J.error(`Initial index failed; will retry on kb_reindex`,K(e))}},i=async()=>{J.info(`Shutting down`),await t.embedder.shutdown().catch(()=>{}),await t.graphStore.close().catch(()=>{}),await t.store.close(),process.exit(0)};process.on(`SIGINT`,i),process.on(`SIGTERM`,i);let a=process.ppid,o=setInterval(()=>{try{process.kill(a,0)}catch{J.info(`Parent process died; shutting down`,{parentPid:a}),clearInterval(o),i()}},5e3);return o.unref(),{server:n,runInitialIndex:r,shutdown:i}}const He=new Set(`batch.changelog.check.checkpoint.codemod.compact.data_transform.delegate.diff_parse.digest.encode.env.eval.evidence_map.file_summary.forge_classify.git_context.graph.guide.health.http.lane.measure.onboard.parse_output.process.queue.read.regex_test.reindex.remember.rename.replay.schema_validate.scope_map.snippet.stash.status.stratum_card.test_run.time.update.forget.list.watch.web_fetch.web_search.workset`.split(`.`)),Q=5e3,$=`analyze_dependencies.analyze_diagram.analyze_entry_points.analyze_patterns.analyze_structure.analyze_symbols.audit.batch.blast_radius.changelog.check.checkpoint.codemod.compact.data_transform.dead_symbols.delegate.diff_parse.digest.encode.env.eval.evidence_map.file_summary.find.forge_classify.forge_ground.forget.git_context.graph.guide.health.http.lane.list.lookup.measure.onboard.parse_output.process.produce_knowledge.queue.read.regex_test.reindex.remember.rename.replay.schema_validate.scope_map.search.snippet.stash.status.stratum_card.symbol.test_run.time.trace.update.watch.web_fetch.web_search.workset`.split(`.`);function Ue(e){let t=new q({name:e.serverName??`knowledge-base`,version:G()}),n=t.sendToolListChanged.bind(t);t.sendToolListChanged=()=>{};let r=$.map(e=>t.registerTool(e,{description:`${e} (initializing...)`,inputSchema:{}},async()=>({content:[{type:`text`,text:`KB is still initializing, please retry in a few seconds.`}]})));t.sendToolListChanged=n;let i=t.resource(`kb-status`,`kb://status`,{description:`Knowledge base status (initializing...)`,mimeType:`text/plain`},async()=>({contents:[{uri:`kb://status`,text:`KB is initializing...`,mimeType:`text/plain`}]})),a,o=new Promise(e=>{a=e}),s=(async()=>{let n=await Y(e),o=t.sendToolListChanged.bind(t);t.sendToolListChanged=()=>{};for(let e of r)e.remove();i.remove(),Z(t,n,e),t.sendToolListChanged=o,t.sendToolListChanged();let s=t._registeredTools??{};for(let[e,t]of Object.entries(s)){if(He.has(e))continue;let r=t.handler;t.handler=async(...t)=>{if(!n.indexer.isIndexing)return r(...t);let i=new Promise(t=>setTimeout(()=>t({content:[{type:`text`,text:`⏳ KB is re-indexing. The tool "${e}" timed out waiting for index data (${Q/1e3}s).\n\nThe existing index may be temporarily locked. Please retry shortly — indexing will complete automatically.`}]}),Q));return Promise.race([r(...t),i])}}let c=Object.keys(s).length;c!==$.length&&J.warn(`ALL_TOOL_NAMES count mismatch`,{expectedToolCount:$.length,registeredToolCount:c}),J.info(`MCP server configured`,{toolCount:$.length,resourceCount:2}),a?.(n)})(),c=async()=>{let t=await o;try{let n=e.sources.map(e=>e.path).join(`, `);J.info(`Running initial index`,{sourcePaths:n});let r=await t.indexer.index(e,e=>{e.phase===`crawling`||e.phase===`done`||(e.phase===`chunking`&&e.currentFile&&J.debug(`Indexing file`,{current:e.filesProcessed+1,total:e.filesTotal,file:e.currentFile}),e.phase===`cleanup`&&J.debug(`Index cleanup`,{staleEntries:e.filesTotal-e.filesProcessed}))});J.info(`Initial index complete`,{filesProcessed:r.filesProcessed,filesSkipped:r.filesSkipped,chunksCreated:r.chunksCreated,durationMs:r.durationMs});try{await t.store.createFtsIndex()}catch(e){J.warn(`FTS index creation failed`,K(e))}try{let e=await t.curated.reindexAll();J.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){J.error(`Curated re-index failed`,K(e))}}catch(e){J.error(`Initial index failed; will retry on kb_reindex`,K(e))}},l=process.ppid,u=setInterval(()=>{try{process.kill(l,0)}catch{J.info(`Parent process died; shutting down`,{parentPid:l}),clearInterval(u),o.then(async e=>{await e.embedder.shutdown().catch(()=>{}),await e.graphStore.close().catch(()=>{}),await e.store.close().catch(()=>{})}).catch(()=>{}).finally(()=>process.exit(0))}},5e3);return u.unref(),{server:t,ready:s,runInitialIndex:c}}export{$ as ALL_TOOL_NAMES,Ue as createLazyServer,X as createMcpServer,Ve as createServer,Y as initializeKnowledgeBase,Z as registerMcpTools};

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

@@ -1,11 +1,14 @@
-import type { IEmbedder } from '@kb/embeddings';
-import type { IKnowledgeStore } from '@kb/store';
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare function registerAnalyzeStructureTool(server: McpServer, store: IKnowledgeStore, embedder: IEmbedder): void;
-export declare function registerAnalyzeDependenciesTool(server: McpServer, store: IKnowledgeStore, embedder: IEmbedder): void;
-export declare function registerAnalyzeSymbolsTool(server: McpServer, store: IKnowledgeStore, embedder: IEmbedder): void;
-export declare function registerAnalyzePatternsTool(server: McpServer, store: IKnowledgeStore, embedder: IEmbedder): void;
-export declare function registerAnalyzeEntryPointsTool(server: McpServer, store: IKnowledgeStore, embedder: IEmbedder): void;
-export declare function registerAnalyzeDiagramTool(server: McpServer, store: IKnowledgeStore, embedder: IEmbedder): void;
-export declare function registerBlastRadiusTool(server: McpServer, store: IKnowledgeStore, embedder: IEmbedder): void;
-//# sourceMappingURL=analyze.tools.d.ts.map
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { IEmbedder } from "@kb/embeddings";
+import { IKnowledgeStore } from "@kb/store";
+
+//#region packages/server/src/tools/analyze.tools.d.ts
+declare function registerAnalyzeStructureTool(server: McpServer, store: IKnowledgeStore, embedder: IEmbedder): void;
+declare function registerAnalyzeDependenciesTool(server: McpServer, store: IKnowledgeStore, embedder: IEmbedder): void;
+declare function registerAnalyzeSymbolsTool(server: McpServer, store: IKnowledgeStore, embedder: IEmbedder): void;
+declare function registerAnalyzePatternsTool(server: McpServer, store: IKnowledgeStore, embedder: IEmbedder): void;
+declare function registerAnalyzeEntryPointsTool(server: McpServer, store: IKnowledgeStore, embedder: IEmbedder): void;
+declare function registerAnalyzeDiagramTool(server: McpServer, store: IKnowledgeStore, embedder: IEmbedder): void;
+declare function registerBlastRadiusTool(server: McpServer, store: IKnowledgeStore, embedder: IEmbedder): void;
+//#endregion
+export { registerAnalyzeDependenciesTool, registerAnalyzeDiagramTool, registerAnalyzeEntryPointsTool, registerAnalyzePatternsTool, registerAnalyzeStructureTool, registerAnalyzeSymbolsTool, registerBlastRadiusTool };

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

@@ -1,3 +1 @@
-import{createHash as g}from"node:crypto";import{BlastRadiusAnalyzer as w,DependencyAnalyzer as z,DiagramGenerator as _,EntryPointAnalyzer as v,PatternAnalyzer as S,StructureAnalyzer as A,SymbolAnalyzer as E}from"../../../analyzers/dist/index.js";import{TreeSitterRuntime as k}from"../../../chunker/dist/index.js";import{truncateToTokenBudget as T}from"../../../tools/dist/index.js";import{z as s}from"zod";const f=s.number().min(100).max(5e4).optional().describe("Maximum token budget for the response. When set, output is truncated to fit.");function h(r,n){return n?T(r,n):r}function y(){const r=[];return k.get()||r.push("Tree-sitter unavailable \u2014 using regex fallback, symbol/pattern confidence reduced"),r.length===0?"":`
-
-> **\u26A0 Caveats:** ${r.join("; ")}`}async function u(r,n,a,o,e){try{const t=g("sha256").update(o).digest("hex").slice(0,12),i=`produced/analysis/${a}/${t}.md`,c=g("sha256").update(e).digest("hex").slice(0,16),d=new Date().toISOString(),l=e.length>2e3?e.split(/(?=^## )/m).filter(p=>p.trim().length>0):[e],m=l.map((p,x)=>({id:g("sha256").update(`${i}::${x}`).digest("hex").slice(0,16),content:p.trim(),sourcePath:i,contentType:"produced-knowledge",chunkIndex:x,totalChunks:l.length,startLine:0,endLine:0,fileHash:c,indexedAt:d,origin:"produced",tags:["analysis",a],category:"analysis",version:1})),b=await n.embedBatch(m.map(p=>p.content));await r.upsert(m,b),console.error(`[KB] Auto-persisted ${a} analysis (${m.length} chunks)`)}catch(t){console.error(`[KB] Auto-persist ${a} failed:`,t)}}function M(r,n,a){const o=new A;r.registerTool("analyze_structure",{description:"Analyze the file/directory structure of a codebase. Returns an annotated tree with language stats.",inputSchema:{path:s.string().describe("Root path to analyze"),max_depth:s.number().min(1).max(10).default(6).describe("Maximum directory depth"),format:s.enum(["json","markdown"]).default("markdown").describe("Output format"),max_tokens:f}},async({path:e,max_depth:t,format:i,max_tokens:c})=>{try{const d=await o.analyze(e,{format:i,maxDepth:t});return u(n,a,"structure",e,d.output),{content:[{type:"text",text:h(d.output+"\n\n---\n_Analysis auto-saved to KB. Next: Use `analyze_dependencies` for import graphs, or `analyze_patterns` to detect architecture patterns._",c)}]}}catch(d){return{content:[{type:"text",text:`Analysis failed: ${d.message}`}],isError:!0}}})}function j(r,n,a){const o=new z;r.registerTool("analyze_dependencies",{description:"Analyze import/require dependencies across a codebase. Shows external packages and internal module graph.",inputSchema:{path:s.string().describe("Root path to analyze"),format:s.enum(["json","markdown","mermaid"]).default("markdown").describe("Output format"),max_tokens:f}},async({path:e,format:t,max_tokens:i})=>{try{const c=await o.analyze(e,{format:t});return u(n,a,"dependencies",e,c.output),{content:[{type:"text",text:h(c.output+"\n\n---\n_Analysis auto-saved to KB. Next: Use `analyze_symbols` to explore exported symbols, or `analyze_diagram` for visual representation._",i)}]}}catch(c){return{content:[{type:"text",text:`Analysis failed: ${c.message}`}],isError:!0}}})}function D(r,n,a){const o=new E;r.registerTool("analyze_symbols",{description:"Extract exported and local symbols (functions, classes, interfaces, types, constants) from a codebase.",inputSchema:{path:s.string().describe("Root path to analyze"),filter:s.string().optional().describe("Filter symbols by name substring"),format:s.enum(["json","markdown"]).default("markdown").describe("Output format")}},async({path:e,filter:t,format:i})=>{try{const c=await o.analyze(e,{format:i,filter:t});return u(n,a,"symbols",e,c.output),{content:[{type:"text",text:c.output+y()+"\n\n---\n_Analysis auto-saved to KB. Next: Use `analyze_dependencies` to see import relationships, or `search` to find usage patterns._"}]}}catch(c){return{content:[{type:"text",text:`Analysis failed: ${c.message}`}],isError:!0}}})}function U(r,n,a){const o=new S;r.registerTool("analyze_patterns",{description:"Detect architectural patterns, frameworks, and conventions in a codebase using directory structure and code heuristics.",inputSchema:{path:s.string().describe("Root path to analyze")}},async({path:e})=>{try{const t=await o.analyze(e);return u(n,a,"patterns",e,t.output),{content:[{type:"text",text:t.output+y()+"\n\n---\n_Analysis auto-saved to KB. Next: Use `analyze_entry_points` to find Lambda handlers and main exports, or `produce_knowledge` for full analysis._"}]}}catch(t){return{content:[{type:"text",text:`Analysis failed: ${t.message}`}],isError:!0}}})}function C(r,n,a){const o=new v;r.registerTool("analyze_entry_points",{description:"Find entry points: Lambda handlers, main exports, CLI bins, and server start scripts.",inputSchema:{path:s.string().describe("Root path to analyze")}},async({path:e})=>{try{const t=await o.analyze(e);return u(n,a,"entry-points",e,t.output),{content:[{type:"text",text:t.output+y()+"\n\n---\n_Analysis auto-saved to KB. Next: Use `analyze_dependencies` to see what each entry point imports, or `produce_knowledge` for comprehensive analysis._"}]}}catch(t){return{content:[{type:"text",text:`Analysis failed: ${t.message}`}],isError:!0}}})}function O(r,n,a){const o=new _;r.registerTool("analyze_diagram",{description:"Generate a Mermaid diagram of the codebase architecture or dependency graph.",inputSchema:{path:s.string().describe("Root path to analyze"),diagram_type:s.enum(["architecture","dependencies"]).default("architecture").describe("Type of diagram")}},async({path:e,diagram_type:t})=>{try{const i=await o.analyze(e,{diagramType:t});return u(n,a,"diagram",e,i.output),{content:[{type:"text",text:i.output+"\n\n---\n_Analysis auto-saved to KB. Next: Use `analyze_structure` for detailed file tree, or `produce_knowledge` for comprehensive analysis._"}]}}catch(i){return{content:[{type:"text",text:`Diagram generation failed: ${i.message}`}],isError:!0}}})}function P(r,n,a){const o=new w;r.registerTool("blast_radius",{description:"Given a list of changed files, trace the dependency graph to find all affected files (direct + transitive importers) and their tests. Useful for scoping code reviews and impact analysis.",inputSchema:{path:s.string().describe("Root path of the codebase"),files:s.array(s.string()).min(1).describe("Changed file paths (relative to root)"),max_depth:s.number().min(1).max(20).default(5).describe("Maximum transitive dependency depth"),format:s.enum(["json","markdown"]).default("markdown").describe("Output format"),max_tokens:f}},async({path:e,files:t,max_depth:i,format:c,max_tokens:d})=>{try{const l=await o.analyze(e,{files:t,maxDepth:i,format:c});return u(n,a,"blast-radius",e,l.output),{content:[{type:"text",text:h(l.output+y()+"\n\n---\n_Analysis auto-saved to KB. Next: Use `analyze_dependencies` to see the full import graph, or `analyze_symbols` to inspect affected exports._",d)}]}}catch(l){return{content:[{type:"text",text:`Blast radius analysis failed: ${l.message}`}],isError:!0}}})}export{j as registerAnalyzeDependenciesTool,O as registerAnalyzeDiagramTool,C as registerAnalyzeEntryPointsTool,U as registerAnalyzePatternsTool,M as registerAnalyzeStructureTool,D as registerAnalyzeSymbolsTool,P as registerBlastRadiusTool};
+import{createHash as e}from"node:crypto";import{BlastRadiusAnalyzer as t,DependencyAnalyzer as n,DiagramGenerator as r,EntryPointAnalyzer as i,PatternAnalyzer as a,StructureAnalyzer as o,SymbolAnalyzer as s}from"../../../analyzers/dist/index.js";import{WasmRuntime as c}from"../../../chunker/dist/index.js";import{createLogger as l,serializeError as u}from"../../../core/dist/index.js";import{truncateToTokenBudget as d}from"../../../tools/dist/index.js";import{z as f}from"zod";const p=l(`tools`),m=f.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`);function h(e,t){return t?d(e,t):e}function g(){let e=[];return c.get()||e.push(`Tree-sitter unavailable — using regex fallback, symbol/pattern confidence reduced`),e.length===0?``:`\n\n> **⚠ Caveats:** ${e.join(`; `)}`}async function _(t,n,r,i,a){try{let o=`produced/analysis/${r}/${e(`sha256`).update(i).digest(`hex`).slice(0,12)}.md`,s=e(`sha256`).update(a).digest(`hex`).slice(0,16),c=new Date().toISOString(),l=a.length>2e3?a.split(/(?=^## )/m).filter(e=>e.trim().length>0):[a],u=l.map((t,n)=>({id:e(`sha256`).update(`${o}::${n}`).digest(`hex`).slice(0,16),content:t.trim(),sourcePath:o,contentType:`produced-knowledge`,chunkIndex:n,totalChunks:l.length,startLine:0,endLine:0,fileHash:s,indexedAt:c,origin:`produced`,tags:[`analysis`,r],category:`analysis`,version:1})),d=await n.embedBatch(u.map(e=>e.content));await t.upsert(u,d),p.info(`Auto-persisted analysis`,{analyzerName:r,chunkCount:u.length})}catch(e){p.warn(`Auto-persist analysis failed`,{analyzerName:r,...u(e)})}}function v(e,t,n){let r=new o;e.registerTool(`analyze_structure`,{description:`Analyze the file/directory structure of a codebase. Returns an annotated tree with language stats.`,inputSchema:{path:f.string().describe(`Root path to analyze`),max_depth:f.number().min(1).max(10).default(6).describe(`Maximum directory depth`),format:f.enum([`json`,`markdown`]).default(`markdown`).describe(`Output format`),max_tokens:m}},async({path:e,max_depth:i,format:a,max_tokens:o})=>{try{let s=await r.analyze(e,{format:a,maxDepth:i});return _(t,n,`structure`,e,s.output),{content:[{type:`text`,text:h(s.output+"\n\n---\n_Analysis auto-saved to KB. Next: Use `analyze_dependencies` for import graphs, or `analyze_patterns` to detect architecture patterns._",o)}]}}catch(e){return p.error(`Analysis failed`,u(e)),{content:[{type:`text`,text:`Analysis failed: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}})}function y(e,t,r){let i=new n;e.registerTool(`analyze_dependencies`,{description:`Analyze import/require dependencies across a codebase. Shows external packages and internal module graph.`,inputSchema:{path:f.string().describe(`Root path to analyze`),format:f.enum([`json`,`markdown`,`mermaid`]).default(`markdown`).describe(`Output format`),max_tokens:m}},async({path:e,format:n,max_tokens:a})=>{try{let o=await i.analyze(e,{format:n});return _(t,r,`dependencies`,e,o.output),{content:[{type:`text`,text:h(o.output+"\n\n---\n_Analysis auto-saved to KB. Next: Use `analyze_symbols` to explore exported symbols, or `analyze_diagram` for visual representation._",a)}]}}catch(e){return p.error(`Analysis failed`,u(e)),{content:[{type:`text`,text:`Analysis failed: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}})}function b(e,t,n){let r=new s;e.registerTool(`analyze_symbols`,{description:`Extract exported and local symbols (functions, classes, interfaces, types, constants) from a codebase.`,inputSchema:{path:f.string().describe(`Root path to analyze`),filter:f.string().optional().describe(`Filter symbols by name substring`),format:f.enum([`json`,`markdown`]).default(`markdown`).describe(`Output format`)}},async({path:e,filter:i,format:a})=>{try{let o=await r.analyze(e,{format:a,filter:i});return _(t,n,`symbols`,e,o.output),{content:[{type:`text`,text:o.output+g()+"\n\n---\n_Analysis auto-saved to KB. Next: Use `analyze_dependencies` to see import relationships, or `search` to find usage patterns._"}]}}catch(e){return p.error(`Analysis failed`,u(e)),{content:[{type:`text`,text:`Analysis failed: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}})}function x(e,t,n){let r=new a;e.registerTool(`analyze_patterns`,{description:`Detect architectural patterns, frameworks, and conventions in a codebase using directory structure and code heuristics.`,inputSchema:{path:f.string().describe(`Root path to analyze`)}},async({path:e})=>{try{let i=await r.analyze(e);return _(t,n,`patterns`,e,i.output),{content:[{type:`text`,text:i.output+g()+"\n\n---\n_Analysis auto-saved to KB. Next: Use `analyze_entry_points` to find Lambda handlers and main exports, or `produce_knowledge` for full analysis._"}]}}catch(e){return p.error(`Analysis failed`,u(e)),{content:[{type:`text`,text:`Analysis failed: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}})}function S(e,t,n){let r=new i;e.registerTool(`analyze_entry_points`,{description:`Find entry points: Lambda handlers, main exports, CLI bins, and server start scripts.`,inputSchema:{path:f.string().describe(`Root path to analyze`)}},async({path:e})=>{try{let i=await r.analyze(e);return _(t,n,`entry-points`,e,i.output),{content:[{type:`text`,text:i.output+g()+"\n\n---\n_Analysis auto-saved to KB. Next: Use `analyze_dependencies` to see what each entry point imports, or `produce_knowledge` for comprehensive analysis._"}]}}catch(e){return p.error(`Analysis failed`,u(e)),{content:[{type:`text`,text:`Analysis failed: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}})}function C(e,t,n){let i=new r;e.registerTool(`analyze_diagram`,{description:`Generate a Mermaid diagram of the codebase architecture or dependency graph.`,inputSchema:{path:f.string().describe(`Root path to analyze`),diagram_type:f.enum([`architecture`,`dependencies`]).default(`architecture`).describe(`Type of diagram`)}},async({path:e,diagram_type:r})=>{try{let a=await i.analyze(e,{diagramType:r});return _(t,n,`diagram`,e,a.output),{content:[{type:`text`,text:a.output+"\n\n---\n_Analysis auto-saved to KB. Next: Use `analyze_structure` for detailed file tree, or `produce_knowledge` for comprehensive analysis._"}]}}catch(e){return p.error(`Diagram generation failed`,u(e)),{content:[{type:`text`,text:`Diagram generation failed: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}})}function w(e,n,r){let i=new t;e.registerTool(`blast_radius`,{description:`Given a list of changed files, trace the dependency graph to find all affected files (direct + transitive importers) and their tests. Useful for scoping code reviews and impact analysis.`,inputSchema:{path:f.string().describe(`Root path of the codebase`),files:f.array(f.string()).min(1).describe(`Changed file paths (relative to root)`),max_depth:f.number().min(1).max(20).default(5).describe(`Maximum transitive dependency depth`),format:f.enum([`json`,`markdown`]).default(`markdown`).describe(`Output format`),max_tokens:m}},async({path:e,files:t,max_depth:a,format:o,max_tokens:s})=>{try{let c=await i.analyze(e,{files:t,maxDepth:a,format:o});return _(n,r,`blast-radius`,e,c.output),{content:[{type:`text`,text:h(c.output+g()+"\n\n---\n_Analysis auto-saved to KB. Next: Use `analyze_dependencies` to see the full import graph, or `analyze_symbols` to inspect affected exports._",s)}]}}catch(e){return p.error(`Blast radius analysis failed`,u(e)),{content:[{type:`text`,text:`Blast radius analysis failed: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}})}export{y as registerAnalyzeDependenciesTool,C as registerAnalyzeDiagramTool,S as registerAnalyzeEntryPointsTool,x as registerAnalyzePatternsTool,v as registerAnalyzeStructureTool,b as registerAnalyzeSymbolsTool,w as registerBlastRadiusTool};

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

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

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

@@ -1,4 +1 @@
-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: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}})}export{a as registerAuditTool};

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

@@ -0,0 +1,34 @@
+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 };

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

@@ -0,0 +1,15 @@
+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};

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

@@ -0,0 +1,7 @@
+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 };

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

@@ -0,0 +1,5 @@
+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};

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

@@ -1,12 +1,13 @@
-/**
- * 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;
-//# sourceMappingURL=forge.tools.d.ts.map
+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 };

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

@@ -1,13 +1,10 @@
-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: ${e instanceof Error?e.message:String(e)}`}],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: ${e instanceof Error?e.message:String(e)}`}],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: ${e instanceof Error?e.message:String(e)}`}],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: ${e instanceof Error?e.message:String(e)}`}],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: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}})}export{u as registerDigestTool,l as registerEvidenceMapTool,d as registerForgeClassifyTool,p as registerForgeGroundTool,f as registerStratumCardTool};

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

@@ -1,4 +1,7 @@
-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;
-//# sourceMappingURL=forget.tool.d.ts.map
+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 };

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

@@ -1,7 +1 @@
-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 .ai/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: \`.ai/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};

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

@@ -1,4 +1,7 @@
-import type { IGraphStore } from '@kb/store';
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare function registerGraphTool(server: McpServer, graphStore: IGraphStore): void;
-//# sourceMappingURL=graph.tool.d.ts.map
+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 };

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

@@ -1,5 +1,4 @@
-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: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}})}export{s as registerGraphTool};

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

@@ -1,4 +1,7 @@
-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;
-//# sourceMappingURL=list.tool.d.ts.map
+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 };

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

@@ -1,8 +1,2 @@
-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};

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

@@ -1,4 +1,7 @@
-import type { IKnowledgeStore } from '@kb/store';
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare function registerLookupTool(server: McpServer, store: IKnowledgeStore): void;
-//# sourceMappingURL=lookup.tool.d.ts.map
+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 };