@agent-teams/engineering-foundation 1.3.3 → 1.4.0

package/dist/capabilities/public-api-compatibility/adapters/inbound/configuration/load-capability-config.d.ts

@@ -1,8 +1,8 @@
-import type { PublicApiCompatibilityPolicy } from "../../../application/model/public-api.js";
+import type { PublicApiCapabilityPolicy } from "../../../application/model/growth-configuration.js";
 import type { PublicApiSchemaAssertion } from "../../schema-validation.js";
 export interface PublicApiConfigurationDependencies {
     readonly readYaml: (consumerRoot: string, configPath: string, phase: string, signal?: AbortSignal) => Promise<unknown>;
     readonly assertSchema: PublicApiSchemaAssertion;
 }
-export declare function loadCapabilityConfig(dependencies: PublicApiConfigurationDependencies, consumerRoot: string, configPath: string, signal?: AbortSignal): Promise<PublicApiCompatibilityPolicy>;
+export declare function loadCapabilityConfig(dependencies: PublicApiConfigurationDependencies, consumerRoot: string, configPath: string, signal?: AbortSignal): Promise<PublicApiCapabilityPolicy>;
 //# sourceMappingURL=load-capability-config.d.ts.map

package/dist/capabilities/public-api-compatibility/adapters/inbound/configuration/load-capability-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-capability-config.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/public-api-compatibility/adapters/inbound/configuration/load-capability-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,0CAA0C,CAAC;AAC7F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAG3E,MAAM,WAAW,kCAAkC;IACjD,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,wBAAwB,CAAC;CACjD;AAED,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,kCAAkC,EAChD,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,4BAA4B,CAAC,CAKvC"}
+{"version":3,"file":"load-capability-config.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/public-api-compatibility/adapters/inbound/configuration/load-capability-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oDAAoD,CAAC;AACpG,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAG3E,MAAM,WAAW,kCAAkC;IACjD,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,wBAAwB,CAAC;CACjD;AAED,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,kCAAkC,EAChD,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,yBAAyB,CAAC,CAgBpC"}

package/dist/capabilities/public-api-compatibility/adapters/inbound/configuration/load-capability-config.js

@@ -1,8 +1,19 @@
-import { readConfigurationHeader, parseCapabilityConfig } from "./parse-capability-config.js";
+import { readPublicApiConfigurationHeader, mapPublicApiConfiguration, assertGrowthReportDestination } from "./parse-growth-config.js";
 export async function loadCapabilityConfig(dependencies, consumerRoot, configPath, signal) {
     const input = await dependencies.readYaml(consumerRoot, configPath, "public-api-compatibility-config", signal);
-    const root = readConfigurationHeader(input);
-    await dependencies.assertSchema("package-public-api-compatibility/v1", input, "public-api-compatibility-config");
-    return parseCapabilityConfig(root);
+    const root = readPublicApiConfigurationHeader(input);
+    const schema = root["schemaVersion"] === 1 ? "package-public-api-compatibility/v1" : "package-public-api-compatibility/v2";
+    await dependencies.assertSchema(schema, input, "public-api-compatibility-config");
+    const policy = mapPublicApiConfiguration(root, configPath);
+    if (policy.schemaVersion === 2) {
+        const phase = "public-api-compatibility-config";
+        const governance = await dependencies.readYaml(consumerRoot, policy.compatibility.governanceConfigPath, phase, signal);
+        await dependencies.assertSchema("governance-architecture-decisions/v1", governance, phase);
+        // Read only the public schema's path projection. Governance still owns all
+        // lifecycle and approval policy; none of these paths confer authority.
+        const paths = governance;
+        assertGrowthReportDestination(policy.sdkGrowth.reportPath, [...paths.adrRoots, paths.index.path, paths.acceptedBaselinePath]);
+    }
+    return policy;
 }
 //# sourceMappingURL=load-capability-config.js.map

package/dist/capabilities/public-api-compatibility/adapters/inbound/configuration/load-capability-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"load-capability-config.js","sourceRoot":"","sources":["../../../../../../src/capabilities/public-api-compatibility/adapters/inbound/configuration/load-capability-config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAO9F,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,YAAgD,EAChD,YAAoB,EACpB,UAAkB,EAClB,MAAoB;IAEpB,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,YAAY,EAAE,UAAU,EAAE,iCAAiC,EAAE,MAAM,CAAC,CAAC;IAC/G,MAAM,IAAI,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,YAAY,CAAC,YAAY,CAAC,qCAAqC,EAAE,KAAK,EAAE,iCAAiC,CAAC,CAAC;IACjH,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC"}
+{"version":3,"file":"load-capability-config.js","sourceRoot":"","sources":["../../../../../../src/capabilities/public-api-compatibility/adapters/inbound/configuration/load-capability-config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gCAAgC,EAAE,yBAAyB,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAOtI,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,YAAgD,EAChD,YAAoB,EACpB,UAAkB,EAClB,MAAoB;IAEpB,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,YAAY,EAAE,UAAU,EAAE,iCAAiC,EAAE,MAAM,CAAC,CAAC;IAC/G,MAAM,IAAI,GAAG,gCAAgC,CAAC,KAAK,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,qCAAqC,CAAC,CAAC,CAAC,qCAAqC,CAAC;IAC3H,MAAM,YAAY,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,iCAAiC,CAAC,CAAC;IAClF,MAAM,MAAM,GAAG,yBAAyB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC3D,IAAI,MAAM,CAAC,aAAa,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,iCAAiC,CAAC;QAChD,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,aAAa,CAAC,oBAAqB,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACxH,MAAM,YAAY,CAAC,YAAY,CAAC,sCAAsC,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;QAC3F,2EAA2E;QAC3E,uEAAuE;QACvE,MAAM,KAAK,GAAG,UAAoG,CAAC;QACnH,6BAA6B,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAChI,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/capabilities/public-api-compatibility/adapters/inbound/configuration/parse-growth-config.d.ts

@@ -0,0 +1,8 @@
+import type { PublicApiCapabilityPolicy } from "../../../application/model/growth-configuration.js";
+export declare function readPublicApiConfigurationHeader(input: unknown): Record<string, unknown>;
+/** Invoked only after the selected closed JSON schema validates the raw data. */
+export declare function mapPublicApiConfiguration(root: Record<string, unknown>, configPath?: string): PublicApiCapabilityPolicy;
+/** Protect both descendants and ancestors: a destination cannot replace a
+ * directory that owns an input, even when the final file does not exist yet. */
+export declare function assertGrowthReportDestination(destination: string, protectedPaths: readonly string[]): void;
+//# sourceMappingURL=parse-growth-config.d.ts.map

package/dist/capabilities/public-api-compatibility/adapters/inbound/configuration/parse-growth-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-growth-config.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/public-api-compatibility/adapters/inbound/configuration/parse-growth-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAA6B,MAAM,oDAAoD,CAAC;AAG/H,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASxF;AAED,iFAAiF;AACjF,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,yBAAyB,CA4BvH;AAED;gFACgF;AAChF,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAI1G"}

package/dist/capabilities/public-api-compatibility/adapters/inbound/configuration/parse-growth-config.js

@@ -0,0 +1,54 @@
+import { configurationInputError, assertConfigurationRepositoryPath } from "../../../application/configuration-input.js";
+import { parseCapabilityConfig } from "./parse-capability-config.js";
+export function readPublicApiConfigurationHeader(input) {
+    if (input === null || typeof input !== "object" || Array.isArray(input)) {
+        configurationInputError("public API compatibility config must be an object.");
+    }
+    const root = input;
+    if (root["schemaVersion"] !== 1 && root["schemaVersion"] !== 2) {
+        configurationInputError("schemaVersion must be 1 or 2.");
+    }
+    return root;
+}
+/** Invoked only after the selected closed JSON schema validates the raw data. */
+export function mapPublicApiConfiguration(root, configPath) {
+    if (root["schemaVersion"] === 1) {
+        return parseCapabilityConfig(root);
+    }
+    const { sdkGrowth: rawGrowth, ...legacy } = root;
+    const compatibility = parseCapabilityConfig({ ...legacy, schemaVersion: 1 });
+    const growth = structuredClone(rawGrowth);
+    const paths = [growth.comparison.trustedBasePath, growth.decisionsPath,
+        ...growth.comparison.released.map((entry) => entry.kind === "released" ? entry.observationPath : entry.trustedHistoryPath)];
+    for (const path of [...paths, growth.reportPath, compatibility.changesetDirectory, compatibility.governanceConfigPath,
+        ...compatibility.packages.flatMap((pkg) => [pkg.packageRoot, pkg.manifestPath, pkg.tsconfigPath, ...pkg.entrypoints.map((entry) => entry.declarationEntryPoint)])]) {
+        assertConfigurationRepositoryPath(path);
+        if (path.length > 300 || path.trim() !== path || path.trim().length === 0 || /^[a-z]:/iu.test(path) || /[\0*?{}[\]]/u.test(path)) {
+            configurationInputError("SDK paths must be normalized nonempty repository-relative regular-file paths.");
+        }
+    }
+    assertGrowthReportDestination(growth.reportPath, [
+        ...paths, ...(configPath === undefined ? [] : [configPath]),
+        "package.json", "tsconfig.json", "tsconfig.base.json", "pnpm-workspace.yaml", "pnpm-lock.yaml", "package-lock.json",
+        "npm-shrinkwrap.json", "yarn.lock", "bun.lock", "bun.lockb",
+        "architecture", ".git", ".github", "node_modules", ".npmrc", ".yarnrc.yml", ".pnp.cjs", ".pnp.loader.mjs",
+        "foundation.config.yaml", "foundation.config.json", "src", "scripts", "tests", compatibility.changesetDirectory, compatibility.governanceConfigPath,
+        compatibility.acceptedDecisionBaselinePath,
+        ...compatibility.packages.flatMap((pkg) => [pkg.packageRoot, pkg.manifestPath, pkg.tsconfigPath,
+            pkg.releasedBaselinePath, ...pkg.entrypoints.map((entry) => entry.declarationEntryPoint)])
+    ].filter((path) => path !== undefined));
+    const names = growth.comparison.released.map((entry) => entry.packageName);
+    if (new Set(names).size !== names.length) {
+        configurationInputError("SDK released package identities must be unique.");
+    }
+    return Object.freeze({ schemaVersion: 2, compatibility, sdkGrowth: Object.freeze({ ...growth, comparison: Object.freeze({ ...growth.comparison,
+                released: Object.freeze([...growth.comparison.released].toSorted((a, b) => a.packageName < b.packageName ? -1 : a.packageName > b.packageName ? 1 : 0)) }) }) });
+}
+/** Protect both descendants and ancestors: a destination cannot replace a
+ * directory that owns an input, even when the final file does not exist yet. */
+export function assertGrowthReportDestination(destination, protectedPaths) {
+    if (protectedPaths.some((path) => destination === path || destination.startsWith(`${path}/`) || path.startsWith(`${destination}/`))) {
+        configurationInputError("SDK report path overlaps a protected input, governance, baseline, lockfile or package path.");
+    }
+}
+//# sourceMappingURL=parse-growth-config.js.map

package/dist/capabilities/public-api-compatibility/adapters/inbound/configuration/parse-growth-config.js.map

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

package/dist/capabilities/public-api-compatibility/adapters/outbound/filesystem/growth-input-context.d.ts

@@ -0,0 +1,18 @@
+import type { GrowthInputContextPort } from "../../../application/ports/growth-input-context.js";
+import type { PublicApiCompatibilityPolicy } from "../../../application/model/public-api.js";
+import type { PublicApiRepository } from "../../../application/ports/public-api-repository.js";
+import type { ChangeFingerprint } from "../../../application/ports/change-fingerprint.js";
+import type { AcceptedDecisionEvidencePort } from "../../../application/ports/accepted-decision-evidence.js";
+import type { PublicApiSchemaAssertion } from "../../schema-validation.js";
+/** Files establish content observations only. No disk record can establish
+ * retained-history, initial-unreleased or owner authority before S3. */
+export declare function createFilesystemGrowthInputContext(input: {
+    readonly consumerRoot: string;
+    readonly policy: PublicApiCompatibilityPolicy;
+}, dependencies: {
+    readonly repository: PublicApiRepository;
+    readonly acceptedDecisionEvidence: AcceptedDecisionEvidencePort;
+    readonly fingerprint: ChangeFingerprint;
+    readonly assertSchema: PublicApiSchemaAssertion;
+}): GrowthInputContextPort;
+//# sourceMappingURL=growth-input-context.d.ts.map

package/dist/capabilities/public-api-compatibility/adapters/outbound/filesystem/growth-input-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"growth-input-context.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/public-api-compatibility/adapters/outbound/filesystem/growth-input-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oDAAoD,CAAC;AAIjG,OAAO,KAAK,EAAE,4BAA4B,EAAqB,MAAM,0CAA0C,CAAC;AAChH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAC;AAC/F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AAC1F,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,0DAA0D,CAAC;AAG7G,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AA8E3E;wEACwE;AACxE,wBAAgB,kCAAkC,CAAC,KAAK,EAAE;IACxD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAC;CAC/C,EAAE,YAAY,EAAE;IACf,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;IACzC,QAAQ,CAAC,wBAAwB,EAAE,4BAA4B,CAAC;IAChE,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,wBAAwB,CAAC;CACjD,GAAG,sBAAsB,CA0EzB"}

package/dist/capabilities/public-api-compatibility/adapters/outbound/filesystem/growth-input-context.js

@@ -0,0 +1,194 @@
+import { GrowthObservationUnavailableError } from "../../../application/model/growth-observation.js";
+import { growthObservationReference, growthUniqueSorted, normalizeGrowthObservation } from "../../../application/policies/normalize-growth-observation.js";
+import { configurationInputError } from "../../../application/configuration-input.js";
+import { mapReleasedBaseline } from "./public-api-baseline-mapper.js";
+import { auditRead } from "./public-api-audit-inputs.js";
+function unavailable(reason) { return { status: "unavailable", reasons: [reason] }; }
+function available(value) { return { status: "available", value }; }
+function historicalObservation(value, missingReason) {
+    if (value === undefined) {
+        return unavailable(missingReason);
+    }
+    try {
+        return available(normalizeGrowthObservation(value));
+    }
+    catch (error) {
+        if (!(error instanceof GrowthObservationUnavailableError)) {
+            throw error;
+        }
+        return unavailable(error.reason);
+    }
+}
+/** Native JSON parsing owns syntax; this iterative token walk preserves object-key
+ * occurrences (including escaped spellings) before any semantic validation. */
+function parseContextJson(text) {
+    const value = JSON.parse(text);
+    const objects = [];
+    for (let index = 0; index < text.length; index += 1) {
+        const token = text[index];
+        if (token === "{") {
+            objects.push(new Set());
+        }
+        else if (token === "[") {
+            objects.push(undefined);
+        }
+        else if (token === "}" || token === "]") {
+            objects.pop();
+        }
+        else if (token === '"') {
+            const start = index;
+            for (index += 1; index < text.length; index += 1) {
+                if (text[index] === "\\") {
+                    index += 1;
+                }
+                else if (text[index] === '"') {
+                    break;
+                }
+            }
+            let next = index + 1;
+            while ([" ", "\t", "\r", "\n"].includes(text[next] ?? "")) {
+                next += 1;
+            }
+            if (text[next] === ":") {
+                const key = JSON.parse(text.slice(start, index + 1));
+                const keys = objects.at(-1);
+                if (keys?.has(key) === true) {
+                    configurationInputError("SDK context input contains duplicate JSON object keys.");
+                }
+                keys?.add(key);
+            }
+        }
+    }
+    return value;
+}
+/** The shared audit reader predates typed failures. Match only its exact known
+ * input failures, inside the read boundary; dependency defects still propagate. */
+function inputUnavailableReason(error, path) {
+    if (!(error instanceof Error)) {
+        return;
+    }
+    if (error.message === "Audit input file budget exhausted." || error.message === "Audit input byte budget exhausted.") {
+        return "growth-input-budget-exhausted";
+    }
+    if ("code" in error && ["ENOENT", "ENOTDIR", "EACCES", "EPERM", "EIO", "ESTALE", "EBUSY", "EMFILE", "ENFILE"].includes(String(error.code))) {
+        return error.code === "ENOENT" ? undefined : "growth-input-unavailable";
+    }
+    if (error.message === `Audit input changed: ${path}.` || error.message === `Audit input is not a regular file: ${path}.`) {
+        return "growth-input-unavailable";
+    }
+    return;
+}
+function rejectVerifiedClaims(input) {
+    const pending = [input];
+    while (pending.length > 0) {
+        const value = pending.pop();
+        if (value !== null && typeof value === "object") {
+            if ("status" in value && value.status === "verified") {
+                configurationInputError("SDK filesystem inputs cannot contain verified authority claims.");
+            }
+            for (const nested of Object.values(value)) {
+                pending.push(nested);
+            }
+        }
+    }
+}
+function closed(input, fields) {
+    if (input === null || typeof input !== "object" || Array.isArray(input)
+        || Object.keys(input).length !== fields.length || fields.some((field) => !Object.hasOwn(input, field))) {
+        configurationInputError(`SDK context requires exactly: ${fields.join(", ")}.`);
+    }
+    return input;
+}
+/** Files establish content observations only. No disk record can establish
+ * retained-history, initial-unreleased or owner authority before S3. */
+export function createFilesystemGrowthInputContext(input, dependencies) {
+    const { consumerRoot, policy } = structuredClone(input);
+    return {
+        async read(rawRequest, cancellation) {
+            const request = structuredClone(rawRequest);
+            const unavailableReasons = new Map();
+            const historicalBudget = { bytes: 0, files: 0 }, candidateBudget = { bytes: 0, files: 0 };
+            async function json(path, budget) {
+                cancellation.throwIfCancelled();
+                let bytes;
+                try {
+                    bytes = await auditRead(consumerRoot, path, budget);
+                }
+                catch (error) {
+                    cancellation.throwIfCancelled();
+                    const reason = inputUnavailableReason(error, path);
+                    if (reason !== undefined) {
+                        unavailableReasons.set(path, reason);
+                        return undefined;
+                    }
+                    if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+                        return undefined;
+                    }
+                    throw error;
+                }
+                cancellation.throwIfCancelled();
+                let value;
+                try {
+                    value = parseContextJson(new TextDecoder("utf-8", { fatal: true }).decode(bytes));
+                }
+                catch (error) {
+                    if (error instanceof SyntaxError || error instanceof TypeError) {
+                        configurationInputError("SDK context input must be valid UTF-8 JSON.");
+                    }
+                    throw error;
+                }
+                rejectVerifiedClaims(value);
+                return value;
+            }
+            const base = await json(request.trustedBasePath, historicalBudget);
+            const trustedBase = historicalObservation(base, unavailableReasons.get(request.trustedBasePath) ?? "growth-base-file-missing");
+            const decisions = await json(request.decisionsPath, candidateBudget);
+            if (decisions !== undefined && !Array.isArray(decisions)) {
+                configurationInputError("SDK decisions must be a JSON array.");
+            }
+            const released = [];
+            for (const row of growthUniqueSorted(request.released, (entry) => entry.packageName)) {
+                cancellation.throwIfCancelled();
+                const selected = policy.packages.find((pkg) => pkg.packageName === row.packageName)
+                    ?? configurationInputError(`SDK release package has no compatibility policy: ${row.packageName}.`);
+                const releaseEvidence = available(await dependencies.repository.readReleaseEvidence(consumerRoot, policy.changesetDirectory, selected, cancellation.signal));
+                if (row.kind === "initial-unreleased") {
+                    const raw = await json(row.trustedHistoryPath, historicalBudget);
+                    if (raw !== undefined) {
+                        const history = closed(raw, ["historyDigest"]);
+                        if (typeof history["historyDigest"] !== "string" || !/^sha256:[a-f0-9]{64}$/u.test(history["historyDigest"])) {
+                            configurationInputError("SDK historyDigest must be a SHA-256 identity.");
+                        }
+                    }
+                    released.push({ packageName: row.packageName, policy: selected, releaseEvidence,
+                        evidence: { kind: "initial-unreleased", history: unavailable(unavailableReasons.get(row.trustedHistoryPath) ?? "growth-initial-history-unverified") } });
+                    continue;
+                }
+                const raw = await json(row.observationPath, historicalBudget);
+                const pair = raw === undefined ? undefined : closed(raw, ["typed", "artifact"]);
+                const missingReason = unavailableReasons.get(row.observationPath) ?? "growth-released-file-missing";
+                async function branch(kind) {
+                    if (pair === undefined) {
+                        return unavailable(missingReason);
+                    }
+                    await dependencies.assertSchema("package-public-api-baseline/v1", pair[kind], "sdk-growth-released-context");
+                    return available(mapReleasedBaseline(pair[kind], selected));
+                }
+                released.push({ packageName: row.packageName, policy: selected, releaseEvidence,
+                    evidence: { kind: "released", typed: await branch("typed"), artifact: await branch("artifact") } });
+            }
+            const accepted = policy.governanceConfigPath === undefined ? { acceptedDecisionIds: [], acceptedDecisionPaths: [] }
+                : await dependencies.acceptedDecisionEvidence.readAcceptedDecisionEvidence({ consumerRoot,
+                    baselinePath: policy.acceptedDecisionBaselinePath, governanceConfigPath: policy.governanceConfigPath,
+                    ...(cancellation.signal === undefined ? {} : { signal: cancellation.signal }) });
+            cancellation.throwIfCancelled();
+            return { trustedBase,
+                trustedBaseReference: trustedBase.status === "available" ? available(growthObservationReference(trustedBase.value, dependencies.fingerprint)) : unavailable("growth-base-reference-missing"),
+                retainedHistory: unavailable("growth-retained-history-unverified"), released, decisions: decisions ?? [],
+                acceptedBreakingDecisions: { acceptedDecisionIds: accepted.acceptedDecisionIds, acceptedDecisionPaths: accepted.acceptedDecisionPaths,
+                    growthDecisionAuthority: unavailable("growth-owner-authority-unverified") },
+                authority: { status: "unverified", reasons: ["growth-filesystem-authority-unverified", ...(decisions === undefined ? [unavailableReasons.get(request.decisionsPath) ?? "growth-decisions-file-missing"] : [])] } };
+        }
+    };
+}
+//# sourceMappingURL=growth-input-context.js.map

package/dist/capabilities/public-api-compatibility/adapters/outbound/filesystem/growth-input-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"growth-input-context.js","sourceRoot":"","sources":["../../../../../../src/capabilities/public-api-compatibility/adapters/outbound/filesystem/growth-input-context.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/public-api-compatibility/adapters/outbound/filesystem/growth-invocation.d.ts

@@ -0,0 +1,15 @@
+import type { GrowthWorkspaceReader } from "../../../application/ports/growth-workspace.js";
+import type { PublicApiFileReader } from "../../../application/ports/public-api-evidence.js";
+import type { GrowthInvocation } from "../../../application/model/growth-observation.js";
+/** Command-boundary identity of the actual source checkpoint and selected build
+ * inputs. These byte identities carry no archive qualification or CI authority. */
+export declare function readGrowthInvocation(consumerRoot: string, inventory: Awaited<ReturnType<GrowthWorkspaceReader["read"]>>, dependencies: {
+    readonly files: PublicApiFileReader;
+    readonly runGit: (args: readonly string[], signal?: AbortSignal) => Promise<{
+        readonly exitCode: number;
+        readonly stdout: string;
+    }>;
+}, signal?: AbortSignal): Promise<GrowthInvocation>;
+/** Early destination validation; publication revalidates under its own fence. */
+export declare function assertGrowthDestination(root: string, path: string): Promise<void>;
+//# sourceMappingURL=growth-invocation.d.ts.map

package/dist/capabilities/public-api-compatibility/adapters/outbound/filesystem/growth-invocation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"growth-invocation.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/public-api-compatibility/adapters/outbound/filesystem/growth-invocation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AAM5F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mDAAmD,CAAC;AAC7F,OAAO,KAAK,EAAgB,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AASvG;mFACmF;AACnF,wBAAsB,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE;IAC5I,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrI,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmElD;AAwBD,iFAAiF;AACjF,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgCvF"}

package/dist/capabilities/public-api-compatibility/adapters/outbound/filesystem/growth-invocation.js

@@ -0,0 +1,173 @@
+import { configurationInputError } from "../../../application/configuration-input.js";
+import { createHash } from "node:crypto";
+import { readFile, readdir, lstat, realpath } from "node:fs/promises";
+import { resolve, join } from "node:path";
+import { Extractor } from "@microsoft/api-extractor";
+import { assertNotCancelled, publicApiInputError, publicApiFileFailure } from "../../../application/policies/public-api-evidence-errors.js";
+import { growthCanonicalJson, normalizeGrowthInvocation } from "../../../application/policies/normalize-growth-observation.js";
+const digest = (bytes) => `sha256:${createHash("sha256").update(bytes).digest("hex")}`;
+function unavailable(reason) {
+    publicApiInputError("SDK_GROWTH_EVIDENCE_INCOMPLETE", reason, "sdk-growth-evidence");
+}
+/** Command-boundary identity of the actual source checkpoint and selected build
+ * inputs. These byte identities carry no archive qualification or CI authority. */
+export async function readGrowthInvocation(consumerRoot, inventory, dependencies, signal) {
+    assertNotCancelled(signal);
+    const git = async (args) => {
+        try {
+            const result = await dependencies.runGit(["-C", consumerRoot, ...args], signal);
+            if (result.exitCode !== 0) {
+                unavailable("Source Git checkpoint is unavailable or changed.");
+            }
+            return result.stdout.trim();
+        }
+        catch (error) {
+            assertNotCancelled(signal);
+            if (error !== null && typeof error === "object" && "code" in error && (typeof error.code === "number" || error.code === "ENOENT")) {
+                unavailable("Source Git checkpoint is unavailable or changed; observe a committed source with its built inputs.");
+            }
+            throw error;
+        }
+    };
+    // The workspace metadata manifest has no package directory. Keep it in the
+    // topology digest; a root export requires a separately bounded source scope.
+    const packageDirectories = inventory.packages.filter((pkg) => pkg.rootPath !== ".");
+    if (inventory.packages.some((pkg) => pkg.rootPath === "." && pkg.exportSurface.explicit)) {
+        unavailable("Root-package exports require an explicit bounded source/report separation.");
+    }
+    const sourceCommit = await git(["rev-parse", "--verify", "HEAD"]);
+    const sourceTree = await git(["rev-parse", "--verify", "HEAD^{tree}"]);
+    await git(["diff", "--quiet", "HEAD", "--"]);
+    if (packageDirectories.length > 0 && await git(["ls-files", "--others", "--exclude-standard", "--", ...packageDirectories.map((pkg) => pkg.rootPath)])) {
+        unavailable("Uncommitted package inputs cannot bind a Git source tree.");
+    }
+    let total = 0;
+    const input = async (path) => {
+        try {
+            const bytes = await dependencies.files.read({ root: consumerRoot, candidate: resolve(consumerRoot, path), maxBytes: 32 * 1024 * 1024 });
+            total += bytes.byteLength;
+            if (total > 32 * 1024 * 1024) {
+                unavailable("SDK invocation input byte budget exhausted.");
+            }
+            return { path, digest: digest(bytes) };
+        }
+        catch (error) {
+            const failure = publicApiFileFailure(error);
+            if (failure !== undefined) {
+                unavailable(`SDK invocation input ${path} is ${failure}.`);
+            }
+            throw error;
+        }
+    };
+    const workspace = await input("pnpm-workspace.yaml");
+    const manifests = await Promise.all(inventory.packages.map((pkg) => input(pkg.manifestPath)));
+    const buildPaths = [];
+    async function buildFiles(path) {
+        for (const entry of await readdir(resolve(consumerRoot, path), { withFileTypes: true })) {
+            if (entry.name === "node_modules" || entry.name === ".git") {
+                continue;
+            }
+            const child = `${path}/${entry.name}`;
+            if (entry.isDirectory()) {
+                await buildFiles(child);
+            }
+            else {
+                buildPaths.push(child);
+            }
+            if (buildPaths.length > 4096) {
+                unavailable("SDK invocation input file budget exhausted.");
+            }
+        }
+    }
+    for (const pkg of packageDirectories) {
+        await buildFiles(pkg.rootPath);
+    }
+    const build = await Promise.all(buildPaths.toSorted().map(input));
+    const lock = await input("pnpm-lock.yaml");
+    const manifestBytes = await readFile(new URL("../../../../../../package.json", import.meta.url));
+    const toolManifest = JSON.parse(manifestBytes.toString("utf8"));
+    const toolArtifactDigest = await distributionDigest(await realpath(new URL("../../../../../../", import.meta.url)), dependencies.files, signal);
+    assertNotCancelled(signal);
+    if (await git(["rev-parse", "--verify", "HEAD"]) !== sourceCommit) {
+        unavailable("Source checkpoint changed during observation.");
+    }
+    await git(["diff", "--quiet", "HEAD", "--"]);
+    return normalizeGrowthInvocation({ repository: await git(["rev-parse", "--show-toplevel"]), sourceCommit, sourceTree,
+        topologyDigest: digest(growthCanonicalJson({ workspace, manifests: manifests.toSorted((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0) })),
+        lockDigest: lock.digest, toolchainDigest: digest(growthCanonicalJson({ node: process.version, extractor: Extractor.version, lock: lock.digest })),
+        artifactDigests: [digest(growthCanonicalJson(build))],
+        tool: { version: toolManifest.version, artifactDigest: toolArtifactDigest, extractorVersion: Extractor.version } });
+}
+async function distributionDigest(root, reader, signal) {
+    const files = [];
+    let total = 0;
+    async function capture(path) {
+        assertNotCancelled(signal);
+        const bytes = await reader.read({ root, candidate: join(root, path), maxBytes: 32 * 1024 * 1024 });
+        total += bytes.byteLength;
+        if (total > 32 * 1024 * 1024 || files.length >= 4096) {
+            unavailable("SDK checker distribution identity budget exhausted.");
+        }
+        files.push({ path, digest: digest(bytes) });
+    }
+    async function visit(path) {
+        for (const entry of await readdir(join(root, path), { withFileTypes: true })) {
+            const child = `${path}/${entry.name}`;
+            if (entry.isDirectory()) {
+                await visit(child);
+            }
+            else {
+                await capture(child);
+            }
+        }
+    }
+    await capture("package.json");
+    await visit("dist");
+    await visit("schemas");
+    return digest(growthCanonicalJson(files.toSorted((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0)));
+}
+/** Early destination validation; publication revalidates under its own fence. */
+export async function assertGrowthDestination(root, path) {
+    const segments = path.split("/");
+    if (path.length === 0 || path.startsWith("/") || segments.some(segment => segment === "." || segment === "..")) {
+        configurationInputError("SDK report destination must be repository-relative and normalized.");
+    }
+    let current = resolve(root);
+    const directories = [current];
+    for (const segment of segments.slice(0, -1)) {
+        current = join(current, segment);
+        directories.push(current);
+    }
+    for (const directory of directories) {
+        let entry;
+        try {
+            entry = await lstat(directory);
+        }
+        catch (error) {
+            if (error instanceof Error && "code" in error && (error.code === "ENOENT" || error.code === "ENOTDIR")) {
+                configurationInputError("SDK report parents must exist as real directories.");
+            }
+            throw error;
+        }
+        // The path is assembled from the validated repository-relative config.
+        // lstat on every parent is the portable identity check: it rejects links
+        // and reparse entries without comparing platform-specific realpath spelling
+        // (`/private` on macOS, `\\?\\` and case on Windows).
+        if (!entry.isDirectory() || entry.isSymbolicLink()) {
+            configurationInputError("SDK report parents must be real contained directories.");
+        }
+    }
+    try {
+        const entry = await lstat(join(root, path));
+        if (!entry.isFile() || entry.isSymbolicLink() || entry.nlink !== 1) {
+            configurationInputError("SDK report destination must be a distinct regular file.");
+        }
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+            return;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=growth-invocation.js.map

package/dist/capabilities/public-api-compatibility/adapters/outbound/filesystem/growth-invocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"growth-invocation.js","sourceRoot":"","sources":["../../../../../../src/capabilities/public-api-compatibility/adapters/outbound/filesystem/growth-invocation.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/public-api-compatibility/adapters/outbound/filesystem/growth-report-writer.d.ts

@@ -0,0 +1,10 @@
+import * as filesystem from "node:fs/promises";
+import type { GrowthReportWriter } from "../../../application/ports/growth-report-writer.js";
+type ReportFilesystem = Pick<typeof filesystem, "lstat" | "open" | "rename" | "unlink">;
+/** Cooperative writers share an exclusive fence. No stale-lock takeover, durable
+ * journal or trust claim. Parent directories must already exist. Node cannot
+ * protect path lookup against a hostile process replacing directory ancestors;
+ * the caller owns isolation from non-cooperating writers (S3). */
+export declare function createFilesystemGrowthReportWriter(consumerRoot: string, fs?: ReportFilesystem): GrowthReportWriter;
+export {};
+//# sourceMappingURL=growth-report-writer.d.ts.map

package/dist/capabilities/public-api-compatibility/adapters/outbound/filesystem/growth-report-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"growth-report-writer.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/public-api-compatibility/adapters/outbound/filesystem/growth-report-writer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAI/C,OAAO,KAAK,EAAgB,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AAE3G,KAAK,gBAAgB,GAAG,IAAI,CAAC,OAAO,UAAU,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAC;AAiCxF;;;kEAGkE;AAClE,wBAAgB,kCAAkC,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,GAAE,gBAA6B,GAAG,kBAAkB,CAyI9H"}