@vpxa/aikit 0.1.59 → 0.1.60

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

@@ -1,92 +0,0 @@
-//#region packages/tools/src/evidence-map.d.ts
-/**
- * aikit_evidence_map — FORGE Evidence Map CRUD + Gate evaluator.
- *
- * Structured storage, validation, and gate evaluation for FORGE Evidence Map entries.
- * Persisted in .aikit-state/evidence-maps.json.
- */
-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';
-type SafetyGate = 'provenance' | 'commitment' | 'coverage';
-interface EvidenceEntry {
-  id: number;
-  claim: string;
-  status: EvidenceStatus;
-  receipt: string;
-  criticalPath: boolean;
-  unknownType?: UnknownType;
-  safetyGate?: SafetyGate;
-}
-interface EvidenceMapState {
-  taskId: string;
-  tier: ForgeTier;
-  entries: EvidenceEntry[];
-  createdAt: string;
-  updatedAt: string;
-}
-interface SafetyGateResult {
-  provenance: 'pass' | 'fail';
-  commitment: 'pass' | 'fail';
-  coverage: 'pass' | 'fail';
-  failures: string[];
-}
-interface GateResult {
-  decision: GateDecision;
-  reason: string;
-  unresolvedCritical: EvidenceEntry[];
-  warnings: string[];
-  stats: {
-    total: number;
-    verified: number;
-    assumed: number;
-    unresolved: number;
-  };
-  safetyGates?: SafetyGateResult;
-  annotation?: string;
-}
-type EvidenceMapAction = {
-  action: 'create';
-  taskId: string;
-  tier: ForgeTier;
-} | {
-  action: 'add';
-  taskId: string;
-  claim: string;
-  status: EvidenceStatus;
-  receipt: string;
-  criticalPath?: boolean;
-  unknownType?: UnknownType;
-  safetyGate?: SafetyGate;
-} | {
-  action: 'update';
-  taskId: string;
-  id: number;
-  status: EvidenceStatus;
-  receipt: string;
-} | {
-  action: 'get';
-  taskId: string;
-} | {
-  action: 'gate';
-  taskId: string;
-  retryCount?: number;
-} | {
-  action: 'list';
-} | {
-  action: 'delete';
-  taskId: string;
-};
-interface EvidenceMapResult {
-  state?: EvidenceMapState;
-  states?: EvidenceMapState[];
-  entry?: EvidenceEntry;
-  gate?: GateResult;
-  deleted?: boolean;
-  formattedMap?: string;
-}
-declare function evidenceMap(action: EvidenceMapAction, cwd?: string): EvidenceMapResult;
-declare function autoClaimTestFailures(taskId: string, failures: string[], cwd?: string): EvidenceEntry[];
-//#endregion
-export { EvidenceEntry, EvidenceMapAction, EvidenceMapResult, EvidenceMapState, EvidenceStatus, ForgeTier, GateDecision, GateResult, SafetyGate, SafetyGateResult, UnknownType, autoClaimTestFailures, evidenceMap };

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

@@ -1,2 +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()),`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(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){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 | Safety |`,`|---|-------|--------|---------|----------|------|--------|`];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)} | ${m(n.safetyGate)} |`);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){let t=[],n=e.entries.filter(e=>e.status===`V`&&!e.receipt.trim());n.length>0&&t.push(`Provenance: ${n.length} verified claim(s) lack receipts`);let r=e.entries.filter(e=>e.safetyGate===`commitment`&&e.status!==`V`);r.length>0&&t.push(`Commitment: ${r.length} commitment(s) not verified`);let i=e.entries.some(e=>e.safetyGate===`coverage`&&e.status===`U`);return i&&t.push(`Coverage: unresolved coverage entries remain`),{provenance:n.length>0?`fail`:`pass`,commitment:r.length>0?`fail`:`pass`,coverage:i?`fail`:`pass`,failures:t}}function b(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,...x(e,r,i)}}function x(e,t,n){if(!e.entries.some(e=>e.safetyGate)||e.tier===`floor`)return{};let r=y(e);return r.failures.length>0?{safetyGates:r,decision:`HOLD`,reason:`Safety gate failure: ${r.failures.join(`; `)}`,warnings:[...t,...r.failures]}:{safetyGates:r}}function S(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,safetyGate:e.safetyGate};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:b(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}}}}function C(e,t,n){let r=[];for(let i of t){let t=S({action:`add`,taskId:e,claim:`Test failure: ${i}`,status:`U`,receipt:``,criticalPath:!0},n);t.entry&&r.push(t.entry)}return r}export{C as autoClaimTestFailures,S as evidenceMap};

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

@@ -1,41 +0,0 @@
-//#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

@@ -1,3 +0,0 @@
-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);if(c.isDirectory())throw Error(`Path is a directory: ${a}. Expected a file path, not a directory. Use analyze_structure or find to explore directories.`);let l=c.mtimeMs,u=this.cache.get(s);if(u){if(u.mtimeMs===l)return this.cacheHits++,u.hitCount++,{content:u.content,hash:u.hash,lines:u.lines,estimatedTokens:u.estimatedTokens,hitCount:u.hitCount,changed:!1};let n=await t(s,`utf-8`),r=o(n);if(r===u.hash)return this.cacheHits++,u.hitCount++,u.mtimeMs=l,{content:u.content,hash:u.hash,lines:u.lines,estimatedTokens:u.estimatedTokens,hitCount:u.hitCount,changed:!1};let i=n.split(`
-`).length,a=e(n);return u.content=n,u.hash=r,u.lines=i,u.estimatedTokens=a,u.hitCount++,u.mtimeMs=l,{content:n,hash:r,lines:i,estimatedTokens:a,hitCount:u.hitCount,changed:!0}}let d=await t(s,`utf-8`),f=o(d),p=d.split(`
-`).length,m=e(d);if(this.cache.set(s,{content:d,hash:f,lines:p,estimatedTokens:m,hitCount:1,mtimeMs:l}),this.cache.size>i.MAX_ENTRIES){let e=this.cache.keys().next().value;e&&this.cache.delete(e)}return{content:d,hash:f,lines:p,estimatedTokens:m,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,52 +0,0 @@
-//#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;
-}
-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;
-}
-declare function fileSummary(options: FileSummaryOptions): Promise<FileSummaryResult>;
-//#endregion
-export { FileSummaryOptions, FileSummaryResult, fileSummary };

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

@@ -1,2 +0,0 @@
-import{readFile as e,stat as t}from"node:fs/promises";import{extname as n}from"node:path";import{SUPPORTED_EXTENSIONS as r,WasmRuntime as i,extractCalls as a,extractImports as o,extractSymbols as s}from"../../chunker/dist/index.js";async function c(a){let{path:o,previewLines:s=3}=a;if(!a.content){let e;try{e=await t(o)}catch(e){let t=e.code;throw t===`ENOENT`?Error(`File not found: ${o}. Check the path and try again.`):t===`EACCES`||t===`EPERM`?Error(`Permission denied reading ${o}. The file exists but is not accessible.`):e}if(e.isDirectory())throw Error(`Path is a directory: ${o}. file_summary requires a file path, not a directory. Use analyze_structure or find to explore directories.`);if(e.size>1e7)throw Error(`File too large (${(e.size/1e6).toFixed(1)}MB). file_summary supports files up to 10MB. Use search or compact with a query instead.`)}let c=a.content??await e(o,`utf-8`),d=c.split(`
-`),f=o.split(`.`).pop()??``,p=n(o);return i.get()&&r.has(p)?l(o,c,d,f,p):u(o,c,d,f)}async function l(e,t,n,r,i){let[c,l,u]=await Promise.all([s(t,i,e),o(t,i,e),a(t,i,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=u.map(e=>({caller:e.callerName,callee:e.calleeName,line:e.line}));return{path:e,lines:n.length,language:d(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 u(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:d(r),imports:i,exports:a,functions:o,classes:s,interfaces:c,types:l,estimatedTokens:Math.ceil(t.length/4)}}function d(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{c as fileSummary};

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

@@ -1,6 +0,0 @@
-//#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 +0,0 @@
-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{AIKIT_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,29 +0,0 @@
-import { ContentType } from "../../core/dist/index.js";
-import { IEmbedder } from "../../embeddings/dist/index.js";
-import { IKnowledgeStore } from "../../store/dist/index.js";
-
-//#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;
-}
-interface Example {
-  path: string;
-  startLine: number;
-  endLine: number;
-  content: string;
-  relevance: number;
-  context: string;
-}
-interface FindExamplesResult {
-  query: string;
-  examples: Example[];
-  totalFound: number;
-}
-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 +0,0 @@
-import{escapeRegExp as e}from"./regex-utils.js";async function t(t,n,r){let{query:i,limit:a=5,contentType:o}=r,s=`usage example of ${i}`,c=await t.embed(s),l=await n.search(c,{limit:a*3,contentType:o}),u=RegExp(`\\b${e(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}}export{t as findExamples};

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

@@ -1,49 +0,0 @@
-import { ContentType } from "../../core/dist/index.js";
-import { IEmbedder } from "../../embeddings/dist/index.js";
-import { IKnowledgeStore } from "../../store/dist/index.js";
-
-//#region packages/tools/src/find.d.ts
-interface FindOptions {
-  /** Semantic search query (optional) */
-  query?: string;
-  /** File glob pattern (optional) */
-  glob?: string;
-  /** Keyword/regex pattern for text search (optional) */
-  pattern?: string;
-  /** Max results per strategy (default: 10) */
-  limit?: number;
-  /** Filter by content type */
-  contentType?: ContentType;
-  /** Working directory for glob resolution (default: cwd) */
-  cwd?: string;
-}
-interface FindResult {
-  /** File path (relative to cwd) */
-  path: string;
-  /** How this result was found */
-  source: 'vector' | 'keyword' | 'glob' | 'pattern';
-  /** Relevance score (0-1 for vector/keyword, 1 for glob/pattern matches) */
-  score: number;
-  /** Line range if from AI Kit search */
-  lineRange?: {
-    start: number;
-    end: number;
-  };
-  /** Content preview */
-  preview?: string;
-}
-interface FindResults {
-  results: FindResult[];
-  strategies: string[];
-  totalFound: number;
-  failedStrategies?: Array<{
-    strategy: string;
-    reason: string;
-  }>;
-}
-/**
- * Run federated search across multiple strategies.
- */
-declare function find(embedder: IEmbedder, store: IKnowledgeStore, options: FindOptions): Promise<FindResults>;
-//#endregion
-export { FindOptions, FindResult, FindResults, find };

package/packages/tools/dist/find.js

@@ -1 +0,0 @@
-import{AIKIT_PATHS as e}from"../../core/dist/index.js";async function t(t,a,o){let{query:s,glob:c,pattern:l,limit:u=10,contentType:d,cwd:f=process.cwd()}=o,p=[],m=[],h=new Set,g=[];if(s){p.push(`vector`);let e=await t.embed(s),n={limit:u,contentType:d},r=await a.search(e,n);for(let e of r){let t=`${e.record.sourcePath}:${e.record.startLine}`;h.has(t)||(h.add(t),m.push({path:e.record.sourcePath,source:`vector`,score:e.score,lineRange:{start:e.record.startLine,end:e.record.endLine},preview:e.record.content.slice(0,200)}))}}if(s){p.push(`keyword`);try{let e=await a.ftsSearch(s,{limit:u,contentType:d});for(let t of e){let e=`${t.record.sourcePath}:${t.record.startLine}`;h.has(e)||(h.add(e),m.push({path:t.record.sourcePath,source:`keyword`,score:t.score,lineRange:{start:t.record.startLine,end:t.record.endLine},preview:t.record.content.slice(0,200)}))}}catch(e){g.push({strategy:`keyword`,reason:e instanceof Error?e.message:String(e)})}}if(c){p.push(`glob`);try{let{globSync:t}=await import(`node:fs`),n=t(c,{cwd:f,withFileTypes:!1}),r=new Set([`node_modules`,`.git`,`dist`,`build`,`coverage`,`.turbo`,`.cache`,`cdk.out`,e.state,e.data]),i=n.filter(e=>!e.replace(/\\/g,`/`).split(`/`).some(e=>r.has(e)));for(let e of i.slice(0,u)){let t=`glob:${e}`;h.has(t)||(h.add(t),m.push({path:e,source:`glob`,score:1}))}}catch(e){g.push({strategy:`glob`,reason:e instanceof Error?e.message:String(e)})}}if(l){p.push(`pattern`);try{let e=n(l),t=e?r(l):l,o=new RegExp(t,`i`),s=e?i(l):l,c=await a.ftsSearch(s,{limit:u*2,contentType:d});for(let t of c){let n=e?t.record.sourcePath:t.record.content;if(o.test(n)){let e=`${t.record.sourcePath}:${t.record.startLine}`;h.has(e)||(h.add(e),m.push({path:t.record.sourcePath,source:`pattern`,score:t.score,lineRange:{start:t.record.startLine,end:t.record.endLine},preview:t.record.content.slice(0,200)}))}}}catch(e){g.push({strategy:`pattern`,reason:e instanceof Error?e.message:String(e)})}}return m.sort((e,t)=>t.score-e.score),{results:m.slice(0,u),strategies:p,totalFound:m.length,...g.length>0&&{failedStrategies:g}}}function n(e){return/\*\*|^[*?]|\/\*|^\*\./.test(e)}function r(e){let t=`\0DS\0`,n=`\0SS\0`,r=e.replace(/\*\*/g,t).replace(/\*/g,n);return r=r.replace(/[.+^${}()|[\]\\]/g,`\\$&`),r=r.replace(/\?/g,`.`),r=r.replace(new RegExp(t.replace(/\0/g,`\\0`),`g`),`.*`),r=r.replace(new RegExp(n.replace(/\0/g,`\\0`),`g`),`[^/]*`),r}function i(e){return e.replace(/\*+/g,` `).replace(/[/\\]/g,` `).trim().split(/\s+/).filter(e=>e.length>1).join(` `)||e}export{t as find};

package/packages/tools/dist/forge-classify.d.ts

@@ -1,44 +0,0 @@
-import { ForgeTier } from "./evidence-map.js";
-
-//#region packages/tools/src/forge-classify.d.ts
-interface ForgeClassifyOptions {
-  /** Files being modified (absolute or relative paths) */
-  files: string[];
-  /** Task description for keyword detection */
-  task: string;
-  /** Root path for package boundary detection */
-  rootPath: string;
-}
-interface ClassifyTrigger {
-  rule: string;
-  detail: string;
-  source: 'blast_radius' | 'cross_package' | 'schema_contract' | 'security_auth' | 'task_hint' | 'default';
-}
-interface TypedUnknownSeed {
-  description: string;
-  type: 'contract' | 'convention' | 'freshness' | 'runtime' | 'data-flow' | 'impact';
-  suggestedTool: string;
-}
-interface ForgeClassifyCeremony {
-  ground: string;
-  build: string;
-  break: string;
-  evidenceMap: string;
-  gate: string;
-}
-interface ForgeClassifyResult {
-  tier: ForgeTier;
-  triggers: ClassifyTrigger[];
-  packagesCrossed: string[];
-  hasSchemaChange: boolean;
-  hasSecurityPath: boolean;
-  typedUnknownSeeds: TypedUnknownSeed[];
-  ceremony: ForgeClassifyCeremony;
-  reclassifyHint?: {
-    suggestedTier: ForgeTier;
-    reason: string;
-  };
-}
-declare function forgeClassify(options: ForgeClassifyOptions): Promise<ForgeClassifyResult>;
-//#endregion
-export { ClassifyTrigger, ForgeClassifyCeremony, ForgeClassifyOptions, ForgeClassifyResult, TypedUnknownSeed, forgeClassify };

package/packages/tools/dist/forge-classify.js

@@ -1,2 +0,0 @@
-import{fileSummary as e}from"./file-summary.js";import{dirname as t,extname as n,relative as r,resolve as i}from"node:path";import{existsSync as a,readFileSync as o,readdirSync as s,statSync as c}from"node:fs";import{AIKIT_PATHS as l}from"../../core/dist/index.js";const u=new Set([`.ts`,`.tsx`,`.js`,`.jsx`,`.mts`,`.cts`,`.mjs`,`.cjs`]),d=new Set([`.git`,l.data,l.state,`.turbo`,`.yarn`,`build`,`coverage`,`dist`,`node_modules`]),f=/auth|token|permission|acl|encrypt|secret|credential|jwt|oauth|password/i,p=/\b(hash|sign|verify|bcrypt|jwt|decrypt|secret|password)\b/i,m=/auth|security|permission|encrypt|secret|credential/i,h=/types\.ts$|schema\.ts$|contract\.ts$|\.proto$|openapi|swagger|\.graphql$/i,g=/(?:^|\/)(events|contracts|shared)(?:\/|$)/i,_=/export\s+interface\b|export\s+type\b|export\s+const\s+\w*Schema\w*\s*=\s*z\./i,v=/schema|contract|migration|breaking.change|api.change/i,y=/migration|data.?model|multi.?service|breaking|backward.?compat/i,b={floor:{ground:`Parasitic — read target file only`,build:`Implement directly`,break:`Skip`,evidenceMap:`Not required`,gate:`Self-certify`},standard:{ground:`Scope map + blast radius + constraint seed`,build:`TDD — test first, then implement`,break:`Error paths + edge cases`,evidenceMap:`3-8 critical-path entries`,gate:`YIELD/HOLD evaluation`},critical:{ground:`Full scope map + blast radius + trace + patterns + constraint pack`,build:`TDD + contract verification + cross-service validation`,break:`Error paths + edge cases + security dimensions + data-flow verification`,evidenceMap:`Comprehensive — all critical-path claims with receipts`,gate:`Strict YIELD/HOLD/HARD_BLOCK evaluation`}};async function x(e){let t=i(e.rootPath),n=e.task.trim(),r=e.files.map(e=>i(t,e)),a=[],o=!1,s=!1;for(let e of r){let r=C(e,t),i=T(e);(f.test(r)||p.test(i)||m.test(n))&&(o=!0),(h.test(r)||g.test(r)||v.test(n)||_.test(i)||await E(e))&&(s=!0)}o&&S(a,{rule:`security-path`,detail:`Security/auth path, task, or content matched security heuristics`,source:`security_auth`}),s&&S(a,{rule:`schema-contract`,detail:`Schema or contract path, task, or export shape matched contract heuristics`,source:`schema_contract`});let c=D(r,t);c.affectedFiles>5&&S(a,{rule:`blast-radius-importers`,detail:`${c.affectedFiles} affected files via direct import scanning`,source:`blast_radius`});let l=[...new Set(r.map(e=>M(e,t)).filter(e=>!!e))].sort();l.length>=2&&S(a,{rule:`cross-package-boundary`,detail:`Files span ${l.length} packages: ${l.join(`, `)}`,source:`cross_package`}),y.test(n)&&S(a,{rule:`task-hint-critical`,detail:`Task description matched migration or compatibility criticality hints`,source:`task_hint`});let u=a.length>0?`critical`:r.length===1?`floor`:`standard`;u===`floor`&&(o||s)&&(u=`standard`);let d=j(a),x=u===`floor`&&d.some(e=>e.type===`contract`)?{suggestedTier:`standard`,reason:`Contract-type unknowns detected — Floor may be insufficient`}:void 0;return{tier:u,triggers:a,packagesCrossed:l,hasSchemaChange:s,hasSecurityPath:o,typedUnknownSeeds:d,ceremony:b[u],reclassifyHint:x}}function S(e,t){e.some(e=>e.rule===t.rule&&e.source===t.source)||e.push(t)}function C(e,t){let n=i(t,e),a=r(t,n);return(a&&!a.startsWith(`..`)?a:n).replace(/\\/g,`/`)}function w(e){if(!a(e))return!1;try{return c(e).size<=1e5}catch{return!1}}function T(e){if(!w(e))return``;try{return o(e,`utf-8`).split(/\r?\n/).slice(0,200).join(`
-`)}catch{return``}}async function E(t){if(!w(t))return!1;try{let n=await e({path:t}),r=new Set(n.exports);return n.interfaces.some(e=>r.has(e.name))||n.types.some(e=>r.has(e.name))}catch{return!1}}function D(e,t){let n=new Set(e.filter(e=>a(e)));if(n.size===0)return{affectedFiles:e.length,importers:[]};let i=new Set;for(let e of O(t)){if(n.has(e)||!w(e))continue;let t=T(e);t&&k(t).some(t=>A(t,e,n))&&i.add(e)}return{affectedFiles:e.length+i.size,importers:[...i].map(e=>r(t,e).replace(/\\/g,`/`))}}function O(e){let t=[];function r(e){let a=[];try{a=s(e)}catch{return}for(let o of a){if(d.has(o))continue;let a=i(e,o),s;try{s=c(a)}catch{continue}if(s.isDirectory()){r(a);continue}u.has(n(o).toLowerCase())&&t.push(a)}}return r(e),t}function k(e){let t=new Set;for(let n of e.matchAll(/(?:from\s+['"]([^'"]+)['"]|import\s+['"]([^'"]+)['"]|require\(\s*['"]([^'"]+)['"]\s*\))/g)){let e=n[1]??n[2]??n[3];e&&t.add(e)}return[...t]}function A(e,n,r){if(!e.startsWith(`.`))return!1;let a=i(t(n),e);return[a,`${a}.ts`,`${a}.tsx`,`${a}.js`,`${a}.jsx`,`${a}.mts`,`${a}.cts`,`${a}.mjs`,`${a}.cjs`,i(a,`index.ts`),i(a,`index.tsx`),i(a,`index.js`),i(a,`index.jsx`)].some(e=>r.has(e))}function j(e){return e.map(e=>{switch(e.source){case`security_auth`:return{description:`Verify auth and security assumptions before yielding`,type:`contract`,suggestedTool:`aikit_search`};case`schema_contract`:return{description:`Confirm schema and contract compatibility`,type:`contract`,suggestedTool:`aikit_schema_validate`};case`blast_radius`:return{description:`Inspect affected importers before delivery`,type:`impact`,suggestedTool:`aikit_blast_radius`};case`cross_package`:return{description:`Assess downstream package impact across boundaries`,type:`impact`,suggestedTool:`aikit_blast_radius`};case`task_hint`:return{description:`Check established conventions for migrations or compatibility work`,type:`convention`,suggestedTool:`aikit_find`};default:return{description:`No explicit unknown routing required`,type:`freshness`,suggestedTool:`aikit_lookup`}}})}function M(e,n){let s=t(i(n,e)),c=i(n);for(;s.length>=c.length;){let e=i(s,`package.json`);if(a(e))try{return JSON.parse(o(e,`utf-8`)).name??r(c,s).replace(/\\/g,`/`)}catch{return r(c,s).replace(/\\/g,`/`)}let n=t(s);if(n===s)break;s=n}}export{x as forgeClassify};

package/packages/tools/dist/forge-ground.d.ts

@@ -1,61 +0,0 @@
-import { ForgeTier } from "./evidence-map.js";
-import { ClassifyTrigger, TypedUnknownSeed } from "./forge-classify.js";
-import { ScopeMapResult } from "./scope-map.js";
-import { IEmbedder } from "../../embeddings/dist/index.js";
-import { IKnowledgeStore } from "../../store/dist/index.js";
-
-//#region packages/tools/src/forge-ground.d.ts
-interface ForgeGroundOptions {
-  /** Task description */
-  task: string;
-  /** Target files being modified (absolute paths) */
-  files: string[];
-  /** Root path of the codebase */
-  rootPath: string;
-  /** Max constraint entries to load (default: 3) */
-  maxConstraints?: number;
-  /** Force a specific tier (skip auto-classify) */
-  forceTier?: ForgeTier;
-  /** Task ID for evidence map creation (default: auto-generated from task) */
-  taskId?: string;
-}
-interface ConstraintRef {
-  source: string;
-  snippet: string;
-  relevance: number;
-}
-interface ForgeGroundResult {
-  /** Computed or forced tier */
-  tier: ForgeTier;
-  /** Classification triggers (empty if tier was forced) */
-  classifyTriggers: ClassifyTrigger[];
-  /** Scope map (relevant files with focus ranges) — null for Floor tier */
-  scopeMap: ScopeMapResult | null;
-  /** Typed Unknown Queue seeds */
-  typedUnknownSeeds: TypedUnknownSeed[];
-  /** Constraint seed — relevant AI Kit entries from decisions/patterns */
-  constraints: ConstraintRef[];
-  /** File summaries for target files */
-  fileSummaries: Array<{
-    path: string;
-    exports: string[];
-    functions: string[];
-    lines: number;
-    error?: string;
-  }>;
-  /** Evidence map task ID (created if Standard or Critical) */
-  evidenceMapTaskId: string | null;
-  /** Total estimated tokens for this Ground output */
-  estimatedTokens: number;
-  /** Ceremony recommendations for this tier */
-  ceremony: {
-    ground: string;
-    build: string;
-    break: string;
-    evidenceMap: string;
-    gate: string;
-  };
-}
-declare function forgeGround(embedder: IEmbedder, store: IKnowledgeStore, options: ForgeGroundOptions): Promise<ForgeGroundResult>;
-//#endregion
-export { ConstraintRef, ForgeGroundOptions, ForgeGroundResult, forgeGround };

package/packages/tools/dist/forge-ground.js

@@ -1 +0,0 @@
-import{estimateTokens as e}from"./text-utils.js";import{evidenceMap as t}from"./evidence-map.js";import{fileSummary as n}from"./file-summary.js";import{forgeClassify as r}from"./forge-classify.js";import{scopeMap as i}from"./scope-map.js";const a={floor:{ground:`Parasitic — read target file only`,build:`Implement directly`,break:`Skip`,evidenceMap:`Not required`,gate:`Self-certify`},standard:{ground:`Scope map + blast radius + constraint seed`,build:`TDD — test first, then implement`,break:`Error paths + edge cases`,evidenceMap:`3-8 critical-path entries`,gate:`YIELD/HOLD evaluation`},critical:{ground:`Full scope map + blast radius + trace + patterns + constraint pack`,build:`TDD + contract verification + cross-service validation`,break:`Error paths + edge cases + security dimensions + data-flow verification`,evidenceMap:`Comprehensive — all critical-path claims with receipts`,gate:`Strict YIELD/HOLD/HARD_BLOCK evaluation`}};async function o(e,t,n){let r=n.maxConstraints??3,i=await s(n),a=await u(n.files);if(i.tier===`floor`)return _({tier:i.tier,classifyTriggers:i.classifyTriggers,scopeMap:null,typedUnknownSeeds:i.typedUnknownSeeds,constraints:[],fileSummaries:a,evidenceMapTaskId:null,ceremony:i.ceremony});let[o,d,p]=await Promise.all([c(e,t,n.task,i.tier),l(e,t,n.task,r),f(n.rootPath,n.taskId??v(n.task),i.tier)]);return _({tier:i.tier,classifyTriggers:i.classifyTriggers,scopeMap:o,typedUnknownSeeds:i.typedUnknownSeeds,constraints:d,fileSummaries:a,evidenceMapTaskId:p,ceremony:i.ceremony})}async function s(e){if(e.forceTier)return{tier:e.forceTier,classifyTriggers:[],typedUnknownSeeds:[],ceremony:g(e.forceTier)};try{let t=await r({files:e.files,task:e.task,rootPath:e.rootPath});return{tier:t.tier,classifyTriggers:t.triggers,typedUnknownSeeds:t.typedUnknownSeeds,ceremony:t.ceremony}}catch{return{tier:`standard`,classifyTriggers:[],typedUnknownSeeds:[],ceremony:g(`standard`)}}}async function c(e,t,n,r){try{return await i(e,t,{task:n,maxFiles:r===`critical`?20:10})}catch{return null}}async function l(e,t,n,r){try{let i=`decision pattern convention ${n}`,a=typeof e.embedQuery==`function`?await e.embedQuery(i):await e.embed(i);return(await t.search(a,{limit:r,origin:`curated`})).slice(0,r).map(e=>p(e))}catch{return[]}}async function u(e){return Promise.all(e.map(async e=>d(e)))}async function d(e){try{return h(await n({path:e}))}catch(t){return{path:e,exports:[],functions:[],lines:0,error:t instanceof Error?t.message:`Unable to summarize file`}}}async function f(e,n,r){try{return t({action:`create`,taskId:n,tier:r},e),n}catch{return null}}function p(e){return{source:e.record.sourcePath,snippet:m(e.record.content),relevance:e.score}}function m(e){let t=e.replace(/\s+/g,` `).trim();return t.length<=200?t:`${t.slice(0,197).trimEnd()}...`}function h(e){return{path:e.path,exports:e.exports,functions:e.functions.map(e=>e.name),lines:e.lines}}function g(e){return{...a[e]}}function _(t){return{...t,estimatedTokens:e(JSON.stringify(t))}}function v(e){let t=e.toLowerCase().replace(/[^a-z0-9\s]/g,` `).split(/\s+/).filter(Boolean).slice(0,5).join(`-`),n=Date.now().toString(36);return`${t||`task`}-${n}`}export{o as forgeGround};

package/packages/tools/dist/git-context.d.ts

@@ -1,25 +0,0 @@
-//#region packages/tools/src/git-context.d.ts
-interface GitContextOptions {
-  cwd?: string;
-  commitCount?: number;
-  includeDiff?: boolean;
-}
-interface GitContextResult {
-  gitRoot: string;
-  branch: string;
-  status: {
-    staged: string[];
-    modified: string[];
-    untracked: string[];
-  };
-  recentCommits: Array<{
-    hash: string;
-    message: string;
-    author: string;
-    date: string;
-  }>;
-  diff?: string;
-}
-declare function gitContext(options?: GitContextOptions): Promise<GitContextResult>;
-//#endregion
-export { GitContextOptions, GitContextResult, gitContext };

package/packages/tools/dist/git-context.js

@@ -1,3 +0,0 @@
-import{execFile as e}from"node:child_process";import{promisify as t}from"node:util";const n=t(e);async function r(e,t){try{let{stdout:r}=await n(`git`,e,{cwd:t,timeout:15e3});return r.toString().trim()}catch{return``}}async function i(e={}){let t=e.cwd??process.cwd(),n=e.commitCount??5,i=await r([`rev-parse`,`--show-toplevel`],t);if(!i)return{gitRoot:t,branch:`unknown`,status:{staged:[],modified:[],untracked:[]},recentCommits:[]};let a=i,[o,s,c,l]=await Promise.all([r([`rev-parse`,`--abbrev-ref`,`HEAD`],a),r([`status`,`--porcelain`],a),r([`log`,`--max-count=${n}`,`--format=%h|%s|%an|%ai`],a),e.includeDiff?r([`diff`,`--stat`,`--no-color`],a):Promise.resolve(``)]),u=[],d=[],f=[];for(let e of s.split(`
-`).filter(Boolean)){let t=e[0],n=e[1],r=e.slice(3).trim();t!==` `&&t!==`?`&&u.push(r),(n===`M`||n===`D`)&&d.push(r),t===`?`&&f.push(r)}let p=c.split(`
-`).filter(Boolean).map(e=>{let[t,n,r,i]=e.split(`|`);return{hash:t,message:n,author:r,date:i}});return{gitRoot:i,branch:o||`unknown`,status:{staged:u,modified:d,untracked:f},recentCommits:p,diff:l||void 0}}export{i as gitContext};

package/packages/tools/dist/graph-query.d.ts

@@ -1,98 +0,0 @@
-import { DepthGroupedResult, GraphEdge, GraphNode, GraphStats, GraphTraversalResult, GraphValidationResult, IGraphStore, ProcessInfo, Symbol360 } from "../../store/dist/index.js";
-
-//#region packages/tools/src/graph-query.d.ts
-interface GraphQueryOptions {
-  /** Action: query nodes, traverse from a node, get stats, or add data */
-  action: 'find_nodes' | 'find_edges' | 'neighbors' | 'traverse' | 'stats' | 'validate' | 'add' | 'delete' | 'clear' | 'detect_communities' | 'set_community' | 'trace_process' | 'list_processes' | 'delete_process' | 'depth_traverse' | 'cohesion' | 'symbol360';
-  /** Node type filter (for find_nodes) */
-  nodeType?: string;
-  /** Name pattern (LIKE %pattern%) for find_nodes */
-  namePattern?: string;
-  /** Source path filter */
-  sourcePath?: string;
-  /** Node ID for neighbors/traverse/delete */
-  nodeId?: string;
-  /** Edge type filter */
-  edgeType?: string;
-  /** From node ID (for find_edges) */
-  fromId?: string;
-  /** To node ID (for find_edges) */
-  toId?: string;
-  /** Traversal direction */
-  direction?: 'outgoing' | 'incoming' | 'both';
-  /** Max traversal depth (default: 2) */
-  maxDepth?: number;
-  /** Max results (default: 50) */
-  limit?: number;
-  /** Nodes to add (for action=add) */
-  nodes?: Array<{
-    id?: string;
-    type: string;
-    name: string;
-    properties?: Record<string, unknown>;
-    sourceRecordId?: string;
-    sourcePath?: string;
-  }>;
-  /** Edges to add (for action=add) */
-  edges?: Array<{
-    id?: string;
-    fromId: string;
-    toId: string;
-    type: string;
-    weight?: number;
-    properties?: Record<string, unknown>;
-  }>;
-  /** Community label (for set_community, cohesion) */
-  community?: string;
-  /** Process ID (for delete_process) */
-  processId?: string;
-  /** Label for process tracing */
-  label?: string;
-}
-interface GraphQueryResult {
-  action: string;
-  nodes?: GraphNode[];
-  edges?: GraphEdge[];
-  stats?: GraphStats;
-  validation?: GraphValidationResult;
-  communities?: Record<string, string[]>;
-  process?: ProcessInfo;
-  processes?: ProcessInfo[];
-  depthGroups?: DepthGroupedResult;
-  cohesionScore?: number;
-  symbol360?: Symbol360;
-  nodesAdded?: number;
-  edgesAdded?: number;
-  deleted?: number;
-  summary: string;
-}
-declare function graphQuery(graphStore: IGraphStore, options: GraphQueryOptions): Promise<GraphQueryResult>;
-interface GraphAugmentOptions {
-  /** Max graph hops from each vector hit (default: 1) */
-  hops?: number;
-  /** Edge type filter for graph expansion */
-  edgeType?: string;
-  /** Max graph nodes per vector hit (default: 5) */
-  maxPerHit?: number;
-}
-interface GraphAugmentedResult {
-  /** Original search result record ID */
-  recordId: string;
-  /** Original similarity score */
-  score: number;
-  /** Source path of the matched record */
-  sourcePath: string;
-  /** Graph nodes connected to this record (via sourceRecordId) */
-  graphContext: GraphTraversalResult;
-}
-/**
- * Augment vector search results with graph context.
- * For each search hit, finds linked graph nodes and traverses their connections.
- */
-declare function graphAugmentSearch(graphStore: IGraphStore, hits: Array<{
-  recordId: string;
-  score: number;
-  sourcePath: string;
-}>, options?: GraphAugmentOptions): Promise<GraphAugmentedResult[]>;
-//#endregion
-export { GraphAugmentOptions, GraphAugmentedResult, GraphQueryOptions, GraphQueryResult, graphAugmentSearch, graphQuery };

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

@@ -1 +0,0 @@
-import{createHash as e}from"node:crypto";function t(t,...n){return`${t}_${e(`sha256`).update(n.join(`|`)).digest(`hex`).slice(0,12)}`}async function n(e,n){let{action:r}=n;switch(r){case`find_nodes`:{let t=await e.findNodes({type:n.nodeType,namePattern:n.namePattern,sourcePath:n.sourcePath,limit:n.limit});return{action:r,nodes:t,summary:`Found ${t.length} node(s)${n.nodeType?` of type "${n.nodeType}"`:``}${n.namePattern?` matching "${n.namePattern}"`:``}`}}case`find_edges`:{let t=await e.findEdges({type:n.edgeType,fromId:n.fromId,toId:n.toId,limit:n.limit});return{action:r,edges:t,summary:`Found ${t.length} edge(s)${n.edgeType?` of type "${n.edgeType}"`:``}`}}case`neighbors`:{if(!n.nodeId)return{action:r,summary:`Error: nodeId is required for neighbors action`};let t=await e.getNeighbors(n.nodeId,{edgeType:n.edgeType,direction:n.direction,limit:n.limit});return{action:r,nodes:t.nodes,edges:t.edges,summary:`Found ${t.nodes.length} neighbor(s) and ${t.edges.length} edge(s) for node "${n.nodeId}"`}}case`traverse`:{if(!n.nodeId)return{action:r,summary:`Error: nodeId is required for traverse action`};let t=await e.traverse(n.nodeId,{edgeType:n.edgeType,maxDepth:n.maxDepth,direction:n.direction,limit:n.limit});return{action:r,nodes:t.nodes,edges:t.edges,summary:`Traversed ${t.nodes.length} node(s) and ${t.edges.length} edge(s) from "${n.nodeId}" (depth=${n.maxDepth??2})`}}case`stats`:{let t=await e.getStats();return{action:r,stats:t,summary:`Graph: ${t.nodeCount} nodes, ${t.edgeCount} edges. Types: ${Object.entries(t.nodeTypes).map(([e,t])=>`${e}(${t})`).join(`, `)||`none`}`}}case`validate`:{let t=await e.validate();return{action:r,validation:t,stats:t.stats,summary:t.valid?`Graph validation passed: ${t.stats.nodeCount} nodes, ${t.stats.edgeCount} edges, ${t.orphanNodes.length} orphan node(s)`:`Graph validation found ${t.danglingEdges.length} dangling edge(s) and ${t.orphanNodes.length} orphan node(s)`}}case`add`:{let i=0,a=0;if(n.nodes&&n.nodes.length>0){let r=n.nodes.map(e=>({id:e.id??t(`node`,e.type,e.name),type:e.type,name:e.name,properties:e.properties??{},sourceRecordId:e.sourceRecordId,sourcePath:e.sourcePath,createdAt:new Date().toISOString()}));await e.upsertNodes(r),i=r.length}if(n.edges&&n.edges.length>0){let r=n.edges.map(e=>({id:e.id??t(`edge`,e.fromId,e.toId,e.type),fromId:e.fromId,toId:e.toId,type:e.type,weight:e.weight,properties:e.properties}));await e.upsertEdges(r),a=r.length}return{action:r,nodesAdded:i,edgesAdded:a,summary:`Added ${i} node(s) and ${a} edge(s) to the graph`}}case`delete`:if(n.nodeId)return await e.deleteNode(n.nodeId),{action:r,deleted:1,summary:`Deleted node "${n.nodeId}" and its edges`};if(n.sourcePath){let t=await e.deleteBySourcePath(n.sourcePath);return{action:r,deleted:t,summary:`Deleted ${t} node(s) from source "${n.sourcePath}"`}}return{action:r,summary:`Error: nodeId or sourcePath required for delete action`};case`clear`:{let t=await e.getStats();return await e.clear(),{action:r,deleted:t.nodeCount,summary:`Cleared graph: removed ${t.nodeCount} node(s) and ${t.edgeCount} edge(s)`}}case`detect_communities`:{let t=await e.detectCommunities(),n=Object.values(t).reduce((e,t)=>e+t.length,0);return{action:r,communities:t,summary:`Detected ${Object.keys(t).length} community/communities covering ${n} node(s)`}}case`set_community`:return!n.nodeId||!n.community?{action:r,summary:`Error: nodeId and community are required for set_community action`}:(await e.setNodeCommunity(n.nodeId,n.community),{action:r,summary:`Set community "${n.community}" on node "${n.nodeId}"`});case`trace_process`:{if(!n.nodeId||!n.label)return{action:r,summary:`Error: nodeId and label are required for trace_process action`};let t=await e.traceProcess(n.nodeId,n.label);return{action:r,process:t,summary:`Traced process "${t.label}" from node "${n.nodeId}": ${t.steps.length} step(s)`}}case`list_processes`:{let t=await e.getProcesses(n.nodeId);return{action:r,processes:t,summary:`Found ${t.length} process(es)${n.nodeId?` involving node "${n.nodeId}"`:``}`}}case`delete_process`:return n.processId?(await e.deleteProcess(n.processId),{action:r,summary:`Deleted process "${n.processId}"`}):{action:r,summary:`Error: processId is required for delete_process action`};case`depth_traverse`:{if(!n.nodeId)return{action:r,summary:`Error: nodeId is required for depth_traverse action`};let t=await e.depthGroupedTraversal(n.nodeId,n.maxDepth,{edgeType:n.edgeType,direction:n.direction,limit:n.limit}),i=Object.values(t).reduce((e,t)=>e+t.length,0);return{action:r,depthGroups:t,summary:`Depth-grouped traversal from "${n.nodeId}": ${i} node(s) across ${Object.keys(t).length} depth level(s)`}}case`cohesion`:{if(!n.community)return{action:r,summary:`Error: community is required for cohesion action`};let t=await e.getCohesionScore(n.community);return{action:r,cohesionScore:t,summary:`Community "${n.community}" cohesion score: ${(t*100).toFixed(1)}%`}}case`symbol360`:{if(!n.nodeId)return{action:r,summary:`Error: nodeId is required for symbol360 action`};let t=await e.getSymbol360(n.nodeId);return{action:r,symbol360:t,nodes:[t.node],edges:[...t.incoming,...t.outgoing],summary:`360° view of "${t.node.name}": ${t.incoming.length} incoming, ${t.outgoing.length} outgoing, community: ${t.community??`none`}, ${t.processes.length} process(es)`}}default:return{action:r,summary:`Unknown action: ${r}`}}}async function r(e,t,n){let r=n?.hops??1,i=n?.maxPerHit??5,a=[];for(let o of t)try{let t=await e.findNodes({sourcePath:o.sourcePath}),s=[],c=[],l=new Set,u=new Set;for(let a of t.slice(0,i))if(!l.has(a.id)&&(l.add(a.id),s.push(a),r>0)){let t=await e.traverse(a.id,{maxDepth:r,edgeType:n?.edgeType,limit:i});for(let e of t.nodes)l.has(e.id)||(l.add(e.id),s.push(e));for(let e of t.edges)u.has(e.id)||(u.add(e.id),c.push(e))}a.push({recordId:o.recordId,score:o.score,sourcePath:o.sourcePath,graphContext:{nodes:s,edges:c}})}catch{a.push({recordId:o.recordId,score:o.score,sourcePath:o.sourcePath,graphContext:{nodes:[],edges:[]}})}return a}export{r as graphAugmentSearch,n as graphQuery};

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

@@ -1,25 +0,0 @@
-//#region packages/tools/src/guide.d.ts
-/**
- * Tool discovery — recommends MCP tools and workflows for a given goal.
- *
- * Uses keyword matching against predefined workflow templates.
- * No embeddings required — pure string matching for instant results.
- */
-interface GuideRecommendation {
-  tool: string;
-  reason: string;
-  order: number;
-  suggestedArgs?: Record<string, unknown>;
-}
-interface GuideResult {
-  workflow: string;
-  description: string;
-  tools: GuideRecommendation[];
-  alternativeWorkflows: string[];
-}
-/**
- * Match a goal description to the best workflow and return tool recommendations.
- */
-declare function guide(goal: string, maxRecommendations?: number, indexMode?: string): GuideResult;
-//#endregion
-export { GuideRecommendation, GuideResult, guide };