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

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

@@ -0,0 +1,223 @@
+import { applyConsumerIntegration, checkConsumerIntegration, planNodeConsumerIntegration, recoverConsumerIntegration } from "./node-consumer-integration.js";
+import { assertConsumerIntegrationExecutionSchema } 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 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 commandId = ["apply", "check", "plan", "recover"].includes(command)
+        ? `consumer.${command}`
+        : "consumer.check";
+    const rawMessage = error instanceof Error ? error.message : "Consumer integration failed.";
+    const safeMessage = [...rawMessage
+            .replace(/(?:[A-Za-z]:\\|\/(?:Users|home|tmp|private|var|Volumes)\/)[^\s'"`]+/gu, "<local-path>")
+    ].map((character) => {
+        const codePoint = character.codePointAt(0) ?? 0;
+        return (codePoint < 32 && ![9, 10, 13].includes(codePoint)) || codePoint === 127
+            ? "?"
+            : character;
+    }).join("")
+        .slice(0, 4096);
+    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.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 consumer plan again and review the new digest."
+            : issue.code.includes("RECOVERY") || issue.code.startsWith("KNOWN_FILE")
+                ? "Next: run consumer 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"].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.");
+    }
+}
+export function consumerIntegrationHelp() {
+    return `Usage: agent-teams-docs consumer <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
+  recover                       Recover the Foundation transaction (profile not read)
+
+Options:
+  --consumer PATH               Git repository root (default: .)
+  --integration-profile PATH    V1 fixed integration profile path
+  --json                        Emit one bounded versioned JSON envelope
+  --help                        Show this help
+`;
+}
+// oxlint-disable-next-line complexity -- the bounded command router keeps all CLI variants in one envelope boundary.
+export async function runConsumerIntegrationCli(argv) {
+    let command = "";
+    let jsonRequested = false;
+    let execution;
+    try {
+        assertBoundedArgv(argv);
+        command = argv[0] ?? "";
+        jsonRequested = argv.includes("--json");
+        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(consumerIntegrationHelp());
+            return 0;
+        }
+        const args = new Arguments(argv.slice(1));
+        args.flag("--json");
+        const consumerRoot = args.one("--consumer") ?? ".";
+        const integrationProfilePath = args.one("--integration-profile");
+        if (command === "check") {
+            args.assertConsumed();
+            execution = await checkConsumerIntegration({
+                consumerRoot,
+                ...(integrationProfilePath === undefined ? {} : { integrationProfilePath })
+            });
+        }
+        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,
+                ...(integrationProfilePath === undefined ? {} : { integrationProfilePath })
+            });
+        }
+        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,
+                ...(integrationProfilePath === undefined ? {} : { integrationProfilePath })
+            });
+        }
+        else if (command === "recover") {
+            if (integrationProfilePath !== undefined) {
+                throw new ConsumerCliInputError("consumer recover does not read an integration profile.");
+            }
+            args.assertConsumed();
+            execution = await recoverConsumerIntegration({ consumerRoot });
+        }
+        else {
+            throw new ConsumerCliInputError("Expected consumer command: check, plan, apply, or recover.");
+        }
+    }
+    catch (error) {
+        execution = failure(command || "check", error);
+    }
+    try {
+        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/node-consumer-integration.d.ts

@@ -0,0 +1,28 @@
+import { type KnownFileTransactionReceiptV1 } from "@agent-teams/engineering-foundation/mutation";
+import type { ConsumerIntegrationIssue, ConsumerIntegrationPlanV1 } from "../domain/model.js";
+export interface ConsumerIntegrationExecutionV1 {
+    readonly schemaVersion: 1;
+    readonly command: "consumer.apply" | "consumer.check" | "consumer.plan" | "consumer.recover";
+    readonly outcome: "applied" | "blocked" | "change-required" | "current" | "recovered";
+    readonly issues: readonly ConsumerIntegrationIssue[];
+    readonly plan?: ConsumerIntegrationPlanV1;
+    readonly receipt?: KnownFileTransactionReceiptV1;
+}
+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>;
+//# 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":"AAAA,OAAO,EAIL,KAAK,6BAA6B,EACnC,MAAM,8CAA8C,CAAC;AAKtD,OAAO,KAAK,EACV,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,GAAG,eAAe,GAAG,kBAAkB,CAAC;IAC7F,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,iBAAiB,GAAG,SAAS,GAAG,WAAW,CAAC;IACtF,QAAQ,CAAC,MAAM,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACrD,QAAQ,CAAC,IAAI,CAAC,EAAE,yBAAyB,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,6BAA6B,CAAC;CAClD;AA8CD,wBAAsB,wBAAwB,CAAC,OAAO,EAAE;IACtD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;CAC1C,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAW1C;AAED,wBAAsB,2BAA2B,CAAC,OAAO,EAAE;IACzD,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,CAyB1C;AAED,wBAAsB,wBAAwB,CAAC,OAAO,EAAE;IACtD,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,CA2C1C;AAED,wBAAsB,0BAA0B,CAAC,OAAO,EAAE;IACxD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAW1C"}

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

@@ -0,0 +1,138 @@
+import { applyKnownFileTransaction, inspectKnownFileTransactionBarrier, recoverKnownFileTransaction } from "@agent-teams/engineering-foundation/mutation";
+import { readConsumerIntegrationInput } from "../adapters/node-consumer-integration-repository.js";
+import { loadPackageConsumerAssetCatalog } from "../adapters/package-consumer-asset-catalog.js";
+import { compileConsumerIntegration } from "../application/use-cases/plan-consumer-integration.js";
+async function compile(options) {
+    const input = await readConsumerIntegrationInput(options);
+    const assetCatalog = await loadPackageConsumerAssetCatalog();
+    const compiled = compileConsumerIntegration({
+        desired: input.desired,
+        snapshot: input.snapshot,
+        assetCatalog
+    });
+    return {
+        root: input.root,
+        ...compiled
+    };
+}
+async function recoveryIssue(consumerRoot) {
+    const inspection = await inspectKnownFileTransactionBarrier({ consumerRoot });
+    if (inspection.state === "idle") {
+        return undefined;
+    }
+    return Object.freeze({
+        code: inspection.code,
+        severity: "error",
+        subject: "foundation-transaction",
+        message: inspection.message
+    });
+}
+function blockedExecution(command, issue) {
+    return Object.freeze({
+        schemaVersion: 1,
+        command,
+        outcome: "blocked",
+        issues: Object.freeze([issue])
+    });
+}
+export async function checkConsumerIntegration(options) {
+    const issue = await recoveryIssue(options.consumerRoot);
+    if (issue !== undefined) {
+        return blockedExecution("consumer.check", issue);
+    }
+    const { plan } = await compile(options);
+    return Object.freeze({
+        schemaVersion: 1,
+        command: "consumer.check",
+        outcome: plan.outcome,
+        issues: plan.issues,
+        plan
+    });
+}
+export async function planNodeConsumerIntegration(options) {
+    const issue = await recoveryIssue(options.consumerRoot);
+    if (issue !== undefined) {
+        return blockedExecution("consumer.plan", issue);
+    }
+    const { plan } = await compile(options);
+    if (plan.cohortId !== options.to) {
+        return Object.freeze({
+            schemaVersion: 1,
+            command: "consumer.plan",
+            outcome: "blocked",
+            issues: Object.freeze([{
+                    code: "DOCS_CONSUMER_TARGET_COHORT_MISMATCH",
+                    severity: "error",
+                    subject: options.to,
+                    message: `Integration profile selects ${plan.cohortId}, not requested cohort ${options.to}.`
+                }]),
+            plan
+        });
+    }
+    return Object.freeze({
+        schemaVersion: 1,
+        command: "consumer.plan",
+        outcome: plan.outcome,
+        issues: plan.issues,
+        plan
+    });
+}
+export async function applyConsumerIntegration(options) {
+    const issue = await recoveryIssue(options.consumerRoot);
+    if (issue !== undefined) {
+        return blockedExecution("consumer.apply", issue);
+    }
+    const { root, plan, mutationPlan } = await compile(options);
+    if (plan.planDigest !== options.expect) {
+        return Object.freeze({
+            schemaVersion: 1,
+            command: "consumer.apply",
+            outcome: "blocked",
+            issues: Object.freeze([{
+                    code: "DOCS_CONSUMER_STALE_PLAN",
+                    severity: "error",
+                    subject: "--expect",
+                    message: `Expected ${options.expect}, but fresh Plan digest is ${plan.planDigest}.`
+                }]),
+            plan
+        });
+    }
+    if (plan.outcome === "blocked" || mutationPlan === undefined) {
+        return Object.freeze({
+            schemaVersion: 1,
+            command: "consumer.apply",
+            outcome: "blocked",
+            issues: plan.issues,
+            plan
+        });
+    }
+    const receipt = await applyKnownFileTransaction({
+        consumerRoot: root,
+        plan: mutationPlan
+    });
+    const after = await compile(options);
+    if (after.plan.outcome !== "current") {
+        throw new Error("Consumer integration postimage verification did not converge to current.");
+    }
+    return Object.freeze({
+        schemaVersion: 1,
+        command: "consumer.apply",
+        outcome: receipt.outcome === "applied" ? "applied" : "current",
+        issues: Object.freeze([]),
+        plan: after.plan,
+        receipt
+    });
+}
+export async function recoverConsumerIntegration(options) {
+    const receipt = await recoverKnownFileTransaction({
+        consumerRoot: options.consumerRoot
+    });
+    return Object.freeze({
+        schemaVersion: 1,
+        command: "consumer.recover",
+        outcome: "recovered",
+        issues: Object.freeze([]),
+        receipt
+    });
+}
+//# 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,EACL,yBAAyB,EACzB,kCAAkC,EAClC,2BAA2B,EAE5B,MAAM,8CAA8C,CAAC;AAEtD,OAAO,EAAE,4BAA4B,EAAE,MAAM,qDAAqD,CAAC;AACnG,OAAO,EAAE,+BAA+B,EAAE,MAAM,+CAA+C,CAAC;AAChG,OAAO,EAAE,0BAA0B,EAAE,MAAM,uDAAuD,CAAC;AAenG,KAAK,UAAU,OAAO,CAAC,OAGtB;IAKC,MAAM,KAAK,GAAG,MAAM,4BAA4B,CAAC,OAAO,CAAC,CAAC;IAC1D,MAAM,YAAY,GAAG,MAAM,+BAA+B,EAAE,CAAC;IAC7D,MAAM,QAAQ,GAAG,0BAA0B,CAAC;QAC1C,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,YAAY;KACb,CAAC,CAAC;IACH,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,GAAG,QAAQ;KACZ,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,YAAoB;IAC/C,MAAM,UAAU,GAAG,MAAM,kCAAkC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;IAC9E,IAAI,UAAU,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;QAAA,OAAO,SAAS,CAAC;IAAA,CAAC;IACpD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,QAAQ,EAAE,OAAO;QACjB,OAAO,EAAE,wBAAwB;QACjC,OAAO,EAAE,UAAU,CAAC,OAAO;KAC5B,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CACvB,OAAkD,EAClD,KAA+B;IAE/B,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,aAAa,EAAE,CAAC;QAChB,OAAO;QACP,OAAO,EAAE,SAAS;QAClB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;KAC/B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,OAG9C;IACC,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACxD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAAA,OAAO,gBAAgB,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;IAAA,CAAC;IAC5E,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,aAAa,EAAE,CAAC;QAChB,OAAO,EAAE,gBAAgB;QACzB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI;KACL,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,OAIjD;IACC,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACxD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAAA,OAAO,gBAAgB,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IAAA,CAAC;IAC3E,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAC,EAAE,EAAE,CAAC;QACjC,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,aAAa,EAAE,CAAC;YAChB,OAAO,EAAE,eAAe;YACxB,OAAO,EAAE,SAAS;YAClB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;oBACrB,IAAI,EAAE,sCAAsC;oBAC5C,QAAQ,EAAE,OAAgB;oBAC1B,OAAO,EAAE,OAAO,CAAC,EAAE;oBACnB,OAAO,EAAE,+BAA+B,IAAI,CAAC,QAAQ,0BAA0B,OAAO,CAAC,EAAE,GAAG;iBAC7F,CAAC,CAAC;YACH,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,aAAa,EAAE,CAAC;QAChB,OAAO,EAAE,eAAe;QACxB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI;KACL,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,OAI9C;IACC,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACxD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAAA,OAAO,gBAAgB,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;IAAA,CAAC;IAC5E,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,IAAI,IAAI,CAAC,UAAU,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;QACvC,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,aAAa,EAAE,CAAC;YAChB,OAAO,EAAE,gBAAgB;YACzB,OAAO,EAAE,SAAS;YAClB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;oBACrB,IAAI,EAAE,0BAA0B;oBAChC,QAAQ,EAAE,OAAgB;oBAC1B,OAAO,EAAE,UAAU;oBACnB,OAAO,EAAE,YAAY,OAAO,CAAC,MAAM,8BAA8B,IAAI,CAAC,UAAU,GAAG;iBACpF,CAAC,CAAC;YACH,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC7D,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,aAAa,EAAE,CAAC;YAChB,OAAO,EAAE,gBAAgB;YACzB,OAAO,EAAE,SAAS;YAClB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,yBAAyB,CAAC;QAC9C,YAAY,EAAE,IAAI;QAClB,IAAI,EAAE,YAAY;KACnB,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,aAAa,EAAE,CAAC;QAChB,OAAO,EAAE,gBAAgB;QACzB,OAAO,EAAE,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;QAC9D,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO;KACR,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,OAEhD;IACC,MAAM,OAAO,GAAG,MAAM,2BAA2B,CAAC;QAChD,YAAY,EAAE,OAAO,CAAC,YAAY;KACnC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,aAAa,EAAE,CAAC;QAChB,OAAO,EAAE,kBAAkB;QAC3B,OAAO,EAAE,WAAW;QACpB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,OAAO;KACR,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,105 @@
+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[];
+}
+//# sourceMappingURL=model.d.ts.map

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

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

package/dist/consumer-integration/domain/model.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=model.js.map

package/dist/consumer-integration/domain/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../src/consumer-integration/domain/model.ts"],"names":[],"mappings":""}

package/dist/consumer-integration/generated/canonical-assets.d.ts

@@ -0,0 +1,3 @@
+export declare const GENERATED_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 GENERATED_CALLER_WORKFLOW_TEMPLATE = "name: Documentation Protocol\n\non:\n  pull_request:\n  merge_group:\n  push:\n\npermissions:\n  contents: read\n  id-token: write\n\njobs:\n  docs-protocol:\n    uses: {{REUSABLE_WORKFLOW_REPOSITORY}}/{{REUSABLE_WORKFLOW_PATH}}@{{REUSABLE_WORKFLOW_REVISION}}\n";
+//# sourceMappingURL=canonical-assets.d.ts.map

package/dist/consumer-integration/generated/canonical-assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-assets.d.ts","sourceRoot":"","sources":["../../../src/consumer-integration/generated/canonical-assets.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,oBAAoB,o3CAAo3C,CAAC;AACt5C,eAAO,MAAM,kCAAkC,0QAA0Q,CAAC"}

package/dist/consumer-integration/generated/canonical-assets.js

@@ -0,0 +1,4 @@
+// Generated by scripts/generate-consumer-assets.mjs. Do not edit by hand.
+export const GENERATED_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 const GENERATED_CALLER_WORKFLOW_TEMPLATE = "name: Documentation Protocol\n\non:\n  pull_request:\n  merge_group:\n  push:\n\npermissions:\n  contents: read\n  id-token: write\n\njobs:\n  docs-protocol:\n    uses: {{REUSABLE_WORKFLOW_REPOSITORY}}/{{REUSABLE_WORKFLOW_PATH}}@{{REUSABLE_WORKFLOW_REVISION}}\n";
+//# sourceMappingURL=canonical-assets.js.map

package/dist/consumer-integration/generated/canonical-assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-assets.js","sourceRoot":"","sources":["../../../src/consumer-integration/generated/canonical-assets.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,MAAM,CAAC,MAAM,oBAAoB,GAAG,i3CAAi3C,CAAC;AACt5C,MAAM,CAAC,MAAM,kCAAkC,GAAG,uQAAuQ,CAAC"}

package/dist/consumer-integration/index.d.ts

@@ -0,0 +1,11 @@
+export { CANONICAL_DOCS_SKILL, BOOTSTRAP_KNOWN_PRIOR_CALLER_WORKFLOWS, canonicalCallerWorkflow, canonicalDocsScriptsDigest, canonicalDocsScripts, canonicalManagedRoute, canonicalManagedState, describeCanonicalConsumerAssets } from "./application/policies/consumer-integration-assets.js";
+export { planConsumerIntegration } from "./application/use-cases/plan-consumer-integration.js";
+export { planAgentsRouteV1 } from "./adapters/agents-route-adapter-v1.js";
+export type { AgentsRoutePlanV1 } from "./adapters/agents-route-adapter-v1.js";
+export { planPnpmManifestV1 } from "./adapters/pnpm-manifest-adapter-v1.js";
+export type { PnpmManifestPlanV1 } from "./adapters/pnpm-manifest-adapter-v1.js";
+export { applyConsumerIntegration, checkConsumerIntegration, planNodeConsumerIntegration, recoverConsumerIntegration } from "./composition/node-consumer-integration.js";
+export type { ConsumerIntegrationExecutionV1 } from "./composition/node-consumer-integration.js";
+export { ConsumerIntegrationNodeError, readConsumerIntegrationInput } from "./adapters/node-consumer-integration-repository.js";
+export type { ConsumerIntegrationAssetPlan, ConsumerIntegrationAssetState, ConsumerIntegrationDesiredStateV1, ConsumerIntegrationDigest, ConsumerIntegrationFileObservation, ConsumerIntegrationIssue, ConsumerIntegrationPlanV1, ConsumerIntegrationSnapshot, QualifiedDocsCohortBindingV1, QualifiedDocsCohortV1 } from "./domain/model.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/consumer-integration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/consumer-integration/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,sCAAsC,EACtC,uBAAuB,EACvB,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,+BAA+B,EAChC,MAAM,uDAAuD,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sDAAsD,CAAC;AAC/F,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,YAAY,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,YAAY,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,EAC3B,MAAM,4CAA4C,CAAC;AACpD,YAAY,EAAE,8BAA8B,EAAE,MAAM,4CAA4C,CAAC;AACjG,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,EAC7B,MAAM,oDAAoD,CAAC;AAC5D,YAAY,EACV,4BAA4B,EAC5B,6BAA6B,EAC7B,iCAAiC,EACjC,yBAAyB,EACzB,kCAAkC,EAClC,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,4BAA4B,EAC5B,qBAAqB,EACtB,MAAM,mBAAmB,CAAC"}

package/dist/consumer-integration/index.js

@@ -0,0 +1,7 @@
+export { CANONICAL_DOCS_SKILL, BOOTSTRAP_KNOWN_PRIOR_CALLER_WORKFLOWS, canonicalCallerWorkflow, canonicalDocsScriptsDigest, canonicalDocsScripts, canonicalManagedRoute, canonicalManagedState, describeCanonicalConsumerAssets } from "./application/policies/consumer-integration-assets.js";
+export { planConsumerIntegration } from "./application/use-cases/plan-consumer-integration.js";
+export { planAgentsRouteV1 } from "./adapters/agents-route-adapter-v1.js";
+export { planPnpmManifestV1 } from "./adapters/pnpm-manifest-adapter-v1.js";
+export { applyConsumerIntegration, checkConsumerIntegration, planNodeConsumerIntegration, recoverConsumerIntegration } from "./composition/node-consumer-integration.js";
+export { ConsumerIntegrationNodeError, readConsumerIntegrationInput } from "./adapters/node-consumer-integration-repository.js";
+//# sourceMappingURL=index.js.map

package/dist/consumer-integration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/consumer-integration/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,sCAAsC,EACtC,uBAAuB,EACvB,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,+BAA+B,EAChC,MAAM,uDAAuD,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sDAAsD,CAAC;AAC/F,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAE5E,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,EAC3B,MAAM,4CAA4C,CAAC;AAEpD,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,EAC7B,MAAM,oDAAoD,CAAC"}

package/dist/index.d.ts

@@ -2,5 +2,6 @@ export { renderDocsHuman, runDocsCli } from "./composition/cli.js";
 export { docsCheck, docsDoctor, docsFind, docsInfo, docsNew, docsRecover } from "./composition/node-docs-api.js";
 export type { DocsConsumerRequest } from "./composition/node-docs-api.js";
 export { DOCS_PROTOCOL_ID, DOCS_PROTOCOL_VERSION } from "./domain/model.js";
+export * as consumerIntegration from "./consumer-integration/index.js";
 export type { DocsCommand, DocsCommandEnvelope, DocsCommandOutcome, DocsCodeAnchor, DocsDiagnostic, DocsExecution, DocsFindDocument, DocsFindQuery, DocsNewResult, DocsNewRequest, DocsProtocolProfile, DocsTypeProfile, ReachabilityAction } from "./domain/model.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EACL,SAAS,EACT,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,WAAW,EACZ,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EACnB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EACL,SAAS,EACT,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,WAAW,EACZ,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,mBAAmB,MAAM,iCAAiC,CAAC;AACvE,YAAY,EACV,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EACnB,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export { renderDocsHuman, runDocsCli } from "./composition/cli.js";
 export { docsCheck, docsDoctor, docsFind, docsInfo, docsNew, docsRecover } from "./composition/node-docs-api.js";
 export { DOCS_PROTOCOL_ID, DOCS_PROTOCOL_VERSION } from "./domain/model.js";
+export * as consumerIntegration from "./consumer-integration/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EACL,SAAS,EACT,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,WAAW,EACZ,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EACL,SAAS,EACT,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,WAAW,EACZ,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,mBAAmB,MAAM,iCAAiC,CAAC"}