@agent-teams/docs-protocol-agent-teams 0.0.0

package/dist/consumer-integration/adapters/foundation-known-file-transaction.d.ts

@@ -0,0 +1,3 @@
+import type { ConsumerIntegrationTransactionPort } from "../application/ports/consumer-integration-lifecycle.js";
+export declare const foundationKnownFileTransaction: ConsumerIntegrationTransactionPort;
+//# sourceMappingURL=foundation-known-file-transaction.d.ts.map

package/dist/consumer-integration/adapters/foundation-known-file-transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundation-known-file-transaction.d.ts","sourceRoot":"","sources":["../../../src/consumer-integration/adapters/foundation-known-file-transaction.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,kCAAkC,EACnC,MAAM,wDAAwD,CAAC;AAEhE,eAAO,MAAM,8BAA8B,EAAE,kCAKzC,CAAC"}

package/dist/consumer-integration/adapters/foundation-known-file-transaction.js

@@ -0,0 +1,7 @@
+import { applyKnownFileTransaction, inspectKnownFileTransactionBarrier, recoverKnownFileTransaction } from "@agent-teams/repository-mutation";
+export const foundationKnownFileTransaction = Object.freeze({
+    inspect: inspectKnownFileTransactionBarrier,
+    apply: applyKnownFileTransaction,
+    recover: recoverKnownFileTransaction
+});
+//# sourceMappingURL=foundation-known-file-transaction.js.map

package/dist/consumer-integration/adapters/foundation-known-file-transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundation-known-file-transaction.js","sourceRoot":"","sources":["../../../src/consumer-integration/adapters/foundation-known-file-transaction.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,kCAAkC,EAClC,2BAA2B,EAC5B,MAAM,kCAAkC,CAAC;AAM1C,MAAM,CAAC,MAAM,8BAA8B,GACzC,MAAM,CAAC,MAAM,CAAC;IACZ,OAAO,EAAE,kCAAkC;IAC3C,KAAK,EAAE,yBAAyB;IAChC,OAAO,EAAE,2BAA2B;CACrC,CAAC,CAAC"}

package/dist/consumer-integration/adapters/github-cohort-authority-reader.d.ts

@@ -0,0 +1,21 @@
+import type { ConsumerUpgradeAuthorityReader } from "../application/ports/consumer-upgrade.js";
+import type { ConsumerIntegrationDesiredStateV1, ConsumerUpgradeAuthorityV1 } from "../domain/model.js";
+type AuthorityFetch = (input: string | URL | globalThis.Request, init?: RequestInit) => Promise<Response>;
+export declare function projectQualifiedCohortAuthority(input: {
+    readonly cohortId: string;
+    readonly registry: Record<string, unknown>;
+    readonly repository: ConsumerIntegrationDesiredStateV1["repository"];
+    readonly revision: string;
+}): ConsumerUpgradeAuthorityV1;
+export declare class GitHubCohortAuthorityReader implements ConsumerUpgradeAuthorityReader {
+    #private;
+    constructor(fetcher?: AuthorityFetch);
+    read(options: {
+        readonly cohortId: string;
+        readonly repository: ConsumerIntegrationDesiredStateV1["repository"];
+        readonly revision?: string;
+    }): Promise<ConsumerUpgradeAuthorityV1>;
+}
+export declare const githubCohortAuthorityReader: ConsumerUpgradeAuthorityReader;
+export {};
+//# sourceMappingURL=github-cohort-authority-reader.d.ts.map

package/dist/consumer-integration/adapters/github-cohort-authority-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-cohort-authority-reader.d.ts","sourceRoot":"","sources":["../../../src/consumer-integration/adapters/github-cohort-authority-reader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,8BAA8B,EAC/B,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EACV,iCAAiC,EACjC,0BAA0B,EAE3B,MAAM,oBAAoB,CAAC;AAkB5B,KAAK,cAAc,GAAG,CACpB,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,UAAU,CAAC,OAAO,EACxC,IAAI,CAAC,EAAE,WAAW,KACf,OAAO,CAAC,QAAQ,CAAC,CAAC;AA+OvB,wBAAgB,+BAA+B,CAAC,KAAK,EAAE;IACrD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,iCAAiC,CAAC,YAAY,CAAC,CAAC;IACrE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,GAAG,0BAA0B,CAsB7B;AAED,qBAAa,2BAA4B,YAAW,8BAA8B;;IAGhF,YAAmB,OAAO,GAAE,cAAiC,EAE5D;IAEY,IAAI,CAAC,OAAO,EAAE;QACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,UAAU,EAAE,iCAAiC,CAAC,YAAY,CAAC,CAAC;QACrE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;KAC5B,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAgBtC;CACF;AAED,eAAO,MAAM,2BAA2B,EAAE,8BACQ,CAAC"}

package/dist/consumer-integration/adapters/github-cohort-authority-reader.js

@@ -0,0 +1,215 @@
+import { assertQualifiedDocsCohortBindingV1 } from "../application/policies/consumer-integration-desired-state.js";
+import { ConsumerIntegrationNodeError } from "./consumer-integration-node-error.js";
+import { parseJsonRecord } from "./strict-json-record.js";
+const AUTHORITY_REPOSITORY = "agent-teams-ai/.github";
+const AUTHORITY_PATH = "governance/docs-qualified-cohorts.json";
+const AUTHORITY_API = `https://api.github.com/repos/${AUTHORITY_REPOSITORY}`;
+const AUTHORITY_RAW = `https://raw.githubusercontent.com/${AUTHORITY_REPOSITORY}`;
+const GIT_SHA = /^(?!0{40}$)[0-9a-f]{40}$/u;
+const MAXIMUM_AUTHORITY_BYTES = 8 * 1024 * 1024;
+const MANAGED_PACKAGES = [
+    "@agent-teams/docs-protocol",
+    "@agent-teams/engineering-foundation"
+];
+function record(value, subject) {
+    if (typeof value !== "object" || value === null || Array.isArray(value) ||
+        Object.getPrototypeOf(value) !== Object.prototype) {
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_AUTHORITY_INVALID", `${subject} must be one plain object.`);
+    }
+    return value;
+}
+function array(value, subject) {
+    if (!Array.isArray(value) || value.length > 4096) {
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_AUTHORITY_INVALID", `${subject} must be one bounded array.`);
+    }
+    return value;
+}
+function string(value, subject) {
+    if (typeof value !== "string" || value.length === 0 || value.length > 4096 ||
+        value.includes("\u0000")) {
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_AUTHORITY_INVALID", `${subject} must be one bounded string.`);
+    }
+    return value;
+}
+async function responseBytes(response, subject) {
+    if (!response.ok) {
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_AUTHORITY_UNAVAILABLE", `${subject} returned HTTP ${response.status}.`);
+    }
+    const declared = Number(response.headers.get("content-length") ?? "0");
+    if (Number.isFinite(declared) && declared > MAXIMUM_AUTHORITY_BYTES) {
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_AUTHORITY_INVALID", `${subject} exceeds the authority size limit.`);
+    }
+    const bytes = new Uint8Array(await response.arrayBuffer());
+    if (bytes.byteLength === 0 || bytes.byteLength > MAXIMUM_AUTHORITY_BYTES) {
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_AUTHORITY_INVALID", `${subject} has invalid or overlong bytes.`);
+    }
+    return bytes;
+}
+function timeoutSignal() {
+    return AbortSignal.timeout(20_000);
+}
+async function resolveAuthorityRevision(fetcher) {
+    const bytes = await responseBytes(await fetcher(`${AUTHORITY_API}/commits/main`, {
+        headers: { Accept: "application/vnd.github+json", "User-Agent": "agent-teams-docs" },
+        redirect: "error",
+        signal: timeoutSignal()
+    }), "Central authority revision");
+    const response = parseJsonRecord(new TextDecoder("utf-8", { fatal: true }).decode(bytes));
+    const revision = response["sha"];
+    if (typeof revision !== "string" || !GIT_SHA.test(revision)) {
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_AUTHORITY_INVALID", "Central authority did not resolve one exact Git revision.");
+    }
+    return revision;
+}
+async function readAuthorityRegistry(fetcher, revision) {
+    const bytes = await responseBytes(await fetcher(`${AUTHORITY_RAW}/${revision}/${AUTHORITY_PATH}`, {
+        headers: { Accept: "application/json", "User-Agent": "agent-teams-docs" },
+        redirect: "error",
+        signal: timeoutSignal()
+    }), "Central Cohort registry");
+    try {
+        return parseJsonRecord(new TextDecoder("utf-8", { fatal: true }).decode(bytes));
+    }
+    catch (error) {
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_AUTHORITY_INVALID", "Central Cohort registry is not strict duplicate-free UTF-8 JSON.", { cause: error });
+    }
+}
+function selectedLifecycleState(events, cohortId) {
+    const selected = events.map((value) => record(value, "Cohort lifecycle event"))
+        .filter((event) => event["cohort_id"] === cohortId)
+        .map((event) => {
+        const sequence = event["sequence"];
+        if (!Number.isSafeInteger(sequence) || Number(sequence) < 1) {
+            throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_AUTHORITY_INVALID", `${cohortId} has an invalid lifecycle sequence.`);
+        }
+        return { event, sequence: Number(sequence) };
+    })
+        .toSorted((left, right) => left.sequence - right.sequence);
+    if (new Set(selected.map(({ sequence }) => sequence)).size !== selected.length) {
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_AUTHORITY_INVALID", `${cohortId} has duplicate lifecycle sequences.`);
+    }
+    const qualification = selected.filter(({ event }) => event["state"] === "QUALIFIED");
+    const last = selected.at(-1);
+    if (qualification.length !== 1 || last === undefined) {
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_AUTHORITY_INVALID", `${cohortId} does not have one immutable QUALIFIED lifecycle event.`);
+    }
+    return {
+        qualificationEventDigest: string(qualification[0].event["event_digest"], "QUALIFIED event digest"),
+        state: string(last.event["state"], "Current Cohort lifecycle state")
+    };
+}
+function assertSelectable(source, state, repository) {
+    if (state === "RECOMMENDED") {
+        return;
+    }
+    const canaries = array(source["canary_repositories"], "Cohort canary repositories")
+        .map((entry) => record(entry, "Cohort canary repository"));
+    if (["QUALIFIED", "CANARY"].includes(state) && canaries.some((entry) => String(entry["repository_id"]) === repository.id)) {
+        return;
+    }
+    throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_COHORT_NOT_SELECTABLE", `${String(source["cohort_id"])} is ${state} and is not selectable for repository ${repository.id}.`);
+}
+function packageProjection(source) {
+    const entries = array(source["packages"], "Cohort packages")
+        .map((value) => record(value, "Cohort package"));
+    const packageByName = new Map(entries.map((entry) => [entry["name"], entry]));
+    if (entries.length !== MANAGED_PACKAGES.length ||
+        packageByName.size !== MANAGED_PACKAGES.length ||
+        MANAGED_PACKAGES.some((name) => !packageByName.has(name))) {
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_AUTHORITY_INVALID", "Qualified Cohort must select exactly the two managed packages.");
+    }
+    const docs = packageByName.get(MANAGED_PACKAGES[0]);
+    const foundation = packageByName.get(MANAGED_PACKAGES[1]);
+    return {
+        docsProtocol: {
+            version: string(docs["version"], "Docs Protocol version"),
+            integrity: string(docs["integrity"], "Docs Protocol integrity")
+        },
+        engineeringFoundation: {
+            version: string(foundation["version"], "Foundation version"),
+            integrity: string(foundation["integrity"], "Foundation integrity")
+        }
+    };
+}
+function cohortProjection(source, qualificationEventDigest) {
+    const workflow = record(source["reusable_workflow"], "Cohort reusable workflow");
+    const assets = record(source["assets"], "Cohort assets");
+    const skill = record(assets["skill"], "Cohort Skill asset");
+    const caller = record(assets["caller_workflow"], "Cohort caller workflow asset");
+    const assetCatalog = record(assets["asset_catalog"], "Cohort asset catalog");
+    const transitionCatalog = record(assets["transition_catalog"], "Cohort transition catalog");
+    const runtime = record(source["runtime"], "Cohort runtime");
+    const runtimeClosure = record(source["runtime_closure"], "Cohort runtime closure");
+    const schemas = record(source["schemas"], "Cohort schemas");
+    const projection = {
+        schemaVersion: 1,
+        cohortId: string(source["cohort_id"], "Cohort ID"),
+        channel: string(source["channel"], "Cohort channel"),
+        recordDigest: string(source["record_digest"], "Cohort record digest"),
+        qualificationEventDigest,
+        eligibleAfter: string(source["eligible_after"], "Cohort eligibility timestamp"),
+        upgradeFrom: array(source["upgrade_from"], "Cohort upgrade origins").map((entry) => string(entry, "Cohort upgrade origin")),
+        rollbackTo: array(source["rollback_to"], "Cohort rollback targets").map((entry) => string(entry, "Cohort rollback target")),
+        packages: packageProjection(source),
+        workflow: {
+            repository: string(workflow["repository"], "Workflow repository"),
+            path: string(workflow["path"], "Workflow path"),
+            revision: string(workflow["revision"], "Workflow revision"),
+            blobSha: string(workflow["blob_sha"], "Workflow blob SHA")
+        },
+        assets: {
+            skillDigest: string(skill["digest"], "Skill digest"),
+            callerWorkflowDigest: string(caller["rendered_digest"], "Caller workflow digest"),
+            assetCatalogDigest: string(assetCatalog["digest"], "Asset catalog digest"),
+            transitionCatalogDigest: string(transitionCatalog["digest"], "Transition catalog digest")
+        },
+        schemas: {
+            consumerIntegration: schemas["consumer_integration"],
+            managedState: schemas["managed_state"],
+            docsProtocol: schemas["docs_protocol"]
+        },
+        runtime: {
+            node: string(runtime["node"], "Node runtime"),
+            pnpm: string(runtime["pnpm"], "pnpm runtime"),
+            runtimeClosureDigest: string(runtimeClosure["digest"], "Runtime closure digest")
+        }
+    };
+    assertQualifiedDocsCohortBindingV1(projection);
+    return Object.freeze(projection);
+}
+export function projectQualifiedCohortAuthority(input) {
+    const matches = array(input.registry["cohorts"], "Qualified Cohorts")
+        .map((value) => record(value, "Qualified Cohort"))
+        .filter((cohort) => cohort["cohort_id"] === input.cohortId);
+    if (matches.length !== 1) {
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_COHORT_UNKNOWN", `${input.cohortId} is not one exact central Cohort.`);
+    }
+    const source = matches[0];
+    const lifecycle = selectedLifecycleState(array(input.registry["events"], "Cohort lifecycle events"), input.cohortId);
+    assertSelectable(source, lifecycle.state, input.repository);
+    return Object.freeze({
+        repository: AUTHORITY_REPOSITORY,
+        path: AUTHORITY_PATH,
+        revision: input.revision,
+        cohort: cohortProjection(source, lifecycle.qualificationEventDigest)
+    });
+}
+export class GitHubCohortAuthorityReader {
+    #fetcher;
+    constructor(fetcher = globalThis.fetch) {
+        this.#fetcher = fetcher;
+    }
+    async read(options) {
+        if (options.revision !== undefined && !GIT_SHA.test(options.revision)) {
+            throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_AUTHORITY_REVISION_INVALID", "Authority revision must be one nonzero lowercase Git SHA.");
+        }
+        const revision = await resolveAuthorityRevision(this.#fetcher);
+        if (options.revision !== undefined && options.revision !== revision) {
+            throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_AUTHORITY_REVISION_STALE", "Requested authority revision is not the current protected main revision.");
+        }
+        const registry = await readAuthorityRegistry(this.#fetcher, revision);
+        return projectQualifiedCohortAuthority({ ...options, registry, revision });
+    }
+}
+export const githubCohortAuthorityReader = Object.freeze(new GitHubCohortAuthorityReader());
+//# sourceMappingURL=github-cohort-authority-reader.js.map

package/dist/consumer-integration/adapters/github-cohort-authority-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-cohort-authority-reader.js","sourceRoot":"","sources":["../../../src/consumer-integration/adapters/github-cohort-authority-reader.ts"],"names":[],"mappings":"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"}

package/dist/consumer-integration/adapters/node-consumer-integration-repository.d.ts

@@ -0,0 +1,13 @@
+import type { ConsumerIntegrationDesiredStateV1, ConsumerIntegrationSnapshot } from "../domain/model.js";
+import type { ConsumerIntegrationInputReader } from "../application/ports/consumer-integration-lifecycle.js";
+export { ConsumerIntegrationNodeError } from "./consumer-integration-node-error.js";
+export declare function readConsumerIntegrationInput(options: {
+    readonly consumerRoot: string;
+    readonly integrationProfilePath?: string;
+}): Promise<{
+    readonly desired: ConsumerIntegrationDesiredStateV1;
+    readonly root: string;
+    readonly snapshot: ConsumerIntegrationSnapshot;
+}>;
+export declare const nodeConsumerIntegrationInputReader: ConsumerIntegrationInputReader;
+//# sourceMappingURL=node-consumer-integration-repository.d.ts.map

package/dist/consumer-integration/adapters/node-consumer-integration-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-consumer-integration-repository.d.ts","sourceRoot":"","sources":["../../../src/consumer-integration/adapters/node-consumer-integration-repository.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,iCAAiC,EAEjC,2BAA2B,EAC5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EACV,8BAA8B,EAC/B,MAAM,wDAAwD,CAAC;AAiChE,OAAO,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC;AA4MpF,wBAAsB,4BAA4B,CAAC,OAAO,EAAE;IAC1D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;CAC1C,GAAG,OAAO,CAAC;IACV,QAAQ,CAAC,OAAO,EAAE,iCAAiC,CAAC;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;CAChD,CAAC,CAsED;AAED,eAAO,MAAM,kCAAkC,EAAE,8BACM,CAAC"}

package/dist/consumer-integration/adapters/node-consumer-integration-repository.js

@@ -0,0 +1,213 @@
+import { realpath } from "node:fs/promises";
+import { dirname } from "node:path";
+import { execFile } from "node:child_process";
+import { assertConsumerIntegrationProfileSchema } from "./consumer-integration-schema-validator.js";
+import { ConsumerIntegrationNodeError } from "./consumer-integration-node-error.js";
+import { assertQualifiedPnpmLockfileV1 } from "./pnpm-lockfile-validator-v1.js";
+import { parseJsonRecord } from "./strict-json-record.js";
+import { scanConsumerRepositoryTopology } from "./bounded-repository-topology.js";
+import { canonicalConsumerRoot, INTEGRATION_PROFILE_PATH, MAXIMUM_LOCKFILE_BYTES, MAXIMUM_MANAGED_ASSET_BYTES, MAXIMUM_MANIFEST_BYTES, MAXIMUM_PROFILE_BYTES, readStableConsumerFile, sameConsumerFileObservation } from "./node-consumer-repository-files.js";
+function executeGit(root, args, maximumBytes) {
+    return new Promise((resolve, reject) => {
+        execFile("git", [...args], {
+            cwd: root,
+            encoding: "utf8",
+            maxBuffer: maximumBytes
+        }, (error, stdout) => {
+            if (error === null) {
+                resolve(stdout);
+            }
+            else {
+                reject(error);
+            }
+        });
+    });
+}
+export { ConsumerIntegrationNodeError } from "./consumer-integration-node-error.js";
+function assertSingleIntegrationTopology(topology) {
+    if (topology.lockfiles.length !== 1 || topology.lockfiles[0] !== "pnpm-lock.yaml") {
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_NESTED_LOCKFILE_UNSUPPORTED", "V1 requires exactly one root pnpm-lock.yaml and no nested lockfiles.");
+    }
+    if (topology.integrationProfiles.length !== 1 ||
+        topology.integrationProfiles[0] !== INTEGRATION_PROFILE_PATH) {
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_MULTIPLE_INTEGRATION_UNITS", `V1 requires exactly one integration profile at ${INTEGRATION_PROFILE_PATH}.`);
+    }
+    if (topology.pnpmfiles.length > 0) {
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_PNPMFILE_UNSUPPORTED", "V1 does not permit .pnpmfile.cjs in the integration repository.");
+    }
+}
+async function assertGitRepositoryRoot(root) {
+    let gitRoot;
+    try {
+        gitRoot = await realpath((await executeGit(root, ["rev-parse", "--show-toplevel"], 64 * 1024)).trim());
+    }
+    catch (error) {
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_GIT_ROOT_INVALID", "Consumer root must be the exact top-level directory of one Git repository.", { cause: error });
+    }
+    if (gitRoot !== root) {
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_GIT_ROOT_INVALID", "Consumer root must equal the Git repository top-level directory.");
+    }
+}
+function assertNestedAgentsAuthority(topology, governedRoots) {
+    const nested = topology.agents.filter((path) => path !== "AGENTS.md");
+    const conflicting = governedRoots === undefined
+        ? nested
+        : nested.filter((path) => {
+            const authorityRoot = dirname(path);
+            return governedRoots.some((docsRoot) => authorityRoot === docsRoot ||
+                authorityRoot.startsWith(`${docsRoot}/`) ||
+                docsRoot.startsWith(`${authorityRoot}/`));
+        });
+    if (conflicting.length > 0) {
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_NESTED_AGENTS_UNSUPPORTED", `Nested AGENTS.md overlaps governed documentation authority: ${conflicting.join(", ")}.`);
+    }
+}
+function rejectPrototypeKeys(value, path = "integration profile") {
+    if (Array.isArray(value)) {
+        value.forEach((entry, index) => {
+            rejectPrototypeKeys(entry, `${path}[${index}]`);
+        });
+        return;
+    }
+    if (typeof value !== "object" || value === null) {
+        return;
+    }
+    for (const [key, entry] of Object.entries(value)) {
+        if (["__proto__", "constructor", "prototype"].includes(key)) {
+            throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_PROFILE_INVALID", `${path}.${key} is forbidden.`);
+        }
+        rejectPrototypeKeys(entry, `${path}.${key}`);
+    }
+}
+function assertGitHubRuntimeIdentity(desired) {
+    const runtimeId = process.env["GITHUB_REPOSITORY_ID"];
+    const runtimeName = process.env["GITHUB_REPOSITORY"];
+    if (runtimeId !== undefined && runtimeId !== desired.repository.id) {
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_REPOSITORY_ID_MISMATCH", "GitHub runtime repository ID does not match the committed integration profile.");
+    }
+    if (runtimeName !== undefined && runtimeName.toLowerCase() !==
+        desired.repository.nameWithOwner.toLowerCase()) {
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_REPOSITORY_NAME_MISMATCH", "GitHub runtime repository name does not match the committed integration profile.");
+    }
+}
+async function assertQualifiedPnpmRoot(root) {
+    const [major, minor] = process.versions.node.split(".").map(Number);
+    if (major !== 24 || (minor ?? 0) < 18) {
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_UNSUPPORTED_NODE", "V1 check and plan require Node >=24.18.0 <25.");
+    }
+    const manifestObservation = await readStableConsumerFile(root, "package.json", MAXIMUM_MANIFEST_BYTES, true);
+    if (manifestObservation.state !== "file") {
+        throw new Error("unreachable");
+    }
+    let manifest;
+    try {
+        manifest = parseJsonRecord(Buffer.from(manifestObservation.bytes).toString("utf8"));
+    }
+    catch (error) {
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_MANIFEST_INVALID", error instanceof Error ? error.message : "package.json is invalid.", { cause: error });
+    }
+    const packageManager = manifest["packageManager"];
+    const match = typeof packageManager === "string"
+        ? /^pnpm@(11)\.([0-9]+)\.([0-9]+)(?:\+sha512\.[A-Za-z0-9+/=]+)?$/u.exec(packageManager)
+        : null;
+    if (match === null || Number(match[2]) < 17) {
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_UNSUPPORTED_PACKAGE_MANAGER", "V1 requires one exact root packageManager declaration within >=11.17.0 <12.");
+    }
+    const nodeVersion = await readStableConsumerFile(root, ".node-version", 128, true);
+    if (nodeVersion.state !== "file" ||
+        !/^24\.(?:1[89]|[2-9][0-9])\.[0-9]+\n?$/u.test(Buffer.from(nodeVersion.bytes).toString("utf8"))) {
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_NODE_VERSION_GATE_INVALID", ".node-version must pin one exact Node version within >=24.18.0 <25.");
+    }
+    await readStableConsumerFile(root, "pnpm-lock.yaml", MAXIMUM_LOCKFILE_BYTES, true);
+    for (const path of ["package-lock.json", "yarn.lock", "bun.lock", "bun.lockb"]) {
+        if ((await readStableConsumerFile(root, path, 1024, false)).state !== "absent") {
+            throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_UNSUPPORTED_PACKAGE_MANAGER", `Multiple or unsupported package-manager evidence is present: ${path}.`);
+        }
+    }
+}
+async function assertSnapshotStillStable(input) {
+    const paths = [
+        ["integrationProfile", INTEGRATION_PROFILE_PATH, MAXIMUM_PROFILE_BYTES, true],
+        ["lockfile", "pnpm-lock.yaml", MAXIMUM_LOCKFILE_BYTES, true],
+        ["packageManifest", "package.json", MAXIMUM_MANIFEST_BYTES, true],
+        ["agents", "AGENTS.md", MAXIMUM_MANAGED_ASSET_BYTES, false],
+        ["skill", input.desired.skillPath, MAXIMUM_MANAGED_ASSET_BYTES, false],
+        ["callerWorkflow", input.desired.callerWorkflowPath, MAXIMUM_MANAGED_ASSET_BYTES, false],
+        ["managedState", input.desired.managedStatePath, MAXIMUM_MANAGED_ASSET_BYTES, false]
+    ];
+    const reread = await Promise.all(paths.map(([, path, maximum, required]) => readStableConsumerFile(input.root, path, maximum, required)));
+    const unstable = paths.find(([key], index) => !sameConsumerFileObservation(input.snapshot[key], reread[index]));
+    if (unstable !== undefined) {
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_SNAPSHOT_UNSTABLE", `Consumer integration input changed while the repository snapshot was assembled: ${unstable[1]}.`);
+    }
+}
+async function assertQualifiedLockfile(root, desired) {
+    const observation = await readStableConsumerFile(root, "pnpm-lock.yaml", MAXIMUM_LOCKFILE_BYTES, true);
+    if (observation.state !== "file") {
+        throw new Error("unreachable");
+    }
+    assertQualifiedPnpmLockfileV1(observation.bytes, desired);
+    return observation;
+}
+export async function readConsumerIntegrationInput(options) {
+    const root = await canonicalConsumerRoot(options.consumerRoot);
+    await assertGitRepositoryRoot(root);
+    const topology = await scanConsumerRepositoryTopology(root);
+    assertSingleIntegrationTopology(topology);
+    await assertQualifiedPnpmRoot(root);
+    const profilePath = options.integrationProfilePath ?? INTEGRATION_PROFILE_PATH;
+    if (profilePath !== INTEGRATION_PROFILE_PATH) {
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_PROFILE_PATH_UNSUPPORTED", `V1 requires the integration profile at ${INTEGRATION_PROFILE_PATH}.`);
+    }
+    const profile = await readStableConsumerFile(root, profilePath, MAXIMUM_PROFILE_BYTES, true);
+    if (profile.state !== "file") {
+        throw new Error("unreachable");
+    }
+    let desired;
+    let lockfile;
+    try {
+        const parsed = parseJsonRecord(Buffer.from(profile.bytes).toString("utf8"));
+        rejectPrototypeKeys(parsed);
+        await assertConsumerIntegrationProfileSchema(parsed);
+        if (parsed.schemaVersion === 2) {
+            const { qualification: _qualification, ...v1 } = parsed;
+            desired = { ...v1, schemaVersion: 1 };
+        }
+        else {
+            desired = parsed;
+        }
+        assertNestedAgentsAuthority(topology, desired.governedDocsRoots);
+        assertGitHubRuntimeIdentity(desired);
+        lockfile = await assertQualifiedLockfile(root, desired);
+    }
+    catch (error) {
+        if (error instanceof ConsumerIntegrationNodeError) {
+            throw error;
+        }
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_PROFILE_INVALID", error instanceof Error ? error.message : "Integration profile is invalid.", { cause: error });
+    }
+    const [packageManifest, agents, skill, callerWorkflow, managedState] = await Promise.all([
+        readStableConsumerFile(root, "package.json", MAXIMUM_MANIFEST_BYTES, true),
+        readStableConsumerFile(root, "AGENTS.md", MAXIMUM_MANAGED_ASSET_BYTES, false),
+        readStableConsumerFile(root, desired.skillPath, MAXIMUM_MANAGED_ASSET_BYTES, false),
+        readStableConsumerFile(root, desired.callerWorkflowPath, MAXIMUM_MANAGED_ASSET_BYTES, false),
+        readStableConsumerFile(root, desired.managedStatePath, MAXIMUM_MANAGED_ASSET_BYTES, false)
+    ]);
+    const snapshot = {
+        integrationProfile: profile,
+        lockfile,
+        packageManifest,
+        agents,
+        skill,
+        callerWorkflow,
+        managedState
+    };
+    await assertSnapshotStillStable({ root, desired, snapshot });
+    return {
+        desired,
+        root,
+        snapshot
+    };
+}
+export const nodeConsumerIntegrationInputReader = Object.freeze({ read: readConsumerIntegrationInput });
+//# sourceMappingURL=node-consumer-integration-repository.js.map

package/dist/consumer-integration/adapters/node-consumer-integration-repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-consumer-integration-repository.js","sourceRoot":"","sources":["../../../src/consumer-integration/adapters/node-consumer-integration-repository.ts"],"names":[],"mappings":"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"}

package/dist/consumer-integration/adapters/node-consumer-repository-files.d.ts

@@ -0,0 +1,11 @@
+import type { ConsumerIntegrationFileObservation } from "../domain/model.js";
+export declare const MAXIMUM_PROFILE_BYTES: number;
+export declare const MAXIMUM_MANIFEST_BYTES: number;
+export declare const MAXIMUM_MANAGED_ASSET_BYTES: number;
+export declare const MAXIMUM_LOCKFILE_BYTES: number;
+export declare const MAXIMUM_WORKSPACE_BYTES: number;
+export declare const INTEGRATION_PROFILE_PATH = "architecture/foundation/docs-consumer-integration.json";
+export declare function canonicalConsumerRoot(consumerRoot: string): Promise<string>;
+export declare function readStableConsumerFile(root: string, repositoryPath: string, maximumBytes: number, required: boolean): Promise<ConsumerIntegrationFileObservation>;
+export declare function sameConsumerFileObservation(left: ConsumerIntegrationFileObservation, right: ConsumerIntegrationFileObservation): boolean;
+//# sourceMappingURL=node-consumer-repository-files.d.ts.map

package/dist/consumer-integration/adapters/node-consumer-repository-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-consumer-repository-files.d.ts","sourceRoot":"","sources":["../../../src/consumer-integration/adapters/node-consumer-repository-files.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,kCAAkC,EACnC,MAAM,oBAAoB,CAAC;AAG5B,eAAO,MAAM,qBAAqB,QAAa,CAAC;AAChD,eAAO,MAAM,sBAAsB,QAAc,CAAC;AAClD,eAAO,MAAM,2BAA2B,QAAkB,CAAC;AAC3D,eAAO,MAAM,sBAAsB,QAAmB,CAAC;AACvD,eAAO,MAAM,uBAAuB,QAAkB,CAAC;AACvD,eAAO,MAAM,wBAAwB,2DACqB,CAAC;AAoB3D,wBAAsB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBjF;AAED,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,kCAAkC,CAAC,CA8C7C;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,kCAAkC,EACxC,KAAK,EAAE,kCAAkC,GACxC,OAAO,CAIT"}

package/dist/consumer-integration/adapters/node-consumer-repository-files.js

@@ -0,0 +1,81 @@
+import { constants } from "node:fs";
+import { lstat, open, realpath } from "node:fs/promises";
+import { isAbsolute, relative, resolve as resolvePath, sep } from "node:path";
+import { ConsumerIntegrationNodeError } from "./consumer-integration-node-error.js";
+export const MAXIMUM_PROFILE_BYTES = 256 * 1024;
+export const MAXIMUM_MANIFEST_BYTES = 1024 * 1024;
+export const MAXIMUM_MANAGED_ASSET_BYTES = 8 * 1024 * 1024;
+export const MAXIMUM_LOCKFILE_BYTES = 32 * 1024 * 1024;
+export const MAXIMUM_WORKSPACE_BYTES = 2 * 1024 * 1024;
+export const INTEGRATION_PROFILE_PATH = "architecture/foundation/docs-consumer-integration.json";
+function errorCode(error) {
+    return error instanceof Error && "code" in error
+        ? error.code
+        : undefined;
+}
+function contained(root, repositoryPath) {
+    const absolute = resolvePath(root, repositoryPath);
+    const relation = relative(root, absolute);
+    if (relation === ".." || relation.startsWith(`..${sep}`) || isAbsolute(relation)) {
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_PATH_ESCAPE", `Consumer integration path escapes the repository root: ${repositoryPath}.`);
+    }
+    return absolute;
+}
+export async function canonicalConsumerRoot(consumerRoot) {
+    const requested = resolvePath(consumerRoot);
+    let metadata;
+    try {
+        metadata = await lstat(requested);
+    }
+    catch (error) {
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_ROOT_INVALID", "Consumer root is unavailable or is not a real directory.", { cause: error });
+    }
+    if (metadata.isSymbolicLink() || !metadata.isDirectory()) {
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_ROOT_INVALID", "Consumer root must be one real directory.");
+    }
+    return realpath(requested);
+}
+export async function readStableConsumerFile(root, repositoryPath, maximumBytes, required) {
+    const path = contained(root, repositoryPath);
+    let handle;
+    try {
+        handle = await open(path, constants.O_RDONLY |
+            (process.platform === "win32" ? 0 : constants.O_NOFOLLOW));
+    }
+    catch (error) {
+        if (!required && errorCode(error) === "ENOENT") {
+            return { state: "absent" };
+        }
+        throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_INPUT_MISSING", `Required consumer integration input is unavailable: ${repositoryPath}.`, { cause: error });
+    }
+    try {
+        const before = await handle.stat({ bigint: true });
+        if (!before.isFile() || before.nlink > 1n || before.size > BigInt(maximumBytes)) {
+            throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_INPUT_INVALID", `Consumer integration input must be one bounded, non-hardlinked regular file: ${repositoryPath}.`);
+        }
+        const bytes = await handle.readFile();
+        const [after, pathState, canonical] = await Promise.all([
+            handle.stat({ bigint: true }),
+            lstat(path, { bigint: true }),
+            realpath(path)
+        ]);
+        if (pathState.isSymbolicLink() || canonical !== path ||
+            before.dev !== after.dev || before.ino !== after.ino ||
+            before.birthtimeNs !== after.birthtimeNs || before.ctimeNs !== after.ctimeNs ||
+            before.mtimeNs !== after.mtimeNs || before.size !== after.size ||
+            pathState.dev !== after.dev || pathState.ino !== after.ino ||
+            bytes.byteLength !== Number(after.size)) {
+            throw new ConsumerIntegrationNodeError("DOCS_CONSUMER_INPUT_UNSTABLE", `Consumer integration input changed during observation: ${repositoryPath}.`);
+        }
+        return { state: "file", bytes, mode: Number(after.mode) & 0o777 };
+    }
+    finally {
+        await handle.close();
+    }
+}
+export function sameConsumerFileObservation(left, right) {
+    return left.state === right.state && (left.state === "absent" ||
+        (right.state === "file" && left.mode === right.mode &&
+            Buffer.from(left.bytes).equals(Buffer.from(right.bytes))));
+}
+//# sourceMappingURL=node-consumer-repository-files.js.map