@vpxa/kb 0.1.15 → 0.1.17

package/packages/chunker/src/queries/typescript/imports.scm

@@ -0,0 +1,35 @@
+; TypeScript import extraction queries
+; Captures: @node (full import statement), @source (module path string)
+
+; === ES module imports ===
+
+; import { foo } from './module'
+; import type { IFoo } from './types'
+; import Def from 'pkg'
+; import * as ns from 'pkg'
+(import_statement
+  source: (string
+    (string_fragment) @source)) @node
+
+; === CommonJS require ===
+
+; const x = require('./mod')
+; const { a, b } = require('./mod')
+(lexical_declaration
+  (variable_declarator
+    value: (call_expression
+      function: (identifier) @_fn
+      arguments: (arguments
+        (string
+          (string_fragment) @source))))
+  (#eq? @_fn "require")) @node
+
+; === Dynamic import ===
+
+; const x = await import('./dynamic')
+; import('./dynamic').then(...)
+(call_expression
+  function: (import)
+  arguments: (arguments
+    (string
+      (string_fragment) @source))) @node

package/packages/chunker/src/queries/typescript/patterns.scm

@@ -0,0 +1,47 @@
+; TypeScript pattern detection queries
+; Captures: @node (pattern site), @name (identifier or function name)
+
+; === Singleton: private constructor or cached instances ===
+
+; class Foo { private constructor() {} }
+(class_declaration
+  name: (type_identifier) @name
+  body: (class_body
+    (method_definition
+      (accessibility_modifier) @_access
+      name: (property_identifier) @_ctor)
+    (#eq? @_access "private")
+    (#eq? @_ctor "constructor"))) @node
+
+; === Factory: export function create*() ===
+
+(export_statement
+  (function_declaration
+    name: (identifier) @name
+    (#match? @name "^create[A-Z]"))) @node
+
+; === Dependency Injection markers ===
+
+; container.register(...) / container.bind(...)
+(call_expression
+  function: (member_expression
+    object: (identifier) @_obj
+    property: (property_identifier) @_method)
+  (#eq? @_obj "container")
+  (#match? @_method "^(register|bind)$")) @node
+
+; === Decorator patterns ===
+; @Injectable() / @Component() etc.
+(decorator
+  (call_expression
+    function: (identifier) @name
+    (#match? @name "^(Injectable|Component|Service|Controller|Module)$"))) @node
+
+; === Cached instance: new Map() / new WeakMap() ===
+
+(lexical_declaration
+  (variable_declarator
+    name: (identifier) @name
+    value: (new_expression
+      constructor: (identifier) @_cls
+      (#match? @_cls "^(Map|WeakMap|Set)$")))) @node

package/packages/chunker/src/queries/typescript/symbols.scm

@@ -0,0 +1,79 @@
+; TypeScript symbol extraction queries
+; Captures: @node (full declaration), @name (identifier), @kind (implicit from pattern)
+
+; === Exported declarations ===
+
+; export function foo() {}
+; export async function foo() {}
+(export_statement
+  (function_declaration
+    name: (identifier) @name) @node) @exported
+
+; export class Foo {}
+(export_statement
+  (class_declaration
+    name: (type_identifier) @name) @node) @exported
+
+; export interface IFoo {}
+(export_statement
+  (interface_declaration
+    name: (type_identifier) @name) @node) @exported
+
+; export type MyType = ...
+(export_statement
+  (type_alias_declaration
+    name: (type_identifier) @name) @node) @exported
+
+; export enum Color {}
+(export_statement
+  (enum_declaration
+    name: (identifier) @name) @node) @exported
+
+; export const FOO = ...
+(export_statement
+  (lexical_declaration
+    (variable_declarator
+      name: (identifier) @name)) @node) @exported
+
+; export default class Foo {}
+(export_statement
+  "default"
+  (class_declaration
+    name: (type_identifier) @name) @node) @exported
+
+; === Non-exported declarations ===
+
+; function foo() {}
+(function_declaration
+  name: (identifier) @name) @node
+
+; class Foo {}
+(class_declaration
+  name: (type_identifier) @name) @node
+
+; interface IFoo {}
+(interface_declaration
+  name: (type_identifier) @name) @node
+
+; type MyType = ...
+(type_alias_declaration
+  name: (type_identifier) @name) @node
+
+; enum Color {}
+(enum_declaration
+  name: (identifier) @name) @node
+
+; const foo = ...
+(lexical_declaration
+  (variable_declarator
+    name: (identifier) @name)) @node
+
+; === Class members ===
+
+; class methods: foo() {} / async foo() {} / static foo() {}
+(method_definition
+  name: (property_identifier) @name) @node
+
+; class properties: foo = value / readonly foo: Type
+(public_field_definition
+  name: (property_identifier) @name) @node

package/packages/cli/dist/commands/analyze.d.ts

@@ -3,5 +3,4 @@ import { Command } from "../types.js";
 //#region packages/cli/src/commands/analyze.d.ts
 declare const analyzeCommands: Command[];
 //#endregion
-export { analyzeCommands };
-//# sourceMappingURL=analyze.d.ts.map
+export { analyzeCommands };

package/packages/cli/dist/commands/analyze.js

@@ -1,3 +1,2 @@
 import{resolve as e}from"node:path";const t=[{name:`analyze`,description:`Run analyzer output for a path`,usage:`kb analyze <type> <path>`,run:async t=>{let n=t.shift()?.trim()??``,r=t.shift()?.trim()??``;(!n||!r)&&(console.error(`Usage: kb analyze <type> <path>`),console.error(`Types: structure, deps, symbols, patterns, entry-points, blast-radius, diagram`),process.exit(1));let{BlastRadiusAnalyzer:i,DependencyAnalyzer:a,DiagramGenerator:o,EntryPointAnalyzer:s,PatternAnalyzer:c,StructureAnalyzer:l,SymbolAnalyzer:u}=await import(`../../../analyzers/dist/index.js`),d=e(r),f;switch(n){case`structure`:f=await new l().analyze(d,{format:`markdown`});break;case`deps`:case`dependencies`:f=await new a().analyze(d,{format:`markdown`});break;case`symbols`:f=await new u().analyze(d,{format:`markdown`});break;case`patterns`:f=await new c().analyze(d,{format:`markdown`});break;case`entry-points`:f=await new s().analyze(d,{format:`markdown`});break;case`blast-radius`:f=await new i().analyze(process.cwd(),{files:[r],format:`markdown`});break;case`diagram`:f=await new o().analyze(d,{diagramType:`architecture`});break;default:console.error(`Unknown analyze type: ${n}`),console.error(`Types: structure, deps, symbols, patterns, entry-points, blast-radius, diagram`),process.exit(1)}console.log(f.output)}},{name:`onboard`,description:`Run all analyses for first-time codebase onboarding`,usage:`kb onboard <path> [--generate] [--out-dir <dir>]`,run:async t=>{let{onboard:n}=await import(`../../../tools/dist/index.js`),r=``,i=`memory`,a;for(let e=0;e<t.length;e++){let n=t[e].trim();n===`--generate`?i=`generate`:n===`--out-dir`&&e+1<t.length?a=t[++e].trim():n.startsWith(`--`)||(r=n)}r||=process.cwd();let o=e(r);console.log(`Onboarding: ${o} (mode: ${i})`),console.log(`Running analyses...
-`);let s=await n({path:o,mode:i,outDir:a});for(let e of s.steps){let t=e.status===`success`?`✓`:`✗`,n=e.status===`success`?`${e.durationMs}ms, ${e.output.length} chars`:e.error;console.log(`  ${t} ${e.name} — ${n}`)}console.log(`\nTotal: ${s.totalDurationMs}ms`),s.outDir&&console.log(`Output written to: ${s.outDir}`)}}];export{t as analyzeCommands};
-//# sourceMappingURL=analyze.js.map
+`);let s=await n({path:o,mode:i,outDir:a});for(let e of s.steps){let t=e.status===`success`?`✓`:`✗`,n=e.status===`success`?`${e.durationMs}ms, ${e.output.length} chars`:e.error;console.log(`  ${t} ${e.name} — ${n}`)}console.log(`\nTotal: ${s.totalDurationMs}ms`),s.outDir&&console.log(`Output written to: ${s.outDir}`)}}];export{t as analyzeCommands};

package/packages/cli/dist/commands/context-cmds.d.ts

@@ -3,5 +3,4 @@ import { Command } from "../types.js";
 //#region packages/cli/src/commands/context-cmds.d.ts
 declare const contextCommands: Command[];
 //#endregion
-export { contextCommands };
-//# sourceMappingURL=context-cmds.d.ts.map
+export { contextCommands };

package/packages/cli/dist/commands/context-cmds.js

@@ -1,2 +1 @@
-import{extractBoolFlag as e,extractNumFlag as t,extractStrFlag as n,parseRecordString as r,printCheckpoint as i,printDiffFiles as a,printFileSummary as o,printGitContext as s,printParsedOutput as c,readStdin as l}from"../helpers.js";import{resolve as u}from"node:path";import{checkpointLatest as d,checkpointList as f,checkpointLoad as p,checkpointSave as m,diffParse as h,fileSummary as g,gitContext as _,parseOutput as v}from"../../../tools/dist/index.js";const y=[{name:`parse-output`,description:`Parse build or tool output from stdin`,usage:`kb parse-output [--tool tsc|vitest|biome|git-status]`,run:async e=>{let t=n(e,`--tool`,``).trim()||void 0,r=await l();r.trim()||(console.error(`Usage: kb parse-output [--tool tsc|vitest|biome|git-status]`),process.exit(1)),c(v(r,t))}},{name:`git`,description:`Show git branch, status, recent commits, and optional diff stats`,usage:`kb git [--cwd path] [--commit-count N] [--diff]`,run:async r=>{s(await _({cwd:n(r,`--cwd`,``).trim()||void 0,commitCount:t(r,`--commit-count`,5),includeDiff:e(r,`--diff`)}))}},{name:`diff`,description:`Parse unified diff text from stdin into structured file changes`,usage:`git diff | kb diff`,run:async()=>{let e=await l();e.trim()||(console.error(`Usage: git diff | kb diff`),process.exit(1)),a(h({diff:e}))}},{name:`summarize`,description:`Show a structural summary of a file`,usage:`kb summarize <path>`,run:async e=>{let t=e.shift()?.trim();t||(console.error(`Usage: kb summarize <path>`),process.exit(1)),o(await g({path:u(t)}))}},{name:`checkpoint`,description:`Save and restore lightweight session checkpoints`,usage:`kb checkpoint <save|load|list|latest> [label-or-id] [--data json] [--notes text]`,run:async e=>{let t=e.shift()?.trim();switch(t||(console.error(`Usage: kb checkpoint <save|load|list|latest> [label-or-id] [--data json] [--notes text]`),process.exit(1)),t){case`save`:{let t=e.shift()?.trim(),a=n(e,`--data`,``),o=n(e,`--notes`,``).trim()||void 0,s=a.trim()?``:await l();t||(console.error(`Usage: kb checkpoint save <label> [--data json] [--notes text]`),process.exit(1)),i(m(t,r(a||s),{notes:o}));return}case`load`:{let t=e.shift()?.trim();t||(console.error(`Usage: kb checkpoint load <id>`),process.exit(1));let n=p(t);if(!n){console.log(`No checkpoint found: ${t}`);return}i(n);return}case`list`:{let e=f();if(e.length===0){console.log(`No checkpoints saved.`);return}console.log(`Checkpoints (${e.length})`),console.log(`─`.repeat(60));for(let t of e)console.log(`${t.id}`),console.log(`  Label: ${t.label}`),console.log(`  Created: ${t.createdAt}`);return}case`latest`:{let e=d();if(!e){console.log(`No checkpoints saved.`);return}i(e);return}default:console.error(`Unknown checkpoint action: ${t}`),console.error(`Actions: save, load, list, latest`),process.exit(1)}}}];export{y as contextCommands};
-//# sourceMappingURL=context-cmds.js.map
+import{extractBoolFlag as e,extractNumFlag as t,extractStrFlag as n,parseRecordString as r,printCheckpoint as i,printDiffFiles as a,printFileSummary as o,printGitContext as s,printParsedOutput as c,readStdin as l}from"../helpers.js";import{resolve as u}from"node:path";import{checkpointLatest as d,checkpointList as f,checkpointLoad as p,checkpointSave as m,diffParse as h,fileSummary as g,gitContext as _,parseOutput as v}from"../../../tools/dist/index.js";const y=[{name:`parse-output`,description:`Parse build or tool output from stdin`,usage:`kb parse-output [--tool tsc|vitest|biome|git-status]`,run:async e=>{let t=n(e,`--tool`,``).trim()||void 0,r=await l();r.trim()||(console.error(`Usage: kb parse-output [--tool tsc|vitest|biome|git-status]`),process.exit(1)),c(v(r,t))}},{name:`git`,description:`Show git branch, status, recent commits, and optional diff stats`,usage:`kb git [--cwd path] [--commit-count N] [--diff]`,run:async r=>{s(await _({cwd:n(r,`--cwd`,``).trim()||void 0,commitCount:t(r,`--commit-count`,5),includeDiff:e(r,`--diff`)}))}},{name:`diff`,description:`Parse unified diff text from stdin into structured file changes`,usage:`git diff | kb diff`,run:async()=>{let e=await l();e.trim()||(console.error(`Usage: git diff | kb diff`),process.exit(1)),a(h({diff:e}))}},{name:`summarize`,description:`Show a structural summary of a file`,usage:`kb summarize <path>`,run:async e=>{let t=e.shift()?.trim();t||(console.error(`Usage: kb summarize <path>`),process.exit(1)),o(await g({path:u(t)}))}},{name:`checkpoint`,description:`Save and restore lightweight session checkpoints`,usage:`kb checkpoint <save|load|list|latest> [label-or-id] [--data json] [--notes text]`,run:async e=>{let t=e.shift()?.trim();switch(t||(console.error(`Usage: kb checkpoint <save|load|list|latest> [label-or-id] [--data json] [--notes text]`),process.exit(1)),t){case`save`:{let t=e.shift()?.trim(),a=n(e,`--data`,``),o=n(e,`--notes`,``).trim()||void 0,s=a.trim()?``:await l();t||(console.error(`Usage: kb checkpoint save <label> [--data json] [--notes text]`),process.exit(1)),i(m(t,r(a||s),{notes:o}));return}case`load`:{let t=e.shift()?.trim();t||(console.error(`Usage: kb checkpoint load <id>`),process.exit(1));let n=p(t);if(!n){console.log(`No checkpoint found: ${t}`);return}i(n);return}case`list`:{let e=f();if(e.length===0){console.log(`No checkpoints saved.`);return}console.log(`Checkpoints (${e.length})`),console.log(`─`.repeat(60));for(let t of e)console.log(`${t.id}`),console.log(`  Label: ${t.label}`),console.log(`  Created: ${t.createdAt}`);return}case`latest`:{let e=d();if(!e){console.log(`No checkpoints saved.`);return}i(e);return}default:console.error(`Unknown checkpoint action: ${t}`),console.error(`Actions: save, load, list, latest`),process.exit(1)}}}];export{y as contextCommands};

package/packages/cli/dist/commands/environment.d.ts

@@ -3,5 +3,4 @@ import { Command } from "../types.js";
 //#region packages/cli/src/commands/environment.d.ts
 declare const environmentCommands: Command[];
 //#endregion
-export { environmentCommands };
-//# sourceMappingURL=environment.d.ts.map
+export { environmentCommands };

package/packages/cli/dist/commands/environment.js

@@ -1,2 +1 @@
-import{extractNumFlag as e,extractStrFlag as t,printManagedProcess as n,readStdin as r}from"../helpers.js";import{resolve as i}from"node:path";import{readFile as a}from"node:fs/promises";import{delegate as o,delegateListModels as s,processList as c,processLogs as l,processStart as u,processStatus as d,processStop as f,watchList as p,watchStart as m,watchStop as h}from"../../../tools/dist/index.js";const g=[{name:`proc`,description:`Manage in-memory child processes`,usage:`kb proc <start|stop|status|list|logs> ...`,run:async t=>{let r=t.shift()?.trim()??``;switch(r){case`start`:{let e=t.shift()?.trim(),r=t.shift()?.trim();(!e||!r)&&(console.error(`Usage: kb proc start <id> <command> [args...]`),process.exit(1)),n(u(e,r,t));return}case`stop`:{let e=t.shift()?.trim();e||(console.error(`Usage: kb proc stop <id>`),process.exit(1));let r=f(e);if(!r){console.log(`No managed process found: ${e}`);return}n(r);return}case`status`:{let e=t.shift()?.trim();e||(console.error(`Usage: kb proc status <id>`),process.exit(1));let r=d(e);if(!r){console.log(`No managed process found: ${e}`);return}n(r);return}case`list`:{let e=c();if(e.length===0){console.log(`No managed processes.`);return}for(let t of e)n(t),console.log(``);return}case`logs`:{let n=e(t,`--tail`,50),r=t.shift()?.trim();r||(console.error(`Usage: kb proc logs <id> [--tail N]`),process.exit(1));let i=l(r,n);if(i.length===0){console.log(`No logs found for process: ${r}`);return}for(let e of i)console.log(e);return}default:console.error(`Unknown proc action: ${r}`),console.error(`Actions: start, stop, status, list, logs`),process.exit(1)}}},{name:`watch`,description:`Manage in-memory filesystem watchers`,usage:`kb watch <start|stop|list> ...`,run:async e=>{let t=e.shift()?.trim()??``;switch(t){case`start`:{let t=e.shift()?.trim();t||(console.error(`Usage: kb watch start <path>`),process.exit(1));let n=m({path:i(t)});console.log(`Started watcher: ${n.id}`),console.log(`  Path: ${n.path}`),console.log(`  Status: ${n.status}`);return}case`stop`:{let t=e.shift()?.trim();t||(console.error(`Usage: kb watch stop <id>`),process.exit(1));let n=h(t);console.log(n?`Stopped watcher: ${t}`:`Watcher not found: ${t}`);return}case`list`:{let e=p();if(e.length===0){console.log(`No active watchers.`);return}for(let t of e)console.log(`${t.id}`),console.log(`  Path: ${t.path}`),console.log(`  Status: ${t.status}`),console.log(`  Events: ${t.eventCount}`);return}default:console.error(`Unknown watch action: ${t}`),console.error(`Actions: start, stop, list`),process.exit(1)}}},{name:`delegate`,description:`Delegate a task to a local Ollama model`,usage:`kb delegate [--model name] [--system prompt] [--temp 0.3] <prompt | --stdin>`,run:async n=>{if((n[0]===`models`?n.shift():void 0)===`models`){try{let e=await s();if(e.length===0){console.log(`No Ollama models available. Pull one with: ollama pull qwen2.5-coder:7b`);return}for(let t of e)console.log(t)}catch{console.error(`Ollama is not running. Start it with: ollama serve`),process.exit(1)}return}let c=t(n,`--model`,``),l=t(n,`--system`,``),u=e(n,`--temp`,.3),d=t(n,`--context`,``),f=n.join(` `);f||=await r(),f||(console.error(`Usage: kb delegate [--model name] <prompt>`),process.exit(1));let p;d&&(p=await a(i(d),`utf-8`));let m=await o({prompt:f,model:c||void 0,system:l||void 0,context:p,temperature:u});m.error&&(console.error(`Error: ${m.error}`),process.exit(1)),console.log(m.response),console.error(`\n(${m.model}, ${m.durationMs}ms, ${m.tokenCount??`?`} tokens)`)}}];export{g as environmentCommands};
-//# sourceMappingURL=environment.js.map
+import{extractNumFlag as e,extractStrFlag as t,printManagedProcess as n,readStdin as r}from"../helpers.js";import{resolve as i}from"node:path";import{readFile as a}from"node:fs/promises";import{delegate as o,delegateListModels as s,processList as c,processLogs as l,processStart as u,processStatus as d,processStop as f,watchList as p,watchStart as m,watchStop as h}from"../../../tools/dist/index.js";const g=[{name:`proc`,description:`Manage in-memory child processes`,usage:`kb proc <start|stop|status|list|logs> ...`,run:async t=>{let r=t.shift()?.trim()??``;switch(r){case`start`:{let e=t.shift()?.trim(),r=t.shift()?.trim();(!e||!r)&&(console.error(`Usage: kb proc start <id> <command> [args...]`),process.exit(1)),n(u(e,r,t));return}case`stop`:{let e=t.shift()?.trim();e||(console.error(`Usage: kb proc stop <id>`),process.exit(1));let r=f(e);if(!r){console.log(`No managed process found: ${e}`);return}n(r);return}case`status`:{let e=t.shift()?.trim();e||(console.error(`Usage: kb proc status <id>`),process.exit(1));let r=d(e);if(!r){console.log(`No managed process found: ${e}`);return}n(r);return}case`list`:{let e=c();if(e.length===0){console.log(`No managed processes.`);return}for(let t of e)n(t),console.log(``);return}case`logs`:{let n=e(t,`--tail`,50),r=t.shift()?.trim();r||(console.error(`Usage: kb proc logs <id> [--tail N]`),process.exit(1));let i=l(r,n);if(i.length===0){console.log(`No logs found for process: ${r}`);return}for(let e of i)console.log(e);return}default:console.error(`Unknown proc action: ${r}`),console.error(`Actions: start, stop, status, list, logs`),process.exit(1)}}},{name:`watch`,description:`Manage in-memory filesystem watchers`,usage:`kb watch <start|stop|list> ...`,run:async e=>{let t=e.shift()?.trim()??``;switch(t){case`start`:{let t=e.shift()?.trim();t||(console.error(`Usage: kb watch start <path>`),process.exit(1));let n=m({path:i(t)});console.log(`Started watcher: ${n.id}`),console.log(`  Path: ${n.path}`),console.log(`  Status: ${n.status}`);return}case`stop`:{let t=e.shift()?.trim();t||(console.error(`Usage: kb watch stop <id>`),process.exit(1));let n=h(t);console.log(n?`Stopped watcher: ${t}`:`Watcher not found: ${t}`);return}case`list`:{let e=p();if(e.length===0){console.log(`No active watchers.`);return}for(let t of e)console.log(`${t.id}`),console.log(`  Path: ${t.path}`),console.log(`  Status: ${t.status}`),console.log(`  Events: ${t.eventCount}`);return}default:console.error(`Unknown watch action: ${t}`),console.error(`Actions: start, stop, list`),process.exit(1)}}},{name:`delegate`,description:`Delegate a task to a local Ollama model`,usage:`kb delegate [--model name] [--system prompt] [--temp 0.3] <prompt | --stdin>`,run:async n=>{if((n[0]===`models`?n.shift():void 0)===`models`){try{let e=await s();if(e.length===0){console.log(`No Ollama models available. Pull one with: ollama pull qwen2.5-coder:7b`);return}for(let t of e)console.log(t)}catch{console.error(`Ollama is not running. Start it with: ollama serve`),process.exit(1)}return}let c=t(n,`--model`,``),l=t(n,`--system`,``),u=e(n,`--temp`,.3),d=t(n,`--context`,``),f=n.join(` `);f||=await r(),f||(console.error(`Usage: kb delegate [--model name] <prompt>`),process.exit(1));let p;d&&(p=await a(i(d),`utf-8`));let m=await o({prompt:f,model:c||void 0,system:l||void 0,context:p,temperature:u});m.error&&(console.error(`Error: ${m.error}`),process.exit(1)),console.log(m.response),console.error(`\n(${m.model}, ${m.durationMs}ms, ${m.tokenCount??`?`} tokens)`)}}];export{g as environmentCommands};

package/packages/cli/dist/commands/execution.d.ts

@@ -3,5 +3,4 @@ import { Command } from "../types.js";
 //#region packages/cli/src/commands/execution.d.ts
 declare const executionCommands: Command[];
 //#endregion
-export { executionCommands };
-//# sourceMappingURL=execution.d.ts.map
+export { executionCommands };

package/packages/cli/dist/commands/execution.js

@@ -1,2 +1 @@
-import{extractBoolFlag as e,extractNumFlag as t,extractStrFlag as n,printTestRunResult as r,readStdin as i,splitCsv as a}from"../helpers.js";import{resolve as o}from"node:path";import{readFile as s}from"node:fs/promises";import{codemod as c,dataTransform as l,evaluate as u,rename as d,testRun as f}from"../../../tools/dist/index.js";const p=[{name:`eval`,description:`Evaluate JavaScript or TypeScript in a constrained VM sandbox`,usage:`kb eval [code] [--lang js|ts] [--timeout ms]`,run:async e=>{let r=n(e,`--lang`,`js`),a=t(e,`--timeout`,5e3),o=e.join(` `),s=o.trim()?``:await i(),c=o||s;c.trim()||(console.error(`Usage: kb eval [code] [--lang js|ts] [--timeout ms]`),process.exit(1));let l=u({code:c,lang:r===`ts`?`ts`:`js`,timeout:a});if(!l.success){console.error(`Eval failed in ${l.durationMs}ms: ${l.error}`),process.exitCode=1;return}console.log(`Eval succeeded in ${l.durationMs}ms`),console.log(`─`.repeat(60)),console.log(l.output)}},{name:`test`,description:`Run Vitest for all tests or a specific subset`,usage:`kb test [files...] [--grep pattern] [--cwd path] [--timeout ms]`,run:async e=>{let i=n(e,`--grep`,``).trim()||void 0,a=n(e,`--cwd`,``).trim()||void 0,o=t(e,`--timeout`,6e4),s=e.filter(Boolean),c=await f({files:s.length>0?s:void 0,grep:i,cwd:a,timeout:o});r(c),c.passed||(process.exitCode=1)}},{name:`rename`,description:`Rename a symbol across files using whole-word regex matching`,usage:`kb rename <old> <new> <path> [--dry-run] [--extensions .ts,.tsx] [--exclude dist/**]`,run:async t=>{let r=t.shift()?.trim()??``,i=t.shift()?.trim()??``,s=t.shift()?.trim()??``;(!r||!i||!s)&&(console.error(`Usage: kb rename <old> <new> <path> [--dry-run] [--extensions .ts,.tsx] [--exclude dist/**]`),process.exit(1));let c=a(n(t,`--extensions`,``)),l=a(n(t,`--exclude`,``)),u=await d({oldName:r,newName:i,rootPath:o(s),extensions:c.length>0?c:void 0,exclude:l.length>0?l:void 0,dryRun:e(t,`--dry-run`)});console.log(JSON.stringify(u,null,2))}},{name:`codemod`,description:`Apply regex-based codemod rules from a JSON file across a path`,usage:`kb codemod <path> --rules <file.json> [--dry-run] [--extensions .ts,.tsx] [--exclude dist/**]`,run:async t=>{let r=t.shift()?.trim()??``,i=n(t,`--rules`,``).trim();(!r||!i)&&(console.error(`Usage: kb codemod <path> --rules <file.json> [--dry-run] [--extensions .ts,.tsx] [--exclude dist/**]`),process.exit(1));let l=await s(o(i),`utf-8`),u;try{u=JSON.parse(l)}catch{throw Error(`Failed to parse rules file as JSON: ${i}`)}if(!Array.isArray(u))throw Error(`Codemod rules file must contain a JSON array.`);let d=a(n(t,`--extensions`,``)),f=a(n(t,`--exclude`,``)),p=await c({rootPath:o(r),rules:u,extensions:d.length>0?d:void 0,exclude:f.length>0?f:void 0,dryRun:e(t,`--dry-run`)});console.log(JSON.stringify(p,null,2))}},{name:`transform`,description:`Apply jq-like transforms to JSON from stdin`,usage:`cat data.json | kb transform <expression>`,run:async e=>{let t=e.join(` `).trim(),n=await i();(!t||!n.trim())&&(console.error(`Usage: cat data.json | kb transform <expression>`),process.exit(1));let r=l({input:n,expression:t});console.log(r.outputString)}}];export{p as executionCommands};
-//# sourceMappingURL=execution.js.map
+import{extractBoolFlag as e,extractNumFlag as t,extractStrFlag as n,printTestRunResult as r,readStdin as i,splitCsv as a}from"../helpers.js";import{resolve as o}from"node:path";import{readFile as s}from"node:fs/promises";import{codemod as c,dataTransform as l,evaluate as u,rename as d,testRun as f}from"../../../tools/dist/index.js";const p=[{name:`eval`,description:`Evaluate JavaScript or TypeScript in a constrained VM sandbox`,usage:`kb eval [code] [--lang js|ts] [--timeout ms]`,run:async e=>{let r=n(e,`--lang`,`js`),a=t(e,`--timeout`,5e3),o=e.join(` `),s=o.trim()?``:await i(),c=o||s;c.trim()||(console.error(`Usage: kb eval [code] [--lang js|ts] [--timeout ms]`),process.exit(1));let l=u({code:c,lang:r===`ts`?`ts`:`js`,timeout:a});if(!l.success){console.error(`Eval failed in ${l.durationMs}ms: ${l.error}`),process.exitCode=1;return}console.log(`Eval succeeded in ${l.durationMs}ms`),console.log(`─`.repeat(60)),console.log(l.output)}},{name:`test`,description:`Run Vitest for all tests or a specific subset`,usage:`kb test [files...] [--grep pattern] [--cwd path] [--timeout ms]`,run:async e=>{let i=n(e,`--grep`,``).trim()||void 0,a=n(e,`--cwd`,``).trim()||void 0,o=t(e,`--timeout`,6e4),s=e.filter(Boolean),c=await f({files:s.length>0?s:void 0,grep:i,cwd:a,timeout:o});r(c),c.passed||(process.exitCode=1)}},{name:`rename`,description:`Rename a symbol across files using whole-word regex matching`,usage:`kb rename <old> <new> <path> [--dry-run] [--extensions .ts,.tsx] [--exclude dist/**]`,run:async t=>{let r=t.shift()?.trim()??``,i=t.shift()?.trim()??``,s=t.shift()?.trim()??``;(!r||!i||!s)&&(console.error(`Usage: kb rename <old> <new> <path> [--dry-run] [--extensions .ts,.tsx] [--exclude dist/**]`),process.exit(1));let c=a(n(t,`--extensions`,``)),l=a(n(t,`--exclude`,``)),u=await d({oldName:r,newName:i,rootPath:o(s),extensions:c.length>0?c:void 0,exclude:l.length>0?l:void 0,dryRun:e(t,`--dry-run`)});console.log(JSON.stringify(u,null,2))}},{name:`codemod`,description:`Apply regex-based codemod rules from a JSON file across a path`,usage:`kb codemod <path> --rules <file.json> [--dry-run] [--extensions .ts,.tsx] [--exclude dist/**]`,run:async t=>{let r=t.shift()?.trim()??``,i=n(t,`--rules`,``).trim();(!r||!i)&&(console.error(`Usage: kb codemod <path> --rules <file.json> [--dry-run] [--extensions .ts,.tsx] [--exclude dist/**]`),process.exit(1));let l=await s(o(i),`utf-8`),u;try{u=JSON.parse(l)}catch{throw Error(`Failed to parse rules file as JSON: ${i}`)}if(!Array.isArray(u))throw Error(`Codemod rules file must contain a JSON array.`);let d=a(n(t,`--extensions`,``)),f=a(n(t,`--exclude`,``)),p=await c({rootPath:o(r),rules:u,extensions:d.length>0?d:void 0,exclude:f.length>0?f:void 0,dryRun:e(t,`--dry-run`)});console.log(JSON.stringify(p,null,2))}},{name:`transform`,description:`Apply jq-like transforms to JSON from stdin`,usage:`cat data.json | kb transform <expression>`,run:async e=>{let t=e.join(` `).trim(),n=await i();(!t||!n.trim())&&(console.error(`Usage: cat data.json | kb transform <expression>`),process.exit(1));let r=l({input:n,expression:t});console.log(r.outputString)}}];export{p as executionCommands};

package/packages/cli/dist/commands/graph.d.ts

@@ -3,5 +3,4 @@ import { Command } from "../types.js";
 //#region packages/cli/src/commands/graph.d.ts
 declare const graphCommands: Command[];
 //#endregion
-export { graphCommands };
-//# sourceMappingURL=graph.d.ts.map
+export { graphCommands };

package/packages/cli/dist/commands/graph.js

@@ -3,5 +3,4 @@ import{ctx as e}from"../context.js";import{extractNumFlag as t,extractStrFlag as
   Options: --type, --name, --node-id, --edge-type, --direction, --depth, --limit, --source-path`,run:async i=>{let a=i.shift()?.trim()??``;a||(console.error(`Usage: kb graph <action>
 Actions: stats, find-nodes, find-edges, neighbors, traverse, delete, clear`),process.exit(1));let{graphStore:o}=await e(),s=n(i,`--type`,``),c=n(i,`--name`,``),l=n(i,`--node-id`,``),u=n(i,`--edge-type`,``),d=n(i,`--direction`,`both`),f=t(i,`--depth`,2),p=t(i,`--limit`,50),m=n(i,`--source-path`,``),h={stats:`stats`,"find-nodes":`find_nodes`,"find-edges":`find_edges`,neighbors:`neighbors`,traverse:`traverse`,delete:`delete`,clear:`clear`}[a];h||(console.error(`Unknown graph action: ${a}`),console.error(`Actions: stats, find-nodes, find-edges, neighbors, traverse, delete, clear`),process.exit(1));let g=await r(o,{action:h,nodeType:s||void 0,namePattern:c||void 0,sourcePath:m||void 0,nodeId:l||void 0,edgeType:u||void 0,direction:d,maxDepth:f,limit:p});if(console.log(g.summary),g.nodes&&g.nodes.length>0){console.log(`
 Nodes:`);for(let e of g.nodes){let t=Object.keys(e.properties).length>0?` ${JSON.stringify(e.properties)}`:``;console.log(`  ${e.name} (${e.type}, id: ${e.id})${t}`)}}if(g.edges&&g.edges.length>0){console.log(`
-Edges:`);for(let e of g.edges){let t=e.weight===1?``:` (weight: ${e.weight})`;console.log(`  ${e.fromId} --[${e.type}]--> ${e.toId}${t}`)}}g.stats&&(console.log(`\nNode types: ${JSON.stringify(g.stats.nodeTypes)}`),console.log(`Edge types: ${JSON.stringify(g.stats.edgeTypes)}`)),g.deleted!==void 0&&console.log(`Deleted: ${g.deleted}`)}}];export{i as graphCommands};
-//# sourceMappingURL=graph.js.map
+Edges:`);for(let e of g.edges){let t=e.weight===1?``:` (weight: ${e.weight})`;console.log(`  ${e.fromId} --[${e.type}]--> ${e.toId}${t}`)}}g.stats&&(console.log(`\nNode types: ${JSON.stringify(g.stats.nodeTypes)}`),console.log(`Edge types: ${JSON.stringify(g.stats.edgeTypes)}`)),g.deleted!==void 0&&console.log(`Deleted: ${g.deleted}`)}}];export{i as graphCommands};

package/packages/cli/dist/commands/init/adapters.d.ts

@@ -6,7 +6,7 @@
  * instructions, and skills live. This module defines the interface and
  * provides auto-detection based on workspace markers.
  */
-type SupportedIde = 'copilot' | 'claude-code';
+type SupportedIde = 'copilot' | 'claude-code' | 'cursor' | 'windsurf';
 interface IdeAdapter {
   /** Create the MCP server config file for this IDE. */
   writeMcpConfig(cwd: string, serverName: string): void;
@@ -21,7 +21,8 @@ interface IdeAdapter {
 declare function detectIde(cwd: string): SupportedIde;
 declare const copilotAdapter: IdeAdapter;
 declare const claudeCodeAdapter: IdeAdapter;
+declare const cursorAdapter: IdeAdapter;
+declare const windsurfAdapter: IdeAdapter;
 declare function getAdapter(ide: SupportedIde): IdeAdapter;
 //#endregion
-export { IdeAdapter, SupportedIde, claudeCodeAdapter, copilotAdapter, detectIde, getAdapter };
-//# sourceMappingURL=adapters.d.ts.map
+export { IdeAdapter, SupportedIde, claudeCodeAdapter, copilotAdapter, cursorAdapter, detectIde, getAdapter, windsurfAdapter };

package/packages/cli/dist/commands/init/adapters.js

@@ -1,2 +1 @@
-import{buildAgentsMd as e,buildCopilotInstructions as t}from"./templates.js";import{existsSync as n,mkdirSync as r,writeFileSync as i}from"node:fs";import{basename as a,resolve as o}from"node:path";function s(e){return n(o(e,`.vscode`))?`copilot`:n(o(e,`.claude`))?`claude-code`:`copilot`}function c(e){return{servers:{[e]:{type:`stdio`,command:`npx`,args:[`@vpxa/kb`,`serve`]}}}}const l={scaffoldDir:`copilot`,writeMcpConfig(e,t){let r=o(e,`.vscode`),a=o(r,`mcp.json`);n(r)&&!n(a)&&(i(a,`${JSON.stringify(c(t),null,2)}\n`,`utf-8`),console.log(`  Created .vscode/mcp.json`))},writeInstructions(e,s){let c=o(e,`.github`),l=o(c,`copilot-instructions.md`);n(l)||(r(c,{recursive:!0}),i(l,t(a(e),s),`utf-8`),console.log(`  Created .github/copilot-instructions.md`))},writeAgentsMd(t,r){let s=o(t,`AGENTS.md`);n(s)||(i(s,e(a(t),r),`utf-8`),console.log(`  Created AGENTS.md`))}},u={scaffoldDir:`claude-code`,writeMcpConfig(e,t){},writeInstructions(e,t){},writeAgentsMd(e,t){}};function d(e){switch(e){case`copilot`:return l;case`claude-code`:return u}}export{u as claudeCodeAdapter,l as copilotAdapter,s as detectIde,d as getAdapter};
-//# sourceMappingURL=adapters.js.map
+import{MCP_SERVER_ENTRY as e}from"./constants.js";import{buildAgentsMd as t,buildCopilotInstructions as n}from"./templates.js";import{existsSync as r,mkdirSync as i,writeFileSync as a}from"node:fs";import{basename as o,resolve as s}from"node:path";function c(e){return r(s(e,`.cursor`))?`cursor`:r(s(e,`.claude`))?`claude-code`:r(s(e,`.windsurf`))?`windsurf`:`copilot`}function l(t){return{servers:{[t]:{...e}}}}function u(t){let{type:n,...r}=e;return{mcpServers:{[t]:r}}}const d={scaffoldDir:`general`,writeMcpConfig(e,t){let n=s(e,`.vscode`),o=s(n,`mcp.json`);r(o)||(i(n,{recursive:!0}),a(o,`${JSON.stringify(l(t),null,2)}\n`,`utf-8`),console.log(`  Created .vscode/mcp.json`))},writeInstructions(e,t){let c=s(e,`.github`),l=s(c,`copilot-instructions.md`);r(l)||(i(c,{recursive:!0}),a(l,n(o(e),t),`utf-8`),console.log(`  Created .github/copilot-instructions.md`))},writeAgentsMd(e,n){let i=s(e,`AGENTS.md`);r(i)||(a(i,t(o(e),n),`utf-8`),console.log(`  Created AGENTS.md`))}},f={scaffoldDir:`general`,writeMcpConfig(e,t){let n=s(e,`.mcp.json`);r(n)||(a(n,`${JSON.stringify(u(t),null,2)}\n`,`utf-8`),console.log(`  Created .mcp.json`))},writeInstructions(e,i){let c=s(e,`CLAUDE.md`);if(!r(c)){let r=o(e);a(c,`${n(r,i)}\n---\n\n${t(r,i)}`,`utf-8`),console.log(`  Created CLAUDE.md`)}},writeAgentsMd(e,t){}},p={scaffoldDir:`general`,writeMcpConfig(e,t){let n=s(e,`.cursor`),o=s(n,`mcp.json`);r(o)||(i(n,{recursive:!0}),a(o,`${JSON.stringify(u(t),null,2)}\n`,`utf-8`),console.log(`  Created .cursor/mcp.json`))},writeInstructions(e,c){let l=s(e,`.cursor`,`rules`),u=s(l,`kb.mdc`);if(!r(u)){i(l,{recursive:!0});let r=o(e);a(u,`${n(r,c)}\n---\n\n${t(r,c)}`,`utf-8`),console.log(`  Created .cursor/rules/kb.mdc`)}},writeAgentsMd(e,t){}},m={scaffoldDir:`general`,writeMcpConfig(e,t){let n=s(e,`.vscode`),o=s(n,`mcp.json`);r(o)||(i(n,{recursive:!0}),a(o,`${JSON.stringify(l(t),null,2)}\n`,`utf-8`),console.log(`  Created .vscode/mcp.json (Windsurf-compatible)`))},writeInstructions(e,i){let c=s(e,`.windsurfrules`);if(!r(c)){let r=o(e);a(c,`${n(r,i)}\n---\n\n${t(r,i)}`,`utf-8`),console.log(`  Created .windsurfrules`)}},writeAgentsMd(e,t){}};function h(e){switch(e){case`copilot`:return d;case`claude-code`:return f;case`cursor`:return p;case`windsurf`:return m}}export{f as claudeCodeAdapter,d as copilotAdapter,p as cursorAdapter,c as detectIde,h as getAdapter,m as windsurfAdapter};

package/packages/cli/dist/commands/init/config.d.ts

@@ -7,5 +7,4 @@ declare function writeKbConfig(cwd: string, force: boolean): boolean;
 declare function ensureGitignore(cwd: string): void;
 declare function getServerName(): string;
 //#endregion
-export { ensureGitignore, getServerName, writeKbConfig };
-//# sourceMappingURL=config.d.ts.map
+export { ensureGitignore, getServerName, writeKbConfig };

package/packages/cli/dist/commands/init/config.js

@@ -1,4 +1,3 @@
-import{appendFileSync as e,existsSync as t,readFileSync as n,writeFileSync as r}from"node:fs";import{resolve as i}from"node:path";const a={serverName:`knowledge-base`,sources:[{path:`.`,excludePatterns:[`**/node_modules/**`,`**/dist/**`,`**/build/**`,`**/.git/**`,`**/.kb-data/**`,`**/coverage/**`,`**/*.min.js`,`**/package-lock.json`,`**/pnpm-lock.yaml`]}],indexing:{chunkSize:1500,chunkOverlap:200,minChunkSize:100},embedding:{model:`mixedbread-ai/mxbai-embed-large-v1`,dimensions:1024},store:{backend:`lancedb`,path:`.kb-data/lance`},curated:{path:`curated`}};function o(e,n){let o=i(e,`kb.config.json`);return t(o)&&!n?(console.log(`kb.config.json already exists. Use --force to overwrite.`),!1):(r(o,`${JSON.stringify(a,null,2)}\n`,`utf-8`),console.log(`  Created kb.config.json`),!0)}function s(a){let o=i(a,`.gitignore`),s=[{dir:`.kb-data/`,label:`Knowledge base vector store`},{dir:`.brainstorm/`,label:`Brainstorming sessions`},{dir:`curated/`,label:`Curated knowledge entries`},{dir:`curated-archive/`,label:`Archived curated entries`}];if(t(o)){let t=n(o,`utf-8`),r=s.filter(e=>!t.includes(e.dir));r.length>0&&(e(o,`\n${r.map(e=>`# ${e.label}\n${e.dir}`).join(`
-`)}\n`,`utf-8`),console.log(`  Added ${r.map(e=>e.dir).join(`, `)} to .gitignore`))}else r(o,`${s.map(e=>`# ${e.label}\n${e.dir}`).join(`
-`)}\n`,`utf-8`),console.log(`  Created .gitignore with KB entries`)}function c(){return a.serverName}export{s as ensureGitignore,c as getServerName,o as writeKbConfig};
-//# sourceMappingURL=config.js.map
+import{SERVER_NAME as e}from"./constants.js";import{appendFileSync as t,existsSync as n,readFileSync as r,writeFileSync as i}from"node:fs";import{resolve as a}from"node:path";import{KB_PATHS as o}from"../../../../core/dist/index.js";const s={serverName:e,sources:[{path:`.`,excludePatterns:[`**/node_modules/**`,`**/dist/**`,`**/build/**`,`**/.git/**`,`**/${o.data}/**`,`**/coverage/**`,`**/*.min.js`,`**/package-lock.json`,`**/pnpm-lock.yaml`]}],indexing:{chunkSize:1500,chunkOverlap:200,minChunkSize:100},embedding:{model:`mixedbread-ai/mxbai-embed-large-v1`,dimensions:1024},store:{backend:`lancedb`,path:`${o.data}/lance`},curated:{path:o.aiCurated}};function c(e,t){let r=a(e,`kb.config.json`);return n(r)&&!t?(console.log(`kb.config.json already exists. Use --force to overwrite.`),!1):(i(r,`${JSON.stringify(s,null,2)}\n`,`utf-8`),console.log(`  Created kb.config.json`),!0)}function l(e){let s=a(e,`.gitignore`),c=[{dir:`${o.data}/`,label:`Knowledge base vector store`},{dir:`${o.state}/`,label:`Knowledge base session state`},{dir:`${o.brainstorm}/`,label:`Brainstorming sessions`},{dir:`${o.handoffs}/`,label:`Handoff documents`}];if(n(s)){let e=r(s,`utf-8`),n=c.filter(t=>!e.includes(t.dir));n.length>0&&(t(s,`\n${n.map(e=>`# ${e.label}\n${e.dir}`).join(`
+`)}\n`,`utf-8`),console.log(`  Added ${n.map(e=>e.dir).join(`, `)} to .gitignore`))}else i(s,`${c.map(e=>`# ${e.label}\n${e.dir}`).join(`
+`)}\n`,`utf-8`),console.log(`  Created .gitignore with KB entries`)}function u(){return s.serverName}export{l as ensureGitignore,u as getServerName,c as writeKbConfig};

package/packages/cli/dist/commands/init/constants.d.ts

@@ -0,0 +1,18 @@
+//#region packages/cli/src/commands/init/constants.d.ts
+/**
+ * Init module — shared constants.
+ *
+ * Single source of truth for lists used by both local and global init.
+ */
+/** The MCP server name used in all IDE configs. */
+declare const SERVER_NAME = "knowledge-base";
+/** The npx-based MCP server entry written into mcp.json files. */
+declare const MCP_SERVER_ENTRY: {
+  readonly type: "stdio";
+  readonly command: "npx";
+  readonly args: readonly ["-y", "@vpxa/kb", "serve"];
+};
+/** Skills shipped with the KB package and installed during init. */
+declare const SKILL_NAMES: readonly ["knowledge-base", "brainstorming", "session-handoff", "requirements-clarity", "lesson-learned", "c4-architecture", "adr-skill"];
+//#endregion
+export { MCP_SERVER_ENTRY, SERVER_NAME, SKILL_NAMES };

package/packages/cli/dist/commands/init/constants.js

@@ -0,0 +1 @@
+const e=`knowledge-base`,t={type:`stdio`,command:`npx`,args:[`-y`,`@vpxa/kb`,`serve`]},n=[`knowledge-base`,`brainstorming`,`session-handoff`,`requirements-clarity`,`lesson-learned`,`c4-architecture`,`adr-skill`];export{t as MCP_SERVER_ENTRY,e as SERVER_NAME,n as SKILL_NAMES};

package/packages/cli/dist/commands/init/curated.d.ts

@@ -4,5 +4,4 @@
  */
 declare function createCuratedDirs(cwd: string): void;
 //#endregion
-export { createCuratedDirs };
-//# sourceMappingURL=curated.d.ts.map
+export { createCuratedDirs };

package/packages/cli/dist/commands/init/curated.js

@@ -1,2 +1 @@
-import{existsSync as e,mkdirSync as t}from"node:fs";import{resolve as n}from"node:path";const r=[`decisions`,`patterns`,`conventions`,`troubleshooting`];function i(i){let a=n(i,`curated`);e(a)||(t(a,{recursive:!0}),console.log(`  Created curated/`));for(let i of r){let r=n(a,i);e(r)||t(r,{recursive:!0})}console.log(`  Created curated/{${r.join(`,`)}}/`)}export{i as createCuratedDirs};
-//# sourceMappingURL=curated.js.map
+import{existsSync as e,mkdirSync as t}from"node:fs";import{resolve as n}from"node:path";const r=[`decisions`,`patterns`,`conventions`,`troubleshooting`];function i(i){let a=n(i,`.ai`,`curated`);e(a)||(t(a,{recursive:!0}),console.log(`  Created .ai/curated/`));for(let i of r){let r=n(a,i);e(r)||t(r,{recursive:!0})}console.log(`  Created .ai/curated/{${r.join(`,`)}}/`)}export{i as createCuratedDirs};

package/packages/cli/dist/commands/init/global.d.ts

@@ -0,0 +1,34 @@
+//#region packages/cli/src/commands/init/global.d.ts
+/**
+ * `kb init --global` — configure KB as a user-level MCP server.
+ *
+ * Auto-detects all installed IDEs, writes user-level mcp.json for each,
+ * installs skills to a global location, and creates the global data store.
+ */
+/** Represents a user-level IDE config location. */
+interface UserLevelIdePath {
+  ide: string;
+  configDir: string;
+  mcpConfigPath: string;
+}
+/**
+ * Detect all installed IDEs by checking if their user-level config directory exists.
+ */
+declare function detectInstalledIdes(): UserLevelIdePath[];
+/**
+ * Write or merge the KB server entry into a user-level mcp.json.
+ * Preserves all existing non-KB entries. Backs up existing file before writing.
+ */
+declare function writeUserLevelMcpConfig(idePath: UserLevelIdePath, serverName: string, force?: boolean): void;
+/**
+ * Install skills to the global user-level directory (~/.kb-data/skills/).
+ */
+declare function installGlobalSkills(pkgRoot: string): void;
+/**
+ * Main orchestrator for `kb init --global`.
+ */
+declare function initGlobal(options: {
+  force: boolean;
+}): Promise<void>;
+//#endregion
+export { UserLevelIdePath, detectInstalledIdes, initGlobal, installGlobalSkills, writeUserLevelMcpConfig };

package/packages/cli/dist/commands/init/global.js

@@ -0,0 +1,5 @@
+import{MCP_SERVER_ENTRY as e,SERVER_NAME as t,SKILL_NAMES as n}from"./constants.js";import{copyDirectoryRecursive as r}from"./scaffold.js";import{existsSync as i,mkdirSync as a,readFileSync as o,writeFileSync as s}from"node:fs";import{dirname as c,resolve as l}from"node:path";import{fileURLToPath as u}from"node:url";import{getGlobalDataDir as d,saveRegistry as f}from"../../../../core/dist/index.js";import{homedir as p}from"node:os";function m(){let e=p(),t=process.platform,n=[];if(t===`win32`){let t=process.env.APPDATA??l(e,`AppData`,`Roaming`);n.push({ide:`VS Code`,configDir:l(t,`Code`,`User`),mcpConfigPath:l(t,`Code`,`User`,`mcp.json`)},{ide:`VS Code Insiders`,configDir:l(t,`Code - Insiders`,`User`),mcpConfigPath:l(t,`Code - Insiders`,`User`,`mcp.json`)},{ide:`VSCodium`,configDir:l(t,`VSCodium`,`User`),mcpConfigPath:l(t,`VSCodium`,`User`,`mcp.json`)},{ide:`Cursor`,configDir:l(t,`Cursor`,`User`),mcpConfigPath:l(t,`Cursor`,`User`,`mcp.json`)},{ide:`Cursor Nightly`,configDir:l(t,`Cursor Nightly`,`User`),mcpConfigPath:l(t,`Cursor Nightly`,`User`,`mcp.json`)},{ide:`Windsurf`,configDir:l(t,`Windsurf`,`User`),mcpConfigPath:l(t,`Windsurf`,`User`,`mcp.json`)})}else if(t===`darwin`){let t=l(e,`Library`,`Application Support`);n.push({ide:`VS Code`,configDir:l(t,`Code`,`User`),mcpConfigPath:l(t,`Code`,`User`,`mcp.json`)},{ide:`VS Code Insiders`,configDir:l(t,`Code - Insiders`,`User`),mcpConfigPath:l(t,`Code - Insiders`,`User`,`mcp.json`)},{ide:`VSCodium`,configDir:l(t,`VSCodium`,`User`),mcpConfigPath:l(t,`VSCodium`,`User`,`mcp.json`)},{ide:`Cursor`,configDir:l(t,`Cursor`,`User`),mcpConfigPath:l(t,`Cursor`,`User`,`mcp.json`)},{ide:`Cursor Nightly`,configDir:l(t,`Cursor Nightly`,`User`),mcpConfigPath:l(t,`Cursor Nightly`,`User`,`mcp.json`)},{ide:`Windsurf`,configDir:l(t,`Windsurf`,`User`),mcpConfigPath:l(t,`Windsurf`,`User`,`mcp.json`)})}else{let t=process.env.XDG_CONFIG_HOME??l(e,`.config`);n.push({ide:`VS Code`,configDir:l(t,`Code`,`User`),mcpConfigPath:l(t,`Code`,`User`,`mcp.json`)},{ide:`VS Code Insiders`,configDir:l(t,`Code - Insiders`,`User`),mcpConfigPath:l(t,`Code - Insiders`,`User`,`mcp.json`)},{ide:`VSCodium`,configDir:l(t,`VSCodium`,`User`),mcpConfigPath:l(t,`VSCodium`,`User`,`mcp.json`)},{ide:`Cursor`,configDir:l(t,`Cursor`,`User`),mcpConfigPath:l(t,`Cursor`,`User`,`mcp.json`)},{ide:`Cursor Nightly`,configDir:l(t,`Cursor Nightly`,`User`),mcpConfigPath:l(t,`Cursor Nightly`,`User`,`mcp.json`)},{ide:`Windsurf`,configDir:l(t,`Windsurf`,`User`),mcpConfigPath:l(t,`Windsurf`,`User`,`mcp.json`)})}return n.push({ide:`Claude Code`,configDir:l(e,`.claude`),mcpConfigPath:l(e,`.claude`,`mcp.json`)}),n.filter(e=>i(e.configDir))}function h(t,n,r=!1){let{mcpConfigPath:c,configDir:l}=t,u={...e},d={};if(i(c)){try{let e=o(c,`utf-8`);d=JSON.parse(e)}catch{let e=`${c}.bak`;s(e,o(c,`utf-8`),`utf-8`),console.log(`  Backed up invalid ${c} to ${e}`),d={}}if((d.servers??d.mcpServers??{})[n]&&!r){console.log(`  ${t.ide}: ${n} already configured (use --force to update)`);return}}let f=new Set([`VS Code`,`VS Code Insiders`,`VSCodium`,`Windsurf`]).has(t.ide)?`servers`:`mcpServers`,p=d[f]??{};p[n]=u,d[f]=p,a(l,{recursive:!0}),s(c,`${JSON.stringify(d,null,2)}\n`,`utf-8`),console.log(`  ${t.ide}: configured ${n} in ${c}`)}function g(e){let t=l(d(),`skills`);for(let a of n){let n=l(e,`skills`,a);i(n)&&r(n,l(t,a),`skills/${a}`,!0)}console.log(`  Installed ${n.length} skills to ${t}`)}async function _(e){let n=t;console.log(`Initializing global KB installation...
+`);let r=d();a(r,{recursive:!0}),console.log(`  Global data store: ${r}`),f({version:1,workspaces:{}}),console.log(`  Created registry.json`);let i=m();if(i.length===0)console.log(`
+  No supported IDEs detected. You can manually add the MCP server config.`);else{console.log(`\n  Detected ${i.length} IDE(s):`);for(let t of i)h(t,n,e.force)}g(l(c(u(import.meta.url)),`..`,`..`,`..`,`..`,`..`)),console.log(`
+Global KB installation complete!`),console.log(`
+Next steps:`),console.log(`  1. Open any workspace in your IDE`),console.log(`  2. The KB server will auto-start and index the workspace`),console.log("  3. Run `kb init` in a workspace to add AGENTS.md and instructions")}export{m as detectInstalledIdes,_ as initGlobal,g as installGlobalSkills,h as writeUserLevelMcpConfig};

package/packages/cli/dist/commands/init/index.d.ts

@@ -16,8 +16,13 @@
 declare function initProject(options: {
   force: boolean;
 }): Promise<void>;
+/**
+ * Smart init — scaffold-only if global detected, full local otherwise.
+ */
+declare function initSmart(options: {
+  force: boolean;
+}): Promise<void>;
 /** Generate a JSON guide report comparing installed vs source files. */
 declare function guideProject(): Promise<void>;
 //#endregion
-export { guideProject, initProject };
-//# sourceMappingURL=index.d.ts.map
+export { guideProject, initProject, initSmart };

package/packages/cli/dist/commands/init/index.js

@@ -1,3 +1,5 @@
-import{detectIde as e,getAdapter as t}from"./adapters.js";import{ensureGitignore as n,getServerName as r,writeKbConfig as i}from"./config.js";import{createCuratedDirs as a}from"./curated.js";import{copyScaffold as o,copySkills as s,guideScaffold as c,guideSkills as l}from"./scaffold.js";import{dirname as u,resolve as d}from"node:path";import{fileURLToPath as f}from"node:url";const p=[`knowledge-base`,`brainstorming`];async function m(c){let l=process.cwd();if(!i(l,c.force))return;n(l);let m=r(),h=t(e(l));h.writeMcpConfig(l,m),h.writeInstructions(l,m),h.writeAgentsMd(l,m);let g=d(u(f(import.meta.url)),`..`,`..`,`..`,`..`,`..`);s(l,g,p,c.force),o(l,g,h.scaffoldDir,c.force),a(l),console.log(`
-Knowledge base initialized! Next steps:`),console.log(`  kb reindex     Index your codebase`),console.log(`  kb search      Search indexed content`),console.log(`  kb serve       Start MCP server for IDE integration`)}async function h(){let n=process.cwd(),r=t(e(n)),i=d(u(f(import.meta.url)),`..`,`..`,`..`,`..`,`..`),a=[...l(n,i,p),...c(n,i,r.scaffoldDir)],o={summary:{total:a.length,new:a.filter(e=>e.status===`new`).length,outdated:a.filter(e=>e.status===`outdated`).length,current:a.filter(e=>e.status===`current`).length},files:a};console.log(JSON.stringify(o,null,2))}export{h as guideProject,m as initProject};
-//# sourceMappingURL=index.js.map
+import{SKILL_NAMES as e}from"./constants.js";import{detectIde as t,getAdapter as n}from"./adapters.js";import{ensureGitignore as r,getServerName as i,writeKbConfig as a}from"./config.js";import{createCuratedDirs as o}from"./curated.js";import{copyScaffold as s,copySkills as c,guideScaffold as l,guideSkills as u}from"./scaffold.js";import{dirname as d,resolve as f}from"node:path";import{fileURLToPath as p}from"node:url";import{isGlobalInstalled as m}from"../../../../core/dist/index.js";async function h(l){let u=process.cwd();if(!a(u,l.force))return;r(u);let h=i(),g=n(t(u));g.writeMcpConfig(u,h),g.writeInstructions(u,h),g.writeAgentsMd(u,h);let _=f(d(p(import.meta.url)),`..`,`..`,`..`,`..`,`..`);c(u,_,[...e],l.force),s(u,_,g.scaffoldDir,l.force),o(u),console.log(`
+Knowledge base initialized! Next steps:`),console.log(`  kb reindex     Index your codebase`),console.log(`  kb search      Search indexed content`),console.log(`  kb serve       Start MCP server for IDE integration`),m()&&console.log(`
+Note: Global KB is also installed. This workspace uses its own local data store.`)}async function g(e){m()?await _(e):await h(e)}async function _(e){let a=process.cwd(),c=i(),l=n(t(a));l.writeInstructions(a,c),l.writeAgentsMd(a,c),s(a,f(d(p(import.meta.url)),`..`,`..`,`..`,`..`,`..`),l.scaffoldDir,e.force),o(a),r(a),console.log(`
+Workspace scaffolded for global KB! Files added:`),console.log(`  Instruction files (AGENTS.md, copilot-instructions.md, etc.)`),console.log(`  .ai/curated/ directories`),console.log(`  .github/agents/ & .github/prompts/`),console.log(`
+The global KB server will auto-index this workspace when opened in your IDE.`)}async function v(){let r=process.cwd(),i=n(t(r)),a=f(d(p(import.meta.url)),`..`,`..`,`..`,`..`,`..`),o=[...u(r,a,[...e]),...l(r,a,i.scaffoldDir)],s={summary:{total:o.length,new:o.filter(e=>e.status===`new`).length,outdated:o.filter(e=>e.status===`outdated`).length,current:o.filter(e=>e.status===`current`).length},files:o};console.log(JSON.stringify(s,null,2))}export{v as guideProject,h as initProject,g as initSmart};

package/packages/cli/dist/commands/init/scaffold.d.ts

@@ -20,5 +20,4 @@ declare function guideScaffold(cwd: string, pkgRoot: string, ide: string): Guide
 /** Generate guide report for skill files — compare source vs destination. */
 declare function guideSkills(cwd: string, pkgRoot: string, skillNames: string[]): GuideFileEntry[];
 //#endregion
-export { GuideFileEntry, copyDirectoryRecursive, copyScaffold, copySkills, guideScaffold, guideSkills };
-//# sourceMappingURL=scaffold.d.ts.map
+export { GuideFileEntry, copyDirectoryRecursive, copyScaffold, copySkills, guideScaffold, guideSkills };

package/packages/cli/dist/commands/init/scaffold.js

@@ -1,2 +1 @@
-import{copyFileSync as e,existsSync as t,mkdirSync as n,readFileSync as r,readdirSync as i,statSync as a}from"node:fs";import{resolve as o}from"node:path";function s(r,c,l=``,u=!1){n(c,{recursive:!0});for(let n of i(r)){let i=o(r,n),d=o(c,n),f=l?`${l}/${n}`:n;if(a(i).isDirectory())s(i,d,f,u);else if(u||!t(d)){let n=t(d)?`Updated`:`Created`;e(i,d),console.log(`  ${n} .github/${f}`)}}}function c(e,n,s,l){if(t(e))for(let u of i(e)){let i=o(e,u),d=s?`${s}/${u}`:u;if(a(i).isDirectory())c(i,o(n,u),d,l);else{let e=o(n,u),a=r(i,`utf-8`);t(e)?a===r(e,`utf-8`)?l.push({status:`current`,relativePath:d,sourcePath:i}):l.push({status:`outdated`,relativePath:d,sourcePath:i,content:a}):l.push({status:`new`,relativePath:d,sourcePath:i,content:a})}}}function l(e,n,r,i=!1){let a=o(n,`scaffold`,r);for(let n of[`agents`,`prompts`]){let r=o(a,n),c=o(e,`.github`,n);t(r)&&s(r,c,``,i)}}function u(e,n,r,i=!1){for(let a of r){let r=o(n,`skills`,a);t(r)&&s(r,o(e,`.github`,`skills`,a),`skills/${a}`,i)}}function d(e,t,n){let r=[],i=o(t,`scaffold`,n);for(let t of[`agents`,`prompts`])c(o(i,t),o(e,`.github`,t),t,r);return r}function f(e,n,r){let i=[];for(let a of r){let r=o(n,`skills`,a);t(r)&&c(r,o(e,`.github`,`skills`,a),`skills/${a}`,i)}return i}export{s as copyDirectoryRecursive,l as copyScaffold,u as copySkills,d as guideScaffold,f as guideSkills};
-//# sourceMappingURL=scaffold.js.map
+import{copyFileSync as e,existsSync as t,mkdirSync as n,readFileSync as r,readdirSync as i,statSync as a}from"node:fs";import{resolve as o}from"node:path";function s(r,c,l=``,u=!1){n(c,{recursive:!0});for(let n of i(r)){let i=o(r,n),d=o(c,n),f=l?`${l}/${n}`:n;if(a(i).isDirectory())s(i,d,f,u);else if(u||!t(d)){let n=t(d)?`Updated`:`Created`;e(i,d),console.log(`  ${n} .github/${f}`)}}}function c(e,n,s,l){if(t(e))for(let u of i(e)){let i=o(e,u),d=s?`${s}/${u}`:u;if(a(i).isDirectory())c(i,o(n,u),d,l);else{let e=o(n,u),a=r(i,`utf-8`);t(e)?a===r(e,`utf-8`)?l.push({status:`current`,relativePath:d,sourcePath:i}):l.push({status:`outdated`,relativePath:d,sourcePath:i,content:a}):l.push({status:`new`,relativePath:d,sourcePath:i,content:a})}}}function l(e,n,r,i=!1){let a=o(n,`scaffold`,r);for(let n of[`agents`,`prompts`]){let r=o(a,n),c=o(e,`.github`,n);t(r)&&s(r,c,``,i)}}function u(e,n,r,i=!1){for(let a of r){let r=o(n,`skills`,a);t(r)&&s(r,o(e,`.github`,`skills`,a),`skills/${a}`,i)}}function d(e,t,n){let r=[],i=o(t,`scaffold`,n);for(let t of[`agents`,`prompts`])c(o(i,t),o(e,`.github`,t),t,r);return r}function f(e,n,r){let i=[];for(let a of r){let r=o(n,`skills`,a);t(r)&&c(r,o(e,`.github`,`skills`,a),`skills/${a}`,i)}return i}export{s as copyDirectoryRecursive,l as copyScaffold,u as copySkills,d as guideScaffold,f as guideSkills};

package/packages/cli/dist/commands/init/templates.d.ts

@@ -3,8 +3,7 @@
  * Init module — instruction and AGENTS.md template builders.
  * Content for copilot-instructions.md and AGENTS.md.
  */
-declare function buildCopilotInstructions(projectName: string, _serverName: string): string;
-declare function buildAgentsMd(projectName: string, _serverName: string): string;
+declare function buildCopilotInstructions(projectName: string, serverName: string): string;
+declare function buildAgentsMd(projectName: string, serverName: string): string;
 //#endregion
-export { buildAgentsMd, buildCopilotInstructions };
-//# sourceMappingURL=templates.d.ts.map
+export { buildAgentsMd, buildCopilotInstructions };