@cleocode/core 2026.3.41 → 2026.3.43

package/dist/memory/session-memory.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Session Memory Auto-Capture
+ *
+ * When a session ends, automatically persists decisions, patterns,
+ * and learnings to brain.db as observations with source_type='session-debrief'.
+ *
+ * Also provides getSessionMemoryContext() for enriching session start/resume
+ * with relevant brain memory.
+ *
+ * @epic T5149
+ */
+import type { DebriefData } from '../sessions/handoff.js';
+import type { BrainCompactHit, BrainObservationType } from './brain-retrieval.js';
+/** Result of persisting session memory to brain.db. */
+export interface SessionMemoryResult {
+    /** Number of observations created */
+    observationsCreated: number;
+    /** Number of links created */
+    linksCreated: number;
+    /** IDs of created observations */
+    observationIds: string[];
+    /** Whether any errors occurred (best-effort -- errors don't fail the operation) */
+    errors: string[];
+}
+/** A memory item to be persisted to brain.db. */
+export interface MemoryItem {
+    text: string;
+    title: string;
+    type: BrainObservationType;
+    sourceSessionId: string;
+    sourceType: 'session-debrief';
+    /** Optional task ID to link this observation to */
+    linkTaskId?: string;
+}
+/** Memory context returned for session start/resume enrichment. */
+export interface SessionMemoryContext {
+    /** Recent decisions relevant to this scope */
+    recentDecisions: BrainCompactHit[];
+    /** Patterns relevant to this scope */
+    relevantPatterns: BrainCompactHit[];
+    /** Recent observations from prior sessions */
+    recentObservations: BrainCompactHit[];
+    /** Recent learnings relevant to this scope */
+    recentLearnings: BrainCompactHit[];
+    /** Total token estimate for this context */
+    tokensEstimated: number;
+}
+/**
+ * Extract memory-worthy items from debrief data.
+ * Pure function -- no side effects.
+ *
+ * Items extracted:
+ * - Decisions (from debrief.decisions[]) -> observations with type='decision'
+ * - Tasks completed summary -> observation with type='change'
+ * - Session-level note (if present) -> observation with type='discovery'
+ */
+export declare function extractMemoryItems(sessionId: string, debrief: DebriefData | null | undefined): MemoryItem[];
+/**
+ * Main entry point -- called from session.end handler.
+ * Extracts memory-worthy content from debrief data and persists to brain.db.
+ *
+ * ALL errors are caught and accumulated in result.errors -- never throws.
+ *
+ * @param projectRoot - Project root directory
+ * @param sessionId - The session that just ended
+ * @param debrief - Rich debrief data from sessionComputeDebrief()
+ * @returns Summary of what was persisted
+ */
+export declare function persistSessionMemory(projectRoot: string, sessionId: string, debrief: DebriefData | null | undefined): Promise<SessionMemoryResult>;
+/**
+ * Retrieve session memory for a given scope.
+ * Used by briefing/handoff to enrich response with brain context.
+ *
+ * @param projectRoot - Project root directory
+ * @param scope - Session scope for filtering (epic:T### or global)
+ * @param options - Retrieval options
+ * @returns Relevant brain memory entries
+ */
+export declare function getSessionMemoryContext(projectRoot: string, scope?: {
+    type: string;
+    epicId?: string;
+    rootTaskId?: string;
+}, options?: {
+    limit?: number;
+    includeDecisions?: boolean;
+    includePatterns?: boolean;
+}): Promise<SessionMemoryContext>;
+//# sourceMappingURL=session-memory.d.ts.map

package/dist/memory/session-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-memory.d.ts","sourceRoot":"","sources":["../../src/memory/session-memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAmB,MAAM,wBAAwB,CAAC;AAC3E,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EAGrB,MAAM,sBAAsB,CAAC;AAM9B,uDAAuD;AACvD,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,mFAAmF;IACnF,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,iDAAiD;AACjD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,oBAAoB,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,mEAAmE;AACnE,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,eAAe,EAAE,eAAe,EAAE,CAAC;IACnC,sCAAsC;IACtC,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,8CAA8C;IAC9C,kBAAkB,EAAE,eAAe,EAAE,CAAC;IACtC,8CAA8C;IAC9C,eAAe,EAAE,eAAe,EAAE,CAAC;IACnC,4CAA4C;IAC5C,eAAe,EAAE,MAAM,CAAC;CACzB;AAMD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GACtC,UAAU,EAAE,CAuDd;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GACtC,OAAO,CAAC,mBAAmB,CAAC,CAsE9B;AAMD;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EAC9D,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,GAClF,OAAO,CAAC,oBAAoB,CAAC,CA2E/B"}

package/dist/metrics/ab-test.d.ts

@@ -0,0 +1,52 @@
+/**
+ * A/B testing framework for CLEO vs baseline comparison.
+ *
+ * Enables scientific comparison of CLEO (with subagents, manifests, protocols)
+ * vs baseline (direct implementation) across token consumption, validation
+ * effectiveness, and completion rates.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+/** A/B test variant. */
+export type ABVariant = 'cleo' | 'baseline';
+/** A/B test event types. */
+export type ABEventType = 'start' | 'end' | 'milestone' | 'note';
+/** Log an A/B test event. */
+export declare function logABEvent(eventType: ABEventType, testName: string, variant: ABVariant, context?: Record<string, unknown> | string, cwd?: string): Promise<void>;
+/** Start an A/B test session. */
+export declare function startABTest(testName: string, variant: ABVariant, description?: string, cwd?: string): Promise<void>;
+/** A/B test summary result. */
+export interface ABTestSummary {
+    test_name: string;
+    variant: ABVariant;
+    start_time: string;
+    end_time: string;
+    duration_seconds: number;
+    tokens_consumed: number;
+    token_source: string;
+    tasks_completed: number;
+    validations: {
+        passed: number;
+        failed: number;
+        total: number;
+        pass_rate_percent: number;
+    };
+    notes: string;
+}
+/** End an A/B test session with summary. */
+export declare function endABTest(options?: {
+    tasksCompleted?: number;
+    validationPasses?: number;
+    validationFailures?: number;
+    notes?: string;
+}, cwd?: string): Promise<ABTestSummary | null>;
+/** Get results for a specific test variant. */
+export declare function getABTestResults(testName: string, variant: ABVariant, cwd?: string): Record<string, unknown> | null;
+/** List all A/B tests. */
+export declare function listABTests(filter?: string, cwd?: string): Record<string, unknown>[];
+/** Compare two variants of the same test. */
+export declare function compareABTest(testName: string, cwd?: string): Record<string, unknown>;
+/** Get aggregate statistics of all A/B tests. */
+export declare function getABTestStats(cwd?: string): Record<string, unknown>;
+//# sourceMappingURL=ab-test.d.ts.map

package/dist/metrics/ab-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ab-test.d.ts","sourceRoot":"","sources":["../../src/metrics/ab-test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,wBAAwB;AACxB,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;AAE5C,4BAA4B;AAC5B,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,KAAK,GAAG,WAAW,GAAG,MAAM,CAAC;AAoBjE,6BAA6B;AAC7B,wBAAsB,UAAU,CAC9B,SAAS,EAAE,WAAW,EACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,SAAS,EAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAC1C,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED,iCAAiC;AACjC,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,SAAS,EAClB,WAAW,CAAC,EAAE,MAAM,EACpB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED,+BAA+B;AAC/B,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,SAAS,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE;QACX,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,KAAK,EAAE,MAAM,CAAC;CACf;AAED,4CAA4C;AAC5C,wBAAsB,SAAS,CAC7B,OAAO,GAAE;IACP,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CACX,EACN,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CA4D/B;AAED,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,SAAS,EAClB,GAAG,CAAC,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAWhC;AAED,0BAA0B;AAC1B,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CA2BpF;AAED,6CAA6C;AAC7C,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0ErF;AAED,iDAAiD;AACjD,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiCpE"}

package/dist/metrics/aggregation.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Metrics aggregation - project-to-global sync and compliance summaries.
+ *
+ * Project metrics: .cleo/metrics/COMPLIANCE.jsonl
+ * Global metrics:  ~/.cleo/metrics/GLOBAL.jsonl
+ *
+ * @task T4454
+ * @epic T4454
+ */
+/** Sync project metrics to global aggregation file. */
+export declare function syncMetricsToGlobal(options?: {
+    force?: boolean;
+}, cwd?: string): Promise<Record<string, unknown>>;
+/** Get compliance summary for the current project. */
+export declare function getProjectComplianceSummary(options?: {
+    since?: string;
+    agent?: string;
+    category?: string;
+}, cwd?: string): Record<string, unknown>;
+/** Get compliance summary across all projects. */
+export declare function getGlobalComplianceSummary(options?: {
+    since?: string;
+    project?: string;
+}): Record<string, unknown>;
+/** Get compliance trend over time. */
+export declare function getComplianceTrend(days?: number, options?: {
+    project?: string;
+    global?: boolean;
+}, cwd?: string): Record<string, unknown>;
+/** Get reliability stats per skill/agent. */
+export declare function getSkillReliability(options?: {
+    since?: string;
+    global?: boolean;
+}, cwd?: string): Record<string, unknown>;
+/** Log session metrics to SESSIONS.jsonl. */
+export declare function logSessionMetrics(metricsJson: Record<string, unknown>, cwd?: string): Promise<Record<string, unknown>>;
+/** Get summary of session metrics. */
+export declare function getSessionMetricsSummary(options?: {
+    since?: string;
+}, cwd?: string): Record<string, unknown>;
+//# sourceMappingURL=aggregation.d.ts.map

package/dist/metrics/aggregation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregation.d.ts","sourceRoot":"","sources":["../../src/metrics/aggregation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmCH,uDAAuD;AACvD,wBAAsB,mBAAmB,CACvC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,EACjC,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAiDlC;AAgBD,sDAAsD;AACtD,wBAAgB,2BAA2B,CACzC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,EACnE,GAAG,CAAC,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6BzB;AAED,kDAAkD;AAClD,wBAAgB,0BAA0B,CACxC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GACjD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA4BzB;AAmED,sCAAsC;AACtC,wBAAgB,kBAAkB,CAChC,IAAI,GAAE,MAAU,EAChB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,EACpD,GAAG,CAAC,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6CzB;AAED,6CAA6C;AAC7C,wBAAgB,mBAAmB,CACjC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,EAClD,GAAG,CAAC,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmDzB;AAED,6CAA6C;AAC7C,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAoBlC;AAED,sCAAsC;AACtC,wBAAgB,wBAAwB,CACtC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,EAChC,GAAG,CAAC,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2EzB"}

package/dist/metrics/common.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shared metrics utilities - paths, timestamps, and compliance summaries.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+/** Ensure metrics directory exists, returning its path. */
+export declare function ensureMetricsDir(metricsDir?: string): Promise<string>;
+/** Get compliance log path. */
+export declare function getCompliancePath(metricsDir?: string): string;
+/** Get violations log path. */
+export declare function getViolationsPath(metricsDir?: string): string;
+/** Get sessions metrics log path. */
+export declare function getSessionsMetricsPath(metricsDir?: string): string;
+/** Generate ISO 8601 UTC timestamp. */
+export declare function isoTimestamp(): string;
+/** Generate ISO 8601 date only. */
+export declare function isoDate(): string;
+/** Read a JSONL file into an array of parsed objects. */
+export declare function readJsonlFile(filePath: string): Record<string, unknown>[];
+/** Compliance summary shape. */
+export interface ComplianceSummary {
+    total: number;
+    pass: number;
+    fail: number;
+    rate: number;
+}
+/** Get compliance summary from log file. */
+export declare function getComplianceSummaryBase(compliancePath?: string): ComplianceSummary;
+//# sourceMappingURL=common.d.ts.map

package/dist/metrics/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/metrics/common.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,2DAA2D;AAC3D,wBAAsB,gBAAgB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM3E;AAED,+BAA+B;AAC/B,wBAAgB,iBAAiB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,+BAA+B;AAC/B,wBAAgB,iBAAiB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,qCAAqC;AACrC,wBAAgB,sBAAsB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,uCAAuC;AACvC,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,mCAAmC;AACnC,wBAAgB,OAAO,IAAI,MAAM,CAEhC;AAED,yDAAyD;AACzD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAQzE;AAED,gCAAgC;AAChC,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,4CAA4C;AAC5C,wBAAgB,wBAAwB,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAgBnF"}

package/dist/metrics/enums.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Metrics enum definitions - type-safe enums for the CLEO metrics system.
+ * All values match schema definitions in schemas/metrics.schema.json.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+/** Violation severity levels. */
+export declare enum Severity {
+    Low = "low",
+    Medium = "medium",
+    High = "high",
+    Critical = "critical"
+}
+/** Manifest integrity states. */
+export declare enum ManifestIntegrity {
+    Valid = "valid",
+    Partial = "partial",
+    Invalid = "invalid",
+    Missing = "missing"
+}
+/** Instruction stability levels. */
+export declare enum InstructionStability {
+    Stable = "stable",
+    Clarified = "clarified",
+    Revised = "revised",
+    Unstable = "unstable"
+}
+/** Session degradation levels. */
+export declare enum SessionDegradation {
+    None = "none",
+    Mild = "mild",
+    Moderate = "moderate",
+    Severe = "severe"
+}
+/** Agent reliability levels. */
+export declare enum AgentReliability {
+    High = "high",
+    Medium = "medium",
+    Low = "low",
+    Unreliable = "unreliable"
+}
+/** Metric categories. */
+export declare enum MetricCategory {
+    Compliance = "compliance",
+    Efficiency = "efficiency",
+    Session = "session",
+    Improvement = "improvement"
+}
+/** Metric sources. */
+export declare enum MetricSource {
+    Task = "task",
+    Session = "session",
+    Agent = "agent",
+    System = "system",
+    Orchestrator = "orchestrator"
+}
+/** Aggregation periods. */
+export declare enum AggregationPeriod {
+    Instant = "instant",
+    Hourly = "hourly",
+    Daily = "daily",
+    Weekly = "weekly",
+    Monthly = "monthly"
+}
+/** Validate that a value is a member of a given enum. */
+export declare function isValidEnumValue<T extends Record<string, string>>(enumObj: T, value: string): value is T[keyof T];
+//# sourceMappingURL=enums.d.ts.map

package/dist/metrics/enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../src/metrics/enums.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,iCAAiC;AACjC,oBAAY,QAAQ;IAClB,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,QAAQ,aAAa;CACtB;AAED,iCAAiC;AACjC,oBAAY,iBAAiB;IAC3B,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB;AAED,oCAAoC;AACpC,oBAAY,oBAAoB;IAC9B,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,QAAQ,aAAa;CACtB;AAED,kCAAkC;AAClC,oBAAY,kBAAkB;IAC5B,IAAI,SAAS;IACb,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,MAAM,WAAW;CAClB;AAED,gCAAgC;AAChC,oBAAY,gBAAgB;IAC1B,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,GAAG,QAAQ;IACX,UAAU,eAAe;CAC1B;AAED,yBAAyB;AACzB,oBAAY,cAAc;IACxB,UAAU,eAAe;IACzB,UAAU,eAAe;IACzB,OAAO,YAAY;IACnB,WAAW,gBAAgB;CAC5B;AAED,sBAAsB;AACtB,oBAAY,YAAY;IACtB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,YAAY,iBAAiB;CAC9B;AAED,2BAA2B;AAC3B,oBAAY,iBAAiB;IAC3B,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,OAAO,YAAY;CACpB;AAED,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/D,OAAO,EAAE,CAAC,EACV,KAAK,EAAE,MAAM,GACZ,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAErB"}

package/dist/metrics/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Metrics module - token tracking, compliance aggregation, A/B testing, OpenTelemetry.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+export type { ABEventType, ABTestSummary, ABVariant } from './ab-test.js';
+export { compareABTest, endABTest, getABTestResults, getABTestStats, listABTests, logABEvent, startABTest, } from './ab-test.js';
+export { getComplianceTrend, getGlobalComplianceSummary, getProjectComplianceSummary, getSessionMetricsSummary, getSkillReliability, logSessionMetrics, syncMetricsToGlobal, } from './aggregation.js';
+export type { ComplianceSummary } from './common.js';
+export { ensureMetricsDir, getCompliancePath, getComplianceSummaryBase, getSessionsMetricsPath, getViolationsPath, isoDate, isoTimestamp, readJsonlFile, } from './common.js';
+export { AgentReliability, AggregationPeriod, InstructionStability, isValidEnumValue, ManifestIntegrity, MetricCategory, MetricSource, SessionDegradation, Severity, } from './enums.js';
+export type { AggregatedTokens, OtelCaptureMode, OtelTokenDataPoint } from './otel-integration.js';
+export { compareSessions, getOtelSetupCommands, getSessionTokens, getTokenStats, isOtelEnabled, parseTokenMetrics, recordSessionEnd, recordSessionStart, } from './otel-integration.js';
+export type { TokenEvent, TokenEventType, TokenSessionSummary } from './token-estimation.js';
+export { compareManifestVsFull, endTokenSession, estimateTokens, estimateTokensFromFile, getTokenSummary, getTrackingStatus, logTokenEvent, startTokenSession, trackFileRead, trackManifestQuery, trackPromptBuild, trackSkillInjection, trackSpawnComplete, trackSpawnOutput, } from './token-estimation.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE1E,OAAO,EACL,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,UAAU,EACV,WAAW,GACZ,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,2BAA2B,EAC3B,wBAAwB,EACxB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,EACjB,OAAO,EACP,YAAY,EACZ,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,QAAQ,GACT,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEnG,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE7F,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC"}

package/dist/metrics/model-provider-registry.d.ts

@@ -0,0 +1,17 @@
+interface ModelsDevProviderRecord {
+    id?: string;
+    models?: Record<string, {
+        id?: string;
+    }>;
+}
+export interface ModelProviderLookup {
+    provider?: string;
+    source: 'model-prefix' | 'models.dev-exact' | 'models.dev-suffix' | 'none';
+    candidates?: string[];
+}
+type ModelsDevIndex = Record<string, ModelsDevProviderRecord>;
+export declare function resolveProviderFromModelIndex(index: ModelsDevIndex, model?: string): ModelProviderLookup;
+export declare function resolveProviderFromModelRegistry(model?: string): Promise<ModelProviderLookup>;
+export declare function resetModelsDevCache(): void;
+export {};
+//# sourceMappingURL=model-provider-registry.d.ts.map

package/dist/metrics/model-provider-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-provider-registry.d.ts","sourceRoot":"","sources":["../../src/metrics/model-provider-registry.ts"],"names":[],"mappings":"AAEA,UAAU,uBAAuB;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,cAAc,GAAG,kBAAkB,GAAG,mBAAmB,GAAG,MAAM,CAAC;IAC3E,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;AAe9D,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,cAAc,EACrB,KAAK,CAAC,EAAE,MAAM,GACb,mBAAmB,CAiDrB;AAkBD,wBAAsB,gCAAgC,CACpD,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,mBAAmB,CAAC,CAS9B;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/dist/metrics/otel-integration.d.ts

@@ -0,0 +1,49 @@
+/**
+ * OpenTelemetry integration for Claude Code metrics.
+ *
+ * Captures real token usage data from Claude Code OTel exports.
+ * Supports setup, parsing, aggregation, and session comparison.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+/** Check if OTel telemetry is enabled. */
+export declare function isOtelEnabled(): boolean;
+/** OTel capture mode. */
+export type OtelCaptureMode = 'console' | 'file' | 'prometheus';
+/** Get environment variable commands for OTel capture setup. */
+export declare function getOtelSetupCommands(mode?: OtelCaptureMode, cwd?: string): string;
+/** Token data point parsed from OTel metrics. */
+export interface OtelTokenDataPoint {
+    timestamp: string | number;
+    type: string;
+    model: string;
+    tokens: number;
+}
+/** Parse OTel token metrics from collected data. */
+export declare function parseTokenMetrics(inputFile?: string, cwd?: string): OtelTokenDataPoint[];
+/** Aggregated token counts. */
+export interface AggregatedTokens {
+    session_id: string | null;
+    tokens: {
+        input: number;
+        output: number;
+        cache_read: number;
+        cache_creation: number;
+        total: number;
+        effective: number;
+    };
+    api_requests: number;
+    source: 'otel';
+}
+/** Get aggregated token counts from OTel data. */
+export declare function getSessionTokens(sessionId?: string, cwd?: string): AggregatedTokens;
+/** Record token counts at session start. */
+export declare function recordSessionStart(sessionId: string, cwd?: string): Promise<Record<string, unknown>>;
+/** Record token counts at session end. */
+export declare function recordSessionEnd(sessionId: string, cwd?: string): Promise<Record<string, unknown>>;
+/** Compare token usage between two sessions. */
+export declare function compareSessions(sessionA: string, sessionB: string, cwd?: string): Record<string, unknown>;
+/** Get statistics about token usage across sessions. */
+export declare function getTokenStats(cwd?: string): Record<string, unknown>;
+//# sourceMappingURL=otel-integration.d.ts.map

package/dist/metrics/otel-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel-integration.d.ts","sourceRoot":"","sources":["../../src/metrics/otel-integration.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH,0CAA0C;AAC1C,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED,yBAAyB;AACzB,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,MAAM,GAAG,YAAY,CAAC;AAEhE,gEAAgE;AAChE,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,eAAwB,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAwBzF;AAED,iDAAiD;AACjD,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAsBD,oDAAoD;AACpD,wBAAgB,iBAAiB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAmCxF;AAED,+BAA+B;AAC/B,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,kDAAkD;AAClD,wBAAgB,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAoCnF;AAED,4CAA4C;AAC5C,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAclC;AAED,0CAA0C;AAC1C,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAsClC;AAED,gDAAgD;AAChD,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2CzB;AAED,wDAAwD;AACxD,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgCnE"}

package/dist/metrics/provider-detection.d.ts

@@ -0,0 +1,20 @@
+import { type DetectionResult } from '@cleocode/caamp';
+export interface RuntimeProviderContext {
+    runtimeProviderId?: string;
+    runtimeToolName?: string;
+    runtimeVendor?: string;
+    runtimeInstructionFile?: string;
+    runtimeProjectDetected?: boolean;
+    runtimeDetectionMethods?: string[];
+    runtimeCandidates?: string[];
+    inferredModelProvider?: string;
+}
+export interface RuntimeProviderSnapshot {
+    cwd?: string;
+    argv?: string[];
+    env?: NodeJS.ProcessEnv;
+}
+export declare function selectRuntimeProviderContext(detections: DetectionResult[], snapshot?: RuntimeProviderSnapshot): RuntimeProviderContext;
+export declare function detectRuntimeProviderContext(snapshot?: RuntimeProviderSnapshot): RuntimeProviderContext;
+export declare function resetRuntimeProviderContextCache(): void;
+//# sourceMappingURL=provider-detection.d.ts.map

package/dist/metrics/provider-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-detection.d.ts","sourceRoot":"","sources":["../../src/metrics/provider-detection.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,eAAe,EAIrB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,sBAAsB;IACrC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,uBAAuB,CAAC,EAAE,MAAM,EAAE,CAAC;IACnC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,uBAAuB;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAoED,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,eAAe,EAAE,EAC7B,QAAQ,GAAE,uBAA4B,GACrC,sBAAsB,CA2BxB;AAID,wBAAgB,4BAA4B,CAC1C,QAAQ,GAAE,uBAA4B,GACrC,sBAAsB,CAexB;AAED,wBAAgB,gCAAgC,IAAI,IAAI,CAEvD"}

package/dist/metrics/token-estimation.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Token usage estimation and tracking.
+ *
+ * Estimates token consumption using heuristics (1 token ~ 4 chars).
+ * Logs events to TOKEN_USAGE.jsonl for value-proof metrics.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+/** Token event types. */
+export type TokenEventType = 'manifest_read' | 'manifest_query' | 'full_file_read' | 'file_read' | 'skill_inject' | 'protocol_inject' | 'prompt_build' | 'spawn_output' | 'spawn_complete' | 'session_start' | 'session_end';
+/** A token usage event entry. */
+export interface TokenEvent {
+    timestamp: string;
+    event_type: TokenEventType;
+    estimated_tokens: number;
+    source: string;
+    task_id: string | null;
+    session_id: string | null;
+    context: Record<string, unknown>;
+}
+/** Estimate token count from text. ~4 characters per token. */
+export declare function estimateTokens(text: string): number;
+/** Estimate token count from a file. */
+export declare function estimateTokensFromFile(filePath: string): number;
+/** Log a token usage event to the JSONL file. */
+export declare function logTokenEvent(eventType: TokenEventType, tokens: number, source: string, taskId?: string, context?: Record<string, unknown>, cwd?: string): Promise<void>;
+/** Track a file read with token estimate. */
+export declare function trackFileRead(filePath: string, purpose: 'manifest' | 'full_file' | 'full' | 'skill' | 'protocol' | string, taskId?: string, cwd?: string): Promise<number>;
+/** Track a manifest query (partial read). */
+export declare function trackManifestQuery(queryType: string, resultCount: number, taskId?: string, cwd?: string): Promise<number>;
+/** Track skill injection with tokens. */
+export declare function trackSkillInjection(skillName: string, tier: number, tokens: number, taskId?: string, cwd?: string): Promise<void>;
+/** Track final prompt size. */
+export declare function trackPromptBuild(prompt: string, taskId: string, skillsUsed: string, cwd?: string): Promise<number>;
+/** Track subagent output tokens. */
+export declare function trackSpawnOutput(taskId: string, outputText: string, sessionId?: string, cwd?: string): Promise<number>;
+/** Track complete spawn cycle (prompt + output). */
+export declare function trackSpawnComplete(taskId: string, promptTokens: number, outputTokens: number, sessionId?: string, cwd?: string): Promise<number>;
+/** Start tracking tokens for a session. */
+export declare function startTokenSession(sessionId: string, cwd?: string): Promise<void>;
+/** Token session summary shape. */
+export interface TokenSessionSummary {
+    session_id: string;
+    start: string;
+    end: string;
+    tokens: {
+        manifest_reads: number;
+        full_file_reads: number;
+        skill_injections: number;
+        prompt_builds: number;
+        total: number;
+    };
+    savings: {
+        avoided_tokens: number;
+        savings_percent: number;
+    };
+}
+/** End token tracking session with summary. */
+export declare function endTokenSession(cwd?: string): Promise<TokenSessionSummary | null>;
+/** Get token usage summary for a time period. */
+export declare function getTokenSummary(days?: number, cwd?: string): Record<string, unknown>;
+/** Compare manifest vs full file token usage strategies. */
+export declare function compareManifestVsFull(manifestEntries: number): Record<string, unknown>;
+/** Get tracking status. */
+export declare function getTrackingStatus(): {
+    tracking_enabled: boolean;
+    env_var: string;
+};
+//# sourceMappingURL=token-estimation.d.ts.map

package/dist/metrics/token-estimation.d.ts.map

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

package/dist/metrics/token-service.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Provider-aware token measurement and persistence.
+ *
+ * Central SSoT for CLI/MCP/tooling token estimation with a three-layer chain:
+ * 1) OTel/provider telemetry when available
+ * 2) Exact tokenizer for supported models
+ * 3) Heuristic fallback calibrated for JSON vs text payloads
+ *
+ * @task T5618
+ * @why CLEO needs a provider-aware in-house token service instead of relying on a single external runtime.
+ * @what Adds central token measurement, persistence, CRUD, and summary helpers for CLI, MCP, tests, and telemetry tooling.
+ */
+import { type TokenUsageRow } from '../store/tasks-schema.js';
+export type TokenMethod = 'otel' | 'provider_api' | 'tokenizer' | 'heuristic';
+export type TokenConfidence = 'real' | 'high' | 'estimated' | 'coarse';
+export type TokenTransport = 'cli' | 'mcp' | 'api' | 'agent' | 'unknown';
+export interface TokenExchangeInput {
+    requestPayload?: unknown;
+    responsePayload?: unknown;
+    provider?: string;
+    model?: string;
+    transport?: TokenTransport;
+    gateway?: string;
+    domain?: string;
+    operation?: string;
+    sessionId?: string;
+    taskId?: string;
+    requestId?: string;
+    cwd?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface TokenMeasurement {
+    inputChars: number;
+    outputChars: number;
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    method: TokenMethod;
+    confidence: TokenConfidence;
+    provider: string;
+    model?: string;
+    requestHash?: string;
+    responseHash?: string;
+    metadata: Record<string, unknown>;
+}
+export interface TokenUsageFilters {
+    provider?: string;
+    transport?: TokenTransport;
+    gateway?: string;
+    domain?: string;
+    operation?: string;
+    sessionId?: string;
+    taskId?: string;
+    method?: TokenMethod;
+    confidence?: TokenConfidence;
+    requestId?: string;
+    since?: string;
+    until?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface TokenUsageSummary {
+    totalRecords: number;
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    byMethod: Array<{
+        method: string;
+        count: number;
+        totalTokens: number;
+    }>;
+    byTransport: Array<{
+        transport: string;
+        count: number;
+        totalTokens: number;
+    }>;
+    byOperation: Array<{
+        key: string;
+        count: number;
+        totalTokens: number;
+    }>;
+}
+export declare function measureTokenExchange(input: TokenExchangeInput): Promise<TokenMeasurement>;
+export declare function recordTokenExchange(input: TokenExchangeInput): Promise<TokenUsageRow>;
+export declare function showTokenUsage(id: string, cwd?: string): Promise<TokenUsageRow | null>;
+export declare function listTokenUsage(filters?: TokenUsageFilters, cwd?: string): Promise<{
+    records: TokenUsageRow[];
+    total: number;
+    filtered: number;
+}>;
+export declare function summarizeTokenUsage(filters?: TokenUsageFilters, cwd?: string): Promise<TokenUsageSummary>;
+export declare function deleteTokenUsage(id: string, cwd?: string): Promise<{
+    deleted: boolean;
+    id: string;
+}>;
+export declare function clearTokenUsage(filters?: TokenUsageFilters, cwd?: string): Promise<{
+    deleted: number;
+}>;
+export declare function autoRecordDispatchTokenUsage(input: TokenExchangeInput): Promise<void>;
+export declare function getLatestTokenRecord(cwd?: string): Promise<TokenUsageRow | null>;
+export declare function getTokenUsageAggregateSql(cwd?: string): Promise<Array<{
+    provider: string;
+    transport: string;
+    totalTokens: number;
+    count: number;
+}>>;
+//# sourceMappingURL=token-service.d.ts.map

package/dist/metrics/token-service.d.ts.map

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