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

package/dist/consumer-integration/application/use-cases/upgrade-consumer-integration.js

@@ -0,0 +1,134 @@
+import { compileKnownFileTransactionPlan } from "@agent-teams/repository-mutation";
+import { compileConsumerIntegration } from "./plan-consumer-integration.js";
+import { canonicalConsumerIntegrationJson } from "../policies/consumer-integration-assets.js";
+function issue(code, subject, message) {
+    return Object.freeze({ code, severity: "error", subject, message });
+}
+function blocked(problem, authority) {
+    return Object.freeze({
+        schemaVersion: 1,
+        command: "consumer.upgrade",
+        outcome: "blocked",
+        issues: Object.freeze([problem]),
+        ...(authority === undefined ? {} : { authority: authorityEvidence(authority) })
+    });
+}
+function authorityEvidence(authority) {
+    return Object.freeze({
+        repository: authority.repository,
+        path: authority.path,
+        revision: authority.revision,
+        cohortId: authority.cohort.cohortId,
+        recordDigest: authority.cohort.recordDigest,
+        qualificationEventDigest: authority.cohort.qualificationEventDigest
+    });
+}
+function reverseOperations(operations) {
+    return operations.map((operation) => {
+        if (operation.precondition.state !== "known-file" ||
+            operation.precondition.acceptedPreimages.length !== 1) {
+            throw new TypeError("A Cohort-to-Cohort upgrade may replace only one exact existing preimage.");
+        }
+        const preimage = operation.precondition.acceptedPreimages[0];
+        const postimageMode = operation.postimage.mode;
+        if (postimageMode === undefined) {
+            throw new TypeError("A Cohort-to-Cohort upgrade postimage must retain an exact file mode.");
+        }
+        return Object.freeze({
+            path: operation.path,
+            precondition: {
+                state: "known-file",
+                acceptedPreimages: [{ bytes: operation.postimage.bytes, mode: postimageMode }]
+            },
+            postimage: { bytes: preimage.bytes, mode: preimage.mode }
+        });
+    });
+}
+export function createConsumerUpgradeUseCase(ports) {
+    return async function upgrade(options) {
+        const inspection = await ports.transaction.inspect({ consumerRoot: options.consumerRoot });
+        if (inspection.state !== "idle") {
+            return blocked(issue(inspection.code, "foundation-transaction", inspection.message));
+        }
+        const [input, assetCatalog] = await Promise.all([
+            ports.input.read({ consumerRoot: options.consumerRoot }),
+            ports.assets.read()
+        ]);
+        const source = compileConsumerIntegration({
+            desired: input.desired,
+            snapshot: input.snapshot,
+            assetCatalog
+        }, ports.planning).plan;
+        if (source.outcome !== "current") {
+            return blocked(issue("DOCS_CONSUMER_UPGRADE_SOURCE_NOT_CURRENT", input.desired.cohort.cohortId, "The installed source Cohort must pass consumer check before a successor is staged."));
+        }
+        if (input.desired.cohort.cohortId === options.to) {
+            return Object.freeze({
+                schemaVersion: 1,
+                command: "consumer.upgrade",
+                outcome: "current",
+                issues: Object.freeze([])
+            });
+        }
+        const authority = await ports.authority.read({
+            cohortId: options.to,
+            repository: input.desired.repository,
+            ...(options.authorityRevision === undefined
+                ? {}
+                : { revision: options.authorityRevision })
+        });
+        if (!authority.cohort.upgradeFrom.includes(input.desired.cohort.cohortId)) {
+            return blocked(issue("DOCS_CONSUMER_COHORT_TRANSITION_FORBIDDEN", options.to, `Central authority does not permit an upgrade from ${input.desired.cohort.cohortId}.`), authority);
+        }
+        const prepared = await ports.sandbox.prepare({
+            authority,
+            consumerRoot: input.root,
+            current: input.desired
+        });
+        if (prepared.operations.length === 0) {
+            throw new TypeError("The staged successor produced no repository changes.");
+        }
+        const confirmedAuthority = await ports.authority.read({
+            cohortId: options.to,
+            repository: input.desired.repository,
+            revision: authority.revision
+        });
+        if (canonicalConsumerIntegrationJson(confirmedAuthority) !==
+            canonicalConsumerIntegrationJson(authority)) {
+            return blocked(issue("DOCS_CONSUMER_AUTHORITY_CHANGED", options.to, "Central Cohort authority changed while the successor was staged."), confirmedAuthority);
+        }
+        const mutationPlan = compileKnownFileTransactionPlan({
+            operations: prepared.operations
+        });
+        const receipt = await ports.transaction.apply({
+            consumerRoot: input.root,
+            plan: mutationPlan
+        });
+        try {
+            await ports.sandbox.activateAndVerify({
+                authority,
+                consumerRoot: input.root
+            });
+        }
+        catch (activationError) {
+            const rollbackPlan = compileKnownFileTransactionPlan({
+                operations: reverseOperations(prepared.operations)
+            });
+            await ports.transaction.apply({ consumerRoot: input.root, plan: rollbackPlan });
+            await ports.sandbox.restoreAndVerify({
+                consumerRoot: input.root,
+                current: input.desired
+            });
+            throw activationError;
+        }
+        return Object.freeze({
+            schemaVersion: 1,
+            command: "consumer.upgrade",
+            outcome: receipt.outcome === "applied" ? "upgraded" : "current",
+            issues: Object.freeze([]),
+            authority: authorityEvidence(authority),
+            receipt
+        });
+    };
+}
+//# sourceMappingURL=upgrade-consumer-integration.js.map

package/dist/consumer-integration/application/use-cases/upgrade-consumer-integration.js.map

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

package/dist/consumer-integration/composition/consumer-integration-cli.d.ts

@@ -0,0 +1,3 @@
+export declare function managedDocsHelp(): string;
+export declare function runManagedConsumerCommand(argv: readonly string[]): Promise<number>;
+//# sourceMappingURL=consumer-integration-cli.d.ts.map

package/dist/consumer-integration/composition/consumer-integration-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer-integration-cli.d.ts","sourceRoot":"","sources":["../../../src/consumer-integration/composition/consumer-integration-cli.ts"],"names":[],"mappings":"AA8JA,wBAAgB,eAAe,IAAI,MAAM,CAgBxC;AAGD,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA+DxF"}

package/dist/consumer-integration/composition/consumer-integration-cli.js

@@ -0,0 +1,241 @@
+import { applyConsumerIntegration, checkConsumerIntegration, planNodeConsumerIntegration, recoverConsumerIntegration, upgradeConsumerIntegration } from "./node-consumer-integration.js";
+import { assertConsumerIntegrationExecutionSchema, assertConsumerUpgradeExecutionSchema } from "../adapters/consumer-integration-schema-validator.js";
+class ConsumerCliInputError extends Error {
+    code = "DOCS_CONSUMER_CLI_INVALID";
+}
+const COHORT_ID = /^[a-z0-9]+(?:[._-][a-z0-9]+)*$/u;
+const SHA256 = /^sha256:[0-9a-f]{64}$/u;
+const GIT_SHA = /^(?!0{40}$)[0-9a-f]{40}$/u;
+const MAXIMUM_ARGUMENT_LENGTH = 4096;
+const MAXIMUM_ARGUMENTS = 32;
+class Arguments {
+    #values;
+    #used = new Set();
+    constructor(values) {
+        this.#values = [...values];
+    }
+    flag(name) {
+        const indexes = this.#values.flatMap((value, index) => value === name ? [index] : []);
+        if (indexes.length > 1) {
+            throw new ConsumerCliInputError(`${name} may be supplied only once.`);
+        }
+        if (indexes[0] !== undefined) {
+            this.#used.add(indexes[0]);
+        }
+        return indexes.length === 1;
+    }
+    one(name, required = false) {
+        const indexes = this.#values.flatMap((value, index) => value === name ? [index] : []);
+        if (indexes.length > 1) {
+            throw new ConsumerCliInputError(`${name} may be supplied only once.`);
+        }
+        const index = indexes[0];
+        if (index === undefined) {
+            if (required) {
+                throw new ConsumerCliInputError(`${name} is required.`);
+            }
+            return undefined;
+        }
+        const value = this.#values[index + 1];
+        if (value === undefined || value.startsWith("--")) {
+            throw new ConsumerCliInputError(`${name} requires a value.`);
+        }
+        if (value.length > MAXIMUM_ARGUMENT_LENGTH || value.includes("\u0000")) {
+            throw new ConsumerCliInputError(`${name} contains an invalid or overlong value.`);
+        }
+        this.#used.add(index);
+        this.#used.add(index + 1);
+        return value;
+    }
+    assertConsumed() {
+        const unknown = this.#values.filter((_value, index) => !this.#used.has(index));
+        if (unknown.length > 0) {
+            throw new ConsumerCliInputError(`Unknown consumer arguments: ${unknown.join(" ")}.`);
+        }
+    }
+}
+function failure(command, error) {
+    const candidateCode = typeof error === "object" && error !== null && "code" in error &&
+        typeof error.code === "string" ? error.code : "DOCS_CONSUMER_EXECUTION_FAILURE";
+    const code = /^(?:DOCS_|KNOWN_)[A-Z0-9_]{1,122}$/u.test(candidateCode)
+        ? candidateCode
+        : "DOCS_CONSUMER_EXECUTION_FAILURE";
+    const rawMessage = error instanceof Error ? error.message : "Consumer integration failed.";
+    let safeMessage = "";
+    for (const character of rawMessage
+        .replace(/(?:[A-Za-z]:\\|\/(?:Users|home|tmp|private|var|Volumes)\/)[^\s'"`]+/gu, "<local-path>")) {
+        const codePoint = character.codePointAt(0) ?? 0;
+        safeMessage += (codePoint < 32 && ![9, 10, 13].includes(codePoint)) || codePoint === 127
+            ? "?"
+            : character;
+    }
+    safeMessage = safeMessage.slice(0, 4096);
+    if (command === "upgrade") {
+        return {
+            schemaVersion: 1,
+            command: "consumer.upgrade",
+            outcome: "blocked",
+            issues: [{ code, severity: "error", subject: command, message: safeMessage }]
+        };
+    }
+    const commandId = ["apply", "check", "plan", "recover"].includes(command)
+        ? `consumer.${command}`
+        : "consumer.check";
+    return {
+        schemaVersion: 1,
+        command: commandId,
+        outcome: "blocked",
+        issues: [{
+                code,
+                severity: "error",
+                subject: command.slice(0, 2048),
+                message: safeMessage
+            }]
+    };
+}
+function human(execution) {
+    const lines = [`${execution.command}: ${execution.outcome}`];
+    if (execution.command !== "consumer.upgrade" && execution.plan !== undefined) {
+        lines.push(`Cohort: ${execution.plan.cohortId}`);
+        lines.push(`Plan: ${execution.plan.planDigest}`);
+        for (const asset of execution.plan.assets) {
+            const current = asset.currentDigest === undefined ? "absent" : asset.currentDigest;
+            lines.push(`${asset.action.padEnd(7)} ${asset.path} (${asset.ownership}, ${asset.state})`);
+            if (asset.action !== "none") {
+                lines.push(`        ${current} -> ${asset.expectedDigest}`);
+            }
+        }
+    }
+    if (execution.receipt !== undefined) {
+        lines.push(`Receipt: ${execution.receipt.receiptDigest}`);
+    }
+    for (const issue of execution.issues) {
+        lines.push(`${issue.severity.toUpperCase()} ${issue.code} [${issue.subject}]: ${issue.message}`);
+        lines.push(issue.code === "DOCS_CONSUMER_STALE_PLAN"
+            ? "Next: run agent-teams-docs-managed plan again and review the new digest."
+            : issue.code.includes("RECOVERY") || issue.code.startsWith("KNOWN_FILE")
+                ? "Next: run agent-teams-docs-managed recover, then repeat check and plan."
+                : "Next: fix the reported authority or conflict, then repeat check and plan.");
+    }
+    return `${lines.join("\n")}\n`;
+}
+function exitCode(execution) {
+    if (["applied", "current", "recovered", "upgraded"].includes(execution.outcome)) {
+        return 0;
+    }
+    if (execution.outcome === "change-required") {
+        return 1;
+    }
+    const codes = new Set(execution.issues.map(({ code }) => code));
+    if (codes.has("DOCS_CONSUMER_CLI_INVALID")) {
+        return 2;
+    }
+    return codes.has("DOCS_CONSUMER_EXECUTION_FAILURE") ? 3 : 1;
+}
+function assertBoundedArgv(argv) {
+    if (argv.length > MAXIMUM_ARGUMENTS || argv.some((value) => typeof value !== "string" || value.length > MAXIMUM_ARGUMENT_LENGTH || value.includes("\u0000"))) {
+        throw new ConsumerCliInputError("Consumer arguments are invalid or exceed the bounded CLI contract.");
+    }
+}
+function requestsJsonOutput(argv) {
+    return argv.some((value) => value === "--json");
+}
+export function managedDocsHelp() {
+    return `Usage: agent-teams-docs-managed <command> [options]
+
+Commands:
+  check                         Verify the selected Cohort without writing
+  plan --to COHORT              Print a deterministic, write-free semantic plan
+  apply --expect SHA256         Rebuild and apply the reviewed plan through Foundation
+  upgrade --to COHORT           Project authority, pins, lockfile, and assets in one command
+  recover                       Recover the Foundation transaction (profile not read)
+
+Options:
+  --consumer PATH               Git repository root (default: .)
+  --authority-revision SHA      Optional exact protected .github revision
+  --json                        Emit one bounded versioned JSON envelope
+  --help                        Show this help
+`;
+}
+// oxlint-disable-next-line complexity
+export async function runManagedConsumerCommand(argv) {
+    let command = "";
+    const jsonRequested = requestsJsonOutput(argv);
+    let execution;
+    try {
+        assertBoundedArgv(argv);
+        command = argv[0] ?? "";
+        if (command === "help" || command === "--help" || argv[1] === "--help") {
+            const helpArgs = new Arguments(argv.slice(1));
+            if (argv[1] === "--help") {
+                helpArgs.flag("--help");
+            }
+            helpArgs.assertConsumed();
+            process.stdout.write(managedDocsHelp());
+            return 0;
+        }
+        const args = new Arguments(argv.slice(1));
+        args.flag("--json");
+        const consumerRoot = args.one("--consumer") ?? ".";
+        if (command === "check") {
+            args.assertConsumed();
+            execution = await checkConsumerIntegration({ consumerRoot });
+        }
+        else if (command === "plan") {
+            const to = args.one("--to", true);
+            if (!COHORT_ID.test(to)) {
+                throw new ConsumerCliInputError("--to must be one exact Cohort ID.");
+            }
+            args.assertConsumed();
+            execution = await planNodeConsumerIntegration({ consumerRoot, to });
+        }
+        else if (command === "apply") {
+            const expect = args.one("--expect", true);
+            if (!SHA256.test(expect)) {
+                throw new ConsumerCliInputError("--expect must be one sha256 Plan digest.");
+            }
+            args.assertConsumed();
+            execution = await applyConsumerIntegration({ consumerRoot, expect });
+        }
+        else if (command === "upgrade") {
+            const to = args.one("--to", true);
+            if (!COHORT_ID.test(to)) {
+                throw new ConsumerCliInputError("--to must be one exact Cohort ID.");
+            }
+            const authorityRevision = args.one("--authority-revision");
+            if (authorityRevision !== undefined && !GIT_SHA.test(authorityRevision)) {
+                throw new ConsumerCliInputError("--authority-revision must be one nonzero lowercase Git SHA.");
+            }
+            args.assertConsumed();
+            execution = await upgradeConsumerIntegration({
+                consumerRoot,
+                to,
+                ...(authorityRevision === undefined ? {} : { authorityRevision })
+            });
+        }
+        else if (command === "recover") {
+            args.assertConsumed();
+            execution = await recoverConsumerIntegration({ consumerRoot });
+        }
+        else {
+            throw new ConsumerCliInputError("Expected consumer command: check, plan, apply, upgrade, or recover.");
+        }
+    }
+    catch (error) {
+        execution = failure(command || "check", error);
+    }
+    try {
+        if (execution.command === "consumer.upgrade") {
+            await assertConsumerUpgradeExecutionSchema(execution);
+        }
+        else {
+            await assertConsumerIntegrationExecutionSchema(execution);
+        }
+    }
+    catch (error) {
+        execution = failure(command || "check", error);
+    }
+    process.stdout.write(jsonRequested ? `${JSON.stringify(execution)}\n` : human(execution));
+    return exitCode(execution);
+}
+//# sourceMappingURL=consumer-integration-cli.js.map

package/dist/consumer-integration/composition/consumer-integration-cli.js.map

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

package/dist/consumer-integration/composition/consumer-integration-planner.d.ts

@@ -0,0 +1,19 @@
+import type { ConsumerAssetCatalogV1, KnownPriorCohortCatalogEntryV1 } from "../application/policies/consumer-integration-assets.js";
+import type { ConsumerIntegrationPlanningPorts } from "../application/ports/consumer-integration-planners.js";
+import type { ConsumerIntegrationDesiredStateV1, ConsumerIntegrationPlanV1, ConsumerIntegrationSnapshot } from "../domain/model.js";
+export declare const consumerIntegrationPlanningPorts: ConsumerIntegrationPlanningPorts;
+export declare function compileConsumerIntegration(input: {
+    readonly desired: ConsumerIntegrationDesiredStateV1;
+    readonly snapshot: ConsumerIntegrationSnapshot;
+    readonly assetCatalog?: ConsumerAssetCatalogV1;
+    /** Unit-level compatibility input; production composition loads package assets. */
+    readonly knownPriorCohorts?: readonly KnownPriorCohortCatalogEntryV1[];
+}): {
+    readonly plan: ConsumerIntegrationPlanV1;
+    readonly mutationPlan?: ReturnType<typeof import("@agent-teams/repository-mutation").compileKnownFileTransactionPlan>;
+};
+export declare function planConsumerIntegration(input: {
+    readonly desired: ConsumerIntegrationDesiredStateV1;
+    readonly snapshot: ConsumerIntegrationSnapshot;
+}): ConsumerIntegrationPlanV1;
+//# sourceMappingURL=consumer-integration-planner.d.ts.map

package/dist/consumer-integration/composition/consumer-integration-planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer-integration-planner.d.ts","sourceRoot":"","sources":["../../../src/consumer-integration/composition/consumer-integration-planner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,sBAAsB,EACtB,8BAA8B,EAC/B,MAAM,wDAAwD,CAAC;AAChE,OAAO,KAAK,EACV,gCAAgC,EACjC,MAAM,uDAAuD,CAAC;AAI/D,OAAO,KAAK,EACV,iCAAiC,EACjC,yBAAyB,EACzB,2BAA2B,EAC5B,MAAM,oBAAoB,CAAC;AAE5B,eAAO,MAAM,gCAAgC,EAAE,gCAI3C,CAAC;AAEL,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,QAAQ,CAAC,OAAO,EAAE,iCAAiC,CAAC;IACpD,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;IAC/C,QAAQ,CAAC,YAAY,CAAC,EAAE,sBAAsB,CAAC;IAC/C,mFAAmF;IACnF,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,8BAA8B,EAAE,CAAC;CACxE;;;EAEA;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,QAAQ,CAAC,OAAO,EAAE,iCAAiC,CAAC;IACpD,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;CAChD,GAAG,yBAAyB,CAE5B"}

package/dist/consumer-integration/composition/consumer-integration-planner.js

@@ -0,0 +1,14 @@
+import { agentsRoutePlannerV1 } from "../adapters/agents-route-adapter-v1.js";
+import { pnpmManifestPlannerV1 } from "../adapters/pnpm-manifest-adapter-v1.js";
+import { compileConsumerIntegration as compileWithPorts } from "../application/use-cases/plan-consumer-integration.js";
+export const consumerIntegrationPlanningPorts = Object.freeze({
+    agentsRoute: agentsRoutePlannerV1,
+    packageManifest: pnpmManifestPlannerV1
+});
+export function compileConsumerIntegration(input) {
+    return compileWithPorts(input, consumerIntegrationPlanningPorts);
+}
+export function planConsumerIntegration(input) {
+    return compileConsumerIntegration(input).plan;
+}
+//# sourceMappingURL=consumer-integration-planner.js.map

package/dist/consumer-integration/composition/consumer-integration-planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer-integration-planner.js","sourceRoot":"","sources":["../../../src/consumer-integration/composition/consumer-integration-planner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAQhF,OAAO,EACL,0BAA0B,IAAI,gBAAgB,EAC/C,MAAM,uDAAuD,CAAC;AAO/D,MAAM,CAAC,MAAM,gCAAgC,GAC3C,MAAM,CAAC,MAAM,CAAC;IACZ,WAAW,EAAE,oBAAoB;IACjC,eAAe,EAAE,qBAAqB;CACvC,CAAC,CAAC;AAEL,MAAM,UAAU,0BAA0B,CAAC,KAM1C;IACC,OAAO,gBAAgB,CAAC,KAAK,EAAE,gCAAgC,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAGvC;IACC,OAAO,0BAA0B,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC;AAChD,CAAC"}

package/dist/consumer-integration/composition/node-consumer-integration.d.ts

@@ -0,0 +1,26 @@
+import type { ConsumerIntegrationExecutionV1 } from "../application/model/consumer-integration-execution.js";
+import type { ConsumerUpgradeExecutionV1 } from "../application/model/consumer-upgrade-execution.js";
+export type { ConsumerIntegrationExecutionV1 } from "../application/model/consumer-integration-execution.js";
+export declare function checkConsumerIntegration(options: {
+    readonly consumerRoot: string;
+    readonly integrationProfilePath?: string;
+}): Promise<ConsumerIntegrationExecutionV1>;
+export declare function planNodeConsumerIntegration(options: {
+    readonly consumerRoot: string;
+    readonly integrationProfilePath?: string;
+    readonly to: string;
+}): Promise<ConsumerIntegrationExecutionV1>;
+export declare function applyConsumerIntegration(options: {
+    readonly consumerRoot: string;
+    readonly expect: string;
+    readonly integrationProfilePath?: string;
+}): Promise<ConsumerIntegrationExecutionV1>;
+export declare function recoverConsumerIntegration(options: {
+    readonly consumerRoot: string;
+}): Promise<ConsumerIntegrationExecutionV1>;
+export declare function upgradeConsumerIntegration(options: {
+    readonly consumerRoot: string;
+    readonly authorityRevision?: string;
+    readonly to: string;
+}): Promise<ConsumerUpgradeExecutionV1>;
+//# sourceMappingURL=node-consumer-integration.d.ts.map

package/dist/consumer-integration/composition/node-consumer-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-consumer-integration.d.ts","sourceRoot":"","sources":["../../../src/consumer-integration/composition/node-consumer-integration.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,8BAA8B,EAC/B,MAAM,wDAAwD,CAAC;AAOhE,OAAO,KAAK,EACV,0BAA0B,EAC3B,MAAM,oDAAoD,CAAC;AAG5D,YAAY,EACV,8BAA8B,EAC/B,MAAM,wDAAwD,CAAC;AAkBhE,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;CAC1C,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAE1C;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE;IACnD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAE1C;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;CAC1C,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAE1C;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAClD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAE1C;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAClD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAEtC"}

package/dist/consumer-integration/composition/node-consumer-integration.js

@@ -0,0 +1,38 @@
+import { foundationKnownFileTransaction } from "../adapters/foundation-known-file-transaction.js";
+import { githubCohortAuthorityReader } from "../adapters/github-cohort-authority-reader.js";
+import { nodeConsumerIntegrationInputReader } from "../adapters/node-consumer-integration-repository.js";
+import { packageConsumerAssetCatalogReader } from "../adapters/package-consumer-asset-catalog.js";
+import { nodeConsumerUpgradeSandbox } from "../adapters/node-consumer-upgrade-sandbox.js";
+import { createConsumerIntegrationUseCases } from "../application/use-cases/run-consumer-integration.js";
+import { createConsumerUpgradeUseCase } from "../application/use-cases/upgrade-consumer-integration.js";
+import { consumerIntegrationPlanningPorts } from "./consumer-integration-planner.js";
+const useCases = createConsumerIntegrationUseCases({
+    assets: packageConsumerAssetCatalogReader,
+    input: nodeConsumerIntegrationInputReader,
+    planning: consumerIntegrationPlanningPorts,
+    transaction: foundationKnownFileTransaction
+});
+const upgrade = createConsumerUpgradeUseCase({
+    assets: packageConsumerAssetCatalogReader,
+    authority: githubCohortAuthorityReader,
+    input: nodeConsumerIntegrationInputReader,
+    planning: consumerIntegrationPlanningPorts,
+    sandbox: nodeConsumerUpgradeSandbox,
+    transaction: foundationKnownFileTransaction
+});
+export function checkConsumerIntegration(options) {
+    return useCases.check(options);
+}
+export function planNodeConsumerIntegration(options) {
+    return useCases.plan(options);
+}
+export function applyConsumerIntegration(options) {
+    return useCases.apply(options);
+}
+export function recoverConsumerIntegration(options) {
+    return useCases.recover(options);
+}
+export function upgradeConsumerIntegration(options) {
+    return upgrade(options);
+}
+//# sourceMappingURL=node-consumer-integration.js.map

package/dist/consumer-integration/composition/node-consumer-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-consumer-integration.js","sourceRoot":"","sources":["../../../src/consumer-integration/composition/node-consumer-integration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,kDAAkD,CAAC;AAClG,OAAO,EAAE,2BAA2B,EAAE,MAAM,+CAA+C,CAAC;AAC5F,OAAO,EACL,kCAAkC,EACnC,MAAM,qDAAqD,CAAC;AAC7D,OAAO,EACL,iCAAiC,EAClC,MAAM,+CAA+C,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,8CAA8C,CAAC;AAI1F,OAAO,EACL,iCAAiC,EAClC,MAAM,sDAAsD,CAAC;AAC9D,OAAO,EACL,4BAA4B,EAC7B,MAAM,0DAA0D,CAAC;AAIlE,OAAO,EAAE,gCAAgC,EAAE,MAAM,mCAAmC,CAAC;AAMrF,MAAM,QAAQ,GAAG,iCAAiC,CAAC;IACjD,MAAM,EAAE,iCAAiC;IACzC,KAAK,EAAE,kCAAkC;IACzC,QAAQ,EAAE,gCAAgC;IAC1C,WAAW,EAAE,8BAA8B;CAC5C,CAAC,CAAC;AAEH,MAAM,OAAO,GAAG,4BAA4B,CAAC;IAC3C,MAAM,EAAE,iCAAiC;IACzC,SAAS,EAAE,2BAA2B;IACtC,KAAK,EAAE,kCAAkC;IACzC,QAAQ,EAAE,gCAAgC;IAC1C,OAAO,EAAE,0BAA0B;IACnC,WAAW,EAAE,8BAA8B;CAC5C,CAAC,CAAC;AAEH,MAAM,UAAU,wBAAwB,CAAC,OAGxC;IACC,OAAO,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,OAI3C;IACC,OAAO,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAIxC;IACC,OAAO,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,OAE1C;IACC,OAAO,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,OAI1C;IACC,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;AAC1B,CAAC"}

package/dist/consumer-integration/domain/model.d.ts

@@ -0,0 +1,111 @@
+export type ConsumerIntegrationDigest = `sha256:${string}`;
+export interface QualifiedDocsCohortV1 {
+    readonly schemaVersion: 1;
+    readonly cohortId: string;
+    readonly channel: "rc" | "stable";
+    readonly recordDigest: ConsumerIntegrationDigest;
+    readonly qualificationEventDigest: ConsumerIntegrationDigest;
+    readonly lifecycleState: "QUALIFIED" | "CANARY" | "RECOMMENDED";
+    readonly eligibleAfter: string;
+    readonly upgradeFrom: readonly string[];
+    readonly rollbackTo: readonly string[];
+    readonly canaryRepositoryIds: readonly string[];
+    readonly packages: {
+        readonly docsProtocol: {
+            readonly version: string;
+            readonly integrity: `sha512-${string}`;
+        };
+        readonly engineeringFoundation: {
+            readonly version: string;
+            readonly integrity: `sha512-${string}`;
+        };
+    };
+    readonly workflow: {
+        readonly repository: string;
+        readonly path: string;
+        readonly revision: string;
+        readonly blobSha: string;
+    };
+    readonly assets: {
+        readonly skillDigest: ConsumerIntegrationDigest;
+        readonly callerWorkflowDigest: ConsumerIntegrationDigest;
+        readonly assetCatalogDigest: ConsumerIntegrationDigest;
+        readonly transitionCatalogDigest: ConsumerIntegrationDigest;
+    };
+    readonly schemas: {
+        readonly consumerIntegration: 1;
+        readonly managedState: 1;
+        readonly docsProtocol: 1;
+    };
+    readonly runtime: {
+        readonly node: ">=24.18.0 <25";
+        readonly pnpm: ">=11.17.0 <12";
+        readonly runtimeClosureDigest: ConsumerIntegrationDigest;
+    };
+}
+/** Immutable Cohort evidence that may be committed in a consumer repository. */
+export type QualifiedDocsCohortBindingV1 = Omit<QualifiedDocsCohortV1, "canaryRepositoryIds" | "lifecycleState">;
+export interface ConsumerIntegrationDesiredStateV1 {
+    readonly schemaVersion: 1;
+    readonly repository: {
+        readonly provider: "github";
+        readonly id: string;
+        readonly nameWithOwner: string;
+    };
+    readonly integrationRoot: ".";
+    readonly packageManager: "pnpm";
+    readonly profilePath: string;
+    readonly skillPath: string;
+    readonly callerWorkflowPath: string;
+    readonly managedStatePath: string;
+    readonly governedDocsRoots?: readonly string[];
+    readonly cohort: QualifiedDocsCohortBindingV1;
+}
+export type ConsumerIntegrationFileObservation = {
+    readonly state: "absent";
+} | {
+    readonly state: "file";
+    readonly bytes: Uint8Array;
+    readonly mode: number;
+};
+export interface ConsumerIntegrationSnapshot {
+    readonly integrationProfile: ConsumerIntegrationFileObservation;
+    readonly lockfile: ConsumerIntegrationFileObservation;
+    readonly packageManifest: ConsumerIntegrationFileObservation;
+    readonly agents: ConsumerIntegrationFileObservation;
+    readonly skill: ConsumerIntegrationFileObservation;
+    readonly callerWorkflow: ConsumerIntegrationFileObservation;
+    readonly managedState: ConsumerIntegrationFileObservation;
+}
+export type ConsumerIntegrationAssetState = "absent" | "exact-current" | "known-prior" | "partial-adoption" | "outdated-cohort" | "unknown-modified" | "conflict" | "unsupported";
+export interface ConsumerIntegrationIssue {
+    readonly code: string;
+    readonly severity: "error" | "warning";
+    readonly subject: string;
+    readonly message: string;
+}
+export interface ConsumerIntegrationAssetPlan {
+    readonly id: "agents-route" | "caller-workflow" | "managed-state" | "package-manifest" | "skill";
+    readonly path: string;
+    readonly ownership: "full-bytes" | "partial-fields" | "managed-block";
+    readonly state: ConsumerIntegrationAssetState;
+    readonly currentDigest?: ConsumerIntegrationDigest;
+    readonly expectedDigest: ConsumerIntegrationDigest;
+    readonly action: "create" | "none" | "replace" | "blocked";
+}
+export interface ConsumerIntegrationPlanV1 {
+    readonly schemaVersion: 1;
+    readonly cohortId: string;
+    readonly repository: ConsumerIntegrationDesiredStateV1["repository"];
+    readonly planDigest: ConsumerIntegrationDigest;
+    readonly outcome: "blocked" | "change-required" | "current";
+    readonly assets: readonly ConsumerIntegrationAssetPlan[];
+    readonly issues: readonly ConsumerIntegrationIssue[];
+}
+export interface ConsumerUpgradeAuthorityV1 {
+    readonly repository: "agent-teams-ai/.github";
+    readonly path: "governance/docs-qualified-cohorts.json";
+    readonly revision: string;
+    readonly cohort: QualifiedDocsCohortBindingV1;
+}
+//# sourceMappingURL=model.d.ts.map