sdd-agent-platform 0.3.0 → 0.4.1

package/packages/core/dist/runtime-analysis/model.d.ts

@@ -0,0 +1,175 @@
+import type { RUNTIME_ANALYSIS_CONTRACT_VERSION } from '../contracts.js';
+export type RuntimeAnalysisProfile = 'brief' | 'normal' | 'forensic';
+export interface RuntimeAnalysisGapLike {
+    severity: 'blocking' | 'warning';
+    taskId: string | null;
+    field: string;
+    message: string;
+    recommendation: string;
+}
+export interface RuntimeAnalysisWorkflowLike {
+    workflowStatus: 'active' | 'not_started';
+    recommendedNextCommand: string;
+    gaps: RuntimeAnalysisGapLike[];
+    tasks: {
+        pending: number;
+    };
+    latestRun: {
+        runId: string;
+        currentTask: string | null;
+    } | null;
+    latestRunStaleReasons: string[];
+    latestRunsByTask: Array<{
+        taskId: string;
+        runId: string;
+    }>;
+}
+export interface RuntimeAnalysisDoctorLike {
+    checks: Array<{
+        level: 'PASS' | 'WARN' | 'FAIL';
+        check: string;
+        message: string;
+        action?: string;
+    }>;
+}
+export interface RuntimeAnalysisRunIndexLike {
+    valid: boolean;
+    exists: boolean;
+    indexPath: string;
+    issues: Array<{
+        message: string;
+        recommendation: string;
+    }>;
+}
+export interface RuntimeAnalysisTaskGraphLike {
+    valid: boolean;
+    nodes: Array<{
+        taskId: string;
+        status: string;
+    }>;
+    diagnostics: RuntimeAnalysisGapLike[];
+}
+export interface RuntimeAnalysisWavePlanLike {
+    branch: string;
+    blockedTasks: Array<{
+        taskId: string;
+        reasons: string[];
+    }>;
+    manualGates: Array<{
+        taskId: string;
+        reasons: string[];
+    }>;
+    summary: {
+        tasks: number;
+    };
+}
+export interface RuntimeAnalysisRunInspectionLike {
+    summary: {
+        runId: string;
+        currentTask: string | null;
+        partition: string | null;
+        gitBranch: string | null;
+    };
+    state: {
+        status: string;
+    };
+    validation: {
+        status: string;
+    };
+    syncBack: {
+        status: string;
+    };
+}
+export interface RuntimeAnalysisEvidenceSummaryLike {
+    authoritative: false;
+    usableForPass: false;
+    runId: string;
+    taskId: string | null;
+    passCount: number;
+    blockedCount: number;
+    failCount: number;
+    issueCodes: string[];
+}
+export interface RuntimeAnalysisContextPackageLike {
+    authoritative: false;
+    usableForPass: false;
+    mode: string;
+    taskId: string;
+    warnings: string[];
+    nextCommands: string[];
+}
+export interface RuntimeAnalysisSyncBackLike {
+    runId: string;
+    branch: string;
+    taskId: string | null;
+    status: 'ready' | 'blocked' | 'applied';
+    reasons: string[];
+    targetTasksPath: string;
+    applyPolicy: {
+        requiresApproval: boolean;
+    };
+}
+export type RuntimeAnalysisStatus = 'PASS' | 'WARN' | 'BLOCKED';
+export type RuntimeAnalysisFindingSeverity = 'info' | 'warning' | 'blocking';
+export type RuntimeAnalysisFindingCategory = 'workflow' | 'doctor' | 'run_index' | 'run' | 'evidence' | 'sync_back' | 'task_graph' | 'wave_plan' | 'context';
+export interface RuntimeAnalysisOptions {
+    branch?: string | null;
+    runId?: string;
+    taskId?: string;
+    profile?: RuntimeAnalysisProfile;
+}
+export interface RuntimeAnalysisFinding {
+    severity: RuntimeAnalysisFindingSeverity;
+    category: RuntimeAnalysisFindingCategory;
+    source: string;
+    message: string;
+    action?: string;
+    runId?: string;
+    taskId?: string;
+}
+export interface RuntimeAnalysisInputIssue {
+    source: RuntimeAnalysisFindingCategory;
+    message: string;
+    action?: string;
+    runId?: string;
+    taskId?: string;
+}
+export interface RuntimeAnalysisReportInput {
+    generatedAt: string;
+    profile: RuntimeAnalysisProfile;
+    branch: string;
+    selectedRunId: string | null;
+    selectedTaskId: string | null;
+    status: RuntimeAnalysisWorkflowLike;
+    doctor: RuntimeAnalysisDoctorLike;
+    runIndex: RuntimeAnalysisRunIndexLike;
+    taskGraph: RuntimeAnalysisTaskGraphLike;
+    wavePlan: RuntimeAnalysisWavePlanLike;
+    runInspection: RuntimeAnalysisRunInspectionLike | null;
+    evidenceSummary: RuntimeAnalysisEvidenceSummaryLike | null;
+    contextPackage: RuntimeAnalysisContextPackageLike | null;
+    syncBack: RuntimeAnalysisSyncBackLike | null;
+    inputIssues: RuntimeAnalysisInputIssue[];
+}
+export interface RuntimeAnalysisReport {
+    contract: typeof RUNTIME_ANALYSIS_CONTRACT_VERSION;
+    generatedAt: string;
+    profile: RuntimeAnalysisProfile;
+    authoritative: false;
+    usableForPass: false;
+    status: RuntimeAnalysisStatus;
+    branch: string;
+    selectedRunId: string | null;
+    selectedTaskId: string | null;
+    recommendedNextCommand: string;
+    workflow: RuntimeAnalysisWorkflowLike;
+    doctor: RuntimeAnalysisDoctorLike;
+    runIndex: RuntimeAnalysisRunIndexLike;
+    taskGraph: RuntimeAnalysisTaskGraphLike;
+    wavePlan: RuntimeAnalysisWavePlanLike;
+    runInspection: RuntimeAnalysisRunInspectionLike | null;
+    evidenceSummary: RuntimeAnalysisEvidenceSummaryLike | null;
+    contextPackage: RuntimeAnalysisContextPackageLike | null;
+    syncBack: RuntimeAnalysisSyncBackLike | null;
+    findings: RuntimeAnalysisFinding[];
+}

package/packages/core/dist/runtime-analysis/model.js

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

package/packages/core/dist/runtime-analysis/model.js.map

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

package/packages/core/dist/runtime-analysis.d.ts

@@ -0,0 +1,3 @@
+export * from './runtime-analysis/model.js';
+export * from './runtime-analysis/findings.js';
+export * from './runtime-analysis/build.js';

package/packages/core/dist/runtime-analysis.js

@@ -0,0 +1,4 @@
+export * from './runtime-analysis/model.js';
+export * from './runtime-analysis/findings.js';
+export * from './runtime-analysis/build.js';
+//# sourceMappingURL=runtime-analysis.js.map

package/packages/core/dist/runtime-analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-analysis.js","sourceRoot":"","sources":["../src/runtime-analysis.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC"}

package/packages/core/dist/runtime-paths.d.ts

@@ -0,0 +1,35 @@
+export declare function getWorktreesDir(projectRoot: string): string;
+export declare function getSddDir(projectRoot: string): string;
+export declare function getProjectConfigPath(projectRoot: string): string;
+export declare function getRunsDir(projectRoot: string): string;
+export declare function getLocalRunIndexPath(projectRoot: string): string;
+export declare function getRuntimeStorePath(projectRoot: string): string;
+export declare function getLegacyRunDir(projectRoot: string, runId: string): string;
+export declare function getRunDir(projectRoot: string, runId: string): string;
+export declare function getBranchRunRoot(projectRoot: string, branchSlug: string): string;
+export declare function getEvidenceDir(projectRoot: string, branchSlug: string): string;
+export declare function getEvidenceAttachmentPath(projectRoot: string, branchSlug: string, relativeEvidencePath: string): string;
+export declare function getLegacyArtifactsDir(projectRoot: string, runId: string): string;
+export declare function getArtifactsDir(projectRoot: string, runId: string): string;
+export declare function getLegacyAgentExecutionsDir(projectRoot: string, runId: string): string;
+export declare function getAgentExecutionsDir(projectRoot: string, runId: string): string;
+export declare function getLegacyTeamSessionsDir(projectRoot: string, runId: string): string;
+export declare function getTeamSessionsDir(projectRoot: string, runId: string): string;
+export declare function getLegacyWorkerRuntimesDir(projectRoot: string, runId: string): string;
+export declare function getWorkerRuntimesDir(projectRoot: string, runId: string): string;
+export declare function getLegacyInvocationLedgerPath(projectRoot: string, runId: string): string;
+export declare function getInvocationLedgerPath(projectRoot: string, runId: string): string;
+export declare function getRouteCacheDir(projectRoot: string): string;
+export declare function getRouteCachePath(projectRoot: string, key: string): string;
+export declare function getLegacyWorkerRuntimeRecordPath(projectRoot: string, runId: string, runtimeId: string): string;
+export declare function getWorkerRuntimeRecordPath(projectRoot: string, runId: string, runtimeId: string): string;
+export declare function getLegacyAgentExecutionRecordPath(projectRoot: string, runId: string, executionId: string): string;
+export declare function getAgentExecutionRecordPath(projectRoot: string, runId: string, executionId: string): string;
+export declare function getLegacyTeamSessionRecordPath(projectRoot: string, runId: string, teamId: string): string;
+export declare function getTeamSessionRecordPath(projectRoot: string, runId: string, teamId: string): string;
+export declare function getLegacyArtifactPath(projectRoot: string, runId: string, relativeArtifactPath: string): string;
+export declare function getArtifactPath(projectRoot: string, runId: string, relativeArtifactPath: string): string;
+export declare function getRunRelativeArtifactPath(artifactRootRelativePath: string): string;
+export declare function toArtifactRootRelativePath(runRelativeArtifactPath: string): string;
+export declare function normalizeArtifactRootRelativePath(value: string): string;
+export declare function normalizeEvidenceRootRelativePath(value: string): string;

package/packages/core/dist/runtime-paths.js

@@ -0,0 +1,142 @@
+import path from 'node:path';
+import { assertSafePathSegment, branchToSafePartition, normalizePortablePath } from './path-safety.js';
+export function getWorktreesDir(projectRoot) {
+    return path.join(getSddDir(projectRoot), 'worktrees');
+}
+export function getSddDir(projectRoot) {
+    return path.join(projectRoot, '.sdd');
+}
+export function getProjectConfigPath(projectRoot) {
+    return path.join(getSddDir(projectRoot), 'project.yml');
+}
+export function getRunsDir(projectRoot) {
+    return path.join(getSddDir(projectRoot), 'runs');
+}
+export function getLocalRunIndexPath(projectRoot) {
+    return path.join(getSddDir(projectRoot), 'run-index.json');
+}
+export function getRuntimeStorePath(projectRoot) {
+    return path.join(getSddDir(projectRoot), 'runtime.sqlite');
+}
+export function getLegacyRunDir(projectRoot, runId) {
+    assertSafePathSegment(runId, 'runId');
+    return path.join(getRunsDir(projectRoot), runId);
+}
+export function getRunDir(projectRoot, runId) {
+    return getLegacyRunDir(projectRoot, runId);
+}
+export function getBranchRunRoot(projectRoot, branchSlug) {
+    return path.join(getRunsDir(projectRoot), branchToSafePartition(branchSlug));
+}
+export function getEvidenceDir(projectRoot, branchSlug) {
+    return path.join(getBranchRunRoot(projectRoot, branchSlug), 'evidence');
+}
+export function getEvidenceAttachmentPath(projectRoot, branchSlug, relativeEvidencePath) {
+    const evidenceDir = getEvidenceDir(projectRoot, branchSlug);
+    const normalized = normalizeEvidenceRootRelativePath(relativeEvidencePath);
+    const resolved = path.resolve(evidenceDir, normalized);
+    if (!resolved.startsWith(path.resolve(evidenceDir) + path.sep) && resolved !== path.resolve(evidenceDir)) {
+        throw new Error(`Evidence path escapes evidence directory: ${relativeEvidencePath}`);
+    }
+    return resolved;
+}
+export function getLegacyArtifactsDir(projectRoot, runId) {
+    return path.join(getLegacyRunDir(projectRoot, runId), 'artifacts');
+}
+export function getArtifactsDir(projectRoot, runId) {
+    return getLegacyArtifactsDir(projectRoot, runId);
+}
+export function getLegacyAgentExecutionsDir(projectRoot, runId) {
+    return path.join(getLegacyRunDir(projectRoot, runId), 'agent-executions');
+}
+export function getAgentExecutionsDir(projectRoot, runId) {
+    return getLegacyAgentExecutionsDir(projectRoot, runId);
+}
+export function getLegacyTeamSessionsDir(projectRoot, runId) {
+    return path.join(getLegacyRunDir(projectRoot, runId), 'team-sessions');
+}
+export function getTeamSessionsDir(projectRoot, runId) {
+    return getLegacyTeamSessionsDir(projectRoot, runId);
+}
+export function getLegacyWorkerRuntimesDir(projectRoot, runId) {
+    return path.join(getLegacyRunDir(projectRoot, runId), 'worker-runtimes');
+}
+export function getWorkerRuntimesDir(projectRoot, runId) {
+    return getLegacyWorkerRuntimesDir(projectRoot, runId);
+}
+export function getLegacyInvocationLedgerPath(projectRoot, runId) {
+    return path.join(getLegacyRunDir(projectRoot, runId), 'invocations.jsonl');
+}
+export function getInvocationLedgerPath(projectRoot, runId) {
+    return getLegacyInvocationLedgerPath(projectRoot, runId);
+}
+export function getRouteCacheDir(projectRoot) {
+    return path.join(getSddDir(projectRoot), 'cache', 'routes');
+}
+export function getRouteCachePath(projectRoot, key) {
+    assertSafePathSegment(key, 'routeCacheKey');
+    return path.join(getRouteCacheDir(projectRoot), `${key}.json`);
+}
+export function getLegacyWorkerRuntimeRecordPath(projectRoot, runId, runtimeId) {
+    assertSafePathSegment(runtimeId, 'runtimeId');
+    return path.join(getLegacyWorkerRuntimesDir(projectRoot, runId), `${runtimeId}.json`);
+}
+export function getWorkerRuntimeRecordPath(projectRoot, runId, runtimeId) {
+    return getLegacyWorkerRuntimeRecordPath(projectRoot, runId, runtimeId);
+}
+export function getLegacyAgentExecutionRecordPath(projectRoot, runId, executionId) {
+    assertSafePathSegment(executionId, 'executionId');
+    return path.join(getLegacyAgentExecutionsDir(projectRoot, runId), `${executionId}.json`);
+}
+export function getAgentExecutionRecordPath(projectRoot, runId, executionId) {
+    return getLegacyAgentExecutionRecordPath(projectRoot, runId, executionId);
+}
+export function getLegacyTeamSessionRecordPath(projectRoot, runId, teamId) {
+    assertSafePathSegment(teamId, 'teamId');
+    return path.join(getLegacyTeamSessionsDir(projectRoot, runId), `${teamId}.json`);
+}
+export function getTeamSessionRecordPath(projectRoot, runId, teamId) {
+    return getLegacyTeamSessionRecordPath(projectRoot, runId, teamId);
+}
+export function getLegacyArtifactPath(projectRoot, runId, relativeArtifactPath) {
+    const artifactsDir = getLegacyArtifactsDir(projectRoot, runId);
+    const resolved = path.resolve(artifactsDir, relativeArtifactPath);
+    if (!resolved.startsWith(path.resolve(artifactsDir) + path.sep) && resolved !== path.resolve(artifactsDir)) {
+        throw new Error(`Artifact path escapes artifacts directory: ${relativeArtifactPath}`);
+    }
+    return resolved;
+}
+export function getArtifactPath(projectRoot, runId, relativeArtifactPath) {
+    return getLegacyArtifactPath(projectRoot, runId, relativeArtifactPath);
+}
+export function getRunRelativeArtifactPath(artifactRootRelativePath) {
+    return `artifacts/${normalizeArtifactRootRelativePath(artifactRootRelativePath)}`;
+}
+export function toArtifactRootRelativePath(runRelativeArtifactPath) {
+    const portablePath = runRelativeArtifactPath.replace(/\\/g, '/');
+    if (!portablePath.startsWith('artifacts/')) {
+        throw new Error(`Run-relative artifact path must start with artifacts/: ${runRelativeArtifactPath}`);
+    }
+    return normalizeArtifactRootRelativePath(portablePath.slice('artifacts/'.length));
+}
+export function normalizeArtifactRootRelativePath(value) {
+    const normalized = normalizePortablePath(value);
+    if (!normalized || normalized === '.' || normalized.startsWith('../') || normalized === '..' || path.isAbsolute(value)) {
+        throw new Error(`Artifact path must be relative and stay under artifacts/: ${value}`);
+    }
+    if (normalized.startsWith('artifacts/')) {
+        throw new Error(`Artifact helper paths must be artifact-root-relative, not run-relative: ${value}`);
+    }
+    return normalized;
+}
+export function normalizeEvidenceRootRelativePath(value) {
+    const normalized = normalizePortablePath(value);
+    if (!normalized || normalized === '.' || normalized.startsWith('../') || normalized === '..' || path.isAbsolute(value)) {
+        throw new Error(`Evidence path must be relative and stay under evidence/: ${value}`);
+    }
+    if (normalized.startsWith('evidence/')) {
+        throw new Error(`Evidence helper paths must be evidence-root-relative, not branch-run-relative: ${value}`);
+    }
+    return normalized;
+}
+//# sourceMappingURL=runtime-paths.js.map

package/packages/core/dist/runtime-paths.js.map

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

package/packages/core/dist/sdd-docs/context.d.ts

@@ -0,0 +1,18 @@
+import { CONTEXT_RESOLVER_CONTRACT_VERSION } from '../contracts.js';
+import type { RunState } from '../run-state/model.js';
+export type ContextBranchSource = 'explicit_option' | 'cli_option' | 'project_config' | 'git_branch';
+export interface ContextResolverContract {
+    contract: typeof CONTEXT_RESOLVER_CONTRACT_VERSION;
+    branch: string;
+    partition: string;
+    rawBranch: string;
+    branchSource: ContextBranchSource;
+    currentGitBranch: string | null;
+    workingTreeMatched: boolean | null;
+    specDir: string;
+}
+export declare function resolveSddContext(projectRoot: string, options?: {
+    branch?: string | null;
+    branchSource?: ContextBranchSource;
+}): Promise<ContextResolverContract>;
+export declare function resolveRunStateContext(projectRoot: string, state: RunState): Promise<ContextResolverContract>;

package/packages/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. The spec stage 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/packages/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/packages/core/dist/sdd-docs/document-hashes.d.ts

@@ -0,0 +1,4 @@
+export declare function hashDocumentContent(raw: string): string;
+export declare function hashSemanticDocument(raw: string | null): string | null;
+export declare function hashTasksContract(raw: string | null): string | null;
+export declare function documentHashMatches(expected: string, actual: string): boolean;