@vpxa/aikit 0.1.1

package/packages/tools/dist/forge-ground.js

@@ -0,0 +1 @@
+import{estimateTokens as e}from"./text-utils.js";import{evidenceMap as t}from"./evidence-map.js";import{fileSummary as n}from"./file-summary.js";import{forgeClassify as r}from"./forge-classify.js";import{scopeMap as i}from"./scope-map.js";const a={floor:{ground:`Parasitic — read target file only`,build:`Implement directly`,break:`Skip`,evidenceMap:`Not required`,gate:`Self-certify`},standard:{ground:`Scope map + blast radius + constraint seed`,build:`TDD — test first, then implement`,break:`Error paths + edge cases`,evidenceMap:`3-8 critical-path entries`,gate:`YIELD/HOLD evaluation`},critical:{ground:`Full scope map + blast radius + trace + patterns + constraint pack`,build:`TDD + contract verification + cross-service validation`,break:`Error paths + edge cases + security dimensions + data-flow verification`,evidenceMap:`Comprehensive — all critical-path claims with receipts`,gate:`Strict YIELD/HOLD/HARD_BLOCK evaluation`}};async function o(e,t,n){let r=n.maxConstraints??3,i=await s(n),a=await u(n.files);if(i.tier===`floor`)return _({tier:i.tier,classifyTriggers:i.classifyTriggers,scopeMap:null,typedUnknownSeeds:i.typedUnknownSeeds,constraints:[],fileSummaries:a,evidenceMapTaskId:null,ceremony:i.ceremony});let[o,d,p]=await Promise.all([c(e,t,n.task,i.tier),l(e,t,n.task,r),f(n.rootPath,n.taskId??v(n.task),i.tier)]);return _({tier:i.tier,classifyTriggers:i.classifyTriggers,scopeMap:o,typedUnknownSeeds:i.typedUnknownSeeds,constraints:d,fileSummaries:a,evidenceMapTaskId:p,ceremony:i.ceremony})}async function s(e){if(e.forceTier)return{tier:e.forceTier,classifyTriggers:[],typedUnknownSeeds:[],ceremony:g(e.forceTier)};try{let t=await r({files:e.files,task:e.task,rootPath:e.rootPath});return{tier:t.tier,classifyTriggers:t.triggers,typedUnknownSeeds:t.typedUnknownSeeds,ceremony:t.ceremony}}catch{return{tier:`standard`,classifyTriggers:[],typedUnknownSeeds:[],ceremony:g(`standard`)}}}async function c(e,t,n,r){try{return await i(e,t,{task:n,maxFiles:r===`critical`?20:10})}catch{return null}}async function l(e,t,n,r){try{let i=`decision pattern convention ${n}`,a=typeof e.embedQuery==`function`?await e.embedQuery(i):await e.embed(i);return(await t.search(a,{limit:r,origin:`curated`})).slice(0,r).map(e=>p(e))}catch{return[]}}async function u(e){return Promise.all(e.map(async e=>d(e)))}async function d(e){try{return h(await n({path:e}))}catch(t){return{path:e,exports:[],functions:[],lines:0,error:t instanceof Error?t.message:`Unable to summarize file`}}}async function f(e,n,r){try{return t({action:`create`,taskId:n,tier:r},e),n}catch{return null}}function p(e){return{source:e.record.sourcePath,snippet:m(e.record.content),relevance:e.score}}function m(e){let t=e.replace(/\s+/g,` `).trim();return t.length<=200?t:`${t.slice(0,197).trimEnd()}...`}function h(e){return{path:e.path,exports:e.exports,functions:e.functions.map(e=>e.name),lines:e.lines}}function g(e){return{...a[e]}}function _(t){return{...t,estimatedTokens:e(JSON.stringify(t))}}function v(e){let t=e.toLowerCase().replace(/[^a-z0-9\s]/g,` `).split(/\s+/).filter(Boolean).slice(0,5).join(`-`),n=Date.now().toString(36);return`${t||`task`}-${n}`}export{o as forgeGround};

package/packages/tools/dist/git-context.d.ts

@@ -0,0 +1,25 @@
+//#region packages/tools/src/git-context.d.ts
+interface GitContextOptions {
+  cwd?: string;
+  commitCount?: number;
+  includeDiff?: boolean;
+}
+interface GitContextResult {
+  gitRoot: string;
+  branch: string;
+  status: {
+    staged: string[];
+    modified: string[];
+    untracked: string[];
+  };
+  recentCommits: Array<{
+    hash: string;
+    message: string;
+    author: string;
+    date: string;
+  }>;
+  diff?: string;
+}
+declare function gitContext(options?: GitContextOptions): Promise<GitContextResult>;
+//#endregion
+export { GitContextOptions, GitContextResult, gitContext };

package/packages/tools/dist/git-context.js

@@ -0,0 +1,3 @@
+import{execFile as e}from"node:child_process";import{promisify as t}from"node:util";const n=t(e);async function r(e,t){try{let{stdout:r}=await n(`git`,e,{cwd:t,timeout:15e3});return r.toString().trim()}catch{return``}}async function i(e={}){let t=e.cwd??process.cwd(),n=e.commitCount??5,i=await r([`rev-parse`,`--show-toplevel`],t);if(!i)return{gitRoot:t,branch:`unknown`,status:{staged:[],modified:[],untracked:[]},recentCommits:[]};let a=i,[o,s,c,l]=await Promise.all([r([`rev-parse`,`--abbrev-ref`,`HEAD`],a),r([`status`,`--porcelain`],a),r([`log`,`--max-count=${n}`,`--format=%h|%s|%an|%ai`],a),e.includeDiff?r([`diff`,`--stat`,`--no-color`],a):Promise.resolve(``)]),u=[],d=[],f=[];for(let e of s.split(`
+`).filter(Boolean)){let t=e[0],n=e[1],r=e.slice(3).trim();t!==` `&&t!==`?`&&u.push(r),(n===`M`||n===`D`)&&d.push(r),t===`?`&&f.push(r)}let p=c.split(`
+`).filter(Boolean).map(e=>{let[t,n,r,i]=e.split(`|`);return{hash:t,message:n,author:r,date:i}});return{gitRoot:i,branch:o||`unknown`,status:{staged:u,modified:d,untracked:f},recentCommits:p,diff:l||void 0}}export{i as gitContext};

package/packages/tools/dist/graph-query.d.ts

@@ -0,0 +1,86 @@
+import { GraphEdge, GraphNode, GraphStats, GraphTraversalResult, GraphValidationResult, IGraphStore } from "../../store/dist/index.js";
+
+//#region packages/tools/src/graph-query.d.ts
+interface GraphQueryOptions {
+  /** Action: query nodes, traverse from a node, get stats, or add data */
+  action: 'find_nodes' | 'find_edges' | 'neighbors' | 'traverse' | 'stats' | 'validate' | 'add' | 'delete' | 'clear';
+  /** Node type filter (for find_nodes) */
+  nodeType?: string;
+  /** Name pattern (LIKE %pattern%) for find_nodes */
+  namePattern?: string;
+  /** Source path filter */
+  sourcePath?: string;
+  /** Node ID for neighbors/traverse/delete */
+  nodeId?: string;
+  /** Edge type filter */
+  edgeType?: string;
+  /** From node ID (for find_edges) */
+  fromId?: string;
+  /** To node ID (for find_edges) */
+  toId?: string;
+  /** Traversal direction */
+  direction?: 'outgoing' | 'incoming' | 'both';
+  /** Max traversal depth (default: 2) */
+  maxDepth?: number;
+  /** Max results (default: 50) */
+  limit?: number;
+  /** Nodes to add (for action=add) */
+  nodes?: Array<{
+    id?: string;
+    type: string;
+    name: string;
+    properties?: Record<string, unknown>;
+    sourceRecordId?: string;
+    sourcePath?: string;
+  }>;
+  /** Edges to add (for action=add) */
+  edges?: Array<{
+    id?: string;
+    fromId: string;
+    toId: string;
+    type: string;
+    weight?: number;
+    properties?: Record<string, unknown>;
+  }>;
+}
+interface GraphQueryResult {
+  action: string;
+  nodes?: GraphNode[];
+  edges?: GraphEdge[];
+  stats?: GraphStats;
+  validation?: GraphValidationResult;
+  nodesAdded?: number;
+  edgesAdded?: number;
+  deleted?: number;
+  summary: string;
+}
+declare function graphQuery(graphStore: IGraphStore, options: GraphQueryOptions): Promise<GraphQueryResult>;
+interface GraphAugmentOptions {
+  /** Max graph hops from each vector hit (default: 1) */
+  hops?: number;
+  /** Edge type filter for graph expansion */
+  edgeType?: string;
+  /** Max graph nodes per vector hit (default: 5) */
+  maxPerHit?: number;
+}
+interface GraphAugmentedResult {
+  /** Original search result record ID */
+  recordId: string;
+  /** Original similarity score */
+  score: number;
+  /** Source path of the matched record */
+  sourcePath: string;
+  /** Graph nodes connected to this record (via sourceRecordId) */
+  graphContext: GraphTraversalResult;
+}
+/**
+ * Augment vector search results with graph context.
+ * For each search hit, finds linked graph nodes and traverses their connections.
+ */
+declare function graphAugmentSearch(graphStore: IGraphStore, hits: Array<{
+  recordId: string;
+  score: number;
+  sourcePath: string;
+}>, options?: GraphAugmentOptions): Promise<GraphAugmentedResult[]>;
+//#endregion
+export { GraphAugmentOptions, GraphAugmentedResult, GraphQueryOptions, GraphQueryResult, graphAugmentSearch, graphQuery };

package/packages/tools/dist/graph-query.js

@@ -0,0 +1 @@
+import{createHash as e}from"node:crypto";function t(t,...n){return`${t}_${e(`sha256`).update(n.join(`|`)).digest(`hex`).slice(0,12)}`}async function n(e,n){let{action:r}=n;switch(r){case`find_nodes`:{let t=await e.findNodes({type:n.nodeType,namePattern:n.namePattern,sourcePath:n.sourcePath,limit:n.limit});return{action:r,nodes:t,summary:`Found ${t.length} node(s)${n.nodeType?` of type "${n.nodeType}"`:``}${n.namePattern?` matching "${n.namePattern}"`:``}`}}case`find_edges`:{let t=await e.findEdges({type:n.edgeType,fromId:n.fromId,toId:n.toId,limit:n.limit});return{action:r,edges:t,summary:`Found ${t.length} edge(s)${n.edgeType?` of type "${n.edgeType}"`:``}`}}case`neighbors`:{if(!n.nodeId)return{action:r,summary:`Error: nodeId is required for neighbors action`};let t=await e.getNeighbors(n.nodeId,{edgeType:n.edgeType,direction:n.direction,limit:n.limit});return{action:r,nodes:t.nodes,edges:t.edges,summary:`Found ${t.nodes.length} neighbor(s) and ${t.edges.length} edge(s) for node "${n.nodeId}"`}}case`traverse`:{if(!n.nodeId)return{action:r,summary:`Error: nodeId is required for traverse action`};let t=await e.traverse(n.nodeId,{edgeType:n.edgeType,maxDepth:n.maxDepth,direction:n.direction,limit:n.limit});return{action:r,nodes:t.nodes,edges:t.edges,summary:`Traversed ${t.nodes.length} node(s) and ${t.edges.length} edge(s) from "${n.nodeId}" (depth=${n.maxDepth??2})`}}case`stats`:{let t=await e.getStats();return{action:r,stats:t,summary:`Graph: ${t.nodeCount} nodes, ${t.edgeCount} edges. Types: ${Object.entries(t.nodeTypes).map(([e,t])=>`${e}(${t})`).join(`, `)||`none`}`}}case`validate`:{let t=await e.validate();return{action:r,validation:t,stats:t.stats,summary:t.valid?`Graph validation passed: ${t.stats.nodeCount} nodes, ${t.stats.edgeCount} edges, ${t.orphanNodes.length} orphan node(s)`:`Graph validation found ${t.danglingEdges.length} dangling edge(s) and ${t.orphanNodes.length} orphan node(s)`}}case`add`:{let i=0,a=0;if(n.nodes&&n.nodes.length>0){let r=n.nodes.map(e=>({id:e.id??t(`node`,e.type,e.name),type:e.type,name:e.name,properties:e.properties??{},sourceRecordId:e.sourceRecordId,sourcePath:e.sourcePath,createdAt:new Date().toISOString()}));await e.upsertNodes(r),i=r.length}if(n.edges&&n.edges.length>0){let r=n.edges.map(e=>({id:e.id??t(`edge`,e.fromId,e.toId,e.type),fromId:e.fromId,toId:e.toId,type:e.type,weight:e.weight,properties:e.properties}));await e.upsertEdges(r),a=r.length}return{action:r,nodesAdded:i,edgesAdded:a,summary:`Added ${i} node(s) and ${a} edge(s) to the graph`}}case`delete`:if(n.nodeId)return await e.deleteNode(n.nodeId),{action:r,deleted:1,summary:`Deleted node "${n.nodeId}" and its edges`};if(n.sourcePath){let t=await e.deleteBySourcePath(n.sourcePath);return{action:r,deleted:t,summary:`Deleted ${t} node(s) from source "${n.sourcePath}"`}}return{action:r,summary:`Error: nodeId or sourcePath required for delete action`};case`clear`:{let t=await e.getStats();return await e.clear(),{action:r,deleted:t.nodeCount,summary:`Cleared graph: removed ${t.nodeCount} node(s) and ${t.edgeCount} edge(s)`}}default:return{action:r,summary:`Unknown action: ${r}`}}}async function r(e,t,n){let r=n?.hops??1,i=n?.maxPerHit??5,a=[];for(let o of t)try{let t=await e.findNodes({sourcePath:o.sourcePath}),s=[],c=[],l=new Set,u=new Set;for(let a of t.slice(0,i))if(!l.has(a.id)&&(l.add(a.id),s.push(a),r>0)){let t=await e.traverse(a.id,{maxDepth:r,edgeType:n?.edgeType,limit:i});for(let e of t.nodes)l.has(e.id)||(l.add(e.id),s.push(e));for(let e of t.edges)u.has(e.id)||(u.add(e.id),c.push(e))}a.push({recordId:o.recordId,score:o.score,sourcePath:o.sourcePath,graphContext:{nodes:s,edges:c}})}catch{a.push({recordId:o.recordId,score:o.score,sourcePath:o.sourcePath,graphContext:{nodes:[],edges:[]}})}return a}export{r as graphAugmentSearch,n as graphQuery};

package/packages/tools/dist/guide.d.ts

@@ -0,0 +1,25 @@
+//#region packages/tools/src/guide.d.ts
+/**
+ * Tool discovery — recommends MCP tools and workflows for a given goal.
+ *
+ * Uses keyword matching against predefined workflow templates.
+ * No embeddings required — pure string matching for instant results.
+ */
+interface GuideRecommendation {
+  tool: string;
+  reason: string;
+  order: number;
+  suggestedArgs?: Record<string, unknown>;
+}
+interface GuideResult {
+  workflow: string;
+  description: string;
+  tools: GuideRecommendation[];
+  alternativeWorkflows: string[];
+}
+/**
+ * Match a goal description to the best workflow and return tool recommendations.
+ */
+declare function guide(goal: string, maxRecommendations?: number): GuideResult;
+//#endregion
+export { GuideRecommendation, GuideResult, guide };

package/packages/tools/dist/guide.js

@@ -0,0 +1 @@
+const e=[{name:`onboard`,description:`First-time codebase exploration and understanding`,keywords:[`onboard`,`new project`,`understand`,`explore`,`first time`,`getting started`,`learn`,`overview`],tools:[{tool:`status`,reason:`Check index health and record count`,order:1},{tool:`onboard`,reason:`Run all analysis tools in one command`,order:2,suggestedArgs:{path:`.`}},{tool:`search`,reason:`Find specific topics of interest`,order:3},{tool:`graph`,reason:`Explore module relationships`,order:4,suggestedArgs:{action:`stats`}}]},{name:`audit`,description:`Assess project health, quality, and structure`,keywords:[`audit`,`health`,`quality`,`assess`,`review project`,`check quality`,`code quality`,`tech debt`],tools:[{tool:`status`,reason:`Check index freshness`,order:1},{tool:`audit`,reason:`Unified audit report with score and recommendations`,order:2,suggestedArgs:{detail:`summary`}},{tool:`check`,reason:`Typecheck + lint validation`,order:3},{tool:`health`,reason:`Detailed health checks on package.json, tsconfig, etc.`,order:4}]},{name:`bugfix`,description:`Diagnose and fix a bug or failing test`,keywords:[`bug`,`fix`,`debug`,`error`,`failing`,`broken`,`crash`,`wrong`,`issue`,`problem`,`not working`],tools:[{tool:`parse_output`,reason:`Parse error output from build tools (tsc, vitest, biome)`,order:1},{tool:`symbol`,reason:`Find definition and all references of the failing symbol`,order:2},{tool:`trace`,reason:`Trace call chain backward from the failure point`,order:3,suggestedArgs:{direction:`backward`}},{tool:`search`,reason:`Search for related patterns or similar fixes`,order:4},{tool:`test_run`,reason:`Re-run tests after fix`,order:5}]},{name:`implement`,description:`Add a new feature or implement a change`,keywords:[`implement`,`add feature`,`new feature`,`build`,`create`,`add`,`develop`,`write code`],tools:[{tool:`scope_map`,reason:`Generate a reading plan for affected files`,order:1},{tool:`search`,reason:`Find related patterns and prior art`,order:2},{tool:`find`,reason:`Find usage examples of similar patterns`,order:3,suggestedArgs:{mode:`examples`}},{tool:`check`,reason:`Validate after implementation`,order:4},{tool:`test_run`,reason:`Run tests to verify`,order:5},{tool:`blast_radius`,reason:`Check impact of changes`,order:6}]},{name:`refactor`,description:`Restructure or clean up existing code`,keywords:[`refactor`,`restructure`,`clean up`,`reorganize`,`rename`,`move`,`extract`,`DRY`,`dead code`],tools:[{tool:`dead_symbols`,reason:`Find unused exports to remove`,order:1},{tool:`symbol`,reason:`Find all references before renaming`,order:2},{tool:`blast_radius`,reason:`Assess impact before making changes`,order:3},{tool:`rename`,reason:`Safe cross-file rename`,order:4},{tool:`check`,reason:`Validate after refactoring`,order:5},{tool:`test_run`,reason:`Ensure no regressions`,order:6}]},{name:`search`,description:`Find specific code, patterns, or information`,keywords:[`find`,`search`,`where`,`locate`,`look for`,`grep`,`which file`,`how does`],tools:[{tool:`search`,reason:`Hybrid semantic + keyword search`,order:1},{tool:`find`,reason:`Federated search with glob and regex`,order:2},{tool:`symbol`,reason:`Resolve a specific symbol definition and references`,order:3},{tool:`graph`,reason:`Explore entity relationships`,order:4,suggestedArgs:{action:`neighbors`}}]},{name:`context`,description:`Compress or manage context for efficient LLM interaction`,keywords:[`context`,`compress`,`summarize`,`too long`,`token`,`budget`,`reduce`,`compact`],tools:[{tool:`file_summary`,reason:`Quick structural overview without reading full file`,order:1},{tool:`compact`,reason:`Compress file to relevant sections`,order:2,suggestedArgs:{segmentation:`paragraph`}},{tool:`digest`,reason:`Compress multiple sources into budgeted summary`,order:3},{tool:`stratum_card`,reason:`Generate reusable context cards`,order:4}]},{name:`memory`,description:`Manage persistent knowledge across sessions`,keywords:[`memory`,`remember`,`persist`,`save`,`recall`,`decision`,`convention`,`session`,`checkpoint`],tools:[{tool:`list`,reason:`See all stored knowledge entries`,order:1},{tool:`search`,reason:`Search curated knowledge`,order:2,suggestedArgs:{origin:`curated`}},{tool:`remember`,reason:`Store a new decision or pattern`,order:3},{tool:`checkpoint`,reason:`Save/restore session progress`,order:4},{tool:`stash`,reason:`Temporary key-value storage within session`,order:5}]},{name:`validate`,description:`Run checks, tests, and validation`,keywords:[`validate`,`check`,`test`,`lint`,`typecheck`,`verify`,`CI`,`pass`,`run tests`],tools:[{tool:`check`,reason:`Typecheck + lint in one call`,order:1,suggestedArgs:{detail:`errors`}},{tool:`test_run`,reason:`Run tests with structured output`,order:2},{tool:`health`,reason:`Project health assessment`,order:3}]},{name:`analyze`,description:`Deep analysis of codebase structure, dependencies, or patterns`,keywords:[`analyze`,`dependency`,`structure`,`pattern`,`architecture`,`diagram`,`entry point`,`import`],tools:[{tool:`analyze_structure`,reason:`Project structure overview`,order:1},{tool:`analyze_dependencies`,reason:`Dependency graph and analysis`,order:2},{tool:`analyze_patterns`,reason:`Detect code patterns and conventions`,order:3},{tool:`analyze_entry_points`,reason:`Find handlers, exports, and entry points`,order:4},{tool:`analyze_diagram`,reason:`Generate Mermaid diagrams`,order:5}]},{name:`upgrade`,description:`Update KB agents, prompts, skills, and scaffold to the latest version (user-level and workspace-level)`,keywords:[`upgrade`,`update`,`version`,`scaffold`,`outdated`,`mismatch`,`deploy`,`install`,`refresh`],tools:[{tool:`status`,reason:`Check current versions and detect mismatches — auto-triggers upgrade when a version mismatch is found`,order:1},{tool:`reindex`,reason:`Refresh the index after the upgrade completes`,order:2},{tool:`produce_knowledge`,reason:`Regenerate codebase analysis with updated tooling`,order:3,suggestedArgs:{path:`.`}}]}];function t(t,n=5){let r=t.toLowerCase(),i=e.map(e=>{let t=0;for(let n of e.keywords)r.includes(n)&&(t+=n.includes(` `)?2:1);return{workflow:e,score:t}}).filter(e=>e.score>0).sort((e,t)=>t.score-e.score),a=e.find(e=>e.name===`search`)??e[0],o=i[0]?.workflow??a,s=i.slice(1,4).map(e=>e.workflow.name).filter(e=>e!==o.name);return{workflow:o.name,description:o.description,tools:o.tools.slice(0,n),alternativeWorkflows:s}}export{t as guide};

package/packages/tools/dist/health.d.ts

@@ -0,0 +1,16 @@
+//#region packages/tools/src/health.d.ts
+interface HealthCheck {
+  name: string;
+  status: 'pass' | 'warn' | 'fail';
+  message: string;
+}
+interface HealthResult {
+  path: string;
+  checks: HealthCheck[];
+  score: number;
+  summary: string;
+}
+/** Run project health checks on a directory. */
+declare function health(rootPath?: string): HealthResult;
+//#endregion
+export { HealthCheck, HealthResult, health };

package/packages/tools/dist/health.js

@@ -0,0 +1,2 @@
+import{extname as e,join as t,relative as n,resolve as r}from"node:path";import{existsSync as i,readFileSync as a,readdirSync as o,statSync as s}from"node:fs";function c(e){let n=r(e??process.cwd()),o=[],c=t(n,`package.json`);if(i(c)){o.push({name:`package.json`,status:`pass`,message:`Found`});try{let e=JSON.parse(a(c,`utf-8`));e.name?o.push({name:`package.name`,status:`pass`,message:e.name}):o.push({name:`package.name`,status:`warn`,message:`Missing package name`});let t=e.scripts??{};for(let e of[`build`,`test`,`lint`])t[e]?o.push({name:`script:${e}`,status:`pass`,message:t[e]}):o.push({name:`script:${e}`,status:`warn`,message:`No "${e}" script defined`});e.type===`module`?o.push({name:`esm`,status:`pass`,message:`ESM ("type": "module")`}):e.type===`commonjs`?o.push({name:`esm`,status:`pass`,message:`CJS ("type": "commonjs")`}):o.push({name:`esm`,status:`warn`,message:`No "type" field — defaults to CJS`}),e.engines?.node?o.push({name:`engines.node`,status:`pass`,message:e.engines.node}):o.push({name:`engines.node`,status:`warn`,message:`No Node.js engine constraint`})}catch{o.push({name:`package.json`,status:`fail`,message:`Failed to parse package.json`})}}else o.push({name:`package.json`,status:`fail`,message:`Missing — not a Node.js project`});let f=t(n,`tsconfig.json`);i(f)?o.push({name:`tsconfig.json`,status:`pass`,message:`Found`}):o.push({name:`tsconfig.json`,status:`warn`,message:`Missing`});let p=t(n,`.gitignore`);if(i(p)){let e=a(p,`utf-8`),t=e.includes(`node_modules`),n=e.includes(`dist`);t&&n?o.push({name:`.gitignore`,status:`pass`,message:`Includes node_modules and dist`}):o.push({name:`.gitignore`,status:`warn`,message:`Missing: ${t?``:`node_modules `}${n?``:`dist`}`.trim()})}else o.push({name:`.gitignore`,status:`warn`,message:`Missing`});let h=[`pnpm-lock.yaml`,`package-lock.json`,`yarn.lock`,`bun.lock`].find(e=>i(t(n,e)));h?o.push({name:`lockfile`,status:`pass`,message:h}):o.push({name:`lockfile`,status:`warn`,message:`No lock file found`});let g=t(n,`README.md`);if(i(g)){let e=a(g,`utf-8`).length;o.push({name:`README.md`,status:e>100?`pass`:`warn`,message:e>100?`Found (${e} chars)`:`Found but very short`})}else o.push({name:`README.md`,status:`warn`,message:`Missing`});if(i(t(n,`LICENSE`))||i(t(n,`LICENSE.md`))?o.push({name:`LICENSE`,status:`pass`,message:`Found`}):o.push({name:`LICENSE`,status:`warn`,message:`Missing`}),i(f))try{let e=a(f,`utf-8`).replace(/\/\/.*$/gm,``).replace(/\/\*[\s\S]*?\*\//g,``);JSON.parse(e).compilerOptions?.strict===!0?o.push({name:`typescript.strict`,status:`pass`,message:`strict: true`}):o.push({name:`typescript.strict`,status:`warn`,message:`strict mode not enabled in tsconfig.json`})}catch{}if(i(c))try{let e=JSON.parse(a(c,`utf-8`));e.exports?o.push({name:`package.exports`,status:`pass`,message:`Has exports field`}):e.workspaces||i(t(n,`pnpm-workspace.yaml`))||o.push({name:`package.exports`,status:`warn`,message:`Missing — consider adding exports field for explicit public API`});let r=l(n,e);r.length>0&&u(n,r,o)}catch{}let _=t(n,`dist`),v=t(n,`src`);if(i(_)&&i(v))try{let e=s(_).mtimeMs;d(v)>e?o.push({name:`build.freshness`,status:`warn`,message:`Source files are newer than dist/ — rebuild may be needed`}):o.push({name:`build.freshness`,status:`pass`,message:`Build output is fresh`})}catch{}if(i(v)){let e=m(v);if(e.length===0)o.push({name:`circular_deps`,status:`pass`,message:`No circular imports detected`});else{let t=e.slice(0,3).map(e=>e.join(` → `));o.push({name:`circular_deps`,status:`warn`,message:`${e.length} circular import(s): ${t.join(`; `)}${e.length>3?` (+${e.length-3} more)`:``}`})}}let y=o.length,b=o.filter(e=>e.status===`pass`).length,x=o.filter(e=>e.status===`fail`).length;return{path:n,checks:o,score:y>0?Math.round(b/y*100):0,summary:x>0?`${x} critical issue(s), ${y-b-x} warning(s)`:y-b>0?`${y-b} warning(s)`:`All checks passed`}}function l(e,n){let r=[];Array.isArray(n.workspaces)?r.push(...n.workspaces):n.workspaces&&typeof n.workspaces==`object`&&Array.isArray(n.workspaces.packages)&&r.push(...n.workspaces.packages);let s=t(e,`pnpm-workspace.yaml`);if(i(s)){let e=a(s,`utf-8`);for(let t of e.split(`
+`)){let e=t.match(/^\s*-\s+['"]?([^'"#\s]+)['"]?\s*$/);e&&r.push(e[1])}}let c=[];for(let n of r)if(n.endsWith(`/*`)||n.endsWith(`/**`)){let r=t(e,n.replace(/\/\*+$/,``));if(i(r))try{for(let e of o(r,{withFileTypes:!0}))e.isDirectory()&&i(t(r,e.name,`package.json`))&&c.push(t(r,e.name))}catch{}}else{let r=t(e,n);i(t(r,`package.json`))&&c.push(r)}return c}function u(e,n,r){let i=0,o=0,s=new Map;for(let e of n)try{let n=JSON.parse(a(t(e,`package.json`),`utf-8`));n.scripts?.test||i++,!n.exports&&!n.main&&o++;let r={...n.dependencies,...n.devDependencies};for(let e of Object.values(r))if(typeof e==`string`&&e.startsWith(`workspace:`)){let t=e.startsWith(`workspace:*`)?`workspace:*`:e.startsWith(`workspace:^`)?`workspace:^`:`workspace:~`;s.set(t,(s.get(t)??0)+1)}}catch{}if(i>0?r.push({name:`workspace.test-scripts`,status:`warn`,message:`${i}/${n.length} workspace packages missing test script`}):r.push({name:`workspace.test-scripts`,status:`pass`,message:`All ${n.length} workspace packages have test scripts`}),o>0?r.push({name:`workspace.exports`,status:`warn`,message:`${o}/${n.length} packages missing exports field`}):n.length>0&&r.push({name:`workspace.exports`,status:`pass`,message:`All ${n.length} packages have exports or main field`}),s.size>1){let e=[...s.entries()].map(([e,t])=>`${e} (${t})`).join(`, `);r.push({name:`workspace.protocol`,status:`warn`,message:`Mixed workspace protocols: ${e} — consider standardizing`})}else if(s.size===1){let[e]=s.keys();r.push({name:`workspace.protocol`,status:`pass`,message:`Consistent workspace protocol: ${e}`})}}function d(e){let n=0;try{for(let r of o(e,{withFileTypes:!0})){if(r.name.startsWith(`.`)||r.name===`node_modules`)continue;let i=t(e,r.name);n=r.isDirectory()?Math.max(n,d(i)):Math.max(n,s(i).mtimeMs)}}catch{}return n}const f=/(?:import|export)\s+.*?from\s+['"](\.[^'"]+)['"]/g,p=new Set([`.ts`,`.tsx`,`.mts`]);function m(e){let t=new Map;h(e,e,t);let n=[],r=new Set,i=new Set;function a(e,o){if(i.has(e)){let t=o.indexOf(e);t>=0&&n.push(o.slice(t).concat(e));return}if(!r.has(e)){r.add(e),i.add(e),o.push(e);for(let n of t.get(e)??[])a(n,o);o.pop(),i.delete(e)}}for(let e of t.keys())a(e,[]);return n}function h(r,i,c){let l;try{l=o(r)}catch{return}for(let o of l){if(o.startsWith(`.`)||o===`node_modules`||o===`__tests__`)continue;let l=t(r,o);try{if(s(l).isDirectory())h(l,i,c);else if(p.has(e(o))){let e=n(i,l).replace(/\\/g,`/`),t=a(l,`utf-8`),o=[];for(let e of t.matchAll(f)){let t=e[1],n=g(r,t,i);n&&o.push(n)}c.set(e,o)}}catch{}}}function g(e,t,i){let a=r(e,t);for(let e of[`.ts`,`.tsx`,`.mts`,`.js`,`.mjs`,``])return n(i,e?a.replace(/\.[^.]+$/,``)+e:a).replace(/\\/g,`/`).replace(/\.js$/,`.ts`).replace(/\.mjs$/,`.mts`);return null}export{c as health};

package/packages/tools/dist/http-request.d.ts

@@ -0,0 +1,25 @@
+//#region packages/tools/src/http-request.d.ts
+/**
+ * aikit_http — Make HTTP requests for API testing and debugging.
+ */
+type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD';
+interface HttpRequestOptions {
+  url: string;
+  method?: HttpMethod;
+  headers?: Record<string, string>;
+  body?: string;
+  timeout?: number;
+}
+interface HttpRequestResult {
+  status: number;
+  statusText: string;
+  headers: Record<string, string>;
+  body: string;
+  durationMs: number;
+  contentType: string;
+  sizeBytes: number;
+  truncated: boolean;
+}
+declare function httpRequest(options: HttpRequestOptions): Promise<HttpRequestResult>;
+//#endregion
+export { HttpMethod, HttpRequestOptions, HttpRequestResult, httpRequest };

package/packages/tools/dist/http-request.js

@@ -0,0 +1 @@
+import{headTailTruncate as e}from"./truncation.js";const t=5e4;async function n(n){let{url:r,method:i=`GET`,headers:a={},body:o,timeout:s=15e3}=n,c=new URL(r);if(c.protocol!==`http:`&&c.protocol!==`https:`)throw Error(`Unsupported protocol: ${c.protocol} — only http/https allowed`);let l=c.hostname;if(l===`169.254.169.254`||l===`metadata.google.internal`||l.startsWith(`fd`)||/^(10\.|172\.(1[6-9]|2\d|3[01])\.|192\.168\.)/.test(l)||l===`0.0.0.0`||l===`[::]`)throw Error(`Blocked request to private/metadata address: ${l}`);let u=new AbortController,d=setTimeout(()=>u.abort(),s),f=Date.now(),p;try{p=await fetch(r,{method:i,headers:{"User-Agent":`aikit-http/1.0`,...a},body:i!==`GET`&&i!==`HEAD`?o:void 0,signal:u.signal,redirect:`follow`})}finally{clearTimeout(d)}let m=Date.now()-f,h=await p.text(),g=p.headers.get(`content-type`)??``,_=h;if(g.includes(`json`))try{_=JSON.stringify(JSON.parse(h),null,2)}catch{}let v=!1;_.length>t&&(_=e(_,t),v=!0);let y={};return p.headers.forEach((e,t)=>{y[t]=e}),{status:p.status,statusText:p.statusText,headers:y,body:_,durationMs:m,contentType:g,sizeBytes:h.length,truncated:v}}export{n as httpRequest};

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

@@ -0,0 +1,57 @@
+import { KBError, KBErrorCode, KBNextHint, KBResponse, KBResponseMeta, errorResponse, okResponse } from "./response-envelope.js";
+import { AuditCheck, AuditData, AuditOptions, AuditRecommendation, audit } from "./audit.js";
+import { BatchOperation, BatchOptions, BatchResult, batch } from "./batch.js";
+import { ChangelogEntry, ChangelogFormat, ChangelogOptions, ChangelogResult, changelog, formatChangelog } from "./changelog.js";
+import { ParsedError, ParsedGitStatus, ParsedOutput, ParsedTestResult, ParsedTestSummary, parseBiome, parseGitStatus, parseOutput, parseTsc, parseVitest } from "./parse-output.js";
+import { CheckOptions, CheckResult, CheckSummaryResult, check, summarizeCheckResult } from "./check.js";
+import { Checkpoint, checkpointLatest, checkpointList, checkpointLoad, checkpointSave } from "./checkpoint.js";
+import { CodemodChange, CodemodOptions, CodemodResult, CodemodRule, codemod } from "./codemod.js";
+import { FileCache, FileCacheEntry, FileCacheStats } from "./file-cache.js";
+import { CompactOptions, CompactResult, compact } from "./compact.js";
+import { TransformOptions, TransformResult, dataTransform } from "./data-transform.js";
+import { DeadSymbol, DeadSymbolOptions, DeadSymbolResult, findDeadSymbols } from "./dead-symbols.js";
+import { DelegateOptions, DelegateResult, delegate, delegateListModels } from "./delegate.js";
+import { DiffChange, DiffFile, DiffHunk, DiffParseOptions, diffParse } from "./diff-parse.js";
+import { DigestFieldEntry, DigestOptions, DigestResult, DigestSource, digest } from "./digest.js";
+import { DogfoodLogEntry, DogfoodLogGroupedEntry, DogfoodLogOptions, DogfoodLogResult, dogfoodLog } from "./dogfood-log.js";
+import { EncodeOperation, EncodeOptions, EncodeResult, encode } from "./encode.js";
+import { EnvInfoOptions, EnvInfoResult, envInfo } from "./env-info.js";
+import { EvalOptions, EvalResult, evaluate } from "./eval.js";
+import { EvidenceEntry, EvidenceMapAction, EvidenceMapResult, EvidenceMapState, EvidenceStatus, ForgeTier, GateDecision, GateResult, SafetyGate, SafetyGateResult, UnknownType, autoClaimTestFailures, evidenceMap } from "./evidence-map.js";
+import { FileSummaryOptions, FileSummaryResult, fileSummary } from "./file-summary.js";
+import { Example, FindExamplesOptions, FindExamplesResult, findExamples } from "./find-examples.js";
+import { FindOptions, FindResult, FindResults, find } from "./find.js";
+import { ClassifyTrigger, ForgeClassifyCeremony, ForgeClassifyOptions, ForgeClassifyResult, TypedUnknownSeed, forgeClassify } from "./forge-classify.js";
+import { ScopeMapEntry, ScopeMapOptions, ScopeMapResult, scopeMap } from "./scope-map.js";
+import { ConstraintRef, ForgeGroundOptions, ForgeGroundResult, forgeGround } from "./forge-ground.js";
+import { GitContextOptions, GitContextResult, gitContext } from "./git-context.js";
+import { GraphAugmentOptions, GraphAugmentedResult, GraphQueryOptions, GraphQueryResult, graphAugmentSearch, graphQuery } from "./graph-query.js";
+import { GuideRecommendation, GuideResult, guide } from "./guide.js";
+import { HealthCheck, HealthResult, health } from "./health.js";
+import { HttpMethod, HttpRequestOptions, HttpRequestResult, httpRequest } from "./http-request.js";
+import { LaneDiffEntry, LaneDiffResult, LaneMergeResult, LaneMeta, laneCreate, laneDiff, laneDiscard, laneList, laneMerge, laneStatus } from "./lane.js";
+import { FileMetrics, MeasureOptions, MeasureResult, analyzeFile, measure } from "./measure.js";
+import { OnboardMode, OnboardOptions, OnboardResult, OnboardStepResult, onboard } from "./onboard.js";
+import { resolvePath } from "./path-resolver.js";
+import { ManagedProcess, processList, processLogs, processStart, processStatus, processStop } from "./process-manager.js";
+import { QueueItem, QueueState, queueClear, queueCreate, queueDelete, queueDone, queueFail, queueGet, queueList, queueNext, queuePush } from "./queue.js";
+import { RegexTestOptions, RegexTestResult, regexTest } from "./regex-test.js";
+import { escapeRegExp } from "./regex-utils.js";
+import { RenameChange, RenameOptions, RenameResult, rename } from "./rename.js";
+import { ReplayEntry, ReplayOptions, replayAppend, replayCapture, replayClear, replayList, replayTrim } from "./replay.js";
+import { RestorePoint, createRestorePoint, listRestorePoints, restoreFromPoint } from "./restore-points.js";
+import { SchemaValidateOptions, SchemaValidateResult, ValidationError, schemaValidate } from "./schema-validate.js";
+import { Snippet, SnippetAction, SnippetOptions, SnippetResult, snippet } from "./snippet.js";
+import { StashEntry, stashClear, stashDelete, stashGet, stashList, stashSet } from "./stash.js";
+import { StratumCard, StratumCardOptions, StratumCardResult, stratumCard } from "./stratum-card.js";
+import { SymbolGraphContext, SymbolInfo, SymbolOptions, symbol } from "./symbol.js";
+import { TestRunOptions, TestRunResult, classifyExitCode, testRun } from "./test-run.js";
+import { bookendReorder, cosineSimilarity, estimateTokens, segment } from "./text-utils.js";
+import { TimeOptions, TimeResult, timeUtils } from "./time-utils.js";
+import { TraceNode, TraceOptions, TraceResult, trace } from "./trace.js";
+import { headTailTruncate, paragraphTruncate, truncateToTokenBudget } from "./truncation.js";
+import { WatchEvent, WatchHandle, WatchOptions, watchList, watchStart, watchStop } from "./watch.js";
+import { WebFetchMode, WebFetchOptions, WebFetchResult, webFetch } from "./web-fetch.js";
+import { WebSearchOptions, WebSearchResult, WebSearchResultItem, parseSearchResults, webSearch } from "./web-search.js";
+import { Workset, addToWorkset, deleteWorkset, getWorkset, listWorksets, removeFromWorkset, saveWorkset } from "./workset.js";
+export { type AuditCheck, type AuditData, type AuditOptions, type AuditRecommendation, type BatchOperation, type BatchOptions, type BatchResult, type ChangelogEntry, type ChangelogFormat, type ChangelogOptions, type ChangelogResult, type CheckOptions, type CheckResult, type CheckSummaryResult, type Checkpoint, type ClassifyTrigger, type CodemodChange, type CodemodOptions, type CodemodResult, type CodemodRule, type CompactOptions, type CompactResult, type ConstraintRef, type DeadSymbol, type DeadSymbolOptions, type DeadSymbolResult, type DelegateOptions, type DelegateResult, type DiffChange, type DiffFile, type DiffHunk, type DiffParseOptions, type DigestFieldEntry, type DigestOptions, type DigestResult, type DigestSource, type DogfoodLogEntry, type DogfoodLogGroupedEntry, type DogfoodLogOptions, type DogfoodLogResult, type EncodeOperation, type EncodeOptions, type EncodeResult, type EnvInfoOptions, type EnvInfoResult, type EvalOptions, type EvalResult, type EvidenceEntry, type EvidenceMapAction, type EvidenceMapResult, type EvidenceMapState, type EvidenceStatus, type Example, FileCache, type FileCacheEntry, type FileCacheStats, type FileMetrics, type FileSummaryOptions, type FileSummaryResult, type FindExamplesOptions, type FindExamplesResult, type FindOptions, type FindResult, type FindResults, type ForgeClassifyCeremony, type ForgeClassifyOptions, type ForgeClassifyResult, type ForgeGroundOptions, type ForgeGroundResult, type ForgeTier, type GateDecision, type GateResult, type GitContextOptions, type GitContextResult, type GraphAugmentOptions, type GraphAugmentedResult, type GraphQueryOptions, type GraphQueryResult, type GuideRecommendation, type GuideResult, type HealthCheck, type HealthResult, type HttpMethod, type HttpRequestOptions, type HttpRequestResult, type KBError, type KBErrorCode, type KBNextHint, type KBResponse, type KBResponseMeta, type LaneDiffEntry, type LaneDiffResult, type LaneMergeResult, type LaneMeta, type ManagedProcess, type MeasureOptions, type MeasureResult, type OnboardMode, type OnboardOptions, type OnboardResult, type OnboardStepResult, type ParsedError, type ParsedGitStatus, type ParsedOutput, type ParsedTestResult, type ParsedTestSummary, type QueueItem, type QueueState, type RegexTestOptions, type RegexTestResult, type RenameChange, type RenameOptions, type RenameResult, type ReplayEntry, type ReplayOptions, type RestorePoint, type SafetyGate, type SafetyGateResult, type SchemaValidateOptions, type SchemaValidateResult, type ScopeMapEntry, type ScopeMapOptions, type ScopeMapResult, type Snippet, type SnippetAction, type SnippetOptions, type SnippetResult, type StashEntry, type StratumCard, type StratumCardOptions, type StratumCardResult, type SymbolGraphContext, type SymbolInfo, type SymbolOptions, type TestRunOptions, type TestRunResult, type TimeOptions, type TimeResult, type TraceNode, type TraceOptions, type TraceResult, type TransformOptions, type TransformResult, type TypedUnknownSeed, type UnknownType, type ValidationError, type WatchEvent, type WatchHandle, type WatchOptions, type WebFetchMode, type WebFetchOptions, type WebFetchResult, type WebSearchOptions, type WebSearchResult, type WebSearchResultItem, type Workset, addToWorkset, analyzeFile, audit, autoClaimTestFailures, batch, bookendReorder, changelog, check, checkpointLatest, checkpointList, checkpointLoad, checkpointSave, classifyExitCode, codemod, compact, cosineSimilarity, createRestorePoint, dataTransform, delegate, delegateListModels, deleteWorkset, diffParse, digest, dogfoodLog, encode, envInfo, errorResponse, escapeRegExp, estimateTokens, evaluate, evidenceMap, fileSummary, find, findDeadSymbols, findExamples, forgeClassify, forgeGround, formatChangelog, getWorkset, gitContext, graphAugmentSearch, graphQuery, guide, headTailTruncate, health, httpRequest, laneCreate, laneDiff, laneDiscard, laneList, laneMerge, laneStatus, listRestorePoints, listWorksets, measure, okResponse, onboard, paragraphTruncate, parseBiome, parseGitStatus, parseOutput, parseSearchResults, parseTsc, parseVitest, processList, processLogs, processStart, processStatus, processStop, queueClear, queueCreate, queueDelete, queueDone, queueFail, queueGet, queueList, queueNext, queuePush, regexTest, removeFromWorkset, rename, replayAppend, replayCapture, replayClear, replayList, replayTrim, resolvePath, restoreFromPoint, saveWorkset, schemaValidate, scopeMap, segment, snippet, stashClear, stashDelete, stashGet, stashList, stashSet, stratumCard, summarizeCheckResult, symbol, testRun, timeUtils, trace, truncateToTokenBudget, watchList, watchStart, watchStop, webFetch, webSearch };

package/packages/tools/dist/index.js

@@ -0,0 +1 @@
+import{parseBiome as e,parseGitStatus as t,parseOutput as n,parseTsc as r,parseVitest as i}from"./parse-output.js";import{check as a,summarizeCheckResult as o}from"./check.js";import{escapeRegExp as s}from"./regex-utils.js";import{findDeadSymbols as c}from"./dead-symbols.js";import{health as l}from"./health.js";import{resolvePath as u}from"./path-resolver.js";import{bookendReorder as d,cosineSimilarity as f,estimateTokens as p,segment as m}from"./text-utils.js";import{errorResponse as h,okResponse as g}from"./response-envelope.js";import{audit as _}from"./audit.js";import{batch as v}from"./batch.js";import{changelog as y,formatChangelog as b}from"./changelog.js";import{checkpointLatest as x,checkpointList as S,checkpointLoad as C,checkpointSave as w}from"./checkpoint.js";import{createRestorePoint as T,listRestorePoints as E,restoreFromPoint as D}from"./restore-points.js";import{codemod as O}from"./codemod.js";import{compact as k}from"./compact.js";import{dataTransform as A}from"./data-transform.js";import{delegate as j,delegateListModels as M}from"./delegate.js";import{diffParse as N}from"./diff-parse.js";import{digest as P}from"./digest.js";import{dogfoodLog as F}from"./dogfood-log.js";import{encode as I}from"./encode.js";import{envInfo as L}from"./env-info.js";import{evaluate as R}from"./eval.js";import{autoClaimTestFailures as z,evidenceMap as B}from"./evidence-map.js";import{FileCache as V}from"./file-cache.js";import{fileSummary as H}from"./file-summary.js";import{findExamples as U}from"./find-examples.js";import{find as W}from"./find.js";import{forgeClassify as G}from"./forge-classify.js";import{scopeMap as K}from"./scope-map.js";import{forgeGround as q}from"./forge-ground.js";import{gitContext as J}from"./git-context.js";import{graphAugmentSearch as Y,graphQuery as X}from"./graph-query.js";import{guide as Z}from"./guide.js";import{headTailTruncate as Q,paragraphTruncate as $,truncateToTokenBudget as ee}from"./truncation.js";import{httpRequest as te}from"./http-request.js";import{laneCreate as ne,laneDiff as re,laneDiscard as ie,laneList as ae,laneMerge as oe,laneStatus as se}from"./lane.js";import{analyzeFile as ce,measure as le}from"./measure.js";import{onboard as ue}from"./onboard.js";import{processList as de,processLogs as fe,processStart as pe,processStatus as me,processStop as he}from"./process-manager.js";import{queueClear as ge,queueCreate as _e,queueDelete as ve,queueDone as ye,queueFail as be,queueGet as xe,queueList as Se,queueNext as Ce,queuePush as we}from"./queue.js";import{regexTest as Te}from"./regex-test.js";import{rename as Ee}from"./rename.js";import{replayAppend as De,replayCapture as Oe,replayClear as ke,replayList as Ae,replayTrim as je}from"./replay.js";import{schemaValidate as Me}from"./schema-validate.js";import{snippet as Ne}from"./snippet.js";import{stashClear as Pe,stashDelete as Fe,stashGet as Ie,stashList as Le,stashSet as Re}from"./stash.js";import{stratumCard as ze}from"./stratum-card.js";import{symbol as Be}from"./symbol.js";import{classifyExitCode as Ve,testRun as He}from"./test-run.js";import{timeUtils as Ue}from"./time-utils.js";import{trace as We}from"./trace.js";import{watchList as Ge,watchStart as Ke,watchStop as qe}from"./watch.js";import{webFetch as Je}from"./web-fetch.js";import{parseSearchResults as Ye,webSearch as Xe}from"./web-search.js";import{addToWorkset as Ze,deleteWorkset as Qe,getWorkset as $e,listWorksets as et,removeFromWorkset as tt,saveWorkset as nt}from"./workset.js";export{V as FileCache,Ze as addToWorkset,ce as analyzeFile,_ as audit,z as autoClaimTestFailures,v as batch,d as bookendReorder,y as changelog,a as check,x as checkpointLatest,S as checkpointList,C as checkpointLoad,w as checkpointSave,Ve as classifyExitCode,O as codemod,k as compact,f as cosineSimilarity,T as createRestorePoint,A as dataTransform,j as delegate,M as delegateListModels,Qe as deleteWorkset,N as diffParse,P as digest,F as dogfoodLog,I as encode,L as envInfo,h as errorResponse,s as escapeRegExp,p as estimateTokens,R as evaluate,B as evidenceMap,H as fileSummary,W as find,c as findDeadSymbols,U as findExamples,G as forgeClassify,q as forgeGround,b as formatChangelog,$e as getWorkset,J as gitContext,Y as graphAugmentSearch,X as graphQuery,Z as guide,Q as headTailTruncate,l as health,te as httpRequest,ne as laneCreate,re as laneDiff,ie as laneDiscard,ae as laneList,oe as laneMerge,se as laneStatus,E as listRestorePoints,et as listWorksets,le as measure,g as okResponse,ue as onboard,$ as paragraphTruncate,e as parseBiome,t as parseGitStatus,n as parseOutput,Ye as parseSearchResults,r as parseTsc,i as parseVitest,de as processList,fe as processLogs,pe as processStart,me as processStatus,he as processStop,ge as queueClear,_e as queueCreate,ve as queueDelete,ye as queueDone,be as queueFail,xe as queueGet,Se as queueList,Ce as queueNext,we as queuePush,Te as regexTest,tt as removeFromWorkset,Ee as rename,De as replayAppend,Oe as replayCapture,ke as replayClear,Ae as replayList,je as replayTrim,u as resolvePath,D as restoreFromPoint,nt as saveWorkset,Me as schemaValidate,K as scopeMap,m as segment,Ne as snippet,Pe as stashClear,Fe as stashDelete,Ie as stashGet,Le as stashList,Re as stashSet,ze as stratumCard,o as summarizeCheckResult,Be as symbol,He as testRun,Ue as timeUtils,We as trace,ee as truncateToTokenBudget,Ge as watchList,Ke as watchStart,qe as watchStop,Je as webFetch,Xe as webSearch};

package/packages/tools/dist/lane.d.ts

@@ -0,0 +1,41 @@
+//#region packages/tools/src/lane.d.ts
+interface LaneMeta {
+  name: string;
+  createdAt: string;
+  sourceFiles: string[];
+  rootPath: string;
+}
+interface LaneDiffEntry {
+  file: string;
+  status: 'modified' | 'added' | 'deleted' | 'unchanged';
+  diff?: string;
+}
+interface LaneDiffResult {
+  name: string;
+  entries: LaneDiffEntry[];
+  modified: number;
+  added: number;
+  deleted: number;
+}
+interface LaneMergeResult {
+  name: string;
+  filesMerged: number;
+  files: string[];
+}
+/**
+ * Create an isolated lane by copying specified files into `.aikit-state/lanes/<name>/`.
+ * Files are stored with their relative paths preserved.
+ */
+declare function laneCreate(name: string, files: string[], cwd?: string): LaneMeta;
+/** List all active lanes. */
+declare function laneList(cwd?: string): LaneMeta[];
+/** Get the status of a lane — which files are modified, added, deleted. */
+declare function laneStatus(name: string, cwd?: string): LaneDiffResult;
+/** Generate a unified diff for modified files in a lane. */
+declare function laneDiff(name: string, cwd?: string): LaneDiffResult;
+/** Merge lane files back to the original locations. */
+declare function laneMerge(name: string, cwd?: string): LaneMergeResult;
+/** Discard a lane entirely. */
+declare function laneDiscard(name: string, cwd?: string): boolean;
+//#endregion
+export { LaneDiffEntry, LaneDiffResult, LaneMergeResult, LaneMeta, laneCreate, laneDiff, laneDiscard, laneList, laneMerge, laneStatus };

package/packages/tools/dist/lane.js

@@ -0,0 +1,6 @@
+import{join as e,relative as t,resolve as n}from"node:path";import{cpSync as r,existsSync as i,mkdirSync as a,readFileSync as o,readdirSync as s,rmSync as c,statSync as l,writeFileSync as u}from"node:fs";import{AIKIT_PATHS as d}from"../../core/dist/index.js";const f=`${d.state}/lanes`,p=`.lane-meta.json`;function m(e){return n(e??process.cwd(),f)}function h(e,t){let r=m(t),i=n(r,e);if(!i.startsWith(n(r)))throw Error(`Invalid lane name: "${e}"`);return i}function g(t,n){let r=e(h(t,n),p);if(!i(r))throw Error(`Lane "${t}" does not exist`);try{return JSON.parse(o(r,`utf-8`))}catch{throw Error(`Lane "${t}" has corrupted metadata`)}}function _(o,s,c){let l=c??process.cwd(),d=h(o,c);if(i(d))throw Error(`Lane "${o}" already exists`);a(d,{recursive:!0});let f=[];for(let o of s){let s=n(l,o);if(!i(s))throw Error(`Source file does not exist: ${o}`);let c=t(l,s).replace(/\\/g,`/`),u=e(d,c);a(e(u,`..`),{recursive:!0}),r(s,u),f.push(c)}let m={name:o,createdAt:new Date().toISOString(),sourceFiles:f,rootPath:l};return u(e(d,p),`${JSON.stringify(m,null,2)}\n`,`utf-8`),m}function v(t){let n=m(t);if(!i(n))return[];let r=s(n),a=[];for(let t of r){let r=e(n,t,p);if(i(r))try{a.push(JSON.parse(o(r,`utf-8`)))}catch{}}return a}function y(t,r){let a=g(t,r),s=h(t,r),c=a.rootPath,l=[];for(let t of a.sourceFiles){let r=n(c,t),a=e(s,t);if(!i(a)){l.push({file:t,status:`deleted`});continue}if(!i(r)){l.push({file:t,status:`added`});continue}o(r,`utf-8`)===o(a,`utf-8`)?l.push({file:t,status:`unchanged`}):l.push({file:t,status:`modified`})}let u=C(s);for(let e of u)a.sourceFiles.includes(e)||l.push({file:e,status:`added`});return{name:t,entries:l,modified:l.filter(e=>e.status===`modified`).length,added:l.filter(e=>e.status===`added`).length,deleted:l.filter(e=>e.status===`deleted`).length}}function b(t,r){let a=g(t,r),s=h(t,r),c=a.rootPath,l=[],u=new Set(a.sourceFiles);for(let e of C(s))u.add(e);for(let t of u){let r=n(c,t),a=e(s,t),u=i(r),d=i(a);if(!d&&u){l.push({file:t,status:`deleted`});continue}if(d&&!u){let e=o(a,`utf-8`);l.push({file:t,status:`added`,diff:e.split(`
+`).map(e=>`+${e}`).join(`
+`)});continue}if(!d||!u)continue;let f=o(r,`utf-8`),p=o(a,`utf-8`);f===p?l.push({file:t,status:`unchanged`}):l.push({file:t,status:`modified`,diff:w(f,p)})}return{name:t,entries:l,modified:l.filter(e=>e.status===`modified`).length,added:l.filter(e=>e.status===`added`).length,deleted:l.filter(e=>e.status===`deleted`).length}}function x(t,o){let s=g(t,o),l=h(t,o),u=s.rootPath,d=[],f=new Set(s.sourceFiles);for(let e of C(l))f.add(e);for(let t of f){let o=e(l,t);if(!i(o))continue;let s=n(u,t);a(e(s,`..`),{recursive:!0}),r(o,s),d.push(t)}return c(l,{recursive:!0,force:!0}),{name:t,filesMerged:d.length,files:d}}function S(e,t){let n=h(e,t);return i(n)?(c(n,{recursive:!0,force:!0}),!0):!1}function C(n){let r=[];function a(i){for(let o of s(i)){if(o===p)continue;let s=e(i,o);l(s).isDirectory()?a(s):r.push(t(n,s).replace(/\\/g,`/`))}}return i(n)&&a(n),r.sort()}function w(e,t){let n=e.split(`
+`),r=t.split(`
+`),i=[],a=Math.max(n.length,r.length);for(let e=0;e<a;e++){let t=n[e],a=r[e];t===a?i.push(` ${t??``}`):(t!==void 0&&i.push(`-${t}`),a!==void 0&&i.push(`+${a}`))}return i.join(`
+`)}export{_ as laneCreate,b as laneDiff,S as laneDiscard,v as laneList,x as laneMerge,y as laneStatus};

package/packages/tools/dist/measure.d.ts

@@ -0,0 +1,42 @@
+//#region packages/tools/src/measure.d.ts
+/**
+ * aikit_measure — Code complexity and size metrics.
+ */
+interface MeasureOptions {
+  path: string;
+  extensions?: string[];
+}
+interface FileMetrics {
+  path: string;
+  lines: {
+    total: number;
+    code: number;
+    blank: number;
+    comment: number;
+  };
+  complexity: number;
+  /** AST-based cognitive complexity that weights nested branches higher (available when WASM is active) */
+  cognitiveComplexity?: number;
+  functions: number;
+  imports: number;
+  exports: number;
+}
+interface MeasureResult {
+  files: FileMetrics[];
+  summary: {
+    totalFiles: number;
+    totalLines: number;
+    totalCodeLines: number;
+    avgComplexity: number;
+    maxComplexity: {
+      file: string;
+      value: number;
+    };
+    totalFunctions: number;
+  };
+}
+declare function measure(options: MeasureOptions): Promise<MeasureResult>;
+/** Exported for unit testing */
+declare function analyzeFile(path: string, content: string): FileMetrics;
+//#endregion
+export { FileMetrics, MeasureOptions, MeasureResult, analyzeFile, measure };

package/packages/tools/dist/measure.js

@@ -0,0 +1,2 @@
+import{extname as e,join as t,relative as n}from"node:path";import{SUPPORTED_EXTENSIONS as r,WasmRuntime as i}from"../../chunker/dist/index.js";import{readFileSync as a,readdirSync as o,statSync as s}from"node:fs";const c=new Set([`node_modules`,`.git`,`dist`,`build`,`coverage`,`.turbo`,`cdk.out`,`.cache`]),l=[/\bif\s*\(/g,/\belse\s+if\b/g,/\bfor\s*\(/g,/\bwhile\s*\(/g,/\bcase\s+/g,/\bcatch\s*\(/g,/&&/g,/\|\|/g,/\?\?/g];async function u(t){let{path:r,extensions:i=[`.ts`,`.tsx`,`.js`,`.jsx`]}=t,o=h(r,i),s=[];for(let t of o){let r=a(t,`utf8`),i=d(n(process.cwd(),t),r),o=await m(r,e(t));o!==void 0&&(i.cognitiveComplexity=o),s.push(i)}s.sort((e,t)=>t.complexity-e.complexity);let c=s.reduce((e,t)=>e+t.lines.total,0),l=s.reduce((e,t)=>e+t.lines.code,0),u=s.reduce((e,t)=>e+t.complexity,0),f=s.reduce((e,t)=>e+t.functions,0),p=s[0]??{path:``,complexity:0};return{files:s,summary:{totalFiles:s.length,totalLines:c,totalCodeLines:l,avgComplexity:s.length>0?Math.round(u/s.length*10)/10:0,maxComplexity:{file:p.path,value:p.complexity},totalFunctions:f}}}function d(e,t){let n=t.split(`
+`),r=0,i=0,a=!1;for(let e of n){let t=e.trim();if(t===``){r++;continue}if(a){i++,t.includes(`*/`)&&(a=!1);continue}if(t.startsWith(`//`)){i++;continue}t.startsWith(`/*`)&&(i++,a=!t.includes(`*/`))}let o=1;for(let e of l){let n=t.match(e);n&&(o+=n.length)}let s=(t.match(/\bfunction\b/g)?.length??0)+(t.match(/=>\s*[{(]/g)?.length??0),c=t.match(/^\s*import\s/gm)?.length??0,u=t.match(/^\s*export\s/gm)?.length??0;return{path:e,lines:{total:n.length,code:n.length-r-i,blank:r,comment:i},complexity:o,functions:s,imports:c,exports:u}}const f=new Set(`if_statement.for_statement.for_in_statement.while_statement.do_statement.switch_case.catch_clause.ternary_expression.if_statement.for_statement.while_statement.except_clause.list_comprehension.if_statement.for_statement.enhanced_for_statement.while_statement.catch_clause.ternary_expression.if_statement.for_statement.select_statement.if_expression.for_expression.while_expression.match_arm`.split(`.`)),p=new Set([`if_statement`,`if_expression`,`for_statement`,`for_in_statement`,`enhanced_for_statement`,`for_expression`,`while_statement`,`while_expression`,`do_statement`,`switch_statement`,`match_expression`,`try_statement`,`catch_clause`,`except_clause`,`lambda`,`lambda_expression`,`arrow_function`]);async function m(e,t){let n=i.get();if(!(!n||!r.has(t)))try{let r=await n.parse(e,t);if(!r)return;let i=0;function a(e,t){let n=f.has(e.type),r=p.has(e.type);n&&(i+=1+t);let o=r?t+1:t;for(let t=0;t<e.childCount;t++){let n=e.child(t);n&&a(n,o)}}return a(r.rootNode,0),i}catch{return}}function h(n,r){try{if(s(n).isFile())return[n]}catch{throw Error(`Path not found: ${n}`)}let i=[];function a(n){for(let l of o(n)){if(c.has(l))continue;let o=t(n,l);s(o).isDirectory()?a(o):r.includes(e(l).toLowerCase())&&i.push(o)}}return a(n),i.sort(),i}export{d as analyzeFile,u as measure};

package/packages/tools/dist/onboard-utils.d.ts

@@ -0,0 +1,12 @@
+//#region packages/tools/src/onboard-utils.d.ts
+/**
+ * Shared utilities for onboard sub-modules.
+ */
+declare const TEST_SEGMENTS: Set<string>;
+declare function isTestPath(filePath: string): boolean;
+/** Get the package key for grouping: detects monorepo, Java, and flat structures */
+declare function getPackageKey(fp: string): string;
+/** Try to match extensionless import path to actual source file */
+declare function resolveExtensionlessPath(nf: string, exportsByFile: Map<string, unknown>): string;
+//#endregion
+export { TEST_SEGMENTS, getPackageKey, isTestPath, resolveExtensionlessPath };

package/packages/tools/dist/onboard-utils.js

@@ -0,0 +1 @@
+const e=new Set([`test`,`tests`,`__tests__`,`spec`,`specs`,`__mocks__`,`__fixtures__`,`fixtures`,`test-utils`]);function t(t){return t.replace(/\\/g,`/`).split(`/`).some(t=>e.has(t))||/\.(test|spec)\.[jt]sx?$/.test(t)||/Test\.java$/.test(t)}function n(e){let t=e.split(`/`);if(t.length>=2&&[`packages`,`services`,`providers`,`apps`,`libs`].includes(t[0]))return`${t[0]}/${t[1]}`;let n=t.indexOf(`java`),r=t.indexOf(`kotlin`),i=n>=0?n:r;if(i>=0&&i+2<t.length){let e=t.slice(i+1);return[`com`,`org`,`net`,`io`,`dev`].includes(e[0])&&e.length>=3?e.slice(0,3).join(`/`):e.slice(0,2).join(`/`)}return t[0]===`src`&&t.length>=3?`${t[0]}/${t[1]}`:t[0]}function r(e,t){if(t.has(e))return e;for(let n of[`.ts`,`.tsx`,`.js`,`.jsx`])if(t.has(`${e}${n}`))return`${e}${n}`;return t.has(`${e}/index.ts`)?`${e}/index.ts`:e}export{e as TEST_SEGMENTS,n as getPackageKey,t as isTestPath,r as resolveExtensionlessPath};

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

@@ -0,0 +1,50 @@
+//#region packages/tools/src/onboard.d.ts
+/**
+ * aikit_onboard — First-time codebase onboarding in a single command.
+ *
+ * Runs all analysis tools in parallel and optionally writes structured
+ * output to `.ai/kb/` for human-readable reference.
+ *
+ * Analyses: structure, dependencies, entry-points, symbols, patterns, diagram.
+ */
+type OnboardMode = 'memory' | 'generate';
+interface OnboardOptions {
+  /** Root path to analyze */
+  path: string;
+  /** Output mode: 'memory' (KB only) or 'generate' (write to .ai/kb/) */
+  mode?: OnboardMode;
+  /** Output directory for generate mode (default: '<path>/.ai/kb') */
+  outDir?: string;
+}
+interface OnboardStepResult {
+  name: string;
+  status: 'success' | 'failed';
+  output: string;
+  durationMs: number;
+  error?: string;
+}
+interface OnboardResult {
+  /** Root path that was analyzed */
+  path: string;
+  /** Mode used */
+  mode: OnboardMode;
+  /** Results for each analysis step */
+  steps: OnboardStepResult[];
+  /** Output directory (only set in generate mode) */
+  outDir?: string;
+  /** Total duration in ms */
+  totalDurationMs: number;
+  /** Auto-generated knowledge entries for curated store persistence */
+  autoRemember?: Array<{
+    title: string;
+    content: string;
+    category: string;
+    tags: string[];
+  }>;
+}
+/**
+ * Run all onboarding analyses in parallel and return combined results.
+ */
+declare function onboard(options: OnboardOptions): Promise<OnboardResult>;
+//#endregion
+export { OnboardMode, OnboardOptions, OnboardResult, OnboardStepResult, onboard };

package/packages/tools/dist/onboard.js

@@ -0,0 +1,18 @@
+import{extractConfigValues as e}from"./config-extractor.js";import{buildDiagrams as t}from"./diagram-builder.js";import{buildCodeMap as n,buildSynthesisGuide as r}from"./synthesis-engine.js";import{DependencyAnalyzer as i,DiagramGenerator as a,EntryPointAnalyzer as o,PatternAnalyzer as ee,StructureAnalyzer as s,SymbolAnalyzer as c,extractRegexCallGraph as l,extractTsCallGraph as u}from"../../analyzers/dist/index.js";import{basename as d,join as f,resolve as p}from"node:path";import{existsSync as m,mkdirSync as h,readdirSync as g,rmSync as _,writeFileSync as v}from"node:fs";import{AIKIT_PATHS as y}from"../../core/dist/index.js";const b={structure:`Project Structure`,dependencies:`Dependencies`,"entry-points":`Entry Points`,symbols:`Symbols`,patterns:`Patterns`,diagram:`C4 Container Diagram`,"code-map":`Code Map (Module Graph)`,"config-values":`Configuration Values`,"synthesis-guide":`Synthesis Guide`,"api-surface":`API Surface`,"type-inventory":`Type Inventory`};function x(e){let t=e.get(`symbols`);if(!t?.symbols?.length)return`# API Surface
+
+*No symbol data available.*
+`;let n=t.symbols.filter(e=>e.exported);if(n.length===0)return`# API Surface
+
+*No exported symbols found.*
+`;let r=new Map;for(let e of n){let t=r.get(e.filePath)??[];t.push(e),r.set(e.filePath,t)}let i=[`# API Surface
+`];for(let[e,t]of[...r.entries()].sort(([e],[t])=>e.localeCompare(t))){i.push(`## ${e}\n`);for(let e of t){e.decorators?.length&&i.push(e.decorators.join(` `));let t=e.signature??``,n=e.returnType?`: ${e.returnType}`:``;if(e.kind===`function`||e.kind===`method`)i.push(`### \`${e.name}${t}${n}\``);else if(e.kind===`class`)i.push(`### class \`${e.name}\`${t?` ${t}`:``}`);else if(e.kind===`interface`||e.kind===`type`){let t=e.typeBody?` ${e.typeBody}`:``;i.push(`### ${e.kind} \`${e.name}\`${t}`)}else i.push(`### ${e.kind} \`${e.name}\`${t?`: ${t}`:``}`);e.jsdoc&&i.push(`> ${e.jsdoc}`),i.push(``)}}let a=i.join(`
+`);return a.length>1e5?`${a.slice(0,1e5)}\n\n*[truncated]*`:a}function S(e){let t=e.get(`symbols`);if(!t?.symbols?.length)return`# Type Inventory
+
+*No symbol data available.*
+`;let n=t.symbols.filter(e=>e.exported&&(e.kind===`interface`||e.kind===`type`||e.kind===`enum`));if(n.length===0)return`# Type Inventory
+
+*No exported types/interfaces found.*
+`;let r=new Map;for(let e of n){let t=r.get(e.filePath)??[];t.push(e),r.set(e.filePath,t)}let i=[`# Type Inventory
+`];for(let[e,t]of[...r.entries()].sort(([e],[t])=>e.localeCompare(t))){i.push(`## ${e}\n`);for(let e of t){let t=e.typeBody??`*body not available*`;e.jsdoc&&i.push(`> ${e.jsdoc}`),i.push(`### ${e.kind} \`${e.name}\``),i.push("```"),i.push(t),i.push("```\n")}}let a=i.join(`
+`);return a.length>1e5?`${a.slice(0,1e5)}\n\n*[truncated]*`:a}async function C(C){let w=Date.now(),T=p(C.path),E=d(T),D=C.mode??`generate`,O=C.outDir??f(T,y.aiKb),k=new s,A=new i,j=new c,M=new ee,N=new o,P=new a,F=[{name:`structure`,fn:()=>k.analyze(T,{format:`markdown`,maxDepth:3,sourceOnly:!0})},{name:`dependencies`,fn:()=>A.analyze(T,{format:`markdown`})},{name:`entry-points`,fn:()=>N.analyze(T)},{name:`symbols`,fn:()=>j.analyze(T,{format:`markdown`})},{name:`patterns`,fn:()=>M.analyze(T)},{name:`diagram`,fn:()=>P.analyze(T,{diagramType:`architecture`})}],I=await Promise.allSettled(F.map(async e=>{let t=Date.now(),n=await e.fn();return{name:e.name,result:n,durationMs:Date.now()-t}})),L=[],R=new Map,z=new Map;for(let e of I)if(e.status===`fulfilled`){let{name:t,result:n,durationMs:r}=e.value,i=n;L.push({name:t,status:`success`,output:i.output,durationMs:r}),R.set(t,i.output),z.set(t,i.data)}else{let t=e.reason,n=F[I.indexOf(e)].name;L.push({name:n,status:`failed`,output:``,durationMs:0,error:t.message})}let B=Date.now(),V=null;try{let e=await u(T);if((!e||e.edges.length===0)&&(e=await l(T)),e&&e.edges.length>0){V=new Map;for(let t of e.edges){let e=V.get(t.from);e||(e=new Map,V.set(t.from,e));let n=e.get(t.to);if(n)for(let e of t.symbols)n.includes(e)||n.push(e);else e.set(t.to,[...t.symbols])}}}catch{}let H=Date.now()-B,U=Date.now(),W=n(z,E,V),G=Date.now()-U+H;if(L.push({name:`code-map`,status:`success`,output:W,durationMs:G}),R.set(`code-map`,W),V&&V.size>0){let e=t(V,z,E),n=L.find(e=>e.name===`diagram`);n&&(n.output=e,R.set(`diagram`,e))}let K=Date.now(),q=await e(T,E),J=Date.now()-K;L.push({name:`config-values`,status:`success`,output:q,durationMs:J}),R.set(`config-values`,q);let Y=r(L,D,E,z);L.push({name:`synthesis-guide`,status:`success`,output:Y,durationMs:0}),R.set(`synthesis-guide`,Y);let X=x(z);L.push({name:`api-surface`,status:`success`,output:X,durationMs:0}),R.set(`api-surface`,X);let Z=S(z);if(L.push({name:`type-inventory`,status:`success`,output:Z,durationMs:0}),R.set(`type-inventory`,Z),D===`generate`){if(m(O))for(let e of g(O))(e.endsWith(`.md`)||e.endsWith(`.json`))&&_(f(O,e),{force:!0});h(O,{recursive:!0});let e=new Date().toISOString();for(let[t,n]of R){let r=f(O,`${t}.md`),i=n.replaceAll(T,E);v(r,`<!-- Generated: ${e} -->\n<!-- Project: ${E} -->\n<!-- Source: ${T} -->\n\n`+i,`utf-8`)}let t=[`<!-- Generated: ${e} -->`,`<!-- Project: ${E} -->`,`<!-- Source: ${T} -->`,``,`# ${E} — Codebase Knowledge`,``,`## Contents`,``];for(let e of L){let n=`${e.name}.md`,r=b[e.name]??e.name,i=e.status===`success`?`✓`:`✗`,a=e.durationMs>0?` (${e.durationMs}ms)`:``;t.push(`- ${i} [${r}](./${n})${a}`)}t.push(``),v(f(O,`README.md`),t.join(`
+`),`utf-8`)}let Q=[];Q.push({title:`Onboard: ${E} project overview`,content:Y.slice(0,2e3),category:`conventions`,tags:[`onboard`,`project-overview`,E]});let $=L.find(e=>e.name===`patterns`);return $?.status===`success`&&$.output&&Q.push({title:`Onboard: ${E} detected patterns`,content:$.output.slice(0,1500),category:`patterns`,tags:[`onboard`,`patterns`,E]}),q&&Q.push({title:`Onboard: ${E} config and commands`,content:q.slice(0,1500),category:`conventions`,tags:[`onboard`,`config`,`commands`,E]}),{path:T,mode:D,steps:L,outDir:D===`generate`?O:void 0,totalDurationMs:Date.now()-w,autoRemember:Q}}export{C as onboard};

package/packages/tools/dist/parse-output.d.ts

@@ -0,0 +1,82 @@
+//#region packages/tools/src/parse-output.d.ts
+/**
+ * aikit_parse_output — Structured parsers for common build tool output.
+ *
+ * Converts noisy text output from tsc, vitest, biome, and git status
+ * into structured JSON that LLM agents can act on directly.
+ */
+interface ParsedError {
+  file: string;
+  line?: number;
+  column?: number;
+  severity: 'error' | 'warning' | 'info';
+  code?: string;
+  message: string;
+}
+interface ParsedTestResult {
+  name: string;
+  file?: string;
+  status: 'pass' | 'fail' | 'skip';
+  duration?: number;
+  error?: string;
+}
+interface ParsedTestSummary {
+  tests: ParsedTestResult[];
+  passed: number;
+  failed: number;
+  skipped: number;
+  duration?: number;
+  suites?: number;
+}
+interface ParsedGitStatus {
+  staged: Array<{
+    status: string;
+    file: string;
+  }>;
+  unstaged: Array<{
+    status: string;
+    file: string;
+  }>;
+  untracked: string[];
+  branch?: string;
+}
+type ParsedOutput = {
+  tool: 'tsc';
+  errors: ParsedError[];
+} | {
+  tool: 'vitest';
+  summary: ParsedTestSummary;
+} | {
+  tool: 'biome';
+  errors: ParsedError[];
+} | {
+  tool: 'git-status';
+  status: ParsedGitStatus;
+};
+/**
+ * Parse `tsc` output into structured errors.
+ *
+ * Example line: `src/foo.ts(10,5): error TS2339: Property 'x' does not exist`
+ */
+declare function parseTsc(output: string): ParsedError[];
+/**
+ * Parse vitest run output into structured test results.
+ */
+declare function parseVitest(output: string): ParsedTestSummary;
+/**
+ * Parse biome check/lint output into structured errors.
+ *
+ * Example: `src/foo.ts:10:5 lint/suspicious/noDoubleEquals ━━━`
+ *          `  × Use === instead of ==`
+ */
+declare function parseBiome(output: string): ParsedError[];
+/**
+ * Parse `git status --porcelain=v1 -b` output into structured status.
+ */
+declare function parseGitStatus(output: string): ParsedGitStatus;
+/**
+ * Auto-detect the tool from output content and parse accordingly.
+ */
+declare function parseOutput(output: string, tool?: string): ParsedOutput;
+//#endregion
+export { ParsedError, ParsedGitStatus, ParsedOutput, ParsedTestResult, ParsedTestSummary, parseBiome, parseGitStatus, parseOutput, parseTsc, parseVitest };

package/packages/tools/dist/parse-output.js

@@ -0,0 +1,2 @@
+function e(e){let t=[];for(let n of e.matchAll(/^(.+?)\((\d+),(\d+)\):\s+(error|warning)\s+(TS\d+):\s+(.+)$/gm))t.push({file:n[1],line:Number.parseInt(n[2],10),column:Number.parseInt(n[3],10),severity:n[4],code:n[5],message:n[6]});if(t.length===0)for(let n of e.matchAll(/^(.+?):(\d+):(\d+)\s+-\s+(error|warning)\s+(TS\d+):\s+(.+)$/gm))t.push({file:n[1],line:Number.parseInt(n[2],10),column:Number.parseInt(n[3],10),severity:n[4],code:n[5],message:n[6]});return t}function t(e){return e.replace(/\x1B(?:[@-Z\\-_]|\[[0-?]*[ -/]*[@-~])/g,``)}function n(e){let n=t(e),r=[];for(let e of n.matchAll(/^\s*([✓✕×-])\s+(.+?)(?:\s+(\d+)ms)?$/gm)){let t=e[1],n=t===`✓`?`pass`:t===`-`?`skip`:`fail`;r.push({name:e[2].trim(),status:n,duration:e[3]?Number.parseInt(e[3],10):void 0})}for(let e of n.matchAll(/^\s*([✓✕×])\s+(\S+\.test\.\w+)\s+\((\d+)\s+tests?\)\s*(\d+ms)?$/gm)){let t=e[1]===`✓`?`pass`:`fail`;r.push({name:e[2],file:e[2],status:t,duration:e[4]?Number.parseInt(e[4],10):void 0})}let i=/Tests\s+(?:(\d+)\s+passed)?(?:\s*\|\s*)?(?:(\d+)\s+failed)?(?:\s*\|\s*)?(?:(\d+)\s+skipped)?\s*\((\d+)\)/.exec(n),a=i?Number.parseInt(i[1]??`0`,10):r.filter(e=>e.status===`pass`).length,o=i?Number.parseInt(i[2]??`0`,10):r.filter(e=>e.status===`fail`).length,s=i?Number.parseInt(i[3]??`0`,10):r.filter(e=>e.status===`skip`).length,c=/Duration\s+(\d+(?:\.\d+)?)(?:ms|s)/.exec(n),l=c?c[0].includes(`s`)&&!c[0].includes(`ms`)?Number.parseFloat(c[1])*1e3:Number.parseFloat(c[1]):void 0,u=/Test Files\s+(\d+)\s+passed/.exec(n);return{tests:r,passed:a,failed:o,skipped:s,duration:l,suites:u?Number.parseInt(u[1],10):void 0}}function r(e){let t=[];for(let n of e.matchAll(/^(.+?):(\d+):(\d+)\s+([\w/]+)\s+━+$/gm)){let r=n[1],i=Number.parseInt(n[2],10),a=Number.parseInt(n[3],10),o=n[4],s=e.slice((n.index??0)+n[0].length,(n.index??0)+n[0].length+500),c=/^\s*[×!i]\s+(.+)$/m.exec(s),l=c?c[1].trim():o,u=o.includes(`lint`)?`warning`:`error`;t.push({file:r,line:i,column:a,severity:u,code:o,message:l})}return t}function i(e){let t=[],n=[],r=[],i;for(let o of e.split(`
+`)){if(!o)continue;if(o.startsWith(`## `)){i=o.slice(3).split(`...`)[0];continue}let e=o[0],s=o[1],c=o.slice(3).trim();e===`?`&&s===`?`?r.push(c):(e!==` `&&e!==`?`&&t.push({status:a(e),file:c}),s!==` `&&s!==`?`&&n.push({status:a(s),file:c}))}return{staged:t,unstaged:n,untracked:r,branch:i}}function a(e){return{M:`modified`,A:`added`,D:`deleted`,R:`renamed`,C:`copied`,U:`unmerged`}[e]??e}function o(t,a){let o=a??s(t);switch(o){case`tsc`:return{tool:`tsc`,errors:e(t)};case`vitest`:return{tool:`vitest`,summary:n(t)};case`biome`:return{tool:`biome`,errors:r(t)};case`git-status`:return{tool:`git-status`,status:i(t)};default:throw Error(`Unknown tool: ${o}. Supported: tsc, vitest, biome, git-status`)}}function s(e){return e.includes(`error TS`)||/\(\d+,\d+\):\s+error/.test(e)?`tsc`:e.includes(`vitest`)||e.includes(`Test Files`)||e.includes(`✓`)?`vitest`:e.includes(`biome`)||/\w+\/\w+\s+━+/.test(e)?`biome`:/^##\s/.test(e)||/^[MADRCU?! ]{2}\s/.test(e)?`git-status`:`unknown`}export{r as parseBiome,i as parseGitStatus,o as parseOutput,e as parseTsc,n as parseVitest};