@archdoc/cli 0.0.0-stage → 0.1.1

package/dist/commands/trace.js

@@ -0,0 +1,39 @@
+import { readFile } from "node:fs/promises";
+import { relative, resolve } from "node:path";
+import { formatTraceList, loadTraces, readTraceSources, } from "@archdoc/core";
+import { load } from "./code.js";
+/** The repository's traces, or the files named. */
+async function readTraces(files, options, io) {
+    const sources = files.length
+        ? await Promise.all(files.map(async (f) => ({
+            path: relative(io.cwd, resolve(io.cwd, f)) || f,
+            text: await readFile(resolve(io.cwd, f), "utf8"),
+        })))
+        : await readTraceSources(options.model ?? ".", { cwd: io.cwd });
+    const { traces, diagnostics } = loadTraces(sources);
+    return { traces, problems: diagnostics };
+}
+export async function traceList(options, io) {
+    const model = await load(options, io);
+    if (!model)
+        return 2;
+    const { traces, problems } = await readTraces([], options, io);
+    for (const d of problems)
+        io.err(`${d.severity} ${d.code} ${d.message}`);
+    io.out(options.json
+        ? JSON.stringify(traces.map((t) => ({
+            id: t.id,
+            title: t.spec.title,
+            expands: t.spec.expands,
+            file: t.file,
+        })), null, 2)
+        : formatTraceList(traces));
+    return 0;
+}
+export async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin)
+        chunks.push(chunk);
+    return Buffer.concat(chunks).toString("utf8");
+}
+//# sourceMappingURL=trace.js.map

package/dist/commands/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../src/commands/trace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAEL,eAAe,EACf,UAAU,EACV,gBAAgB,GAEjB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,IAAI,EAAqB,MAAM,WAAW,CAAC;AAEpD,mDAAmD;AACnD,KAAK,UAAU,UAAU,CACvB,KAAwB,EACxB,OAAqB,EACrB,EAAM;IAEN,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM;QAC1B,CAAC,CAAC,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACtB,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAC/C,IAAI,EAAE,MAAM,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC;SACjD,CAAC,CAAC,CACJ;QACH,CAAC,CAAC,MAAM,gBAAgB,CAAC,OAAO,CAAC,KAAK,IAAI,GAAG,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;IAClE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACpD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAqB,EAAE,EAAM;IAC3D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACtC,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,UAAU,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;IAC/D,KAAK,MAAM,CAAC,IAAI,QAAQ;QAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACzE,EAAE,CAAC,GAAG,CACJ,OAAO,CAAC,IAAI;QACV,CAAC,CAAC,IAAI,CAAC,SAAS,CACZ,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACjB,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK;YACnB,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO;YACvB,IAAI,EAAE,CAAC,CAAC,IAAI;SACb,CAAC,CAAC,EACH,IAAI,EACJ,CAAC,CACF;QACH,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,CAC5B,CAAC;IACF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK;QAAE,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,CAAC;IACtE,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAChD,CAAC"}

package/dist/commands/validate.d.ts

@@ -0,0 +1,8 @@
+import type { Io } from "../io.js";
+export interface ValidateOptions {
+    json?: boolean;
+    /** Treat warnings as failures. */
+    strict?: boolean;
+}
+export declare function validate(target: string, options: ValidateOptions, io: Io): Promise<number>;
+//# sourceMappingURL=validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAEnC,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,kCAAkC;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAqDhG"}

package/dist/commands/validate.js

@@ -0,0 +1,49 @@
+import { formatDiagnostic, hasErrors, loadModel } from "@archdoc/core";
+export async function validate(target, options, io) {
+    const model = await loadModel(target, { cwd: io.cwd });
+    const failed = hasErrors(model.diagnostics) ||
+        (options.strict === true && model.diagnostics.some((d) => d.severity === "warning"));
+    if (options.json) {
+        io.out(JSON.stringify({
+            ok: !failed,
+            namespace: model.namespace,
+            files: model.files,
+            counts: {
+                actors: model.actors.size,
+                elements: model.elements.size,
+                relationships: model.relationships.length,
+                journeys: model.journeys.size,
+            },
+            diagnostics: model.diagnostics,
+        }, null, 2));
+        return failed ? 1 : 0;
+    }
+    for (const d of model.diagnostics)
+        io.err(formatDiagnostic(d));
+    const count = (s) => model.diagnostics.filter((d) => d.severity === s).length;
+    const errors = count("error");
+    const warnings = count("warning");
+    const problems = [
+        errors ? `${errors} error${errors === 1 ? "" : "s"}` : "",
+        warnings ? `${warnings} warning${warnings === 1 ? "" : "s"}` : "",
+    ]
+        .filter(Boolean)
+        .join(", ");
+    if (failed) {
+        io.err(`\n✗ ${problems || "failed"}`);
+    }
+    else {
+        const summary = [
+            plural(model.actors.size, "actor"),
+            plural(model.elements.size, "element"),
+            plural(model.relationships.length, "relationship"),
+            plural(model.journeys.size, "journey"),
+        ].join(", ");
+        io.out(`${model.diagnostics.length ? "\n" : ""}✓ ${model.namespace}: ${summary} in ${plural(model.files.length, "file")}${problems ? ` (${problems})` : ""}`);
+    }
+    return failed ? 1 : 0;
+}
+function plural(n, word) {
+    return `${n} ${word}${n === 1 ? "" : "s"}`;
+}
+//# sourceMappingURL=validate.js.map

package/dist/commands/validate.js.map

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

package/dist/commands/view.d.ts

@@ -0,0 +1,17 @@
+import type { Io } from "../io.js";
+import { type ViewServer } from "../server.js";
+export interface ViewOptions {
+    watch?: boolean;
+    /** Show changes since this ref. */
+    base?: string;
+    /** Show the composed landscape. */
+    landscape?: boolean;
+    port?: string;
+    open?: boolean;
+}
+/** Starts the explorer. Resolves once the server is listening; it runs until the process ends. */
+export declare function view(target: string, options: ViewOptions, io: Io): Promise<{
+    code: number;
+    server?: ViewServer;
+}>;
+//# sourceMappingURL=view.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../src/commands/view.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAEhE,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,kGAAkG;AAClG,wBAAsB,IAAI,CACxB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,WAAW,EACpB,EAAE,EAAE,EAAE,GACL,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,UAAU,CAAA;CAAE,CAAC,CAuChD"}

package/dist/commands/view.js

@@ -0,0 +1,50 @@
+import { spawn } from "node:child_process";
+import { relative } from "node:path";
+import { startViewServer } from "../server.js";
+/** Starts the explorer. Resolves once the server is listening; it runs until the process ends. */
+export async function view(target, options, io) {
+    const port = options.port === undefined ? 0 : Number(options.port);
+    if (!Number.isInteger(port) || port < 0 || port > 65535) {
+        io.err(`--port must be a number from 0 to 65535 (0 picks a free port).`);
+        return { code: 1 };
+    }
+    let server;
+    try {
+        server = await startViewServer({
+            target,
+            cwd: io.cwd,
+            port,
+            watch: options.watch,
+            base: options.base,
+            landscape: options.landscape,
+        });
+    }
+    catch (err) {
+        io.err(`Couldn't start the explorer: ${err instanceof Error ? err.message : String(err)}`);
+        return { code: 1 };
+    }
+    if (!server.source) {
+        io.err(`No ArchDoc model at ${target}. Expected .archdoc/archdoc.yaml. Run archdoc init to start one.`);
+        await server.close();
+        return { code: 1 };
+    }
+    const what = relative(io.cwd, server.source) || ".";
+    io.out(`ArchDoc explorer: ${server.url}${options.landscape ? " (the landscape)" : ""}${options.base ? ` (showing changes since ${options.base})` : ""}`);
+    io.out(options.watch
+        ? `Watching ${what} for changes. Press Ctrl+C to stop.`
+        : `Serving ${what}. Press Ctrl+C to stop.`);
+    if (options.open)
+        openBrowser(server.url);
+    return { code: 0, server };
+}
+function openBrowser(url) {
+    const [cmd, args] = process.platform === "darwin"
+        ? ["open", [url]]
+        : process.platform === "win32"
+            ? ["cmd", ["/c", "start", "", url]]
+            : ["xdg-open", [url]];
+    spawn(cmd, args, { stdio: "ignore", detached: true })
+        .on("error", () => { })
+        .unref();
+}
+//# sourceMappingURL=view.js.map

package/dist/commands/view.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { type Io, processIo } from "./io.js";
+export { createProgram } from "./program.js";
+export { findWebDir, startViewServer, type ViewServer, type ViewServerOptions } from "./server.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { processIo } from "./io.js";
+export { createProgram } from "./program.js";
+export { findWebDir, startViewServer } from "./server.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,eAAe,EAA2C,MAAM,aAAa,CAAC"}

package/dist/io.d.ts

@@ -0,0 +1,7 @@
+export interface Io {
+    cwd: string;
+    out(text: string): void;
+    err(text: string): void;
+}
+export declare const processIo: Io;
+//# sourceMappingURL=io.d.ts.map

package/dist/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,EAAE;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,eAAO,MAAM,SAAS,EAAE,EAIvB,CAAC"}

package/dist/io.js

@@ -0,0 +1,6 @@
+export const processIo = {
+    cwd: process.cwd(),
+    out: (text) => process.stdout.write(`${text}\n`),
+    err: (text) => process.stderr.write(`${text}\n`),
+};
+//# sourceMappingURL=io.js.map

package/dist/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,SAAS,GAAO;IAC3B,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;IAClB,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;IAChD,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;CACjD,CAAC"}

package/dist/landscape.d.ts

@@ -0,0 +1,28 @@
+import { type ComposedLandscape, type LoadedModel } from "@archdoc/core";
+/** What the explorer loads for a landscape: the composed model, as one source. */
+export interface LandscapePayload {
+    root: string;
+    sources: {
+        path: string;
+        text: string;
+    }[];
+    watch: boolean;
+    files: string[];
+    repo: Record<string, unknown>;
+    landscape: {
+        namespace: string;
+        name?: string | undefined;
+        repos: ComposedLandscape["repos"];
+        domains: ComposedLandscape["domains"];
+    };
+}
+/**
+ * Loads a landscape repo's model and composes it with the models it imports.
+ * Fails when the imports aren't synced, since then there's nothing to compose.
+ */
+export declare function loadLandscape(target: string, cwd: string): Promise<{
+    model: LoadedModel;
+    composed: ComposedLandscape;
+}>;
+export declare function landscapePayload(model: LoadedModel, composed: ComposedLandscape, watch: boolean): Promise<LandscapePayload>;
+//# sourceMappingURL=landscape.d.ts.map

package/dist/landscape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"landscape.d.ts","sourceRoot":"","sources":["../src/landscape.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,iBAAiB,EAEtB,KAAK,WAAW,EAGjB,MAAM,eAAe,CAAC;AAEvB,kFAAkF;AAClF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE;QACT,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC1B,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAClC,OAAO,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;KACvC,CAAC;CACH;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,iBAAiB,CAAA;CAAE,CAAC,CAc9D;AAED,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,iBAAiB,EAC3B,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,gBAAgB,CAAC,CAc3B"}

package/dist/landscape.js

@@ -0,0 +1,34 @@
+import { composeLandscape, loadModel, repoInfo, } from "@archdoc/core";
+/**
+ * Loads a landscape repo's model and composes it with the models it imports.
+ * Fails when the imports aren't synced, since then there's nothing to compose.
+ */
+export async function loadLandscape(target, cwd) {
+    const model = await loadModel(target, { cwd });
+    if (model.diagnostics.some((d) => d.code === "model/not-found")) {
+        throw new Error(model.diagnostics[0]?.message ?? "No ArchDoc model found.");
+    }
+    if (Object.keys(model.imports).length === 0) {
+        throw new Error("This model imports no other repos, so there's no landscape to compose. List them under imports.");
+    }
+    if (!model.imported?.size) {
+        throw new Error("The landscape's imports aren't synced. Run archdoc sync first.");
+    }
+    return { model, composed: composeLandscape(model) };
+}
+export async function landscapePayload(model, composed, watch) {
+    return {
+        root: composed.root,
+        sources: composed.sources,
+        watch,
+        files: [],
+        repo: { ...(await repoInfo(model.baseDir)) },
+        landscape: {
+            namespace: model.namespace,
+            name: model.name,
+            repos: composed.repos,
+            domains: composed.domains,
+        },
+    };
+}
+//# sourceMappingURL=landscape.js.map

package/dist/landscape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"landscape.js","sourceRoot":"","sources":["../src/landscape.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,gBAAgB,EAEhB,SAAS,EACT,QAAQ,GACT,MAAM,eAAe,CAAC;AAiBvB;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAc,EACd,GAAW;IAEX,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/C,IAAI,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,iBAAiB,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,yBAAyB,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CACb,iGAAiG,CAClG,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;AACtD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAkB,EAClB,QAA2B,EAC3B,KAAc;IAEd,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,KAAK;QACL,KAAK,EAAE,EAAE;QACT,IAAI,EAAE,EAAE,GAAG,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE;QAC5C,SAAS,EAAE;YACT,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,OAAO,EAAE,QAAQ,CAAC,OAAO;SAC1B;KACF,CAAC;AACJ,CAAC"}

package/dist/model-path.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Whether a base given on the command line names a model on disk (a model
+ * file, or a directory with one) rather than a git ref, so two versions of
+ * a model can be compared without a repository: `archdoc diff a.yaml b.yaml`.
+ */
+export declare function isModelPath(cwd: string, arg: string): boolean;
+//# sourceMappingURL=model-path.d.ts.map

package/dist/model-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-path.d.ts","sourceRoot":"","sources":["../src/model-path.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAM7D"}

package/dist/model-path.js

@@ -0,0 +1,17 @@
+import { existsSync, statSync } from "node:fs";
+import { resolve } from "node:path";
+/**
+ * Whether a base given on the command line names a model on disk (a model
+ * file, or a directory with one) rather than a git ref, so two versions of
+ * a model can be compared without a repository: `archdoc diff a.yaml b.yaml`.
+ */
+export function isModelPath(cwd, arg) {
+    const path = resolve(cwd, arg);
+    if (!existsSync(path))
+        return false;
+    const stat = statSync(path);
+    if (stat.isFile())
+        return /\.(ya?ml|json)$/i.test(path);
+    return stat.isDirectory() && existsSync(resolve(path, ".archdoc"));
+}
+//# sourceMappingURL=model-path.js.map

package/dist/model-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-path.js","sourceRoot":"","sources":["../src/model-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,GAAW;IAClD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACpC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,IAAI,CAAC,MAAM,EAAE;QAAE,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,OAAO,IAAI,CAAC,WAAW,EAAE,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;AACrE,CAAC"}

package/dist/program.d.ts

@@ -0,0 +1,7 @@
+import { Command } from "commander";
+import { type Io } from "./io.js";
+/** Builds the `archdoc` program. Each action sets `exitCode` instead of exiting. */
+export declare function createProgram(io?: Io): Command & {
+    exitCode?: number;
+};
+//# sourceMappingURL=program.d.ts.map

package/dist/program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgBpC,OAAO,EAAE,KAAK,EAAE,EAAa,MAAM,SAAS,CAAC;AAM7C,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,EAAE,GAAE,EAAc,GAAG,OAAO,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAuTjF"}

package/dist/program.js

@@ -0,0 +1,197 @@
+import { readFileSync } from "node:fs";
+import { SPEC_VERSION } from "@archdoc/spec";
+import { Command } from "commander";
+import { check } from "./commands/check.js";
+import { map, show } from "./commands/code.js";
+import { context, evalCommand } from "./commands/context.js";
+import { diff } from "./commands/diff.js";
+import { publish, sync } from "./commands/federation.js";
+import { init } from "./commands/init.js";
+import { landscapeBuild } from "./commands/landscape.js";
+import { migrate } from "./commands/migrate.js";
+import { report } from "./commands/report.js";
+import { schema } from "./commands/schema.js";
+import { seal } from "./commands/seal.js";
+import { site } from "./commands/site.js";
+import { traceList } from "./commands/trace.js";
+import { validate } from "./commands/validate.js";
+import { view } from "./commands/view.js";
+import { processIo } from "./io.js";
+const { version } = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+/** Builds the `archdoc` program. Each action sets `exitCode` instead of exiting. */
+export function createProgram(io = processIo) {
+    const program = new Command("archdoc");
+    const run = (code) => code.then((c) => {
+        program.exitCode = c;
+    });
+    program
+        .description("An architecture control plane for AI-assisted development.")
+        .version(`${version} (spec ${SPEC_VERSION})`)
+        .configureOutput({
+        writeOut: (s) => io.out(s.trimEnd()),
+        writeErr: (s) => io.err(s.trimEnd()),
+    });
+    program
+        .command("init")
+        .description("Start a model from what the repository declares: packages, compose services, imports, and schema files, all marked inferred")
+        .argument("[path]", "the repository", ".")
+        .option("--name <namespace>", "the model's namespace (default: the root package or directory)")
+        .option("--dry-run", "print the model without writing it")
+        .option("--json", "print the result as JSON")
+        .action((path, opts) => run(init(path, opts, io)));
+    program
+        .command("validate")
+        .description("Check the model: schema, references, and journeys")
+        .argument("[path]", "repository, .archdoc directory, or model file", ".")
+        .option("--json", "print the result as JSON")
+        .option("--strict", "fail on warnings too")
+        .action((path, opts) => run(validate(path, opts, io)));
+    program
+        .command("view")
+        .description("Open the explorer in your browser")
+        .argument("[path]", "repository, .archdoc directory, or model file", ".")
+        .option("-w, --watch", "reload the explorer when model files change")
+        .option("-b, --base <ref>", "show what changed in the model since this branch or commit, or since another model file")
+        .option("-l, --landscape", "show the landscape: this model composed with every model it imports")
+        .option("-p, --port <port>", "port to listen on (default: a free port)")
+        .option("--open", "open the explorer in your default browser")
+        .action(async (path, opts) => {
+        const result = await view(path, opts, io);
+        program.exitCode = result.code;
+    });
+    program
+        .command("site")
+        .description("Write the explorer as a static site; with --base, opened on a change, for a pull request to link to")
+        .argument("[path]", "repository, .archdoc directory, or model file", ".")
+        .option("-o, --out <dir>", "directory to write the site to", "site")
+        .option("-b, --base <ref>", "show the change since this branch or commit")
+        .action((path, opts) => run(site(path, opts, io)));
+    program
+        .command("context")
+        .description("Where to start: files and symbols to open first, other code that does the same job, data, rules, journeys, tests, owners, and who uses it. With --error, where an error showed up; with nothing, an overview")
+        .argument("[words-or-paths...]", "the task in a few words, files you plan to change, or both")
+        .option("-e, --error <file>", "an error, log, or stack trace to place, from a file or - (stdin)")
+        .option("-m, --model <path>", "repository, .archdoc directory, or model file", ".")
+        .option("-f, --format <format>", "text or json", "text")
+        .option("--json", "print the result as JSON")
+        .action((args, opts) => run(context(args, opts, io)));
+    program
+        .command("eval", { hidden: true })
+        .description("Replay recent commits through archdoc context: how many of the files each changed the brief pointed at")
+        .argument("[ref]", "the branch or commit whose history to replay", "HEAD")
+        .option("-n, --commits <n>", "how many non-merge commits to replay", "50")
+        .option("--min-recall <ratio>", "exit 1 when recall is below this, from 0 to 1")
+        .option("-m, --model <path>", "repository, .archdoc directory, or model file", ".")
+        .option("-f, --format <format>", "text or json", "text")
+        .option("-v, --verbose", "list the changed files each brief missed")
+        .action((ref, opts) => run(evalCommand(ref, opts, io)));
+    program
+        .command("show")
+        .description("One thing in the model: an element, actor, journey, data entry, Entry.field (its lineage), trace, or sealed fact")
+        .argument("<id>", "such as payments.charges, Refund.amount_cents, or step:refund#2")
+        .option("-m, --model <path>", "repository, .archdoc directory, or model file", ".")
+        .option("--code", "print the code snippets an element points at")
+        .option("-s, --sample <file>", "run a journey on JSON or YAML records that exist when it starts, by data entry")
+        .action((id, opts) => run(show(id, opts, io)));
+    program
+        .command("map")
+        .description("How the repository's files map onto the model: coverage, unmapped files, stale paths")
+        .option("-m, --model <path>", "repository, .archdoc directory, or model file", ".")
+        .option("--unmapped", "list every unmapped file")
+        .option("--json", "print the result as JSON")
+        .action((opts) => run(map(opts, io)));
+    program
+        .command("mcp")
+        .description("Start the MCP server on stdio, for coding agents")
+        .option("-m, --model <path>", "repository, .archdoc directory, or model file", ".")
+        .action(async (opts) => {
+        const { runStdio } = await import("@archdoc/mcp");
+        await runStdio({ model: opts.model, cwd: io.cwd, version });
+    });
+    const trace = program
+        .command("trace")
+        .description("Traces: the path a failing request took, attached to the journey step where the error showed up (.archdoc/traces/)");
+    trace
+        .command("list")
+        .description("List the traces in .archdoc/traces/")
+        .option("-m, --model <path>", "repository, .archdoc directory, or model file", ".")
+        .option("--json", "print the result as JSON")
+        .action((opts) => run(traceList(opts, io)));
+    program
+        .command("check")
+        .description("What's wrong or stale: model problems, undeclared dependencies, rules, stale paths, traces, and sealed facts whose code changed. With --base, what the change does")
+        .option("-m, --model <path>", "repository, .archdoc directory, or model file", ".")
+        .option("-b, --base <ref>", "mark what changed since this ref introduced, and fail only on that")
+        .option("-f, --format <format>", "text, markdown, json, or github (workflow annotations on the diff)", "text")
+        .option("--fail-on <severity>", "error, warning, or never", "error")
+        .option("--no-code", "check the model only, without analyzing code")
+        .option("--all", "list every finding, not only the change's (or the first few)")
+        .option("--seals", "only facts whose sealed code changed, in full; exits 1 while there are any")
+        .action((opts) => run(check(opts, io)));
+    program
+        .command("seal")
+        .description("Record that the model still describes the code these facts point at (archdoc.sum); without facts, seal the new ones")
+        .argument("[facts...]", "facts to seal, such as element:toolchain.cli, or an element ID")
+        .option("-m, --model <path>", "repository, .archdoc directory, or model file", ".")
+        .option("--all", "seal every fact, changed or not (to start, or after checking them all)")
+        .option("--by <who>", "who checked, such as agent:claude-code")
+        .option("--dry-run", "say what would be sealed without writing archdoc.sum")
+        .action((facts, opts) => run(seal(facts, opts, io)));
+    program
+        .command("report")
+        .description("The architectural impact of a change, as markdown for a pull request comment")
+        .requiredOption("-b, --base <ref>", "the branch or commit the change is compared with, such as main, or a model file")
+        .option("-m, --model <path>", "repository, .archdoc directory, or model file", ".")
+        .option("-f, --format <format>", "markdown or json", "markdown")
+        .option("--no-diagrams", "leave out the Mermaid diagrams of the change and its journeys")
+        .option("--explorer-url <url>", "a page that shows this change in the explorer, to link to")
+        .action((opts) => run(report(opts, io)));
+    program
+        .command("diff")
+        .description("What changed in the model: actors, elements, relationships, journeys, data, rules")
+        .argument("[range]", "HEAD (default), a ref, a..b, a...b (what a pull request shows), or a model file")
+        .argument("[after]", "with a model file as the range, the model file to compare it with")
+        .option("-m, --model <path>", "repository, .archdoc directory, or model file", ".")
+        .option("-f, --format <format>", "text, markdown, mermaid, or json", "text")
+        .option("--exit-code", "exit 1 when the model changed")
+        .action((range, after, opts) => run(diff(range, opts, io, after)));
+    program
+        .command("sync")
+        .description("Pin the model's imports in archdoc.lock and vendor other repos' models, then check references into them")
+        .option("-m, --model <path>", "repository, .archdoc directory, or model file", ".")
+        .option("-u, --update [namespaces...]", "move imports (all, or the ones named) to the newest version their range allows")
+        .option("--frozen", "change nothing; fail if archdoc.lock doesn't match imports (for CI)")
+        .action((opts) => run(sync(opts, io)));
+    program
+        .command("publish")
+        .description("Write a versioned, validated bundle of the model for other repos to import")
+        .argument("[version]", "release version, such as 5.2.0 (default: the release tag on HEAD)")
+        .option("-m, --model <path>", "repository, .archdoc directory, or model file", ".")
+        .option("-o, --out <dir>", "directory to write the bundle to, or - for stdout", "dist")
+        .action((version, opts) => run(publish({ ...opts, version }, io)));
+    const landscape = program
+        .command("landscape")
+        .description("Compose every repo's model into one landscape (run in the landscape repo)");
+    landscape
+        .command("build")
+        .description("Check the composed landscape and write a static explorer site for GitHub Pages")
+        .argument("[path]", "the landscape repo, .archdoc directory, or model file", ".")
+        .option("-o, --out <dir>", "directory to write the site to", "site")
+        .option("--force", "write the site even when the landscape has errors")
+        .action((path, opts) => run(landscapeBuild(path, opts, io)));
+    program
+        .command("migrate", { hidden: true })
+        .description("Convert a v1 model (users/components) to spec v2")
+        .argument("<file>", "v1 model file")
+        .option("-n, --namespace <namespace>", "namespace for the model (default: from the file name)")
+        .option("--name <name>", "display name for the model")
+        .option("-o, --out <file>", "write to a file instead of stdout")
+        .action((file, opts) => run(migrate(file, opts, io)));
+    program
+        .command("schema")
+        .description("Print the JSON Schema for v2 model files, for editor validation")
+        .option("-o, --out <file>", "write to a file instead of stdout")
+        .action((opts) => run(schema(opts, io)));
+    return program;
+}
+//# sourceMappingURL=program.js.map

package/dist/program.js.map

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