@vpxa/aikit 0.1.59 → 0.1.60

package/packages/elicitation/dist/build.d.ts

@@ -1,14 +0,0 @@
-import { ElicitFormSchema, ElicitOptions, FieldSchema } from "./types.js";
-
-//#region packages/elicitation/src/build.d.ts
-/** Build a form schema from a record of named fields. */
-declare function buildFormSchema(fields: Record<string, FieldSchema>, required?: string[]): ElicitFormSchema;
-/**
- * Build the full elicitation request options.
- * `message` — prompt text shown above the form.
- * `fields`  — record of field-id → FieldSchema.
- * `required` — field ids that must be filled.
- */
-declare function buildElicitRequest(message: string, fields: Record<string, FieldSchema>, required?: string[]): ElicitOptions;
-//#endregion
-export { buildElicitRequest, buildFormSchema };

package/packages/elicitation/dist/build.js

@@ -1 +0,0 @@
-function e(e,t){return{type:`object`,properties:e,...t&&t.length>0?{required:t}:{}}}function t(t,n,r){return{message:t,schema:e(n,r)}}export{t as buildElicitRequest,e as buildFormSchema};

package/packages/elicitation/dist/fields.d.ts

@@ -1,32 +0,0 @@
-import { ArrayFieldSchema, BooleanFieldSchema, EnumFieldSchema, NumberFieldSchema, TextFieldSchema } from "./types.js";
-
-//#region packages/elicitation/src/fields.d.ts
-declare const field: {
-  /** Free text input. */readonly text: (title: string, opts?: {
-    description?: string;
-    minLength?: number;
-    maxLength?: number;
-    default?: string;
-  }) => TextFieldSchema; /** Single-select dropdown/radio. */
-  readonly select: (title: string, options: string[], opts?: {
-    description?: string;
-    enumNames?: string[];
-    default?: string;
-  }) => EnumFieldSchema; /** Multi-select checkboxes. */
-  readonly multi: (title: string, options: string[], opts?: {
-    description?: string;
-  }) => ArrayFieldSchema; /** Boolean checkbox / confirmation. */
-  readonly confirm: (title: string, opts?: {
-    description?: string;
-    default?: boolean;
-  }) => BooleanFieldSchema; /** Numeric input. */
-  readonly number: (title: string, opts?: {
-    description?: string;
-    minimum?: number;
-    maximum?: number;
-    integer?: boolean;
-    default?: number;
-  }) => NumberFieldSchema;
-};
-//#endregion
-export { field };

package/packages/elicitation/dist/fields.js

@@ -1 +0,0 @@
-const e={text(e,t){return{type:`string`,title:e,...t?.description!==void 0&&{description:t.description},...t?.minLength!==void 0&&{minLength:t.minLength},...t?.maxLength!==void 0&&{maxLength:t.maxLength},...t?.default!==void 0&&{default:t.default}}},select(e,t,n){return{type:`string`,title:e,enum:t,...n?.description!==void 0&&{description:n.description},...n?.enumNames!==void 0&&{enumNames:n.enumNames},...n?.default!==void 0&&{default:n.default}}},multi(e,t,n){return{type:`array`,title:e,items:{type:`string`,enum:t},uniqueItems:!0,...n?.description!==void 0&&{description:n.description}}},confirm(e,t){return{type:`boolean`,title:e,...t?.description!==void 0&&{description:t.description},...t?.default!==void 0&&{default:t.default}}},number(e,t){return{type:t?.integer?`integer`:`number`,title:e,...t?.description!==void 0&&{description:t.description},...t?.minimum!==void 0&&{minimum:t.minimum},...t?.maximum!==void 0&&{maximum:t.maximum},...t?.default!==void 0&&{default:t.default}}}};export{e as field};

package/packages/elicitation/dist/normalize.d.ts

@@ -1,15 +0,0 @@
-import { ElicitContent, ElicitResponse } from "./types.js";
-
-//#region packages/elicitation/src/normalize.d.ts
-/** Raw elicitation result from the MCP SDK. */
-interface RawElicitResult {
-  action: string;
-  content?: Record<string, unknown>;
-}
-/**
- * Normalize a raw MCP elicitation result into a typed response.
- * Handles missing fields, unknown actions, and type coercion.
- */
-declare function normalizeResponse<T extends ElicitContent = ElicitContent>(raw: RawElicitResult | undefined | null): ElicitResponse<T>;
-//#endregion
-export { normalizeResponse };

package/packages/elicitation/dist/normalize.js

@@ -1 +0,0 @@
-const e=new Set([`accept`,`decline`,`cancel`]);function t(t){if(!t)return{action:`cancel`};let n=e.has(t.action)?t.action:`cancel`;if(n!==`accept`||!t.content)return{action:n};let r={};for(let[e,n]of Object.entries(t.content))(typeof n==`string`||typeof n==`number`||typeof n==`boolean`||Array.isArray(n)&&n.every(e=>typeof e==`string`))&&(r[e]=n);return{action:n,content:r}}export{t as normalizeResponse};

package/packages/elicitation/dist/types.d.ts

@@ -1,88 +0,0 @@
-//#region packages/elicitation/src/types.d.ts
-/**
- * MCP elicitation types.
- *
- * Elicitation allows tools to request structured input from the user via
- * the MCP client. The schema follows JSON Schema constraints:
- * only flat primitives and string arrays are supported.
- */
-/** User action on the elicitation dialog. */
-type ElicitAction = 'accept' | 'decline' | 'cancel';
-/** Flat content map — MCP only supports primitives + string arrays. */
-type ElicitContent = Record<string, string | number | boolean | string[]>;
-/** Normalized elicitation response. */
-interface ElicitResponse<T extends ElicitContent = ElicitContent> {
-  action: ElicitAction;
-  content?: T;
-}
-interface TextFieldSchema {
-  type: 'string';
-  title: string;
-  description?: string;
-  minLength?: number;
-  maxLength?: number;
-  default?: string;
-}
-interface EnumFieldSchema {
-  type: 'string';
-  title: string;
-  description?: string;
-  enum: string[];
-  enumNames?: string[];
-  default?: string;
-}
-interface ArrayFieldSchema {
-  type: 'array';
-  title: string;
-  description?: string;
-  items: {
-    type: 'string';
-    enum: string[];
-  };
-  uniqueItems: true;
-}
-interface BooleanFieldSchema {
-  type: 'boolean';
-  title: string;
-  description?: string;
-  default?: boolean;
-}
-interface NumberFieldSchema {
-  type: 'number' | 'integer';
-  title: string;
-  description?: string;
-  minimum?: number;
-  maximum?: number;
-  default?: number;
-}
-type FieldSchema = TextFieldSchema | EnumFieldSchema | ArrayFieldSchema | BooleanFieldSchema | NumberFieldSchema;
-/** JSON Schema object for the elicitation form. */
-interface ElicitFormSchema {
-  type: 'object';
-  properties: Record<string, FieldSchema>;
-  required?: string[];
-}
-interface ElicitOptions {
-  message: string;
-  schema: ElicitFormSchema;
-}
-/**
- * High-level elicitation interface exposed to tools.
- * Wraps `server.createElicitation()` with convenience methods.
- */
-interface Elicitor {
-  /** Whether the connected client supports elicitation. */
-  readonly available: boolean;
-  /** Ask a structured form question. */
-  ask<T extends ElicitContent = ElicitContent>(opts: ElicitOptions): Promise<ElicitResponse<T>>;
-  /** Yes/no confirmation. */
-  confirm(message: string): Promise<boolean>;
-  /** Pick one from a list. Returns null if declined/cancelled. */
-  selectOne(message: string, options: string[]): Promise<string | null>;
-  /** Pick many from a list. Returns empty array if declined/cancelled. */
-  selectMany(message: string, options: string[]): Promise<string[]>;
-  /** Free text prompt. Returns null if declined/cancelled. */
-  promptText(message: string, description?: string): Promise<string | null>;
-}
-//#endregion
-export { ArrayFieldSchema, BooleanFieldSchema, ElicitAction, ElicitContent, ElicitFormSchema, ElicitOptions, ElicitResponse, Elicitor, EnumFieldSchema, FieldSchema, NumberFieldSchema, TextFieldSchema };

package/packages/elicitation/dist/types.js

@@ -1 +0,0 @@
-export{};

package/packages/embeddings/dist/embedder.interface.d.ts

@@ -1,26 +0,0 @@
-//#region packages/embeddings/src/embedder.interface.d.ts
-/**
- * Embedding abstraction — allows swapping embedding models.
- */
-interface IEmbedder {
-  /** Generate an embedding vector for a single text string (used for documents/passages) */
-  embed(text: string): Promise<Float32Array>;
-  /**
-   * Generate an embedding vector for a search query.
-   * Some models (e.g., BGE) use a query prefix for asymmetric retrieval.
-   * Falls back to embed() if the model doesn't need query prefixing.
-   */
-  embedQuery(query: string): Promise<Float32Array>;
-  /** Generate embeddings for multiple text strings (batched, for documents/passages) */
-  embedBatch(texts: string[], batchSize?: number): Promise<Float32Array[]>;
-  /** The dimensionality of the embedding vectors */
-  readonly dimensions: number;
-  /** The model identifier */
-  readonly modelId: string;
-  /** Initialize the model (download if needed, load into memory) */
-  initialize(): Promise<void>;
-  /** Release model resources */
-  shutdown?(): Promise<void>;
-}
-//#endregion
-export { IEmbedder };

package/packages/embeddings/dist/embedder.interface.js

@@ -1 +0,0 @@
-export{};

package/packages/embeddings/dist/onnx-embedder.d.ts

@@ -1,23 +0,0 @@
-import { IEmbedder } from "./embedder.interface.js";
-
-//#region packages/embeddings/src/onnx-embedder.d.ts
-declare class OnnxEmbedder implements IEmbedder {
-  private pipe;
-  readonly dimensions: number;
-  readonly modelId: string;
-  private readonly queryPrefix;
-  constructor(options?: {
-    model?: string;
-    dimensions?: number;
-    queryPrefix?: string;
-  });
-  private detectQueryPrefix;
-  initialize(): Promise<void>;
-  private isCorruptionError;
-  shutdown(): Promise<void>;
-  embed(text: string): Promise<Float32Array>;
-  embedQuery(query: string): Promise<Float32Array>;
-  embedBatch(texts: string[], batchSize?: number): Promise<Float32Array[]>;
-}
-//#endregion
-export { OnnxEmbedder };

package/packages/embeddings/dist/onnx-embedder.js

@@ -1 +0,0 @@
-import{rm as e}from"node:fs/promises";import{homedir as t}from"node:os";import{join as n}from"node:path";import{EMBEDDING_DEFAULTS as r}from"../../core/dist/index.js";import{env as i,pipeline as a}from"@huggingface/transformers";i.cacheDir=n(t(),`.cache`,`huggingface`,`transformers-js`);var o=class{pipe=null;dimensions;modelId;queryPrefix;constructor(e){this.modelId=e?.model??r.model,this.dimensions=e?.dimensions??r.dimensions,this.queryPrefix=e?.queryPrefix??this.detectQueryPrefix(this.modelId)}detectQueryPrefix(e){let t=e.toLowerCase();return t.includes(`bge`)||t.includes(`mxbai-embed`)?`Represent this sentence for searching relevant passages: `:t.includes(`/e5-`)||t.includes(`multilingual-e5`)?`query: `:``}async initialize(){if(!this.pipe)try{this.pipe=await a(`feature-extraction`,this.modelId,{dtype:`q8`})}catch(r){let o=r.message?.toLowerCase()??``;if(this.isCorruptionError(o)){let r=n(i.cacheDir??n(t(),`.cache`,`huggingface`,`transformers-js`),this.modelId);console.error(`[aikit:auto-heal] Detected corrupted model cache for "${this.modelId}". Clearing cache at ${r} and retrying download...`);try{await e(r,{recursive:!0,force:!0})}catch{}try{this.pipe=await a(`feature-extraction`,this.modelId,{dtype:`q8`}),console.error(`[aikit:auto-heal] Model "${this.modelId}" re-downloaded successfully.`);return}catch(e){throw Error(`Failed to initialize embedding model "${this.modelId}" after auto-heal: ${e.message}`)}}throw Error(`Failed to initialize embedding model "${this.modelId}": ${r.message}`)}}isCorruptionError(e){return[`protobuf`,`invalid model`,`invalid onnx`,`unexpected end`,`unexpected token`,`failed to load`,`checksum`,`corrupt`,`could not load`,`onnx`,`malformed`].some(t=>e.includes(t))}async shutdown(){this.pipe=null}async embed(e){this.pipe||await this.initialize();let t=await this.pipe?.(e,{pooling:`mean`,normalize:!0});if(!t)throw Error(`Embedding pipeline returned no output`);return new Float32Array(t.data)}async embedQuery(e){return this.embed(this.queryPrefix+e)}async embedBatch(e,t=64){if(e.length===0)return[];this.pipe||await this.initialize();let n=[];for(let r=0;r<e.length;r+=t){let i=e.slice(r,r+t),a=await this.pipe?.(i,{pooling:`mean`,normalize:!0});if(!a)throw Error(`Embedding pipeline returned no output`);if(i.length===1)n.push(new Float32Array(a.data));else for(let e=0;e<i.length;e++){let t=e*this.dimensions,r=a.data.slice(t,t+this.dimensions);n.push(new Float32Array(r))}}return n}};export{o as OnnxEmbedder};

package/packages/enterprise-bridge/dist/cache.d.ts

@@ -1,28 +0,0 @@
-import { ERSearchResult } from "./types.js";
-
-//#region packages/enterprise-bridge/src/cache.d.ts
-declare class ERCache {
-  private readonly cache;
-  private readonly maxEntries;
-  private readonly defaultTtl;
-  constructor(options?: {
-    maxEntries?: number;
-    defaultTtl?: number;
-  });
-  /** Normalize query for cache key: lowercase, trim, collapse whitespace */
-  static normalizeKey(query: string): string;
-  get(query: string): ERSearchResult[] | undefined;
-  set(query: string, results: ERSearchResult[], ttl?: number): void;
-  /** Invalidate entries matching a topic (exact normalized key match) */
-  invalidate(query: string): boolean;
-  clear(): void;
-  get size(): number;
-  /** Get cache stats */
-  stats(): {
-    size: number;
-    maxEntries: number;
-    defaultTtlMs: number;
-  };
-}
-//#endregion
-export { ERCache };

package/packages/enterprise-bridge/dist/cache.js

@@ -1 +0,0 @@
-var e=class e{cache=new Map;maxEntries;defaultTtl;constructor(e){this.maxEntries=e?.maxEntries??100,this.defaultTtl=e?.defaultTtl??216e5}static normalizeKey(e){return e.toLowerCase().trim().replace(/\s+/g,` `)}get(t){let n=e.normalizeKey(t),r=this.cache.get(n);if(r){if(Date.now()-r.cachedAt>r.ttl){this.cache.delete(n);return}return this.cache.delete(n),this.cache.set(n,r),r.results}}set(t,n,r){let i=e.normalizeKey(t);if(this.cache.size>=this.maxEntries&&!this.cache.has(i)){let e=this.cache.keys().next().value;e!==void 0&&this.cache.delete(e)}this.cache.set(i,{results:n,query:i,cachedAt:Date.now(),ttl:r??this.defaultTtl})}invalidate(t){let n=e.normalizeKey(t);return this.cache.delete(n)}clear(){this.cache.clear()}get size(){return this.cache.size}stats(){return{size:this.cache.size,maxEntries:this.maxEntries,defaultTtlMs:this.defaultTtl}}};export{e as ERCache};

package/packages/enterprise-bridge/dist/er-client.d.ts

@@ -1,37 +0,0 @@
-import { ERBridgeConfig, ERPushRequest, ERPushResponse, ERSearchResult } from "./types.js";
-
-//#region packages/enterprise-bridge/src/er-client.d.ts
-declare class ERClient {
-  private readonly baseUrl;
-  private readonly apiKey;
-  private readonly timeoutMs;
-  private circuitState;
-  private consecutiveFailures;
-  private openUntil;
-  private halfOpenProbeInFlight;
-  private static readonly FAILURE_THRESHOLD;
-  private static readonly RESET_TIMEOUT_MS;
-  constructor(config: ERBridgeConfig);
-  /** Search ER AI Kit */
-  search(query: string, maxResults?: number): Promise<ERSearchResult[]>;
-  /** Push curated knowledge to ER via MCP tools endpoint */
-  push(request: ERPushRequest): Promise<ERPushResponse>;
-  /** Explicit pull from ER (bypasses local search, for cross-repo context) */
-  pull(query: string, maxResults?: number): Promise<ERSearchResult[]>;
-  /** Check ER health */
-  health(): Promise<{
-    healthy: boolean;
-    status?: number;
-  }>;
-  /** Check available MCP tools (verify curated_remember exists) */
-  listTools(): Promise<string[]>;
-  private fetch;
-  private checkCircuit;
-  private recordSuccess;
-  private recordFailure;
-  private backoffMs;
-  private parseRetryAfter;
-  private sleep;
-}
-//#endregion
-export { ERClient };

package/packages/enterprise-bridge/dist/er-client.js

@@ -1 +0,0 @@
-import{ERTransientError as e}from"./types.js";var t=class t{baseUrl;apiKey;timeoutMs;circuitState=`closed`;consecutiveFailures=0;openUntil=0;halfOpenProbeInFlight=!1;static FAILURE_THRESHOLD=3;static RESET_TIMEOUT_MS=6e4;constructor(e){let t=new URL(e.baseUrl);if(t.protocol!==`http:`&&t.protocol!==`https:`)throw Error(`Unsupported protocol: ${t.protocol} — only http/https allowed`);let n=t.hostname===`localhost`||t.hostname===`127.0.0.1`||t.hostname===`::1`;if(t.protocol===`http:`&&!n)throw Error(`Non-TLS (http://) ER endpoints are only allowed for localhost. Use https:// to avoid leaking API keys.`);this.baseUrl=e.baseUrl.replace(/\/+$/,``),this.apiKey=e.apiKey,this.timeoutMs=e.timeoutMs}async search(e,t=5){let n=await this.fetch(`/api/v1/search`,{method:`POST`,body:JSON.stringify({query:e,maxResults:t,generateResponse:!1})});if(!n.ok)throw Error(`ER search failed: ${n.status} ${n.statusText}`);return((await n.json()).sources??[]).map(e=>{let t=typeof e.score==`number`?e.score:void 0,n=typeof e.confidence==`number`?e.confidence:void 0;return{content:e.content,sourcePath:e.metadata?.sourceUri??`unknown`,score:t??n??0,metadata:e.metadata}})}async push(e){let t=await this.fetch(`/mcp/tools`,{method:`POST`,body:JSON.stringify({name:`curated_remember`,arguments:{title:e.title,content:e.content,category:e.category??`conventions`,tags:[...e.tags??[],`pushed-from-kb`]}})});if(!t.ok)return{pushed:!1,status:`failed`,timestamp:new Date().toISOString(),error:`ER push failed: ${t.status} ${t.statusText}`};let n=await t.json();return{pushed:!0,status:`stored`,remotePath:typeof n.path==`string`?n.path:void 0,timestamp:new Date().toISOString()}}async pull(e,t=10){return this.search(e,t)}async health(){try{let e=await this.fetch(`/api/v1/health`,{method:`GET`});return{healthy:e.ok,status:e.status}}catch{return{healthy:!1}}}async listTools(){try{let e=await this.fetch(`/mcp/tools`,{method:`GET`});return e.ok?((await e.json()).tools??[]).map(e=>e.name):[]}catch{return[]}}async fetch(e,t){this.checkCircuit();let n;for(let r=0;r<=2;r++){let i=new AbortController,a=setTimeout(()=>i.abort(),this.timeoutMs);try{let n=await fetch(`${this.baseUrl}${e}`,{...t,headers:{"Content-Type":`application/json`,"X-Api-Key":this.apiKey,"User-Agent":`aikit-enterprise-bridge/1.0`,...t.headers},signal:i.signal});if(n.ok||n.status>=400&&n.status<500&&n.status!==429)return this.recordSuccess(),n;if(r<2){let e=this.parseRetryAfter(n)??this.backoffMs(r);await this.sleep(e);continue}return this.recordFailure(),n}catch(e){n=e,r<2&&await this.sleep(this.backoffMs(r))}finally{clearTimeout(a)}}throw this.recordFailure(),n??Error(`Fetch failed after retries`)}checkCircuit(){if(this.circuitState===`open`)if(Date.now()>=this.openUntil){if(this.halfOpenProbeInFlight)throw new e(`ER circuit breaker is half-open — probe in progress`);this.circuitState=`half-open`,this.halfOpenProbeInFlight=!0}else throw new e(`ER circuit breaker is open — skipping request`)}recordSuccess(){this.consecutiveFailures=0,this.circuitState=`closed`,this.halfOpenProbeInFlight=!1}recordFailure(){this.consecutiveFailures++,this.halfOpenProbeInFlight=!1,this.consecutiveFailures>=t.FAILURE_THRESHOLD&&(this.circuitState=`open`,this.openUntil=Date.now()+t.RESET_TIMEOUT_MS)}backoffMs(e){let t=500*3**e,n=t*.25*(Math.random()*2-1);return Math.round(t+n)}parseRetryAfter(e){let t=e.headers.get(`Retry-After`);if(!t)return;let n=Number(t);if(!Number.isNaN(n)&&n>=0)return Math.min(n*1e3,3e4)}sleep(e){return new Promise(t=>setTimeout(t,e))}};export{t as ERClient};

package/packages/enterprise-bridge/dist/evolution-collector.d.ts

@@ -1,62 +0,0 @@
-//#region packages/enterprise-bridge/src/evolution-collector.d.ts
-/** Evolution data collector — tracks usage metrics for LLM review */
-interface EvolutionMetrics {
-  /** Search metrics */
-  search: {
-    totalSearches: number;
-    erFallbackCount: number;
-    erFallbackRate: number;
-    erCacheHitCount: number;
-    erCacheHitRate: number;
-    topMissedQueries: Array<{
-      query: string;
-      count: number;
-    }>;
-  };
-  /** Push metrics */
-  push: {
-    totalPushes: number;
-    successCount: number;
-    failCount: number;
-    pushRate: number; /** Classification match rate — how often rules fired vs knowledge stored */
-    classificationMatchRate: number; /** Push acceptance rate — how often LLM decided to push after recommendation */
-    pushAcceptanceRate: number;
-  };
-  /** Rule effectiveness */
-  rules: {
-    matchCounts: Record<string, number>;
-    pushCounts: Record<string, number>; /** Rules that fire often but rarely lead to pushes (potential false positives) */
-    lowConversionRules: Array<{
-      ruleId: string;
-      matchCount: number;
-      pushCount: number;
-      conversionRate: number;
-    }>;
-  };
-  /** Summary period */
-  period: {
-    startedAt: string;
-    queriedAt: string;
-    totalEvents: number;
-  };
-}
-declare class EvolutionCollector {
-  private searchEvents;
-  private classificationEvents;
-  private pushEvents;
-  private readonly startedAt;
-  constructor();
-  /** Record a search event */
-  recordSearch(query: string, erFallbackTriggered: boolean, erCacheHit: boolean): void;
-  /** Record a classification event (when remember returns classification signals) */
-  recordClassification(entryTitle: string, matchingRuleIds: string[], pushRecommended: boolean): void;
-  /** Record a push event */
-  recordPush(entryId: string, success: boolean, ruleId?: string): void;
-  /** Get aggregated metrics for LLM review */
-  getMetrics(): EvolutionMetrics;
-  /** Reset all collected data */
-  reset(): void;
-  private trimEvents;
-}
-//#endregion
-export { EvolutionCollector, EvolutionMetrics };

package/packages/enterprise-bridge/dist/evolution-collector.js

@@ -1 +0,0 @@
-var e=class{searchEvents=[];classificationEvents=[];pushEvents=[];startedAt;constructor(){this.startedAt=new Date().toISOString()}recordSearch(e,t,n){this.searchEvents.push({query:e.toLowerCase().trim(),erFallbackTriggered:t,erCacheHit:n,timestamp:Date.now()}),this.trimEvents()}recordClassification(e,t,n){this.classificationEvents.push({entryTitle:e,matchingRuleIds:t,pushRecommended:n,timestamp:Date.now()}),this.trimEvents()}recordPush(e,t,n){this.pushEvents.push({entryId:e,ruleId:n,success:t,timestamp:Date.now()}),this.trimEvents()}getMetrics(){let e=this.searchEvents.length,t=this.searchEvents.filter(e=>e.erFallbackTriggered).length,n=this.searchEvents.filter(e=>e.erCacheHit).length,r=new Map;for(let e of this.searchEvents)e.erFallbackTriggered&&r.set(e.query,(r.get(e.query)??0)+1);let i=[...r.entries()].sort((e,t)=>t[1]-e[1]).slice(0,20).map(([e,t])=>({query:e,count:t})),a=this.pushEvents.length,o=this.pushEvents.filter(e=>e.success).length,s=this.classificationEvents.length,c=this.classificationEvents.filter(e=>e.pushRecommended).length,l={},u={};for(let e of this.classificationEvents)for(let t of e.matchingRuleIds)l[t]=(l[t]??0)+1;for(let e of this.pushEvents)e.ruleId&&(u[e.ruleId]=(u[e.ruleId]??0)+1);let d=Object.entries(l).map(([e,t])=>{let n=u[e]??0;return{ruleId:e,matchCount:t,pushCount:n,conversionRate:t>0?n/t:0}}).filter(e=>e.matchCount>=3&&e.conversionRate<.3).sort((e,t)=>e.conversionRate-t.conversionRate);return{search:{totalSearches:e,erFallbackCount:t,erFallbackRate:e>0?t/e:0,erCacheHitCount:n,erCacheHitRate:t>0?n/t:0,topMissedQueries:i},push:{totalPushes:a,successCount:o,failCount:a-o,pushRate:s>0?a/s:0,classificationMatchRate:s>0?c/s:0,pushAcceptanceRate:c>0?a/c:0},rules:{matchCounts:l,pushCounts:u,lowConversionRules:d},period:{startedAt:this.startedAt,queriedAt:new Date().toISOString(),totalEvents:this.searchEvents.length+this.classificationEvents.length+this.pushEvents.length}}}reset(){this.searchEvents=[],this.classificationEvents=[],this.pushEvents=[]}trimEvents(){this.searchEvents.length>500&&(this.searchEvents=this.searchEvents.slice(-500)),this.classificationEvents.length>500&&(this.classificationEvents=this.classificationEvents.slice(-500)),this.pushEvents.length>500&&(this.pushEvents=this.pushEvents.slice(-500))}};export{e as EvolutionCollector};

package/packages/enterprise-bridge/dist/policy-store.d.ts

@@ -1,45 +0,0 @@
-//#region packages/enterprise-bridge/src/policy-store.d.ts
-/** A single classification rule */
-interface ClassificationRule {
-  id: string;
-  patterns: string[];
-  category: string;
-  pushWeight: number;
-  description: string;
-  examples: string[];
-  autoPush: false;
-  enabled: boolean;
-  createdAt: string;
-  updatedAt: string;
-}
-/** Classification result for a knowledge entry */
-interface ClassificationResult {
-  matchingRules: Array<{
-    ruleId: string;
-    category: string;
-    pushWeight: number;
-    matchedPatterns: string[];
-  }>;
-  pushRecommended: boolean;
-  maxPushWeight: number;
-}
-declare class PolicyStore {
-  private rules;
-  private readonly rulesPath;
-  constructor(curatedPath: string);
-  /** Classify a knowledge entry against all enabled rules */
-  classify(title: string, content: string, tags: string[]): ClassificationResult;
-  /** Get all rules */
-  getRules(): ClassificationRule[];
-  /** Get a single rule by ID */
-  getRule(ruleId: string): ClassificationRule | undefined;
-  /** Update an existing rule */
-  updateRule(ruleId: string, changes: Partial<Omit<ClassificationRule, 'id' | 'createdAt' | 'autoPush'>>): ClassificationRule | undefined;
-  /** Add a new rule */
-  addRule(rule: Omit<ClassificationRule, 'createdAt' | 'updatedAt' | 'autoPush'>): ClassificationRule;
-  /** Delete a rule */
-  deleteRule(ruleId: string): boolean;
-  private save;
-}
-//#endregion
-export { ClassificationResult, ClassificationRule, PolicyStore };

package/packages/enterprise-bridge/dist/policy-store.js

@@ -1 +0,0 @@
-import{existsSync as e,mkdirSync as t,readFileSync as n,writeFileSync as r}from"node:fs";import{join as i}from"node:path";import{createLogger as a}from"../../core/dist/index.js";const o=a(`bridge`),s=()=>new Date().toISOString(),c=[{id:`cross-repo-contract`,patterns:[`contract`,`interface`,`api`,`event schema`,`publishes`,`subscribes`],category:`contract`,pushWeight:.8,description:`Knowledge describing cross-service interfaces`,examples:[`Service X publishes OrderCreated event with fields...`],autoPush:!1,enabled:!0,createdAt:s(),updatedAt:s()},{id:`architecture-decision`,patterns:[`decided`,`chose`,`tradeoff`,`adr`,`because we need`],category:`decision`,pushWeight:.7,description:`Architecture decisions that affect the ecosystem`,examples:[`We decided to use event sourcing because...`],autoPush:!1,enabled:!0,createdAt:s(),updatedAt:s()},{id:`shared-pattern`,patterns:[`pattern`,`convention`,`standard`,`guideline`,`always use`],category:`pattern`,pushWeight:.6,description:`Patterns and conventions that maintain consistency across repos`,examples:[`Always use the Result type for error handling...`],autoPush:!1,enabled:!0,createdAt:s(),updatedAt:s()},{id:`company-term`,patterns:[`means`,`defined as`,`acronym`,`refers to`],category:`glossary`,pushWeight:.7,description:`Shared vocabulary and terminology definitions`,examples:[`DDD means Domain-Driven Design in our context...`],autoPush:!1,enabled:!0,createdAt:s(),updatedAt:s()},{id:`implementation-detail`,patterns:[`private`,`internal`,`helper`,`todo`,`hack`,`workaround`],category:`local-only`,pushWeight:0,description:`Local-only implementation details — never push`,examples:[`TODO: refactor this helper`,`Internal workaround for...`],autoPush:!1,enabled:!0,createdAt:s(),updatedAt:s()}];var l=class{rules=[];rulesPath;constructor(r){let a=i(r,`_policy`);if(this.rulesPath=i(a,`rules.json`),e(a)||t(a,{recursive:!0}),e(this.rulesPath))try{let e=n(this.rulesPath,`utf-8`),t=JSON.parse(e);if(!Array.isArray(t))throw Error(`rules.json must be an array`);for(let e of t)if(typeof e!=`object`||!e||typeof e.id!=`string`||!Array.isArray(e.patterns)||typeof e.category!=`string`||typeof e.pushWeight!=`number`)throw Error(`Invalid rule: ${JSON.stringify(e).slice(0,100)}`);this.rules=t}catch{o.warn(`Failed to parse policy rules, resetting to starter set`),this.rules=[...c],this.save()}else this.rules=[...c],this.save()}classify(e,t,n){let r=`${e} ${t} ${n.join(` `)}`.toLowerCase(),i=[];for(let e of this.rules){if(!e.enabled)continue;let t=e.patterns.filter(e=>r.includes(e.toLowerCase()));t.length>0&&i.push({ruleId:e.id,category:e.category,pushWeight:e.pushWeight,matchedPatterns:t})}let a=i.length>0?Math.max(...i.map(e=>e.pushWeight)):0;return{matchingRules:i,pushRecommended:a>=.5,maxPushWeight:a}}getRules(){return[...this.rules]}getRule(e){return this.rules.find(t=>t.id===e)}updateRule(e,t){let n=this.rules.find(t=>t.id===e);if(n)return Object.assign(n,t,{updatedAt:new Date().toISOString(),autoPush:!1}),this.save(),n}addRule(e){if(this.rules.find(t=>t.id===e.id))throw Error(`Rule with id '${e.id}' already exists`);let t=new Date().toISOString(),n={...e,autoPush:!1,createdAt:t,updatedAt:t};return this.rules.push(n),this.save(),n}deleteRule(e){let t=this.rules.findIndex(t=>t.id===e);return t===-1?!1:(this.rules.splice(t,1),this.save(),!0)}save(){r(this.rulesPath,JSON.stringify(this.rules,null,2),`utf-8`)}};export{l as PolicyStore};

package/packages/enterprise-bridge/dist/push-adapter.d.ts

@@ -1,23 +0,0 @@
-import { ERPushRequest, ERPushResponse, ERSyncEntry } from "./types.js";
-import { ERClient } from "./er-client.js";
-
-//#region packages/enterprise-bridge/src/push-adapter.d.ts
-declare class PushAdapter {
-  private readonly client;
-  private readonly syncHistory;
-  private static readonly MAX_HISTORY;
-  constructor(client: ERClient);
-  /** Push a knowledge entry to ER */
-  push(entryId: string, request: ERPushRequest): Promise<ERPushResponse>;
-  /** Get sync history */
-  getHistory(): ERSyncEntry[];
-  /** Get sync status summary */
-  getStatus(): {
-    totalPushed: number;
-    successCount: number;
-    failCount: number;
-    lastPush?: ERSyncEntry;
-  };
-}
-//#endregion
-export { PushAdapter };

package/packages/enterprise-bridge/dist/push-adapter.js

@@ -1 +0,0 @@
-var e=class e{client;syncHistory=[];static MAX_HISTORY=100;constructor(e){this.client=e}async push(t,n){let r=await this.client.push(n);for(this.syncHistory.push({entryId:t,title:n.title,pushedAt:r.timestamp,status:r.status,remotePath:r.remotePath});this.syncHistory.length>e.MAX_HISTORY;)this.syncHistory.shift();return r}getHistory(){return[...this.syncHistory]}getStatus(){let e=this.syncHistory.filter(e=>e.status===`stored`).length;return{totalPushed:this.syncHistory.length,successCount:e,failCount:this.syncHistory.length-e,lastPush:this.syncHistory.at(-1)}}};export{e as PushAdapter};

package/packages/enterprise-bridge/dist/result-merger.d.ts

@@ -1,14 +0,0 @@
-import { ERSearchResult, MergedSearchResult } from "./types.js";
-import { SearchResult } from "../../core/dist/index.js";
-
-//#region packages/enterprise-bridge/src/result-merger.d.ts
-/**
- * Merge local and ER results using local-first interleaving.
- *
- * Local RRF scores (~0.01-0.05) and ER raw similarity scores (~0.3-0.9) are on
- * incomparable scales. Instead of sorting both together (which would always rank
- * ER above local), we preserve local ordering, deduplicate, then append ER results.
- */
-declare function mergeResults(localResults: SearchResult[], erResults: ERSearchResult[], limit: number): MergedSearchResult[];
-//#endregion
-export { mergeResults };

package/packages/enterprise-bridge/dist/result-merger.js

@@ -1 +0,0 @@
-function e(e){return{content:e.record.content,sourcePath:e.record.sourcePath,score:e.score,source:`local`,startLine:e.record.startLine,endLine:e.record.endLine,contentType:e.record.contentType,headingPath:e.record.headingPath,origin:e.record.origin,category:e.record.category,tags:e.record.tags}}function t(e){return{content:e.content,sourcePath:e.sourcePath,score:e.score,source:`er`,metadata:e.metadata}}function n(e){return`${e.slice(0,200).replace(/\s+/g,` `)}:${e.length}`}function r(r,i,a){let o=new Set,s=[];for(let t of r){let r=n(t.record.content);o.has(r)||(o.add(r),s.push(e(t)))}let c=[...i].sort((e,t)=>t.score-e.score);for(let e of c){let r=n(e.content);o.has(r)||(o.add(r),s.push(t(e)))}return s.slice(0,a)}export{r as mergeResults};

package/packages/enterprise-bridge/dist/types.d.ts

@@ -1,81 +0,0 @@
-//#region packages/enterprise-bridge/src/types.d.ts
-/** ER bridge configuration (subset of KBConfig.er) */
-interface ERBridgeConfig {
-  enabled: boolean;
-  baseUrl: string;
-  apiKey: string;
-  timeoutMs: number;
-  cacheTtlMs: number;
-  cacheMaxEntries: number;
-  fallbackThreshold: number;
-}
-/** Result from ER search API */
-interface ERSearchResult {
-  content: string;
-  sourcePath: string;
-  score: number;
-  metadata?: Record<string, unknown>;
-}
-/** Response from ER search API (POST /api/v1/search) */
-interface ERSearchResponse {
-  sources: Array<{
-    content: string;
-    metadata: Record<string, string>;
-    score?: number;
-    confidence?: number;
-  }>;
-  query?: string;
-  searchMode?: string;
-}
-/** Push request to ER */
-interface ERPushRequest {
-  title: string;
-  content: string;
-  category?: string;
-  tags?: string[];
-}
-/** Push response from ER */
-interface ERPushResponse {
-  pushed: boolean;
-  status: 'stored' | 'failed';
-  remotePath?: string;
-  timestamp: string;
-  error?: string;
-}
-/** Transient ER error (429, 5xx, network) — retries exhausted but not a permanent failure */
-declare class ERTransientError extends Error {
-  readonly statusCode?: number | undefined;
-  constructor(message: string, statusCode?: number | undefined);
-}
-/** Sync status entry for tracking push history */
-interface ERSyncEntry {
-  entryId: string;
-  title: string;
-  pushedAt: string;
-  status: 'stored' | 'failed';
-  remotePath?: string;
-}
-/** Cache entry wrapping ER search results */
-interface ERCacheEntry {
-  results: ERSearchResult[];
-  query: string;
-  cachedAt: number;
-  ttl: number;
-}
-/** Merged search result with source provenance */
-interface MergedSearchResult {
-  content: string;
-  sourcePath: string;
-  score: number;
-  source: 'local' | 'er';
-  startLine?: number;
-  endLine?: number;
-  contentType?: string;
-  headingPath?: string;
-  origin?: string;
-  category?: string;
-  tags?: string[];
-  metadata?: Record<string, unknown>;
-}
-//#endregion
-export { ERBridgeConfig, ERCacheEntry, ERPushRequest, ERPushResponse, ERSearchResponse, ERSearchResult, ERSyncEntry, ERTransientError, MergedSearchResult };

package/packages/enterprise-bridge/dist/types.js

@@ -1 +0,0 @@
-var e=class extends Error{constructor(e,t){super(e),this.statusCode=t,this.name=`ERTransientError`}};export{e as ERTransientError};

package/packages/flows/dist/adapters/claude-plugin.d.ts

@@ -1,25 +0,0 @@
-import { FlowFormatAdapter, FlowManifest, FlowParseOptions } from "../types.js";
-
-//#region packages/flows/src/adapters/claude-plugin.d.ts
-declare class ClaudePluginAdapter implements FlowFormatAdapter {
-  readonly format: "claude-plugin";
-  detect(sourceDir: string): boolean;
-  parse(sourceDir: string, options?: FlowParseOptions): Promise<FlowManifest>;
-  private readPluginJson;
-  private readString;
-  private discoverSteps;
-  private readStep;
-  /**
-   * Copy supporting subdirectories (references/, assets/, scripts/) from
-   * skills/<step>/ to steps/<step>/ so that relative paths inside the
-   * step README.md resolve correctly at runtime.
-   *
-   * When `force` is true, existing copies are replaced (used during updates).
-   */
-  private syncStepAssets;
-  private materializeNativeSteps;
-  private buildStepReadme;
-  private discoverAgents;
-}
-//#endregion
-export { ClaudePluginAdapter };

package/packages/flows/dist/adapters/claude-plugin.js

@@ -1,3 +0,0 @@
-import{cpSync as e,existsSync as t,mkdirSync as n,readFileSync as r,readdirSync as i,rmSync as a,writeFileSync as o}from"node:fs";import{basename as s,join as c}from"node:path";const l=[`spec`,`plan`,`task`,`execute`,`verify`];function u(e){let t=e.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);if(!t)return{data:{},body:e};let n={};for(let e of t[1].split(/\r?\n/)){let t=e.indexOf(`:`);t>0&&(n[e.slice(0,t).trim()]=e.slice(t+1).trim().replace(/^["']|["']$/g,``))}return{data:n,body:t[2]}}function d(e){return e.split(/[-_]/g).filter(Boolean).map(e=>e.charAt(0).toUpperCase()+e.slice(1)).join(` `)}function f(e){let t=l.indexOf(e);return t===-1?1/0:t}var p=class{format=`claude-plugin`;detect(e){return t(c(e,`.claude-plugin`,`plugin.json`))}async parse(e,t){let n=this.readPluginJson(e),r=this.discoverSteps(e);await this.materializeNativeSteps(e,r,t);let i=this.discoverAgents(e),a=r.map(({step:e})=>e);return{name:this.readString(n.name)??s(e),version:this.readString(n.version)??`1.0.0`,description:this.readString(n.description)??``,author:this.readString(n.author),steps:a,agents:i,artifacts_dir:`.spec`,install:[]}}readPluginJson(e){let t=c(e,`.claude-plugin`,`plugin.json`);return JSON.parse(r(t,`utf-8`))}readString(e){return typeof e==`string`?e:void 0}discoverSteps(e){let n=c(e,`skills`);if(!t(n))return[];let r=i(n,{withFileTypes:!0}).filter(e=>e.isDirectory()).map(e=>e.name).map(t=>this.readStep(e,t)).filter(e=>e!==null).sort((e,t)=>{let n=Number(e.metadata.order),r=Number(t.metadata.order),i=Number.isFinite(n),a=Number.isFinite(r);if(i&&a)return n-r;if(i)return-1;if(a)return 1;let o=f(e.step.id),s=f(t.step.id);return o===s?e.step.id.localeCompare(t.step.id):o-s});return r.map((e,t)=>({...e,step:{...e.step,requires:t>0?[r[t-1].step.id]:[]}}))}readStep(e,n){let i=c(e,`skills`,n,`SKILL.md`);if(!t(i))return null;let a=r(i,`utf-8`),{data:o,body:s}=u(a),l=o.name||d(n),f=o.description||`${l} step`;return{step:{id:n,name:l,instruction:`steps/${n}/README.md`,produces:[`${n}.md`],requires:[],agents:[],description:f},metadata:o,content:a,body:s}}syncStepAssets(n,r,i){let o=[`references`,`assets`,`scripts`];for(let s of r)for(let r of o){let o=c(n,`skills`,s.id,r),l=c(n,`steps`,s.id,r);if(t(o)){if(t(l)){if(!i)continue;a(l,{recursive:!0,force:!0})}e(o,l,{recursive:!0})}}}async materializeNativeSteps(e,t,r){for(let i of t){let t=c(e,`steps`,i.step.id);n(t,{recursive:!0});let a=r?.transform?await r.transform({content:i.content,sourceFormat:`claude-plugin`,stepName:i.step.id,metadata:i.metadata}):this.buildStepReadme(i.step.name,i.step.description,i.body);o(c(t,`README.md`),a,`utf-8`)}this.syncStepAssets(e,t.map(({step:e})=>e),r?.forceAssetSync)}buildStepReadme(e,t,n){return[`# ${e}`,``,t,``,`---`,``,n.trim()].join(`
-`).trimEnd().concat(`
-`)}discoverAgents(e){let n=c(e,`agents`);return t(n)?i(n,{withFileTypes:!0}).filter(e=>e.isFile()&&e.name.endsWith(`.md`)).map(e=>`agents/${e.name}`):[]}};export{p as ClaudePluginAdapter};

package/packages/flows/dist/adapters/copilot.d.ts

@@ -1,12 +0,0 @@
-import { FlowFormatAdapter, FlowManifest, FlowParseOptions } from "../types.js";
-
-//#region packages/flows/src/adapters/copilot.d.ts
-declare class CopilotAdapter implements FlowFormatAdapter {
-  readonly format: "copilot";
-  detect(sourceDir: string): boolean;
-  parse(sourceDir: string, options?: FlowParseOptions): Promise<FlowManifest>;
-  private getStepId;
-  private materializeSteps;
-}
-//#endregion
-export { CopilotAdapter };

package/packages/flows/dist/adapters/copilot.js

@@ -1 +0,0 @@
-import{existsSync as e,mkdirSync as t,readFileSync as n,readdirSync as r,writeFileSync as i}from"node:fs";import{basename as a,join as o}from"node:path";var s=class{format=`copilot`;detect(t){return e(o(t,`.github`,`agents`))}async parse(e,t){let n=r(o(e,`.github`,`agents`),{withFileTypes:!0}).filter(e=>e.isFile()&&e.name.endsWith(`.md`)).map(e=>`.github/agents/${e.name}`),i=n.map(e=>this.getStepId(e)),s=n.map((e,t)=>{let n=i[t];return{id:n,name:n.charAt(0).toUpperCase()+n.slice(1),instruction:`steps/${n}/README.md`,produces:[`${n}.md`],requires:t>0?[i[t-1]]:[],agents:[e],description:`${n} agent step`}});return await this.materializeSteps(e,s,t),{name:a(e),version:`1.0.0`,description:`Copilot agents flow from ${a(e)}`,steps:s,agents:n,artifacts_dir:`.spec`,install:[]}}getStepId(e){return a(e,`.md`).toLowerCase().replace(/\.agent$/,``)}async materializeSteps(e,r,a){for(let s of r){let r=s.agents[0];if(!r)continue;let c=n(o(e,r),`utf-8`),l=o(e,`steps`,s.id),u=o(l,`README.md`);t(l,{recursive:!0}),i(u,a?.transform?await a.transform({content:c,sourceFormat:`copilot`,stepName:s.id,metadata:{sourcePath:r,displayName:s.name}}):`# ${s.name}\n\n${c}`,`utf-8`)}}};export{s as CopilotAdapter};

package/packages/flows/dist/adapters/index.d.ts

@@ -1,12 +0,0 @@
-import { FlowFormat, FlowFormatAdapter } from "../types.js";
-import { ClaudePluginAdapter } from "./claude-plugin.js";
-import { CopilotAdapter } from "./copilot.js";
-import { NativeAdapter } from "./native.js";
-import { OpenSpecAdapter } from "./openspec.js";
-
-//#region packages/flows/src/adapters/index.d.ts
-declare function detectFormat(sourceDir: string): FlowFormat | null;
-declare function getAdapter(format: FlowFormat): FlowFormatAdapter;
-declare function getAdapterForSource(sourceDir: string): FlowFormatAdapter | null;
-//#endregion
-export { ClaudePluginAdapter, CopilotAdapter, NativeAdapter, OpenSpecAdapter, detectFormat, getAdapter, getAdapterForSource };

package/packages/flows/dist/adapters/index.js

@@ -1 +0,0 @@
-import{ClaudePluginAdapter as e}from"./claude-plugin.js";import{CopilotAdapter as t}from"./copilot.js";import{NativeAdapter as n}from"./native.js";import{OpenSpecAdapter as r}from"./openspec.js";const i=[new n,new e,new t,new r];function a(e){for(let t of i)if(t.detect(e))return t.format;return null}function o(e){let t=i.find(t=>t.format===e);if(!t)throw Error(`No adapter for format: ${e}`);return t}function s(e){for(let t of i)if(t.detect(e))return t;return null}export{e as ClaudePluginAdapter,t as CopilotAdapter,n as NativeAdapter,r as OpenSpecAdapter,a as detectFormat,o as getAdapter,s as getAdapterForSource};