@archdoc/cli 0.0.0-stage → 0.1.0

package/dist/commands/federation.d.ts

@@ -0,0 +1,20 @@
+import type { Io } from "../io.js";
+export interface SyncCommandOptions {
+    model?: string;
+    /** true for every import, or a list of namespaces. */
+    update?: boolean | string[];
+    frozen?: boolean;
+}
+/**
+ * `archdoc sync`: pin the model's imports in archdoc.lock and vendor their
+ * models, then report references into them that don't resolve.
+ */
+export declare function sync(options: SyncCommandOptions, io: Io): Promise<number>;
+export interface PublishCommandOptions {
+    model?: string;
+    version?: string;
+    out?: string;
+}
+/** `archdoc publish`: write a versioned, validated bundle of the model for other repos. */
+export declare function publish(options: PublishCommandOptions, io: Io): Promise<number>;
+//# sourceMappingURL=federation.d.ts.map

package/dist/commands/federation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"federation.d.ts","sourceRoot":"","sources":["../../src/commands/federation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAEnC,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,IAAI,CAAC,OAAO,EAAE,kBAAkB,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA0D/E;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,2FAA2F;AAC3F,wBAAsB,OAAO,CAAC,OAAO,EAAE,qBAAqB,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAsCrF"}

package/dist/commands/federation.js

@@ -0,0 +1,96 @@
+import { formatDiagnostic, loadModel } from "@archdoc/core";
+import { publish as publishModel, sync as syncModel } from "@archdoc/federation";
+/**
+ * `archdoc sync`: pin the model's imports in archdoc.lock and vendor their
+ * models, then report references into them that don't resolve.
+ */
+export async function sync(options, io) {
+    try {
+        const result = await syncModel({
+            model: options.model,
+            cwd: io.cwd,
+            update: options.update,
+            frozen: options.frozen,
+        });
+        if (options.frozen) {
+            if (result.problems.length) {
+                for (const p of result.problems)
+                    io.err(`✗ ${p}`);
+                io.err("\nRun archdoc sync and commit archdoc.lock and .archdoc/vendor/.");
+                return 1;
+            }
+            io.out(`✓ ${result.lockPath} matches imports.`);
+            return 0;
+        }
+        if (result.changes.length === 0) {
+            io.out("Nothing to sync: the model has no imports.");
+            return 0;
+        }
+        for (const c of result.changes) {
+            const at = c.version ? `@${c.version}` : c.ref ? ` at ${c.ref}` : "";
+            const what = c.landscape ? "landscape " : "";
+            const line = {
+                kept: `  ${what}${c.namespace}${at}`,
+                added: `+ ${what}${c.namespace}${at} (${c.source})`,
+                updated: `↑ ${what}${c.namespace}${c.previous && c.version ? ` ${c.previous} → ${c.version}` : at}`,
+                removed: `- ${what}${c.namespace}${at}`,
+            }[c.action];
+            io.out(line);
+        }
+        const changed = result.changes.filter((c) => c.action !== "kept").length;
+        io.out(changed
+            ? `\nWrote ${result.lockPath}. Commit it with .archdoc/vendor/.`
+            : `\n${result.lockPath} is up to date.`);
+        // What the pinned versions mean for this model.
+        const model = await loadModel(options.model ?? ".", { cwd: io.cwd });
+        const crossRepo = model.diagnostics.filter((d) => d.severity !== "info" &&
+            /^(import|ref\/unknown-in-import|ref\/deprecated|ref\/unknown-contract|journey\/broken-step)/.test(d.code));
+        if (crossRepo.length) {
+            io.err("");
+            for (const d of crossRepo)
+                io.err(formatDiagnostic(d));
+            return crossRepo.some((d) => d.severity === "error") ? 1 : 0;
+        }
+        return 0;
+    }
+    catch (err) {
+        io.err(err instanceof Error ? err.message : String(err));
+        return 2;
+    }
+}
+/** `archdoc publish`: write a versioned, validated bundle of the model for other repos. */
+export async function publish(options, io) {
+    try {
+        const result = await publishModel({
+            model: options.model,
+            cwd: io.cwd,
+            version: options.version,
+            out: options.out === "-" ? undefined : options.out,
+            dryRun: options.out === "-",
+        });
+        if (result.errors.length) {
+            for (const d of result.errors)
+                io.err(formatDiagnostic(d));
+            io.err(`\n✗ Not published: the model has ${result.errors.length} error${result.errors.length === 1 ? "" : "s"}.`);
+            return 1;
+        }
+        if (options.out === "-") {
+            io.out(result.text?.trimEnd() ?? "");
+            return 0;
+        }
+        const b = result.bundle;
+        io.out(`✓ Wrote ${result.path} (${b?.namespace}${b?.version ? `@${b.version}` : ""}, ${b?.sources.length} file${b?.sources.length === 1 ? "" : "s"}).`);
+        if (!b?.version) {
+            io.err("  It has no version. Tag the commit (such as v1.0.0) or pass one (archdoc publish 1.0.0), so other repos can pin it.");
+        }
+        else {
+            io.out(`  Other repos import it with git: (the tag is enough) or url: (attach ${result.path} to the release).`);
+        }
+        return 0;
+    }
+    catch (err) {
+        io.err(err instanceof Error ? err.message : String(err));
+        return 2;
+    }
+}
+//# sourceMappingURL=federation.js.map

package/dist/commands/federation.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,13 @@
+import type { Io } from "../io.js";
+export interface InitOptions {
+    name?: string;
+    dryRun?: boolean;
+    json?: boolean;
+}
+/**
+ * `archdoc init [path]`: a starting model for a repository without one, from
+ * its manifests, compose files, imports, and schema files, every fact marked
+ * inferred. Never writes over a model.
+ */
+export declare function init(path: string, options: InitOptions, io: Io): Promise<number>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAEnC,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAatF"}

package/dist/commands/init.js

@@ -0,0 +1,24 @@
+import { resolve } from "node:path";
+import { formatInit, initModel } from "@archdoc/analyzers";
+/**
+ * `archdoc init [path]`: a starting model for a repository without one, from
+ * its manifests, compose files, imports, and schema files, every fact marked
+ * inferred. Never writes over a model.
+ */
+export async function init(path, options, io) {
+    try {
+        const r = await initModel(resolve(io.cwd, path), options);
+        if (options.json) {
+            io.out(JSON.stringify(r, null, 2));
+        }
+        else {
+            (r.refused ? io.err : io.out)(formatInit(r));
+        }
+        return r.refused || r.problems.length ? 1 : 0;
+    }
+    catch (err) {
+        io.err(err instanceof Error ? err.message : String(err));
+        return 2;
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAS3D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAY,EAAE,OAAoB,EAAE,EAAM;IACnE,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QAC1D,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,EAAE,CAAC,GAAG,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACzD,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/commands/landscape.d.ts

@@ -0,0 +1,14 @@
+import type { Io } from "../io.js";
+export interface LandscapeBuildOptions {
+    out?: string;
+    /** Write the site even when the composed model has errors. */
+    force?: boolean;
+}
+/**
+ * `archdoc landscape build`: composes the landscape repo's model with every
+ * model it imports, checks the whole (journeys across repos, owners, org
+ * rules on declared relationships), and writes a static explorer site for
+ * GitHub Pages or any static host.
+ */
+export declare function landscapeBuild(target: string, options: LandscapeBuildOptions, io: Io): Promise<number>;
+//# sourceMappingURL=landscape.d.ts.map

package/dist/commands/landscape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"landscape.d.ts","sourceRoot":"","sources":["../../src/commands/landscape.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAInC,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,qBAAqB,EAC9B,EAAE,EAAE,EAAE,GACL,OAAO,CAAC,MAAM,CAAC,CAkDjB"}

package/dist/commands/landscape.js

@@ -0,0 +1,52 @@
+import { cp, mkdir, rm, writeFile } from "node:fs/promises";
+import { join, relative, resolve } from "node:path";
+import { check, formatDiagnostic } from "@archdoc/core";
+import { landscapePayload, loadLandscape } from "../landscape.js";
+import { findWebDir } from "../server.js";
+/**
+ * `archdoc landscape build`: composes the landscape repo's model with every
+ * model it imports, checks the whole (journeys across repos, owners, org
+ * rules on declared relationships), and writes a static explorer site for
+ * GitHub Pages or any static host.
+ */
+export async function landscapeBuild(target, options, io) {
+    try {
+        const { model, composed } = await loadLandscape(target, io.cwd);
+        const findings = check(composed.model).findings.filter((f) => f.code !== "model/orphan-element");
+        for (const f of findings) {
+            io.err(formatDiagnostic({
+                severity: f.severity,
+                code: f.code,
+                message: f.message,
+                location: f.location,
+            }));
+        }
+        const errors = findings.filter((f) => f.severity === "error").length;
+        if (errors && !options.force) {
+            io.err(`\n✗ Not built: the landscape has ${errors} error${errors === 1 ? "" : "s"}. Fix them, or pass --force.`);
+            return 1;
+        }
+        const webDir = findWebDir();
+        if (!webDir) {
+            io.err("The explorer isn't built. In the ArchDoc repo, run `pnpm build`, or set ARCHDOC_WEB_DIR.");
+            return 2;
+        }
+        const out = resolve(io.cwd, options.out ?? "site");
+        await rm(out, { recursive: true, force: true });
+        await mkdir(join(out, "api"), { recursive: true });
+        await cp(webDir, out, { recursive: true });
+        const payload = await landscapePayload(model, composed, false);
+        await writeFile(join(out, "api", "model"), JSON.stringify(payload));
+        // GitHub Pages serves files and folders as they are.
+        await writeFile(join(out, ".nojekyll"), "");
+        const m = composed.model;
+        io.out(`✓ Wrote ${relative(io.cwd, out) || "."}/: ${model.name ?? model.namespace}, ${composed.repos.length} repos (${composed.repos.map((r) => `${r.namespace}@${r.version ?? "?"}`).join(", ")}), ${m.elements.size} elements, ${m.actors.size} actors, ${m.journeys.size} journeys${composed.domains.length ? `, ${composed.domains.length} domains` : ""}.`);
+        io.out("  Publish the folder with GitHub Pages or any static host.");
+        return 0;
+    }
+    catch (err) {
+        io.err(err instanceof Error ? err.message : String(err));
+        return 2;
+    }
+}
+//# sourceMappingURL=landscape.js.map

package/dist/commands/landscape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"landscape.js","sourceRoot":"","sources":["../../src/commands/landscape.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAExD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAQ1C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAc,EACd,OAA8B,EAC9B,EAAM;IAEN,IAAI,CAAC;QACH,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;QAChE,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,MAAM,CACpD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,sBAAsB,CACzC,CAAC;QACF,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,EAAE,CAAC,GAAG,CACJ,gBAAgB,CAAC;gBACf,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ;aACrB,CAAC,CACH,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;QACrE,IAAI,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC7B,EAAE,CAAC,GAAG,CACJ,oCAAoC,MAAM,SAAS,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,8BAA8B,CACzG,CAAC;YACF,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,EAAE,CAAC,GAAG,CACJ,0FAA0F,CAC3F,CAAC;YACF,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,GAAG,GAAG,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC;QACnD,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,MAAM,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC/D,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QACpE,qDAAqD;QACrD,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC;QAE5C,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC;QACzB,EAAE,CAAC,GAAG,CACJ,WAAW,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,SAAS,KAAK,QAAQ,CAAC,KAAK,CAAC,MAAM,WAAW,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,OAAO,IAAI,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,IAAI,cAAc,CAAC,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,CAAC,QAAQ,CAAC,IAAI,YAAY,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,OAAO,CAAC,MAAM,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,CACzV,CAAC;QACF,EAAE,CAAC,GAAG,CAAC,4DAA4D,CAAC,CAAC;QACrE,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,EAAE,CAAC,GAAG,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACzD,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/commands/migrate.d.ts

@@ -0,0 +1,8 @@
+import type { Io } from "../io.js";
+export interface MigrateOptions {
+    namespace?: string;
+    name?: string;
+    out?: string;
+}
+export declare function migrate(file: string, options: MigrateOptions, io: Io): Promise<number>;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/commands/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/commands/migrate.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAEnC,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAyB5F"}

package/dist/commands/migrate.js

@@ -0,0 +1,38 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { basename, extname, resolve } from "node:path";
+import { isV1Model, migrateV1 } from "@archdoc/spec";
+import { parse, stringify } from "yaml";
+export async function migrate(file, options, io) {
+    const path = resolve(io.cwd, file);
+    const text = await readFile(path, "utf8").catch(() => undefined);
+    if (text === undefined) {
+        io.err(`Can't read ${file}.`);
+        return 1;
+    }
+    const doc = parse(text);
+    if (!isV1Model(doc)) {
+        io.err(`${file} is not a v1 model (no users or components). Nothing to migrate.`);
+        return 1;
+    }
+    const namespace = options.namespace ?? slug(basename(file, extname(file)));
+    const { model, notes } = migrateV1(doc, { namespace, name: options.name });
+    const yaml = `# Migrated from v1 by "archdoc migrate".\n${stringify(model, { lineWidth: 100 })}`;
+    if (options.out) {
+        await writeFile(resolve(io.cwd, options.out), yaml);
+        io.err(`Wrote ${options.out}.`);
+    }
+    else {
+        io.out(yaml.trimEnd());
+    }
+    for (const note of notes)
+        io.err(`note: ${note}`);
+    return 0;
+}
+function slug(s) {
+    const out = s
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^[^a-z]+|-+$/g, "");
+    return out || "model";
+}
+//# sourceMappingURL=migrate.js.map

package/dist/commands/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../src/commands/migrate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AASxC,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAY,EAAE,OAAuB,EAAE,EAAM;IACzE,MAAM,IAAI,GAAG,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACjE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,EAAE,CAAC,GAAG,CAAC,cAAc,IAAI,GAAG,CAAC,CAAC;QAC9B,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IACxB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;QACpB,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,kEAAkE,CAAC,CAAC;QAClF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3E,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3E,MAAM,IAAI,GAAG,6CAA6C,SAAS,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;IAEjG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,MAAM,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;QACpD,EAAE,CAAC,GAAG,CAAC,SAAS,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;IAClC,CAAC;SAAM,CAAC;QACN,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IACzB,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,EAAE,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IAClD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,IAAI,CAAC,CAAS;IACrB,MAAM,GAAG,GAAG,CAAC;SACV,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAChC,OAAO,GAAG,IAAI,OAAO,CAAC;AACxB,CAAC"}

package/dist/commands/report.d.ts

@@ -0,0 +1,16 @@
+import type { Io } from "../io.js";
+export interface ReportOptions {
+    model?: string;
+    base?: string;
+    format?: string;
+    /** False leaves out the Mermaid diagrams. */
+    diagrams?: boolean;
+    /** A page that shows the change in the explorer, linked from the comment. */
+    explorerUrl?: string;
+}
+/**
+ * `archdoc report --base <ref>`: the architectural impact of the change since
+ * the merge base with <ref>, as markdown for a pull request comment.
+ */
+export declare function report(options: ReportOptions, io: Io): Promise<number>;
+//# sourceMappingURL=report.d.ts.map

package/dist/commands/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/commands/report.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAInC,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAoC5E"}

package/dist/commands/report.js

@@ -0,0 +1,77 @@
+import { resealedSince } from "@archdoc/analyzers";
+import { check, diffModels, loadModel, loadTraces, prReport, readTraceSources, tracesInChange, } from "@archdoc/core";
+import { isModelPath } from "../model-path.js";
+import { runCheck } from "./check.js";
+/**
+ * `archdoc report --base <ref>`: the architectural impact of the change since
+ * the merge base with <ref>, as markdown for a pull request comment.
+ */
+export async function report(options, io) {
+    if (!options.base) {
+        io.err("--base is required, such as --base main or --base origin/main.");
+        return 2;
+    }
+    const format = options.format ?? "markdown";
+    try {
+        if (isModelPath(io.cwd, options.base))
+            return await reportFiles(options.base, options, io);
+        const { model, findings, base } = await runCheck({ model: options.model, base: options.base }, io.cwd);
+        if (!base)
+            throw new Error(`Couldn't read the model at ${options.base}.`);
+        const baseModel = base.model;
+        const changed = base.changedFiles;
+        // Bug traces the change adds or edits: the comment says which bug it fixes.
+        const { traces } = loadTraces(await readTraceSources(options.model ?? ".", { cwd: io.cwd }));
+        const r = prReport({
+            model,
+            base: baseModel,
+            changedFiles: changed,
+            diff: diffModels(baseModel, model),
+            findings,
+            diagrams: options.diagrams !== false,
+            explorerUrl: options.explorerUrl,
+            fixes: tracesInChange(changed, traces),
+            resealed: await resealedSince(options.model ?? ".", io.cwd, base.commit),
+            // A commit hash, as the Action passes, reads better short.
+            label: `${/^[0-9a-f]{40}$/.test(options.base) ? options.base.slice(0, 7) : options.base}...HEAD`,
+        });
+        io.out(format === "json" ? JSON.stringify({ ...r, markdown: undefined }, null, 2) : r.markdown);
+        return 0;
+    }
+    catch (err) {
+        io.err(err instanceof Error ? err.message : String(err));
+        return 2;
+    }
+}
+/**
+ * The report for two models on disk, such as an example and its variant: the
+ * model checked on its own (there's no code to compare it with), with what the
+ * base didn't already have marked as introduced.
+ */
+async function reportFiles(base, options, io) {
+    const target = options.model ?? ".";
+    const [baseModel, model] = await Promise.all([
+        loadModel(base, { cwd: io.cwd }),
+        loadModel(target, { cwd: io.cwd }),
+    ]);
+    const key = (f) => `${f.code} ${f.message}`;
+    const before = new Set(check(baseModel).findings.map(key));
+    const findings = check(model).findings.map((f) => ({
+        ...f,
+        introduced: !before.has(key(f)),
+    }));
+    const r = prReport({
+        model,
+        base: baseModel,
+        changedFiles: [],
+        diff: diffModels(baseModel, model),
+        findings,
+        diagrams: options.diagrams !== false,
+        label: `${base} → ${target}`,
+    });
+    io.out((options.format ?? "markdown") === "json"
+        ? JSON.stringify({ ...r, markdown: undefined }, null, 2)
+        : r.markdown);
+    return 0;
+}
+//# sourceMappingURL=report.js.map

package/dist/commands/report.js.map

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

package/dist/commands/schema.d.ts

@@ -0,0 +1,5 @@
+import type { Io } from "../io.js";
+export declare function schema(options: {
+    out?: string;
+}, io: Io): Promise<number>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/commands/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/commands/schema.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAEnC,wBAAsB,MAAM,CAAC,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAS/E"}

package/dist/commands/schema.js

@@ -0,0 +1,15 @@
+import { writeFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { archdocJsonSchema } from "@archdoc/spec";
+export async function schema(options, io) {
+    const json = `${JSON.stringify(archdocJsonSchema(), null, 2)}\n`;
+    if (options.out) {
+        await writeFile(resolve(io.cwd, options.out), json);
+        io.err(`Wrote ${options.out}.`);
+    }
+    else {
+        io.out(json.trimEnd());
+    }
+    return 0;
+}
+//# sourceMappingURL=schema.js.map

package/dist/commands/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/commands/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAAyB,EAAE,EAAM;IAC5D,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;IACjE,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,MAAM,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;QACpD,EAAE,CAAC,GAAG,CAAC,SAAS,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;IAClC,CAAC;SAAM,CAAC;QACN,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/commands/seal.d.ts

@@ -0,0 +1,25 @@
+import type { Io } from "../io.js";
+export interface CheckSealsOptions {
+    model?: string;
+    format?: string;
+}
+/**
+ * `archdoc check --seals`: the model facts whose code changed since they were sealed
+ * (and what changed), and the facts no one has sealed. Exits 1 when there are
+ * any, so an agent or CI knows the model needs a look.
+ */
+export declare function checkSeals(options: CheckSealsOptions, io: Io): Promise<number>;
+export interface SealCommandOptions {
+    model?: string;
+    all?: boolean;
+    by?: string;
+    dryRun?: boolean;
+}
+/**
+ * `archdoc seal [facts…]`: records that the model still describes the code
+ * these facts point at. Without facts, seals the ones no one has sealed and
+ * drops the ones that left the model; changed facts stay flagged until named,
+ * or until --all. Says what's still to check.
+ */
+export declare function seal(facts: string[], options: SealCommandOptions, io: Io): Promise<number>;
+//# sourceMappingURL=seal.d.ts.map

package/dist/commands/seal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seal.d.ts","sourceRoot":"","sources":["../../src/commands/seal.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAEnC,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAuCpF;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,kBAAkB,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAahG"}

package/dist/commands/seal.js

@@ -0,0 +1,64 @@
+import { sealAnswer, sealReport } from "@archdoc/analyzers";
+import { formatSealStatus } from "@archdoc/core";
+/**
+ * `archdoc check --seals`: the model facts whose code changed since they were sealed
+ * (and what changed), and the facts no one has sealed. Exits 1 when there are
+ * any, so an agent or CI knows the model needs a look.
+ */
+export async function checkSeals(options, io) {
+    try {
+        const r = await sealReport(options.model ?? ".", io.cwd);
+        if (!r) {
+            io.err(`No ArchDoc model at ${options.model ?? "."}. Expected .archdoc/archdoc.yaml. Run archdoc init to start one.`);
+            return 2;
+        }
+        if (options.format === "json") {
+            io.out(JSON.stringify({
+                file: r.file,
+                sealed: r.recorded !== undefined,
+                error: r.error,
+                facts: r.statuses.map((s) => ({
+                    key: s.fact.key,
+                    label: s.fact.label,
+                    state: s.state,
+                    refs: s.fact.refs,
+                    location: s.fact.location,
+                    changes: s.changes,
+                    problems: s.problems,
+                })),
+            }, null, 2));
+        }
+        else {
+            io.out(formatSealStatus(r.statuses, { file: r.file, hasSum: !!r.recorded, error: r.error }));
+        }
+        if (r.error)
+            return 2;
+        return r.recorded && r.statuses.some((s) => s.state !== "sealed") ? 1 : 0;
+    }
+    catch (err) {
+        io.err(err instanceof Error ? err.message : String(err));
+        return 2;
+    }
+}
+/**
+ * `archdoc seal [facts…]`: records that the model still describes the code
+ * these facts point at. Without facts, seals the ones no one has sealed and
+ * drops the ones that left the model; changed facts stay flagged until named,
+ * or until --all. Says what's still to check.
+ */
+export async function seal(facts, options, io) {
+    try {
+        const r = await sealAnswer({ model: options.model, cwd: io.cwd }, { ...options, facts });
+        if (!r.ok) {
+            io.err(r.text);
+            return r.text.startsWith("No ArchDoc model") ? 2 : 1;
+        }
+        io.out(r.text);
+        return 0;
+    }
+    catch (err) {
+        io.err(err instanceof Error ? err.message : String(err));
+        return 2;
+    }
+}
+//# sourceMappingURL=seal.js.map

package/dist/commands/seal.js.map

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

package/dist/commands/site.d.ts

@@ -0,0 +1,14 @@
+import type { Io } from "../io.js";
+export interface SiteOptions {
+    out?: string;
+    /** Compare with this branch or commit, as `archdoc view --base` does. */
+    base?: string;
+}
+/**
+ * `archdoc site`: the explorer as a static site for this repository, for any
+ * static host. With --base, it opens on the change since the merge base with
+ * that ref, with the same verdict and findings as the PR comment, so a pull
+ * request can link to it.
+ */
+export declare function site(target: string, options: SiteOptions, io: Io): Promise<number>;
+//# sourceMappingURL=site.d.ts.map

package/dist/commands/site.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../../src/commands/site.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAGnC,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAsB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAoCxF"}

package/dist/commands/site.js

@@ -0,0 +1,42 @@
+import { cp, mkdir, rm, writeFile } from "node:fs/promises";
+import { join, relative, resolve } from "node:path";
+import { findWebDir, modelResponse } from "../server.js";
+/**
+ * `archdoc site`: the explorer as a static site for this repository, for any
+ * static host. With --base, it opens on the change since the merge base with
+ * that ref, with the same verdict and findings as the PR comment, so a pull
+ * request can link to it.
+ */
+export async function site(target, options, io) {
+    try {
+        const webDir = findWebDir();
+        if (!webDir) {
+            io.err("The explorer isn't built. In the ArchDoc repo, run `pnpm build`, or set ARCHDOC_WEB_DIR.");
+            return 2;
+        }
+        const body = await modelResponse({ target, cwd: io.cwd, base: options.base });
+        if (!body) {
+            io.err(`No ArchDoc model at ${target}. Expected .archdoc/archdoc.yaml. Run archdoc init to start one.`);
+            return 1;
+        }
+        const out = resolve(io.cwd, options.out ?? "site");
+        await rm(out, { recursive: true, force: true });
+        await mkdir(out, { recursive: true });
+        await cp(webDir, out, { recursive: true });
+        await mkdir(join(out, "api"), { recursive: true });
+        await writeFile(join(out, "api", "model"), JSON.stringify({ ...body, watch: false }));
+        // GitHub Pages serves files and folders as they are.
+        await writeFile(join(out, ".nojekyll"), "");
+        const where = relative(io.cwd, out) || ".";
+        io.out(`✓ Wrote ${where}/.`);
+        io.out(options.base
+            ? `  Publish the folder with any static host, and link to it with #changes to open the change since ${options.base}.`
+            : "  Publish the folder with any static host.");
+        return 0;
+    }
+    catch (err) {
+        io.err(err instanceof Error ? err.message : String(err));
+        return 2;
+    }
+}
+//# sourceMappingURL=site.js.map

package/dist/commands/site.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site.js","sourceRoot":"","sources":["../../src/commands/site.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAQzD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,MAAc,EAAE,OAAoB,EAAE,EAAM;IACrE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,EAAE,CAAC,GAAG,CACJ,0FAA0F,CAC3F,CAAC;YACF,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9E,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,EAAE,CAAC,GAAG,CACJ,uBAAuB,MAAM,kEAAkE,CAChG,CAAC;YACF,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,GAAG,GAAG,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC;QACnD,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,MAAM,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QACtF,qDAAqD;QACrD,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC;QAC3C,EAAE,CAAC,GAAG,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC;QAC7B,EAAE,CAAC,GAAG,CACJ,OAAO,CAAC,IAAI;YACV,CAAC,CAAC,oGAAoG,OAAO,CAAC,IAAI,GAAG;YACrH,CAAC,CAAC,4CAA4C,CACjD,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,EAAE,CAAC,GAAG,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACzD,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}