@mc1global/opencode-jarvis 0.1.0

package/dist/infrastructure/rag/vectra-adapter.js

@@ -0,0 +1,275 @@
+/**
+ * RAG Infrastructure — Vectra Vector Repository Adapter
+ *
+ * Implements VectorRepository using Vectra's file-backed LocalIndex.
+ * Each workspace gets its own LocalIndex folder; Oracle has a separate index.
+ *
+ * SOLID: SRP — vector storage only
+ * SOLID: DIP — implements domain VectorRepository interface
+ * DDD: Infrastructure adapter for persistence
+ */
+import { LocalIndex } from "vectra";
+// ── Workspace RAG indexed fields ──────────────────────────────────────
+const WORKSPACE_INDEXED_FIELDS = ["workspace", "source", "domain", "file_type"];
+// ── Oracle indexed fields ─────────────────────────────────────────────
+const ORACLE_INDEXED_FIELDS = ["oracle_domain", "source"];
+// ── Helper ────────────────────────────────────────────────────────────
+function toMutableVector(vector) {
+    return Array.from(vector);
+}
+// ── Adapter Implementation ────────────────────────────────────────────
+/**
+ * Vectra-backed implementation of the VectorRepository port.
+ *
+ * Index layout on disk:
+ *   {persistRoot}/{workspace}/  → workspace index
+ *   {persistRoot}/ORACLE/       → shared Oracle index
+ */
+export class VectraVectorRepository {
+    persistRoot;
+    embeddingModel;
+    indexes = new Map();
+    oracleIndex;
+    constructor(persistRoot, embeddingModel) {
+        this.persistRoot = persistRoot;
+        this.embeddingModel = embeddingModel;
+    }
+    // ── Private Helpers ───────────────────────────────────────────
+    getIndex(workspace) {
+        const key = workspace.toLowerCase();
+        let index = this.indexes.get(key);
+        if (index === undefined) {
+            const folderPath = `${this.persistRoot}/${key}`;
+            index = new LocalIndex(folderPath);
+            this.indexes.set(key, index);
+        }
+        return index;
+    }
+    getOracleIndex() {
+        if (this.oracleIndex === undefined) {
+            const folderPath = `${this.persistRoot}/ORACLE`;
+            this.oracleIndex = new LocalIndex(folderPath);
+        }
+        return this.oracleIndex;
+    }
+    buildWorkspaceFilter(options) {
+        const conditions = [];
+        if (options.workspace !== undefined) {
+            conditions.push({ workspace: { $eq: options.workspace.toLowerCase() } });
+        }
+        if (options.domainFilter !== undefined) {
+            conditions.push({ domain: { $eq: options.domainFilter } });
+        }
+        if (options.typeFilter !== undefined) {
+            conditions.push({ file_type: { $eq: options.typeFilter } });
+        }
+        if (conditions.length === 0)
+            return undefined;
+        if (conditions.length === 1)
+            return conditions[0];
+        return { $and: conditions };
+    }
+    // ── Workspace Index Operations ────────────────────────────────
+    async ensureIndex(workspace) {
+        const index = this.getIndex(workspace);
+        const exists = await index.isIndexCreated();
+        if (!exists) {
+            await index.createIndex({
+                version: 1,
+                metadata_config: { indexed: WORKSPACE_INDEXED_FIELDS },
+            });
+        }
+    }
+    async addChunks(workspace, chunks) {
+        if (chunks.length === 0)
+            return;
+        const index = this.getIndex(workspace);
+        const items = chunks.map((chunk) => ({
+            vector: toMutableVector(chunk.vector),
+            metadata: {
+                source: chunk.metadata.source,
+                workspace: chunk.metadata.workspace,
+                domain: chunk.metadata.domain,
+                file_type: chunk.metadata.fileType,
+                chunk_index: chunk.metadata.chunkIndex,
+                total_chunks: chunk.metadata.totalChunks,
+                content: chunk.metadata.content,
+            },
+        }));
+        await index.beginUpdate();
+        try {
+            for (const item of items) {
+                await index.insertItem(item);
+            }
+            await index.endUpdate();
+        }
+        catch (error) {
+            index.cancelUpdate();
+            throw error;
+        }
+    }
+    async deleteBySource(workspace, source) {
+        const index = this.getIndex(workspace);
+        const filter = { source: { $eq: source } };
+        const items = await index.listItemsByMetadata(filter);
+        if (items.length === 0)
+            return 0;
+        await index.beginUpdate();
+        try {
+            for (const item of items) {
+                await index.deleteItem(item.id);
+            }
+            await index.endUpdate();
+        }
+        catch (error) {
+            index.cancelUpdate();
+            throw error;
+        }
+        return items.length;
+    }
+    async search(vector, options) {
+        const workspace = options.workspace;
+        if (workspace === undefined) {
+            throw new Error("VectraVectorRepository.search: workspace is required");
+        }
+        const index = this.getIndex(workspace);
+        const exists = await index.isIndexCreated();
+        if (!exists)
+            return [];
+        const filter = this.buildWorkspaceFilter(options);
+        const results = await index.queryItems(toMutableVector(vector), "", options.topK, filter);
+        return results.map((r) => ({
+            score: r.score,
+            source: r.item.metadata.source,
+            domain: r.item.metadata.domain,
+            fileType: r.item.metadata.file_type,
+            content: r.item.metadata.content,
+        }));
+    }
+    async getStats(workspace) {
+        const index = this.getIndex(workspace);
+        const exists = await index.isIndexCreated();
+        if (!exists) {
+            return {
+                workspace,
+                documentCount: 0,
+                embeddingModel: this.embeddingModel,
+                storeType: "vectra",
+            };
+        }
+        const stats = await index.getIndexStats();
+        return {
+            workspace,
+            documentCount: stats.items,
+            embeddingModel: this.embeddingModel,
+            storeType: "vectra",
+        };
+    }
+    async clearIndex(workspace) {
+        const index = this.getIndex(workspace);
+        const exists = await index.isIndexCreated();
+        if (exists) {
+            await index.deleteIndex();
+        }
+        await index.createIndex({
+            version: 1,
+            metadata_config: { indexed: WORKSPACE_INDEXED_FIELDS },
+        });
+    }
+    // ── Oracle Index Operations ───────────────────────────────────
+    async ensureOracleIndex() {
+        const index = this.getOracleIndex();
+        const exists = await index.isIndexCreated();
+        if (!exists) {
+            await index.createIndex({
+                version: 1,
+                metadata_config: { indexed: ORACLE_INDEXED_FIELDS },
+            });
+        }
+    }
+    async addOracleChunks(chunks) {
+        if (chunks.length === 0)
+            return;
+        const index = this.getOracleIndex();
+        const items = chunks.map((chunk) => ({
+            vector: toMutableVector(chunk.vector),
+            metadata: {
+                source: chunk.metadata.source,
+                oracle_domain: chunk.metadata.oracleDomain,
+                header1: chunk.metadata.header1,
+                header2: chunk.metadata.header2,
+                header3: chunk.metadata.header3,
+                content: chunk.metadata.content,
+            },
+        }));
+        await index.beginUpdate();
+        try {
+            for (const item of items) {
+                await index.insertItem(item);
+            }
+            await index.endUpdate();
+        }
+        catch (error) {
+            index.cancelUpdate();
+            throw error;
+        }
+    }
+    async searchOracle(vector, options) {
+        const index = this.getOracleIndex();
+        const exists = await index.isIndexCreated();
+        if (!exists)
+            return [];
+        const filter = options.domainFilter !== undefined
+            ? { oracle_domain: { $eq: options.domainFilter } }
+            : undefined;
+        const results = await index.queryItems(toMutableVector(vector), "", options.topK, filter);
+        return results.map((r) => ({
+            score: r.score,
+            source: r.item.metadata.source,
+            oracleDomain: r.item.metadata.oracle_domain,
+            header1: r.item.metadata.header1,
+            header2: r.item.metadata.header2,
+            header3: r.item.metadata.header3,
+            content: r.item.metadata.content,
+        }));
+    }
+    async getOracleStats() {
+        const index = this.getOracleIndex();
+        const exists = await index.isIndexCreated();
+        if (!exists) {
+            return {
+                workspace: "ORACLE",
+                documentCount: 0,
+                embeddingModel: this.embeddingModel,
+                storeType: "vectra",
+            };
+        }
+        const stats = await index.getIndexStats();
+        return {
+            workspace: "ORACLE",
+            documentCount: stats.items,
+            embeddingModel: this.embeddingModel,
+            storeType: "vectra",
+        };
+    }
+    async clearOracleIndex() {
+        const index = this.getOracleIndex();
+        const exists = await index.isIndexCreated();
+        if (exists) {
+            await index.deleteIndex();
+        }
+        await index.createIndex({
+            version: 1,
+            metadata_config: { indexed: ORACLE_INDEXED_FIELDS },
+        });
+    }
+    async oracleIndexExists() {
+        const index = this.getOracleIndex();
+        const exists = await index.isIndexCreated();
+        if (!exists)
+            return false;
+        const stats = await index.getIndexStats();
+        return stats.items > 0;
+    }
+}
+//# sourceMappingURL=vectra-adapter.js.map

package/dist/infrastructure/rag/vectra-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vectra-adapter.js","sourceRoot":"","sources":["../../../src/infrastructure/rag/vectra-adapter.ts"],"names":[],"mappings":"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"}

package/dist/infrastructure/token-metrics/token-metrics-repository.d.ts

@@ -0,0 +1,29 @@
+/**
+ * SQLite Token Metrics Repository
+ *
+ * Implements TokenMetricsRepository interface from the domain layer.
+ * Maps TokenUsage entities to/from SQLite rows. Provides aggregated
+ * queries for metrics by agent, card, sprint, and workspace summary.
+ *
+ * SOLID: SRP - persistence for TokenUsage aggregate only
+ * SOLID: DIP - implements domain interface
+ * SOLID: LSP - fully substitutable for TokenMetricsRepository
+ */
+import type { SqliteAdapter } from "../database/sqlite-adapter.js";
+import type { TokenMetricsRepository, TokenUsageFilter, AgentMetrics, CardMetrics, SprintMetrics, WorkspaceSummary } from "../../domain/token-metrics/repositories.js";
+import { TokenUsage } from "../../domain/token-metrics/entities.js";
+import { TokenUsageId } from "../../domain/token-metrics/value-objects.js";
+import { WorkspaceId } from "../../domain/shared/value-objects.js";
+export declare class SqliteTokenMetricsRepository implements TokenMetricsRepository {
+    private readonly db;
+    constructor(db: SqliteAdapter);
+    save(usage: TokenUsage): Promise<void>;
+    findById(id: TokenUsageId): Promise<TokenUsage | undefined>;
+    findByWorkspace(workspace: WorkspaceId, filter?: TokenUsageFilter): Promise<readonly TokenUsage[]>;
+    nextSequence(workspace: WorkspaceId): Promise<number>;
+    getMetricsByAgent(workspace: WorkspaceId, agent?: string): Promise<readonly AgentMetrics[]>;
+    getMetricsByCard(workspace: WorkspaceId, cardId?: string): Promise<readonly CardMetrics[]>;
+    getMetricsBySprint(workspace: WorkspaceId, sprintId?: string): Promise<readonly SprintMetrics[]>;
+    getWorkspaceSummary(workspace: WorkspaceId): Promise<WorkspaceSummary>;
+}
+//# sourceMappingURL=token-metrics-repository.d.ts.map

package/dist/infrastructure/token-metrics/token-metrics-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-metrics-repository.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/token-metrics/token-metrics-repository.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EACV,sBAAsB,EACtB,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,aAAa,EACb,gBAAgB,EACjB,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AACpE,OAAO,EACL,YAAY,EAEb,MAAM,6CAA6C,CAAC;AAErD,OAAO,EAAE,WAAW,EAAa,MAAM,sCAAsC,CAAC;AA6E9E,qBAAa,4BAA6B,YAAW,sBAAsB;IAC7D,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,aAAa;IAIxC,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BtC,QAAQ,CAAC,EAAE,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAQ3D,eAAe,CACnB,SAAS,EAAE,WAAW,EACtB,MAAM,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC;IAmC3B,YAAY,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IASrD,iBAAiB,CACrB,SAAS,EAAE,WAAW,EACtB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC;IA8C7B,gBAAgB,CACpB,SAAS,EAAE,WAAW,EACtB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC;IA4C5B,kBAAkB,CACtB,SAAS,EAAE,WAAW,EACtB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC;IA+C9B,mBAAmB,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC;CA8D7E"}

package/dist/infrastructure/token-metrics/token-metrics-repository.js

@@ -0,0 +1,254 @@
+import { TokenUsage } from "../../domain/token-metrics/entities.js";
+import { TokenUsageId, parseOperationType, } from "../../domain/token-metrics/value-objects.js";
+import { WorkspaceId, Timestamp } from "../../domain/shared/value-objects.js";
+const SCHEMA_KEY = "token_metrics";
+const DDL = `
+  CREATE TABLE IF NOT EXISTS token_usage (
+    id TEXT PRIMARY KEY,
+    workspace TEXT NOT NULL,
+    tool_name TEXT NOT NULL,
+    agent TEXT NOT NULL,
+    operation TEXT NOT NULL DEFAULT 'other',
+    input_tokens INTEGER NOT NULL DEFAULT 0,
+    output_tokens INTEGER NOT NULL DEFAULT 0,
+    model TEXT NOT NULL DEFAULT 'unknown',
+    cost_usd REAL NOT NULL DEFAULT 0,
+    cost_tier TEXT NOT NULL DEFAULT 'standard',
+    card_id TEXT,
+    sprint_id TEXT,
+    session_id TEXT,
+    metadata TEXT NOT NULL DEFAULT '{}',
+    created_at TEXT NOT NULL
+  );
+  CREATE INDEX IF NOT EXISTS idx_token_workspace ON token_usage(workspace);
+  CREATE INDEX IF NOT EXISTS idx_token_agent ON token_usage(workspace, agent);
+  CREATE INDEX IF NOT EXISTS idx_token_card ON token_usage(card_id);
+  CREATE INDEX IF NOT EXISTS idx_token_sprint ON token_usage(sprint_id);
+  CREATE INDEX IF NOT EXISTS idx_token_operation ON token_usage(workspace, operation);
+  CREATE INDEX IF NOT EXISTS idx_token_session ON token_usage(session_id);
+`;
+/** Map a SQLite row to a TokenUsage entity. */
+function rowToEntity(row) {
+    let metadata = {};
+    try {
+        metadata = JSON.parse(row.metadata);
+    }
+    catch {
+        metadata = {};
+    }
+    return TokenUsage.reconstitute({
+        id: TokenUsageId.from(row.id),
+        workspace: WorkspaceId.from(row.workspace),
+        toolName: row.tool_name,
+        agent: row.agent,
+        operation: parseOperationType(row.operation),
+        inputTokens: row.input_tokens,
+        outputTokens: row.output_tokens,
+        model: row.model,
+        costUsd: row.cost_usd,
+        costTier: row.cost_tier,
+        cardId: row.card_id ?? undefined,
+        sprintId: row.sprint_id ?? undefined,
+        sessionId: row.session_id ?? undefined,
+        metadata,
+        createdAt: Timestamp.fromISO(row.created_at),
+    });
+}
+export class SqliteTokenMetricsRepository {
+    db;
+    constructor(db) {
+        this.db = db;
+        db.ensureSchema(SCHEMA_KEY, DDL);
+    }
+    async save(usage) {
+        this.db.execute(`INSERT INTO token_usage
+         (id, workspace, tool_name, agent, operation, input_tokens, output_tokens,
+          model, cost_usd, cost_tier, card_id, sprint_id, session_id, metadata, created_at)
+       VALUES
+         (@id, @workspace, @tool_name, @agent, @operation, @input_tokens, @output_tokens,
+          @model, @cost_usd, @cost_tier, @card_id, @sprint_id, @session_id, @metadata, @created_at)`, {
+            id: usage.id.value,
+            workspace: usage.workspace.value,
+            tool_name: usage.toolName,
+            agent: usage.agent,
+            operation: usage.operation,
+            input_tokens: usage.inputTokens,
+            output_tokens: usage.outputTokens,
+            model: usage.model,
+            cost_usd: usage.costUsd,
+            cost_tier: usage.costTier,
+            card_id: usage.cardId ?? null,
+            sprint_id: usage.sprintId ?? null,
+            session_id: usage.sessionId ?? null,
+            metadata: JSON.stringify(usage.metadata),
+            created_at: usage.createdAt.toISO(),
+        });
+    }
+    async findById(id) {
+        const row = this.db.queryOne("SELECT * FROM token_usage WHERE id = @id", { id: id.value });
+        return row ? rowToEntity(row) : undefined;
+    }
+    async findByWorkspace(workspace, filter) {
+        const conditions = ["workspace = @workspace"];
+        const params = { workspace: workspace.value };
+        if (filter?.agent !== undefined) {
+            conditions.push("agent = @filter_agent");
+            params.filter_agent = filter.agent;
+        }
+        if (filter?.cardId !== undefined) {
+            conditions.push("card_id = @filter_card_id");
+            params.filter_card_id = filter.cardId;
+        }
+        if (filter?.sprintId !== undefined) {
+            conditions.push("sprint_id = @filter_sprint_id");
+            params.filter_sprint_id = filter.sprintId;
+        }
+        if (filter?.operation !== undefined) {
+            conditions.push("operation = @filter_operation");
+            params.filter_operation = filter.operation;
+        }
+        if (filter?.sessionId !== undefined) {
+            conditions.push("session_id = @filter_session_id");
+            params.filter_session_id = filter.sessionId;
+        }
+        const limit = filter?.limit ?? 100;
+        const sql = `SELECT * FROM token_usage
+      WHERE ${conditions.join(" AND ")}
+      ORDER BY created_at DESC
+      LIMIT ${limit}`;
+        const rows = this.db.queryAll(sql, params);
+        return rows.map(rowToEntity);
+    }
+    async nextSequence(workspace) {
+        const row = this.db.queryOne(`SELECT MAX(CAST(SUBSTR(id, 4) AS INTEGER)) as max_seq
+       FROM token_usage WHERE workspace = @workspace`, { workspace: workspace.value });
+        return (row?.max_seq ?? 0) + 1;
+    }
+    async getMetricsByAgent(workspace, agent) {
+        const conditions = ["t.workspace = @workspace"];
+        const params = { workspace: workspace.value };
+        if (agent !== undefined) {
+            conditions.push("t.agent = @agent");
+            params.agent = agent;
+        }
+        const rows = this.db.queryAll(`SELECT
+        t.agent,
+        SUM(t.input_tokens) as total_input,
+        SUM(t.output_tokens) as total_output,
+        SUM(t.input_tokens + t.output_tokens) as total_tokens,
+        SUM(t.cost_usd) as total_cost,
+        COUNT(*) as record_count,
+        (SELECT t2.operation FROM token_usage t2
+         WHERE t2.workspace = t.workspace AND t2.agent = t.agent
+         GROUP BY t2.operation ORDER BY COUNT(*) DESC LIMIT 1) as dominant_op
+      FROM token_usage t
+      WHERE ${conditions.join(" AND ")}
+      GROUP BY t.agent
+      ORDER BY total_tokens DESC`, params);
+        return rows.map((r) => ({
+            agent: r.agent,
+            totalInputTokens: r.total_input,
+            totalOutputTokens: r.total_output,
+            totalTokens: r.total_tokens,
+            totalCostUsd: r.total_cost,
+            recordCount: r.record_count,
+            dominantOperation: parseOperationType(r.dominant_op),
+        }));
+    }
+    async getMetricsByCard(workspace, cardId) {
+        const conditions = ["workspace = @workspace", "card_id IS NOT NULL"];
+        const params = { workspace: workspace.value };
+        if (cardId !== undefined) {
+            conditions.push("card_id = @card_id");
+            params.card_id = cardId;
+        }
+        const rows = this.db.queryAll(`SELECT
+        card_id,
+        SUM(input_tokens) as total_input,
+        SUM(output_tokens) as total_output,
+        SUM(input_tokens + output_tokens) as total_tokens,
+        SUM(cost_usd) as total_cost,
+        COUNT(*) as record_count,
+        COUNT(DISTINCT agent) as agent_count
+      FROM token_usage
+      WHERE ${conditions.join(" AND ")}
+      GROUP BY card_id
+      ORDER BY total_tokens DESC`, params);
+        return rows.map((r) => ({
+            cardId: r.card_id,
+            totalInputTokens: r.total_input,
+            totalOutputTokens: r.total_output,
+            totalTokens: r.total_tokens,
+            totalCostUsd: r.total_cost,
+            recordCount: r.record_count,
+            agentCount: r.agent_count,
+        }));
+    }
+    async getMetricsBySprint(workspace, sprintId) {
+        const conditions = ["workspace = @workspace", "sprint_id IS NOT NULL"];
+        const params = { workspace: workspace.value };
+        if (sprintId !== undefined) {
+            conditions.push("sprint_id = @sprint_id");
+            params.sprint_id = sprintId;
+        }
+        const rows = this.db.queryAll(`SELECT
+        sprint_id,
+        SUM(input_tokens) as total_input,
+        SUM(output_tokens) as total_output,
+        SUM(input_tokens + output_tokens) as total_tokens,
+        SUM(cost_usd) as total_cost,
+        COUNT(*) as record_count,
+        COUNT(DISTINCT card_id) as card_count,
+        COUNT(DISTINCT agent) as agent_count
+      FROM token_usage
+      WHERE ${conditions.join(" AND ")}
+      GROUP BY sprint_id
+      ORDER BY total_tokens DESC`, params);
+        return rows.map((r) => ({
+            sprintId: r.sprint_id,
+            totalInputTokens: r.total_input,
+            totalOutputTokens: r.total_output,
+            totalTokens: r.total_tokens,
+            totalCostUsd: r.total_cost,
+            recordCount: r.record_count,
+            cardCount: r.card_count,
+            agentCount: r.agent_count,
+        }));
+    }
+    async getWorkspaceSummary(workspace) {
+        const totals = this.db.queryOne(`SELECT
+        SUM(input_tokens) as total_input,
+        SUM(output_tokens) as total_output,
+        SUM(input_tokens + output_tokens) as total_tokens,
+        SUM(cost_usd) as total_cost,
+        COUNT(*) as record_count
+      FROM token_usage WHERE workspace = @workspace`, { workspace: workspace.value });
+        const byOp = this.db.queryAll(`SELECT operation, SUM(input_tokens + output_tokens) as total_tokens,
+        SUM(cost_usd) as total_cost, COUNT(*) as count
+      FROM token_usage WHERE workspace = @workspace
+      GROUP BY operation ORDER BY total_tokens DESC`, { workspace: workspace.value });
+        const topAgents = this.db.queryAll(`SELECT agent, SUM(input_tokens + output_tokens) as total_tokens,
+        SUM(cost_usd) as total_cost
+      FROM token_usage WHERE workspace = @workspace
+      GROUP BY agent ORDER BY total_tokens DESC LIMIT 5`, { workspace: workspace.value });
+        return {
+            totalInputTokens: totals?.total_input ?? 0,
+            totalOutputTokens: totals?.total_output ?? 0,
+            totalTokens: totals?.total_tokens ?? 0,
+            totalCostUsd: totals?.total_cost ?? 0,
+            recordCount: totals?.record_count ?? 0,
+            byOperation: byOp.map((r) => ({
+                operation: parseOperationType(r.operation),
+                totalTokens: r.total_tokens,
+                totalCostUsd: r.total_cost,
+                count: r.count,
+            })),
+            topAgents: topAgents.map((r) => ({
+                agent: r.agent,
+                totalTokens: r.total_tokens,
+                totalCostUsd: r.total_cost,
+            })),
+        };
+    }
+}
+//# sourceMappingURL=token-metrics-repository.js.map

package/dist/infrastructure/token-metrics/token-metrics-repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-metrics-repository.js","sourceRoot":"","sources":["../../../src/infrastructure/token-metrics/token-metrics-repository.ts"],"names":[],"mappings":"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"}

package/dist/infrastructure/vault/markdown-parser.d.ts

@@ -0,0 +1,35 @@
+import { VaultPath } from "../../domain/vault/value-objects.js";
+import { MarkdownDocument } from "../../domain/vault/document.js";
+export interface ParsedFrontmatter {
+    readonly data: Record<string, unknown>;
+    readonly body: string;
+    readonly raw: string;
+}
+/**
+ * Extract and parse YAML frontmatter from markdown content.
+ * Returns parsed data, remaining body, and raw YAML text.
+ */
+export declare function parseYamlFrontmatter(content: string): ParsedFrontmatter;
+/**
+ * Serialize a frontmatter data object to YAML string (without --- delimiters).
+ * Uses consistent formatting: no line wrapping, double quotes when needed.
+ */
+export declare function serializeYamlFrontmatter(data: Record<string, unknown>): string;
+/**
+ * Parse a complete markdown document: frontmatter + section tree.
+ * Combines YAML infrastructure with domain parser service.
+ */
+export declare function parseFullDocument(path: VaultPath, content: string): MarkdownDocument;
+/**
+ * Simple template engine for Obsidian-style {{variable}} placeholders.
+ * Handles built-in variables: {{date}}, {{date+Nd}}, {{title}}.
+ */
+export declare class TemplateEngine {
+    /**
+     * Render a template string with variable substitutions.
+     * Built-in variables are resolved automatically.
+     * Custom variables override built-ins if there's a name collision.
+     */
+    render(template: string, variables: Record<string, string>): string;
+}
+//# sourceMappingURL=markdown-parser.d.ts.map

package/dist/infrastructure/vault/markdown-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-parser.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/vault/markdown-parser.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAOlE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAoCvE;AAID;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAYR;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,GACd,gBAAgB,CAqBlB;AAqBD;;;GAGG;AACH,qBAAa,cAAc;IACzB;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM;CA0BpE"}