sdd-agent-platform 0.3.0 → 0.4.1

package/packages/core/dist/sdd-docs/document-hashes.js

@@ -0,0 +1,189 @@
+import { createHash } from 'node:crypto';
+const TASK_CONTRACT_METADATA_KEYS = [
+    'id',
+    'wave',
+    'depends_on',
+    'acceptance_refs',
+    'plan_refs',
+    'affected_files',
+    'change_surface',
+    'implementation_wave',
+    'validation_batch',
+    'validation_timing',
+    'requires_verify_before_next',
+    'validation',
+    'risk',
+    'required_artifacts',
+    'allowed_agents',
+    'verification_availability',
+    'autonomy',
+    'validation_wave',
+    'review_gate'
+];
+const TASK_CONTRACT_SECTION_TITLES = [
+    'Boundary',
+    'Acceptance',
+    'Definition of Done',
+    'Evidence Expectations'
+];
+const TOP_LEVEL_CONTRACT_SECTION_TITLES = [
+    'Delivery Map',
+    'Wave Plan',
+    'Implementation Waves',
+    'Validation Waves',
+    'Review Gate',
+    'Review Gates',
+    'Review Gate Declarations',
+    'Phase Gate Checkpoint'
+];
+export function hashDocumentContent(raw) {
+    return sha256(raw.replace(/\r\n/g, '\n'));
+}
+export function hashSemanticDocument(raw) {
+    return raw === null ? null : sha256(normalizeSemanticMarkdown(raw));
+}
+export function hashTasksContract(raw) {
+    if (raw === null) {
+        return null;
+    }
+    return sha256(stableJson({
+        tasks: parseTaskContracts(raw),
+        declarations: TOP_LEVEL_CONTRACT_SECTION_TITLES.map((title) => [title, normalizeSectionText(sectionText(raw, title))]).filter(([, value]) => value !== null)
+    }));
+}
+export function documentHashMatches(expected, actual) {
+    return expected.replace(/^sha256:/, '') === actual;
+}
+function parseTaskContracts(raw) {
+    const fencedBlocks = Array.from(raw.matchAll(/^\s*```sdd-task\s*\r?\n([\s\S]*?)\r?^\s*```\s*$/gm));
+    return fencedBlocks.map((blockMatch, index) => {
+        const block = blockMatch[1] ?? '';
+        const blockStart = blockMatch.index ?? 0;
+        const blockEnd = blockStart + blockMatch[0].length;
+        const nextBlockStart = fencedBlocks[index + 1]?.index ?? raw.length;
+        const section = raw.slice(blockEnd, nextTaskStart(raw, blockEnd, nextBlockStart));
+        const metadata = parseSimpleYamlBlock(block);
+        const heading = nearestTaskHeading(raw.slice(0, blockStart));
+        const id = scalarValue(metadata.id) ?? heading?.id ?? null;
+        return {
+            id,
+            title: heading?.title ?? null,
+            metadata: Object.fromEntries(TASK_CONTRACT_METADATA_KEYS.map((key) => [key, normalizedMetadataValue(metadata[key])])),
+            sections: Object.fromEntries(TASK_CONTRACT_SECTION_TITLES.map((title) => [title, normalizeSectionText(sectionText(section, title))]))
+        };
+    }).sort((left, right) => String(left.id ?? '').localeCompare(String(right.id ?? '')));
+}
+function normalizeSemanticMarkdown(raw) {
+    return raw
+        .replace(/\r\n/g, '\n')
+        .split('\n')
+        .filter((line) => !/^\s*(created_at|updated_at|generatedAt|generated_at|run_id):/i.test(line))
+        .map((line) => line.trim())
+        .filter(Boolean)
+        .join('\n');
+}
+function normalizeSectionText(value) {
+    if (!value) {
+        return null;
+    }
+    return value.replace(/\r\n/g, '\n').split('\n').map((line) => line.trim()).filter((line) => line && !/^<!--.*-->$/.test(line)).join('\n');
+}
+function sectionText(raw, title) {
+    const escaped = title.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const sectionPattern = `^\\s*#{2,4}\\s+${escaped}\\s*$([\\s\\S]*?)(?=^\\s*#{2,4}\\s+|$(?![\\s\\S]))`;
+    const match = raw.match(new RegExp(sectionPattern, 'im'));
+    const text = match?.[1]?.trim() ?? '';
+    return text.length > 0 ? text : null;
+}
+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 normalizedMetadataValue(value) {
+    if (Array.isArray(value)) {
+        return [...value].filter(Boolean).sort();
+    }
+    return value && value !== '[]' ? value : null;
+}
+function scalarValue(value) {
+    return typeof value === 'string' && value.length > 0 ? value : null;
+}
+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 nearestTaskHeading(prefix) {
+    const matches = Array.from(prefix.matchAll(/^\s*###\s+(.+)$/gm));
+    const last = matches.at(-1);
+    if (!last) {
+        return null;
+    }
+    const raw = last[1].trim();
+    const parsed = raw.match(/^([^:：\s]+)\s*[:：]\s*(.+)$/);
+    return {
+        raw,
+        id: parsed?.[1]?.trim() ?? null,
+        title: parsed?.[2]?.trim() ?? raw
+    };
+}
+function nextTaskStart(raw, offset, limit = raw.length) {
+    const next = raw.slice(offset, limit).search(/^\s*###\s+/m);
+    return next < 0 ? limit : offset + next;
+}
+function stableJson(value) {
+    if (Array.isArray(value)) {
+        return `[${value.map(stableJson).join(',')}]`;
+    }
+    if (value && typeof value === 'object') {
+        return `{${Object.entries(value).sort(([left], [right]) => left.localeCompare(right)).map(([key, item]) => `${JSON.stringify(key)}:${stableJson(item)}`).join(',')}}`;
+    }
+    return JSON.stringify(value);
+}
+function sha256(value) {
+    return createHash('sha256').update(value, 'utf8').digest('hex');
+}
+//# sourceMappingURL=document-hashes.js.map

package/packages/core/dist/sdd-docs/document-hashes.js.map

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

package/packages/core/dist/sdd-docs/run-binding.d.ts

@@ -0,0 +1,6 @@
+import type { RunDocumentSnapshot, RunState } from '../run-state/model.js';
+import type { ContextResolverContract } from './context.js';
+import type { SddTask, SddTaskModel } from './task-parser.js';
+export declare function bindRunStateToTask(projectRoot: string, state: RunState, context: ContextResolverContract, model: SddTaskModel, task: SddTask | null, taskId: string): Promise<RunState>;
+export declare function bindRunStateToTaskContext(projectRoot: string, state: RunState, context: ContextResolverContract, model: SddTaskModel, task: SddTask | null, taskId: string): Promise<RunState>;
+export declare function documentSnapshotFromModel(model: SddTaskModel): RunDocumentSnapshot;

package/packages/core/dist/sdd-docs/run-binding.js

@@ -0,0 +1,88 @@
+import path from 'node:path';
+import { appendEvent } from '../run-state/events.js';
+import { readRunState, writeRunState } from '../run-state/run-state.js';
+import { getEvidenceDir } from '../runtime-paths.js';
+export async function bindRunStateToTask(projectRoot, state, context, model, task, taskId) {
+    if (state.partition && state.partition !== context.partition) {
+        throw new Error(`Run ${state.runId} belongs to partition ${state.partition}, not ${context.partition}.`);
+    }
+    if (state.taskId && state.taskId !== taskId) {
+        throw new Error(`Run ${state.runId} belongs to task ${state.taskId}, not ${taskId}.`);
+    }
+    if (state.gitBranch && state.gitBranch !== context.rawBranch) {
+        throw new Error(`Run ${state.runId} belongs to Git branch ${state.gitBranch}, not ${context.rawBranch}.`);
+    }
+    const nextState = {
+        ...state,
+        currentTask: taskId,
+        partition: context.partition,
+        gitBranch: context.rawBranch,
+        taskId,
+        affectedFiles: task?.affectedFiles ?? state.affectedFiles,
+        documentSnapshot: documentSnapshotFromModel(model),
+        artifactRoot: path.relative(projectRoot, getEvidenceDir(projectRoot, context.partition))
+    };
+    await writeRunState(projectRoot, nextState);
+    await appendEvent(projectRoot, state.runId, {
+        event: 'run_context_bound',
+        runId: state.runId,
+        summary: `Run bound to ${context.partition}/${taskId}`,
+        data: {
+            partition: context.partition,
+            gitBranch: context.rawBranch,
+            task: taskId,
+            affectedFiles: nextState.affectedFiles,
+            documentSnapshot: nextState.documentSnapshot
+        }
+    });
+    return readRunState(projectRoot, state.runId);
+}
+export async function bindRunStateToTaskContext(projectRoot, state, context, model, task, taskId) {
+    if (!state.taskId || state.taskId === taskId) {
+        return bindRunStateToTask(projectRoot, state, context, model, task, taskId);
+    }
+    if (state.partition && state.partition !== context.partition) {
+        throw new Error(`Run ${state.runId} belongs to partition ${state.partition}, not ${context.partition}.`);
+    }
+    if (state.gitBranch && state.gitBranch !== context.rawBranch) {
+        throw new Error(`Run ${state.runId} belongs to Git branch ${state.gitBranch}, not ${context.rawBranch}.`);
+    }
+    const nextState = {
+        ...state,
+        currentTask: taskId,
+        partition: context.partition,
+        gitBranch: context.rawBranch,
+        affectedFiles: [...new Set([...state.affectedFiles, ...(task?.affectedFiles ?? [])])],
+        documentSnapshot: documentSnapshotFromModel(model),
+        artifactRoot: path.relative(projectRoot, getEvidenceDir(projectRoot, context.partition))
+    };
+    await writeRunState(projectRoot, nextState);
+    await appendEvent(projectRoot, state.runId, {
+        event: 'run_context_bound',
+        runId: state.runId,
+        summary: `Run context updated for ${context.partition}/${taskId}`,
+        data: {
+            partition: context.partition,
+            gitBranch: context.rawBranch,
+            task: taskId,
+            affectedFiles: nextState.affectedFiles,
+            documentSnapshot: nextState.documentSnapshot
+        }
+    });
+    return readRunState(projectRoot, state.runId);
+}
+export function documentSnapshotFromModel(model) {
+    return {
+        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
+    };
+}
+//# sourceMappingURL=run-binding.js.map

package/packages/core/dist/sdd-docs/run-binding.js.map

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

package/packages/core/dist/sdd-docs/task-inspection.d.ts

@@ -0,0 +1,6 @@
+import type { SddTask, SddTaskGap, SddTaskModel } from './task-parser.js';
+export declare function inspectSddTask(model: SddTaskModel, taskId: string): {
+    task: SddTask | null;
+    gaps: SddTaskGap[];
+};
+export declare function taskGap(taskId: string, field: string, message: string, recommendation: string): SddTaskGap;

package/packages/core/dist/sdd-docs/task-inspection.js

@@ -0,0 +1,31 @@
+export function inspectSddTask(model, taskId) {
+    const matchingTasks = model.tasks.filter((candidate) => candidate.id === taskId);
+    if (matchingTasks.length > 1) {
+        return {
+            task: null,
+            gaps: [
+                ...model.gaps.filter((gap) => gap.taskId === taskId),
+                taskGap(taskId, 'id', `Task id ${taskId} is ambiguous; ${matchingTasks.length} tasks share this id: ${matchingTasks.map(taskSourceEvidence).join('; ')}.`, 'Inspect by a unique task id, or rename duplicate task ids before implementation.')
+            ]
+        };
+    }
+    const task = matchingTasks[0] ?? null;
+    return {
+        task,
+        gaps: model.gaps.filter((gap) => gap.taskId === taskId || (task === null && gap.taskId === null))
+    };
+}
+export function taskGap(taskId, field, message, recommendation) {
+    return {
+        type: 'Task Gap',
+        severity: 'blocking',
+        taskId,
+        field,
+        message,
+        recommendation
+    };
+}
+function taskSourceEvidence(task) {
+    return `${task.id} at ${task.source.filePath}:${task.source.lineStart}-${task.source.lineEnd}`;
+}
+//# sourceMappingURL=task-inspection.js.map

package/packages/core/dist/sdd-docs/task-inspection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-inspection.js","sourceRoot":"","sources":["../../src/sdd-docs/task-inspection.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,cAAc,CAAC,KAAmB,EAAE,MAAc;IAChE,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IACjF,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO;YACL,IAAI,EAAE,IAAI;YACV,IAAI,EAAE;gBACJ,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC;gBACpD,OAAO,CACL,MAAM,EACN,IAAI,EACJ,WAAW,MAAM,kBAAkB,aAAa,CAAC,MAAM,yBAAyB,aAAa,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EACnI,kFAAkF,CACnF;aACF;SACF,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IACtC,OAAO;QACL,IAAI;QACJ,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC;KAClG,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,MAAc,EAAE,KAAa,EAAE,OAAe,EAAE,cAAsB;IAC5F,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,UAAU;QACpB,MAAM;QACN,KAAK;QACL,OAAO;QACP,cAAc;KACf,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAoC;IAC9D,OAAO,GAAG,IAAI,CAAC,EAAE,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;AACjG,CAAC"}

package/packages/core/dist/sdd-docs/task-parser.d.ts

@@ -0,0 +1,98 @@
+export type SddTaskStatus = 'pending' | 'in_progress' | 'completed' | 'blocked' | 'deferred' | 'unknown';
+export type SddChangeSurface = 'frontend_only' | 'backend_only' | 'full_stack' | 'docs_only' | 'config_only' | 'unknown';
+export type SddValidationTiming = 'task_end' | 'batch_end' | 'wave_end';
+export type SddGapSeverity = 'blocking' | 'warning';
+export type SddGapType = 'Document Gap' | 'Task Gap' | 'Dependency Gap';
+export interface SddTaskSourceLocation {
+    filePath: string;
+    heading: string | null;
+    lineStart: number;
+    lineEnd: number;
+}
+export interface SddValidationCommand {
+    command: string;
+    acceptanceRefs: string[];
+    raw: string;
+}
+export interface SddTask {
+    id: string;
+    title: string | null;
+    status: SddTaskStatus;
+    wave: number | null;
+    implementationWave: string | null;
+    validationBatch: string | null;
+    validationTiming: SddValidationTiming;
+    requiresVerifyBeforeNext: boolean;
+    changeSurface: SddChangeSurface;
+    dependsOn: string[];
+    affectedFiles: string[];
+    validation: string[];
+    validationCommands: SddValidationCommand[];
+    risk: string[];
+    acceptanceRefs: string[];
+    planRefs: string[];
+    fileOwnership: string[];
+    agentFit: string[];
+    verificationAvailability: string[];
+    autonomy: string | null;
+    allowedAgents: string[];
+    requiredArtifacts: string[];
+    gapState: string | null;
+    boundary: string | null;
+    acceptance: string[];
+    implementationNotes: string | null;
+    rawMetadata: Record<string, string | string[]>;
+    source: SddTaskSourceLocation;
+}
+export interface SddTaskGap {
+    type: SddGapType;
+    severity: SddGapSeverity;
+    taskId: string | null;
+    field: string;
+    message: string;
+    recommendation: string;
+}
+export interface SddTaskModel {
+    branch: string;
+    specPath: string;
+    planPath: string;
+    tasksPath: string;
+    verifyPath: string;
+    documents: {
+        specExists: boolean;
+        planExists: boolean;
+        tasksExists: boolean;
+        verifyExists: boolean;
+        specHash?: string | null;
+        planHash?: string | null;
+        tasksHash?: string | null;
+        verifyHash?: string | null;
+        specDocHash?: string | null;
+        planDocHash?: string | null;
+        tasksDocHash?: string | null;
+        verifyDocHash?: string | null;
+        specContractHash?: string | null;
+        planContractHash?: string | null;
+        tasksContractHash?: string | null;
+        verifyContractHash?: string | null;
+        planBasedOnSpecHash?: string | null;
+        tasksBasedOnPlanHash?: string | null;
+        verifyBasedOnTasksHash?: string | null;
+        planBasedOnSpecContractHash?: string | null;
+        tasksBasedOnPlanContractHash?: string | null;
+        verifyBasedOnTasksContractHash?: string | null;
+        planStale?: boolean;
+        tasksStale?: boolean;
+        verifyStale?: boolean;
+    };
+    tasks: SddTask[];
+    gaps: SddTaskGap[];
+}
+export declare function parseSddBranch(projectRoot: string, branch?: string): Promise<SddTaskModel>;
+export declare function parseSddTasksMarkdown(raw: string, options?: {
+    branch?: string;
+    tasksPath?: string;
+    validateDependencies?: boolean;
+}): Pick<SddTaskModel, 'tasks' | 'gaps'>;
+export declare function isFrontendOnlyTask(task: SddTask): boolean;
+export declare function isBackendBuildValidationCommand(command: string): boolean;