@agent-teams/engineering-foundation 1.3.2 → 1.4.0

package/dist/capabilities/public-api-compatibility/application/policies/project-growth-resolution.js

@@ -0,0 +1,53 @@
+import { GrowthObservationInvariantError, GrowthObservationUnavailableError } from "../model/growth-observation.js";
+/** Translate the existing workspace observer's retained tree, without parsing a
+ * manifest or resolving Node conditions again. Arrays and conditions are ordered.
+ */
+export function projectGrowthResolution(target) {
+    const budget = { nodes: 0 };
+    function visit(value, depth) {
+        if (++budget.nodes > 10_000 || depth > 64) {
+            throw new GrowthObservationUnavailableError("growth-resolution-budget-exhausted");
+        }
+        if (value === null) {
+            return { kind: "null" };
+        }
+        if (typeof value === "string") {
+            return { kind: "target", target: value };
+        }
+        if (Array.isArray(value)) {
+            return { kind: "fallbacks", entries: value.map((entry) => visit(entry, depth + 1)) };
+        }
+        if (typeof value !== "object") {
+            throw new GrowthObservationInvariantError("invalid-observed-export-target");
+        }
+        return { kind: "conditions", entries: Object.entries(value).map(([condition, entry]) => ({ condition, value: visit(entry, depth + 1) })) };
+    }
+    return visit(target, 0);
+}
+/** A typed declaration identity may occur in several ordered branches. This is
+ * coordinate attribution only; the existing export observer owns admissibility.
+ */
+export function growthDeclarationBranches(tree, target) {
+    const branches = [];
+    function visit(value, path) {
+        switch (value.kind) {
+            case "target":
+                if (value.target === target) {
+                    branches.push(path);
+                }
+                break;
+            case "null": break;
+            case "conditions":
+                for (const entry of value.entries) {
+                    visit(entry.value, [...path, { condition: entry.condition }]);
+                }
+                break;
+            case "fallbacks":
+                value.entries.forEach((entry, index) => { visit(entry, [...path, { index }]); });
+                break;
+        }
+    }
+    visit(tree, []);
+    return branches;
+}
+//# sourceMappingURL=project-growth-resolution.js.map

package/dist/capabilities/public-api-compatibility/application/policies/project-growth-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-growth-resolution.js","sourceRoot":"","sources":["../../../../../src/capabilities/public-api-compatibility/application/policies/project-growth-resolution.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,+BAA+B,EAAE,iCAAiC,EAAE,MAAM,gCAAgC,CAAC;AAEpH;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAA0B;IAChE,MAAM,MAAM,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAC5B,SAAS,KAAK,CAAC,KAAyB,EAAE,KAAa;QACrD,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,MAAM,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;YAC1C,MAAM,IAAI,iCAAiC,CAAC,oCAAoC,CAAC,CAAC;QACpF,CAAC;QACD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,CAAC;QAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAAC,CAAC;QAC5E,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAAC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAG,KAAuC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAAC,CAAC;QACtJ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAAC,MAAM,IAAI,+BAA+B,CAAC,gCAAgC,CAAC,CAAC;QAAC,CAAC;QAC/G,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAC7I,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAA0B,EAAE,MAAc;IAClF,MAAM,QAAQ,GAAwC,EAAE,CAAC;IACzD,SAAS,KAAK,CAAC,KAA2B,EAAE,IAAqC;QAC/E,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,QAAQ;gBAAE,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;oBAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM;YAC3E,KAAK,MAAM,EAAE,MAAM;YACnB,KAAK,YAAY;gBAAE,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;oBAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM;YAC/H,KAAK,WAAW;gBAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAAC,MAAM;QAC5G,CAAC;IACH,CAAC;IACD,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAChB,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/capabilities/public-api-compatibility/application/policies/retain-growth-compatibility.d.ts

@@ -0,0 +1,26 @@
+import type { GrowthCancellation, GrowthCompatibilityPackage, GrowthEvidence } from "../model/growth-observation.js";
+import type { PublicApiArtifactSnapshot, PublicApiPackagePolicy } from "../model/public-api.js";
+import type { PublicApiExtractor } from "../ports/public-api-extractor.js";
+import type { PackageArtifactInventory } from "../ports/package-artifact-inventory.js";
+export interface GrowthCompatibilitySubject {
+    readonly policy: PublicApiPackagePolicy;
+    readonly packageVersion: string;
+}
+export interface RetainedGrowthCompatibility {
+    readonly compatibility: GrowthCompatibilityPackage;
+    readonly artifactObservation: GrowthEvidence<PublicApiArtifactSnapshot>;
+}
+/** Retain the original v1 payloads, never reconstruct them from growth hashes.
+ * Observer failures are stable unavailable evidence; invalid provenance is an
+ * invariant failure. Cancellation is always propagated, including after I/O.
+ */
+export declare function retainGrowthCompatibility(input: {
+    readonly consumerRoot: string;
+    readonly subjects: readonly GrowthCompatibilitySubject[];
+    readonly extractorVersion: string;
+    readonly cancellation: GrowthCancellation;
+}, dependencies: {
+    readonly typed: PublicApiExtractor;
+    readonly artifact: PackageArtifactInventory;
+}): Promise<readonly RetainedGrowthCompatibility[]>;
+//# sourceMappingURL=retain-growth-compatibility.d.ts.map

package/dist/capabilities/public-api-compatibility/application/policies/retain-growth-compatibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retain-growth-compatibility.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/public-api-compatibility/application/policies/retain-growth-compatibility.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrH,OAAO,KAAK,EAAE,yBAAyB,EAAE,sBAAsB,EAAqB,MAAM,wBAAwB,CAAC;AACnH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAGvF,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,aAAa,EAAE,0BAA0B,CAAC;IACnD,QAAQ,CAAC,mBAAmB,EAAE,cAAc,CAAC,yBAAyB,CAAC,CAAC;CACzE;AAMD;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,KAAK,EAAE;IACrD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,SAAS,0BAA0B,EAAE,CAAC;IACzD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;CAC3C,EAAE,YAAY,EAAE;IACf,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;CAC7C,GAAG,OAAO,CAAC,SAAS,2BAA2B,EAAE,CAAC,CAgDlD"}

package/dist/capabilities/public-api-compatibility/application/policies/retain-growth-compatibility.js

@@ -0,0 +1,63 @@
+import { compareGrowthStrings } from "./normalize-growth-observation.js";
+import { GrowthObservationInvariantError } from "../model/growth-observation.js";
+import { artifactApiProjection } from "./artifact-api-projection.js";
+function unavailable(reason) {
+    return { status: "unavailable", reasons: [reason] };
+}
+/** Retain the original v1 payloads, never reconstruct them from growth hashes.
+ * Observer failures are stable unavailable evidence; invalid provenance is an
+ * invariant failure. Cancellation is always propagated, including after I/O.
+ */
+export async function retainGrowthCompatibility(input, dependencies) {
+    if (input.extractorVersion === "package-artifact-inventory/1") {
+        throw new GrowthObservationInvariantError("typed-observer-provenance-mismatch");
+    }
+    const subjects = input.subjects.toSorted((a, b) => compareGrowthStrings(a.policy.packageName, b.policy.packageName));
+    for (let index = 1; index < subjects.length; index += 1) {
+        if (subjects[index]?.policy.packageName === subjects[index - 1]?.policy.packageName) {
+            throw new GrowthObservationInvariantError("duplicate-compatibility-package");
+        }
+    }
+    const rows = [];
+    for (const subject of subjects) {
+        input.cancellation.throwIfCancelled();
+        const { policy, packageVersion } = subject;
+        let typed;
+        try {
+            typed = { status: "available", value: structuredClone(await dependencies.typed.extract(input.consumerRoot, policy, packageVersion, input.cancellation.signal)) };
+        }
+        catch {
+            input.cancellation.throwIfCancelled();
+            typed = unavailable("typed-observation-unavailable");
+        }
+        input.cancellation.throwIfCancelled();
+        if (typed.status === "available" && (typed.value.packageName !== policy.packageName || typed.value.packageVersion !== packageVersion || typed.value.extractorVersion !== input.extractorVersion || typed.value.schemaVersion !== 1)) {
+            throw new GrowthObservationInvariantError("typed-observer-provenance-mismatch");
+        }
+        let artifact;
+        let snapshots;
+        let artifactObservation;
+        try {
+            snapshots = structuredClone(await dependencies.artifact.inspect(input.consumerRoot, [policy], input.cancellation.signal));
+        }
+        catch {
+            input.cancellation.throwIfCancelled();
+        }
+        input.cancellation.throwIfCancelled();
+        if (snapshots === undefined) {
+            artifact = unavailable("artifact-observation-unavailable");
+            artifactObservation = { status: "unavailable", reasons: ["artifact-observation-unavailable"] };
+        }
+        else {
+            const snapshot = snapshots[0];
+            if (snapshots.length !== 1 || snapshot === undefined || snapshot.packageName !== policy.packageName || snapshot.packageVersion !== packageVersion || snapshot.schemaVersion !== 1) {
+                throw new GrowthObservationInvariantError("artifact-observer-provenance-mismatch");
+            }
+            artifact = { status: "available", value: artifactApiProjection(snapshot) };
+            artifactObservation = { status: "available", value: snapshot };
+        }
+        rows.push({ compatibility: { packageName: policy.packageName, typed: { kind: "typed", snapshot: typed }, artifact: { kind: "artifact", snapshot: artifact } }, artifactObservation });
+    }
+    return rows;
+}
+//# sourceMappingURL=retain-growth-compatibility.js.map

package/dist/capabilities/public-api-compatibility/application/policies/retain-growth-compatibility.js.map

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

package/dist/capabilities/public-api-compatibility/application/policies/validate-growth-decision.d.ts

@@ -0,0 +1,5 @@
+import type { GrowthDecision } from "../model/growth-admission.js";
+/** Closed metadata validation only; exact matching and trusted owner evidence
+ * remain separate requirements. No date is inferred for a supported surface. */
+export declare function isGrowthDecision(value: unknown): value is GrowthDecision;
+//# sourceMappingURL=validate-growth-decision.d.ts.map

package/dist/capabilities/public-api-compatibility/application/policies/validate-growth-decision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-growth-decision.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/public-api-compatibility/application/policies/validate-growth-decision.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAuBnE;gFACgF;AAChF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CA6BxE"}

package/dist/capabilities/public-api-compatibility/application/policies/validate-growth-decision.js

@@ -0,0 +1,86 @@
+import { assertGrowthCoordinateShape } from "./validate-growth-observation.js";
+function record(value, fields) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)
+        || Object.keys(value).length !== fields.length
+        || fields.some((field) => !Object.hasOwn(value, field))) {
+        throw new Error("Malformed growth decision record");
+    }
+    return value;
+}
+function text(value) {
+    if (typeof value !== "string" || value.trim().length === 0 || value.length > 4096) {
+        throw new Error("Missing growth decision text");
+    }
+}
+function digest(value) {
+    if (typeof value !== "string" || !/^sha256:[a-f0-9]{64}$/u.test(value)) {
+        throw new Error("Invalid growth decision digest");
+    }
+}
+function commit(value) {
+    if (typeof value !== "string" || !/^[a-f0-9]{40}$/u.test(value)) {
+        throw new Error("Invalid growth decision source");
+    }
+}
+function array(value) {
+    if (!Array.isArray(value) || value.length === 0 || value.length > 100_000) {
+        throw new Error("Invalid growth decision collection");
+    }
+    return value;
+}
+/** Closed metadata validation only; exact matching and trusted owner evidence
+ * remain separate requirements. No date is inferred for a supported surface. */
+export function isGrowthDecision(value) {
+    try {
+        const decision = record(value, ["contractRevision", "decisionId", "ownerRef", "stability", "transitions", "coordinates", "changeFingerprint", "consumerEvidenceRefs", "exposureRationale", "compatibilityRationale", "lifecycle"]);
+        if (decision["contractRevision"] !== "foundation:sdk-growth:c0:5"
+            || typeof decision["stability"] !== "string" || !["development", "experimental", "supported"].includes(decision["stability"])) {
+            return false;
+        }
+        for (const key of ["decisionId", "ownerRef", "exposureRationale", "compatibilityRationale"]) {
+            text(decision[key]);
+        }
+        digest(decision["changeFingerprint"]);
+        const transitions = array(decision["transitions"]);
+        transitions.forEach(digest);
+        if (new Set(transitions).size !== transitions.length) {
+            return false;
+        }
+        array(decision["coordinates"]).forEach(assertGrowthCoordinateShape);
+        for (const raw of array(decision["consumerEvidenceRefs"])) {
+            const evidence = record(raw, ["useCase", "repository", "source", "artifactDigest"]);
+            text(evidence["useCase"]);
+            text(evidence["repository"]);
+            const source = record(evidence["source"], ["tree", "contentDigest", "commit"]);
+            commit(source["tree"]);
+            digest(source["contentDigest"]);
+            if (source["commit"] !== null) {
+                commit(source["commit"]);
+            }
+            if (evidence["artifactDigest"] !== null) {
+                digest(evidence["artifactDigest"]);
+            }
+        }
+        const lifecycle = decision["lifecycle"];
+        if (lifecycle === null || typeof lifecycle !== "object" || !("kind" in lifecycle)) {
+            return false;
+        }
+        if (lifecycle.kind === "ordinary") {
+            record(lifecycle, ["kind"]);
+        }
+        else {
+            if (typeof lifecycle.kind !== "string" || !["shim", "deprecation", "removal"].includes(lifecycle.kind)) {
+                return false;
+            }
+            const conditions = record(lifecycle, ["kind", "replacement", "migration", "removalConditions"]);
+            for (const key of ["replacement", "migration", "removalConditions"]) {
+                text(conditions[key]);
+            }
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=validate-growth-decision.js.map

package/dist/capabilities/public-api-compatibility/application/policies/validate-growth-decision.js.map

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

package/dist/capabilities/public-api-compatibility/application/policies/validate-growth-execution.d.ts

@@ -0,0 +1,5 @@
+import type { GrowthEvidence, GrowthInvocation, GrowthObservationExecution } from "../model/growth-observation.js";
+export declare function assertGrowthEvidence<T>(evidence: GrowthEvidence<T>): void;
+/** Validate the one S1 handoff before any admission or release comparison. */
+export declare function validateGrowthExecution(execution: GrowthObservationExecution, invocation: GrowthInvocation): void;
+//# sourceMappingURL=validate-growth-execution.d.ts.map

package/dist/capabilities/public-api-compatibility/application/policies/validate-growth-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-growth-execution.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/public-api-compatibility/application/policies/validate-growth-execution.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAKnH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,CAOzE;AAED,8EAA8E;AAC9E,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,0BAA0B,EAAE,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAiCjH"}

package/dist/capabilities/public-api-compatibility/application/policies/validate-growth-execution.js

@@ -0,0 +1,51 @@
+import { GrowthObservationInvariantError } from "../model/growth-observation.js";
+import { growthCanonicalJson, growthUniqueSorted, normalizeGrowthInvocation, normalizeGrowthObservation } from "./normalize-growth-observation.js";
+function invariant(reason) { throw new GrowthObservationInvariantError(reason); }
+export function assertGrowthEvidence(evidence) {
+    if (evidence.status === "available") {
+        return;
+    }
+    if (evidence.status !== "unavailable" || evidence.reasons.length === 0
+        || evidence.reasons.some((reason) => typeof reason !== "string" || reason.trim().length === 0)) {
+        invariant("growth-evidence-reasons-missing");
+    }
+    growthUniqueSorted(evidence.reasons, (reason) => reason);
+}
+/** Validate the one S1 handoff before any admission or release comparison. */
+export function validateGrowthExecution(execution, invocation) {
+    if (growthCanonicalJson(normalizeGrowthInvocation(execution.identity)) !== growthCanonicalJson(normalizeGrowthInvocation(invocation))) {
+        invariant("growth-execution-identity-mismatch");
+    }
+    assertGrowthEvidence(execution.surface);
+    const rows = growthUniqueSorted(execution.compatibilitySnapshots, (row) => row.packageName);
+    if (execution.surface.status === "available") {
+        const surface = normalizeGrowthObservation(execution.surface.value);
+        const identity = { repository: surface.repository, sourceCommit: surface.sourceCommit, sourceTree: surface.sourceTree,
+            topologyDigest: surface.topologyDigest, lockDigest: surface.lockDigest, toolchainDigest: surface.toolchainDigest,
+            artifactDigests: surface.artifactDigests, tool: surface.tool };
+        if (growthCanonicalJson(normalizeGrowthInvocation(identity)) !== growthCanonicalJson(normalizeGrowthInvocation(invocation))) {
+            invariant("growth-surface-identity-mismatch");
+        }
+        if (growthCanonicalJson(rows.map((row) => row.packageName)) !== growthCanonicalJson(surface.coverage.map((row) => row.packageName))) {
+            invariant("growth-compatibility-topology-mismatch");
+        }
+    }
+    for (const row of rows) {
+        if (row.typed?.kind !== "typed" || row.artifact?.kind !== "artifact") {
+            invariant("growth-compatibility-branch-mismatch");
+        }
+        for (const branch of ["typed", "artifact"]) {
+            const snapshot = row[branch].snapshot;
+            assertGrowthEvidence(snapshot);
+            if (snapshot.status === "available" && (snapshot.value.packageName !== row.packageName || snapshot.value.schemaVersion !== 1
+                || snapshot.value.extractorVersion !== (branch === "typed" ? invocation.tool.extractorVersion : "package-artifact-inventory/1"))) {
+                invariant("growth-compatibility-provenance-mismatch");
+            }
+        }
+        if (row.typed.snapshot.status === "available" && row.artifact.snapshot.status === "available"
+            && row.typed.snapshot.value.packageVersion !== row.artifact.snapshot.value.packageVersion) {
+            invariant("growth-compatibility-version-mismatch");
+        }
+    }
+}
+//# sourceMappingURL=validate-growth-execution.js.map

package/dist/capabilities/public-api-compatibility/application/policies/validate-growth-execution.js.map

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

package/dist/capabilities/public-api-compatibility/application/policies/validate-growth-observation.d.ts

@@ -0,0 +1,4 @@
+export declare function assertGrowthInvocationShape(value: unknown): void;
+export declare function assertGrowthCoordinateShape(value: unknown): void;
+export declare function assertGrowthObservationShape(value: unknown): void;
+//# sourceMappingURL=validate-growth-observation.d.ts.map

package/dist/capabilities/public-api-compatibility/application/policies/validate-growth-observation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-growth-observation.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/public-api-compatibility/application/policies/validate-growth-observation.ts"],"names":[],"mappings":"AA6BA,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAEhE;AACD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAoBhE;AAYD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAiBjE"}

package/dist/capabilities/public-api-compatibility/application/policies/validate-growth-observation.js

@@ -0,0 +1,125 @@
+import { GrowthObservationInvariantError, GrowthObservationUnavailableError, growthDimensions } from "../model/growth-observation.js";
+function invalid() { throw new GrowthObservationInvariantError("invalid-growth-observation-shape"); }
+function record(value, fields) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        invalid();
+    }
+    const keys = Object.keys(value);
+    if (keys.length !== fields.length || fields.some((field) => !Object.hasOwn(value, field))) {
+        invalid();
+    }
+    return value;
+}
+function text(value) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        invalid();
+    }
+}
+function array(value) {
+    if (!Array.isArray(value)) {
+        invalid();
+    }
+    return value;
+}
+function oneOf(value, values) {
+    if (typeof value !== "string" || !values.includes(value)) {
+        invalid();
+    }
+}
+const growthIdentityFields = ["repository", "sourceCommit", "sourceTree", "topologyDigest", "lockDigest", "toolchainDigest", "artifactDigests", "tool"];
+function identity(value) {
+    for (const field of growthIdentityFields) {
+        if (field !== "tool" && field !== "artifactDigests") {
+            text(value[field]);
+        }
+    }
+    for (const digest of array(value["artifactDigests"])) {
+        text(digest);
+    }
+    const tool = record(value["tool"], ["version", "artifactDigest", "extractorVersion"]);
+    for (const field of Object.values(tool)) {
+        text(field);
+    }
+}
+export function assertGrowthInvocationShape(value) {
+    identity(record(value, growthIdentityFields));
+}
+export function assertGrowthCoordinateShape(value) {
+    const entry = record(value, ["packageName", "exportPath", "resolutionBranch", "subject"]);
+    text(entry["packageName"]);
+    text(entry["exportPath"]);
+    for (const step of array(entry["resolutionBranch"])) {
+        if (step !== null && typeof step === "object" && "condition" in step) {
+            text(record(step, ["condition"])["condition"]);
+        }
+        else {
+            const index = record(step, ["index"])["index"];
+            if (typeof index !== "number" || !Number.isSafeInteger(index) || index < 0) {
+                invalid();
+            }
+        }
+    }
+    const subject = entry["subject"];
+    if (subject === null || typeof subject !== "object" || !("kind" in subject)) {
+        invalid();
+    }
+    switch (subject.kind) {
+        case "typed":
+            text(record(subject, ["kind", "canonicalReference"])["canonicalReference"]);
+            break;
+        case "bin":
+            text(record(subject, ["kind", "name"])["name"]);
+            break;
+        case "data":
+        case "wildcard-member":
+            text(record(subject, ["kind", "member"])["member"]);
+            break;
+        case "export-branch":
+        case "package":
+            record(subject, ["kind"]);
+            break;
+        default: invalid();
+    }
+}
+function coverage(value) {
+    const row = record(value, ["packageName", "classification", "dimensions"]);
+    text(row["packageName"]);
+    oneOf(row["classification"], ["governed", "private-only"]);
+    for (const raw of array(row["dimensions"])) {
+        const entry = record(raw, ["dimension", "status", "reasons"]);
+        oneOf(entry["dimension"], growthDimensions);
+        oneOf(entry["status"], ["complete", "limited", "unsupported", "unavailable"]);
+        for (const reason of array(entry["reasons"])) {
+            text(reason);
+        }
+    }
+}
+export function assertGrowthObservationShape(value) {
+    const observation = record(value, [...growthIdentityFields, "contractRevision", "observationVersion", "coverage", "entries"]);
+    identity(observation);
+    for (const row of array(observation["coverage"])) {
+        coverage(row);
+    }
+    const entries = array(observation["entries"]);
+    if (entries.length > 100_000) {
+        throw new GrowthObservationUnavailableError("growth-entry-budget-exhausted");
+    }
+    for (const raw of entries) {
+        const entry = record(raw, ["coordinate", "value"]);
+        assertGrowthCoordinateShape(entry["coordinate"]);
+        const valueRef = entry["value"];
+        if (valueRef === null || typeof valueRef !== "object" || !("state" in valueRef)) {
+            invalid();
+        }
+        switch (valueRef.state) {
+            case "absent":
+                record(valueRef, ["state"]);
+                break;
+            case "present":
+                text(record(valueRef, ["state", "digest"])["digest"]);
+                break;
+            default: invalid();
+        }
+    }
+}
+//# sourceMappingURL=validate-growth-observation.js.map

package/dist/capabilities/public-api-compatibility/application/policies/validate-growth-observation.js.map

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

package/dist/capabilities/public-api-compatibility/application/policies/validate-growth-report.d.ts

@@ -0,0 +1,5 @@
+import type { GrowthReport } from "../model/growth-report.js";
+import type { ChangeFingerprint } from "../ports/change-fingerprint.js";
+/** Validate the complete closed artifact before serialization/publication. */
+export declare function validateGrowthReport(report: GrowthReport, fingerprint: ChangeFingerprint): GrowthReport;
+//# sourceMappingURL=validate-growth-report.d.ts.map

package/dist/capabilities/public-api-compatibility/application/policies/validate-growth-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-growth-report.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/public-api-compatibility/application/policies/validate-growth-report.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AA0CxE,8EAA8E;AAC9E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,GAAG,YAAY,CA+CvG"}