@substrate-ai/core 0.19.54

package/dist/persistence/schemas/operational.js

@@ -0,0 +1,197 @@
+/**
+ * Category and key-schema constants for operational findings in the decision store.
+ *
+ * These constants avoid string literals scattered across supervisor, orchestrator,
+ * and experimenter code. Import them wherever you need to insert or query
+ * operational decisions.
+ */
+// ---------------------------------------------------------------------------
+// Category constants
+// ---------------------------------------------------------------------------
+/**
+ * Category for supervisor stall events and run-level summaries.
+ *
+ * Key schemas:
+ *   - Stall finding:  "stall:{storyKey}:{timestamp}"
+ *   - Run summary:    "run-summary:{runId}"
+ *
+ * Value shapes:
+ *
+ * Stall finding:
+ * ```json
+ * {
+ *   "phase": "string",                     // story phase at stall time, e.g. "code-review"
+ *   "staleness_secs": 700,
+ *   "attempt": 1,                          // restart attempt number (1-based)
+ *   "outcome": "recovered"                 // "recovered" | "failed" | "max-restarts-escalated"
+ * }
+ * ```
+ *
+ * Run summary:
+ * ```json
+ * {
+ *   "succeeded": ["1-1", "1-2"],
+ *   "failed": ["1-3"],
+ *   "escalated": [],
+ *   "total_restarts": 0,
+ *   "elapsed_seconds": 1234,
+ *   "total_input_tokens": 50000,
+ *   "total_output_tokens": 10000
+ * }
+ * ```
+ */
+export const OPERATIONAL_FINDING = 'operational-finding';
+/**
+ * Category for supervisor experiment results.
+ *
+ * Key schema: "experiment:{runId}:{timestamp}"
+ *
+ * Value shape:
+ * ```json
+ * {
+ *   "target_metric": "token_regression",
+ *   "before": 12000,
+ *   "after": 9500,
+ *   "verdict": "IMPROVED",                // "IMPROVED" | "MIXED" | "REGRESSED"
+ *   "branch_name": "supervisor/experiment/abc12345-dev-story-token-regression"
+ * }
+ * ```
+ */
+export const EXPERIMENT_RESULT = 'experiment-result';
+/**
+ * Category for per-story wall-clock and efficiency metrics.
+ *
+ * Key schema: "{storyKey}:{runId}"
+ *
+ * Value shape:
+ * ```json
+ * {
+ *   "wall_clock_seconds": 180,
+ *   "input_tokens": 8000,
+ *   "output_tokens": 2000,
+ *   "review_cycles": 2,
+ *   "stalled": false
+ * }
+ * ```
+ */
+export const STORY_METRICS = 'story-metrics';
+/**
+ * Category for structured escalation diagnoses.
+ *
+ * Key schema: "{storyKey}:{runId}"
+ *
+ * Value shape:
+ * ```json
+ * {
+ *   "issueDistribution": "concentrated",
+ *   "severityProfile": "major-only",
+ *   "totalIssues": 3,
+ *   "blockerCount": 0,
+ *   "majorCount": 3,
+ *   "minorCount": 0,
+ *   "affectedFiles": ["src/foo.ts"],
+ *   "reviewCycles": 3,
+ *   "recommendedAction": "retry-targeted",
+ *   "rationale": "3 major issues concentrated in few files."
+ * }
+ * ```
+ */
+export const ESCALATION_DIAGNOSIS = 'escalation-diagnosis';
+/**
+ * Category for per-story outcome findings (learning loop).
+ *
+ * Key schema: "{storyKey}:{runId}"
+ *
+ * Value shape:
+ * ```json
+ * {
+ *   "storyKey": "22-1",
+ *   "outcome": "complete",
+ *   "reviewCycles": 2,
+ *   "verdictHistory": ["NEEDS_MINOR_FIXES", "SHIP_IT"],
+ *   "recurringPatterns": ["missing error handling"]
+ * }
+ * ```
+ */
+export const STORY_OUTCOME = 'story-outcome';
+/**
+ * Category for post-implementation test expansion findings generated per-story.
+ *
+ * Key schema: "{storyKey}:{runId}"
+ *
+ * Value shape:
+ * ```json
+ * {
+ *   "expansion_priority": "medium",        // "low" | "medium" | "high"
+ *   "coverage_gaps": [
+ *     {
+ *       "ac_ref": "AC1",
+ *       "description": "Happy path not exercised at module boundary",
+ *       "gap_type": "missing-integration"  // "missing-e2e" | "missing-integration" | "unit-only"
+ *     }
+ *   ],
+ *   "suggested_tests": [
+ *     {
+ *       "test_name": "runFoo integration happy path",
+ *       "test_type": "integration",        // "e2e" | "integration" | "unit"
+ *       "description": "Test runFoo with real DB instance",
+ *       "target_ac": "AC1"                 // optional
+ *     }
+ *   ],
+ *   "notes": "Optional free-text notes",  // optional
+ *   "error": "Error message if fallback"  // optional — present only on graceful fallback
+ * }
+ * ```
+ */
+export const TEST_EXPANSION_FINDING = 'test-expansion-finding';
+/**
+ * Category for pre-implementation test plans generated per-story.
+ *
+ * Key schema: "{storyKey}"
+ *
+ * Value shape:
+ * ```json
+ * {
+ *   "test_files": ["src/modules/foo/__tests__/foo.test.ts"],
+ *   "test_categories": ["unit", "integration"],
+ *   "coverage_notes": "AC1 covered by foo.test.ts"
+ * }
+ * ```
+ */
+export const TEST_PLAN = 'test-plan';
+/**
+ * Category for advisory notes persisted when a code review returns LGTM_WITH_NOTES.
+ *
+ * Key schema: "{storyKey}:{runId}"
+ *
+ * Value shape:
+ * ```json
+ * {
+ *   "storyKey": "25-3",
+ *   "notes": "Consider extracting the helper into a shared module for reuse."
+ * }
+ * ```
+ */
+export const ADVISORY_NOTES = 'advisory-notes';
+/**
+ * Category for root cause taxonomy findings persisted by the learning loop.
+ *
+ * Key schema: "{storyKey}:{runId}"
+ *
+ * Value shape: JSON-serialized `Finding` object from the learning loop, e.g.:
+ * ```json
+ * {
+ *   "id": "uuid",
+ *   "run_id": "run-abc",
+ *   "story_key": "53-5",
+ *   "root_cause": "build-failure",
+ *   "affected_files": ["src/foo.ts"],
+ *   "description": "Build failed after story dispatch",
+ *   "confidence": "high",
+ *   "created_at": "2026-04-06T00:00:00.000Z",
+ *   "expires_after_runs": 5
+ * }
+ * ```
+ */
+export const LEARNING_FINDING = 'finding';
+//# sourceMappingURL=operational.js.map

package/dist/persistence/schemas/operational.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operational.js","sourceRoot":"","sources":["../../../src/persistence/schemas/operational.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAA8B,CAAA;AAEjE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAA4B,CAAA;AAE7D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,eAAwB,CAAA;AAErD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAA+B,CAAA;AAEnE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,eAAwB,CAAA;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,wBAAiC,CAAA;AAEvE;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,WAAoB,CAAA;AAE7C;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,gBAAyB,CAAA;AAEvD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAkB,CAAA"}

package/dist/persistence/types.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Persistence interface definitions for @substrate-ai/core.
+ *
+ * This module contains interface definitions only — no implementations.
+ * Implementations live in the monolith `src/persistence/` and will be
+ * migrated to `packages/core/` in Epic 41.
+ *
+ * Exports:
+ *  - DatabaseAdapter: unified async interface for all persistence backends
+ *  - SyncAdapter: optional synchronous extension for in-memory backends
+ *  - DatabaseAdapterConfig: configuration for the createDatabaseAdapter factory
+ *  - isSyncAdapter: type guard for capability detection
+ *  - InitSchemaFn: function type alias for the initSchema contract
+ */
+/**
+ * Optional synchronous query extension for adapters backed by synchronous engines
+ * (e.g., InMemoryDatabaseAdapter). Consumers that require a synchronous
+ * interface (like MonitorDatabaseImpl) use this to avoid async cascades.
+ */
+export interface SyncAdapter {
+    /** Execute a SQL query synchronously and return typed rows. */
+    querySync<T = unknown>(sql: string, params?: unknown[]): T[];
+    /** Execute a SQL statement synchronously (DDL/DML). */
+    execSync(sql: string): void;
+}
+/**
+ * Unified async database adapter interface.
+ * All persistence backends implement this interface.
+ */
+export interface DatabaseAdapter {
+    /**
+     * The persistence backend powering this adapter.
+     * - 'dolt': backed by a Dolt SQL database (persists to disk)
+     * - 'memory': backed by in-memory Maps (no persistence, lost on process exit)
+     */
+    readonly backendType: 'dolt' | 'memory';
+    /**
+     * Execute a SQL query and return typed rows.
+     * @param sql - SQL query string (use ? for parameter placeholders)
+     * @param params - Optional array of parameter values
+     */
+    query<T = unknown>(sql: string, params?: unknown[]): Promise<T[]>;
+    /**
+     * Execute a SQL statement with no return value.
+     * Suitable for DDL statements (CREATE TABLE, DROP TABLE) and DML without results.
+     * @param sql - SQL statement string
+     */
+    exec(sql: string): Promise<void>;
+    /**
+     * Execute a function within a database transaction.
+     * Commits on successful return, rolls back on thrown error.
+     * @param fn - Async function that receives the adapter and performs operations
+     */
+    transaction<T>(fn: (adapter: DatabaseAdapter) => Promise<T>): Promise<T>;
+    /**
+     * Close the database connection and release all resources.
+     */
+    close(): Promise<void>;
+    /**
+     * Query story keys from the `ready_stories` SQL view.
+     *
+     * Returns an array of story key strings (e.g. ['31-1', '31-2']) for stories
+     * whose status is `planned` or `ready` and whose hard dependencies are all
+     * `complete` in the work graph.
+     *
+     * Returns `[]` when:
+     *   - The `ready_stories` view does not exist (story 31-1 schema not applied)
+     *   - The `stories` table is empty (story 31-2 ingestion has not run)
+     *   - The adapter does not support the work graph (InMemory)
+     *
+     * Callers should treat `[]` as a signal to fall through to the legacy
+     * story discovery chain (decisions table → epic-shard → epics.md).
+     */
+    queryReadyStories(): Promise<string[]>;
+}
+/**
+ * Configuration for the `createDatabaseAdapter` factory.
+ */
+export interface DatabaseAdapterConfig {
+    /**
+     * Which backend to use.
+     * - 'dolt': connect via DoltClient (mysql2 socket or CLI fallback)
+     * - 'memory': in-memory Maps, no persistence (ideal for CI / unit tests)
+     * - 'auto': detect Dolt availability; fall back to 'memory' if not available
+     */
+    backend: 'dolt' | 'memory' | 'auto';
+    /** Project root used for Dolt auto-detection and as the Dolt repo path. */
+    basePath?: string;
+}
+/** Type guard: check if a DatabaseAdapter also implements SyncAdapter. */
+export declare function isSyncAdapter(adapter: DatabaseAdapter): adapter is DatabaseAdapter & SyncAdapter;
+/**
+ * Function type alias describing the `initSchema` contract.
+ * Implementations accept a DatabaseAdapter and initialize all persistence
+ * tables. Must be idempotent — safe to call multiple times.
+ */
+export type InitSchemaFn = (adapter: DatabaseAdapter) => Promise<void>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/persistence/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,CAAA;IAC5D,uDAAuD;IACvD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAA;IAEvC;;;;OAIG;IACH,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAA;IAEjE;;;;OAIG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEhC;;;;OAIG;IACH,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IAExE;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAEtB;;;;;;;;;;;;;;OAcG;IACH,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;CACvC;AAMD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAA;IAEnC,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAMD,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,IAAI,eAAe,GAAG,WAAW,CAEhG;AAMD;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA"}

package/dist/persistence/types.js

@@ -0,0 +1,22 @@
+/**
+ * Persistence interface definitions for @substrate-ai/core.
+ *
+ * This module contains interface definitions only — no implementations.
+ * Implementations live in the monolith `src/persistence/` and will be
+ * migrated to `packages/core/` in Epic 41.
+ *
+ * Exports:
+ *  - DatabaseAdapter: unified async interface for all persistence backends
+ *  - SyncAdapter: optional synchronous extension for in-memory backends
+ *  - DatabaseAdapterConfig: configuration for the createDatabaseAdapter factory
+ *  - isSyncAdapter: type guard for capability detection
+ *  - InitSchemaFn: function type alias for the initSchema contract
+ */
+// ---------------------------------------------------------------------------
+// Type guard
+// ---------------------------------------------------------------------------
+/** Type guard: check if a DatabaseAdapter also implements SyncAdapter. */
+export function isSyncAdapter(adapter) {
+    return typeof adapter.querySync === 'function';
+}
+//# sourceMappingURL=types.js.map

package/dist/persistence/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/persistence/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA8FH,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,0EAA0E;AAC1E,MAAM,UAAU,aAAa,CAAC,OAAwB;IACpD,OAAO,OAAQ,OAAyC,CAAC,SAAS,KAAK,UAAU,CAAA;AACnF,CAAC"}

package/dist/quality-gates/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/quality-gates/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/quality-gates/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA"}

package/dist/quality-gates/index.js

@@ -0,0 +1,2 @@
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/quality-gates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/quality-gates/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA"}

package/dist/quality-gates/types.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Shared types for the Quality Gates module.
+ */
+import { type ZodSchema } from 'zod';
+/**
+ * Result of running a gate evaluator function against some output.
+ */
+export interface GateEvaluation {
+    pass: boolean;
+    issues: string[];
+    severity: 'info' | 'warning' | 'error';
+}
+/**
+ * Function that evaluates an output and returns a GateEvaluation.
+ */
+export type EvaluatorFn = (output: unknown) => GateEvaluation;
+/**
+ * Configuration for a QualityGate instance.
+ */
+export interface GateConfig {
+    /** Human-readable name for this gate */
+    name: string;
+    /** Maximum number of retries before transitioning to 'warn' */
+    maxRetries: number;
+    /** Evaluator function that determines pass/fail */
+    evaluator: EvaluatorFn;
+    /** Optional Zod schema for schema-compliance gate */
+    schema?: ZodSchema<unknown>;
+}
+/**
+ * Result of running evaluate() on a QualityGate.
+ */
+export interface GateResult {
+    /** Action to take based on evaluation outcome */
+    action: 'proceed' | 'retry' | 'warn' | 'escalate';
+    /** Issues reported by the evaluator */
+    issues: string[];
+    /** Number of retries remaining (0 means this is the last retry) */
+    retriesRemaining: number;
+    /** The evaluated output (pass-through on proceed/warn) */
+    result?: unknown;
+}
+/**
+ * Issue reported from a gate within a pipeline run.
+ */
+export interface GateIssue {
+    /** Name of the gate that raised this issue */
+    gate: string;
+    /** Severity of the issue */
+    severity: string;
+    /** Human-readable issue description */
+    message: string;
+}
+/**
+ * Overall result of running a GatePipeline.
+ */
+export interface GatePipelineResult {
+    /** Action to take: proceed if all gates pass, retry/escalate if any gate halts */
+    action: 'proceed' | 'retry' | 'warn' | 'escalate';
+    /** Number of gates that were executed */
+    gatesRun: number;
+    /** Number of gates that passed */
+    gatesPassed: number;
+    /** Accumulated issues from all gates */
+    issues: GateIssue[];
+}
+/**
+ * Options for creating a gate via `createGate()`.
+ */
+export interface CreateGateOptions {
+    /** Human-readable gate name (defaults to the type name) */
+    name?: string;
+    /** Maximum retries before transitioning to 'warn' (defaults to 0) */
+    maxRetries?: number;
+    /** Zod schema for 'schema-compliance' gate type */
+    schema?: ZodSchema<unknown>;
+}
+/**
+ * A quality gate that evaluates output and manages retry logic.
+ */
+export interface QualityGate {
+    /** Name of this gate (from config) */
+    readonly name: string;
+    /**
+     * Evaluate the given output.
+     * - pass → `{ action: 'proceed', result: output }`
+     * - fail, retries remain → `{ action: 'retry', issues, retriesRemaining }`
+     * - fail, no retries → `{ action: 'warn', issues, retriesRemaining: 0 }`
+     */
+    evaluate(output: unknown): GateResult;
+    /** Reset the retry counter to 0 */
+    reset(): void;
+    /** Access to gate configuration */
+    readonly config: GateConfig;
+}
+/**
+ * A pipeline that runs a sequence of QualityGates in order.
+ */
+export interface GatePipeline {
+    /**
+     * Run all gates in order against the given output.
+     * Halts on first 'retry' or 'escalate' result.
+     */
+    run(output: unknown): GatePipelineResult;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/quality-gates/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/quality-gates/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,KAAK,CAAA;AAMpC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,CAAA;IACb,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAA;CACvC;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,OAAO,KAAK,cAAc,CAAA;AAM7D;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAA;IAClB,mDAAmD;IACnD,SAAS,EAAE,WAAW,CAAA;IACtB,qDAAqD;IACrD,MAAM,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAA;CAC5B;AAMD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,iDAAiD;IACjD,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,CAAA;IACjD,uCAAuC;IACvC,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,mEAAmE;IACnE,gBAAgB,EAAE,MAAM,CAAA;IACxB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAMD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,kFAAkF;IAClF,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,CAAA;IACjD,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAA;IAChB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAA;IACnB,wCAAwC;IACxC,MAAM,EAAE,SAAS,EAAE,CAAA;CACpB;AAMD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,mDAAmD;IACnD,MAAM,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAA;CAC5B;AAMD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,UAAU,CAAA;IACrC,mCAAmC;IACnC,KAAK,IAAI,IAAI,CAAA;IACb,mCAAmC;IACnC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAC5B;AAMD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,kBAAkB,CAAA;CACzC"}

package/dist/quality-gates/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared types for the Quality Gates module.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/quality-gates/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/quality-gates/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/routing/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Routing module barrel export.
+ * Re-exports all routing interfaces, schemas, types, and implementations
+ * from @substrate-ai/core.
+ */
+export * from './types.js';
+export * from './routing-decision.js';
+export * from './provider-status.js';
+export * from './model-routing-config.js';
+export * from './routing-policy.js';
+export * from './routing-engine.js';
+export * from './routing-engine-impl.js';
+export * from './model-routing-resolver.js';
+export * from './model-tier.js';
+export * from './routing-recommender.js';
+export * from './routing-telemetry.js';
+export * from './routing-token-accumulator.js';
+export * from './routing-tuner.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/routing/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,YAAY,CAAA;AAG1B,cAAc,uBAAuB,CAAA;AAGrC,cAAc,sBAAsB,CAAA;AAGpC,cAAc,2BAA2B,CAAA;AAGzC,cAAc,qBAAqB,CAAA;AAGnC,cAAc,qBAAqB,CAAA;AAGnC,cAAc,0BAA0B,CAAA;AAGxC,cAAc,6BAA6B,CAAA;AAG3C,cAAc,iBAAiB,CAAA;AAG/B,cAAc,0BAA0B,CAAA;AAGxC,cAAc,wBAAwB,CAAA;AAGtC,cAAc,gCAAgC,CAAA;AAG9C,cAAc,oBAAoB,CAAA"}

package/dist/routing/index.js

@@ -0,0 +1,32 @@
+/**
+ * Routing module barrel export.
+ * Re-exports all routing interfaces, schemas, types, and implementations
+ * from @substrate-ai/core.
+ */
+// Duck-typed interfaces and token-analysis types
+export * from './types.js';
+// RoutingDecision, MonitorRecommendation, RoutingDecisionBuilder, makeRoutingDecision
+export * from './routing-decision.js';
+// ProviderStatus, ProviderStatusTracker
+export * from './provider-status.js';
+// ModelRoutingConfig, ModelPhaseConfig, ModelRoutingConfigSchema, RoutingConfigError, loadModelRoutingConfig
+export * from './model-routing-config.js';
+// RoutingPolicy and related, RoutingPolicySchema, ProviderPolicySchema, loadRoutingPolicy, RoutingPolicyValidationError
+export * from './routing-policy.js';
+// RoutingTask, ModelResolution, IRoutingResolver, RoutingEngine, TASK_TYPE_PHASE_MAP
+export * from './routing-engine.js';
+// RoutingEngineImpl, RoutingEngineImplOptions, createRoutingEngineImpl, createRoutingEngine
+export * from './routing-engine-impl.js';
+// RoutingResolver, ROUTING_RESOLVER_LOGGER_NAME
+export * from './model-routing-resolver.js';
+// getModelTier
+export * from './model-tier.js';
+// RoutingRecommender
+export * from './routing-recommender.js';
+// RoutingTelemetry
+export * from './routing-telemetry.js';
+// RoutingTokenAccumulator
+export * from './routing-token-accumulator.js';
+// RoutingTuner
+export * from './routing-tuner.js';
+//# sourceMappingURL=index.js.map

package/dist/routing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/routing/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,iDAAiD;AACjD,cAAc,YAAY,CAAA;AAE1B,sFAAsF;AACtF,cAAc,uBAAuB,CAAA;AAErC,wCAAwC;AACxC,cAAc,sBAAsB,CAAA;AAEpC,6GAA6G;AAC7G,cAAc,2BAA2B,CAAA;AAEzC,wHAAwH;AACxH,cAAc,qBAAqB,CAAA;AAEnC,qFAAqF;AACrF,cAAc,qBAAqB,CAAA;AAEnC,4FAA4F;AAC5F,cAAc,0BAA0B,CAAA;AAExC,gDAAgD;AAChD,cAAc,6BAA6B,CAAA;AAE3C,eAAe;AACf,cAAc,iBAAiB,CAAA;AAE/B,qBAAqB;AACrB,cAAc,0BAA0B,CAAA;AAExC,mBAAmB;AACnB,cAAc,wBAAwB,CAAA;AAEtC,0BAA0B;AAC1B,cAAc,gCAAgC,CAAA;AAE9C,eAAe;AACf,cAAc,oBAAoB,CAAA"}

package/dist/routing/model-routing-config.d.ts

@@ -0,0 +1,75 @@
+/**
+ * ModelRoutingConfig — Zod schema, types, error, and loader for substrate.routing.yml.
+ *
+ * The routing config YAML controls which model is used for each pipeline phase
+ * (explore / generate / review) and supports per-task-type overrides.
+ *
+ * References:
+ *  - Epic 28, Story 28-4: Model Routing Configuration Schema
+ */
+import { z } from 'zod';
+/**
+ * Per-phase model configuration.
+ */
+export declare const ModelPhaseConfigSchema: z.ZodObject<{
+    model: z.ZodString;
+    max_tokens: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type ModelPhaseConfig = z.infer<typeof ModelPhaseConfigSchema>;
+/**
+ * Complete model routing configuration document.
+ *
+ * All three phase keys (explore, generate, review) are optional — an absent
+ * phase causes resolveModel() to return null, signalling callers to use their
+ * own default model.
+ */
+export declare const ModelRoutingConfigSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    phases: z.ZodObject<{
+        explore: z.ZodOptional<z.ZodObject<{
+            model: z.ZodString;
+            max_tokens: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        generate: z.ZodOptional<z.ZodObject<{
+            model: z.ZodString;
+            max_tokens: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        review: z.ZodOptional<z.ZodObject<{
+            model: z.ZodString;
+            max_tokens: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    baseline_model: z.ZodString;
+    overrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        model: z.ZodString;
+        max_tokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    auto_tune: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type ModelRoutingConfig = z.infer<typeof ModelRoutingConfigSchema>;
+type RoutingConfigErrorCode = 'CONFIG_NOT_FOUND' | 'INVALID_YAML' | 'SCHEMA_INVALID';
+/**
+ * Error thrown by loadModelRoutingConfig() for all failure modes.
+ *
+ * Extends plain Error (not SubstrateError) to keep core package free of monolith imports.
+ */
+export declare class RoutingConfigError extends Error {
+    readonly context?: Record<string, unknown> | undefined;
+    readonly code: 'CONFIG_NOT_FOUND' | 'INVALID_YAML' | 'SCHEMA_INVALID';
+    constructor(message: string, code: RoutingConfigErrorCode, context?: Record<string, unknown> | undefined);
+}
+/**
+ * Load and validate a model routing config YAML file.
+ *
+ * @param filePath - Absolute or relative path to substrate.routing.yml
+ * @returns Parsed and validated ModelRoutingConfig object
+ * @throws {RoutingConfigError} with code CONFIG_NOT_FOUND if the file cannot be read
+ * @throws {RoutingConfigError} with code INVALID_YAML if the file contains invalid YAML
+ * @throws {RoutingConfigError} with code SCHEMA_INVALID if validation fails
+ *
+ * @example
+ * const config = loadModelRoutingConfig('.substrate/routing.yml')
+ */
+export declare function loadModelRoutingConfig(filePath: string): ModelRoutingConfig;
+export {};
+//# sourceMappingURL=model-routing-config.d.ts.map

package/dist/routing/model-routing-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-routing-config.d.ts","sourceRoot":"","sources":["../../src/routing/model-routing-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAYvB;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;iBAMjC,CAAA;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAErE;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;iBAiBnC,CAAA;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAMzE,KAAK,sBAAsB,GAAG,kBAAkB,GAAG,cAAc,GAAG,gBAAgB,CAAA;AAEpF;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAMzC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAL5C,QAAQ,CAAC,IAAI,EAAE,kBAAkB,GAAG,cAAc,GAAG,gBAAgB,CAAA;gBAGnE,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,sBAAsB,EACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAO7C;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CA0C3E"}