@vpxa/aikit 0.1.59 → 0.1.61

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

@@ -1,79 +0,0 @@
-//#region packages/cli/src/commands/init/frontmatter.d.ts
-/**
- * Init module — YAML frontmatter parsing and merging for agent files.
- *
- * Agent `.agent.md` files use YAML frontmatter with fields like `tools`, `model`,
- * `description`, and `argument-hint`. When updating these files, we need to
- * merge new tools while preserving user customizations (model choice, extra tools).
- *
- * This is a lightweight parser — no full YAML dependency. It handles the specific
- * frontmatter format used by Copilot agent files.
- */
-interface ParsedFrontmatter {
-  /** Raw key-value pairs from YAML frontmatter. */
-  fields: Record<string, string>;
-  /** Parsed metadata sub-fields nested under `metadata:`. */
-  metadata: Record<string, string>;
-  /** Parsed tools array (from YAML inline array syntax). */
-  tools: string[];
-  /** Body content after the closing `---`. */
-  body: string;
-}
-/**
- * Structured metadata for SKILL.md files — HeraSpec-inspired.
- * All fields beyond name/description are optional for backward compatibility.
- */
-interface SkillFrontmatter {
-  name: string;
-  description: string;
-  category?: 'cross-cutting' | 'domain' | 'project';
-  domain?: string;
-  applicability?: 'always' | 'on-demand';
-  inputs?: string[];
-  outputs?: string[];
-  requires?: string[];
-  relatedSkills?: string[];
-  tools?: string[];
-  model?: string;
-  'argument-hint'?: string;
-}
-/**
- * Parse a markdown file with YAML frontmatter.
- *
- * Expects format:
- * ```
- * ---
- * key: value
- * tools: [tool1, tool2]
- * ---
- * body content
- * ```
- */
-declare function parseFrontmatter(content: string): ParsedFrontmatter;
-/**
- * Parse SKILL.md frontmatter into a typed SkillFrontmatter object.
- * Uses parseFrontmatter() internally, then maps array fields.
- */
-declare function parseSkillFrontmatter(content: string): SkillFrontmatter;
-/**
- * Parse a YAML inline array: `[tool1, tool2, tool3]` → string[]
- */
-declare function parseToolsArray(value: string): string[];
-/**
- * Serialize tools array back to YAML inline syntax.
- */
-declare function serializeToolsArray(tools: string[]): string;
-/**
- * Merge two parsed frontmatter files (source = new upstream, deployed = user's current).
- *
- * Merge rules:
- * - `tools`: UNION of both arrays (add new, keep user-added). Order: source first, then user extras.
- * - `model`: KEEP deployed (user's choice).
- * - `description`, `argument-hint`: TAKE from source (upstream updates).
- * - Body: TAKE from source (structural changes come from upstream).
- *
- * Returns the merged file content as a string.
- */
-declare function mergeFrontmatter(sourceContent: string, deployedContent: string): string;
-//#endregion
-export { ParsedFrontmatter, SkillFrontmatter, mergeFrontmatter, parseFrontmatter, parseSkillFrontmatter, parseToolsArray, serializeToolsArray };

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

@@ -1,2 +0,0 @@
-const e=[`inputs`,`outputs`,`requires`,`relatedSkills`],t=[`model`],n=[`category`,`domain`,`applicability`],r=new Set([`__proto__`,`constructor`,`prototype`]);function i(e,t){return e.metadata[t]??e.fields[t]}function a(e,t){let n=i(e,t);return n?c(n):[]}function o(e){let t=Object.create(null),n=Object.create(null),i=[],a=e,o=e.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);if(!o)return{fields:t,metadata:n,tools:i,body:a};let s=o[1];a=o[2];let l=!1;for(let e of s.split(/\r?\n/)){if(l){if(e.trim()===``)continue;let t=e.match(/^\s{2,}(\S+?):\s*(.*)$/);if(t){let[,e,i]=t;if(r.has(e))continue;n[e]=i;continue}l=!1}let a=e.match(/^(\S+?):\s*(.*)$/);if(!a)continue;let[,o,s]=a;if(o===`metadata`&&s.trim()===``){l=!0;continue}r.has(o)||(t[o]=s,o===`tools`&&(i=c(s)))}return{fields:t,metadata:n,tools:i,body:a}}function s(t){let n=o(t),r={name:n.fields.name??``,description:n.fields.description??``},s=i(n,`category`);s&&(r.category=s);let c=i(n,`domain`);c&&(r.domain=c);let l=i(n,`applicability`);l&&(r.applicability=l),n.fields.model&&(r.model=n.fields.model),n.fields[`argument-hint`]&&(r[`argument-hint`]=n.fields[`argument-hint`]),n.tools.length>0&&(r.tools=n.tools);for(let t of e){let e=a(n,t);e.length>0&&(r[t]=e)}return r}function c(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 l(e){return`[${e.join(`, `)}]`}function u(r,s){let c=o(r),u=o(s),d={...c.fields},f={...c.metadata};for(let[e,t]of Object.entries(u.metadata))e in f||(f[e]=t);for(let e of t)u.fields[e]&&(d[e]=u.fields[e]);for(let e of n){let t=i(u,e);t&&(f[e]=t)}for(let t of[...n,...e])delete d[t];delete d.metadata;let p=c.tools,m=u.tools,h=new Set(p),g=m.filter(e=>!h.has(e)),_=[...p,...g];_.length>0&&(d.tools=l(_));for(let t of e){let e=a(c,t),n=a(u,t),r=new Set(e),i=n.filter(e=>!r.has(e)),o=[...e,...i];o.length>0?f[t]=l(o):delete f[t]}let v=[`---`],y=[`name`,`description`,`argument-hint`,`tools`,`model`],b=[`category`,`domain`,`applicability`,`inputs`,`outputs`,`requires`,`relatedSkills`],x=new Set;for(let e of y)e in d&&(v.push(`${e}: ${d[e]}`),x.add(e));for(let[e,t]of Object.entries(d))x.has(e)||v.push(`${e}: ${t}`);let S=[],C=new Set;for(let e of b){let t=f[e];t&&(S.push(`  ${e}: ${t}`),C.add(e))}for(let[e,t]of Object.entries(f))!C.has(e)&&t&&S.push(`  ${e}: ${t}`);return S.length>0&&(v.push(`metadata:`),v.push(...S)),v.push(`---`),`${v.join(`
-`)}\n${c.body}`}export{u as mergeFrontmatter,o as parseFrontmatter,s as parseSkillFrontmatter,c as parseToolsArray,l as serializeToolsArray};

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

@@ -1,36 +0,0 @@
-//#region packages/cli/src/commands/init/index.d.ts
-/**
- * `aikit init` — scaffold AI Kit in the current directory.
- *
- * Creates aikit.config.json, .gitignore entry, IDE-specific config,
- * agent instruction files, skills, scaffold agents/prompts,
- * and curated knowledge directories.
- *
- * This is the main orchestrator that wires together the focused modules:
- *   config.ts    — aikit.config.json + .gitignore
- *   adapters.ts  — IDE detection + adapter interface
- *   scaffold.ts  — copy scaffold agents/prompts + skills from package
- *   curated.ts   — curated knowledge directories
- *   templates.ts — copilot-instructions.md + AGENTS.md content
- */
-declare function initProject(options: {
-  force: boolean;
-}): Promise<void>;
-/**
- * Smart init — scaffold-only if user-level detected, full workspace otherwise.
- */
-declare function initSmart(options: {
-  force: boolean;
-}): Promise<void>;
-/**
- * Scaffold-only init for workspaces when user-level mode is active.
- * Creates instruction files, scaffold agents/prompts, and curated dirs
- * but does NOT create aikit.config.json, mcp.json, or local skills.
- */
-declare function initScaffoldOnly(options: {
-  force: boolean;
-}): Promise<void>;
-/** Generate a JSON guide report comparing installed vs source files. */
-declare function guideProject(): Promise<void>;
-//#endregion
-export { guideProject, initProject, initScaffoldOnly, initSmart };

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

@@ -1,5 +0,0 @@
-import{FLOW_DIRS as e,SKILL_NAMES as t}from"./constants.js";import{detectIde as n,getAdapter as r}from"./adapters.js";import{ensureGitignore as i,getServerName as a,writeKbConfig as o}from"./config.js";import{createCuratedDirs as s}from"./curated.js";import{guideFlows as c,guideScaffold as l,guideSkills as u,smartCopyClaudeCommands as d,smartCopyFlows as f,smartCopyScaffold as p,smartCopySkills as m}from"./scaffold.js";import{readFileSync as h}from"node:fs";import{dirname as g,resolve as _}from"node:path";import{fileURLToPath as v}from"node:url";import{isUserInstalled as y}from"../../../../core/dist/index.js";async function b(c){let l=process.cwd();if(!o(l,c.force))return;i(l);let u=a(),b=r(n(l));b.writeMcpConfig(l,u),b.writeInstructions(l,u),b.writeAgentsMd(l,u);let x=_(g(v(import.meta.url)),`..`,`..`,`..`,`..`,`..`),S=JSON.parse(h(_(x,`package.json`),`utf-8`)).version;m(l,x,[...t],S,c.force),f(l,x,[...e],S,c.force),p(l,x,b.scaffoldDir,S,c.force),d(l,x,S,c.force),s(l),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`),y()&&console.log(`
-Note: User-level AI Kit is also installed. This workspace uses its own local data store.`)}async function x(e){y()?await S(e):await b(e)}async function S(t){let o=process.cwd(),c=a(),l=r(n(o));l.writeInstructions(o,c),l.writeAgentsMd(o,c);let u=_(g(v(import.meta.url)),`..`,`..`,`..`,`..`,`..`),m=JSON.parse(h(_(u,`package.json`),`utf-8`)).version;p(o,u,l.scaffoldDir,m,t.force),d(o,u,m,t.force),f(o,u,[...e],m,t.force),s(o),i(o),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 C(){let i=process.cwd(),a=r(n(i)),o=_(g(v(import.meta.url)),`..`,`..`,`..`,`..`,`..`),s=[...u(i,o,[...t]),...c(i,o,[...e]),...l(i,o,a.scaffoldDir)],d={summary:{total:s.length,new:s.filter(e=>e.status===`new`).length,outdated:s.filter(e=>e.status===`outdated`).length,current:s.filter(e=>e.status===`current`).length},files:s};console.log(JSON.stringify(d,null,2))}export{C as guideProject,b as initProject,S as initScaffoldOnly,x as initSmart};

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

@@ -1,72 +0,0 @@
-//#region packages/cli/src/commands/init/manifest.d.ts
-/**
- * Init module — scaffold manifest for smart updates.
- *
- * Tracks which scaffold files have been deployed and their source hashes,
- * enabling incremental updates that preserve user customizations while
- * applying new features from upstream.
- *
- * Manifest file: `.aikit-scaffold.json` stored alongside the scaffold root
- * (e.g. `~/.copilot/.aikit-scaffold.json` for user-level, `.github/.aikit-scaffold.json` for workspace).
- */
-/**
- * How a file should be updated when the source changes:
- *
- * - `overwrite`: Replace entirely (shared protocols, templates, skills).
- * - `merge-frontmatter`: Merge YAML frontmatter tools (union), keep user model,
- *   replace body. Used for agent .md files that users may customize.
- * - `regenerate`: Re-run the template generator (copilot-instructions.md, CLAUDE.md).
- */
-type UpdateStrategy = 'overwrite' | 'merge-frontmatter' | 'regenerate';
-interface ManifestEntry {
-  /** SHA-256 hash (16-char hex) of the source content when deployed. */
-  sourceHash: string;
-  /** Update strategy for this file. */
-  strategy: UpdateStrategy;
-  /** ISO timestamp of last deployment. */
-  updatedAt: string;
-}
-interface ScaffoldManifest {
-  /** Package version that generated this manifest. */
-  version: string;
-  /** ISO timestamp of manifest creation/update. */
-  generatedAt: string;
-  /** File entries keyed by relative path from scaffold root. */
-  files: Record<string, ManifestEntry>;
-}
-/** Compute a 16-char hex SHA-256 hash of content (consistent with file-hasher). */
-declare function hashContent(content: string): string;
-/** Read and parse a manifest file; returns null if missing or invalid. */
-declare function readManifest(manifestPath: string): ScaffoldManifest | null;
-/** Write a manifest to disk. */
-declare function writeManifest(manifestPath: string, manifest: ScaffoldManifest): void;
-/**
- * Determine the update strategy for a file based on its relative path.
- *
- * Strategy rules:
- * - *.agent.md (not under _shared/) → merge-frontmatter
- * - SKILL.md (not under _shared/ or templates/) → merge-frontmatter
- * - _shared/*.md, templates/*.md → overwrite
- * - *.prompt.md, README.md → overwrite
- * - Everything else → overwrite
- */
-declare function getUpdateStrategy(relativePath: string): UpdateStrategy;
-/**
- * Check whether a deployed file needs updating.
- *
- * Returns:
- * - `'new'`: File not in manifest (first deployment).
- * - `'outdated'`: Source hash changed since last deployment.
- * - `'current'`: Source hash matches — no update needed.
- */
-declare function getFileStatus(manifest: ScaffoldManifest | null, relativePath: string, sourceContent: string): 'new' | 'outdated' | 'current';
-/**
- * Record a file deployment in the manifest.
- */
-declare function recordDeployment(manifest: ScaffoldManifest, relativePath: string, sourceContent: string, strategy?: UpdateStrategy): void;
-/**
- * Create a fresh manifest for a new deployment.
- */
-declare function createManifest(version: string): ScaffoldManifest;
-//#endregion
-export { ManifestEntry, ScaffoldManifest, UpdateStrategy, createManifest, getFileStatus, getUpdateStrategy, hashContent, readManifest, recordDeployment, writeManifest };

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

@@ -1 +0,0 @@
-import{existsSync as e,readFileSync as t,writeFileSync as n}from"node:fs";import{createHash as r}from"node:crypto";function i(e){return r(`sha256`).update(e).digest(`hex`).slice(0,16)}function a(n){if(!e(n))return null;try{let e=t(n,`utf-8`),r=JSON.parse(e);return!r.version||!r.files?null:r}catch{return null}}function o(e,t){n(e,`${JSON.stringify(t,null,2)}\n`,`utf-8`)}function s(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 c(e,t,n){if(!e)return`new`;let r=e.files[t];return r?r.sourceHash===i(n)?`current`:`outdated`:`new`}function l(e,t,n,r){e.files[t]={sourceHash:i(n),strategy:r??s(t),updatedAt:new Date().toISOString()}}function u(e){return{version:e,generatedAt:new Date().toISOString(),files:{}}}export{u as createManifest,c as getFileStatus,s as getUpdateStrategy,i as hashContent,a as readManifest,l as recordDeployment,o as writeManifest};

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

@@ -1,58 +0,0 @@
-import { ScaffoldManifest } from "./manifest.js";
-
-//#region packages/cli/src/commands/init/scaffold.d.ts
-interface GuideFileEntry {
-  status: 'new' | 'outdated' | 'current';
-  relativePath: string;
-  sourcePath: string;
-  content?: string;
-}
-/** Recursively copy a directory. When force=false, skip files that already exist. */
-declare function copyDirectoryRecursive(srcDir: string, destDir: string, logPrefix?: string, force?: boolean): void;
-/**
- * Manifest-aware recursive copy with per-file merge strategies.
- *
- * For each file:
- * - `new`: Deploy and record in manifest.
- * - `outdated` + `overwrite` strategy: Replace entirely.
- * - `outdated` + `merge-frontmatter`: Merge tools (union), keep user model, update body.
- * - `current`: Skip (source unchanged).
- * - `force=true`: Always overwrite (resets manifest entry).
- */
-declare function smartCopyDirectory(srcDir: string, destDir: string, manifest: ScaffoldManifest, logPrefix?: string, force?: boolean): void;
-/**
- * Smart-copy scaffold files with manifest tracking.
- * Reads/creates manifest at `<destRoot>/.aikit-scaffold.json`.
- */
-declare function smartCopyScaffold(cwd: string, pkgRoot: string, ide: string, version: string, force?: boolean): void;
-/**
- * Smart-copy skill files with manifest tracking.
- */
-declare function smartCopySkills(cwd: string, pkgRoot: string, skillNames: string[], version: string, force?: boolean): void;
-/**
- * Smart-copy a directory with a standalone manifest (for user-level scaffold).
- * Manifest stored at `<destRoot>/.aikit-scaffold.json`.
- */
-declare function smartCopySubdir(srcDir: string, destRoot: string, subdir: string, version: string, force?: boolean): void;
-/** Copy scaffold files for a given IDE into the workspace .github/ directory. */
-declare function copyScaffold(cwd: string, pkgRoot: string, ide: string, force?: boolean): void;
-/** Copy skill directories from the package into .github/skills/. */
-declare function copySkills(cwd: string, pkgRoot: string, skillNames: string[], force?: boolean): void;
-/** Generate guide report for scaffold files — compare source vs destination. */
-declare function guideScaffold(cwd: string, pkgRoot: string, ide: string): GuideFileEntry[];
-/** Generate guide report for skill files — compare source vs destination. */
-declare function guideSkills(cwd: string, pkgRoot: string, skillNames: string[]): GuideFileEntry[];
-/**
- * Smart-copy built-in flow step files with manifest tracking.
- * Copies from scaffold/flows/<flowName>/steps/ into .github/flows/<flowName>/steps/.
- */
-declare function smartCopyFlows(cwd: string, pkgRoot: string, flowDirs: string[], version: string, force?: boolean): void;
-/** Generate guide report for flow step files. */
-declare function guideFlows(cwd: string, pkgRoot: string, flowDirs: string[]): GuideFileEntry[];
-/**
- * Copy Claude Code slash commands from scaffold/claude-code/commands/ to .claude/commands/.
- * Uses the same manifest-based tracking as other scaffold copy functions.
- */
-declare function smartCopyClaudeCommands(cwd: string, pkgRoot: string, version: string, force?: boolean): void;
-//#endregion
-export { GuideFileEntry, copyDirectoryRecursive, copyScaffold, copySkills, guideFlows, guideScaffold, guideSkills, smartCopyClaudeCommands, smartCopyDirectory, smartCopyFlows, smartCopyScaffold, smartCopySkills, smartCopySubdir };

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

@@ -1 +0,0 @@
-import{mergeFrontmatter as e}from"./frontmatter.js";import{createManifest as t,getFileStatus as n,getUpdateStrategy as r,readManifest as i,recordDeployment as a,writeManifest as o}from"./manifest.js";import{copyFileSync as s,existsSync as c,mkdirSync as l,readFileSync as u,readdirSync as d,rmSync as f,statSync as p,unlinkSync as m,writeFileSync as h}from"node:fs";import{dirname as g,resolve as _}from"node:path";import{createHash as v}from"node:crypto";function y(e,t,n=``,r=!1){l(t,{recursive:!0});for(let i of d(e)){let a=_(e,i),o=_(t,i),l=n?`${n}/${i}`:i;p(a).isDirectory()?y(a,o,l,r):(r||!c(o))&&s(a,o)}}function b(t,i,o,s=``,f=!1){if(c(t)){l(i,{recursive:!0});for(let m of d(t)){let d=_(t,m),v=_(i,m),y=s?`${s}/${m}`:m;if(p(d).isDirectory()){b(d,v,o,y,f);continue}let x=u(d,`utf-8`);if(f){l(g(v),{recursive:!0}),h(v,x,`utf-8`),a(o,y,x);continue}let S=n(o,y,x);if(S!==`current`){if(S===`new`&&!c(v)){l(g(v),{recursive:!0}),h(v,x,`utf-8`),a(o,y,x);continue}if(S===`new`&&c(v)){a(o,y,x);continue}r(y)===`merge-frontmatter`&&c(v)?h(v,e(x,u(v,`utf-8`)),`utf-8`):(l(g(v),{recursive:!0}),h(v,x,`utf-8`)),a(o,y,x)}}}}function x(e,t,n,r){let i=new Set;if(c(e)){let t=(e,n)=>{for(let a of d(e)){let o=_(e,a),s=n?`${n}/${a}`:a;p(o).isDirectory()?t(o,s):i.add(`${r}/${s}`)}};t(e,``)}let a=[];for(let e of Object.keys(n.files)){if(!e.startsWith(`${r}/`)||i.has(e))continue;let o=_(t,e.slice(r.length+1));c(o)&&(m(o),a.push(e)),delete n.files[e]}return a}function S(e,n,r,a,s=!1){let l=_(n,`scaffold`,r),u=_(e,`.github`),d=_(u,`.aikit-scaffold.json`),f=i(d)??t(a);f.version=a;for(let e of[`agents`,`prompts`]){let t=_(l,e);c(t)&&b(t,_(u,e),f,e,s)}if(s)for(let e of[`agents`,`prompts`]){let t=x(_(l,e),_(u,e),f,e);for(let e of t)console.log(`  Removed orphaned scaffold file: ${e}`)}o(d,f)}function C(e,n,r,a,s=!1){let l=_(e,`.github`),u=_(l,`.aikit-scaffold.json`),d=i(u)??t(a);d.version=a;for(let e of r){let t=_(n,`scaffold`,`general`,`skills`,e);c(t)&&b(t,_(l,`skills`,e),d,`skills/${e}`,s)}o(u,d)}function w(e,n,r,a,s=!1){let l=_(e,r);if(!c(l))return;let u=_(n,r),d=_(n,`.aikit-scaffold.json`),f=i(d)??t(a);if(f.version=a,b(l,u,f,r,s),s){let e=x(l,u,f,r);for(let t of e)console.log(`  Removed orphaned scaffold file: ${t}`)}o(d,f)}function T(e,t,n,r){if(c(e))for(let i of d(e)){let a=_(e,i),o=n?`${n}/${i}`:i;if(p(a).isDirectory())T(a,_(t,i),o,r);else{let e=_(t,i),n=u(a,`utf-8`);c(e)?n===u(e,`utf-8`)?r.push({status:`current`,relativePath:o,sourcePath:a}):r.push({status:`outdated`,relativePath:o,sourcePath:a,content:n}):r.push({status:`new`,relativePath:o,sourcePath:a,content:n})}}}function E(e,t,n,r=!1){let i=_(t,`scaffold`,n);for(let t of[`agents`,`prompts`]){let n=_(i,t),a=_(e,`.github`,t);c(n)&&y(n,a,``,r)}}function D(e,t,n,r=!1){for(let i of n){let n=_(t,`scaffold`,`general`,`skills`,i);c(n)&&y(n,_(e,`.github`,`skills`,i),`skills/${i}`,r)}}function O(e,t,n){let r=[],i=_(t,`scaffold`,n);for(let t of[`agents`,`prompts`])T(_(i,t),_(e,`.github`,t),t,r);return r}function k(e,t,n){let r=[];for(let i of n){let n=_(t,`scaffold`,`general`,`skills`,i);c(n)&&T(n,_(e,`.github`,`skills`,i),`skills/${i}`,r)}return r}function A(e,n,r,a,s=!1){let l=_(e,`.github`),u=_(l,`.aikit-scaffold.json`),d=i(u)??t(a);d.version=a;for(let e of r){let t=_(n,`scaffold`,`flows`,e,`steps`);if(!c(t))continue;let r=_(l,`flows`,e,`skills`);c(r)&&f(r,{recursive:!0,force:!0}),b(t,_(l,`flows`,e,`steps`),d,`flows/${e}/steps`,s)}o(u,d)}function j(e,t,n){let r=[];for(let i of n){let n=_(t,`scaffold`,`flows`,i,`steps`);c(n)&&T(n,_(e,`.github`,`flows`,i,`steps`),`flows/${i}/steps`,r)}return r}function M(e,t,n,r=!1){let i=_(t,`scaffold`,`claude-code`,`commands`);if(!c(i))return;let a=_(e,`.claude`),o=_(a,`.aikit-scaffold.json`),s;s=c(o)?JSON.parse(u(o,`utf-8`)):{version:n,generatedAt:new Date().toISOString(),files:{}},s.version=n,s.generatedAt=new Date().toISOString(),l(_(a,`commands`),{recursive:!0});let f=d(i);for(let e of f){let t=_(i,e);if(!p(t).isFile())continue;let n=`commands/${e}`,o=_(a,n),l=u(t,`utf-8`),d=v(`sha256`).update(l).digest(`hex`).slice(0,16),f=s.files[n];if(f&&!r&&c(o)){let e=u(o,`utf-8`);if(v(`sha256`).update(e).digest(`hex`).slice(0,16)!==f.sourceHash)continue}h(o,l,`utf-8`),s.files[n]={sourceHash:d,strategy:`overwrite`,updatedAt:new Date().toISOString()}}if(r){let e=x(i,_(a,`commands`),s,`commands`);for(let t of e)console.log(`  Removed orphaned scaffold file: ${t}`)}h(o,JSON.stringify(s,null,2),`utf-8`)}export{y as copyDirectoryRecursive,E as copyScaffold,D as copySkills,j as guideFlows,O as guideScaffold,k as guideSkills,M as smartCopyClaudeCommands,b as smartCopyDirectory,A as smartCopyFlows,S as smartCopyScaffold,C as smartCopySkills,w as smartCopySubdir};

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

@@ -1,9 +0,0 @@
-//#region packages/cli/src/commands/init/templates.d.ts
-/**
- * Init module — instruction and AGENTS.md template builders.
- * Content for copilot-instructions.md and AGENTS.md.
- */
-declare function buildCopilotInstructions(projectName: string, serverName: string): string;
-declare function buildAgentsMd(projectName: string, serverName: string): string;
-//#endregion
-export { buildAgentsMd, buildCopilotInstructions };

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

@@ -1,61 +0,0 @@
-//#region packages/cli/src/commands/init/user.d.ts
-/**
- * `aikit init --user` — configure AI Kit as a user-level MCP server.
- *
- * Auto-detects all installed IDEs, writes user-level mcp.json for each,
- * installs skills to a user-level location, and creates the shared data store.
- */
-/** Represents a user-level IDE config location. */
-interface UserLevelIdePath {
-  ide: string;
-  configDir: string;
-  mcpConfigPath: string;
-  /**
-   * User-level scaffold root for agents/prompts/skills.
-   * VS Code: ~/.copilot, Claude Code: ~/.claude, Cursor: ~/.cursor, Windsurf: ~/.windsurf.
-   * Null if the IDE has no user-level scaffold support.
-   */
-  globalScaffoldRoot: string | null;
-  /**
-   * User-level instruction file root (may differ from scaffold root).
-   * VS Code uses ~/.copilot/instructions/ for .instructions.md files.
-   * When null, falls back to globalScaffoldRoot.
-   */
-  instructionsRoot: string | null;
-}
-/**
- * Detect all installed IDEs by checking if their user-level config directory exists.
- */
-declare function detectInstalledIdes(): UserLevelIdePath[];
-/**
- * Write or merge the AI Kit server entry into a user-level mcp.json.
- * Preserves all existing non-AI Kit entries. Backs up existing file before writing.
- */
-declare function writeUserLevelMcpConfig(idePath: UserLevelIdePath, serverName: string, force?: boolean): void;
-/**
- * Merge aikit-related settings into a VS Code-family IDE's settings.json.
- * Preserves all existing settings. Only writes keys defined in VSCODE_SETTINGS.
- */
-declare function writeVscodeSettings(idePath: UserLevelIdePath, force?: boolean): void;
-/**
- * Install agents, prompts, skills, and instruction files to each detected IDE's
- * global scaffold root.
- *
- * Each IDE has its own global discovery path:
- *   - VS Code / VSCodium:  ~/.copilot/ (agents/, prompts/, skills/, instructions/)
- *   - Claude Code:         ~/.claude/ (CLAUDE.md, agents/)
- *   - Cursor:              ~/.cursor/ (rules/aikit.mdc, agents/, prompts/, skills/)
- *   - Windsurf:            ~/.windsurf/ (rules/aikit.md, agents/, prompts/, skills/)
- *
- * Multiple IDEs may share the same root (e.g. VS Code + VSCodium both use ~/.copilot/).
- * We deduplicate scaffold files but generate IDE-specific instruction files.
- */
-declare function installGlobalScaffold(pkgRoot: string, ides: UserLevelIdePath[], serverName: string, version: string, force?: boolean): void;
-/**
- * Main orchestrator for `aikit init --user`.
- */
-declare function initUser(options: {
-  force: boolean;
-}): Promise<void>;
-//#endregion
-export { UserLevelIdePath, detectInstalledIdes, initUser, installGlobalScaffold, writeUserLevelMcpConfig, writeVscodeSettings };

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

@@ -1,5 +0,0 @@
-import{FLOW_DIRS as e,MCP_SERVER_ENTRY as t,SERVER_NAME as n,SKILL_NAMES as r,VSCODE_SETTINGS as i}from"./constants.js";import{buildAgentsMd as a,buildCopilotInstructions as o}from"./templates.js";import{smartCopySubdir as s}from"./scaffold.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,n,r=!1){let{mcpConfigPath:i,configDir:a}=e,o={...t},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??{})[n]&&!r){console.log(`  ${e.ide}: ${n} 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[n]={...o,tools:[`*`]}:f[n]=o,s[d]=f,l(a,{recursive:!0}),p(i,`${JSON.stringify(s,null,2)}\n`,`utf-8`),console.log(`  ${e.ide}: configured ${n} in ${i}`)}const S=new Set([`VS Code`,`VS Code Insiders`,`VSCodium`]);function C(e,t=!1){if(!S.has(e.ide))return;let n=h(e.configDir,`settings.json`),r={};if(c(n))try{let e=u(n,`utf-8`);r=JSON.parse(e)}catch{console.log(`  ${e.ide}: skipped settings.json (invalid JSON)`);return}let a=!1;for(let[e,n]of Object.entries(i))if(typeof n==`object`&&n){let t=typeof r[e]==`object`&&r[e]!==null?r[e]:{},i={...t,...n};JSON.stringify(i)!==JSON.stringify(t)&&(r[e]=i,a=!0)}else (t||!(e in r))&&(r[e]=n,a=!0);a&&(p(n,`${JSON.stringify(r,null,2)}\n`,`utf-8`),console.log(`  ${e.ide}: updated settings.json`))}function w(t,n,i,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(t,`scaffold`,`general`);for(let n of m){s(g,n,`agents`,u,f),s(g,n,`prompts`,u,f);let i=0;for(let e of r)c(h(g,`skills`,e))&&(s(g,n,`skills/${e}`,u,f),i++);for(let r of e){let e=h(t,`scaffold`,`flows`,r);if(!c(h(e,`steps`)))continue;let i=h(n,`flows`,r);l(i,{recursive:!0});let a=h(i,`skills`);c(a)&&(d(a,{recursive:!0,force:!0}),console.log(`  ${n}: migrated ${r} flow to steps/ layout`)),s(e,i,`steps`,u,f)}console.log(`  ${n}: scaffold updated (${i} skills)`)}let _=new Set,v=o(`aikit`,i),b=a(`aikit`,i);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=n,r=h(m(g(import.meta.url)),`..`,`..`,`..`,`..`,`..`,`package.json`),i=JSON.parse(u(r,`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{b as detectInstalledIdes,E as initUser,w as installGlobalScaffold,x as writeUserLevelMcpConfig,C as writeVscodeSettings};

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

@@ -1,6 +0,0 @@
-import { Command } from "../types.js";
-
-//#region packages/cli/src/commands/knowledge.d.ts
-declare const knowledgeCommands: Command[];
-//#endregion
-export { knowledgeCommands };

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

@@ -1 +0,0 @@
-import{ctx as e}from"../context.js";import{extractNumFlag as t,extractStrFlag as n,readStdin as r,splitCsv as i}from"../helpers.js";import{compact as a}from"../../../tools/dist/index.js";const o=[{name:`remember`,description:`Store curated knowledge`,usage:`aikit remember <title> --category <cat> [--tags tag1,tag2]`,run:async t=>{let a=n(t,`--category`,``).trim(),o=i(n(t,`--tags`,``)),s=t.shift()?.trim()??``,c=await r(),l=c.trim().length>0?c:t.join(` `).trim();(!s||!a||!l.trim())&&(console.error(`Usage: aikit remember <title> --category <cat> [--tags tag1,tag2]`),process.exit(1));let{curated:u}=await e(),d=await u.remember(s,l,a,o);console.log(`Stored curated entry`),console.log(`  Path: ${d.path}`),console.log(`  Category: ${a}`),o.length>0&&console.log(`  Tags: ${o.join(`, `)}`)}},{name:`forget`,description:`Remove a curated entry`,usage:`aikit forget <path> --reason <reason>`,run:async t=>{let r=n(t,`--reason`,``).trim(),i=t.shift()?.trim()??``;(!i||!r)&&(console.error(`Usage: aikit forget <path> --reason <reason>`),process.exit(1));let{curated:a}=await e(),o=await a.forget(i,r);console.log(`Removed curated entry: ${o.path}`)}},{name:`read`,description:`Read a curated entry`,usage:`aikit read <path>`,run:async t=>{let n=t.shift()?.trim()??``;n||(console.error(`Usage: aikit read <path>`),process.exit(1));let{curated:r}=await e(),i=await r.read(n);console.log(i.title),console.log(`─`.repeat(60)),console.log(`Path: ${i.path}`),console.log(`Category: ${i.category}`),console.log(`Version: ${i.version}`),console.log(`Tags: ${i.tags.length>0?i.tags.join(`, `):`None`}`),console.log(``),console.log(i.content)}},{name:`list`,description:`List curated entries`,usage:`aikit list [--category <cat>] [--tag <tag>]`,run:async t=>{let r=n(t,`--category`,``).trim()||void 0,i=n(t,`--tag`,``).trim()||void 0,{curated:a}=await e(),o=await a.list({category:r,tag:i});if(o.length===0){console.log(`No curated entries found.`);return}console.log(`Curated entries (${o.length})`),console.log(`─`.repeat(60));for(let e of o){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 t=>{let i=n(t,`--reason`,``).trim(),a=t.shift()?.trim()??``,o=await r();(!a||!i||!o.trim())&&(console.error(`Usage: aikit update <path> --reason <reason>`),process.exit(1));let{curated:s}=await e(),c=await s.update(a,o,i);console.log(`Updated curated entry`),console.log(`  Path: ${c.path}`),console.log(`  Version: ${c.version}`)}},{name:`compact`,description:`Compress text for context`,usage:`aikit compact <query> [--path <file>] [--max-chars N] [--segmentation paragraph|sentence|line]`,run:async i=>{let o=t(i,`--max-chars`,3e3),s=n(i,`--path`,``).trim()||void 0,c=n(i,`--segmentation`,`paragraph`),l=i.join(` `).trim(),u=s?void 0:await r();(!l||!s&&!u?.trim())&&(console.error(`Usage: aikit compact <query> --path <file>  OR  cat file | aikit compact <query>`),process.exit(1));let{embedder:d}=await e(),f=await a(d,{text:u,path:s,query:l,maxChars:o,segmentation:c});console.log(`Compressed ${f.originalChars} chars to ${f.compressedChars} chars`),console.log(`Ratio: ${(f.ratio*100).toFixed(1)}% | Segments: ${f.segmentsKept}/${f.segmentsTotal}`),console.log(``),console.log(f.text)}}];export{o as knowledgeCommands};

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

@@ -1,6 +0,0 @@
-import { Command } from "../types.js";
-
-//#region packages/cli/src/commands/search.d.ts
-declare const searchCommands: Command[];
-//#endregion
-export { searchCommands };

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

@@ -1 +0,0 @@
-import{ctx as e}from"../context.js";import{extractNumFlag as t,extractStrFlag as n,formatFocusRanges as r,printDeadSymbolsResult as i,printExamplesResult as a,printSymbolInfo as o,printTraceResult as s,rrf as c}from"../helpers.js";import{find as l,findDeadSymbols as u,findExamples as d,scopeMap as f,symbol as p,trace as m}from"../../../tools/dist/index.js";const h=[{name:`search`,description:`Search the AI Kit index`,usage:`aikit search <query> [--limit N] [--mode hybrid|semantic|keyword] [--graph-hops 0-3]`,run:async r=>{let i=t(r,`--limit`,5),a=n(r,`--mode`,`hybrid`),o=t(r,`--graph-hops`,0),s=r.join(` `).trim();s||(console.error(`Usage: aikit search <query>`),process.exit(1));let{embedder:l,store:u,graphStore:d}=await e(),f=await l.embedQuery(s),p;if(a===`keyword`)p=await u.ftsSearch(s,{limit:i});else if(a===`semantic`)p=await u.search(f,{limit:i});else{let[e,t]=await Promise.all([u.search(f,{limit:i*2}),u.ftsSearch(s,{limit:i*2}).catch(()=>[])]);p=c(e,t).slice(0,i)}if(p.length===0){console.log(`No results found.`);return}for(let{record:e,score:t}of p){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(`${p.length} result(s) found.`),o>0&&p.length>0)try{let{graphAugmentSearch:e}=await import(`../../../tools/dist/index.js`),t=(await e(d,p.map(e=>({recordId:e.record.id,score:e.score,sourcePath:e.record.sourcePath})),{hops:o,maxPerHit:5})).filter(e=>e.graphContext.nodes.length>0);if(t.length>0){console.log(`\nGraph context (${o} hop${o>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 r=>{let i=t(r,`--limit`,10),a=n(r,`--glob`,``).trim()||void 0,o=n(r,`--pattern`,``).trim()||void 0,s=r.join(` `).trim()||void 0;!s&&!a&&!o&&(console.error(`Usage: aikit find [query] [--glob <pattern>] [--pattern <regex>] [--limit N]`),process.exit(1));let{embedder:c,store:u}=await e(),d=await l(c,u,{query:s,glob:a,pattern:o,limit:i});if(d.results.length===0){console.log(`No matches found.`);return}console.log(`Strategies: ${d.strategies.join(`, `)}`),console.log(`Results: ${d.results.length} shown (${d.totalFound} total)`);for(let e of d.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 n=>{let i=t(n,`--max-files`,15),a=n.join(` `).trim();a||(console.error(`Usage: aikit scope-map <task> [--max-files N]`),process.exit(1));let{embedder:o,store:s}=await e(),c=await f(o,s,{task:a,maxFiles:i});console.log(`Task: ${c.task}`),console.log(`Files: ${c.files.length}`),console.log(`Estimated tokens: ${c.totalEstimatedTokens}`),console.log(``),console.log(`Reading order:`);for(let e of c.readingOrder)console.log(`  ${e}`);for(let[e,t]of c.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: ${r(t.focusRanges)}`)}},{name:`symbol`,description:`Resolve a symbol definition, imports, and references`,usage:`aikit symbol <name> [--limit N]`,run:async n=>{let r=t(n,`--limit`,20),i=n.join(` `).trim();i||(console.error(`Usage: aikit symbol <name> [--limit N]`),process.exit(1));let{embedder:a,store:s}=await e();o(await p(a,s,{name:i,limit:r}))}},{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 r=>{let i=n(r,`--direction`,`both`).trim()||`both`,a=t(r,`--max-depth`,3),o=r.join(` `).trim();(!o||![`forward`,`backward`,`both`].includes(i))&&(console.error(`Usage: aikit trace <start> [--direction forward|backward|both] [--max-depth N]`),process.exit(1));let{embedder:c,store:l}=await e();s(await m(c,l,{start:o,direction:i,maxDepth:a}))}},{name:`examples`,description:`Find real code examples of a symbol or pattern`,usage:`aikit examples <query> [--limit N] [--content-type type]`,run:async r=>{let i=t(r,`--limit`,5),o=n(r,`--content-type`,``).trim()||void 0,s=r.join(` `).trim();s||(console.error(`Usage: aikit examples <query> [--limit N] [--content-type type]`),process.exit(1));let{embedder:c,store:l}=await e();a(await d(c,l,{query:s,limit:i,contentType:o}))}},{name:`dead-symbols`,description:`Find exported symbols that appear to be unused`,usage:`aikit dead-symbols [--limit N]`,run:async n=>{let r=t(n,`--limit`,100),{embedder:a,store:o}=await e();i(await u(a,o,{limit:r}))}},{name:`lookup`,description:`Look up indexed content by record ID or source path`,usage:`aikit lookup <id>`,run:async t=>{let n=t.join(` `).trim();n||(console.error(`Usage: aikit lookup <id>`),process.exit(1));let{store:r}=await e(),i=await r.getById(n);if(i){console.log(i.id),console.log(`─`.repeat(60)),console.log(`Path: ${i.sourcePath}`),console.log(`Chunk: ${i.chunkIndex+1}/${i.totalChunks}`),console.log(`Lines: ${i.startLine}-${i.endLine}`),console.log(`Type: ${i.contentType} | Origin: ${i.origin}`),i.tags.length>0&&console.log(`Tags: ${i.tags.join(`, `)}`),console.log(``),console.log(i.content);return}let a=await r.getBySourcePath(n);if(a.length===0){console.log(`No indexed content found for: ${n}`);return}a.sort((e,t)=>e.chunkIndex-t.chunkIndex),console.log(n),console.log(`─`.repeat(60)),console.log(`Chunks: ${a.length} | Type: ${a[0].contentType}`);for(let e of a){let t=e.startLine?` (lines ${e.startLine}-${e.endLine})`:``;console.log(`\nChunk ${e.chunkIndex+1}/${e.totalChunks}${t}`),console.log(e.content)}}}];export{h as searchCommands};

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

@@ -1,6 +0,0 @@
-import { Command } from "../types.js";
-
-//#region packages/cli/src/commands/system.d.ts
-declare const systemCommands: Command[];
-//#endregion
-export { systemCommands };

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

@@ -1,4 +0,0 @@
-import{ctx as e}from"../context.js";import{executeCliBatchOperation as t,extractStrFlag as n,parseBatchPayload as r,printCheckResult as i,readInput as a}from"../helpers.js";import{dirname as o,resolve as s}from"node:path";import{fileURLToPath as c}from"node:url";import{audit as l,batch as u,check as d,guide as f,health as p,replayClear as m,replayList as h,replayTrim as g}from"../../../tools/dist/index.js";import{fork as _}from"node:child_process";const v=o(c(import.meta.url)),y=[{name:`status`,description:`Show AI Kit index status and statistics`,run:async()=>{let{isUserInstalled:t,getGlobalDataDir:n,computePartitionKey:r,listWorkspaces:i}=await import(`../../../core/dist/index.js`),{existsSync:a}=await import(`node:fs`),o=process.cwd(),c=t(),l=a(s(o,`.vscode`,`mcp.json`)),u,d;if(c&&l)u=`workspace (overrides user-level for this workspace)`,d=s(o,`.aikit-data`);else if(c){let e=r(o);u=a(s(o,`AGENTS.md`))?`user (workspace scaffolded)`:`user (workspace not scaffolded)`,d=s(n(),e)}else u=`workspace`,d=s(o,`.aikit-data`);if(console.log(`AI Kit Status`),console.log(`─`.repeat(40)),console.log(`  Mode:     ${u}`),console.log(`  Data:     ${d}`),c&&!l){let e=i();console.log(`  Registry: ${e.length} workspace(s) enrolled`)}try{let{store:t}=await e(),n=await t.getStats(),r=await t.listSourcePaths();console.log(`  Records:  ${n.totalRecords}`),console.log(`  Files:    ${n.totalFiles}`),console.log(`  Indexed:  ${n.lastIndexedAt??`Never`}`),console.log(`  Backend:  ${n.storeBackend}`),console.log(`  Model:    ${n.embeddingModel}`),console.log(``),console.log(`Content Types:`);for(let[e,t]of Object.entries(n.contentTypeBreakdown))console.log(`  ${e}: ${t}`);if(r.length>0){console.log(``),console.log(`Files (${r.length} total):`);for(let e of r.slice(0,20))console.log(`  ${e}`);r.length>20&&console.log(`  ... and ${r.length-20} more`)}}catch{console.log(``),console.log("  Index not available — run `aikit reindex` to index this workspace.")}c&&!l&&!a(s(o,`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 t=>{let n=t.includes(`--full`),{store:r,indexer:i,curated:a,config:o}=await e();console.log(`Indexing sources...`);let s=e=>{e.phase===`chunking`&&e.currentFile&&process.stdout.write(`\r  [${e.filesProcessed+1}/${e.filesTotal}] ${e.currentFile}`),e.phase===`done`&&process.stdout.write(`
-`)},c;n?(console.log(`Dropping existing index for full reindex...`),c=await i.reindexAll(o,s)):c=await i.index(o,s),console.log(`Done: ${c.filesProcessed} files, ${c.chunksCreated} chunks in ${(c.durationMs/1e3).toFixed(1)}s`),console.log(`Building FTS index...`),await r.createFtsIndex(),console.log(`Re-indexing curated entries...`);let l=await a.reindexAll();console.log(`Curated: ${l.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=s(v,`..`,`..`,`..`,`server`,`dist`,`index.js`),r=n(e,`--transport`,`stdio`),i=n(e,`--port`,`3210`),a=_(t,[],{stdio:r===`stdio`?[`pipe`,`pipe`,`inherit`,`ipc`]:`inherit`,env:{...process.env,AIKIT_TRANSPORT:r,AIKIT_PORT:i}});r===`stdio`&&a.stdin&&a.stdout&&(process.stdin.pipe(a.stdin),a.stdout.pipe(process.stdout)),a.on(`exit`,e=>process.exit(e??0)),process.on(`SIGINT`,()=>a.kill(`SIGINT`)),process.on(`SIGTERM`,()=>a.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/index.js`);await e();return}if(t){let{initUser:e}=await import(`./init/user.js`);await e({force:i})}else if(n){let{initProject:e}=await import(`./init/index.js`);await e({force:i})}else{let{initSmart:e}=await import(`./init/index.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=n(e,`--cwd`,``).trim()||void 0,r=n(e,`--files`,``),a=n(e,`--detail`,`full`)||`full`,o=r.split(`,`).map(e=>e.trim()).filter(Boolean),s=!1;e.includes(`--skip-types`)&&(e.splice(e.indexOf(`--skip-types`),1),s=!0);let c=!1;e.includes(`--skip-lint`)&&(e.splice(e.indexOf(`--skip-lint`),1),c=!0);let l=await d({cwd:t,files:o.length>0?o:void 0,skipTypes:s,skipLint:c,detail:a});i(l),l.passed||(process.exitCode=1)}},{name:`batch`,description:`Execute built-in operations from JSON input`,usage:`aikit batch [--file path] [--concurrency N]`,run:async i=>{let o=n(i,`--file`,``).trim()||void 0,s=(()=>{let e=i.indexOf(`--concurrency`);if(e===-1||e+1>=i.length)return 0;let t=Number.parseInt(i.splice(e,2)[1],10);return Number.isNaN(t)?0:t})(),c=await a(o);c.trim()||(console.error(`Usage: aikit batch [--file path] [--concurrency N]`),process.exit(1));let l=r(c),d=s>0?s:l.concurrency,f=l.operations.some(e=>e.type!==`check`)?await e():null,p=await u(l.operations,async e=>t(e,f),{concurrency:d});console.log(JSON.stringify(p,null,2)),p.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=p(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 t=>{let{store:r,embedder:i}=await e(),a=n(t,`--detail`,`summary`)||`summary`,o=n(t,`--checks`,``),s=o?o.split(`,`).map(e=>e.trim()):void 0,c=await l(r,i,{path:t.shift()||`.`,checks:s,detail:a});if(c.ok){if(console.log(c.summary),c.next&&c.next.length>0){console.log(`
-Suggested next steps:`);for(let e of c.next)console.log(`  → ${e.tool}: ${e.reason}`)}}else console.error(c.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=f(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=h({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}`)}g().catch(()=>{})}},{name:`replay-clear`,description:`Clear the replay audit trail`,run:async()=>{m(),console.log(`Replay log cleared.`)}},{name:`tui`,description:`Launch interactive terminal dashboard (human monitoring)`,run:async()=>{try{let{launch:t}=await import(`../../../tui/dist/index.js`),{DirectKBClient:n}=await import(`../../../aikit-client/dist/index.js`),{store:r,embedder:i,graphStore:a,curated:o}=await e();t(new n({store:r,embedder:i,graphStore:a,listCurated:async()=>(await o.list()).map(e=>({...e,content:e.contentPreview})),readCurated:e=>o.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`),c=s(v,`..`,`..`,`..`,`server`,`dist`,`index.js`),l=a(process.execPath,[c,`--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.`),l.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=()=>{l.kill(),process.exit(0)};process.on(`SIGINT`,p),process.on(`SIGTERM`,p),await new Promise(e=>{l.on(`exit`,()=>e())})}}];export{y as systemCommands};

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

@@ -1,6 +0,0 @@
-import { Command } from "../types.js";
-
-//#region packages/cli/src/commands/upgrade.d.ts
-declare const upgradeCommands: Command[];
-//#endregion
-export { upgradeCommands };

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

@@ -1 +0,0 @@
-import{FLOW_DIRS as e,SKILL_NAMES as t}from"./init/constants.js";import{existsSync as n,readFileSync as r}from"node:fs";import{dirname as i,resolve as a}from"node:path";import{fileURLToPath as o}from"node:url";const s=[{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:s}=await import(`./init/user.js`);await s({force:!0});let c=process.cwd(),l=n(a(c,`.github`,`.aikit-scaffold.json`)),u=n(a(c,`.github`,`agents`)),d=n(a(c,`.github`,`prompts`)),f=n(a(c,`.claude`,`commands`));if(l||u||d||f){let{initScaffoldOnly:e}=await import(`./init/index.js`);await e({force:!0})}if(n(a(c,`.github`,`skills`))){let{smartCopySkills:n}=await import(`./init/scaffold.js`),s=a(i(o(import.meta.url)),`..`,`..`,`..`,`..`),l=JSON.parse(r(a(s,`package.json`),`utf-8`)).version;n(c,s,[...t],l,!0);let{smartCopyFlows:u}=await import(`./init/scaffold.js`);u(c,s,[...e],l,!0)}}}];export{s as upgradeCommands};

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

@@ -1,6 +0,0 @@
-import { Command } from "../types.js";
-
-//#region packages/cli/src/commands/workspace.d.ts
-declare const workspaceCommands: Command[];
-//#endregion
-export { workspaceCommands };

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

@@ -1 +0,0 @@
-import{extractStrFlag as e,parseMaybeJsonString as t,printWorkset as n,readStdin as r,splitCsv as i}from"../helpers.js";import{addToWorkset as a,deleteWorkset as o,getWorkset as s,laneCreate as c,laneDiff as l,laneDiscard as u,laneList as d,laneMerge as f,laneStatus as p,listWorksets as m,queueClear as h,queueCreate as g,queueDelete as _,queueDone as v,queueFail as y,queueGet as b,queueList as x,queueNext as S,queuePush as C,removeFromWorkset as w,saveWorkset as T,stashClear as E,stashDelete as D,stashGet as O,stashList as k,stashSet as A}from"../../../tools/dist/index.js";const j=[{name:`workset`,description:`Manage saved file sets`,usage:`aikit workset <action> [name] [--files f1,f2] [--description desc]`,run:async t=>{let r=t.shift()?.trim(),c=i(e(t,`--files`,``)),l=e(t,`--description`,``).trim()||void 0,u=t.shift()?.trim();switch(r||(console.error(`Usage: aikit workset <action> [name] [--files f1,f2] [--description desc]`),console.error(`Actions: save, get, list, delete, add, remove`),process.exit(1)),r){case`save`:{(!u||c.length===0)&&(console.error(`Usage: aikit workset save <name> --files f1,f2 [--description desc]`),process.exit(1));let e=T(u,c,{description:l});console.log(`Saved workset: ${e.name}`),n(e);return}case`get`:{u||(console.error(`Usage: aikit workset get <name>`),process.exit(1));let e=s(u);if(!e){console.log(`No workset found: ${u}`);return}n(e);return}case`list`:{let e=m();if(e.length===0){console.log(`No worksets saved.`);return}console.log(`Worksets (${e.length})`),console.log(`─`.repeat(60));for(let t of e)n(t),console.log(``);return}case`delete`:{u||(console.error(`Usage: aikit workset delete <name>`),process.exit(1));let e=o(u);console.log(e?`Deleted workset: ${u}`:`No workset found: ${u}`);return}case`add`:{(!u||c.length===0)&&(console.error(`Usage: aikit workset add <name> --files f1,f2`),process.exit(1));let e=a(u,c);console.log(`Updated workset: ${e.name}`),n(e);return}case`remove`:{(!u||c.length===0)&&(console.error(`Usage: aikit workset remove <name> --files f1,f2`),process.exit(1));let e=w(u,c);if(!e){console.log(`No workset found: ${u}`);return}console.log(`Updated workset: ${e.name}`),n(e);return}default:console.error(`Unknown workset action: ${r}`),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 n=e.shift()?.trim(),i=e.shift()?.trim();switch(n||(console.error(`Usage: aikit stash <set|get|list|delete|clear> [key] [value]`),process.exit(1)),n){case`set`:{i||(console.error(`Usage: aikit stash set <key> <value>`),process.exit(1));let n=e.join(` `),a=n.trim()?``:await r(),o=A(i,t(n||a));console.log(`Stored stash entry: ${o.key}`),console.log(`  Type: ${o.type}`),console.log(`  Stored: ${o.storedAt}`);return}case`get`:{i||(console.error(`Usage: aikit stash get <key>`),process.exit(1));let e=O(i);if(!e){console.log(`No stash entry found: ${i}`);return}console.log(JSON.stringify(e,null,2));return}case`list`:{let e=k();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`:{i||(console.error(`Usage: aikit stash delete <key>`),process.exit(1));let e=D(i);console.log(e?`Deleted stash entry: ${i}`:`No stash entry found: ${i}`);return}case`clear`:{let e=E();console.log(`Cleared ${e} stash entr${e===1?`y`:`ies`}.`);return}default:console.error(`Unknown stash action: ${n}`),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 t=>{let n=t.shift();if((!n||![`create`,`list`,`status`,`diff`,`merge`,`discard`].includes(n))&&(console.error(`Usage: aikit lane <create|list|status|diff|merge|discard> [name] [--files f1,f2]`),process.exit(1)),n===`list`){let e=d();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 r=t.shift();switch(r||(console.error(`Lane name is required for "${n}".`),process.exit(1)),n){case`create`:{let n=e(t,`--files`,``);n||(console.error(`Usage: aikit lane create <name> --files file1.ts,file2.ts`),process.exit(1));let i=c(r,n.split(`,`).map(e=>e.trim()));console.log(`Lane "${i.name}" created with ${i.sourceFiles.length} files.`);break}case`status`:{let e=p(r);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=l(r);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=f(r);console.log(`Merged ${e.filesMerged} files from lane "${e.name}".`);for(let t of e.files)console.log(`  ${t}`);break}case`discard`:{let e=u(r);console.log(e?`Lane "${r}" discarded.`:`Lane "${r}" 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=x();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=g(n);console.log(`Queue "${e.name}" created.`);break}case`push`:{let t=C(n,e.join(` `)||`Untitled task`);console.log(`Pushed "${t.title}" (${t.id}) to queue "${n}".`);break}case`next`:{let e=S(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=v(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=y(n,t,r);console.log(`Marked "${i.title}" as failed: ${r}`);break}case`get`:{let e=b(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=h(n);console.log(`Cleared ${e} completed/failed items from queue "${n}".`);break}case`delete`:{let e=_(n);console.log(e?`Queue "${n}" deleted.`:`Queue "${n}" not found.`);break}}}}];export{j as workspaceCommands};

package/packages/cli/dist/context.d.ts

@@ -1,7 +0,0 @@
-import { KBContext } from "./aikit-init.js";
-
-//#region packages/cli/src/context.d.ts
-declare function ctx(): Promise<KBContext>;
-declare function getCtx(): KBContext | null;
-//#endregion
-export { type KBContext, ctx, getCtx };

package/packages/cli/dist/context.js

@@ -1 +0,0 @@
-import{initKB as e}from"./aikit-init.js";let t=null;async function n(){return t||=await e(),t}function r(){return t}export{n as ctx,r as getCtx};

package/packages/cli/dist/helpers.d.ts

@@ -1,55 +0,0 @@
-import { KBContext } from "./aikit-init.js";
-import { SearchResult } from "../../core/dist/index.js";
-import { BatchOperation, ManagedProcess, check, checkpointSave, diffParse, fileSummary, findDeadSymbols, findExamples, gitContext, parseOutput, symbol, testRun, trace } from "../../tools/dist/index.js";
-
-//#region packages/cli/src/helpers.d.ts
-declare function extractNumFlag(args: string[], flag: string, defaultValue: number): number;
-declare function extractStrFlag(args: string[], flag: string, defaultValue: string): string;
-declare function extractBoolFlag(args: string[], flag: string): boolean;
-declare function readStdin(): Promise<string>;
-declare function readInput(filePath?: string): Promise<string>;
-declare function splitCsv(value: string): string[];
-declare function parseBatchPayload(input: string): {
-  operations: BatchOperation[];
-  concurrency?: number;
-};
-declare function validateBatchOperations(value: unknown): BatchOperation[];
-declare function formatFocusRanges(ranges: Array<{
-  start: number;
-  end: number;
-  heading?: string;
-}>): string;
-declare function printParsedOutput(result: ReturnType<typeof parseOutput>): void;
-declare function printCheckResult(result: Awaited<ReturnType<typeof check>>): void;
-declare function printCheckSection(label: string, passed: boolean, errors: Array<{
-  file: string;
-  line?: number;
-  column?: number;
-  severity: 'error' | 'warning' | 'info';
-  code?: string;
-  message: string;
-}>): void;
-declare function printTestRunResult(result: Awaited<ReturnType<typeof testRun>>): void;
-declare function printGitContext(result: Awaited<ReturnType<typeof gitContext>>): void;
-declare function printDiffFiles(files: ReturnType<typeof diffParse>): void;
-declare function printTraceResult(result: Awaited<ReturnType<typeof trace>>): void;
-declare function printExamplesResult(result: Awaited<ReturnType<typeof findExamples>>): void;
-declare function printManagedProcess(info: ManagedProcess): void;
-declare function printDeadSymbolsResult(result: Awaited<ReturnType<typeof findDeadSymbols>>): void;
-declare function printFileSummary(summary: Awaited<ReturnType<typeof fileSummary>>): void;
-declare function printSymbolInfo(result: Awaited<ReturnType<typeof symbol>>): void;
-declare function printWorkset(workset: {
-  name: string;
-  files: string[];
-  created: string;
-  updated: string;
-  description?: string;
-}): void;
-declare function printCheckpoint(checkpoint: ReturnType<typeof checkpointSave>): void;
-declare function printSection(label: string, items: string[]): void;
-declare function parseMaybeJsonString(value: string): unknown;
-declare function parseRecordString(value: string): Record<string, unknown>;
-declare function rrf(vecResults: SearchResult[], ftsResults: SearchResult[], k?: number): SearchResult[];
-declare function executeCliBatchOperation(operation: BatchOperation, context: KBContext | null): Promise<unknown>;
-//#endregion
-export { executeCliBatchOperation, extractBoolFlag, extractNumFlag, extractStrFlag, formatFocusRanges, parseBatchPayload, parseMaybeJsonString, parseRecordString, printCheckResult, printCheckSection, printCheckpoint, printDeadSymbolsResult, printDiffFiles, printExamplesResult, printFileSummary, printGitContext, printManagedProcess, printParsedOutput, printSection, printSymbolInfo, printTestRunResult, printTraceResult, printWorkset, readInput, readStdin, rrf, splitCsv, validateBatchOperations };

package/packages/cli/dist/helpers.js

@@ -1,5 +0,0 @@
-import{resolve as e}from"node:path";import{readFile as t}from"node:fs/promises";import{check as n,find as r}from"../../tools/dist/index.js";function i(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 a(e,t,n){let r=e.indexOf(t);return r===-1||r+1>=e.length?n:e.splice(r,2)[1]}function o(e,t){let n=e.indexOf(t);return n===-1?!1:(e.splice(n,1),!0)}async function s(){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 c(n){return n?t(e(n),`utf-8`):s()}function l(e){return e.split(`,`).map(e=>e.trim()).filter(Boolean)}function u(e){let t=JSON.parse(e);if(Array.isArray(t))return{operations:d(t)};if(t&&typeof t==`object`&&`operations`in t){let e=t;return{operations:d(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 d(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 f(e){return e.map(e=>{let t=e.heading?` ${e.heading}`:``;return`${e.start}-${e.end}${t}`}).join(`, `)}function p(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 m(e){console.log(`Overall: ${e.passed?`passed`:`failed`}`),h(`tsc`,e.tsc.passed,e.tsc.errors),h(`biome`,e.biome.passed,e.biome.errors)}function h(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 g(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 _(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 v(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 y(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 b(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 x(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 S(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 C(e){console.log(e.path),console.log(`  Language: ${e.language}`),console.log(`  Lines: ${e.lines}`),console.log(`  Estimated tokens: ~${e.estimatedTokens}`),console.log(``),D(`Imports`,e.imports),D(`Exports`,e.exports),D(`Functions`,e.functions.map(e=>`${e.name} @ line ${e.line}${e.exported?` [exported]`:``}`)),D(`Classes`,e.classes.map(e=>`${e.name} @ line ${e.line}${e.exported?` [exported]`:``}`)),D(`Interfaces`,e.interfaces.map(e=>`${e.name} @ line ${e.line}`)),D(`Types`,e.types.map(e=>`${e.name} @ line ${e.line}`))}function w(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 T(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 E(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 D(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 O(e){let t=e.trim();if(!t)return``;try{return JSON.parse(t)}catch{return e}}function k(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 A(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 j(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 A(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,i=typeof e.args.glob==`string`?e.args.glob:void 0,a=typeof e.args.pattern==`string`?e.args.pattern:void 0,o=typeof e.args.limit==`number`?e.args.limit:10,s=typeof e.args.content_type==`string`?e.args.content_type:void 0,c=typeof e.args.cwd==`string`?e.args.cwd:void 0;if(!n&&!i&&!a)throw Error(`find operation requires query, glob, or pattern`);return r(t.embedder,t.store,{query:n,glob:i,pattern:a,limit:o,contentType:s,cwd:c})}case`check`:return n({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}`)}}export{j as executeCliBatchOperation,o as extractBoolFlag,i as extractNumFlag,a as extractStrFlag,f as formatFocusRanges,u as parseBatchPayload,O as parseMaybeJsonString,k as parseRecordString,m as printCheckResult,h as printCheckSection,E as printCheckpoint,S as printDeadSymbolsResult,v as printDiffFiles,b as printExamplesResult,C as printFileSummary,_ as printGitContext,x as printManagedProcess,p as printParsedOutput,D as printSection,w as printSymbolInfo,g as printTestRunResult,y as printTraceResult,T as printWorkset,c as readInput,s as readStdin,A as rrf,l as splitCsv,d as validateBatchOperations};

package/packages/cli/dist/types.d.ts

@@ -1,9 +0,0 @@
-//#region packages/cli/src/types.d.ts
-interface Command {
-  name: string;
-  description: string;
-  usage?: string;
-  run: (args: string[]) => Promise<void>;
-}
-//#endregion
-export { Command };

package/packages/cli/dist/types.js

@@ -1 +0,0 @@
-export{};