@vpxa/aikit 0.1.58 → 0.1.60

package/packages/tools/dist/replay.js

@@ -1,4 +0,0 @@
-import{readFile as e,writeFile as t}from"node:fs/promises";import{dirname as n,resolve as r}from"node:path";import{appendFileSync as i,mkdirSync as a,readFileSync as o,writeFileSync as s}from"node:fs";import{resolveStateDir as c}from"../../core/dist/index.js";const l=5e3;let u=0;function d(){return r(c(process.cwd()),`replay.jsonl`)}function f(e,t){return e.length<=t?e:`${e.slice(0,t-1)}…`}function p(e){let t=d();a(n(t),{recursive:!0});let r={...e,input:f(e.input,200),output:f(e.output,200)};i(t,`${JSON.stringify(r)}\n`,`utf-8`),u++,u>=100&&(u=0,h().catch(()=>{}))}function m(e={}){let t=d(),n;try{n=o(t,`utf-8`)}catch{return[]}let r=n.trim().split(`
-`).filter(Boolean),i=[];for(let e of r)try{i.push(JSON.parse(e))}catch{}if(e.tool&&(i=i.filter(t=>t.tool===e.tool)),e.source&&(i=i.filter(t=>t.source===e.source)),e.since){let t=e.since;i=i.filter(e=>e.ts>=t)}let a=e.last??20;return i.slice(-a)}async function h(){let n=d(),r;try{r=await e(n,`utf-8`)}catch{return 0}let i=r.trim().split(`
-`).filter(Boolean);if(i.length<=l)return 0;let a=i.length-l;return await t(n,`${i.slice(-l).join(`
-`)}\n`,`utf-8`),a}function g(){let e=d();try{s(e,``,`utf-8`)}catch{}}function _(e,t,n,r){let i=Date.now();return r().then(r=>(p({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 p({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{p as replayAppend,_ as replayCapture,g as replayClear,m as replayList,h as replayTrim};

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

@@ -1,43 +0,0 @@
-//#region packages/tools/src/response-envelope.d.ts
-/**
- * Standardized response envelope for AI Kit tools (E-009).
- * New tools should return KBResponse<T>. Existing tools can adopt gradually.
- */
-interface KBNextHint {
-  tool: string;
-  reason: string;
-  suggested_args?: Record<string, unknown>;
-}
-interface KBError {
-  code: KBErrorCode;
-  category: 'input' | 'runtime' | 'dependency' | 'timeout' | 'not_found';
-  retryable: boolean;
-  message: string;
-  suggestion?: 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[];
-}
-interface KBResponse<T> {
-  ok: boolean;
-  tool: string;
-  summary: string;
-  data?: T;
-  meta: KBResponseMeta;
-  next?: KBNextHint[];
-  error?: KBError;
-}
-/** Create a success response. */
-declare function okResponse<T>(tool: string, summary: string, data: T, meta: Partial<KBResponseMeta> & {
-  durationMs: number;
-}, next?: KBNextHint[]): KBResponse<T>;
-/** Create an error response. */
-declare function errorResponse(tool: string, error: KBError, durationMs: number): KBResponse<never>;
-//#endregion
-export { KBError, KBErrorCode, KBNextHint, KBResponse, KBResponseMeta, errorResponse, okResponse };

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

@@ -1 +0,0 @@
-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};

package/packages/tools/dist/restore-points.d.ts

@@ -1,22 +0,0 @@
-//#region packages/tools/src/restore-points.d.ts
-interface RestorePoint {
-  id: string;
-  timestamp: string;
-  operation: 'codemod' | 'rename' | 'forget';
-  files: Array<{
-    path: string;
-    content: string;
-  }>;
-  description: string;
-}
-/** Create a restore point before a destructive operation */
-declare function createRestorePoint(operation: RestorePoint['operation'], files: Array<{
-  path: string;
-  content: string;
-}>, description: string): string;
-/** List all restore points (newest first) */
-declare function listRestorePoints(): RestorePoint[];
-/** Restore files from a restore point, returns list of restored paths */
-declare function restoreFromPoint(id: string): Promise<string[]>;
-//#endregion
-export { RestorePoint, createRestorePoint, listRestorePoints, restoreFromPoint };

package/packages/tools/dist/restore-points.js

@@ -1 +0,0 @@
-import{writeFile as e}from"node:fs/promises";import{dirname as t,join as n}from"node:path";import{existsSync as r,mkdirSync as i,readFileSync as a,readdirSync as o,unlinkSync as s,writeFileSync as c}from"node:fs";import{AIKIT_PATHS as l}from"../../core/dist/index.js";const u=l.restorePoints;function d(){let e=n(process.cwd(),u);return r(e)||i(e,{recursive:!0}),e}function f(e,t,r){let i=d(),a=`${Date.now()}-${e}`,l={id:a,timestamp:new Date().toISOString(),operation:e,files:t,description:r};c(n(i,`${a}.json`),`${JSON.stringify(l,null,2)}\n`,`utf-8`);let u=o(i).filter(e=>e.endsWith(`.json`)).sort();for(;u.length>50;){let e=u.shift();if(!e)break;try{s(n(i,e))}catch{}}return a}function p(){let e=n(process.cwd(),u);return r(e)?o(e).filter(e=>e.endsWith(`.json`)).sort().reverse().map(t=>{try{return JSON.parse(a(n(e,t),`utf-8`))}catch(r){return console.debug(`Skipping corrupt restore point ${n(e,t)}: ${r instanceof Error?r.message:String(r)}`),null}}).filter(e=>e!==null):[]}async function m(o){let s=n(n(process.cwd(),u),`${o}.json`);if(!r(s))throw Error(`Restore point not found: ${o}`);let c=JSON.parse(a(s,`utf-8`)),l=[];for(let n of c.files){let a=t(n.path);r(a)||i(a,{recursive:!0}),await e(n.path,n.content,`utf-8`),l.push(n.path)}return l}export{f as createRestorePoint,p as listRestorePoints,m as restoreFromPoint};

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

@@ -1,25 +0,0 @@
-//#region packages/tools/src/schema-validate.d.ts
-/**
- * aikit_schema_validate — Validate data against a JSON Schema (core subset).
- *
- * Supports: type, required, properties, additionalProperties, items,
- * enum, const, pattern, minimum, maximum, minLength, maxLength,
- * minItems, maxItems.
- */
-interface SchemaValidateOptions {
-  data: unknown;
-  schema: Record<string, unknown>;
-}
-interface ValidationError {
-  path: string;
-  message: string;
-  expected?: string;
-  received?: string;
-}
-interface SchemaValidateResult {
-  valid: boolean;
-  errors: ValidationError[];
-}
-declare function schemaValidate(options: SchemaValidateOptions): SchemaValidateResult;
-//#endregion
-export { SchemaValidateOptions, SchemaValidateResult, ValidationError, schemaValidate };

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

@@ -1 +0,0 @@
-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))try{new RegExp(i.pattern).test(e)||o.push({path:a,message:`Does not match pattern: ${i.pattern}`})}catch(e){o.push({path:a,message:`Invalid pattern: ${e instanceof Error?e.message:String(e)}`})}if(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};

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

@@ -1,51 +0,0 @@
-import { ContentType, KnowledgeOrigin } from "../../core/dist/index.js";
-import { IEmbedder } from "../../embeddings/dist/index.js";
-import { IKnowledgeStore } from "../../store/dist/index.js";
-
-//#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;
-}
-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 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.
- */
-declare function scopeMap(embedder: IEmbedder, store: IKnowledgeStore, options: ScopeMapOptions): Promise<ScopeMapResult>;
-//#endregion
-export { ScopeMapEntry, ScopeMapOptions, ScopeMapResult, scopeMap };

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

@@ -1 +0,0 @@
-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(`aikit_file_summary({ path: "${e.path}" })  → ~${e.estimatedTokens} tokens`):h.push(`aikit_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};

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

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

package/packages/tools/dist/snippet.js

@@ -1 +0,0 @@
-import{join as e}from"node:path";import{existsSync as t,mkdirSync as n,readFileSync as r,readdirSync as i,renameSync as a,unlinkSync as o,writeFileSync as s}from"node:fs";import{resolveStateDir as c}from"../../core/dist/index.js";const l=()=>e(c(process.cwd()),`snippets`);function u(){let e=l();return t(e)||n(e,{recursive:!0}),e}function d(e){let t=e.replace(/[^a-zA-Z0-9_-]/g,`_`);if(!t)throw Error(`Invalid snippet name`);return t}function f(n){switch(n.action){case`save`:{if(!n.name||!n.code)throw Error(`name and code required for save`);let i=e(u(),`${d(n.name)}.json`),o=null;if(t(i))try{o=JSON.parse(r(i,`utf8`))}catch(e){e?.code!==`ENOENT`&&console.warn(`Corrupt state file ${i}: ${e instanceof Error?e.message:String(e)}`),o=null}let c=new Date().toISOString(),l={name:n.name,language:n.language??`text`,code:n.code,tags:n.tags??[],created:o?.created??c,updated:c},f=`${i}.tmp`;return s(f,JSON.stringify(l,null,2)),a(f,i),l}case`get`:{if(!n.name)throw Error(`name required for get`);let i=e(l(),`${d(n.name)}.json`);if(!t(i))throw Error(`Snippet not found: ${n.name}`);try{return JSON.parse(r(i,`utf8`))}catch(e){throw e?.code!==`ENOENT`&&console.warn(`Corrupt state file ${i}: ${e instanceof Error?e.message:String(e)}`),Error(`Snippet corrupted: ${n.name}`)}}case`list`:{let t=u();return{snippets:i(t).filter(e=>e.endsWith(`.json`)).flatMap(n=>{let i=e(t,n);try{let e=JSON.parse(r(i,`utf8`));return[{name:e.name,language:e.language,tags:e.tags,updated:e.updated}]}catch(e){return e?.code!==`ENOENT`&&console.warn(`Corrupt state file ${i}: ${e instanceof Error?e.message:String(e)}`),[]}})}}case`search`:{if(!n.query)throw Error(`query required for search`);let t=n.query.toLowerCase(),a=u();return{snippets:i(a).filter(e=>e.endsWith(`.json`)).flatMap(t=>{let n=e(a,t);try{return[JSON.parse(r(n,`utf8`))]}catch(e){return e?.code!==`ENOENT`&&console.warn(`Corrupt state file ${n}: ${e instanceof Error?e.message:String(e)}`),[]}}).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(l(),`${d(n.name)}.json`);return t(r)?(o(r),{deleted:!0}):{deleted:!1}}default:throw Error(`Unknown action: ${n.action}`)}}export{f as snippet};

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

@@ -1,14 +0,0 @@
-//#region packages/tools/src/stash.d.ts
-interface StashEntry {
-  key: string;
-  value: unknown;
-  type: string;
-  storedAt: string;
-}
-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 };

package/packages/tools/dist/stash.js

@@ -1 +0,0 @@
-import{dirname as e,resolve as t}from"node:path";import{existsSync as n,mkdirSync as r,readFileSync as i,renameSync as a,writeFileSync as o}from"node:fs";import{resolveStateDir as s}from"../../core/dist/index.js";function c(e){return t(s(e??process.cwd()),`stash.json`)}function l(e){let t=c(e);if(!n(t))return{};try{let e=i(t,`utf-8`);return JSON.parse(e)}catch(e){return e?.code===`ENOENT`||console.warn(`Corrupt state file ${t}: ${e instanceof Error?e.message:String(e)}`),{}}}function u(t,i){let s=c(i),l=e(s);n(l)||r(l,{recursive:!0});let u=`${s}.tmp`;o(u,`${JSON.stringify(t,null,2)}\n`,`utf-8`),a(u,s)}function d(e,t,n){let r=l(n),i={key:e,value:t,type:typeof t,storedAt:new Date().toISOString()};return r[e]=i,u(r,n),i}function f(e,t){return l(t)[e]}function p(e){return Object.values(l(e))}function m(e,t){let n=l(t);return e in n?(delete n[e],u(n,t),!0):!1}function h(e){let t=l(e),n=Object.keys(t).length;return u({},e),n}export{h as stashClear,m as stashDelete,f as stashGet,p as stashList,d as stashSet};

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

@@ -1,30 +0,0 @@
-import { FileCache } from "./file-cache.js";
-import { IEmbedder } from "../../embeddings/dist/index.js";
-
-//#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;
-}
-interface StratumCard {
-  path: string;
-  tier: 'T1' | 'T2';
-  card: string;
-  unknowns: string[];
-  riskTier: 'low' | 'medium' | 'high';
-  tokenEstimate: number;
-  originalTokenEstimate: number;
-}
-interface StratumCardResult {
-  cards: StratumCard[];
-  totalTokenEstimate: number;
-  totalOriginalTokenEstimate: number;
-  compressionRatio: number;
-}
-declare function stratumCard(embedder: IEmbedder, options: StratumCardOptions): Promise<StratumCardResult>;
-//#endregion
-export { StratumCard, StratumCardOptions, StratumCardResult, stratumCard };

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

@@ -1,4 +0,0 @@
-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{c as stratumCard};

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

@@ -1,45 +0,0 @@
-import { IEmbedder } from "../../embeddings/dist/index.js";
-import { IGraphStore, IKnowledgeStore } from "../../store/dist/index.js";
-
-//#region packages/tools/src/symbol.d.ts
-interface SymbolGraphContext {
-  /** Module that defines this symbol */
-  definingModule?: string;
-  /** Modules that import the file containing this symbol */
-  importedByModules: string[];
-  /** Symbols defined in the same module */
-  siblingSymbols: string[];
-}
-interface SymbolInfo {
-  name: string;
-  definedIn?: {
-    path: string;
-    line: number;
-    kind: string;
-    signature?: string;
-  };
-  importedBy: Array<{
-    path: string;
-    line: number;
-    importStatement: string;
-  }>;
-  referencedIn: Array<{
-    path: string;
-    line: number;
-    context: string;
-    scope?: string;
-  }>;
-  /** Graph-derived context (when graph store available) */
-  graphContext?: SymbolGraphContext;
-}
-interface SymbolOptions {
-  /** Symbol name to look up */
-  name: string;
-  /** Limit results */
-  limit?: number;
-  /** Optional graph store for enriching results */
-  graphStore?: IGraphStore;
-}
-declare function symbol(embedder: IEmbedder, store: IKnowledgeStore, options: SymbolOptions): Promise<SymbolInfo>;
-//#endregion
-export { SymbolGraphContext, SymbolInfo, SymbolOptions, symbol };

package/packages/tools/dist/symbol.js

@@ -1,3 +0,0 @@
-import{escapeRegExp as e}from"./regex-utils.js";import{extname as t}from"node:path";import{SUPPORTED_EXTENSIONS as n,WasmRuntime as r,extractSymbols as i,resolveScopes as a}from"../../chunker/dist/index.js";async function o(o,s,c){let{name:l,limit:u=20,graphStore:d}=c,f=o.embedQuery?.bind(o)??o.embed.bind(o),p=[`export function ${l}`,`export class ${l}`,`export const ${l}`,`export interface ${l}`,`export type ${l}`,`export enum ${l}`].join(` | `),m=await s.search(await f(p),{limit:u*2}),h=RegExp(`^export\\s+(?:default\\s+)?(?:async\\s+)?(?:function|class|const|let|interface|type|enum)\\s+${e(l)}\\b`,`m`),g;for(let e of m){if(!h.test(e.record.content))continue;let a=e.record.content.match(/export\s+(?:default\s+)?(?:async\s+)?(\w+)/)?.[1]??`unknown`;g={path:e.record.sourcePath,line:e.record.startLine,kind:a};let o=t(e.record.sourcePath);if(r.get()&&n.has(o))try{let t=(await i(e.record.content,o,e.record.sourcePath)).find(e=>e.name===l&&e.exported);t&&(g.kind=t.kind,t.signature&&(g.signature=t.signature))}catch{}break}let _=RegExp(`import\\s+.*\\b${e(l)}\\b.*from\\s+`,`m`),v=await s.search(await f(`import ${l} from`),{limit:u*3}),y=[],b=new Set;for(let e of v){let t=e.record.content.split(`
-`);for(let n=0;n<t.length;n++){let r=t[n];if(!_.test(r))continue;let i=`${e.record.sourcePath}:${r.trim()}`;b.has(i)||(b.add(i),y.push({path:e.record.sourcePath,line:e.record.startLine+n,importStatement:r.trim()}))}}let x=RegExp(`\\b${e(l)}\\b`),S=await s.search(await f(l),{limit:u*3}),C=[],w=new Set;for(let e of S){if(C.length>=u)break;if(g&&e.record.sourcePath===g.path)continue;let i=e.record.content.split(`
-`);for(let o=0;o<i.length;o++){let s=i[o];if(!x.test(s)||_.test(s))continue;let c=`${e.record.sourcePath}:${e.record.startLine+o}`;if(w.has(c))continue;w.add(c);let l,u=t(e.record.sourcePath);if(r.get()&&n.has(u))try{let t=await a(e.record.content,u,o+1);t.length>0&&(l=t[0].name)}catch{}C.push({path:e.record.sourcePath,line:e.record.startLine+o,context:s.trim().slice(0,120),scope:l});break}}let T;if(d)try{let e={importedByModules:[],siblingSymbols:[]},t=await d.findNodes({namePattern:l});if(t.length>0){let n=t[0];if(n.sourcePath?e.definingModule=n.sourcePath:g&&(e.definingModule=g.path),n.sourcePath){let t=(await d.findNodes({sourcePath:n.sourcePath,type:`module`}))[0];if(t){let n=await d.getNeighbors(t.id,{direction:`incoming`,edgeType:`imports`});for(let t of n.nodes)e.importedByModules.push(t.sourcePath??t.name)}}if(e.definingModule){let t=await d.findNodes({sourcePath:e.definingModule});for(let n of t)n.name!==l&&n.type!==`module`&&e.siblingSymbols.push(`${n.type}:${n.name}`);e.siblingSymbols=e.siblingSymbols.slice(0,15)}}(e.definingModule||e.importedByModules.length>0||e.siblingSymbols.length>0)&&(T=e)}catch{}return{name:l,definedIn:g,importedBy:y.slice(0,u),referencedIn:C.slice(0,u),graphContext:T}}export{o as symbol};

package/packages/tools/dist/synthesis-engine.d.ts

@@ -1,13 +0,0 @@
-import { OnboardMode, OnboardStepResult } from "./onboard.js";
-
-//#region packages/tools/src/synthesis-engine.d.ts
-declare function buildSynthesisGuide(steps: OnboardStepResult[], mode: OnboardMode, projectName: string, dataMap: Map<string, Record<string, unknown>>): string;
-/**
- * Build a compact code-map.md showing module relationships with call edges.
- * Uses TypeScript compiler API call graph when available, falls back to
- * import-based dependency graph for non-TS projects.
- * Designed to be LLM-consumable (~10-50KB).
- */
-declare function buildCodeMap(dataMap: Map<string, Record<string, unknown>>, projectName: string, callGraph: Map<string, Map<string, string[]>> | null): string;
-//#endregion
-export { buildCodeMap, buildSynthesisGuide };

package/packages/tools/dist/synthesis-engine.js

@@ -1,6 +0,0 @@
-import{getPackageKey as e,isTestPath as t,resolveExtensionlessPath as n}from"./onboard-utils.js";const r={structure:`Project Structure`,dependencies:`Dependencies`,"entry-points":`Entry Points`,symbols:`Symbols`,patterns:`Patterns`,diagram:`C4 Container Diagram`,"code-map":`Code Map (Module Graph)`,"config-values":`Configuration Values`,"synthesis-guide":`Synthesis Guide`};function i(e,t,n,i){let a=[`Analysis baselines for **${n}** have been generated.`];t===`generate`?a.push("Individual results are in the sibling `.md` and `.json` files in this directory.",``):a.push(`Results are stored in the AI Kit vector store.`,``);let o=i.get(`symbols`),s=i.get(`dependencies`),c=i.get(`patterns`),l=i.get(`entry-points`),u=o?.totalCount??0,d=o?.exportedCount??0,f=s?.totalImports??0,p=l?.total??0,m=(c?.patterns??[]).map(e=>e.pattern),h=m.some(e=>e.startsWith(`Spring`)),g=m.includes(`AWS CDK`)||m.includes(`CDK IaC`),_=m.includes(`Maven`),v=m.includes(`Serverless`)||p>3,y=s?.external?Object.keys(s.external):[],b=y.some(e=>[`express`,`fastify`,`next`,`react`,`vitest`,`jest`].includes(e))||f>0,x=y.some(e=>[`turbo`,`lerna`,`nx`].includes(e))||m.includes(`Monorepo`);if(a.push(`### Project Profile`,``),a.push(`- **${u} symbols** (${d} exported), **${f} imports**, **${p} entry ${p===1?`point`:`points`}**`),m.length>0&&a.push(`- **Detected**: ${m.slice(0,8).join(`, `)}`),a.push(``),u===0&&f===0&&p===0)return a.push(`> **Note:** This project appears to be empty or contains no analyzable source code.`,`> Run onboard again after adding source files.`),a.join(`
-`);let S=e.filter(e=>e.status===`success`),C=e.filter(e=>e.status===`failed`);a.push(`### Completed Analyses`,``);for(let e of S){let n=r[e.name]??e.name,i=e.output.length>1e3?`${Math.round(e.output.length/1024)}KB`:`${e.output.length}B`;t===`generate`?a.push(`- ✓ [${n}](./${e.name}.md) (${i})`):a.push(`- ✓ ${n} (${i})`)}if(C.length>0){a.push(``,`### Failed Analyses`,``);for(let e of C)a.push(`- ✗ ${e.name}: ${e.error}`)}a.push(``,`### Recommended Reading Order`,``,"1. **Start with** `synthesis-guide.md` (this file) → `entry-points.md` → `patterns.md`","2. **Module graph** via `code-map.md` — cross-package call edges with function names","3. **Architecture** via `diagram.md` (C4 Container) → `dependencies.md`","4. **Browse structure** via `structure.md` for file layout","5. **API surface** via `symbols.md` — file paths + exported symbols (capped at 80KB)","6. **Reference**: `config-values.md` (config reference)",``,`> **Size guidance:** Total output is ~`);let w=S.reduce((e,t)=>e+t.output.length,0)/1024;return a[a.length-1]+=`${Math.round(w)}KB. Focus on code-map.md + entry-points.md + diagram.md (~${Math.round((S.find(e=>e.name===`code-map`)?.output.length??0)/1024+(S.find(e=>e.name===`entry-points`)?.output.length??0)/1024+(S.find(e=>e.name===`diagram`)?.output.length??0)/1024)}KB) for maximum signal-to-token ratio.`,a.push(``,`### Synthesize Knowledge`,``,"Produce the following `aikit_remember` entries:",``),a.push("1. **Architecture Summary** (category: `architecture`)"),x?(a.push(`   - Package boundaries, dependency graph between packages`),a.push(`   - Shared vs service-specific code`)):v?(a.push(`   - Lambda functions, triggers, event flow`),a.push(`   - Infrastructure patterns (queues, tables, APIs)`)):h?(a.push(`   - Controller → Service → Repository layers`),a.push(`   - Spring configuration and profiles`)):(a.push(`   - Layer structure, dependency flow`),a.push(`   - Key design decisions`)),a.push(``),a.push("2. **Domain Model** (category: `architecture`)"),a.push(`   - Key entities/types and their relationships`),a.push(`   - Data flow from entry points through processing`),a.push(``),a.push("3. **Conventions** (category: `conventions`)"),a.push(`   - Naming patterns, file organization, testing approach`),g&&a.push(`   - CDK construct patterns and stack organization`),b&&a.push(`   - Build tooling, package manager, module system`),_&&a.push(`   - Maven module structure, dependency management`),a.push(``,`### Using AI Kit Tools`,``,`This project has an AI Kit MCP server with tools for search, analysis, memory, and more.`,"`aikit init` has already created `.github/copilot-instructions.md` and `AGENTS.md` with the complete tool reference.","If not, run `npx @vpxa/aikit init` to generate them.",``,`**Workflow pattern — use on every task:**`,``,"```",`aikit_search({ query: "your task keywords" })            # Recall prior decisions`,`aikit_scope_map({ task: "what you are doing" })           # Get a reading plan`,`# ... do the work ...`,`aikit_check({})                                           # Typecheck + lint`,`aikit_test_run({})                                        # Run tests`,`aikit_remember({ title: "What I learned", category: "decisions" })  # Persist`,"```"),a.join(`
-`)}function a(r,i,a){let o=r.get(`dependencies`),s=r.get(`symbols`),c=r.get(`entry-points`),l=[`## Code Map: ${i}\n`];if(!o&&!s)return l.push(`No dependency or symbol data available.`),l.join(`
-`);let u=o?.reverseGraph??{},d=s?.symbols??[],f=c?.entryPoints??[],p=new Map;for(let e of d){if(!e.exported)continue;let n=e.filePath.replace(/\\/g,`/`);if(t(n))continue;let r=p.get(n);r?r.push({name:e.name,kind:e.kind}):p.set(n,[{name:e.name,kind:e.kind}])}let m=new Map;for(let[e,r]of Object.entries(u)){let i=n(e.replace(/\\/g,`/`),p),a=r.map(e=>e.replace(/\\/g,`/`)).filter(e=>!t(e));if(a.length===0)continue;let o=m.get(i);if(o)for(let e of a)o.add(e);else m.set(i,new Set(a))}let h=new Map;for(let e of f)h.set(e.filePath.replace(/\\/g,`/`),{name:e.name,trigger:e.trigger});let g=new Map,_=new Map;if(a)for(let[n,r]of a){if(t(n))continue;let i=e(n);for(let[a,o]of r){if(t(a)||i===e(a))continue;let r=g.get(n);r||(r=new Map,g.set(n,r)),r.set(a,o);let s=_.get(a),c={file:n,symbols:o};s?s.push(c):_.set(a,[c])}}let v=new Set;for(let e of h.keys())v.add(e);for(let e of g.keys())v.add(e);for(let e of _.keys())v.add(e);if(!a)for(let e of p.keys()){let t=m.get(e);t&&t.size>=3&&v.add(e)}let y=new Map;for(let t of v){let n=e(t),r=y.get(n);r?r.push(t):y.set(n,[t])}let b=[...y.entries()].sort((e,t)=>e[0].localeCompare(t[0])),x=a?`AST call graph`:`import analysis`,S=a?`, ${g.size} cross-package callers`:``;l.push(`**${v.size} key modules** (${x}${S})\n`),l.push(`**Legend:** ⚡ Entry point | 📤 Exports | → Calls (outgoing) | ← Called by (incoming) | ➡ Used by (import)
-`);for(let[e,n]of b){n.sort(),l.push(`### ${e}/\n`);for(let r of n){let n=p.get(r),i=h.get(r),o=g.get(r),s=_.get(r),c=m.get(r),u=r.startsWith(`${e}/`)?r.slice(e.length+1):r;if(l.push(`**${u}**`),i&&l.push(`  ⚡ Entry: \`${i.name}\`${i.trigger?` (${i.trigger})`:``}`),n&&n.length>0){let e=n.slice(0,8).map(e=>`${e.name}`).join(`, `),t=n.length>8?` (+${n.length-8})`:``;l.push(`  📤 ${e}${t}`)}if(o&&o.size>0){let t=[...o.entries()].sort((e,t)=>t[1].length-e[1].length);for(let[n,r]of t.slice(0,4)){let t=n.startsWith(`${e}/`)?n.slice(e.length+1):n;l.push(`  → ${t}: ${r.slice(0,5).join(`, `)}${r.length>5?`…`:``}`)}t.length>4&&l.push(`  → +${t.length-4} more targets`)}if(s&&s.length>0){for(let t of s.slice(0,4)){let n=t.file.startsWith(`${e}/`)?t.file.slice(e.length+1):t.file;l.push(`  ← ${n}: ${t.symbols.slice(0,4).join(`, `)}${t.symbols.length>4?`…`:``}`)}s.length>4&&l.push(`  ← +${s.length-4} more callers`)}else if(!a&&c&&c.size>0){let e=[...c].filter(e=>!t(e));e.length<=3?l.push(`  ➡ Used by: ${e.join(`, `)}`):l.push(`  ➡ Used by: ${e.slice(0,3).join(`, `)} (+${e.length-3} more)`)}l.push(``)}}return l.join(`
-`)}export{a as buildCodeMap,i as buildSynthesisGuide};

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

@@ -1,28 +0,0 @@
-import { ParsedTestSummary } from "./parse-output.js";
-
-//#region packages/tools/src/test-run.d.ts
-interface TestRunOptions {
-  files?: string[];
-  cwd?: string;
-  timeout?: number;
-  grep?: string;
-  /** Include full raw output in result (default: false to save tokens) */
-  includeRaw?: boolean;
-}
-interface TestRunResult {
-  summary: ParsedTestSummary;
-  passed: boolean;
-  raw?: string;
-  durationMs: number;
-}
-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").
- */
-declare function classifyExitCode(exitCode: number, _stdout: string, command?: string): {
-  isError: boolean;
-  reason?: string;
-};
-//#endregion
-export { TestRunOptions, TestRunResult, classifyExitCode, testRun };

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

@@ -1,2 +0,0 @@
-import{parseVitest as e}from"./parse-output.js";import{exec 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`,`--no-color`];t.files?.length&&o.push(...t.files),t.grep&&o.push(`--testNamePattern`,t.grep);try{let{stdout:s}=await r(`npx ${o.join(` `)}`,{cwd:n,timeout:i}),c=s.toString(),l=e(c);return{summary:l,passed:l.failed===0,...t.includeRaw&&{raw:c},durationMs:Date.now()-a}}catch(n){let r=s(n);return{summary:e(r),passed:!1,...t.includeRaw&&{raw:r},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};

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

@@ -1,24 +0,0 @@
-//#region packages/tools/src/text-utils.d.ts
-/**
- * Shared text utilities used by compact, digest, stratum-card, and other tools.
- */
-/**
- * Approximate token count from character count (~4 chars/token).
- */
-declare function estimateTokens(text: string): number;
-/**
- * Segment text into chunks for scoring.
- */
-declare function segment(text: string, strategy: 'paragraph' | 'sentence' | 'line'): string[];
-/**
- * Cosine similarity between two vectors.
- */
-declare function cosineSimilarity(a: Float32Array, b: Float32Array): number;
-/**
- * Reorder items using "bookend" strategy (Liu et al. 2023 "Lost in the Middle").
- * Highest-scoring items placed at start and end positions for better LLM attention.
- * Input must already be sorted by score descending.
- */
-declare function bookendReorder<T>(items: T[]): T[];
-//#endregion
-export { bookendReorder, cosineSimilarity, estimateTokens, segment };

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

@@ -1,2 +0,0 @@
-function e(e){return Math.ceil(e.length/4)}function t(e,t){switch(t){case`paragraph`:return e.split(/\n\s*\n/).map(e=>e.trim()).filter(e=>e.length>0);case`sentence`:return e.split(/(?<=[.!?])\s+/).map(e=>e.trim()).filter(e=>e.length>0);case`line`:return e.split(`
-`).map(e=>e.trim()).filter(e=>e.length>0)}}function n(e,t){let n=0,r=0,i=0;for(let a=0;a<e.length;a++)n+=e[a]*t[a],r+=e[a]*e[a],i+=t[a]*t[a];let a=Math.sqrt(r)*Math.sqrt(i);return a===0?0:n/a}function r(e){if(e.length<=2)return e;let t=Array(e.length),n=0,r=e.length-1;for(let i=0;i<e.length;i++)i%2==0?t[n++]=e[i]:t[r--]=e[i];return t}export{r as bookendReorder,n as cosineSimilarity,e as estimateTokens,t as segment};

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

@@ -1,20 +0,0 @@
-//#region packages/tools/src/time-utils.d.ts
-/**
- * aikit_time — Timezone conversion, date parsing, duration calculation.
- */
-type TimeOperation = 'now' | 'parse' | 'convert' | 'diff' | 'add';
-interface TimeOptions {
-  operation: TimeOperation;
-  input?: string;
-  timezone?: string;
-  duration?: string;
-}
-interface TimeResult {
-  output: string;
-  iso: string;
-  unix: number;
-  details?: Record<string, string | number>;
-}
-declare function timeUtils(options: TimeOptions): TimeResult;
-//#endregion
-export { TimeOperation, TimeOptions, TimeResult, timeUtils };

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

@@ -1 +0,0 @@
-function e(e){let{operation:a,input:o,timezone:s}=e;switch(a){case`now`:return n(new Date,s);case`parse`:if(!o)throw Error(`input required for parse`);return n(t(o),s);case`convert`:if(!o)throw Error(`input required for convert`);if(!s)throw Error(`timezone required for convert`);return n(t(o),s);case`diff`:{if(!o)throw Error(`input required for diff (two comma-separated dates)`);let e=o.split(`,`).map(e=>e.trim());if(e.length<2)throw Error(`diff requires two comma-separated dates`);let n=t(e[0]),i=t(e[1]),a=Math.abs(i.getTime()-n.getTime());return{output:r(a),iso:`PT${Math.floor(a/1e3)}S`,unix:a,details:{milliseconds:a,seconds:Math.floor(a/1e3),minutes:Math.floor(a/6e4),hours:Math.floor(a/36e5),days:Math.floor(a/864e5)}}}case`add`:{if(!o)throw Error(`input required for add`);let{duration:r}=e;if(!r)throw Error(`duration required for add (e.g., "2h30m")`);let a=t(o),c=i(r);return n(new Date(a.getTime()+c),s)}default:throw Error(`Unknown operation: ${a}`)}}function t(e){let t=Number(e);if(!Number.isNaN(t))return new Date(t>0xe8d4a51000?t:t*1e3);let n=new Date(e);if(Number.isNaN(n.getTime()))throw Error(`Cannot parse date: ${e}`);return n}function n(e,t){let n=t??`UTC`,r=e.toLocaleString(`en-US`,{timeZone:n,dateStyle:`full`,timeStyle:`long`}),i=new Intl.DateTimeFormat(`en-US`,{timeZone:n,year:`numeric`,month:`numeric`,day:`numeric`,hour:`numeric`,minute:`numeric`,second:`numeric`,hour12:!1}).formatToParts(e).reduce((e,t)=>(t.type!==`literal`&&(e[t.type]=Number.parseInt(t.value,10)),e),{});return{output:r,iso:e.toISOString(),unix:Math.floor(e.getTime()/1e3),details:{timezone:n,year:i.year,month:i.month,day:i.day,hour:i.hour===24?0:i.hour,minute:i.minute,second:i.second}}}function r(e){let t=[],n=Math.floor(e/864e5);n&&t.push(`${n}d`);let r=Math.floor(e%864e5/36e5);r&&t.push(`${r}h`);let i=Math.floor(e%36e5/6e4);i&&t.push(`${i}m`);let a=Math.floor(e%6e4/1e3);return(a||t.length===0)&&t.push(`${a}s`),t.join(` `)}function i(e){let t=0,n=e.matchAll(/(\d+)\s*(d|h|m|s|ms)/gi);for(let e of n){let n=Number(e[1]);switch(e[2].toLowerCase()){case`d`:t+=n*864e5;break;case`h`:t+=n*36e5;break;case`m`:t+=n*6e4;break;case`s`:t+=n*1e3;break;case`ms`:t+=n;break}}if(t===0)throw Error(`Cannot parse duration: ${e}`);return t}export{e as timeUtils};

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

@@ -1,43 +0,0 @@
-import { IEmbedder } from "../../embeddings/dist/index.js";
-import { IGraphStore, IKnowledgeStore } from "../../store/dist/index.js";
-
-//#region packages/tools/src/trace.d.ts
-interface TraceOptions {
-  /** Starting point — a symbol or file:line reference */
-  start: string;
-  /** Direction */
-  direction: 'forward' | 'backward' | 'both';
-  /** Max depth (default: 3) */
-  maxDepth?: number;
-  /** Optional graph store for enriching results */
-  graphStore?: IGraphStore;
-}
-interface TraceGraphContext {
-  /** Module that defines the traced symbol */
-  definingModule?: string;
-  /** Community/cluster of the traced symbol */
-  community?: string;
-  /** Modules that import the file containing this symbol */
-  importedByModules: string[];
-  /** Symbols defined in the same module */
-  siblingSymbols: string[];
-}
-interface TraceNode {
-  path: string;
-  symbol: string;
-  line: number;
-  relationship: 'calls' | 'called-by' | 'imports' | 'imported-by' | 'references';
-  /** The enclosing function/scope where the relationship occurs (AST-powered) */
-  scope?: string;
-}
-interface TraceResult {
-  start: string;
-  direction: string;
-  nodes: TraceNode[];
-  depth: number;
-  /** Graph-derived context (when graph store available) */
-  graphContext?: TraceGraphContext;
-}
-declare function trace(embedder: IEmbedder, store: IKnowledgeStore, options: TraceOptions): Promise<TraceResult>;
-//#endregion
-export { TraceGraphContext, TraceNode, TraceOptions, TraceResult, trace };

package/packages/tools/dist/trace.js

@@ -1,2 +0,0 @@
-import{escapeRegExp as e}from"./regex-utils.js";import{readFile as t}from"node:fs/promises";import{extname as n}from"node:path";import{SUPPORTED_EXTENSIONS as r,WasmRuntime as i,extractCalls as a}from"../../chunker/dist/index.js";async function o(t,n,r){let{start:a,direction:o,maxDepth:f=3,graphStore:p}=r,m=[],h=new Set,g=new Set,_=!!i.get(),v=new Map,y=await t.embed(a);if((await n.search(y,{limit:10})).length===0)return{start:a,direction:o,nodes:m,depth:0};let b=[{target:a,depth:0}],x=0;for(;b.length>0;){let r=b.shift();if(!r)break;if(r.depth>=f||h.has(r.target))continue;h.add(r.target);let i=await t.embed(r.target),a=await n.search(i,{limit:20}),s=e(r.target),d=u(r.target);for(let e of a){let t=e.record.sourcePath,n=e.record.content.split(`
-`);if(_&&!d){let e=await c(v,t);for(let n of e)o!==`backward`&&n.callerName===r.target&&(l(g,m,{path:t,symbol:n.calleeName,line:n.line,relationship:`calls`,scope:n.callerName}),x=Math.max(x,r.depth+1),b.push({target:n.calleeName,depth:r.depth+1})),o!==`forward`&&n.calleeName===r.target&&(l(g,m,{path:t,symbol:n.callerName,line:n.line,relationship:`called-by`,scope:n.callerName}),x=Math.max(x,r.depth+1),b.push({target:n.callerName,depth:r.depth+1}))}for(let i=0;i<n.length;i+=1){let a=n[i],c=e.record.startLine+i;if(o!==`forward`&&RegExp(d?`from\\s+['"]${s}['"]`:`import\\s+.*\\b${s}\\b.*from\\s+`).test(a)){l(g,m,{path:t,symbol:r.target,line:c,relationship:`imported-by`}),x=Math.max(x,r.depth+1);let e=a.match(/from\s+['"]([^'"]+)['"]/);!d&&e&&b.push({target:e[1],depth:r.depth+1})}o!==`backward`&&(d?RegExp(`from\\s+['"]${s}['"]`).test(a)&&(l(g,m,{path:t,symbol:r.target,line:c,relationship:`imports`}),x=Math.max(x,r.depth+1)):_||RegExp(`\\b${s}\\s*\\(`).test(a)&&!/^\s*(?:export\s+)?(?:async\s+)?function\s/.test(a)&&(l(g,m,{path:t,symbol:r.target,line:c,relationship:`calls`}),x=Math.max(x,r.depth+1))),RegExp(d?`['"]${s}['"]`:`\\b${s}\\b`).test(a)&&!/^\s*import\s/.test(a)&&!/^\s*(?:export\s+)?(?:async\s+)?function\s/.test(a)&&(l(g,m,{path:t,symbol:r.target,line:c,relationship:`references`}),x=Math.max(x,r.depth+1))}}}let S=p?await s(a,p):void 0;return{start:a,direction:o,nodes:d(m),depth:x,graphContext:S}}async function s(e,t){try{let n=await t.findNodes({namePattern:e,limit:10}),r=n.find(t=>t.name===e&&t.type!==`module`)??n.find(t=>t.name===e)??n[0];if(!r)return;let i={definingModule:r.sourcePath,community:r.community,importedByModules:[],siblingSymbols:[]};try{let e=await t.getSymbol360(r.id);i.community=e.community??i.community,i.definingModule=e.node.sourcePath??i.definingModule}catch{}if(r.sourcePath){let[e]=await t.findNodes({sourcePath:r.sourcePath,type:`module`});e&&(i.importedByModules=f((await t.getNeighbors(e.id,{direction:`incoming`,edgeType:`imports`})).nodes.map(e=>e.sourcePath??e.name)))}return i.definingModule&&(i.siblingSymbols=f((await t.findNodes({sourcePath:i.definingModule,limit:50})).filter(e=>e.name!==r.name&&e.type!==`module`).map(e=>`${e.type}:${e.name}`)).slice(0,15)),i.definingModule||i.community||i.importedByModules.length>0||i.siblingSymbols.length>0?i:void 0}catch{return}}async function c(e,i){let o=e.get(i);if(o)return o;let s=n(i);if(!r.has(s))return e.set(i,[]),[];try{let n=await a(await t(i,`utf-8`),s,i);return e.set(i,n),n}catch{return e.set(i,[]),[]}}function l(e,t,n){let r=`${n.path}:${n.line}:${n.relationship}`;e.has(r)||(e.add(r),t.push(n))}function u(e){return/[./\\]/.test(e)}function d(e){let t=new Set;return e.filter(e=>{let n=`${e.path}:${e.line}:${e.relationship}`;return t.has(n)?!1:(t.add(n),!0)})}function f(e){return[...new Set(e.filter(e=>e.length>0))]}export{o as trace};

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

@@ -1,66 +0,0 @@
-//#region packages/tools/src/truncation.d.ts
-/**
- * Smart truncation utilities.
- *
- * Head/tail split: preserves both the beginning (context/setup) and
- * end (errors/results/stack traces) of content. Snaps to line boundaries.
- */
-/** Metadata about truncation for transparency */
-interface TruncationMeta {
-  /** Whether the text was actually truncated */
-  truncated: boolean;
-  /** Original character count before truncation */
-  originalChars: number;
-  /** Character count after truncation */
-  truncatedChars: number;
-  /** Number of lines/paragraphs omitted */
-  omittedCount: number;
-  /** Type of truncation applied */
-  strategy: 'head-tail' | 'paragraph' | 'token-budget' | 'none';
-}
-/** Result of a truncation operation with metadata */
-interface TruncationResult {
-  /** The truncated text */
-  text: string;
-  /** Truncation metadata for transparency */
-  _meta: TruncationMeta;
-}
-/**
- * Truncate text keeping both head and tail portions.
- * Critical for process output where errors appear at the end.
- *
- * @param text    - Full text to truncate
- * @param maxLen  - Maximum character length
- * @param headRatio - Fraction for head portion (default 0.6)
- * @returns Truncated text with separator showing omitted line/char count
- */
-declare function headTailTruncate(text: string, maxLen: number, headRatio?: number): string;
-/**
- * Truncate at a paragraph boundary near maxLength (head-only).
- * Best for web content and markdown where structure is at the top.
- */
-declare function paragraphTruncate(text: string, maxLen: number): string;
-/**
- * Truncate text to fit within a token budget.
- * Uses ~4 chars/token approximation. Snaps to line boundaries.
- *
- * @param text - Full text to truncate
- * @param maxTokens - Maximum token count
- * @returns Original text if within budget, or truncated with notice
- */
-declare function truncateToTokenBudget(text: string, maxTokens: number): string;
-/**
- * Head-tail truncation with metadata.
- * Same as headTailTruncate but returns a TruncationResult with _meta.
- */
-declare function headTailTruncateWithMeta(text: string, maxLen: number, headRatio?: number): TruncationResult;
-/**
- * Paragraph truncation with metadata.
- */
-declare function paragraphTruncateWithMeta(text: string, maxLen: number): TruncationResult;
-/**
- * Token-budget truncation with metadata.
- */
-declare function truncateToTokenBudgetWithMeta(text: string, maxTokens: number): TruncationResult;
-//#endregion
-export { TruncationMeta, TruncationResult, headTailTruncate, headTailTruncateWithMeta, paragraphTruncate, paragraphTruncateWithMeta, truncateToTokenBudget, truncateToTokenBudgetWithMeta };

package/packages/tools/dist/truncation.js

@@ -1,11 +0,0 @@
-import{estimateTokens as e}from"./text-utils.js";const t=.6;function n(e,n,r=t){if(e.length<=n)return e;let i=Math.max(0,n-120),a=Math.floor(i*r),o=i-a,s=e.slice(0,a),c=s.lastIndexOf(`
-`),l=c>0?s.slice(0,c):s,u=e.length-o,d=e.slice(u),f=d.indexOf(`
-`),p=f>=0?d.slice(f+1):d,m=e.length-l.length-p.length,h=1,g=l.length,_=e.length-p.length;for(let t=g;t<_;t++)e.charCodeAt(t)===10&&h++;return`${l}\n\n[… ${h} lines / ${(m/1024).toFixed(1)}KB truncated — showing first ${l.split(`
-`).length} + last ${p.split(`
-`).length} lines]\n\n${p}`}function r(e,t){if(e.length<=t)return e;let n=Math.max(0,t-200),r=e.slice(n,t).lastIndexOf(`
-
-`),i=r>=0?n+r:t,a=e.slice(0,i).trimEnd(),o=Math.round(i/e.length*100);return`${a}\n\n---\n*[Truncated at ${i.toLocaleString()} chars — ${o}% of original content]*`}function i(e,t){let r=t*4;return e.length<=r?e:n(e,r)}function a(e,r,i=t){if(e.length<=r)return{text:e,_meta:{truncated:!1,originalChars:e.length,truncatedChars:e.length,omittedCount:0,strategy:`none`}};let a=Math.max(0,r-120),o=Math.floor(a*i),s=a-o,c=e.slice(0,o),l=c.lastIndexOf(`
-`),u=l>0?c.slice(0,l):c,d=e.length-s,f=e.slice(d),p=f.indexOf(`
-`),m=p>=0?f.slice(p+1):f,h=1,g=u.length,_=e.length-m.length;for(let t=g;t<_;t++)e.charCodeAt(t)===10&&h++;let v=n(e,r,i);return{text:v,_meta:{truncated:!0,originalChars:e.length,truncatedChars:v.length,omittedCount:h,strategy:`head-tail`}}}function o(e,t){if(e.length<=t)return{text:e,_meta:{truncated:!1,originalChars:e.length,truncatedChars:e.length,omittedCount:0,strategy:`none`}};let n=Math.max(0,t-200),i=e.slice(n,t).lastIndexOf(`
-
-`),a=i>=0?n+i:t,o=e.split(/\n\s*\n/),s=e.slice(0,a).trimEnd(),c=s.length===0?0:s.split(/\n\s*\n/).length,l=r(e,t);return{text:l,_meta:{truncated:!0,originalChars:e.length,truncatedChars:l.length,omittedCount:Math.max(0,o.length-c),strategy:`paragraph`}}}function s(t,n){if(e(t)<=n)return{text:t,_meta:{truncated:!1,originalChars:t.length,truncatedChars:t.length,omittedCount:0,strategy:`none`}};let r=a(t,n*4);return{text:r.text,_meta:{...r._meta,strategy:`token-budget`}}}export{n as headTailTruncate,a as headTailTruncateWithMeta,r as paragraphTruncate,o as paragraphTruncateWithMeta,i as truncateToTokenBudget,s as truncateToTokenBudgetWithMeta};