@agent-teams/engineering-foundation 0.3.0 → 0.4.0

package/README.md

@@ -23,12 +23,16 @@ schemaVersion: 1
 project:
   id: consumer-repository
 capabilities:
-  architecture.source-dependencies:
-    configPath: architecture/foundation/source-dependencies.yaml
   workspace.dependency-declarations:
     configPath: architecture/foundation/dependency-declarations.yaml
 ```
 
+Capability presence means enabled. Add source dependencies, suppression
+governance, public API compatibility, or the publishing-repository security
+profile only in separate reviewed adoption changes with consumer-owned policy
+and qualification evidence. Installing or upgrading this package never enables
+them automatically.
+
 The root file is `foundation.config.yaml`. Use
 `agent-teams-foundation schema foundation-config/v1` for its canonical schema
 and `agent-teams-foundation explain <rule-id>` for rule guidance.
@@ -39,3 +43,8 @@ configuration extends the fast
 `./node_modules/@agent-teams/engineering-foundation/presets/oxlint/node.json`
 or type-aware `type-aware.json` preset. TypeScript remains the separate typecheck
 authority.
+
+`agent-teams-foundation public-api-promote-release` is reserved for the
+Changesets version workflow. Normal feature checks never update released API
+baselines. Publishing consumers must also enforce release-owned baseline
+mutation in required pull-request CI.

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

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

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

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

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

@@ -0,0 +1,143 @@
+import { mkdtemp, readFile, realpath, rm, stat } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { isAbsolute, join, relative, resolve, sep } from "node:path";
+import { Extractor, ExtractorConfig, ExtractorLogLevel } from "@microsoft/api-extractor";
+import { ApiDeclaredItem, ApiModel } from "@microsoft/api-extractor-model";
+import { CapabilityInputError } from "../../../../../capability-runtime.js";
+import { pathTraversesSymbolicLink } from "../../../../../filesystem-path-safety.js";
+import { assertNotCancelled } from "../../../../../strict-yaml.js";
+import { compareCanonicalReferences } from "../../../application/model/public-api.js";
+function inputError(code, message, phase) {
+    throw new CapabilityInputError({ code, message, phase, retryable: false });
+}
+function contained(parent, candidate) {
+    const relation = relative(parent, candidate);
+    return (relation === "" ||
+        (!isAbsolute(relation) && relation !== ".." && !relation.startsWith(`..${sep}`)));
+}
+async function safePath(root, repositoryPath, kind) {
+    const candidate = resolve(root, repositoryPath);
+    if (await pathTraversesSymbolicLink(root, candidate)) {
+        inputError("PUBLIC_API_PATH_SYMLINK_PROHIBITED", `Public API ${kind} cannot traverse a symbolic link: ${repositoryPath}.`, "public-api-extraction");
+    }
+    const canonical = await realpath(candidate).catch(() => inputError("PUBLIC_API_PATH_UNAVAILABLE", `Public API ${kind} is unavailable: ${repositoryPath}.`, "public-api-extraction"));
+    if (!contained(root, canonical)) {
+        inputError("PUBLIC_API_PATH_ESCAPE", `Public API ${kind} escapes the consumer repository: ${repositoryPath}.`, "public-api-extraction");
+    }
+    const metadata = await stat(canonical);
+    if ((kind === "file" && !metadata.isFile()) || (kind === "directory" && !metadata.isDirectory())) {
+        inputError("PUBLIC_API_PATH_INVALID", `Public API path is not a ${kind}: ${repositoryPath}.`, "public-api-extraction");
+    }
+    return canonical;
+}
+function collectItems(item, output) {
+    if (item instanceof ApiDeclaredItem) {
+        const parent = item.parent;
+        output.push({
+            canonicalReference: item.canonicalReference.toString(),
+            kind: item.kind,
+            ...(parent === undefined
+                ? {}
+                : { parentReference: parent.canonicalReference.toString() }),
+            parentKind: parent?.kind ?? "None",
+            signature: item.excerpt.text.replaceAll("\r\n", "\n").trim()
+        });
+    }
+    for (const member of item.members) {
+        collectItems(member, output);
+    }
+}
+export class MicrosoftPublicApiExtractor {
+    async extract(consumerRoot, policy, packageVersion, signal) {
+        assertNotCancelled(signal);
+        const canonicalRoot = await realpath(consumerRoot).catch(() => inputError("CONSUMER_ROOT_UNAVAILABLE", "Consumer root must be an existing accessible directory.", "public-api-extraction"));
+        const [packageRoot, manifestPath, entryPoint, tsconfigPath] = await Promise.all([
+            safePath(canonicalRoot, policy.packageRoot, "directory"),
+            safePath(canonicalRoot, policy.manifestPath, "file"),
+            safePath(canonicalRoot, policy.declarationEntryPoint, "file"),
+            safePath(canonicalRoot, policy.tsconfigPath, "file")
+        ]);
+        let manifest;
+        try {
+            manifest = JSON.parse(await readFile(manifestPath, "utf8"));
+        }
+        catch {
+            inputError("PUBLIC_API_PACKAGE_MANIFEST_INVALID", `Package manifest is not valid JSON: ${policy.manifestPath}.`, "public-api-extraction");
+        }
+        if (manifest.name !== policy.packageName) {
+            inputError("PUBLIC_API_PACKAGE_IDENTITY_INVALID", `Package manifest identity does not match ${policy.packageName}.`, "public-api-extraction");
+        }
+        const outputRoot = await mkdtemp(join(tmpdir(), "agent-teams-api-extractor-"));
+        try {
+            const apiJsonPath = join(outputRoot, "surface.api.json");
+            const config = ExtractorConfig.prepare({
+                configObject: {
+                    projectFolder: packageRoot,
+                    mainEntryPointFilePath: entryPoint,
+                    compiler: { tsconfigFilePath: tsconfigPath },
+                    apiReport: { enabled: false },
+                    docModel: {
+                        enabled: true,
+                        apiJsonFilePath: apiJsonPath,
+                        includeForgottenExports: false
+                    },
+                    dtsRollup: { enabled: false },
+                    tsdocMetadata: { enabled: false },
+                    newlineKind: "lf",
+                    testMode: true,
+                    messages: {
+                        compilerMessageReporting: {
+                            default: { logLevel: ExtractorLogLevel.Error }
+                        },
+                        extractorMessageReporting: {
+                            default: { logLevel: ExtractorLogLevel.Warning },
+                            "ae-forgotten-export": { logLevel: ExtractorLogLevel.Error },
+                            "ae-missing-release-tag": { logLevel: ExtractorLogLevel.None },
+                            "ae-undocumented": { logLevel: ExtractorLogLevel.None }
+                        },
+                        tsdocMessageReporting: {
+                            default: { logLevel: ExtractorLogLevel.Warning }
+                        }
+                    }
+                },
+                configObjectFullPath: undefined,
+                packageJsonFullPath: manifestPath,
+                projectFolderLookupToken: packageRoot
+            });
+            const errors = [];
+            const result = Extractor.invoke(config, {
+                localBuild: true,
+                showVerboseMessages: false,
+                messageCallback(message) {
+                    if (message.logLevel === ExtractorLogLevel.Error) {
+                        errors.push(message.messageId);
+                    }
+                    message.handled = true;
+                }
+            });
+            assertNotCancelled(signal);
+            if (!result.succeeded || errors.length > 0) {
+                inputError("PUBLIC_API_EXTRACTION_FAILED", `API Extractor failed with message(s): ${[...new Set(errors)].toSorted().join(", ") || "unknown"}.`, "public-api-extraction");
+            }
+            const apiJsonSource = await readFile(apiJsonPath, "utf8");
+            if (apiJsonSource.length > 32 * 1024 * 1024) {
+                inputError("PUBLIC_API_SURFACE_TOO_LARGE", "Generated public API surface exceeds 32 MiB.", "public-api-extraction");
+            }
+            const model = new ApiModel();
+            const apiPackage = model.loadPackage(apiJsonPath);
+            const items = [];
+            collectItems(apiPackage, items);
+            return {
+                schemaVersion: 1,
+                packageName: policy.packageName,
+                packageVersion,
+                extractorVersion: Extractor.version,
+                items: items.toSorted((left, right) => compareCanonicalReferences(left.canonicalReference, right.canonicalReference))
+            };
+        }
+        finally {
+            await rm(outputRoot, { recursive: true, force: true });
+        }
+    }
+}
+//# sourceMappingURL=microsoft-public-api-extractor.js.map

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

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

package/dist/capabilities/public-api-compatibility/adapters/outbound/crypto/node-change-fingerprint.d.ts

@@ -0,0 +1,5 @@
+import type { ChangeFingerprint } from "../../../application/ports/change-fingerprint.js";
+export declare class NodeChangeFingerprint implements ChangeFingerprint {
+    sha256(value: string): string;
+}
+//# sourceMappingURL=node-change-fingerprint.d.ts.map

package/dist/capabilities/public-api-compatibility/adapters/outbound/crypto/node-change-fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-change-fingerprint.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/public-api-compatibility/adapters/outbound/crypto/node-change-fingerprint.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AAE1F,qBAAa,qBAAsB,YAAW,iBAAiB;IAC7D,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5B;CACF"}

package/dist/capabilities/public-api-compatibility/adapters/outbound/crypto/node-change-fingerprint.js

@@ -0,0 +1,7 @@
+import { createHash } from "node:crypto";
+export class NodeChangeFingerprint {
+    sha256(value) {
+        return createHash("sha256").update(value, "utf8").digest("hex");
+    }
+}
+//# sourceMappingURL=node-change-fingerprint.js.map

package/dist/capabilities/public-api-compatibility/adapters/outbound/crypto/node-change-fingerprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-change-fingerprint.js","sourceRoot":"","sources":["../../../../../../src/capabilities/public-api-compatibility/adapters/outbound/crypto/node-change-fingerprint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzC,MAAM,OAAO,qBAAqB;IAChC,MAAM,CAAC,KAAa;QAClB,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClE,CAAC;CACF"}

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

@@ -0,0 +1,9 @@
+import type { PackageReleaseEvidence, PublicApiPackagePolicy, PublicApiSnapshot } from "../../../application/model/public-api.js";
+import type { PublicApiRepository } from "../../../application/ports/public-api-repository.js";
+export declare class FilesystemPublicApiRepository implements PublicApiRepository {
+    readReleasedBaseline(consumerRoot: string, policy: PublicApiPackagePolicy, signal?: AbortSignal): Promise<PublicApiSnapshot>;
+    readReleaseEvidence(consumerRoot: string, changesetDirectory: string, policy: PublicApiPackagePolicy, signal?: AbortSignal): Promise<PackageReleaseEvidence>;
+    isAcceptedDecision(consumerRoot: string, decisionPath: string, signal?: AbortSignal): Promise<boolean>;
+    writeReleasedBaseline(consumerRoot: string, policy: PublicApiPackagePolicy, snapshot: PublicApiSnapshot, signal?: AbortSignal): Promise<void>;
+}
+//# sourceMappingURL=filesystem-public-api-repository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-public-api-repository.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/public-api-compatibility/adapters/outbound/filesystem/filesystem-public-api-repository.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EACV,sBAAsB,EAEtB,sBAAsB,EACtB,iBAAiB,EAElB,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAC;AAiK/F,qBAAa,6BAA8B,YAAW,mBAAmB;IACjE,oBAAoB,CACxB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,sBAAsB,EAC9B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAmE5B;IAEK,mBAAmB,CACvB,YAAY,EAAE,MAAM,EACpB,kBAAkB,EAAE,MAAM,EAC1B,MAAM,EAAE,sBAAsB,EAC9B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,sBAAsB,CAAC,CAqCjC;IAEK,kBAAkB,CACtB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC,CAiBlB;IAEK,qBAAqB,CACzB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,sBAAsB,EAC9B,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAuBf;CACF"}

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

@@ -0,0 +1,205 @@
+import { lstat, mkdtemp, opendir, readFile, realpath, rename, rm, stat, writeFile } from "node:fs/promises";
+import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { CapabilityInputError } from "../../../../../capability-runtime.js";
+import { pathTraversesSymbolicLink } from "../../../../../filesystem-path-safety.js";
+import { assertSchema } from "../../../../../schema-catalog.js";
+import { isExactVersion } from "../../../../../semantic-version.js";
+import { assertNotCancelled, parseStrictYamlSource } from "../../../../../strict-yaml.js";
+import { compareCanonicalReferences } from "../../../application/model/public-api.js";
+const MAX_INPUT_BYTES = 32 * 1024 * 1024;
+const BUMP_RANK = {
+    patch: 0,
+    minor: 1,
+    major: 2
+};
+function inputError(code, message, phase) {
+    throw new CapabilityInputError({ code, message, phase, retryable: false });
+}
+function contained(parent, candidate) {
+    const relation = relative(parent, candidate);
+    return (relation === "" ||
+        (!isAbsolute(relation) && relation !== ".." && !relation.startsWith(`..${sep}`)));
+}
+async function canonicalRoot(consumerRoot) {
+    return realpath(consumerRoot).catch(() => inputError("CONSUMER_ROOT_UNAVAILABLE", "Consumer root must be an existing accessible directory.", "public-api-evidence"));
+}
+async function safePath(root, repositoryPath, kind) {
+    const candidate = resolve(root, repositoryPath);
+    if (await pathTraversesSymbolicLink(root, candidate)) {
+        inputError("PUBLIC_API_EVIDENCE_SYMLINK_PROHIBITED", `Public API evidence cannot traverse a symbolic link: ${repositoryPath}.`, "public-api-evidence");
+    }
+    const canonical = await realpath(candidate).catch(() => inputError("PUBLIC_API_EVIDENCE_UNAVAILABLE", `Public API evidence is unavailable: ${repositoryPath}.`, "public-api-evidence"));
+    if (!contained(root, canonical)) {
+        inputError("PUBLIC_API_EVIDENCE_ESCAPE", `Public API evidence escapes the consumer repository: ${repositoryPath}.`, "public-api-evidence");
+    }
+    const metadata = await stat(canonical);
+    if ((kind === "file" && (!metadata.isFile() || metadata.size > MAX_INPUT_BYTES)) ||
+        (kind === "directory" && !metadata.isDirectory())) {
+        inputError("PUBLIC_API_EVIDENCE_INVALID", `Public API evidence is not a valid ${kind}: ${repositoryPath}.`, "public-api-evidence");
+    }
+    return canonical;
+}
+function record(value, field) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        inputError("PUBLIC_API_EVIDENCE_INVALID", `${field} must be an object.`, "public-api-evidence");
+    }
+    return value;
+}
+function mapItem(value, index) {
+    const item = record(value, `items[${index}]`);
+    return Object.freeze({
+        canonicalReference: String(item["canonicalReference"]),
+        kind: String(item["kind"]),
+        ...(typeof item["parentReference"] === "string"
+            ? { parentReference: item["parentReference"] }
+            : {}),
+        parentKind: String(item["parentKind"]),
+        signature: String(item["signature"])
+    });
+}
+function strongerBump(current, candidate) {
+    if (candidate !== "patch" && candidate !== "minor" && candidate !== "major") {
+        return current;
+    }
+    return current === undefined || BUMP_RANK[candidate] > BUMP_RANK[current]
+        ? candidate
+        : current;
+}
+function changesetFrontmatter(source) {
+    const normalized = source.replaceAll("\r\n", "\n");
+    if (!normalized.startsWith("---\n")) {
+        return undefined;
+    }
+    const end = normalized.indexOf("\n---\n", 4);
+    return end === -1 ? undefined : normalized.slice(4, end);
+}
+async function declaredBump(directory, packageName, signal) {
+    let bump;
+    const entries = [];
+    const handle = await opendir(directory);
+    for await (const entry of handle) {
+        assertNotCancelled(signal);
+        if (entry.isSymbolicLink()) {
+            inputError("CHANGESET_SYMLINK_PROHIBITED", `Changeset entries cannot be symbolic links: ${entry.name}.`, "public-api-evidence");
+        }
+        if (entry.isFile() && entry.name.endsWith(".md") && entry.name !== "README.md") {
+            entries.push(entry.name);
+        }
+    }
+    for (const name of entries.toSorted()) {
+        const path = resolve(directory, name);
+        const metadata = await lstat(path);
+        if (!metadata.isFile() || metadata.size > 1024 * 1024) {
+            inputError("CHANGESET_INVALID", `Changeset must be a regular file no larger than 1 MiB: ${name}.`, "public-api-evidence");
+        }
+        const frontmatter = changesetFrontmatter(await readFile(path, "utf8"));
+        if (frontmatter === undefined) {
+            inputError("CHANGESET_INVALID", `Changeset has invalid frontmatter: ${name}.`, "public-api-evidence");
+        }
+        const parsed = record(parseStrictYamlSource(frontmatter, "public-api-changeset"), `changeset ${name}`);
+        bump = strongerBump(bump, parsed[packageName]);
+    }
+    return bump;
+}
+export class FilesystemPublicApiRepository {
+    async readReleasedBaseline(consumerRoot, policy, signal) {
+        assertNotCancelled(signal);
+        const root = await canonicalRoot(consumerRoot);
+        const baselinePath = await safePath(root, policy.releasedBaselinePath, "file");
+        let input;
+        try {
+            input = JSON.parse(await readFile(baselinePath, "utf8"));
+        }
+        catch {
+            inputError("PUBLIC_API_BASELINE_INVALID", `Released API baseline is not valid JSON: ${policy.releasedBaselinePath}.`, "public-api-evidence");
+        }
+        await assertSchema("package-public-api-baseline/v1", input, "public-api-baseline");
+        const baseline = record(input, "released API baseline");
+        const itemsInput = baseline["items"];
+        if (!Array.isArray(itemsInput)) {
+            inputError("PUBLIC_API_BASELINE_INVALID", "Released API baseline items must be an array.", "public-api-evidence");
+        }
+        const items = itemsInput.map(mapItem);
+        const references = items.map((item) => item.canonicalReference);
+        const sortedReferences = references.toSorted(compareCanonicalReferences);
+        if (new Set(references).size !== references.length ||
+            references.some((value, index) => value !== sortedReferences[index])) {
+            inputError("PUBLIC_API_BASELINE_INVALID", "Released API baseline items must have unique sorted canonical references.", "public-api-evidence");
+        }
+        const packageName = String(baseline["packageName"]);
+        if (packageName !== policy.packageName) {
+            inputError("PUBLIC_API_BASELINE_INVALID", `Released API baseline package does not match ${policy.packageName}.`, "public-api-evidence");
+        }
+        const packageVersion = String(baseline["packageVersion"]);
+        if (!isExactVersion(packageVersion)) {
+            inputError("PUBLIC_API_BASELINE_INVALID", `Released API baseline version is not exact SemVer: ${packageVersion}.`, "public-api-evidence");
+        }
+        return Object.freeze({
+            schemaVersion: 1,
+            packageName,
+            packageVersion,
+            extractorVersion: String(baseline["extractorVersion"]),
+            items: Object.freeze(items)
+        });
+    }
+    async readReleaseEvidence(consumerRoot, changesetDirectory, policy, signal) {
+        assertNotCancelled(signal);
+        const root = await canonicalRoot(consumerRoot);
+        const [manifestPath, changesetPath] = await Promise.all([
+            safePath(root, policy.manifestPath, "file"),
+            safePath(root, changesetDirectory, "directory")
+        ]);
+        let manifestInput;
+        try {
+            manifestInput = JSON.parse(await readFile(manifestPath, "utf8"));
+        }
+        catch {
+            inputError("PUBLIC_API_PACKAGE_MANIFEST_INVALID", `Package manifest is not valid JSON: ${policy.manifestPath}.`, "public-api-evidence");
+        }
+        const manifest = record(manifestInput, "package manifest");
+        const packageName = manifest["name"];
+        const packageVersion = manifest["version"];
+        if (packageName !== policy.packageName ||
+            typeof packageVersion !== "string" ||
+            !isExactVersion(packageVersion)) {
+            inputError("PUBLIC_API_PACKAGE_IDENTITY_INVALID", `Package manifest identity or version is invalid: ${policy.manifestPath}.`, "public-api-evidence");
+        }
+        const bump = await declaredBump(changesetPath, policy.packageName, signal);
+        return {
+            packageName: policy.packageName,
+            packageVersion,
+            ...(bump === undefined ? {} : { declaredBump: bump })
+        };
+    }
+    async isAcceptedDecision(consumerRoot, decisionPath, signal) {
+        assertNotCancelled(signal);
+        const root = await canonicalRoot(consumerRoot);
+        const source = await readFile(await safePath(root, decisionPath, "file"), "utf8");
+        const metadataLines = source.replaceAll("\r\n", "\n").split("\n").slice(0, 30);
+        const heading = metadataLines[0] ?? "";
+        const sectionBoundary = metadataLines.findIndex((line, index) => index > 0 && line.startsWith("## "));
+        const firstSection = metadataLines.slice(0, sectionBoundary === -1 ? metadataLines.length : sectionBoundary);
+        return (/^# ADR-[0-9]{4}:/u.test(heading) &&
+            firstSection.some((line) => line.trim() === "Status: Accepted"));
+    }
+    async writeReleasedBaseline(consumerRoot, policy, snapshot, signal) {
+        assertNotCancelled(signal);
+        const root = await canonicalRoot(consumerRoot);
+        const baselinePath = await safePath(root, policy.releasedBaselinePath, "file");
+        await assertSchema("package-public-api-baseline/v1", snapshot, "public-api-baseline-promotion");
+        const temporaryDirectory = await mkdtemp(join(dirname(baselinePath), ".public-api-baseline-"));
+        try {
+            const temporaryPath = join(temporaryDirectory, "baseline.json");
+            await writeFile(temporaryPath, `${JSON.stringify(snapshot, null, 2)}\n`, {
+                encoding: "utf8",
+                mode: 0o644
+            });
+            assertNotCancelled(signal);
+            await rename(temporaryPath, baselinePath);
+        }
+        finally {
+            await rm(temporaryDirectory, { recursive: true, force: true });
+        }
+    }
+}
+//# sourceMappingURL=filesystem-public-api-repository.js.map

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

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

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

@@ -0,0 +1,46 @@
+export type ReleaseBump = "major" | "minor" | "patch";
+export interface PublicApiItem {
+    readonly canonicalReference: string;
+    readonly kind: string;
+    readonly parentReference?: string;
+    readonly parentKind: string;
+    readonly signature: string;
+}
+export declare function compareCanonicalReferences(left: string, right: string): number;
+export interface PublicApiSnapshot {
+    readonly schemaVersion: 1;
+    readonly packageName: string;
+    readonly packageVersion: string;
+    readonly extractorVersion: string;
+    readonly items: readonly PublicApiItem[];
+}
+export interface ApprovedBreakingChange {
+    readonly fingerprint: string;
+    readonly decisionPath: string;
+}
+export interface PublicApiPackagePolicy {
+    readonly packageName: string;
+    readonly packageRoot: string;
+    readonly manifestPath: string;
+    readonly declarationEntryPoint: string;
+    readonly tsconfigPath: string;
+    readonly releasedBaselinePath: string;
+    readonly approvedBreakingChanges: readonly ApprovedBreakingChange[];
+}
+export interface PublicApiCompatibilityPolicy {
+    readonly changesetDirectory: string;
+    readonly packages: readonly PublicApiPackagePolicy[];
+}
+export interface PublicApiChangeSet {
+    readonly classification: "additive" | "breaking" | "none";
+    readonly fingerprint?: string;
+    readonly added: readonly string[];
+    readonly changed: readonly string[];
+    readonly removed: readonly string[];
+}
+export interface PackageReleaseEvidence {
+    readonly packageName: string;
+    readonly packageVersion: string;
+    readonly declaredBump?: ReleaseBump;
+}
+//# sourceMappingURL=public-api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"public-api.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/public-api-compatibility/application/model/public-api.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAEtD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,uBAAuB,EAAE,SAAS,sBAAsB,EAAE,CAAC;CACrE;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,SAAS,sBAAsB,EAAE,CAAC;CACtD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,cAAc,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;IAC1D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,WAAW,CAAC;CACrC"}

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

@@ -0,0 +1,4 @@
+export function compareCanonicalReferences(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+//# sourceMappingURL=public-api.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"public-api.js","sourceRoot":"","sources":["../../../../../src/capabilities/public-api-compatibility/application/model/public-api.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,0BAA0B,CAAC,IAAY,EAAE,KAAa;IACpE,OAAO,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC"}

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

@@ -0,0 +1,13 @@
+import type { FoundationDiagnostic } from "../../../../check-contract.js";
+import type { ChangeFingerprint } from "../ports/change-fingerprint.js";
+import type { PackageReleaseEvidence, PublicApiChangeSet, PublicApiPackagePolicy, PublicApiSnapshot } from "../model/public-api.js";
+export declare function classifyPublicApiChange(releasedSnapshot: PublicApiSnapshot, currentSnapshot: PublicApiSnapshot, fingerprint: ChangeFingerprint): PublicApiChangeSet;
+export declare function evaluatePublicApiCompatibility(input: {
+    readonly policy: PublicApiPackagePolicy;
+    readonly released: PublicApiSnapshot;
+    readonly current: PublicApiSnapshot;
+    readonly change: PublicApiChangeSet;
+    readonly releaseEvidence: PackageReleaseEvidence;
+    readonly acceptedDecision: boolean | undefined;
+}): readonly FoundationDiagnostic[];
+//# sourceMappingURL=evaluate-public-api-compatibility.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate-public-api-compatibility.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/public-api-compatibility/application/policies/evaluate-public-api-compatibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAE1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAExE,OAAO,KAAK,EACV,sBAAsB,EACtB,kBAAkB,EAElB,sBAAsB,EACtB,iBAAiB,EAElB,MAAM,wBAAwB,CAAC;AAiEhC,wBAAgB,uBAAuB,CACrC,gBAAgB,EAAE,iBAAiB,EACnC,eAAe,EAAE,iBAAiB,EAClC,WAAW,EAAE,iBAAiB,GAC7B,kBAAkB,CA4CpB;AASD,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IACpD,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,sBAAsB,CAAC;IACjD,QAAQ,CAAC,gBAAgB,EAAE,OAAO,GAAG,SAAS,CAAC;CAChD,GAAG,SAAS,oBAAoB,EAAE,CAgGlC"}