@vpxa/kb 0.1.24 → 0.1.25

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

@@ -0,0 +1,14 @@
+import { CuratedKnowledgeManager } from "./curated-manager.js";
+import { IGraphStore, IKnowledgeStore } from "@kb/store";
+
+//#region packages/server/src/completions.d.ts
+/** Clear all completion caches (useful for testing). */
+declare function clearCompletionCache(): void;
+declare function completeCuratedPaths(curated: CuratedKnowledgeManager, partial: string): Promise<string[]>;
+declare function completeFilePaths(store: IKnowledgeStore, partial: string): Promise<string[]>;
+declare function completeSymbolNames(graphStore: IGraphStore, partial: string): Promise<string[]>;
+declare function completeStashKeys(partial: string): string[];
+declare function completeWorksetNames(partial: string): string[];
+declare function completeCheckpointNames(partial: string): string[];
+//#endregion
+export { clearCompletionCache, completeCheckpointNames, completeCuratedPaths, completeFilePaths, completeStashKeys, completeSymbolNames, completeWorksetNames };

package/packages/server/dist/completions.js

@@ -0,0 +1 @@
+import{checkpointList as e,listWorksets as t,stashList as n}from"../../tools/dist/index.js";const r=3e4,i=new Map;function a(e,t,n){let r=i.get(e);if(r&&Date.now()<r.expires)return Promise.resolve(r.data);let a=n();return Promise.resolve(a).then(n=>(i.set(e,{data:n,expires:Date.now()+t}),n))}function o(){i.clear()}function s(e,t){return a(`curated-paths`,r,async()=>(await e.list()).map(e=>e.path)).then(e=>e.filter(e=>e.toLowerCase().includes(t.toLowerCase())).slice(0,20))}function c(e,t){return a(`file-paths`,r,()=>e.listSourcePaths()).then(e=>e.filter(e=>e.toLowerCase().includes(t.toLowerCase())).slice(0,20))}function l(e,t){return a(`symbol-names`,r,async()=>(await e.findNodes({type:`symbol`,limit:500})).map(e=>e.name)).then(e=>e.filter(e=>e.toLowerCase().includes(t.toLowerCase())).slice(0,20))}function u(e){return n().map(e=>e.key).filter(t=>t.toLowerCase().includes(e.toLowerCase())).slice(0,20)}function d(e){return t().map(e=>e.name).filter(t=>t.toLowerCase().includes(e.toLowerCase())).slice(0,20)}function f(t){return e().map(e=>e.label).filter(e=>e.toLowerCase().includes(t.toLowerCase())).slice(0,20)}export{o as clearCompletionCache,f as completeCheckpointNames,s as completeCuratedPaths,c as completeFilePaths,u as completeStashKeys,l as completeSymbolNames,d as completeWorksetNames};

package/packages/server/dist/dashboard-static.d.ts

@@ -0,0 +1,27 @@
+import * as express from "express";
+
+//#region packages/server/src/dashboard-static.d.ts
+type DashboardApp = {
+  get: (path: string, handler: (req: express.Request, res: express.Response) => void) => void;
+};
+type DashboardLogger = {
+  info: (message: string, meta?: Record<string, unknown>) => void;
+};
+type DashboardRequestResolution = {
+  kind: 'file';
+  path: string;
+  contentType: string;
+} | {
+  kind: 'spa';
+  path: string;
+  contentType: 'text/html';
+} | {
+  kind: 'forbidden';
+} | {
+  kind: 'not-found';
+};
+declare function resolveDashboardDir(baseDir?: string): string;
+declare function resolveDashboardRequest(dashboardDir: string, requestPath: string): DashboardRequestResolution;
+declare function registerDashboardRoutes(app: DashboardApp, dashboardDir: string, logger: DashboardLogger): boolean;
+//#endregion
+export { DashboardRequestResolution, registerDashboardRoutes, resolveDashboardDir, resolveDashboardRequest };

package/packages/server/dist/dashboard-static.js

@@ -0,0 +1 @@
+import{createReadStream as e,existsSync as t,statSync as n}from"node:fs";import{dirname as r,extname as i,join as a,resolve as o,sep as s}from"node:path";import{fileURLToPath as c}from"node:url";const l=import.meta.dirname??r(c(import.meta.url)),u={".html":`text/html`,".js":`application/javascript`,".css":`text/css`,".json":`application/json`,".png":`image/png`,".svg":`image/svg+xml`,".ico":`image/x-icon`,".woff":`font/woff`,".woff2":`font/woff2`};function d(e=l){return a(e,`..`,`..`,`dashboard`,`dist`)}function f(e,r){let c=r.replace(/^\/_dashboard\/?/,``)||`index.html`;try{c=decodeURIComponent(c)}catch{}let l=o(e,c);if(!(l===e||l.startsWith(`${e}${s}`)))return{kind:`forbidden`};try{if(n(l).isFile())return{kind:`file`,path:l,contentType:u[i(l)]??`application/octet-stream`}}catch{}let d=a(e,`index.html`);return t(d)?{kind:`spa`,path:d,contentType:`text/html`}:{kind:`not-found`}}function p(n,r,i){return t(r)?(n.get(`/_dashboard{/*path}`,(t,n)=>{let i=f(r,t.path);if(i.kind===`forbidden`){n.status(403).end(`Forbidden`);return}if(i.kind===`not-found`){n.status(404).end(`Not found`);return}n.setHeader(`Content-Type`,i.contentType),i.kind===`file`&&/\.[a-f0-9]{8,}\.(js|css)$/i.test(i.path)?n.setHeader(`Cache-Control`,`public, max-age=31536000, immutable`):n.setHeader(`Cache-Control`,`no-cache`),e(i.path).pipe(n)}),i.info(`Dashboard available`,{url:`/_dashboard/`,dir:r}),!0):!1}export{p as registerDashboardRoutes,d as resolveDashboardDir,f as resolveDashboardRequest};

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

@@ -0,0 +1,18 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { Elicitor } from "@kb/elicitation";
+
+//#region packages/server/src/elicitor.d.ts
+/**
+ * Create an Elicitor backed by the MCP server's elicitInput capability.
+ *
+ * All methods degrade gracefully: if the client does not support elicitation,
+ * they return decline / false / null / [] defaults without throwing.
+ */
+declare function createElicitor(mcpServer: McpServer): Elicitor;
+/**
+ * No-op Elicitor — always returns decline / false / null / [].
+ * Used when no MCP server is available.
+ */
+declare const noopElicitor: Elicitor;
+//#endregion
+export { createElicitor, noopElicitor };

package/packages/server/dist/elicitor.js

@@ -0,0 +1 @@
+import{buildFormSchema as e,field as t,normalizeResponse as n}from"../../elicitation/dist/index.js";function r(r){function i(){return!!r.server?.getClientCapabilities?.()?.elicitation}async function a(e,t){if(i())try{let i=await r.server.elicitInput({message:e,requestedSchema:t});return n(i?{action:i.action,content:i.content}:void 0)}catch{return}}return{get available(){return i()},async ask(e){return await a(e.message,e.schema)||{action:`decline`}},async confirm(n){let r=await a(n,e({confirmed:t.confirm(n)}));return r?.action===`accept`&&r.content?.confirmed===!0},async selectOne(n,r){let i=await a(n,e({selection:t.select(`Choose one`,r)}));if(i?.action!==`accept`)return null;let o=i.content?.selection;return typeof o==`string`?o:null},async selectMany(n,r){let i=await a(n,e({selections:t.multi(`Choose one or more`,r)}));if(i?.action!==`accept`)return[];let o=i.content?.selections;return Array.isArray(o)?o:[]},async promptText(n,r){let i=await a(n,e({text:t.text(n,{description:r})}));if(i?.action!==`accept`)return null;let o=i.content?.text;return typeof o==`string`?o:null}}}const i={available:!1,async ask(){return{action:`decline`}},async confirm(){return!1},async selectOne(){return null},async selectMany(){return[]},async promptText(){return null}};export{r as createElicitor,i as noopElicitor};

package/packages/server/dist/index.js

@@ -1 +1 @@
-import{loadConfig as e,reconfigureForWorkspace as t}from"./config.js";import{checkForUpdates as n}from"./version-check.js";import{ALL_TOOL_NAMES as r,createLazyServer as i,createMcpServer as a,initializeKnowledgeBase as o}from"./server.js";import{fileURLToPath as s}from"node:url";import{createLogger as c,serializeError as l}from"../../core/dist/index.js";import{parseArgs as u}from"node:util";import{RootsListChangedNotificationSchema as d}from"@modelcontextprotocol/sdk/types.js";const f=c(`server`),{values:p}=u({options:{transport:{type:`string`,default:process.env.KB_TRANSPORT??`stdio`},port:{type:`string`,default:process.env.KB_PORT??`3210`}}});async function m(){process.on(`unhandledRejection`,e=>{f.error(`Unhandled rejection`,l(e))}),f.info(`Starting MCP Knowledge Base server`);let c=e();if(f.info(`Config loaded`,{sourceCount:c.sources.length,storePath:c.store.path}),n(),p.transport===`http`){let{StreamableHTTPServerTransport:e}=await import(`@modelcontextprotocol/sdk/server/streamableHttp.js`),t=(await import(`express`)).default,n=await o(c),i=a(n,c);f.info(`MCP server configured`,{toolCount:r.length,resourceCount:2});let s=t();s.use(t.json()),s.use((e,t,n)=>{if(t.setHeader(`Access-Control-Allow-Origin`,process.env.KB_CORS_ORIGIN??`*`),t.setHeader(`Access-Control-Allow-Methods`,`GET, POST, DELETE, OPTIONS`),t.setHeader(`Access-Control-Allow-Headers`,`Content-Type, Authorization`),e.method===`OPTIONS`){t.status(204).end();return}n()}),s.get(`/health`,(e,t)=>{t.json({status:`ok`})}),s.post(`/mcp`,async(t,n)=>{try{let r=new e({sessionIdGenerator:void 0});await i.connect(r),await r.handleRequest(t,n,t.body),n.on(`close`,()=>{r.close()})}catch(e){f.error(`MCP handler error`,l(e)),n.headersSent||n.status(500).json({jsonrpc:`2.0`,error:{code:-32603,message:`Internal server error`},id:null})}}),s.get(`/mcp`,(e,t)=>{t.writeHead(405).end(JSON.stringify({jsonrpc:`2.0`,error:{code:-32e3,message:`Method not allowed.`},id:null}))}),s.delete(`/mcp`,(e,t)=>{t.writeHead(405).end(JSON.stringify({jsonrpc:`2.0`,error:{code:-32e3,message:`Method not allowed.`},id:null}))});let u=Number(p.port),d=s.listen(u,()=>{f.info(`MCP server listening`,{url:`http://0.0.0.0:${u}/mcp`,port:u}),(async()=>{try{let e=c.sources.map(e=>e.path).join(`, `);f.info(`Running initial index`,{sourcePaths:e});let t=await n.indexer.index(c,e=>{e.phase===`crawling`||e.phase===`done`||e.phase===`chunking`&&e.currentFile&&f.debug(`Indexing file`,{current:e.filesProcessed+1,total:e.filesTotal,file:e.currentFile})});f.info(`Initial index complete`,{filesProcessed:t.filesProcessed,filesSkipped:t.filesSkipped,chunksCreated:t.chunksCreated,durationMs:t.durationMs});try{let e=await n.curated.reindexAll();f.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){f.error(`Curated re-index failed`,l(e))}}catch(e){f.error(`Initial index failed; will retry on kb_reindex`,l(e))}})().catch(e=>f.error(`Initial index failed`,l(e)))}),m=async e=>{f.info(`Shutdown signal received`,{signal:e}),d.close(),await i.close(),await n.graphStore.close().catch(()=>{}),await n.store.close(),await n.embedder.shutdown(),process.exit(0)};process.on(`SIGINT`,()=>m(`SIGINT`)),process.on(`SIGTERM`,()=>m(`SIGTERM`))}else{let{server:e,startInit:n,ready:r,runInitialIndex:a}=i(c),{StdioServerTransport:o}=await import(`@modelcontextprotocol/sdk/server/stdio.js`),u=new o;await e.connect(u),f.info(`MCP server started`,{transport:`stdio`});let p=e=>{if(e.length===0)return!1;let n=e[0].uri,r=n.startsWith(`file://`)?s(n):n;return f.info(`MCP roots resolved`,{rootUri:n,rootPath:r,rootCount:e.length}),t(c,r),!0},m=!1;try{m=p((await e.server.listRoots()).roots),m||f.info(`No MCP roots yet; waiting for roots/list_changed notification`)}catch(e){f.warn(`MCP roots/list not supported by client; using cwd fallback`,{cwd:process.cwd(),...l(e)}),m=!0}m||=await new Promise(t=>{let n=setTimeout(()=>{f.warn(`Timed out waiting for MCP roots/list_changed; using cwd fallback`,{cwd:process.cwd()}),t(!1)},5e3);e.server.setNotificationHandler(d,async()=>{clearTimeout(n);try{t(p((await e.server.listRoots()).roots))}catch(e){f.warn(`roots/list retry failed after notification`,l(e)),t(!1)}})}),n(),r.catch(e=>{f.error(`Initialization failed — server will continue with limited tools`,l(e))}),process.env.KB_AUTO_INDEX===`false`?f.warn(`Auto-index disabled; use kb_reindex to index manually`):a().catch(e=>f.error(`Initial index failed`,l(e)))}}m().catch(e=>{f.error(`Fatal error`,l(e)),process.exit(1)});export{};
+import{fileURLToPath as e}from"node:url";import{createLogger as t,serializeError as n}from"../../core/dist/index.js";import{parseArgs as r}from"node:util";const i=t(`server`),{values:a}=r({options:{transport:{type:`string`,default:process.env.KB_TRANSPORT??`stdio`},port:{type:`string`,default:process.env.KB_PORT??`3210`}}});async function o(){if(process.on(`unhandledRejection`,e=>{i.error(`Unhandled rejection`,n(e))}),i.info(`Starting MCP Knowledge Base server`),a.transport===`http`){let[{default:e},{loadConfig:t},{registerDashboardRoutes:r,resolveDashboardDir:o}]=await Promise.all([import(`express`),import(`./config.js`),import(`./dashboard-static.js`)]),s=t();i.info(`Config loaded`,{sourceCount:s.sources.length,storePath:s.store.path});let c=e();c.use(e.json());let l=Number(a.port);c.use((e,t,n)=>{if(t.setHeader(`Access-Control-Allow-Origin`,process.env.KB_CORS_ORIGIN??`http://localhost:${l}`),t.setHeader(`Access-Control-Allow-Methods`,`GET, POST, DELETE, OPTIONS`),t.setHeader(`Access-Control-Allow-Headers`,`Content-Type, Authorization`),e.method===`OPTIONS`){t.status(204).end();return}n()}),r(c,o(),i),c.get(`/health`,(e,t)=>{t.json({status:`ok`})});let u=!1,d=null,f=null,p=Promise.resolve();c.post(`/mcp`,async(e,t)=>{if(!u||!d||!f){t.status(503).json({jsonrpc:`2.0`,error:{code:-32603,message:`Server initializing — please retry in a few seconds`},id:null});return}let r=p,a;p=new Promise(e=>{a=e}),await r;try{let n=new f({sessionIdGenerator:void 0});await d.connect(n),await n.handleRequest(e,t,e.body),n.close()}catch(e){if(i.error(`MCP handler error`,n(e)),!t.headersSent){let n=e instanceof Error?e.message:String(e),r=n.includes(`Not Acceptable`);t.status(r?406:500).json({jsonrpc:`2.0`,error:{code:r?-32e3:-32603,message:r?n:`Internal server error`},id:null})}}finally{a()}}),c.get(`/mcp`,(e,t)=>{t.writeHead(405).end(JSON.stringify({jsonrpc:`2.0`,error:{code:-32e3,message:`Method not allowed.`},id:null}))}),c.delete(`/mcp`,(e,t)=>{t.writeHead(405).end(JSON.stringify({jsonrpc:`2.0`,error:{code:-32e3,message:`Method not allowed.`},id:null}))});let m=c.listen(l,`127.0.0.1`,()=>{i.info(`MCP server listening`,{url:`http://127.0.0.1:${l}/mcp`,port:l}),setTimeout(async()=>{try{let[{createLazyServer:e,ALL_TOOL_NAMES:t},{StreamableHTTPServerTransport:r},{checkForUpdates:a}]=await Promise.all([import(`./server.js`),import(`@modelcontextprotocol/sdk/server/streamableHttp.js`),import(`./version-check.js`)]);a();let o=e(s);d=o.server,f=r,u=!0,i.info(`MCP server configured (lazy — KB initializing in background)`,{toolCount:t.length,resourceCount:2}),o.startInit(),process.env.KB_AUTO_INDEX===`true`?o.ready.then(async()=>{try{let e=s.sources.map(e=>e.path).join(`, `);i.info(`Running initial index`,{sourcePaths:e}),await o.runInitialIndex(),i.info(`Initial index complete`)}catch(e){i.error(`Initial index failed; will retry on kb_reindex`,n(e))}}).catch(e=>i.error(`KB init or indexing failed`,n(e))):(o.ready.catch(e=>i.error(`KB initialization failed`,n(e))),i.info(`Auto-index disabled in HTTP mode (set KB_AUTO_INDEX=true to enable)`))}catch(e){i.error(`Failed to load server modules`,n(e))}},100)}),h=async e=>{i.info(`Shutdown signal received`,{signal:e}),m.close(),d&&await d.close(),process.exit(0)};process.on(`SIGINT`,()=>h(`SIGINT`)),process.on(`SIGTERM`,()=>h(`SIGTERM`))}else{let[{loadConfig:t,reconfigureForWorkspace:r},{createLazyServer:a},{checkForUpdates:o},{RootsListChangedNotificationSchema:s}]=await Promise.all([import(`./config.js`),import(`./server.js`),import(`./version-check.js`),import(`@modelcontextprotocol/sdk/types.js`)]),c=t();i.info(`Config loaded`,{sourceCount:c.sources.length,storePath:c.store.path}),o();let{server:l,startInit:u,ready:d,runInitialIndex:f}=a(c),{StdioServerTransport:p}=await import(`@modelcontextprotocol/sdk/server/stdio.js`),m=new p;await l.connect(m),i.info(`MCP server started`,{transport:`stdio`});let h=t=>{if(t.length===0)return!1;let n=t[0].uri,a=n.startsWith(`file://`)?e(n):n;return i.info(`MCP roots resolved`,{rootUri:n,rootPath:a,rootCount:t.length}),r(c,a),!0},g=!1;try{g=h((await l.server.listRoots()).roots),g||i.info(`No MCP roots yet; waiting for roots/list_changed notification`)}catch(e){i.warn(`MCP roots/list not supported by client; using cwd fallback`,{cwd:process.cwd(),...n(e)}),g=!0}g||=await new Promise(e=>{let t=setTimeout(()=>{i.warn(`Timed out waiting for MCP roots/list_changed; using cwd fallback`,{cwd:process.cwd()}),e(!1)},5e3);l.server.setNotificationHandler(s,async()=>{clearTimeout(t);try{e(h((await l.server.listRoots()).roots))}catch(t){i.warn(`roots/list retry failed after notification`,n(t)),e(!1)}})}),u(),d.catch(e=>{i.error(`Initialization failed — server will continue with limited tools`,n(e))}),process.env.KB_AUTO_INDEX===`false`?i.warn(`Auto-index disabled; use kb_reindex to index manually`):f().catch(e=>i.error(`Initial index failed`,n(e)))}}o().catch(e=>{i.error(`Fatal error`,n(e)),process.exit(1)});export{};

package/packages/server/dist/mcp-logging.js

@@ -1 +1 @@
-import{addLogListener as e}from"../../core/dist/index.js";const t={debug:`debug`,info:`info`,warn:`warning`,error:`error`};function n(n){return e(({level:e,component:r,message:i,data:a})=>{try{n.sendLoggingMessage({level:t[e],logger:r,data:a?{message:i,...a}:i})}catch{}})}export{n as bridgeMcpLogging};
+import{addLogListener as e}from"../../core/dist/index.js";const t={debug:`debug`,info:`info`,warn:`warning`,error:`error`};function n(n){return e(({level:e,component:r,message:i,data:a})=>{try{Promise.resolve(n.sendLoggingMessage({level:t[e],logger:r,data:a?{message:i,...a}:i})).catch(()=>{})}catch{}})}export{n as bridgeMcpLogging};

package/packages/server/dist/output-schemas.d.ts

@@ -116,5 +116,122 @@ declare const SymbolOutputSchema: z.ZodObject<{
     siblingSymbols: z.ZodArray<z.ZodString>;
   }, z.core.$strip>>;
 }, z.core.$strip>;
+declare const SearchOutputSchema: z.ZodObject<{
+  results: z.ZodArray<z.ZodObject<{
+    sourcePath: z.ZodString;
+    contentType: z.ZodString;
+    score: z.ZodNumber;
+    headingPath: z.ZodOptional<z.ZodString>;
+    startLine: z.ZodOptional<z.ZodNumber>;
+    endLine: z.ZodOptional<z.ZodNumber>;
+    origin: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>;
+  totalResults: z.ZodNumber;
+  searchMode: z.ZodString;
+  query: z.ZodString;
+}, z.core.$strip>;
+declare const FindOutputSchema: z.ZodObject<{
+  matches: z.ZodArray<z.ZodObject<{
+    path: z.ZodString;
+    line: z.ZodOptional<z.ZodNumber>;
+    matchType: z.ZodString;
+    preview: z.ZodString;
+  }, z.core.$strip>>;
+  totalMatches: z.ZodNumber;
+  pattern: z.ZodString;
+  truncated: z.ZodBoolean;
+}, z.core.$strip>;
+declare const ScopeMapOutputSchema: z.ZodObject<{
+  files: z.ZodArray<z.ZodObject<{
+    path: z.ZodString;
+    relevance: z.ZodNumber;
+    estimatedTokens: z.ZodNumber;
+    focusLines: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>;
+  totalFiles: z.ZodNumber;
+  totalEstimatedTokens: z.ZodNumber;
+  task: z.ZodString;
+}, z.core.$strip>;
+declare const BlastRadiusOutputSchema: z.ZodObject<{
+  changedFiles: z.ZodArray<z.ZodString>;
+  affectedFiles: z.ZodArray<z.ZodObject<{
+    path: z.ZodString;
+    impact: z.ZodString;
+    reason: z.ZodString;
+  }, z.core.$strip>>;
+  totalAffected: z.ZodNumber;
+  riskLevel: z.ZodString;
+}, z.core.$strip>;
+declare const AuditOutputSchema: z.ZodObject<{
+  passed: z.ZodBoolean;
+  score: z.ZodNumber;
+  checks: z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    passed: z.ZodBoolean;
+    message: z.ZodOptional<z.ZodString>;
+    severity: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+  summary: z.ZodString;
+}, z.core.$strip>;
+declare const GraphOutputSchema: z.ZodObject<{
+  nodes: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    type: z.ZodString;
+    sourcePath: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+  edges: z.ZodArray<z.ZodObject<{
+    fromId: z.ZodString;
+    toId: z.ZodString;
+    type: z.ZodString;
+  }, z.core.$strip>>;
+  totalNodes: z.ZodNumber;
+  totalEdges: z.ZodNumber;
+  query: z.ZodString;
+}, z.core.$strip>;
+declare const DeadSymbolsOutputSchema: z.ZodObject<{
+  symbols: z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    path: z.ZodString;
+    line: z.ZodOptional<z.ZodNumber>;
+    kind: z.ZodString;
+  }, z.core.$strip>>;
+  totalDead: z.ZodNumber;
+}, z.core.$strip>;
+declare const AnalyzeStructureOutputSchema: z.ZodObject<{
+  files: z.ZodNumber;
+  packages: z.ZodNumber;
+  languages: z.ZodRecord<z.ZodString, z.ZodNumber>;
+  tree: z.ZodString;
+}, z.core.$strip>;
+declare const FileSummaryOutputSchema: z.ZodObject<{
+  path: z.ZodString;
+  language: z.ZodString;
+  lines: z.ZodNumber;
+  imports: z.ZodNumber;
+  exports: z.ZodNumber;
+  functions: z.ZodNumber;
+  classes: z.ZodNumber;
+}, z.core.$strip>;
+declare const GitContextOutputSchema: z.ZodObject<{
+  gitRoot: z.ZodString;
+  branch: z.ZodString;
+  commitCount: z.ZodNumber;
+  hasUncommitted: z.ZodBoolean;
+  recentCommits: z.ZodArray<z.ZodObject<{
+    hash: z.ZodString;
+    message: z.ZodString;
+    author: z.ZodString;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const CompactOutputSchema: z.ZodObject<{
+  originalChars: z.ZodNumber;
+  compressedChars: z.ZodNumber;
+  ratio: z.ZodNumber;
+  segmentsKept: z.ZodNumber;
+  segmentsTotal: z.ZodNumber;
+}, z.core.$strip>;
 //#endregion
-export { CheckOutputSchema, EnvOutputSchema, HealthOutputSchema, ListOutputSchema, MeasureOutputSchema, StatusOutputSchema, SymbolOutputSchema, TimeOutputSchema };
+export { AnalyzeStructureOutputSchema, AuditOutputSchema, BlastRadiusOutputSchema, CheckOutputSchema, CompactOutputSchema, DeadSymbolsOutputSchema, EnvOutputSchema, FileSummaryOutputSchema, FindOutputSchema, GitContextOutputSchema, GraphOutputSchema, HealthOutputSchema, ListOutputSchema, MeasureOutputSchema, ScopeMapOutputSchema, SearchOutputSchema, StatusOutputSchema, SymbolOutputSchema, TimeOutputSchema };

package/packages/server/dist/output-schemas.js

@@ -1 +1 @@
-import{z as e}from"zod";const t=e.object({totalRecords:e.number(),totalFiles:e.number(),lastIndexedAt:e.string().nullable(),onboarded:e.boolean(),contentTypes:e.record(e.string(),e.number()),wasmAvailable:e.boolean(),graphStats:e.object({nodes:e.number(),edges:e.number()}).nullable(),curatedCount:e.number()}),n=e.object({entries:e.array(e.object({path:e.string(),title:e.string(),category:e.string(),tags:e.array(e.string()),version:e.number(),preview:e.string()})),totalCount:e.number()}),r=e.object({ok:e.boolean(),checks:e.array(e.object({name:e.string(),ok:e.boolean(),message:e.string().optional()}))}),i=e.object({summary:e.object({totalFiles:e.number(),totalLines:e.number(),totalCodeLines:e.number(),totalFunctions:e.number(),avgComplexity:e.number(),maxComplexity:e.object({value:e.number(),file:e.string()})}),files:e.array(e.object({path:e.string(),lines:e.number(),code:e.number(),complexity:e.number(),functions:e.number()}))}),a=e.object({platform:e.string(),arch:e.string(),nodeVersion:e.string(),cwd:e.string(),cpus:e.number(),memoryFreeGb:e.number(),memoryTotalGb:e.number()}),o=e.object({iso:e.string(),unix:e.number(),timezone:e.string(),formatted:e.string()}),s=e.object({passed:e.boolean(),errorCount:e.number(),warningCount:e.number(),topErrors:e.array(e.string())}),c=e.object({passed:e.boolean(),tsc:s,biome:s}),l=e.object({name:e.string(),definedIn:e.object({path:e.string(),line:e.number(),kind:e.string(),signature:e.string().optional()}).nullable(),importedBy:e.array(e.object({path:e.string(),line:e.number(),importStatement:e.string()})),referencedIn:e.array(e.object({path:e.string(),line:e.number(),context:e.string(),scope:e.string().optional()})),graphContext:e.object({definingModule:e.string().optional(),importedByModules:e.array(e.string()),siblingSymbols:e.array(e.string())}).nullable()});export{c as CheckOutputSchema,a as EnvOutputSchema,r as HealthOutputSchema,n as ListOutputSchema,i as MeasureOutputSchema,t as StatusOutputSchema,l as SymbolOutputSchema,o as TimeOutputSchema};
+import{z as e}from"zod";const t=e.object({totalRecords:e.number(),totalFiles:e.number(),lastIndexedAt:e.string().nullable(),onboarded:e.boolean(),contentTypes:e.record(e.string(),e.number()),wasmAvailable:e.boolean(),graphStats:e.object({nodes:e.number(),edges:e.number()}).nullable(),curatedCount:e.number()}),n=e.object({entries:e.array(e.object({path:e.string(),title:e.string(),category:e.string(),tags:e.array(e.string()),version:e.number(),preview:e.string()})),totalCount:e.number()}),r=e.object({ok:e.boolean(),checks:e.array(e.object({name:e.string(),ok:e.boolean(),message:e.string().optional()}))}),i=e.object({summary:e.object({totalFiles:e.number(),totalLines:e.number(),totalCodeLines:e.number(),totalFunctions:e.number(),avgComplexity:e.number(),maxComplexity:e.object({value:e.number(),file:e.string()})}),files:e.array(e.object({path:e.string(),lines:e.number(),code:e.number(),complexity:e.number(),functions:e.number()}))}),a=e.object({platform:e.string(),arch:e.string(),nodeVersion:e.string(),cwd:e.string(),cpus:e.number(),memoryFreeGb:e.number(),memoryTotalGb:e.number()}),o=e.object({iso:e.string(),unix:e.number(),timezone:e.string(),formatted:e.string()}),s=e.object({passed:e.boolean(),errorCount:e.number(),warningCount:e.number(),topErrors:e.array(e.string())}),c=e.object({passed:e.boolean(),tsc:s,biome:s}),l=e.object({name:e.string(),definedIn:e.object({path:e.string(),line:e.number(),kind:e.string(),signature:e.string().optional()}).nullable(),importedBy:e.array(e.object({path:e.string(),line:e.number(),importStatement:e.string()})),referencedIn:e.array(e.object({path:e.string(),line:e.number(),context:e.string(),scope:e.string().optional()})),graphContext:e.object({definingModule:e.string().optional(),importedByModules:e.array(e.string()),siblingSymbols:e.array(e.string())}).nullable()}),u=e.object({sourcePath:e.string(),contentType:e.string(),score:e.number(),headingPath:e.string().optional(),startLine:e.number().optional(),endLine:e.number().optional(),origin:e.string().optional(),category:e.string().optional(),tags:e.array(e.string()).optional()}),d=e.object({results:e.array(u),totalResults:e.number(),searchMode:e.string(),query:e.string()}),f=e.object({path:e.string(),line:e.number().optional(),matchType:e.string(),preview:e.string()}),p=e.object({matches:e.array(f),totalMatches:e.number(),pattern:e.string(),truncated:e.boolean()}),m=e.object({path:e.string(),relevance:e.number(),estimatedTokens:e.number(),focusLines:e.array(e.string()).optional()}),h=e.object({files:e.array(m),totalFiles:e.number(),totalEstimatedTokens:e.number(),task:e.string()}),g=e.object({path:e.string(),impact:e.string(),reason:e.string()}),_=e.object({changedFiles:e.array(e.string()),affectedFiles:e.array(g),totalAffected:e.number(),riskLevel:e.string()}),v=e.object({name:e.string(),passed:e.boolean(),message:e.string().optional(),severity:e.string().optional()}),y=e.object({passed:e.boolean(),score:e.number(),checks:e.array(v),summary:e.string()}),b=e.object({id:e.string(),name:e.string(),type:e.string(),sourcePath:e.string().optional()}),x=e.object({fromId:e.string(),toId:e.string(),type:e.string()}),S=e.object({nodes:e.array(b),edges:e.array(x),totalNodes:e.number(),totalEdges:e.number(),query:e.string()}),C=e.object({symbols:e.array(e.object({name:e.string(),path:e.string(),line:e.number().optional(),kind:e.string()})),totalDead:e.number()}),w=e.object({files:e.number(),packages:e.number(),languages:e.record(e.string(),e.number()),tree:e.string()}),T=e.object({path:e.string(),language:e.string(),lines:e.number(),imports:e.number(),exports:e.number(),functions:e.number(),classes:e.number()}),E=e.object({gitRoot:e.string(),branch:e.string(),commitCount:e.number(),hasUncommitted:e.boolean(),recentCommits:e.array(e.object({hash:e.string(),message:e.string(),author:e.string()}))}),D=e.object({originalChars:e.number(),compressedChars:e.number(),ratio:e.number(),segmentsKept:e.number(),segmentsTotal:e.number()});export{w as AnalyzeStructureOutputSchema,y as AuditOutputSchema,_ as BlastRadiusOutputSchema,c as CheckOutputSchema,D as CompactOutputSchema,C as DeadSymbolsOutputSchema,a as EnvOutputSchema,T as FileSummaryOutputSchema,p as FindOutputSchema,E as GitContextOutputSchema,S as GraphOutputSchema,r as HealthOutputSchema,n as ListOutputSchema,i as MeasureOutputSchema,h as ScopeMapOutputSchema,d as SearchOutputSchema,t as StatusOutputSchema,l as SymbolOutputSchema,o as TimeOutputSchema};

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

@@ -1,6 +1,13 @@
+import { CuratedKnowledgeManager } from "./curated-manager.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { IGraphStore, IKnowledgeStore } from "@kb/store";
 
 //#region packages/server/src/prompts.d.ts
-declare function registerPrompts(server: McpServer): void;
+interface PromptDependencies {
+  curated: CuratedKnowledgeManager;
+  store: IKnowledgeStore;
+  graphStore: IGraphStore;
+}
+declare function registerPrompts(server: McpServer, deps?: PromptDependencies): void;
 //#endregion
-export { registerPrompts };
+export { PromptDependencies, registerPrompts };

package/packages/server/dist/prompts.js

@@ -1,7 +1,13 @@
-import{z as e}from"zod";function t(t){t.registerPrompt(`ready`,{title:`KB Ready`,description:`Knowledge base is ready — quick-start guide for search, onboard, and workflows`},async()=>({messages:[{role:`user`,content:{type:`text`,text:[`Knowledge base is ready. Quick start:`,``,'• **New project?** → `onboard({ path: "." })` for full codebase analysis','• **Returning?** → `status({})` then `search({ query: "SESSION CHECKPOINT", origin: "curated" })`','• **Exploring?** → `guide({ goal: "your task" })` for workflow recommendations','• **Quick lookup?** → `search({ query: "your question" })`'].join(`
-`)}}]})),t.registerPrompt(`onboard`,{title:`Onboard Codebase`,description:`Analyze the codebase for first-time onboarding — runs all analyzers and produces a knowledge summary`,argsSchema:{path:e.string().optional().describe(`Path to analyze (default: workspace root)`)}},async({path:e})=>({messages:[{role:`user`,content:{type:`text`,text:[`Run the full onboarding workflow for "${e??`.`}"`,``,`1. \`onboard({ path: "${e??`.`}" })\` — full codebase analysis`,`2. \`produce_knowledge({ path: "${e??`.`}" })\` — generate synthesis`,"3. `remember` key findings as curated entries","4. `status` to verify index health"].join(`
-`)}}]})),t.registerPrompt(`sessionStart`,{title:`Start KB Session`,description:`Initialize a KB session — check status, list knowledge, and resume from last checkpoint`},async()=>({messages:[{role:`user`,content:{type:`text`,text:[`Run the session start protocol:`,``,"1. `status({})` — check KB health and onboard state","2. `list()` — see stored knowledge entries",'3. `search({ query: "SESSION CHECKPOINT", origin: "curated" })` — resume prior work'].join(`
-`)}}]})),t.registerPrompt(`sessionEnd`,{title:`End KB Session`,description:`Persist decisions and create a session checkpoint before ending`,argsSchema:{summary:e.string().describe(`Brief summary of decisions made, blockers encountered, and next steps`)}},async({summary:e})=>({messages:[{role:`user`,content:{type:`text`,text:[`Run the session end protocol:`,``,'1. `remember({ title: "Session checkpoint: '+e.slice(0,60)+`...", content: "`+e.replace(/"/g,`\\"`)+'", category: "conventions" })` — persist findings',"2. `reindex({})` — refresh search index if files changed",`3. Confirm session data saved`].join(`
-`)}}]})),t.registerPrompt(`search`,{title:`Search Knowledge Base`,description:`Search the knowledge base with hybrid semantic + keyword search`,argsSchema:{query:e.string().describe(`Search query`)}},async({query:e})=>({messages:[{role:`user`,content:{type:`text`,text:`Search the knowledge base for: "${e}"\n\nUse \`search({ query: "${e.replace(/"/g,`\\"`)}" })\` to find relevant code, documentation, and curated knowledge.`}}]})),t.registerPrompt(`remember`,{title:`Remember Knowledge`,description:`Store a decision, convention, or finding as curated knowledge`,argsSchema:{title:e.string().describe(`Title of the knowledge entry`),content:e.string().describe(`Content to remember`),category:e.enum([`conventions`,`decisions`,`patterns`,`blockers`,`tasks`]).optional().describe(`Category (default: conventions)`)}},async({title:e,content:t,category:n})=>({messages:[{role:`user`,content:{type:`text`,text:`Store this knowledge:\n\n\`remember({ title: "${e.replace(/"/g,`\\"`)}", content: "${t.replace(/"/g,`\\"`).slice(0,200)}...", category: "${n??`conventions`}" })\``}}]})),t.registerPrompt(`planTask`,{title:`Plan a Task`,description:`Generate a reading plan and scope map for a development task`,argsSchema:{task:e.string().describe(`Description of the task to plan`)}},async({task:e})=>({messages:[{role:`user`,content:{type:`text`,text:[`Plan implementation for: "${e}"`,``,'1. `search({ query: "'+e.replace(/"/g,`\\"`)+'" })` — find related code and prior decisions','2. `scope_map({ task: "'+e.replace(/"/g,`\\"`)+'" })` — generate a reading plan',"3. For each recommended file, use `file_summary` then `compact` for detail","4. `blast_radius` on planned changes to assess impact"].join(`
-`)}}]})),t.registerPrompt(`investigate`,{title:`Investigate Bug`,description:`Bug investigation workflow — parse error, find symbols, trace data flow, assess impact`,argsSchema:{error:e.string().describe(`Error message, stack trace, or bug description`)}},async({error:e})=>({messages:[{role:`user`,content:{type:`text`,text:[`Investigate this error:`,"```",e,"```",``,`Follow the bug investigation workflow:`,"1. `parse_output({ text: <error> })` — extract structured data from the error","2. `symbol({ name: <relevant symbol> })` — find definition and references",'3. `trace({ symbol: <symbol>, direction: "backward" })` — trace data flow to find root cause',"4. `blast_radius({ changed_files: [<affected files>] })` — assess fix impact"].join(`
-`)}}]}))}export{t as registerPrompts};
+import{completeCheckpointNames as e,completeCuratedPaths as t,completeFilePaths as n,completeStashKeys as r,completeSymbolNames as i,completeWorksetNames as a}from"./completions.js";import{completable as o}from"@modelcontextprotocol/sdk/server/completable.js";import{z as s}from"zod";function c(c,l){if(c.registerPrompt(`ready`,{title:`KB Ready`,description:`Knowledge base is ready — quick-start guide for search, onboard, and workflows`},async()=>({messages:[{role:`user`,content:{type:`text`,text:[`Knowledge base is ready. Quick start:`,``,'• **New project?** → `onboard({ path: "." })` for full codebase analysis','• **Returning?** → `status({})` then `search({ query: "SESSION CHECKPOINT", origin: "curated" })`','• **Exploring?** → `guide({ goal: "your task" })` for workflow recommendations','• **Quick lookup?** → `search({ query: "your question" })`'].join(`
+`)}}]})),c.registerPrompt(`onboard`,{title:`Onboard Codebase`,description:`Analyze the codebase for first-time onboarding — runs all analyzers and produces a knowledge summary`,argsSchema:{path:s.string().optional().describe(`Path to analyze (default: workspace root)`)}},async({path:e})=>({messages:[{role:`user`,content:{type:`text`,text:[`Run the full onboarding workflow for "${e??`.`}"`,``,`1. \`onboard({ path: "${e??`.`}" })\` — full codebase analysis`,`2. \`produce_knowledge({ path: "${e??`.`}" })\` — generate synthesis`,"3. `remember` key findings as curated entries","4. `status` to verify index health"].join(`
+`)}}]})),c.registerPrompt(`sessionStart`,{title:`Start KB Session`,description:`Initialize a KB session — check status, list knowledge, and resume from last checkpoint`},async()=>({messages:[{role:`user`,content:{type:`text`,text:[`Run the session start protocol:`,``,"1. `status({})` — check KB health and onboard state","2. `list()` — see stored knowledge entries",'3. `search({ query: "SESSION CHECKPOINT", origin: "curated" })` — resume prior work'].join(`
+`)}}]})),c.registerPrompt(`sessionEnd`,{title:`End KB Session`,description:`Persist decisions and create a session checkpoint before ending`,argsSchema:{summary:s.string().describe(`Brief summary of decisions made, blockers encountered, and next steps`)}},async({summary:e})=>({messages:[{role:`user`,content:{type:`text`,text:[`Run the session end protocol:`,``,'1. `remember({ title: "Session checkpoint: '+e.slice(0,60)+`...", content: "`+e.replace(/"/g,`\\"`)+'", category: "conventions" })` — persist findings',"2. `reindex({})` — refresh search index if files changed",`3. Confirm session data saved`].join(`
+`)}}]})),c.registerPrompt(`search`,{title:`Search Knowledge Base`,description:`Search the knowledge base with hybrid semantic + keyword search`,argsSchema:{query:s.string().describe(`Search query`)}},async({query:e})=>({messages:[{role:`user`,content:{type:`text`,text:`Search the knowledge base for: "${e}"\n\nUse \`search({ query: "${e.replace(/"/g,`\\"`)}" })\` to find relevant code, documentation, and curated knowledge.`}}]})),c.registerPrompt(`remember`,{title:`Remember Knowledge`,description:`Store a decision, convention, or finding as curated knowledge`,argsSchema:{title:s.string().describe(`Title of the knowledge entry`),content:s.string().describe(`Content to remember`),category:s.enum([`conventions`,`decisions`,`patterns`,`blockers`,`tasks`]).optional().describe(`Category (default: conventions)`)}},async({title:e,content:t,category:n})=>({messages:[{role:`user`,content:{type:`text`,text:`Store this knowledge:\n\n\`remember({ title: "${e.replace(/"/g,`\\"`)}", content: "${t.replace(/"/g,`\\"`).slice(0,200)}...", category: "${n??`conventions`}" })\``}}]})),c.registerPrompt(`planTask`,{title:`Plan a Task`,description:`Generate a reading plan and scope map for a development task`,argsSchema:{task:s.string().describe(`Description of the task to plan`)}},async({task:e})=>({messages:[{role:`user`,content:{type:`text`,text:[`Plan implementation for: "${e}"`,``,'1. `search({ query: "'+e.replace(/"/g,`\\"`)+'" })` — find related code and prior decisions','2. `scope_map({ task: "'+e.replace(/"/g,`\\"`)+'" })` — generate a reading plan',"3. For each recommended file, use `file_summary` then `compact` for detail","4. `blast_radius` on planned changes to assess impact"].join(`
+`)}}]})),c.registerPrompt(`investigate`,{title:`Investigate Bug`,description:`Bug investigation workflow — parse error, find symbols, trace data flow, assess impact`,argsSchema:{error:s.string().describe(`Error message, stack trace, or bug description`)}},async({error:e})=>({messages:[{role:`user`,content:{type:`text`,text:[`Investigate this error:`,"```",e,"```",``,`Follow the bug investigation workflow:`,"1. `parse_output({ text: <error> })` — extract structured data from the error","2. `symbol({ name: <relevant symbol> })` — find definition and references",'3. `trace({ symbol: <symbol>, direction: "backward" })` — trace data flow to find root cause',"4. `blast_radius({ changed_files: [<affected files>] })` — assess fix impact"].join(`
+`)}}]})),!l)return;let{curated:u,store:d,graphStore:f}=l;c.registerPrompt(`read_knowledge`,{title:`Read Knowledge`,description:`Read a curated knowledge entry by path — with autocomplete`,argsSchema:{path:o(s.string().describe(`Path of the curated entry (e.g. conventions/naming.md)`),async e=>t(u,e))}},async({path:e})=>({messages:[{role:`user`,content:{type:`text`,text:`Read the curated knowledge entry: \`read({ path: "${e}" })\``}}]})),c.registerPrompt(`update_knowledge`,{title:`Update Knowledge`,description:`Update an existing curated knowledge entry — with autocomplete`,argsSchema:{path:o(s.string().describe(`Path of the curated entry to update`),async e=>t(u,e)),content:s.string().describe(`New content for the entry`)}},async({path:e,content:t})=>({messages:[{role:`user`,content:{type:`text`,text:`Update the curated entry at "${e}":\n\n\`update({ path: "${e}", content: "${t.replace(/"/g,`\\"`).slice(0,200)}..." })\``}}]})),c.registerPrompt(`forget_knowledge`,{title:`Forget Knowledge`,description:`Delete a curated knowledge entry — with autocomplete`,argsSchema:{path:o(s.string().describe(`Path of the curated entry to delete`),async e=>t(u,e))}},async({path:e})=>({messages:[{role:`user`,content:{type:`text`,text:`Delete the curated entry: \`forget({ path: "${e}" })\``}}]})),c.registerPrompt(`lookup_file`,{title:`Lookup File`,description:`Look up an indexed file — with autocomplete`,argsSchema:{path:o(s.string().describe(`Source file path`),async e=>n(d,e))}},async({path:e})=>({messages:[{role:`user`,content:{type:`text`,text:`Look up the indexed file: \`file_summary({ path: "${e}" })\``}}]})),c.registerPrompt(`find_symbol`,{title:`Find Symbol`,description:`Find a symbol definition and references — with autocomplete`,argsSchema:{name:o(s.string().describe(`Symbol name`),async e=>i(f,e))}},async({name:e})=>({messages:[{role:`user`,content:{type:`text`,text:`Find symbol: \`symbol({ name: "${e}" })\``}}]})),c.registerPrompt(`get_stash`,{title:`Get Stash`,description:`Retrieve a stashed value by key — with autocomplete`,argsSchema:{key:o(s.string().describe(`Stash key`),e=>r(e))}},async({key:e})=>({messages:[{role:`user`,content:{type:`text`,text:`Get stashed value: \`stash({ action: "get", key: "${e}" })\``}}]})),c.registerPrompt(`get_workset`,{title:`Get Workset`,description:`Load a saved workset by name — with autocomplete`,argsSchema:{name:o(s.string().describe(`Workset name`),e=>a(e))}},async({name:e})=>({messages:[{role:`user`,content:{type:`text`,text:`Load workset: \`workset({ action: "load", name: "${e}" })\``}}]})),c.registerPrompt(`load_checkpoint`,{title:`Load Checkpoint`,description:`Restore a saved checkpoint by name — with autocomplete`,argsSchema:{name:o(s.string().describe(`Checkpoint name`),t=>e(t))}},async({name:e})=>({messages:[{role:`user`,content:{type:`text`,text:`Load checkpoint: \`checkpoint({ action: "load", name: "${e}" })\``}}]})),c.registerPrompt(`audit_workflow`,{title:`Audit Workflow`,description:`Run a full project quality audit: check → test_run → audit → produce recommendations`},async()=>({messages:[{role:`user`,content:{type:`text`,text:[`## Audit Workflow`,``,`Execute the following tools in sequence:`,``,"1. `check({})` — Run typecheck + lint","2. `test_run({})` — Run all tests","3. `audit({})` — Full project audit","4. Review findings and `remember` important patterns",``,`Report: pass/fail status, error counts, audit recommendations, and suggested next steps.`].join(`
+`)}}]})),c.registerPrompt(`refactor_workflow`,{title:`Refactor Workflow`,description:`Safe refactoring workflow: analyze → blast_radius → implement → verify`},async()=>({messages:[{role:`user`,content:{type:`text`,text:[`## Refactor Workflow`,``,`For the target files/symbols:`,``,"1. `analyze_structure({ path })` — Understand current structure","2. `analyze_dependencies({ path })` — Map dependency graph","3. `blast_radius({ changed_files })` — Assess impact scope",`4. Implement changes carefully`,"5. `check({})` + `test_run({})` — Verify nothing broke","6. `reindex({})` — Update KB with changes",``,`What would you like to refactor?`].join(`
+`)}}]})),c.registerPrompt(`forge_workflow`,{title:`FORGE Workflow`,description:`Full FORGE protocol: classify → ground → implement with quality gates`},async()=>({messages:[{role:`user`,content:{type:`text`,text:[`## FORGE Quality Gate Workflow`,``,"1. `forge_classify({ task })` — Determine complexity tier (floor/standard/critical)","2. `forge_ground({ task, files, root_path })` — Full grounding analysis",`3. Review typed unknowns and constraints`,`4. Implement with evidence tracking`,'5. `evidence_map({ action: "validate" })` — Verify all claims',"6. `check({})` + `test_run({})` — Final verification",``,`Describe the task to classify:`].join(`
+`)}}]})),c.registerPrompt(`investigate_workflow`,{title:`Investigate Issue`,description:`Bug investigation workflow: trace → analyze → find root cause → fix`},async()=>({messages:[{role:`user`,content:{type:`text`,text:[`## Bug Investigation Workflow`,``,"1. `parse_output({ output })` — Parse error messages if available","2. `symbol({ name })` — Find the failing symbol",'3. `trace({ symbol, direction: "backward" })` — Trace data flow to root cause',"4. `blast_radius({ changed_files })` — Assess impact of fix",`5. Implement fix`,"6. `check({})` + `test_run({})` — Verify fix works",``,`Describe the issue:`].join(`
+`)}}]})),c.registerPrompt(`context_workflow`,{title:`Build Context`,description:`Progressive context building: file_summary → compact → digest for deep understanding`},async()=>({messages:[{role:`user`,content:{type:`text`,text:[`## Context Building Workflow`,``,`Build understanding progressively:`,``,"1. `file_summary({ path })` — Structure overview (~50 tokens)","2. `compact({ path, query })` — Extract relevant sections (5-20x reduction)","3. `digest({ sources })` — Multi-file compressed summary","4. `stratum_card({ files })` — Reusable reference card",``,`For project-wide context:`,"- `scope_map({ task })` — Reading plan for a specific task",'- `workset({ action: "save" })` — Save working set for later',``,`What do you need to understand?`].join(`
+`)}}]})),c.registerPrompt(`migrate_workflow`,{title:`Migration Workflow`,description:`Code migration workflow: analyze → plan → migrate → verify → document`},async()=>({messages:[{role:`user`,content:{type:`text`,text:[`## Migration Workflow`,``,"1. `analyze_structure({ path })` — Current codebase state","2. `analyze_patterns({ path })` — Identify patterns to migrate","3. `dead_symbols({ path })` — Find unused code to remove",'4. `scope_map({ task: "migration" })` — Plan migration scope',"5. Use `codemod` for bulk transformations","6. `check({})` + `test_run({})` — Verify after each step","7. `changelog({ from })` — Document changes",``,`What are you migrating from/to?`].join(`
+`)}}]}))}export{c as registerPrompts};

package/packages/server/dist/resources/curated-resources.js

@@ -1,2 +1,2 @@
 import{ResourceTemplate as e}from"@modelcontextprotocol/sdk/server/mcp.js";function t(t,n){t.resource(`kb-curated-index`,`kb://curated`,{description:`Index of all curated knowledge entries`,mimeType:`text/markdown`},async()=>{let e=(await n.list()).map(e=>`- [${e.title}](kb://curated/${e.path}) — ${e.category}`);return{contents:[{uri:`kb://curated`,text:`# Curated Knowledge Index\n\n${e.length>0?e.join(`
-`):`_No curated entries yet._`}`,mimeType:`text/markdown`}]}});let r=new e(`kb://curated/{path}`,{list:async()=>({resources:(await n.list()).map(e=>({uri:`kb://curated/${e.path}`,name:e.title,description:`[${e.category}] ${e.contentPreview?.slice(0,80)??``}`,mimeType:`text/markdown`}))})});t.resource(`kb-curated-entry`,r,{description:`A curated knowledge entry`,mimeType:`text/markdown`},async(e,t)=>{let r=t.path;if(!r)throw Error(`Missing path variable in curated resource URI`);let i=await n.read(r);return{contents:[{uri:e.toString(),text:`---\ntitle: ${i.title}\ncategory: ${i.category}\ntags: ${i.tags?.join(`, `)??``}\nversion: ${i.version??1}\n---\n\n${i.content??i.contentPreview??``}`,mimeType:`text/markdown`}]}})}export{t as registerCuratedResources};
+`):`_No curated entries yet._`}`,mimeType:`text/markdown`}]}});let r=new e(`kb://curated/{+path}`,{list:async()=>({resources:(await n.list()).map(e=>({uri:`kb://curated/${e.path}`,name:e.title,description:`[${e.category}] ${e.contentPreview?.slice(0,80)??``}`,mimeType:`text/markdown`}))})});t.resource(`kb-curated-entry`,r,{description:`A curated knowledge entry`,mimeType:`text/markdown`},async(e,t)=>{let r=t.path;if(!r)throw Error(`Missing path variable in curated resource URI`);let i=await n.read(r);return{contents:[{uri:e.toString(),text:`---\ntitle: ${i.title}\ncategory: ${i.category}\ntags: ${i.tags?.join(`, `)??``}\nversion: ${i.version??1}\n---\n\n${i.content??i.contentPreview??``}`,mimeType:`text/markdown`}]}})}export{t as registerCuratedResources};

package/packages/server/dist/resources/resource-notifier.d.ts

@@ -0,0 +1,45 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region packages/server/src/resources/resource-notifier.d.ts
+declare class ResourceNotifier {
+  private readonly mcpServer;
+  constructor(mcpServer: McpServer);
+  /**
+   * Notify that the KB status resource has changed.
+   * Call after: reindex, onboard, remember, forget operations.
+   */
+  notifyStatusChanged(): Promise<void>;
+  /**
+   * Notify that the file tree resource has changed.
+   * Call after: reindex operations.
+   */
+  notifyFileTreeChanged(): Promise<void>;
+  /**
+   * Notify that the curated knowledge index has changed.
+   * Call after: remember, update, forget operations.
+   */
+  notifyCuratedIndexChanged(): Promise<void>;
+  /**
+   * Notify that a specific curated entry has changed.
+   * Call after: update or remember operations for a specific path.
+   */
+  notifyCuratedEntryChanged(path: string): Promise<void>;
+  /**
+   * Notify that the resource list itself changed (new/removed resources).
+   * Call after: curated entries are added or removed.
+   */
+  notifyResourceListChanged(): Promise<void>;
+  /**
+   * Convenience: notify all relevant resources after a reindex.
+   */
+  notifyAfterReindex(): Promise<void>;
+  /**
+   * Convenience: notify all relevant resources after a curated write.
+   */
+  notifyAfterCuratedWrite(path?: string): Promise<void>;
+  private sendUpdate;
+}
+/** No-op resource notifier — all methods silently succeed. */
+declare const noopResourceNotifier: ResourceNotifier;
+//#endregion
+export { ResourceNotifier, noopResourceNotifier };

package/packages/server/dist/resources/resource-notifier.js

@@ -0,0 +1 @@
+import{createLogger as e}from"../../../core/dist/index.js";const t=e(`resource-notifier`);var n=class{constructor(e){this.mcpServer=e}async notifyStatusChanged(){await this.sendUpdate(`kb://status`)}async notifyFileTreeChanged(){await this.sendUpdate(`kb://file-tree`)}async notifyCuratedIndexChanged(){await this.sendUpdate(`kb://curated`)}async notifyCuratedEntryChanged(e){await this.sendUpdate(`kb://curated/${e}`)}async notifyResourceListChanged(){try{await this.mcpServer.server.sendResourceListChanged()}catch(e){t.debug(`sendResourceListChanged failed`,{error:String(e)})}}async notifyAfterReindex(){await Promise.allSettled([this.notifyStatusChanged(),this.notifyFileTreeChanged()])}async notifyAfterCuratedWrite(e){let t=[this.notifyStatusChanged(),this.notifyCuratedIndexChanged()];e&&t.push(this.notifyCuratedEntryChanged(e)),await Promise.allSettled(t)}async sendUpdate(e){try{await this.mcpServer.server.sendResourceUpdated({uri:e})}catch(n){t.debug(`sendResourceUpdated failed`,{uri:e,error:String(n)})}}};const r={notifyStatusChanged:async()=>{},notifyFileTreeChanged:async()=>{},notifyCuratedIndexChanged:async()=>{},notifyCuratedEntryChanged:async()=>{},notifyResourceListChanged:async()=>{},notifyAfterReindex:async()=>{},notifyAfterCuratedWrite:async()=>{}};export{n as ResourceNotifier,r as noopResourceNotifier};

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

@@ -0,0 +1,41 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region packages/server/src/sampling.d.ts
+interface SamplingRequest {
+  /** The user prompt to send. */
+  prompt: string;
+  /** Optional system prompt. */
+  systemPrompt?: string;
+  /** Optional context to prepend to the prompt. */
+  context?: string;
+  /** Max tokens in the response (default: 4000). */
+  maxTokens?: number;
+  /** Model preferences. */
+  modelPreferences?: {
+    costPriority?: number;
+    speedPriority?: number;
+    intelligencePriority?: number;
+  };
+}
+interface SamplingResponse {
+  /** The model's text response. */
+  text: string;
+  /** Which model was used. */
+  model?: string;
+  /** Stop reason. */
+  stopReason?: string;
+}
+interface ISamplingClient {
+  /** Whether the sampling capability is available. */
+  readonly available: boolean;
+  /** Send a prompt to the host LLM. */
+  createMessage(request: SamplingRequest): Promise<SamplingResponse>;
+}
+/**
+ * Create a sampling client backed by the MCP server.
+ */
+declare function createSamplingClient(mcpServer: McpServer): ISamplingClient;
+/** No-op sampling client — always reports unavailable. */
+declare const noopSamplingClient: ISamplingClient;
+//#endregion
+export { ISamplingClient, SamplingRequest, SamplingResponse, createSamplingClient, noopSamplingClient };

package/packages/server/dist/sampling.js

@@ -0,0 +1,2 @@
+import{createLogger as e}from"../../core/dist/index.js";const t=e(`sampling`);function n(e){if(!e.modelPreferences)return;let t={...e.modelPreferences.costPriority===void 0?{}:{costPriority:e.modelPreferences.costPriority},...e.modelPreferences.speedPriority===void 0?{}:{speedPriority:e.modelPreferences.speedPriority},...e.modelPreferences.intelligencePriority===void 0?{}:{intelligencePriority:e.modelPreferences.intelligencePriority}};return Object.keys(t).length>0?t:void 0}function r(e){if(Array.isArray(e))return e.map(e=>r(e)).filter(e=>e.length>0).join(`
+`);if(e&&typeof e==`object`&&`type`in e){let t=e;if(t.type===`text`&&typeof t.text==`string`)return t.text}return JSON.stringify(e)}function i(e){let i=e.server,a=typeof i?.createMessage==`function`;return{get available(){return a},async createMessage(e){if(!a)throw Error(`Sampling not available: client does not support createMessage`);let o=e.context?`${e.context}\n\n---\n\n${e.prompt}`:e.prompt;try{let t=await i.createMessage({messages:[{role:`user`,content:{type:`text`,text:o}}],systemPrompt:e.systemPrompt,modelPreferences:n(e),maxTokens:e.maxTokens??4e3});return{text:r(t.content),model:t.model,stopReason:t.stopReason}}catch(e){throw t.warn(`Sampling createMessage failed`,{error:String(e)}),e}}}}const a={available:!1,async createMessage(){throw Error(`Sampling not available`)}};export{i as createSamplingClient,a as noopSamplingClient};

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

@@ -1,7 +1,10 @@
 import { CuratedKnowledgeManager } from "./curated-manager.js";
+import { ResourceNotifier } from "./resources/resource-notifier.js";
+import { ISamplingClient } from "./sampling.js";
 import { BridgeComponents } from "./tools/bridge.tools.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { KBConfig } from "@kb/core";
+import { Elicitor } from "@kb/elicitation";
 import { OnnxEmbedder } from "@kb/embeddings";
 import { EvolutionCollector, PolicyStore } from "@kb/enterprise-bridge";
 import { IncrementalIndexer } from "@kb/indexer";
@@ -24,7 +27,7 @@ interface KnowledgeBaseComponents {
 }
 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;
+declare function registerMcpTools(server: McpServer, kb: KnowledgeBaseComponents, config: KBConfig, elicitor?: Elicitor, resourceNotifier?: ResourceNotifier, samplingClient?: ISamplingClient): void;
 /**
  * Create a fully-initialized server (HTTP mode or when immediate readiness is needed).
  */
@@ -33,7 +36,7 @@ declare function createServer(config: KBConfig): Promise<{
   runInitialIndex: () => Promise<void>;
   shutdown: () => 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", "restore", "schema_validate", "scope_map", "search", "snippet", "stash", "status", "stratum_card", "symbol", "test_run", "time", "trace", "update", "watch", "web_fetch", "web_search", "workset"];
+declare const ALL_TOOL_NAMES: readonly ["analyze_dependencies", "analyze_diagram", "analyze_entry_points", "analyze_patterns", "analyze_structure", "analyze_symbols", "audit", "batch", "blast_radius", "brainstorm", "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", "present", "process", "produce_knowledge", "queue", "read", "regex_test", "reindex", "remember", "rename", "replay", "restore", "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; /** Call after MCP roots are resolved (or fallback decided) to start heavy init. */
   startInit: () => void;

package/packages/server/dist/server.js

@@ -1,3 +1,3 @@
-import{CuratedKnowledgeManager as e}from"./curated-manager.js";import{bridgeMcpLogging as t}from"./mcp-logging.js";import{registerPrompts as n}from"./prompts.js";import{installReplayInterceptor as r}from"./replay-interceptor.js";import{registerResources as i}from"./resources/resources.js";import{getToolMeta as a}from"./tool-metadata.js";import{registerAnalyzeDependenciesTool as o,registerAnalyzeDiagramTool as s,registerAnalyzeEntryPointsTool as c,registerAnalyzePatternsTool as l,registerAnalyzeStructureTool as u,registerAnalyzeSymbolsTool as d,registerBlastRadiusTool as f}from"./tools/analyze.tools.js";import{registerAuditTool as p}from"./tools/audit.tool.js";import{initBridgeComponents as m,registerErPullTool as h,registerErPushTool as g,registerErSyncStatusTool as ee}from"./tools/bridge.tools.js";import{registerCompactTool as te,registerDeadSymbolsTool as _,registerFileSummaryTool as v,registerFindTool as y,registerScopeMapTool as ne,registerSymbolTool as re,registerTraceTool as ie}from"./tools/context.tools.js";import{registerErEvolveReviewTool as ae}from"./tools/evolution.tools.js";import{registerBatchTool as oe,registerCheckTool as b,registerDelegateTool as x,registerEvalTool as S,registerParseOutputTool as C,registerTestRunTool as w}from"./tools/execution.tools.js";import{registerDigestTool as se,registerEvidenceMapTool as T,registerForgeClassifyTool as E,registerForgeGroundTool as ce,registerStratumCardTool as le}from"./tools/forge.tools.js";import{registerForgetTool as ue}from"./tools/forget.tool.js";import{registerGraphTool as de}from"./tools/graph.tool.js";import{registerGuideTool as D,registerHealthTool as O,registerProcessTool as k,registerWatchTool as A,registerWebFetchTool as j}from"./tools/infra.tools.js";import{registerListTool as fe}from"./tools/list.tool.js";import{registerLookupTool as pe}from"./tools/lookup.tool.js";import{registerCodemodTool as M,registerDataTransformTool as N,registerDiffParseTool as P,registerGitContextTool as F,registerRenameTool as I}from"./tools/manipulation.tools.js";import{registerOnboardTool as me}from"./tools/onboard.tool.js";import{registerCheckpointTool as L,registerLaneTool as R,registerQueueTool as he,registerStashTool as z,registerWorksetTool as B}from"./tools/persistence.tools.js";import{registerErUpdatePolicyTool as ge}from"./tools/policy.tools.js";import{registerProduceKnowledgeTool as V}from"./tools/produce.tool.js";import{registerReadTool as _e}from"./tools/read.tool.js";import{registerReindexTool as ve}from"./tools/reindex.tool.js";import{registerRememberTool as ye}from"./tools/remember.tool.js";import{registerReplayTool as H}from"./tools/replay.tool.js";import{registerRestoreTool as U}from"./tools/restore.tool.js";import{registerSearchTool as be}from"./tools/search.tool.js";import{registerStatusTool as xe}from"./tools/status.tool.js";import{registerUpdateTool as Se}from"./tools/update.tool.js";import{registerChangelogTool as W,registerEncodeTool as G,registerEnvTool as K,registerHttpTool as q,registerMeasureTool as Ce,registerRegexTestTool as we,registerSchemaValidateTool as Te,registerSnippetTool as Ee,registerTimeTool as De,registerWebSearchTool as Oe}from"./tools/utility.tools.js";import{getCurrentVersion as ke}from"./version-check.js";import{existsSync as Ae,statSync as je}from"node:fs";import{resolve as Me}from"node:path";import{KB_PATHS as Ne,createLogger as Pe,serializeError as J}from"../../core/dist/index.js";import{initializeWasm as Fe}from"../../chunker/dist/index.js";import{OnnxEmbedder as Ie}from"../../embeddings/dist/index.js";import{EvolutionCollector as Le,PolicyStore as Re}from"../../enterprise-bridge/dist/index.js";import{FileHashCache as ze,IncrementalIndexer as Be}from"../../indexer/dist/index.js";import{SqliteGraphStore as Ve,createStore as He}from"../../store/dist/index.js";import{FileCache as Ue}from"../../tools/dist/index.js";import{McpServer as We}from"@modelcontextprotocol/sdk/server/mcp.js";const Y=Pe(`server`);async function X(t){Y.info(`Initializing knowledge base components`);let[n,r,i,a]=await Promise.all([(async()=>{let e=new Ie({model:t.embedding.model,dimensions:t.embedding.dimensions});return await e.initialize(),Y.info(`Embedder loaded`,{modelId:e.modelId,dimensions:e.dimensions}),e})(),(async()=>{let e=await He({backend:t.store.backend,path:t.store.path});return await e.initialize(),Y.info(`Store initialized`),e})(),(async()=>{let e=new Ve({path:t.store.path});return await e.initialize(),Y.info(`Graph store initialized`),e})(),(async()=>{let e=await Fe();return e?Y.info(`WASM tree-sitter enabled for AST analysis`):Y.warn(`WASM tree-sitter not available; analyzers will use regex fallback`),e})()]),o=new Be(n,r),s=new ze(t.store.path);s.load(),o.setHashCache(s);let c=t.curated.path,l=new e(c,r,n);o.setGraphStore(i);let u=m(t.er),d=u?new Re(t.curated.path):void 0;d&&Y.info(`Policy store initialized`,{ruleCount:d.getRules().length});let f=u?new Le:void 0,p=Me(t.sources[0]?.path??process.cwd(),Ne.aiKb),h=Ae(p),g;if(h)try{g=je(p).mtime.toISOString()}catch{}return Y.info(`Onboard state detected`,{onboardComplete:h,onboardTimestamp:g}),{embedder:n,store:r,indexer:o,curated:l,graphStore:i,fileCache:new Ue,bridge:u,policyStore:d,evolutionCollector:f,onboardComplete:h,onboardTimestamp:g}}function Ge(e,r){let i=new We({name:r.serverName??`knowledge-base`,version:ke()},{capabilities:{logging:{}}});return t(i),Z(i,e,r),n(i),i}function Z(e,t,n){r(e),be(e,t.embedder,t.store,t.graphStore,t.bridge,t.evolutionCollector),pe(e,t.store),xe(e,t.store,t.graphStore,t.curated,{onboardComplete:t.onboardComplete,onboardTimestamp:t.onboardTimestamp}),ve(e,t.indexer,n,t.curated,t.store),ye(e,t.curated,t.policyStore,t.evolutionCollector),Se(e,t.curated),ue(e,t.curated),_e(e,t.curated),fe(e,t.curated),u(e,t.store,t.embedder),o(e,t.store,t.embedder),d(e,t.store,t.embedder),l(e,t.store,t.embedder),c(e,t.store,t.embedder),s(e,t.store,t.embedder),f(e,t.store,t.embedder,t.graphStore),V(e),me(e,t.store,t.embedder),de(e,t.graphStore),p(e,t.store,t.embedder),te(e,t.embedder,t.fileCache),ne(e,t.embedder,t.store),y(e,t.embedder,t.store),C(e),B(e),b(e),oe(e,t.embedder,t.store),re(e,t.embedder,t.store,t.graphStore),S(e),w(e),z(e),F(e),P(e),I(e),M(e),U(e),v(e,t.fileCache),L(e),N(e),ie(e,t.embedder,t.store),k(e),A(e),_(e,t.embedder,t.store),x(e),O(e),R(e),he(e),j(e),D(e),T(e),se(e,t.embedder),E(e),le(e,t.embedder,t.fileCache),ce(e,t.embedder,t.store),Oe(e),q(e),we(e),G(e),Ce(e),W(e),Te(e),Ee(e),K(e),De(e),t.bridge&&(g(e,t.bridge,t.evolutionCollector),h(e,t.bridge),ee(e,t.bridge)),t.policyStore&&ge(e,t.policyStore),t.evolutionCollector&&ae(e,t.evolutionCollector),i(e,t.store,t.curated),H(e)}async function Ke(e){let t=await X(e),n=Ge(t,e);Y.info(`MCP server configured`,{toolCount:$.length,resourceCount:2});let r=async()=>{try{let n=e.sources.map(e=>e.path).join(`, `);Y.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&&Y.debug(`Indexing file`,{current:e.filesProcessed+1,total:e.filesTotal,file:e.currentFile}),e.phase===`cleanup`&&Y.debug(`Index cleanup`,{staleEntries:e.filesTotal-e.filesProcessed}))});Y.info(`Initial index complete`,{filesProcessed:r.filesProcessed,filesSkipped:r.filesSkipped,chunksCreated:r.chunksCreated,durationMs:r.durationMs});try{await t.store.createFtsIndex()}catch(e){Y.warn(`FTS index creation failed`,J(e))}try{let e=await t.curated.reindexAll();Y.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){Y.error(`Curated re-index failed`,J(e))}}catch(e){Y.error(`Initial index failed; will retry on kb_reindex`,J(e))}},i=async()=>{Y.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{Y.info(`Parent process died; shutting down`,{parentPid:a}),clearInterval(o),i()}},5e3);return o.unref(),{server:n,runInitialIndex:r,shutdown:i}}const qe=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.produce_knowledge.queue.read.regex_test.reindex.remember.rename.replay.restore.schema_validate.scope_map.snippet.stash.status.stratum_card.test_run.time.update.forget.list.watch.web_fetch.web_search.workset`.split(`.`)),Je=5e3,Q=new Set(`changelog.check.checkpoint.codemod.data_transform.delegate.diff_parse.encode.env.eval.evidence_map.forge_classify.git_context.guide.health.http.lane.measure.parse_output.process.produce_knowledge.queue.regex_test.rename.replay.restore.schema_validate.snippet.stash.test_run.time.watch.web_fetch.web_search.workset`.split(`.`));function Ye(e){b(e),S(e),w(e),C(e),x(e),F(e),P(e),I(e),M(e),N(e),B(e),z(e),L(e),U(e),R(e),he(e),O(e),k(e),A(e),j(e),D(e),T(e),E(e),V(e),H(e),Oe(e),q(e),we(e),G(e),Ce(e),W(e),Te(e),Ee(e),K(e),De(e)}const $=`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.restore.schema_validate.scope_map.search.snippet.stash.status.stratum_card.symbol.test_run.time.trace.update.watch.web_fetch.web_search.workset`.split(`.`);function Xe(e){let r=new We({name:e.serverName??`knowledge-base`,version:ke()},{capabilities:{logging:{}}}),i=`initializing`,o=``,s=!1,c=()=>i===`failed`?[`❌ KB initialization failed — this tool is unavailable.`,``,o?`Error: ${o}`:``,``,`**35 tools are still available** and fully functional:`,`check, eval, test_run, git_context, health, measure, web_fetch, web_search,`,`regex_test, encode, stash, checkpoint, lane, process, time, env, and more.`,``,`Try restarting the MCP server to retry initialization.`].filter(Boolean).join(`
+import{CuratedKnowledgeManager as e}from"./curated-manager.js";import{createElicitor as t}from"./elicitor.js";import{bridgeMcpLogging as n}from"./mcp-logging.js";import{registerPrompts as r}from"./prompts.js";import{installReplayInterceptor as i}from"./replay-interceptor.js";import{ResourceNotifier as a}from"./resources/resource-notifier.js";import{registerResources as o}from"./resources/resources.js";import{createSamplingClient as s}from"./sampling.js";import{getToolMeta as c}from"./tool-metadata.js";import{installToolPrefix as l}from"./tool-prefix.js";import{registerAnalyzeDependenciesTool as u,registerAnalyzeDiagramTool as d,registerAnalyzeEntryPointsTool as f,registerAnalyzePatternsTool as p,registerAnalyzeStructureTool as m,registerAnalyzeSymbolsTool as h,registerBlastRadiusTool as ee}from"./tools/analyze.tools.js";import{registerAuditTool as g}from"./tools/audit.tool.js";import{registerBrainstormTool as _}from"./tools/brainstorm.tool.js";import{initBridgeComponents as v,registerErPullTool as te,registerErPushTool as y,registerErSyncStatusTool as b}from"./tools/bridge.tools.js";import{registerCompactTool as x,registerDeadSymbolsTool as S,registerFileSummaryTool as C,registerFindTool as ne,registerScopeMapTool as re,registerSymbolTool as ie,registerTraceTool as ae}from"./tools/context.tools.js";import{registerErEvolveReviewTool as oe}from"./tools/evolution.tools.js";import{registerBatchTool as se,registerCheckTool as w,registerDelegateTool as T,registerEvalTool as E,registerParseOutputTool as D,registerTestRunTool as O}from"./tools/execution.tools.js";import{registerDigestTool as ce,registerEvidenceMapTool as k,registerForgeClassifyTool as A,registerForgeGroundTool as le,registerStratumCardTool as ue}from"./tools/forge.tools.js";import{registerForgetTool as de}from"./tools/forget.tool.js";import{registerGraphTool as fe}from"./tools/graph.tool.js";import{registerGuideTool as j,registerHealthTool as M,registerProcessTool as N,registerWatchTool as P,registerWebFetchTool as F}from"./tools/infra.tools.js";import{registerListTool as pe}from"./tools/list.tool.js";import{registerLookupTool as me}from"./tools/lookup.tool.js";import{registerCodemodTool as I,registerDataTransformTool as L,registerDiffParseTool as R,registerGitContextTool as z,registerRenameTool as B}from"./tools/manipulation.tools.js";import{registerOnboardTool as he}from"./tools/onboard.tool.js";import{registerCheckpointTool as V,registerLaneTool as H,registerQueueTool as U,registerStashTool as W,registerWorksetTool as G}from"./tools/persistence.tools.js";import{registerErUpdatePolicyTool as ge}from"./tools/policy.tools.js";import{registerPresentTool as K}from"./tools/present.tool.js";import{registerProduceKnowledgeTool as q}from"./tools/produce.tool.js";import{registerReadTool as _e}from"./tools/read.tool.js";import{registerReindexTool as ve}from"./tools/reindex.tool.js";import{registerRememberTool as ye}from"./tools/remember.tool.js";import{registerReplayTool as be}from"./tools/replay.tool.js";import{registerRestoreTool as xe}from"./tools/restore.tool.js";import{registerSearchTool as Se}from"./tools/search.tool.js";import{registerStatusTool as Ce}from"./tools/status.tool.js";import{registerUpdateTool as we}from"./tools/update.tool.js";import{registerChangelogTool as Te,registerEncodeTool as Ee,registerEnvTool as De,registerHttpTool as Oe,registerMeasureTool as ke,registerRegexTestTool as Ae,registerSchemaValidateTool as je,registerSnippetTool as Me,registerTimeTool as Ne,registerWebSearchTool as Pe}from"./tools/utility.tools.js";import{getCurrentVersion as Fe}from"./version-check.js";import{existsSync as Ie,statSync as Le}from"node:fs";import{resolve as Re}from"node:path";import{KB_PATHS as ze,createLogger as Be,serializeError as J}from"../../core/dist/index.js";import{initializeWasm as Ve}from"../../chunker/dist/index.js";import{OnnxEmbedder as He}from"../../embeddings/dist/index.js";import{EvolutionCollector as Ue,PolicyStore as We}from"../../enterprise-bridge/dist/index.js";import{FileHashCache as Ge,IncrementalIndexer as Ke}from"../../indexer/dist/index.js";import{SqliteGraphStore as qe,createStore as Je}from"../../store/dist/index.js";import{FileCache as Ye}from"../../tools/dist/index.js";import{McpServer as Xe}from"@modelcontextprotocol/sdk/server/mcp.js";const Y=Be(`server`);async function X(t){Y.info(`Initializing knowledge base components`);let[n,r,i,a]=await Promise.all([(async()=>{let e=new He({model:t.embedding.model,dimensions:t.embedding.dimensions});return await e.initialize(),Y.info(`Embedder loaded`,{modelId:e.modelId,dimensions:e.dimensions}),e})(),(async()=>{let e=await Je({backend:t.store.backend,path:t.store.path});return await e.initialize(),Y.info(`Store initialized`),e})(),(async()=>{let e=new qe({path:t.store.path});return await e.initialize(),Y.info(`Graph store initialized`),e})(),(async()=>{let e=await Ve();return e?Y.info(`WASM tree-sitter enabled for AST analysis`):Y.warn(`WASM tree-sitter not available; analyzers will use regex fallback`),e})()]),o=new Ke(n,r),s=new Ge(t.store.path);s.load(),o.setHashCache(s);let c=t.curated.path,l=new e(c,r,n);o.setGraphStore(i);let u=v(t.er),d=u?new We(t.curated.path):void 0;d&&Y.info(`Policy store initialized`,{ruleCount:d.getRules().length});let f=u?new Ue:void 0,p=Re(t.sources[0]?.path??process.cwd(),ze.aiKb),m=Ie(p),h;if(m)try{h=Le(p).mtime.toISOString()}catch{}return Y.info(`Onboard state detected`,{onboardComplete:m,onboardTimestamp:h}),{embedder:n,store:r,indexer:o,curated:l,graphStore:i,fileCache:new Ye,bridge:u,policyStore:d,evolutionCollector:f,onboardComplete:m,onboardTimestamp:h}}function Ze(e,i){let o=new Xe({name:i.serverName??`knowledge-base`,version:Fe()},{capabilities:{logging:{}}});return n(o),l(o,i.toolPrefix??``),Z(o,e,i,t(o),new a(o),s(o)),r(o,{curated:e.curated,store:e.store,graphStore:e.graphStore}),o}function Z(e,t,n,r,a,s){i(e),Se(e,t.embedder,t.store,t.graphStore,t.bridge,t.evolutionCollector,s),me(e,t.store),Ce(e,t.store,t.graphStore,t.curated,{onboardComplete:t.onboardComplete,onboardTimestamp:t.onboardTimestamp}),ve(e,t.indexer,n,t.curated,t.store,a),ye(e,t.curated,t.policyStore,t.evolutionCollector,a),we(e,t.curated,a),de(e,t.curated,a),_e(e,t.curated),pe(e,t.curated),m(e,t.store,t.embedder),u(e,t.store,t.embedder),h(e,t.store,t.embedder),p(e,t.store,t.embedder),f(e,t.store,t.embedder),d(e,t.store,t.embedder),ee(e,t.store,t.embedder,t.graphStore),q(e),he(e,t.store,t.embedder),fe(e,t.graphStore),g(e,t.store,t.embedder),x(e,t.embedder,t.fileCache),re(e,t.embedder,t.store),ne(e,t.embedder,t.store),D(e),G(e),w(e),se(e,t.embedder,t.store),ie(e,t.embedder,t.store,t.graphStore),E(e),O(e),W(e),z(e),R(e),B(e),I(e),xe(e),C(e,t.fileCache),V(e),L(e),ae(e,t.embedder,t.store),N(e),P(e),S(e,t.embedder,t.store),T(e,s),M(e),H(e),U(e),F(e),j(e),k(e),ce(e,t.embedder),A(e),ue(e,t.embedder,t.fileCache),le(e,t.embedder,t.store),K(e,r),r&&_(e,r),Pe(e),Oe(e),Ae(e),Ee(e),ke(e),Te(e),je(e),Me(e),De(e),Ne(e),t.bridge&&(y(e,t.bridge,t.evolutionCollector),te(e,t.bridge),b(e,t.bridge)),t.policyStore&&ge(e,t.policyStore),t.evolutionCollector&&oe(e,t.evolutionCollector),o(e,t.store,t.curated),be(e)}async function Qe(e){let t=await X(e),n=Ze(t,e);Y.info(`MCP server configured`,{toolCount:$.length,resourceCount:2});let r=async()=>{try{let n=e.sources.map(e=>e.path).join(`, `);Y.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&&Y.debug(`Indexing file`,{current:e.filesProcessed+1,total:e.filesTotal,file:e.currentFile}),e.phase===`cleanup`&&Y.debug(`Index cleanup`,{staleEntries:e.filesTotal-e.filesProcessed}))});Y.info(`Initial index complete`,{filesProcessed:r.filesProcessed,filesSkipped:r.filesSkipped,chunksCreated:r.chunksCreated,durationMs:r.durationMs});try{await t.store.createFtsIndex()}catch(e){Y.warn(`FTS index creation failed`,J(e))}try{let e=await t.curated.reindexAll();Y.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){Y.error(`Curated re-index failed`,J(e))}}catch(e){Y.error(`Initial index failed; will retry on kb_reindex`,J(e))}},i=async()=>{Y.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{Y.info(`Parent process died; shutting down`,{parentPid:a}),clearInterval(o),i()}},5e3);return o.unref(),{server:n,runInitialIndex:r,shutdown:i}}const $e=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.present.process.produce_knowledge.queue.read.regex_test.reindex.remember.rename.replay.restore.schema_validate.scope_map.snippet.stash.status.stratum_card.test_run.time.update.forget.list.watch.web_fetch.web_search.workset`.split(`.`)),et=5e3,Q=new Set(`changelog.check.checkpoint.codemod.data_transform.delegate.diff_parse.encode.env.eval.evidence_map.forge_classify.git_context.guide.present.health.http.lane.measure.parse_output.process.produce_knowledge.queue.regex_test.rename.replay.restore.schema_validate.snippet.stash.test_run.time.watch.web_fetch.web_search.workset`.split(`.`));function tt(e){w(e),E(e),O(e),D(e),T(e),z(e),R(e),B(e),I(e),L(e),G(e),W(e),V(e),xe(e),H(e),U(e),M(e),N(e),P(e),F(e),j(e),k(e),A(e),K(e),q(e),be(e),Pe(e),Oe(e),Ae(e),Ee(e),ke(e),Te(e),je(e),Me(e),De(e),Ne(e)}const $=`analyze_dependencies.analyze_diagram.analyze_entry_points.analyze_patterns.analyze_structure.analyze_symbols.audit.batch.blast_radius.brainstorm.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.present.process.produce_knowledge.queue.read.regex_test.reindex.remember.rename.replay.restore.schema_validate.scope_map.search.snippet.stash.status.stratum_card.symbol.test_run.time.trace.update.watch.web_fetch.web_search.workset`.split(`.`);function nt(e){let i=new Xe({name:e.serverName??`knowledge-base`,version:Fe()},{capabilities:{logging:{}}}),o=`initializing`,u=``,d=!1,f=()=>o===`failed`?[`❌ KB initialization failed — this tool is unavailable.`,``,u?`Error: ${u}`:``,``,`**35 tools are still available** and fully functional:`,`check, eval, test_run, git_context, health, measure, web_fetch, web_search,`,`regex_test, encode, stash, checkpoint, lane, process, time, env, and more.`,``,`Try restarting the MCP server to retry initialization.`].filter(Boolean).join(`
 `):[`KB is still initializing (loading embeddings model & store).`,``,`**35 tools are already available** while initialization completes — including:`,`check, eval, test_run, git_context, health, measure, web_fetch, web_search,`,`regex_test, encode, stash, checkpoint, lane, process, time, env, and more.`,``,`This tool requires the knowledge base index. Please retry in a few seconds,`,`or use one of the available tools above in the meantime.`].join(`
-`);t(r);let l=r.sendToolListChanged.bind(r);r.sendToolListChanged=()=>{};let u=[];for(let e of $){let t=a(e),n=r.registerTool(e,{title:t.title,description:`${t.title} — initializing, available shortly`,inputSchema:{},annotations:t.annotations},async()=>({content:[{type:`text`,text:c()}]}));Q.has(e)?n.remove():u.push(n)}Ye(r),r.sendToolListChanged=l;let d=r.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`}]})),f=r.prompt(`_init`,`KB is initializing prompts...`,async()=>({messages:[{role:`user`,content:{type:`text`,text:c()}}]})),p,m=new Promise(e=>{p=e}),h,g=new Promise(e=>{h=e}),ee=()=>h?.(),te=(async()=>{await g;let t;try{t=await X(e)}catch(e){i=`failed`,o=e instanceof Error?e.message:String(e),Y.error(`KB initialization failed — server continuing with zero-dep tools only`,{error:o});return}let a=r.sendToolListChanged.bind(r);r.sendToolListChanged=()=>{};let c=r.sendPromptListChanged.bind(r);r.sendPromptListChanged=()=>{};for(let e of u)e.remove();d.remove(),f.remove();let l=r._registeredTools??{};for(let e of Q)l[e]?.remove();Z(r,t,e),n(r),r.sendToolListChanged=a,r.sendPromptListChanged=c,r.sendToolListChanged(),r.sendPromptListChanged();let m=r._registeredTools??{};for(let[e,n]of Object.entries(m)){if(qe.has(e))continue;let r=n.handler;n.handler=async(...n)=>{if(!t.indexer.isIndexing)return r(...n);let i=s?`re-indexing`:`running initial index`,a=new Promise(t=>setTimeout(()=>t({content:[{type:`text`,text:`⏳ KB is ${i}. The tool "${e}" timed out waiting for index data (${Je/1e3}s).\n\nThe existing index may be temporarily locked. Please retry shortly — indexing will complete automatically.`}]}),Je));return Promise.race([r(...n),a])}}let h=Object.keys(m).length;h!==$.length&&Y.warn(`ALL_TOOL_NAMES count mismatch`,{expectedToolCount:$.length,registeredToolCount:h}),Y.info(`MCP server configured`,{toolCount:$.length,resourceCount:4}),p?.(t)})(),_=async()=>{let t=await m;try{let n=e.sources.map(e=>e.path).join(`, `);Y.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&&Y.debug(`Indexing file`,{current:e.filesProcessed+1,total:e.filesTotal,file:e.currentFile}),e.phase===`cleanup`&&Y.debug(`Index cleanup`,{staleEntries:e.filesTotal-e.filesProcessed}))});s=!0,Y.info(`Initial index complete`,{filesProcessed:r.filesProcessed,filesSkipped:r.filesSkipped,chunksCreated:r.chunksCreated,durationMs:r.durationMs});try{await t.store.createFtsIndex()}catch(e){Y.warn(`FTS index creation failed`,J(e))}try{let e=await t.curated.reindexAll();Y.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){Y.error(`Curated re-index failed`,J(e))}}catch(e){Y.error(`Initial index failed; will retry on kb_reindex`,J(e))}},v=process.ppid,y=setInterval(()=>{try{process.kill(v,0)}catch{Y.info(`Parent process died; shutting down`,{parentPid:v}),clearInterval(y),m.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 y.unref(),{server:r,startInit:ee,ready:te,runInitialIndex:_}}export{$ as ALL_TOOL_NAMES,Xe as createLazyServer,Ge as createMcpServer,Ke as createServer,X as initializeKnowledgeBase,Z as registerMcpTools};
+`);n(i),l(i,e.toolPrefix??``);let p=i.sendToolListChanged.bind(i);i.sendToolListChanged=()=>{};let m=[];for(let e of $){let t=c(e),n=i.registerTool(e,{title:t.title,description:`${t.title} — initializing, available shortly`,inputSchema:{},annotations:t.annotations},async()=>({content:[{type:`text`,text:f()}]}));Q.has(e)?n.remove():m.push(n)}tt(i),i.sendToolListChanged=p;let h=i.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`}]})),ee=i.prompt(`_init`,`KB is initializing prompts...`,async()=>({messages:[{role:`user`,content:{type:`text`,text:f()}}]})),g,_=new Promise(e=>{g=e}),v,te=new Promise(e=>{v=e}),y=()=>v?.(),b=(async()=>{await te;let n;try{n=await X(e)}catch(e){o=`failed`,u=e instanceof Error?e.message:String(e),Y.error(`KB initialization failed — server continuing with zero-dep tools only`,{error:u});return}let c=i.sendToolListChanged.bind(i);i.sendToolListChanged=()=>{};let l=i.sendPromptListChanged.bind(i);i.sendPromptListChanged=()=>{};let f=i.sendResourceListChanged.bind(i);i.sendResourceListChanged=()=>{};for(let e of m)e.remove();h.remove(),ee.remove();let p=i._registeredTools??{};for(let e of Q)p[e]?.remove();let _=new a(i),v=s(i);Z(i,n,e,t(i),_,v),r(i),i.sendToolListChanged=c,i.sendPromptListChanged=l,i.sendResourceListChanged=f,Promise.resolve(i.sendToolListChanged()).catch(()=>{}),Promise.resolve(i.sendPromptListChanged()).catch(()=>{}),Promise.resolve(i.sendResourceListChanged()).catch(()=>{});let y=i._registeredTools??{};for(let[e,t]of Object.entries(y)){if($e.has(e))continue;let r=t.handler;t.handler=async(...t)=>{if(!n.indexer.isIndexing)return r(...t);let i=d?`re-indexing`:`running initial index`,a=new Promise(t=>setTimeout(()=>t({content:[{type:`text`,text:`⏳ KB is ${i}. The tool "${e}" timed out waiting for index data (${et/1e3}s).\n\nThe existing index may be temporarily locked. Please retry shortly — indexing will complete automatically.`}]}),et));return Promise.race([r(...t),a])}}let b=Object.keys(y).length;b!==$.length&&Y.warn(`ALL_TOOL_NAMES count mismatch`,{expectedToolCount:$.length,registeredToolCount:b}),Y.info(`MCP server configured`,{toolCount:$.length,resourceCount:4}),g?.(n)})(),x=async()=>{let t=await _;try{let n=e.sources.map(e=>e.path).join(`, `);Y.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&&Y.debug(`Indexing file`,{current:e.filesProcessed+1,total:e.filesTotal,file:e.currentFile}),e.phase===`cleanup`&&Y.debug(`Index cleanup`,{staleEntries:e.filesTotal-e.filesProcessed}))});d=!0,Y.info(`Initial index complete`,{filesProcessed:r.filesProcessed,filesSkipped:r.filesSkipped,chunksCreated:r.chunksCreated,durationMs:r.durationMs});try{await t.store.createFtsIndex()}catch(e){Y.warn(`FTS index creation failed`,J(e))}try{let e=await t.curated.reindexAll();Y.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){Y.error(`Curated re-index failed`,J(e))}}catch(e){Y.error(`Initial index failed; will retry on kb_reindex`,J(e))}},S=process.ppid,C=setInterval(()=>{try{process.kill(S,0)}catch{Y.info(`Parent process died; shutting down`,{parentPid:S}),clearInterval(C),_.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 C.unref(),{server:i,startInit:y,ready:b,runInitialIndex:x}}export{$ as ALL_TOOL_NAMES,nt as createLazyServer,Ze as createMcpServer,Qe as createServer,X as initializeKnowledgeBase,Z as registerMcpTools};

package/packages/server/dist/task-manager.d.ts

@@ -0,0 +1,40 @@
+//#region packages/server/src/task-manager.d.ts
+/**
+ * Lightweight progress reporting for long-running tool operations.
+ *
+ * Wraps MCP progress notifications (`notifications/progress`) with a simple
+ * TaskHandle API. Degrades gracefully when the client doesn't support progress.
+ *
+ * @see E-027 — Tasks + Progress enhancement
+ */
+/**
+ * Minimal type for the tool handler `extra` parameter we need.
+ * Avoids importing full SDK types for testing flexibility.
+ */
+interface ToolHandlerExtra {
+  sendNotification?: (notification: {
+    method: string;
+    params?: Record<string, unknown>;
+  }) => Promise<void>;
+}
+interface TaskHandle {
+  /** Report progress. `current` is 0-based step number. */
+  progress(current: number, message?: string): void;
+  /** Mark the task as complete. */
+  complete(message?: string): void;
+  /** Mark the task as failed. */
+  fail(error?: string): void;
+}
+interface ITaskRunner {
+  /** Create a task with a descriptive title and expected total steps. */
+  createTask(title: string, totalSteps: number): TaskHandle;
+}
+/**
+ * Create a task runner that sends MCP progress notifications.
+ * If `extra` is undefined or lacks sendNotification, returns a no-op runner.
+ */
+declare function createTaskRunner(extra?: ToolHandlerExtra): ITaskRunner;
+/** No-op task runner — all methods silently succeed. */
+declare const noopTaskRunner: ITaskRunner;
+//#endregion
+export { ITaskRunner, TaskHandle, ToolHandlerExtra, createTaskRunner, noopTaskRunner };

package/packages/server/dist/task-manager.js

@@ -0,0 +1 @@
+import{createLogger as e}from"../../core/dist/index.js";const t=e(`task-manager`);let n=0;function r(e){let r=typeof e?.sendNotification==`function`;return{createTask(i,a){let o=`kb-task-${++n}`,s=(n,i,a)=>{r&&e.sendNotification?.({method:`notifications/progress`,params:{progressToken:o,progress:n,total:i,...a?{message:a}:{}}}).catch(e=>{t.debug(`Progress notification failed`,{token:o,error:String(e)})})};return r&&t.debug(`Task created`,{token:o,title:i,totalSteps:a}),{progress(e,t){s(e,a,t??`${i}: step ${e+1}/${a}`)},complete(e){s(a,a,e??`${i}: complete`)},fail(e){s(a,a,e??`${i}: failed`)}}}}}const i={createTask(){return{progress(){},complete(){},fail(){}}}};export{r as createTaskRunner,i as noopTaskRunner};