sdd-agent-platform 0.2.0 → 0.4.0

package/node_modules/@sdd-agent-platform/core/dist/sdd-docs/context.js

@@ -0,0 +1,89 @@
+import { execFile } from 'node:child_process';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { promisify } from 'node:util';
+import { CONTEXT_RESOLVER_CONTRACT_VERSION } from '../contracts.js';
+import { branchToSafePartition, normalizePortablePath, safeBranchOrNull } from '../path-safety.js';
+import { getProjectConfigPath } from '../runtime-paths.js';
+import { parseProjectConfig } from '../config/project-config.js';
+const execFileAsync = promisify(execFile);
+export async function resolveSddContext(projectRoot, options = {}) {
+    const currentGitBranch = await getCurrentGitBranch(projectRoot);
+    const requestedBranch = options.branch?.trim();
+    if (requestedBranch) {
+        return resolvedContext(projectRoot, requestedBranch, options.branchSource ?? 'explicit_option', currentGitBranch);
+    }
+    if (currentGitBranch) {
+        return resolvedContext(projectRoot, currentGitBranch, 'git_branch', currentGitBranch);
+    }
+    const projectConfigBranch = await resolveProjectConfigBranch(projectRoot);
+    if (projectConfigBranch) {
+        return resolvedContext(projectRoot, projectConfigBranch, 'project_config', currentGitBranch);
+    }
+    throw new Error('Cannot resolve SDD branch. Run from a Git branch, pass --branch <branch>, or set sdd.default_branch in .sdd/project.yml. /sdd:spec is the workflow partition entry.');
+}
+export async function resolveRunStateContext(projectRoot, state) {
+    if (!state.partition && !state.gitBranch) {
+        return resolveSddContext(projectRoot);
+    }
+    const currentGitBranch = await getCurrentGitBranch(projectRoot);
+    const partition = state.partition ?? branchToSafePartition(state.gitBranch ?? '');
+    const rawBranch = state.gitBranch ?? state.partition ?? partition;
+    return {
+        contract: CONTEXT_RESOLVER_CONTRACT_VERSION,
+        branch: partition,
+        partition,
+        rawBranch,
+        branchSource: 'explicit_option',
+        currentGitBranch,
+        workingTreeMatched: currentGitBranch ? currentGitBranch === rawBranch : null,
+        specDir: normalizePortablePath(path.relative(projectRoot, path.join(projectRoot, 'specs', partition)))
+    };
+}
+function resolvedContext(projectRoot, rawBranch, branchSource, currentGitBranch) {
+    const partition = branchToSafePartition(rawBranch);
+    return {
+        contract: CONTEXT_RESOLVER_CONTRACT_VERSION,
+        branch: partition,
+        partition,
+        rawBranch,
+        branchSource,
+        currentGitBranch,
+        workingTreeMatched: currentGitBranch ? currentGitBranch === rawBranch : null,
+        specDir: normalizePortablePath(path.relative(projectRoot, path.join(projectRoot, 'specs', partition)))
+    };
+}
+async function resolveProjectConfigBranch(projectRoot) {
+    try {
+        const configPath = getProjectConfigPath(projectRoot);
+        const raw = await readFile(configPath, 'utf8');
+        const config = parseProjectConfig(raw, configPath);
+        const defaultBranch = safeBranchOrNull(config.sdd.default_branch ?? '');
+        if (defaultBranch) {
+            return defaultBranch;
+        }
+        const specDir = normalizePortablePath(config.sdd.spec_dir);
+        if (specDir.includes('<branch>')) {
+            return null;
+        }
+        const parts = specDir.split('/');
+        if (parts.length === 2 && parts[0] === 'specs') {
+            return safeBranchOrNull(parts[1]);
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+async function getCurrentGitBranch(projectRoot) {
+    try {
+        const result = await execFileAsync('git', ['-C', projectRoot, 'branch', '--show-current']);
+        const branch = result.stdout.trim();
+        return branch.length > 0 ? branch : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=context.js.map

package/node_modules/@sdd-agent-platform/core/dist/sdd-docs/context.js.map

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

package/node_modules/@sdd-agent-platform/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/node_modules/@sdd-agent-platform/core/dist/sdd-docs/run-binding.js

@@ -0,0 +1,79 @@
+import { appendEvent } from '../run-state/events.js';
+import { readRunState, writeRunState } from '../run-state/run-state.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)
+    };
+    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)
+    };
+    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,
+        planBasedOnSpecHash: model.documents.planBasedOnSpecHash ?? null,
+        tasksBasedOnPlanHash: model.documents.tasksBasedOnPlanHash ?? null
+    };
+}
+//# sourceMappingURL=run-binding.js.map

package/node_modules/@sdd-agent-platform/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/node_modules/@sdd-agent-platform/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/node_modules/@sdd-agent-platform/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/node_modules/@sdd-agent-platform/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/node_modules/@sdd-agent-platform/core/dist/sdd-docs/task-parser.d.ts

@@ -0,0 +1,78 @@
+export type SddTaskStatus = 'pending' | 'in_progress' | 'completed' | 'blocked' | 'deferred' | 'unknown';
+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;
+    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;
+        planBasedOnSpecHash?: string | null;
+        tasksBasedOnPlanHash?: string | null;
+        verifyBasedOnTasksHash?: 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'>;