sdd-agent-platform 0.2.0 → 0.4.0

package/node_modules/@sdd-agent-platform/core/dist/runtime-analysis/findings.js

@@ -0,0 +1,274 @@
+import { RUNTIME_ANALYSIS_CONTRACT_VERSION } from '../contracts.js';
+export function createRuntimeAnalysisReport(input) {
+    const findings = buildRuntimeAnalysisFindings(input);
+    return {
+        contract: RUNTIME_ANALYSIS_CONTRACT_VERSION,
+        generatedAt: input.generatedAt,
+        profile: input.profile,
+        authoritative: false,
+        usableForPass: false,
+        status: summarizeRuntimeAnalysisStatus(findings),
+        branch: input.branch,
+        selectedRunId: input.selectedRunId,
+        selectedTaskId: input.selectedTaskId,
+        recommendedNextCommand: input.status.recommendedNextCommand,
+        workflow: input.status,
+        doctor: input.doctor,
+        runIndex: input.runIndex,
+        taskGraph: input.taskGraph,
+        wavePlan: input.wavePlan,
+        runInspection: input.runInspection,
+        evidenceSummary: input.evidenceSummary,
+        contextPackage: input.contextPackage,
+        syncBack: input.syncBack,
+        findings
+    };
+}
+export function buildRuntimeAnalysisFindings(input) {
+    const findings = [];
+    const add = (finding) => findings.push(finding);
+    if (input.status.workflowStatus === 'not_started') {
+        add({
+            severity: 'blocking',
+            category: 'workflow',
+            source: `specs/${input.branch}`,
+            message: `Workflow partition ${input.branch} has not started.`,
+            action: input.status.recommendedNextCommand
+        });
+    }
+    for (const gap of input.status.gaps) {
+        add({
+            severity: gap.severity === 'blocking' ? 'blocking' : 'warning',
+            category: 'workflow',
+            source: gap.field,
+            message: gap.taskId ? `${gap.taskId}: ${gap.message}` : gap.message,
+            action: gap.recommendation,
+            taskId: gap.taskId ?? undefined
+        });
+    }
+    if (input.status.tasks.pending > 0) {
+        add({
+            severity: 'info',
+            category: 'workflow',
+            source: `specs/${input.branch}/tasks.md`,
+            message: `${input.status.tasks.pending} pending task(s) remain.`,
+            action: input.status.recommendedNextCommand
+        });
+    }
+    for (const reason of input.status.latestRunStaleReasons) {
+        add({
+            severity: 'warning',
+            category: 'run',
+            source: input.status.latestRun?.runId ?? 'latest-run',
+            message: reason,
+            action: input.status.latestRun?.currentTask ? `sdd test task ${input.status.latestRun.currentTask} --branch ${input.branch}` : undefined,
+            runId: input.status.latestRun?.runId ?? undefined,
+            taskId: input.status.latestRun?.currentTask ?? undefined
+        });
+    }
+    for (const check of input.doctor.checks) {
+        if (check.level !== 'PASS') {
+            add({
+                severity: check.level === 'FAIL' ? 'blocking' : 'warning',
+                category: 'doctor',
+                source: check.check,
+                message: check.message,
+                action: check.action
+            });
+        }
+    }
+    if (!input.runIndex.exists) {
+        add({
+            severity: 'warning',
+            category: 'run_index',
+            source: input.runIndex.indexPath,
+            message: 'Local run index is missing.',
+            action: 'sdd run index rebuild'
+        });
+    }
+    else if (!input.runIndex.valid) {
+        for (const issue of input.runIndex.issues) {
+            add({
+                severity: 'warning',
+                category: 'run_index',
+                source: input.runIndex.indexPath,
+                message: issue.message,
+                action: issue.recommendation
+            });
+        }
+    }
+    if (!input.taskGraph.valid) {
+        add({
+            severity: 'blocking',
+            category: 'task_graph',
+            source: `specs/${input.branch}/tasks.md`,
+            message: 'Task graph is not valid.',
+            action: `sdd tasks gaps --branch ${input.branch}`
+        });
+    }
+    for (const diagnostic of input.taskGraph.diagnostics) {
+        add({
+            severity: diagnostic.severity === 'blocking' ? 'blocking' : 'warning',
+            category: 'task_graph',
+            source: diagnostic.field,
+            message: diagnostic.taskId ? `${diagnostic.taskId}: ${diagnostic.message}` : diagnostic.message,
+            action: diagnostic.recommendation,
+            taskId: diagnostic.taskId ?? undefined
+        });
+    }
+    for (const gate of input.wavePlan.blockedTasks) {
+        add({
+            severity: 'blocking',
+            category: 'wave_plan',
+            source: `wave:${input.wavePlan.branch}`,
+            message: `${gate.taskId} is blocked: ${gate.reasons.join('; ')}`,
+            action: `sdd tasks inspect ${gate.taskId} --branch ${input.wavePlan.branch}`,
+            taskId: gate.taskId
+        });
+    }
+    for (const gate of input.wavePlan.manualGates) {
+        add({
+            severity: 'warning',
+            category: 'wave_plan',
+            source: `wave:${input.wavePlan.branch}`,
+            message: `${gate.taskId} requires manual gating: ${gate.reasons.join('; ')}`,
+            action: `sdd tasks inspect ${gate.taskId} --branch ${input.wavePlan.branch}`,
+            taskId: gate.taskId
+        });
+    }
+    if (input.runInspection) {
+        addRunInspectionFindings(input.runInspection, add);
+    }
+    if (input.evidenceSummary) {
+        addEvidenceSummaryFindings(input.evidenceSummary, add);
+    }
+    if (input.contextPackage) {
+        for (const warning of input.contextPackage.warnings) {
+            add({
+                severity: warning.includes('cannot satisfy PASS evidence') ? 'info' : 'warning',
+                category: 'context',
+                source: `context:${input.contextPackage.mode}`,
+                message: warning,
+                action: input.contextPackage.nextCommands[0],
+                taskId: input.contextPackage.taskId
+            });
+        }
+    }
+    if (input.syncBack) {
+        addSyncBackFindings(input.syncBack, add);
+    }
+    for (const issue of input.inputIssues) {
+        add({
+            severity: 'warning',
+            category: issue.source,
+            source: issue.source,
+            message: issue.message,
+            action: issue.action,
+            runId: issue.runId,
+            taskId: issue.taskId
+        });
+    }
+    return findings;
+}
+function addRunInspectionFindings(run, add) {
+    if (run.state.status === 'failed' || run.state.status === 'blocked') {
+        add({
+            severity: 'blocking',
+            category: 'run',
+            source: run.summary.runId,
+            message: `Run status is ${run.state.status}.`,
+            action: run.summary.currentTask ? `sdd do task ${run.summary.currentTask} --branch ${run.summary.partition ?? run.summary.gitBranch ?? 'master'}` : undefined,
+            runId: run.summary.runId,
+            taskId: run.summary.currentTask ?? undefined
+        });
+    }
+    if (run.validation.status === 'fail' || run.validation.status === 'blocked') {
+        add({
+            severity: 'blocking',
+            category: 'run',
+            source: `${run.summary.runId}:validation`,
+            message: `Run validation status is ${run.validation.status}.`,
+            action: run.summary.currentTask ? `sdd test task ${run.summary.currentTask} --branch ${run.summary.partition ?? run.summary.gitBranch ?? 'master'}` : undefined,
+            runId: run.summary.runId,
+            taskId: run.summary.currentTask ?? undefined
+        });
+    }
+    if (run.syncBack.status === 'proposed') {
+        add({
+            severity: 'warning',
+            category: 'sync_back',
+            source: `${run.summary.runId}:sync_back`,
+            message: 'Run has an unapplied sync-back proposal.',
+            action: run.summary.currentTask ? `sdd sync-back inspect --branch ${run.summary.partition ?? run.summary.gitBranch ?? 'master'} --task ${run.summary.currentTask}` : undefined,
+            runId: run.summary.runId,
+            taskId: run.summary.currentTask ?? undefined
+        });
+    }
+}
+function addEvidenceSummaryFindings(summary, add) {
+    add({
+        severity: 'info',
+        category: 'evidence',
+        source: `evidence:${summary.runId}`,
+        message: 'Evidence summary is derived guidance only and cannot satisfy PASS evidence.',
+        action: summary.taskId ? `sdd test task ${summary.taskId}` : undefined,
+        runId: summary.runId,
+        taskId: summary.taskId ?? undefined
+    });
+    if (summary.failCount > 0 || summary.blockedCount > 0) {
+        add({
+            severity: summary.failCount > 0 ? 'blocking' : 'warning',
+            category: 'evidence',
+            source: `evidence:${summary.runId}`,
+            message: `Evidence projection has pass=${summary.passCount}, blocked=${summary.blockedCount}, fail=${summary.failCount}.`,
+            action: summary.taskId ? `sdd test task ${summary.taskId}` : undefined,
+            runId: summary.runId,
+            taskId: summary.taskId ?? undefined
+        });
+    }
+    if (summary.issueCodes.length > 0) {
+        add({
+            severity: 'warning',
+            category: 'evidence',
+            source: `evidence:${summary.runId}`,
+            message: `Evidence quality issues: ${summary.issueCodes.join(', ')}.`,
+            action: summary.taskId ? `sdd artifact validate ${summary.runId} <artifact> --task ${summary.taskId} --agent <agent>` : undefined,
+            runId: summary.runId,
+            taskId: summary.taskId ?? undefined
+        });
+    }
+}
+function addSyncBackFindings(syncBack, add) {
+    if (syncBack.status === 'ready') {
+        add({
+            severity: 'warning',
+            category: 'sync_back',
+            source: syncBack.targetTasksPath,
+            message: `Sync-back is ready for ${syncBack.taskId ?? 'unknown task'} but not applied.`,
+            action: `sdd sync-back apply ${syncBack.runId} --branch ${syncBack.branch} --task ${syncBack.taskId ?? '<task_id>'}${syncBack.applyPolicy.requiresApproval ? ' --approved' : ''}`,
+            runId: syncBack.runId,
+            taskId: syncBack.taskId ?? undefined
+        });
+    }
+    else if (syncBack.status === 'blocked') {
+        add({
+            severity: 'blocking',
+            category: 'sync_back',
+            source: syncBack.targetTasksPath,
+            message: `Sync-back is blocked: ${syncBack.reasons.join('; ')}`,
+            action: `sdd sync-back inspect ${syncBack.runId} --branch ${syncBack.branch} --task ${syncBack.taskId ?? '<task_id>'}`,
+            runId: syncBack.runId,
+            taskId: syncBack.taskId ?? undefined
+        });
+    }
+}
+export function summarizeRuntimeAnalysisStatus(findings) {
+    if (findings.some((finding) => finding.severity === 'blocking')) {
+        return 'BLOCKED';
+    }
+    if (findings.some((finding) => finding.severity === 'warning')) {
+        return 'WARN';
+    }
+    return 'PASS';
+}
+//# sourceMappingURL=findings.js.map

package/node_modules/@sdd-agent-platform/core/dist/runtime-analysis/findings.js.map

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

package/node_modules/@sdd-agent-platform/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/node_modules/@sdd-agent-platform/core/dist/runtime-analysis/model.js

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

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

@@ -0,0 +1,25 @@
+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 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 getArtifactsDir(projectRoot: string, runId: string): string;
+export declare function getAgentExecutionsDir(projectRoot: string, runId: string): string;
+export declare function getTeamSessionsDir(projectRoot: string, runId: string): string;
+export declare function getWorkerRuntimesDir(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 getWorkerRuntimeRecordPath(projectRoot: string, runId: string, runtimeId: string): string;
+export declare function getAgentExecutionRecordPath(projectRoot: string, runId: string, executionId: string): string;
+export declare function getTeamSessionRecordPath(projectRoot: string, runId: string, teamId: 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/node_modules/@sdd-agent-platform/core/dist/runtime-paths.js

@@ -0,0 +1,112 @@
+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 getRunDir(projectRoot, runId) {
+    assertSafePathSegment(runId, 'runId');
+    return path.join(getRunsDir(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 getArtifactsDir(projectRoot, runId) {
+    return path.join(getRunDir(projectRoot, runId), 'artifacts');
+}
+export function getAgentExecutionsDir(projectRoot, runId) {
+    return path.join(getRunDir(projectRoot, runId), 'agent-executions');
+}
+export function getTeamSessionsDir(projectRoot, runId) {
+    return path.join(getRunDir(projectRoot, runId), 'team-sessions');
+}
+export function getWorkerRuntimesDir(projectRoot, runId) {
+    return path.join(getRunDir(projectRoot, runId), 'worker-runtimes');
+}
+export function getInvocationLedgerPath(projectRoot, runId) {
+    return path.join(getRunDir(projectRoot, runId), 'invocations.jsonl');
+}
+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 getWorkerRuntimeRecordPath(projectRoot, runId, runtimeId) {
+    assertSafePathSegment(runtimeId, 'runtimeId');
+    return path.join(getWorkerRuntimesDir(projectRoot, runId), `${runtimeId}.json`);
+}
+export function getAgentExecutionRecordPath(projectRoot, runId, executionId) {
+    assertSafePathSegment(executionId, 'executionId');
+    return path.join(getAgentExecutionsDir(projectRoot, runId), `${executionId}.json`);
+}
+export function getTeamSessionRecordPath(projectRoot, runId, teamId) {
+    assertSafePathSegment(teamId, 'teamId');
+    return path.join(getTeamSessionsDir(projectRoot, runId), `${teamId}.json`);
+}
+export function getArtifactPath(projectRoot, runId, relativeArtifactPath) {
+    const artifactsDir = getArtifactsDir(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 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/node_modules/@sdd-agent-platform/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/node_modules/@sdd-agent-platform/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>;