trellis 2.1.7 → 3.0.2

package/dist/links/resolver.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Entity Reference Resolver
+ *
+ * Resolves parsed EntityRefs to TrellisVCS entities by querying
+ * the EAV store, tracked files, semantic parser, milestones, and identities.
+ *
+ * @see TRL-12
+ */
+import type { EntityRef, ResolvedRef } from './types.js';
+/**
+ * Abstract interface for the engine capabilities the resolver needs.
+ * This allows testing with mocks without a real TrellisVcsEngine.
+ */
+export interface ResolverContext {
+    /** Get a tracked file by path. Returns true if the file exists in the op stream. */
+    hasTrackedFile(path: string): boolean;
+    /** Look up an issue by ID (e.g. "TRL-5"). Returns title if found. */
+    getIssueTitle(id: string): string | undefined;
+    /** Look up a milestone by ID or message fragment. Returns message if found. */
+    getMilestoneTitle(idOrMessage: string): string | undefined;
+    /** Check if a symbol exists in a file. Returns true if found. */
+    hasSymbol(filePath: string, symbolName: string): boolean;
+    /** Check if an identity/agent ID exists. Returns true if known. */
+    hasIdentity(id: string): boolean;
+    /** List all known agent IDs (from ops). */
+    getKnownAgentIds(): string[];
+    /** List all tracked file paths. */
+    getTrackedFilePaths(): string[];
+    /** List all issue IDs. */
+    getIssueIds(): string[];
+    /** List all milestone IDs. */
+    getMilestoneIds(): string[];
+    /** Check if a decision exists by ID (e.g. "DEC-1"). */
+    hasDecision(id: string): boolean;
+    /** Get a decision's tool name as a human-readable title. */
+    getDecisionTitle(id: string): string | undefined;
+    /** Get all symbol names for a file. */
+    getSymbolNames(filePath: string): string[];
+}
+/**
+ * Resolve a single EntityRef against the resolver context.
+ */
+export declare function resolveRef(ref: EntityRef, ctx: ResolverContext): ResolvedRef;
+/**
+ * Resolve multiple EntityRefs in batch.
+ */
+export declare function resolveRefs(refs: EntityRef[], ctx: ResolverContext): ResolvedRef[];
+/**
+ * Minimal engine interface for building a ResolverContext.
+ * Accepts anything that quacks like TrellisVcsEngine.
+ */
+export interface Enginelike {
+    trackedFiles(): Array<{
+        path: string;
+        contentHash: string | undefined;
+    }>;
+    getIssue(id: string): {
+        title?: string;
+    } | null;
+    listIssues(filters?: any): Array<{
+        id: string;
+    }>;
+    listMilestones(): Array<{
+        id: string;
+        message?: string;
+    }>;
+    parseFile(content: string, filePath: string): {
+        declarations: Array<{
+            name: string;
+        }>;
+    } | null;
+    getOps(): Array<{
+        agentId: string;
+    }>;
+    getRootPath(): string;
+    getDecision?(id: string): {
+        id: string;
+        toolName: string;
+    } | null;
+    queryDecisions?(filter?: any): Array<{
+        id: string;
+        toolName: string;
+    }>;
+}
+/**
+ * Build a ResolverContext from an engine-like object.
+ * The symbol resolution reads files from disk and parses them.
+ */
+export declare function createResolverContext(engine: Enginelike): ResolverContext;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/links/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/links/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAgB,MAAM,YAAY,CAAC;AAMvE;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,oFAAoF;IACpF,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAEtC,qEAAqE;IACrE,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAE9C,+EAA+E;IAC/E,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAE3D,iEAAiE;IACjE,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IAEzD,mEAAmE;IACnE,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAEjC,2CAA2C;IAC3C,gBAAgB,IAAI,MAAM,EAAE,CAAC;IAE7B,mCAAmC;IACnC,mBAAmB,IAAI,MAAM,EAAE,CAAC;IAEhC,0BAA0B;IAC1B,WAAW,IAAI,MAAM,EAAE,CAAC;IAExB,8BAA8B;IAC9B,eAAe,IAAI,MAAM,EAAE,CAAC;IAE5B,uDAAuD;IACvD,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAEjC,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAEjD,uCAAuC;IACvC,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC5C;AAMD;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,eAAe,GAAG,WAAW,CAiB5E;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,SAAS,EAAE,EACjB,GAAG,EAAE,eAAe,GACnB,WAAW,EAAE,CAEf;AAsGD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,YAAY,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC,CAAC;IACzE,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAChD,UAAU,CAAC,OAAO,CAAC,EAAE,GAAG,GAAG,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,cAAc,IAAI,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,SAAS,CACP,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf;QAAE,YAAY,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IACpD,MAAM,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrC,WAAW,IAAI,MAAM,CAAC;IACtB,WAAW,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAClE,cAAc,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,GAAG,eAAe,CAiGzE"}

package/dist/links/types.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Linked Markdown — Type Definitions
+ *
+ * Types for wiki-link parsing, entity reference resolution,
+ * and bidirectional reference indexing.
+ *
+ * @see TRL-11
+ */
+export type RefNamespace = 'issue' | 'file' | 'symbol' | 'identity' | 'milestone' | 'decision';
+export interface EntityRef {
+    /** Full matched text inside [[ ]], e.g. "issue:TRL-5|the parser ticket" */
+    raw: string;
+    /** Resolved or inferred namespace */
+    namespace: RefNamespace;
+    /** Target identifier, e.g. "TRL-5", "src/engine.ts" */
+    target: string;
+    /** Optional anchor for symbol refs, e.g. "createIssue" in [[src/engine.ts#createIssue]] */
+    anchor?: string;
+    /** Optional display alias, e.g. "the parser ticket" in [[TRL-5|the parser ticket]] */
+    alias?: string;
+    /** Where this reference was found */
+    source: RefSource;
+}
+export interface RefSource {
+    /** File containing the reference */
+    filePath: string;
+    /** 1-indexed line number */
+    line: number;
+    /** 0-indexed column offset of the opening [[ */
+    col: number;
+    /** Context in which the ref was found */
+    context: RefContext;
+}
+export type RefContext = 'markdown' | 'jsdoc' | 'pydoc' | 'rustdoc' | 'godoc' | 'comment';
+export type RefState = 'resolved' | 'stale' | 'broken';
+export interface ResolvedRef extends EntityRef {
+    /** Whether the reference target was found */
+    state: RefState;
+    /** EAV entity ID if resolved (e.g. "issue:TRL-5", "file:src/engine.ts") */
+    entityId?: string;
+    /** Human-readable label from the resolved entity */
+    title?: string;
+    /** For stale refs: the op hash that caused the ref to become stale */
+    staleOpHash?: string;
+    /** For stale refs: reason it became stale */
+    staleReason?: 'renamed' | 'deleted';
+}
+export interface RefIndex {
+    /** Forward: source file → refs it contains */
+    outgoing: Map<string, EntityRef[]>;
+    /** Backward: target entity ID → sources that reference it */
+    incoming: Map<string, RefSource[]>;
+}
+export interface RefUpdateProposal {
+    /** The rename that triggered this proposal */
+    oldTarget: string;
+    newTarget: string;
+    /** Files that would be modified */
+    affectedFiles: string[];
+    /** Individual ref rewrites */
+    rewrites: RefRewrite[];
+}
+export interface RefRewrite {
+    filePath: string;
+    line: number;
+    col: number;
+    oldText: string;
+    newText: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/links/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,MAAM,YAAY,GACpB,OAAO,GACP,MAAM,GACN,QAAQ,GACR,UAAU,GACV,WAAW,GACX,UAAU,CAAC;AAMf,MAAM,WAAW,SAAS;IACxB,2EAA2E;IAC3E,GAAG,EAAE,MAAM,CAAC;IACZ,qCAAqC;IACrC,SAAS,EAAE,YAAY,CAAC;IACxB,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,2FAA2F;IAC3F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,MAAM,EAAE,SAAS,CAAC;CACnB;AAMD,MAAM,WAAW,SAAS;IACxB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,yCAAyC;IACzC,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAM1F,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEvD,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,6CAA6C;IAC7C,KAAK,EAAE,QAAQ,CAAC;IAChB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CACrC;AAMD,MAAM,WAAW,QAAQ;IACvB,8CAA8C;IAC9C,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IACnC,6DAA6D;IAC7D,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;CACpC;AAMD,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,8BAA8B;IAC9B,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/llm/provider.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Base LLM Provider Implementation
+ */
+import { LLMProvider, LLMMessage, LLMCompletionOptions, LLMCompletionResponse, LLMCompletionChunk } from './types.js';
+export declare abstract class BaseLLMProvider implements LLMProvider {
+    abstract id: string;
+    abstract name: string;
+    abstract complete(messages: LLMMessage[], options?: LLMCompletionOptions): Promise<LLMCompletionResponse>;
+    stream(messages: LLMMessage[], options?: LLMCompletionOptions): AsyncIterable<LLMCompletionChunk>;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/llm/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/llm/provider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,WAAW,EACX,UAAU,EACV,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,8BAAsB,eAAgB,YAAW,WAAW;IAC1D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAElG,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,aAAa,CAAC,kBAAkB,CAAC;CAGzG"}

package/dist/llm/types.d.ts

@@ -0,0 +1,74 @@
+/**
+ * LLM Provider Interface and Types
+ */
+export interface LLMMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string | null;
+    name?: string;
+    tool_call_id?: string;
+}
+export interface LLMToolChoice {
+    type: 'function';
+    function: {
+        name: string;
+    };
+}
+export interface LLMToolDefinition {
+    type: 'function';
+    function: {
+        name: string;
+        description?: string;
+        parameters: Record<string, unknown>;
+    };
+}
+export interface LLMCompletionOptions {
+    model?: string;
+    temperature?: number;
+    max_tokens?: number;
+    stop?: string[];
+    tools?: LLMToolDefinition[];
+    tool_choice?: 'none' | 'auto' | 'required' | LLMToolChoice;
+    stream?: boolean;
+}
+export interface LLMToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface LLMCompletionChunk {
+    id: string;
+    choices: {
+        delta: {
+            content?: string;
+            tool_calls?: LLMToolCall[];
+        };
+        finish_reason: string | null;
+    }[];
+}
+export interface LLMCompletionResponse {
+    id: string;
+    model: string;
+    choices: {
+        message: {
+            role: 'assistant';
+            content: string | null;
+            tool_calls?: LLMToolCall[];
+        };
+        finish_reason: string;
+    }[];
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+export interface LLMProvider {
+    id: string;
+    name: string;
+    complete(messages: LLMMessage[], options?: LLMCompletionOptions): Promise<LLMCompletionResponse>;
+    stream(messages: LLMMessage[], options?: LLMCompletionOptions): AsyncIterable<LLMCompletionChunk>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/llm/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,CAAC;CACH;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,aAAa,CAAC;IAC3D,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE;QACP,KAAK,EAAE;YACL,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC;SAC5B,CAAC;QACF,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B,EAAE,CAAC;CACL;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QACP,OAAO,EAAE;YACP,IAAI,EAAE,WAAW,CAAC;YAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;YACvB,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC;SAC5B,CAAC;QACF,aAAa,EAAE,MAAM,CAAC;KACvB,EAAE,CAAC;IACJ,KAAK,CAAC,EAAE;QACN,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IAEb,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACjG,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,aAAa,CAAC,kBAAkB,CAAC,CAAC;CACnG"}

package/dist/mcp/docs.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Trellis Docs MCP Server
+ *
+ * Exposes TrellisVCS and TrellisDB documentation to any MCP-compatible
+ * AI agent, enabling context-aware assistance for developers using Trellis.
+ *
+ * Modeled after the SvelteMCP pattern:
+ *   - list-sections   → discover all doc sections
+ *   - get-documentation → fetch full content for specific sections
+ *   - trellis-check   → lint/validate trellis code patterns
+ *
+ * Usage (local):
+ *   bun run src/mcp/docs.ts
+ *
+ * @module mcp/docs
+ */
+export {};
+//# sourceMappingURL=docs.d.ts.map

package/dist/mcp/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/mcp/docs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * TrellisVCS MCP Server — stdio or HTTP/SSE entry point
+ *
+ * Run with: bun run src/mcp/index.ts
+ * Or via MCP config: { "command": "bun", "args": ["run", "src/mcp/index.ts"] }
+ *
+ * Flags:
+ *   --quiet    Suppress stderr startup message (for harness mode)
+ *   --path     Repository root path (defaults to cwd)
+ *   --http     Run HTTP/SSE server instead of stdio (for web clients)
+ *   --port     HTTP port (default: 3333)
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,26 @@
+/**
+ * TrellisVCS MCP Server
+ *
+ * @module mcp
+ *
+ * Exposes TrellisVcsEngine as an MCP (Model Context Protocol) server,
+ * enabling any MCP-compatible AI agent to interact with TrellisVCS
+ * repositories through structured tool calls and resource queries.
+ *
+ * Tools provide write/query actions (status, log, milestone, branch, etc.).
+ * Resources provide read-only context (op stream, file list, garden clusters).
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { HookRegistry } from '../decisions/index.js';
+import type { DecisionRecorder } from '../decisions/auto-capture.js';
+export declare function createTrellisMcpServer(): McpServer;
+/**
+ * The shared hook registry for this MCP server instance.
+ * External agent harnesses can register pre/post hooks here.
+ */
+export declare const hookRegistry: HookRegistry;
+/**
+ * Create a DecisionRecorder that persists to a given repo path.
+ */
+export declare function createRecorder(repoPath: string): DecisionRecorder;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAwBrE,wBAAgB,sBAAsB,IAAI,SAAS,CAqrClD;AAMD;;;GAGG;AACH,eAAO,MAAM,YAAY,cAAqB,CAAC;AAE/C;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAKjE"}

package/dist/orchestration/types.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Agent Orchestration Types
+ *
+ * Multi-agent coordination, routing, and handoffs.
+ */
+import { AgentHarness } from '../core/agents/harness.js';
+import { LLMMessage } from '../llm/types.js';
+export interface Route {
+    sourceAgentId: string;
+    targetAgentId: string;
+    condition?: string;
+}
+export interface SupervisorConfig {
+    agents: string[];
+    strategy: 'rule' | 'llm';
+}
+export interface Orchestrator {
+    harness: AgentHarness;
+    route(input: string, context?: LLMMessage[]): Promise<string>;
+    handoff(runId: string, fromAgentId: string, toAgentId: string): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/orchestration/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,WAAW,KAAK;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,YAAY,CAAC;IAGtB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAG9D,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/E"}

package/dist/plugins/agent-memory/graph-context-manager.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Graph Context Manager — Persists conversation history as entities in the Trellis graph.
+ *
+ * Implements the ContextManager interface but backs every message with a
+ * kernel entity, making conversations queryable via EQL-S and persistent
+ * across sessions and devices.
+ *
+ * @module trellis/plugins/agent-memory
+ */
+import type { LLMMessage } from '../../llm/types.js';
+import type { ContextManager } from '../../context/types.js';
+import type { TrellisKernel } from '../../core/kernel/trellis-kernel.js';
+export interface ConversationOptions {
+    title: string;
+    agentId?: string;
+    model?: string;
+    createdBy?: string;
+}
+export declare class GraphContextManager implements ContextManager {
+    private kernel;
+    private conversationId;
+    private messageCounter;
+    /**
+     * In-memory cache of active messages for fast getHistory() reads.
+     * Always kept in sync with the graph via addMessage/prune/resume.
+     */
+    private cache;
+    constructor(kernel: TrellisKernel);
+    /**
+     * Create a new conversation entity and set it as the active context.
+     * Returns the conversation entity ID.
+     */
+    createConversation(opts: ConversationOptions): Promise<string>;
+    /**
+     * Resume an existing conversation by loading its messages from the graph.
+     */
+    resumeConversation(conversationId: string): Promise<void>;
+    /**
+     * Get the active conversation ID, or null if none is set.
+     */
+    getConversationId(): string | null;
+    /**
+     * Archive the active conversation and clear local state.
+     */
+    archiveConversation(): Promise<void>;
+    addMessage(message: LLMMessage): void;
+    getHistory(): LLMMessage[];
+    prune(targetTokenCount: number): Promise<void>;
+    summarize(): Promise<string>;
+    injectRagContext(query: string, limit?: number): Promise<void>;
+    calculateTokenCount(message: LLMMessage): number;
+    /**
+     * List all conversations, optionally filtered by status.
+     */
+    listConversations(status?: 'active' | 'archived'): Array<{
+        id: string;
+        title: string;
+        status: string;
+        createdAt: string;
+        messageCount: number;
+    }>;
+    /**
+     * Get the total message count for the active conversation.
+     */
+    getMessageCount(): number;
+    /**
+     * Get the total estimated token count for the active conversation.
+     */
+    getTotalTokenCount(): number;
+    /**
+     * Load messages from the graph for a given conversation, sorted by timestamp.
+     */
+    private _loadMessagesFromGraph;
+}
+//# sourceMappingURL=graph-context-manager.d.ts.map

package/dist/plugins/agent-memory/graph-context-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-context-manager.d.ts","sourceRoot":"","sources":["../../../src/plugins/agent-memory/graph-context-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAOzE,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAmBD,qBAAa,mBAAoB,YAAW,cAAc;IACxD,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,cAAc,CAAK;IAE3B;;;OAGG;IACH,OAAO,CAAC,KAAK,CAAuB;gBAExB,MAAM,EAAE,aAAa;IAQjC;;;OAGG;IACG,kBAAkB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBpE;;OAEG;IACG,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW/D;;OAEG;IACH,iBAAiB,IAAI,MAAM,GAAG,IAAI;IAIlC;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAW1C,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IA0CrC,UAAU,IAAI,UAAU,EAAE;IAMpB,KAAK,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6B9C,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAO5B,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE,mBAAmB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM;IAQhD;;OAEG;IACH,iBAAiB,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,KAAK,CAAC;QACvD,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IAeF;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAU5B;;OAEG;IACH,OAAO,CAAC,sBAAsB;CAiC/B"}

package/dist/plugins/agent-memory/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Agent Memory — Trellis plugin for graph-persisted agent conversations.
+ *
+ * @module trellis/plugins/agent-memory
+ *
+ * @example
+ * ```typescript
+ * import { createAgentMemoryPlugin, agentMemoryOntology, GraphContextManager } from 'trellis/plugins/agent-memory';
+ *
+ * // 1. Register the plugin
+ * const plugin = createAgentMemoryPlugin();
+ * pluginRegistry.register(plugin);
+ * await pluginRegistry.load('trellis:agent-memory', kernel, ontologyRegistry);
+ *
+ * // 2. Use graph-backed context manager with agent harness
+ * const contextManager = new GraphContextManager(kernel);
+ * const conversationId = await contextManager.createConversation({
+ *   title: 'Design review',
+ *   agentId: 'agent:trellis',
+ * });
+ *
+ * // Messages are auto-persisted as graph entities
+ * contextManager.addMessage({ role: 'user', content: 'Review the color tokens' });
+ * const history = contextManager.getHistory(); // reads from graph
+ * ```
+ */
+export { agentMemoryOntology } from './ontology.js';
+export { createAgentMemoryPlugin } from './plugin.js';
+export { GraphContextManager, type ConversationOptions } from './graph-context-manager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/agent-memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/agent-memory/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAGtD,OAAO,EAAE,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/plugins/agent-memory/ontology.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Agent Memory Ontology — Schema definitions for Conversation and Message entities.
+ *
+ * Two entity types, one relation:
+ * - Conversation: a thread of messages between user and agent
+ * - Message: a single message within a conversation
+ * - hasMessage: links a conversation to its messages
+ *
+ * @module trellis/plugins/agent-memory
+ */
+import type { OntologySchema } from '../../core/ontology/types.js';
+export declare const agentMemoryOntology: OntologySchema;
+//# sourceMappingURL=ontology.d.ts.map

package/dist/plugins/agent-memory/ontology.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ontology.d.ts","sourceRoot":"","sources":["../../../src/plugins/agent-memory/ontology.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,eAAO,MAAM,mBAAmB,EAAE,cAyDjC,CAAC"}

package/dist/plugins/agent-memory/plugin.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Agent Memory Plugin — Trellis plugin for graph-persisted conversations.
+ *
+ * Registers the agent memory ontology and subscribes to entity events
+ * so consumers can react to conversation/message lifecycle changes.
+ *
+ * @module trellis/plugins/agent-memory
+ */
+import type { PluginDef } from '../../core/plugins/types.js';
+/**
+ * Create the agent memory plugin instance.
+ *
+ * Returns a PluginDef that registers Conversation/Message schemas
+ * and emits well-known events on conversation lifecycle changes.
+ */
+export declare function createAgentMemoryPlugin(): PluginDef;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugins/agent-memory/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/agent-memory/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAG7D;;;;;GAKG;AACH,wBAAgB,uBAAuB,IAAI,SAAS,CA+CnD"}

package/dist/plugins/brand/cache.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Catalog Cache — Stores generated json-render catalogs keyed by BrandGuide ID.
+ *
+ * Invalidation is event-driven: the plugin clears the cache when
+ * DesignToken or BrandGuide entities are created, updated, or deleted.
+ *
+ * @module trellis/plugins/brand
+ */
+export declare class CatalogCache {
+    private store;
+    get(brandGuideId: string): unknown | undefined;
+    set(brandGuideId: string, catalog: unknown): void;
+    invalidate(brandGuideId: string): void;
+    invalidateAll(): void;
+    has(brandGuideId: string): boolean;
+    get size(): number;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/plugins/brand/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/plugins/brand/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAmC;IAEhD,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAI9C,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAIjD,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAItC,aAAa,IAAI,IAAI;IAIrB,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAIlC,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/plugins/brand/catalog-generator.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Catalog Generator — Reads brand tokens from the Trellis graph and produces
+ * a json-render catalog with Zod-constrained component props.
+ *
+ * Pure function: no side effects, no caching (caching is handled by CatalogCache).
+ *
+ * @module trellis/plugins/brand
+ */
+import type { EntityRecord } from '../../core/kernel/trellis-kernel.js';
+import { type VoiceToneConfig } from './voice-tone.js';
+export interface CollectedTokens {
+    color: Array<{
+        role: string;
+        value: unknown;
+        lightMode?: unknown;
+        darkMode?: unknown;
+    }>;
+    typography: Array<{
+        role: string;
+        value: unknown;
+    }>;
+    spacing: Array<{
+        role: string;
+        value: unknown;
+    }>;
+    shadow: Array<{
+        role: string;
+        value: unknown;
+    }>;
+    motion: Array<{
+        role: string;
+        value: unknown;
+    }>;
+    radius: Array<{
+        role: string;
+        value: unknown;
+    }>;
+}
+export interface BrandGuideData {
+    id: string;
+    name: string;
+    status: string;
+    complianceMode: 'strict' | 'moderate' | 'permissive';
+    voiceTone: VoiceToneConfig | null;
+}
+export interface GenerateCatalogResult {
+    /** The constrained catalog (opaque — call .prompt() or .jsonSchema() on it) */
+    catalog: unknown;
+    /** Voice/tone rules derived from the brand guide */
+    voiceRules: string[];
+    /** The parsed brand guide data */
+    guide: BrandGuideData;
+    /** All collected tokens grouped by type */
+    tokens: CollectedTokens;
+}
+/**
+ * Minimal kernel interface — only the methods the generator needs.
+ * Avoids importing the full TrellisKernel class.
+ */
+export interface KernelReader {
+    getEntity(entityId: string): EntityRecord | null;
+    listEntities(type?: string, filters?: Record<string, unknown>): EntityRecord[];
+}
+/**
+ * Collect all DesignTokens linked to a BrandGuide, grouped by tokenType.
+ */
+export declare function collectTokens(kernel: KernelReader, guideEntity: EntityRecord): CollectedTokens;
+/**
+ * Parse a BrandGuide entity into structured data.
+ */
+export declare function parseBrandGuide(entity: EntityRecord): BrandGuideData;
+/**
+ * Generate a brand-constrained json-render catalog.
+ *
+ * @param kernel - Trellis kernel (or anything implementing KernelReader)
+ * @param brandGuideId - Entity ID of the BrandGuide
+ * @param defineCatalog - The `defineCatalog` function from `@json-render/core`
+ * @param schema - The schema instance from `@json-render/react/schema` (or other renderer)
+ * @param baseComponents - Component definitions to constrain (defaults to shadcn if not provided)
+ * @returns Generated catalog, voice rules, guide data, and collected tokens
+ */
+export declare function generateBrandCatalog(kernel: KernelReader, brandGuideId: string, defineCatalog: (schema: unknown, input: {
+    components: Record<string, unknown>;
+    actions: Record<string, unknown>;
+}) => unknown, schema: unknown, baseComponents: Record<string, {
+    props: unknown;
+    [key: string]: unknown;
+}>): GenerateCatalogResult;
+//# sourceMappingURL=catalog-generator.d.ts.map

package/dist/plugins/brand/catalog-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-generator.d.ts","sourceRoot":"","sources":["../../../src/plugins/brand/catalog-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAExE,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAM5E,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACxF,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACpD,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACjD,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAChD,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAChD,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAC;IACrD,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,qBAAqB;IACpC,+EAA+E;IAC/E,OAAO,EAAE,OAAO,CAAC;IACjB,oDAAoD;IACpD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,kCAAkC;IAClC,KAAK,EAAE,cAAc,CAAC;IACtB,2CAA2C;IAC3C,MAAM,EAAE,eAAe,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAAC;IACjD,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,EAAE,CAAC;CAChF;AAyBD;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,GAAG,eAAe,CAkC9F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,CAsBpE;AAMD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,KAAK,OAAO,EAC7H,MAAM,EAAE,OAAO,EACf,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC,GACzE,qBAAqB,CAsCvB"}