substrate-ai 0.9.0 → 0.11.0

package/dist/operational-BdcdmDqS.js

@@ -1,374 +0,0 @@
-//#region src/persistence/queries/metrics.ts
-/**
-* 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).
-*/
-async function writeRunMetrics(adapter, input) {
-	await adapter.transaction(async (tx) => {
-		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.
-*/
-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.
-*/
-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).
-*/
-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).
-*/
-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.
-*/
-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()]);
-	});
-}
-/**
-* 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.
-*/
-async function writeStoryMetrics(adapter, input) {
-	await adapter.transaction(async (tx) => {
-		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
-      ) 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
-		]);
-	});
-}
-/**
-* Get all story metrics for a given run.
-*/
-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.
-*/
-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)
-	};
-}
-/**
-* Aggregate token usage from the token_usage table for a pipeline run.
-*/
-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.
-*/
-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
-	};
-}
-
-//#endregion
-//#region src/persistence/schemas/operational.ts
-/**
-* 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 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
-* }
-* ```
-*/
-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"
-* }
-* ```
-*/
-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
-* }
-* ```
-*/
-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."
-* }
-* ```
-*/
-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"]
-* }
-* ```
-*/
-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
-* }
-* ```
-*/
-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"
-* }
-* ```
-*/
-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."
-* }
-* ```
-*/
-const ADVISORY_NOTES = "advisory-notes";
-
-//#endregion
-export { ADVISORY_NOTES, ESCALATION_DIAGNOSIS, EXPERIMENT_RESULT, OPERATIONAL_FINDING, STORY_METRICS, STORY_OUTCOME, TEST_EXPANSION_FINDING, TEST_PLAN, aggregateTokenUsageForRun, aggregateTokenUsageForStory, compareRunMetrics, getBaselineRunMetrics, getRunMetrics, getStoryMetricsForRun, incrementRunRestarts, listRunMetrics, tagRunAsBaseline, writeRunMetrics, writeStoryMetrics };
-//# sourceMappingURL=operational-BdcdmDqS.js.map