sdd-agent-platform 0.3.0 → 0.4.0

package/node_modules/@sdd-agent-platform/core/dist/storage/runtime-store.js

@@ -0,0 +1,362 @@
+import { createHash } from 'node:crypto';
+import { mkdir, readFile } from 'node:fs/promises';
+import { getRuntimeStorePath, getSddDir } from '../runtime-paths.js';
+import { exists } from './json-io.js';
+import { RUNTIME_PROJECTION_ENVELOPE_CONTRACT_VERSION } from '../contracts.js';
+export const RUNTIME_STORE_SCHEMA_VERSION = 2;
+export const RUNTIME_STORE_CONTRACT_VERSION = 'phase-7.2-runtime-store-v2';
+export class RuntimeStoreError extends Error {
+    code;
+    constructor(code, message, options) {
+        super(message);
+        this.code = code;
+        this.name = 'RuntimeStoreError';
+        this.cause = options?.cause;
+    }
+}
+let runtimeStoreConstructorPromise = null;
+export async function withRuntimeStore(projectRoot, fn) {
+    const store = await openRuntimeStore(projectRoot);
+    try {
+        return await fn(store);
+    }
+    finally {
+        store.db.close();
+    }
+}
+async function loadRuntimeStoreConstructor() {
+    runtimeStoreConstructorPromise ??= importNodeSqlite()
+        .then((sqlite) => sqlite.DatabaseSync)
+        .catch((error) => {
+        throw new RuntimeStoreError('STORE_UNAVAILABLE', `node:sqlite is unavailable: ${messageFromError(error)}`, { cause: error });
+    });
+    return runtimeStoreConstructorPromise;
+}
+async function importNodeSqlite() {
+    const emitWarning = process.emitWarning;
+    const forwardWarning = emitWarning;
+    process.emitWarning = ((warning, ...args) => {
+        const message = warning instanceof Error ? warning.message : warning;
+        if (typeof message === 'string' && message.includes('SQLite is an experimental feature')) {
+            return;
+        }
+        return forwardWarning.call(process, warning, ...args);
+    });
+    try {
+        return await import('node:sqlite');
+    }
+    finally {
+        process.emitWarning = emitWarning;
+    }
+}
+async function openRuntimeStore(projectRoot) {
+    await mkdir(getSddDir(projectRoot), { recursive: true });
+    const DatabaseSync = await loadRuntimeStoreConstructor();
+    const storePath = getRuntimeStorePath(projectRoot);
+    let db;
+    try {
+        db = new DatabaseSync(storePath);
+    }
+    catch (error) {
+        throw new RuntimeStoreError('STORE_UNAVAILABLE', `Cannot open runtime store ${storePath}: ${messageFromError(error)}`, { cause: error });
+    }
+    try {
+        db.exec('PRAGMA foreign_keys = ON');
+        db.exec('PRAGMA busy_timeout = 5000');
+        db.exec('PRAGMA journal_mode = WAL');
+        initializeRuntimeStoreSchema(db);
+        return { path: storePath, db };
+    }
+    catch (error) {
+        db.close();
+        throw new RuntimeStoreError('SCHEMA_MISMATCH', `Cannot initialize runtime store ${storePath}: ${messageFromError(error)}`, { cause: error });
+    }
+}
+function initializeRuntimeStoreSchema(db) {
+    const currentVersion = readRuntimeStoreSchemaVersion(db);
+    if (currentVersion > RUNTIME_STORE_SCHEMA_VERSION) {
+        throw new RuntimeStoreError('SCHEMA_MISMATCH', `Runtime store schema ${currentVersion} is newer than supported schema ${RUNTIME_STORE_SCHEMA_VERSION}.`);
+    }
+    db.exec(`
+CREATE TABLE IF NOT EXISTS runtime_meta (key TEXT PRIMARY KEY, value TEXT NOT NULL, updated_at TEXT NOT NULL);
+CREATE TABLE IF NOT EXISTS runs (run_id TEXT PRIMARY KEY, status TEXT NOT NULL, phase TEXT, current_task TEXT, partition TEXT, git_branch TEXT, task_id TEXT, created_at TEXT NOT NULL, updated_at TEXT NOT NULL, state_json TEXT NOT NULL, state_hash TEXT NOT NULL);
+CREATE TABLE IF NOT EXISTS events (event_id INTEGER PRIMARY KEY AUTOINCREMENT, run_id TEXT NOT NULL, event_time TEXT NOT NULL, event_name TEXT NOT NULL, event_hash TEXT NOT NULL, event_json TEXT NOT NULL, source TEXT NOT NULL DEFAULT 'runtime', FOREIGN KEY(run_id) REFERENCES runs(run_id) ON DELETE CASCADE, UNIQUE(run_id, event_hash));
+CREATE TABLE IF NOT EXISTS attempts (attempt_id TEXT PRIMARY KEY, run_id TEXT NOT NULL, task_id TEXT, status TEXT, payload_json TEXT NOT NULL, updated_at TEXT NOT NULL, FOREIGN KEY(run_id) REFERENCES runs(run_id) ON DELETE CASCADE);
+CREATE TABLE IF NOT EXISTS activities (activity_id TEXT PRIMARY KEY, run_id TEXT NOT NULL, task_id TEXT, branch TEXT, kind TEXT NOT NULL, ref TEXT NOT NULL, status TEXT, created_at TEXT NOT NULL, payload_json TEXT NOT NULL, FOREIGN KEY(run_id) REFERENCES runs(run_id) ON DELETE CASCADE);
+CREATE TABLE IF NOT EXISTS artifacts (artifact_id TEXT PRIMARY KEY, run_id TEXT NOT NULL, path TEXT NOT NULL, kind TEXT NOT NULL, task_id TEXT, agent TEXT, content_hash TEXT NOT NULL, bytes INTEGER NOT NULL, status TEXT NOT NULL, created_at TEXT NOT NULL, payload_json TEXT NOT NULL, FOREIGN KEY(run_id) REFERENCES runs(run_id) ON DELETE CASCADE, UNIQUE(run_id, path, content_hash));
+CREATE TABLE IF NOT EXISTS artifact_ingestions (ingestion_id TEXT PRIMARY KEY, run_id TEXT NOT NULL, delegation_id TEXT NOT NULL, task_id TEXT NOT NULL, agent TEXT NOT NULL, artifact_path TEXT NOT NULL, status TEXT NOT NULL, result_status TEXT, ingested_at TEXT NOT NULL, payload_json TEXT NOT NULL, FOREIGN KEY(run_id) REFERENCES runs(run_id) ON DELETE CASCADE);
+CREATE TABLE IF NOT EXISTS policy_decisions (decision_id TEXT PRIMARY KEY, run_id TEXT NOT NULL, task_id TEXT, acceptance_id TEXT, status TEXT NOT NULL, issue_codes TEXT NOT NULL, created_at TEXT NOT NULL, payload_json TEXT NOT NULL, FOREIGN KEY(run_id) REFERENCES runs(run_id) ON DELETE CASCADE);
+CREATE TABLE IF NOT EXISTS evidence_claims (claim_id TEXT PRIMARY KEY, run_id TEXT NOT NULL, partition TEXT, task_id TEXT NOT NULL, acceptance_id TEXT NOT NULL, coverage_status TEXT NOT NULL, source_artifact TEXT NOT NULL, is_derived INTEGER NOT NULL, created_at TEXT NOT NULL, payload_json TEXT NOT NULL, FOREIGN KEY(run_id) REFERENCES runs(run_id) ON DELETE CASCADE);
+CREATE TABLE IF NOT EXISTS evidence_attachments (evidence_id TEXT PRIMARY KEY, branch_slug TEXT NOT NULL, run_id TEXT, task_id TEXT, kind TEXT NOT NULL, relative_path TEXT NOT NULL, content_hash TEXT NOT NULL, bytes INTEGER NOT NULL, created_at TEXT NOT NULL, payload_json TEXT NOT NULL, FOREIGN KEY(run_id) REFERENCES runs(run_id) ON DELETE CASCADE, UNIQUE(branch_slug, relative_path, content_hash));
+CREATE TABLE IF NOT EXISTS gaps (gap_id TEXT PRIMARY KEY, run_id TEXT, task_id TEXT, severity TEXT NOT NULL, payload_json TEXT NOT NULL, created_at TEXT NOT NULL);
+CREATE TABLE IF NOT EXISTS recovery_actions (action_id TEXT PRIMARY KEY, run_id TEXT, task_id TEXT, status TEXT NOT NULL, payload_json TEXT NOT NULL, created_at TEXT NOT NULL);
+CREATE TABLE IF NOT EXISTS source_snapshots (snapshot_id TEXT PRIMARY KEY, run_id TEXT NOT NULL, partition TEXT, spec_hash TEXT, plan_hash TEXT, tasks_hash TEXT, created_at TEXT NOT NULL, payload_json TEXT NOT NULL, FOREIGN KEY(run_id) REFERENCES runs(run_id) ON DELETE CASCADE);
+CREATE TABLE IF NOT EXISTS projections (projection_id TEXT PRIMARY KEY, projection_type TEXT NOT NULL, scope_key TEXT NOT NULL, generated_at TEXT NOT NULL, payload_json TEXT NOT NULL, UNIQUE(projection_type, scope_key));
+CREATE TABLE IF NOT EXISTS legacy_imports (import_id TEXT PRIMARY KEY, run_id TEXT NOT NULL, entity_type TEXT NOT NULL, content_hash TEXT NOT NULL, imported_at TEXT NOT NULL, status TEXT NOT NULL, issue TEXT, UNIQUE(run_id, entity_type));
+CREATE TABLE IF NOT EXISTS test_runs (test_run_id TEXT PRIMARY KEY, run_id TEXT NOT NULL, partition TEXT, task_id TEXT NOT NULL, status TEXT NOT NULL, started_at TEXT NOT NULL, completed_at TEXT NOT NULL, payload_json TEXT NOT NULL, FOREIGN KEY(run_id) REFERENCES runs(run_id) ON DELETE CASCADE);
+CREATE TABLE IF NOT EXISTS test_steps (test_step_id TEXT PRIMARY KEY, test_run_id TEXT NOT NULL, run_id TEXT NOT NULL, task_id TEXT NOT NULL, command TEXT NOT NULL, status TEXT NOT NULL, exit_code INTEGER, duration_ms INTEGER NOT NULL, output_artifact TEXT NOT NULL, payload_json TEXT NOT NULL, FOREIGN KEY(test_run_id) REFERENCES test_runs(test_run_id) ON DELETE CASCADE, FOREIGN KEY(run_id) REFERENCES runs(run_id) ON DELETE CASCADE);
+CREATE INDEX IF NOT EXISTS idx_runs_partition_task_updated ON runs(partition, task_id, updated_at);
+CREATE INDEX IF NOT EXISTS idx_events_run_time ON events(run_id, event_time, event_id);
+CREATE INDEX IF NOT EXISTS idx_artifacts_run_path ON artifacts(run_id, path);
+CREATE INDEX IF NOT EXISTS idx_evidence_claims_run_task ON evidence_claims(run_id, task_id, acceptance_id);
+CREATE INDEX IF NOT EXISTS idx_evidence_attachments_branch_created ON evidence_attachments(branch_slug, created_at);
+CREATE INDEX IF NOT EXISTS idx_evidence_attachments_run_path ON evidence_attachments(run_id, relative_path);
+CREATE INDEX IF NOT EXISTS idx_test_runs_run_task ON test_runs(run_id, task_id, completed_at);
+CREATE INDEX IF NOT EXISTS idx_test_steps_test_run ON test_steps(test_run_id, status);
+`);
+    db.exec(`PRAGMA user_version = ${RUNTIME_STORE_SCHEMA_VERSION}`);
+    const now = new Date().toISOString();
+    db.prepare('INSERT OR REPLACE INTO runtime_meta (key, value, updated_at) VALUES (?, ?, ?)').run('contract', RUNTIME_STORE_CONTRACT_VERSION, now);
+    db.prepare('INSERT OR REPLACE INTO runtime_meta (key, value, updated_at) VALUES (?, ?, ?)').run('schema_version', String(RUNTIME_STORE_SCHEMA_VERSION), now);
+}
+function readRuntimeStoreSchemaVersion(db) {
+    const row = db.prepare('PRAGMA user_version').get();
+    return typeof row?.user_version === 'number' ? row.user_version : 0;
+}
+export async function recordRuntimeEvent(projectRoot, event, source = 'runtime') {
+    const eventJson = JSON.stringify(event);
+    await withRuntimeStore(projectRoot, ({ db }) => {
+        db.prepare('INSERT OR IGNORE INTO events (run_id, event_time, event_name, event_hash, event_json, source) VALUES (?, ?, ?, ?, ?, ?)')
+            .run(event.runId, event.time, event.event, hashDocumentContent(eventJson), eventJson, source);
+    });
+}
+export async function importLegacyRunEventsIfNeeded(projectRoot, runId, eventPath) {
+    if (!await exists(eventPath)) {
+        return;
+    }
+    try {
+        const raw = await readFile(eventPath, 'utf8');
+        const contentHash = hashDocumentContent(raw);
+        await withRuntimeStore(projectRoot, ({ db }) => {
+            const legacy = db.prepare('SELECT content_hash FROM legacy_imports WHERE run_id = ? AND entity_type = ?').get(runId, 'events');
+            if (legacy?.content_hash === contentHash) {
+                return;
+            }
+            for (const line of raw.split(/\r?\n/).filter((item) => item.trim().length > 0)) {
+                const event = JSON.parse(line);
+                const eventJson = JSON.stringify(event);
+                db.prepare('INSERT OR IGNORE INTO events (run_id, event_time, event_name, event_hash, event_json, source) VALUES (?, ?, ?, ?, ?, ?)')
+                    .run(event.runId, event.time, event.event, hashDocumentContent(eventJson), eventJson, 'legacy');
+            }
+            db.prepare('INSERT OR REPLACE INTO legacy_imports (import_id, run_id, entity_type, content_hash, imported_at, status, issue) VALUES (?, ?, ?, ?, ?, ?, ?)')
+                .run(legacyImportId(runId, 'events'), runId, 'events', contentHash, new Date().toISOString(), 'imported', null);
+        });
+    }
+    catch (error) {
+        await recordLegacyImportFailure(projectRoot, runId, 'events', error);
+        throw new RuntimeStoreError('LEGACY_IMPORT_FAILED', `Cannot import legacy events for ${runId}: ${messageFromError(error)}`, { cause: error });
+    }
+}
+export async function readRuntimeRunEvents(projectRoot, runId) {
+    return withRuntimeStore(projectRoot, ({ db }) => {
+        const rows = db.prepare('SELECT event_json FROM events WHERE run_id = ? ORDER BY event_time ASC, event_id ASC').all(runId);
+        return rows.map((row) => JSON.parse(row.event_json));
+    });
+}
+export async function upsertRuntimeRunState(projectRoot, state, serializedState) {
+    await withRuntimeStore(projectRoot, ({ db }) => {
+        db.prepare(`INSERT INTO runs (run_id, status, phase, current_task, partition, git_branch, task_id, created_at, updated_at, state_json, state_hash) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?) ON CONFLICT(run_id) DO UPDATE SET status=excluded.status, phase=excluded.phase, current_task=excluded.current_task, partition=excluded.partition, git_branch=excluded.git_branch, task_id=excluded.task_id, updated_at=excluded.updated_at, state_json=excluded.state_json, state_hash=excluded.state_hash`)
+            .run(state.runId, state.status, state.phase, state.currentTask, state.partition, state.gitBranch, state.taskId, state.createdAt, state.updatedAt, serializedState, hashDocumentContent(serializedState));
+    });
+}
+export async function readRuntimeRunState(projectRoot, runId) {
+    return withRuntimeStore(projectRoot, ({ db }) => {
+        const row = db.prepare('SELECT state_json FROM runs WHERE run_id = ?').get(runId);
+        return row?.state_json ? JSON.parse(row.state_json) : null;
+    });
+}
+export async function listRuntimeRunStates(projectRoot) {
+    return withRuntimeStore(projectRoot, ({ db }) => {
+        const rows = db.prepare('SELECT state_json FROM runs ORDER BY updated_at DESC, run_id DESC').all();
+        return rows.map((row) => JSON.parse(row.state_json));
+    });
+}
+export async function recordRuntimeActivity(projectRoot, entry) {
+    await withRuntimeStore(projectRoot, ({ db }) => {
+        db.prepare('INSERT OR REPLACE INTO activities (activity_id, run_id, task_id, branch, kind, ref, status, created_at, payload_json) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)')
+            .run(entry.entryId, entry.runId, entry.taskId ?? null, entry.branch ?? null, entry.kind, entry.ref, entry.status ?? null, entry.timestamp, JSON.stringify(entry));
+    });
+}
+export async function readRuntimeActivities(projectRoot, runId) {
+    return withRuntimeStore(projectRoot, ({ db }) => {
+        const rows = db.prepare('SELECT payload_json FROM activities WHERE run_id = ? ORDER BY created_at ASC, activity_id ASC').all(runId);
+        return rows.map((row) => JSON.parse(row.payload_json));
+    });
+}
+export async function recordRuntimeEvidenceAttachment(projectRoot, input) {
+    const now = new Date().toISOString();
+    const payloadJson = JSON.stringify(input.payload ?? { relativePath: input.relativePath, kind: input.kind });
+    await withRuntimeStore(projectRoot, ({ db }) => {
+        db.prepare('INSERT OR REPLACE INTO evidence_attachments (evidence_id, branch_slug, run_id, task_id, kind, relative_path, content_hash, bytes, created_at, payload_json) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)')
+            .run(runtimeScopedId(input.branchSlug, input.runId ?? 'none', input.relativePath, input.contentHash), input.branchSlug, input.runId ?? null, input.taskId ?? null, input.kind, input.relativePath, input.contentHash, input.bytes, now, payloadJson);
+    });
+}
+export async function recordRuntimeProjection(projectRoot, projectionType, scopeKey, payload) {
+    const now = new Date().toISOString();
+    await withRuntimeStore(projectRoot, ({ db }) => {
+        db.prepare('INSERT OR REPLACE INTO projections (projection_id, projection_type, scope_key, generated_at, payload_json) VALUES (?, ?, ?, ?, ?)')
+            .run(runtimeScopedId(projectionType, scopeKey), projectionType, scopeKey, now, JSON.stringify(payload));
+    });
+}
+export function buildRuntimeProjectionEnvelope(input) {
+    return {
+        contract: RUNTIME_PROJECTION_ENVELOPE_CONTRACT_VERSION,
+        projectionType: input.projectionType,
+        scopeKey: input.scopeKey,
+        id: runtimeScopedId(input.projectionType, input.scopeKey, input.inputHash, input.producerVersion),
+        inputHash: input.inputHash,
+        producer: input.producer,
+        producerVersion: input.producerVersion,
+        generatedAt: input.generatedAt ?? new Date().toISOString(),
+        payload: input.payload
+    };
+}
+export async function recordRuntimeProjectionEnvelope(projectRoot, input) {
+    const candidate = buildRuntimeProjectionEnvelope(input);
+    return withRuntimeStore(projectRoot, ({ db }) => {
+        const previous = readRuntimeProjectionRecordFromDb(db, input.projectionType, input.scopeKey);
+        const existingEnvelope = asRuntimeProjectionEnvelope(previous?.payload);
+        const staleness = runtimeProjectionStaleness(existingEnvelope, input);
+        if (existingEnvelope && staleness === 'fresh' && JSON.stringify(existingEnvelope.payload) === JSON.stringify(input.payload)) {
+            return { envelope: existingEnvelope, previous, staleness, status: 'unchanged' };
+        }
+        db.prepare('INSERT OR REPLACE INTO projections (projection_id, projection_type, scope_key, generated_at, payload_json) VALUES (?, ?, ?, ?, ?)')
+            .run(runtimeScopedId(input.projectionType, input.scopeKey), input.projectionType, input.scopeKey, candidate.generatedAt, JSON.stringify(candidate));
+        return { envelope: candidate, previous, staleness, status: previous ? 'updated' : 'created' };
+    });
+}
+export async function readRuntimeProjection(projectRoot, projectionType, scopeKey) {
+    return withRuntimeStore(projectRoot, ({ db }) => readRuntimeProjectionRecordFromDb(db, projectionType, scopeKey));
+}
+export async function readRuntimeProjectionEnvelope(projectRoot, projectionType, scopeKey) {
+    const record = await readRuntimeProjection(projectRoot, projectionType, scopeKey);
+    return asRuntimeProjectionEnvelope(record?.payload);
+}
+export function runtimeProjectionStaleness(envelope, freshness) {
+    if (!envelope) {
+        return 'unknown';
+    }
+    if (envelope.contract !== RUNTIME_PROJECTION_ENVELOPE_CONTRACT_VERSION || envelope.producerVersion !== freshness.producerVersion) {
+        return 'incompatible';
+    }
+    return envelope.inputHash === freshness.inputHash ? 'fresh' : 'stale';
+}
+export async function listRuntimeProjections(projectRoot, projectionTypes) {
+    if (projectionTypes.length === 0) {
+        return [];
+    }
+    const placeholders = projectionTypes.map(() => '?').join(', ');
+    return withRuntimeStore(projectRoot, ({ db }) => {
+        const rows = db.prepare(`SELECT projection_type, scope_key, generated_at, payload_json FROM projections WHERE projection_type IN (${placeholders}) ORDER BY generated_at DESC, projection_type ASC, scope_key ASC`)
+            .all(...projectionTypes);
+        return rows.map(runtimeProjectionRecordFromRow);
+    });
+}
+export async function recordRuntimeTestRun(projectRoot, record) {
+    await withRuntimeStore(projectRoot, ({ db }) => {
+        db.prepare('INSERT OR REPLACE INTO test_runs (test_run_id, run_id, partition, task_id, status, started_at, completed_at, payload_json) VALUES (?, ?, ?, ?, ?, ?, ?, ?)')
+            .run(record.testRunId, record.runId, record.partition, record.taskId, record.status, record.startedAt, record.completedAt, JSON.stringify(record.payload));
+    });
+}
+export async function recordRuntimeTestStep(projectRoot, record) {
+    await withRuntimeStore(projectRoot, ({ db }) => {
+        db.prepare('INSERT OR REPLACE INTO test_steps (test_step_id, test_run_id, run_id, task_id, command, status, exit_code, duration_ms, output_artifact, payload_json) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)')
+            .run(record.stepId, record.testRunId, record.runId, record.taskId, record.command, record.status, record.exitCode, record.durationMs, record.outputArtifact, JSON.stringify(record.payload));
+    });
+}
+export async function listRuntimeTestRuns(projectRoot, runId) {
+    return withRuntimeStore(projectRoot, ({ db }) => {
+        const rows = runId
+            ? db.prepare('SELECT test_run_id, run_id, partition, task_id, status, started_at, completed_at, payload_json FROM test_runs WHERE run_id = ? ORDER BY completed_at DESC').all(runId)
+            : db.prepare('SELECT test_run_id, run_id, partition, task_id, status, started_at, completed_at, payload_json FROM test_runs ORDER BY completed_at DESC').all();
+        return rows.map((row) => ({
+            testRunId: row.test_run_id,
+            runId: row.run_id,
+            partition: row.partition,
+            taskId: row.task_id,
+            status: row.status,
+            startedAt: row.started_at,
+            completedAt: row.completed_at,
+            payload: JSON.parse(row.payload_json)
+        }));
+    });
+}
+export async function recordLegacyImportFailure(projectRoot, runId, entityType, error) {
+    try {
+        await withRuntimeStore(projectRoot, ({ db }) => {
+            db.prepare('INSERT OR REPLACE INTO legacy_imports (import_id, run_id, entity_type, content_hash, imported_at, status, issue) VALUES (?, ?, ?, ?, ?, ?, ?)')
+                .run(legacyImportId(runId, entityType), runId, entityType, 'unavailable', new Date().toISOString(), 'failed', messageFromError(error));
+        });
+    }
+    catch {
+        return;
+    }
+}
+export async function inspectRuntimeStoreEvidence(projectRoot) {
+    try {
+        return await withRuntimeStore(projectRoot, ({ path: storePath, db }) => {
+            const versionRow = db.prepare('PRAGMA user_version').get();
+            const integrityRow = db.prepare('PRAGMA integrity_check').get();
+            const schemaVersion = versionRow?.user_version ?? 0;
+            if (schemaVersion !== RUNTIME_STORE_SCHEMA_VERSION) {
+                return [{ level: 'FAIL', check: 'runtime_store', message: `Runtime store schema version ${schemaVersion} does not match expected ${RUNTIME_STORE_SCHEMA_VERSION}.`, action: 'Run a compatible sdd version or rebuild the runtime store from legacy .sdd/runs.' }];
+            }
+            if (integrityRow?.integrity_check !== 'ok') {
+                return [{ level: 'FAIL', check: 'runtime_store', message: `Runtime store integrity check failed: ${integrityRow?.integrity_check ?? 'unknown'}.`, action: 'Rebuild runtime projections from legacy .sdd/runs after preserving the database for debugging.' }];
+            }
+            const checks = [{ level: 'PASS', check: 'runtime_store', message: `${RUNTIME_STORE_CONTRACT_VERSION} is available at ${storePath} with schema ${schemaVersion}.` }];
+            const scopeLeak = db.prepare('SELECT COUNT(*) AS count FROM evidence_claims c JOIN runs r ON r.run_id = c.run_id WHERE c.partition IS NOT NULL AND r.partition IS NOT NULL AND c.partition <> r.partition').get();
+            checks.push(((scopeLeak?.count ?? 0) > 0)
+                ? { level: 'FAIL', check: 'runtime_partition_scope', message: `Runtime store has ${scopeLeak?.count ?? 0} cross-partition evidence claim(s).`, action: 'Reingest validator artifacts for the correct run partition; mismatched claims cannot satisfy PASS evidence.' }
+                : { level: 'PASS', check: 'runtime_partition_scope', message: 'Runtime evidence claims match their run partition scope.' });
+            const freshness = db.prepare('SELECT (SELECT MAX(updated_at) FROM runs) AS latest_run, (SELECT MAX(generated_at) FROM projections) AS latest_projection').get();
+            checks.push(freshness?.latest_run && freshness?.latest_projection && freshness.latest_projection < freshness.latest_run
+                ? { level: 'PASS', check: 'runtime_projection_freshness', message: `Latest runtime projection ${freshness.latest_projection} is older than latest run update ${freshness.latest_run}; views can be refreshed on demand.` }
+                : { level: 'PASS', check: 'runtime_projection_freshness', message: freshness?.latest_projection ? 'Runtime projections are current with known run updates.' : 'No runtime projections have been materialized yet.' });
+            const legacy = db.prepare("SELECT status, COUNT(*) AS count FROM legacy_imports GROUP BY status").all();
+            const failedLegacy = legacy.find((row) => row.status === 'failed')?.count ?? 0;
+            const importedLegacy = legacy.find((row) => row.status === 'imported')?.count ?? 0;
+            checks.push(failedLegacy > 0
+                ? { level: 'FAIL', check: 'runtime_legacy_import', message: `${failedLegacy} legacy import record(s) failed.`, action: 'Inspect legacy .sdd/runs files and repair malformed state/events/invocation evidence before test or sync-back.' }
+                : importedLegacy > 0
+                    ? { level: 'PASS', check: 'runtime_legacy_import', message: `${importedLegacy} legacy runtime record(s) imported non-destructively; trust debt was preserved, not upgraded.` }
+                    : { level: 'PASS', check: 'runtime_legacy_import', message: 'No legacy runtime import debt detected.' });
+            return checks;
+        });
+    }
+    catch (error) {
+        return [{ level: 'FAIL', check: 'runtime_store', message: `Runtime store unavailable: ${messageFromError(error)}`, action: 'Use a Node runtime with node:sqlite support and writable .sdd/runtime.sqlite.' }];
+    }
+}
+function readRuntimeProjectionRecordFromDb(db, projectionType, scopeKey) {
+    const row = db.prepare('SELECT projection_type, scope_key, generated_at, payload_json FROM projections WHERE projection_type = ? AND scope_key = ?').get(projectionType, scopeKey);
+    return row ? runtimeProjectionRecordFromRow(row) : null;
+}
+function runtimeProjectionRecordFromRow(row) {
+    return {
+        projectionType: row.projection_type,
+        scopeKey: row.scope_key,
+        generatedAt: row.generated_at,
+        payload: JSON.parse(row.payload_json)
+    };
+}
+function asRuntimeProjectionEnvelope(payload) {
+    if (!payload || typeof payload !== 'object') {
+        return null;
+    }
+    const candidate = payload;
+    return candidate.contract === RUNTIME_PROJECTION_ENVELOPE_CONTRACT_VERSION ? candidate : null;
+}
+export function runtimeScopedId(...parts) {
+    return createHash('sha256').update(parts.join('\0'), 'utf8').digest('hex').slice(0, 32);
+}
+export function legacyImportId(runId, entityType) {
+    return runtimeScopedId(runId, entityType);
+}
+function hashDocumentContent(raw) {
+    return createHash('sha256').update(raw.replace(/\r\n/g, '\n'), 'utf8').digest('hex');
+}
+function messageFromError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=runtime-store.js.map

package/node_modules/@sdd-agent-platform/core/dist/storage/runtime-store.js.map

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

package/node_modules/@sdd-agent-platform/core/dist/subagents/contracts.d.ts

@@ -0,0 +1,41 @@
+import type { ModelProducedArtifact, RuntimeRef, RuntimeScope } from '../contracts.js';
+import { SUBAGENT_DEFINITION_CONTRACT_VERSION, SUBAGENT_DISPATCH_CONTRACT_VERSION, SUBAGENT_RESULT_CONTRACT_VERSION } from '../contracts.js';
+export type SubagentDispatchMode = 'foreground' | 'background';
+export type SubagentDispatchStatus = 'queued' | 'running' | 'completed' | 'failed' | 'cancelled' | 'stale';
+export type SubagentResultAuthority = 'non-authoritative' | 'evidence-candidate' | 'diagnostic-only';
+export interface SubagentDefinition {
+    contract: typeof SUBAGENT_DEFINITION_CONTRACT_VERSION;
+    name: string;
+    description: string;
+    promptRef: RuntimeRef;
+    allowedToolRefs: RuntimeRef[];
+    canEditProduction: false;
+    canOwnLifecycle: false;
+    allowedWritePaths: string[];
+    resultAuthority: SubagentResultAuthority;
+}
+export interface SubagentDispatch {
+    contract: typeof SUBAGENT_DISPATCH_CONTRACT_VERSION;
+    id: string;
+    scope: RuntimeScope;
+    workUnitId: string;
+    definitionName: string;
+    mode: SubagentDispatchMode;
+    status: SubagentDispatchStatus;
+    blocking: boolean;
+    requiredBefore: 'handoff' | 'sync-back' | 'ship' | 'never';
+    contextRef: RuntimeRef;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface SubagentResult {
+    contract: typeof SUBAGENT_RESULT_CONTRACT_VERSION;
+    dispatchId: string;
+    status: 'completed' | 'failed' | 'cancelled' | 'stale';
+    authority: SubagentResultAuthority;
+    summary: string;
+    artifactRefs: RuntimeRef[];
+    evidenceRefs: RuntimeRef[];
+    modelArtifacts: ModelProducedArtifact[];
+    completedAt: string;
+}

package/node_modules/@sdd-agent-platform/core/dist/subagents/contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contracts.js.map

package/node_modules/@sdd-agent-platform/core/dist/subagents/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/subagents/contracts.ts"],"names":[],"mappings":""}

package/node_modules/@sdd-agent-platform/core/dist/subagents/runtime.d.ts

@@ -0,0 +1,43 @@
+import type { RuntimeProjectionEnvelope, RuntimeRef, RuntimeScope } from '../contracts.js';
+import { type RuntimeProjectionEnvelopeWriteResult } from '../storage/runtime-store.js';
+import type { SubagentDefinition, SubagentDispatch, SubagentResult } from './contracts.js';
+export declare const SUBAGENT_RUNTIME_PRODUCER_VERSION = "phase8-subagent-runtime-v1";
+export declare const SUBAGENT_DEFINITION_PROJECTION_TYPE = "phase8_subagent_definition";
+export declare const SUBAGENT_DISPATCH_PROJECTION_TYPE = "phase8_subagent_dispatch";
+export declare const SUBAGENT_RESULT_PROJECTION_TYPE = "phase8_subagent_result";
+export type SubagentDispatchDiagnosticStatus = 'missing' | 'fresh' | 'blocked' | 'failed' | 'stale' | 'incompatible';
+export interface SubagentPolicyResult {
+    allowed: boolean;
+    issues: string[];
+}
+export interface SubagentDispatchDiagnostic {
+    status: SubagentDispatchDiagnosticStatus;
+    branch: string;
+    dispatches: number;
+    blockingOpen: number;
+    failed: number;
+    stale: number;
+    completed: number;
+    archived: number;
+    superseded: number;
+    reasons: string[];
+}
+export declare function validateSubagentDefinition(definition: SubagentDefinition): SubagentPolicyResult;
+export declare function validateSubagentWrite(definition: SubagentDefinition, relativePath: string): SubagentPolicyResult;
+export declare function consumeSubagentResult(result: SubagentResult): {
+    authority: SubagentResult['authority'];
+    summary: string;
+    artifactRefs: RuntimeRef[];
+    evidenceRefs: RuntimeRef[];
+    authoritative: false;
+};
+export declare function subagentDispatchBlocksGate(dispatch: SubagentDispatch, result: SubagentResult | null): boolean;
+export declare function subagentDefinitionScopeKey(name: string): string;
+export declare function subagentDispatchScopeKey(scope: RuntimeScope, dispatchId: string): string;
+export declare function subagentResultScopeKey(dispatchId: string): string;
+export declare function recordSubagentDefinitionProjection(projectRoot: string, definition: SubagentDefinition): Promise<RuntimeProjectionEnvelopeWriteResult<SubagentDefinition>>;
+export declare function recordSubagentDispatchProjection(projectRoot: string, dispatch: SubagentDispatch): Promise<RuntimeProjectionEnvelopeWriteResult<SubagentDispatch>>;
+export declare function readSubagentDispatchProjection(projectRoot: string, scope: RuntimeScope, dispatchId: string): Promise<RuntimeProjectionEnvelope<SubagentDispatch> | null>;
+export declare function recordSubagentResultProjection(projectRoot: string, result: SubagentResult): Promise<RuntimeProjectionEnvelopeWriteResult<SubagentResult>>;
+export declare function readSubagentResultProjection(projectRoot: string, dispatchId: string): Promise<RuntimeProjectionEnvelope<SubagentResult> | null>;
+export declare function inspectSubagentDispatches(projectRoot: string, branch: string): Promise<SubagentDispatchDiagnostic>;