@substrate-ai/core 0.19.54

package/dist/persistence/queries/metrics.js

@@ -0,0 +1,237 @@
+/**
+ * Metrics query functions for the persistence layer.
+ *
+ * Provides CRUD operations for run_metrics and story_metrics tables (Story 17-2).
+ *
+ * All functions are async and accept a DatabaseAdapter, making them
+ * compatible with both the SqliteDatabaseAdapter and DoltDatabaseAdapter.
+ */
+// ---------------------------------------------------------------------------
+// Run metrics queries
+// ---------------------------------------------------------------------------
+/**
+ * Write or update run-level metrics.
+ *
+ * Uses a portable delete-then-insert pattern inside a transaction to work on
+ * both SQLite/WASM and Dolt/MySQL. When a row already exists, the `restarts`
+ * and `is_baseline` values are preserved from the existing row (so any
+ * `incrementRunRestarts()` calls made by the supervisor between the caller's
+ * read and this write are not silently overwritten).
+ */
+export async function writeRunMetrics(adapter, input) {
+    await adapter.transaction(async (tx) => {
+        // Read existing row to preserve restarts and is_baseline
+        const existing = await tx.query('SELECT restarts, is_baseline FROM run_metrics WHERE run_id = ?', [input.run_id]);
+        if (existing.length > 0) {
+            await tx.query('DELETE FROM run_metrics WHERE run_id = ?', [input.run_id]);
+        }
+        const restarts = existing[0]?.restarts ?? (input.restarts ?? 0);
+        const isBaseline = existing[0]?.is_baseline ?? (input.is_baseline ?? 0);
+        await tx.query(`INSERT INTO run_metrics (
+        run_id, methodology, status, started_at, completed_at,
+        wall_clock_seconds, total_input_tokens, total_output_tokens, total_cost_usd,
+        stories_attempted, stories_succeeded, stories_failed, stories_escalated,
+        total_review_cycles, total_dispatches, concurrency_setting, max_concurrent_actual, restarts,
+        is_baseline
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+            input.run_id,
+            input.methodology,
+            input.status,
+            input.started_at,
+            input.completed_at ?? null,
+            input.wall_clock_seconds ?? 0,
+            input.total_input_tokens ?? 0,
+            input.total_output_tokens ?? 0,
+            input.total_cost_usd ?? 0,
+            input.stories_attempted ?? 0,
+            input.stories_succeeded ?? 0,
+            input.stories_failed ?? 0,
+            input.stories_escalated ?? 0,
+            input.total_review_cycles ?? 0,
+            input.total_dispatches ?? 0,
+            input.concurrency_setting ?? 1,
+            input.max_concurrent_actual ?? 1,
+            restarts,
+            isBaseline,
+        ]);
+    });
+}
+/**
+ * Get run metrics for a specific run.
+ */
+export async function getRunMetrics(adapter, runId) {
+    const rows = await adapter.query('SELECT * FROM run_metrics WHERE run_id = ?', [runId]);
+    return rows[0];
+}
+/**
+ * List the most recent N run metrics rows, newest first.
+ */
+export async function listRunMetrics(adapter, limit = 10) {
+    return adapter.query('SELECT * FROM run_metrics ORDER BY started_at DESC LIMIT ?', [limit]);
+}
+/**
+ * Tag a run as the baseline (clears any existing baseline first).
+ */
+export async function tagRunAsBaseline(adapter, runId) {
+    await adapter.transaction(async (tx) => {
+        await tx.query('UPDATE run_metrics SET is_baseline = 0');
+        await tx.query('UPDATE run_metrics SET is_baseline = 1 WHERE run_id = ?', [runId]);
+    });
+}
+/**
+ * Get the current baseline run metrics (if any).
+ */
+export async function getBaselineRunMetrics(adapter) {
+    const rows = await adapter.query('SELECT * FROM run_metrics WHERE is_baseline = 1 LIMIT 1');
+    return rows[0];
+}
+/**
+ * Increment the restart count for a run by 1.
+ * Called by the supervisor each time it successfully restarts the pipeline.
+ * If the run_id does not yet exist in run_metrics, a placeholder row is
+ * inserted so the restart count is not lost — writeRunMetrics will overwrite
+ * all other fields when the run reaches a terminal state.
+ *
+ * Uses a portable select-then-update/insert pattern inside a transaction to
+ * work on both SQLite/WASM and Dolt/MySQL.
+ */
+export async function incrementRunRestarts(adapter, runId) {
+    await adapter.transaction(async (tx) => {
+        const existing = await tx.query('SELECT restarts FROM run_metrics WHERE run_id = ?', [runId]);
+        if (existing.length > 0) {
+            await tx.query('UPDATE run_metrics SET restarts = ? WHERE run_id = ?', [existing[0].restarts + 1, runId]);
+        }
+        else {
+            await tx.query(`INSERT INTO run_metrics (run_id, methodology, status, started_at, restarts)
+         VALUES (?, 'unknown', 'running', ?, 1)`, [runId, new Date().toISOString()]);
+        }
+    });
+}
+// ---------------------------------------------------------------------------
+// Story metrics queries
+// ---------------------------------------------------------------------------
+/**
+ * Write or update story-level metrics.
+ *
+ * Uses a portable delete-then-insert pattern inside a transaction to work on
+ * both SQLite/WASM and Dolt/MySQL. When a row already exists, the `started_at`
+ * value is preserved from the existing row if the new value is null.
+ */
+export async function writeStoryMetrics(adapter, input) {
+    await adapter.transaction(async (tx) => {
+        // Read existing row to preserve started_at when new value is null
+        const existing = await tx.query('SELECT started_at FROM story_metrics WHERE run_id = ? AND story_key = ?', [input.run_id, input.story_key]);
+        if (existing.length > 0) {
+            await tx.query('DELETE FROM story_metrics WHERE run_id = ? AND story_key = ?', [input.run_id, input.story_key]);
+        }
+        const startedAt = input.started_at ?? existing[0]?.started_at ?? null;
+        await tx.query(`INSERT INTO story_metrics (
+        run_id, story_key, result, phase_durations_json, started_at, completed_at,
+        wall_clock_seconds, input_tokens, output_tokens, cost_usd,
+        review_cycles, dispatches, primary_agent_id, primary_model, dispatch_agents_json
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+            input.run_id,
+            input.story_key,
+            input.result,
+            input.phase_durations_json ?? null,
+            startedAt,
+            input.completed_at ?? null,
+            input.wall_clock_seconds ?? 0,
+            input.input_tokens ?? 0,
+            input.output_tokens ?? 0,
+            input.cost_usd ?? 0,
+            input.review_cycles ?? 0,
+            input.dispatches ?? 0,
+            input.primary_agent_id ?? null,
+            input.primary_model ?? null,
+            input.dispatch_agents_json ?? null,
+        ]);
+    });
+}
+/**
+ * Get all story metrics for a given run.
+ */
+export async function getStoryMetricsForRun(adapter, runId) {
+    return adapter.query('SELECT * FROM story_metrics WHERE run_id = ? ORDER BY id ASC', [runId]);
+}
+/**
+ * Compare two runs and return percentage deltas for key numeric fields.
+ * Positive deltas mean run B is larger/longer than run A.
+ * Returns null if either run does not exist.
+ */
+export async function compareRunMetrics(adapter, runIdA, runIdB) {
+    const a = await getRunMetrics(adapter, runIdA);
+    const b = await getRunMetrics(adapter, runIdB);
+    if (!a || !b)
+        return null;
+    const pct = (base, diff) => base === 0 ? null : Math.round((diff / base) * 100 * 10) / 10;
+    const inputDelta = b.total_input_tokens - a.total_input_tokens;
+    const outputDelta = b.total_output_tokens - a.total_output_tokens;
+    const clockDelta = (b.wall_clock_seconds ?? 0) - (a.wall_clock_seconds ?? 0);
+    const cycleDelta = b.total_review_cycles - a.total_review_cycles;
+    const costDelta = (b.total_cost_usd ?? 0) - (a.total_cost_usd ?? 0);
+    return {
+        run_id_a: runIdA,
+        run_id_b: runIdB,
+        token_input_delta: inputDelta,
+        token_output_delta: outputDelta,
+        token_input_pct: pct(a.total_input_tokens, inputDelta),
+        token_output_pct: pct(a.total_output_tokens, outputDelta),
+        wall_clock_delta_seconds: clockDelta,
+        wall_clock_pct: pct(a.wall_clock_seconds ?? 0, clockDelta),
+        review_cycles_delta: cycleDelta,
+        review_cycles_pct: pct(a.total_review_cycles, cycleDelta),
+        cost_delta: costDelta,
+        cost_pct: pct(a.total_cost_usd ?? 0, costDelta),
+    };
+}
+/**
+ * Fetch a full run summary for consumption by the supervisor agent (AC5).
+ * Includes per-story metrics and baseline delta percentages.
+ */
+export async function getRunSummaryForSupervisor(adapter, runId) {
+    const run = await getRunMetrics(adapter, runId);
+    if (!run)
+        return null;
+    const stories = await getStoryMetricsForRun(adapter, runId);
+    const baseline = await getBaselineRunMetrics(adapter);
+    let token_vs_baseline_pct = null;
+    let review_cycles_vs_baseline_pct = null;
+    if (baseline && baseline.run_id !== runId) {
+        const pct = (base, val) => base === 0 ? 0 : Math.round(((val - base) / base) * 100 * 10) / 10;
+        token_vs_baseline_pct = pct((baseline.total_input_tokens ?? 0) + (baseline.total_output_tokens ?? 0), (run.total_input_tokens ?? 0) + (run.total_output_tokens ?? 0));
+        review_cycles_vs_baseline_pct = pct(baseline.total_review_cycles ?? 0, run.total_review_cycles ?? 0);
+    }
+    return { run, stories, baseline, token_vs_baseline_pct, review_cycles_vs_baseline_pct };
+}
+// ---------------------------------------------------------------------------
+// Token aggregation
+// ---------------------------------------------------------------------------
+/**
+ * Aggregate token usage from the token_usage table for a pipeline run.
+ */
+export async function aggregateTokenUsageForRun(adapter, runId) {
+    const rows = await adapter.query(`SELECT
+      COALESCE(SUM(input_tokens), 0) as input,
+      COALESCE(SUM(output_tokens), 0) as output,
+      COALESCE(SUM(cost_usd), 0) as cost
+    FROM token_usage
+    WHERE pipeline_run_id = ?`, [runId]);
+    return rows[0] ?? { input: 0, output: 0, cost: 0 };
+}
+/**
+ * Aggregate token usage for a specific story within a pipeline run.
+ * Matches rows where the metadata JSON contains the given storyKey.
+ */
+export async function aggregateTokenUsageForStory(adapter, runId, storyKey) {
+    const rows = await adapter.query(`SELECT
+      COALESCE(SUM(input_tokens), 0) as input,
+      COALESCE(SUM(output_tokens), 0) as output,
+      COALESCE(SUM(cost_usd), 0) as cost
+    FROM token_usage
+    WHERE pipeline_run_id = ?
+      AND metadata IS NOT NULL
+      AND metadata LIKE ?`, [runId, `%"storyKey":"${storyKey}"%`]);
+    return rows[0] ?? { input: 0, output: 0, cost: 0 };
+}
+//# sourceMappingURL=metrics.js.map

package/dist/persistence/queries/metrics.js.map

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

package/dist/persistence/queries/retry-escalated.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Query functions for retryable escalated stories.
+ *
+ * Reads escalation-diagnosis decisions from the decision store and classifies
+ * each story as retryable (retry-targeted) or skipped (human-intervention /
+ * split-story).
+ *
+ * All functions are async and accept a DatabaseAdapter, making them
+ * compatible with both the SqliteDatabaseAdapter and DoltDatabaseAdapter.
+ */
+import type { DatabaseAdapter } from '../types.js';
+export interface SkippedStory {
+    key: string;
+    reason: string;
+}
+export interface RetryableEscalationsResult {
+    retryable: string[];
+    skipped: SkippedStory[];
+}
+/**
+ * Query the decision store for escalation-diagnosis decisions and classify
+ * each story key as retryable or skipped.
+ *
+ * Key format in the DB: `{storyKey}:{runId}`
+ *
+ * - When `runId` is provided, only decisions whose key contains that runId
+ *   are considered (AC5 scoping).
+ * - When `runId` is omitted, the runId of the last (most recently created)
+ *   escalation-diagnosis decision is used as the default (AC1 defaulting).
+ *
+ * @param adapter  The database adapter
+ * @param runId    Optional run ID to scope the query
+ */
+export declare function getRetryableEscalations(adapter: DatabaseAdapter, runId?: string): Promise<RetryableEscalationsResult>;
+//# sourceMappingURL=retry-escalated.d.ts.map

package/dist/persistence/queries/retry-escalated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-escalated.d.ts","sourceRoot":"","sources":["../../../src/persistence/queries/retry-escalated.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAiBlD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,OAAO,EAAE,YAAY,EAAE,CAAA;CACxB;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,eAAe,EACxB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,0BAA0B,CAAC,CAmErC"}

package/dist/persistence/queries/retry-escalated.js

@@ -0,0 +1,83 @@
+/**
+ * Query functions for retryable escalated stories.
+ *
+ * Reads escalation-diagnosis decisions from the decision store and classifies
+ * each story as retryable (retry-targeted) or skipped (human-intervention /
+ * split-story).
+ *
+ * All functions are async and accept a DatabaseAdapter, making them
+ * compatible with both the SqliteDatabaseAdapter and DoltDatabaseAdapter.
+ */
+import { getDecisionsByCategory } from './decisions.js';
+import { ESCALATION_DIAGNOSIS } from '../schemas/operational.js';
+// ---------------------------------------------------------------------------
+// Query
+// ---------------------------------------------------------------------------
+/**
+ * Query the decision store for escalation-diagnosis decisions and classify
+ * each story key as retryable or skipped.
+ *
+ * Key format in the DB: `{storyKey}:{runId}`
+ *
+ * - When `runId` is provided, only decisions whose key contains that runId
+ *   are considered (AC5 scoping).
+ * - When `runId` is omitted, the runId of the last (most recently created)
+ *   escalation-diagnosis decision is used as the default (AC1 defaulting).
+ *
+ * @param adapter  The database adapter
+ * @param runId    Optional run ID to scope the query
+ */
+export async function getRetryableEscalations(adapter, runId) {
+    const decisions = await getDecisionsByCategory(adapter, ESCALATION_DIAGNOSIS);
+    const result = { retryable: [], skipped: [] };
+    if (decisions.length === 0) {
+        return result;
+    }
+    const parsed = [];
+    for (const decision of decisions) {
+        const colonIdx = decision.key.indexOf(':');
+        if (colonIdx === -1)
+            continue; // skip malformed keys
+        const storyKey = decision.key.slice(0, colonIdx);
+        const decisionRunId = decision.key.slice(colonIdx + 1);
+        let diagnosis;
+        try {
+            diagnosis = JSON.parse(decision.value);
+        }
+        catch {
+            continue; // skip malformed values
+        }
+        parsed.push({ storyKey, decisionRunId, diagnosis });
+    }
+    if (parsed.length === 0) {
+        return result;
+    }
+    // Determine effective runId:
+    // - If caller supplies a runId, use it (AC5)
+    // - Otherwise, use the runId of the last decision (most recently created = latest run) (AC1)
+    const effectiveRunId = runId ?? (parsed[parsed.length - 1].decisionRunId);
+    // Deduplicate by storyKey: keep the last entry per storyKey (last write wins since the
+    // list is ordered by created_at ASC — later entries in the array are more recent).
+    const lastEntryByKey = new Map();
+    for (const entry of parsed) {
+        if (entry.decisionRunId !== effectiveRunId)
+            continue;
+        // Overwrite so the last occurrence wins
+        lastEntryByKey.set(entry.storyKey, entry);
+    }
+    for (const [storyKey, entry] of lastEntryByKey.entries()) {
+        const { recommendedAction } = entry.diagnosis;
+        if (recommendedAction === 'retry-targeted') {
+            result.retryable.push(storyKey);
+        }
+        else if (recommendedAction === 'human-intervention') {
+            result.skipped.push({ key: storyKey, reason: 'needs human review' });
+        }
+        else if (recommendedAction === 'split-story') {
+            result.skipped.push({ key: storyKey, reason: 'story should be split' });
+        }
+        // Unknown recommendedAction values are silently ignored
+    }
+    return result;
+}
+//# sourceMappingURL=retry-escalated.js.map

package/dist/persistence/queries/retry-escalated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-escalated.js","sourceRoot":"","sources":["../../../src/persistence/queries/retry-escalated.ts"],"names":[],"mappings":"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"}

package/dist/persistence/schema-version.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Schema version management contract for @substrate-ai/core.
+ *
+ * This module defines the versioning contract — interfaces, type aliases,
+ * constants, and the `checkSchemaVersion` runtime function. It does NOT
+ * contain schema DDL for application tables (those live in schema.ts).
+ *
+ * The concrete `SchemaVersionManagerImpl` is added in Epic 41 (story 41-3).
+ * Factory schema versioning (Epic 44) uses `FACTORY_SCHEMA_NAME` defined here.
+ */
+import type { DatabaseAdapter } from './types.js';
+/** Canonical schema name for the core (monolith) persistence schema. */
+export declare const CORE_SCHEMA_NAME: "core";
+/** Canonical schema name for the factory persistence schema (Epic 44+). */
+export declare const FACTORY_SCHEMA_NAME: "factory";
+/**
+ * Canonical DDL for the `schema_version` table.
+ * Epic 41 will call this as part of `initSchema`.
+ */
+export declare const SCHEMA_VERSION_DDL: "\n  CREATE TABLE IF NOT EXISTS schema_version (\n    schema_name TEXT    NOT NULL,\n    version     INTEGER NOT NULL,\n    applied_at  TEXT    NOT NULL DEFAULT CURRENT_TIMESTAMP,\n    PRIMARY KEY (schema_name)\n  )\n";
+/** A single row in the `schema_version` table. */
+export interface SchemaVersionRecord {
+    schema_name: string;
+    version: number;
+    applied_at: string;
+}
+/**
+ * Result returned by `checkSchemaVersion`.
+ *
+ * - `action: 'ok'`           — stored version matches expected; no action needed
+ * - `action: 'migrate'`      — stored version is less than expected; run migrations
+ * - `action: 'incompatible'` — stored version is null (table empty) or greater
+ *                              than expected; manual intervention required
+ */
+export interface SchemaVersionCheckResult {
+    compatible: boolean;
+    storedVersion: number | null;
+    expectedVersion: number;
+    action: 'ok' | 'migrate' | 'incompatible';
+}
+/**
+ * Interface for the schema version manager.
+ * The concrete implementation (`SchemaVersionManagerImpl`) is added in Epic 41.
+ */
+export interface SchemaVersionManager {
+    /** Ensure the `schema_version` table exists (idempotent). */
+    ensureVersionTable(adapter: DatabaseAdapter): Promise<void>;
+    /**
+     * Return the currently stored version for `schemaName`, or `null` if no
+     * row exists for that schema.
+     */
+    getCurrentVersion(adapter: DatabaseAdapter, schemaName: string): Promise<number | null>;
+    /** Upsert the version row for `schemaName`. */
+    setVersion(adapter: DatabaseAdapter, schemaName: string, version: number): Promise<void>;
+}
+/**
+ * A single schema migration step.
+ * Migrations must be strictly additive on the `'migrate'` path (new columns
+ * with defaults, new tables). Destructive changes require `'incompatible'`.
+ */
+export interface SchemaMigration {
+    fromVersion: number;
+    toVersion: number;
+    description: string;
+    up: (adapter: DatabaseAdapter) => Promise<void>;
+}
+/**
+ * Function type alias for the migration orchestration entry point.
+ * Implementations are responsible for ordering migrations by `fromVersion`,
+ * executing them in sequence, and updating the version row after each step.
+ */
+export type MigrationRunner = (adapter: DatabaseAdapter, migrations: SchemaMigration[], schemaName: string, targetVersion: number) => Promise<void>;
+/**
+ * Check whether the stored schema version for `schemaName` is compatible with
+ * `expectedVersion`.
+ *
+ * Queries the `schema_version` table directly via `adapter`.  Callers must
+ * ensure the table exists before calling this function (use
+ * `SchemaVersionManager.ensureVersionTable` or include `SCHEMA_VERSION_DDL`
+ * in `initSchema`).
+ *
+ * Decision logic:
+ *   - `storedVersion === expectedVersion`  → `{ action: 'ok', compatible: true }`
+ *   - `storedVersion < expectedVersion`    → `{ action: 'migrate', compatible: false }`
+ *   - `storedVersion > expectedVersion`    → `{ action: 'incompatible', compatible: false }`
+ *   - no row for `schemaName`              → `{ action: 'incompatible', compatible: false }`
+ */
+export declare function checkSchemaVersion(adapter: DatabaseAdapter, schemaName: string, expectedVersion: number): Promise<SchemaVersionCheckResult>;
+//# sourceMappingURL=schema-version.d.ts.map

package/dist/persistence/schema-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-version.d.ts","sourceRoot":"","sources":["../../src/persistence/schema-version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAMjD,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,EAAG,MAAe,CAAA;AAE/C,2EAA2E;AAC3E,eAAO,MAAM,mBAAmB,EAAG,SAAkB,CAAA;AAMrD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,4NAOrB,CAAA;AAMV,kDAAkD;AAClD,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,OAAO,CAAA;IACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,eAAe,EAAE,MAAM,CAAA;IACvB,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,cAAc,CAAA;CAC1C;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,6DAA6D;IAC7D,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE3D;;;OAGG;IACH,iBAAiB,CAAC,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IAEvF,+CAA+C;IAC/C,UAAU,CAAC,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACzF;AAMD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,EAAE,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAChD;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,CAC5B,OAAO,EAAE,eAAe,EACxB,UAAU,EAAE,eAAe,EAAE,EAC7B,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,KAClB,OAAO,CAAC,IAAI,CAAC,CAAA;AAMlB;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,eAAe,EACxB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,wBAAwB,CAAC,CAuBnC"}

package/dist/persistence/schema-version.js

@@ -0,0 +1,67 @@
+/**
+ * Schema version management contract for @substrate-ai/core.
+ *
+ * This module defines the versioning contract — interfaces, type aliases,
+ * constants, and the `checkSchemaVersion` runtime function. It does NOT
+ * contain schema DDL for application tables (those live in schema.ts).
+ *
+ * The concrete `SchemaVersionManagerImpl` is added in Epic 41 (story 41-3).
+ * Factory schema versioning (Epic 44) uses `FACTORY_SCHEMA_NAME` defined here.
+ */
+// ---------------------------------------------------------------------------
+// Schema name constants
+// ---------------------------------------------------------------------------
+/** Canonical schema name for the core (monolith) persistence schema. */
+export const CORE_SCHEMA_NAME = 'core';
+/** Canonical schema name for the factory persistence schema (Epic 44+). */
+export const FACTORY_SCHEMA_NAME = 'factory';
+// ---------------------------------------------------------------------------
+// DDL
+// ---------------------------------------------------------------------------
+/**
+ * Canonical DDL for the `schema_version` table.
+ * Epic 41 will call this as part of `initSchema`.
+ */
+export const SCHEMA_VERSION_DDL = `
+  CREATE TABLE IF NOT EXISTS schema_version (
+    schema_name TEXT    NOT NULL,
+    version     INTEGER NOT NULL,
+    applied_at  TEXT    NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    PRIMARY KEY (schema_name)
+  )
+`;
+// ---------------------------------------------------------------------------
+// Runtime helper
+// ---------------------------------------------------------------------------
+/**
+ * Check whether the stored schema version for `schemaName` is compatible with
+ * `expectedVersion`.
+ *
+ * Queries the `schema_version` table directly via `adapter`.  Callers must
+ * ensure the table exists before calling this function (use
+ * `SchemaVersionManager.ensureVersionTable` or include `SCHEMA_VERSION_DDL`
+ * in `initSchema`).
+ *
+ * Decision logic:
+ *   - `storedVersion === expectedVersion`  → `{ action: 'ok', compatible: true }`
+ *   - `storedVersion < expectedVersion`    → `{ action: 'migrate', compatible: false }`
+ *   - `storedVersion > expectedVersion`    → `{ action: 'incompatible', compatible: false }`
+ *   - no row for `schemaName`              → `{ action: 'incompatible', compatible: false }`
+ */
+export async function checkSchemaVersion(adapter, schemaName, expectedVersion) {
+    const rows = await adapter.query('SELECT schema_name, version, applied_at FROM schema_version WHERE schema_name = ?', [schemaName]);
+    const firstRow = rows.length > 0 ? rows[0] : undefined;
+    const storedVersion = firstRow !== undefined ? firstRow.version : null;
+    if (storedVersion === null) {
+        return { compatible: false, storedVersion: null, expectedVersion, action: 'incompatible' };
+    }
+    if (storedVersion === expectedVersion) {
+        return { compatible: true, storedVersion, expectedVersion, action: 'ok' };
+    }
+    if (storedVersion < expectedVersion) {
+        return { compatible: false, storedVersion, expectedVersion, action: 'migrate' };
+    }
+    // storedVersion > expectedVersion
+    return { compatible: false, storedVersion, expectedVersion, action: 'incompatible' };
+}
+//# sourceMappingURL=schema-version.js.map

package/dist/persistence/schema-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-version.js","sourceRoot":"","sources":["../../src/persistence/schema-version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,wEAAwE;AACxE,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAe,CAAA;AAE/C,2EAA2E;AAC3E,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAkB,CAAA;AAErD,8EAA8E;AAC9E,MAAM;AACN,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;CAOxB,CAAA;AA0EV,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAwB,EACxB,UAAkB,EAClB,eAAuB;IAEvB,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,KAAK,CAC9B,mFAAmF,EACnF,CAAC,UAAU,CAAC,CACb,CAAA;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IACtD,MAAM,aAAa,GAAkB,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAA;IAErF,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA;IAC5F,CAAC;IAED,IAAI,aAAa,KAAK,eAAe,EAAE,CAAC;QACtC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;IAC3E,CAAC;IAED,IAAI,aAAa,GAAG,eAAe,EAAE,CAAC;QACpC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;IACjF,CAAC;IAED,kCAAkC;IAClC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA;AACtF,CAAC"}

package/dist/persistence/schema.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Consolidated schema DDL for all persistence tables.
+ *
+ * Replaces the 11 separate SQLite migration files with a single
+ * async function that creates all tables via DatabaseAdapter.
+ *
+ * All tables use CREATE TABLE IF NOT EXISTS for idempotency.
+ * Indexes and views use IF NOT EXISTS.
+ *
+ * Schema covers:
+ *   - Core: sessions, tasks, task_dependencies, execution_log
+ *   - Cost: cost_entries
+ *   - Pipeline: pipeline_runs, decisions, requirements, constraints, artifacts, token_usage
+ *   - Plans: plans, plan_versions
+ *   - Signals: session_signals
+ *   - Metrics: run_metrics, story_metrics
+ *   - Monitor: task_metrics, performance_aggregates, routing_recommendations
+ *   - Telemetry: turn_analysis, efficiency_scores, recommendations, category_stats, consumer_stats
+ */
+import type { DatabaseAdapter } from './types.js';
+/**
+ * Initialize all persistence tables on the given adapter.
+ * Idempotent — safe to call multiple times.
+ */
+export declare function initSchema(adapter: DatabaseAdapter): Promise<void>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/persistence/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/persistence/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA0fxE"}