@vpxa/kb 0.1.13 → 0.1.16

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

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

@@ -1,23 +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.
  */
-export interface GuideRecommendation {
-    tool: string;
-    reason: string;
-    order: number;
-    suggestedArgs?: Record<string, unknown>;
+interface GuideRecommendation {
+  tool: string;
+  reason: string;
+  order: number;
+  suggestedArgs?: Record<string, unknown>;
 }
-export interface GuideResult {
-    workflow: string;
-    description: string;
-    tools: GuideRecommendation[];
-    alternativeWorkflows: string[];
+interface GuideResult {
+  workflow: string;
+  description: string;
+  tools: GuideRecommendation[];
+  alternativeWorkflows: string[];
 }
 /**
  * Match a goal description to the best workflow and return tool recommendations.
  */
-export declare function guide(goal: string, maxRecommendations?: number): GuideResult;
-//# sourceMappingURL=guide.d.ts.map
+declare function guide(goal: string, maxRecommendations?: number): GuideResult;
+//#endregion
+export { GuideRecommendation, GuideResult, guide };

package/packages/tools/dist/guide.js

@@ -1 +1 @@
-const t=[{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}]}];function u(n,i=5){const d=n.toLowerCase(),s=t.map(e=>{let r=0;for(const a of e.keywords)d.includes(a)&&(r+=a.includes(" ")?2:1);return{workflow:e,score:r}}).filter(e=>e.score>0).sort((e,r)=>r.score-e.score),l=t.find(e=>e.name==="search")??t[0],o=s[0]?.workflow??l,c=s.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,i),alternativeWorkflows:c}}export{u as guide};
+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}]}];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

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

package/packages/tools/dist/health.js

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

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

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

@@ -1 +1 @@
-import{headTailTruncate as E}from"./truncation.js";const u=5e4,R=15e3;async function H(d){const{url:n,method:s="GET",headers:l={},body:h,timeout:T=R}=d,o=new URL(n);if(o.protocol!=="http:"&&o.protocol!=="https:")throw new Error(`Unsupported protocol: ${o.protocol} \u2014 only http/https allowed`);const a=new AbortController,g=setTimeout(()=>a.abort(),T),y=Date.now();let t;try{t=await fetch(n,{method:s,headers:{"User-Agent":"kb-http/1.0",...l},body:s!=="GET"&&s!=="HEAD"?h:void 0,signal:a.signal,redirect:"follow"})}finally{clearTimeout(g)}const f=Date.now()-y,r=await t.text(),i=t.headers.get("content-type")??"";let e=r;if(i.includes("json"))try{e=JSON.stringify(JSON.parse(r),null,2)}catch{}let c=!1;e.length>u&&(e=E(e,u),c=!0);const p={};return t.headers.forEach((m,b)=>{p[b]=m}),{status:t.status,statusText:t.statusText,headers:p,body:e,durationMs:f,contentType:i,sizeBytes:r.length,truncated:c}}export{H as httpRequest};
+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":`kb-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

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

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

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

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

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