sdd-agent-platform 0.4.0 → 0.4.2

package/packages/core/dist/stage-artifacts.js

@@ -0,0 +1,322 @@
+import { createHash } from 'node:crypto';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { branchToSafePartition, normalizePortablePath } from './path-safety.js';
+import { normalizeBranchStageEvidenceRef } from './runtime-paths.js';
+import { hashDocumentContent } from './sdd-docs/document-hashes.js';
+export const SPEC_SCOUT_ARTIFACT_CONTRACT_VERSION = 'sdd-spec-scout-artifact-v1';
+export const SPEC_REVIEW_ARTIFACT_CONTRACT_VERSION = 'sdd-spec-review-artifact-v1';
+export const SPEC_MANAGER_ARTIFACT_CONTRACT_VERSION = 'sdd-spec-manager-artifact-v1';
+export function parseMarkdownFrontmatter(content) {
+    const match = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/.exec(content);
+    if (!match) {
+        throw new Error('Markdown artifact must start with frontmatter.');
+    }
+    return { frontmatter: parseSimpleFrontmatter(match[1]), body: content.slice(match[0].length) };
+}
+export async function readMarkdownArtifact(projectRoot, ref) {
+    const normalizedRef = normalizeBranchStageEvidenceRef(ref);
+    const projectPath = path.resolve(projectRoot);
+    const artifactPath = path.resolve(projectRoot, normalizedRef);
+    if (!artifactPath.startsWith(`${projectPath}${path.sep}`)) {
+        throw new Error(`Markdown artifact ref escapes project root: ${ref}`);
+    }
+    const content = await readFile(artifactPath, 'utf8');
+    const { frontmatter, body } = parseMarkdownFrontmatter(content);
+    return { ref: normalizedRef, path: artifactPath, content, hash: hashDocumentContent(content), frontmatter, body };
+}
+export function validateStageArtifactFrontmatter(input) {
+    const normalizedRef = normalizeBranchStageEvidenceRef(input.ref);
+    const [, , refBranch, refStage] = normalizedRef.split('/');
+    const branch = branchToSafePartition(input.branch);
+    if (refBranch !== branch) {
+        throw new Error(`Stage artifact ref branch ${refBranch} does not match ${branch}.`);
+    }
+    if (refStage !== input.stage) {
+        throw new Error(`Stage artifact ref stage ${refStage} does not match ${input.stage}.`);
+    }
+    const frontmatterBranch = requireString(input.frontmatter, 'branch');
+    if (frontmatterBranch !== input.branch && frontmatterBranch !== branch) {
+        throw new Error(`Stage artifact frontmatter branch ${frontmatterBranch} does not match ${input.branch}.`);
+    }
+    const frontmatterStage = requireString(input.frontmatter, 'stage');
+    if (frontmatterStage !== input.stage) {
+        throw new Error(`Stage artifact frontmatter stage ${frontmatterStage} does not match ${input.stage}.`);
+    }
+    const stageRules = requireStageArtifactRules(input.stage);
+    const kindValue = requireString(input.frontmatter, 'kind');
+    const rule = stageRules.find((candidate) => candidate.kind === kindValue);
+    if (!rule) {
+        throw new Error(`Stage artifact frontmatter kind has unsupported value for ${input.stage}: ${kindValue}`);
+    }
+    const kind = rule.kind;
+    const producerValue = requireString(input.frontmatter, 'producer');
+    if (!rule.producers.includes(producerValue)) {
+        throw new Error(`Stage artifact kind ${kind} must be produced by ${rule.producers.join(' or ')}.`);
+    }
+    const producer = producerValue;
+    const contract = requireString(input.frontmatter, 'contract');
+    if (contract !== rule.contract) {
+        throw new Error(`Stage artifact kind ${kind} requires contract ${rule.contract}.`);
+    }
+    const targetHash = optionalString(input.frontmatter, 'targetHash');
+    const targetRefValue = optionalString(input.frontmatter, 'targetRef');
+    const reviewHash = optionalString(input.frontmatter, 'reviewHash');
+    const reviewRefValue = optionalString(input.frontmatter, 'reviewRef');
+    const reviewRef = reviewRefValue ? normalizeBranchStageEvidenceRef(reviewRefValue) : undefined;
+    if (reviewRef) {
+        const [, , reviewRefBranch, reviewRefStage] = reviewRef.split('/');
+        if (reviewRefBranch !== branch) {
+            throw new Error(`Stage artifact reviewRef branch ${reviewRefBranch} does not match ${branch}.`);
+        }
+        if (reviewRefStage !== input.stage) {
+            throw new Error(`Stage artifact reviewRef stage ${reviewRefStage} does not match ${input.stage}.`);
+        }
+    }
+    const verdict = optionalEnum(input.frontmatter, 'verdict', STAGE_ARTIFACT_REVIEW_VERDICTS);
+    const findingCount = optionalNumber(input.frontmatter, 'findingCount');
+    const blockingCount = optionalNumber(input.frontmatter, 'blockingCount');
+    const recommendation = optionalEnum(input.frontmatter, 'recommendation', STAGE_MANAGER_RECOMMENDATIONS);
+    if (rule.requireTarget) {
+        requirePresent(targetRefValue, 'targetRef');
+        requirePresent(targetHash, 'targetHash');
+    }
+    if (rule.requireReviewLink) {
+        requirePresent(reviewRef, 'reviewRef');
+        requirePresent(reviewHash, 'reviewHash');
+    }
+    if (rule.requireVerdict) {
+        requirePresent(verdict, 'verdict');
+    }
+    if (rule.requireFindingCounts) {
+        requirePresent(findingCount, 'findingCount');
+        requirePresent(blockingCount, 'blockingCount');
+    }
+    if (rule.requireRecommendation) {
+        requirePresent(recommendation, 'recommendation');
+    }
+    return {
+        artifactId: stageArtifactId(branch, input.stage, normalizedRef, input.hash),
+        branch,
+        stage: input.stage,
+        kind,
+        producer,
+        ref: normalizedRef,
+        hash: input.hash,
+        contract,
+        targetRef: targetRefValue ? runtimeRef(targetRefValue, targetHash) : undefined,
+        targetHash,
+        reviewRef: reviewRef ? runtimeRef(reviewRef, reviewHash) : undefined,
+        reviewHash,
+        verdict,
+        findingCount,
+        blockingCount,
+        recommendation,
+        frontmatter: input.frontmatter,
+        registeredAt: input.registeredAt ?? new Date().toISOString()
+    };
+}
+function parseSimpleFrontmatter(raw) {
+    const frontmatter = {};
+    let arrayKey = null;
+    let currentObject = null;
+    for (const line of raw.split(/\r?\n/)) {
+        if (!line.trim()) {
+            continue;
+        }
+        if (line.startsWith('  - ') && arrayKey) {
+            const item = line.slice(4);
+            if (item.includes(':')) {
+                const [key, value] = splitKeyValue(item);
+                currentObject = { [key]: parseScalar(value) };
+                frontmatter[arrayKey].push(currentObject);
+            }
+            else {
+                currentObject = null;
+                frontmatter[arrayKey].push(parseScalar(item));
+            }
+            continue;
+        }
+        if (line.startsWith('    ') && currentObject) {
+            const [key, value] = splitKeyValue(line.trim());
+            currentObject[key] = parseScalar(value);
+            continue;
+        }
+        const [key, value] = splitKeyValue(line);
+        currentObject = null;
+        if (value === '') {
+            frontmatter[key] = [];
+            arrayKey = key;
+        }
+        else {
+            frontmatter[key] = parseScalar(value);
+            arrayKey = null;
+        }
+    }
+    return frontmatter;
+}
+function splitKeyValue(value) {
+    const index = value.indexOf(':');
+    if (index === -1) {
+        throw new Error(`Invalid frontmatter line: ${value}`);
+    }
+    return [value.slice(0, index).trim(), value.slice(index + 1).trim()];
+}
+function parseScalar(value) {
+    const trimmed = value.trim();
+    if ((trimmed.startsWith('"') && trimmed.endsWith('"')) || (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
+        return trimmed.slice(1, -1);
+    }
+    if (trimmed === 'true') {
+        return true;
+    }
+    if (trimmed === 'false') {
+        return false;
+    }
+    if (/^-?\d+$/.test(trimmed)) {
+        return Number(trimmed);
+    }
+    if (trimmed === '[]') {
+        return [];
+    }
+    return trimmed;
+}
+function requireString(frontmatter, key) {
+    const value = frontmatter[key];
+    if (typeof value !== 'string' || value.length === 0) {
+        throw new Error(`Stage artifact frontmatter ${key} must be a non-empty string.`);
+    }
+    return value;
+}
+function optionalString(frontmatter, key) {
+    const value = frontmatter[key];
+    if (value === undefined || value === null || value === '') {
+        return undefined;
+    }
+    if (typeof value !== 'string') {
+        throw new Error(`Stage artifact frontmatter ${key} must be a string.`);
+    }
+    return normalizeRuntimeRefValue(value, key);
+}
+function optionalNumber(frontmatter, key) {
+    const value = frontmatter[key];
+    if (value === undefined || value === null || value === '') {
+        return undefined;
+    }
+    if (typeof value !== 'number' || !Number.isInteger(value) || value < 0) {
+        throw new Error(`Stage artifact frontmatter ${key} must be a non-negative integer.`);
+    }
+    return value;
+}
+function requireEnum(frontmatter, key, allowed) {
+    const value = requireString(frontmatter, key);
+    if (!allowed.includes(value)) {
+        throw new Error(`Stage artifact frontmatter ${key} has unsupported value: ${value}`);
+    }
+    return value;
+}
+function optionalEnum(frontmatter, key, allowed) {
+    const value = frontmatter[key];
+    if (value === undefined || value === null || value === '') {
+        return undefined;
+    }
+    if (typeof value !== 'string' || !allowed.includes(value)) {
+        throw new Error(`Stage artifact frontmatter ${key} has unsupported value: ${String(value)}`);
+    }
+    return value;
+}
+function requirePresent(value, key) {
+    if (value === undefined || value === null || value === '') {
+        throw new Error(`Stage artifact frontmatter ${key} is required.`);
+    }
+}
+function runtimeRef(value, hash) {
+    const ref = normalizeRuntimeRefValue(value, 'ref');
+    const kind = ref.startsWith('specs/') ? 'document' : ref.startsWith('.sdd/runs/') ? 'artifact' : 'external';
+    return hash ? { kind, ref, hash } : { kind, ref };
+}
+function normalizeRuntimeRefValue(value, field) {
+    const normalized = normalizePortablePath(value);
+    if (!normalized || normalized === '.' || normalized === '..' || normalized.includes('..') || path.isAbsolute(value)) {
+        throw new Error(`Stage artifact frontmatter ${field} must be a safe logical ref: ${value}`);
+    }
+    return normalized;
+}
+function stageArtifactId(branch, stage, ref, hash) {
+    return `stage-artifact-${createHash('sha256').update([branch, stage, ref, hash].join('\0'), 'utf8').digest('hex').slice(0, 24)}`;
+}
+function requireStageArtifactRules(stage) {
+    const rules = STAGE_ARTIFACT_RULES[stage];
+    if (!rules) {
+        throw new Error(`Unsupported stage artifact stage: ${stage}`);
+    }
+    return rules;
+}
+export function expectedStageArtifactContracts(stage, outputKinds) {
+    const rules = requireStageArtifactRules(stage);
+    const contracts = [];
+    for (const outputKind of outputKinds) {
+        const rule = rules.find((candidate) => candidate.kind === outputKind);
+        if (rule && !contracts.includes(rule.contract)) {
+            contracts.push(rule.contract);
+        }
+    }
+    return contracts;
+}
+function evidenceRule(kind, producers, contract) {
+    return { kind, producers, contract };
+}
+function reviewRule(kind, producer, contract) {
+    return { kind, producers: [producer], contract, requireTarget: true, requireVerdict: true, requireFindingCounts: true };
+}
+function managerRule(producer, contract) {
+    return { kind: 'manager_closure_request', producers: [producer], contract, requireTarget: true, requireReviewLink: true, requireRecommendation: true };
+}
+const STAGE_ARTIFACT_REVIEW_VERDICTS = ['approved', 'changes_requested', 'blocked'];
+const STAGE_MANAGER_RECOMMENDATIONS = ['close_stage', 'request_clarification', 'reject', 'blocked'];
+const STAGE_ARTIFACT_RULES = {
+    spec: [
+        evidenceRule('scout_context', ['scout'], SPEC_SCOUT_ARTIFACT_CONTRACT_VERSION),
+        reviewRule('spec_review', 'spec-reviewer', SPEC_REVIEW_ARTIFACT_CONTRACT_VERSION),
+        evidenceRule('spec_manager_coordination', ['spec-manager'], SPEC_MANAGER_ARTIFACT_CONTRACT_VERSION),
+        managerRule('spec-manager', SPEC_MANAGER_ARTIFACT_CONTRACT_VERSION)
+    ],
+    plan: [
+        evidenceRule('plan_context', ['plan-scout', 'plan-capability'], 'sdd-plan-context-artifact-v1'),
+        reviewRule('plan_review', 'plan-reviewer', 'sdd-plan-review-artifact-v1'),
+        managerRule('plan-manager', 'sdd-plan-manager-artifact-v1')
+    ],
+    tasks: [
+        evidenceRule('tasks_context', ['task-slicer', 'tasks-capability'], 'sdd-tasks-context-artifact-v1'),
+        reviewRule('tasks_review', 'tasks-reviewer', 'sdd-tasks-review-artifact-v1'),
+        managerRule('tasks-manager', 'sdd-tasks-manager-artifact-v1')
+    ],
+    verifies: [
+        evidenceRule('verifies_context', ['verification-agent', 'verifies-capability'], 'sdd-verifies-context-artifact-v1'),
+        reviewRule('verifies_review', 'verifies-reviewer', 'sdd-verifies-review-artifact-v1'),
+        managerRule('verifies-manager', 'sdd-verifies-manager-artifact-v1')
+    ],
+    do: [
+        evidenceRule('implementation_evidence', ['implementer'], 'sdd-do-implementation-artifact-v1'),
+        reviewRule('code_review', 'code-reviewer', 'sdd-do-code-review-artifact-v1'),
+        evidenceRule('debug_evidence', ['debugger'], 'sdd-do-debug-artifact-v1'),
+        managerRule('do-manager', 'sdd-do-manager-artifact-v1')
+    ],
+    test: [
+        evidenceRule('test_execution', ['test-runner'], 'sdd-test-execution-artifact-v1'),
+        evidenceRule('validation_evidence', ['validator'], 'sdd-test-validation-artifact-v1'),
+        reviewRule('test_review', 'test-reviewer', 'sdd-test-review-artifact-v1'),
+        managerRule('test-manager', 'sdd-test-manager-artifact-v1')
+    ],
+    'goal-verify': [
+        evidenceRule('goal_verification', ['goal-validator'], 'sdd-goal-verify-verification-artifact-v1'),
+        reviewRule('goal_review', 'goal-reviewer', 'sdd-goal-verify-review-artifact-v1'),
+        managerRule('goal-verify-manager', 'sdd-goal-verify-manager-artifact-v1')
+    ],
+    ship: [
+        evidenceRule('ship_readiness', ['ship-validator'], 'sdd-ship-readiness-artifact-v1'),
+        reviewRule('release_review', 'release-reviewer', 'sdd-ship-release-review-artifact-v1'),
+        managerRule('ship-manager', 'sdd-ship-manager-artifact-v1')
+    ]
+};
+//# sourceMappingURL=stage-artifacts.js.map

package/packages/core/dist/stage-artifacts.js.map

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

package/packages/core/dist/stage-collaboration-contracts.d.ts

@@ -0,0 +1,55 @@
+import type { SddStage } from './contracts.js';
+export declare const STAGE_COLLABORATION_CONTRACT_VERSION = "sdd-stage-collaboration-contract-v1";
+export type StageCollaborationContractStatus = 'validated' | 'rejected';
+export type StageCollaborationContractProducer = 'spec-manager' | 'plan-manager' | 'tasks-manager' | 'verifies-manager' | 'do-manager' | 'test-manager' | 'goal-verify-manager' | 'ship-manager';
+export interface StageCollaborationContractWorkOrderInput {
+    workOrderId: string;
+    stage: SddStage;
+    stageManager: StageCollaborationContractProducer;
+    agentTeam: readonly string[];
+    requiredOutputKinds: readonly string[];
+    forbiddenActions: readonly string[];
+    requiredCapabilities: readonly string[];
+    optionalCapabilities: readonly string[];
+    materialPackIds: readonly string[];
+    authorityCeiling: string;
+}
+export interface StageCollaborationContractValidationInput {
+    branch: string;
+    stage: SddStage;
+    ref: string;
+    hash: string;
+    frontmatter: Record<string, unknown>;
+    workOrder: StageCollaborationContractWorkOrderInput | null;
+    registeredAt?: string;
+}
+export interface RegisteredStageCollaborationContract {
+    contractId: string;
+    branch: string;
+    stage: SddStage;
+    ref: string;
+    hash: string;
+    contract: string;
+    producer: StageCollaborationContractProducer;
+    workOrderId: string | null;
+    status: StageCollaborationContractStatus;
+    validationErrors: string[];
+    selectedAgents: string[];
+    selectedSkills: string[];
+    selectedMaterialPacks: string[];
+    evidenceContracts: string[];
+    checkpointPlan: string[];
+    reworkPlan: {
+        maxAttempts: number | null;
+    };
+    permissionProjection: {
+        authorityCeiling: string | null;
+        allowAutoWithinStage: boolean | null;
+        allowAutoNextStage: boolean | null;
+        writableRefs: string[];
+    };
+    frontmatter: Record<string, unknown>;
+    registeredAt: string;
+}
+export declare function readStageCollaborationContract(projectRoot: string, ref: string): Promise<import("./stage-artifacts.js").MarkdownArtifactReadResult>;
+export declare function validateStageCollaborationContractFrontmatter(input: StageCollaborationContractValidationInput): RegisteredStageCollaborationContract;

package/packages/core/dist/stage-collaboration-contracts.js

@@ -0,0 +1,241 @@
+import { createHash } from 'node:crypto';
+import { branchToSafePartition, normalizePortablePath } from './path-safety.js';
+import { normalizeBranchStageEvidenceRef } from './runtime-paths.js';
+import { expectedStageArtifactContracts, readMarkdownArtifact } from './stage-artifacts.js';
+export const STAGE_COLLABORATION_CONTRACT_VERSION = 'sdd-stage-collaboration-contract-v1';
+export async function readStageCollaborationContract(projectRoot, ref) {
+    return readMarkdownArtifact(projectRoot, ref);
+}
+export function validateStageCollaborationContractFrontmatter(input) {
+    const normalizedRef = normalizeBranchStageEvidenceRef(input.ref);
+    const [, , refBranch, refStage] = normalizedRef.split('/');
+    const branch = branchToSafePartition(input.branch);
+    const errors = [];
+    if (refBranch !== branch) {
+        errors.push(`Stage collaboration contract ref branch ${refBranch} does not match ${branch}.`);
+    }
+    if (refStage !== input.stage) {
+        errors.push(`Stage collaboration contract ref stage ${refStage} does not match ${input.stage}.`);
+    }
+    const contract = stringField(input.frontmatter, 'contract', errors);
+    if (contract !== STAGE_COLLABORATION_CONTRACT_VERSION) {
+        errors.push(`Stage collaboration contract requires contract ${STAGE_COLLABORATION_CONTRACT_VERSION}.`);
+    }
+    const frontmatterBranch = stringField(input.frontmatter, 'branch', errors);
+    if (frontmatterBranch && frontmatterBranch !== input.branch && frontmatterBranch !== branch) {
+        errors.push(`Stage collaboration contract branch ${frontmatterBranch} does not match ${input.branch}.`);
+    }
+    const frontmatterStage = stringField(input.frontmatter, 'stage', errors);
+    if (frontmatterStage !== input.stage) {
+        errors.push(`Stage collaboration contract stage ${frontmatterStage} does not match ${input.stage}.`);
+    }
+    const kind = stringField(input.frontmatter, 'kind', errors);
+    if (kind !== 'stage_collaboration_contract') {
+        errors.push(`Stage collaboration contract kind must be stage_collaboration_contract.`);
+    }
+    const producerValue = stringField(input.frontmatter, 'producer', errors);
+    const producer = parseStageCollaborationContractProducer(producerValue, input.workOrder?.stageManager ?? 'spec-manager', errors);
+    if (input.workOrder && producerValue !== input.workOrder.stageManager) {
+        errors.push(`Stage collaboration contract producer ${producerValue || 'none'} does not match ${input.workOrder.stageManager}.`);
+    }
+    const workOrderId = stringField(input.frontmatter, 'workOrderId', errors) || null;
+    if (!input.workOrder) {
+        errors.push('Stage collaboration contract requires an active StageWorkOrder.');
+    }
+    else if (workOrderId !== input.workOrder.workOrderId) {
+        errors.push(`Stage collaboration contract workOrderId ${workOrderId ?? 'none'} does not match ${input.workOrder.workOrderId}.`);
+    }
+    const selectedAgents = stringArrayField(input.frontmatter, 'selectedAgents', errors);
+    const selectedSkills = stringArrayField(input.frontmatter, 'selectedSkills', errors, true);
+    const selectedMaterialPacks = stringArrayField(input.frontmatter, 'selectedMaterialPacks', errors, true);
+    const evidenceContracts = stringArrayField(input.frontmatter, 'evidenceContracts', errors);
+    const checkpointPlan = stringArrayField(input.frontmatter, 'checkpointPlan', errors, true);
+    const writableRefs = stringArrayField(input.frontmatter, 'writableRefs', errors, true).map((ref) => normalizeSafeRuntimeRef(ref, 'writableRefs', errors)).filter((ref) => Boolean(ref));
+    const authorityAttempts = stringArrayField(input.frontmatter, 'authorityAttempts', errors, true);
+    const maxAttempts = numberField(input.frontmatter, 'maxReworkAttempts', errors);
+    const allowAutoWithinStage = booleanField(input.frontmatter, 'allowAutoWithinStage', errors);
+    const allowAutoNextStage = booleanField(input.frontmatter, 'allowAutoNextStage', errors);
+    const authorityCeiling = optionalStringField(input.frontmatter, 'authorityCeiling', errors);
+    if (input.workOrder) {
+        const allowedAgents = new Set(input.workOrder.agentTeam);
+        for (const agent of selectedAgents) {
+            if (!allowedAgents.has(agent)) {
+                errors.push(`Selected agent ${agent} is not exposed by StageWorkOrder.`);
+            }
+        }
+        const requiredAgents = new Set(input.workOrder.agentTeam);
+        for (const agent of requiredAgents) {
+            if (!selectedAgents.includes(agent)) {
+                errors.push(`Selected agents must cover required StageWorkOrder agent ${agent}.`);
+            }
+        }
+        const allowedSkills = new Set([...input.workOrder.requiredCapabilities, ...input.workOrder.optionalCapabilities].map((capability) => `cap.${capability}`));
+        for (const skill of selectedSkills) {
+            if (!allowedSkills.has(skill)) {
+                errors.push(`Selected skill ${skill} is not exposed by StageWorkOrder.`);
+            }
+        }
+        const allowedMaterials = new Set(input.workOrder.materialPackIds);
+        for (const material of selectedMaterialPacks) {
+            if (!allowedMaterials.has(material)) {
+                errors.push(`Selected material pack ${material} is not exposed by StageWorkOrder.`);
+            }
+        }
+        const allowedEvidenceContracts = new Set(expectedStageArtifactContracts(input.workOrder.stage, input.workOrder.requiredOutputKinds));
+        for (const evidenceContract of evidenceContracts) {
+            if (!allowedEvidenceContracts.has(evidenceContract)) {
+                errors.push(`Evidence contract ${evidenceContract} is not accepted by StageWorkOrder.`);
+            }
+        }
+        for (const evidenceContract of allowedEvidenceContracts) {
+            if (!evidenceContracts.includes(evidenceContract)) {
+                errors.push(`Evidence contracts must include ${evidenceContract}.`);
+            }
+        }
+        for (const attempt of authorityAttempts) {
+            if (input.workOrder.forbiddenActions.includes(attempt)) {
+                errors.push(`Authority attempt ${attempt} exceeds StageWorkOrder authority ceiling.`);
+            }
+        }
+        if (authorityCeiling && authorityCeiling !== input.workOrder.authorityCeiling) {
+            errors.push(`Authority ceiling ${authorityCeiling} does not match ${input.workOrder.authorityCeiling}.`);
+        }
+    }
+    if (maxAttempts !== null && maxAttempts < 1) {
+        errors.push('maxReworkAttempts must be greater than zero.');
+    }
+    if (allowAutoWithinStage !== true) {
+        errors.push('allowAutoWithinStage must be true for a validated stage collaboration contract.');
+    }
+    if (allowAutoNextStage !== false) {
+        errors.push('allowAutoNextStage must be false; inter-stage progression is Orchestrator + runtime only.');
+    }
+    for (const writableRef of writableRefs) {
+        if (!isAllowedWritableRef(input.stage, branch, writableRef)) {
+            errors.push(`Writable ref ${writableRef} is outside the ${input.stage} stage writable surface.`);
+        }
+    }
+    return {
+        contractId: stageCollaborationContractId(branch, input.stage, normalizedRef, input.hash),
+        branch,
+        stage: input.stage,
+        ref: normalizedRef,
+        hash: input.hash,
+        contract: contract || STAGE_COLLABORATION_CONTRACT_VERSION,
+        producer,
+        workOrderId,
+        status: errors.length === 0 ? 'validated' : 'rejected',
+        validationErrors: errors,
+        selectedAgents,
+        selectedSkills,
+        selectedMaterialPacks,
+        evidenceContracts,
+        checkpointPlan,
+        reworkPlan: { maxAttempts },
+        permissionProjection: {
+            authorityCeiling: authorityCeiling ?? null,
+            allowAutoWithinStage,
+            allowAutoNextStage,
+            writableRefs
+        },
+        frontmatter: input.frontmatter,
+        registeredAt: input.registeredAt ?? new Date().toISOString()
+    };
+}
+const STAGE_COLLABORATION_CONTRACT_PRODUCERS = [
+    'spec-manager',
+    'plan-manager',
+    'tasks-manager',
+    'verifies-manager',
+    'do-manager',
+    'test-manager',
+    'goal-verify-manager',
+    'ship-manager'
+];
+function parseStageCollaborationContractProducer(value, fallback, errors) {
+    if (STAGE_COLLABORATION_CONTRACT_PRODUCERS.includes(value)) {
+        return value;
+    }
+    errors.push(`Stage collaboration contract producer ${value || 'none'} is unsupported.`);
+    return fallback;
+}
+function isAllowedWritableRef(stage, branch, ref) {
+    if (ref.startsWith(`.sdd/runs/${branch}/${stage}/`)) {
+        return true;
+    }
+    return allowedCanonicalWritableRefs(stage, branch).includes(ref);
+}
+function allowedCanonicalWritableRefs(stage, branch) {
+    if (stage === 'spec')
+        return [`specs/${branch}/spec.md`];
+    if (stage === 'plan')
+        return [`specs/${branch}/plan.md`];
+    if (stage === 'tasks')
+        return [`specs/${branch}/tasks.md`];
+    if (stage === 'verifies')
+        return [`specs/${branch}/verify.md`];
+    if (stage === 'ship')
+        return [`specs/${branch}/release.md`];
+    return [];
+}
+function stringField(frontmatter, key, errors) {
+    const value = frontmatter[key];
+    if (typeof value !== 'string' || value.length === 0) {
+        errors.push(`Stage collaboration contract ${key} must be a non-empty string.`);
+        return '';
+    }
+    return value;
+}
+function optionalStringField(frontmatter, key, errors) {
+    const value = frontmatter[key];
+    if (value === undefined || value === null || value === '') {
+        return null;
+    }
+    if (typeof value !== 'string') {
+        errors.push(`Stage collaboration contract ${key} must be a string.`);
+        return null;
+    }
+    return value;
+}
+function stringArrayField(frontmatter, key, errors, optional = false) {
+    const value = frontmatter[key];
+    if (value === undefined || value === null) {
+        if (!optional) {
+            errors.push(`Stage collaboration contract ${key} is required.`);
+        }
+        return [];
+    }
+    if (!Array.isArray(value) || value.some((item) => typeof item !== 'string' || item.length === 0)) {
+        errors.push(`Stage collaboration contract ${key} must be a string array.`);
+        return [];
+    }
+    return [...value];
+}
+function numberField(frontmatter, key, errors) {
+    const value = frontmatter[key];
+    if (typeof value !== 'number' || !Number.isInteger(value)) {
+        errors.push(`Stage collaboration contract ${key} must be an integer.`);
+        return null;
+    }
+    return value;
+}
+function booleanField(frontmatter, key, errors) {
+    const value = frontmatter[key];
+    if (typeof value !== 'boolean') {
+        errors.push(`Stage collaboration contract ${key} must be a boolean.`);
+        return null;
+    }
+    return value;
+}
+function normalizeSafeRuntimeRef(value, field, errors) {
+    const normalized = normalizePortablePath(value);
+    if (!normalized || normalized === '.' || normalized === '..' || normalized.includes('..')) {
+        errors.push(`Stage collaboration contract ${field} contains unsafe ref ${value}.`);
+        return null;
+    }
+    return normalized;
+}
+function stageCollaborationContractId(branch, stage, ref, hash) {
+    return `stage-collaboration-contract-${createHash('sha256').update([branch, stage, ref, hash].join('\0'), 'utf8').digest('hex').slice(0, 24)}`;
+}
+//# sourceMappingURL=stage-collaboration-contracts.js.map