@mc1global/opencode-jarvis 0.1.0

package/dist/domain/rag/value-objects.d.ts

@@ -0,0 +1,118 @@
+/**
+ * RAG Domain — Value Objects
+ *
+ * Immutable value objects for the RAG bounded context.
+ * Zero external dependencies (pure domain).
+ *
+ * SOLID: SRP — value object definitions only
+ * DDD: Value Objects compared by value, no identity
+ */
+/**
+ * Languages supported by the code-aware text splitter.
+ * Maps to @langchain/textsplitters language keys in infrastructure.
+ */
+export type SupportedLanguage = "python" | "js" | "go" | "java" | "rust" | "swift" | "markdown" | "cpp" | "ruby" | "scala" | "php" | "html";
+/** Extension → language mapping for code-aware splitting. */
+export declare const EXTENSION_LANGUAGE_MAP: ReadonlyMap<string, SupportedLanguage>;
+/** Configuration for text splitting per language. */
+export interface ChunkConfig {
+    readonly chunkSize: number;
+    readonly chunkOverlap: number;
+}
+/** Default chunk configurations matching Python RAG behavior. */
+export declare const DEFAULT_CHUNK_CONFIGS: ReadonlyMap<SupportedLanguage | "default", ChunkConfig>;
+/**
+ * Metadata attached to each document chunk in the vector store.
+ * Stored alongside the embedding vector for filtering and retrieval.
+ */
+export interface ChunkMetadata {
+    /** Absolute path of the source file. */
+    readonly source: string;
+    /** Workspace name (lowercased). */
+    readonly workspace: string;
+    /** DDD domain inferred from file path. */
+    readonly domain: string;
+    /** File extension without dot. */
+    readonly fileType: string;
+    /** 0-based index of this chunk within the file. */
+    readonly chunkIndex: number;
+    /** Total number of chunks produced from this file. */
+    readonly totalChunks: number;
+    /** The raw text content of this chunk. */
+    readonly content: string;
+}
+/**
+ * Oracle-specific metadata for governance documentation chunks.
+ */
+export interface OracleChunkMetadata {
+    /** Absolute path of the source markdown file. */
+    readonly source: string;
+    /** Oracle domain: governance, workflows, patterns, quick_reference. */
+    readonly oracleDomain: string;
+    /** H1 heading context (if available). */
+    readonly header1: string;
+    /** H2 heading context (if available). */
+    readonly header2: string;
+    /** H3 heading context (if available). */
+    readonly header3: string;
+    /** The raw text content of this chunk. */
+    readonly content: string;
+}
+/**
+ * A single search result from the vector store.
+ * Score is cosine similarity (0-1, higher = more similar).
+ */
+export interface SearchResult {
+    readonly score: number;
+    readonly source: string;
+    readonly domain: string;
+    readonly fileType: string;
+    readonly content: string;
+}
+/** Oracle search result with heading context. */
+export interface OracleSearchResult {
+    readonly score: number;
+    readonly source: string;
+    readonly oracleDomain: string;
+    readonly header1: string;
+    readonly header2: string;
+    readonly header3: string;
+    readonly content: string;
+}
+/** Statistics for a RAG index. */
+export interface IndexStats {
+    readonly workspace: string;
+    readonly documentCount: number;
+    readonly embeddingModel: string;
+    readonly storeType: string;
+}
+/**
+ * Configuration for the RAG system.
+ * Passed at initialization, overridable per operation.
+ */
+export interface RagConfig {
+    /** Ollama server URL (default: http://localhost:11434). */
+    readonly ollamaUrl: string;
+    /** Embedding model name (default: embeddinggemma). */
+    readonly embeddingModel: string;
+    /** Root directory for vector store persistence. */
+    readonly persistRoot: string;
+}
+/** Default RAG configuration matching current Python behavior. */
+export declare const DEFAULT_RAG_CONFIG: RagConfig;
+/** File extensions that should always be skipped during indexing. */
+export declare const BINARY_EXTENSIONS: ReadonlySet<string>;
+/** Directories that should always be skipped during indexing. */
+export declare const SKIP_DIRECTORIES: ReadonlySet<string>;
+/**
+ * Infer DDD domain from a file path.
+ * Looks for known directory segments in the path.
+ * e.g., "src/domain/kanban/entities.ts" → "kanban"
+ */
+export declare function inferDomain(filePath: string): string;
+/**
+ * Infer Oracle domain from a file path.
+ * Looks for governance, workflows, patterns, quick_reference in the path.
+ */
+export declare function inferOracleDomain(filePath: string): string;
+//# sourceMappingURL=value-objects.d.ts.map

package/dist/domain/rag/value-objects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-objects.d.ts","sourceRoot":"","sources":["../../../src/domain/rag/value-objects.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GACzB,QAAQ,GACR,IAAI,GACJ,IAAI,GACJ,MAAM,GACN,MAAM,GACN,OAAO,GACP,UAAU,GACV,KAAK,GACL,MAAM,GACN,OAAO,GACP,KAAK,GACL,MAAM,CAAC;AAEX,6DAA6D;AAC7D,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAyBtE,CAAC;AAIL,qDAAqD;AACrD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,iEAAiE;AACjE,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,iBAAiB,GAAG,SAAS,EAAE,WAAW,CAetF,CAAC;AAIL;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mCAAmC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,mDAAmD;IACnD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAID;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,iDAAiD;AACjD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAID,kCAAkC;AAClC,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAID;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,sDAAsD;IACtD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,mDAAmD;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,kEAAkE;AAClE,eAAO,MAAM,kBAAkB,EAAE,SAIhC,CAAC;AAIF,qEAAqE;AACrE,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAUhD,CAAC;AAEH,iEAAiE;AACjE,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAI/C,CAAC;AASH;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYpD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO1D"}

package/dist/domain/rag/value-objects.js

@@ -0,0 +1,114 @@
+/**
+ * RAG Domain — Value Objects
+ *
+ * Immutable value objects for the RAG bounded context.
+ * Zero external dependencies (pure domain).
+ *
+ * SOLID: SRP — value object definitions only
+ * DDD: Value Objects compared by value, no identity
+ */
+/** Extension → language mapping for code-aware splitting. */
+export const EXTENSION_LANGUAGE_MAP = new Map([
+    [".py", "python"],
+    [".ts", "js"],
+    [".tsx", "js"],
+    [".js", "js"],
+    [".jsx", "js"],
+    [".mjs", "js"],
+    [".cjs", "js"],
+    [".go", "go"],
+    [".java", "java"],
+    [".rs", "rust"],
+    [".swift", "swift"],
+    [".md", "markdown"],
+    [".mdx", "markdown"],
+    [".cpp", "cpp"],
+    [".cc", "cpp"],
+    [".c", "cpp"],
+    [".h", "cpp"],
+    [".hpp", "cpp"],
+    [".rb", "ruby"],
+    [".scala", "scala"],
+    [".php", "php"],
+    [".html", "html"],
+    [".htm", "html"],
+]);
+/** Default chunk configurations matching Python RAG behavior. */
+export const DEFAULT_CHUNK_CONFIGS = new Map([
+    ["python", { chunkSize: 900, chunkOverlap: 120 }],
+    ["js", { chunkSize: 900, chunkOverlap: 120 }],
+    ["go", { chunkSize: 900, chunkOverlap: 120 }],
+    ["java", { chunkSize: 950, chunkOverlap: 130 }],
+    ["rust", { chunkSize: 850, chunkOverlap: 110 }],
+    ["swift", { chunkSize: 850, chunkOverlap: 110 }],
+    ["markdown", { chunkSize: 300, chunkOverlap: 40 }],
+    ["cpp", { chunkSize: 900, chunkOverlap: 120 }],
+    ["ruby", { chunkSize: 900, chunkOverlap: 120 }],
+    ["scala", { chunkSize: 900, chunkOverlap: 120 }],
+    ["php", { chunkSize: 900, chunkOverlap: 120 }],
+    ["html", { chunkSize: 800, chunkOverlap: 100 }],
+    ["default", { chunkSize: 500, chunkOverlap: 50 }],
+]);
+/** Default RAG configuration matching current Python behavior. */
+export const DEFAULT_RAG_CONFIG = {
+    ollamaUrl: "http://localhost:11434",
+    embeddingModel: "embeddinggemma",
+    persistRoot: ".jarvis/rag",
+};
+// ── File Filtering ────────────────────────────────────────────────────
+/** File extensions that should always be skipped during indexing. */
+export const BINARY_EXTENSIONS = new Set([
+    ".pyc", ".pyo", ".class", ".o", ".so", ".dylib", ".exe", ".bin",
+    ".png", ".jpg", ".jpeg", ".gif", ".ico", ".svg", ".webp", ".bmp",
+    ".woff", ".woff2", ".ttf", ".eot",
+    ".lock", ".map",
+    ".zip", ".tar", ".gz", ".rar", ".7z",
+    ".mp4", ".avi", ".mov", ".mp3", ".wav",
+    ".pdf", ".doc", ".docx", ".xls", ".xlsx",
+    ".mlmodel", ".mlpackage", ".pb", ".h5",
+    ".db", ".sqlite",
+]);
+/** Directories that should always be skipped during indexing. */
+export const SKIP_DIRECTORIES = new Set([
+    "node_modules", "__pycache__", ".git", "dist", "build", ".next",
+    "venv", ".venv", "target", ".tox", "coverage", ".nyc_output",
+    ".jarvis", ".obsidian",
+]);
+// ── Domain Inference ──────────────────────────────────────────────────
+/** Known DDD domain segments for metadata tagging. */
+const DOMAIN_SEGMENTS = [
+    "domain", "application", "infrastructure", "tools", "hooks",
+];
+/**
+ * Infer DDD domain from a file path.
+ * Looks for known directory segments in the path.
+ * e.g., "src/domain/kanban/entities.ts" → "kanban"
+ */
+export function inferDomain(filePath) {
+    const normalized = filePath.replace(/\\/g, "/").toLowerCase();
+    const parts = normalized.split("/");
+    for (const segment of DOMAIN_SEGMENTS) {
+        const idx = parts.indexOf(segment);
+        if (idx !== -1 && idx + 1 < parts.length) {
+            return parts[idx + 1];
+        }
+    }
+    return "general";
+}
+/**
+ * Infer Oracle domain from a file path.
+ * Looks for governance, workflows, patterns, quick_reference in the path.
+ */
+export function inferOracleDomain(filePath) {
+    const lower = filePath.toLowerCase();
+    if (lower.includes("governance"))
+        return "governance";
+    if (lower.includes("workflows"))
+        return "workflows";
+    if (lower.includes("patterns"))
+        return "patterns";
+    if (lower.includes("quick_reference") || lower.includes("quick-reference"))
+        return "quick_reference";
+    return "other";
+}
+//# sourceMappingURL=value-objects.js.map

package/dist/domain/rag/value-objects.js.map

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

package/dist/domain/shared/value-objects.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Shared Value Objects
+ *
+ * Cross-context value objects used by multiple bounded contexts.
+ * All value objects are immutable with value-based equality.
+ *
+ * SOLID: SRP - each class has one reason to change
+ * DDD: Value Objects have no identity, compared by value
+ */
+/** Base class for string-based entity identifiers. */
+export declare abstract class EntityId {
+    readonly value: string;
+    protected constructor(value: string);
+    equals(other: EntityId): boolean;
+    toString(): string;
+}
+/**
+ * Workspace identifier.
+ * Workspaces scope all operations (sessions, todos, cards, RAG indexes).
+ * Convention: uppercase string (e.g., "JARVIS", "MENU_OCR").
+ */
+export declare class WorkspaceId extends EntityId {
+    private constructor();
+    static create(name: string): WorkspaceId;
+    static from(value: string): WorkspaceId;
+}
+/**
+ * Timestamp value object for consistent date handling across entities.
+ * Wraps Date to ensure immutability and provide domain-specific formatting.
+ */
+export declare class Timestamp {
+    readonly value: Date;
+    private constructor();
+    static now(): Timestamp;
+    static from(date: Date): Timestamp;
+    static fromISO(iso: string): Timestamp;
+    /** Format as YYYYMMDD_HHMMSS_mmm (used in session IDs). Includes milliseconds for uniqueness. */
+    toCompactString(): string;
+    toISO(): string;
+    equals(other: Timestamp): boolean;
+}
+/**
+ * Result type for operations that can succeed or fail.
+ * Avoids throwing exceptions for expected failure paths.
+ * DDD: used in application layer use cases.
+ */
+export type Result<T> = {
+    readonly success: true;
+    readonly data: T;
+} | {
+    readonly success: false;
+    readonly error: string;
+};
+export declare function ok<T>(data: T): Result<T>;
+export declare function fail<T>(error: string): Result<T>;
+//# sourceMappingURL=value-objects.d.ts.map

package/dist/domain/shared/value-objects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-objects.d.ts","sourceRoot":"","sources":["../../../src/domain/shared/value-objects.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,sDAAsD;AACtD,8BAAsB,QAAQ;aACU,KAAK,EAAE,MAAM;IAAnD,SAAS,aAA6B,KAAK,EAAE,MAAM;IAMnD,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;IAIhC,QAAQ,IAAI,MAAM;CAGnB;AAED;;;;GAIG;AACH,qBAAa,WAAY,SAAQ,QAAQ;IACvC,OAAO;IAIP,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW;IAOxC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW;CAGxC;AAED;;;GAGG;AACH,qBAAa,SAAS;aACgB,KAAK,EAAE,IAAI;IAA/C,OAAO;IAEP,MAAM,CAAC,GAAG,IAAI,SAAS;IAIvB,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS;IAIlC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;IAQtC,iGAAiG;IACjG,eAAe,IAAI,MAAM;IAWzB,KAAK,IAAI,MAAM;IAIf,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO;CAGlC;AAED;;;;GAIG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,IAChB;IAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC5C;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAExD,wBAAgB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAExC;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAEhD"}

package/dist/domain/shared/value-objects.js

@@ -0,0 +1,89 @@
+/**
+ * Shared Value Objects
+ *
+ * Cross-context value objects used by multiple bounded contexts.
+ * All value objects are immutable with value-based equality.
+ *
+ * SOLID: SRP - each class has one reason to change
+ * DDD: Value Objects have no identity, compared by value
+ */
+/** Base class for string-based entity identifiers. */
+export class EntityId {
+    value;
+    constructor(value) {
+        this.value = value;
+        if (!value || value.trim().length === 0) {
+            throw new Error(`${this.constructor.name}: value cannot be empty`);
+        }
+    }
+    equals(other) {
+        return this.constructor === other.constructor && this.value === other.value;
+    }
+    toString() {
+        return this.value;
+    }
+}
+/**
+ * Workspace identifier.
+ * Workspaces scope all operations (sessions, todos, cards, RAG indexes).
+ * Convention: uppercase string (e.g., "JARVIS", "MENU_OCR").
+ */
+export class WorkspaceId extends EntityId {
+    constructor(value) {
+        super(value);
+    }
+    static create(name) {
+        if (!name || name.trim().length === 0) {
+            throw new Error("WorkspaceId: name cannot be empty");
+        }
+        return new WorkspaceId(name.trim().toUpperCase());
+    }
+    static from(value) {
+        return new WorkspaceId(value);
+    }
+}
+/**
+ * Timestamp value object for consistent date handling across entities.
+ * Wraps Date to ensure immutability and provide domain-specific formatting.
+ */
+export class Timestamp {
+    value;
+    constructor(value) {
+        this.value = value;
+    }
+    static now() {
+        return new Timestamp(new Date());
+    }
+    static from(date) {
+        return new Timestamp(new Date(date.getTime()));
+    }
+    static fromISO(iso) {
+        const date = new Date(iso);
+        if (isNaN(date.getTime())) {
+            throw new Error(`Timestamp: invalid ISO string "${iso}"`);
+        }
+        return new Timestamp(date);
+    }
+    /** Format as YYYYMMDD_HHMMSS_mmm (used in session IDs). Includes milliseconds for uniqueness. */
+    toCompactString() {
+        const d = this.value;
+        const pad = (n) => String(n).padStart(2, "0");
+        const pad3 = (n) => String(n).padStart(3, "0");
+        return (`${d.getFullYear()}${pad(d.getMonth() + 1)}${pad(d.getDate())}` +
+            `_${pad(d.getHours())}${pad(d.getMinutes())}${pad(d.getSeconds())}` +
+            `_${pad3(d.getMilliseconds())}`);
+    }
+    toISO() {
+        return this.value.toISOString();
+    }
+    equals(other) {
+        return this.value.getTime() === other.value.getTime();
+    }
+}
+export function ok(data) {
+    return { success: true, data };
+}
+export function fail(error) {
+    return { success: false, error };
+}
+//# sourceMappingURL=value-objects.js.map

package/dist/domain/shared/value-objects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-objects.js","sourceRoot":"","sources":["../../../src/domain/shared/value-objects.ts"],"names":[],"mappings":"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"}

package/dist/domain/token-metrics/entities.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Token Metrics Entities
+ *
+ * TokenUsage is the aggregate root for recording token consumption.
+ * Each record captures a single tool invocation's token cost,
+ * linked to the agent, card, sprint, and session context.
+ *
+ * This is the "payroll record" for AI agents — just as human
+ * workforce accounting tracks hours per task, this tracks tokens
+ * per operation.
+ *
+ * DDD: Aggregate Root with invariants
+ * SOLID: SRP - token usage recording only
+ */
+import { WorkspaceId, Timestamp } from "../shared/value-objects.js";
+import { TokenUsageId, OperationType } from "./value-objects.js";
+import type { CostTier } from "./value-objects.js";
+export interface TokenUsageProps {
+    readonly id: TokenUsageId;
+    readonly workspace: WorkspaceId;
+    readonly toolName: string;
+    readonly agent: string;
+    readonly operation: OperationType;
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly model: string;
+    readonly costUsd: number;
+    readonly costTier: CostTier;
+    readonly cardId: string | undefined;
+    readonly sprintId: string | undefined;
+    readonly sessionId: string | undefined;
+    readonly metadata: Record<string, unknown>;
+    readonly createdAt: Timestamp;
+}
+export interface CreateTokenUsageParams {
+    readonly id: TokenUsageId;
+    readonly workspace: WorkspaceId;
+    readonly toolName: string;
+    readonly agent: string;
+    readonly operation?: OperationType;
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly model: string;
+    readonly cardId?: string;
+    readonly sprintId?: string;
+    readonly sessionId?: string;
+    readonly metadata?: Record<string, unknown>;
+}
+/**
+ * TokenUsage — aggregate root.
+ *
+ * Immutable record of token consumption for a single operation.
+ * Cost is calculated at creation time based on model pricing.
+ * Total tokens is a derived value (input + output).
+ */
+export declare class TokenUsage {
+    readonly id: TokenUsageId;
+    readonly workspace: WorkspaceId;
+    readonly toolName: string;
+    readonly agent: string;
+    readonly operation: OperationType;
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly model: string;
+    readonly costUsd: number;
+    readonly costTier: CostTier;
+    readonly cardId: string | undefined;
+    readonly sprintId: string | undefined;
+    readonly sessionId: string | undefined;
+    readonly metadata: Record<string, unknown>;
+    readonly createdAt: Timestamp;
+    private constructor();
+    /** Total tokens consumed (input + output). */
+    get totalTokens(): number;
+    /** Efficiency ratio: output / input. Higher = more output per input. */
+    get efficiencyRatio(): number;
+    /**
+     * Create a new TokenUsage record.
+     * Enforces invariants:
+     * - Input and output tokens must be non-negative
+     * - Tool name and agent must not be empty
+     * - Cost is auto-calculated from model pricing
+     */
+    static create(params: CreateTokenUsageParams): TokenUsage;
+    /**
+     * Reconstitute from persistence (no validation, no cost recalculation).
+     */
+    static reconstitute(props: TokenUsageProps): TokenUsage;
+}
+//# sourceMappingURL=entities.d.ts.map

package/dist/domain/token-metrics/entities.d.ts.map

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

package/dist/domain/token-metrics/entities.js

@@ -0,0 +1,115 @@
+/**
+ * Token Metrics Entities
+ *
+ * TokenUsage is the aggregate root for recording token consumption.
+ * Each record captures a single tool invocation's token cost,
+ * linked to the agent, card, sprint, and session context.
+ *
+ * This is the "payroll record" for AI agents — just as human
+ * workforce accounting tracks hours per task, this tracks tokens
+ * per operation.
+ *
+ * DDD: Aggregate Root with invariants
+ * SOLID: SRP - token usage recording only
+ */
+import { WorkspaceId, Timestamp } from "../shared/value-objects.js";
+import { TokenUsageId, OperationType, calculateCost, getModelCostTier, } from "./value-objects.js";
+// ── Token Usage Entity ────────────────────────────────────────────────
+/**
+ * TokenUsage — aggregate root.
+ *
+ * Immutable record of token consumption for a single operation.
+ * Cost is calculated at creation time based on model pricing.
+ * Total tokens is a derived value (input + output).
+ */
+export class TokenUsage {
+    id;
+    workspace;
+    toolName;
+    agent;
+    operation;
+    inputTokens;
+    outputTokens;
+    model;
+    costUsd;
+    costTier;
+    cardId;
+    sprintId;
+    sessionId;
+    metadata;
+    createdAt;
+    constructor(props) {
+        this.id = props.id;
+        this.workspace = props.workspace;
+        this.toolName = props.toolName;
+        this.agent = props.agent;
+        this.operation = props.operation;
+        this.inputTokens = props.inputTokens;
+        this.outputTokens = props.outputTokens;
+        this.model = props.model;
+        this.costUsd = props.costUsd;
+        this.costTier = props.costTier;
+        this.cardId = props.cardId;
+        this.sprintId = props.sprintId;
+        this.sessionId = props.sessionId;
+        this.metadata = props.metadata;
+        this.createdAt = props.createdAt;
+    }
+    /** Total tokens consumed (input + output). */
+    get totalTokens() {
+        return this.inputTokens + this.outputTokens;
+    }
+    /** Efficiency ratio: output / input. Higher = more output per input. */
+    get efficiencyRatio() {
+        if (this.inputTokens === 0)
+            return 0;
+        return Math.round((this.outputTokens / this.inputTokens) * 100) / 100;
+    }
+    /**
+     * Create a new TokenUsage record.
+     * Enforces invariants:
+     * - Input and output tokens must be non-negative
+     * - Tool name and agent must not be empty
+     * - Cost is auto-calculated from model pricing
+     */
+    static create(params) {
+        if (params.inputTokens < 0) {
+            throw new Error("TokenUsage: inputTokens must be non-negative");
+        }
+        if (params.outputTokens < 0) {
+            throw new Error("TokenUsage: outputTokens must be non-negative");
+        }
+        if (!params.toolName || params.toolName.trim().length === 0) {
+            throw new Error("TokenUsage: toolName cannot be empty");
+        }
+        if (!params.agent || params.agent.trim().length === 0) {
+            throw new Error("TokenUsage: agent cannot be empty");
+        }
+        const costUsd = calculateCost(params.inputTokens, params.outputTokens, params.model);
+        const costTier = getModelCostTier(params.model);
+        return new TokenUsage({
+            id: params.id,
+            workspace: params.workspace,
+            toolName: params.toolName,
+            agent: params.agent,
+            operation: params.operation ?? OperationType.Other,
+            inputTokens: params.inputTokens,
+            outputTokens: params.outputTokens,
+            model: params.model,
+            costUsd,
+            costTier,
+            cardId: params.cardId,
+            sprintId: params.sprintId,
+            sessionId: params.sessionId,
+            metadata: params.metadata ?? {},
+            createdAt: Timestamp.now(),
+        });
+    }
+    /**
+     * Reconstitute from persistence (no validation, no cost recalculation).
+     */
+    static reconstitute(props) {
+        return new TokenUsage(props);
+    }
+}
+//# sourceMappingURL=entities.js.map

package/dist/domain/token-metrics/entities.js.map

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