@vpxa/kb 0.1.15 → 0.1.17

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -7,5 +7,4 @@ import { IKnowledgeStore } from "@kb/store";
 //#region packages/server/src/tools/reindex.tool.d.ts
 declare function registerReindexTool(server: McpServer, indexer: IncrementalIndexer, config: KBConfig, curated: CuratedKnowledgeManager, store?: IKnowledgeStore): void;
 //#endregion
-export { registerReindexTool };
-//# sourceMappingURL=reindex.tool.d.ts.map
+export { registerReindexTool };

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

@@ -1,3 +1,3 @@
-import{createLogger as e,serializeError as t}from"../../../core/dist/index.js";import{z as n}from"zod";const r=e(`tools`);function i(e,i,a,o,s){e.registerTool(`reindex`,{description:`Trigger re-indexing of the knowledge base. Can do incremental (only changed files) or full re-index.`,inputSchema:{full:n.boolean().default(!1).describe(`If true, force full re-index ignoring file hashes`)}},async({full:e})=>{try{r.info(`Starting re-index`,{mode:e?`full`:`incremental`});let n=e=>t=>{t.phase===`chunking`&&t.currentFile&&r.debug(`Re-index progress`,{prefix:e,current:t.filesProcessed+1,total:t.filesTotal,file:t.currentFile})},c=e?await i.reindexAll(a,n(`Reindex`)):await i.index(a,n(`Index`)),l=[`## Re-index Complete`,``,`- **Files Processed**: ${c.filesProcessed}`,`- **Files Skipped** (unchanged): ${c.filesSkipped}`,`- **Chunks Created**: ${c.chunksCreated}`,`- **Files Removed**: ${c.filesRemoved}`,`- **Duration**: ${(c.durationMs/1e3).toFixed(1)}s`];if(s)try{await s.createFtsIndex()}catch(e){l.push(``,`- **FTS Index Failed**: ${e.message}`)}try{let e=await o.reindexAll();l.push(``,`- **Curated Entries Re-indexed**: ${e.indexed}`),e.errors.length>0&&l.push(`- **Curated Errors**: ${e.errors.length}`),r.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){l.push(``,`- **Curated Re-index Failed**: ${e.message}`),r.warn(`Curated re-index failed`,t(e))}return{content:[{type:`text`,text:l.join(`
-`)+"\n\n---\n_Next: Use `search` to query the refreshed index, or `status` to verify index stats._"}]}}catch(e){return r.error(`Reindex failed`,t(e)),{content:[{type:`text`,text:`Reindex failed. Check server logs for details.`}],isError:!0}}})}export{i as registerReindexTool};
-//# sourceMappingURL=reindex.tool.js.map
+import{createLogger as e,serializeError as t}from"../../../core/dist/index.js";import{z as n}from"zod";const r=e(`tools`);function i(e,i,a,o,s){e.registerTool(`reindex`,{description:`Trigger re-indexing of the knowledge base. Can do incremental (only changed files) or full re-index.`,inputSchema:{full:n.boolean().default(!1).describe(`If true, force full re-index ignoring file hashes`)}},async({full:e})=>{try{if(i.isIndexing)return{content:[{type:`text`,text:`## Reindex Already in Progress
+
+A reindex operation is currently running. Search and other tools continue to work with existing data. Use \`status({})\` to check when it completes.`}]};r.info(`Starting background re-index`,{mode:e?`full`:`incremental`});let n=e=>t=>{t.phase===`chunking`&&t.currentFile&&r.debug(`Re-index progress`,{prefix:e,current:t.filesProcessed+1,total:t.filesTotal,file:t.currentFile})};return(e?i.reindexAll(a,n(`Reindex`)):i.index(a,n(`Index`))).then(async e=>{if(r.info(`Background re-index complete`,{filesProcessed:e.filesProcessed,chunksCreated:e.chunksCreated,durationMs:e.durationMs}),s)try{await s.createFtsIndex(),r.info(`FTS index rebuilt after reindex`)}catch(e){r.warn(`FTS index rebuild failed`,t(e))}try{let e=await o.reindexAll();r.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){r.warn(`Curated re-index failed`,t(e))}}).catch(e=>{r.error(`Background reindex failed`,t(e))}),{content:[{type:`text`,text:`## Reindex Started (Background)\n\n- **Mode**: ${e?`Full`:`Incremental`}\n- Search and other tools continue to work with existing data during reindex.\n- Completion will be logged. Use \`status({})\` to check index stats afterward.\n\n---\n_Next: Continue working — the reindex runs in the background._`}]}}catch(e){return r.error(`Reindex failed`,t(e)),{content:[{type:`text`,text:`Reindex failed. Check server logs for details.`}],isError:!0}}})}export{i as registerReindexTool};

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

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

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

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

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

@@ -3,5 +3,4 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 //#region packages/server/src/tools/replay.tool.d.ts
 declare function registerReplayTool(server: McpServer): void;
 //#endregion
-export { registerReplayTool };
-//# sourceMappingURL=replay.tool.d.ts.map
+export { registerReplayTool };

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

@@ -1,4 +1,3 @@
 import{createLogger as e,serializeError as t}from"../../../core/dist/index.js";import{replayClear as n,replayList as r,replayTrim as i}from"../../../tools/dist/index.js";import{z as a}from"zod";const o=e(`tools`);function s(e){e.registerTool(`replay`,{description:`View or clear the audit trail of recent MCP tool and CLI invocations. Shows tool name, duration, status, and input/output summaries.`,inputSchema:{action:a.enum([`list`,`clear`]).default(`list`).describe(`Action: "list" (default) to view entries, "clear" to wipe the log`),last:a.number().optional().describe(`Number of entries to return (default: 20, list only)`),tool:a.string().optional().describe(`Filter by tool name (list only)`),source:a.enum([`mcp`,`cli`]).optional().describe(`Filter by source: "mcp" or "cli" (list only)`),since:a.string().optional().describe(`ISO timestamp — only show entries after this time (list only)`)}},async({action:e,last:a,tool:s,source:c,since:l})=>{try{if(e===`clear`)return n(),{content:[{type:`text`,text:`Replay log cleared.`}]};let t=r({last:a,tool:s,source:c,since:l});if(t.length===0)return{content:[{type:`text`,text:`No replay entries found. Activity is logged when tools are invoked via MCP or CLI.`}]};let o=t.map(e=>`${e.ts.split(`T`)[1]?.split(`.`)[0]??e.ts} ${e.status===`ok`?`✓`:`✗`} ${e.tool} (${e.durationMs}ms) [${e.source}]\n  in: ${e.input}\n  out: ${e.output}`);return i(),{content:[{type:`text`,text:`**Replay Log** (${t.length} entries)\n\n${o.join(`
 
-`)}`}]}}catch(e){return o.error(`Replay failed`,t(e)),{content:[{type:`text`,text:`Replay failed. Check server logs for details.`}],isError:!0}}})}export{s as registerReplayTool};
-//# sourceMappingURL=replay.tool.js.map
+`)}`}]}}catch(e){return o.error(`Replay failed`,t(e)),{content:[{type:`text`,text:`Replay failed. Check server logs for details.`}],isError:!0}}})}export{s as registerReplayTool};

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

@@ -7,5 +7,4 @@ import { IGraphStore, IKnowledgeStore } from "@kb/store";
 //#region packages/server/src/tools/search.tool.d.ts
 declare function registerSearchTool(server: McpServer, embedder: IEmbedder, store: IKnowledgeStore, graphStore?: IGraphStore, bridge?: BridgeComponents, evolutionCollector?: EvolutionCollector): void;
 //#endregion
-export { registerSearchTool };
-//# sourceMappingURL=search.tool.d.ts.map
+export { registerSearchTool };

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

@@ -1,10 +1,9 @@
-import{stat as e}from"node:fs/promises";import{CONTENT_TYPES as t,KNOWLEDGE_ORIGINS as n,SOURCE_TYPES as r,createLogger as i,serializeError as a}from"../../../core/dist/index.js";import{graphAugmentSearch as o,truncateToTokenBudget as s}from"../../../tools/dist/index.js";import{z as c}from"zod";import{mergeResults as l}from"../../../enterprise-bridge/dist/index.js";const u=i(`tools`);async function d(e,t,n,r,i){if(!e||t>=e.config.fallbackThreshold&&n.length>0)return{results:n,triggered:!1,cacheHit:!1};let o=!1;try{let t=e.cache.get(r);return t?o=!0:(t=await e.client.search(r,i),t.length>0&&e.cache.set(r,t)),t.length>0?{results:l(n,t,i).map(e=>({record:{id:`er:${e.sourcePath}`,content:e.content,sourcePath:e.source===`er`?`[ER] ${e.sourcePath}`:e.sourcePath,startLine:e.startLine??0,endLine:e.endLine??0,contentType:e.contentType??`documentation`,headingPath:e.headingPath,origin:e.source===`er`?`curated`:e.origin??`indexed`,category:e.category,tags:e.tags??[],chunkIndex:0,totalChunks:1,fileHash:``,indexedAt:new Date().toISOString(),version:1},score:e.score})),triggered:!0,cacheHit:o}:{results:n,triggered:!0,cacheHit:o}}catch(e){return u.warn(`ER fallback failed`,a(e)),{results:n,triggered:!0,cacheHit:o}}}function f(e,t,n=60){let r=new Map;for(let t=0;t<e.length;t++){let i=e[t];r.set(i.record.id,{record:i.record,score:1/(n+t+1)})}for(let e=0;e<t.length;e++){let i=t[e],a=r.get(i.record.id);a?a.score+=1/(n+e+1):r.set(i.record.id,{record:i.record,score:1/(n+e+1)})}return[...r.values()].sort((e,t)=>t.score-e.score).map(({record:e,score:t})=>({record:e,score:t}))}function p(e,t){let n=t.toLowerCase().split(/\s+/).filter(e=>e.length>=2);return n.length<2?e:e.map(e=>{let t=e.record.content.toLowerCase(),r=n.map(e=>{let n=[],r=t.indexOf(e);for(;r!==-1;)n.push(r),r=t.indexOf(e,r+1);return n});if(r.some(e=>e.length===0))return e;let i=t.length;for(let e of r[0]){let t=e,a=e+n[0].length;for(let i=1;i<r.length;i++){let o=r[i][0],s=Math.abs(o-e);for(let t=1;t<r[i].length;t++){let n=Math.abs(r[i][t]-e);n<s&&(s=n,o=r[i][t])}t=Math.min(t,o),a=Math.max(a,o+n[i].length)}i=Math.min(i,a-t)}let a=1+.25/(1+i/200);return{record:e.record,score:e.score*a}}).sort((e,t)=>t.score-e.score)}function m(e,t,n=8){let r=new Set(t.toLowerCase().split(/\s+/).filter(e=>e.length>=2)),i=new Map,a=e.length;for(let t of e){let e=new Set(t.record.content.split(/[^a-zA-Z0-9_]+/).filter(e=>e.length>=3&&!h.has(e.toLowerCase())));for(let t of e){let e=t.toLowerCase();/[_A-Z]/.test(t)&&i.set(`__id__${e}`,1)}let n=new Set(t.record.content.toLowerCase().split(/[^a-zA-Z0-9_]+/).filter(e=>e.length>=3&&!h.has(e)));for(let e of n)i.set(e,(i.get(e)??0)+1)}let o=[];for(let[e,t]of i){if(e.startsWith(`__id__`)||r.has(e)||t>a*.8)continue;let n=Math.log(a/t),s=i.has(`__id__${e}`)?1:0,c=e.length>8?.5:0;o.push({term:e,score:n+s+c})}return o.sort((e,t)=>t.score-e.score).slice(0,n).map(e=>e.term)}const h=new Set(`the.and.for.are.but.not.you.all.can.had.her.was.one.our.out.has.have.from.this.that.with.they.been.said.each.which.their.will.other.about.many.then.them.these.some.would.make.like.into.could.time.very.when.come.just.know.take.people.also.back.after.only.more.than.over.such.import.export.const.function.return.true.false.null.undefined.string.number.boolean.void.type.interface`.split(`.`));async function g(t,n){try{let r=await t.getStats();if(!r.lastIndexedAt)return;let i=new Date(r.lastIndexedAt).getTime(),a=Date.now(),o=[...new Set(n.map(e=>e.record.sourcePath))].filter(e=>!e.startsWith(`[ER]`)).slice(0,5);if(o.length===0)return;let s=0;for(let t of o)try{(await e(t)).mtimeMs>i&&s++}catch{s++}if(s>0){let e=a-i,t=Math.floor(e/6e4),n=t<1?`<1 min`:`${t} min`;return`> ⚠️ **Index may be stale** — ${s} file(s) modified since last index (${n} ago). Use \`reindex\` to refresh.`}}catch{}}function _(e,i,l,h,_,v){e.registerTool(`search`,{description:`Search the knowledge base with hybrid vector + keyword matching (BM25 + RRF fusion). Best for finding code, docs, and prior decisions. Supports semantic, keyword, and hybrid modes.`,inputSchema:{query:c.string().max(5e3).describe(`Natural language search query`),limit:c.number().min(1).max(20).default(5).describe(`Maximum results to return`),search_mode:c.enum([`hybrid`,`semantic`,`keyword`]).default(`hybrid`).describe(`Search strategy: hybrid (vector + FTS + RRF fusion, default), semantic (vector only), keyword (FTS only)`),content_type:c.enum(t).optional().describe(`Filter by content type`),source_type:c.enum(r).optional().describe(`Coarse filter: "source" (code only), "documentation" (md, curated), "test", "config". Overrides content_type if both set.`),origin:c.enum(n).optional().describe(`Filter by knowledge origin`),category:c.string().optional().describe(`Filter by category (e.g., decisions, patterns, conventions)`),tags:c.array(c.string()).optional().describe(`Filter by tags (returns results matching ANY of the specified tags)`),min_score:c.number().min(0).max(1).default(.25).describe(`Minimum similarity score`),graph_hops:c.number().min(0).max(3).default(0).describe(`Number of graph hops to augment results with (0 = no graph context, 1-3 = enrich results with connected entities)`),max_tokens:c.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),dedup:c.enum([`file`,`chunk`]).default(`chunk`).describe(`Deduplication mode: "chunk" (default, show all matching chunks) or "file" (collapse chunks from same file into single result with merged line ranges)`)}},async({query:e,limit:t,search_mode:n,content_type:r,source_type:c,origin:y,category:b,tags:x,min_score:S,graph_hops:C,max_tokens:w,dedup:T})=>{try{let E={limit:t,minScore:S,contentType:r,sourceType:c,origin:y,category:b,tags:x},D,O=!1,k=!1;if(n===`keyword`)D=await l.ftsSearch(e,E),D=D.slice(0,t);else if(n===`semantic`){let n=await i.embedQuery(e);D=await l.search(n,E);let r=await d(_,D[0]?.score??0,D,e,t);D=r.results,O=r.triggered,k=r.cacheHit}else{let n=await i.embedQuery(e),[r,a]=await Promise.all([l.search(n,{...E,limit:t*2}),l.ftsSearch(e,{...E,limit:t*2}).catch(()=>[])]);D=f(r,a).slice(0,t);let o=await d(_,r[0]?.score??0,D,e,t);D=o.results,O=o.triggered,k=o.cacheHit}if(v&&v.recordSearch(e,O,k),D.length>1&&(D=p(D,e)),T===`file`&&D.length>1){let e=new Map;for(let t of D){let n=t.record.sourcePath,r=e.get(n);r?(t.score>r.best.score&&(r.best=t),r.ranges.push({start:t.record.startLine,end:t.record.endLine})):e.set(n,{best:t,ranges:[{start:t.record.startLine,end:t.record.endLine}]})}D=[...e.values()].sort((e,t)=>t.best.score-e.best.score).map(({best:e,ranges:t})=>({record:{...e.record,content:t.length>1?`${e.record.content}\n\n_Matched ${t.length} sections: ${t.sort((e,t)=>e.start-t.start).map(e=>`L${e.start}-${e.end}`).join(`, `)}_`:e.record.content},score:e.score}))}if(D.length===0)return{content:[{type:`text`,text:`No results found for the given query.`}]};let A,j;if(C>0&&!h&&(j="> **Note:** `graph_hops` was set but no graph store is available. Graph augmentation skipped."),C>0&&h)try{let e=await o(h,D.map(e=>({recordId:e.record.id,score:e.score,sourcePath:e.record.sourcePath})),{hops:C,maxPerHit:5});A=new Map;for(let t of e)if(t.graphContext.nodes.length>0){let e=t.graphContext.nodes.slice(0,5).map(e=>`  - **${e.name}** (${e.type})`).join(`
+import{fanOutFtsSearch as e,fanOutSearch as t,openWorkspaceStores as n,resolveWorkspaces as r}from"../cross-workspace.js";import{stat as i}from"node:fs/promises";import{CONTENT_TYPES as a,KNOWLEDGE_ORIGINS as o,SOURCE_TYPES as s,computePartitionKey as c,createLogger as l,serializeError as u}from"../../../core/dist/index.js";import{graphAugmentSearch as d,truncateToTokenBudget as f}from"../../../tools/dist/index.js";import{z as p}from"zod";import{mergeResults as m}from"../../../enterprise-bridge/dist/index.js";const h=l(`tools`);async function g(e,t,n,r,i){if(!e||t>=e.config.fallbackThreshold&&n.length>0)return{results:n,triggered:!1,cacheHit:!1};let a=!1;try{let t=e.cache.get(r);return t?a=!0:(t=await e.client.search(r,i),t.length>0&&e.cache.set(r,t)),t.length>0?{results:m(n,t,i).map(e=>({record:{id:`er:${e.sourcePath}`,content:e.content,sourcePath:e.source===`er`?`[ER] ${e.sourcePath}`:e.sourcePath,startLine:e.startLine??0,endLine:e.endLine??0,contentType:e.contentType??`documentation`,headingPath:e.headingPath,origin:e.source===`er`?`curated`:e.origin??`indexed`,category:e.category,tags:e.tags??[],chunkIndex:0,totalChunks:1,fileHash:``,indexedAt:new Date().toISOString(),version:1},score:e.score})),triggered:!0,cacheHit:a}:{results:n,triggered:!0,cacheHit:a}}catch(e){return h.warn(`ER fallback failed`,u(e)),{results:n,triggered:!0,cacheHit:a}}}function _(e,t,n=60){let r=new Map;for(let t=0;t<e.length;t++){let i=e[t];r.set(i.record.id,{record:i.record,score:1/(n+t+1)})}for(let e=0;e<t.length;e++){let i=t[e],a=r.get(i.record.id);a?a.score+=1/(n+e+1):r.set(i.record.id,{record:i.record,score:1/(n+e+1)})}return[...r.values()].sort((e,t)=>t.score-e.score).map(({record:e,score:t})=>({record:e,score:t}))}function v(e,t){let n=t.toLowerCase().split(/\s+/).filter(e=>e.length>=2);return n.length<2?e:e.map(e=>{let t=e.record.content.toLowerCase(),r=n.map(e=>{let n=[],r=t.indexOf(e);for(;r!==-1;)n.push(r),r=t.indexOf(e,r+1);return n});if(r.some(e=>e.length===0))return e;let i=t.length;for(let e of r[0]){let t=e,a=e+n[0].length;for(let i=1;i<r.length;i++){let o=r[i][0],s=Math.abs(o-e);for(let t=1;t<r[i].length;t++){let n=Math.abs(r[i][t]-e);n<s&&(s=n,o=r[i][t])}t=Math.min(t,o),a=Math.max(a,o+n[i].length)}i=Math.min(i,a-t)}let a=1+.25/(1+i/200);return{record:e.record,score:e.score*a}}).sort((e,t)=>t.score-e.score)}function y(e,t,n=8){let r=new Set(t.toLowerCase().split(/\s+/).filter(e=>e.length>=2)),i=new Map,a=e.length;for(let t of e){let e=new Set(t.record.content.split(/[^a-zA-Z0-9_]+/).filter(e=>e.length>=3&&!b.has(e.toLowerCase())));for(let t of e){let e=t.toLowerCase();/[_A-Z]/.test(t)&&i.set(`__id__${e}`,1)}let n=new Set(t.record.content.toLowerCase().split(/[^a-zA-Z0-9_]+/).filter(e=>e.length>=3&&!b.has(e)));for(let e of n)i.set(e,(i.get(e)??0)+1)}let o=[];for(let[e,t]of i){if(e.startsWith(`__id__`)||r.has(e)||t>a*.8)continue;let n=Math.log(a/t),s=i.has(`__id__${e}`)?1:0,c=e.length>8?.5:0;o.push({term:e,score:n+s+c})}return o.sort((e,t)=>t.score-e.score).slice(0,n).map(e=>e.term)}const b=new Set(`the.and.for.are.but.not.you.all.can.had.her.was.one.our.out.has.have.from.this.that.with.they.been.said.each.which.their.will.other.about.many.then.them.these.some.would.make.like.into.could.time.very.when.come.just.know.take.people.also.back.after.only.more.than.over.such.import.export.const.function.return.true.false.null.undefined.string.number.boolean.void.type.interface`.split(`.`));async function x(e,t){try{let n=await e.getStats();if(!n.lastIndexedAt)return;let r=new Date(n.lastIndexedAt).getTime(),a=Date.now(),o=[...new Set(t.map(e=>e.record.sourcePath))].filter(e=>!e.startsWith(`[ER]`)).slice(0,5);if(o.length===0)return;let s=0;for(let e of o)try{(await i(e)).mtimeMs>r&&s++}catch{s++}if(s>0){let e=a-r,t=Math.floor(e/6e4),n=t<1?`<1 min`:`${t} min`;return`> ⚠️ **Index may be stale** — ${s} file(s) modified since last index (${n} ago). Use \`reindex\` to refresh.`}}catch{}}function S(i,l,m,b,S,C){i.registerTool(`search`,{description:`Search the knowledge base with hybrid vector + keyword matching (BM25 + RRF fusion). Best for finding code, docs, and prior decisions. Supports semantic, keyword, and hybrid modes.`,inputSchema:{query:p.string().max(5e3).describe(`Natural language search query`),limit:p.number().min(1).max(20).default(5).describe(`Maximum results to return`),search_mode:p.enum([`hybrid`,`semantic`,`keyword`]).default(`hybrid`).describe(`Search strategy: hybrid (vector + FTS + RRF fusion, default), semantic (vector only), keyword (FTS only)`),content_type:p.enum(a).optional().describe(`Filter by content type`),source_type:p.enum(s).optional().describe(`Coarse filter: "source" (code only), "documentation" (md, curated), "test", "config". Overrides content_type if both set.`),origin:p.enum(o).optional().describe(`Filter by knowledge origin`),category:p.string().optional().describe(`Filter by category (e.g., decisions, patterns, conventions)`),tags:p.array(p.string()).optional().describe(`Filter by tags (returns results matching ANY of the specified tags)`),min_score:p.number().min(0).max(1).default(.25).describe(`Minimum similarity score`),graph_hops:p.number().min(0).max(3).default(1).describe(`Number of graph hops to augment results with connected entities (0 = disabled, 1 = direct connections, 2-3 = deeper traversal). Default 1 provides module/symbol context automatically.`),max_tokens:p.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),dedup:p.enum([`file`,`chunk`]).default(`chunk`).describe(`Deduplication mode: "chunk" (default, show all matching chunks) or "file" (collapse chunks from same file into single result with merged line ranges)`),workspaces:p.array(p.string()).optional().describe(`Cross-workspace search: partition names or folder basenames to include. Use ["*"] for all registered workspaces. Only works in global install mode.`)}},async({query:i,limit:a,search_mode:o,content_type:s,source_type:p,origin:w,category:T,tags:E,min_score:D,graph_hops:O,max_tokens:k,dedup:A,workspaces:j})=>{try{let M={limit:a,minScore:D,contentType:s,sourceType:p,origin:w,category:T,tags:E},N,P=!1,F=!1;if(o===`keyword`)N=await m.ftsSearch(i,M),N=N.slice(0,a);else if(o===`semantic`){let e=await l.embedQuery(i);N=await m.search(e,M);let t=await g(S,N[0]?.score??0,N,i,a);N=t.results,P=t.triggered,F=t.cacheHit}else{let e=await l.embedQuery(i),[t,n]=await Promise.all([m.search(e,{...M,limit:a*2}),m.ftsSearch(i,{...M,limit:a*2}).catch(()=>[])]);N=_(t,n).slice(0,a);let r=await g(S,t[0]?.score??0,N,i,a);N=r.results,P=r.triggered,F=r.cacheHit}C&&C.recordSearch(i,P,F),N.length>1&&(N=v(N,i));let I=``;if(j&&j.length>0){let s=r(j,c(process.cwd()));if(s.length>0){let{stores:r,closeAll:c}=await n(s);try{let n;n=o===`keyword`?await e(r,i,{...M,limit:a}):await t(r,await l.embedQuery(i),{...M,limit:a});for(let e of n)N.push({record:{...e.record,sourcePath:`[${e.workspace}] ${e.record.sourcePath}`},score:e.score});N=N.sort((e,t)=>t.score-e.score).slice(0,a),I=` + ${s.length} workspace(s)`}finally{await c()}}}if(A===`file`&&N.length>1){let e=new Map;for(let t of N){let n=t.record.sourcePath,r=e.get(n);r?(t.score>r.best.score&&(r.best=t),r.ranges.push({start:t.record.startLine,end:t.record.endLine})):e.set(n,{best:t,ranges:[{start:t.record.startLine,end:t.record.endLine}]})}N=[...e.values()].sort((e,t)=>t.best.score-e.best.score).map(({best:e,ranges:t})=>({record:{...e.record,content:t.length>1?`${e.record.content}\n\n_Matched ${t.length} sections: ${t.sort((e,t)=>e.start-t.start).map(e=>`L${e.start}-${e.end}`).join(`, `)}_`:e.record.content},score:e.score}))}if(N.length===0)return{content:[{type:`text`,text:`No results found for the given query.`}]};let L,R;if(O>0&&!b&&(R="> **Note:** `graph_hops` was set but no graph store is available. Graph augmentation skipped."),O>0&&b)try{let e=await d(b,N.map(e=>({recordId:e.record.id,score:e.score,sourcePath:e.record.sourcePath})),{hops:O,maxPerHit:5});L=new Map;for(let t of e)if(t.graphContext.nodes.length>0){let e=t.graphContext.nodes.slice(0,5).map(e=>`  - **${e.name}** (${e.type})`).join(`
 `),n=t.graphContext.edges.slice(0,5).map(e=>`  - ${e.fromId} —[${e.type}]→ ${e.toId}`).join(`
-`),r=[`- **Graph Context** (${C} hop${C>1?`s`:``}):`];e&&r.push(`  Entities:\n${e}`),n&&r.push(`  Relationships:\n${n}`),A.set(t.recordId,r.join(`
-`))}}catch(e){u.warn(`Graph augmentation failed`,a(e)),j=`> **Note:** Graph augmentation failed. Results shown without graph context.`}let M=D.map((e,t)=>{let n=e.record;return`${`### Result ${t+1} (score: ${e.score.toFixed(3)})`}\n${[`- **Source**: ${n.sourcePath}`,n.headingPath?`- **Section**: ${n.headingPath}`:null,`- **Type**: ${n.contentType}`,n.startLine?`- **Lines**: ${n.startLine}-${n.endLine}`:null,n.origin===`indexed`?null:`- **Origin**: ${n.origin}`,n.category?`- **Category**: ${n.category}`:null,n.tags?.length?`- **Tags**: ${n.tags.join(`, `)}`:null,A?.get(n.id)??null].filter(Boolean).join(`
+`),r=[`- **Graph Context** (${O} hop${O>1?`s`:``}):`];e&&r.push(`  Entities:\n${e}`),n&&r.push(`  Relationships:\n${n}`),L.set(t.recordId,r.join(`
+`))}}catch(e){h.warn(`Graph augmentation failed`,u(e)),R=`> **Note:** Graph augmentation failed. Results shown without graph context.`}let z=N.map((e,t)=>{let n=e.record;return`${`### Result ${t+1} (score: ${e.score.toFixed(3)})`}\n${[`- **Source**: ${n.sourcePath}`,n.headingPath?`- **Section**: ${n.headingPath}`:null,`- **Type**: ${n.contentType}`,n.startLine?`- **Lines**: ${n.startLine}-${n.endLine}`:null,n.origin===`indexed`?null:`- **Origin**: ${n.origin}`,n.category?`- **Category**: ${n.category}`:null,n.tags?.length?`- **Tags**: ${n.tags.join(`, `)}`:null,L?.get(n.id)??null].filter(Boolean).join(`
 `)}\n\n${n.content}`}).join(`
 
 ---
 
-`),N=n===`hybrid`?`hybrid (vector + keyword RRF)`:n===`keyword`?`keyword (FTS)`:`semantic (vector)`,P=m(D,e),F=P.length>0?`\n_Distinctive terms: ${P.map(e=>`\`${e}\``).join(`, `)}_`:``,I=await g(l,D),L=[];if(D.length===0)L.push("`reindex` — no results found, index may be stale"),L.push("`find` — try federated search with glob/regex");else{let e=D[0]?.record.sourcePath;e&&L.push(`\`lookup\` — see all chunks from \`${e}\``),L.push("`symbol` — resolve a specific symbol from the results"),L.push("`compact` — compress a result file for focused reading")}let R=[j?`${j}\n\n`:``,I?`${I}\n\n`:``,M,`\n\n---\n_Search mode: ${N} | ${D.length} results_${F}`,`\n_Next: ${L.join(` | `)}_`].join(``);return w&&(R=s(R,w)),{content:[{type:`text`,text:R}]}}catch(e){return u.error(`Search failed`,a(e)),{content:[{type:`text`,text:`Search failed. Check server logs for details.`}],isError:!0}}})}export{_ as registerSearchTool};
-//# sourceMappingURL=search.tool.js.map
+`),B=(o===`hybrid`?`hybrid (vector + keyword RRF)`:o===`keyword`?`keyword (FTS)`:`semantic (vector)`)+I,V=y(N,i),H=V.length>0?`\n_Distinctive terms: ${V.map(e=>`\`${e}\``).join(`, `)}_`:``,U=await x(m,N),W=[];if(N.length===0)W.push("`reindex` — no results found, index may be stale"),W.push("`find` — try federated search with glob/regex");else{let e=N[0]?.record.sourcePath;e&&W.push(`\`lookup\` — see all chunks from \`${e}\``),W.push("`symbol` — resolve a specific symbol from the results"),W.push("`compact` — compress a result file for focused reading")}let G=[R?`${R}\n\n`:``,U?`${U}\n\n`:``,z,`\n\n---\n_Search mode: ${B} | ${N.length} results_${H}`,`\n_Next: ${W.join(` | `)}_`].join(``);return k&&(G=f(G,k)),{content:[{type:`text`,text:G}]}}catch(e){return h.error(`Search failed`,u(e)),{content:[{type:`text`,text:`Search failed: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}})}export{S as registerSearchTool};

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

@@ -1,8 +1,12 @@
+import { CuratedKnowledgeManager } from "../curated-manager.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { IGraphStore, IKnowledgeStore } from "@kb/store";
 
 //#region packages/server/src/tools/status.tool.d.ts
-declare function registerStatusTool(server: McpServer, store: IKnowledgeStore, graphStore?: IGraphStore): void;
+interface OnboardState {
+  onboardComplete: boolean;
+  onboardTimestamp?: string;
+}
+declare function registerStatusTool(server: McpServer, store: IKnowledgeStore, graphStore?: IGraphStore, curated?: CuratedKnowledgeManager, onboardState?: OnboardState): void;
 //#endregion
-export { registerStatusTool };
-//# sourceMappingURL=status.tool.d.ts.map
+export { OnboardState, registerStatusTool };

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

@@ -1,3 +1,2 @@
-import{TreeSitterRuntime as e}from"../../../chunker/dist/index.js";import{createLogger as t,serializeError as n}from"../../../core/dist/index.js";const r=t(`tools`);function i(t,i,a){t.registerTool(`status`,{description:`Get the current status and statistics of the knowledge base index.`},async()=>{try{let t=await i.getStats(),n=await i.listSourcePaths(),r=[`## Knowledge Base Status`,``,`- **Total Records**: ${t.totalRecords}`,`- **Total Files**: ${t.totalFiles}`,`- **Last Indexed**: ${t.lastIndexedAt??`Never`}`,``,`### Content Types`,...Object.entries(t.contentTypeBreakdown).map(([e,t])=>`- ${e}: ${t}`),``,`### Indexed Files`,...n.slice(0,50).map(e=>`- ${e}`),n.length>50?`\n... and ${n.length-50} more files`:``];if(a)try{let e=await a.getStats();r.push(``,`### Knowledge Graph`,`- **Nodes**: ${e.nodeCount}`,`- **Edges**: ${e.edgeCount}`,...Object.entries(e.nodeTypes).map(([e,t])=>`  - ${e}: ${t}`))}catch{r.push(``,`### Knowledge Graph`,`- Graph store unavailable`)}return r.push(``,`### Runtime`,`- **Tree-sitter**: ${e.get()?`✅ Available`:`⚠ Unavailable (regex fallback)`}`),{content:[{type:`text`,text:r.join(`
-`)+"\n\n---\n_Next: Use `search` to query indexed content, `graph(stats)` to explore the knowledge graph, or `reindex` to refresh the index._"}]}}catch(e){return r.error(`Status failed`,n(e)),{content:[{type:`text`,text:`Status check failed. Check server logs for details.`}],isError:!0}}})}export{i as registerStatusTool};
-//# sourceMappingURL=status.tool.js.map
+import{existsSync as e}from"node:fs";import{resolve as t}from"node:path";import{WasmRuntime as n}from"../../../chunker/dist/index.js";import{KB_PATHS as r,createLogger as i,serializeError as a}from"../../../core/dist/index.js";const o=i(`tools`);function s(i,s,c,l,u){i.registerTool(`status`,{description:`Get the current status and statistics of the knowledge base index.`},async()=>{try{let i=await s.getStats(),a=await s.listSourcePaths(),o=[`## Knowledge Base Status`,``,`- **Total Records**: ${i.totalRecords}`,`- **Total Files**: ${i.totalFiles}`,`- **Last Indexed**: ${i.lastIndexedAt??`Never`}`,``,`### Content Types`,...Object.entries(i.contentTypeBreakdown).map(([e,t])=>`- ${e}: ${t}`),``,`### Indexed Files`,...a.slice(0,50).map(e=>`- ${e}`),a.length>50?`\n... and ${a.length-50} more files`:``];if(c)try{let e=await c.getStats();o.push(``,`### Knowledge Graph`,`- **Nodes**: ${e.nodeCount}`,`- **Edges**: ${e.edgeCount}`,...Object.entries(e.nodeTypes).map(([e,t])=>`  - ${e}: ${t}`))}catch{o.push(``,`### Knowledge Graph`,`- Graph store unavailable`)}let d=e(t(process.cwd(),r.aiKb)),f=u?.onboardComplete??d;if(o.push(``,`### Onboard Status`,f?`- ✅ Complete${u?.onboardTimestamp?` (last: ${u.onboardTimestamp})`:``}`:'- ❌ Not run — call `onboard({ path: "." })` to analyze the codebase'),l)try{let e=await l.list();o.push(``,`### Curated Knowledge`,e.length>0?`- ${e.length} entries`:"- Empty — use `remember()` to persist decisions")}catch{o.push(``,`### Curated Knowledge`,`- Unable to read curated entries`)}if(i.lastIndexedAt){let e=new Date(i.lastIndexedAt),t=(Date.now()-e.getTime())/(1e3*60*60);o.push(``,`### Index Freshness`,t>24?`- ⚠ Last indexed ${Math.floor(t)}h ago — may be stale. Run \`reindex({})\``:`- ✅ Last indexed ${t<1?`less than 1h`:`${Math.floor(t)}h`} ago`)}return o.push(``,`### Runtime`,`- **Tree-sitter (WASM)**: ${n.get()?`✅ Available (AST analysis)`:`⚠ Unavailable (regex fallback)`}`),{content:[{type:`text`,text:o.join(`
+`)+"\n\n---\n_Next: Use `search` to query indexed content, `graph(stats)` to explore the knowledge graph, or `reindex` to refresh the index._"}]}}catch(e){return o.error(`Status failed`,a(e)),{content:[{type:`text`,text:`Status check failed: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}})}export{s as registerStatusTool};

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

@@ -1,6 +1,6 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { IEmbedder } from "@kb/embeddings";
-import { IKnowledgeStore } from "@kb/store";
+import { IGraphStore, IKnowledgeStore } from "@kb/store";
 import { FileCache } from "@kb/tools";
 
 //#region packages/server/src/tools/toolkit.tools.d.ts
@@ -11,7 +11,7 @@ declare function registerParseOutputTool(server: McpServer): void;
 declare function registerWorksetTool(server: McpServer): void;
 declare function registerCheckTool(server: McpServer): void;
 declare function registerBatchTool(server: McpServer, embedder: IEmbedder, store: IKnowledgeStore): void;
-declare function registerSymbolTool(server: McpServer, embedder: IEmbedder, store: IKnowledgeStore): void;
+declare function registerSymbolTool(server: McpServer, embedder: IEmbedder, store: IKnowledgeStore, graphStore?: IGraphStore): void;
 declare function registerEvalTool(server: McpServer): void;
 declare function registerTestRunTool(server: McpServer): void;
 declare function registerStashTool(server: McpServer): void;
@@ -33,5 +33,4 @@ declare function registerQueueTool(server: McpServer): void;
 declare function registerWebFetchTool(server: McpServer): void;
 declare function registerGuideTool(server: McpServer): void;
 //#endregion
-export { registerBatchTool, registerCheckTool, registerCheckpointTool, registerCodemodTool, registerCompactTool, registerDataTransformTool, registerDeadSymbolsTool, registerDelegateTool, registerDiffParseTool, registerEvalTool, registerFileSummaryTool, registerFindTool, registerGitContextTool, registerGuideTool, registerHealthTool, registerLaneTool, registerParseOutputTool, registerProcessTool, registerQueueTool, registerRenameTool, registerScopeMapTool, registerStashTool, registerSymbolTool, registerTestRunTool, registerTraceTool, registerWatchTool, registerWebFetchTool, registerWorksetTool };
-//# sourceMappingURL=toolkit.tools.d.ts.map
+export { registerBatchTool, registerCheckTool, registerCheckpointTool, registerCodemodTool, registerCompactTool, registerDataTransformTool, registerDeadSymbolsTool, registerDelegateTool, registerDiffParseTool, registerEvalTool, registerFileSummaryTool, registerFindTool, registerGitContextTool, registerGuideTool, registerHealthTool, registerLaneTool, registerParseOutputTool, registerProcessTool, registerQueueTool, registerRenameTool, registerScopeMapTool, registerStashTool, registerSymbolTool, registerTestRunTool, registerTraceTool, registerWatchTool, registerWebFetchTool, registerWorksetTool };