@agent-teams/engineering-foundation 0.4.1 → 0.6.0

package/dist/capabilities/governance-architecture-decisions/application/use-cases/resolve-architecture-decision-index-memberships.js

@@ -0,0 +1,50 @@
+import { compareBinaryStrings } from "../../../../binary-string-comparator.js";
+import { normalizeArchitectureDecisionIndexSection } from "../policies/evaluate-architecture-decision-index.js";
+export async function resolveArchitectureDecisionIndexMemberships(input) {
+    if (input.index === undefined) {
+        return Object.freeze([]);
+    }
+    const decisionsByPath = new Map(input.decisions.map((decision) => [decision.document.repositoryPath, decision]));
+    const headings = input.index.headings
+        .filter((heading) => heading.depth === 2)
+        .toSorted((left, right) => left.location.offset - right.location.offset);
+    const references = input.index.references
+        .filter((reference) => reference.kind === "link")
+        .toSorted((left, right) => left.location.offset - right.location.offset);
+    const memberships = new Map();
+    let headingIndex = 0;
+    let section = "";
+    for (const reference of references) {
+        while (headingIndex < headings.length &&
+            (headings[headingIndex]?.location.offset ?? Number.POSITIVE_INFINITY) <
+                reference.location.offset) {
+            section = normalizeArchitectureDecisionIndexSection(headings[headingIndex]?.text ?? "");
+            headingIndex += 1;
+        }
+        const resolution = await input.repository.resolveReference({
+            consumerRoot: input.consumerRoot,
+            rawTarget: reference.rawTarget,
+            ...(input.signal === undefined ? {} : { signal: input.signal }),
+            source: input.index
+        });
+        if (resolution.kind !== "file") {
+            continue;
+        }
+        const decision = decisionsByPath.get(resolution.repositoryPath);
+        if (decision === undefined) {
+            continue;
+        }
+        const current = memberships.get(decision.id) ?? { count: 0, sections: [] };
+        current.count += 1;
+        current.sections.push(section);
+        memberships.set(decision.id, current);
+    }
+    return Object.freeze([...memberships.entries()]
+        .toSorted(([left], [right]) => compareBinaryStrings(left, right))
+        .map(([decisionId, membership]) => Object.freeze({
+        count: membership.count,
+        decisionId,
+        sections: Object.freeze(membership.sections.toSorted())
+    })));
+}
+//# sourceMappingURL=resolve-architecture-decision-index-memberships.js.map

package/dist/capabilities/governance-architecture-decisions/application/use-cases/resolve-architecture-decision-index-memberships.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-architecture-decision-index-memberships.js","sourceRoot":"","sources":["../../../../../src/capabilities/governance-architecture-decisions/application/use-cases/resolve-architecture-decision-index-memberships.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/governance-architecture-decisions/contract/config.d.ts

@@ -0,0 +1,5 @@
+import type { ArchitectureDecisionPolicy } from "../application/model/architecture-decision.js";
+export declare const CAPABILITY_ID: "governance.architecture-decisions";
+export declare const CAPABILITY_CONFIG_SCHEMA_VERSION: 1;
+export declare function loadCapabilityConfig(consumerRoot: string, configPath: string, signal?: AbortSignal): Promise<ArchitectureDecisionPolicy>;
+//# sourceMappingURL=config.d.ts.map

package/dist/capabilities/governance-architecture-decisions/contract/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/governance-architecture-decisions/contract/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,0BAA0B,EAE3B,MAAM,+CAA+C,CAAC;AAEvD,eAAO,MAAM,aAAa,EAAG,mCAA4C,CAAC;AAC1E,eAAO,MAAM,gCAAgC,EAAG,CAAU,CAAC;AAiE3D,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,0BAA0B,CAAC,CAmDrC"}

package/dist/capabilities/governance-architecture-decisions/contract/config.js

@@ -0,0 +1,94 @@
+import { CapabilityInputError } from "../../../capability-runtime.js";
+import { assertSchema } from "../../../schema-catalog.js";
+import { assertRepositoryRelativePath, loadStrictYamlFile } from "../../../strict-yaml.js";
+export const CAPABILITY_ID = "governance.architecture-decisions";
+export const CAPABILITY_CONFIG_SCHEMA_VERSION = 1;
+const STATUSES = ["proposed", "accepted", "superseded"];
+function inputError(message) {
+    throw new CapabilityInputError({
+        code: "ARCHITECTURE_DECISION_GOVERNANCE_CONFIG_INVALID",
+        message,
+        phase: "architecture-decision-governance-config",
+        retryable: false
+    });
+}
+function record(value, field) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        inputError(`${field} must be an object.`);
+    }
+    return value;
+}
+function string(value, field) {
+    if (typeof value !== "string") {
+        inputError(`${field} must be a string.`);
+    }
+    return value;
+}
+function strings(value, field) {
+    if (!Array.isArray(value) || value.some((entry) => typeof entry !== "string")) {
+        inputError(`${field} must be an array of strings.`);
+    }
+    return value;
+}
+function onlyKeys(value, keys, field) {
+    for (const key of Object.keys(value)) {
+        if (!keys.includes(key)) {
+            inputError(`${field} contains unsupported property: ${key}.`);
+        }
+    }
+}
+function pathInside(path, root) {
+    return path === root || path.startsWith(`${root}/`);
+}
+function indexPolicy(value) {
+    const index = record(value, "index");
+    onlyKeys(index, ["path", "sections"], "index");
+    const path = string(index["path"], "index.path");
+    assertRepositoryRelativePath(path, "architecture-decision-governance-config");
+    const sectionInput = record(index["sections"], "index.sections");
+    onlyKeys(sectionInput, STATUSES, "index.sections");
+    const sections = Object.fromEntries(STATUSES.map((status) => [
+        status,
+        string(sectionInput[status], `index.sections.${status}`)
+    ]));
+    if (new Set(Object.values(sections).map((section) => section.trim().toLocaleLowerCase("en-US"))).size !== STATUSES.length) {
+        inputError("index.sections values must be distinct.");
+    }
+    return Object.freeze({ path, sections: Object.freeze(sections) });
+}
+export async function loadCapabilityConfig(consumerRoot, configPath, signal) {
+    const input = await loadStrictYamlFile(consumerRoot, configPath, "architecture-decision-governance-config", signal);
+    await assertSchema("governance-architecture-decisions/v1", input, "architecture-decision-governance-config");
+    const root = record(input, "architecture decision governance config");
+    onlyKeys(root, ["schemaVersion", "adrRoots", "index", "acceptedBaselinePath"], "config");
+    if (root["schemaVersion"] !== CAPABILITY_CONFIG_SCHEMA_VERSION) {
+        inputError(`schemaVersion must be ${CAPABILITY_CONFIG_SCHEMA_VERSION}.`);
+    }
+    const adrRoots = strings(root["adrRoots"], "adrRoots");
+    if (adrRoots.length === 0) {
+        inputError("adrRoots must not be empty.");
+    }
+    const distinctRoots = new Set();
+    for (const adrRoot of adrRoots) {
+        assertRepositoryRelativePath(adrRoot, "architecture-decision-governance-config");
+        if (distinctRoots.has(adrRoot)) {
+            inputError(`adrRoots contains a duplicate path: ${adrRoot}.`);
+        }
+        distinctRoots.add(adrRoot);
+    }
+    const index = indexPolicy(root["index"]);
+    if (!adrRoots.some((adrRoot) => pathInside(index.path, adrRoot))) {
+        inputError("index.path must be inside one configured adrRoots directory.");
+    }
+    const acceptedBaselinePath = string(root["acceptedBaselinePath"], "acceptedBaselinePath");
+    assertRepositoryRelativePath(acceptedBaselinePath, "architecture-decision-governance-config");
+    if (acceptedBaselinePath !== "architecture/decisions/accepted-decisions.json") {
+        inputError("acceptedBaselinePath must use the stable architecture/decisions/accepted-decisions.json anchor.");
+    }
+    return Object.freeze({
+        acceptedBaselinePath,
+        adrRoots: Object.freeze([...adrRoots].toSorted()),
+        index
+    });
+}
+//# sourceMappingURL=config.js.map

package/dist/capabilities/governance-architecture-decisions/contract/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../src/capabilities/governance-architecture-decisions/contract/config.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/governance-architecture-decisions/module.d.ts

@@ -0,0 +1,26 @@
+import { type CapabilityDefinition } from "../../capability-runtime.js";
+import { ARCHITECTURE_DECISION_GOVERNANCE_RULES_BY_ID } from "./application/rules.js";
+export { ARCHITECTURE_DECISION_GOVERNANCE_RULES_BY_ID };
+export interface AcceptedArchitectureDecisionEvidence {
+    readonly acceptedDecisionIds: readonly `ADR-${string}`[];
+    readonly acceptedDecisionPaths: readonly string[];
+}
+export declare function promoteArchitectureDecisionBaseline(input: {
+    readonly consumerRoot: string;
+    readonly configPath: string;
+    readonly signal?: AbortSignal;
+}): Promise<import("./application/use-cases/promote-architecture-decision-baseline.js").ArchitectureDecisionBaselinePromotion>;
+/**
+ * Provides a narrow, validated view of accepted ADR history to another
+ * capability. The caller receives only stable IDs and immutable historical
+ * paths; the governance catalog, baseline, immutable digests, and lifecycle
+ * validation remain owned here.
+ */
+export declare function readAcceptedArchitectureDecisionEvidence(input: {
+    readonly baselinePath: string;
+    readonly configPath: string;
+    readonly consumerRoot: string;
+    readonly signal?: AbortSignal;
+}): Promise<AcceptedArchitectureDecisionEvidence>;
+export declare function createArchitectureDecisionGovernanceCapability(): CapabilityDefinition;
+//# sourceMappingURL=module.d.ts.map

package/dist/capabilities/governance-architecture-decisions/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/capabilities/governance-architecture-decisions/module.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,oBAAoB,EAE1B,MAAM,6BAA6B,CAAC;AAKrC,OAAO,EAAE,4CAA4C,EAAE,MAAM,wBAAwB,CAAC;AAYtF,OAAO,EAAE,4CAA4C,EAAE,CAAC;AAExD,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,mBAAmB,EAAE,SAAS,OAAO,MAAM,EAAE,EAAE,CAAC;IACzD,QAAQ,CAAC,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAC;CACnD;AAUD,wBAAsB,mCAAmC,CAAC,KAAK,EAAE;IAC/D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B,8HAcA;AAED;;;;;GAKG;AACH,wBAAsB,wCAAwC,CAAC,KAAK,EAAE;IACpE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B,GAAG,OAAO,CAAC,oCAAoC,CAAC,CAwEhD;AAED,wBAAgB,8CAA8C,IAAI,oBAAoB,CAgDrF"}

package/dist/capabilities/governance-architecture-decisions/module.js

@@ -0,0 +1,136 @@
+import { CapabilityInputError, capabilityReport } from "../../capability-runtime.js";
+import { FilesystemMarkdownRepository } from "../../documentation-observation/adapters/outbound/filesystem/filesystem-markdown-repository.js";
+import { NodeArchitectureDecisionFingerprint } from "./adapters/outbound/crypto/node-architecture-decision-fingerprint.js";
+import { FilesystemArchitectureDecisionBaselineRepository } from "./adapters/outbound/filesystem/filesystem-architecture-decision-baseline-repository.js";
+import { parseAcceptedArchitectureDecisionBaseline } from "./application/policies/accepted-architecture-decision-baseline.js";
+import { ARCHITECTURE_DECISION_GOVERNANCE_RULES_BY_ID } from "./application/rules.js";
+import { analyzeArchitectureDecisionEvidence, analyzeArchitectureDecisions } from "./application/use-cases/analyze-architecture-decisions.js";
+import { promoteArchitectureDecisionBaseline as promoteBaseline } from "./application/use-cases/promote-architecture-decision-baseline.js";
+import { CAPABILITY_CONFIG_SCHEMA_VERSION, CAPABILITY_ID, loadCapabilityConfig } from "./contract/config.js";
+export { ARCHITECTURE_DECISION_GOVERNANCE_RULES_BY_ID };
+function createDependencies() {
+    return Object.freeze({
+        baselineRepository: new FilesystemArchitectureDecisionBaselineRepository(),
+        fingerprint: new NodeArchitectureDecisionFingerprint(),
+        markdownRepository: new FilesystemMarkdownRepository()
+    });
+}
+export async function promoteArchitectureDecisionBaseline(input) {
+    const policy = await loadCapabilityConfig(input.consumerRoot, input.configPath, input.signal);
+    return promoteBaseline({
+        consumerRoot: input.consumerRoot,
+        policy,
+        ...(input.signal === undefined ? {} : { signal: input.signal })
+    }, createDependencies());
+}
+/**
+ * Provides a narrow, validated view of accepted ADR history to another
+ * capability. The caller receives only stable IDs and immutable historical
+ * paths; the governance catalog, baseline, immutable digests, and lifecycle
+ * validation remain owned here.
+ */
+export async function readAcceptedArchitectureDecisionEvidence(input) {
+    const dependencies = createDependencies();
+    const policy = await loadCapabilityConfig(input.consumerRoot, input.configPath, input.signal);
+    if (policy.acceptedBaselinePath !== input.baselinePath) {
+        throw new CapabilityInputError({
+            code: "ARCHITECTURE_DECISION_EVIDENCE_BASELINE_MISMATCH",
+            message: "Accepted ADR evidence must use the baseline configured by architecture decision governance.",
+            phase: "architecture-decision-evidence",
+            retryable: false
+        });
+    }
+    const analysis = await analyzeArchitectureDecisionEvidence({
+        consumerRoot: input.consumerRoot,
+        policy,
+        ...(input.signal === undefined ? {} : { signal: input.signal })
+    }, dependencies);
+    if (analysis.diagnostics.length > 0) {
+        const subjects = analysis.diagnostics
+            .map((diagnostic) => diagnostic.subject)
+            .toSorted()
+            .slice(0, 3)
+            .join(", ");
+        throw new CapabilityInputError({
+            code: "ARCHITECTURE_DECISION_EVIDENCE_INVALID",
+            message: `Accepted ADR evidence requires a valid immutable governance catalog${subjects.length === 0 ? "." : `: ${subjects}.`}`,
+            phase: "architecture-decision-evidence",
+            retryable: false
+        });
+    }
+    const baseline = analysis.baseline;
+    const parsed = baseline.kind === "valid"
+        ? parseAcceptedArchitectureDecisionBaseline(baseline.value)
+        : undefined;
+    if (parsed === undefined) {
+        throw new CapabilityInputError({
+            code: "ARCHITECTURE_DECISION_EVIDENCE_INVALID",
+            message: "Accepted ADR evidence baseline was invalid while resolving governance evidence.",
+            phase: "architecture-decision-evidence",
+            retryable: false
+        });
+    }
+    const baselineById = new Map(parsed.decisions.map((entry) => [entry.id, entry]));
+    const acceptedDecisions = analysis.decisions
+        .filter((decision) => decision.status === "accepted")
+        .map((decision) => {
+        const baselineEntry = baselineById.get(decision.id);
+        if (baselineEntry === undefined ||
+            baselineEntry.path !== decision.document.repositoryPath) {
+            throw new CapabilityInputError({
+                code: "ARCHITECTURE_DECISION_EVIDENCE_INVALID",
+                message: `Accepted ADR ${decision.id} is not represented by the validated immutable governance baseline.`,
+                phase: "architecture-decision-evidence",
+                retryable: false
+            });
+        }
+        return Object.freeze({ id: decision.id, path: baselineEntry.path });
+    });
+    return Object.freeze({
+        acceptedDecisionIds: Object.freeze(acceptedDecisions.map((decision) => decision.id)),
+        acceptedDecisionPaths: Object.freeze(acceptedDecisions.map((decision) => decision.path))
+    });
+}
+export function createArchitectureDecisionGovernanceCapability() {
+    return Object.freeze({
+        configSchemaVersion: CAPABILITY_CONFIG_SCHEMA_VERSION,
+        id: CAPABILITY_ID,
+        async run(invocation) {
+            try {
+                const dependencies = createDependencies();
+                const policy = await loadCapabilityConfig(invocation.consumerRoot, invocation.configPath, invocation.signal);
+                return capabilityReport({
+                    capabilityConfigSchemaVersion: CAPABILITY_CONFIG_SCHEMA_VERSION,
+                    capabilityId: CAPABILITY_ID,
+                    diagnostics: await analyzeArchitectureDecisions({
+                        consumerRoot: invocation.consumerRoot,
+                        policy,
+                        ...(invocation.signal === undefined ? {} : { signal: invocation.signal })
+                    }, dependencies)
+                });
+            }
+            catch (error) {
+                if (error instanceof CapabilityInputError) {
+                    return capabilityReport({
+                        capabilityConfigSchemaVersion: CAPABILITY_CONFIG_SCHEMA_VERSION,
+                        capabilityId: CAPABILITY_ID,
+                        outcome: error.problem.code === "EXECUTION_CANCELLED" ? "cancelled" : "invalid-input",
+                        problem: error.problem
+                    });
+                }
+                return capabilityReport({
+                    capabilityConfigSchemaVersion: CAPABILITY_CONFIG_SCHEMA_VERSION,
+                    capabilityId: CAPABILITY_ID,
+                    outcome: "failed",
+                    problem: {
+                        code: "CAPABILITY_EXECUTION_FAILED",
+                        message: "Architecture decision governance capability execution failed.",
+                        phase: "architecture-decision-governance-execution",
+                        retryable: false
+                    }
+                });
+            }
+        }
+    });
+}
+//# sourceMappingURL=module.js.map

package/dist/capabilities/governance-architecture-decisions/module.js.map

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

package/dist/capabilities/property-testing-standard/contract/deterministic-seed-bank.d.ts

@@ -0,0 +1,27 @@
+export interface DeterministicSeedBank {
+    readonly schemaVersion: 1;
+    readonly propertyId: string;
+    readonly numRuns: number;
+    readonly seeds: readonly number[];
+}
+export interface PropertyReplayEvidence {
+    readonly schemaVersion: 1;
+    readonly propertyId: string;
+    readonly seed: number;
+    readonly numRuns: number;
+    readonly path?: string;
+    readonly counterexampleDigest?: `sha256:${string}`;
+}
+export interface FastCheckParameters {
+    readonly seed: number;
+    readonly numRuns: number;
+    readonly path?: string;
+}
+export declare class PropertyTestingEvidenceError extends Error {
+    readonly code: "PROPERTY_TESTING_EVIDENCE_INVALID";
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare function normalizeDeterministicSeedBank(input: DeterministicSeedBank): DeterministicSeedBank;
+export declare function normalizePropertyReplayEvidence(input: PropertyReplayEvidence): PropertyReplayEvidence;
+export declare function createFastCheckParameters(bank: DeterministicSeedBank, seed: number, replay?: PropertyReplayEvidence): FastCheckParameters;
+//# sourceMappingURL=deterministic-seed-bank.d.ts.map

package/dist/capabilities/property-testing-standard/contract/deterministic-seed-bank.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deterministic-seed-bank.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/property-testing-standard/contract/deterministic-seed-bank.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,oBAAoB,CAAC,EAAE,UAAU,MAAM,EAAE,CAAC;CACpD;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,IAAI,EAAG,mCAAmC,CAAU;IAE7D,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAGlD;CACF;AAiCD,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,qBAAqB,GAC3B,qBAAqB,CAyBvB;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,sBAAsB,GAC5B,sBAAsB,CA0BxB;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,qBAAqB,EAC3B,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,sBAAsB,GAC9B,mBAAmB,CAsBrB"}

package/dist/capabilities/property-testing-standard/contract/deterministic-seed-bank.js

@@ -0,0 +1,109 @@
+const PROPERTY_ID = /^[a-z][a-z0-9.-]{1,159}$/u;
+const REPLAY_PATH = /^[0-9:._-]{1,1024}$/u;
+const SHA256_DIGEST = /^sha256:[a-f0-9]{64}$/u;
+const MIN_SEED = -2_147_483_648;
+const MAX_SEED = 2_147_483_647;
+export class PropertyTestingEvidenceError extends Error {
+    code = "PROPERTY_TESTING_EVIDENCE_INVALID";
+    constructor(message, options) {
+        super(message, options);
+        this.name = "PropertyTestingEvidenceError";
+    }
+}
+function inputError(message) {
+    throw new PropertyTestingEvidenceError(message);
+}
+function readSchemaVersion(input) {
+    return Reflect.get(input, "schemaVersion");
+}
+function assertPropertyId(value) {
+    if (!PROPERTY_ID.test(value)) {
+        inputError("Property IDs must be normalized stable identifiers.");
+    }
+}
+function assertSeed(value, field) {
+    if (typeof value !== "number" ||
+        !Number.isInteger(value) ||
+        value < MIN_SEED ||
+        value > MAX_SEED) {
+        inputError(`${field} must be a signed 32-bit integer.`);
+    }
+}
+function assertNumRuns(value, field) {
+    if (!Number.isInteger(value) || value < 1 || value > 1_000_000) {
+        inputError(`${field} must be an integer between 1 and 1000000.`);
+    }
+}
+export function normalizeDeterministicSeedBank(input) {
+    if (readSchemaVersion(input) !== 1) {
+        inputError("Seed bank schemaVersion is unsupported.");
+    }
+    assertPropertyId(input.propertyId);
+    assertNumRuns(input.numRuns, "seed bank numRuns");
+    if (!Array.isArray(input.seeds) || input.seeds.length === 0 || input.seeds.length > 256) {
+        inputError("Seed bank must contain between one and 256 seeds.");
+    }
+    const candidates = input.seeds;
+    const seeds = candidates
+        .map((seed, index) => {
+        assertSeed(seed, `seed bank seeds[${index}]`);
+        return seed;
+    })
+        .toSorted((left, right) => left - right);
+    if (new Set(seeds).size !== seeds.length) {
+        inputError("Seed bank cannot contain duplicate seeds.");
+    }
+    return Object.freeze({
+        schemaVersion: 1,
+        propertyId: input.propertyId,
+        numRuns: input.numRuns,
+        seeds: Object.freeze(seeds)
+    });
+}
+export function normalizePropertyReplayEvidence(input) {
+    if (readSchemaVersion(input) !== 1) {
+        inputError("Replay evidence schemaVersion is unsupported.");
+    }
+    assertPropertyId(input.propertyId);
+    assertSeed(input.seed, "replay seed");
+    assertNumRuns(input.numRuns, "replay numRuns");
+    if (input.path !== undefined && !REPLAY_PATH.test(input.path)) {
+        inputError("Replay path contains unsupported characters.");
+    }
+    if (input.counterexampleDigest !== undefined &&
+        !SHA256_DIGEST.test(input.counterexampleDigest)) {
+        inputError("Counterexample digest must be a lowercase sha256 digest.");
+    }
+    return Object.freeze({
+        schemaVersion: 1,
+        propertyId: input.propertyId,
+        seed: input.seed,
+        numRuns: input.numRuns,
+        ...(input.path === undefined ? {} : { path: input.path }),
+        ...(input.counterexampleDigest === undefined
+            ? {}
+            : { counterexampleDigest: input.counterexampleDigest })
+    });
+}
+export function createFastCheckParameters(bank, seed, replay) {
+    const normalizedBank = normalizeDeterministicSeedBank(bank);
+    assertSeed(seed, "selected seed");
+    if (!normalizedBank.seeds.includes(seed)) {
+        inputError("Selected seed is not part of the declared seed bank.");
+    }
+    if (replay === undefined) {
+        return Object.freeze({ seed, numRuns: normalizedBank.numRuns });
+    }
+    const normalizedReplay = normalizePropertyReplayEvidence(replay);
+    if (normalizedReplay.propertyId !== normalizedBank.propertyId ||
+        normalizedReplay.seed !== seed ||
+        normalizedReplay.numRuns !== normalizedBank.numRuns) {
+        inputError("Replay evidence must bind to the same property, seed, and numRuns.");
+    }
+    return Object.freeze({
+        seed,
+        numRuns: normalizedBank.numRuns,
+        ...(normalizedReplay.path === undefined ? {} : { path: normalizedReplay.path })
+    });
+}
+//# sourceMappingURL=deterministic-seed-bank.js.map

package/dist/capabilities/property-testing-standard/contract/deterministic-seed-bank.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deterministic-seed-bank.js","sourceRoot":"","sources":["../../../../src/capabilities/property-testing-standard/contract/deterministic-seed-bank.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/public-api-compatibility/adapters/outbound/api-extractor/link-staged-package-node-modules.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Keeps package-local resolution intact without copying dependencies into the
+ * snapshot. A sibling stage has the same relative depth as the source package.
+ */
+export declare function linkStagedNodeModules(input: {
+    readonly sourceDirectory: string;
+    readonly stagedDirectory: string;
+}): Promise<void>;
+//# sourceMappingURL=link-staged-package-node-modules.d.ts.map

package/dist/capabilities/public-api-compatibility/adapters/outbound/api-extractor/link-staged-package-node-modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-staged-package-node-modules.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/public-api-compatibility/adapters/outbound/api-extractor/link-staged-package-node-modules.ts"],"names":[],"mappings":"AAuBA;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE;IACjD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BhB"}

package/dist/capabilities/public-api-compatibility/adapters/outbound/api-extractor/link-staged-package-node-modules.js

@@ -0,0 +1,45 @@
+import { stat, symlink } from "node:fs/promises";
+import { join } from "node:path";
+import { CapabilityInputError } from "../../../../../capability-runtime.js";
+function inputError(code, message) {
+    throw new CapabilityInputError({
+        code,
+        message,
+        phase: "public-api-extraction",
+        retryable: false
+    });
+}
+function isMissingPath(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        error.code === "ENOENT");
+}
+/**
+ * Keeps package-local resolution intact without copying dependencies into the
+ * snapshot. A sibling stage has the same relative depth as the source package.
+ */
+export async function linkStagedNodeModules(input) {
+    const sourceNodeModules = join(input.sourceDirectory, "node_modules");
+    try {
+        if (!(await stat(sourceNodeModules)).isDirectory()) {
+            inputError("PUBLIC_API_PATH_INVALID", "Public API package node_modules is not a directory.");
+        }
+    }
+    catch (error) {
+        if (error instanceof CapabilityInputError) {
+            throw error;
+        }
+        if (isMissingPath(error)) {
+            return;
+        }
+        inputError("PUBLIC_API_PATH_UNAVAILABLE", "Public API package node_modules is unavailable.");
+    }
+    try {
+        await symlink(sourceNodeModules, join(input.stagedDirectory, "node_modules"), process.platform === "win32" ? "junction" : "dir");
+    }
+    catch {
+        inputError("PUBLIC_API_EXTRACTION_FAILED", "Unable to link package-local dependencies into the staged package.");
+    }
+}
+//# sourceMappingURL=link-staged-package-node-modules.js.map

package/dist/capabilities/public-api-compatibility/adapters/outbound/api-extractor/link-staged-package-node-modules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-staged-package-node-modules.js","sourceRoot":"","sources":["../../../../../../src/capabilities/public-api-compatibility/adapters/outbound/api-extractor/link-staged-package-node-modules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAE5E,SAAS,UAAU,CAAC,IAAY,EAAE,OAAe;IAC/C,MAAM,IAAI,oBAAoB,CAAC;QAC7B,IAAI;QACJ,OAAO;QACP,KAAK,EAAE,uBAAuB;QAC9B,SAAS,EAAE,KAAK;KACjB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,KAAK,CAAC,IAAI,KAAK,QAAQ,CACxB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,KAG3C;IACC,MAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;IACtE,IAAI,CAAC;QACH,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;YACnD,UAAU,CAAC,yBAAyB,EAAE,qDAAqD,CAAC,CAAC;QAC/F,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,oBAAoB,EAAE,CAAC;YAC1C,MAAM,KAAK,CAAC;QACd,CAAC;QACD,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO;QACT,CAAC;QACD,UAAU,CAAC,6BAA6B,EAAE,iDAAiD,CAAC,CAAC;IAC/F,CAAC;IACD,IAAI,CAAC;QACH,MAAM,OAAO,CACX,iBAAiB,EACjB,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,cAAc,CAAC,EAC3C,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAClD,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,UAAU,CACR,8BAA8B,EAC9B,oEAAoE,CACrE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/capabilities/public-api-compatibility/adapters/outbound/api-extractor/microsoft-public-api-extractor.d.ts

@@ -1,4 +1,4 @@
-import type { PublicApiPackagePolicy, PublicApiSnapshot } from "../../../application/model/public-api.js";
+import { type PublicApiPackagePolicy, type PublicApiSnapshot } from "../../../application/model/public-api.js";
 import type { PublicApiExtractor } from "../../../application/ports/public-api-extractor.js";
 export declare class MicrosoftPublicApiExtractor implements PublicApiExtractor {
     extract(consumerRoot: string, policy: PublicApiPackagePolicy, packageVersion: string, signal?: AbortSignal): Promise<PublicApiSnapshot>;

package/dist/capabilities/public-api-compatibility/adapters/outbound/api-extractor/microsoft-public-api-extractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"microsoft-public-api-extractor.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/public-api-compatibility/adapters/outbound/api-extractor/microsoft-public-api-extractor.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAEV,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AAsE7F,qBAAa,2BAA4B,YAAW,kBAAkB;IAC9D,OAAO,CACX,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,sBAAsB,EAC9B,cAAc,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAkH5B;CACF"}
+{"version":3,"file":"microsoft-public-api-extractor.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/public-api-compatibility/adapters/outbound/api-extractor/microsoft-public-api-extractor.ts"],"names":[],"mappings":"AAmBA,OAAO,EAML,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACvB,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AA8N7F,qBAAa,2BAA4B,YAAW,kBAAkB;IAC9D,OAAO,CACX,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,sBAAsB,EAC9B,cAAc,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAuF5B;CACF"}