@vpxa/kb 0.1.13 → 0.1.15

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

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

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

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

package/packages/tools/dist/path-resolver.d.ts

@@ -1,3 +1,4 @@
+//#region packages/tools/src/path-resolver.d.ts
 /**
  * Shared path resolver for MCP tools (E-014).
  * Provides consistent path resolution across all tools.
@@ -8,5 +9,7 @@
  * - Relative paths are resolved against the server's cwd
  * - '.' and empty/undefined default to cwd
  */
-export declare function resolvePath(input?: string): string;
+declare function resolvePath(input?: string): string;
+//#endregion
+export { resolvePath };
 //# sourceMappingURL=path-resolver.d.ts.map

package/packages/tools/dist/path-resolver.js

@@ -1 +1,2 @@
-import{isAbsolute as e,resolve as s}from"node:path";function t(r){return!r||r==="."?process.cwd():e(r)?r:s(process.cwd(),r)}export{t as resolvePath};
+import{isAbsolute as e,resolve as t}from"node:path";function n(n){return!n||n===`.`?process.cwd():e(n)?n:t(process.cwd(),n)}export{n as resolvePath};
+//# sourceMappingURL=path-resolver.js.map

package/packages/tools/dist/process-manager.d.ts

@@ -1,18 +1,21 @@
-export interface ManagedProcess {
-    id: string;
-    command: string;
-    args: string[];
-    pid?: number;
-    status: 'running' | 'stopped' | 'error';
-    startedAt: string;
-    exitCode?: number;
-    logs: string[];
+//#region packages/tools/src/process-manager.d.ts
+interface ManagedProcess {
+  id: string;
+  command: string;
+  args: string[];
+  pid?: number;
+  status: 'running' | 'stopped' | 'error';
+  startedAt: string;
+  exitCode?: number;
+  logs: string[];
 }
-export declare function processStart(id: string, command: string, args?: string[], options?: {
-    cwd?: string;
+declare function processStart(id: string, command: string, args?: string[], options?: {
+  cwd?: string;
 }): ManagedProcess;
-export declare function processStop(id: string): ManagedProcess | undefined;
-export declare function processStatus(id: string): ManagedProcess | undefined;
-export declare function processList(): ManagedProcess[];
-export declare function processLogs(id: string, tail?: number): string[];
+declare function processStop(id: string): ManagedProcess | undefined;
+declare function processStatus(id: string): ManagedProcess | undefined;
+declare function processList(): ManagedProcess[];
+declare function processLogs(id: string, tail?: number): string[];
+//#endregion
+export { ManagedProcess, processList, processLogs, processStart, processStatus, processStop };
 //# sourceMappingURL=process-manager.d.ts.map

package/packages/tools/dist/process-manager.js

@@ -1 +1,2 @@
-import{spawn as d}from"node:child_process";const t=new Map,p=200;function f(s,r,n=[],c){if(t.has(s))throw new Error(`Process "${s}" is already running. Stop it first.`);const o=d(r,n,{cwd:c?.cwd??process.cwd(),shell:!0,stdio:["ignore","pipe","pipe"]}),e={id:s,command:r,args:n,pid:o.pid??void 0,status:"running",startedAt:new Date().toISOString(),logs:[]},g=i=>{const a=i.toString().split(/\r?\n/).filter(Boolean);e.logs.push(...a),e.logs.length>p&&(e.logs=e.logs.slice(-p))};return o.stdout?.on("data",g),o.stderr?.on("data",g),o.on("exit",i=>{e.status=i===0?"stopped":"error",e.exitCode=i??void 0}),o.on("error",i=>{e.status="error",e.logs.push(`[error] ${i.message}`)}),t.set(s,{proc:o,info:e}),e}function l(s){const r=t.get(s);if(r)return r.proc.kill("SIGTERM"),r.info.status="stopped",t.delete(s),r.info}function M(s){return t.get(s)?.info}function P(){return[...t.values()].map(s=>s.info)}function w(s,r){const n=t.get(s);return n?r?n.info.logs.slice(-r):n.info.logs:[]}export{P as processList,w as processLogs,f as processStart,M as processStatus,l as processStop};
+import{spawn as e}from"node:child_process";const t=new Map;function n(n,r,i=[],a){if(t.has(n))throw Error(`Process "${n}" is already running. Stop it first.`);if(t.size>=20)throw Error(`Too many managed processes (max 20). Stop some first.`);let o=/[;|&`$(){}[\]!<>\\]/,s=[r,...i].join(` `);if(o.test(s))throw Error(`Command contains disallowed shell metacharacters`);let c=e(r,i,{cwd:a?.cwd??process.cwd(),shell:!0,stdio:[`ignore`,`pipe`,`pipe`]}),l={id:n,command:r,args:i,pid:c.pid??void 0,status:`running`,startedAt:new Date().toISOString(),logs:[]},u=e=>{let t=e.toString().split(/\r?\n/).filter(Boolean);l.logs.push(...t),l.logs.length>200&&(l.logs=l.logs.slice(-200))};return c.stdout?.on(`data`,u),c.stderr?.on(`data`,u),c.on(`exit`,e=>{l.status=e===0?`stopped`:`error`,l.exitCode=e??void 0,setTimeout(()=>t.delete(n),3e4)}),c.on(`error`,e=>{l.status=`error`,l.logs.push(`[error] ${e.message}`)}),t.set(n,{proc:c,info:l}),l}function r(e){let n=t.get(e);if(!n)return;n.proc.kill(`SIGTERM`);let r=setTimeout(()=>{try{n.proc.kill(`SIGKILL`)}catch{}},5e3);return n.proc.once(`exit`,()=>clearTimeout(r)),n.info.status=`stopped`,t.delete(e),n.info}function i(e){return t.get(e)?.info}function a(){return[...t.values()].map(e=>e.info)}function o(e,n){let r=t.get(e);return r?n?r.info.logs.slice(-n):r.info.logs:[]}export{a as processList,o as processLogs,n as processStart,i as processStatus,r as processStop};
+//# sourceMappingURL=process-manager.js.map

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

@@ -1,38 +1,41 @@
-export interface QueueItem {
-    id: string;
-    title: string;
-    status: 'pending' | 'in-progress' | 'done' | 'failed';
-    data?: unknown;
-    createdAt: string;
-    updatedAt: string;
-    error?: string;
+//#region packages/tools/src/queue.d.ts
+interface QueueItem {
+  id: string;
+  title: string;
+  status: 'pending' | 'in-progress' | 'done' | 'failed';
+  data?: unknown;
+  createdAt: string;
+  updatedAt: string;
+  error?: string;
 }
-export interface QueueState {
-    name: string;
-    items: QueueItem[];
+interface QueueState {
+  name: string;
+  items: QueueItem[];
 }
 /** Create a new named queue. */
-export declare function queueCreate(name: string, cwd?: string): QueueState;
+declare function queueCreate(name: string, cwd?: string): QueueState;
 /** Push an item onto a queue. Creates the queue if it doesn't exist. */
-export declare function queuePush(name: string, title: string, data?: unknown, cwd?: string): QueueItem;
+declare function queuePush(name: string, title: string, data?: unknown, cwd?: string): QueueItem;
 /** Take the next pending item from a queue and mark it in-progress. */
-export declare function queueNext(name: string, cwd?: string): QueueItem | null;
+declare function queueNext(name: string, cwd?: string): QueueItem | null;
 /** Mark a queue item as done. */
-export declare function queueDone(name: string, id: string, cwd?: string): QueueItem;
+declare function queueDone(name: string, id: string, cwd?: string): QueueItem;
 /** Mark a queue item as failed with an error message. */
-export declare function queueFail(name: string, id: string, error: string, cwd?: string): QueueItem;
+declare function queueFail(name: string, id: string, error: string, cwd?: string): QueueItem;
 /** Get the current state of a queue. */
-export declare function queueGet(name: string, cwd?: string): QueueState | null;
+declare function queueGet(name: string, cwd?: string): QueueState | null;
 /** List all queues with their item counts. */
-export declare function queueList(cwd?: string): Array<{
-    name: string;
-    pending: number;
-    done: number;
-    failed: number;
-    total: number;
+declare function queueList(cwd?: string): Array<{
+  name: string;
+  pending: number;
+  done: number;
+  failed: number;
+  total: number;
 }>;
 /** Clear completed items from a queue. */
-export declare function queueClear(name: string, cwd?: string): number;
+declare function queueClear(name: string, cwd?: string): number;
 /** Delete a queue entirely. */
-export declare function queueDelete(name: string, cwd?: string): boolean;
+declare function queueDelete(name: string, cwd?: string): boolean;
+//#endregion
+export { QueueItem, QueueState, queueClear, queueCreate, queueDelete, queueDone, queueFail, queueGet, queueList, queueNext, queuePush };
 //# sourceMappingURL=queue.d.ts.map

package/packages/tools/dist/queue.js

@@ -1,2 +1,2 @@
-import{existsSync as a,mkdirSync as c,readFileSync as l,writeFileSync as p}from"node:fs";import{dirname as m,resolve as q}from"node:path";const Q=".kb-state",S="queue.json";function d(e){return q(e??process.cwd(),Q,S)}function o(e){const r=d(e);return a(r)?JSON.parse(l(r,"utf-8")):{}}function g(e,r){const t=d(r),n=m(t);a(n)||c(n,{recursive:!0}),p(t,`${JSON.stringify(e,null,2)}
-`,"utf-8")}function h(){return`q_${Date.now().toString(36)}_${Math.random().toString(36).slice(2,6)}`}function I(e,r){const t=o(r);if(t[e])throw new Error(`Queue "${e}" already exists`);const n={name:e,items:[]};return t[e]=n,g(t,r),n}function E(e,r,t,n){const u=o(n);u[e]||(u[e]={name:e,items:[]});const s=new Date().toISOString(),i={id:h(),title:r,status:"pending",data:t,createdAt:s,updatedAt:s};return u[e].items.push(i),g(u,n),i}function $(e,r){const t=o(r),n=t[e];if(!n)throw new Error(`Queue "${e}" does not exist`);const u=n.items.find(s=>s.status==="pending");return u?(u.status="in-progress",u.updatedAt=new Date().toISOString(),g(t,r),u):null}function b(e,r,t){const n=o(t),u=n[e];if(!u)throw new Error(`Queue "${e}" does not exist`);const s=u.items.find(i=>i.id===r);if(!s)throw new Error(`Item "${r}" not found in queue "${e}"`);return s.status="done",s.updatedAt=new Date().toISOString(),g(n,t),s}function A(e,r,t,n){const u=o(n),s=u[e];if(!s)throw new Error(`Queue "${e}" does not exist`);const i=s.items.find(f=>f.id===r);if(!i)throw new Error(`Item "${r}" not found in queue "${e}"`);return i.status="failed",i.error=t,i.updatedAt=new Date().toISOString(),g(u,n),i}function D(e,r){return o(r)[e]??null}function y(e){const r=o(e);return Object.values(r).map(t=>({name:t.name,pending:t.items.filter(n=>n.status==="pending").length,done:t.items.filter(n=>n.status==="done").length,failed:t.items.filter(n=>n.status==="failed").length,total:t.items.length}))}function O(e,r){const t=o(r),n=t[e];if(!n)throw new Error(`Queue "${e}" does not exist`);const u=n.items.length;n.items=n.items.filter(i=>i.status==="pending"||i.status==="in-progress");const s=u-n.items.length;return g(t,r),s}function v(e,r){const t=o(r);return t[e]?(delete t[e],g(t,r),!0):!1}export{O as queueClear,I as queueCreate,v as queueDelete,b as queueDone,A as queueFail,D as queueGet,y as queueList,$ as queueNext,E as queuePush};
+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`,`queue.json`)}function s(e){let t=o(e);if(!n(t))return{};try{return JSON.parse(i(t,`utf-8`))}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(){return`q_${Date.now().toString(36)}_${Math.random().toString(36).slice(2,6)}`}function u(e,t){let n=s(t);if(n[e])throw Error(`Queue "${e}" already exists`);let r={name:e,items:[]};return n[e]=r,c(n,t),r}function d(e,t,n,r){let i=s(r);i[e]||(i[e]={name:e,items:[]});let a=new Date().toISOString(),o={id:l(),title:t,status:`pending`,data:n,createdAt:a,updatedAt:a};return i[e].items.push(o),c(i,r),o}function f(e,t){let n=s(t),r=n[e];if(!r)throw Error(`Queue "${e}" does not exist`);let i=r.items.find(e=>e.status===`pending`);return i?(i.status=`in-progress`,i.updatedAt=new Date().toISOString(),c(n,t),i):null}function p(e,t,n){let r=s(n),i=r[e];if(!i)throw Error(`Queue "${e}" does not exist`);let a=i.items.find(e=>e.id===t);if(!a)throw Error(`Item "${t}" not found in queue "${e}"`);return a.status=`done`,a.updatedAt=new Date().toISOString(),c(r,n),a}function m(e,t,n,r){let i=s(r),a=i[e];if(!a)throw Error(`Queue "${e}" does not exist`);let o=a.items.find(e=>e.id===t);if(!o)throw Error(`Item "${t}" not found in queue "${e}"`);return o.status=`failed`,o.error=n,o.updatedAt=new Date().toISOString(),c(i,r),o}function h(e,t){return s(t)[e]??null}function g(e){let t=s(e);return Object.values(t).map(e=>({name:e.name,pending:e.items.filter(e=>e.status===`pending`).length,done:e.items.filter(e=>e.status===`done`).length,failed:e.items.filter(e=>e.status===`failed`).length,total:e.items.length}))}function _(e,t){let n=s(t),r=n[e];if(!r)throw Error(`Queue "${e}" does not exist`);let i=r.items.length;r.items=r.items.filter(e=>e.status===`pending`||e.status===`in-progress`);let a=i-r.items.length;return c(n,t),a}function v(e,t){let n=s(t);return n[e]?(delete n[e],c(n,t),!0):!1}export{_ as queueClear,u as queueCreate,v as queueDelete,p as queueDone,m as queueFail,h as queueGet,g as queueList,f as queueNext,d as queuePush};
+//# sourceMappingURL=queue.js.map

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

@@ -1,31 +1,34 @@
+//#region packages/tools/src/regex-test.d.ts
 /**
  * kb_regex_test — Test regex patterns against sample strings.
  */
-export interface RegexTestOptions {
-    pattern: string;
-    flags?: string;
-    testStrings: string[];
-    mode?: 'match' | 'replace' | 'split';
-    replacement?: string;
+interface RegexTestOptions {
+  pattern: string;
+  flags?: string;
+  testStrings: string[];
+  mode?: 'match' | 'replace' | 'split';
+  replacement?: string;
 }
-export interface RegexMatchInfo {
-    full: string;
-    groups: (string | undefined)[];
-    index: number;
+interface RegexMatchInfo {
+  full: string;
+  groups: (string | undefined)[];
+  index: number;
 }
-export interface RegexTestStringResult {
-    input: string;
-    matched: boolean;
-    matches?: RegexMatchInfo[];
-    replaced?: string;
-    split?: string[];
+interface RegexTestStringResult {
+  input: string;
+  matched: boolean;
+  matches?: RegexMatchInfo[];
+  replaced?: string;
+  split?: string[];
 }
-export interface RegexTestResult {
-    pattern: string;
-    flags: string;
-    results: RegexTestStringResult[];
-    valid: boolean;
-    error?: string;
+interface RegexTestResult {
+  pattern: string;
+  flags: string;
+  results: RegexTestStringResult[];
+  valid: boolean;
+  error?: string;
 }
-export declare function regexTest(options: RegexTestOptions): RegexTestResult;
+declare function regexTest(options: RegexTestOptions): RegexTestResult;
+//#endregion
+export { RegexMatchInfo, RegexTestOptions, RegexTestResult, RegexTestStringResult, regexTest };
 //# sourceMappingURL=regex-test.d.ts.map

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

@@ -1 +1,2 @@
-function u(g){const{pattern:r,flags:e="",testStrings:l,mode:c="match",replacement:i=""}=g;try{const s=new RegExp(r,e),o=l.map(t=>{const n=s.test(t);switch(c){case"match":{const p=e.includes("g")?e:`${e}g`,x=[...t.matchAll(new RegExp(r,p))];return{input:t,matched:n,matches:x.map(a=>({full:a[0],groups:[...a.slice(1)],index:a.index??0}))}}case"replace":return{input:t,matched:n,replaced:t.replace(new RegExp(r,e),i)};default:return{input:t,matched:n,split:t.split(new RegExp(r,e))}}});return{pattern:r,flags:e,results:o,valid:!0}}catch(s){return{pattern:r,flags:e,results:[],valid:!1,error:s.message}}}export{u as regexTest};
+function e(e){let{pattern:t,flags:n=``,testStrings:r,mode:i=`match`,replacement:a=``}=e;try{let e=new RegExp(t,n);return{pattern:t,flags:n,results:r.map(r=>{let o=e.test(r);switch(i){case`match`:{let e=n.includes(`g`)?n:`${n}g`;return{input:r,matched:o,matches:[...r.matchAll(new RegExp(t,e))].map(e=>({full:e[0],groups:[...e.slice(1)],index:e.index??0}))}}case`replace`:return{input:r,matched:o,replaced:r.replace(new RegExp(t,n),a)};default:return{input:r,matched:o,split:r.split(new RegExp(t,n))}}}),valid:!0}}catch(e){return{pattern:t,flags:n,results:[],valid:!1,error:e.message}}}export{e as regexTest};
+//# sourceMappingURL=regex-test.js.map

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

@@ -1,29 +1,32 @@
-export interface RenameOptions {
-    /** Symbol to rename */
-    oldName: string;
-    /** New symbol name */
-    newName: string;
-    /** Root directory to search in */
-    rootPath: string;
-    /** File extensions to process (default: .ts, .tsx, .js, .jsx) */
-    extensions?: string[];
-    /** Glob patterns to exclude */
-    exclude?: string[];
-    /** Dry run — don't write changes */
-    dryRun?: boolean;
+//#region packages/tools/src/rename.d.ts
+interface RenameOptions {
+  /** Symbol to rename */
+  oldName: string;
+  /** New symbol name */
+  newName: string;
+  /** Root directory to search in */
+  rootPath: string;
+  /** File extensions to process (default: .ts, .tsx, .js, .jsx) */
+  extensions?: string[];
+  /** Glob patterns to exclude */
+  exclude?: string[];
+  /** Dry run — don't write changes */
+  dryRun?: boolean;
 }
-export interface RenameChange {
-    path: string;
-    line: number;
-    before: string;
-    after: string;
+interface RenameChange {
+  path: string;
+  line: number;
+  before: string;
+  after: string;
 }
-export interface RenameResult {
-    oldName: string;
-    newName: string;
-    changes: RenameChange[];
-    filesModified: number;
-    dryRun: boolean;
+interface RenameResult {
+  oldName: string;
+  newName: string;
+  changes: RenameChange[];
+  filesModified: number;
+  dryRun: boolean;
 }
-export declare function rename(options: RenameOptions): Promise<RenameResult>;
+declare function rename(options: RenameOptions): Promise<RenameResult>;
+//#endregion
+export { RenameChange, RenameOptions, RenameResult, rename };
 //# sourceMappingURL=rename.d.ts.map

package/packages/tools/dist/rename.js

@@ -1,2 +1,3 @@
-import{readFile as x,writeFile as w}from"node:fs/promises";import{relative as N}from"node:path";import{DEFAULT_TOOL_EXTENSIONS as $,walkFiles as b}from"./file-walk.js";function P(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function C(e){return e.replace(/\\/g,"/")}function E(e){return new RegExp(`(^|[^A-Za-z0-9_$])(${P(e)})(?=[^A-Za-z0-9_$]|$)`,"g")}async function A(e){const{oldName:r,newName:s,rootPath:l,extensions:p=$,exclude:d=[],dryRun:f=!1}=e;if(!r.trim())throw new Error("oldName must not be empty");const g=E(r),h=await b(l,p,d),c=[];let m=0;for(const i of h){const t=(await x(i,"utf-8")).split(/\r?\n/);let u=!1;for(let n=0;n<t.length;n++){const a=t[n];g.lastIndex=0;const o=a.replace(g,(O,R)=>(u=!0,`${R}${s}`));a!==o&&(t[n]=o,c.push({path:C(N(l,i)),line:n+1,before:a,after:o}))}u&&(m+=1,f||await w(i,t.join(`
-`),"utf-8"))}return{oldName:r,newName:s,changes:c,filesModified:m,dryRun:f}}export{A as rename};
+import{DEFAULT_TOOL_EXTENSIONS as e,walkFiles as t}from"./file-walk.js";import{readFile as n,writeFile as r}from"node:fs/promises";import{relative as i}from"node:path";function a(e){return e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)}function o(e){return e.replace(/\\/g,`/`)}function s(e){return RegExp(`(^|[^A-Za-z0-9_$])(${a(e)})(?=[^A-Za-z0-9_$]|$)`,`g`)}async function c(a){let{oldName:c,newName:l,rootPath:u,extensions:d=e,exclude:f=[],dryRun:p=!1}=a;if(!c.trim())throw Error(`oldName must not be empty`);let m=s(c),h=await t(u,d,f),g=[],_=0;for(let e of h){let t=(await n(e,`utf-8`)).split(/\r?\n/),a=!1;for(let n=0;n<t.length;n++){let r=t[n];m.lastIndex=0;let s=r.replace(m,(e,t)=>(a=!0,`${t}${l}`));r!==s&&(t[n]=s,g.push({path:o(i(u,e)),line:n+1,before:r,after:s}))}a&&(_+=1,p||await r(e,t.join(`
+`),`utf-8`))}return{oldName:c,newName:l,changes:g,filesModified:_,dryRun:p}}export{c as rename};
+//# sourceMappingURL=rename.js.map

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

@@ -1,3 +1,4 @@
+//#region packages/tools/src/replay.d.ts
 /**
  * Replay — append-only audit trail of tool/CLI invocations.
  *
@@ -5,52 +6,54 @@
  * to `.kb-state/replay.jsonl`. Used by `kb replay` CLI, `kb_replay` MCP tool,
  * and the TUI log panel.
  */
-export interface ReplayEntry {
-    /** ISO timestamp */
-    ts: string;
-    /** Source: 'mcp' | 'cli' */
-    source: 'mcp' | 'cli';
-    /** Tool or command name */
-    tool: string;
-    /** Redacted input summary (first 200 chars of JSON) */
-    input: string;
-    /** Duration in milliseconds */
-    durationMs: number;
-    /** Result status */
-    status: 'ok' | 'error';
-    /** Short result summary (first 200 chars) */
-    output: string;
+interface ReplayEntry {
+  /** ISO timestamp */
+  ts: string;
+  /** Source: 'mcp' | 'cli' */
+  source: 'mcp' | 'cli';
+  /** Tool or command name */
+  tool: string;
+  /** Redacted input summary (first 200 chars of JSON) */
+  input: string;
+  /** Duration in milliseconds */
+  durationMs: number;
+  /** Result status */
+  status: 'ok' | 'error';
+  /** Short result summary (first 200 chars) */
+  output: string;
 }
-export interface ReplayOptions {
-    /** Max entries to return (default: 20) */
-    last?: number;
-    /** Filter by tool name */
-    tool?: string;
-    /** Filter by source */
-    source?: 'mcp' | 'cli';
-    /** Filter entries after this ISO timestamp */
-    since?: string;
+interface ReplayOptions {
+  /** Max entries to return (default: 20) */
+  last?: number;
+  /** Filter by tool name */
+  tool?: string;
+  /** Filter by source */
+  source?: 'mcp' | 'cli';
+  /** Filter entries after this ISO timestamp */
+  since?: string;
 }
 /**
  * Append a replay entry to the audit log.
  * Creates the `.kb-state/` directory if it doesn't exist.
  */
-export declare function replayAppend(entry: ReplayEntry): void;
+declare function replayAppend(entry: ReplayEntry): void;
 /**
  * Read replay entries with optional filters.
  */
-export declare function replayList(opts?: ReplayOptions): ReplayEntry[];
+declare function replayList(opts?: ReplayOptions): ReplayEntry[];
 /**
  * Trim the replay log to MAX_ENTRIES, keeping the most recent.
  */
-export declare function replayTrim(): number;
+declare function replayTrim(): number;
 /**
  * Clear the entire replay log.
  */
-export declare function replayClear(): void;
+declare function replayClear(): void;
 /**
  * Helper: create a replay entry from a tool invocation.
  * Use as a wrapper around tool execution.
  */
-export declare function replayCapture(source: 'mcp' | 'cli', tool: string, input: unknown, fn: () => Promise<unknown>): Promise<unknown>;
+declare function replayCapture(source: 'mcp' | 'cli', tool: string, input: unknown, fn: () => Promise<unknown>): Promise<unknown>;
+//#endregion
+export { ReplayEntry, ReplayOptions, replayAppend, replayCapture, replayClear, replayList, replayTrim };
 //# sourceMappingURL=replay.d.ts.map

package/packages/tools/dist/replay.js

@@ -1,6 +1,5 @@
-import{appendFileSync as m,mkdirSync as S,readFileSync as u,writeFileSync as l}from"node:fs";import{dirname as w,resolve as d}from"node:path";const a=5e3,p=200;function c(){return d(process.cwd(),".kb-state","replay.jsonl")}function f(t,r){return t.length<=r?t:`${t.slice(0,r-1)}\u2026`}function y(t){const r=c();S(w(r),{recursive:!0});const n={...t,input:f(t.input,p),output:f(t.output,p)};m(r,`${JSON.stringify(n)}
-`,"utf-8")}function E(t={}){const r=c();let n;try{n=u(r,"utf-8")}catch{return[]}const s=n.trim().split(`
-`).filter(Boolean);let e=[];for(const o of s)try{e.push(JSON.parse(o))}catch{}if(t.tool&&(e=e.filter(o=>o.tool===t.tool)),t.source&&(e=e.filter(o=>o.source===t.source)),t.since){const o=t.since;e=e.filter(g=>g.ts>=o)}const i=t.last??20;return e.slice(-i)}function k(){const t=c();let r;try{r=u(t,"utf-8")}catch{return 0}const n=r.trim().split(`
-`).filter(Boolean);if(n.length<=a)return 0;const s=n.length-a,e=n.slice(-a);return l(t,`${e.join(`
-`)}
-`,"utf-8"),s}function O(){const t=c();try{l(t,"","utf-8")}catch{}}function N(t,r,n,s){const e=Date.now();return s().then(i=>(y({ts:new Date().toISOString(),source:t,tool:r,input:typeof n=="string"?n:JSON.stringify(n),durationMs:Date.now()-e,status:"ok",output:typeof i=="string"?i:JSON.stringify(i??"")}),i)).catch(i=>{throw y({ts:new Date().toISOString(),source:t,tool:r,input:typeof n=="string"?n:JSON.stringify(n),durationMs:Date.now()-e,status:"error",output:i instanceof Error?i.message:String(i)}),i})}export{y as replayAppend,N as replayCapture,O as replayClear,E as replayList,k as replayTrim};
+import{dirname as e,resolve as t}from"node:path";import{appendFileSync as n,mkdirSync as r,readFileSync as i,writeFileSync as a}from"node:fs";const o=5e3;let s=0;function c(){return t(process.cwd(),`.kb-state`,`replay.jsonl`)}function l(e,t){return e.length<=t?e:`${e.slice(0,t-1)}…`}function u(t){let i=c();r(e(i),{recursive:!0});let a={...t,input:l(t.input,200),output:l(t.output,200)};if(n(i,`${JSON.stringify(a)}\n`,`utf-8`),s++,s>=100){s=0;try{f()}catch{}}}function d(e={}){let t=c(),n;try{n=i(t,`utf-8`)}catch{return[]}let r=n.trim().split(`
+`).filter(Boolean),a=[];for(let e of r)try{a.push(JSON.parse(e))}catch{}if(e.tool&&(a=a.filter(t=>t.tool===e.tool)),e.source&&(a=a.filter(t=>t.source===e.source)),e.since){let t=e.since;a=a.filter(e=>e.ts>=t)}let o=e.last??20;return a.slice(-o)}function f(){let e=c(),t;try{t=i(e,`utf-8`)}catch{return 0}let n=t.trim().split(`
+`).filter(Boolean);if(n.length<=o)return 0;let r=n.length-o;return a(e,`${n.slice(-o).join(`
+`)}\n`,`utf-8`),r}function p(){let e=c();try{a(e,``,`utf-8`)}catch{}}function m(e,t,n,r){let i=Date.now();return r().then(r=>(u({ts:new Date().toISOString(),source:e,tool:t,input:typeof n==`string`?n:JSON.stringify(n),durationMs:Date.now()-i,status:`ok`,output:typeof r==`string`?r:JSON.stringify(r??``)}),r)).catch(r=>{throw u({ts:new Date().toISOString(),source:e,tool:t,input:typeof n==`string`?n:JSON.stringify(n),durationMs:Date.now()-i,status:`error`,output:r instanceof Error?r.message:String(r)}),r})}export{u as replayAppend,m as replayCapture,p as replayClear,d as replayList,f as replayTrim};
+//# sourceMappingURL=replay.js.map