@vpxa/aikit 0.1.59 → 0.1.60

package/packages/cli/dist/index.js

@@ -1,3 +1,16 @@
-import{getCtx as e}from"./context.js";import{analyzeCommands as t}from"./commands/analyze.js";import{contextCommands as n}from"./commands/context-cmds.js";import{environmentCommands as r}from"./commands/environment.js";import{executionCommands as i}from"./commands/execution.js";import{flowCommands as a}from"./commands/flow.js";import{graphCommands as o}from"./commands/graph.js";import{knowledgeCommands as s}from"./commands/knowledge.js";import{searchCommands as c}from"./commands/search.js";import{systemCommands as l}from"./commands/system.js";import{upgradeCommands as u}from"./commands/upgrade.js";import{workspaceCommands as d}from"./commands/workspace.js";import{readFileSync as f}from"node:fs";import{dirname as p,resolve as m}from"node:path";import{fileURLToPath as h}from"node:url";const g=[...c,...s,...t,...o,...l,...i,...n,...d,...r,...u,...a];g.push({name:`help`,description:`Show available commands`,run:async()=>{v()}});async function _(t){let n=[...t],r=n.shift();if(!r||r===`--help`||r===`-h`){v();return}if(r===`--version`||r===`-v`){let e=m(p(h(import.meta.url)),`..`,`..`,`..`,`package.json`),t=JSON.parse(f(e,`utf-8`));console.log(t.version);return}let i=g.find(e=>e.name===r);i||(console.error(`Unknown command: ${r}`),v(),process.exit(1));try{await i.run(n)}finally{let t=e();t&&await t.store.close()}}function v(){console.log(`@vpxa/aikit — Local-first AI developer toolkit
+import{i as e,t}from"./constants-D3v4VDf0.js";import{copyFileSync as n,existsSync as r,mkdirSync as i,readFileSync as a}from"node:fs";import{basename as o,dirname as s,join as c,resolve as l}from"node:path";import{fileURLToPath as u}from"node:url";import{addToWorkset as d,audit as f,batch as p,check as m,checkpointLatest as h,checkpointList as ee,checkpointLoad as te,checkpointSave as ne,codemod as re,compact as ie,dataTransform as ae,delegate as oe,delegateListModels as se,deleteWorkset as ce,diffParse as le,evaluate as ue,fileSummary as de,find as g,findDeadSymbols as fe,findExamples as pe,getWorkset as me,gitContext as he,graphQuery as ge,guide as _e,health as ve,laneCreate as ye,laneDiff as be,laneDiscard as xe,laneList as Se,laneMerge as Ce,laneStatus as we,listWorksets as _,parseOutput as v,processList as y,processLogs as b,processStart as x,processStatus as S,processStop as C,queueClear as w,queueCreate as T,queueDelete as E,queueDone as D,queueFail as O,queueGet as k,queueList as Te,queueNext as Ee,queuePush as De,removeFromWorkset as Oe,rename as ke,replayClear as Ae,replayList as je,replayTrim as Me,saveWorkset as Ne,scopeMap as Pe,stashClear as Fe,stashDelete as Ie,stashGet as Le,stashList as Re,stashSet as ze,symbol as Be,testRun as Ve,trace as He,watchList as Ue,watchStart as We,watchStop as Ge}from"../../tools/dist/index.js";import{readFile as A}from"node:fs/promises";import{AIKIT_PATHS as j,getGlobalDataDir as Ke,getPartitionDir as M,isUserInstalled as qe,registerWorkspace as Je}from"../../core/dist/index.js";import{initializeWasm as Ye}from"../../chunker/dist/index.js";import{OnnxEmbedder as Xe}from"../../embeddings/dist/index.js";import{IncrementalIndexer as Ze}from"../../indexer/dist/index.js";import{SqliteGraphStore as Qe,createStore as $e}from"../../store/dist/index.js";import{fork as et}from"node:child_process";const tt=[{name:`analyze`,description:`Run analyzer output for a path`,usage:`aikit analyze <type> <path>`,run:async e=>{let t=e.shift()?.trim()??``,n=e.shift()?.trim()??``;(!t||!n)&&(console.error(`Usage: aikit analyze <type> <path>`),console.error(`Types: structure, deps, symbols, patterns, entry-points, blast-radius, diagram`),process.exit(1));let{BlastRadiusAnalyzer:r,DependencyAnalyzer:i,DiagramGenerator:a,EntryPointAnalyzer:o,PatternAnalyzer:s,StructureAnalyzer:c,SymbolAnalyzer:u}=await import(`../../analyzers/dist/index.js`),d=l(n),f;switch(t){case`structure`:f=await new c().analyze(d,{format:`markdown`});break;case`deps`:case`dependencies`:f=await new i().analyze(d,{format:`markdown`});break;case`symbols`:f=await new u().analyze(d,{format:`markdown`});break;case`patterns`:f=await new s().analyze(d,{format:`markdown`});break;case`entry-points`:f=await new o().analyze(d,{format:`markdown`});break;case`blast-radius`:f=await new r().analyze(process.cwd(),{files:[n],format:`markdown`});break;case`diagram`:f=await new a().analyze(d,{diagramType:`architecture`});break;default:console.error(`Unknown analyze type: ${t}`),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:`aikit onboard <path> [--generate] [--out-dir <dir>]`,run:async e=>{let{onboard:t}=await import(`../../tools/dist/index.js`),n=``,r=`memory`,i;for(let t=0;t<e.length;t++){let a=e[t].trim();a===`--generate`?r=`generate`:a===`--out-dir`&&t+1<e.length?i=e[++t].trim():a.startsWith(`--`)||(n=a)}n||=process.cwd();let a=l(n);console.log(`Onboarding: ${a} (mode: ${r})`),console.log(`Running analyses...
+`);let o=await t({path:a,mode:r,outDir:i});for(let e of o.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: ${o.totalDurationMs}ms`),o.outDir&&console.log(`Output written to: ${o.outDir}`)}}];function N(e,t,n){let r=e.indexOf(t);if(r===-1||r+1>=e.length)return n;let i=Number.parseInt(e.splice(r,2)[1],10);return Number.isNaN(i)?n:i}function P(e,t,n){let r=e.indexOf(t);return r===-1||r+1>=e.length?n:e.splice(r,2)[1]}function F(e,t){let n=e.indexOf(t);return n===-1?!1:(e.splice(n,1),!0)}async function I(){if(process.stdin.isTTY)return``;let e=[];for await(let t of process.stdin)e.push(t);return Buffer.concat(e).toString(`utf-8`)}async function nt(e){return e?A(l(e),`utf-8`):I()}function L(e){return e.split(`,`).map(e=>e.trim()).filter(Boolean)}function rt(e){let t=JSON.parse(e);if(Array.isArray(t))return{operations:R(t)};if(t&&typeof t==`object`&&`operations`in t){let e=t;return{operations:R(e.operations),concurrency:typeof e.concurrency==`number`?e.concurrency:void 0}}throw Error(`Batch input must be an array of operations or an object with an operations array.`)}function R(e){if(!Array.isArray(e))throw Error(`Batch operations must be an array.`);return e.map((e,t)=>{if(!e||typeof e!=`object`)throw Error(`Batch operation at index ${t} must be an object.`);let n=e;if(typeof n.id!=`string`||n.id.length===0)throw Error(`Batch operation at index ${t} is missing a valid id.`);if(typeof n.type!=`string`||n.type.length===0)throw Error(`Batch operation ${n.id} is missing a valid type.`);if(!n.args||typeof n.args!=`object`||Array.isArray(n.args))throw Error(`Batch operation ${n.id} must include an args object.`);return{id:n.id,type:n.type,args:n.args}})}function it(e){return e.map(e=>{let t=e.heading?` ${e.heading}`:``;return`${e.start}-${e.end}${t}`}).join(`, `)}function at(e){switch(e.tool){case`tsc`:case`biome`:console.log(`${e.tool} errors: ${e.errors.length}`);for(let t of e.errors){let e=[t.line,t.column].filter(e=>e!==void 0).join(`:`),n=e?`${t.file}:${e}`:t.file,r=t.code?` ${t.code}`:``;console.log(`- ${n} [${t.severity}${r}] ${t.message}`)}return;case`vitest`:console.log(`Vitest summary`),console.log(`  Passed:  ${e.summary.passed}`),console.log(`  Failed:  ${e.summary.failed}`),console.log(`  Skipped: ${e.summary.skipped}`),e.summary.duration!==void 0&&console.log(`  Duration: ${e.summary.duration}ms`);for(let t of e.summary.tests)t.status===`fail`&&(console.log(`- ${t.name}${t.file?` (${t.file})`:``}`),t.error&&console.log(`  ${t.error}`));return;case`git-status`:console.log(`Branch: ${e.status.branch??`unknown`}`),console.log(`Staged: ${e.status.staged.length}`);for(let t of e.status.staged)console.log(`  ${t.status} ${t.file}`);console.log(`Unstaged: ${e.status.unstaged.length}`);for(let t of e.status.unstaged)console.log(`  ${t.status} ${t.file}`);console.log(`Untracked: ${e.status.untracked.length}`);for(let t of e.status.untracked)console.log(`  ?? ${t}`);return}}function ot(e){console.log(`Overall: ${e.passed?`passed`:`failed`}`),z(`tsc`,e.tsc.passed,e.tsc.errors),z(`biome`,e.biome.passed,e.biome.errors)}function z(e,t,n){console.log(`${e}: ${t?`passed`:`${n.length} issue(s)`}`);for(let e of n){let t=[e.line,e.column].filter(e=>e!==void 0).join(`:`),n=t?`${e.file}:${t}`:e.file,r=e.code?` ${e.code}`:``;console.log(`  - ${n} [${e.severity}${r}] ${e.message}`)}}function st(e){console.log(`Vitest: ${e.passed?`passed`:`failed`}`),console.log(`  Duration: ${e.durationMs}ms`),console.log(`  Passed: ${e.summary.passed}`),console.log(`  Failed: ${e.summary.failed}`),console.log(`  Skipped: ${e.summary.skipped}`),e.summary.suites!==void 0&&console.log(`  Suites: ${e.summary.suites}`);let t=e.summary.tests.filter(e=>e.status===`fail`);if(t.length!==0){console.log(`Failed tests:`);for(let e of t)console.log(`  - ${e.name}${e.file?` (${e.file})`:``}`),e.error&&console.log(`    ${e.error}`)}}function ct(e){console.log(`Branch: ${e.branch}`),console.log(`Staged: ${e.status.staged.length}`);for(let t of e.status.staged)console.log(`  - ${t}`);console.log(`Modified: ${e.status.modified.length}`);for(let t of e.status.modified)console.log(`  - ${t}`);console.log(`Untracked: ${e.status.untracked.length}`);for(let t of e.status.untracked)console.log(`  - ${t}`);if(console.log(``),console.log(`Recent commits:`),e.recentCommits.length===0)console.log(`  none`);else for(let t of e.recentCommits)console.log(`  - ${t.hash} ${t.message}`),console.log(`    ${t.author} @ ${t.date}`);e.diff&&(console.log(``),console.log(`Diff stat:`),console.log(e.diff))}function lt(e){if(e.length===0){console.log(`No diff files found.`);return}for(let t of e){let e=t.oldPath?` (from ${t.oldPath})`:``;console.log(`${t.path}${e}`),console.log(`  Status: ${t.status}`),console.log(`  Changes: +${t.additions} -${t.deletions}`),console.log(`  Hunks: ${t.hunks.length}`);for(let e of t.hunks){let t=e.header?` ${e.header}`:``;console.log(`    @@ -${e.oldStart},${e.oldLines} +${e.newStart},${e.newLines} @@${t}`)}}}function ut(e){if(console.log(`Start: ${e.start}`),console.log(`Direction: ${e.direction}`),console.log(`Depth reached: ${e.depth}`),console.log(`Nodes: ${e.nodes.length}`),e.nodes.length===0){console.log(`No trace nodes found.`);return}for(let t of e.nodes)console.log(`  - [${t.relationship}] ${t.path}:${t.line} ${t.symbol}`)}function dt(e){if(console.log(`Query: ${e.query}`),console.log(`Examples: ${e.examples.length} shown (${e.totalFound} total)`),e.examples.length===0){console.log(`No matching examples found.`);return}for(let t of e.examples){console.log(``),console.log(`${t.path}:${t.startLine}-${t.endLine}`),console.log(`  Context: ${t.context}`),console.log(`  Relevance: ${(t.relevance*100).toFixed(1)}%`);for(let e of t.content.split(`
+`))console.log(`  ${e}`)}}function B(e){console.log(e.id),console.log(`  Command: ${e.command}${e.args.length>0?` ${e.args.join(` `)}`:``}`),console.log(`  PID: ${e.pid??`unknown`}`),console.log(`  Status: ${e.status}`),console.log(`  Started: ${e.startedAt}`),e.exitCode!==void 0&&console.log(`  Exit code: ${e.exitCode}`),console.log(`  Logs: ${e.logs.length}`)}function ft(e){if(console.log(`Exports scanned: ${e.totalExports}`),console.log(`Dead in source: ${e.totalDeadSource} (actionable)`),console.log(`Dead in docs: ${e.totalDeadDocs} (informational)`),e.totalDeadSource===0&&e.totalDeadDocs===0){console.log(`No dead symbols found.`);return}if(e.deadInSource.length>0){console.log(`
+Dead in source (actionable):`);for(let t of e.deadInSource)console.log(`  - ${t.path}:${t.line} ${t.kind} ${t.name}`)}if(e.deadInDocs.length>0){console.log(`
+Dead in docs (informational):`);for(let t of e.deadInDocs)console.log(`  - ${t.path}:${t.line} ${t.kind} ${t.name}`)}}function pt(e){console.log(e.path),console.log(`  Language: ${e.language}`),console.log(`  Lines: ${e.lines}`),console.log(`  Estimated tokens: ~${e.estimatedTokens}`),console.log(``),U(`Imports`,e.imports),U(`Exports`,e.exports),U(`Functions`,e.functions.map(e=>`${e.name} @ line ${e.line}${e.exported?` [exported]`:``}`)),U(`Classes`,e.classes.map(e=>`${e.name} @ line ${e.line}${e.exported?` [exported]`:``}`)),U(`Interfaces`,e.interfaces.map(e=>`${e.name} @ line ${e.line}`)),U(`Types`,e.types.map(e=>`${e.name} @ line ${e.line}`))}function mt(e){if(console.log(`Symbol: ${e.name}`),e.definedIn?console.log(`Defined in: ${e.definedIn.path}:${e.definedIn.line} (${e.definedIn.kind})`):console.log(`Defined in: not found`),console.log(``),console.log(`Imported by:`),e.importedBy.length===0)console.log(`  none`);else for(let t of e.importedBy)console.log(`  - ${t.path}:${t.line} ${t.importStatement}`);if(console.log(``),console.log(`Referenced in:`),e.referencedIn.length===0)console.log(`  none`);else for(let t of e.referencedIn)console.log(`  - ${t.path}:${t.line} ${t.context}`)}function V(e){console.log(e.name),console.log(`  Files: ${e.files.length}`),console.log(`  Updated: ${e.updated}`),e.description&&console.log(`  Description: ${e.description}`);for(let t of e.files)console.log(`  - ${t}`)}function H(e){if(console.log(e.id),console.log(`  Label: ${e.label}`),console.log(`  Created: ${e.createdAt}`),e.notes&&console.log(`  Notes: ${e.notes}`),e.files?.length){console.log(`  Files: ${e.files.length}`);for(let t of e.files)console.log(`  - ${t}`)}console.log(`  Data:`);for(let t of JSON.stringify(e.data,null,2).split(`
+`))console.log(`    ${t}`)}function U(e,t){if(console.log(`${e}:`),t.length===0){console.log(`  none`),console.log(``);return}for(let e of t)console.log(`  - ${e}`);console.log(``)}function ht(e){let t=e.trim();if(!t)return``;try{return JSON.parse(t)}catch{return e}}function gt(e){let t=e.trim();if(!t)return{};let n=JSON.parse(t);if(!n||typeof n!=`object`||Array.isArray(n))throw Error(`Checkpoint data must be a JSON object.`);return n}function W(e,t,n=60){let r=new Map;for(let t=0;t<e.length;t++){let i=e[t];r.set(i.record.id,{record:i.record,score:1/(n+t+1)})}for(let e=0;e<t.length;e++){let i=t[e],a=r.get(i.record.id);a?a.score+=1/(n+e+1):r.set(i.record.id,{record:i.record,score:1/(n+e+1)})}return[...r.values()].sort((e,t)=>t.score-e.score)}async function _t(e,t){switch(e.type){case`search`:{if(!t)throw Error(`search operation requires AI Kit context`);let n=typeof e.args.query==`string`?e.args.query.trim():``;if(!n)throw Error(`search operation requires a query`);let r=typeof e.args.limit==`number`?e.args.limit:5,i=e.args.search_mode===`semantic`||e.args.search_mode===`keyword`?e.args.search_mode:`hybrid`,a=typeof e.args.content_type==`string`?e.args.content_type:void 0,o=typeof e.args.min_score==`number`?e.args.min_score:.25;if(i===`keyword`)return(await t.store.ftsSearch(n,{limit:r,contentType:a,minScore:o})).slice(0,r);let s=await t.embedder.embedQuery(n);if(i===`semantic`)return t.store.search(s,{limit:r,contentType:a,minScore:o});let[c,l]=await Promise.all([t.store.search(s,{limit:r*2,contentType:a,minScore:o}),t.store.ftsSearch(n,{limit:r*2,contentType:a,minScore:o}).catch(()=>[])]);return W(c,l).slice(0,r)}case`find`:{if(!t)throw Error(`find operation requires AI Kit context`);let n=typeof e.args.query==`string`?e.args.query:void 0,r=typeof e.args.glob==`string`?e.args.glob:void 0,i=typeof e.args.pattern==`string`?e.args.pattern:void 0,a=typeof e.args.limit==`number`?e.args.limit:10,o=typeof e.args.content_type==`string`?e.args.content_type:void 0,s=typeof e.args.cwd==`string`?e.args.cwd:void 0;if(!n&&!r&&!i)throw Error(`find operation requires query, glob, or pattern`);return g(t.embedder,t.store,{query:n,glob:r,pattern:i,limit:a,contentType:o,cwd:s})}case`check`:return m({files:Array.isArray(e.args.files)?e.args.files.filter(e=>typeof e==`string`):void 0,cwd:typeof e.args.cwd==`string`?e.args.cwd:void 0,skipTypes:e.args.skip_types===!0,skipLint:e.args.skip_lint===!0});default:throw Error(`Unsupported batch operation type: ${e.type}`)}}const vt=[{name:`parse-output`,description:`Parse build or tool output from stdin`,usage:`aikit parse-output [--tool tsc|vitest|biome|git-status]`,run:async e=>{let t=P(e,`--tool`,``).trim()||void 0,n=await I();n.trim()||(console.error(`Usage: aikit parse-output [--tool tsc|vitest|biome|git-status]`),process.exit(1)),at(v(n,t))}},{name:`git`,description:`Show git branch, status, recent commits, and optional diff stats`,usage:`aikit git [--cwd path] [--commit-count N] [--diff]`,run:async e=>{ct(await he({cwd:P(e,`--cwd`,``).trim()||void 0,commitCount:N(e,`--commit-count`,5),includeDiff:F(e,`--diff`)}))}},{name:`diff`,description:`Parse unified diff text from stdin into structured file changes`,usage:`git diff | aikit diff`,run:async()=>{let e=await I();e.trim()||(console.error(`Usage: git diff | aikit diff`),process.exit(1)),lt(le({diff:e}))}},{name:`summarize`,description:`Show a structural summary of a file`,usage:`aikit summarize <path>`,run:async e=>{let t=e.shift()?.trim();t||(console.error(`Usage: aikit summarize <path>`),process.exit(1)),pt(await de({path:l(t)}))}},{name:`checkpoint`,description:`Save and restore lightweight session checkpoints`,usage:`aikit 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: aikit checkpoint <save|load|list|latest> [label-or-id] [--data json] [--notes text]`),process.exit(1)),t){case`save`:{let t=e.shift()?.trim(),n=P(e,`--data`,``),r=P(e,`--notes`,``).trim()||void 0,i=n.trim()?``:await I();t||(console.error(`Usage: aikit checkpoint save <label> [--data json] [--notes text]`),process.exit(1)),H(ne(t,gt(n||i),{notes:r}));return}case`load`:{let t=e.shift()?.trim();t||(console.error(`Usage: aikit checkpoint load <id>`),process.exit(1));let n=te(t);if(!n){console.log(`No checkpoint found: ${t}`);return}H(n);return}case`list`:{let e=ee();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=h();if(!e){console.log(`No checkpoints saved.`);return}H(e);return}default:console.error(`Unknown checkpoint action: ${t}`),console.error(`Actions: save, load, list, latest`),process.exit(1)}}}],yt=[{name:`proc`,description:`Manage in-memory child processes`,usage:`aikit proc <start|stop|status|list|logs> ...`,run:async e=>{let t=e.shift()?.trim()??``;switch(t){case`start`:{let t=e.shift()?.trim(),n=e.shift()?.trim();(!t||!n)&&(console.error(`Usage: aikit proc start <id> <command> [args...]`),process.exit(1)),B(x(t,n,e));return}case`stop`:{let t=e.shift()?.trim();t||(console.error(`Usage: aikit proc stop <id>`),process.exit(1));let n=C(t);if(!n){console.log(`No managed process found: ${t}`);return}B(n);return}case`status`:{let t=e.shift()?.trim();t||(console.error(`Usage: aikit proc status <id>`),process.exit(1));let n=S(t);if(!n){console.log(`No managed process found: ${t}`);return}B(n);return}case`list`:{let e=y();if(e.length===0){console.log(`No managed processes.`);return}for(let t of e)B(t),console.log(``);return}case`logs`:{let t=N(e,`--tail`,50),n=e.shift()?.trim();n||(console.error(`Usage: aikit proc logs <id> [--tail N]`),process.exit(1));let r=b(n,t);if(r.length===0){console.log(`No logs found for process: ${n}`);return}for(let e of r)console.log(e);return}default:console.error(`Unknown proc action: ${t}`),console.error(`Actions: start, stop, status, list, logs`),process.exit(1)}}},{name:`watch`,description:`Manage in-memory filesystem watchers`,usage:`aikit 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: aikit watch start <path>`),process.exit(1));let n=We({path:l(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: aikit watch stop <id>`),process.exit(1));let n=Ge(t);console.log(n?`Stopped watcher: ${t}`:`Watcher not found: ${t}`);return}case`list`:{let e=Ue();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:`aikit delegate [--model name] [--system prompt] [--temp 0.3] <prompt | --stdin>`,run:async e=>{if((e[0]===`models`?e.shift():void 0)===`models`){try{let e=await se();if(e.length===0){console.log(`No Ollama models available. Pull one with: ollama pull gemma4:e2b`);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 t=P(e,`--model`,``),n=P(e,`--system`,``),r=N(e,`--temp`,.3),i=P(e,`--context`,``),a=e.join(` `);a||=await I(),a||(console.error(`Usage: aikit delegate [--model name] <prompt>`),process.exit(1));let o;i&&(o=await A(l(i),`utf-8`));let s=await oe({prompt:a,model:t||void 0,system:n||void 0,context:o,temperature:r});s.error&&(console.error(`Error: ${s.error}`),process.exit(1)),console.log(s.response),console.error(`\n(${s.model}, ${s.durationMs}ms, ${s.tokenCount??`?`} tokens)`)}}],bt=[{name:`eval`,description:`Evaluate JavaScript or TypeScript in a constrained VM sandbox`,usage:`aikit eval [code] [--lang js|ts] [--timeout ms]`,run:async e=>{let t=P(e,`--lang`,`js`),n=N(e,`--timeout`,5e3),r=e.join(` `),i=r.trim()?``:await I(),a=r||i;a.trim()||(console.error(`Usage: aikit eval [code] [--lang js|ts] [--timeout ms]`),process.exit(1));let o=ue({code:a,lang:t===`ts`?`ts`:`js`,timeout:n});if(!o.success){console.error(`Eval failed in ${o.durationMs}ms: ${o.error}`),process.exitCode=1;return}console.log(`Eval succeeded in ${o.durationMs}ms`),console.log(`─`.repeat(60)),console.log(o.output)}},{name:`test`,description:`Run Vitest for all tests or a specific subset`,usage:`aikit test [files...] [--grep pattern] [--cwd path] [--timeout ms]`,run:async e=>{let t=P(e,`--grep`,``).trim()||void 0,n=P(e,`--cwd`,``).trim()||void 0,r=N(e,`--timeout`,6e4),i=e.filter(Boolean),a=await Ve({files:i.length>0?i:void 0,grep:t,cwd:n,timeout:r});st(a),a.passed||(process.exitCode=1)}},{name:`rename`,description:`Rename a symbol across files using whole-word regex matching`,usage:`aikit rename <old> <new> <path> [--dry-run] [--extensions .ts,.tsx] [--exclude dist/**]`,run:async e=>{let t=e.shift()?.trim()??``,n=e.shift()?.trim()??``,r=e.shift()?.trim()??``;(!t||!n||!r)&&(console.error(`Usage: aikit rename <old> <new> <path> [--dry-run] [--extensions .ts,.tsx] [--exclude dist/**]`),process.exit(1));let i=L(P(e,`--extensions`,``)),a=L(P(e,`--exclude`,``)),o=await ke({oldName:t,newName:n,rootPath:l(r),extensions:i.length>0?i:void 0,exclude:a.length>0?a:void 0,dryRun:F(e,`--dry-run`)});console.log(JSON.stringify(o,null,2))}},{name:`codemod`,description:`Apply regex-based codemod rules from a JSON file across a path`,usage:`aikit codemod <path> --rules <file.json> [--dry-run] [--extensions .ts,.tsx] [--exclude dist/**]`,run:async e=>{let t=e.shift()?.trim()??``,n=P(e,`--rules`,``).trim();(!t||!n)&&(console.error(`Usage: aikit codemod <path> --rules <file.json> [--dry-run] [--extensions .ts,.tsx] [--exclude dist/**]`),process.exit(1));let r=await A(l(n),`utf-8`),i;try{i=JSON.parse(r)}catch{throw Error(`Failed to parse rules file as JSON: ${n}`)}if(!Array.isArray(i))throw Error(`Codemod rules file must contain a JSON array.`);let a=L(P(e,`--extensions`,``)),o=L(P(e,`--exclude`,``)),s=await re({rootPath:l(t),rules:i,extensions:a.length>0?a:void 0,exclude:o.length>0?o:void 0,dryRun:F(e,`--dry-run`)});console.log(JSON.stringify(s,null,2))}},{name:`transform`,description:`Apply jq-like transforms to JSON from stdin`,usage:`cat data.json | aikit transform <expression>`,run:async e=>{let t=e.join(` `).trim(),n=await I();(!t||!n.trim())&&(console.error(`Usage: cat data.json | aikit transform <expression>`),process.exit(1));let r=ae({input:n,expression:t});console.log(r.outputString)}}];function G(){let e=process.env.AIKIT_CONFIG_PATH??(r(l(process.cwd(),`aikit.config.json`))?l(process.cwd(),`aikit.config.json`):null);if(!e)return xt();let t=a(e,`utf-8`),n;try{n=JSON.parse(t)}catch{console.error(`Failed to parse ${e} as JSON. Ensure the file contains valid JSON.`),process.exit(1)}let i=s(e);return n.sources=n.sources.map(e=>({...e,path:l(i,e.path)})),n.store.path=l(i,n.store.path),n.curated=n.curated??{path:`curated`},n.curated.path=l(i,n.curated.path),K(n,i),n}function xt(){let e=process.env.AIKIT_WORKSPACE_ROOT??process.cwd(),t={sources:[{path:e,excludePatterns:[`node_modules/**`,`dist/**`,`.git/**`,`coverage/**`,`*.lock`,`pnpm-lock.yaml`]}],serverName:`aikit`,indexing:{chunkSize:1500,chunkOverlap:200,minChunkSize:100},embedding:{model:`mixedbread-ai/mxbai-embed-large-v1`,dimensions:1024},store:{backend:`lancedb`,path:l(e,j.data)},curated:{path:l(e,j.aiCurated)},stateDir:l(e,j.state)};return K(t,e),t}function K(e,t){if(!qe())return;let n=Je(t);e.store.path=l(M(n.partition)),e.stateDir=l(M(n.partition),`state`),e.curated||={path:l(t,j.aiCurated)}}async function St(){let e=G(),t=new Xe({model:e.embedding.model,dimensions:e.embedding.dimensions});await t.initialize();let n=await $e({backend:e.store.backend,path:e.store.path});await n.initialize();let r=new Ze(t,n),{CuratedKnowledgeManager:i}=await import(`../../server/dist/index.js`),a=new i(e.curated.path,n,t),o;try{let t=new Qe({path:e.store.path});await t.initialize(),o=t,r.setGraphStore(o)}catch(e){console.error(`[aikit] Graph store init failed (non-fatal): ${e.message}`),o={initialize:async()=>{},upsertNode:async()=>{},upsertEdge:async()=>{},upsertNodes:async()=>{},upsertEdges:async()=>{},getNode:async()=>null,getNeighbors:async()=>({nodes:[],edges:[]}),traverse:async()=>({nodes:[],edges:[]}),findNodes:async()=>[],findEdges:async()=>[],deleteNode:async()=>{},deleteBySourcePath:async()=>0,clear:async()=>{},getStats:async()=>({nodeCount:0,edgeCount:0,nodeTypes:{},edgeTypes:{}}),validate:async()=>({valid:!0,orphanNodes:[],danglingEdges:[],stats:{nodeCount:0,edgeCount:0,nodeTypes:{},edgeTypes:{}}}),setNodeCommunity:async()=>{},detectCommunities:async()=>({}),traceProcess:async()=>({id:``,entryNodeId:``,label:``,properties:{},steps:[]}),getProcesses:async()=>[],deleteProcess:async()=>{},depthGroupedTraversal:async()=>({}),getCohesionScore:async()=>0,getSymbol360:async()=>({node:{id:``,type:``,name:``,properties:{}},incoming:[],outgoing:[],community:null,processes:[]}),close:async()=>{}}}return await Ye().catch(()=>{}),{config:e,embedder:t,store:n,graphStore:o,indexer:r,curated:a}}async function Ct(){let e=await import(`../../flows/dist/index.js`),{FlowLoader:t,FlowRegistryManager:n,FlowStateMachine:a,GitInstaller:o}=e,s=typeof e.getBuiltinFlows==`function`?e.getBuiltinFlows:void 0,l=G(),u=c(l.stateDir??c(l.sources[0].path,`.aikit-state`),`flows`),d=c(Ke(),`flows`);i(d,{recursive:!0});let f=c(d,`registry.json`),p=c(u,`state.json`);r(u)||i(u,{recursive:!0});let m=l.sources[0].path;return{loader:new t,registry:new n(f),stateMachine:new a(p),git:new o(c(u,`installed`)),getBuiltinFlows:s,cwd:m}}const q=[e=>c(`skills`,e,`SKILL.md`),e=>c(`skills`,e,`README.md`),e=>c(e,`SKILL.md`),e=>c(e,`README.md`)];function wt(e,t){for(let a of t.steps){let t=c(e,a.instruction);if(r(t))continue;let o=!1;for(let l of q){let u=c(e,l(a.id));if(r(u)){let e=s(t);r(e)||i(e,{recursive:!0}),n(u,t),o=!0;break}}o||console.warn(`Warning: instruction file for step "${a.id}" not found.\n  Expected: ${a.instruction}\n  Searched: ${q.map(e=>e(a.id)).join(`, `)}`)}}const J=[{name:`flow`,description:`Manage pluggable development flows`,usage:`flow <add|remove|list|info|use|update|status|start|reset> [args]`,run:async e=>{let t=e[0];if(!t){console.log(`Usage: aikit flow <add|remove|list|info|use|update|status|start|reset>`),console.log(``),console.log(`Commands:`),console.log(`  add <source>     Install a flow from git URL or local path`),console.log(`  remove <name>    Remove an installed flow`),console.log(`  list             List all installed flows`),console.log(`  info <name>      Show details of a flow`),console.log(`  use <name>       Set active flow (start it)`),console.log(`  update <name>    Update a flow from its source`),console.log(`  status           Show current flow execution status`),console.log(`  start [name]     Start a flow (or resume)`),console.log(`  reset            Reset the active flow`);return}let n=await Ct();switch(t){case`add`:{let t=e[1];if(!t){console.error(`Usage: aikit flow add <source>`),console.error(`  source: git URL (https://...) or local path`);return}let i=t.startsWith(`http`)||t.startsWith(`git@`)||t.endsWith(`.git`),a=l(t),s=r(a);if(!i&&!s){console.error(`Source not found: ${t}`),console.error(`Provide a git URL or existing local path.`);return}let c,u;if(i){console.log(`Cloning ${t}...`);let e=n.git.clone(t);if(!e.success||!e.data){console.error(e.error??`Failed to clone flow`);return}c=e.data,u=`git`}else{let r=e[2]||o(a);console.log(`Copying local flow from ${t}...`);let i=n.git.copyLocal(a,r);if(!i.success||!i.data){console.error(i.error??`Failed to copy local flow`);return}c=i.data,u=`local`}let d=await n.loader.load(c);if(!d.success||!d.data){console.error(d.error??`Failed to load flow`),n.git.remove(c);return}let{manifest:f,format:p}=d.data;if(wt(c,f),f.install.length>0){console.log(`Installing ${f.install.length} dependencies...`);let e=n.git.runInstallDeps(f.install);if(!e.success){console.error(`Dependency install failed: ${e.error}`),n.git.remove(c);return}}let m=new Date().toISOString(),h=n.registry.register({name:f.name,version:f.version,source:t,sourceType:u,installPath:c,format:p,registeredAt:m,updatedAt:m,manifest:f});if(!h.success){console.error(h.error??`Failed to register flow`),n.git.remove(c);return}console.log(`✓ Flow "${f.name}" v${f.version} installed (${p} format)`),console.log(`  Steps: ${f.steps.map(e=>e.id).join(` → `)}`);break}case`remove`:{let t=e[1];if(!t){console.error(`Usage: aikit flow remove <name>`);return}let r=n.registry.get(t);if(!r){console.error(`Flow "${t}" not found`);return}let i=n.git.remove(r.installPath);if(!i.success){console.error(i.error??`Failed to remove flow files`);return}let a=n.registry.unregister(t);if(!a.success){console.error(a.error??`Failed to unregister flow`);return}console.log(`✓ Flow "${t}" removed`);break}case`list`:{let e=n.registry.list();if(e.length===0){console.log("No flows installed. Use `aikit flow add <source>` to install one.");return}console.log(`Installed Flows:`),console.log(`─`.repeat(60));for(let t of e){let e=t.manifest.steps.map(e=>e.id).join(` → `);console.log(`  ${t.name} v${t.version} (${t.sourceType}, ${t.format})`),console.log(`    Steps: ${e}`)}let t=n.stateMachine.getStatus();t.success&&t.data&&(console.log(``),console.log(`Active: ${t.data.flow} (${t.data.status}, step: ${t.data.currentStep??`done`})`));break}case`info`:{let t=e[1];if(!t){console.error(`Usage: aikit flow info <name>`);return}let r=n.registry.get(t);if(!r){console.error(`Flow "${t}" not found`);return}console.log(`Flow: ${r.name}`),console.log(`Version: ${r.version}`),console.log(`Source: ${r.source} (${r.sourceType})`),console.log(`Format: ${r.format}`),console.log(`Path: ${r.installPath}`),console.log(`Registered: ${r.registeredAt}`),console.log(`Updated: ${r.updatedAt}`),console.log(``),console.log(`Steps:`);for(let e of r.manifest.steps){let t=e.requires.length?` (requires: ${e.requires.join(`, `)})`:``;console.log(`  ${e.id}: ${e.name}${t}`),console.log(`    Skill: ${e.skill}`),console.log(`    Produces: ${e.produces.join(`, `)}`)}if(r.manifest.install.length>0){console.log(``),console.log(`Dependencies:`);for(let e of r.manifest.install)console.log(`  ${e}`)}break}case`use`:case`start`:{let r=e[1],i=r?n.registry.get(r):null;if(t===`use`&&!r){console.error(`Usage: aikit flow use <name>`);return}if(t===`start`&&!r){let e=n.stateMachine.getStatus();if(e.success&&e.data&&e.data.status===`active`){console.log(`Resuming flow: ${e.data.flow}`),console.log(`Current step: ${e.data.currentStep}`),console.log(`Completed: ${e.data.completedSteps.join(`, `)||`none`}`);return}console.error("No active flow. Use `aikit flow start <name>` to begin one.");return}if(!i){console.error(`Flow "${r}" not found. Use \`aikit flow list\` to see installed flows.`);return}let a=n.stateMachine.start(i.name,i.manifest);if(!a.success||!a.data){console.error(a.error??`Failed to start flow`);return}let o=a.data;console.log(`✓ Flow "${i.name}" started`),console.log(`  Current step: ${o.currentStep}`),console.log(`  Steps: ${i.manifest.steps.map(e=>e.id).join(` → `)}`);break}case`update`:{let t=e[1];if(!t){console.error(`Usage: aikit flow update <name>`);return}let r=n.registry.get(t);if(!r){console.error(`Flow "${t}" not found`);return}if(r.sourceType!==`git`){console.error(`Flow "${t}" is ${r.sourceType}, not updatable via git`);return}console.log(`Updating ${t}...`);let i=n.git.update(r.installPath);if(!i.success){console.error(i.error??`Failed to update flow`);return}let a=await n.loader.load(r.installPath);if(a.success&&a.data){let e=new Date().toISOString(),t=n.registry.register({...r,version:a.data.manifest.version,format:a.data.format,manifest:a.data.manifest,updatedAt:e});if(!t.success){console.error(t.error??`Failed to refresh flow registry entry`);return}}console.log(`✓ Flow "${t}" updated`);break}case`status`:{let e=n.stateMachine.getStatus();if(!e.success||!e.data){console.log(`No active flow.`);return}let t=e.data;if(console.log(`Flow: ${t.flow}`),console.log(`Status: ${t.status}`),console.log(`Current Step: ${t.currentStep??`(completed)`}`),console.log(`Completed: ${t.completedSteps.join(`, `)||`none`}`),t.skippedSteps.length>0&&console.log(`Skipped: ${t.skippedSteps.join(`, `)}`),console.log(`Started: ${t.startedAt}`),console.log(`Updated: ${t.updatedAt}`),Object.keys(t.artifacts).length>0){console.log(`Artifacts:`);for(let[e,n]of Object.entries(t.artifacts))console.log(`  ${e}: ${n}`)}break}case`reset`:{let e=n.stateMachine.reset();if(!e.success){console.error(e.error??`Failed to reset flow state`);return}console.log(`✓ Flow state reset`);break}default:console.error(`Unknown flow command: ${t}`),console.log("Use `aikit flow` for help.")}}}];let Y=null;async function X(){return Y||=await St(),Y}function Tt(){return Y}const Et=[{name:`graph`,description:`Query the knowledge graph`,usage:`aikit graph <action> [options]
+  Actions: stats, find-nodes, find-edges, neighbors, traverse, delete, clear
+  Options: --type, --name, --node-id, --edge-type, --direction, --depth, --limit, --source-path`,run:async e=>{let t=e.shift()?.trim()??``;t||(console.error(`Usage: aikit graph <action>
+Actions: stats, find-nodes, find-edges, neighbors, traverse, delete, clear`),process.exit(1));let{graphStore:n}=await X(),r=P(e,`--type`,``),i=P(e,`--name`,``),a=P(e,`--node-id`,``),o=P(e,`--edge-type`,``),s=P(e,`--direction`,`both`),c=N(e,`--depth`,2),l=N(e,`--limit`,50),u=P(e,`--source-path`,``),d={stats:`stats`,"find-nodes":`find_nodes`,"find-edges":`find_edges`,neighbors:`neighbors`,traverse:`traverse`,delete:`delete`,clear:`clear`}[t];d||(console.error(`Unknown graph action: ${t}`),console.error(`Actions: stats, find-nodes, find-edges, neighbors, traverse, delete, clear`),process.exit(1));let f=await ge(n,{action:d,nodeType:r||void 0,namePattern:i||void 0,sourcePath:u||void 0,nodeId:a||void 0,edgeType:o||void 0,direction:s,maxDepth:c,limit:l});if(console.log(f.summary),f.nodes&&f.nodes.length>0){console.log(`
+Nodes:`);for(let e of f.nodes){let t=Object.keys(e.properties).length>0?` ${JSON.stringify(e.properties)}`:``;console.log(`  ${e.name} (${e.type}, id: ${e.id})${t}`)}}if(f.edges&&f.edges.length>0){console.log(`
+Edges:`);for(let e of f.edges){let t=e.weight===1?``:` (weight: ${e.weight})`;console.log(`  ${e.fromId} --[${e.type}]--> ${e.toId}${t}`)}}f.stats&&(console.log(`\nNode types: ${JSON.stringify(f.stats.nodeTypes)}`),console.log(`Edge types: ${JSON.stringify(f.stats.edgeTypes)}`)),f.deleted!==void 0&&console.log(`Deleted: ${f.deleted}`)}}],Dt=[{name:`remember`,description:`Store curated knowledge`,usage:`aikit remember <title> --category <cat> [--tags tag1,tag2]`,run:async e=>{let t=P(e,`--category`,``).trim(),n=L(P(e,`--tags`,``)),r=e.shift()?.trim()??``,i=await I(),a=i.trim().length>0?i:e.join(` `).trim();(!r||!t||!a.trim())&&(console.error(`Usage: aikit remember <title> --category <cat> [--tags tag1,tag2]`),process.exit(1));let{curated:o}=await X(),s=await o.remember(r,a,t,n);console.log(`Stored curated entry`),console.log(`  Path: ${s.path}`),console.log(`  Category: ${t}`),n.length>0&&console.log(`  Tags: ${n.join(`, `)}`)}},{name:`forget`,description:`Remove a curated entry`,usage:`aikit forget <path> --reason <reason>`,run:async e=>{let t=P(e,`--reason`,``).trim(),n=e.shift()?.trim()??``;(!n||!t)&&(console.error(`Usage: aikit forget <path> --reason <reason>`),process.exit(1));let{curated:r}=await X(),i=await r.forget(n,t);console.log(`Removed curated entry: ${i.path}`)}},{name:`read`,description:`Read a curated entry`,usage:`aikit read <path>`,run:async e=>{let t=e.shift()?.trim()??``;t||(console.error(`Usage: aikit read <path>`),process.exit(1));let{curated:n}=await X(),r=await n.read(t);console.log(r.title),console.log(`─`.repeat(60)),console.log(`Path: ${r.path}`),console.log(`Category: ${r.category}`),console.log(`Version: ${r.version}`),console.log(`Tags: ${r.tags.length>0?r.tags.join(`, `):`None`}`),console.log(``),console.log(r.content)}},{name:`list`,description:`List curated entries`,usage:`aikit list [--category <cat>] [--tag <tag>]`,run:async e=>{let t=P(e,`--category`,``).trim()||void 0,n=P(e,`--tag`,``).trim()||void 0,{curated:r}=await X(),i=await r.list({category:t,tag:n});if(i.length===0){console.log(`No curated entries found.`);return}console.log(`Curated entries (${i.length})`),console.log(`─`.repeat(60));for(let e of i){console.log(e.path),console.log(`  ${e.title}`),console.log(`  Category: ${e.category} | Version: ${e.version}`),console.log(`  Tags: ${e.tags.length>0?e.tags.join(`, `):`None`}`);let t=e.contentPreview.replace(/\s+/g,` `).trim();t&&console.log(`  Preview: ${t}`),console.log(``)}}},{name:`update`,description:`Update a curated entry`,usage:`aikit update <path> --reason <reason>`,run:async e=>{let t=P(e,`--reason`,``).trim(),n=e.shift()?.trim()??``,r=await I();(!n||!t||!r.trim())&&(console.error(`Usage: aikit update <path> --reason <reason>`),process.exit(1));let{curated:i}=await X(),a=await i.update(n,r,t);console.log(`Updated curated entry`),console.log(`  Path: ${a.path}`),console.log(`  Version: ${a.version}`)}},{name:`compact`,description:`Compress text for context`,usage:`aikit compact <query> [--path <file>] [--max-chars N] [--segmentation paragraph|sentence|line]`,run:async e=>{let t=N(e,`--max-chars`,3e3),n=P(e,`--path`,``).trim()||void 0,r=P(e,`--segmentation`,`paragraph`),i=e.join(` `).trim(),a=n?void 0:await I();(!i||!n&&!a?.trim())&&(console.error(`Usage: aikit compact <query> --path <file>  OR  cat file | aikit compact <query>`),process.exit(1));let{embedder:o}=await X(),s=await ie(o,{text:a,path:n,query:i,maxChars:t,segmentation:r});console.log(`Compressed ${s.originalChars} chars to ${s.compressedChars} chars`),console.log(`Ratio: ${(s.ratio*100).toFixed(1)}% | Segments: ${s.segmentsKept}/${s.segmentsTotal}`),console.log(``),console.log(s.text)}}],Ot=[{name:`search`,description:`Search the AI Kit index`,usage:`aikit search <query> [--limit N] [--mode hybrid|semantic|keyword] [--graph-hops 0-3]`,run:async e=>{let t=N(e,`--limit`,5),n=P(e,`--mode`,`hybrid`),r=N(e,`--graph-hops`,0),i=e.join(` `).trim();i||(console.error(`Usage: aikit search <query>`),process.exit(1));let{embedder:a,store:o,graphStore:s}=await X(),c=await a.embedQuery(i),l;if(n===`keyword`)l=await o.ftsSearch(i,{limit:t});else if(n===`semantic`)l=await o.search(c,{limit:t});else{let[e,n]=await Promise.all([o.search(c,{limit:t*2}),o.ftsSearch(i,{limit:t*2}).catch(()=>[])]);l=W(e,n).slice(0,t)}if(l.length===0){console.log(`No results found.`);return}for(let{record:e,score:t}of l){console.log(`\n${`─`.repeat(60)}`),console.log(`[${(t*100).toFixed(1)}%] ${e.sourcePath}:${e.startLine}-${e.endLine}`),console.log(`  Type: ${e.contentType} | Origin: ${e.origin}`),e.tags.length>0&&console.log(`  Tags: ${e.tags.join(`, `)}`),console.log(``);let n=e.content.length>500?`${e.content.slice(0,500)}...`:e.content;console.log(n)}if(console.log(`\n${`─`.repeat(60)}`),console.log(`${l.length} result(s) found.`),r>0&&l.length>0)try{let{graphAugmentSearch:e}=await import(`../../tools/dist/index.js`),t=(await e(s,l.map(e=>({recordId:e.record.id,score:e.score,sourcePath:e.record.sourcePath})),{hops:r,maxPerHit:5})).filter(e=>e.graphContext.nodes.length>0);if(t.length>0){console.log(`\nGraph context (${r} hop${r>1?`s`:``}):\n`);for(let e of t){console.log(`  ${e.sourcePath}:`);for(let t of e.graphContext.nodes.slice(0,5))console.log(`    → ${t.name} (${t.type})`);for(let t of e.graphContext.edges.slice(0,5))console.log(`    → ${t.fromId} --[${t.type}]--> ${t.toId}`)}}}catch(e){console.error(`[graph] augmentation failed: ${e.message}`)}}},{name:`find`,description:`Run federated search across indexed content and files`,usage:`aikit find [query] [--glob <pattern>] [--pattern <regex>] [--limit N]`,run:async e=>{let t=N(e,`--limit`,10),n=P(e,`--glob`,``).trim()||void 0,r=P(e,`--pattern`,``).trim()||void 0,i=e.join(` `).trim()||void 0;!i&&!n&&!r&&(console.error(`Usage: aikit find [query] [--glob <pattern>] [--pattern <regex>] [--limit N]`),process.exit(1));let{embedder:a,store:o}=await X(),s=await g(a,o,{query:i,glob:n,pattern:r,limit:t});if(s.results.length===0){console.log(`No matches found.`);return}console.log(`Strategies: ${s.strategies.join(`, `)}`),console.log(`Results: ${s.results.length} shown (${s.totalFound} total)`);for(let e of s.results){let t=e.lineRange?`:${e.lineRange.start}-${e.lineRange.end}`:``;console.log(`\n[${e.source}] ${e.path}${t}`),console.log(`  Score: ${(e.score*100).toFixed(1)}%`),e.preview&&console.log(`  ${e.preview.replace(/\s+/g,` `).trim()}`)}}},{name:`scope-map`,description:`Generate a reading plan for a task`,usage:`aikit scope-map <task> [--max-files N]`,run:async e=>{let t=N(e,`--max-files`,15),n=e.join(` `).trim();n||(console.error(`Usage: aikit scope-map <task> [--max-files N]`),process.exit(1));let{embedder:r,store:i}=await X(),a=await Pe(r,i,{task:n,maxFiles:t});console.log(`Task: ${a.task}`),console.log(`Files: ${a.files.length}`),console.log(`Estimated tokens: ${a.totalEstimatedTokens}`),console.log(``),console.log(`Reading order:`);for(let e of a.readingOrder)console.log(`  ${e}`);for(let[e,t]of a.files.entries())console.log(`\n${e+1}. ${t.path}`),console.log(`   Relevance: ${(t.relevance*100).toFixed(1)}% | Tokens: ${t.estimatedTokens}`),console.log(`   Why: ${t.reason}`),t.focusRanges.length>0&&console.log(`   Focus: ${it(t.focusRanges)}`)}},{name:`symbol`,description:`Resolve a symbol definition, imports, and references`,usage:`aikit symbol <name> [--limit N]`,run:async e=>{let t=N(e,`--limit`,20),n=e.join(` `).trim();n||(console.error(`Usage: aikit symbol <name> [--limit N]`),process.exit(1));let{embedder:r,store:i}=await X();mt(await Be(r,i,{name:n,limit:t}))}},{name:`trace`,description:`Trace forward/backward flow for a symbol or file location`,usage:`aikit trace <start> [--direction forward|backward|both] [--max-depth N]`,run:async e=>{let t=P(e,`--direction`,`both`).trim()||`both`,n=N(e,`--max-depth`,3),r=e.join(` `).trim();(!r||![`forward`,`backward`,`both`].includes(t))&&(console.error(`Usage: aikit trace <start> [--direction forward|backward|both] [--max-depth N]`),process.exit(1));let{embedder:i,store:a}=await X();ut(await He(i,a,{start:r,direction:t,maxDepth:n}))}},{name:`examples`,description:`Find real code examples of a symbol or pattern`,usage:`aikit examples <query> [--limit N] [--content-type type]`,run:async e=>{let t=N(e,`--limit`,5),n=P(e,`--content-type`,``).trim()||void 0,r=e.join(` `).trim();r||(console.error(`Usage: aikit examples <query> [--limit N] [--content-type type]`),process.exit(1));let{embedder:i,store:a}=await X();dt(await pe(i,a,{query:r,limit:t,contentType:n}))}},{name:`dead-symbols`,description:`Find exported symbols that appear to be unused`,usage:`aikit dead-symbols [--limit N]`,run:async e=>{let t=N(e,`--limit`,100),{embedder:n,store:r}=await X();ft(await fe(n,r,{limit:t}))}},{name:`lookup`,description:`Look up indexed content by record ID or source path`,usage:`aikit lookup <id>`,run:async e=>{let t=e.join(` `).trim();t||(console.error(`Usage: aikit lookup <id>`),process.exit(1));let{store:n}=await X(),r=await n.getById(t);if(r){console.log(r.id),console.log(`─`.repeat(60)),console.log(`Path: ${r.sourcePath}`),console.log(`Chunk: ${r.chunkIndex+1}/${r.totalChunks}`),console.log(`Lines: ${r.startLine}-${r.endLine}`),console.log(`Type: ${r.contentType} | Origin: ${r.origin}`),r.tags.length>0&&console.log(`Tags: ${r.tags.join(`, `)}`),console.log(``),console.log(r.content);return}let i=await n.getBySourcePath(t);if(i.length===0){console.log(`No indexed content found for: ${t}`);return}i.sort((e,t)=>e.chunkIndex-t.chunkIndex),console.log(t),console.log(`─`.repeat(60)),console.log(`Chunks: ${i.length} | Type: ${i[0].contentType}`);for(let e of i){let t=e.startLine?` (lines ${e.startLine}-${e.endLine})`:``;console.log(`\nChunk ${e.chunkIndex+1}/${e.totalChunks}${t}`),console.log(e.content)}}}],Z=s(u(import.meta.url)),kt=[{name:`status`,description:`Show AI Kit index status and statistics`,run:async()=>{let{isUserInstalled:e,getGlobalDataDir:t,computePartitionKey:n,listWorkspaces:r}=await import(`../../core/dist/index.js`),{existsSync:i}=await import(`node:fs`),a=process.cwd(),o=e(),s=i(l(a,`.vscode`,`mcp.json`)),c,u;if(o&&s)c=`workspace (overrides user-level for this workspace)`,u=l(a,`.aikit-data`);else if(o){let e=n(a);c=i(l(a,`AGENTS.md`))?`user (workspace scaffolded)`:`user (workspace not scaffolded)`,u=l(t(),e)}else c=`workspace`,u=l(a,`.aikit-data`);if(console.log(`AI Kit Status`),console.log(`─`.repeat(40)),console.log(`  Mode:     ${c}`),console.log(`  Data:     ${u}`),o&&!s){let e=r();console.log(`  Registry: ${e.length} workspace(s) enrolled`)}try{let{store:e}=await X(),t=await e.getStats(),n=await e.listSourcePaths();console.log(`  Records:  ${t.totalRecords}`),console.log(`  Files:    ${t.totalFiles}`),console.log(`  Indexed:  ${t.lastIndexedAt??`Never`}`),console.log(`  Backend:  ${t.storeBackend}`),console.log(`  Model:    ${t.embeddingModel}`),console.log(``),console.log(`Content Types:`);for(let[e,n]of Object.entries(t.contentTypeBreakdown))console.log(`  ${e}: ${n}`);if(n.length>0){console.log(``),console.log(`Files (${n.length} total):`);for(let e of n.slice(0,20))console.log(`  ${e}`);n.length>20&&console.log(`  ... and ${n.length-20} more`)}}catch{console.log(``),console.log("  Index not available — run `aikit reindex` to index this workspace.")}o&&!s&&!i(l(a,`AGENTS.md`))&&(console.log(``),console.log("  Action: Run `npx @vpxa/aikit init` to add AGENTS.md and copilot-instructions.md"))}},{name:`reindex`,description:`Re-index the AI Kit index from configured sources`,usage:`aikit reindex [--full]`,run:async e=>{let t=e.includes(`--full`),{store:n,indexer:r,curated:i,config:a}=await X();console.log(`Indexing sources...`);let o=e=>{e.phase===`chunking`&&e.currentFile&&process.stdout.write(`\r  [${e.filesProcessed+1}/${e.filesTotal}] ${e.currentFile}`),e.phase===`done`&&process.stdout.write(`
+`)},s;t?(console.log(`Dropping existing index for full reindex...`),s=await r.reindexAll(a,o)):s=await r.index(a,o),console.log(`Done: ${s.filesProcessed} files, ${s.chunksCreated} chunks in ${(s.durationMs/1e3).toFixed(1)}s`),console.log(`Building FTS index...`),await n.createFtsIndex(),console.log(`Re-indexing curated entries...`);let c=await i.reindexAll();console.log(`Curated: ${c.indexed} entries restored`)}},{name:`serve`,description:`Start the MCP server (stdio or HTTP)`,usage:`aikit serve [--transport stdio|http] [--port N]`,run:async e=>{let t=l(Z,`..`,`..`,`..`,`server`,`dist`,`index.js`),n=P(e,`--transport`,`stdio`),r=P(e,`--port`,`3210`),i=et(t,[],{stdio:n===`stdio`?[`pipe`,`pipe`,`inherit`,`ipc`]:`inherit`,env:{...process.env,AIKIT_TRANSPORT:n,AIKIT_PORT:r}});n===`stdio`&&i.stdin&&i.stdout&&(process.stdin.pipe(i.stdin),i.stdout.pipe(process.stdout)),i.on(`exit`,e=>process.exit(e??0)),process.on(`SIGINT`,()=>i.kill(`SIGINT`)),process.on(`SIGTERM`,()=>i.kill(`SIGTERM`)),await new Promise(()=>{})}},{name:`init`,description:`Initialize AI Kit in the current directory`,usage:`aikit init [--user|--workspace] [--force] [--guide]`,run:async e=>{let t=e.includes(`--user`),n=e.includes(`--workspace`),r=e.includes(`--guide`),i=e.includes(`--force`);if(t&&n&&(console.error(`Cannot use --user and --workspace together.`),process.exit(1)),r){let{guideProject:e}=await import(`./init-D0CiV9PX.js`);await e();return}if(t){let{initUser:e}=await import(`./user-HmJYNt5b.js`);await e({force:i})}else if(n){let{initProject:e}=await import(`./init-D0CiV9PX.js`);await e({force:i})}else{let{initSmart:e}=await import(`./init-D0CiV9PX.js`);await e({force:i})}}},{name:`check`,description:`Run incremental typecheck and lint`,usage:`aikit check [--cwd <dir>] [--files f1,f2] [--skip-types] [--skip-lint] [--detail summary|errors|full]`,run:async e=>{let t=P(e,`--cwd`,``).trim()||void 0,n=P(e,`--files`,``),r=P(e,`--detail`,`full`)||`full`,i=n.split(`,`).map(e=>e.trim()).filter(Boolean),a=!1;e.includes(`--skip-types`)&&(e.splice(e.indexOf(`--skip-types`),1),a=!0);let o=!1;e.includes(`--skip-lint`)&&(e.splice(e.indexOf(`--skip-lint`),1),o=!0);let s=await m({cwd:t,files:i.length>0?i:void 0,skipTypes:a,skipLint:o,detail:r});ot(s),s.passed||(process.exitCode=1)}},{name:`batch`,description:`Execute built-in operations from JSON input`,usage:`aikit batch [--file path] [--concurrency N]`,run:async e=>{let t=P(e,`--file`,``).trim()||void 0,n=(()=>{let t=e.indexOf(`--concurrency`);if(t===-1||t+1>=e.length)return 0;let n=Number.parseInt(e.splice(t,2)[1],10);return Number.isNaN(n)?0:n})(),r=await nt(t);r.trim()||(console.error(`Usage: aikit batch [--file path] [--concurrency N]`),process.exit(1));let i=rt(r),a=n>0?n:i.concurrency,o=i.operations.some(e=>e.type!==`check`)?await X():null,s=await p(i.operations,async e=>_t(e,o),{concurrency:a});console.log(JSON.stringify(s,null,2)),s.some(e=>e.status===`error`)&&(process.exitCode=1)}},{name:`health`,description:`Run project health checks on the current directory`,usage:`aikit health [path]`,run:async e=>{let t=ve(e.shift());console.log(`Project Health: ${t.path}`),console.log(`─`.repeat(50));for(let e of t.checks){let t=e.status===`pass`?`+`:e.status===`warn`?`~`:`X`;console.log(`  [${t}] ${e.name}: ${e.message}`)}console.log(`─`.repeat(50)),console.log(`Score: ${t.score}% — ${t.summary}`)}},{name:`audit`,description:`Run a unified project audit (structure, deps, patterns, health, dead symbols, check)`,usage:`aikit audit [path] [--checks structure,dependencies,patterns,health,dead_symbols,check,entry_points] [--detail summary|full]`,run:async e=>{let{store:t,embedder:n}=await X(),r=P(e,`--detail`,`summary`)||`summary`,i=P(e,`--checks`,``),a=i?i.split(`,`).map(e=>e.trim()):void 0,o=await f(t,n,{path:e.shift()||`.`,checks:a,detail:r});if(o.ok){if(console.log(o.summary),o.next&&o.next.length>0){console.log(`
+Suggested next steps:`);for(let e of o.next)console.log(`  → ${e.tool}: ${e.reason}`)}}else console.error(o.error?.message??`Audit failed`),process.exitCode=1}},{name:`guide`,description:`Tool discovery — recommend AI Kit tools for a given goal`,usage:`aikit guide <goal> [--max N]`,run:async e=>{let t=e.indexOf(`--max`),n=5;t!==-1&&t+1<e.length&&(n=Number.parseInt(e.splice(t,2)[1],10)||5);let r=e.join(` `).trim();r||(console.error(`Usage: aikit guide <goal> [--max N]`),console.error(`Example: aikit guide "audit this project"`),process.exit(1));let i=_e(r,n);console.log(`Workflow: ${i.workflow}`),console.log(`  ${i.description}\n`),console.log(`Recommended tools:`);for(let e of i.tools){let t=e.suggestedArgs?` ${JSON.stringify(e.suggestedArgs)}`:``;console.log(`  ${e.order}. ${e.tool} — ${e.reason}${t}`)}i.alternativeWorkflows.length>0&&console.log(`\nAlternatives: ${i.alternativeWorkflows.join(`, `)}`)}},{name:`replay`,description:`Show recent tool invocation audit trail`,usage:`aikit replay [--last N] [--tool <name>] [--source mcp|cli]`,run:async e=>{let t=je({last:Number.parseInt(e[e.indexOf(`--last`)+1],10)||20,tool:e.includes(`--tool`)?e[e.indexOf(`--tool`)+1]:void 0,source:e.includes(`--source`)?e[e.indexOf(`--source`)+1]:void 0});if(t.length===0){console.log(`No replay entries. Activity is logged when tools are invoked.`);return}console.log(`Replay Log (${t.length} entries)\n`);for(let e of t){let t=e.ts.split(`T`)[1]?.split(`.`)[0]??e.ts,n=e.status===`ok`?`✓`:`✗`;console.log(`${t} ${n} ${e.tool} (${e.durationMs}ms) [${e.source}]`),console.log(`  in:  ${e.input}`),console.log(`  out: ${e.output}`)}Me().catch(()=>{})}},{name:`replay-clear`,description:`Clear the replay audit trail`,run:async()=>{Ae(),console.log(`Replay log cleared.`)}},{name:`tui`,description:`Launch interactive terminal dashboard (human monitoring)`,run:async()=>{try{let{launch:e}=await import(`../../tui/dist/index.js`),{DirectKBClient:t}=await import(`../../aikit-client/dist/index.js`),{store:n,embedder:r,graphStore:i,curated:a}=await X();e(new t({store:n,embedder:r,graphStore:i,listCurated:async()=>(await a.list()).map(e=>({...e,content:e.contentPreview})),readCurated:e=>a.read(e)}))}catch(e){throw e.code===`ERR_MODULE_NOT_FOUND`&&(console.error(`TUI requires ink and react. Install them with:
+  pnpm add -D ink react @types/react`),process.exit(1)),e}}},{name:`dashboard`,description:`Launch web dashboard for knowledge graph visualization`,usage:`aikit dashboard [--port <port>] [--no-open]`,run:async e=>{let t=e.indexOf(`--port`),n=t!==-1&&e[t+1]?Number.parseInt(e[t+1],10):3210,r=Number.isFinite(n)?n:3210,i=e.includes(`--no-open`);console.log(`Starting AI Kit server on port ${r}...`);let{spawn:a}=await import(`node:child_process`),{platform:o}=await import(`node:os`),s=l(Z,`..`,`..`,`..`,`server`,`dist`,`index.js`),c=a(process.execPath,[s,`--transport`,`http`,`--port`,String(r)],{stdio:[`ignore`,`pipe`,`pipe`],env:{...process.env,AIKIT_TRANSPORT:`http`,AIKIT_PORT:String(r)}}),u=`http://localhost:${r}/_dashboard/`,d=`http://localhost:${r}/health`,f=!1;for(let e=0;e<30;e+=1){try{if((await fetch(d)).ok){f=!0;break}}catch{}await new Promise(e=>setTimeout(e,1e3))}if(f||(console.error(`Server failed to start within 30 seconds.`),c.kill(),process.exit(1)),console.log(`AI Kit Dashboard: ${u}`),console.log(`Press Ctrl+C to stop.`),!i){let e=o();e===`win32`?a(`cmd`,[`/c`,`start`,``,u],{stdio:`ignore`,detached:!0}).unref():a(e===`darwin`?`open`:`xdg-open`,[u],{stdio:`ignore`,detached:!0}).unref()}let p=()=>{c.kill(),process.exit(0)};process.on(`SIGINT`,p),process.on(`SIGTERM`,p),await new Promise(e=>{c.on(`exit`,()=>e())})}}],At=[{name:`upgrade`,description:`Upgrade AI Kit agents, prompts, and skills to the latest version (user-level and workspace-level)`,usage:`aikit upgrade`,run:async()=>{let{initUser:n}=await import(`./user-HmJYNt5b.js`);await n({force:!0});let i=process.cwd(),o=r(l(i,`.github`,`.aikit-scaffold.json`)),c=r(l(i,`.github`,`agents`)),d=r(l(i,`.github`,`prompts`)),f=r(l(i,`.claude`,`commands`));if(o||c||d||f){let{initScaffoldOnly:e}=await import(`./init-D0CiV9PX.js`);await e({force:!0})}if(r(l(i,`.github`,`skills`))){let{smartCopySkills:n}=await import(`./scaffold-CJwkHf-q.js`),r=l(s(u(import.meta.url)),`..`,`..`,`..`,`..`),o=JSON.parse(a(l(r,`package.json`),`utf-8`)).version;n(i,r,[...e],o,!0);let{smartCopyFlows:c}=await import(`./scaffold-CJwkHf-q.js`);c(i,r,[...t],o,!0)}}}],jt=[{name:`workset`,description:`Manage saved file sets`,usage:`aikit workset <action> [name] [--files f1,f2] [--description desc]`,run:async e=>{let t=e.shift()?.trim(),n=L(P(e,`--files`,``)),r=P(e,`--description`,``).trim()||void 0,i=e.shift()?.trim();switch(t||(console.error(`Usage: aikit workset <action> [name] [--files f1,f2] [--description desc]`),console.error(`Actions: save, get, list, delete, add, remove`),process.exit(1)),t){case`save`:{(!i||n.length===0)&&(console.error(`Usage: aikit workset save <name> --files f1,f2 [--description desc]`),process.exit(1));let e=Ne(i,n,{description:r});console.log(`Saved workset: ${e.name}`),V(e);return}case`get`:{i||(console.error(`Usage: aikit workset get <name>`),process.exit(1));let e=me(i);if(!e){console.log(`No workset found: ${i}`);return}V(e);return}case`list`:{let e=_();if(e.length===0){console.log(`No worksets saved.`);return}console.log(`Worksets (${e.length})`),console.log(`─`.repeat(60));for(let t of e)V(t),console.log(``);return}case`delete`:{i||(console.error(`Usage: aikit workset delete <name>`),process.exit(1));let e=ce(i);console.log(e?`Deleted workset: ${i}`:`No workset found: ${i}`);return}case`add`:{(!i||n.length===0)&&(console.error(`Usage: aikit workset add <name> --files f1,f2`),process.exit(1));let e=d(i,n);console.log(`Updated workset: ${e.name}`),V(e);return}case`remove`:{(!i||n.length===0)&&(console.error(`Usage: aikit workset remove <name> --files f1,f2`),process.exit(1));let e=Oe(i,n);if(!e){console.log(`No workset found: ${i}`);return}console.log(`Updated workset: ${e.name}`),V(e);return}default:console.error(`Unknown workset action: ${t}`),console.error(`Actions: save, get, list, delete, add, remove`),process.exit(1)}}},{name:`stash`,description:`Persist and retrieve named intermediate values`,usage:`aikit stash <set|get|list|delete|clear> [key] [value]`,run:async e=>{let t=e.shift()?.trim(),n=e.shift()?.trim();switch(t||(console.error(`Usage: aikit stash <set|get|list|delete|clear> [key] [value]`),process.exit(1)),t){case`set`:{n||(console.error(`Usage: aikit stash set <key> <value>`),process.exit(1));let t=e.join(` `),r=t.trim()?``:await I(),i=ze(n,ht(t||r));console.log(`Stored stash entry: ${i.key}`),console.log(`  Type: ${i.type}`),console.log(`  Stored: ${i.storedAt}`);return}case`get`:{n||(console.error(`Usage: aikit stash get <key>`),process.exit(1));let e=Le(n);if(!e){console.log(`No stash entry found: ${n}`);return}console.log(JSON.stringify(e,null,2));return}case`list`:{let e=Re();if(e.length===0){console.log(`No stash entries saved.`);return}console.log(`Stash entries (${e.length})`),console.log(`─`.repeat(60));for(let t of e)console.log(`${t.key} (${t.type})`),console.log(`  Stored: ${t.storedAt}`);return}case`delete`:{n||(console.error(`Usage: aikit stash delete <key>`),process.exit(1));let e=Ie(n);console.log(e?`Deleted stash entry: ${n}`:`No stash entry found: ${n}`);return}case`clear`:{let e=Fe();console.log(`Cleared ${e} stash entr${e===1?`y`:`ies`}.`);return}default:console.error(`Unknown stash action: ${t}`),console.error(`Actions: set, get, list, delete, clear`),process.exit(1)}}},{name:`lane`,description:`Manage verified lanes — isolated file copies for parallel exploration`,usage:`aikit lane <create|list|status|diff|merge|discard> [name] [--files f1,f2]`,run:async e=>{let t=e.shift();if((!t||![`create`,`list`,`status`,`diff`,`merge`,`discard`].includes(t))&&(console.error(`Usage: aikit lane <create|list|status|diff|merge|discard> [name] [--files f1,f2]`),process.exit(1)),t===`list`){let e=Se();if(e.length===0){console.log(`No active lanes.`);return}for(let t of e)console.log(`${t.name}  (${t.sourceFiles.length} files, created ${t.createdAt})`);return}let n=e.shift();switch(n||(console.error(`Lane name is required for "${t}".`),process.exit(1)),t){case`create`:{let t=P(e,`--files`,``);t||(console.error(`Usage: aikit lane create <name> --files file1.ts,file2.ts`),process.exit(1));let r=ye(n,t.split(`,`).map(e=>e.trim()));console.log(`Lane "${r.name}" created with ${r.sourceFiles.length} files.`);break}case`status`:{let e=we(n);console.log(`Lane: ${e.name}`),console.log(`Modified: ${e.modified} | Added: ${e.added} | Deleted: ${e.deleted}`);for(let t of e.entries)console.log(`  ${t.status.padEnd(10)} ${t.file}`);break}case`diff`:{let e=be(n);console.log(`Lane: ${e.name} — ${e.modified} modified, ${e.added} added, ${e.deleted} deleted`);for(let t of e.entries)t.diff&&(console.log(`\n--- ${t.file} (${t.status})`),console.log(t.diff));break}case`merge`:{let e=Ce(n);console.log(`Merged ${e.filesMerged} files from lane "${e.name}".`);for(let t of e.files)console.log(`  ${t}`);break}case`discard`:{let e=xe(n);console.log(e?`Lane "${n}" discarded.`:`Lane "${n}" not found.`);break}}}},{name:`queue`,description:`Manage task queues for sequential agent operations`,usage:`aikit queue <create|push|next|done|fail|get|list|clear|delete> [name] [args]`,run:async e=>{let t=e.shift();if((!t||![`create`,`push`,`next`,`done`,`fail`,`get`,`list`,`clear`,`delete`].includes(t))&&(console.error(`Usage: aikit queue <create|push|next|done|fail|get|list|clear|delete> [name] [args]`),process.exit(1)),t===`list`){let e=Te();if(e.length===0){console.log(`No queues.`);return}for(let t of e)console.log(`${t.name}  pending:${t.pending} done:${t.done} failed:${t.failed} total:${t.total}`);return}let n=e.shift();switch(n||(console.error(`Queue name is required for "${t}".`),process.exit(1)),t){case`create`:{let e=T(n);console.log(`Queue "${e.name}" created.`);break}case`push`:{let t=De(n,e.join(` `)||`Untitled task`);console.log(`Pushed "${t.title}" (${t.id}) to queue "${n}".`);break}case`next`:{let e=Ee(n);console.log(e?`Next: ${e.title} (${e.id})`:`No pending items in queue "${n}".`);break}case`done`:{let t=e.shift();t||(console.error(`Usage: aikit queue done <name> <id>`),process.exit(1));let r=D(n,t);console.log(`Marked "${r.title}" as done.`);break}case`fail`:{let t=e.shift(),r=e.join(` `)||`Unknown error`;t||(console.error(`Usage: aikit queue fail <name> <id> [error message]`),process.exit(1));let i=O(n,t,r);console.log(`Marked "${i.title}" as failed: ${r}`);break}case`get`:{let e=k(n);if(!e){console.log(`Queue "${n}" not found.`);return}console.log(`Queue: ${e.name} (${e.items.length} items)`);for(let t of e.items){let e=t.error?` — ${t.error}`:``;console.log(`  ${t.status.padEnd(12)} ${t.id}  ${t.title}${e}`)}break}case`clear`:{let e=w(n);console.log(`Cleared ${e} completed/failed items from queue "${n}".`);break}case`delete`:{let e=E(n);console.log(e?`Queue "${n}" deleted.`:`Queue "${n}" not found.`);break}}}}],Q=[...Ot,...Dt,...tt,...Et,...kt,...bt,...vt,...jt,...yt,...At,...J];Q.push({name:`help`,description:`Show available commands`,run:async()=>{$()}});async function Mt(e){let t=[...e],n=t.shift();if(!n||n===`--help`||n===`-h`){$();return}if(n===`--version`||n===`-v`){let e=l(s(u(import.meta.url)),`..`,`..`,`..`,`package.json`),t=JSON.parse(a(e,`utf-8`));console.log(t.version);return}let r=Q.find(e=>e.name===n);r||(console.error(`Unknown command: ${n}`),$(),process.exit(1));try{await r.run(t)}finally{let e=Tt();e&&await e.store.close()}}function $(){console.log(`@vpxa/aikit — Local-first AI developer toolkit
 `),console.log(`Usage: aikit <command> [options]
-`),console.log(`Commands:`);let e=Math.max(...g.map(e=>e.name.length));for(let t of g)console.log(`  ${t.name.padEnd(e+2)}${t.description}`);console.log(``),console.log(`Options:`),console.log(`  --help, -h     Show this help`),console.log(`  --version, -v  Show version`)}export{_ as run};
+`),console.log(`Commands:`);let e=Math.max(...Q.map(e=>e.name.length));for(let t of Q)console.log(`  ${t.name.padEnd(e+2)}${t.description}`);console.log(``),console.log(`Options:`),console.log(`  --help, -h     Show this help`),console.log(`  --version, -v  Show version`)}export{Mt as run};

package/packages/cli/dist/init-D0CiV9PX.js

@@ -0,0 +1,7 @@
+import{i as e,n as t,r as n,t as r}from"./constants-D3v4VDf0.js";import{n as i,t as a}from"./templates-DJ7EC5vw.js";import{guideFlows as o,guideScaffold as s,guideSkills as c,smartCopyClaudeCommands as l,smartCopyFlows as u,smartCopyScaffold as d,smartCopySkills as f}from"./scaffold-CJwkHf-q.js";import{appendFileSync as p,existsSync as m,mkdirSync as h,readFileSync as g,unlinkSync as _,writeFileSync as v}from"node:fs";import{basename as y,dirname as b,resolve as x}from"node:path";import{fileURLToPath as S}from"node:url";import{AIKIT_PATHS as C,isUserInstalled as w}from"../../core/dist/index.js";function T(e){return m(x(e,`.cursor`))?`cursor`:m(x(e,`.claude`))?`claude-code`:m(x(e,`.windsurf`))?`windsurf`:`copilot`}function E(e){return{servers:{[e]:{...t}}}}function D(e){let{type:n,...r}=t;return{mcpServers:{[e]:r}}}const O={scaffoldDir:`general`,writeMcpConfig(e,t){let n=x(e,`.vscode`),r=x(n,`mcp.json`);m(r)||(h(n,{recursive:!0}),v(r,`${JSON.stringify(E(t),null,2)}\n`,`utf-8`),console.log(`  Created .vscode/mcp.json`))},writeInstructions(e,t){let n=x(e,`.github`),r=x(n,`copilot-instructions.md`);h(n,{recursive:!0}),v(r,i(y(e),t),`utf-8`),console.log(`  Updated .github/copilot-instructions.md`)},writeAgentsMd(e,t){v(x(e,`AGENTS.md`),a(y(e),t),`utf-8`),console.log(`  Updated AGENTS.md`)}},k={scaffoldDir:`general`,writeMcpConfig(e,t){let n=x(e,`.mcp.json`);m(n)||(v(n,`${JSON.stringify(D(t),null,2)}\n`,`utf-8`),console.log(`  Created .mcp.json`))},writeInstructions(e,t){let n=x(e,`CLAUDE.md`),r=y(e);v(n,`${i(r,t)}\n---\n\n${a(r,t)}`,`utf-8`),console.log(`  Updated CLAUDE.md`)},writeAgentsMd(e,t){}},A={scaffoldDir:`general`,writeMcpConfig(e,t){let n=x(e,`.cursor`),r=x(n,`mcp.json`);m(r)||(h(n,{recursive:!0}),v(r,`${JSON.stringify(D(t),null,2)}\n`,`utf-8`),console.log(`  Created .cursor/mcp.json`))},writeInstructions(e,t){let n=x(e,`.cursor`,`rules`),r=x(n,`aikit.mdc`);h(n,{recursive:!0});let o=y(e);v(r,`${i(o,t)}\n---\n\n${a(o,t)}`,`utf-8`),console.log(`  Updated .cursor/rules/aikit.mdc`);let s=x(n,`kb.mdc`);m(s)&&s!==r&&(_(s),console.log(`  Removed legacy .cursor/rules/kb.mdc`))},writeAgentsMd(e,t){}},j={scaffoldDir:`general`,writeMcpConfig(e,t){let n=x(e,`.vscode`),r=x(n,`mcp.json`);m(r)||(h(n,{recursive:!0}),v(r,`${JSON.stringify(E(t),null,2)}\n`,`utf-8`),console.log(`  Created .vscode/mcp.json (Windsurf-compatible)`))},writeInstructions(e,t){let n=x(e,`.windsurfrules`),r=y(e);v(n,`${i(r,t)}\n---\n\n${a(r,t)}`,`utf-8`),console.log(`  Updated .windsurfrules`)},writeAgentsMd(e,t){}};function M(e){switch(e){case`copilot`:return O;case`claude-code`:return k;case`cursor`:return A;case`windsurf`:return j}}const N={serverName:n,sources:[{path:`.`,excludePatterns:[`**/node_modules/**`,`**/dist/**`,`**/build/**`,`**/.git/**`,`**/${C.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:`${C.data}/lance`},curated:{path:C.aiCurated}};function P(e,t){let n=x(e,`aikit.config.json`);return m(n)&&!t?(console.log(`aikit.config.json already exists. Use --force to overwrite.`),!1):(v(n,`${JSON.stringify(N,null,2)}\n`,`utf-8`),console.log(`  Created aikit.config.json`),!0)}function F(e){let t=x(e,`.gitignore`),n=[{dir:`${C.data}/`,label:`AI Kit vector store`},{dir:`${C.state}/`,label:`AI Kit session state`},{dir:`${C.restorePoints}/`,label:`Restore points (codemod/rename undo snapshots)`},{dir:`${C.brainstorm}/`,label:`Brainstorming sessions`},{dir:`${C.handoffs}/`,label:`Handoff documents`}];if(m(t)){let e=g(t,`utf-8`),r=n.filter(t=>!e.includes(t.dir));r.length>0&&(p(t,`\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 v(t,`${n.map(e=>`# ${e.label}\n${e.dir}`).join(`
+`)}\n`,`utf-8`),console.log(`  Created .gitignore with AI Kit entries`)}function I(){return N.serverName}const L=[`decisions`,`patterns`,`conventions`,`troubleshooting`];function R(e){let t=x(e,`.ai`,`curated`);m(t)||(h(t,{recursive:!0}),console.log(`  Created .ai/curated/`));for(let e of L){let n=x(t,e);m(n)||h(n,{recursive:!0})}console.log(`  Created .ai/curated/{${L.join(`,`)}}/`)}async function z(t){let n=process.cwd();if(!P(n,t.force))return;F(n);let i=I(),a=M(T(n));a.writeMcpConfig(n,i),a.writeInstructions(n,i),a.writeAgentsMd(n,i);let o=x(b(S(import.meta.url)),`..`,`..`,`..`,`..`,`..`),s=JSON.parse(g(x(o,`package.json`),`utf-8`)).version;f(n,o,[...e],s,t.force),u(n,o,[...r],s,t.force),d(n,o,a.scaffoldDir,s,t.force),l(n,o,s,t.force),R(n),console.log(`
+AI Kit initialized! Next steps:`),console.log(`  aikit reindex  Index your codebase`),console.log(`  aikit search   Search indexed content`),console.log(`  aikit serve    Start MCP server for IDE integration`),w()&&console.log(`
+Note: User-level AI Kit is also installed. This workspace uses its own local data store.`)}async function B(e){w()?await V(e):await z(e)}async function V(e){let t=process.cwd(),n=I(),i=M(T(t));i.writeInstructions(t,n),i.writeAgentsMd(t,n);let a=x(b(S(import.meta.url)),`..`,`..`,`..`,`..`,`..`),o=JSON.parse(g(x(a,`package.json`),`utf-8`)).version;d(t,a,i.scaffoldDir,o,e.force),l(t,a,o,e.force),u(t,a,[...r],o,e.force),R(t),F(t),console.log(`
+Workspace scaffolded for user-level AI Kit! 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 user-level AI Kit server will auto-index this workspace when opened in your IDE.`)}async function H(){let t=process.cwd(),n=M(T(t)),i=x(b(S(import.meta.url)),`..`,`..`,`..`,`..`,`..`),a=[...c(t,i,[...e]),...o(t,i,[...r]),...s(t,i,n.scaffoldDir)],l={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(l,null,2))}export{H as guideProject,z as initProject,V as initScaffoldOnly,B as initSmart};

package/packages/cli/dist/scaffold-CJwkHf-q.js

@@ -0,0 +1,2 @@
+import{existsSync as e,mkdirSync as t,readFileSync as n,readdirSync as r,rmSync as i,statSync as a,unlinkSync as o,writeFileSync as s}from"node:fs";import{dirname as c,resolve as l}from"node:path";import{createHash as u}from"node:crypto";const d=[`inputs`,`outputs`,`requires`,`relatedSkills`],f=[`model`],p=[`category`,`domain`,`applicability`],m=new Set([`__proto__`,`constructor`,`prototype`]);function h(e,t){return e.metadata[t]??e.fields[t]}function g(e,t){let n=h(e,t);return n?v(n):[]}function _(e){let t=Object.create(null),n=Object.create(null),r=[],i=e,a=e.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);if(!a)return{fields:t,metadata:n,tools:r,body:i};let o=a[1];i=a[2];let s=!1;for(let e of o.split(/\r?\n/)){if(s){if(e.trim()===``)continue;let t=e.match(/^\s{2,}(\S+?):\s*(.*)$/);if(t){let[,e,r]=t;if(m.has(e))continue;n[e]=r;continue}s=!1}let i=e.match(/^(\S+?):\s*(.*)$/);if(!i)continue;let[,a,o]=i;if(a===`metadata`&&o.trim()===``){s=!0;continue}m.has(a)||(t[a]=o,a===`tools`&&(r=v(o)))}return{fields:t,metadata:n,tools:r,body:i}}function v(e){let t=e.trim();if(!t.startsWith(`[`)||!t.endsWith(`]`))return[];let n=t.slice(1,-1).trim();return n?n.split(`,`).map(e=>e.trim()).filter(Boolean):[]}function y(e){return`[${e.join(`, `)}]`}function b(e,t){let n=_(e),r=_(t),i={...n.fields},a={...n.metadata};for(let[e,t]of Object.entries(r.metadata))e in a||(a[e]=t);for(let e of f)r.fields[e]&&(i[e]=r.fields[e]);for(let e of p){let t=h(r,e);t&&(a[e]=t)}for(let e of[...p,...d])delete i[e];delete i.metadata;let o=n.tools,s=r.tools,c=new Set(o),l=s.filter(e=>!c.has(e)),u=[...o,...l];u.length>0&&(i.tools=y(u));for(let e of d){let t=g(n,e),i=g(r,e),o=new Set(t),s=i.filter(e=>!o.has(e)),c=[...t,...s];c.length>0?a[e]=y(c):delete a[e]}let m=[`---`],v=[`name`,`description`,`argument-hint`,`tools`,`model`],b=[`category`,`domain`,`applicability`,`inputs`,`outputs`,`requires`,`relatedSkills`],x=new Set;for(let e of v)e in i&&(m.push(`${e}: ${i[e]}`),x.add(e));for(let[e,t]of Object.entries(i))x.has(e)||m.push(`${e}: ${t}`);let S=[],C=new Set;for(let e of b){let t=a[e];t&&(S.push(`  ${e}: ${t}`),C.add(e))}for(let[e,t]of Object.entries(a))!C.has(e)&&t&&S.push(`  ${e}: ${t}`);return S.length>0&&(m.push(`metadata:`),m.push(...S)),m.push(`---`),`${m.join(`
+`)}\n${n.body}`}function x(e){return u(`sha256`).update(e).digest(`hex`).slice(0,16)}function S(t){if(!e(t))return null;try{let e=n(t,`utf-8`),r=JSON.parse(e);return!r.version||!r.files?null:r}catch{return null}}function C(e,t){s(e,`${JSON.stringify(t,null,2)}\n`,`utf-8`)}function w(e){return e.endsWith(`.agent.md`)&&!e.startsWith(`_shared/`)&&!e.startsWith(`agents/_shared/`)&&!e.startsWith(`templates/`)||e.endsWith(`SKILL.md`)&&!e.startsWith(`_shared/`)&&!e.startsWith(`templates/`)?`merge-frontmatter`:`overwrite`}function T(e,t,n){if(!e)return`new`;let r=e.files[t];return r?r.sourceHash===x(n)?`current`:`outdated`:`new`}function E(e,t,n,r){e.files[t]={sourceHash:x(n),strategy:r??w(t),updatedAt:new Date().toISOString()}}function D(e){return{version:e,generatedAt:new Date().toISOString(),files:{}}}function O(i,o,u,d=``,f=!1){if(e(i)){t(o,{recursive:!0});for(let p of r(i)){let r=l(i,p),m=l(o,p),h=d?`${d}/${p}`:p;if(a(r).isDirectory()){O(r,m,u,h,f);continue}let g=n(r,`utf-8`);if(f){t(c(m),{recursive:!0}),s(m,g,`utf-8`),E(u,h,g);continue}let _=T(u,h,g);if(_!==`current`){if(_===`new`&&!e(m)){t(c(m),{recursive:!0}),s(m,g,`utf-8`),E(u,h,g);continue}if(_===`new`&&e(m)){E(u,h,g);continue}w(h)===`merge-frontmatter`&&e(m)?s(m,b(g,n(m,`utf-8`)),`utf-8`):(t(c(m),{recursive:!0}),s(m,g,`utf-8`)),E(u,h,g)}}}}function k(t,n,i,s){let c=new Set;if(e(t)){let e=(t,n)=>{for(let i of r(t)){let r=l(t,i),o=n?`${n}/${i}`:i;a(r).isDirectory()?e(r,o):c.add(`${s}/${o}`)}};e(t,``)}let u=[];for(let t of Object.keys(i.files)){if(!t.startsWith(`${s}/`)||c.has(t))continue;let r=l(n,t.slice(s.length+1));e(r)&&(o(r),u.push(t)),delete i.files[t]}return u}function A(t,n,r,i,a=!1){let o=l(n,`scaffold`,r),s=l(t,`.github`),c=l(s,`.aikit-scaffold.json`),u=S(c)??D(i);u.version=i;for(let t of[`agents`,`prompts`]){let n=l(o,t);e(n)&&O(n,l(s,t),u,t,a)}if(a)for(let e of[`agents`,`prompts`]){let t=k(l(o,e),l(s,e),u,e);for(let e of t)console.log(`  Removed orphaned scaffold file: ${e}`)}C(c,u)}function j(t,n,r,i,a=!1){let o=l(t,`.github`),s=l(o,`.aikit-scaffold.json`),c=S(s)??D(i);c.version=i;for(let t of r){let r=l(n,`scaffold`,`general`,`skills`,t);e(r)&&O(r,l(o,`skills`,t),c,`skills/${t}`,a)}C(s,c)}function M(t,n,r,i,a=!1){let o=l(t,r);if(!e(o))return;let s=l(n,r),c=l(n,`.aikit-scaffold.json`),u=S(c)??D(i);if(u.version=i,O(o,s,u,r,a),a){let e=k(o,s,u,r);for(let t of e)console.log(`  Removed orphaned scaffold file: ${t}`)}C(c,u)}function N(t,i,o,s){if(e(t))for(let c of r(t)){let r=l(t,c),u=o?`${o}/${c}`:c;if(a(r).isDirectory())N(r,l(i,c),u,s);else{let t=l(i,c),a=n(r,`utf-8`);e(t)?a===n(t,`utf-8`)?s.push({status:`current`,relativePath:u,sourcePath:r}):s.push({status:`outdated`,relativePath:u,sourcePath:r,content:a}):s.push({status:`new`,relativePath:u,sourcePath:r,content:a})}}}function P(e,t,n){let r=[],i=l(t,`scaffold`,n);for(let t of[`agents`,`prompts`])N(l(i,t),l(e,`.github`,t),t,r);return r}function F(t,n,r){let i=[];for(let a of r){let r=l(n,`scaffold`,`general`,`skills`,a);e(r)&&N(r,l(t,`.github`,`skills`,a),`skills/${a}`,i)}return i}function I(t,n,r,a,o=!1){let s=l(t,`.github`),c=l(s,`.aikit-scaffold.json`),u=S(c)??D(a);u.version=a;for(let t of r){let r=l(n,`scaffold`,`flows`,t,`steps`);if(!e(r))continue;let a=l(s,`flows`,t,`skills`);e(a)&&i(a,{recursive:!0,force:!0}),O(r,l(s,`flows`,t,`steps`),u,`flows/${t}/steps`,o)}C(c,u)}function L(t,n,r){let i=[];for(let a of r){let r=l(n,`scaffold`,`flows`,a,`steps`);e(r)&&N(r,l(t,`.github`,`flows`,a,`steps`),`flows/${a}/steps`,i)}return i}function R(i,o,c,d=!1){let f=l(o,`scaffold`,`claude-code`,`commands`);if(!e(f))return;let p=l(i,`.claude`),m=l(p,`.aikit-scaffold.json`),h;h=e(m)?JSON.parse(n(m,`utf-8`)):{version:c,generatedAt:new Date().toISOString(),files:{}},h.version=c,h.generatedAt=new Date().toISOString(),t(l(p,`commands`),{recursive:!0});let g=r(f);for(let t of g){let r=l(f,t);if(!a(r).isFile())continue;let i=`commands/${t}`,o=l(p,i),c=n(r,`utf-8`),m=u(`sha256`).update(c).digest(`hex`).slice(0,16),g=h.files[i];if(g&&!d&&e(o)){let e=n(o,`utf-8`);if(u(`sha256`).update(e).digest(`hex`).slice(0,16)!==g.sourceHash)continue}s(o,c,`utf-8`),h.files[i]={sourceHash:m,strategy:`overwrite`,updatedAt:new Date().toISOString()}}if(d){let e=k(f,l(p,`commands`),h,`commands`);for(let t of e)console.log(`  Removed orphaned scaffold file: ${t}`)}s(m,JSON.stringify(h,null,2),`utf-8`)}export{L as guideFlows,P as guideScaffold,F as guideSkills,R as smartCopyClaudeCommands,I as smartCopyFlows,A as smartCopyScaffold,j as smartCopySkills,M as smartCopySubdir};

package/packages/cli/dist/{commands/init/templates.js → templates-DJ7EC5vw.js}

@@ -249,4 +249,4 @@ AI Kit provides cross-session persistent memory via curated knowledge. **Use it
 **Complex tasks (FORGE):** \`forge_classify({ task })\` → \`forge_ground({ task })\` → \`evidence_map({ claims })\`
 
 **Quality iteration:** \`check\` → \`test_run\` → \`evidence_map({ action: "gate" })\` → fix → re-gate (max 3 rounds)
-`}export{t as buildAgentsMd,e as buildCopilotInstructions};
+`}export{e as n,t};

package/packages/cli/dist/user-HmJYNt5b.js

@@ -0,0 +1,5 @@
+import{a as e,i as t,n,r,t as i}from"./constants-D3v4VDf0.js";import{n as a,t as o}from"./templates-DJ7EC5vw.js";import{smartCopySubdir as s}from"./scaffold-CJwkHf-q.js";import{existsSync as c,mkdirSync as l,readFileSync as u,rmSync as d,unlinkSync as f,writeFileSync as p}from"node:fs";import{dirname as m,resolve as h}from"node:path";import{fileURLToPath as g}from"node:url";import{getGlobalDataDir as _,saveRegistry as v}from"../../core/dist/index.js";import{homedir as y}from"node:os";function b(){let e=y(),t=process.platform,n=[],r=h(e,`.copilot`),i=h(r,`instructions`),a=h(e,`.claude`),o=h(e,`.cursor`),s=h(e,`.windsurf`);if(t===`win32`){let t=process.env.APPDATA??h(e,`AppData`,`Roaming`);n.push({ide:`VS Code`,configDir:h(t,`Code`,`User`),mcpConfigPath:h(t,`Code`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`VS Code Insiders`,configDir:h(t,`Code - Insiders`,`User`),mcpConfigPath:h(t,`Code - Insiders`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`VSCodium`,configDir:h(t,`VSCodium`,`User`),mcpConfigPath:h(t,`VSCodium`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`Cursor`,configDir:h(t,`Cursor`,`User`),mcpConfigPath:h(t,`Cursor`,`User`,`mcp.json`),globalScaffoldRoot:o,instructionsRoot:null},{ide:`Cursor Nightly`,configDir:h(t,`Cursor Nightly`,`User`),mcpConfigPath:h(t,`Cursor Nightly`,`User`,`mcp.json`),globalScaffoldRoot:o,instructionsRoot:null},{ide:`Windsurf`,configDir:h(t,`Windsurf`,`User`),mcpConfigPath:h(t,`Windsurf`,`User`,`mcp.json`),globalScaffoldRoot:s,instructionsRoot:null})}else if(t===`darwin`){let t=h(e,`Library`,`Application Support`);n.push({ide:`VS Code`,configDir:h(t,`Code`,`User`),mcpConfigPath:h(t,`Code`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`VS Code Insiders`,configDir:h(t,`Code - Insiders`,`User`),mcpConfigPath:h(t,`Code - Insiders`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`VSCodium`,configDir:h(t,`VSCodium`,`User`),mcpConfigPath:h(t,`VSCodium`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`Cursor`,configDir:h(t,`Cursor`,`User`),mcpConfigPath:h(t,`Cursor`,`User`,`mcp.json`),globalScaffoldRoot:o,instructionsRoot:null},{ide:`Cursor Nightly`,configDir:h(t,`Cursor Nightly`,`User`),mcpConfigPath:h(t,`Cursor Nightly`,`User`,`mcp.json`),globalScaffoldRoot:o,instructionsRoot:null},{ide:`Windsurf`,configDir:h(t,`Windsurf`,`User`),mcpConfigPath:h(t,`Windsurf`,`User`,`mcp.json`),globalScaffoldRoot:s,instructionsRoot:null})}else{let t=process.env.XDG_CONFIG_HOME??h(e,`.config`);n.push({ide:`VS Code`,configDir:h(t,`Code`,`User`),mcpConfigPath:h(t,`Code`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`VS Code Insiders`,configDir:h(t,`Code - Insiders`,`User`),mcpConfigPath:h(t,`Code - Insiders`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`VSCodium`,configDir:h(t,`VSCodium`,`User`),mcpConfigPath:h(t,`VSCodium`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`Cursor`,configDir:h(t,`Cursor`,`User`),mcpConfigPath:h(t,`Cursor`,`User`,`mcp.json`),globalScaffoldRoot:o,instructionsRoot:null},{ide:`Cursor Nightly`,configDir:h(t,`Cursor Nightly`,`User`),mcpConfigPath:h(t,`Cursor Nightly`,`User`,`mcp.json`),globalScaffoldRoot:o,instructionsRoot:null},{ide:`Windsurf`,configDir:h(t,`Windsurf`,`User`),mcpConfigPath:h(t,`Windsurf`,`User`,`mcp.json`),globalScaffoldRoot:s,instructionsRoot:null})}return n.push({ide:`Claude Code`,configDir:h(e,`.claude`),mcpConfigPath:h(e,`.claude`,`mcp.json`),globalScaffoldRoot:a,instructionsRoot:null}),n.push({ide:`Copilot CLI`,configDir:r,mcpConfigPath:h(r,`mcp-config.json`),globalScaffoldRoot:null,instructionsRoot:null}),n.filter(e=>c(e.configDir))}function x(e,t,r=!1){let{mcpConfigPath:i,configDir:a}=e,o={...n},s={};if(c(i)){try{let e=u(i,`utf-8`);s=JSON.parse(e)}catch{let e=`${i}.bak`;p(e,u(i,`utf-8`),`utf-8`),console.log(`  Backed up invalid ${i} to ${e}`),s={}}if((s.servers??s.mcpServers??{})[t]&&!r){console.log(`  ${e.ide}: ${t} already configured (use --force to update)`);return}}let d=new Set([`VS Code`,`VS Code Insiders`,`VSCodium`,`Windsurf`]).has(e.ide)?`servers`:`mcpServers`,f=s[d]??{};e.ide===`Copilot CLI`?f[t]={...o,tools:[`*`]}:f[t]=o,s[d]=f,l(a,{recursive:!0}),p(i,`${JSON.stringify(s,null,2)}\n`,`utf-8`),console.log(`  ${e.ide}: configured ${t} in ${i}`)}const S=new Set([`VS Code`,`VS Code Insiders`,`VSCodium`]);function C(t,n=!1){if(!S.has(t.ide))return;let r=h(t.configDir,`settings.json`),i={};if(c(r))try{let e=u(r,`utf-8`);i=JSON.parse(e)}catch{console.log(`  ${t.ide}: skipped settings.json (invalid JSON)`);return}let a=!1;for(let[t,r]of Object.entries(e))if(typeof r==`object`&&r){let e=typeof i[t]==`object`&&i[t]!==null?i[t]:{},n={...e,...r};JSON.stringify(n)!==JSON.stringify(e)&&(i[t]=n,a=!0)}else (n||!(t in i))&&(i[t]=r,a=!0);a&&(p(r,`${JSON.stringify(i,null,2)}\n`,`utf-8`),console.log(`  ${t.ide}: updated settings.json`))}function w(e,n,r,u,f=!1){let m=new Set;for(let e of n)e.globalScaffoldRoot&&m.add(e.globalScaffoldRoot);if(m.size===0){console.log(`  No IDEs with global scaffold support detected.`);return}let g=h(e,`scaffold`,`general`);for(let n of m){s(g,n,`agents`,u,f),s(g,n,`prompts`,u,f);let r=0;for(let e of t)c(h(g,`skills`,e))&&(s(g,n,`skills/${e}`,u,f),r++);for(let t of i){let r=h(e,`scaffold`,`flows`,t);if(!c(h(r,`steps`)))continue;let i=h(n,`flows`,t);l(i,{recursive:!0});let a=h(i,`skills`);c(a)&&(d(a,{recursive:!0,force:!0}),console.log(`  ${n}: migrated ${t} flow to steps/ layout`)),s(r,i,`steps`,u,f)}console.log(`  ${n}: scaffold updated (${r} skills)`)}let _=new Set,v=a(`aikit`,r),b=o(`aikit`,r);for(let e of n){if(!e.globalScaffoldRoot)continue;let t=e.globalScaffoldRoot;if(e.ide===`Claude Code`){let e=h(t,`CLAUDE.md`);p(e,`${v}\n---\n\n${b}`,`utf-8`),_.add(e)}else if(e.ide===`VS Code`||e.ide===`VS Code Insiders`||e.ide===`VSCodium`){let n=e.instructionsRoot??t;l(n,{recursive:!0});let r=h(n,`copilot-instructions.md`);_.has(r)||(p(r,`---\napplyTo: "**"\n---\n\n${v}\n---\n\n${b}`,`utf-8`),_.add(r));let i=h(y(),`.github`),a=h(i,`copilot-instructions.md`);_.has(a)||(l(i,{recursive:!0}),p(a,`${v}\n---\n\n${b}`,`utf-8`),_.add(a)),s(g,e.configDir,`prompts`,u,f)}else if(e.ide===`Cursor`||e.ide===`Cursor Nightly`){let e=h(t,`rules`);l(e,{recursive:!0});let n=h(e,`aikit.mdc`);_.has(n)||(p(n,`${v}\n---\n\n${b}`,`utf-8`),_.add(n))}else if(e.ide===`Windsurf`){let e=h(t,`rules`);l(e,{recursive:!0});let n=h(e,`aikit.md`);_.has(n)||(p(n,`${v}\n---\n\n${b}`,`utf-8`),_.add(n))}}_.size>0&&console.log(`  Instruction files: ${[..._].join(`, `)}`)}function T(e){let t=[];for(let n of e){if(!n.globalScaffoldRoot)continue;let e=n.globalScaffoldRoot;if(n.ide===`VS Code`||n.ide===`VS Code Insiders`||n.ide===`VSCodium`){let r=n.instructionsRoot??e;t.push(h(r,`kb.instructions.md`)),t.push(h(r,`aikit.instructions.md`))}else n.ide===`Cursor`||n.ide===`Cursor Nightly`?t.push(h(e,`rules`,`kb.mdc`)):n.ide===`Windsurf`&&t.push(h(e,`rules`,`kb.md`))}for(let e of t)c(e)&&(f(e),console.log(`  Removed legacy file: ${e}`))}async function E(e){let t=r,n=h(m(g(import.meta.url)),`..`,`..`,`..`,`..`,`..`,`package.json`),i=JSON.parse(u(n,`utf-8`)).version;console.log(`Initializing @vpxa/aikit v${i}...\n`);let a=_();l(a,{recursive:!0}),console.log(`  Global data store: ${a}`),v({version:1,workspaces:{}}),console.log(`  Created registry.json`);let o=b();if(o.length===0)console.log(`
+  No supported IDEs detected. You can manually add the MCP server config.`);else{console.log(`\n  Detected ${o.length} IDE(s):`);for(let n of o)x(n,t,e.force),C(n,e.force)}let s=h(m(g(import.meta.url)),`..`,`..`,`..`,`..`,`..`);console.log(`
+  Installing scaffold files:`),w(s,o,t,i,e.force),T(o),console.log(`
+User-level AI Kit installation complete!`),console.log(`
+Next steps:`),console.log(`  1. Open any workspace in your IDE`),console.log(`  2. The AI Kit server will auto-start and index the workspace`),console.log(`  3. Agents, prompts, skills & instructions are available globally`),console.log(`  4. No per-workspace init needed — just open a project and start coding`)}export{E as initUser};

package/packages/core/dist/index.d.ts

@@ -1,7 +1,358 @@
-import { AIKIT_GLOBAL_PATHS, AIKIT_PATHS, CATEGORY_PATTERN, CHUNK_SIZES, DEFAULT_CATEGORIES, EMBEDDING_DEFAULTS, FILE_LIMITS, SEARCH_DEFAULTS, STORE_DEFAULTS } from "./constants.js";
-import { CONTENT_TYPES, ChunkMetadata, ContentType, INDEX_MODES, IndexMode, IndexStats, KBConfig, KNOWLEDGE_ORIGINS, KnowledgeOrigin, KnowledgeRecord, RawChunk, SOURCE_TYPES, SearchResult, SourceType } from "./types.js";
-import { contentTypeToSourceType, detectContentType, sourceTypeContentTypes } from "./content-detector.js";
-import { ConfigError, EmbeddingError, IndexError, KBError, StoreError } from "./errors.js";
-import { GlobalRegistry, RegistryEntry, computePartitionKey, getGlobalDataDir, getPartitionDir, isUserInstalled, listWorkspaces, loadRegistry, lookupWorkspace, registerWorkspace, resolveStateDir, saveRegistry } from "./global-registry.js";
-import { LogLevel, LogListener, addLogListener, createLogger, getLogLevel, resetLogDir, serializeError, setFileSinkEnabled, setLogLevel } from "./logger.js";
+//#region packages/core/src/constants.d.ts
+/**
+ * Default constants for the AI Kit system.
+ */
+/**
+ * Centralized directory paths for all AI Kit artifacts.
+ * Single source of truth — change here to update everywhere.
+ */
+declare const AIKIT_PATHS: {
+  /** AI artifacts root directory */readonly ai: ".ai"; /** Onboard / produce_knowledge output directory */
+  readonly aiContext: ".ai/context"; /** Curated knowledge directory */
+  readonly aiCurated: ".ai/curated"; /** Restore points for destructive operations (codemod, rename, forget) */
+  readonly restorePoints: ".ai/restore-points"; /** Vector store + graph data */
+  readonly data: ".aikit-data"; /** Session state (stash, lanes, checkpoints, worksets, queues, replay, evidence-maps, snippets) */
+  readonly state: ".aikit-state"; /** Persistent warn/error logs for dogfooding review */
+  readonly logs: ".aikit-state/logs"; /** Brainstorming sessions */
+  readonly brainstorm: ".brainstorm"; /** Session handoff documents */
+  readonly handoffs: ".handoffs";
+};
+/**
+ * Global-mode directory paths (under ~/.aikit-data/).
+ * Used when AI Kit is installed at user level rather than per-workspace.
+ */
+declare const AIKIT_GLOBAL_PATHS: {
+  /** Root directory name for global data store */readonly root: ".aikit-data"; /** Registry file tracking all enrolled workspaces */
+  readonly registry: "registry.json";
+};
+/** Default chunk sizes by content type */
+declare const CHUNK_SIZES: {
+  readonly markdown: {
+    readonly max: 1500;
+    readonly min: 100;
+  };
+  readonly code: {
+    readonly max: 2000;
+    readonly min: 50;
+  };
+  readonly config: {
+    readonly max: 3000;
+    readonly min: 50;
+  };
+  readonly default: {
+    readonly max: 1500;
+    readonly min: 100;
+    readonly overlap: 200;
+  };
+};
+/** Default embedding config */
+declare const EMBEDDING_DEFAULTS: {
+  readonly model: "mixedbread-ai/mxbai-embed-large-v1";
+  readonly dimensions: 1024;
+};
+/** Default store config */
+declare const STORE_DEFAULTS: {
+  readonly backend: "lancedb";
+  readonly path: ".aikit-data";
+  readonly tableName: "knowledge";
+};
+/** File size limits */
+declare const FILE_LIMITS: {
+  readonly maxFileSizeBytes: 1000000;
+  readonly maxCuratedFileSizeBytes: 50000;
+};
+/** Search defaults */
+declare const SEARCH_DEFAULTS: {
+  readonly maxResults: 10;
+  readonly minScore: 0.25;
+};
+/** Category validation regex */
+declare const CATEGORY_PATTERN: RegExp;
+/** Default knowledge categories */
+declare const DEFAULT_CATEGORIES: readonly ["decisions", "patterns", "troubleshooting", "conventions", "architecture"];
+//#endregion
+//#region packages/core/src/types.d.ts
+/**
+ * Core types for the MCP AI Kit system.
+ */
+/** The origin of a knowledge record — how it was created */
+declare const KNOWLEDGE_ORIGINS: readonly ["indexed", "curated", "produced"];
+type KnowledgeOrigin = (typeof KNOWLEDGE_ORIGINS)[number];
+/** Coarse source classification derived from ContentType */
+declare const SOURCE_TYPES: readonly ["source", "documentation", "test", "config", "generated"];
+type SourceType = (typeof SOURCE_TYPES)[number];
+/** Indexing mode */
+declare const INDEX_MODES: readonly ["auto", "manual", "smart"];
+type IndexMode = (typeof INDEX_MODES)[number];
+/** Content type classification */
+declare const CONTENT_TYPES: readonly ["documentation", "code-typescript", "code-javascript", "code-python", "code-other", "config-json", "config-yaml", "config-toml", "config-env", "test-code", "cdk-stack", "markdown", "curated-knowledge", "produced-knowledge", "unknown"];
+type ContentType = (typeof CONTENT_TYPES)[number];
+/** A single knowledge record stored in the vector DB */
+interface KnowledgeRecord {
+  /** Unique identifier (deterministic hash of source + chunk index) */
+  id: string;
+  /** The text content of this chunk */
+  content: string;
+  /** Source file path relative to workspace root */
+  sourcePath: string;
+  /** Content type classification */
+  contentType: ContentType;
+  /** Heading path for markdown (e.g., "## Setup > ### Prerequisites") */
+  headingPath?: string;
+  /** Zero-based chunk index within the source file */
+  chunkIndex: number;
+  /** Total number of chunks from this source file */
+  totalChunks: number;
+  /** Start line in source file (1-based) */
+  startLine: number;
+  /** End line in source file (1-based) */
+  endLine: number;
+  /** File hash for incremental indexing */
+  fileHash: string;
+  /** ISO timestamp when this record was created/updated */
+  indexedAt: string;
+  /** How this record was created */
+  origin: KnowledgeOrigin;
+  /** User-defined tags for categorization */
+  tags: string[];
+  /** Category for curated/produced knowledge */
+  category?: string;
+  /** Version number for curated knowledge updates */
+  version: number;
+}
+/** A raw chunk produced by a chunker before embedding */
+interface RawChunk {
+  /** The text content */
+  text: string;
+  /** Source file path */
+  sourcePath: string;
+  /** Content type */
+  contentType: ContentType;
+  /** Heading path (markdown only) */
+  headingPath?: string;
+  /** Chunk index */
+  chunkIndex: number;
+  /** Total chunks from this file */
+  totalChunks: number;
+  /** Start line (1-based) */
+  startLine: number;
+  /** End line (1-based) */
+  endLine: number;
+}
+/** Metadata passed to a chunker */
+interface ChunkMetadata {
+  /** File path relative to workspace root */
+  sourcePath: string;
+  /** Detected content type */
+  contentType: ContentType;
+}
+/** Search result returned by the store */
+interface SearchResult {
+  /** The matching knowledge record */
+  record: KnowledgeRecord;
+  /** Similarity score (0-1, higher = more similar) */
+  score: number;
+}
+/** Configuration loaded from aikit.config.json */
+interface KBConfig {
+  /** MCP server name. Defaults to 'kb'. */
+  serverName?: string;
+  /** @deprecated Use `indexMode` instead. Maps true→'auto', false→'manual'. */
+  autoIndex?: boolean;
+  /**
+   * Indexing mode:
+   * - `auto`: Full index on startup (same as autoIndex=true)
+   * - `manual`: Only index via tool calls (same as autoIndex=false)
+   * - `smart`: On-demand + idle indexing (default)
+   */
+  indexMode?: IndexMode;
+  /**
+   * Prefix prepended to every MCP tool name to avoid collisions with other
+   * MCP servers. E.g. `"aikit_"` turns `search` → `aikit_search`.
+   * Defaults to `""` (no prefix) for backward compatibility.
+   */
+  toolPrefix?: string;
+  /**
+   * Active tool profile name. Controls which tools are registered.
+   * Built-in profiles: full, safe, research, minimal, discovery.
+   * Override with AIKIT_TOOLSET env var.
+   * Defaults to 'full'.
+   */
+  toolProfile?: string;
+  sources: Array<{
+    path: string;
+    excludePatterns: string[];
+  }>;
+  indexing: {
+    chunkSize: number;
+    chunkOverlap: number;
+    minChunkSize: number; /** Max files processed concurrently. Defaults to half of available CPU cores. */
+    concurrency?: number;
+    trickleIntervalMs?: number;
+    trickleBatchSize?: number;
+  };
+  embedding: {
+    model: string;
+    dimensions: number;
+  };
+  store: {
+    backend: string;
+    path: string;
+  };
+  curated: {
+    path: string; /** Curated storage adapter. Defaults to 'filesystem'. */
+    adapter?: 'filesystem';
+  };
+  /** Resolved directory for onboard/produce_knowledge output. User-level mode redirects this outside the project. */
+  onboardDir?: string;
+  /** Resolved state directory path. User-level mode redirects this to the partition. Defaults to `.aikit-state` in workspace root. */
+  stateDir?: string;
+  /** Enterprise RAG bridge configuration (optional) */
+  er?: {
+    /** Whether ER integration is enabled */enabled: boolean; /** Base URL of the ER API (e.g., https://xxx.execute-api.region.amazonaws.com/prod) */
+    baseUrl: string; /** Request timeout in milliseconds. Defaults to 5000. */
+    timeoutMs?: number; /** Cache TTL in milliseconds. Defaults to 21600000 (6 hours). */
+    cacheTtlMs?: number; /** Maximum cache entries. Defaults to 100. */
+    cacheMaxEntries?: number; /** Vector similarity threshold below which ER fallback triggers. Defaults to 0.45. */
+    fallbackThreshold?: number;
+  };
+}
+/** Index statistics */
+interface IndexStats {
+  totalRecords: number;
+  totalFiles: number;
+  contentTypeBreakdown: Record<string, number>;
+  lastIndexedAt: string | null;
+  storeBackend: string;
+  embeddingModel: string;
+}
+//#endregion
+//#region packages/core/src/content-detector.d.ts
+/**
+ * Detect the content type of a file based on its path.
+ */
+declare function detectContentType(filePath: string): ContentType;
+/** Derive the coarse SourceType from a ContentType. */
+declare function contentTypeToSourceType(ct: ContentType): SourceType;
+/** Get all ContentTypes that belong to a given SourceType. */
+declare function sourceTypeContentTypes(st: SourceType): ContentType[];
+//#endregion
+//#region packages/core/src/errors.d.ts
+declare class KBError extends Error {
+  readonly code: string;
+  readonly cause?: unknown;
+  constructor(message: string, code: string, cause?: unknown);
+}
+declare class EmbeddingError extends KBError {
+  constructor(message: string, cause?: unknown);
+}
+declare class StoreError extends KBError {
+  constructor(message: string, cause?: unknown);
+}
+declare class IndexError extends KBError {
+  constructor(message: string, cause?: unknown);
+}
+declare class ConfigError extends KBError {
+  constructor(message: string, cause?: unknown);
+}
+//#endregion
+//#region packages/core/src/global-registry.d.ts
+/**
+ * Global registry for tracking workspaces enrolled in global MCP install mode.
+ * Registry lives at ~/.aikit-data/registry.json alongside per-workspace partition directories.
+ */
+/** A single workspace entry in the global registry. */
+interface RegistryEntry {
+  /** Partition key: <folder-name>-<sha256-8chars> */
+  partition: string;
+  /** Absolute path to workspace root */
+  workspacePath: string;
+  /** ISO timestamp of first registration */
+  registeredAt: string;
+  /** ISO timestamp of last server start */
+  lastAccessedAt: string;
+}
+/** Schema for ~/.aikit-data/registry.json */
+interface GlobalRegistry {
+  version: 1;
+  workspaces: Record<string, RegistryEntry>;
+}
+/**
+ * Get the global data directory root.
+ * Override with `AIKIT_GLOBAL_DATA_DIR` env var for testing.
+ */
+declare function getGlobalDataDir(): string;
+/**
+ * Compute a deterministic partition key from a workspace path.
+ * Format: <folder-basename>-<sha256(absolutePath)-first8hex>
+ */
+declare function computePartitionKey(cwd: string): string;
+/**
+ * Load the global registry. Returns empty registry if file doesn't exist.
+ */
+declare function loadRegistry(): GlobalRegistry;
+/**
+ * Save the global registry atomically with file locking.
+ * Uses O_CREAT|O_EXCL lock file + write-to-tmp + rename pattern.
+ */
+declare function saveRegistry(registry: GlobalRegistry): void;
+/**
+ * Register a workspace in the global registry. Creates partition directory.
+ * If already registered, updates lastAccessedAt.
+ */
+declare function registerWorkspace(cwd: string): RegistryEntry;
+/**
+ * Look up a workspace in the registry by cwd.
+ */
+declare function lookupWorkspace(cwd: string): RegistryEntry | undefined;
+/**
+ * List all registered workspaces.
+ */
+declare function listWorkspaces(): RegistryEntry[];
+/**
+ * Get the absolute path to a partition's data directory.
+ */
+declare function getPartitionDir(partition: string): string;
+/**
+ * Check whether user-level mode is installed (registry.json exists in ~/.aikit-data/).
+ */
+declare function isUserInstalled(): boolean;
+/**
+ * Resolve the state directory for a given workspace root.
+ * - User-level install: `~/.aikit-data/<partition>/state/`
+ * - Workspace-level install: `<cwd>/.aikit-state/`
+ */
+declare function resolveStateDir(cwd: string): string;
+//#endregion
+//#region packages/core/src/logger.d.ts
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+type LogListener = (entry: {
+  level: LogLevel;
+  component: string;
+  message: string;
+  data?: Record<string, unknown>;
+}) => void;
+declare function setLogLevel(level: LogLevel): void;
+declare function getLogLevel(): LogLevel;
+declare function setFileSinkEnabled(enabled: boolean): void;
+/** Reset resolved log directory (for testing). */
+declare function resetLogDir(): void;
+/**
+ * Serialize an unknown error into a structured record suitable for JSON logging.
+ * Always includes stack traces for Error instances — they are essential for
+ * root-cause analysis regardless of the active log level.
+ */
+declare function serializeError(err: unknown): Record<string, unknown>;
+/**
+ * Register a listener that receives all log messages (after level filtering).
+ * Returns a cleanup function to remove the listener.
+ */
+declare function addLogListener(listener: LogListener): () => void;
+declare function createLogger(component: string): {
+  debug: (msg: string, data?: Record<string, unknown>) => void;
+  info: (msg: string, data?: Record<string, unknown>) => void;
+  warn: (msg: string, data?: Record<string, unknown>) => void;
+  error: (msg: string, data?: Record<string, unknown>) => void;
+};
+//#endregion
 export { AIKIT_GLOBAL_PATHS, AIKIT_PATHS, CATEGORY_PATTERN, CHUNK_SIZES, CONTENT_TYPES, ChunkMetadata, ConfigError, ContentType, DEFAULT_CATEGORIES, EMBEDDING_DEFAULTS, EmbeddingError, FILE_LIMITS, GlobalRegistry, INDEX_MODES, IndexError, IndexMode, IndexStats, KBConfig, KBError, KNOWLEDGE_ORIGINS, KnowledgeOrigin, KnowledgeRecord, LogLevel, LogListener, RawChunk, RegistryEntry, SEARCH_DEFAULTS, SOURCE_TYPES, STORE_DEFAULTS, SearchResult, SourceType, StoreError, addLogListener, computePartitionKey, contentTypeToSourceType, createLogger, detectContentType, getGlobalDataDir, getLogLevel, getPartitionDir, isUserInstalled, listWorkspaces, loadRegistry, lookupWorkspace, registerWorkspace, resetLogDir, resolveStateDir, saveRegistry, serializeError, setFileSinkEnabled, setLogLevel, sourceTypeContentTypes };