sdd-agent-platform 0.3.0 → 0.4.0

package/packages/core/dist/subagents/runtime.js

@@ -0,0 +1,262 @@
+import { createHash } from 'node:crypto';
+import path from 'node:path';
+import { listRuntimeProjections, readRuntimeProjectionEnvelope, recordRuntimeProjectionEnvelope, runtimeProjectionStaleness } from '../storage/runtime-store.js';
+import { readAllRunStates } from '../run-state/run-state.js';
+export const SUBAGENT_RUNTIME_PRODUCER_VERSION = 'phase8-subagent-runtime-v1';
+export const SUBAGENT_DEFINITION_PROJECTION_TYPE = 'phase8_subagent_definition';
+export const SUBAGENT_DISPATCH_PROJECTION_TYPE = 'phase8_subagent_dispatch';
+export const SUBAGENT_RESULT_PROJECTION_TYPE = 'phase8_subagent_result';
+export function validateSubagentDefinition(definition) {
+    const unsafe = definition;
+    const issues = [];
+    if (unsafe.canEditProduction !== false) {
+        issues.push(`Subagent ${definition.name} cannot receive production edit authority.`);
+    }
+    if (unsafe.canOwnLifecycle !== false) {
+        issues.push(`Subagent ${definition.name} cannot own lifecycle control.`);
+    }
+    if (definition.resultAuthority !== 'non-authoritative' && definition.resultAuthority !== 'diagnostic-only' && definition.resultAuthority !== 'evidence-candidate') {
+        issues.push(`Subagent ${definition.name} has unknown result authority ${definition.resultAuthority}.`);
+    }
+    for (const pattern of definition.allowedWritePaths) {
+        const normalizedPattern = normalizeSubagentRelativePath(pattern);
+        if (!normalizedPattern) {
+            issues.push(`Subagent ${definition.name} has invalid allowed write path ${pattern}.`);
+        }
+        else if (unsafeAllowedWritePattern(normalizedPattern)) {
+            issues.push(`Subagent ${definition.name} cannot receive broad production/source write path ${pattern}.`);
+        }
+        else if (!safeAllowedWritePattern(normalizedPattern)) {
+            issues.push(`Subagent ${definition.name} cannot receive unsupported write path ${pattern}.`);
+        }
+    }
+    return { allowed: issues.length === 0, issues };
+}
+export function validateSubagentWrite(definition, relativePath) {
+    const base = validateSubagentDefinition(definition);
+    const normalized = normalizeSubagentRelativePath(relativePath);
+    const allowedByPath = normalized !== null && definition.allowedWritePaths.some((pattern) => matchesWritePattern(normalized, pattern));
+    const issues = [...base.issues];
+    if (!allowedByPath) {
+        issues.push(`Subagent ${definition.name} cannot write ${relativePath}; allowed paths: ${definition.allowedWritePaths.join(', ') || 'none'}.`);
+    }
+    return { allowed: issues.length === 0, issues };
+}
+export function consumeSubagentResult(result) {
+    return {
+        authority: result.authority,
+        summary: result.summary,
+        artifactRefs: result.artifactRefs,
+        evidenceRefs: result.evidenceRefs,
+        authoritative: false
+    };
+}
+export function subagentDispatchBlocksGate(dispatch, result) {
+    if (!dispatch.blocking || dispatch.requiredBefore === 'never') {
+        return false;
+    }
+    if (!result) {
+        return dispatch.status !== 'completed';
+    }
+    return result.status !== 'completed';
+}
+export function subagentDefinitionScopeKey(name) {
+    return name;
+}
+export function subagentDispatchScopeKey(scope, dispatchId) {
+    return [scope.branch, scope.taskId ?? 'all', scope.runId ?? 'none', scope.changeRef ?? 'none', dispatchId].join(':');
+}
+export function subagentResultScopeKey(dispatchId) {
+    return dispatchId;
+}
+export async function recordSubagentDefinitionProjection(projectRoot, definition) {
+    const policy = validateSubagentDefinition(definition);
+    if (!policy.allowed) {
+        throw new Error(`Unsafe subagent definition ${definition.name}: ${policy.issues.join(' ')}`);
+    }
+    return recordRuntimeProjectionEnvelope(projectRoot, {
+        projectionType: SUBAGENT_DEFINITION_PROJECTION_TYPE,
+        scopeKey: subagentDefinitionScopeKey(definition.name),
+        inputHash: stableHash(JSON.stringify(definition)),
+        producer: 'phase8-subagent-runtime',
+        producerVersion: SUBAGENT_RUNTIME_PRODUCER_VERSION,
+        payload: definition
+    });
+}
+export async function recordSubagentDispatchProjection(projectRoot, dispatch) {
+    return recordRuntimeProjectionEnvelope(projectRoot, {
+        projectionType: SUBAGENT_DISPATCH_PROJECTION_TYPE,
+        scopeKey: subagentDispatchScopeKey(dispatch.scope, dispatch.id),
+        inputHash: stableHash(JSON.stringify(dispatch)),
+        producer: 'phase8-subagent-runtime',
+        producerVersion: SUBAGENT_RUNTIME_PRODUCER_VERSION,
+        generatedAt: dispatch.updatedAt,
+        payload: dispatch
+    });
+}
+export async function readSubagentDispatchProjection(projectRoot, scope, dispatchId) {
+    return readRuntimeProjectionEnvelope(projectRoot, SUBAGENT_DISPATCH_PROJECTION_TYPE, subagentDispatchScopeKey(scope, dispatchId));
+}
+export async function recordSubagentResultProjection(projectRoot, result) {
+    return recordRuntimeProjectionEnvelope(projectRoot, {
+        projectionType: SUBAGENT_RESULT_PROJECTION_TYPE,
+        scopeKey: subagentResultScopeKey(result.dispatchId),
+        inputHash: stableHash(JSON.stringify(result)),
+        producer: 'phase8-subagent-runtime',
+        producerVersion: SUBAGENT_RUNTIME_PRODUCER_VERSION,
+        generatedAt: result.completedAt,
+        payload: result
+    });
+}
+export async function readSubagentResultProjection(projectRoot, dispatchId) {
+    return readRuntimeProjectionEnvelope(projectRoot, SUBAGENT_RESULT_PROJECTION_TYPE, subagentResultScopeKey(dispatchId));
+}
+export async function inspectSubagentDispatches(projectRoot, branch) {
+    const projections = await listRuntimeProjections(projectRoot, [SUBAGENT_DISPATCH_PROJECTION_TYPE, SUBAGENT_RESULT_PROJECTION_TYPE]);
+    const resultEnvelopes = projections
+        .filter((projection) => projection.projectionType === SUBAGENT_RESULT_PROJECTION_TYPE)
+        .map((projection) => projection.payload);
+    const resultByDispatch = new Map(resultEnvelopes.map((envelope) => [envelope.payload.dispatchId, envelope.payload]));
+    const archivedRunIds = new Set((await readAllRunStates(projectRoot))
+        .filter((state) => state.status === 'archived')
+        .map((state) => state.runId));
+    const branchDispatchEnvelopes = projections
+        .filter((projection) => projection.projectionType === SUBAGENT_DISPATCH_PROJECTION_TYPE)
+        .map((projection) => projection.payload)
+        .filter((envelope) => envelope?.payload?.scope?.branch === branch);
+    const archived = branchDispatchEnvelopes.filter((envelope) => dispatchBelongsToArchivedRun(envelope.payload, archivedRunIds)).length;
+    const activeDispatches = suppressSupersededDispatches(branchDispatchEnvelopes
+        .filter((envelope) => !dispatchBelongsToArchivedRun(envelope.payload, archivedRunIds)), resultByDispatch);
+    const dispatchEnvelopes = activeDispatches.envelopes;
+    const incompatible = dispatchEnvelopes.some((envelope) => runtimeProjectionStaleness(envelope, { inputHash: stableHash(JSON.stringify(envelope.payload)), producerVersion: SUBAGENT_RUNTIME_PRODUCER_VERSION }) === 'incompatible');
+    const stale = dispatchEnvelopes.filter((envelope) => envelope.payload.status === 'stale').length;
+    const failed = dispatchEnvelopes.filter((envelope) => envelope.payload.status === 'failed' || resultByDispatch.get(envelope.payload.id)?.status === 'failed').length;
+    const blockingOpen = dispatchEnvelopes.filter((envelope) => subagentDispatchBlocksGate(envelope.payload, resultByDispatch.get(envelope.payload.id) ?? null)).length;
+    const completed = dispatchEnvelopes.filter((envelope) => envelope.payload.status === 'completed' && resultByDispatch.get(envelope.payload.id)?.status === 'completed').length;
+    const status = dispatchEnvelopes.length === 0
+        ? 'missing'
+        : incompatible
+            ? 'incompatible'
+            : stale > 0
+                ? 'stale'
+                : failed > 0
+                    ? 'failed'
+                    : blockingOpen > 0
+                        ? 'blocked'
+                        : 'fresh';
+    return {
+        status,
+        branch,
+        dispatches: dispatchEnvelopes.length,
+        blockingOpen,
+        failed,
+        stale,
+        completed,
+        archived,
+        superseded: activeDispatches.superseded,
+        reasons: subagentDispatchReasons(status, blockingOpen, failed, stale, archived, activeDispatches.superseded)
+    };
+}
+function dispatchBelongsToArchivedRun(dispatch, archivedRunIds) {
+    return typeof dispatch.scope.runId === 'string' && archivedRunIds.has(dispatch.scope.runId);
+}
+function suppressSupersededDispatches(dispatchEnvelopes, resultByDispatch) {
+    const successfulByKey = new Map();
+    const active = [];
+    let superseded = 0;
+    for (const envelope of [...dispatchEnvelopes].sort((left, right) => timestamp(right.payload.updatedAt) - timestamp(left.payload.updatedAt))) {
+        const key = dispatchSupersedeKey(envelope.payload);
+        const successful = successfulByKey.get(key);
+        if (successful && timestamp(successful.updatedAt) >= timestamp(envelope.payload.updatedAt)) {
+            superseded += 1;
+            continue;
+        }
+        active.push(envelope);
+        if (dispatchCompleted(envelope.payload, resultByDispatch.get(envelope.payload.id) ?? null)) {
+            successfulByKey.set(key, envelope.payload);
+        }
+    }
+    return { envelopes: active, superseded };
+}
+function dispatchCompleted(dispatch, result) {
+    return dispatch.status === 'completed' && (!result || result.status === 'completed');
+}
+function dispatchSupersedeKey(dispatch) {
+    return [dispatch.scope.branch, dispatch.scope.taskId ?? 'all', dispatch.definitionName, dispatch.requiredBefore, dispatch.contextRef.ref].join(':');
+}
+function timestamp(value) {
+    const parsed = Date.parse(value);
+    return Number.isNaN(parsed) ? 0 : parsed;
+}
+function subagentDispatchReasons(status, blockingOpen, failed, stale, archived, superseded) {
+    const recoveryHint = 'Archive failed exploratory runs with sdd run archive <run_id> --reason <text>, or rerun the subagent worker to supersede the failed dispatch; subagent evidence still cannot approve high-risk execution, sync-back, or ship.';
+    if (status === 'missing') {
+        return archived > 0 || superseded > 0
+            ? [`No active subagent dispatch projections block the main workflow; ignored archived=${archived} superseded=${superseded}. Main workflow still owns lifecycle gates, approvals, sync-back, and ship.`]
+            : ['No subagent dispatch projections recorded; main workflow remains unblocked and still owns lifecycle gates, approvals, sync-back, and ship.'];
+    }
+    if (status === 'blocked') {
+        return [`${blockingOpen} blocking subagent dispatch(es) are incomplete. Complete, rerun, or archive stale exploratory runs before doctor/ship; do not use partial subagent evidence as approval.`];
+    }
+    if (status === 'failed') {
+        return [`${failed} active subagent dispatch(es) failed. ${recoveryHint}`];
+    }
+    if (status === 'stale') {
+        return [`${stale} subagent dispatch(es) are stale. ${recoveryHint}`];
+    }
+    if (status === 'incompatible') {
+        return [`Subagent dispatch projection producer is incompatible with ${SUBAGENT_RUNTIME_PRODUCER_VERSION}; refresh the subagent projection before relying on its diagnostic evidence.`];
+    }
+    return archived > 0 || superseded > 0
+        ? [`Subagent dispatch projections are fresh and non-authoritative; ignored archived=${archived} superseded=${superseded}. Main workflow still owns approvals, sync-back, and ship.`]
+        : ['Subagent dispatch projections are fresh and non-authoritative; main workflow still owns approvals, sync-back, and ship.'];
+}
+function normalizeSubagentRelativePath(relativePath) {
+    const normalized = relativePath.replace(/\\/g, '/');
+    if (normalized.length === 0 || /^[A-Za-z]:/.test(normalized)) {
+        return null;
+    }
+    const resolved = path.posix.normalize(normalized).replace(/^\.\//, '');
+    if (resolved === '' || resolved === '.' || resolved === '..' || resolved.startsWith('../') || path.posix.isAbsolute(resolved)) {
+        return null;
+    }
+    return resolved;
+}
+function unsafeAllowedWritePattern(pattern) {
+    if (safeAllowedWritePattern(pattern)) {
+        return false;
+    }
+    return pattern === 'packages/*/src/**'
+        || pattern === 'packages/**/src/**'
+        || /^packages\/[^/]+\/src\/\*\*$/.test(pattern)
+        || /^packages\/[^/]+\/src\//.test(pattern) && pattern.includes('*');
+}
+function safeAllowedWritePattern(pattern) {
+    return pattern === '**/*.test.ts'
+        || pattern === '**/*.spec.ts'
+        || /(^|\/)\*\*\/\*\.(test|spec)\.ts$/.test(pattern)
+        || /(^|\*)\.(test|spec)\.ts$/.test(pattern)
+        || pattern.startsWith('artifacts/')
+        || pattern.startsWith('.sdd/runs/');
+}
+function matchesWritePattern(relativePath, pattern) {
+    const normalizedPattern = pattern.replace(/\\/g, '/');
+    if (normalizedPattern === relativePath) {
+        return true;
+    }
+    if (normalizedPattern === '**/*.test.ts') {
+        return relativePath.endsWith('.test.ts');
+    }
+    if (normalizedPattern === '**/*.spec.ts') {
+        return relativePath.endsWith('.spec.ts');
+    }
+    if (normalizedPattern.endsWith('/**')) {
+        const prefix = normalizedPattern.slice(0, -3);
+        return relativePath.startsWith(`${prefix}/`);
+    }
+    return false;
+}
+function stableHash(value) {
+    return createHash('sha256').update(value, 'utf8').digest('hex');
+}
+//# sourceMappingURL=runtime.js.map

package/packages/core/dist/subagents/runtime.js.map

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

package/packages/core/dist/subagents.d.ts

@@ -0,0 +1,2 @@
+export * from './subagents/contracts.js';
+export * from './subagents/runtime.js';

package/packages/core/dist/subagents.js

@@ -0,0 +1,3 @@
+export * from './subagents/contracts.js';
+export * from './subagents/runtime.js';
+//# sourceMappingURL=subagents.js.map

package/packages/core/dist/subagents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagents.js","sourceRoot":"","sources":["../src/subagents.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC"}

package/packages/core/dist/sync-back/apply.d.ts

@@ -0,0 +1,17 @@
+import type { SyncBackInspection } from './inspect.js';
+export interface SyncBackApplyResult {
+    runId: string;
+    taskId: string;
+    applied: boolean;
+    tasksPath: string;
+    inspection: SyncBackInspection;
+    message: string;
+    verifyRefreshed: boolean;
+}
+export declare function applySyncBack(projectRoot: string, options: {
+    runId?: string;
+    branch?: string;
+    taskId?: string;
+    approved?: boolean;
+    refreshVerify?: boolean;
+}): Promise<SyncBackApplyResult>;

package/packages/core/dist/sync-back/apply.js

@@ -0,0 +1,221 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { appendEvent } from '../run-state/events.js';
+import { readRunState, writeRunState } from '../run-state/run-state.js';
+import { rebuildLocalRunIndex } from '../run-state/run-index.js';
+import { parseSddBranch } from '../sdd-docs/task-parser.js';
+import { inspectSyncBack } from './inspect.js';
+import { writeVerifyContract } from '../verification/verify-contract.js';
+export async function applySyncBack(projectRoot, options) {
+    let inspection = await inspectSyncBack(projectRoot, options);
+    let verifyRefreshed = false;
+    if (options.refreshVerify === true && inspection.staleVerifyRecoveryCommand) {
+        await writeVerifyContract(projectRoot, { branch: inspection.branch, branchSource: 'cli_option', force: true });
+        verifyRefreshed = true;
+        inspection = await inspectSyncBack(projectRoot, { ...options, runId: inspection.runId, taskId: inspection.taskId ?? options.taskId });
+    }
+    if (!inspection.taskId) {
+        throw new Error('Cannot apply sync-back without a task id.');
+    }
+    if (inspection.status === 'blocked') {
+        throw new Error(`Cannot apply sync-back for ${inspection.runId}: ${inspection.reasons.join(' ')}`);
+    }
+    if (!inspection.markdownTask) {
+        throw new Error(`Cannot apply sync-back for ${inspection.runId}: target task is missing.`);
+    }
+    if (inspection.status === 'applied') {
+        const appliedTaskId = inspection.taskId;
+        const appliedMarkdownTask = inspection.markdownTask;
+        if (options.refreshVerify === true && inspection.staleVerifyRecoveryCommand) {
+            await writeVerifyContract(projectRoot, { branch: inspection.branch, branchSource: 'cli_option', force: true });
+            verifyRefreshed = true;
+            inspection = await inspectSyncBack(projectRoot, { ...options, runId: inspection.runId, taskId: appliedTaskId });
+        }
+        return {
+            runId: inspection.runId,
+            taskId: appliedTaskId,
+            applied: false,
+            tasksPath: appliedMarkdownTask.source.filePath,
+            inspection,
+            message: `Sync-back for ${inspection.runId}/${appliedTaskId} was already applied.`,
+            verifyRefreshed
+        };
+    }
+    if (inspection.applyPolicy.requiresApproval && options.approved !== true) {
+        throw new Error(`Cannot apply sync-back for ${inspection.runId}: ${inspection.applyPolicy.reasons.join(' ')} Re-run with --approved after human confirmation.`);
+    }
+    const state = await readRunState(projectRoot, inspection.runId);
+    const tasksPath = inspection.markdownTask.source.filePath;
+    const rawTasks = await readFile(tasksPath, 'utf8');
+    const note = syncBackImplementationNote(state, inspection);
+    const nextTasks = applySyncBackToTasksMarkdown(rawTasks, inspection.markdownTask, note);
+    await writeFile(tasksPath, nextTasks, 'utf8');
+    const appliedModel = await parseSddBranch(projectRoot, inspection.branch);
+    await writeRunState(projectRoot, {
+        ...state,
+        documentSnapshot: documentSnapshotFromModel(appliedModel),
+        syncBack: {
+            ...state.syncBack,
+            status: 'applied'
+        }
+    });
+    await appendEvent(projectRoot, state.runId, {
+        event: 'sync_back_applied',
+        runId: state.runId,
+        summary: `Sync-back applied for ${inspection.taskId}`,
+        data: {
+            task: inspection.taskId,
+            branch: inspection.branch,
+            tasksPath: path.relative(projectRoot, tasksPath),
+            proposal: inspection.proposalPath
+        }
+    });
+    if (options.refreshVerify === true) {
+        await writeVerifyContract(projectRoot, { branch: inspection.branch, branchSource: 'cli_option', force: true });
+        verifyRefreshed = true;
+    }
+    await rebuildLocalRunIndex(projectRoot);
+    const appliedInspection = await inspectSyncBack(projectRoot, { ...options, runId: inspection.runId, taskId: inspection.taskId });
+    return {
+        runId: state.runId,
+        taskId: inspection.taskId,
+        applied: true,
+        tasksPath,
+        inspection: appliedInspection,
+        message: `Sync-back applied for ${state.runId}/${inspection.taskId}.`,
+        verifyRefreshed
+    };
+}
+function documentSnapshotFromModel(model) {
+    return {
+        specHash: model.documents.specHash ?? null,
+        planHash: model.documents.planHash ?? null,
+        tasksHash: model.documents.tasksHash ?? null,
+        planBasedOnSpecHash: model.documents.planBasedOnSpecHash ?? null,
+        tasksBasedOnPlanHash: model.documents.tasksBasedOnPlanHash ?? null
+    };
+}
+function applySyncBackToTasksMarkdown(raw, task, note) {
+    const range = locateTaskBlockRange(raw, task);
+    const block = raw.slice(range.start, range.end);
+    const nextBlock = setTaskBlockStatus(block, 'completed');
+    const sectionEnd = nextTaskStart(raw, range.end);
+    const section = raw.slice(range.end, sectionEnd);
+    const nextSection = appendSyncBackImplementationNote(section, note);
+    return `${raw.slice(0, range.start)}${nextBlock}${nextSection}${raw.slice(sectionEnd)}`;
+}
+function locateTaskBlockRange(raw, task) {
+    const matches = Array.from(raw.matchAll(/^\s*```sdd-task\s*\r?\n([\s\S]*?)\r?^\s*```\s*$/gm));
+    const matching = matches.filter((match) => {
+        const metadata = parseSimpleYamlBlock(match[1] ?? '');
+        const id = scalarValue(metadata.id);
+        const start = match.index ?? 0;
+        return id === task.id && lineNumberAt(raw, start) === task.source.lineStart;
+    });
+    const fallback = matches.filter((match) => scalarValue(parseSimpleYamlBlock(match[1] ?? '').id) === task.id);
+    const selected = matching.length === 1 ? matching[0] : fallback.length === 1 ? fallback[0] : null;
+    if (!selected || selected.index === undefined) {
+        throw new Error(`Cannot locate a unique sdd-task block for ${task.id}.`);
+    }
+    return {
+        start: selected.index,
+        end: selected.index + selected[0].length
+    };
+}
+function setTaskBlockStatus(block, status) {
+    if (/^\s*status:\s*[^\r\n]*$/m.test(block)) {
+        return block.replace(/^(\s*status:\s*)[^\r\n]*$/m, `$1${status}`);
+    }
+    const eol = block.includes('\r\n') ? '\r\n' : '\n';
+    if (/^\s*id:\s*[^\r\n]*$/m.test(block)) {
+        return block.replace(/^(\s*id:\s*[^\r\n]*)$/m, `$1${eol}status: ${status}`);
+    }
+    throw new Error('Cannot update task status because the sdd-task block has no id line.');
+}
+function appendSyncBackImplementationNote(section, note) {
+    const runMatch = note.match(/run `([^`]+)`/);
+    if (runMatch && section.includes(`run \`${runMatch[1]}\``)) {
+        return section;
+    }
+    const heading = section.match(/^####\s+Implementation Notes\s*$/im);
+    if (!heading || heading.index === undefined) {
+        const separator = section.length === 0 || section.endsWith('\n') ? '' : '\n';
+        return `${section}${separator}\n#### Implementation Notes\n\n${note}\n`;
+    }
+    const contentStart = heading.index + heading[0].length;
+    const remainder = section.slice(contentStart);
+    const nextHeadingOffset = remainder.search(/\n####\s+|\n###\s+/);
+    const insertAt = nextHeadingOffset < 0 ? section.length : contentStart + nextHeadingOffset;
+    const before = section.slice(0, insertAt).trimEnd();
+    const after = section.slice(insertAt);
+    return `${before}\n${note}${after}`;
+}
+function syncBackImplementationNote(state, inspection) {
+    const artifacts = inspection.artifacts.length > 0
+        ? inspection.artifacts.map((artifact) => `\`${artifact}\``).join(', ')
+        : 'none';
+    return `- Sync-back applied from run \`${state.runId}\` (${state.updatedAt}); proposal: \`${inspection.proposalPath ?? 'none'}\`; artifacts: ${artifacts}.`;
+}
+function parseSimpleYamlBlock(raw) {
+    const result = {};
+    const lines = raw.split(/\r?\n/);
+    let currentListKey = null;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#')) {
+            continue;
+        }
+        if (currentListKey && /^-\s+/.test(trimmed)) {
+            const current = result[currentListKey];
+            const items = Array.isArray(current) ? current : [];
+            items.push(unquoteSimpleYamlValue(trimmed.slice(2).trim()));
+            result[currentListKey] = items;
+            continue;
+        }
+        const scalarMatch = trimmed.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
+        if (!scalarMatch) {
+            currentListKey = null;
+            continue;
+        }
+        const key = scalarMatch[1];
+        const value = scalarMatch[2].trim();
+        if (value === '') {
+            result[key] = [];
+            currentListKey = key;
+        }
+        else if (value === '[]') {
+            result[key] = [];
+            currentListKey = null;
+        }
+        else if (value.startsWith('[') && value.endsWith(']')) {
+            result[key] = value.slice(1, -1).split(',').map((item) => unquoteSimpleYamlValue(item.trim())).filter(Boolean);
+            currentListKey = null;
+        }
+        else {
+            result[key] = unquoteSimpleYamlValue(value);
+            currentListKey = null;
+        }
+    }
+    return result;
+}
+function unquoteSimpleYamlValue(value) {
+    if (value.length >= 2) {
+        const first = value[0];
+        const last = value[value.length - 1];
+        if ((first === '"' && last === '"') || (first === "'" && last === "'")) {
+            return value.slice(1, -1);
+        }
+    }
+    return value;
+}
+function scalarValue(value) {
+    return typeof value === 'string' && value.length > 0 ? value : null;
+}
+function lineNumberAt(raw, offset) {
+    return raw.slice(0, offset).split(/\r?\n/).length;
+}
+function nextTaskStart(raw, offset, limit = raw.length) {
+    const next = raw.slice(offset, limit).search(/^\s*###\s+/m);
+    return next < 0 ? limit : offset + next;
+}
+//# sourceMappingURL=apply.js.map

package/packages/core/dist/sync-back/apply.js.map

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

package/packages/core/dist/sync-back/inspect.d.ts

@@ -0,0 +1,91 @@
+import type { RunState } from '../run-state/model.js';
+import { type WorkflowAffectedFileConflict } from '../workflow-state/affected-file-conflicts.js';
+import type { ContextResolverContract } from '../sdd-docs/context.js';
+import type { SddTask, SddTaskGap, SddTaskModel, SddTaskStatus } from '../sdd-docs/task-parser.js';
+import { type VerifyContractIssue, type VerifyContractStatus } from '../verification/verify-contract.js';
+import { type LifecycleRiskConsumerDiagnostic } from '../risk.js';
+export interface ResolvedTaskRun {
+    runId: string;
+    state: RunState;
+    context: ContextResolverContract;
+    model: SddTaskModel;
+    task: SddTask | null;
+    explicitRunId: boolean;
+    staleReasons: string[];
+    affectedFileConflicts: WorkflowAffectedFileConflict[];
+}
+export type SyncBackInspectionStatus = 'ready' | 'blocked' | 'applied';
+export interface SyncBackApplyPolicy {
+    mode: 'direct' | 'confirm';
+    requiresApproval: boolean;
+    reasons: string[];
+}
+export interface SyncBackApprovalCard {
+    contract: 'sdd-sync-back-approval-card-v1';
+    scope: {
+        runId: string;
+        branch: string;
+        taskId: string | null;
+        targetTasksPath: string;
+    };
+    status: SyncBackInspectionStatus;
+    risk: 'low' | 'review' | 'blocked';
+    proposal: {
+        path: string | null;
+        digest: string | null;
+        digestValid: boolean | null;
+    };
+    approval: SyncBackApplyPolicy;
+    blockers: string[];
+    staleReasons: string[];
+    affectedFileConflicts: Array<{
+        file: string;
+        partition: string;
+        taskId: string;
+        runId: string;
+        runStatus: string;
+        syncBackStatus: string;
+    }>;
+    nextAction: string;
+    verifyContractStatus: VerifyContractStatus;
+    verifyContractIssues: VerifyContractIssue[];
+    staleVerifyRecoveryCommand: string | null;
+    lifecycleRisk: LifecycleRiskConsumerDiagnostic;
+}
+export interface SyncBackInspection {
+    runId: string;
+    branch: string;
+    taskId: string | null;
+    status: SyncBackInspectionStatus;
+    reasons: string[];
+    proposalPath: string | null;
+    proposal: string | null;
+    proposalDigest: string | null;
+    proposalDigestValid: boolean | null;
+    runTaskStatus: string | null;
+    markdownTask: SddTask | null;
+    markdownStatus: SddTaskStatus | null;
+    targetTasksPath: string;
+    artifacts: string[];
+    gaps: SddTaskGap[];
+    applyPolicy: SyncBackApplyPolicy;
+    approvalCard: SyncBackApprovalCard;
+    staleReasons: string[];
+    affectedFileConflicts: WorkflowAffectedFileConflict[];
+    verifyContractStatus: VerifyContractStatus;
+    verifyContractIssues: VerifyContractIssue[];
+    staleVerifyRecoveryCommand: string | null;
+    lifecycleRisk: LifecycleRiskConsumerDiagnostic;
+}
+export declare function resolveTaskRun(projectRoot: string, options: {
+    runId?: string;
+    branch?: string;
+    taskId: string;
+}): Promise<ResolvedTaskRun>;
+export declare function inspectSyncBack(projectRoot: string, options: {
+    runId?: string;
+    branch?: string;
+    taskId?: string;
+}): Promise<SyncBackInspection>;
+export declare function runDocumentStaleReasons(projectRoot: string, state: RunState, model: SddTaskModel): Promise<string[]>;
+export declare function affectedFileConflictsForRun(projectRoot: string, state: RunState): Promise<WorkflowAffectedFileConflict[]>;