sdd-agent-platform 0.3.0 → 0.4.1

package/packages/core/dist/run-state/run-index.js

@@ -0,0 +1,238 @@
+import { createHash } from 'node:crypto';
+import { readFile, writeFile } from 'node:fs/promises';
+import { LOCAL_RUN_INDEX_CONTRACT_VERSION } from '../contracts.js';
+import { getLocalRunIndexPath } from '../runtime-paths.js';
+import { exists } from '../storage/json-io.js';
+import { recordRuntimeProjection } from '../storage/runtime-store.js';
+import { readRunEvents } from './events.js';
+import { readAllRunStates, summarizeRunState } from './run-state.js';
+export async function rebuildLocalRunIndex(projectRoot) {
+    const index = await buildLocalRunIndexSnapshot(projectRoot);
+    await writeFile(getLocalRunIndexPath(projectRoot), `${JSON.stringify(index, null, 2)}\n`, 'utf8');
+    await recordRuntimeProjection(projectRoot, 'local_run_index', 'all', index);
+    return index;
+}
+export async function readLocalRunIndex(projectRoot) {
+    const raw = await readFile(getLocalRunIndexPath(projectRoot), 'utf8');
+    return normalizeLocalRunIndex(JSON.parse(raw));
+}
+export async function queryLocalRunIndex(projectRoot, query = {}) {
+    const index = await readLocalRunIndex(projectRoot);
+    const runIds = new Set(index.runs
+        .filter((run) => !query.runId || run.runId === query.runId)
+        .filter((run) => !query.status || run.status === query.status)
+        .filter((run) => !query.taskId || run.taskIds.includes(query.taskId))
+        .filter((run) => !query.artifact || index.artifacts.some((artifact) => artifact.runId === run.runId && artifact.path === query.artifact))
+        .map((run) => run.runId));
+    const result = {
+        ...index,
+        runs: index.runs.filter((run) => runIds.has(run.runId)),
+        tasks: index.tasks.filter((task) => runIds.has(task.runId) && (!query.taskId || task.taskId === query.taskId) && (!query.partition || task.partition === query.partition)),
+        delegations: index.delegations.filter((delegation) => runIds.has(delegation.runId) && (!query.taskId || delegation.taskId === query.taskId)),
+        artifacts: index.artifacts.filter((artifact) => runIds.has(artifact.runId) && (!query.taskId || artifact.task === query.taskId) && (!query.artifact || artifact.path === query.artifact)),
+        waves: index.waves.filter((wave) => runIds.has(wave.runId)),
+        latestByPartitionTask: index.latestByPartitionTask.filter((entry) => runIds.has(entry.runId) && (!query.partition || entry.partition === query.partition) && (!query.taskId || entry.taskId === query.taskId)),
+        activeByAffectedFile: index.activeByAffectedFile.filter((entry) => runIds.has(entry.runId) && (!query.partition || entry.partition === query.partition) && (!query.taskId || entry.taskId === query.taskId))
+    };
+    await recordRuntimeProjection(projectRoot, 'local_run_index_query', hashDocumentContent(JSON.stringify(query)), result);
+    return result;
+}
+export async function inspectLocalRunIndex(projectRoot) {
+    const indexPath = getLocalRunIndexPath(projectRoot);
+    if (!await exists(indexPath)) {
+        return {
+            valid: false,
+            exists: false,
+            indexPath,
+            index: null,
+            issues: [contractIssue('run_index', 'Local run index projection is missing.', 'Run sdd run index rebuild to recreate the derived index from runtime.sqlite.')]
+        };
+    }
+    try {
+        const index = await readLocalRunIndex(projectRoot);
+        const rebuilt = await buildLocalRunIndexSnapshot(projectRoot);
+        const issues = [];
+        if (index.contract !== LOCAL_RUN_INDEX_CONTRACT_VERSION) {
+            issues.push(contractIssue('contract', `Local run index contract is ${index.contract}.`, 'Run sdd run index rebuild to refresh the index contract.'));
+        }
+        if (JSON.stringify(index.runs) !== JSON.stringify(rebuilt.runs)) {
+            issues.push(contractIssue('runs', 'Local run index run summaries differ from runtime.sqlite state.', 'Run sdd run index rebuild.'));
+        }
+        if (JSON.stringify(index.tasks) !== JSON.stringify(rebuilt.tasks)) {
+            issues.push(contractIssue('tasks', 'Local run index task entries differ from runtime.sqlite state.', 'Run sdd run index rebuild.'));
+        }
+        if (JSON.stringify(index.delegations) !== JSON.stringify(rebuilt.delegations)) {
+            issues.push(contractIssue('delegations', 'Local run index delegation entries differ from runtime.sqlite state.', 'Run sdd run index rebuild.'));
+        }
+        if (JSON.stringify(index.artifacts) !== JSON.stringify(rebuilt.artifacts)) {
+            issues.push(contractIssue('artifacts', 'Local run index artifact entries differ from runtime.sqlite state.', 'Run sdd run index rebuild.'));
+        }
+        if (JSON.stringify(index.waves) !== JSON.stringify(rebuilt.waves)) {
+            issues.push(contractIssue('waves', 'Local run index wave summaries differ from runtime.sqlite events.', 'Run sdd run index rebuild.'));
+        }
+        if (JSON.stringify(index.latestByPartitionTask) !== JSON.stringify(rebuilt.latestByPartitionTask)) {
+            issues.push(contractIssue('latestByPartitionTask', 'Local run index partition/task latest view differs from runtime.sqlite state.', 'Run sdd run index rebuild.'));
+        }
+        if (JSON.stringify(index.activeByAffectedFile) !== JSON.stringify(rebuilt.activeByAffectedFile)) {
+            issues.push(contractIssue('activeByAffectedFile', 'Local run index affected-file active view differs from runtime.sqlite state.', 'Run sdd run index rebuild.'));
+        }
+        return {
+            valid: issues.length === 0,
+            exists: true,
+            indexPath,
+            index,
+            issues
+        };
+    }
+    catch (error) {
+        return {
+            valid: false,
+            exists: true,
+            indexPath,
+            index: null,
+            issues: [contractIssue('run_index', `Cannot read local run index: ${messageFromError(error)}`, 'Run sdd run index rebuild to recreate the derived index.')]
+        };
+    }
+}
+async function buildLocalRunIndexSnapshot(projectRoot) {
+    const states = await readAllRunStates(projectRoot);
+    const tasks = [];
+    const artifacts = [];
+    const delegations = [];
+    const waves = [];
+    const latestByPartitionTask = new Map();
+    const activeByAffectedFile = [];
+    for (const state of states) {
+        for (const [taskId, taskState] of Object.entries(state.tasks)) {
+            tasks.push({
+                taskId,
+                partition: state.partition,
+                gitBranch: state.gitBranch,
+                affectedFiles: state.affectedFiles,
+                status: runtimeTaskStatus(taskState),
+                runId: state.runId,
+                runStatus: state.status,
+                updatedAt: state.updatedAt
+            });
+        }
+        if (state.partition && state.taskId && state.status !== 'archived') {
+            const entry = {
+                partition: state.partition,
+                gitBranch: state.gitBranch,
+                taskId: state.taskId,
+                runId: state.runId,
+                runStatus: state.status,
+                validationStatus: state.validation.status,
+                syncBackStatus: state.syncBack.status,
+                affectedFiles: state.affectedFiles,
+                updatedAt: state.updatedAt
+            };
+            const key = partitionTaskKey(state.partition, state.taskId);
+            const existing = latestByPartitionTask.get(key);
+            if (!existing || Date.parse(entry.updatedAt) > Date.parse(existing.updatedAt) || (entry.updatedAt === existing.updatedAt && entry.runId.localeCompare(existing.runId) > 0)) {
+                latestByPartitionTask.set(key, entry);
+            }
+            if (isActiveRunForAffectedFile(state)) {
+                for (const file of state.affectedFiles) {
+                    activeByAffectedFile.push({
+                        file,
+                        partition: state.partition,
+                        gitBranch: state.gitBranch,
+                        taskId: state.taskId,
+                        runId: state.runId,
+                        runStatus: state.status,
+                        syncBackStatus: state.syncBack.status,
+                        updatedAt: state.updatedAt
+                    });
+                }
+            }
+        }
+        for (const artifact of state.artifacts) {
+            artifacts.push({
+                ...artifact,
+                runId: state.runId
+            });
+        }
+        delegations.push(...Object.values(state.delegations).map((delegation) => delegationQueueItemFromRunState(state, delegation)));
+        const waveEvents = (await readRunEvents(projectRoot, state.runId)).filter((event) => event.event.startsWith('wave_executor_'));
+        if (waveEvents.length > 0) {
+            waves.push({
+                runId: state.runId,
+                eventCount: waveEvents.length,
+                lastEvent: waveEvents[waveEvents.length - 1]?.event ?? null
+            });
+        }
+    }
+    return {
+        contract: LOCAL_RUN_INDEX_CONTRACT_VERSION,
+        generatedAt: new Date().toISOString(),
+        runs: states.map((state) => summarizeRunState(state)).sort((left, right) => Date.parse(right.updatedAt) - Date.parse(left.updatedAt)),
+        tasks: tasks.sort((left, right) => (left.partition ?? '').localeCompare(right.partition ?? '') || left.taskId.localeCompare(right.taskId) || left.runId.localeCompare(right.runId)),
+        delegations: delegations.sort((left, right) => left.id.localeCompare(right.id)),
+        artifacts: artifacts.sort((left, right) => left.path.localeCompare(right.path) || left.runId.localeCompare(right.runId)),
+        waves: waves.sort((left, right) => left.runId.localeCompare(right.runId)),
+        latestByPartitionTask: Array.from(latestByPartitionTask.values()).sort((left, right) => left.partition.localeCompare(right.partition) || left.taskId.localeCompare(right.taskId)),
+        activeByAffectedFile: activeByAffectedFile.sort((left, right) => left.file.localeCompare(right.file) || left.partition.localeCompare(right.partition) || left.taskId.localeCompare(right.taskId) || left.runId.localeCompare(right.runId))
+    };
+}
+function normalizeLocalRunIndex(index) {
+    return {
+        contract: index.contract ?? LOCAL_RUN_INDEX_CONTRACT_VERSION,
+        generatedAt: index.generatedAt ?? new Date().toISOString(),
+        runs: index.runs ?? [],
+        tasks: index.tasks ?? [],
+        delegations: index.delegations ?? [],
+        artifacts: index.artifacts ?? [],
+        waves: index.waves ?? [],
+        latestByPartitionTask: index.latestByPartitionTask ?? [],
+        activeByAffectedFile: index.activeByAffectedFile ?? []
+    };
+}
+function delegationQueueItemFromRunState(state, delegation) {
+    return {
+        id: `${state.runId}:${delegation.delegationId}`,
+        runId: state.runId,
+        delegationId: delegation.delegationId,
+        taskId: delegation.task,
+        agent: delegation.agent,
+        requestedCapabilityId: 'sdd-cli',
+        dedupeKey: `${state.runId}:${delegation.task}:${delegation.agent}`,
+        status: delegation.status,
+        statusSource: 'run_state_delegation',
+        runMode: delegation.runMode,
+        expectedArtifact: delegation.expectedArtifact,
+        requiredEvidence: [delegation.expectedArtifact, state.eventLogPath],
+        createdAt: delegation.startedAt,
+        updatedAt: delegation.terminalEventAt ?? delegation.lastHeartbeatAt ?? state.updatedAt
+    };
+}
+function runtimeTaskStatus(value) {
+    if (!isRecord(value)) {
+        return null;
+    }
+    const status = value.status;
+    const verifyStatus = value.verifyStatus;
+    if (typeof verifyStatus === 'string') {
+        return verifyStatus;
+    }
+    return typeof status === 'string' ? status : null;
+}
+function partitionTaskKey(partition, taskId) {
+    return `${partition}::${taskId}`;
+}
+function isActiveRunForAffectedFile(state) {
+    return state.status !== 'archived' && state.syncBack.status !== 'applied' && state.affectedFiles.length > 0;
+}
+function contractIssue(field, message, recommendation) {
+    return { field, message, recommendation };
+}
+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);
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=run-index.js.map

package/packages/core/dist/run-state/run-index.js.map

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

package/packages/core/dist/run-state/run-state.d.ts

@@ -0,0 +1,20 @@
+import type { RunDocumentSnapshot, RunState, RunStateLifecycleDecisionRecord, RunSummary } from './model.js';
+export declare function readRunState(projectRoot: string, runId: string): Promise<RunState>;
+export declare function writeRunState(projectRoot: string, state: RunState): Promise<void>;
+export declare function archiveRun(projectRoot: string, runId: string, options?: {
+    reason?: string;
+}): Promise<RunState>;
+export interface CreateRunOptions {
+    runId?: string;
+    branch?: string;
+    taskId?: string;
+    lifecycleDecision?: RunStateLifecycleDecisionRecord;
+}
+export declare function createRun(projectRoot: string, options?: CreateRunOptions): Promise<RunState>;
+export declare function createUniqueRunId(projectRoot: string): Promise<string>;
+export declare function listRuns(projectRoot: string): Promise<RunSummary[]>;
+export declare function readAllRunStates(projectRoot: string): Promise<RunState[]>;
+export declare function summarizeRunState(state: RunState): RunSummary;
+export declare function normalizeRunState(state: Partial<RunState>): RunState;
+export declare function normalizeRunDocumentSnapshot(snapshot: unknown): RunDocumentSnapshot;
+export declare function emptyRunDocumentSnapshot(): RunDocumentSnapshot;

package/packages/core/dist/run-state/run-state.js

@@ -0,0 +1,366 @@
+import { createHash } from 'node:crypto';
+import { mkdir, readdir, readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { getEvidenceDir, getLegacyRunDir, getProjectConfigPath, getRunsDir } from '../runtime-paths.js';
+import { exists } from '../storage/json-io.js';
+import { RuntimeStoreError, legacyImportId, listRuntimeRunStates, readRuntimeRunState, recordLegacyImportFailure, runtimeScopedId, upsertRuntimeRunState, withRuntimeStore } from '../storage/runtime-store.js';
+import { appendEvent } from './events.js';
+import { LIFECYCLE_DECISION_CONTRACT, LIFECYCLE_DECISION_VERSION, RUN_STATE_CONTRACT, RUNTIME_VERSION } from '../contracts.js';
+import { parseProjectConfig } from '../config/project-config.js';
+import { branchToSafePartition } from '../path-safety.js';
+import { resolveSddContext } from '../sdd-docs/context.js';
+import { parseSddBranch } from '../sdd-docs/task-parser.js';
+import { inspectSddTask } from '../sdd-docs/task-inspection.js';
+export async function readRunState(projectRoot, runId) {
+    const storedState = await readRuntimeRunState(projectRoot, runId);
+    if (storedState) {
+        return normalizeRunState(storedState);
+    }
+    const statePath = path.join(getLegacyRunDir(projectRoot, runId), 'state.json');
+    const legacyState = await importLegacyRunStateIfNeeded(projectRoot, runId, statePath);
+    if (legacyState) {
+        return legacyState;
+    }
+    throw new Error(`Run state not found for ${runId}.`);
+}
+export async function writeRunState(projectRoot, state) {
+    const nextState = normalizeRunState({
+        ...state,
+        updatedAt: new Date().toISOString()
+    });
+    const serializedState = `${JSON.stringify(nextState, null, 2)}\n`;
+    await upsertRuntimeRunState(projectRoot, nextState, serializedState);
+}
+export async function archiveRun(projectRoot, runId, options = {}) {
+    const state = await readRunState(projectRoot, runId);
+    const terminalEventAt = new Date().toISOString();
+    const delegations = Object.fromEntries(Object.entries(state.delegations).map(([delegationId, delegation]) => [
+        delegationId,
+        delegation.status === 'RUNNING'
+            ? { ...delegation, status: 'CANCELLED', terminalEventAt }
+            : delegation
+    ]));
+    for (const delegation of Object.values(delegations)) {
+        if (delegation.status === 'CANCELLED' && state.delegations[delegation.delegationId]?.status === 'RUNNING') {
+            await appendEvent(projectRoot, runId, {
+                event: 'delegation_cancelled',
+                runId,
+                summary: `${delegation.delegationId} cancelled because run was archived.`,
+                data: { delegationId: delegation.delegationId, reason: options.reason ?? null }
+            });
+        }
+    }
+    await writeRunState(projectRoot, {
+        ...state,
+        status: 'archived',
+        delegations
+    });
+    await appendEvent(projectRoot, runId, {
+        event: 'run_archived',
+        runId,
+        summary: options.reason ? `Run archived: ${options.reason}` : 'Run archived.',
+        data: { reason: options.reason ?? null }
+    });
+    return readRunState(projectRoot, runId);
+}
+export async function createRun(projectRoot, options = {}) {
+    await validateProjectConfig(projectRoot);
+    if (Boolean(options.branch) !== Boolean(options.taskId)) {
+        throw new Error('Scoped run creation requires both --branch <branch> and --task <task_id>.');
+    }
+    const scope = options.branch && options.taskId ? await resolveCreateRunScope(projectRoot, options.branch, options.taskId) : null;
+    await mkdir(getRunsDir(projectRoot), { recursive: true });
+    const runId = options.runId ?? await createUniqueRunId(projectRoot);
+    const now = new Date().toISOString();
+    const state = {
+        contract: RUN_STATE_CONTRACT,
+        runtimeVersion: RUNTIME_VERSION,
+        runId,
+        status: 'created',
+        phase: null,
+        currentTask: scope?.taskId ?? null,
+        partition: scope?.partition ?? null,
+        gitBranch: scope?.rawBranch ?? null,
+        taskId: scope?.taskId ?? null,
+        affectedFiles: scope?.affectedFiles ?? [],
+        documentSnapshot: scope?.documentSnapshot ?? emptyRunDocumentSnapshot(),
+        createdAt: now,
+        updatedAt: now,
+        projectRoot: path.resolve(projectRoot),
+        projectConfigPath: path.relative(projectRoot, getProjectConfigPath(projectRoot)),
+        eventLogPath: getRuntimeStoreEventRef(),
+        artifactRoot: path.relative(projectRoot, getEvidenceDir(projectRoot, stateEvidenceBranchSlug(scope?.partition ?? null))),
+        lifecycleDecision: options.lifecycleDecision ?? emptyRunLifecycleDecisionRecord(),
+        tasks: {},
+        agents: {},
+        delegations: {},
+        artifacts: [],
+        artifactIngestions: {},
+        worktrees: {},
+        validation: {
+            status: 'not_run',
+            commands: [],
+            evidence: []
+        },
+        syncBack: {
+            mode: 'proposal',
+            proposalPath: null,
+            status: 'not_created'
+        }
+    };
+    await writeRunState(projectRoot, state);
+    await appendEvent(projectRoot, runId, {
+        event: 'run_started',
+        runId,
+        summary: scope ? `Scoped run created for ${scope.partition}/${scope.taskId}.` : 'Run created by Phase 7.2 SQLite-first runtime storage',
+        data: {
+            runtimeVersion: RUNTIME_VERSION,
+            stateRef: '.sdd/runtime.sqlite:runs',
+            partition: scope?.partition ?? null,
+            gitBranch: scope?.rawBranch ?? null,
+            taskId: scope?.taskId ?? null
+        }
+    });
+    if (state.lifecycleDecision) {
+        await appendEvent(projectRoot, runId, {
+            event: 'lifecycle_decision_recorded',
+            runId,
+            summary: 'Lifecycle decision placeholder recorded for Phase 1.7 command gate',
+            data: {
+                contract: LIFECYCLE_DECISION_CONTRACT,
+                modelVersion: state.lifecycleDecision.model_version,
+                profile: state.lifecycleDecision.decision.profile,
+                confidence: state.lifecycleDecision.decision.confidence
+            }
+        });
+    }
+    return state;
+}
+export async function createUniqueRunId(projectRoot) {
+    const base = formatDateForRunId(new Date());
+    for (let sequence = 1; sequence <= 999; sequence += 1) {
+        const runId = `${base}-${String(sequence).padStart(3, '0')}`;
+        const storedState = await readRuntimeRunState(projectRoot, runId);
+        if (!storedState && !await exists(getLegacyRunDir(projectRoot, runId))) {
+            return runId;
+        }
+    }
+    throw new Error(`Cannot allocate run id for ${base}; sequence exhausted.`);
+}
+export async function listRuns(projectRoot) {
+    const states = await listRuntimeRunStates(projectRoot);
+    if (states.length > 0) {
+        return states.map((state) => summarizeRunState(normalizeRunState(state)));
+    }
+    return listLegacyRunSummaries(projectRoot);
+}
+export async function readAllRunStates(projectRoot) {
+    const states = await listRuntimeRunStates(projectRoot);
+    if (states.length > 0) {
+        return states.map((state) => normalizeRunState(state));
+    }
+    return readAllLegacyRunStates(projectRoot);
+}
+async function listLegacyRunSummaries(projectRoot) {
+    const states = await readAllLegacyRunStates(projectRoot);
+    return states.map((state) => summarizeRunState(state)).sort((left, right) => Date.parse(right.updatedAt) - Date.parse(left.updatedAt));
+}
+async function readAllLegacyRunStates(projectRoot) {
+    const runsDir = getRunsDir(projectRoot);
+    if (!await exists(runsDir)) {
+        return [];
+    }
+    const entries = await readdir(runsDir, { withFileTypes: true });
+    const states = [];
+    for (const entry of entries.filter((candidate) => candidate.isDirectory())) {
+        try {
+            states.push(await readRunState(projectRoot, entry.name));
+        }
+        catch {
+            continue;
+        }
+    }
+    return states;
+}
+export function summarizeRunState(state) {
+    return {
+        runId: state.runId,
+        status: state.status,
+        phase: state.phase,
+        currentTask: state.currentTask,
+        partition: state.partition,
+        gitBranch: state.gitBranch,
+        taskId: state.taskId,
+        affectedFiles: state.affectedFiles,
+        documentSnapshot: state.documentSnapshot,
+        createdAt: state.createdAt,
+        updatedAt: state.updatedAt,
+        validationStatus: state.validation.status,
+        syncBackStatus: state.syncBack.status,
+        taskIds: Object.keys(state.tasks).sort(),
+        artifactCount: state.artifacts.length
+    };
+}
+export function normalizeRunState(state) {
+    return {
+        ...state,
+        partition: typeof state.partition === 'string' ? state.partition : null,
+        gitBranch: typeof state.gitBranch === 'string' ? state.gitBranch : null,
+        taskId: typeof state.taskId === 'string' ? state.taskId : state.currentTask ?? null,
+        affectedFiles: Array.isArray(state.affectedFiles) ? state.affectedFiles.filter((file) => typeof file === 'string') : [],
+        documentSnapshot: normalizeRunDocumentSnapshot(state.documentSnapshot),
+        artifactIngestions: state.artifactIngestions ?? {},
+        worktrees: state.worktrees ?? {}
+    };
+}
+export function normalizeRunDocumentSnapshot(snapshot) {
+    if (!isRecord(snapshot)) {
+        return emptyRunDocumentSnapshot();
+    }
+    return {
+        specHash: stringOrNull(snapshot.specHash),
+        planHash: stringOrNull(snapshot.planHash),
+        tasksHash: stringOrNull(snapshot.tasksHash),
+        specContractHash: stringOrNull(snapshot.specContractHash),
+        planContractHash: stringOrNull(snapshot.planContractHash),
+        tasksContractHash: stringOrNull(snapshot.tasksContractHash),
+        planBasedOnSpecHash: stringOrNull(snapshot.planBasedOnSpecHash),
+        tasksBasedOnPlanHash: stringOrNull(snapshot.tasksBasedOnPlanHash),
+        planBasedOnSpecContractHash: stringOrNull(snapshot.planBasedOnSpecContractHash),
+        tasksBasedOnPlanContractHash: stringOrNull(snapshot.tasksBasedOnPlanContractHash)
+    };
+}
+export function emptyRunDocumentSnapshot() {
+    return {
+        specHash: null,
+        planHash: null,
+        tasksHash: null,
+        specContractHash: null,
+        planContractHash: null,
+        tasksContractHash: null,
+        planBasedOnSpecHash: null,
+        tasksBasedOnPlanHash: null,
+        planBasedOnSpecContractHash: null,
+        tasksBasedOnPlanContractHash: null
+    };
+}
+async function validateProjectConfig(projectRoot) {
+    const configPath = getProjectConfigPath(projectRoot);
+    const raw = await readFile(configPath, 'utf8');
+    parseProjectConfig(raw, configPath);
+}
+function emptyRunLifecycleDecisionRecord() {
+    return {
+        contract: LIFECYCLE_DECISION_CONTRACT,
+        version: LIFECYCLE_DECISION_VERSION,
+        model_version: 'phase1.0-final',
+        input_summary: {},
+        decision: {
+            profile: null,
+            confidence: null,
+            hard_gate_hits: [],
+            required_stages: [],
+            skipped_stages: [],
+            human_checkpoint_required: false
+        },
+        reasons: ['Phase 1.2 records the lifecycle decision contract; Phase 1.7 command gate will populate decision values.'],
+        escalation_triggers: [],
+        downgrade_reason: null,
+        audit: {
+            decided_at: null,
+            decided_by: null,
+            policy_version: 'phase1.0-final',
+            source_artifacts: ['docs/architecture/lifecycle-decision-model.md']
+        }
+    };
+}
+async function resolveCreateRunScope(projectRoot, branch, taskId) {
+    const context = await resolveSddContext(projectRoot, { branch, branchSource: 'cli_option' });
+    const model = await parseSddBranch(projectRoot, context.partition);
+    const task = inspectSddTask(model, taskId).task;
+    if (!task) {
+        throw new Error(`Cannot create scoped run: task ${taskId} was not found in specs/${context.partition}/tasks.md.`);
+    }
+    return {
+        partition: context.partition,
+        rawBranch: context.rawBranch,
+        taskId,
+        affectedFiles: task.affectedFiles,
+        documentSnapshot: {
+            specHash: model.documents.specHash ?? null,
+            planHash: model.documents.planHash ?? null,
+            tasksHash: model.documents.tasksHash ?? null,
+            specContractHash: model.documents.specContractHash ?? null,
+            planContractHash: model.documents.planContractHash ?? null,
+            tasksContractHash: model.documents.tasksContractHash ?? null,
+            planBasedOnSpecHash: model.documents.planBasedOnSpecHash ?? null,
+            tasksBasedOnPlanHash: model.documents.tasksBasedOnPlanHash ?? null,
+            planBasedOnSpecContractHash: model.documents.planBasedOnSpecContractHash ?? null,
+            tasksBasedOnPlanContractHash: model.documents.tasksBasedOnPlanContractHash ?? null
+        }
+    };
+}
+function getRuntimeStoreEventRef() {
+    return '.sdd/runtime.sqlite#events';
+}
+function stateEvidenceBranchSlug(branch) {
+    return branch ? branchToSafePartition(branch) : 'unscoped';
+}
+async function importLegacyRunStateIfNeeded(projectRoot, runId, statePath) {
+    if (!await exists(statePath)) {
+        return null;
+    }
+    try {
+        const raw = await readFile(statePath, 'utf8');
+        const contentHash = hashDocumentContent(raw);
+        return await withRuntimeStore(projectRoot, ({ db }) => {
+            const legacy = db.prepare('SELECT content_hash FROM legacy_imports WHERE run_id = ? AND entity_type = ?').get(runId, 'state');
+            const row = db.prepare('SELECT state_json, state_hash FROM runs WHERE run_id = ?').get(runId);
+            if (legacy?.content_hash === contentHash && row?.state_json && row.state_hash === contentHash) {
+                return normalizeRunState(JSON.parse(row.state_json));
+            }
+            const state = normalizeRunState(JSON.parse(raw));
+            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, created_at=excluded.created_at, 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, raw, contentHash);
+            for (const artifact of state.artifacts) {
+                const payload = JSON.stringify({ ...artifact, status: 'legacy_imported' });
+                db.prepare('INSERT OR REPLACE INTO artifacts (artifact_id, run_id, path, kind, task_id, agent, content_hash, bytes, status, created_at, payload_json) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)')
+                    .run(runtimeScopedId(state.runId, artifact.path, hashDocumentContent(payload)), state.runId, artifact.path, artifactKind(artifact.path), artifact.task, artifact.agent, hashDocumentContent(payload), Buffer.byteLength(payload, 'utf8'), 'legacy_imported', artifact.createdAt, payload);
+            }
+            for (const record of Object.values(state.artifactIngestions ?? {})) {
+                db.prepare('INSERT OR REPLACE INTO artifact_ingestions (ingestion_id, run_id, delegation_id, task_id, agent, artifact_path, status, result_status, ingested_at, payload_json) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)')
+                    .run(runtimeScopedId(record.runId, record.delegationId, record.artifactPath), record.runId, record.delegationId, record.task, record.agent, record.artifactPath, record.status, record.resultStatus, record.ingestedAt, JSON.stringify(record));
+            }
+            db.prepare('INSERT OR REPLACE INTO legacy_imports (import_id, run_id, entity_type, content_hash, imported_at, status, issue) VALUES (?, ?, ?, ?, ?, ?, ?)')
+                .run(legacyImportId(runId, 'state'), runId, 'state', contentHash, new Date().toISOString(), 'imported', null);
+            return state;
+        });
+    }
+    catch (error) {
+        await recordLegacyImportFailure(projectRoot, runId, 'state', error);
+        throw new RuntimeStoreError('LEGACY_IMPORT_FAILED', `Cannot import legacy state for ${runId}: ${messageFromError(error)}`, { cause: error });
+    }
+}
+function artifactKind(runRelativePath) {
+    const extension = path.extname(runRelativePath).replace(/^\./, '');
+    return extension || 'artifact';
+}
+function hashDocumentContent(raw) {
+    return createHash('sha256').update(raw.replace(/\r\n/g, '\n'), 'utf8').digest('hex');
+}
+function stringOrNull(value) {
+    return typeof value === 'string' ? value : null;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function messageFromError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function formatDateForRunId(date) {
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, '0');
+    const day = String(date.getDate()).padStart(2, '0');
+    return `${year}${month}${day}`;
+}
+//# sourceMappingURL=run-state.js.map