@agent-teams/engineering-foundation 1.3.3 → 1.4.0

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

@@ -0,0 +1,238 @@
+import { createHash, randomUUID } from "node:crypto";
+import { constants } from "node:fs";
+import * as filesystem from "node:fs/promises";
+import { dirname, join, resolve, sep } from "node:path";
+import { GrowthReportWriteError } from "../../../application/ports/growth-report-writer.js";
+const maximumBytes = 32 * 1024 * 1024;
+const noFollow = process.platform === "win32" ? 0 : constants.O_NOFOLLOW | constants.O_NONBLOCK;
+function digest(bytes) {
+    return `sha256:${createHash("sha256").update(bytes).digest("hex")}`;
+}
+function code(error) {
+    return error instanceof Error && "code" in error && typeof error.code === "string" ? error.code : undefined;
+}
+function conflict(reason) { throw new GrowthReportWriteError("conflict", reason); }
+function validateRequest(bytes, expectedPreimage) {
+    if (bytes.length > maximumBytes || (expectedPreimage !== undefined && expectedPreimage !== null && !/^sha256:[a-f0-9]{64}$/u.test(expectedPreimage))) {
+        conflict("growth-report-request-invalid");
+    }
+}
+function attachCleanupFailures(primary, failures) {
+    // Preserve cancellation identity, even for immutable or non-Error reasons.
+    if (primary instanceof Error && Object.isExtensible(primary) &&
+        Object.getOwnPropertyDescriptor(primary, "cause")?.configurable !== false) {
+        Object.defineProperty(primary, "cause", {
+            value: new AggregateError([...(primary.cause === undefined ? [] : [primary.cause]), ...failures], "Primary failure with cleanup failures"),
+            configurable: true, writable: true
+        });
+    }
+}
+async function closeHandle(handle, failure) {
+    try {
+        await handle?.close();
+    }
+    catch (error) {
+        if (failure === undefined) {
+            throw error;
+        }
+        attachCleanupFailures(failure, [error]);
+    }
+}
+/** 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 function createFilesystemGrowthReportWriter(consumerRoot, fs = filesystem) {
+    async function parents(path) {
+        if (path.length === 0 || path.includes("\\") || path.split("/").some((part) => part === "" || part === "." || part === ".." || part.includes(":"))) {
+            conflict("growth-report-path-invalid");
+        }
+        const root = resolve(consumerRoot), target = resolve(root, path);
+        if (!target.startsWith(`${root}${sep}`)) {
+            conflict("growth-report-outside-root");
+        }
+        let current = root;
+        for (const part of ["", ...path.split("/").slice(0, -1)]) {
+            current = join(current, part);
+            const stat = await fs.lstat(current);
+            // lstat rejects symlink/reparse parents without relying on platform
+            // specific realpath spellings (`/private`, `\\?\\`, or case changes).
+            if (!stat.isDirectory() || stat.isSymbolicLink()) {
+                conflict("growth-report-parent-unsafe");
+            }
+        }
+        return target;
+    }
+    async function sameFile(path, handle) {
+        const [named, opened] = await Promise.all([fs.lstat(path), handle.stat()]);
+        return named.isFile() && !named.isSymbolicLink() && named.dev === opened.dev && named.ino === opened.ino;
+    }
+    async function preimage(path) {
+        let handle;
+        let failure;
+        try {
+            try {
+                handle = await fs.open(path, constants.O_RDONLY | noFollow);
+            }
+            catch (error) {
+                if (code(error) === "ENOENT") {
+                    return null;
+                }
+                if (code(error) === "ELOOP" || code(error) === "EISDIR") {
+                    conflict("growth-report-slot-unsafe");
+                }
+                throw error;
+            }
+            const before = await handle.stat();
+            if (!before.isFile() || before.nlink !== 1 || before.size > maximumBytes) {
+                conflict("growth-report-slot-unsafe");
+            }
+            if (!await sameFile(path, handle)) {
+                conflict("growth-report-slot-changed");
+            }
+            // Read at most the budget plus one even if a non-cooperating writer grows it.
+            const bytes = Buffer.alloc(maximumBytes + 1);
+            let size = 0;
+            while (size < bytes.length) {
+                const read = await handle.read(bytes, size, bytes.length - size, size);
+                if (read.bytesRead === 0) {
+                    break;
+                }
+                size += read.bytesRead;
+            }
+            const after = await handle.stat();
+            if (size > maximumBytes || before.size !== after.size || before.mtimeMs !== after.mtimeMs || before.ctimeMs !== after.ctimeMs || !await sameFile(path, handle)) {
+                conflict("growth-report-slot-changed");
+            }
+            return { digest: digest(bytes.subarray(0, size)), identity: JSON.stringify([after.dev, after.ino, after.size, after.mtimeMs, after.ctimeMs]) };
+        }
+        catch (error) {
+            failure = error;
+            throw error;
+        }
+        finally {
+            await closeHandle(handle, failure);
+        }
+    }
+    async function removeOwned(path, handle) {
+        let failure;
+        try {
+            if (!await sameFile(path, handle)) {
+                conflict("growth-report-owned-file-changed");
+            }
+            await fs.unlink(path);
+        }
+        catch (error) {
+            failure = error;
+            throw error;
+        }
+        finally {
+            await closeHandle(handle, failure);
+        }
+    }
+    async function cleanup(state) {
+        const failures = [];
+        if (state.stage !== undefined) {
+            try {
+                if (state.renamed) {
+                    await state.stage.close();
+                }
+                else {
+                    await removeOwned(state.stagePath, state.stage);
+                }
+            }
+            catch (error) {
+                failures.push(error);
+            }
+        }
+        if (state.fence !== undefined) {
+            try {
+                await removeOwned(state.fencePath, state.fence);
+            }
+            catch (error) {
+                failures.push(error);
+            }
+        }
+        if (failures.length > 0) {
+            if (state.failure !== undefined) {
+                attachCleanupFailures(state.failure, failures);
+                return;
+            }
+            throw new GrowthReportWriteError(state.commitAttempted ? "uncertain" : "io", "growth-report-cleanup-failed", {
+                cause: new AggregateError(failures, "Owned-file cleanup failed")
+            });
+        }
+    }
+    return {
+        async write(input, cancellation) {
+            const request = { ...input };
+            cancellation.throwIfCancelled();
+            const bytes = Buffer.from(request.contents, "utf8"), outputDigest = digest(bytes);
+            validateRequest(bytes, request.expectedPreimage);
+            let fence, stage;
+            let fencePath = "", stagePath = "", commitAttempted = false, renamed = false;
+            let failure;
+            try {
+                const target = await parents(request.path);
+                fencePath = `${target}.growth-report.lock`;
+                cancellation.throwIfCancelled();
+                try {
+                    fence = await fs.open(fencePath, constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY | noFollow, 0o600);
+                }
+                catch (error) {
+                    if (code(error) === "EEXIST") {
+                        conflict("growth-report-fence-busy");
+                    }
+                    throw error;
+                }
+                cancellation.throwIfCancelled();
+                const before = await preimage(target);
+                cancellation.throwIfCancelled();
+                if (before?.digest === outputDigest) {
+                    return { status: "replayed", digest: outputDigest };
+                }
+                if (request.expectedPreimage !== undefined && (before?.digest ?? null) !== request.expectedPreimage) {
+                    conflict("growth-report-preimage-mismatch");
+                }
+                stagePath = join(dirname(target), `.growth-report-${randomUUID()}.tmp`);
+                stage = await fs.open(stagePath, constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY | noFollow, 0o600);
+                await stage.writeFile(bytes);
+                await stage.sync();
+                await parents(request.path);
+                if (!await sameFile(fencePath, fence) || !await sameFile(stagePath, stage) || JSON.stringify(await preimage(target)) !== JSON.stringify(before)) {
+                    conflict("growth-report-publication-conflict");
+                }
+                // Final cancellation boundary. Once rename starts, complete publication
+                // and cleanup; a late abort cannot turn a committed report into cancelled.
+                cancellation.throwIfCancelled();
+                commitAttempted = true;
+                await fs.rename(stagePath, target);
+                renamed = true;
+                if ((await preimage(target))?.digest !== outputDigest) {
+                    throw new GrowthReportWriteError("uncertain", "growth-report-readback-mismatch");
+                }
+                return { status: "published", digest: outputDigest };
+            }
+            catch (error) {
+                try {
+                    if (commitAttempted) {
+                        throw new GrowthReportWriteError("uncertain", "growth-report-publication-uncertain", { cause: error });
+                    }
+                    cancellation.throwIfCancelled();
+                    if (error instanceof GrowthReportWriteError) {
+                        throw error;
+                    }
+                    throw new GrowthReportWriteError("io", "growth-report-io-failed", { cause: error });
+                }
+                catch (primary) {
+                    failure = primary;
+                    throw primary;
+                }
+            }
+            finally {
+                await cleanup({ stage, stagePath, renamed, fence, fencePath, commitAttempted, failure });
+            }
+        }
+    };
+}
+//# sourceMappingURL=growth-report-writer.js.map

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

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

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

@@ -0,0 +1,4 @@
+import type { GrowthWorkspaceReader } from "../../../application/ports/growth-workspace.js";
+/** Select only the observed facts owned by growth policy; retain ordered targets. */
+export declare function createWorkspaceGrowthReader(workspace: GrowthWorkspaceReader): GrowthWorkspaceReader;
+//# sourceMappingURL=workspace-growth-reader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-growth-reader.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/public-api-compatibility/adapters/outbound/filesystem/workspace-growth-reader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AAE5F,qFAAqF;AACrF,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,qBAAqB,GAAG,qBAAqB,CAYnG"}

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

@@ -0,0 +1,15 @@
+/** Select only the observed facts owned by growth policy; retain ordered targets. */
+export function createWorkspaceGrowthReader(workspace) {
+    return {
+        async read(consumerRoot, workspaceManifestPath, signal) {
+            const inventory = await workspace.read(consumerRoot, workspaceManifestPath, signal);
+            return { packages: inventory.packages.map((pkg) => ({
+                    name: pkg.name, rootPath: pkg.rootPath, manifestPath: pkg.manifestPath, moduleType: pkg.moduleType,
+                    exportSurface: { explicit: pkg.exportSurface.explicit, entries: pkg.exportSurface.entries.map((entry) => ({
+                            subpath: entry.subpath, ...(entry.target === undefined ? {} : { target: structuredClone(entry.target) })
+                        })) }
+                })) };
+        }
+    };
+}
+//# sourceMappingURL=workspace-growth-reader.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-growth-reader.js","sourceRoot":"","sources":["../../../../../../src/capabilities/public-api-compatibility/adapters/outbound/filesystem/workspace-growth-reader.ts"],"names":[],"mappings":"AAEA,qFAAqF;AACrF,MAAM,UAAU,2BAA2B,CAAC,SAAgC;IAC1E,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,qBAAqB,EAAE,MAAM;YACpD,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,YAAY,EAAE,qBAAqB,EAAE,MAAM,CAAC,CAAC;YACpF,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;oBAClD,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU;oBAClG,aAAa,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;4BACxG,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;yBACzG,CAAC,CAAC,EAAE;iBACN,CAAC,CAAC,EAAE,CAAC;QACR,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/capabilities/public-api-compatibility/adapters/outbound/governance/governance-accepted-decision-evidence-acl.d.ts

@@ -7,11 +7,6 @@ import type { AcceptedArchitectureDecisionReader, AcceptedDecisionEvidence, Acce
 export declare class GovernanceAcceptedDecisionEvidenceAcl implements AcceptedDecisionEvidencePort {
     private readonly readAcceptedArchitectureDecisionEvidence;
     constructor(readAcceptedArchitectureDecisionEvidence: AcceptedArchitectureDecisionReader);
-    readAcceptedDecisionEvidence(input: {
-        readonly consumerRoot: string;
-        readonly baselinePath: string;
-        readonly governanceConfigPath: string;
-        readonly signal?: AbortSignal;
-    }): Promise<AcceptedDecisionEvidence>;
+    readAcceptedDecisionEvidence(input: Parameters<AcceptedDecisionEvidencePort["readAcceptedDecisionEvidence"]>[0]): Promise<AcceptedDecisionEvidence>;
 }
 //# sourceMappingURL=governance-accepted-decision-evidence-acl.d.ts.map

package/dist/capabilities/public-api-compatibility/adapters/outbound/governance/governance-accepted-decision-evidence-acl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"governance-accepted-decision-evidence-acl.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/public-api-compatibility/adapters/outbound/governance/governance-accepted-decision-evidence-acl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kCAAkC,EAClC,wBAAwB,EACxB,4BAA4B,EAC7B,MAAM,0DAA0D,CAAC;AAGlE;;;;GAIG;AACH,qBAAa,qCACX,YAAW,4BAA4B;IAE3B,OAAO,CAAC,QAAQ,CAAC,wCAAwC;IAArE,YAA6B,wCAAwC,EAAE,kCAAkC,EAAI;IAEvG,4BAA4B,CAAC,KAAK,EAAE;QACxC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;QACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;KAC/B,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAOpC;CACF"}
+{"version":3,"file":"governance-accepted-decision-evidence-acl.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/public-api-compatibility/adapters/outbound/governance/governance-accepted-decision-evidence-acl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kCAAkC,EAClC,wBAAwB,EACxB,4BAA4B,EAC7B,MAAM,0DAA0D,CAAC;AAGlE;;;;GAIG;AACH,qBAAa,qCACX,YAAW,4BAA4B;IAE3B,OAAO,CAAC,QAAQ,CAAC,wCAAwC;IAArE,YAA6B,wCAAwC,EAAE,kCAAkC,EAAI;IAEvG,4BAA4B,CAAC,KAAK,EAAE,UAAU,CAAC,4BAA4B,CAAC,8BAA8B,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAWxJ;CACF"}

package/dist/capabilities/public-api-compatibility/adapters/outbound/governance/governance-accepted-decision-evidence-acl.js

@@ -9,12 +9,18 @@ export class GovernanceAcceptedDecisionEvidenceAcl {
         this.readAcceptedArchitectureDecisionEvidence = readAcceptedArchitectureDecisionEvidence;
     }
     async readAcceptedDecisionEvidence(input) {
-        return this.readAcceptedArchitectureDecisionEvidence({
+        const evidence = await this.readAcceptedArchitectureDecisionEvidence({
             consumerRoot: input.consumerRoot,
             baselinePath: input.baselinePath,
             configPath: input.governanceConfigPath,
             ...(input.signal === undefined ? {} : { signal: input.signal })
         });
+        if (input.growthDecisions === undefined) {
+            return evidence;
+        }
+        // Retained governance proves IDs/paths, not an owner-approved exact SDK
+        // transition. Never manufacture source/diff approval from those records.
+        return { ...evidence, growthDecisionAuthority: { status: "unavailable", reasons: ["governance-exact-growth-owner-binding-unavailable"] } };
     }
 }
 //# sourceMappingURL=governance-accepted-decision-evidence-acl.js.map

package/dist/capabilities/public-api-compatibility/adapters/outbound/governance/governance-accepted-decision-evidence-acl.js.map

@@ -1 +1 @@
-{"version":3,"file":"governance-accepted-decision-evidence-acl.js","sourceRoot":"","sources":["../../../../../../src/capabilities/public-api-compatibility/adapters/outbound/governance/governance-accepted-decision-evidence-acl.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,MAAM,OAAO,qCAAqC;IAGnB,wCAAwC;IAArE,YAA6B,wCAA4E;wDAA5E,wCAAwC;IAAuC,CAAC;IAE7G,KAAK,CAAC,4BAA4B,CAAC,KAKlC;QACC,OAAO,IAAI,CAAC,wCAAwC,CAAC;YACnD,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,UAAU,EAAE,KAAK,CAAC,oBAAoB;YACtC,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;SAChE,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"governance-accepted-decision-evidence-acl.js","sourceRoot":"","sources":["../../../../../../src/capabilities/public-api-compatibility/adapters/outbound/governance/governance-accepted-decision-evidence-acl.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,MAAM,OAAO,qCAAqC;IAGnB,wCAAwC;IAArE,YAA6B,wCAA4E;wDAA5E,wCAAwC;IAAuC,CAAC;IAE7G,KAAK,CAAC,4BAA4B,CAAC,KAAkF;QACnH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,wCAAwC,CAAC;YACnE,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,UAAU,EAAE,KAAK,CAAC,oBAAoB;YACtC,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;SAChE,CAAC,CAAC;QACH,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YAAC,OAAO,QAAQ,CAAC;QAAC,CAAC;QAC7D,wEAAwE;QACxE,yEAAyE;QACzE,OAAO,EAAE,GAAG,QAAQ,EAAE,uBAAuB,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,mDAAmD,CAAC,EAAE,EAAE,CAAC;IAC7I,CAAC;CACF"}

package/dist/capabilities/public-api-compatibility/adapters/schema-validation.d.ts

@@ -1,4 +1,4 @@
-type PublicApiSchemaId = "package-public-api-compatibility/v1" | "package-public-api-baseline/v1";
+type PublicApiSchemaId = "governance-architecture-decisions/v1" | "package-public-api-compatibility/v1" | "package-public-api-compatibility/v2" | "package-public-api-baseline/v1";
 export type PublicApiSchemaAssertion = (schemaId: PublicApiSchemaId, input: unknown, phase: string) => Promise<void>;
 export {};
 //# sourceMappingURL=schema-validation.d.ts.map

package/dist/capabilities/public-api-compatibility/adapters/schema-validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema-validation.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/public-api-compatibility/adapters/schema-validation.ts"],"names":[],"mappings":"AAAA,KAAK,iBAAiB,GAClB,qCAAqC,GACrC,gCAAgC,CAAC;AAErC,MAAM,MAAM,wBAAwB,GAClC,CAAC,QAAQ,EAAE,iBAAiB,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"schema-validation.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/public-api-compatibility/adapters/schema-validation.ts"],"names":[],"mappings":"AAAA,KAAK,iBAAiB,GAClB,sCAAsC,GACtC,qCAAqC,GACrC,qCAAqC,GACrC,gCAAgC,CAAC;AAErC,MAAM,MAAM,wBAAwB,GAClC,CAAC,QAAQ,EAAE,iBAAiB,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/capabilities/public-api-compatibility/application/model/growth-admission-context.d.ts

@@ -0,0 +1,54 @@
+import type { GrowthDigest, GrowthEvidence, GrowthObservationReference, GrowthSurfaceObservation } from "./growth-observation.js";
+import type { PackageReleaseEvidence, PublicApiPackagePolicy, PublicApiSnapshot } from "./public-api.js";
+import type { AcceptedDecisionEvidence } from "../ports/accepted-decision-evidence.js";
+export interface GrowthReleasedPackage {
+    readonly packageName: string;
+    readonly observation?: GrowthEvidence<GrowthSurfaceObservation>;
+    readonly policy: PublicApiPackagePolicy;
+    readonly releaseEvidence: GrowthEvidence<PackageReleaseEvidence>;
+    readonly evidence: {
+        readonly kind: "released";
+        readonly typed: GrowthEvidence<PublicApiSnapshot>;
+        readonly artifact: GrowthEvidence<PublicApiSnapshot>;
+    } | {
+        readonly kind: "initial-unreleased";
+        readonly history: GrowthEvidence<GrowthDigest>;
+    };
+}
+/** Internal context from a trusted input boundary. No candidate observation or
+ * candidate compatibility snapshot is accepted here. Available history denotes
+ * a validated exact-target retained receipt, not a caller's initial flag. */
+export interface GrowthInputContext {
+    readonly trustedBase: GrowthEvidence<GrowthSurfaceObservation>;
+    readonly trustedBaseReference: GrowthEvidence<GrowthObservationReference>;
+    readonly retainedHistory: GrowthEvidence<{
+        readonly targetSurfaceDigest: GrowthDigest;
+        readonly receiptDigest: GrowthDigest;
+    }>;
+    readonly released: readonly GrowthReleasedPackage[];
+    readonly decisions: readonly unknown[];
+    readonly acceptedBreakingDecisions: AcceptedDecisionEvidence;
+    readonly authority: {
+        readonly status: "verified";
+        readonly receiptDigest: GrowthDigest;
+        readonly workflowRef?: string;
+        readonly runRef?: string;
+    } | {
+        readonly status: "unverified";
+        readonly reasons: readonly string[];
+    };
+}
+export interface GrowthContextRequest {
+    readonly trustedBasePath: string;
+    readonly decisionsPath: string;
+    readonly released: readonly ({
+        readonly packageName: string;
+    } & ({
+        readonly kind: "released";
+        readonly observationPath: string;
+    } | {
+        readonly kind: "initial-unreleased";
+        readonly trustedHistoryPath: string;
+    }))[];
+}
+//# sourceMappingURL=growth-admission-context.d.ts.map

package/dist/capabilities/public-api-compatibility/application/model/growth-admission-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"growth-admission-context.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/public-api-compatibility/application/model/growth-admission-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAClI,OAAO,KAAK,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzG,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAEvF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,cAAc,CAAC,wBAAwB,CAAC,CAAC;IAChE,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,eAAe,EAAE,cAAc,CAAC,sBAAsB,CAAC,CAAC;IACjE,QAAQ,CAAC,QAAQ,EACb;QAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAA;KAAE,GACtI;QAAE,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC,YAAY,CAAC,CAAA;KAAE,CAAC;CAC7F;AAED;;6EAE6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC,wBAAwB,CAAC,CAAC;IAC/D,QAAQ,CAAC,oBAAoB,EAAE,cAAc,CAAC,0BAA0B,CAAC,CAAC;IAC1E,QAAQ,CAAC,eAAe,EAAE,cAAc,CAAC;QACvC,QAAQ,CAAC,mBAAmB,EAAE,YAAY,CAAC;QAC3C,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC;KACtC,CAAC,CAAC;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACpD,QAAQ,CAAC,SAAS,EAAE,SAAS,OAAO,EAAE,CAAC;IACvC,QAAQ,CAAC,yBAAyB,EAAE,wBAAwB,CAAC;IAC7D,QAAQ,CAAC,SAAS,EACd;QAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;QAAC,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC;QAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9H;QAAE,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;CAC5E;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;QAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,CAC5D;QAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;KAAE,GAC/D;QAAE,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;QAAC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAC/E,CAAC,EAAE,CAAC;CACN"}

package/dist/capabilities/public-api-compatibility/application/model/growth-admission-context.js

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

package/dist/capabilities/public-api-compatibility/application/model/growth-admission-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"growth-admission-context.js","sourceRoot":"","sources":["../../../../../src/capabilities/public-api-compatibility/application/model/growth-admission-context.ts"],"names":[],"mappings":""}

package/dist/capabilities/public-api-compatibility/application/model/growth-admission.d.ts

@@ -0,0 +1,77 @@
+import type { GrowthCoordinate, GrowthDigest } from "./growth-observation.js";
+/** Internal S2 data only. Neither a decision file nor this model proves approval. */
+export declare const growthPolicyVersion: "foundation:sdk-growth:policy:1";
+export type GrowthValueRef = {
+    readonly state: "absent";
+} | {
+    readonly state: "present";
+    readonly digest: GrowthDigest;
+};
+export interface GrowthTransition {
+    readonly coordinate: GrowthCoordinate;
+    readonly before: GrowthValueRef;
+    readonly after: GrowthValueRef;
+    readonly policyVersion: typeof growthPolicyVersion;
+    readonly fingerprint: GrowthDigest;
+}
+interface GrowthConsumerEvidenceRef {
+    readonly useCase: string;
+    readonly repository: string;
+    readonly source: {
+        readonly tree: string;
+        readonly contentDigest: GrowthDigest;
+        readonly commit: string | null;
+    };
+    readonly artifactDigest: GrowthDigest | null;
+}
+export interface GrowthDecision {
+    readonly contractRevision: "foundation:sdk-growth:c0:5";
+    readonly decisionId: string;
+    readonly ownerRef: string;
+    readonly stability: "development" | "experimental" | "supported";
+    readonly transitions: readonly GrowthDigest[];
+    readonly coordinates: readonly GrowthCoordinate[];
+    readonly changeFingerprint: GrowthDigest;
+    readonly consumerEvidenceRefs: readonly GrowthConsumerEvidenceRef[];
+    readonly exposureRationale: string;
+    readonly compatibilityRationale: string;
+    readonly lifecycle: {
+        readonly kind: "ordinary";
+    } | {
+        readonly kind: "shim" | "deprecation" | "removal";
+        readonly replacement: string;
+        readonly migration: string;
+        readonly removalConditions: string;
+    };
+}
+export type GrowthComparison = {
+    readonly status: "complete";
+    readonly before: GrowthDigest;
+    readonly after: GrowthDigest;
+    readonly transitions: readonly GrowthTransition[];
+} | {
+    readonly status: "incomplete";
+    readonly reasons: readonly string[];
+    readonly findings: readonly GrowthTransition[];
+};
+export interface GrowthAdmissionDiagnostic {
+    readonly code: "growth-decision-malformed" | "growth-decision-duplicate" | "growth-decision-stale" | "growth-decision-coordinate-mismatch" | "growth-decision-fingerprint-mismatch" | "growth-transition-unadmitted" | "growth-decision-overlap" | "growth-owner-evidence-unavailable" | "growth-decision-budget-exhausted" | "growth-comparison-incomplete" | "growth-compatibility-rejected";
+    readonly subject: string;
+    readonly remediation: string;
+}
+/** Validated authority supplied at the application boundary, never inferred
+ * from a candidate Decision or an accepted ID alone. */
+export interface GrowthDecisionAuthority {
+    readonly decisionId: string;
+    readonly ownerRef: string;
+    readonly decisionDigest: GrowthDigest;
+}
+export interface GrowthAdmissionResult {
+    readonly status: "admitted" | "rejected" | "incomplete";
+    readonly admittedTransitions: readonly GrowthDigest[];
+    readonly diagnostics: readonly GrowthAdmissionDiagnostic[];
+    /** This internal PR policy never grants release authority. */
+    readonly releaseEligible: false;
+}
+export {};
+//# sourceMappingURL=growth-admission.d.ts.map

package/dist/capabilities/public-api-compatibility/application/model/growth-admission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"growth-admission.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/public-api-compatibility/application/model/growth-admission.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/public-api-compatibility/application/model/growth-admission.js

@@ -0,0 +1,3 @@
+/** Internal S2 data only. Neither a decision file nor this model proves approval. */
+export const growthPolicyVersion = "foundation:sdk-growth:policy:1";
+//# sourceMappingURL=growth-admission.js.map

package/dist/capabilities/public-api-compatibility/application/model/growth-admission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"growth-admission.js","sourceRoot":"","sources":["../../../../../src/capabilities/public-api-compatibility/application/model/growth-admission.ts"],"names":[],"mappings":"AAEA,qFAAqF;AACrF,MAAM,CAAC,MAAM,mBAAmB,GAAG,gCAAyC,CAAC"}

package/dist/capabilities/public-api-compatibility/application/model/growth-configuration.d.ts

@@ -0,0 +1,16 @@
+import type { PublicApiCompatibilityPolicy } from "./public-api.js";
+import type { GrowthContextRequest } from "./growth-admission-context.js";
+/** Closed frozen configuration. Execution identity belongs to composition. */
+export interface SdkGrowthCapabilityPolicy {
+    readonly schemaVersion: 2;
+    readonly compatibility: PublicApiCompatibilityPolicy;
+    readonly sdkGrowth: {
+        readonly contractRevision: "foundation:sdk-growth:c0:5";
+        readonly policyVersion: "foundation:sdk-growth:policy:1";
+        readonly comparison: Omit<GrowthContextRequest, "decisionsPath">;
+        readonly decisionsPath: string;
+        readonly reportPath: string;
+    };
+}
+export type PublicApiCapabilityPolicy = PublicApiCompatibilityPolicy | SdkGrowthCapabilityPolicy;
+//# sourceMappingURL=growth-configuration.d.ts.map

package/dist/capabilities/public-api-compatibility/application/model/growth-configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"growth-configuration.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/public-api-compatibility/application/model/growth-configuration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAE1E,8EAA8E;AAC9E,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,4BAA4B,CAAC;IACrD,QAAQ,CAAC,SAAS,EAAE;QAClB,QAAQ,CAAC,gBAAgB,EAAE,4BAA4B,CAAC;QACxD,QAAQ,CAAC,aAAa,EAAE,gCAAgC,CAAC;QACzD,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,oBAAoB,EAAE,eAAe,CAAC,CAAC;QACjE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;KAC7B,CAAC;CACH;AACD,MAAM,MAAM,yBAAyB,GAAG,4BAA4B,GAAG,yBAAyB,CAAC"}

package/dist/capabilities/public-api-compatibility/application/model/growth-configuration.js

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

package/dist/capabilities/public-api-compatibility/application/model/growth-configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"growth-configuration.js","sourceRoot":"","sources":["../../../../../src/capabilities/public-api-compatibility/application/model/growth-configuration.ts"],"names":[],"mappings":""}