trellis 2.1.7 → 2.1.9

package/dist/decisions/hooks.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Decision Hook Registry
+ *
+ * External agent harnesses register pre/post hooks to enrich decision traces
+ * with rationale, alternatives, prompt context, etc.
+ */
+import type { DecisionPreHook, DecisionPostHook, DecisionContext, DecisionEnrichment } from './types.js';
+export declare class HookRegistry {
+    private preHooks;
+    private postHooks;
+    /**
+     * Register a pre-hook that runs before a tool handler.
+     */
+    registerPreHook(hook: DecisionPreHook): void;
+    /**
+     * Register a post-hook that runs after a tool handler.
+     */
+    registerPostHook(hook: DecisionPostHook): void;
+    /**
+     * Remove a pre-hook by name.
+     */
+    removePreHook(name: string): void;
+    /**
+     * Remove a post-hook by name.
+     */
+    removePostHook(name: string): void;
+    /**
+     * Get all pre-hooks matching a tool name.
+     */
+    getPreHooks(toolName: string): DecisionPreHook[];
+    /**
+     * Get all post-hooks matching a tool name.
+     */
+    getPostHooks(toolName: string): DecisionPostHook[];
+    /**
+     * Run all matching pre-hooks and merge their contexts.
+     */
+    runPreHooks(toolName: string, input: Record<string, unknown>): Promise<DecisionContext>;
+    /**
+     * Run all matching post-hooks and merge their enrichments.
+     */
+    runPostHooks(toolName: string, input: Record<string, unknown>, output: unknown, preContext: DecisionContext): Promise<DecisionEnrichment>;
+    /**
+     * Clear all hooks.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=hooks.d.ts.map

package/dist/decisions/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/decisions/hooks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAMpB,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,SAAS,CAA0B;IAE3C;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;IAI5C;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAI9C;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIjC;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIlC;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE;IAIhD;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAMlD;;OAEG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,eAAe,CAAC;IAmB3B;;OAEG;IACG,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,eAAe,GAC1B,OAAO,CAAC,kBAAkB,CAAC;IAkC9B;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}

package/dist/decisions/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Decision Traces Module
+ *
+ * Auto-captures agent decision traces from MCP tool invocations as
+ * first-class Decision entities in the EAV store.
+ *
+ * Public API:
+ * - recordDecision()   — persist a decision as a vcs:decisionRecord op
+ * - queryDecisions()   — filter/list decisions from the EAV store
+ * - getDecisionChain() — all decisions that affected a given entity
+ * - HookRegistry       — pre/post hook registration for external harnesses
+ * - wrapToolHandler()  — MCP middleware for auto-capture
+ */
+export { HookRegistry } from './hooks.js';
+export { wrapToolHandler, type ToolHandler, type DecisionRecorder, type AutoCaptureOpts, } from './auto-capture.js';
+export type { Decision, DecisionInput, DecisionFilter, DecisionContext, DecisionEnrichment, DecisionPreHook, DecisionPostHook, } from './types.js';
+import type { VcsOp } from '../vcs/types.js';
+import type { EngineContext } from '../vcs/engine-context.js';
+import type { Decision, DecisionInput, DecisionFilter } from './types.js';
+/**
+ * Record a decision trace as a vcs:decisionRecord op.
+ */
+export declare function recordDecision(ctx: EngineContext, rootPath: string, input: DecisionInput): Promise<VcsOp>;
+/**
+ * Query decisions with optional filters.
+ */
+export declare function queryDecisions(ctx: EngineContext, filter?: DecisionFilter): Decision[];
+/**
+ * Get all decisions that affected a given entity (the decision chain).
+ */
+export declare function getDecisionChain(ctx: EngineContext, entityId: string): Decision[];
+/**
+ * Get a single decision by ID.
+ */
+export declare function getDecision(ctx: EngineContext, id: string): Decision | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/decisions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/decisions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EACL,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,QAAQ,EACR,aAAa,EACb,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAMpB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA6B1E;;GAEG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,KAAK,CAAC,CAkChB;AAoDD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,aAAa,EAClB,MAAM,CAAC,EAAE,cAAc,GACtB,QAAQ,EAAE,CAsDZ;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,MAAM,GACf,QAAQ,EAAE,CAqBZ;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAO3E"}

package/dist/decisions/types.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Decision Trace Types
+ *
+ * Types for auto-captured agent decision traces. Decisions are first-class
+ * entities in the EAV store, emitted automatically from MCP tool calls
+ * and enrichable via pre/post hooks.
+ */
+export interface Decision {
+    id: string;
+    toolName: string;
+    input?: Record<string, unknown>;
+    outputSummary?: string;
+    context?: string;
+    rationale?: string;
+    alternatives?: string[];
+    confidence?: number;
+    createdAt?: string;
+    createdBy?: string;
+    /** IDs of related entities (issues, files, milestones) affected by this decision */
+    relatedEntities: string[];
+    custom?: Record<string, unknown>;
+}
+export interface DecisionInput {
+    toolName: string;
+    input?: Record<string, unknown>;
+    outputSummary?: string;
+    context?: string;
+    rationale?: string;
+    alternatives?: string[];
+    confidence?: number;
+    /** Entity IDs this decision relates to (e.g. "issue:TRL-5") */
+    relatedEntities?: string[];
+    custom?: Record<string, unknown>;
+}
+export interface DecisionFilter {
+    /** Filter by MCP tool name (glob-like, e.g. "trellis_issue_*") */
+    toolPattern?: string;
+    /** Filter by agent ID */
+    agentId?: string;
+    /** Only decisions after this ISO timestamp */
+    since?: string;
+    /** Only decisions before this ISO timestamp */
+    until?: string;
+    /** Only decisions referencing this entity */
+    entityId?: string;
+    /** Max results */
+    limit?: number;
+}
+export interface DecisionContext {
+    prompt?: string;
+    conversationId?: string;
+    agentModel?: string;
+    custom?: Record<string, unknown>;
+}
+export interface DecisionEnrichment {
+    rationale?: string;
+    alternatives?: string[];
+    confidence?: number;
+    relatedEntities?: string[];
+    custom?: Record<string, unknown>;
+}
+export interface DecisionPreHook {
+    name: string;
+    /** Which tools to intercept — string (glob) or RegExp */
+    toolPattern: string | RegExp;
+    handler: (toolName: string, input: Record<string, unknown>) => Promise<DecisionContext>;
+}
+export interface DecisionPostHook {
+    name: string;
+    toolPattern: string | RegExp;
+    handler: (toolName: string, input: Record<string, unknown>, output: unknown, preContext: DecisionContext) => Promise<DecisionEnrichment>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/decisions/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/decisions/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAMD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAMD,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,OAAO,EAAE,CACP,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC3B,OAAO,CAAC,eAAe,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,OAAO,EAAE,CACP,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,eAAe,KACxB,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAClC"}

package/dist/deploy-99j5dc9c.js

@@ -0,0 +1,9 @@
+// @bun
+import {
+  deploy
+} from "./index-hgd30epa.js";
+import"./index-xzym9w0m.js";
+import"./index-a76rekgs.js";
+export {
+  deploy
+};

package/dist/embeddings/auto-embed.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Auto-Embedding Middleware
+ *
+ * Kernel middleware that automatically embeds entity facts and links
+ * on graph mutations. Runs after successful ops to index new/changed
+ * content into the vector store.
+ *
+ * @module trellis/embeddings
+ */
+import type { KernelMiddleware } from '../core/kernel/middleware.js';
+import type { Embedder } from './search.js';
+import { VectorStore } from './store.js';
+export interface AutoEmbedOptions {
+    /** Path to the vector store SQLite database. */
+    dbPath: string;
+    /** Custom embedder function (default: transformers.js embed). */
+    embedFn?: Embedder;
+    /** Whether to embed facts individually (default: false — only entity summaries). */
+    embedIndividualFacts?: boolean;
+}
+/**
+ * Creates a kernel middleware that auto-embeds entities on mutation.
+ *
+ * On addFacts/addLinks: embeds entity summaries into the vector store.
+ * On deleteFacts/deleteLinks: removes stale embeddings.
+ */
+export declare function createAutoEmbedMiddleware(options: AutoEmbedOptions): KernelMiddleware & {
+    close: () => void;
+};
+export interface RAGContext {
+    /** The original query. */
+    query: string;
+    /** Retrieved chunks ranked by relevance. */
+    chunks: Array<{
+        content: string;
+        entityId: string;
+        score: number;
+        chunkType: string;
+    }>;
+    /** Total token estimate (rough: 1 token ≈ 4 chars). */
+    estimatedTokens: number;
+}
+/**
+ * Build a RAG context from a natural language query.
+ * Searches the vector store and assembles ranked context chunks.
+ */
+export declare function buildRAGContext(query: string, vectorStore: VectorStore, embedFn?: Embedder, options?: {
+    maxChunks?: number;
+    maxTokens?: number;
+    minScore?: number;
+}): Promise<RAGContext>;
+//# sourceMappingURL=auto-embed.d.ts.map

package/dist/embeddings/auto-embed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-embed.d.ts","sourceRoot":"","sources":["../../src/embeddings/auto-embed.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAuC,MAAM,8BAA8B,CAAC;AAG1G,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAwCzC,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,oFAAoF;IACpF,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,GAAG;IAAE,KAAK,EAAE,MAAM,IAAI,CAAA;CAAE,CAwB7G;AA8FD,MAAM,WAAW,UAAU;IACzB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,MAAM,EAAE,KAAK,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,uDAAuD;IACvD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,WAAW,EACxB,OAAO,GAAE,QAAgB,EACzB,OAAO,CAAC,EAAE;IACR,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,OAAO,CAAC,UAAU,CAAC,CAgCrB"}

package/dist/embeddings/chunker.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Text Chunker
+ *
+ * Strategies for splitting different content types into embeddable chunks.
+ * Short text is embedded as-is; markdown is split by headings; code entities
+ * are chunked by declaration; large text uses sliding window.
+ *
+ * @see TRL-19
+ */
+import type { ChunkMeta } from './types.js';
+/**
+ * Chunk an issue into embeddable pieces.
+ */
+export declare function chunkIssue(issue: {
+    id: string;
+    title?: string;
+    description?: string;
+}): ChunkMeta[];
+/**
+ * Chunk a decision trace into embeddable pieces.
+ * Combines tool name, rationale, context, and output summary.
+ */
+export declare function chunkDecision(decision: {
+    id: string;
+    toolName: string;
+    rationale?: string;
+    context?: string;
+    outputSummary?: string;
+}): ChunkMeta[];
+/**
+ * Chunk a milestone message.
+ */
+export declare function chunkMilestone(milestone: {
+    id: string;
+    message?: string;
+}): ChunkMeta[];
+/**
+ * Chunk a markdown file by heading sections.
+ * Each H1/H2/H3 section becomes a separate chunk.
+ * Sections that exceed MAX_CHUNK_CHARS get sliding-window split.
+ */
+export declare function chunkMarkdown(filePath: string, content: string): ChunkMeta[];
+/**
+ * Chunk code entities (functions, classes, interfaces) from a parsed file.
+ * Each declaration's signature + doc-comment becomes a chunk.
+ */
+export declare function chunkCodeEntities(filePath: string, declarations: Array<{
+    id: string;
+    name: string;
+    kind: string;
+    signature: string;
+    docComment?: string;
+}>): ChunkMeta[];
+/**
+ * Chunk doc-comments extracted from source files.
+ */
+export declare function chunkDocComments(filePath: string, comments: Array<{
+    line: number;
+    text: string;
+}>): ChunkMeta[];
+/**
+ * Chunk a summary.md or similar short-to-medium text file.
+ */
+export declare function chunkSummary(filePath: string, content: string): ChunkMeta[];
+/**
+ * Auto-detect file type and chunk accordingly.
+ */
+export declare function chunkFile(filePath: string, content: string): ChunkMeta[];
+/**
+ * Split long text into overlapping windows.
+ */
+export declare function slidingWindow(text: string): string[];
+//# sourceMappingURL=chunker.d.ts.map

package/dist/embeddings/chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.d.ts","sourceRoot":"","sources":["../../src/embeddings/chunker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,YAAY,CAAC;AAevD;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,SAAS,EAAE,CAyBd;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,SAAS,EAAE,CAmBd;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,SAAS,EAAE,CAYd;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAsC5E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,KAAK,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC,GACD,SAAS,EAAE,CAuBb;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAC9C,SAAS,EAAE,CAsBb;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAwB3E;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAkBxE;AAsCD;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAYpD"}

package/dist/embeddings/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Embeddings Module — Public API
+ *
+ * Provides semantic embedding and vector search for TrellisVCS entities.
+ *
+ * @see TRL-18
+ */
+export type { ChunkType, ChunkMeta, EmbeddingRecord, SearchResult, SearchOptions, EmbeddingModelConfig, } from './types.js';
+export { DEFAULT_MODEL_CONFIG } from './types.js';
+export { embed, embedBatch, loadModel, resetModel } from './model.js';
+export { VectorStore, cosineSimilarity } from './store.js';
+export { EmbeddingManager } from './search.js';
+export type { SearchableEngine, Embedder } from './search.js';
+export { createAutoEmbedMiddleware, buildRAGContext } from './auto-embed.js';
+export type { AutoEmbedOptions, RAGContext } from './auto-embed.js';
+export type { GraphChunkType } from './types.js';
+export { chunkIssue, chunkMilestone, chunkDecision, chunkMarkdown, chunkCodeEntities, chunkDocComments, chunkSummary, chunkFile, slidingWindow, } from './chunker.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/embeddings/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/embeddings/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,SAAS,EACT,SAAS,EACT,eAAe,EACf,YAAY,EACZ,aAAa,EACb,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGlD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGtE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG9D,OAAO,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC7E,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGpE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,OAAO,EACL,UAAU,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,aAAa,GACd,MAAM,cAAc,CAAC"}

package/dist/embeddings/model.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Embedding Model
+ *
+ * Lazy-loads @huggingface/transformers (v3+) with all-MiniLM-L6-v2 (384-dim).
+ * Falls back to @xenova/transformers (v2) if the new package is unavailable.
+ * Model is loaded once on first use and cached for subsequent calls.
+ *
+ * @see TRL-18
+ */
+import { EmbeddingModelConfig } from './types.js';
+/**
+ * Load the embedding model lazily. Returns the feature-extraction pipeline.
+ * Subsequent calls return the cached pipeline.
+ */
+export declare function loadModel(config?: EmbeddingModelConfig): Promise<any>;
+/**
+ * Generate an embedding vector for the given text.
+ * Returns a Float32Array of length `config.dimension` (default: 384).
+ */
+export declare function embed(text: string, config?: EmbeddingModelConfig): Promise<Float32Array>;
+/**
+ * Generate embeddings for multiple texts in a batch.
+ * More efficient than calling embed() individually.
+ */
+export declare function embedBatch(texts: string[], config?: EmbeddingModelConfig): Promise<Float32Array[]>;
+/**
+ * Reset the model singleton. Useful for testing.
+ */
+export declare function resetModel(): void;
+//# sourceMappingURL=model.d.ts.map

package/dist/embeddings/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/embeddings/model.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,oBAAoB,EAAwB,MAAM,YAAY,CAAC;AA2BxE;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,MAAM,GAAE,oBAA2C,GAClD,OAAO,CAAC,GAAG,CAAC,CAoBd;AAED;;;GAGG;AACH,wBAAsB,KAAK,CACzB,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,oBAA2C,GAClD,OAAO,CAAC,YAAY,CAAC,CAKvB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,GAAE,oBAA2C,GAClD,OAAO,CAAC,YAAY,EAAE,CAAC,CAiBzB;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAGjC"}

package/dist/embeddings/search.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Semantic Search Integration
+ *
+ * Connects the TrellisVcsEngine to the embedding system.
+ * Provides reindex (full rebuild) and search (query → ranked results).
+ * The embedder function is pluggable for testing with mock vectors.
+ *
+ * @see TRL-20
+ */
+import type { SearchOptions, SearchResult } from './types.js';
+/** Minimal engine interface — avoids importing the full engine for testability */
+export interface SearchableEngine {
+    getRootPath(): string;
+    trackedFiles(): Array<{
+        path: string;
+        contentHash?: string;
+    }>;
+    listIssues(filters?: any): Array<{
+        id: string;
+        title?: string;
+        description?: string;
+    }>;
+    listMilestones(): Array<{
+        id: string;
+        message?: string;
+    }>;
+    queryDecisions?(): Array<{
+        id: string;
+        toolName: string;
+        rationale?: string;
+        context?: string;
+        outputSummary?: string;
+    }>;
+    parseFile?(filePath: string): any;
+}
+/** Embedder function type — maps text → vector. Pluggable for testing. */
+export type Embedder = (text: string) => Promise<Float32Array>;
+export declare class EmbeddingManager {
+    private store;
+    private embedFn;
+    constructor(dbPath: string, embedFn?: Embedder);
+    /**
+     * Full reindex: clear store, re-chunk all entities, embed, and insert.
+     */
+    reindex(engine: SearchableEngine): Promise<{
+        chunks: number;
+    }>;
+    /**
+     * Incrementally index a single file (on file change).
+     */
+    indexFile(filePath: string, content: string, engine?: SearchableEngine): Promise<number>;
+    /**
+     * Index an issue (on create/update).
+     */
+    indexIssue(issue: {
+        id: string;
+        title?: string;
+        description?: string;
+    }): Promise<number>;
+    /**
+     * Index a milestone (on create).
+     */
+    indexMilestone(milestone: {
+        id: string;
+        message?: string;
+    }): Promise<number>;
+    /**
+     * Semantic search: embed query → vector search → ranked results.
+     */
+    search(query: string, opts?: SearchOptions): Promise<SearchResult[]>;
+    /**
+     * Remove all data for a file.
+     */
+    removeFile(filePath: string): void;
+    /**
+     * Get store statistics.
+     */
+    stats(): {
+        total: number;
+        byType: Record<string, number>;
+    };
+    /**
+     * Close the store.
+     */
+    close(): void;
+}
+//# sourceMappingURL=search.d.ts.map

package/dist/embeddings/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/embeddings/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAcH,OAAO,KAAK,EAGV,aAAa,EACb,YAAY,EACb,MAAM,YAAY,CAAC;AAMpB,kFAAkF;AAClF,MAAM,WAAW,gBAAgB;IAC/B,WAAW,IAAI,MAAM,CAAC;IACtB,YAAY,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9D,UAAU,CAAC,OAAO,CAAC,EAAE,GAAG,GAAG,KAAK,CAAC;QAC/B,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,cAAc,IAAI,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,cAAc,CAAC,IAAI,KAAK,CAAC;QACvB,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC,CAAC;IACH,SAAS,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC;CACnC;AAED,0EAA0E;AAC1E,MAAM,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;AAM/D,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,OAAO,CAAW;gBAEd,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ;IAK9C;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAuFpE;;OAEG;IACG,SAAS,CACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC;IAsDlB;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE;QACtB,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,MAAM,CAAC;IAoBnB;;OAEG;IACG,cAAc,CAAC,SAAS,EAAE;QAC9B,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,MAAM,CAAC;IAoBnB;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAK1E;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIlC;;OAEG;IACH,KAAK,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE;IAO1D;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/embeddings/store.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Embedding Vector Store
+ *
+ * Persistent storage for embedding vectors using bun:sqlite.
+ * Vectors are stored as Float32Array blobs; cosine similarity
+ * is computed in JavaScript for cross-platform portability.
+ *
+ * @see TRL-18
+ */
+import type { ChunkMeta, EmbeddingRecord, SearchOptions, SearchResult } from './types.js';
+export declare class VectorStore {
+    private db;
+    constructor(dbPath: string);
+    /**
+     * Insert or update a chunk with its embedding vector.
+     */
+    upsert(record: EmbeddingRecord): void;
+    /**
+     * Batch upsert multiple records.
+     */
+    upsertBatch(records: EmbeddingRecord[]): void;
+    /**
+     * Delete a chunk and its vector by ID.
+     */
+    delete(id: string): void;
+    /**
+     * Delete all chunks for an entity.
+     */
+    deleteByEntity(entityId: string): void;
+    /**
+     * Delete all chunks associated with a file path.
+     */
+    deleteByFile(filePath: string): void;
+    /**
+     * Get a chunk by ID (without vector).
+     */
+    getChunk(id: string): ChunkMeta | null;
+    /**
+     * Search for chunks similar to the query vector.
+     * Uses brute-force cosine similarity scan.
+     */
+    search(queryVector: Float32Array, opts?: SearchOptions): SearchResult[];
+    /**
+     * Get total count of chunks in the store.
+     */
+    count(): number;
+    /**
+     * Get count by chunk type.
+     */
+    countByType(): Record<string, number>;
+    /**
+     * Clear all data from the store.
+     */
+    clear(): void;
+    /**
+     * Close the database connection.
+     */
+    close(): void;
+}
+/**
+ * Compute cosine similarity between two vectors.
+ * Both vectors should already be normalized (output of mean pooling + normalize).
+ * For normalized vectors, cosine similarity = dot product.
+ */
+export declare function cosineSimilarity(a: Float32Array, b: Float32Array): number;
+//# sourceMappingURL=store.d.ts.map

package/dist/embeddings/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/embeddings/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EACV,SAAS,EAET,eAAe,EACf,aAAa,EACb,YAAY,EACb,MAAM,YAAY,CAAC;AA+BpB,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAW;gBAET,MAAM,EAAE,MAAM;IAO1B;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IA4BrC;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,IAAI;IA+B7C;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKxB;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAetC;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAepC;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAQtC;;;OAGG;IACH,MAAM,CAAC,WAAW,EAAE,YAAY,EAAE,IAAI,GAAE,aAAkB,GAAG,YAAY,EAAE;IAwD3E;;OAEG;IACH,KAAK,IAAI,MAAM;IAOf;;OAEG;IACH,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAarC;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAiBD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,MAAM,CAYzE"}

package/dist/embeddings/types.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Embedding Types
+ *
+ * Types for the semantic embedding and vector search system.
+ *
+ * @see TRL-18
+ */
+export type ChunkType = 'issue_title' | 'issue_desc' | 'milestone_msg' | 'decision_rationale' | 'summary_md' | 'code_entity' | 'doc_comment' | 'markdown';
+export interface ChunkMeta {
+    /** Unique chunk ID, e.g. "issue:TRL-5:title", "file:src/engine.ts:chunk:0" */
+    id: string;
+    /** EAV entity ID this chunk belongs to */
+    entityId: string;
+    /** Original text content */
+    content: string;
+    /** Chunk classification */
+    chunkType: ChunkType;
+    /** Source file path (nullable for non-file entities) */
+    filePath?: string;
+    /** When this chunk was last updated */
+    updatedAt: string;
+}
+export interface EmbeddingRecord extends ChunkMeta {
+    /** 384-dimensional embedding vector */
+    embedding: Float32Array;
+}
+export interface SearchResult {
+    /** Chunk metadata */
+    chunk: ChunkMeta;
+    /** Cosine similarity score (0..1) */
+    score: number;
+}
+export interface SearchOptions {
+    /** Max results to return (default: 10) */
+    limit?: number;
+    /** Filter by chunk type(s) */
+    types?: ChunkType[];
+    /** Filter by file path prefix */
+    filePrefix?: string;
+    /** Minimum similarity threshold (default: 0.0) */
+    minScore?: number;
+}
+export interface EmbeddingModelConfig {
+    /** Model name for transformers.js (default: "Xenova/all-MiniLM-L6-v2") */
+    modelName: string;
+    /** Embedding dimension (default: 384) */
+    dimension: number;
+    /** Cache directory for model files */
+    cacheDir?: string;
+}
+export declare const DEFAULT_MODEL_CONFIG: EmbeddingModelConfig;
+/** New chunk types for generic graph entities */
+export type GraphChunkType = ChunkType | 'entity_summary' | 'entity_fact' | 'entity_link';
+//# sourceMappingURL=types.d.ts.map

package/dist/embeddings/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/embeddings/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,MAAM,SAAS,GACjB,aAAa,GACb,YAAY,GACZ,eAAe,GACf,oBAAoB,GACpB,YAAY,GACZ,aAAa,GACb,aAAa,GACb,UAAU,CAAC;AAEf,MAAM,WAAW,SAAS;IACxB,8EAA8E;IAC9E,EAAE,EAAE,MAAM,CAAC;IACX,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,SAAS,EAAE,SAAS,CAAC;IACrB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,uCAAuC;IACvC,SAAS,EAAE,YAAY,CAAC;CACzB;AAMD,MAAM,WAAW,YAAY;IAC3B,qBAAqB;IACrB,KAAK,EAAE,SAAS,CAAC;IACjB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IACpB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,oBAAoB,EAAE,oBAGlC,CAAC;AAEF,iDAAiD;AACjD,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,gBAAgB,GAChB,aAAa,GACb,aAAa,CAAC"}

package/dist/engine-y0724kjq.js

@@ -0,0 +1,8 @@
+// @bun
+import {
+  QueryEngine
+} from "./index-yp88he8n.js";
+import"./index-a76rekgs.js";
+export {
+  QueryEngine
+};