@agent-teams/docs-protocol 0.1.0-rc.1 → 0.1.0-rc.2

package/dist/consumer-integration/adapters/pnpm-lockfile-policy-v1.js

@@ -0,0 +1,37 @@
+export function validPnpmPeerContext(value, exactVersion) {
+    if (value === exactVersion) {
+        return true;
+    }
+    if (typeof value !== "string" || !value.startsWith(`${exactVersion}(`)) {
+        return false;
+    }
+    const contentByDepth = [];
+    for (const character of value.slice(exactVersion.length)) {
+        if (character === "(") {
+            contentByDepth.push(false);
+        }
+        else if (character === ")") {
+            if (contentByDepth.pop() !== true) {
+                return false;
+            }
+            if (contentByDepth.length > 0) {
+                contentByDepth[contentByDepth.length - 1] = true;
+            }
+        }
+        else {
+            if (contentByDepth.length === 0 || /\s/u.test(character)) {
+                return false;
+            }
+            contentByDepth[contentByDepth.length - 1] = true;
+        }
+    }
+    return contentByDepth.length === 0;
+}
+export function targetsManagedPackage(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return false;
+    }
+    return Object.keys(value).some((key) => key.includes("@agent-teams/docs-protocol") ||
+        key.includes("@agent-teams/engineering-foundation"));
+}
+//# sourceMappingURL=pnpm-lockfile-policy-v1.js.map

package/dist/consumer-integration/adapters/pnpm-lockfile-policy-v1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pnpm-lockfile-policy-v1.js","sourceRoot":"","sources":["../../../src/consumer-integration/adapters/pnpm-lockfile-policy-v1.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,oBAAoB,CAAC,KAAc,EAAE,YAAoB;IACvE,IAAI,KAAK,KAAK,YAAY,EAAE,CAAC;QAAA,OAAO,IAAI,CAAC;IAAA,CAAC;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,YAAY,GAAG,CAAC,EAAE,CAAC;QAAA,OAAO,KAAK,CAAC;IAAA,CAAC;IACvF,MAAM,cAAc,GAAc,EAAE,CAAC;IACrC,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;QACzD,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;YACtB,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;aAAM,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;YAC7B,IAAI,cAAc,CAAC,GAAG,EAAE,KAAK,IAAI,EAAE,CAAC;gBAAA,OAAO,KAAK,CAAC;YAAA,CAAC;YAClD,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAAA,cAAc,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC;YAAA,CAAC;QACpF,CAAC;aAAM,CAAC;YACN,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;gBAAA,OAAO,KAAK,CAAC;YAAA,CAAC;YACzE,cAAc,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC;QACnD,CAAC;IACH,CAAC;IACD,OAAO,cAAc,CAAC,MAAM,KAAK,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAAA,OAAO,KAAK,CAAC;IAAA,CAAC;IACxF,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CACrC,GAAG,CAAC,QAAQ,CAAC,4BAA4B,CAAC;QAC1C,GAAG,CAAC,QAAQ,CAAC,qCAAqC,CAAC,CACpD,CAAC;AACJ,CAAC"}

package/dist/consumer-integration/adapters/pnpm-manifest-adapter-v1.d.ts

@@ -0,0 +1,16 @@
+import type { ConsumerIntegrationDigest, ConsumerIntegrationFileObservation, ConsumerIntegrationIssue, QualifiedDocsCohortBindingV1 } from "../domain/model.js";
+/** @public */
+export interface PnpmManifestPlanV1 {
+    readonly state: "conflict" | "exact-current" | "known-prior";
+    readonly currentDigest: ConsumerIntegrationDigest;
+    readonly expectedDigest: ConsumerIntegrationDigest;
+    readonly postimage?: Uint8Array;
+    readonly issues: readonly ConsumerIntegrationIssue[];
+}
+export declare function planPnpmManifestV1(input: {
+    readonly observation: ConsumerIntegrationFileObservation;
+    readonly profilePath: string;
+    readonly cohort: QualifiedDocsCohortBindingV1;
+    readonly knownPriorScriptsDigest?: ConsumerIntegrationDigest;
+}): PnpmManifestPlanV1;
+//# sourceMappingURL=pnpm-manifest-adapter-v1.d.ts.map

package/dist/consumer-integration/adapters/pnpm-manifest-adapter-v1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pnpm-manifest-adapter-v1.d.ts","sourceRoot":"","sources":["../../../src/consumer-integration/adapters/pnpm-manifest-adapter-v1.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,yBAAyB,EACzB,kCAAkC,EAClC,wBAAwB,EACxB,4BAA4B,EAC7B,MAAM,oBAAoB,CAAC;AAU5B,cAAc;AACd,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,eAAe,GAAG,aAAa,CAAC;IAC7D,QAAQ,CAAC,aAAa,EAAE,yBAAyB,CAAC;IAClD,QAAQ,CAAC,cAAc,EAAE,yBAAyB,CAAC;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,wBAAwB,EAAE,CAAC;CACtD;AAoGD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,QAAQ,CAAC,WAAW,EAAE,kCAAkC,CAAC;IACzD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAC;IAC9C,QAAQ,CAAC,uBAAuB,CAAC,EAAE,yBAAyB,CAAC;CAC9D,GAAG,kBAAkB,CA8ErB"}

package/dist/consumer-integration/adapters/pnpm-manifest-adapter-v1.js

@@ -0,0 +1,155 @@
+import { applyEdits, modify } from "jsonc-parser";
+import { parseJsonRecord, recordField } from "../../adapters/adoption-input.js";
+import { canonicalConsumerIntegrationJson, canonicalDocsScripts, digestBytes } from "../application/policies/consumer-integration-assets.js";
+const DOCS_PACKAGE = "@agent-teams/docs-protocol";
+const FOUNDATION_PACKAGE = "@agent-teams/engineering-foundation";
+function issue(subject, code, message) {
+    return { code, severity: "error", subject, message };
+}
+function rejectPrototypeKeys(value, path = "package.json") {
+    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 TypeError(`${path}.${key} is forbidden.`);
+        }
+        rejectPrototypeKeys(entry, `${path}.${key}`);
+    }
+}
+function formatting(source) {
+    const eol = source.includes("\r\n") ? "\r\n" : "\n";
+    const indent = source.match(/\n([\t ]+)"/u)?.[1] ?? "  ";
+    return {
+        eol,
+        insertSpaces: !indent.includes("\t"),
+        tabSize: indent.includes("\t") ? 1 : indent.length
+    };
+}
+function applyField(source, path, value) {
+    return applyEdits(source, modify(source, [...path], value, {
+        formattingOptions: formatting(source)
+    }));
+}
+function parseManifest(bytes) {
+    const source = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+    if (source.startsWith("\uFEFF")) {
+        throw new TypeError("package.json must not contain a UTF-8 BOM.");
+    }
+    const manifest = parseJsonRecord(source);
+    rejectPrototypeKeys(manifest);
+    return { manifest, source };
+}
+function manifestShapeIssues(manifest) {
+    const issues = [];
+    for (const field of [
+        "scripts", "dependencies", "devDependencies", "optionalDependencies", "peerDependencies"
+    ]) {
+        const value = manifest[field];
+        if (value !== undefined &&
+            (typeof value !== "object" || value === null || Array.isArray(value))) {
+            issues.push(issue(`package.json#${field}`, "DOCS_CONSUMER_MANIFEST_FIELD_INVALID", `${field} must be one object when present.`));
+        }
+    }
+    return issues;
+}
+function cohortDependencyIssues(dependencies, devDependencies, optionalDependencies, peerDependencies, cohort) {
+    const issues = [];
+    for (const packageName of [DOCS_PACKAGE, FOUNDATION_PACKAGE]) {
+        for (const [field, declarations] of [
+            ["dependencies", dependencies],
+            ["optionalDependencies", optionalDependencies],
+            ["peerDependencies", peerDependencies]
+        ]) {
+            if (declarations[packageName] !== undefined) {
+                issues.push(issue(`package.json#${field}`, "DOCS_CONSUMER_NON_DEV_DEPENDENCY", `${packageName} may be declared only in root devDependencies.`));
+            }
+        }
+    }
+    const requiredVersions = {
+        [DOCS_PACKAGE]: cohort.packages.docsProtocol.version,
+        [FOUNDATION_PACKAGE]: cohort.packages.engineeringFoundation.version
+    };
+    for (const [packageName, version] of Object.entries(requiredVersions)) {
+        if (devDependencies[packageName] !== version) {
+            issues.push(issue(`package.json#devDependencies.${packageName}`, "DOCS_CONSUMER_COHORT_PIN_REQUIRED", `Update ${packageName} and pnpm-lock.yaml together to exact version ${version} before consumer apply.`));
+        }
+    }
+    return issues;
+}
+export function planPnpmManifestV1(input) {
+    if (input.observation.state === "absent") {
+        const empty = digestBytes(new Uint8Array());
+        return {
+            state: "conflict",
+            currentDigest: empty,
+            expectedDigest: empty,
+            issues: [issue("package.json", "DOCS_CONSUMER_MANIFEST_MISSING", "A root package.json is required and is never created by consumer integration.")]
+        };
+    }
+    const bytes = Buffer.from(input.observation.bytes);
+    const currentDigest = digestBytes(bytes);
+    let source;
+    let manifest;
+    try {
+        ({ manifest, source } = parseManifest(bytes));
+    }
+    catch (error) {
+        return {
+            state: "conflict",
+            currentDigest,
+            expectedDigest: currentDigest,
+            issues: [issue("package.json", "DOCS_CONSUMER_MANIFEST_INVALID", error instanceof Error ? error.message : "package.json is invalid.")]
+        };
+    }
+    const issues = manifestShapeIssues(manifest);
+    const scripts = recordField(manifest, "scripts");
+    const dependencies = recordField(manifest, "dependencies");
+    const devDependencies = recordField(manifest, "devDependencies");
+    const optionalDependencies = recordField(manifest, "optionalDependencies");
+    const peerDependencies = recordField(manifest, "peerDependencies");
+    issues.push(...cohortDependencyIssues(dependencies, devDependencies, optionalDependencies, peerDependencies, input.cohort));
+    const desiredScripts = canonicalDocsScripts(input.profilePath);
+    const observedScripts = Object.fromEntries(Object.keys(desiredScripts).map((script) => [
+        script,
+        scripts[script] ?? null
+    ]));
+    const observedScriptsDigest = digestBytes(Buffer.from(canonicalConsumerIntegrationJson(observedScripts), "utf8"));
+    let postimage = source;
+    for (const [script, command] of Object.entries(desiredScripts)) {
+        const pre = `pre${script}`;
+        const post = `post${script}`;
+        if (scripts[pre] !== undefined || scripts[post] !== undefined) {
+            issues.push(issue(`package.json#scripts.${script}`, "DOCS_CONSUMER_RESERVED_LIFECYCLE_SCRIPT", `${pre} and ${post} are forbidden for managed documentation commands.`));
+        }
+        const current = scripts[script];
+        if (current !== undefined && current !== command &&
+            observedScriptsDigest !== input.knownPriorScriptsDigest) {
+            issues.push(issue(`package.json#scripts.${script}`, "DOCS_CONSUMER_RESERVED_SCRIPT_CONFLICT", `${script} contains unknown local behavior and was not overwritten.`));
+            continue;
+        }
+        if (current !== command) {
+            postimage = applyField(postimage, ["scripts", script], command);
+        }
+    }
+    const expectedBytes = Buffer.from(postimage, "utf8");
+    const expectedDigest = digestBytes(expectedBytes);
+    if (issues.length > 0) {
+        return { state: "conflict", currentDigest, expectedDigest, issues: Object.freeze(issues) };
+    }
+    if (expectedDigest === currentDigest) {
+        return { state: "exact-current", currentDigest, expectedDigest, issues: [] };
+    }
+    return {
+        state: "known-prior",
+        currentDigest,
+        expectedDigest,
+        postimage: expectedBytes,
+        issues: []
+    };
+}
+//# sourceMappingURL=pnpm-manifest-adapter-v1.js.map

package/dist/consumer-integration/adapters/pnpm-manifest-adapter-v1.js.map

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

package/dist/consumer-integration/adapters/pnpm-runtime-closure-v1.d.ts

@@ -0,0 +1,8 @@
+import type { QualifiedDocsCohortBindingV1 } from "../domain/model.js";
+type JsonRecord = Record<string, unknown>;
+export declare class PnpmRuntimeClosureError extends Error {
+    readonly code = "DOCS_CONSUMER_RUNTIME_CLOSURE_MISMATCH";
+}
+export declare function computePnpmRuntimeClosureDigestV1(lock: JsonRecord, cohort: QualifiedDocsCohortBindingV1): `sha256:${string}`;
+export {};
+//# sourceMappingURL=pnpm-runtime-closure-v1.d.ts.map

package/dist/consumer-integration/adapters/pnpm-runtime-closure-v1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pnpm-runtime-closure-v1.d.ts","sourceRoot":"","sources":["../../../src/consumer-integration/adapters/pnpm-runtime-closure-v1.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAWvE,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,SAAgB,IAAI,4CAA4C;CACjE;AAsDD,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,4BAA4B,GACnC,UAAU,MAAM,EAAE,CAmHpB"}

package/dist/consumer-integration/adapters/pnpm-runtime-closure-v1.js

@@ -0,0 +1,160 @@
+import { createHash } from "node:crypto";
+import { canonicalConsumerIntegrationJson } from "../application/policies/consumer-integration-assets.js";
+const PACKAGE_MANAGER = "pnpm@11.18.0";
+const LOCKFILE_VERSION = "9.0";
+const MAXIMUM_PACKAGES = 2048;
+const MAXIMUM_DEPTH = 64;
+const MAXIMUM_BYTES = 2 * 1024 * 1024;
+const REGISTRY_VERSION = /^[0-9]+\.[0-9]+\.[0-9]+(?:-[0-9A-Za-z]+(?:[.-][0-9A-Za-z]+)*)?(?:\+[0-9A-Za-z]+(?:[.-][0-9A-Za-z]+)*)?$/u;
+const SHA512_SRI = /^sha512-[A-Za-z0-9+/]{86}==$/u;
+export class PnpmRuntimeClosureError extends Error {
+    code = "DOCS_CONSUMER_RUNTIME_CLOSURE_MISMATCH";
+}
+function fail(message) {
+    throw new PnpmRuntimeClosureError(message);
+}
+function record(value, label) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        fail(`${label} must be one object.`);
+    }
+    return value;
+}
+function binding(container, name) {
+    return ["dependencies", "devDependencies", "optionalDependencies"].flatMap((section) => {
+        const entries = container[section];
+        return entries === null || typeof entries !== "object" || Array.isArray(entries) ||
+            entries[name] === undefined ? [] : [entries[name]];
+    });
+}
+function locator(name, raw, label) {
+    if (typeof raw !== "string" || raw.length > 1024 || /[\s\\:#]/u.test(raw)) {
+        fail(`${label} is not one bounded registry resolution.`);
+    }
+    const version = raw.split("(", 1)[0];
+    if (!REGISTRY_VERSION.test(version) || raw.startsWith("npm:")) {
+        fail(`${label} uses a non-registry or aliased resolution.`);
+    }
+    return `${name}@${raw}`;
+}
+function sortedEdges(snapshot, section, label) {
+    const value = snapshot[section] ?? {};
+    const source = record(value, `${label} ${section}`);
+    return Object.entries(source)
+        .toSorted(([left], [right]) => left < right ? -1 : left > right ? 1 : 0)
+        .map(([name, raw]) => ({ name, locator: locator(name, raw, `${label} ${section}.${name}`) }));
+}
+function packageRoots(cohort) {
+    return [
+        { name: "@agent-teams/docs-protocol", ...cohort.packages.docsProtocol },
+        { name: "@agent-teams/engineering-foundation", ...cohort.packages.engineeringFoundation }
+    ];
+}
+export function computePnpmRuntimeClosureDigestV1(lock, cohort) {
+    if (String(lock["lockfileVersion"]) !== LOCKFILE_VERSION) {
+        fail("Runtime closure requires pnpm lockfileVersion 9.0.");
+    }
+    const importers = record(lock["importers"], "Runtime closure importers");
+    const packages = record(lock["packages"], "Runtime closure packages");
+    const snapshots = record(lock["snapshots"], "Runtime closure snapshots");
+    const root = record(importers["."], "Runtime closure root importer");
+    const expected = packageRoots(cohort);
+    const roots = expected.map((entry) => {
+        const bindings = binding(root, entry.name);
+        if (bindings.length !== 1) {
+            fail(`${entry.name} runtime closure root binding is not exact.`);
+        }
+        const selected = record(bindings[0], `${entry.name} runtime closure root binding`);
+        if (selected["specifier"] !== entry.version || typeof selected["version"] !== "string") {
+            fail(`${entry.name} runtime closure root binding is not exact.`);
+        }
+        const selectedLocator = locator(entry.name, selected["version"], `${entry.name} runtime closure root`);
+        if (selectedLocator.split("(", 1)[0] !== `${entry.name}@${entry.version}`) {
+            fail(`${entry.name} runtime closure root version differs from the Cohort.`);
+        }
+        const packageEntry = record(packages[`${entry.name}@${entry.version}`], `${entry.name} package`);
+        const resolution = record(packageEntry["resolution"], `${entry.name} resolution`);
+        if (resolution["integrity"] !== entry.integrity) {
+            fail(`${entry.name} runtime closure root integrity differs from the Cohort.`);
+        }
+        return { name: entry.name, locator: selectedLocator };
+    }).toSorted(({ name: left }, { name: right }) => left < right ? -1 : left > right ? 1 : 0);
+    const pending = roots.map(({ locator: rootLocator }) => ({ locator: rootLocator, depth: 0 }));
+    const visited = new Set();
+    const projectedPackages = [];
+    while (pending.length > 0) {
+        const current = pending.shift();
+        if (visited.has(current.locator)) {
+            continue;
+        }
+        if (current.depth > MAXIMUM_DEPTH) {
+            fail(`Runtime closure exceeds maximum dependency depth ${MAXIMUM_DEPTH}.`);
+        }
+        visited.add(current.locator);
+        if (visited.size > MAXIMUM_PACKAGES) {
+            fail(`Runtime closure exceeds maximum package count ${MAXIMUM_PACKAGES}.`);
+        }
+        const physicalLocator = current.locator.split("(", 1)[0];
+        const packageEntry = record(packages[physicalLocator], `Runtime closure package ${physicalLocator}`);
+        const snapshot = record(snapshots[current.locator], `Runtime closure snapshot ${current.locator}`);
+        const resolution = record(packageEntry["resolution"], `Runtime closure resolution ${physicalLocator}`);
+        const integrity = resolution["integrity"];
+        if (typeof integrity !== "string" || !SHA512_SRI.test(integrity)) {
+            fail(`Runtime closure locator ${current.locator} has no exact registry SRI.`);
+        }
+        const dependencies = sortedEdges(snapshot, "dependencies", current.locator);
+        const optionalDependencies = sortedEdges(snapshot, "optionalDependencies", current.locator);
+        const edgeByName = new Map();
+        for (const edge of [...dependencies, ...optionalDependencies]) {
+            const prior = edgeByName.get(edge.name);
+            if (prior !== undefined && prior !== edge.locator) {
+                fail(`Runtime closure locator ${current.locator} has ambiguous dependency ${edge.name}.`);
+            }
+            edgeByName.set(edge.name, edge.locator);
+            pending.push({ locator: edge.locator, depth: current.depth + 1 });
+        }
+        projectedPackages.push({
+            locator: current.locator,
+            integrity,
+            dependencies,
+            optionalDependencies
+        });
+    }
+    projectedPackages.sort(({ locator: left }, { locator: right }) => left < right ? -1 : left > right ? 1 : 0);
+    const projection = {
+        schemaVersion: 1,
+        packageManager: PACKAGE_MANAGER,
+        lockfileVersion: LOCKFILE_VERSION,
+        packageCount: projectedPackages.length,
+        roots,
+        packages: projectedPackages
+    };
+    if (Buffer.byteLength(canonicalConsumerIntegrationJson(projection), "utf8") > MAXIMUM_BYTES) {
+        fail(`Runtime closure projection exceeds ${MAXIMUM_BYTES} bytes.`);
+    }
+    const physicalLocators = [...new Set(projectedPackages.map(({ locator: value }) => value.split("(", 1)[0]))].toSorted((left, right) => left < right ? -1 : left > right ? 1 : 0);
+    const pnpmLock = {
+        lockfileVersion: LOCKFILE_VERSION,
+        settings: { autoInstallPeers: true, excludeLinksFromLockfile: false },
+        importers: { ".": { devDependencies: Object.fromEntries(roots.map(({ name, locator: value }) => [
+                    name,
+                    {
+                        specifier: expected.find((entry) => entry.name === name).version,
+                        version: value.slice(`${name}@`.length)
+                    }
+                ])) } },
+        packages: Object.fromEntries(physicalLocators.map((value) => [value, packages[value]])),
+        snapshots: Object.fromEntries(projectedPackages.map(({ locator: value }) => [value, snapshots[value]]))
+    };
+    const source = `${canonicalConsumerIntegrationJson({
+        domain: "agent-teams.docs-runtime-closure/v1",
+        schemaVersion: 1,
+        packageManager: PACKAGE_MANAGER,
+        packageCount: projectedPackages.length,
+        pnpmLock
+    })}\n`;
+    if (Buffer.byteLength(source, "utf8") > MAXIMUM_BYTES) {
+        fail(`Runtime closure evidence exceeds ${MAXIMUM_BYTES} bytes.`);
+    }
+    return `sha256:${createHash("sha256").update(source).digest("hex")}`;
+}
+//# sourceMappingURL=pnpm-runtime-closure-v1.js.map

package/dist/consumer-integration/adapters/pnpm-runtime-closure-v1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pnpm-runtime-closure-v1.js","sourceRoot":"","sources":["../../../src/consumer-integration/adapters/pnpm-runtime-closure-v1.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,gCAAgC,EAAE,MAAM,wDAAwD,CAAC;AAE1G,MAAM,eAAe,GAAG,cAAc,CAAC;AACvC,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAC/B,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAC9B,MAAM,aAAa,GAAG,EAAE,CAAC;AACzB,MAAM,aAAa,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AACtC,MAAM,gBAAgB,GAAG,0GAA0G,CAAC;AACpI,MAAM,UAAU,GAAG,+BAA+B,CAAC;AAInD,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAChC,IAAI,GAAG,wCAAwC,CAAC;CACjE;AAED,SAAS,IAAI,CAAC,OAAe;IAC3B,MAAM,IAAI,uBAAuB,CAAC,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,MAAM,CAAC,KAAc,EAAE,KAAa;IAC3C,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,IAAI,CAAC,GAAG,KAAK,sBAAsB,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,KAAmB,CAAC;AAC7B,CAAC;AAED,SAAS,OAAO,CAAC,SAAqB,EAAE,IAAY;IAClD,OAAO,CAAC,cAAc,EAAE,iBAAiB,EAAE,sBAAsB,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QACrF,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAC7E,OAAsB,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,OAAsB,CAAC,IAAI,CAAC,CAAC,CAAC;IACvF,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,OAAO,CAAC,IAAY,EAAE,GAAY,EAAE,KAAa;IACxD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,IAAI,IAAI,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1E,IAAI,CAAC,GAAG,KAAK,0CAA0C,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC;IACtC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9D,IAAI,CAAC,GAAG,KAAK,6CAA6C,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC;AAC1B,CAAC;AAED,SAAS,WAAW,CAAC,QAAoB,EAAE,OAAe,EAAE,KAAa;IAIvE,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,OAAO,EAAE,CAAC,CAAC;IACpD,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;SAC1B,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACvE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAClG,CAAC;AAED,SAAS,YAAY,CAAC,MAAoC;IAKxD,OAAO;QACL,EAAE,IAAI,EAAE,4BAA4B,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE;QACvE,EAAE,IAAI,EAAE,qCAAqC,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,qBAAqB,EAAE;KAC1F,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,IAAgB,EAChB,MAAoC;IAEpC,IAAI,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,KAAK,gBAAgB,EAAE,CAAC;QACzD,IAAI,CAAC,oDAAoD,CAAC,CAAC;IAC7D,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,2BAA2B,CAAC,CAAC;IACzE,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,0BAA0B,CAAC,CAAC;IACtE,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,2BAA2B,CAAC,CAAC;IACzE,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,+BAA+B,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACnC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,6CAA6C,CAAC,CAAC;QACnE,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,IAAI,+BAA+B,CAAC,CAAC;QACnF,IAAI,QAAQ,CAAC,WAAW,CAAC,KAAK,KAAK,CAAC,OAAO,IAAI,OAAO,QAAQ,CAAC,SAAS,CAAC,KAAK,QAAQ,EAAE,CAAC;YACvF,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,6CAA6C,CAAC,CAAC;QACnE,CAAC;QACD,MAAM,eAAe,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,GAAG,KAAK,CAAC,IAAI,uBAAuB,CAAC,CAAC;QACvG,IAAI,eAAe,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAC1E,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,wDAAwD,CAAC,CAAC;QAC9E,CAAC;QACD,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,IAAI,UAAU,CAAC,CAAC;QACjG,MAAM,UAAU,GAAG,MAAM,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,GAAG,KAAK,CAAC,IAAI,aAAa,CAAC,CAAC;QAClF,IAAI,UAAU,CAAC,WAAW,CAAC,KAAK,KAAK,CAAC,SAAS,EAAE,CAAC;YAChD,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,0DAA0D,CAAC,CAAC;QAChF,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;IACxD,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE3F,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9F,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,iBAAiB,GAKlB,EAAE,CAAC;IACR,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,EAAG,CAAC;QACjC,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAAA,SAAS;QAAA,CAAC;QAC7C,IAAI,OAAO,CAAC,KAAK,GAAG,aAAa,EAAE,CAAC;YAClC,IAAI,CAAC,oDAAoD,aAAa,GAAG,CAAC,CAAC;QAC7E,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC7B,IAAI,OAAO,CAAC,IAAI,GAAG,gBAAgB,EAAE,CAAC;YACpC,IAAI,CAAC,iDAAiD,gBAAgB,GAAG,CAAC,CAAC;QAC7E,CAAC;QACD,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC;QAC1D,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,2BAA2B,eAAe,EAAE,CAAC,CAAC;QACrG,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,4BAA4B,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QACnG,MAAM,UAAU,GAAG,MAAM,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,8BAA8B,eAAe,EAAE,CAAC,CAAC;QACvG,MAAM,SAAS,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;QAC1C,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACjE,IAAI,CAAC,2BAA2B,OAAO,CAAC,OAAO,6BAA6B,CAAC,CAAC;QAChF,CAAC;QACD,MAAM,YAAY,GAAG,WAAW,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAC5E,MAAM,oBAAoB,GAAG,WAAW,CAAC,QAAQ,EAAE,sBAAsB,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAC5F,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC7C,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,YAAY,EAAE,GAAG,oBAAoB,CAAC,EAAE,CAAC;YAC9D,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;gBAClD,IAAI,CAAC,2BAA2B,OAAO,CAAC,OAAO,6BAA6B,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;YAC5F,CAAC;YACD,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YACxC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;QACpE,CAAC;QACD,iBAAiB,CAAC,IAAI,CAAC;YACrB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,SAAS;YACT,YAAY;YACZ,oBAAoB;SACrB,CAAC,CAAC;IACL,CAAC;IACD,iBAAiB,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAC/D,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CACzC,CAAC;IACF,MAAM,UAAU,GAAG;QACjB,aAAa,EAAE,CAAC;QAChB,cAAc,EAAE,eAAe;QAC/B,eAAe,EAAE,gBAAgB;QACjC,YAAY,EAAE,iBAAiB,CAAC,MAAM;QACtC,KAAK;QACL,QAAQ,EAAE,iBAAiB;KAC5B,CAAC;IACF,IAAI,MAAM,CAAC,UAAU,CAAC,gCAAgC,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,GAAG,aAAa,EAAE,CAAC;QAC5F,IAAI,CAAC,sCAAsC,aAAa,SAAS,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,gBAAgB,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAChF,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,CACxB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,MAAM,QAAQ,GAAG;QACf,eAAe,EAAE,gBAAgB;QACjC,QAAQ,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,wBAAwB,EAAE,KAAK,EAAE;QACrE,SAAS,EAAE,EAAE,GAAG,EAAE,EAAE,eAAe,EAAE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;oBAC9F,IAAI;oBACJ;wBACE,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAE,CAAC,OAAO;wBACjE,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC;qBACxC;iBACF,CAAC,CAAC,EAAE,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACvF,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KACxG,CAAC;IACF,MAAM,MAAM,GAAG,GAAG,gCAAgC,CAAC;QACjD,MAAM,EAAE,qCAAqC;QAC7C,aAAa,EAAE,CAAC;QAChB,cAAc,EAAE,eAAe;QAC/B,YAAY,EAAE,iBAAiB,CAAC,MAAM;QACtC,QAAQ;KACT,CAAC,IAAI,CAAC;IACP,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,aAAa,EAAE,CAAC;QACtD,IAAI,CAAC,oCAAoC,aAAa,SAAS,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,UAAU,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACvE,CAAC"}

package/dist/consumer-integration/application/policies/consumer-integration-assets.d.ts

@@ -0,0 +1,57 @@
+import type { ConsumerIntegrationDesiredStateV1, ConsumerIntegrationDigest, QualifiedDocsCohortBindingV1 } from "../../domain/model.js";
+export declare const CANONICAL_DOCS_SKILL: "---\nname: docs-authoring\ndescription: Use when creating, changing, reorganizing, or reviewing governed documentation in this repository.\n---\n\n# Documentation Authoring\n\nProtocol: `agent-teams.docs-protocol/v1`.\n\n## Required workflow\n\n- Read the current types, owners, placement, metadata, and index policy with `pnpm docs:info`.\n- Search first with `pnpm docs:find -- --text query`.\n- Reuse or relate existing authority instead of creating a competing source.\n- Preview with `pnpm docs:new -- --type TYPE --id ID --title TITLE --owner OWNER --summary SUMMARY --dry-run`.\n- Review the exact destination, metadata, relations, anchors, and diagnostics.\n- Apply with `pnpm docs:new -- --type TYPE --id ID --title TITLE --owner OWNER --summary SUMMARY --apply` after review.\n- Manually update the reported index/link exactly when reachability requires it.\n- Finish with `pnpm docs:check` after the index is current.\n\n## Rules\n\n- Never invent owners, types, statuses, paths, or metadata outside `docs:info`.\n- If dependencies are absent, use only `pnpm install --frozen-lockfile`; never use npx, dlx, or latest tags.\n- Keep preview and apply inputs identical.\n- Stop when recovery is required; use `pnpm docs:doctor` before `pnpm docs:recover`.\n- Resolve required anchors and blockers before apply.\n- Do not bypass repository scripts or hand-edit transaction evidence.\n";
+export declare const CANONICAL_CALLER_WORKFLOW_TEMPLATE: "name: Documentation Protocol\n\non:\n  pull_request:\n  merge_group:\n  push:\n\npermissions:\n  contents: read\n\njobs:\n  docs-protocol:\n    uses: {{REUSABLE_WORKFLOW_REPOSITORY}}/{{REUSABLE_WORKFLOW_PATH}}@{{REUSABLE_WORKFLOW_REVISION}}\n";
+export declare const BOOTSTRAP_KNOWN_PRIOR_DOCS_SKILLS: readonly Uint8Array[];
+export declare const MANAGED_ROUTE_BEGIN = "<!-- agent-teams-docs:route/v1 begin -->";
+export declare const MANAGED_ROUTE_END = "<!-- agent-teams-docs:route/v1 end -->";
+export declare const BOOTSTRAP_KNOWN_PRIOR_CALLER_WORKFLOWS: readonly Uint8Array[];
+export interface KnownPriorCohortCatalogEntryV1 {
+    readonly cohort: QualifiedDocsCohortBindingV1;
+    readonly skill: Uint8Array;
+    readonly callerWorkflow: Uint8Array;
+    readonly agentsRouteDigest: ConsumerIntegrationDigest;
+    readonly docsScriptsDigest: ConsumerIntegrationDigest;
+}
+export interface CurrentSourceExecutorV1 {
+    readonly packages: QualifiedDocsCohortBindingV1["packages"];
+    readonly schemas: QualifiedDocsCohortBindingV1["schemas"];
+    readonly runtime: QualifiedDocsCohortBindingV1["runtime"];
+    readonly assetCatalogDigest: ConsumerIntegrationDigest;
+    readonly skillDigest: ConsumerIntegrationDigest;
+    readonly callerWorkflowDigest: ConsumerIntegrationDigest;
+    readonly agentsRouteDigest: ConsumerIntegrationDigest;
+    readonly docsScriptsDigest: ConsumerIntegrationDigest;
+    readonly directTargetCohortIds: readonly string[];
+}
+export interface ConsumerAssetCatalogV1 {
+    readonly catalogDigest: ConsumerIntegrationDigest;
+    readonly transitionCatalogDigest: ConsumerIntegrationDigest;
+    readonly currentSourceExecutors: readonly CurrentSourceExecutorV1[];
+    readonly directTargetBundles: readonly KnownPriorCohortCatalogEntryV1[];
+}
+export declare const BUNDLED_KNOWN_PRIOR_COHORTS: readonly KnownPriorCohortCatalogEntryV1[];
+export declare const BUNDLED_CURRENT_SOURCE_EXECUTORS: readonly CurrentSourceExecutorV1[];
+export declare const CANONICAL_TRANSITION_CATALOG: string;
+export declare const CANONICAL_ASSET_CATALOG: string;
+export declare function isBootstrapKnownPriorCallerWorkflow(bytes: Uint8Array): boolean;
+export declare function digestBytes(value: Uint8Array): ConsumerIntegrationDigest;
+export declare function canonicalCallerWorkflow(cohort: QualifiedDocsCohortBindingV1): string;
+export declare function canonicalDocsScriptsDigest(profilePath: string): ConsumerIntegrationDigest;
+export declare function canonicalManagedRoute(skillPath: string): string;
+export declare function canonicalDocsScripts(profilePath: string): Readonly<Record<string, string>>;
+export declare function canonicalConsumerIntegrationJson(value: unknown): string;
+export declare function canonicalManagedState(desired: ConsumerIntegrationDesiredStateV1, assets: {
+    readonly skillDigest: ConsumerIntegrationDigest;
+    readonly callerWorkflowDigest: ConsumerIntegrationDigest;
+    readonly assetCatalogDigest: ConsumerIntegrationDigest;
+    readonly transitionCatalogDigest: ConsumerIntegrationDigest;
+    readonly agentsRouteDigest: ConsumerIntegrationDigest;
+    readonly docsScriptsDigest: ConsumerIntegrationDigest;
+}): string;
+export declare function describeCanonicalConsumerAssets(cohort: QualifiedDocsCohortBindingV1): {
+    readonly skillDigest: ConsumerIntegrationDigest;
+    readonly callerWorkflowDigest: ConsumerIntegrationDigest;
+    readonly assetCatalogDigest: ConsumerIntegrationDigest;
+    readonly transitionCatalogDigest: ConsumerIntegrationDigest;
+};
+//# sourceMappingURL=consumer-integration-assets.d.ts.map

package/dist/consumer-integration/application/policies/consumer-integration-assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer-integration-assets.d.ts","sourceRoot":"","sources":["../../../../src/consumer-integration/application/policies/consumer-integration-assets.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,iCAAiC,EACjC,yBAAyB,EACzB,4BAA4B,EAC7B,MAAM,uBAAuB,CAAC;AAW/B,eAAO,MAAM,oBAAoB,m3CAAuB,CAAC;AACzD,eAAO,MAAM,kCAAkC,sPAAwC,CAAC;AAExF,eAAO,MAAM,iCAAiC,EAAE,SAAS,UAAU,EAYjE,CAAC;AAEH,eAAO,MAAM,mBAAmB,6CAA6C,CAAC;AAC9E,eAAO,MAAM,iBAAiB,2CAA2C,CAAC;AAI1E,eAAO,MAAM,sCAAsC,EAAE,SAAS,UAAU,EAgBtE,CAAC;AAEH,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,UAAU,CAAC;IACpC,QAAQ,CAAC,iBAAiB,EAAE,yBAAyB,CAAC;IACtD,QAAQ,CAAC,iBAAiB,EAAE,yBAAyB,CAAC;CACvD;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,EAAE,4BAA4B,CAAC,UAAU,CAAC,CAAC;IAC5D,QAAQ,CAAC,OAAO,EAAE,4BAA4B,CAAC,SAAS,CAAC,CAAC;IAC1D,QAAQ,CAAC,OAAO,EAAE,4BAA4B,CAAC,SAAS,CAAC,CAAC;IAC1D,QAAQ,CAAC,kBAAkB,EAAE,yBAAyB,CAAC;IACvD,QAAQ,CAAC,WAAW,EAAE,yBAAyB,CAAC;IAChD,QAAQ,CAAC,oBAAoB,EAAE,yBAAyB,CAAC;IACzD,QAAQ,CAAC,iBAAiB,EAAE,yBAAyB,CAAC;IACtD,QAAQ,CAAC,iBAAiB,EAAE,yBAAyB,CAAC;IACtD,QAAQ,CAAC,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAC;CACnD;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,aAAa,EAAE,yBAAyB,CAAC;IAClD,QAAQ,CAAC,uBAAuB,EAAE,yBAAyB,CAAC;IAC5D,QAAQ,CAAC,sBAAsB,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACpE,QAAQ,CAAC,mBAAmB,EAAE,SAAS,8BAA8B,EAAE,CAAC;CACzE;AAED,eAAO,MAAM,2BAA2B,EAAE,SAAS,8BAA8B,EAC9D,CAAC;AACpB,eAAO,MAAM,gCAAgC,EAAE,SAAS,uBAAuB,EAC5D,CAAC;AAEpB,eAAO,MAAM,4BAA4B,QAInC,CAAC;AAEP,eAAO,MAAM,uBAAuB,QAW9B,CAAC;AAEP,wBAAgB,mCAAmC,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAkB9E;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,yBAAyB,CAExE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,4BAA4B,GAAG,MAAM,CAKpF;AAED,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,yBAAyB,CAIzF;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAI/D;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAO1F;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAoBvE;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,iCAAiC,EAC1C,MAAM,EAAE;IACN,QAAQ,CAAC,WAAW,EAAE,yBAAyB,CAAC;IAChD,QAAQ,CAAC,oBAAoB,EAAE,yBAAyB,CAAC;IACzD,QAAQ,CAAC,kBAAkB,EAAE,yBAAyB,CAAC;IACvD,QAAQ,CAAC,uBAAuB,EAAE,yBAAyB,CAAC;IAC5D,QAAQ,CAAC,iBAAiB,EAAE,yBAAyB,CAAC;IACtD,QAAQ,CAAC,iBAAiB,EAAE,yBAAyB,CAAC;CACvD,GACA,MAAM,CA8BR;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,4BAA4B,GAAG;IACrF,QAAQ,CAAC,WAAW,EAAE,yBAAyB,CAAC;IAChD,QAAQ,CAAC,oBAAoB,EAAE,yBAAyB,CAAC;IACzD,QAAQ,CAAC,kBAAkB,EAAE,yBAAyB,CAAC;IACvD,QAAQ,CAAC,uBAAuB,EAAE,yBAAyB,CAAC;CAC7D,CAUA"}

package/dist/consumer-integration/application/policies/consumer-integration-assets.js

@@ -0,0 +1,151 @@
+import { createHash } from "node:crypto";
+import { GENERATED_CALLER_WORKFLOW_TEMPLATE, GENERATED_DOCS_SKILL } from "../../generated/canonical-assets.js";
+const CATALOG_SOURCE = Object.freeze({
+    skill: GENERATED_DOCS_SKILL,
+    callerWorkflowTemplate: GENERATED_CALLER_WORKFLOW_TEMPLATE
+});
+export const CANONICAL_DOCS_SKILL = CATALOG_SOURCE.skill;
+export const CANONICAL_CALLER_WORKFLOW_TEMPLATE = CATALOG_SOURCE.callerWorkflowTemplate;
+export const BOOTSTRAP_KNOWN_PRIOR_DOCS_SKILLS = Object.freeze([
+    Buffer.from(CANONICAL_DOCS_SKILL
+        .replace("--type TYPE --id ID --title TITLE --owner OWNER --summary SUMMARY --dry-run", "--type TYPE --id ID --dry-run")
+        .replace("--type TYPE --id ID --title TITLE --owner OWNER --summary SUMMARY --apply", "--type TYPE --id ID --apply")
+        .replace("- If dependencies are absent, use only `pnpm install --frozen-lockfile`; never use npx, dlx, or latest tags.\n", ""), "utf8")
+]);
+export const MANAGED_ROUTE_BEGIN = "<!-- agent-teams-docs:route/v1 begin -->";
+export const MANAGED_ROUTE_END = "<!-- agent-teams-docs:route/v1 end -->";
+const BOOTSTRAP_WORKFLOW_REVISION = "2679c8bc1e432091271d2f68ef904694e4d5838e";
+export const BOOTSTRAP_KNOWN_PRIOR_CALLER_WORKFLOWS = Object.freeze([
+    Buffer.from(`name: Documentation Protocol
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+
+jobs:
+  docs-protocol:
+    uses: agent-teams-ai/.github/.github/workflows/docs-protocol-check.yml@${BOOTSTRAP_WORKFLOW_REVISION}
+`, "utf8")
+]);
+export const BUNDLED_KNOWN_PRIOR_COHORTS = Object.freeze([]);
+export const BUNDLED_CURRENT_SOURCE_EXECUTORS = Object.freeze([]);
+export const CANONICAL_TRANSITION_CATALOG = `${canonicalConsumerIntegrationJson({
+    schemaVersion: 1,
+    currentSourceExecutors: BUNDLED_CURRENT_SOURCE_EXECUTORS,
+    directTargetBundles: []
+})}\n`;
+export const CANONICAL_ASSET_CATALOG = `${canonicalConsumerIntegrationJson({
+    schemaVersion: 1,
+    skillPath: "skills/docs/SKILL.md",
+    skillDigest: digestBytes(Buffer.from(CATALOG_SOURCE.skill, "utf8")),
+    callerWorkflowTemplatePath: "assets/docs-protocol.yml",
+    callerWorkflowTemplateDigest: digestBytes(Buffer.from(CATALOG_SOURCE.callerWorkflowTemplate, "utf8")),
+    routeTemplate: canonicalManagedRoute("{skillPath}"),
+    scriptsTemplate: canonicalDocsScripts("{profilePath}"),
+})}\n`;
+export function isBootstrapKnownPriorCallerWorkflow(bytes) {
+    let source;
+    try {
+        source = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+    }
+    catch {
+        return false;
+    }
+    if (source.normalize("NFC") !== source || source.includes("\u0000") || source.includes("\r")) {
+        return false;
+    }
+    const escapedRevision = BOOTSTRAP_WORKFLOW_REVISION.replaceAll("-", "\\-");
+    const match = new RegExp(`^name: Documentation Protocol\\n\\non:\\n  pull_request:\\n  push:\\n    branches:\\n      - ([A-Za-z0-9._/-]+)\\n\\npermissions:\\n  contents: read\\n\\njobs:\\n  docs-protocol:\\n    uses: agent-teams-ai/\\.github/\\.github/workflows/docs-protocol-check\\.yml@${escapedRevision}\\n$`, "u").exec(source);
+    const branch = match?.[1];
+    return branch !== undefined && !branch.startsWith("/") && !branch.endsWith("/") &&
+        !branch.includes("..") && !branch.includes("//");
+}
+export function digestBytes(value) {
+    return `sha256:${createHash("sha256").update(value).digest("hex")}`;
+}
+export function canonicalCallerWorkflow(cohort) {
+    return CANONICAL_CALLER_WORKFLOW_TEMPLATE
+        .replace("{{REUSABLE_WORKFLOW_REPOSITORY}}", cohort.workflow.repository)
+        .replace("{{REUSABLE_WORKFLOW_PATH}}", cohort.workflow.path)
+        .replace("{{REUSABLE_WORKFLOW_REVISION}}", cohort.workflow.revision);
+}
+export function canonicalDocsScriptsDigest(profilePath) {
+    return digestBytes(Buffer.from(canonicalConsumerIntegrationJson(canonicalDocsScripts(profilePath)), "utf8"));
+}
+export function canonicalManagedRoute(skillPath) {
+    return `${MANAGED_ROUTE_BEGIN}
+Use [${skillPath}](${skillPath}) for documentation.
+${MANAGED_ROUTE_END}`;
+}
+export function canonicalDocsScripts(profilePath) {
+    return Object.freeze(Object.fromEntries(["check", "doctor", "find", "info", "new", "recover"].map((command) => [
+        `docs:${command}`,
+        `agent-teams-docs ${command} --consumer . --profile ${profilePath}`
+    ])));
+}
+export function canonicalConsumerIntegrationJson(value) {
+    if (value === null || typeof value === "boolean" || typeof value === "string") {
+        return JSON.stringify(value);
+    }
+    if (typeof value === "number") {
+        if (!Number.isSafeInteger(value)) {
+            throw new TypeError("Managed state contains a non-canonical number.");
+        }
+        return JSON.stringify(value);
+    }
+    if (Array.isArray(value)) {
+        return `[${value.map(canonicalConsumerIntegrationJson).join(",")}]`;
+    }
+    if (typeof value !== "object" || value === undefined) {
+        throw new TypeError("Managed state contains a non-JSON value.");
+    }
+    return `{${Object.entries(value)
+        .toSorted(([left], [right]) => left < right ? -1 : left > right ? 1 : 0)
+        .map(([key, entry]) => `${JSON.stringify(key)}:${canonicalConsumerIntegrationJson(entry)}`)
+        .join(",")}}`;
+}
+export function canonicalManagedState(desired, assets) {
+    const body = {
+        schemaVersion: 1,
+        cohortId: desired.cohort.cohortId,
+        cohortAuthority: {
+            channel: desired.cohort.channel,
+            recordDigest: desired.cohort.recordDigest,
+            qualificationEventDigest: desired.cohort.qualificationEventDigest,
+            eligibleAfter: desired.cohort.eligibleAfter,
+            upgradeFrom: desired.cohort.upgradeFrom,
+            rollbackTo: desired.cohort.rollbackTo
+        },
+        repository: desired.repository,
+        packages: desired.cohort.packages,
+        schemas: desired.cohort.schemas,
+        runtime: desired.cohort.runtime,
+        profilePath: desired.profilePath,
+        skillPath: desired.skillPath,
+        callerWorkflowPath: desired.callerWorkflowPath,
+        managedStatePath: desired.managedStatePath,
+        assets
+    };
+    const stateDigest = digestBytes(Buffer.from(canonicalConsumerIntegrationJson({
+        domain: "agent-teams.docs-protocol.managed-state/v1",
+        body
+    }), "utf8"));
+    return `${canonicalConsumerIntegrationJson({ ...body, stateDigest })}\n`;
+}
+export function describeCanonicalConsumerAssets(cohort) {
+    const skillDigest = digestBytes(Buffer.from(CANONICAL_DOCS_SKILL, "utf8"));
+    const callerWorkflowDigest = digestBytes(Buffer.from(canonicalCallerWorkflow(cohort), "utf8"));
+    const assetCatalogDigest = digestBytes(Buffer.from(CANONICAL_ASSET_CATALOG, "utf8"));
+    return Object.freeze({
+        skillDigest,
+        callerWorkflowDigest,
+        assetCatalogDigest,
+        transitionCatalogDigest: digestBytes(Buffer.from(CANONICAL_TRANSITION_CATALOG, "utf8"))
+    });
+}
+//# sourceMappingURL=consumer-integration-assets.js.map