@agent-teams/engineering-foundation 1.0.1 → 1.1.0

package/README.md

@@ -170,3 +170,62 @@ continuing recovery. The one-argument API and CLI are unchanged;
 The current built-in Composition is a testing-only conformance fixture. Product
 package and feature recipes, structured updates, and Nx integration require
 separate capability qualification before they become available.
+
+## Disposable scaffold crash qualification
+
+Developer tests can import `runScaffoldCrashQualification` and the types
+`ScaffoldQualificationPhase`, `ScaffoldQualificationPoint`, and
+`ScaffoldQualificationPhaseCallback` from
+`@agent-teams/engineering-foundation/scaffolding/qualification`.
+This testing-only entrypoint uses the existing production apply dependencies and
+returns the existing `ScaffoldReceipt` for the existing `ScaffoldPlan`.
+The entrypoint also explicitly reexports these canonical types and the types
+referenced by their public signatures. These are the same type declarations as
+the main scaffolding entrypoint; no parallel Plan or Receipt model is introduced.
+Do not import it from production runtime code.
+
+```ts
+import { runScaffoldCrashQualification } from
+  "@agent-teams/engineering-foundation/scaffolding/qualification";
+
+// In a disposable fixture's writer child process, using a publicly planned Plan:
+await runScaffoldCrashQualification(consumerRoot, plan, async point => {
+  if (point.phase === "after-hard-link") process.exit(73);
+});
+```
+
+The callback is required and must be a function; an invalid callback rejects
+with `TypeError` before apply. Every supported event is awaited at its existing
+checkpoint and receives a fresh frozen object containing only `phase`.
+The supported phases are:
+
+- `after-journal-temporary-synced`
+- `after-journal-prepared`
+- `before-operation-authority-recheck`
+- `after-journal-operation-publishing`
+- `after-temporary-synced`
+- `after-hard-link`
+- `after-journal-operation-published`
+- `before-final-authority-recheck`
+- `after-final-verification`
+- `before-journal-quarantine`
+- `after-journal-unlinked`
+
+Events can repeat for operations and journal replacements; this list does not
+promise a universal ordering or one event per phase. Private temporary-written,
+recovery-scope, and unknown future events are excluded. Callback return values
+grant no authority. Throws or rejections follow existing apply error/cleanup
+behavior and do not demonstrate a crash. A normal receipt certifies no crash.
+
+The caller owns the disposable fixture and child process. Run existing public
+`recoverFilesystemScaffold` in a fresh process after exit 73, then check planned
+bytes, production reapply idempotency, and preservation of user-owned drift.
+The first journal temporary cut can fail closed on an orphan Foundation
+transaction temporary; publication temporary-sync and hard-link cuts can require
+bounded manual recovery. A final journal-unlinked cut can yield no recovery
+receipt. Qualification does not promise convergence at every cut.
+
+Callbacks are trusted test code with the caller's Node privileges, not sandboxed
+code. The function does not spawn, kill, retry, recover, or clean up a fixture.
+Exit 73 demonstrates process interruption, not physical power-loss durability;
+existing filesystem and Windows directory-sync limitations still apply.

package/assets/transaction-coordination/historical/document-plan-v1.schema.json

@@ -0,0 +1,162 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-teams.ai/schemas/document-plan/v1",
+  "title": "Document Plan",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "protocolVersion", "compiler", "projectId", "intent", "intentDigest", "authority", "selectedOwner", "identityProjection", "referencedDocuments", "destination", "expectedParent", "destinationPrecondition", "output", "requiredAdapterCapabilities", "diagnostics", "planDigest"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "protocolVersion": { "const": 1 },
+    "compiler": { "$ref": "#/$defs/compiler" },
+    "projectId": { "$ref": "#/$defs/lowerId" },
+    "intent": { "$ref": "https://agent-teams.ai/schemas/document-intent/v1" },
+    "intentDigest": { "$ref": "#/$defs/digest" },
+    "authority": { "$ref": "#/$defs/authority" },
+    "selectedOwner": { "$ref": "#/$defs/selectedOwner" },
+    "identityProjection": { "$ref": "#/$defs/identityProjection" },
+    "referencedDocuments": {
+      "type": "array",
+      "maxItems": 128,
+      "items": { "$ref": "#/$defs/referencedDocument" }
+    },
+    "destination": { "$ref": "#/$defs/repositoryPath" },
+    "expectedParent": { "$ref": "#/$defs/expectedParent" },
+    "destinationPrecondition": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["state"],
+      "properties": { "state": { "const": "absent" } }
+    },
+    "output": { "$ref": "#/$defs/output" },
+    "requiredAdapterCapabilities": {
+      "type": "array",
+      "prefixItems": [{ "const": "create-file-no-replace/v1" }],
+      "minItems": 1,
+      "maxItems": 1
+    },
+    "diagnostics": { "type": "array", "maxItems": 256, "items": { "$ref": "#/$defs/diagnostic" } },
+    "planDigest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": {
+    "lowerId": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[a-z0-9][a-z0-9._/-]*$" },
+    "opaqueId": { "type": "string", "minLength": 1, "maxLength": 214, "pattern": "^[A-Za-z0-9@][A-Za-z0-9@._/-]*$" },
+    "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "semver": { "type": "string", "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*))*))?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$" },
+    "repositoryPath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 512,
+      "pattern": "^(?!.*(?:^|/)\\.{1,2}(?:/|$))(?!.*\\.(?:/|$))(?!.*(?:^|/)(?:[Cc][Oo][Nn]|[Pp][Rr][Nn]|[Aa][Uu][Xx]|[Nn][Uu][Ll]|[Cc][Oo][Mm][1-9]|[Ll][Pp][Tt][1-9])(?:\\.[A-Za-z0-9._@-]*)?(?:/|$))[A-Za-z0-9._@-]{1,255}(?:/[A-Za-z0-9._@-]{1,255})*$"
+    },
+    "repositoryParentPath": {
+      "oneOf": [
+        { "const": "." },
+        { "$ref": "#/$defs/repositoryPath" }
+      ]
+    },
+    "compiler": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "version", "buildIdentity"],
+      "properties": {
+        "id": { "const": "@agent-teams/engineering-foundation" },
+        "version": { "$ref": "#/$defs/semver" },
+        "buildIdentity": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "authoritySource": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "digest", "size"],
+      "properties": {
+        "path": { "$ref": "#/$defs/repositoryPath" },
+        "digest": { "$ref": "#/$defs/digest" },
+        "size": { "type": "integer", "minimum": 1, "maximum": 1048576 }
+      }
+    },
+    "templateAuthoritySource": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "digest", "size"],
+      "properties": {
+        "path": { "$ref": "#/$defs/repositoryPath" },
+        "digest": { "$ref": "#/$defs/digest" },
+        "size": { "type": "integer", "minimum": 1, "maximum": 262144 }
+      }
+    },
+    "authority": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["profile", "metadataSchema", "ownerCatalog", "template"],
+      "properties": {
+        "profile": { "$ref": "#/$defs/authoritySource" },
+        "metadataSchema": { "$ref": "#/$defs/authoritySource" },
+        "ownerCatalog": { "$ref": "#/$defs/authoritySource" },
+        "template": { "$ref": "#/$defs/templateAuthoritySource" }
+      }
+    },
+    "selectedOwner": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "membershipDigest"],
+      "properties": {
+        "id": { "$ref": "#/$defs/opaqueId" },
+        "membershipDigest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "identityProjection": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["entryCount", "digest"],
+      "properties": {
+        "entryCount": { "type": "integer", "minimum": 0, "maximum": 100000 },
+        "digest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "referencedDocument": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "path", "projectionDigest"],
+      "properties": {
+        "id": { "$ref": "#/$defs/opaqueId" },
+        "path": { "$ref": "#/$defs/repositoryPath" },
+        "projectionDigest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "expectedParent": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "state", "ancestry"],
+      "properties": {
+        "path": { "$ref": "#/$defs/repositoryParentPath" },
+        "state": { "const": "directory" },
+        "ancestry": { "const": "real-directories" }
+      }
+    },
+    "output": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["digest", "size", "mode", "mediaType", "contentBase64"],
+      "properties": {
+        "digest": { "$ref": "#/$defs/digest" },
+        "size": { "type": "integer", "minimum": 1, "maximum": 1048576 },
+        "mode": { "const": "0644" },
+        "mediaType": { "const": "text/markdown; charset=utf-8" },
+        "contentBase64": { "type": "string", "minLength": 4, "maxLength": 1398104, "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$" }
+      }
+    },
+    "diagnostic": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ruleId", "severity", "phase", "subject", "message"],
+      "properties": {
+        "ruleId": { "$ref": "#/$defs/opaqueId" },
+        "severity": { "enum": ["error", "info", "warning"] },
+        "phase": { "enum": ["authority", "input", "planning", "policy"] },
+        "subject": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "message": { "type": "string", "minLength": 1, "maxLength": 1000 }
+      }
+    }
+  }
+}

package/dist/capabilities/contract-json-schema-releases/adapters/inbound/configuration/load-capability-config.d.ts

@@ -0,0 +1,7 @@
+import type { JsonSchemaReleasePolicy } from "../../../application/model/json-schema-release.js";
+export interface JsonSchemaConfigurationDependencies {
+    readonly readYaml: (consumerRoot: string, configPath: string, phase: string, signal?: AbortSignal) => Promise<unknown>;
+    readonly assertSchema: (schemaId: "contract-json-schema-releases/v1" | "contract-json-schema-release-baseline/v1", input: unknown, phase: string) => Promise<void>;
+}
+export declare function loadCapabilityConfig(dependencies: JsonSchemaConfigurationDependencies, consumerRoot: string, configPath: string, signal?: AbortSignal): Promise<JsonSchemaReleasePolicy>;
+//# sourceMappingURL=load-capability-config.d.ts.map

package/dist/capabilities/contract-json-schema-releases/adapters/inbound/configuration/load-capability-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-capability-config.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/contract-json-schema-releases/adapters/inbound/configuration/load-capability-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAsC,MAAM,mDAAmD,CAAC;AAIrI,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,QAAQ,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvH,QAAQ,CAAC,YAAY,EAAE,CAAC,QAAQ,EAAE,kCAAkC,GAAG,0CAA0C,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACpK;AAgBD,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,mCAAmC,EACjD,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,uBAAuB,CAAC,CASlC"}

package/dist/capabilities/contract-json-schema-releases/adapters/inbound/configuration/load-capability-config.js

@@ -0,0 +1,21 @@
+import { assertConfigurationNotCancelled } from "../../../application/configuration-input.js";
+import { readConfigurationHeader, readBaselineHeader, parseReleasedBaselinePath, parseCapabilityPolicy, mapReleased } from "./parse-capability-config.js";
+async function loadReleasedBaseline(dependencies, consumerRoot, repositoryPath, signal) {
+    const input = await dependencies.readYaml(consumerRoot, repositoryPath, "json-schema-release-baseline", signal);
+    assertConfigurationNotCancelled(signal);
+    const header = readBaselineHeader(input);
+    await dependencies.assertSchema(header.schemaId, input, "json-schema-release-baseline");
+    assertConfigurationNotCancelled(signal);
+    return mapReleased(header.source);
+}
+export async function loadCapabilityConfig(dependencies, consumerRoot, configPath, signal) {
+    const input = await dependencies.readYaml(consumerRoot, configPath, "json-schema-release-config", signal);
+    assertConfigurationNotCancelled(signal);
+    const header = readConfigurationHeader(input);
+    await dependencies.assertSchema(header.schemaId, input, "json-schema-release-config");
+    assertConfigurationNotCancelled(signal);
+    const baselinePath = parseReleasedBaselinePath(header.source);
+    const released = await loadReleasedBaseline(dependencies, consumerRoot, baselinePath, signal);
+    return parseCapabilityPolicy(header.source, released);
+}
+//# sourceMappingURL=load-capability-config.js.map

package/dist/capabilities/contract-json-schema-releases/adapters/inbound/configuration/load-capability-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-capability-config.js","sourceRoot":"","sources":["../../../../../../src/capabilities/contract-json-schema-releases/adapters/inbound/configuration/load-capability-config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,+BAA+B,EAAE,MAAM,6CAA6C,CAAC;AAC9F,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAO1J,KAAK,UAAU,oBAAoB,CACjC,YAAiD,EACjD,YAAoB,EACpB,cAAsB,EACtB,MAA+B;IAE/B,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,YAAY,EAAE,cAAc,EAAE,8BAA8B,EAAE,MAAM,CAAC,CAAC;IAChH,+BAA+B,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,YAAY,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,8BAA8B,CAAC,CAAC;IACxF,+BAA+B,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,YAAiD,EACjD,YAAoB,EACpB,UAAkB,EAClB,MAAoB;IAEpB,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,YAAY,EAAE,UAAU,EAAE,4BAA4B,EAAE,MAAM,CAAC,CAAC;IAC1G,+BAA+B,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,YAAY,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,4BAA4B,CAAC,CAAC;IACtF,+BAA+B,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,YAAY,GAAG,yBAAyB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9D,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IAC9F,OAAO,qBAAqB,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AACxD,CAAC"}

package/dist/capabilities/contract-json-schema-releases/adapters/inbound/configuration/parse-capability-config.d.ts

@@ -0,0 +1,13 @@
+import type { JsonSchemaReleasePolicy, ReleasedJsonSchemaContractEvidence } from "../../../application/model/json-schema-release.js";
+export declare function mapReleased(value: unknown, field?: string): ReleasedJsonSchemaContractEvidence;
+export declare function readConfigurationHeader(input: unknown): {
+    source: Record<string, unknown>;
+    schemaId: "contract-json-schema-releases/v1";
+};
+export declare function readBaselineHeader(input: unknown): {
+    source: Record<string, unknown>;
+    schemaId: "contract-json-schema-release-baseline/v1";
+};
+export declare function parseReleasedBaselinePath(source: Record<string, unknown>): string;
+export declare function parseCapabilityPolicy(source: Record<string, unknown>, released: ReleasedJsonSchemaContractEvidence): JsonSchemaReleasePolicy;
+//# sourceMappingURL=parse-capability-config.d.ts.map

package/dist/capabilities/contract-json-schema-releases/adapters/inbound/configuration/parse-capability-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-capability-config.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/contract-json-schema-releases/adapters/inbound/configuration/parse-capability-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,uBAAuB,EACvB,kCAAkC,EACnC,MAAM,mDAAmD,CAAC;AA0G3D,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,KAAK,SAAsB,GAC1B,kCAAkC,CAcpC;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO;;;EAGrD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO;;;EAGhD;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAEjF;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,kCAAkC,GAAG,uBAAuB,CAqB5I"}

package/dist/capabilities/contract-json-schema-releases/adapters/inbound/configuration/parse-capability-config.js

@@ -0,0 +1,118 @@
+import { CAPABILITY_CONFIG_SCHEMA_VERSION } from "../../../contract/config.js";
+const SCHEMA_ID_BY_VERSION = Object.freeze({
+    1: "contract-json-schema-releases/v1"
+});
+import { configurationInputError as inputError, assertConfigurationRepositoryPath } from "../../../application/configuration-input.js";
+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 number(value, field) {
+    if (typeof value !== "number") {
+        inputError(`${field} must be a number.`);
+    }
+    return value;
+}
+function configSchemaId(value) {
+    if (value === CAPABILITY_CONFIG_SCHEMA_VERSION) {
+        return SCHEMA_ID_BY_VERSION[value];
+    }
+    inputError(`schemaVersion must be ${CAPABILITY_CONFIG_SCHEMA_VERSION}.`);
+}
+function releasedBaselineSchemaId(value) {
+    if (value === 1) {
+        return "contract-json-schema-release-baseline/v1";
+    }
+    inputError("released baseline schemaVersion must be 1.");
+}
+function list(value, field) {
+    if (!Array.isArray(value)) {
+        inputError(`${field} must be an array.`);
+    }
+    return value;
+}
+function digest(value, field) {
+    return string(value, field);
+}
+function releasedBaselinePath(value) {
+    const repositoryPath = string(value, "releasedBaselinePath");
+    assertConfigurationRepositoryPath(repositoryPath);
+    if (!/\.(?:json|ya?ml)$/u.test(repositoryPath)) {
+        inputError("releasedBaselinePath must name a JSON or YAML file.");
+    }
+    if (!repositoryPath.startsWith("architecture/contracts/")) {
+        inputError("releasedBaselinePath must be inside the release-owned architecture/contracts directory.");
+    }
+    return repositoryPath;
+}
+function mapFixture(value, field) {
+    const source = record(value, field);
+    const expectation = string(source["expectation"], `${field}.expectation`);
+    if (expectation !== "valid" && expectation !== "invalid") {
+        inputError(`${field}.expectation is invalid.`);
+    }
+    return Object.freeze({
+        id: string(source["id"], `${field}.id`),
+        path: string(source["path"], `${field}.path`),
+        schemaId: string(source["schemaId"], `${field}.schemaId`),
+        expectation
+    });
+}
+function mapConsumerEvidence(value, field) {
+    const source = record(value, field);
+    const outcome = string(source["outcome"], `${field}.outcome`);
+    if (outcome !== "passed" && outcome !== "failed") {
+        inputError(`${field}.outcome is invalid.`);
+    }
+    return Object.freeze({
+        consumerId: string(source["consumerId"], `${field}.consumerId`),
+        consumerVersion: string(source["consumerVersion"], `${field}.consumerVersion`),
+        contractId: string(source["contractId"], `${field}.contractId`),
+        contractVersion: string(source["contractVersion"], `${field}.contractVersion`),
+        schemaSetDigest: digest(source["schemaSetDigest"], `${field}.schemaSetDigest`),
+        fixtureCorpusDigest: digest(source["fixtureCorpusDigest"], `${field}.fixtureCorpusDigest`),
+        evidenceDigest: digest(source["evidenceDigest"], `${field}.evidenceDigest`),
+        outcome
+    });
+}
+export function mapReleased(value, field = "released baseline") {
+    const source = record(value, field);
+    return Object.freeze({
+        schemaVersion: number(source["schemaVersion"], `${field}.schemaVersion`),
+        contractId: string(source["contractId"], `${field}.contractId`),
+        publicContractVersion: string(source["publicContractVersion"], `${field}.publicContractVersion`),
+        schemaSetDigest: digest(source["schemaSetDigest"], `${field}.schemaSetDigest`),
+        fixtureCorpusDigest: digest(source["fixtureCorpusDigest"], `${field}.fixtureCorpusDigest`),
+        supportedConsumers: Object.freeze(list(source["supportedConsumers"], `${field}.supportedConsumers`).map((entry, index) => mapConsumerEvidence(entry, `${field}.supportedConsumers[${index}]`)))
+    });
+}
+export function readConfigurationHeader(input) {
+    const source = record(input, "JSON Schema release config");
+    return { source, schemaId: configSchemaId(source["schemaVersion"]) };
+}
+export function readBaselineHeader(input) {
+    const source = record(input, "JSON Schema released baseline");
+    return { source, schemaId: releasedBaselineSchemaId(source["schemaVersion"]) };
+}
+export function parseReleasedBaselinePath(source) {
+    return releasedBaselinePath(source["releasedBaselinePath"]);
+}
+export function parseCapabilityPolicy(source, released) {
+    return Object.freeze({
+        contractId: string(source["contractId"], "contractId"),
+        publicContractVersion: string(source["publicContractVersion"], "publicContractVersion"),
+        schemaPaths: Object.freeze(list(source["schemaPaths"], "schemaPaths").map((entry, index) => string(entry, `schemaPaths[${index}]`))),
+        fixtures: Object.freeze(list(source["fixtures"], "fixtures").map((entry, index) => mapFixture(entry, `fixtures[${index}]`))),
+        released,
+        currentConsumerEvidence: Object.freeze(list(source["currentConsumerEvidence"], "currentConsumerEvidence").map((entry, index) => mapConsumerEvidence(entry, `currentConsumerEvidence[${index}]`)))
+    });
+}
+//# sourceMappingURL=parse-capability-config.js.map

package/dist/capabilities/contract-json-schema-releases/adapters/inbound/configuration/parse-capability-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-capability-config.js","sourceRoot":"","sources":["../../../../../../src/capabilities/contract-json-schema-releases/adapters/inbound/configuration/parse-capability-config.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/contract-json-schema-releases/adapters/outbound/filesystem/ajv-json-schema-release-inspector.d.ts

@@ -1,12 +1,16 @@
+import { type JsonSchemaFileReader } from "../../../api.js";
 import type { JsonSchemaFixture, JsonSchemaInspection } from "../../../application/model/json-schema-release.js";
 import type { JsonSchemaReleaseInspector } from "../../../application/ports/json-schema-release-inspector.js";
-type JsonEvidenceReader = (repositoryPath: string) => Promise<Buffer | undefined>;
+type JsonEvidenceReader = (repositoryPath: string) => Promise<Uint8Array | undefined>;
 export declare class AjvJsonSchemaReleaseInspector implements JsonSchemaReleaseInspector {
+    private readonly files;
     private readonly evidenceReader?;
-    constructor(evidenceReader?: JsonEvidenceReader | undefined);
+    constructor(files: JsonSchemaFileReader, evidenceReader?: JsonEvidenceReader | undefined);
     inspect(input: {
         readonly consumerRoot: string;
         readonly schemaPaths: readonly string[];
+        /** Supplied captured evidence is authoritative; missing bytes must not fall back to disk. */
+        readonly evidenceReader?: (repositoryPath: string) => Promise<Uint8Array | undefined>;
         readonly fixtures: readonly JsonSchemaFixture[];
         readonly requireMixedExpectations?: boolean;
         readonly signal?: AbortSignal;

package/dist/capabilities/contract-json-schema-releases/adapters/outbound/filesystem/ajv-json-schema-release-inspector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ajv-json-schema-release-inspector.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/contract-json-schema-releases/adapters/outbound/filesystem/ajv-json-schema-release-inspector.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAEV,iBAAiB,EAEjB,oBAAoB,EACrB,MAAM,mDAAmD,CAAC;AAC3D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6DAA6D,CAAC;AAoE9G,KAAK,kBAAkB,GAAG,CAAC,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;AAmUlF,qBAAa,6BAA8B,YAAW,0BAA0B;IAClE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;IAA5C,YAA6B,cAAc,CAAC,EAAE,kBAAkB,YAAA,EAAI;IAE9D,OAAO,CAAC,KAAK,EAAE;QACnB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;QACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;QAChD,QAAQ,CAAC,wBAAwB,CAAC,EAAE,OAAO,CAAC;QAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;KAC/B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA0EhC;CACF"}
+{"version":3,"file":"ajv-json-schema-release-inspector.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/contract-json-schema-releases/adapters/outbound/filesystem/ajv-json-schema-release-inspector.ts"],"names":[],"mappings":"AAQA,OAAO,EAML,KAAK,oBAAoB,EAC1B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,KAAK,EAEV,iBAAiB,EAEjB,oBAAoB,EACrB,MAAM,mDAAmD,CAAC;AAC3D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6DAA6D,CAAC;AA2D9G,KAAK,kBAAkB,GAAG,CAAC,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;AAoTtF,qBAAa,6BAA8B,YAAW,0BAA0B;IAE5E,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;IAFlC,YACmB,KAAK,EAAE,oBAAoB,EAC3B,cAAc,CAAC,EAAE,kBAAkB,YAAA,EAClD;IAEE,OAAO,CAAC,KAAK,EAAE;QACnB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;QACxC,6FAA6F;QAC7F,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;QACtF,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;QAChD,QAAQ,CAAC,wBAAwB,CAAC,EAAE,OAAO,CAAC;QAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;KAC/B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA0EhC;CACF"}

package/dist/capabilities/contract-json-schema-releases/adapters/outbound/filesystem/ajv-json-schema-release-inspector.js

@@ -4,22 +4,12 @@ import { resolve } from "node:path";
 import { Ajv2020 } from "ajv/dist/2020.js";
 import addFormats from "ajv-formats";
 import { compareBinaryStrings } from "../../../../../binary-string-comparator.js";
-import { CapabilityInputError } from "../../../../../capability-runtime.js";
-import { ContainedFileReadError, readContainedRegularFile } from "../../../../../filesystem-path-safety.js";
-import { assertNotCancelled, assertRepositoryRelativePath } from "../../../../../strict-yaml.js";
-import { parseStrictJson, StrictJsonError } from "../../../../../strict-json.js";
+import { assertJsonSchemaEvidencePath, assertJsonSchemaInspectionActive, assertJsonSchemaRepositoryPath, jsonSchemaInputError as inputError, rejectJsonSchemaFileFailure } from "../../../api.js";
+import { parseStrictJson, StrictJsonError } from "@agent-teams/repository-mutation/serialization";
 const MAX_JSON_BYTES = 4 * 1024 * 1024;
 const DRAFT_2020_12 = "https://json-schema.org/draft/2020-12/schema";
 const SHA256_DIGEST = /^sha256:[a-f0-9]{64}$/u;
 const FIXTURE_ID = /^[a-z][a-z0-9.-]{1,119}$/u;
-function inputError(code, message) {
-    throw new CapabilityInputError({
-        code,
-        message,
-        phase: "json-schema-release-inspection",
-        retryable: false
-    });
-}
 function hasControlCharacter(value) {
     for (const character of value) {
         const code = character.codePointAt(0);
@@ -60,48 +50,33 @@ function canonicalJson(value) {
     }
     inputError("JSON_SCHEMA_VALUE_INVALID", "JSON evidence contains an unsupported value.");
 }
-async function safeJsonFile(root, repositoryPath, evidenceReader) {
-    assertRepositoryRelativePath(repositoryPath, "json-schema-release-inspection");
-    if (!repositoryPath.endsWith(".json")) {
-        inputError("JSON_SCHEMA_PATH_INVALID", `JSON evidence path must end with .json: ${repositoryPath}.`);
-    }
+async function safeJsonFile(root, repositoryPath, files, evidenceReader) {
+    assertJsonSchemaEvidencePath(repositoryPath);
     let bytes;
     if (evidenceReader !== undefined) {
         const observed = await evidenceReader(repositoryPath);
         if (observed === undefined) {
             inputError("JSON_SCHEMA_FILE_UNAVAILABLE", `JSON evidence is unavailable: ${repositoryPath}.`);
         }
-        if (observed.byteLength > MAX_JSON_BYTES) {
-            inputError("JSON_SCHEMA_FILE_INVALID", `JSON evidence is not a supported file: ${repositoryPath}.`);
-        }
         bytes = observed;
     }
     else {
         try {
-            bytes = await readContainedRegularFile({
+            bytes = await files.read({
                 candidate: resolve(root, repositoryPath),
                 maxBytes: MAX_JSON_BYTES,
                 root
             });
         }
         catch (error) {
-            if (error instanceof ContainedFileReadError) {
-                if (error.failure === "escape") {
-                    inputError("JSON_SCHEMA_PATH_ESCAPE", `JSON evidence escapes the consumer root: ${repositoryPath}.`);
-                }
-                if (error.failure === "symlink") {
-                    inputError("JSON_SCHEMA_SYMLINK_PROHIBITED", `JSON evidence cannot traverse a symbolic link: ${repositoryPath}.`);
-                }
-                if (error.failure === "invalid") {
-                    inputError("JSON_SCHEMA_FILE_INVALID", `JSON evidence is not a supported file: ${repositoryPath}.`);
-                }
-                inputError("JSON_SCHEMA_FILE_UNAVAILABLE", `JSON evidence is unavailable: ${repositoryPath}.`);
-            }
-            throw error;
+            rejectJsonSchemaFileFailure(error, repositoryPath);
         }
     }
+    if (bytes.byteLength > MAX_JSON_BYTES) {
+        inputError("JSON_SCHEMA_FILE_INVALID", `JSON evidence is not a supported file: ${repositoryPath}.`);
+    }
     try {
-        return parseStrictJson(bytes.toString("utf8"));
+        return parseStrictJson(Buffer.from(bytes).toString("utf8"));
     }
     catch (error) {
         if (error instanceof StrictJsonError && error.failure === "duplicate-key") {
@@ -264,7 +239,7 @@ function assertFixtures(fixtures, requireMixedExpectations) {
             inputError("JSON_SCHEMA_FIXTURE_INVALID", "Fixture IDs must be unique normalized identifiers.");
         }
         ids.add(fixture.id);
-        assertRepositoryRelativePath(fixture.path, "json-schema-release-inspection");
+        assertJsonSchemaRepositoryPath(fixture.path);
         const expectation = fixture.expectation;
         if (expectation !== "valid" && expectation !== "invalid") {
             inputError("JSON_SCHEMA_FIXTURE_INVALID", `Fixture expectation is invalid: ${fixture.id}.`);
@@ -283,6 +258,8 @@ function compileSchemas(documents) {
     const ajv = new Ajv2020({
         allErrors: true,
         strict: true,
+        // Open prefix tuples are valid Draft 2020-12, including released scaffold receipts.
+        strictTuples: false,
         validateFormats: true
     });
     addFormats.default(ajv);
@@ -316,12 +293,14 @@ function fixtureCorpusDigest(fixtures, values) {
         .toSorted((left, right) => compareBinaryStrings(left.id, right.id))));
 }
 export class AjvJsonSchemaReleaseInspector {
+    files;
     evidenceReader;
-    constructor(evidenceReader) {
+    constructor(files, evidenceReader) {
+        this.files = files;
         this.evidenceReader = evidenceReader;
     }
     async inspect(input) {
-        assertNotCancelled(input.signal);
+        assertJsonSchemaInspectionActive(input.signal);
         if (input.schemaPaths.length === 0 || input.schemaPaths.length > 1_000) {
             inputError("JSON_SCHEMA_PATHS_INVALID", "Contract must declare between one and 1000 schemas.");
         }
@@ -335,8 +314,8 @@ export class AjvJsonSchemaReleaseInspector {
         }
         const documents = [];
         for (const path of input.schemaPaths.toSorted(compareBinaryStrings)) {
-            assertNotCancelled(input.signal);
-            const value = record(await safeJsonFile(root, path, this.evidenceReader), `schema ${path}`);
+            assertJsonSchemaInspectionActive(input.signal);
+            const value = record(await safeJsonFile(root, path, this.files, input.evidenceReader ?? this.evidenceReader), `schema ${path}`);
             if (value["$schema"] !== DRAFT_2020_12) {
                 inputError("JSON_SCHEMA_DIALECT_INVALID", `Schema must declare JSON Schema draft 2020-12: ${path}.`);
             }
@@ -357,8 +336,8 @@ export class AjvJsonSchemaReleaseInspector {
         const fixtureValues = new Map();
         const fixtureResults = [];
         for (const fixture of input.fixtures.toSorted((left, right) => compareBinaryStrings(left.id, right.id))) {
-            assertNotCancelled(input.signal);
-            const value = await safeJsonFile(root, fixture.path, this.evidenceReader);
+            assertJsonSchemaInspectionActive(input.signal);
+            const value = await safeJsonFile(root, fixture.path, this.files, input.evidenceReader ?? this.evidenceReader);
             fixtureValues.set(fixture.id, value);
             const validate = ajv.getSchema(fixture.schemaId);
             if (validate === undefined) {