@vpxa/kb 0.1.13 → 0.1.15

package/packages/tools/dist/response-envelope.d.ts

@@ -1,41 +1,44 @@
+//#region packages/tools/src/response-envelope.d.ts
 /**
  * Standardized response envelope for KB tools (E-009).
  * New tools should return KBResponse<T>. Existing tools can adopt gradually.
  */
-export interface KBNextHint {
-    tool: string;
-    reason: string;
-    suggested_args?: Record<string, unknown>;
+interface KBNextHint {
+  tool: string;
+  reason: string;
+  suggested_args?: Record<string, unknown>;
 }
-export interface KBError {
-    code: KBErrorCode;
-    category: 'input' | 'runtime' | 'dependency' | 'timeout' | 'not_found';
-    retryable: boolean;
-    message: string;
-    suggestion?: string;
+interface KBError {
+  code: KBErrorCode;
+  category: 'input' | 'runtime' | 'dependency' | 'timeout' | 'not_found';
+  retryable: boolean;
+  message: string;
+  suggestion?: string;
 }
-export type KBErrorCode = 'SYMBOL_NOT_FOUND' | 'INDEX_STALE' | 'TREE_SITTER_UNAVAILABLE' | 'PARSE_FAILED' | 'BUDGET_EXCEEDED' | 'PATH_NOT_FOUND' | 'EMBEDDING_COLD_START' | 'ANALYSIS_FAILED';
-export interface KBResponseMeta {
-    durationMs: number;
-    tokensEstimate: number;
-    detail: 'summary' | 'errors' | 'full';
-    cached: boolean;
-    truncated: boolean;
-    caveats?: string[];
+type KBErrorCode = 'SYMBOL_NOT_FOUND' | 'INDEX_STALE' | 'TREE_SITTER_UNAVAILABLE' | 'PARSE_FAILED' | 'BUDGET_EXCEEDED' | 'PATH_NOT_FOUND' | 'EMBEDDING_COLD_START' | 'ANALYSIS_FAILED';
+interface KBResponseMeta {
+  durationMs: number;
+  tokensEstimate: number;
+  detail: 'summary' | 'errors' | 'full';
+  cached: boolean;
+  truncated: boolean;
+  caveats?: string[];
 }
-export interface KBResponse<T> {
-    ok: boolean;
-    tool: string;
-    summary: string;
-    data?: T;
-    meta: KBResponseMeta;
-    next?: KBNextHint[];
-    error?: KBError;
+interface KBResponse<T> {
+  ok: boolean;
+  tool: string;
+  summary: string;
+  data?: T;
+  meta: KBResponseMeta;
+  next?: KBNextHint[];
+  error?: KBError;
 }
 /** Create a success response. */
-export declare function okResponse<T>(tool: string, summary: string, data: T, meta: Partial<KBResponseMeta> & {
-    durationMs: number;
+declare function okResponse<T>(tool: string, summary: string, data: T, meta: Partial<KBResponseMeta> & {
+  durationMs: number;
 }, next?: KBNextHint[]): KBResponse<T>;
 /** Create an error response. */
-export declare function errorResponse(tool: string, error: KBError, durationMs: number): KBResponse<never>;
+declare function errorResponse(tool: string, error: KBError, durationMs: number): KBResponse<never>;
+//#endregion
+export { KBError, KBErrorCode, KBNextHint, KBResponse, KBResponseMeta, errorResponse, okResponse };
 //# sourceMappingURL=response-envelope.d.ts.map

package/packages/tools/dist/response-envelope.js

@@ -1 +1,2 @@
-import{estimateTokens as n}from"./text-utils.js";function u(s,r,t,e,o){const a=typeof t=="string"?t:JSON.stringify(t);return{ok:!0,tool:s,summary:r,data:t,meta:{durationMs:e.durationMs,tokensEstimate:e.tokensEstimate??n(a),detail:e.detail??"summary",cached:e.cached??!1,truncated:e.truncated??!1,...e.caveats?.length?{caveats:e.caveats}:{}},next:o}}function c(s,r,t){return{ok:!1,tool:s,summary:r.message,meta:{durationMs:t,tokensEstimate:n(r.message),detail:"summary",cached:!1,truncated:!1},error:r}}export{c as errorResponse,u as okResponse};
+import{estimateTokens as e}from"./text-utils.js";function t(t,n,r,i,a){let o=typeof r==`string`?r:JSON.stringify(r);return{ok:!0,tool:t,summary:n,data:r,meta:{durationMs:i.durationMs,tokensEstimate:i.tokensEstimate??e(o),detail:i.detail??`summary`,cached:i.cached??!1,truncated:i.truncated??!1,...i.caveats?.length?{caveats:i.caveats}:{}},next:a}}function n(t,n,r){return{ok:!1,tool:t,summary:n.message,meta:{durationMs:r,tokensEstimate:e(n.message),detail:`summary`,cached:!1,truncated:!1},error:n}}export{n as errorResponse,t as okResponse};
+//# sourceMappingURL=response-envelope.js.map

package/packages/tools/dist/schema-validate.d.ts

@@ -1,3 +1,4 @@
+//#region packages/tools/src/schema-validate.d.ts
 /**
  * kb_schema_validate — Validate data against a JSON Schema (core subset).
  *
@@ -5,19 +6,21 @@
  * enum, const, pattern, minimum, maximum, minLength, maxLength,
  * minItems, maxItems.
  */
-export interface SchemaValidateOptions {
-    data: unknown;
-    schema: Record<string, unknown>;
+interface SchemaValidateOptions {
+  data: unknown;
+  schema: Record<string, unknown>;
 }
-export interface ValidationError {
-    path: string;
-    message: string;
-    expected?: string;
-    received?: string;
+interface ValidationError {
+  path: string;
+  message: string;
+  expected?: string;
+  received?: string;
 }
-export interface SchemaValidateResult {
-    valid: boolean;
-    errors: ValidationError[];
+interface SchemaValidateResult {
+  valid: boolean;
+  errors: ValidationError[];
 }
-export declare function schemaValidate(options: SchemaValidateOptions): SchemaValidateResult;
+declare function schemaValidate(options: SchemaValidateOptions): SchemaValidateResult;
+//#endregion
+export { SchemaValidateOptions, SchemaValidateResult, ValidationError, schemaValidate };
 //# sourceMappingURL=schema-validate.d.ts.map

package/packages/tools/dist/schema-validate.js

@@ -1 +1,2 @@
-function m(e){const n=[];return u(e.data,e.schema,"$",n),{valid:n.length===0,errors:n}}function u(e,n,r,t){if("type"in n){const i=n.type;if(!f(e,i)){t.push({path:r,message:`Expected type "${i}"`,expected:i,received:l(e)});return}}if("enum"in n){const i=n.enum;i.some(o=>JSON.stringify(o)===JSON.stringify(e))||t.push({path:r,message:`Must be one of: ${JSON.stringify(i)}`,received:JSON.stringify(e)})}if("const"in n&&JSON.stringify(e)!==JSON.stringify(n.const)&&t.push({path:r,message:`Must equal ${JSON.stringify(n.const)}`,received:JSON.stringify(e)}),typeof e=="string"&&("minLength"in n&&e.length<n.minLength&&t.push({path:r,message:`String too short (min: ${n.minLength})`,received:`length ${e.length}`}),"maxLength"in n&&e.length>n.maxLength&&t.push({path:r,message:`String too long (max: ${n.maxLength})`,received:`length ${e.length}`}),"pattern"in n&&!new RegExp(n.pattern).test(e)&&t.push({path:r,message:`Does not match pattern: ${n.pattern}`})),typeof e=="number"&&("minimum"in n&&e<n.minimum&&t.push({path:r,message:`Below minimum (${n.minimum})`,received:String(e)}),"maximum"in n&&e>n.maximum&&t.push({path:r,message:`Above maximum (${n.maximum})`,received:String(e)})),Array.isArray(e)&&("minItems"in n&&e.length<n.minItems&&t.push({path:r,message:`Too few items (min: ${n.minItems})`,received:`length ${e.length}`}),"maxItems"in n&&e.length>n.maxItems&&t.push({path:r,message:`Too many items (max: ${n.maxItems})`,received:`length ${e.length}`}),"items"in n))for(let i=0;i<e.length;i++)u(e[i],n.items,`${r}[${i}]`,t);if(e&&typeof e=="object"&&!Array.isArray(e)){const i=e;if("required"in n)for(const o of n.required)o in i||t.push({path:`${r}.${o}`,message:"Required property missing"});if("properties"in n){const o=n.properties;for(const[s,g]of Object.entries(o))s in i&&u(i[s],g,`${r}.${s}`,t)}if("additionalProperties"in n&&n.additionalProperties===!1){const o=Object.keys(n.properties??{});for(const s of Object.keys(i))o.includes(s)||t.push({path:`${r}.${s}`,message:"Additional property not allowed"})}}}function f(e,n){switch(n){case"string":return typeof e=="string";case"number":return typeof e=="number"&&!Number.isNaN(e);case"integer":return typeof e=="number"&&Number.isInteger(e);case"boolean":return typeof e=="boolean";case"null":return e===null;case"array":return Array.isArray(e);case"object":return e!==null&&typeof e=="object"&&!Array.isArray(e);default:return!0}}function l(e){return e===null?"null":Array.isArray(e)?"array":typeof e}export{m as schemaValidate};
+function e(e){let n=[];return t(e.data,e.schema,`$`,n),{valid:n.length===0,errors:n}}function t(e,i,a,o){if(`type`in i){let t=i.type;if(!n(e,t)){o.push({path:a,message:`Expected type "${t}"`,expected:t,received:r(e)});return}}if(`enum`in i){let t=i.enum;t.some(t=>JSON.stringify(t)===JSON.stringify(e))||o.push({path:a,message:`Must be one of: ${JSON.stringify(t)}`,received:JSON.stringify(e)})}if(`const`in i&&JSON.stringify(e)!==JSON.stringify(i.const)&&o.push({path:a,message:`Must equal ${JSON.stringify(i.const)}`,received:JSON.stringify(e)}),typeof e==`string`&&(`minLength`in i&&e.length<i.minLength&&o.push({path:a,message:`String too short (min: ${i.minLength})`,received:`length ${e.length}`}),`maxLength`in i&&e.length>i.maxLength&&o.push({path:a,message:`String too long (max: ${i.maxLength})`,received:`length ${e.length}`}),`pattern`in i&&!new RegExp(i.pattern).test(e)&&o.push({path:a,message:`Does not match pattern: ${i.pattern}`})),typeof e==`number`&&(`minimum`in i&&e<i.minimum&&o.push({path:a,message:`Below minimum (${i.minimum})`,received:String(e)}),`maximum`in i&&e>i.maximum&&o.push({path:a,message:`Above maximum (${i.maximum})`,received:String(e)})),Array.isArray(e)&&(`minItems`in i&&e.length<i.minItems&&o.push({path:a,message:`Too few items (min: ${i.minItems})`,received:`length ${e.length}`}),`maxItems`in i&&e.length>i.maxItems&&o.push({path:a,message:`Too many items (max: ${i.maxItems})`,received:`length ${e.length}`}),`items`in i))for(let n=0;n<e.length;n++)t(e[n],i.items,`${a}[${n}]`,o);if(e&&typeof e==`object`&&!Array.isArray(e)){let n=e;if(`required`in i)for(let e of i.required)e in n||o.push({path:`${a}.${e}`,message:`Required property missing`});if(`properties`in i){let e=i.properties;for(let[r,i]of Object.entries(e))r in n&&t(n[r],i,`${a}.${r}`,o)}if(`additionalProperties`in i&&i.additionalProperties===!1){let e=Object.keys(i.properties??{});for(let t of Object.keys(n))e.includes(t)||o.push({path:`${a}.${t}`,message:`Additional property not allowed`})}}}function n(e,t){switch(t){case`string`:return typeof e==`string`;case`number`:return typeof e==`number`&&!Number.isNaN(e);case`integer`:return typeof e==`number`&&Number.isInteger(e);case`boolean`:return typeof e==`boolean`;case`null`:return e===null;case`array`:return Array.isArray(e);case`object`:return typeof e==`object`&&!!e&&!Array.isArray(e);default:return!0}}function r(e){return e===null?`null`:Array.isArray(e)?`array`:typeof e}export{e as schemaValidate};
+//# sourceMappingURL=schema-validate.js.map

package/packages/tools/dist/scope-map.d.ts

@@ -1,54 +1,52 @@
-/**
- * kb_scope_map — Task-scoped reading plan generator.
- *
- * Given a task description, searches the KB to identify which files
- * and sections are relevant, then produces a prioritized reading plan
- * with estimated token counts.
- */
-import type { IEmbedder } from '@kb/embeddings';
-import type { IKnowledgeStore } from '@kb/store';
-export interface ScopeMapOptions {
-    /** Description of the task to scope */
-    task: string;
-    /** Maximum number of files to include (default: 15) */
-    maxFiles?: number;
-    /** Group results by directory (default: true) */
-    groupByDirectory?: boolean;
-    /** Filter by content type */
-    contentType?: string;
-    /** Filter by origin */
-    origin?: string;
+import { IEmbedder } from "@kb/embeddings";
+import { IKnowledgeStore } from "@kb/store";
+import { ContentType, KnowledgeOrigin } from "@kb/core";
+
+//#region packages/tools/src/scope-map.d.ts
+interface ScopeMapOptions {
+  /** Description of the task to scope */
+  task: string;
+  /** Maximum number of files to include (default: 15) */
+  maxFiles?: number;
+  /** Group results by directory (default: true) */
+  groupByDirectory?: boolean;
+  /** Filter by content type */
+  contentType?: ContentType;
+  /** Filter by origin */
+  origin?: KnowledgeOrigin;
 }
-export interface ScopeMapEntry {
-    /** File path */
-    path: string;
-    /** Why this file is relevant (derived from matched chunks) */
-    reason: string;
-    /** Estimated token count (chars / 4 approximation) */
-    estimatedTokens: number;
-    /** Relevance score (0-1) */
-    relevance: number;
-    /** Line ranges to focus on */
-    focusRanges: Array<{
-        start: number;
-        end: number;
-        heading?: string;
-    }>;
+interface ScopeMapEntry {
+  /** File path */
+  path: string;
+  /** Why this file is relevant (derived from matched chunks) */
+  reason: string;
+  /** Estimated token count (chars / 4 approximation) */
+  estimatedTokens: number;
+  /** Relevance score (0-1) */
+  relevance: number;
+  /** Line ranges to focus on */
+  focusRanges: Array<{
+    start: number;
+    end: number;
+    heading?: string;
+  }>;
 }
-export interface ScopeMapResult {
-    /** The task that was analyzed */
-    task: string;
-    /** Prioritized file list */
-    files: ScopeMapEntry[];
-    /** Total estimated tokens across all files */
-    totalEstimatedTokens: number;
-    /** Suggested reading order (file paths) */
-    readingOrder: string[];
-    /** Suggested compact/file_summary commands to reduce context */
-    compactCommands: string[];
+interface ScopeMapResult {
+  /** The task that was analyzed */
+  task: string;
+  /** Prioritized file list */
+  files: ScopeMapEntry[];
+  /** Total estimated tokens across all files */
+  totalEstimatedTokens: number;
+  /** Suggested reading order (file paths) */
+  readingOrder: string[];
+  /** Suggested compact/file_summary commands to reduce context */
+  compactCommands: string[];
 }
 /**
  * Generate a task-scoped reading plan.
  */
-export declare function scopeMap(embedder: IEmbedder, store: IKnowledgeStore, options: ScopeMapOptions): Promise<ScopeMapResult>;
+declare function scopeMap(embedder: IEmbedder, store: IKnowledgeStore, options: ScopeMapOptions): Promise<ScopeMapResult>;
+//#endregion
+export { ScopeMapEntry, ScopeMapOptions, ScopeMapResult, scopeMap };
 //# sourceMappingURL=scope-map.d.ts.map

package/packages/tools/dist/scope-map.js

@@ -1 +1,2 @@
-function C(c){return Math.ceil(c.length/4)}async function E(c,u,l){const{task:i,maxFiles:h=15,contentType:g,origin:f}=l,k=await c.embed(i),S={limit:h*3,contentType:g,origin:f},y=await u.search(k,S),o=new Map;for(const e of y){const t=e.record.sourcePath,n=o.get(t);n?(n.chunks.push(e),n.totalChars+=e.record.content.length,n.maxScore=Math.max(n.maxScore,e.score)):o.set(t,{chunks:[e],totalChars:e.record.content.length,maxScore:e.score})}const s=[...o.entries()].sort(([,e],[,t])=>t.maxScore-e.maxScore).slice(0,h).map(([e,{chunks:t,maxScore:n}])=>{const a=t.sort((r,m)=>r.record.startLine-m.record.startLine).map(r=>({start:r.record.startLine,end:r.record.endLine,heading:r.record.headingPath})),d=t.sort((r,m)=>m.score-r.score)[0],T=d.record.headingPath?`Matches: ${d.record.headingPath}`:`Contains relevant ${d.record.contentType} content`;return{path:e,reason:T,estimatedTokens:0,relevance:n,focusRanges:a}});for(const e of s){const t=o.get(e.path);t&&(e.estimatedTokens=C(t.chunks.map(n=>n.record.content).join("")))}const x=s.reduce((e,t)=>e+t.estimatedTokens,0),b=[...s].sort((e,t)=>{const n=e.path.includes("config")||e.path.includes("types")?-1:0,a=t.path.includes("config")||t.path.includes("types")?-1:0;return n!==a?n-a:t.relevance-e.relevance}).map(e=>e.path),M=100,p=[];for(const e of s)e.estimatedTokens<=M?p.push(`kb_file_summary({ path: "${e.path}" })  \u2192 ~${e.estimatedTokens} tokens`):p.push(`kb_compact({ path: "${e.path}", query: "${i}" })  \u2192 ~${Math.ceil(e.estimatedTokens/5)} tokens`);return{task:i,files:s,totalEstimatedTokens:x,readingOrder:b,compactCommands:p}}export{E as scopeMap};
+function e(e){return Math.ceil(e.length/4)}async function t(t,n,r){let{task:i,maxFiles:a=15,contentType:o,origin:s}=r,c=await t.embed(i),l={limit:a*3,contentType:o,origin:s},u=await n.search(c,l),d=new Map;for(let e of u){let t=e.record.sourcePath,n=d.get(t);n?(n.chunks.push(e),n.totalChars+=e.record.content.length,n.maxScore=Math.max(n.maxScore,e.score)):d.set(t,{chunks:[e],totalChars:e.record.content.length,maxScore:e.score})}let f=[...d.entries()].sort(([,e],[,t])=>t.maxScore-e.maxScore).slice(0,a).map(([e,{chunks:t,maxScore:n}])=>{let r=t.sort((e,t)=>e.record.startLine-t.record.startLine).map(e=>({start:e.record.startLine,end:e.record.endLine,heading:e.record.headingPath})),i=t.sort((e,t)=>t.score-e.score)[0];return{path:e,reason:i.record.headingPath?`Matches: ${i.record.headingPath}`:`Contains relevant ${i.record.contentType} content`,estimatedTokens:0,relevance:n,focusRanges:r}});for(let t of f){let n=d.get(t.path);n&&(t.estimatedTokens=e(n.chunks.map(e=>e.record.content).join(``)))}let p=f.reduce((e,t)=>e+t.estimatedTokens,0),m=[...f].sort((e,t)=>{let n=e.path.includes(`config`)||e.path.includes(`types`)?-1:0,r=t.path.includes(`config`)||t.path.includes(`types`)?-1:0;return n===r?t.relevance-e.relevance:n-r}).map(e=>e.path),h=[];for(let e of f)e.estimatedTokens<=100?h.push(`kb_file_summary({ path: "${e.path}" })  → ~${e.estimatedTokens} tokens`):h.push(`kb_compact({ path: "${e.path}", query: "${i}" })  → ~${Math.ceil(e.estimatedTokens/5)} tokens`);return{task:i,files:f,totalEstimatedTokens:p,readingOrder:m,compactCommands:h}}export{t as scopeMap};
+//# sourceMappingURL=scope-map.js.map

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

@@ -1,34 +1,36 @@
+//#region packages/tools/src/snippet.d.ts
 /**
  * kb_snippet — Persistent code template storage with search.
  */
-export interface Snippet {
-    name: string;
-    language: string;
-    code: string;
-    tags: string[];
-    created: string;
-    updated: string;
+interface Snippet {
+  name: string;
+  language: string;
+  code: string;
+  tags: string[];
+  created: string;
+  updated: string;
 }
-export type SnippetAction = 'save' | 'get' | 'list' | 'search' | 'delete';
-export interface SnippetOptions {
-    action: SnippetAction;
-    name?: string;
-    language?: string;
-    code?: string;
-    tags?: string[];
-    query?: string;
+type SnippetAction = 'save' | 'get' | 'list' | 'search' | 'delete';
+interface SnippetOptions {
+  action: SnippetAction;
+  name?: string;
+  language?: string;
+  code?: string;
+  tags?: string[];
+  query?: string;
 }
-export type SnippetResult = Snippet | {
-    snippets: SnippetSummary[];
+type SnippetResult = Snippet | {
+  snippets: SnippetSummary[];
 } | {
-    deleted: boolean;
+  deleted: boolean;
 };
 interface SnippetSummary {
-    name: string;
-    language: string;
-    tags: string[];
-    updated: string;
+  name: string;
+  language: string;
+  tags: string[];
+  updated: string;
 }
-export declare function snippet(options: SnippetOptions): SnippetResult;
-export {};
+declare function snippet(options: SnippetOptions): SnippetResult;
+//#endregion
+export { Snippet, SnippetAction, SnippetOptions, SnippetResult, snippet };
 //# sourceMappingURL=snippet.d.ts.map

package/packages/tools/dist/snippet.js

@@ -1 +1,2 @@
-import{existsSync as p,mkdirSync as f,readdirSync as l,readFileSync as u,unlinkSync as m,writeFileSync as S}from"node:fs";import{join as a}from"node:path";const o=()=>a(process.cwd(),".kb-state","snippets");function d(){const e=o();return p(e)||f(e,{recursive:!0}),e}function g(e){const n=e.replace(/[^a-zA-Z0-9_-]/g,"_");if(!n)throw new Error("Invalid snippet name");return n}function h(e){switch(e.action){case"save":{if(!e.name||!e.code)throw new Error("name and code required for save");const n=d(),s=g(e.name),i=a(n,`${s}.json`),r=p(i)?JSON.parse(u(i,"utf8")):null,t=new Date().toISOString(),c={name:e.name,language:e.language??"text",code:e.code,tags:e.tags??[],created:r?.created??t,updated:t};return S(i,JSON.stringify(c,null,2)),c}case"get":{if(!e.name)throw new Error("name required for get");const n=a(o(),`${g(e.name)}.json`);if(!p(n))throw new Error(`Snippet not found: ${e.name}`);return JSON.parse(u(n,"utf8"))}case"list":{const n=d();return{snippets:l(n).filter(r=>r.endsWith(".json")).map(r=>{const t=JSON.parse(u(a(n,r),"utf8"));return{name:t.name,language:t.language,tags:t.tags,updated:t.updated}})}}case"search":{if(!e.query)throw new Error("query required for search");const n=e.query.toLowerCase(),s=d();return{snippets:l(s).filter(t=>t.endsWith(".json")).map(t=>JSON.parse(u(a(s,t),"utf8"))).filter(t=>t.name.toLowerCase().includes(n)||t.tags.some(c=>c.toLowerCase().includes(n))||t.language.toLowerCase().includes(n)||t.code.toLowerCase().includes(n)).map(t=>({name:t.name,language:t.language,tags:t.tags,updated:t.updated}))}}case"delete":{if(!e.name)throw new Error("name required for delete");const n=a(o(),`${g(e.name)}.json`);return p(n)?(m(n),{deleted:!0}):{deleted:!1}}default:throw new Error(`Unknown action: ${e.action}`)}}export{h as snippet};
+import{join as e}from"node:path";import{existsSync as t,mkdirSync as n,readFileSync as r,readdirSync as i,unlinkSync as a,writeFileSync as o}from"node:fs";const s=()=>e(process.cwd(),`.kb-state`,`snippets`);function c(){let e=s();return t(e)||n(e,{recursive:!0}),e}function l(e){let t=e.replace(/[^a-zA-Z0-9_-]/g,`_`);if(!t)throw Error(`Invalid snippet name`);return t}function u(n){switch(n.action){case`save`:{if(!n.name||!n.code)throw Error(`name and code required for save`);let i=e(c(),`${l(n.name)}.json`),a=null;if(t(i))try{a=JSON.parse(r(i,`utf8`))}catch{a=null}let s=new Date().toISOString(),u={name:n.name,language:n.language??`text`,code:n.code,tags:n.tags??[],created:a?.created??s,updated:s};return o(i,JSON.stringify(u,null,2)),u}case`get`:{if(!n.name)throw Error(`name required for get`);let i=e(s(),`${l(n.name)}.json`);if(!t(i))throw Error(`Snippet not found: ${n.name}`);try{return JSON.parse(r(i,`utf8`))}catch{throw Error(`Snippet corrupted: ${n.name}`)}}case`list`:{let t=c();return{snippets:i(t).filter(e=>e.endsWith(`.json`)).flatMap(n=>{try{let i=JSON.parse(r(e(t,n),`utf8`));return[{name:i.name,language:i.language,tags:i.tags,updated:i.updated}]}catch{return[]}})}}case`search`:{if(!n.query)throw Error(`query required for search`);let t=n.query.toLowerCase(),a=c();return{snippets:i(a).filter(e=>e.endsWith(`.json`)).flatMap(t=>{try{return[JSON.parse(r(e(a,t),`utf8`))]}catch{return[]}}).filter(e=>e.name.toLowerCase().includes(t)||e.tags.some(e=>e.toLowerCase().includes(t))||e.language.toLowerCase().includes(t)||e.code.toLowerCase().includes(t)).map(e=>({name:e.name,language:e.language,tags:e.tags,updated:e.updated}))}}case`delete`:{if(!n.name)throw Error(`name required for delete`);let r=e(s(),`${l(n.name)}.json`);return t(r)?(a(r),{deleted:!0}):{deleted:!1}}default:throw Error(`Unknown action: ${n.action}`)}}export{u as snippet};
+//# sourceMappingURL=snippet.js.map

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

@@ -1,12 +1,15 @@
-export interface StashEntry {
-    key: string;
-    value: unknown;
-    type: string;
-    storedAt: string;
+//#region packages/tools/src/stash.d.ts
+interface StashEntry {
+  key: string;
+  value: unknown;
+  type: string;
+  storedAt: string;
 }
-export declare function stashSet(key: string, value: unknown, cwd?: string): StashEntry;
-export declare function stashGet(key: string, cwd?: string): StashEntry | undefined;
-export declare function stashList(cwd?: string): StashEntry[];
-export declare function stashDelete(key: string, cwd?: string): boolean;
-export declare function stashClear(cwd?: string): number;
+declare function stashSet(key: string, value: unknown, cwd?: string): StashEntry;
+declare function stashGet(key: string, cwd?: string): StashEntry | undefined;
+declare function stashList(cwd?: string): StashEntry[];
+declare function stashDelete(key: string, cwd?: string): boolean;
+declare function stashClear(cwd?: string): number;
+//#endregion
+export { StashEntry, stashClear, stashDelete, stashGet, stashList, stashSet };
 //# sourceMappingURL=stash.d.ts.map

package/packages/tools/dist/stash.js

@@ -1,2 +1,2 @@
-import{existsSync as a,mkdirSync as u,readFileSync as h,writeFileSync as S}from"node:fs";import{dirname as g,resolve as f}from"node:path";const y=".kb-state",p="stash.json";function c(t){const n=t??process.cwd();return f(n,y,p)}function e(t){const n=c(t);if(!a(n))return{};const r=h(n,"utf-8");return JSON.parse(r)}function o(t,n){const r=c(n),s=g(r);a(s)||u(s,{recursive:!0}),S(r,`${JSON.stringify(t,null,2)}
-`,"utf-8")}function E(t,n,r){const s=e(r),i={key:t,value:n,type:typeof n,storedAt:new Date().toISOString()};return s[t]=i,o(s,r),i}function m(t,n){return e(n)[t]}function x(t){return Object.values(e(t))}function b(t,n){const r=e(n);return t in r?(delete r[t],o(r,n),!0):!1}function v(t){const n=e(t),r=Object.keys(n).length;return o({},t),r}export{v as stashClear,b as stashDelete,m as stashGet,x as stashList,E as stashSet};
+import{dirname as e,resolve as t}from"node:path";import{existsSync as n,mkdirSync as r,readFileSync as i,writeFileSync as a}from"node:fs";function o(e){return t(e??process.cwd(),`.kb-state`,`stash.json`)}function s(e){let t=o(e);if(!n(t))return{};try{let e=i(t,`utf-8`);return JSON.parse(e)}catch{return{}}}function c(t,i){let s=o(i),c=e(s);n(c)||r(c,{recursive:!0}),a(s,`${JSON.stringify(t,null,2)}\n`,`utf-8`)}function l(e,t,n){let r=s(n),i={key:e,value:t,type:typeof t,storedAt:new Date().toISOString()};return r[e]=i,c(r,n),i}function u(e,t){return s(t)[e]}function d(e){return Object.values(s(e))}function f(e,t){let n=s(t);return e in n?(delete n[e],c(n,t),!0):!1}function p(e){let t=s(e),n=Object.keys(t).length;return c({},e),n}export{p as stashClear,f as stashDelete,u as stashGet,d as stashList,l as stashSet};
+//# sourceMappingURL=stash.js.map

package/packages/tools/dist/stratum-card.d.ts

@@ -1,31 +1,31 @@
-/**
- * kb_stratum_card — STRATUM T1/T2 context card generator.
- *
- * Generates compact context cards from files. T1 = structural metadata only
- * (~100 tokens/file). T2 = T1 + compressed content (~300 tokens/file).
- * Uses file-summary for structure and embedder for T2 content scoring.
- */
-import type { IEmbedder } from '@kb/embeddings';
-export interface StratumCardOptions {
-    files: string[];
-    query: string;
-    tier?: 'T1' | 'T2';
-    maxContentChars?: number;
+import { FileCache } from "./file-cache.js";
+import { IEmbedder } from "@kb/embeddings";
+
+//#region packages/tools/src/stratum-card.d.ts
+interface StratumCardOptions {
+  files: string[];
+  query: string;
+  tier?: 'T1' | 'T2';
+  maxContentChars?: number;
+  /** Optional file cache — avoids redundant reads and eliminates double-read with fileSummary */
+  cache?: FileCache;
 }
-export interface StratumCard {
-    path: string;
-    tier: 'T1' | 'T2';
-    card: string;
-    unknowns: string[];
-    riskTier: 'low' | 'medium' | 'high';
-    tokenEstimate: number;
-    originalTokenEstimate: number;
+interface StratumCard {
+  path: string;
+  tier: 'T1' | 'T2';
+  card: string;
+  unknowns: string[];
+  riskTier: 'low' | 'medium' | 'high';
+  tokenEstimate: number;
+  originalTokenEstimate: number;
 }
-export interface StratumCardResult {
-    cards: StratumCard[];
-    totalTokenEstimate: number;
-    totalOriginalTokenEstimate: number;
-    compressionRatio: number;
+interface StratumCardResult {
+  cards: StratumCard[];
+  totalTokenEstimate: number;
+  totalOriginalTokenEstimate: number;
+  compressionRatio: number;
 }
-export declare function stratumCard(embedder: IEmbedder, options: StratumCardOptions): Promise<StratumCardResult>;
+declare function stratumCard(embedder: IEmbedder, options: StratumCardOptions): Promise<StratumCardResult>;
+//#endregion
+export { StratumCard, StratumCardOptions, StratumCardResult, stratumCard };
 //# sourceMappingURL=stratum-card.d.ts.map

package/packages/tools/dist/stratum-card.js

@@ -1,6 +1,5 @@
-import{readFile as F}from"node:fs/promises";import{basename as h,extname as I,relative as A}from"node:path";import{fileSummary as j}from"./file-summary.js";import{cosineSimilarity as X,estimateTokens as y,segment as D}from"./text-utils.js";const M=800,S=3;async function B(t,e){const{files:r,query:o,tier:n="T1",maxContentChars:m=M}=e,u=n==="T2"?await t.embedQuery(o):null,l=await Promise.all(r.map(async i=>{try{const c=await F(i,"utf-8"),p=y(c);if(c.includes("\0"))return C(i,n,"binary","binary file",p);if(c.trim().length===0){const g=x({displayPath:T(i),tier:n,role:"empty",deps:[],exports:[],unknowns:[],riskTier:"low"});return{path:i,tier:n,card:g,unknowns:[],riskTier:"low",tokenEstimate:y(g),originalTokenEstimate:p}}const d=await j({path:i}),N=U(i,d),E=W(c,d),w=_(i,d),O=$(d),R=[...new Set(d.exports)].slice(0,5);let f=x({displayPath:T(i),tier:n,role:N,deps:O,exports:R,unknowns:E,riskTier:w});if(n==="T2"&&u){const g=await v(t,u,c,m);g.length>0&&(f=`${f}
-CONTEXT:
-${g}`)}return{path:i,tier:n,card:f,unknowns:E,riskTier:w,tokenEstimate:y(f),originalTokenEstimate:p}}catch(c){const p=c.code==="ENOENT"?"file missing":"unreadable file",d=c.code==="ENOENT"?"missing":"unreadable";return C(i,n,d,p,0)}})),s=l.reduce((i,c)=>i+c.tokenEstimate,0),a=l.reduce((i,c)=>i+c.originalTokenEstimate,0);return{cards:l,totalTokenEstimate:s,totalOriginalTokenEstimate:a,compressionRatio:a===0?0:s/a}}function C(t,e,r,o,n){const m=x({displayPath:T(t),tier:e,role:r,deps:[],exports:[],unknowns:[o],riskTier:"low"});return{path:t,tier:e,card:m,unknowns:[o],riskTier:"low",tokenEstimate:y(m),originalTokenEstimate:n}}function x(t){const{displayPath:e,tier:r,role:o,deps:n,exports:m,unknowns:u,riskTier:l}=t;return[`[${r}: ${e}]`,`ROLE: ${o}`,`DEPS: ${k(n)}`,`EXPORTS: ${k(m)}`,`UNKNOWNS: ${k(u,"; ")}`,`RISK: ${l}`].join(`
-`)}function T(t){const e=A(process.cwd(),t).replace(/\\/g,"/");return!e||e.startsWith("..")?h(t):e}function k(t,e=", "){return t.length>0?t.join(e):"none"}function U(t,e){const r=h(t),o=I(r).toLowerCase();return[".json",".yaml",".yml",".env"].includes(o)||/config|settings/i.test(r)?"configuration":/types?\.ts$|\.d\.ts$/i.test(r)?"type-definitions":/schema/i.test(r)?"schema":/test|spec/i.test(r)?"test":/index\.[jt]sx?$/i.test(r)?"barrel-export":/handler|controller|route/i.test(r)?"entry-point":/model|entity/i.test(r)?"data-model":/util|helper/i.test(r)?"utility":/service|provider/i.test(r)?"service":e.classes.length>0?"class-module":e.interfaces.length>2?"type-definitions":"implementation"}function W(t,e){const r=[],o=new Set;for(const n of t.matchAll(/\/\/\s*(TODO|FIXME|HACK|XXX)\s*:?\s*(.+)?$/gm)){const m=`${n[1]}: ${(n[2]??"").trim()}`.trim();b(r,o,m.replace(/:\s*$/,""))}K(t)&&b(r,o,"exported any usage");for(const n of $(e))b(r,o,`cross-package import: ${n}`);return r.slice(0,S)}function b(t,e,r){t.length>=S||!r||e.has(r)||(e.add(r),t.push(r))}function K(t){return[/export\s+(?:async\s+)?function\s+\w+[^\n{;]*\bany\b/g,/export\s+interface\s+\w+[\s\S]*?\{[\s\S]*?\bany\b[\s\S]*?\}/g,/export\s+type\s+\w+\s*=.*\bany\b/g,/export\s+const\s+\w+[^\n=]*\bany\b/g].some(r=>r.test(t))}function _(t,e){return/auth|token|permission|secret|credential|encrypt/i.test(t)?"high":/types?\.ts$|schema|contract|\.d\.ts$/i.test(h(t))||e.exports.length>10?"medium":"low"}function $(t){return t.imports.map(q).filter(e=>!!e).filter(e=>!e.startsWith("./")&&!e.startsWith("../")).slice(0,3)}function q(t){const e=t.match(/from\s+['"]([^'"]+)['"]/);if(e)return e[1];const r=t.match(/^import\s+['"]([^'"]+)['"]/);return r?r[1]:null}async function v(t,e,r,o){if(o<=0)return"";const n=D(r,"paragraph");if(n.length===0)return"";const m=await Promise.all(n.map(async(s,a)=>{const i=await t.embed(s);return{index:a,text:s,score:X(e,i)}})),u=[];let l=0;for(const s of m.sort((a,i)=>i.score-a.score)){const a=o-l;if(a<=0)break;if(s.text.length<=a){u.push({index:s.index,text:s.text}),l+=s.text.length;continue}u.length===0&&(u.push({index:s.index,text:s.text.slice(0,a).trimEnd()}),l=o);break}return u.sort((s,a)=>s.index-a.index).map(s=>s.text).filter(s=>s.length>0).join(`
+import{cosineSimilarity as e,estimateTokens as t,segment as n}from"./text-utils.js";import{fileSummary as r}from"./file-summary.js";import{readFile as i}from"node:fs/promises";import{basename as a,extname as o,relative as s}from"node:path";async function c(e,n){let{files:a,query:o,tier:s=`T1`,maxContentChars:c=800}=n,{cache:f}=n,h=s===`T2`?await e.embedQuery(o):null,g=await Promise.all(a.map(async n=>{try{let a=f?(await f.get(n)).content:await i(n,`utf-8`),o=t(a);if(a.includes(`\0`))return l(n,s,`binary`,`binary file`,o);if(a.trim().length===0){let e=u({displayPath:d(n),tier:s,role:`empty`,deps:[],exports:[],unknowns:[],riskTier:`low`});return{path:n,tier:s,card:e,unknowns:[],riskTier:`low`,tokenEstimate:t(e),originalTokenEstimate:o}}let g=await r({path:n,content:a}),y=p(n,g),x=m(a,g),S=_(n,g),C=v(g),w=[...new Set(g.exports)].slice(0,5),T=u({displayPath:d(n),tier:s,role:y,deps:C,exports:w,unknowns:x,riskTier:S});if(s===`T2`&&h){let t=await b(e,h,a,c);t.length>0&&(T=`${T}\nCONTEXT:\n${t}`)}return{path:n,tier:s,card:T,unknowns:x,riskTier:S,tokenEstimate:t(T),originalTokenEstimate:o}}catch(e){let t=e.code===`ENOENT`?`file missing`:`unreadable file`;return l(n,s,e.code===`ENOENT`?`missing`:`unreadable`,t,0)}})),y=g.reduce((e,t)=>e+t.tokenEstimate,0),x=g.reduce((e,t)=>e+t.originalTokenEstimate,0);return{cards:g,totalTokenEstimate:y,totalOriginalTokenEstimate:x,compressionRatio:x===0?0:y/x}}function l(e,n,r,i,a){let o=u({displayPath:d(e),tier:n,role:r,deps:[],exports:[],unknowns:[i],riskTier:`low`});return{path:e,tier:n,card:o,unknowns:[i],riskTier:`low`,tokenEstimate:t(o),originalTokenEstimate:a}}function u(e){let{displayPath:t,tier:n,role:r,deps:i,exports:a,unknowns:o,riskTier:s}=e;return[`[${n}: ${t}]`,`ROLE: ${r}`,`DEPS: ${f(i)}`,`EXPORTS: ${f(a)}`,`UNKNOWNS: ${f(o,`; `)}`,`RISK: ${s}`].join(`
+`)}function d(e){let t=s(process.cwd(),e).replace(/\\/g,`/`);return!t||t.startsWith(`..`)?a(e):t}function f(e,t=`, `){return e.length>0?e.join(t):`none`}function p(e,t){let n=a(e),r=o(n).toLowerCase();return[`.json`,`.yaml`,`.yml`,`.env`].includes(r)||/config|settings/i.test(n)?`configuration`:/types?\.ts$|\.d\.ts$/i.test(n)?`type-definitions`:/schema/i.test(n)?`schema`:/test|spec/i.test(n)?`test`:/index\.[jt]sx?$/i.test(n)?`barrel-export`:/handler|controller|route/i.test(n)?`entry-point`:/model|entity/i.test(n)?`data-model`:/util|helper/i.test(n)?`utility`:/service|provider/i.test(n)?`service`:t.classes.length>0?`class-module`:t.interfaces.length>2?`type-definitions`:`implementation`}function m(e,t){let n=[],r=new Set;for(let t of e.matchAll(/\/\/\s*(TODO|FIXME|HACK|XXX)\s*:?\s*(.+)?$/gm))h(n,r,`${t[1]}: ${(t[2]??``).trim()}`.trim().replace(/:\s*$/,``));g(e)&&h(n,r,`exported any usage`);for(let e of v(t))h(n,r,`cross-package import: ${e}`);return n.slice(0,3)}function h(e,t,n){e.length>=3||!n||t.has(n)||(t.add(n),e.push(n))}function g(e){return[/export\s+(?:async\s+)?function\s+\w+[^\n{;]*\bany\b/g,/export\s+interface\s+\w+[\s\S]*?\{[\s\S]*?\bany\b[\s\S]*?\}/g,/export\s+type\s+\w+\s*=.*\bany\b/g,/export\s+const\s+\w+[^\n=]*\bany\b/g].some(t=>t.test(e))}function _(e,t){return/auth|token|permission|secret|credential|encrypt/i.test(e)?`high`:/types?\.ts$|schema|contract|\.d\.ts$/i.test(a(e))||t.exports.length>10?`medium`:`low`}function v(e){return e.imports.map(y).filter(e=>!!e).filter(e=>!e.startsWith(`./`)&&!e.startsWith(`../`)).slice(0,3)}function y(e){let t=e.match(/from\s+['"]([^'"]+)['"]/);if(t)return t[1];let n=e.match(/^import\s+['"]([^'"]+)['"]/);return n?n[1]:null}async function b(t,r,i,a){if(a<=0)return``;let o=n(i,`paragraph`);if(o.length===0)return``;let s=await Promise.all(o.map(async(n,i)=>({index:i,text:n,score:e(r,await t.embed(n))}))),c=[],l=0;for(let e of s.sort((e,t)=>t.score-e.score)){let t=a-l;if(t<=0)break;if(e.text.length<=t){c.push({index:e.index,text:e.text}),l+=e.text.length;continue}c.length===0&&(c.push({index:e.index,text:e.text.slice(0,t).trimEnd()}),l=a);break}return c.sort((e,t)=>e.index-t.index).map(e=>e.text).filter(e=>e.length>0).join(`
 
-`)}export{B as stratumCard};
+`)}export{c as stratumCard};
+//# sourceMappingURL=stratum-card.js.map

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

@@ -1,28 +1,32 @@
-import type { IEmbedder } from '@kb/embeddings';
-import type { IKnowledgeStore } from '@kb/store';
-export interface SymbolInfo {
-    name: string;
-    definedIn?: {
-        path: string;
-        line: number;
-        kind: string;
-    };
-    importedBy: Array<{
-        path: string;
-        line: number;
-        importStatement: string;
-    }>;
-    referencedIn: Array<{
-        path: string;
-        line: number;
-        context: string;
-    }>;
+import { IEmbedder } from "@kb/embeddings";
+import { IKnowledgeStore } from "@kb/store";
+
+//#region packages/tools/src/symbol.d.ts
+interface SymbolInfo {
+  name: string;
+  definedIn?: {
+    path: string;
+    line: number;
+    kind: string;
+  };
+  importedBy: Array<{
+    path: string;
+    line: number;
+    importStatement: string;
+  }>;
+  referencedIn: Array<{
+    path: string;
+    line: number;
+    context: string;
+  }>;
 }
-export interface SymbolOptions {
-    /** Symbol name to look up */
-    name: string;
-    /** Limit results */
-    limit?: number;
+interface SymbolOptions {
+  /** Symbol name to look up */
+  name: string;
+  /** Limit results */
+  limit?: number;
 }
-export declare function symbol(embedder: IEmbedder, store: IKnowledgeStore, options: SymbolOptions): Promise<SymbolInfo>;
+declare function symbol(embedder: IEmbedder, store: IKnowledgeStore, options: SymbolOptions): Promise<SymbolInfo>;
+//#endregion
+export { SymbolInfo, SymbolOptions, symbol };
 //# sourceMappingURL=symbol.d.ts.map

package/packages/tools/dist/symbol.js

@@ -1,3 +1,4 @@
-function l(i){return i.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}async function P(i,d,h){const{name:t,limit:s=20}=h,m=i.embedQuery?.bind(i)??i.embed.bind(i),g=[`export function ${t}`,`export class ${t}`,`export const ${t}`,`export interface ${t}`,`export type ${t}`,`export enum ${t}`].join(" | "),x=await d.search(await m(g),{limit:s*2}),I=new RegExp(`^export\\s+(?:default\\s+)?(?:async\\s+)?(?:function|class|const|let|interface|type|enum)\\s+${l(t)}\\b`,"m");let a;for(const e of x){if(!I.test(e.record.content))continue;const r=e.record.content.match(/export\s+(?:default\s+)?(?:async\s+)?(\w+)/)?.[1]??"unknown";a={path:e.record.sourcePath,line:e.record.startLine,kind:r};break}const p=new RegExp(`import\\s+.*\\b${l(t)}\\b.*from\\s+`,"m"),$=await d.search(await m(`import ${t} from`),{limit:s*3}),f=[],u=new Set;for(const e of $){const r=e.record.content.split(`
-`);for(let n=0;n<r.length;n++){const o=r[n];if(!p.test(o))continue;const c=`${e.record.sourcePath}:${o.trim()}`;u.has(c)||(u.add(c),f.push({path:e.record.sourcePath,line:e.record.startLine+n,importStatement:o.trim()}))}}const w=new RegExp(`\\b${l(t)}\\b`),S=await d.search(await m(t),{limit:s*3}),y=[],b=new Set;for(const e of S){if(a&&e.record.sourcePath===a.path)continue;const r=e.record.content.split(`
-`);for(let n=0;n<r.length;n++){const o=r[n];if(!w.test(o)||p.test(o))continue;const c=`${e.record.sourcePath}:${e.record.startLine+n}`;if(!b.has(c)){b.add(c),y.push({path:e.record.sourcePath,line:e.record.startLine+n,context:o.trim().slice(0,120)});break}}}return{name:t,definedIn:a,importedBy:f.slice(0,s),referencedIn:y.slice(0,s)}}export{P as symbol};
+function e(e){return e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)}async function t(t,n,r){let{name:i,limit:a=20}=r,o=t.embedQuery?.bind(t)??t.embed.bind(t),s=[`export function ${i}`,`export class ${i}`,`export const ${i}`,`export interface ${i}`,`export type ${i}`,`export enum ${i}`].join(` | `),c=await n.search(await o(s),{limit:a*2}),l=RegExp(`^export\\s+(?:default\\s+)?(?:async\\s+)?(?:function|class|const|let|interface|type|enum)\\s+${e(i)}\\b`,`m`),u;for(let e of c){if(!l.test(e.record.content))continue;let t=e.record.content.match(/export\s+(?:default\s+)?(?:async\s+)?(\w+)/)?.[1]??`unknown`;u={path:e.record.sourcePath,line:e.record.startLine,kind:t};break}let d=RegExp(`import\\s+.*\\b${e(i)}\\b.*from\\s+`,`m`),f=await n.search(await o(`import ${i} from`),{limit:a*3}),p=[],m=new Set;for(let e of f){let t=e.record.content.split(`
+`);for(let n=0;n<t.length;n++){let r=t[n];if(!d.test(r))continue;let i=`${e.record.sourcePath}:${r.trim()}`;m.has(i)||(m.add(i),p.push({path:e.record.sourcePath,line:e.record.startLine+n,importStatement:r.trim()}))}}let h=RegExp(`\\b${e(i)}\\b`),g=await n.search(await o(i),{limit:a*3}),_=[],v=new Set;for(let e of g){if(u&&e.record.sourcePath===u.path)continue;let t=e.record.content.split(`
+`);for(let n=0;n<t.length;n++){let r=t[n];if(!h.test(r)||d.test(r))continue;let i=`${e.record.sourcePath}:${e.record.startLine+n}`;if(!v.has(i)){v.add(i),_.push({path:e.record.sourcePath,line:e.record.startLine+n,context:r.trim().slice(0,120)});break}}}return{name:i,definedIn:u,importedBy:p.slice(0,a),referencedIn:_.slice(0,a)}}export{t as symbol};
+//# sourceMappingURL=symbol.js.map

package/packages/tools/dist/test-run.d.ts

@@ -1,23 +1,27 @@
-import { type ParsedTestSummary } from './parse-output.js';
-export interface TestRunOptions {
-    files?: string[];
-    cwd?: string;
-    timeout?: number;
-    grep?: string;
+import { ParsedTestSummary } from "./parse-output.js";
+
+//#region packages/tools/src/test-run.d.ts
+interface TestRunOptions {
+  files?: string[];
+  cwd?: string;
+  timeout?: number;
+  grep?: string;
 }
-export interface TestRunResult {
-    summary: ParsedTestSummary;
-    passed: boolean;
-    raw: string;
-    durationMs: number;
+interface TestRunResult {
+  summary: ParsedTestSummary;
+  passed: boolean;
+  raw: string;
+  durationMs: number;
 }
-export declare function testRun(options?: TestRunOptions): Promise<TestRunResult>;
+declare function testRun(options?: TestRunOptions): Promise<TestRunResult>;
 /**
  * Classify non-zero exit codes — some tools use exit code 1 for
  * non-error conditions (e.g., grep returns 1 for "no matches").
  */
-export declare function classifyExitCode(exitCode: number, _stdout: string, command?: string): {
-    isError: boolean;
-    reason?: string;
+declare function classifyExitCode(exitCode: number, _stdout: string, command?: string): {
+  isError: boolean;
+  reason?: string;
 };
+//#endregion
+export { TestRunOptions, TestRunResult, classifyExitCode, testRun };
 //# sourceMappingURL=test-run.d.ts.map

package/packages/tools/dist/test-run.js

@@ -1,2 +1,3 @@
-import{execFile as f}from"node:child_process";import{promisify as c}from"node:util";import{parseVitest as u}from"./parse-output.js";const m=c(f);async function w(r={}){const e=r.cwd??process.cwd(),t=r.timeout??6e4,n=Date.now(),i=["vitest","run","--reporter=verbose"];r.files?.length&&i.push(...r.files),r.grep&&i.push("--testNamePattern",r.grep);try{const{stdout:o}=await m("npx",i,{cwd:e,shell:!0,timeout:t}),s=o.toString(),a=u(s);return{summary:a,passed:a.failed===0,raw:s,durationMs:Date.now()-n}}catch(o){const s=g(o);return{summary:u(s),passed:!1,raw:s,durationMs:Date.now()-n}}}function g(r){const e=r,t=e.stdout?.toString()??"",n=e.stderr?.toString()??"";return[t,n].filter(Boolean).join(`
-`).trim()||e.message||"Test run failed"}function y(r,e,t){if(r===0)return{isError:!1};if(r===1&&t){if(/\b(grep|rg|ripgrep|ag|ack|findstr)\b/i.test(t))return{isError:!1,reason:"grep: no matches (exit 1 is normal)"};if(/\bdiff\b/i.test(t))return{isError:!1,reason:"diff: files differ (exit 1 is normal)"}}return{isError:!0}}export{y as classifyExitCode,w as testRun};
+import{parseVitest as e}from"./parse-output.js";import{execFile as t}from"node:child_process";import{promisify as n}from"node:util";const r=n(t);let i=0;async function a(e={}){if(i>=2)throw Error(`Too many concurrent test runs (max 2). Try again later.`);i++;try{return await o(e)}finally{i--}}async function o(t){let n=t.cwd??process.cwd(),i=t.timeout??6e4,a=Date.now(),o=[`vitest`,`run`,`--reporter=verbose`];t.files?.length&&o.push(...t.files),t.grep&&o.push(`--testNamePattern`,t.grep);try{let{stdout:t}=await r(`npx`,o,{cwd:n,shell:!0,timeout:i}),s=t.toString(),c=e(s);return{summary:c,passed:c.failed===0,raw:s,durationMs:Date.now()-a}}catch(t){let n=s(t);return{summary:e(n),passed:!1,raw:n,durationMs:Date.now()-a}}}function s(e){let t=e;return[t.stdout?.toString()??``,t.stderr?.toString()??``].filter(Boolean).join(`
+`).trim()||t.message||`Test run failed`}function c(e,t,n){if(e===0)return{isError:!1};if(e===1&&n){if(/\b(grep|rg|ripgrep|ag|ack|findstr)\b/i.test(n))return{isError:!1,reason:`grep: no matches (exit 1 is normal)`};if(/\bdiff\b/i.test(n))return{isError:!1,reason:`diff: files differ (exit 1 is normal)`}}return{isError:!0}}export{c as classifyExitCode,a as testRun};
+//# sourceMappingURL=test-run.js.map