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

package/dist/consumer-integration/adapters/node-consumer-restoration-lock.js

@@ -0,0 +1,104 @@
+import { isNode, parseDocument, visit } from "yaml";
+import { requireRestoration, restorationJson } from "../application/policies/consumer-restoration-proof.js";
+import { assertQualifiedPnpmLockfileV1 } from "./pnpm-lockfile-validator-v1.js";
+import { assertQualifiedPnpmLockfileV2 } from "./pnpm-lockfile-validator-v2.js";
+const managedRoots = new Set(["@agent-teams/docs-protocol", "@agent-teams/engineering-foundation", "@agent-teams/docs-protocol-agent-teams"]);
+const sections = ["dependencies", "devDependencies", "optionalDependencies"];
+function record(value) {
+    requireRestoration(value !== null && typeof value === "object" && !Array.isArray(value), "invalid lock mapping.");
+    return value;
+}
+function parse(bytes) {
+    const document = parseDocument(new TextDecoder("utf-8", { fatal: true }).decode(bytes), { uniqueKeys: true });
+    requireRestoration(document.errors.length === 0, "invalid lock YAML.");
+    const comments = [document.commentBefore, document.comment].filter((value) => typeof value === "string");
+    visit(document, (_key, node) => {
+        if (!isNode(node)) {
+            return;
+        }
+        for (const value of [node.commentBefore, node.comment]) {
+            if (typeof value === "string") {
+                comments.push(value);
+            }
+        }
+    });
+    return { value: record(document.toJS({ maxAliasCount: 0 })), comments: comments.toSorted() };
+}
+function snapshotLocator(lock, name, version) {
+    // pnpm stores a foreign alias resolution as its target locator, including any peer context.
+    return Object.hasOwn(record(lock["snapshots"]), version) ? version : `${name}@${version}`;
+}
+function closure(lock, roots) {
+    const snapshots = record(lock["snapshots"]);
+    const visited = new Set();
+    const pending = [...roots];
+    while (pending.length > 0) {
+        const key = pending.pop();
+        if (visited.has(key)) {
+            continue;
+        }
+        requireRestoration(visited.size < 8192, "lock scope exceeds bounded graph.");
+        // Unrelated workspace/link dependencies remain verbatim in their importer.
+        if (!Object.hasOwn(snapshots, key)) {
+            continue;
+        }
+        visited.add(key);
+        const snapshot = record(snapshots[key]);
+        for (const section of ["dependencies", "optionalDependencies"]) {
+            for (const [name, version] of Object.entries(record(snapshot[section] ?? {}))) {
+                requireRestoration(typeof version === "string", "invalid lock resolution.");
+                pending.push(snapshotLocator(lock, name, version));
+            }
+        }
+    }
+    return visited;
+}
+function nonOwnedProjection(lock) {
+    const copy = structuredClone(lock);
+    const importers = record(copy["importers"]);
+    const owned = [];
+    const foreign = [];
+    for (const [path, rawImporter] of Object.entries(importers)) {
+        const importer = record(rawImporter);
+        for (const section of sections) {
+            const entries = record(importer[section] ?? {});
+            for (const [name, value] of Object.entries(entries)) {
+                const binding = record(value);
+                requireRestoration(typeof binding["version"] === "string", "invalid importer resolution.");
+                const isOwned = path === "." && section === "devDependencies" && managedRoots.has(name);
+                (isOwned ? owned : foreign).push(snapshotLocator(lock, name, binding["version"]));
+                if (isOwned) {
+                    delete entries[name];
+                }
+            }
+            // pnpm removes empty dependency sections; normalize only this structural difference.
+            if (Object.keys(entries).length === 0) {
+                delete importer[section];
+            }
+        }
+    }
+    const managed = closure(lock, owned);
+    const preserved = closure(lock, foreign);
+    const preservedPackages = new Set([...preserved].map((key) => key.split("(", 1)[0]));
+    const snapshots = record(copy["snapshots"]);
+    const packages = record(copy["packages"]);
+    for (const key of managed) {
+        if (!preserved.has(key)) {
+            delete snapshots[key];
+        }
+        const physical = key.split("(", 1)[0];
+        if (!preservedPackages.has(physical)) {
+            delete packages[physical];
+        }
+    }
+    return copy;
+}
+export function assertRestorationLockScope(before, after, source, target) {
+    // Existing qualification validates exact coordinates, registry provenance, edges and closure digests.
+    assertQualifiedPnpmLockfileV1(before, source);
+    assertQualifiedPnpmLockfileV2(after, target);
+    const sourceLock = parse(before), targetLock = parse(after);
+    requireRestoration(restorationJson(sourceLock.comments) === restorationJson(targetLock.comments), "lock migration changes consumer comments.");
+    requireRestoration(restorationJson(nonOwnedProjection(sourceLock.value)) === restorationJson(nonOwnedProjection(targetLock.value)), "lock migration changes non-owned policy, importers, dependencies or package graphs.");
+}
+//# sourceMappingURL=node-consumer-restoration-lock.js.map

package/dist/consumer-integration/adapters/node-consumer-restoration-lock.js.map

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

package/dist/consumer-integration/adapters/node-consumer-restoration-scope.d.ts

@@ -0,0 +1,9 @@
+import type { KnownFileTransactionPlanV1 } from "@agent-teams/repository-mutation";
+import type { ConsumerIntegrationDesiredStateV1, QualifiedDocsCohortBindingV2 } from "../domain/model.js";
+export declare function assertRestorationManagedEffects(input: {
+    readonly current: ConsumerIntegrationDesiredStateV1;
+    readonly target: QualifiedDocsCohortBindingV2;
+    readonly plan: KnownFileTransactionPlanV1;
+    readonly originals: ReadonlyMap<string, Buffer>;
+}): Promise<void>;
+//# sourceMappingURL=node-consumer-restoration-scope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"node-consumer-restoration-scope.d.ts","sourceRoot":"","sources":["../../../src/consumer-integration/adapters/node-consumer-restoration-scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AACnF,OAAO,KAAK,EAAE,iCAAiC,EAAqC,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAc7I,wBAAsB,+BAA+B,CAAC,KAAK,EAAE;IAC3D,QAAQ,CAAC,OAAO,EAAE,iCAAiC,CAAC;IACpD,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjD,GAAG,OAAO,CAAC,IAAI,CAAC,CA4DhB"}

package/dist/consumer-integration/adapters/node-consumer-restoration-scope.js

@@ -0,0 +1,71 @@
+import { requireRestoration, restorationJson } from "../application/policies/consumer-restoration-proof.js";
+import { CANONICAL_DOCS_SKILL_V2, canonicalCallerWorkflow, canonicalDocsScriptsDigest, canonicalManagedRoute, canonicalManagedState, describeCanonicalConsumerAssets, digestBytes } from "../application/policies/consumer-integration-assets.js";
+import { projectConsumerUpgradeFiles } from "./consumer-upgrade-file-projectors.js";
+import { planAgentsRouteV1 } from "./agents-route-adapter-v1.js";
+import { planPnpmManifestV2 } from "./pnpm-manifest-adapter-v2.js";
+import { assertRestorationLockScope } from "./node-consumer-restoration-lock.js";
+import { parseJsonRecord } from "./strict-json-record.js";
+import { INTEGRATION_PROFILE_PATH } from "./node-consumer-repository-files.js";
+// Git bytes and deterministic managed projections own scope, never a caller's Plan or receipt.
+export async function assertRestorationManagedEffects(input) {
+    const { current, target, plan, originals } = input;
+    const original = (path) => {
+        const bytes = originals.get(path);
+        requireRestoration(bytes !== undefined, `original managed file is missing: ${path}.`);
+        return bytes;
+    };
+    // Canonical evidence sorts object keys; JSON profile rendering retains the forward key order.
+    // Accept that order only after proving the entire candidate Cohort equals independent authority.
+    const profileOperation = plan.operations.find(({ path }) => path === INTEGRATION_PROFILE_PATH);
+    requireRestoration(profileOperation !== undefined, "migration lacks its profile replacement.");
+    const profileTarget = parseJsonRecord(Buffer.from(profileOperation.postimage.contentBase64, "base64").toString("utf8"))["cohort"];
+    requireRestoration(restorationJson(profileTarget) === restorationJson(target), "profile target differs from selected authority.");
+    const workspace = originals.get("pnpm-workspace.yaml");
+    const projected = await projectConsumerUpgradeFiles({
+        current, authority: { repository: "agent-teams-ai/.github", path: "governance/docs-qualified-cohorts.json", revision: "1".repeat(40), cohort: profileTarget },
+        manifest: original("package.json"), profile: original(INTEGRATION_PROFILE_PATH),
+        ...(workspace === undefined ? {} : { workspace })
+    });
+    const desired = parseJsonRecord(Buffer.from(projected.profile).toString("utf8"));
+    const assets = describeCanonicalConsumerAssets(target);
+    requireRestoration(restorationJson(assets) === restorationJson(target.assets), "target assets differ from retained controller projections.");
+    const routeDigest = digestBytes(Buffer.from(canonicalManagedRoute(current.skillPath)));
+    const scriptsDigest = canonicalDocsScriptsDigest(current.profilePath);
+    const sourceState = canonicalManagedState(current, {
+        ...current.cohort.assets, agentsRouteDigest: routeDigest, docsScriptsDigest: scriptsDigest
+    });
+    requireRestoration(digestBytes(original(current.skillPath)) === current.cohort.assets.skillDigest &&
+        digestBytes(original(current.callerWorkflowPath)) === current.cohort.assets.callerWorkflowDigest &&
+        original(current.managedStatePath).equals(Buffer.from(sourceState)), "source whole-file managed assets are not exact.");
+    const route = planAgentsRouteV1({ observation: { state: "file", bytes: original("AGENTS.md"), mode: 0o644 }, skillPath: current.skillPath });
+    const manifest = planPnpmManifestV2({ observation: { state: "file", bytes: projected.manifest, mode: 0o644 }, profilePath: current.profilePath, cohort: target });
+    requireRestoration(route.issues.length === 0 && manifest.issues.length === 0, "managed field projection is conflicted.");
+    const expected = new Map([
+        [INTEGRATION_PROFILE_PATH, projected.profile], ["package.json", manifest.postimage ?? projected.manifest],
+        ["AGENTS.md", route.postimage ?? original("AGENTS.md")],
+        [current.skillPath, Buffer.from(CANONICAL_DOCS_SKILL_V2)],
+        [current.callerWorkflowPath, Buffer.from(canonicalCallerWorkflow(target))],
+        [current.managedStatePath, Buffer.from(canonicalManagedState(desired, {
+                ...assets, agentsRouteDigest: routeDigest, docsScriptsDigest: scriptsDigest
+            }))]
+    ]);
+    if (projected.targetWorkspace !== undefined) {
+        expected.set("pnpm-workspace.yaml", projected.targetWorkspace);
+    }
+    const lock = plan.operations.find(({ path }) => path === "pnpm-lock.yaml");
+    requireRestoration(lock !== undefined, "migration lacks its lock replacement.");
+    const targetLock = Buffer.from(lock.postimage.contentBase64, "base64");
+    assertRestorationLockScope(original("pnpm-lock.yaml"), targetLock, current, desired);
+    expected.set("pnpm-lock.yaml", targetLock);
+    const paths = [...expected].filter(([path, bytes]) => !original(path).equals(Buffer.from(bytes))).map(([path]) => path).toSorted();
+    requireRestoration(restorationJson(paths) === restorationJson(plan.operations.map(({ path }) => path).toSorted()), "Plan paths differ from the exact deterministic managed effects.");
+    for (const operation of plan.operations) {
+        requireRestoration(operation.precondition.state === "known-file" &&
+            operation.precondition.acceptedPreimages[0].mode === operation.postimage.mode &&
+            Buffer.from(operation.postimage.contentBase64, "base64").equals(Buffer.from(expected.get(operation.path))), `Plan exceeds managed field/block ownership at ${operation.path}.`);
+    }
+    const oldPin = parseJsonRecord(original("package.json").toString("utf8"))["packageManager"];
+    const newPin = parseJsonRecord(Buffer.from(expected.get("package.json")).toString("utf8"))["packageManager"];
+    requireRestoration(typeof oldPin === "string" && oldPin === newPin, "migration must preserve the real packageManager pin.");
+}
+//# sourceMappingURL=node-consumer-restoration-scope.js.map

package/dist/consumer-integration/adapters/node-consumer-restoration-scope.js.map

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

package/dist/consumer-integration/adapters/node-consumer-restoration-selection.d.ts

@@ -0,0 +1,9 @@
+import type { ConsumerRestorationIntent, ConsumerRestorationOptions, ConsumerRestorationPreparation } from "../application/model/consumer-restoration.js";
+export declare function readRestorationEvidence(root: string, path: string, required?: boolean): Promise<import("../index.js").ConsumerIntegrationFileObservation>;
+export declare function readRestorationPreparation(root: string, path: string, expect: string): Promise<ConsumerRestorationPreparation>;
+export declare function readSelectedRestorationProof(root: string, options: Pick<ConsumerRestorationOptions, "proofPath" | "expect">): Promise<{
+    proof: import("../application/model/consumer-restoration.js").ConsumerRestorationProof;
+    digest: `sha256:${string}`;
+}>;
+export declare function assertRestorationBinding(root: string, proof: ConsumerRestorationIntent): Promise<import("../index.js").ConsumerIntegrationDesiredStateV1>;
+//# sourceMappingURL=node-consumer-restoration-selection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"node-consumer-restoration-selection.d.ts","sourceRoot":"","sources":["../../../src/consumer-integration/adapters/node-consumer-restoration-selection.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,8BAA8B,EAAE,MAAM,8CAA8C,CAAC;AAW1J,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,UAAO,qEAGxF;AAED,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAIpI;AAED,wBAAsB,4BAA4B,CAAC,IAAI,EAAE,MAAM,EAC7D,OAAO,EAAE,IAAI,CAAC,0BAA0B,EAAE,WAAW,GAAG,QAAQ,CAAC;;;GAOlE;AAED,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,yBAAyB,oEAe5F"}

package/dist/consumer-integration/adapters/node-consumer-restoration-selection.js

@@ -0,0 +1,35 @@
+import { basename, dirname } from "node:path";
+import { inspectKnownFileTransactionBarrier, sha256Bytes } from "@agent-teams/repository-mutation";
+import { MAXIMUM_RESTORATION_PROOF_BYTES, parseConsumerRestorationPreparation, parseConsumerRestorationProof, requireRestoration, restorationJson } from "../application/policies/consumer-restoration-proof.js";
+import { assertRestorationPlanSource, externalRestorationPath, historicalRestorationProfile, restorationArtifacts, restorationConsumer, restorationGit } from "./node-consumer-restoration-evidence.js";
+import { readStableConsumerFile } from "./node-consumer-repository-files.js";
+export async function readRestorationEvidence(root, path, required = true) {
+    const selected = await externalRestorationPath(path, root);
+    return readStableConsumerFile(dirname(selected), basename(selected), MAXIMUM_RESTORATION_PROOF_BYTES, required);
+}
+export async function readRestorationPreparation(root, path, expect) {
+    const file = await readRestorationEvidence(root, path);
+    requireRestoration(file.state === "file", "preparation is missing.");
+    return parseConsumerRestorationPreparation(file.bytes, expect);
+}
+export async function readSelectedRestorationProof(root, options) {
+    const file = await readRestorationEvidence(root, options.proofPath);
+    requireRestoration(file.state === "file", "proof is missing.");
+    const proof = parseConsumerRestorationProof(file.bytes, options.expect);
+    const digest = sha256Bytes(file.bytes);
+    requireRestoration(proof.proofPath === options.proofPath, "final proof destination differs from the explicit retained path.");
+    return { proof, digest };
+}
+export async function assertRestorationBinding(root, proof) {
+    requireRestoration(restorationJson(await restorationConsumer(root, proof.consumer.repository)) === restorationJson(proof.consumer), "proof belongs to another consumer.");
+    requireRestoration(restorationJson(await restorationArtifacts(root)) === restorationJson({ controller: proof.controller, kernel: proof.kernel }), "retain the exact recorded controller and kernel package versions AND builds.");
+    requireRestoration((await inspectKnownFileTransactionBarrier({ consumerRoot: root })).state === "idle", "active transaction requires exact kernel recovery first.");
+    const source = await historicalRestorationProfile(root, proof.sourceRevision);
+    requireRestoration(restorationJson(source.cohort) === restorationJson(proof.sourceCohort) &&
+        restorationJson(source.repository) === restorationJson(proof.consumer.repository) &&
+        (await restorationGit(root, ["rev-parse", "HEAD"])).toString().trim() === proof.sourceRevision &&
+        (await restorationGit(root, ["rev-parse", `${proof.sourceRevision}^{tree}`])).toString().trim() === proof.sourceTree, "historical source binding changed.");
+    await assertRestorationPlanSource(root, proof.sourceRevision, source, proof.plan, proof.targetCohort);
+    return source;
+}
+//# sourceMappingURL=node-consumer-restoration-selection.js.map

package/dist/consumer-integration/adapters/node-consumer-restoration-selection.js.map

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

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

@@ -0,0 +1,12 @@
+import { applyKnownFileTransaction } from "@agent-teams/repository-mutation";
+import type { ConsumerRestorationExecution, ConsumerRestorationOptions, ConsumerRestorationProof } from "../application/model/consumer-restoration.js";
+import type { ConsumerRestorationAuthorityReader, ConsumerRestorationRecorder } from "../application/ports/consumer-restoration.js";
+import type { ConsumerUpgradeSandboxPort } from "../application/ports/consumer-upgrade.js";
+export declare function consumerRestorationRecorder(authority: ConsumerRestorationAuthorityReader): ConsumerRestorationRecorder;
+export declare function assertRestorationAuthority(reader: ConsumerRestorationAuthorityReader, proof: Pick<ConsumerRestorationProof, "sourceCohort" | "targetCohort" | "consumer">): Promise<void>;
+export declare function restoreNodeConsumerIntegration(options: ConsumerRestorationOptions, ports: {
+    readonly authority: ConsumerRestorationAuthorityReader;
+    readonly sandbox: ConsumerUpgradeSandboxPort;
+    readonly apply?: typeof applyKnownFileTransaction;
+}): Promise<ConsumerRestorationExecution>;
+//# sourceMappingURL=node-consumer-restoration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"node-consumer-restoration.d.ts","sourceRoot":"","sources":["../../../src/consumer-integration/adapters/node-consumer-restoration.ts"],"names":[],"mappings":"AACA,OAAO,EACL,yBAAyB,EAC1B,MAAM,kCAAkC,CAAC;AAI1C,OAAO,KAAK,EAAE,4BAA4B,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,8CAA8C,CAAC;AACvJ,OAAO,KAAK,EAAE,kCAAkC,EAAE,2BAA2B,EAAE,MAAM,8CAA8C,CAAC;AACpI,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AAc3F,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,kCAAkC,GAAG,2BAA2B,CA+BtH;AAUD,wBAAsB,0BAA0B,CAAC,MAAM,EAAE,kCAAkC,EACzF,KAAK,EAAE,IAAI,CAAC,wBAAwB,EAAE,cAAc,GAAG,cAAc,GAAG,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAcpG;AAED,wBAAsB,8BAA8B,CAAC,OAAO,EAAE,0BAA0B,EAAE,KAAK,EAAE;IAC/F,QAAQ,CAAC,SAAS,EAAE,kCAAkC,CAAC;IACvD,QAAQ,CAAC,OAAO,EAAE,0BAA0B,CAAC;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,yBAAyB,CAAC;CACnD,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAqCxC"}

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

@@ -0,0 +1,102 @@
+import { lstat } from "node:fs/promises";
+import { applyKnownFileTransaction, inspectKnownFileTransactionBarrier, sha256Bytes } from "@agent-teams/repository-mutation";
+import { acquireMutationLease, claimMutation, observeMutationState, releaseMutationLease } from "@agent-teams/repository-mutation/node";
+import { assertFullyReplacedReceipt, inverseRestorationPlan, parseConsumerRestorationPreparation, requireRestoration, restorationJson } from "../application/policies/consumer-restoration-proof.js";
+import { assertRestorationImages, assertRestorationPlanSource, externalRestorationPath, historicalRestorationProfile, restorationArtifacts, restorationConsumer, restorationGit, restorationInventory, retainRestorationProof } from "./node-consumer-restoration-evidence.js";
+import { nodeConsumerIntegrationInputReader } from "./node-consumer-integration-repository.js";
+import { assertRestorationBinding, readSelectedRestorationProof } from "./node-consumer-restoration-selection.js";
+import { canonicalConsumerRoot } from "./node-consumer-repository-files.js";
+export function consumerRestorationRecorder(authority) {
+    return { prepare: async (options) => {
+            const consumer = await restorationConsumer(options.consumerRoot, options.current.repository);
+            const path = await externalRestorationPath(options.proofPath, consumer.root);
+            const exists = await lstat(path).then(() => true, (error) => {
+                if (error.code === "ENOENT") {
+                    return false;
+                }
+                throw error;
+            });
+            requireRestoration(!exists, "proof destination already exists; preserve it.");
+            requireRestoration((await restorationGit(consumer.root, ["rev-parse", "HEAD"])).toString().trim() === options.sourceRevision &&
+                (await restorationGit(consumer.root, ["diff", "--no-ext-diff", "--no-textconv", options.sourceRevision, "--"])).length === 0, "restorable upgrade requires the exact unchanged source commit.");
+            const current = await historicalRestorationProfile(consumer.root, options.sourceRevision);
+            requireRestoration(restorationJson(current) === restorationJson(options.current), "source profile changed.");
+            inverseRestorationPlan(options.plan);
+            await assertRestorationPlanSource(consumer.root, options.sourceRevision, current, options.plan, options.target);
+            const pending = {
+                schemaVersion: 1, protocol: "agent-teams.managed-v1-restoration-preparation/v1",
+                sourceGeneration: 1, targetGeneration: 2, consumer, initialProofPath: path,
+                sourceRevision: options.sourceRevision,
+                sourceTree: (await restorationGit(consumer.root, ["rev-parse", `${options.sourceRevision}^{tree}`])).toString().trim(),
+                sourceInventoryDigest: await restorationInventory(consumer.root),
+                sourceCohort: current.cohort, targetCohort: options.target,
+                ...await restorationArtifacts(consumer.root), plan: options.plan
+            };
+            await assertRestorationAuthority(authority, pending);
+            await assertRestorationImages(consumer.root, pending, true);
+            const bytes = Buffer.from(`${restorationJson(pending)}\n`);
+            parseConsumerRestorationPreparation(bytes, sha256Bytes(bytes));
+            return retainRestorationProof(await externalRestorationPath(`${path}.prepared`, consumer.root), pending);
+        } };
+}
+function isCentralRestorationAuthority(value) {
+    return value.repository === "agent-teams-ai/.github" && value.path === "governance/docs-qualified-cohorts.json";
+}
+function assertRestoreGenerations(source, target) {
+    requireRestoration(source === 2 && target === 1, "restore requires explicit source generation 2 and target generation 1.");
+}
+export async function assertRestorationAuthority(reader, proof) {
+    const authority = await reader.readRestoration({
+        source: proof.targetCohort, origin: proof.sourceCohort, repository: proof.consumer.repository
+    });
+    requireRestoration(authority.source.revision === authority.target.revision &&
+        isCentralRestorationAuthority(authority.source) && isCentralRestorationAuthority(authority.target) &&
+        /^(?!0{40}$)[0-9a-f]{40}$/u.test(authority.source.revision) &&
+        restorationJson(authority.source.cohort) === restorationJson(proof.targetCohort) &&
+        restorationJson(authority.target.cohort) === restorationJson(proof.sourceCohort) &&
+        proof.targetCohort.rollbackTo.includes(proof.sourceCohort.cohortId) &&
+        proof.targetCohort.upgradeFrom.includes(proof.sourceCohort.cohortId) &&
+        Date.parse(proof.sourceCohort.eligibleAfter) <= Date.now() &&
+        Date.parse(proof.targetCohort.eligibleAfter) <= Date.now(), "fresh protected authority must authorize the exact qualified original rollback edge.");
+}
+export async function restoreNodeConsumerIntegration(options, ports) {
+    assertRestoreGenerations(options.sourceGeneration, options.targetGeneration);
+    const root = await canonicalConsumerRoot(options.consumerRoot);
+    const { proof, digest } = await readSelectedRestorationProof(root, options);
+    requireRestoration(options.from === proof.targetCohort.cohortId && options.to === proof.sourceCohort.cohortId, "command must name the exact recorded source and target Cohorts.");
+    const source = await assertRestorationBinding(root, proof);
+    const inverse = inverseRestorationPlan(proof.plan);
+    let receipt;
+    const lease = await acquireMutationLease(root);
+    try {
+        await assertRestorationImages(root, proof, options.activationOnly === true);
+        const observed = await nodeConsumerIntegrationInputReader.read({ consumerRoot: root });
+        requireRestoration(restorationJson(observed.desired.cohort) ===
+            restorationJson(options.activationOnly === true ? proof.sourceCohort : proof.targetCohort), "current Cohort is stale or mixed.");
+        await assertRestorationAuthority(ports.authority, proof);
+        await assertRestorationImages(root, proof, options.activationOnly === true);
+        if (options.activationOnly !== true) {
+            const claim = await claimMutation(lease, await observeMutationState(lease), {
+                kind: "apply-known-file", planDigest: inverse.planDigest,
+                ownerArtifact: proof.kernel, kernelArtifact: proof.kernel
+            });
+            receipt = await (ports.apply ?? applyKnownFileTransaction)({ consumerRoot: root, plan: inverse, claim });
+            assertFullyReplacedReceipt(inverse, receipt);
+        }
+    }
+    finally {
+        await releaseMutationLease(lease);
+    }
+    // The historical CLI requires an idle kernel barrier. No success is emitted before it passes.
+    await assertRestorationImages(root, proof, true);
+    await ports.sandbox.restoreAndVerifyV1({ consumerRoot: root, current: source });
+    await assertRestorationImages(root, proof, true);
+    requireRestoration((await inspectKnownFileTransactionBarrier({ consumerRoot: root })).state === "idle", "transaction appeared during historical activation.");
+    return {
+        schemaVersion: 1, command: "consumer.restore",
+        outcome: options.activationOnly === true ? "activated-v1" : "restored",
+        issues: [], proofDigest: digest, inversePlanDigest: inverse.planDigest,
+        ...(receipt === undefined ? {} : { receipt })
+    };
+}
+//# sourceMappingURL=node-consumer-restoration.js.map

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

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

package/dist/consumer-integration/adapters/node-consumer-upgrade-sandbox.d.ts

@@ -1,19 +1,47 @@
-import type { ConsumerUpgradeSandboxPort, PreparedConsumerUpgradeV1 } from "../application/ports/consumer-upgrade.js";
-import type { ConsumerIntegrationDesiredStateV1, ConsumerUpgradeAuthorityV1 } from "../domain/model.js";
+import type { ConsumerUpgradeManagedPreimagesV2, ConsumerUpgradeSandboxPort, PreparedConsumerUpgradeV1 } from "../application/ports/consumer-upgrade.js";
+import type { ConsumerIntegrationDesiredStateV1, ConsumerIntegrationDesiredStateV3, ConsumerIntegrationSnapshot, ConsumerUpgradeAuthorityV1, ConsumerUpgradeAuthorityV2 } from "../domain/model.js";
 export declare class NodeConsumerUpgradeSandbox implements ConsumerUpgradeSandboxPort {
-    prepare(options: {
+    private prepareGeneration;
+    prepareV1(options: {
         readonly authority: ConsumerUpgradeAuthorityV1;
         readonly consumerRoot: string;
         readonly current: ConsumerIntegrationDesiredStateV1;
+        readonly expectedSourceRevision: string;
+        readonly expectedSourceSnapshot: ConsumerIntegrationSnapshot;
     }): Promise<PreparedConsumerUpgradeV1>;
-    activateAndVerify(options: {
+    prepareV2(options: {
+        readonly authority: ConsumerUpgradeAuthorityV2;
+        readonly consumerRoot: string;
+        readonly current: ConsumerIntegrationDesiredStateV3;
+        readonly expectedSourceRevision: string;
+        readonly expectedSourceSnapshot: ConsumerIntegrationSnapshot;
+        readonly managedPreimages: ConsumerUpgradeManagedPreimagesV2;
+    }): Promise<PreparedConsumerUpgradeV1>;
+    prepareV1ToV2(options: {
+        readonly authority: ConsumerUpgradeAuthorityV2;
+        readonly consumerRoot: string;
+        readonly current: ConsumerIntegrationDesiredStateV1;
+        readonly expectedSourceRevision: string;
+        readonly expectedSourceSnapshot: ConsumerIntegrationSnapshot;
+    }): Promise<PreparedConsumerUpgradeV1>;
+    private activateAndVerifyGeneration;
+    activateAndVerifyV1(options: {
         readonly authority: ConsumerUpgradeAuthorityV1;
         readonly consumerRoot: string;
     }): Promise<void>;
-    restoreAndVerify(options: {
+    activateAndVerifyV2(options: {
+        readonly authority: ConsumerUpgradeAuthorityV2;
+        readonly consumerRoot: string;
+    }): Promise<void>;
+    private restoreAndVerifyGeneration;
+    restoreAndVerifyV1(options: {
         readonly consumerRoot: string;
         readonly current: ConsumerIntegrationDesiredStateV1;
     }): Promise<void>;
+    restoreAndVerifyV2(options: {
+        readonly consumerRoot: string;
+        readonly current: ConsumerIntegrationDesiredStateV3;
+    }): Promise<void>;
 }
 export declare const nodeConsumerUpgradeSandbox: ConsumerUpgradeSandboxPort;
 //# sourceMappingURL=node-consumer-upgrade-sandbox.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"node-consumer-upgrade-sandbox.d.ts","sourceRoot":"","sources":["../../../src/consumer-integration/adapters/node-consumer-upgrade-sandbox.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACV,0BAA0B,EAC1B,yBAAyB,EAC1B,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EACV,iCAAiC,EACjC,0BAA0B,EAC3B,MAAM,oBAAoB,CAAC;AA6U5B,qBAAa,0BAA2B,YAAW,0BAA0B;IAC9D,OAAO,CAAC,OAAO,EAAE;QAC5B,QAAQ,CAAC,SAAS,EAAE,0BAA0B,CAAC;QAC/C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,OAAO,EAAE,iCAAiC,CAAC;KACrD,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAsFrC;IAEY,iBAAiB,CAAC,OAAO,EAAE;QACtC,QAAQ,CAAC,SAAS,EAAE,0BAA0B,CAAC;QAC/C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;KAC/B,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhB;IAEY,gBAAgB,CAAC,OAAO,EAAE;QACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,OAAO,EAAE,iCAAiC,CAAC;KACrD,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhB;CACF;AAED,eAAO,MAAM,0BAA0B,EAAE,0BACQ,CAAC"}
+{"version":3,"file":"node-consumer-upgrade-sandbox.d.ts","sourceRoot":"","sources":["../../../src/consumer-integration/adapters/node-consumer-upgrade-sandbox.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EACV,iCAAiC,EACjC,0BAA0B,EAC1B,yBAAyB,EAC1B,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EACV,iCAAiC,EACjC,iCAAiC,EACjC,2BAA2B,EAC3B,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,oBAAoB,CAAC;AAoO5B,qBAAa,0BAA2B,YAAW,0BAA0B;YAC7D,iBAAiB;IAiIxB,SAAS,CAAC,OAAO,EAAE;QACxB,QAAQ,CAAC,SAAS,EAAE,0BAA0B,CAAC;QAC/C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,OAAO,EAAE,iCAAiC,CAAC;QACpD,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;QACxC,QAAQ,CAAC,sBAAsB,EAAE,2BAA2B,CAAC;KAC9D,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAErC;IAEM,SAAS,CAAC,OAAO,EAAE;QACxB,QAAQ,CAAC,SAAS,EAAE,0BAA0B,CAAC;QAC/C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,OAAO,EAAE,iCAAiC,CAAC;QACpD,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;QACxC,QAAQ,CAAC,sBAAsB,EAAE,2BAA2B,CAAC;QAC7D,QAAQ,CAAC,gBAAgB,EAAE,iCAAiC,CAAC;KAC9D,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAErC;IAEM,aAAa,CAAC,OAAO,EAAE;QAC5B,QAAQ,CAAC,SAAS,EAAE,0BAA0B,CAAC;QAC/C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,OAAO,EAAE,iCAAiC,CAAC;QACpD,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;QACxC,QAAQ,CAAC,sBAAsB,EAAE,2BAA2B,CAAC;KAC9D,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAErC;YAEa,2BAA2B;IAQlC,mBAAmB,CAAC,OAAO,EAAE;QAClC,QAAQ,CAAC,SAAS,EAAE,0BAA0B,CAAC;QAC/C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;KAC/B,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhB;IAEM,mBAAmB,CAAC,OAAO,EAAE;QAClC,QAAQ,CAAC,SAAS,EAAE,0BAA0B,CAAC;QAC/C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;KAC/B,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhB;YAEa,0BAA0B;IAYjC,kBAAkB,CAAC,OAAO,EAAE;QACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,OAAO,EAAE,iCAAiC,CAAC;KACrD,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhB;IAEY,kBAAkB,CAAC,OAAO,EAAE;QACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,OAAO,EAAE,iCAAiC,CAAC;KACrD,GAAG,OAAO,CAAC,IAAI,CAAC,CAIhB;CACF;AAED,eAAO,MAAM,0BAA0B,EAAE,0BACQ,CAAC"}