@vpxa/kb 0.1.13 → 0.1.16

package/packages/tools/dist/dogfood-log.d.ts

@@ -0,0 +1,49 @@
+//#region packages/tools/src/dogfood-log.d.ts
+/**
+ * kb_dogfood — Review persistent warn/error logs for dogfooding.
+ *
+ * Reads daily JSONL log files from .kb-state/logs/ and returns a
+ * summarized or detailed view of recent issues. Useful for periodic
+ * review cycles to identify and fix recurring problems.
+ */
+interface DogfoodLogEntry {
+  ts: string;
+  level: 'warn' | 'error';
+  component: string;
+  msg: string;
+  [key: string]: unknown;
+}
+interface DogfoodLogOptions {
+  /** Number of days to look back (default: 7) */
+  days?: number;
+  /** Filter by level */
+  level?: 'warn' | 'error';
+  /** Filter by component name */
+  component?: string;
+  /** Maximum entries to return in detail (default: 50) */
+  limit?: number;
+}
+interface DogfoodLogGroupedEntry {
+  component: string;
+  msg: string;
+  level: 'warn' | 'error';
+  count: number;
+  firstSeen: string;
+  lastSeen: string;
+}
+interface DogfoodLogResult {
+  /** Total entries found matching filters */
+  totalEntries: number;
+  /** Unique issue groups (by component + message) */
+  groups: DogfoodLogGroupedEntry[];
+  /** Most recent entries (up to limit) */
+  recent: DogfoodLogEntry[];
+  /** Date range covered */
+  dateRange: {
+    from: string;
+    to: string;
+  };
+}
+declare function dogfoodLog(options?: DogfoodLogOptions): DogfoodLogResult;
+//#endregion
+export { DogfoodLogEntry, DogfoodLogGroupedEntry, DogfoodLogOptions, DogfoodLogResult, dogfoodLog };

package/packages/tools/dist/dogfood-log.js

@@ -0,0 +1,2 @@
+import{join as e,resolve as t}from"node:path";import{readFileSync as n,readdirSync as r}from"node:fs";import{KB_PATHS as i}from"../../core/dist/index.js";function a(){return t(process.cwd(),i.logs)}function o(t={}){let{days:i=7,level:o,component:s,limit:c=50}=t,l=a(),u=new Date,d=new Date(u.getTime()-i*864e5).toISOString().slice(0,10),f=u.toISOString().slice(0,10),p;try{p=r(l).filter(e=>e.endsWith(`.jsonl`)&&e.slice(0,10)>=d).sort()}catch{return{totalEntries:0,groups:[],recent:[],dateRange:{from:d,to:f}}}let m=[];for(let t of p)try{let r=n(e(l,t),`utf-8`);for(let e of r.trim().split(`
+`))if(e)try{let t=JSON.parse(e);if(o&&t.level!==o||s&&t.component!==s)continue;m.push(t)}catch{}}catch{}let h=new Map;for(let e of m){let t=`${e.component}::${e.msg}`,n=h.get(t);n?(n.count++,e.ts<n.firstSeen&&(n.firstSeen=e.ts),e.ts>n.lastSeen&&(n.lastSeen=e.ts)):h.set(t,{component:e.component,msg:e.msg,level:e.level,count:1,firstSeen:e.ts,lastSeen:e.ts})}let g=[...h.values()].sort((e,t)=>t.count-e.count),_=m.slice(-c);return{totalEntries:m.length,groups:g,recent:_,dateRange:{from:p.length>0?p[0].slice(0,10):d,to:f}}}export{o as dogfoodLog};

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

@@ -1,14 +1,16 @@
+//#region packages/tools/src/encode.d.ts
 /**
  * kb_encode — Encoding, decoding, and hashing utilities.
  */
-export type EncodeOperation = 'base64_encode' | 'base64_decode' | 'url_encode' | 'url_decode' | 'sha256' | 'md5' | 'jwt_decode' | 'hex_encode' | 'hex_decode';
-export interface EncodeOptions {
-    operation: EncodeOperation;
-    input: string;
+type EncodeOperation = 'base64_encode' | 'base64_decode' | 'url_encode' | 'url_decode' | 'sha256' | 'md5' | 'jwt_decode' | 'hex_encode' | 'hex_decode';
+interface EncodeOptions {
+  operation: EncodeOperation;
+  input: string;
 }
-export interface EncodeResult {
-    output: string;
-    operation: string;
+interface EncodeResult {
+  output: string;
+  operation: string;
 }
-export declare function encode(options: EncodeOptions): EncodeResult;
-//# sourceMappingURL=encode.d.ts.map
+declare function encode(options: EncodeOptions): EncodeResult;
+//#endregion
+export { EncodeOperation, EncodeOptions, EncodeResult, encode };

package/packages/tools/dist/encode.js

@@ -1 +1 @@
-import{createHash as n}from"node:crypto";function i(a){const{operation:t,input:o}=a;let e;switch(t){case"base64_encode":e=Buffer.from(o).toString("base64");break;case"base64_decode":e=Buffer.from(o,"base64").toString("utf8");break;case"url_encode":e=encodeURIComponent(o);break;case"url_decode":e=decodeURIComponent(o);break;case"sha256":e=n("sha256").update(o).digest("hex");break;case"md5":e=n("md5").update(o).digest("hex");break;case"jwt_decode":{const r=o.split(".");if(r.length!==3)throw new Error("Invalid JWT: expected 3 dot-separated parts");const d=JSON.parse(Buffer.from(r[0],"base64url").toString()),s=JSON.parse(Buffer.from(r[1],"base64url").toString());e=JSON.stringify({header:d,payload:s},null,2);break}case"hex_encode":e=Buffer.from(o).toString("hex");break;case"hex_decode":e=Buffer.from(o,"hex").toString("utf8");break;default:throw new Error(`Unknown operation: ${t}`)}return{output:e,operation:t}}export{i as encode};
+import{createHash as e}from"node:crypto";function t(t){let{operation:n,input:r}=t,i;switch(n){case`base64_encode`:i=Buffer.from(r).toString(`base64`);break;case`base64_decode`:i=Buffer.from(r,`base64`).toString(`utf8`);break;case`url_encode`:i=encodeURIComponent(r);break;case`url_decode`:i=decodeURIComponent(r);break;case`sha256`:i=e(`sha256`).update(r).digest(`hex`);break;case`md5`:i=e(`md5`).update(r).digest(`hex`);break;case`jwt_decode`:{let e=r.split(`.`);if(e.length!==3)throw Error(`Invalid JWT: expected 3 dot-separated parts`);let t,n;try{t=JSON.parse(Buffer.from(e[0],`base64url`).toString()),n=JSON.parse(Buffer.from(e[1],`base64url`).toString())}catch{throw Error(`Invalid JWT: header or payload is not valid JSON`)}i=JSON.stringify({header:t,payload:n},null,2);break}case`hex_encode`:i=Buffer.from(r).toString(`hex`);break;case`hex_decode`:i=Buffer.from(r,`hex`).toString(`utf8`);break;default:throw Error(`Unknown operation: ${n}`)}return{output:i,operation:n}}export{t as encode};

package/packages/tools/dist/env-info.d.ts

@@ -1,28 +1,30 @@
+//#region packages/tools/src/env-info.d.ts
 /**
  * kb_env — System environment and runtime information.
  */
-export interface EnvInfoOptions {
-    includeEnv?: boolean;
-    filterEnv?: string;
-    showSensitive?: boolean;
+interface EnvInfoOptions {
+  includeEnv?: boolean;
+  filterEnv?: string;
+  showSensitive?: boolean;
 }
-export interface EnvInfoResult {
-    system: {
-        platform: string;
-        arch: string;
-        release: string;
-        hostname: string;
-        type: string;
-        cpus: number;
-        memoryTotalGb: number;
-        memoryFreeGb: number;
-    };
-    runtime: {
-        node: string;
-        v8: string;
-    };
-    cwd: string;
-    env?: Record<string, string>;
+interface EnvInfoResult {
+  system: {
+    platform: string;
+    arch: string;
+    release: string;
+    hostname: string;
+    type: string;
+    cpus: number;
+    memoryTotalGb: number;
+    memoryFreeGb: number;
+  };
+  runtime: {
+    node: string;
+    v8: string;
+  };
+  cwd: string;
+  env?: Record<string, string>;
 }
-export declare function envInfo(options?: EnvInfoOptions): EnvInfoResult;
-//# sourceMappingURL=env-info.d.ts.map
+declare function envInfo(options?: EnvInfoOptions): EnvInfoResult;
+//#endregion
+export { EnvInfoOptions, EnvInfoResult, envInfo };

package/packages/tools/dist/env-info.js

@@ -1 +1 @@
-import{arch as m,cpus as l,freemem as f,hostname as p,type as v,platform as u,release as d,totalmem as g}from"node:os";const E=[/key/i,/secret/i,/token/i,/password/i,/passwd/i,/credential/i,/private/i,/certificate/i];function h(o={}){const{includeEnv:i=!1,filterEnv:t,showSensitive:c=!1}=o,s={system:{platform:u(),arch:m(),release:d(),hostname:p(),type:v(),cpus:l().length,memoryTotalGb:Math.round(g()/1024**3*10)/10,memoryFreeGb:Math.round(f()/1024**3*10)/10},runtime:{node:process.versions.node,v8:process.versions.v8},cwd:process.cwd()};if(i){const n={};for(const[e,r]of Object.entries(process.env))r&&(t&&!e.toLowerCase().includes(t.toLowerCase())||(!c&&E.some(a=>a.test(e))?n[e]="[REDACTED]":n[e]=r));s.env=n}return s}export{h as envInfo};
+import{arch as e,cpus as t,freemem as n,hostname as r,platform as i,release as a,totalmem as o,type as s}from"node:os";const c=[/key/i,/secret/i,/token/i,/password/i,/passwd/i,/credential/i,/private/i,/certificate/i];function l(l={}){let{includeEnv:u=!1,filterEnv:d,showSensitive:f=!1}=l,p={system:{platform:i(),arch:e(),release:a(),hostname:r(),type:s(),cpus:t().length,memoryTotalGb:Math.round(o()/1024**3*10)/10,memoryFreeGb:Math.round(n()/1024**3*10)/10},runtime:{node:process.versions.node,v8:process.versions.v8},cwd:process.cwd()};if(u){let e={};for(let[t,n]of Object.entries(process.env))n&&(d&&!t.toLowerCase().includes(d.toLowerCase())||(!f&&c.some(e=>e.test(t))?e[t]=`[REDACTED]`:e[t]=n));p.env=e}return p}export{l as envInfo};

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

@@ -1,13 +1,15 @@
-export interface EvalOptions {
-    code: string;
-    lang?: 'js' | 'ts';
-    timeout?: number;
+//#region packages/tools/src/eval.d.ts
+interface EvalOptions {
+  code: string;
+  lang?: 'js' | 'ts';
+  timeout?: number;
 }
-export interface EvalResult {
-    success: boolean;
-    output: string;
-    error?: string;
-    durationMs: number;
+interface EvalResult {
+  success: boolean;
+  output: string;
+  error?: string;
+  durationMs: number;
 }
-export declare function evaluate(options: EvalOptions): EvalResult;
-//# sourceMappingURL=eval.d.ts.map
+declare function evaluate(options: EvalOptions): EvalResult;
+//#endregion
+export { EvalOptions, EvalResult, evaluate };

package/packages/tools/dist/eval.js

@@ -1,3 +1,2 @@
-import u from"node:vm";function w(e){const{code:o,lang:c="js",timeout:p=5e3}=e,i=Date.now();try{const s=c==="ts"?g(o):o,n=[],l={console:{log:(...t)=>n.push(t.map(String).join(" ")),error:(...t)=>n.push(`[error] ${t.map(String).join(" ")}`),warn:(...t)=>n.push(`[warn] ${t.map(String).join(" ")}`)},setTimeout:void 0,setInterval:void 0,setImmediate:void 0,fetch:void 0,process:void 0,require:void 0,JSON,Math,Date,Array,Object,String,Number,Boolean,Map,Set,RegExp,Error,Promise,parseInt,parseFloat,isNaN,isFinite},d=u.createContext(l,{codeGeneration:{strings:!1,wasm:!1}}),r=u.runInContext(s,d,{timeout:p});return{success:!0,output:n.length>0?n.join(`
-`)+(r!==void 0?`
-\u2192 ${a(r)}`:""):r!==void 0?a(r):"(no output)",durationMs:Date.now()-i}}catch(s){return{success:!1,output:"",error:s.message,durationMs:Date.now()-i}}}function a(e){if(e===void 0)return"undefined";if(e===null)return"null";if(typeof e=="object")try{return JSON.stringify(e,null,2)}catch{return String(e)}return String(e)}function g(e){return e.replace(/^\s*import\s+type\s+.*?;\s*$/gm,"").replace(/^\s*(?:export\s+)?interface\s+\w+[^{]*\{[\s\S]*?^\s*}\s*$/gm,"").replace(/^\s*(?:export\s+)?type\s+\w+\s*=.*?;\s*$/gm,"").replace(/([,(]\s*[A-Za-z_$][\w$]*)\s*:\s*[^,)=\n]+/g,"$1").replace(/\)\s*:\s*[^={\n]+(?=\s*(?:=>|\{))/g,")").replace(/\s+as\s+[A-Za-z_$][\w$<>,[\]|&\s.]*/g,"").replace(/<(?:[A-Za-z_$][\w$]*\s*,?\s*)+>(?=\s*\()/g,"")}export{w as evaluate};
+import e from"node:vm";function t(t){let{code:i,lang:a=`js`,timeout:o=5e3}=t,s=Date.now();try{let t=a===`ts`?r(i):i,c=[],l={console:{log:(...e)=>c.push(e.map(String).join(` `)),error:(...e)=>c.push(`[error] ${e.map(String).join(` `)}`),warn:(...e)=>c.push(`[warn] ${e.map(String).join(` `)}`)},setTimeout:void 0,setInterval:void 0,setImmediate:void 0,fetch:void 0,process:void 0,require:void 0,JSON,Math,Date,Array,Object,String,Number,Boolean,Map,Set,RegExp,Error,Promise,parseInt,parseFloat,isNaN,isFinite},u=e.createContext(l,{codeGeneration:{strings:!1,wasm:!1}}),d=e.runInContext(t,u,{timeout:o});return{success:!0,output:c.length>0?c.join(`
+`)+(d===void 0?``:`\n→ ${n(d)}`):d===void 0?`(no output)`:n(d),durationMs:Date.now()-s}}catch(e){return{success:!1,output:``,error:e.message,durationMs:Date.now()-s}}}function n(e){if(e===void 0)return`undefined`;if(e===null)return`null`;if(typeof e==`object`)try{return JSON.stringify(e,null,2)}catch{return String(e)}return String(e)}function r(e){return e.replace(/^\s*import\s+type\s+.*?;\s*$/gm,``).replace(/^\s*(?:export\s+)?interface\s+\w+[^{]*\{[\s\S]*?^\s*}\s*$/gm,``).replace(/^\s*(?:export\s+)?type\s+\w+\s*=.*?;\s*$/gm,``).replace(/([,(]\s*[A-Za-z_$][\w$]*)\s*:\s*[^,)=\n]+/g,`$1`).replace(/\)\s*:\s*[^={\n]+(?=\s*(?:=>|\{))/g,`)`).replace(/\s+as\s+[A-Za-z_$][\w$<>,[\]|&\s.]*/g,``).replace(/<(?:[A-Za-z_$][\w$]*\s*,?\s*)+>(?=\s*\()/g,``)}export{t as evaluate};

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

@@ -1,79 +1,81 @@
+//#region packages/tools/src/evidence-map.d.ts
 /**
  * kb_evidence_map — FORGE Evidence Map CRUD + Gate evaluator.
  *
  * Structured storage, validation, and gate evaluation for FORGE Evidence Map entries.
  * Persisted in .kb-state/evidence-maps.json.
  */
-export type EvidenceStatus = 'V' | 'A' | 'U';
-export type UnknownType = 'contract' | 'convention' | 'freshness' | 'runtime' | 'data-flow' | 'impact';
-export type GateDecision = 'YIELD' | 'HOLD' | 'HARD_BLOCK' | 'FORCED_DELIVERY';
-export type ForgeTier = 'floor' | 'standard' | 'critical';
-export interface EvidenceEntry {
-    id: number;
-    claim: string;
-    status: EvidenceStatus;
-    receipt: string;
-    criticalPath: boolean;
-    unknownType?: UnknownType;
+type EvidenceStatus = 'V' | 'A' | 'U';
+type UnknownType = 'contract' | 'convention' | 'freshness' | 'runtime' | 'data-flow' | 'impact';
+type GateDecision = 'YIELD' | 'HOLD' | 'HARD_BLOCK' | 'FORCED_DELIVERY';
+type ForgeTier = 'floor' | 'standard' | 'critical';
+interface EvidenceEntry {
+  id: number;
+  claim: string;
+  status: EvidenceStatus;
+  receipt: string;
+  criticalPath: boolean;
+  unknownType?: UnknownType;
 }
-export interface EvidenceMapState {
-    taskId: string;
-    tier: ForgeTier;
-    entries: EvidenceEntry[];
-    createdAt: string;
-    updatedAt: string;
+interface EvidenceMapState {
+  taskId: string;
+  tier: ForgeTier;
+  entries: EvidenceEntry[];
+  createdAt: string;
+  updatedAt: string;
 }
-export interface GateResult {
-    decision: GateDecision;
-    reason: string;
-    unresolvedCritical: EvidenceEntry[];
-    warnings: string[];
-    stats: {
-        total: number;
-        verified: number;
-        assumed: number;
-        unresolved: number;
-    };
-    annotation?: string;
+interface GateResult {
+  decision: GateDecision;
+  reason: string;
+  unresolvedCritical: EvidenceEntry[];
+  warnings: string[];
+  stats: {
+    total: number;
+    verified: number;
+    assumed: number;
+    unresolved: number;
+  };
+  annotation?: string;
 }
-export type EvidenceMapAction = {
-    action: 'create';
-    taskId: string;
-    tier: ForgeTier;
+type EvidenceMapAction = {
+  action: 'create';
+  taskId: string;
+  tier: ForgeTier;
 } | {
-    action: 'add';
-    taskId: string;
-    claim: string;
-    status: EvidenceStatus;
-    receipt: string;
-    criticalPath?: boolean;
-    unknownType?: UnknownType;
+  action: 'add';
+  taskId: string;
+  claim: string;
+  status: EvidenceStatus;
+  receipt: string;
+  criticalPath?: boolean;
+  unknownType?: UnknownType;
 } | {
-    action: 'update';
-    taskId: string;
-    id: number;
-    status: EvidenceStatus;
-    receipt: string;
+  action: 'update';
+  taskId: string;
+  id: number;
+  status: EvidenceStatus;
+  receipt: string;
 } | {
-    action: 'get';
-    taskId: string;
+  action: 'get';
+  taskId: string;
 } | {
-    action: 'gate';
-    taskId: string;
-    retryCount?: number;
+  action: 'gate';
+  taskId: string;
+  retryCount?: number;
 } | {
-    action: 'list';
+  action: 'list';
 } | {
-    action: 'delete';
-    taskId: string;
+  action: 'delete';
+  taskId: string;
 };
-export interface EvidenceMapResult {
-    state?: EvidenceMapState;
-    states?: EvidenceMapState[];
-    entry?: EvidenceEntry;
-    gate?: GateResult;
-    deleted?: boolean;
-    formattedMap?: string;
+interface EvidenceMapResult {
+  state?: EvidenceMapState;
+  states?: EvidenceMapState[];
+  entry?: EvidenceEntry;
+  gate?: GateResult;
+  deleted?: boolean;
+  formattedMap?: string;
 }
-export declare function evidenceMap(action: EvidenceMapAction, cwd?: string): EvidenceMapResult;
-//# sourceMappingURL=evidence-map.d.ts.map
+declare function evidenceMap(action: EvidenceMapAction, cwd?: string): EvidenceMapResult;
+//#endregion
+export { EvidenceEntry, EvidenceMapAction, EvidenceMapResult, EvidenceMapState, EvidenceStatus, ForgeTier, GateDecision, GateResult, UnknownType, evidenceMap };

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

@@ -1,3 +1,2 @@
-import{existsSync as p,mkdirSync as g,readFileSync as m,writeFileSync as v}from"node:fs";import{dirname as E,resolve as y}from"node:path";const h=".kb-state",k="evidence-maps.json";function f(t){const n=t??process.cwd();return y(n,h,k)}function o(t){const n=f(t);if(!p(n))return{};const e=m(n,"utf-8");return JSON.parse(e)}function c(t,n){const e=f(n),r=E(e);p(r)||g(r,{recursive:!0}),v(e,`${JSON.stringify(t,null,2)}
-`,"utf-8")}function d(t,n){const e=o(n),r=e[t];if(!r)throw new Error(`Evidence map not found: ${t}`);return{maps:e,state:r}}function S(t){return t.reduce((n,e)=>Math.max(n,e.id),0)+1}function M(t){const n=t.trim();if(!n)throw new Error("Claim is required");if(/\r?\n/.test(n))throw new Error("Claim must be a single line");return n}function u(t){return(t??"").replace(/\r?\n/g," ").replace(/\|/g,"\\|")}function s(t){const n=["| # | Claim | Status | Receipt | Critical | Type |","|---|-------|--------|---------|----------|------|"];for(const e of t.entries)n.push(`| ${e.id} | ${u(e.claim)} | ${e.status} | ${u(e.receipt)} | ${e.criticalPath?"yes":"no"} | ${u(e.unknownType)} |`);return n.join(`
-`)}function I(t){return{total:t.length,verified:t.filter(n=>n.status==="V").length,assumed:t.filter(n=>n.status==="A").length,unresolved:t.filter(n=>n.status==="U").length}}function w(t){const n=[];for(const e of t.entries)e.status==="V"&&e.receipt.trim()===""&&n.push("V entry without receipt"),e.status==="A"&&t.tier==="critical"&&e.unknownType==="contract"&&n.push("Assumed contract at Critical tier \u2014 should be Verified");return n}function b(t){return`FORCED DELIVERY annotation: unresolved entries remain -> ${t.filter(r=>r.status==="U").map(r=>`#${r.id} ${r.claim}`).join("; ")}`}function A(t,n=0){const e=t.entries.filter(a=>a.criticalPath&&a.status==="U"),r=w(t),i=I(t.entries);return e.find(a=>a.unknownType==="contract")?{decision:"HARD_BLOCK",reason:"Unresolved contract unknown on critical path",unresolvedCritical:e,warnings:r,stats:i}:e.length>0&&n===0?{decision:"HOLD",reason:"Unresolved critical-path unknown \u2014 retry available",unresolvedCritical:e,warnings:r,stats:i}:e.length>0&&n>=1?{decision:"FORCED_DELIVERY",reason:"Unresolved critical-path unknown after retry",unresolvedCritical:e,warnings:r,stats:i,annotation:b(t.entries)}:{decision:"YIELD",reason:"All critical-path claims satisfy gate rules",unresolvedCritical:[],warnings:r,stats:i}}function D(t,n){switch(t.action){case"create":{const e=o(n),r=new Date().toISOString(),i={taskId:t.taskId,tier:t.tier,entries:[],createdAt:r,updatedAt:r};return e[t.taskId]=i,c(e,n),{state:i,formattedMap:s(i)}}case"add":{const{maps:e,state:r}=d(t.taskId,n),i={id:S(r.entries),claim:M(t.claim),status:t.status,receipt:t.receipt,criticalPath:t.criticalPath??!1,unknownType:t.unknownType};return r.entries.push(i),r.updatedAt=new Date().toISOString(),e[t.taskId]=r,c(e,n),{state:r,entry:i,formattedMap:s(r)}}case"update":{const{maps:e,state:r}=d(t.taskId,n),i=r.entries.find(l=>l.id===t.id);if(!i)throw new Error(`Evidence entry not found: ${t.id}`);return i.status=t.status,i.receipt=t.receipt,r.updatedAt=new Date().toISOString(),e[t.taskId]=r,c(e,n),{state:r,entry:i,formattedMap:s(r)}}case"get":{const{state:e}=d(t.taskId,n);return{state:e,formattedMap:s(e)}}case"gate":{const{state:e}=d(t.taskId,n);return{state:e,gate:A(e,t.retryCount??0),formattedMap:s(e)}}case"list":return{states:Object.values(o(n)).sort((r,i)=>r.createdAt.localeCompare(i.createdAt))};case"delete":{const e=o(n);return t.taskId in e?(delete e[t.taskId],c(e,n),{deleted:!0}):{deleted:!1}}}}export{D as evidenceMap};
+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";import{KB_PATHS as o}from"../../core/dist/index.js";const s=o.state;function c(e){return t(e??process.cwd(),s,`evidence-maps.json`)}function l(e){let t=c(e);if(!n(t))return{};try{let e=i(t,`utf-8`);return JSON.parse(e)}catch{return{}}}function u(t,i){let o=c(i),s=e(o);n(s)||r(s,{recursive:!0}),a(o,`${JSON.stringify(t,null,2)}\n`,`utf-8`)}function d(e,t){let n=l(t),r=n[e];if(!r)throw Error(`Evidence map not found: ${e}`);return{maps:n,state:r}}function f(e){return e.reduce((e,t)=>Math.max(e,t.id),0)+1}function p(e){let t=e.trim();if(!t)throw Error(`Claim is required`);if(/\r?\n/.test(t))throw Error(`Claim must be a single line`);return t}function m(e){return(e??``).replace(/\r?\n/g,` `).replace(/\|/g,`\\|`)}function h(e){let t=[`| # | Claim | Status | Receipt | Critical | Type |`,`|---|-------|--------|---------|----------|------|`];for(let n of e.entries)t.push(`| ${n.id} | ${m(n.claim)} | ${n.status} | ${m(n.receipt)} | ${n.criticalPath?`yes`:`no`} | ${m(n.unknownType)} |`);return t.join(`
+`)}function g(e){return{total:e.length,verified:e.filter(e=>e.status===`V`).length,assumed:e.filter(e=>e.status===`A`).length,unresolved:e.filter(e=>e.status===`U`).length}}function _(e){let t=[];for(let n of e.entries)n.status===`V`&&n.receipt.trim()===``&&t.push(`V entry without receipt`),n.status===`A`&&e.tier===`critical`&&n.unknownType===`contract`&&t.push(`Assumed contract at Critical tier — should be Verified`);return t}function v(e){return`FORCED DELIVERY annotation: unresolved entries remain -> ${e.filter(e=>e.status===`U`).map(e=>`#${e.id} ${e.claim}`).join(`; `)}`}function y(e,t=0){let n=e.entries.filter(e=>e.criticalPath&&e.status===`U`),r=_(e),i=g(e.entries);return n.find(e=>e.unknownType===`contract`)?{decision:`HARD_BLOCK`,reason:`Unresolved contract unknown on critical path`,unresolvedCritical:n,warnings:r,stats:i}:n.length>0&&t===0?{decision:`HOLD`,reason:`Unresolved critical-path unknown — retry available`,unresolvedCritical:n,warnings:r,stats:i}:n.length>0&&t>=1?{decision:`FORCED_DELIVERY`,reason:`Unresolved critical-path unknown after retry`,unresolvedCritical:n,warnings:r,stats:i,annotation:v(e.entries)}:{decision:`YIELD`,reason:`All critical-path claims satisfy gate rules`,unresolvedCritical:[],warnings:r,stats:i}}function b(e,t){switch(e.action){case`create`:{let n=l(t),r=new Date().toISOString(),i={taskId:e.taskId,tier:e.tier,entries:[],createdAt:r,updatedAt:r};return n[e.taskId]=i,u(n,t),{state:i,formattedMap:h(i)}}case`add`:{let{maps:n,state:r}=d(e.taskId,t),i={id:f(r.entries),claim:p(e.claim),status:e.status,receipt:e.receipt,criticalPath:e.criticalPath??!1,unknownType:e.unknownType};return r.entries.push(i),r.updatedAt=new Date().toISOString(),n[e.taskId]=r,u(n,t),{state:r,entry:i,formattedMap:h(r)}}case`update`:{let{maps:n,state:r}=d(e.taskId,t),i=r.entries.find(t=>t.id===e.id);if(!i)throw Error(`Evidence entry not found: ${e.id}`);return i.status=e.status,i.receipt=e.receipt,r.updatedAt=new Date().toISOString(),n[e.taskId]=r,u(n,t),{state:r,entry:i,formattedMap:h(r)}}case`get`:{let{state:n}=d(e.taskId,t);return{state:n,formattedMap:h(n)}}case`gate`:{let{state:n}=d(e.taskId,t);return{state:n,gate:y(n,e.retryCount??0),formattedMap:h(n)}}case`list`:return{states:Object.values(l(t)).sort((e,t)=>e.createdAt.localeCompare(t.createdAt))};case`delete`:{let n=l(t);return e.taskId in n?(delete n[e.taskId],u(n,t),{deleted:!0}):{deleted:!1}}}}export{b as evidenceMap};

package/packages/tools/dist/file-cache.d.ts

@@ -0,0 +1,41 @@
+//#region packages/tools/src/file-cache.d.ts
+interface FileCacheEntry {
+  /** Full file content */
+  content: string;
+  /** SHA-256 hash of content */
+  hash: string;
+  /** Line count */
+  lines: number;
+  /** Estimated token count (~chars/4) */
+  estimatedTokens: number;
+  /** How many times this file has been requested */
+  hitCount: number;
+  /** Whether content changed since last read (false on cache hit) */
+  changed: boolean;
+}
+interface FileCacheStats {
+  totalReads: number;
+  cacheHits: number;
+  filesTracked: number;
+}
+declare class FileCache {
+  private cache;
+  private totalReads;
+  private cacheHits;
+  private static readonly MAX_ENTRIES;
+  /**
+   * Get file content with deduplication.
+   * First call: reads from disk, hashes, caches.
+   * Subsequent calls: checks mtime → if unchanged, cache hit (skip read).
+   * If mtime changed: re-reads, re-hashes, checks if content actually changed.
+   */
+  get(filePath: string): Promise<FileCacheEntry>;
+  /** Remove a single file from cache. Returns true if it was cached. */
+  invalidate(filePath: string): boolean;
+  /** Clear all cached files. Returns how many were cleared. */
+  clear(): number;
+  /** Get cache statistics. */
+  stats(): FileCacheStats;
+}
+//#endregion
+export { FileCache, FileCacheEntry, FileCacheStats };

package/packages/tools/dist/file-cache.js

@@ -0,0 +1,3 @@
+import{estimateTokens as e}from"./text-utils.js";import{readFile as t,stat as n}from"node:fs/promises";import{resolve as r}from"node:path";import{createHash as i}from"node:crypto";var a=class i{cache=new Map;totalReads=0;cacheHits=0;static MAX_ENTRIES=500;async get(a){let s=r(a);this.totalReads++;let c=(await n(s)).mtimeMs,l=this.cache.get(s);if(l){if(l.mtimeMs===c)return this.cacheHits++,l.hitCount++,{content:l.content,hash:l.hash,lines:l.lines,estimatedTokens:l.estimatedTokens,hitCount:l.hitCount,changed:!1};let n=await t(s,`utf-8`),r=o(n);if(r===l.hash)return this.cacheHits++,l.hitCount++,l.mtimeMs=c,{content:l.content,hash:l.hash,lines:l.lines,estimatedTokens:l.estimatedTokens,hitCount:l.hitCount,changed:!1};let i=n.split(`
+`).length,a=e(n);return l.content=n,l.hash=r,l.lines=i,l.estimatedTokens=a,l.hitCount++,l.mtimeMs=c,{content:n,hash:r,lines:i,estimatedTokens:a,hitCount:l.hitCount,changed:!0}}let u=await t(s,`utf-8`),d=o(u),f=u.split(`
+`).length,p=e(u);if(this.cache.set(s,{content:u,hash:d,lines:f,estimatedTokens:p,hitCount:1,mtimeMs:c}),this.cache.size>i.MAX_ENTRIES){let e=this.cache.keys().next().value;e&&this.cache.delete(e)}return{content:u,hash:d,lines:f,estimatedTokens:p,hitCount:1,changed:!0}}invalidate(e){return this.cache.delete(r(e))}clear(){let e=this.cache.size;return this.cache.clear(),e}stats(){return{totalReads:this.totalReads,cacheHits:this.cacheHits,filesTracked:this.cache.size}}};function o(e){return i(`sha256`).update(e).digest(`hex`)}export{a as FileCache};

package/packages/tools/dist/file-summary.d.ts

@@ -1,32 +1,52 @@
-export interface FileSummaryOptions {
-    path: string;
-    previewLines?: number;
+//#region packages/tools/src/file-summary.d.ts
+interface FileSummaryOptions {
+  path: string;
+  /** Pre-loaded content — skip readFile when provided (e.g., from FileCache) */
+  content?: string;
+  previewLines?: number;
 }
-export interface FileSummaryResult {
-    path: string;
-    lines: number;
-    language: string;
-    imports: string[];
-    exports: string[];
-    functions: Array<{
-        name: string;
-        line: number;
-        exported: boolean;
-    }>;
-    classes: Array<{
-        name: string;
-        line: number;
-        exported: boolean;
-    }>;
-    interfaces: Array<{
-        name: string;
-        line: number;
-    }>;
-    types: Array<{
-        name: string;
-        line: number;
-    }>;
-    estimatedTokens: number;
+interface FileSummaryResult {
+  path: string;
+  lines: number;
+  language: string;
+  imports: string[];
+  exports: string[];
+  functions: Array<{
+    name: string;
+    line: number;
+    exported: boolean;
+    signature?: string;
+  }>;
+  classes: Array<{
+    name: string;
+    line: number;
+    exported: boolean;
+    signature?: string;
+  }>;
+  interfaces: Array<{
+    name: string;
+    line: number;
+    exported: boolean;
+  }>;
+  types: Array<{
+    name: string;
+    line: number;
+    exported: boolean;
+  }>;
+  /** Import details with external/internal classification (AST-powered) */
+  importDetails?: Array<{
+    source: string;
+    specifiers: string[];
+    isExternal: boolean;
+  }>;
+  /** Intra-file call edges showing which functions call which (AST-powered) */
+  callEdges?: Array<{
+    caller: string;
+    callee: string;
+    line: number;
+  }>;
+  estimatedTokens: number;
 }
-export declare function fileSummary(options: FileSummaryOptions): Promise<FileSummaryResult>;
-//# sourceMappingURL=file-summary.d.ts.map
+declare function fileSummary(options: FileSummaryOptions): Promise<FileSummaryResult>;
+//#endregion
+export { FileSummaryOptions, FileSummaryResult, fileSummary };

package/packages/tools/dist/file-summary.js

@@ -1,2 +1,2 @@
-import{readFile as S}from"node:fs/promises";async function L(i){const{path:r,previewLines:R=3}=i,u=await S(r,"utf-8"),m=u.split(`
-`),j=r.split(".").pop()??"",h=[],e=[],o=[],f=[],y=[],g=[];for(let a=0;a<m.length;a+=1){const t=m[a],n=a+1;if(/^import\s+.+/.test(t)){h.push(t.trim());continue}const l=t.match(/^export\s+(?:async\s+)?function\s+(\w+)/);if(l){o.push({name:l[1],line:n,exported:!0}),e.push(l[1]);continue}const x=t.match(/^(?:async\s+)?function\s+(\w+)/);if(x){o.push({name:x[1],line:n,exported:!1});continue}const c=t.match(/^(export\s+)?const\s+(\w+)\s*=.*(?:=>|\bfunction\b)/);if(c){const s=!!c[1];o.push({name:c[2],line:n,exported:s}),s&&e.push(c[2]);continue}const b=t.match(/^export\s+const\s+(\w+)\s*=/);if(b){e.push(b[1]);continue}const p=t.match(/^(export\s+)?(?:abstract\s+)?class\s+(\w+)/);if(p){const s=!!p[1];f.push({name:p[2],line:n,exported:s}),s&&e.push(p[2]);continue}const d=t.match(/^(?:export\s+)?interface\s+(\w+)/);if(d){y.push({name:d[1],line:n});continue}const w=t.match(/^(?:export\s+)?type\s+(\w+)/);if(w){g.push({name:w[1],line:n});continue}const F=t.match(/^export\s+\{(.+)\}/);if(F){const s=F[1].split(",").map(M=>M.trim().split(/\s+as\s+/).pop()?.trim()??"").filter(Boolean);e.push(...s)}}return{path:r,lines:m.length,language:v(j),imports:h,exports:e,functions:o,classes:f,interfaces:y,types:g,estimatedTokens:Math.ceil(u.length/4)}}function v(i){return{ts:"typescript",tsx:"typescript-jsx",js:"javascript",jsx:"javascript-jsx",py:"python",rs:"rust",go:"go",java:"java",rb:"ruby",md:"markdown",json:"json",yaml:"yaml",yml:"yaml",css:"css",html:"html",sh:"shell",bash:"shell"}[i]??i}export{L as fileSummary};
+import{readFile as e}from"node:fs/promises";import{extname as t}from"node:path";import{SUPPORTED_EXTENSIONS as n,WasmRuntime as r,extractCalls as i,extractImports as a,extractSymbols as o}from"../../chunker/dist/index.js";async function s(i){let{path:a,previewLines:o=3}=i,s=i.content??await e(a,`utf-8`),u=s.split(`
+`),d=a.split(`.`).pop()??``,f=t(a);return r.get()&&n.has(f)?c(a,s,u,d,f):l(a,s,u,d)}async function c(e,t,n,r,s){let[c,l,d]=await Promise.all([o(t,s,e),a(t,s,e),i(t,s,e).catch(()=>[])]),f=l.map(e=>`import ${e.specifiers.length>0?`{ ${e.specifiers.join(`, `)} }`:`*`} from '${e.source}'`),p=[],m=[],h=[],g=[],_=[];for(let e of c)switch(e.exported&&p.push(e.name),e.kind){case`function`:case`method`:m.push({name:e.name,line:e.line,exported:e.exported,signature:e.signature});break;case`class`:h.push({name:e.name,line:e.line,exported:e.exported,signature:e.signature});break;case`interface`:g.push({name:e.name,line:e.line,exported:e.exported});break;case`type`:_.push({name:e.name,line:e.line,exported:e.exported});break}let v=l.map(e=>({source:e.source,specifiers:e.specifiers,isExternal:e.isExternal})),y=d.map(e=>({caller:e.callerName,callee:e.calleeName,line:e.line}));return{path:e,lines:n.length,language:u(r),imports:f,exports:p,functions:m,classes:h,interfaces:g,types:_,importDetails:v,callEdges:y.length>0?y:void 0,estimatedTokens:Math.ceil(t.length/4)}}function l(e,t,n,r){let i=[],a=[],o=[],s=[],c=[],l=[];for(let e=0;e<n.length;e+=1){let t=n[e],r=e+1;if(/^import\s+.+/.test(t)){i.push(t.trim());continue}let u=t.match(/^export\s+(?:async\s+)?function\s+(\w+)/);if(u){o.push({name:u[1],line:r,exported:!0}),a.push(u[1]);continue}let d=t.match(/^(?:async\s+)?function\s+(\w+)/);if(d){o.push({name:d[1],line:r,exported:!1});continue}let f=t.match(/^(export\s+)?const\s+(\w+)\s*=.*(?:=>|\bfunction\b)/);if(f){let e=!!f[1];o.push({name:f[2],line:r,exported:e}),e&&a.push(f[2]);continue}let p=t.match(/^export\s+const\s+(\w+)\s*=/);if(p){a.push(p[1]);continue}let m=t.match(/^(export\s+)?(?:abstract\s+)?class\s+(\w+)/);if(m){let e=!!m[1];s.push({name:m[2],line:r,exported:e}),e&&a.push(m[2]);continue}let h=t.match(/^(export\s+)?interface\s+(\w+)/);if(h){let e=!!h[1];c.push({name:h[2],line:r,exported:e}),e&&a.push(h[2]);continue}let g=t.match(/^(export\s+)?type\s+(\w+)/);if(g){let e=!!g[1];l.push({name:g[2],line:r,exported:e}),e&&a.push(g[2]);continue}let _=t.match(/^export\s+\{(.+)\}/);if(_){let e=_[1].split(`,`).map(e=>e.trim().split(/\s+as\s+/).pop()?.trim()??``).filter(Boolean);a.push(...e)}}return{path:e,lines:n.length,language:u(r),imports:i,exports:a,functions:o,classes:s,interfaces:c,types:l,estimatedTokens:Math.ceil(t.length/4)}}function u(e){return{ts:`typescript`,tsx:`typescript-jsx`,js:`javascript`,jsx:`javascript-jsx`,py:`python`,rs:`rust`,go:`go`,java:`java`,rb:`ruby`,md:`markdown`,json:`json`,yaml:`yaml`,yml:`yaml`,css:`css`,html:`html`,sh:`shell`,bash:`shell`}[e]??e}export{s as fileSummary};

package/packages/tools/dist/file-walk.d.ts

@@ -1,4 +1,6 @@
-export declare const DEFAULT_TOOL_EXTENSIONS: string[];
-export declare function matchesGlobPattern(path: string, pattern: string): boolean;
-export declare function walkFiles(rootPath: string, extensions: string[], exclude: string[]): Promise<string[]>;
-//# sourceMappingURL=file-walk.d.ts.map
+//#region packages/tools/src/file-walk.d.ts
+declare const DEFAULT_TOOL_EXTENSIONS: string[];
+declare function matchesGlobPattern(path: string, pattern: string): boolean;
+declare function walkFiles(rootPath: string, extensions: string[], exclude: string[]): Promise<string[]>;
+//#endregion
+export { DEFAULT_TOOL_EXTENSIONS, matchesGlobPattern, walkFiles };

package/packages/tools/dist/file-walk.js

@@ -1 +1 @@
-import{readdir as p,stat as x}from"node:fs/promises";import{extname as E,join as w,relative as L}from"node:path";const D=[".ts",".tsx",".js",".jsx"],b=new Set(["node_modules",".git","dist","build","coverage",".turbo",".cache","cdk.out",".kb-state"]);function g(e){return e.replace(/\\/g,"/")}function S(e){return e.replace(/[.+^${}()|[\]\\]/g,"\\$&")}function f(e,i){const n=g(e),t=g(i).trim();if(!t)return!1;const s=S(t).replace(/\*\*/g,"::DOUBLE_STAR::").replace(/\*/g,"[^/]*").replace(/\?/g,"[^/]").replace(/::DOUBLE_STAR::/g,".*");return new RegExp(`^${s}$`).test(n)}function m(e,i,n){return i.some(t=>f(e,t)?!0:n?f(`${e}/`,t):!1)}async function P(e,i,n){const t=[],s=i.map(r=>r.toLowerCase());async function a(r){const c=await p(r);for(const l of c){if(b.has(l))continue;const o=w(r,l),d=await x(o),u=g(L(e,o));if(d.isDirectory()){m(u,n,!0)||await a(o);continue}m(u,n,!1)||s.includes(E(l).toLowerCase())&&t.push(o)}}return await a(e),t.sort((r,c)=>r.localeCompare(c)),t}export{D as DEFAULT_TOOL_EXTENSIONS,f as matchesGlobPattern,P as walkFiles};
+import{readdir as e,stat as t}from"node:fs/promises";import{extname as n,join as r,relative as i}from"node:path";import{KB_PATHS as a}from"../../core/dist/index.js";const o=[`.ts`,`.tsx`,`.js`,`.jsx`],s=new Set([`node_modules`,`.git`,`dist`,`build`,`coverage`,`.turbo`,`.cache`,`cdk.out`,a.state]);function c(e){return e.replace(/\\/g,`/`)}function l(e){return e.replace(/[.+^${}()|[\]\\]/g,`\\$&`)}function u(e,t){let n=c(e),r=c(t).trim();if(!r)return!1;let i=l(r).replace(/\*\*/g,`::DOUBLE_STAR::`).replace(/\*/g,`[^/]*`).replace(/\?/g,`[^/]`).replace(/::DOUBLE_STAR::/g,`.*`);return RegExp(`^${i}$`).test(n)}function d(e,t,n){return t.some(t=>u(e,t)?!0:n?u(`${e}/`,t):!1)}async function f(a,o,l){let u=[],f=o.map(e=>e.toLowerCase());async function p(o){let m=await e(o);for(let e of m){if(s.has(e))continue;let m=r(o,e),h=await t(m),g=c(i(a,m));if(h.isDirectory()){d(g,l,!0)||await p(m);continue}d(g,l,!1)||f.includes(n(e).toLowerCase())&&u.push(m)}}return await p(a),u.sort((e,t)=>e.localeCompare(t)),u}export{o as DEFAULT_TOOL_EXTENSIONS,u as matchesGlobPattern,f as walkFiles};

package/packages/tools/dist/find-examples.d.ts

@@ -1,25 +1,29 @@
-import type { IEmbedder } from '@kb/embeddings';
-import type { IKnowledgeStore } from '@kb/store';
-export interface FindExamplesOptions {
-    /** Symbol or pattern to find examples of */
-    query: string;
-    /** Max examples to return (default: 5) */
-    limit?: number;
-    /** Filter by content type */
-    contentType?: string;
+import { IEmbedder } from "@kb/embeddings";
+import { IKnowledgeStore } from "@kb/store";
+import { ContentType } from "@kb/core";
+
+//#region packages/tools/src/find-examples.d.ts
+interface FindExamplesOptions {
+  /** Symbol or pattern to find examples of */
+  query: string;
+  /** Max examples to return (default: 5) */
+  limit?: number;
+  /** Filter by content type */
+  contentType?: ContentType;
 }
-export interface Example {
-    path: string;
-    startLine: number;
-    endLine: number;
-    content: string;
-    relevance: number;
-    context: string;
+interface Example {
+  path: string;
+  startLine: number;
+  endLine: number;
+  content: string;
+  relevance: number;
+  context: string;
 }
-export interface FindExamplesResult {
-    query: string;
-    examples: Example[];
-    totalFound: number;
+interface FindExamplesResult {
+  query: string;
+  examples: Example[];
+  totalFound: number;
 }
-export declare function findExamples(embedder: IEmbedder, store: IKnowledgeStore, options: FindExamplesOptions): Promise<FindExamplesResult>;
-//# sourceMappingURL=find-examples.d.ts.map
+declare function findExamples(embedder: IEmbedder, store: IKnowledgeStore, options: FindExamplesOptions): Promise<FindExamplesResult>;
+//#endregion
+export { Example, FindExamplesOptions, FindExamplesResult, findExamples };

package/packages/tools/dist/find-examples.js

@@ -1,3 +1,3 @@
-async function $(s,l,x){const{query:i,limit:r=5,contentType:u}=x,g=`usage example of ${i}`,f=await s.embed(g),h=await l.search(f,{limit:r*3,contentType:u}),c=new RegExp(`\\b${I(i)}\\b`,"i"),a=h.filter(e=>c.test(e.record.content)),E=a.map(e=>{const t=e.record.content,m=/export\s+(?:async\s+)?(?:function|class|const|interface|type)\s/.test(t),y=/^\s*import\s/m.test(t),p=/(?:^|[\\/])(test|tests|__tests__|spec)(?:[\\/]|$)/i.test(e.record.sourcePath)||/\.(test|spec)\.[jt]sx?$/i.test(e.record.sourcePath);let n=0;m||(n+=.1),y||(n+=.05),p&&(n+=.05);const o=t.split(`
-`),d=o.findIndex(F=>c.test(F)),b=Math.max(0,d-2),L=Math.min(o.length,d+5),v=o.slice(b,L).join(`
-`);return{path:e.record.sourcePath,startLine:e.record.startLine,endLine:e.record.endLine,content:v||t.slice(0,300),relevance:Math.min(1,e.score+n),context:p?"test":m?"definition":"usage"}}).sort((e,t)=>t.relevance-e.relevance).slice(0,r);return{query:i,examples:E,totalFound:a.length}}function I(s){return s.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}export{$ as findExamples};
+async function e(e,n,r){let{query:i,limit:a=5,contentType:o}=r,s=`usage example of ${i}`,c=await e.embed(s),l=await n.search(c,{limit:a*3,contentType:o}),u=RegExp(`\\b${t(i)}\\b`,`i`),d=l.filter(e=>u.test(e.record.content));return{query:i,examples:d.map(e=>{let t=e.record.content,n=/export\s+(?:async\s+)?(?:function|class|const|interface|type)\s/.test(t),r=/^\s*import\s/m.test(t),i=/(?:^|[\\/])(test|tests|__tests__|spec)(?:[\\/]|$)/i.test(e.record.sourcePath)||/\.(test|spec)\.[jt]sx?$/i.test(e.record.sourcePath),a=0;n||(a+=.1),r||(a+=.05),i&&(a+=.05);let o=t.split(`
+`),s=o.findIndex(e=>u.test(e)),c=Math.max(0,s-2),l=Math.min(o.length,s+5),d=o.slice(c,l).join(`
+`);return{path:e.record.sourcePath,startLine:e.record.startLine,endLine:e.record.endLine,content:d||t.slice(0,300),relevance:Math.min(1,e.score+a),context:i?`test`:n?`definition`:`usage`}}).sort((e,t)=>t.relevance-e.relevance).slice(0,a),totalFound:d.length}}function t(e){return e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)}export{e as findExamples};