@archdoc/cli 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 ArchDoc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { createProgram } from "./program.js";
+const program = createProgram();
+await program.parseAsync(process.argv);
+process.exitCode = program.exitCode ?? 0;
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;AAChC,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACvC,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC"}

package/dist/commands/check.d.ts

@@ -0,0 +1,23 @@
+import type { Io } from "../io.js";
+export interface CheckOptions {
+    model?: string;
+    /** Mark findings that the change since this ref introduced, and fail only on those. */
+    base?: string;
+    format?: string;
+    failOn?: string;
+    /** Skip code analysis and check only the model. */
+    code?: boolean;
+    /** List every finding, not only the change's (or the first few). */
+    all?: boolean;
+    /** Only the facts whose sealed code changed: exits 1 while there are any. */
+    seals?: boolean;
+}
+/** Runs analyzers and checks the model against the code and its rules. */
+export declare function runCheck(options: CheckOptions, cwd: string): Promise<import("@archdoc/analyzers").CheckRepositoryResult>;
+/**
+ * `archdoc check`: everything wrong or stale (the model's own problems,
+ * drift from the code, rules, sealed facts whose code changed, traces), and
+ * with --base, what the change does. The text is what archdoc_check answers.
+ */
+export declare function check(options: CheckOptions, io: Io): Promise<number>;
+//# sourceMappingURL=check.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAGnC,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,oEAAoE;IACpE,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,6EAA6E;IAC7E,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,0EAA0E;AAC1E,wBAAgB,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,+DAE1D;AAED;;;;GAIG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAkD1E"}

package/dist/commands/check.js

@@ -0,0 +1,58 @@
+import { checkAnswer, checkRepository } from "@archdoc/analyzers";
+import { formatAnnotations, formatFindings } from "@archdoc/core";
+import { checkSeals } from "./seal.js";
+/** Runs analyzers and checks the model against the code and its rules. */
+export function runCheck(options, cwd) {
+    return checkRepository({ model: options.model, cwd, base: options.base, code: options.code });
+}
+/**
+ * `archdoc check`: everything wrong or stale (the model's own problems,
+ * drift from the code, rules, sealed facts whose code changed, traces), and
+ * with --base, what the change does. The text is what archdoc_check answers.
+ */
+export async function check(options, io) {
+    if (options.seals) {
+        return checkSeals({ model: options.model, format: options.format === "json" ? "json" : "text" }, io);
+    }
+    const format = options.format ?? "text";
+    if (!["text", "markdown", "json", "github"].includes(format)) {
+        io.err("--format must be text, markdown, json, or github.");
+        return 2;
+    }
+    const failOn = options.failOn ?? "error";
+    if (!["error", "warning", "never"].includes(failOn)) {
+        io.err("--fail-on must be error, warning, or never.");
+        return 2;
+    }
+    let findings;
+    try {
+        if (format === "text") {
+            const answer = await checkAnswer({ model: options.model, cwd: io.cwd }, { base: options.base, all: options.all, code: options.code });
+            findings = answer.findings;
+            io.out(answer.text);
+        }
+        else {
+            findings = (await runCheck(options, io.cwd)).findings;
+            if (format === "github") {
+                // Workflow commands put the findings on the diff; the text keeps the log readable.
+                const annotations = formatAnnotations(findings);
+                if (annotations)
+                    io.out(annotations);
+                io.out(formatFindings(findings, "text"));
+            }
+            else {
+                io.out(format === "json"
+                    ? JSON.stringify(findings, null, 2)
+                    : formatFindings(findings, format));
+            }
+        }
+    }
+    catch (err) {
+        io.err(err instanceof Error ? err.message : String(err));
+        return 2;
+    }
+    const counted = options.base ? findings.filter((f) => f.introduced) : findings;
+    const failing = counted.filter((f) => f.severity === "error" || (failOn === "warning" && f.severity === "warning"));
+    return failOn !== "never" && failing.length > 0 ? 1 : 0;
+}
+//# sourceMappingURL=check.js.map

package/dist/commands/check.js.map

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

package/dist/commands/code.d.ts

@@ -0,0 +1,24 @@
+import { type LoadedModel } from "@archdoc/core";
+import type { Io } from "../io.js";
+export interface ModelOptions {
+    /** Repository, .archdoc directory, or model file. */
+    model?: string;
+    json?: boolean;
+}
+export declare function load(options: ModelOptions, io: Io): Promise<LoadedModel | undefined>;
+export declare function map(options: ModelOptions & {
+    unmapped?: boolean;
+}, io: Io): Promise<number>;
+/** Prints the details of an element, actor, or journey by ID. */
+/**
+ * `archdoc show <id>`: one thing in the model, whatever kind of ID names it:
+ * an element, actor, journey (with --sample, run on it), data entry,
+ * Entry.field (its lineage), trace, or a sealed fact. What archdoc_show answers.
+ */
+export declare function show(id: string, options: ModelOptions & {
+    code?: boolean;
+    sample?: string;
+}, io: Io): Promise<number>;
+/** A file in the repository, or undefined when there's none (or it's outside it). */
+export declare function readRepoFile(baseDir: string, path: string): string | undefined;
+//# sourceMappingURL=code.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../src/commands/code.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,WAAW,EAIjB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAEnC,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAU1F;AAED,wBAAsB,GAAG,CAAC,OAAO,EAAE,YAAY,GAAG;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAuDjG;AAED,iEAAiE;AACjE;;;;GAIG;AACH,wBAAsB,IAAI,CACxB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,YAAY,GAAG;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3D,EAAE,EAAE,EAAE,GACL,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQ9E"}

package/dist/commands/code.js

@@ -0,0 +1,92 @@
+import { readFileSync } from "node:fs";
+import { relative, resolve } from "node:path";
+import { showAnswer } from "@archdoc/analyzers";
+import { filesUnder, hasErrors, listRepoFiles, loadModel, resolveCodeMap, } from "@archdoc/core";
+export async function load(options, io) {
+    const model = await loadModel(options.model ?? ".", { cwd: io.cwd });
+    if (model.diagnostics.some((d) => d.code === "model/not-found")) {
+        io.err(model.diagnostics[0]?.message ?? "No model found.");
+        return undefined;
+    }
+    if (hasErrors(model.diagnostics)) {
+        io.err('warning: the model has errors, so answers may be incomplete. Run "archdoc validate".');
+    }
+    return model;
+}
+export async function map(options, io) {
+    const model = await load(options, io);
+    if (!model)
+        return 1;
+    const files = await listRepoFiles(model.baseDir);
+    const codemap = resolveCodeMap(model, files);
+    const top = [...model.elements.values()].filter((e) => e.depth === 0);
+    const mapped = files.length - codemap.unmapped.length;
+    if (options.json) {
+        io.out(JSON.stringify({
+            files: files.length,
+            mapped,
+            elements: Object.fromEntries([...model.elements.keys()].map((id) => [id, filesUnder(model, codemap, id).length])),
+            unmapped: codemap.unmapped,
+            stale: codemap.stale,
+        }, null, 2));
+        return 0;
+    }
+    const lines = [`${mapped} of ${files.length} files map to an element.`, ""];
+    const walk = (id, indent) => {
+        const e = model.elements.get(id);
+        if (!e)
+            return;
+        const n = filesUnder(model, codemap, id).length;
+        const note = e.spec.status === "planned"
+            ? " (planned)"
+            : e.code.length === 0 && n === 0
+                ? " (no code paths)"
+                : "";
+        lines.push(`${indent}${e.key}  ${n} file${n === 1 ? "" : "s"}${note}`);
+        for (const c of e.childIds)
+            walk(c, `${indent}  `);
+    };
+    for (const e of top)
+        walk(e.id, "  ");
+    if (codemap.stale.length) {
+        lines.push("", "Code paths that match no files:");
+        for (const s of codemap.stale)
+            lines.push(`  ${s.element}: ${s.pattern}`);
+    }
+    if (codemap.unmapped.length) {
+        lines.push("", `${codemap.unmapped.length} unmapped file${codemap.unmapped.length === 1 ? "" : "s"}${options.unmapped ? ":" : " (list them with --unmapped)"}`);
+        if (options.unmapped)
+            for (const f of codemap.unmapped)
+                lines.push(`  ${f}`);
+    }
+    io.out(lines.join("\n"));
+    return 0;
+}
+/** Prints the details of an element, actor, or journey by ID. */
+/**
+ * `archdoc show <id>`: one thing in the model, whatever kind of ID names it:
+ * an element, actor, journey (with --sample, run on it), data entry,
+ * Entry.field (its lineage), trace, or a sealed fact. What archdoc_show answers.
+ */
+export async function show(id, options, io) {
+    const r = await showAnswer({ model: options.model, cwd: io.cwd }, { id, code: options.code, sample: options.sample });
+    if (!r.ok) {
+        io.err(r.text);
+        return 1;
+    }
+    io.out(r.text);
+    return r.failing ? 1 : 0;
+}
+/** A file in the repository, or undefined when there's none (or it's outside it). */
+export function readRepoFile(baseDir, path) {
+    const absolute = resolve(baseDir, path);
+    if (relative(baseDir, absolute).startsWith(".."))
+        return undefined;
+    try {
+        return readFileSync(absolute, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=code.js.map

package/dist/commands/code.js.map

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

package/dist/commands/context.d.ts

@@ -0,0 +1,26 @@
+import type { Io } from "../io.js";
+export interface ContextOptions {
+    model?: string;
+    format?: string;
+    json?: boolean;
+    /** A file with the error to place, or - for stdin. */
+    error?: string;
+}
+/**
+ * `archdoc context <words…|paths…>`: where to start a task. Arguments that
+ * are paths (they contain a slash, or exist) are taken relative to where the
+ * command runs; the rest are the task in words.
+ */
+export declare function context(args: string[], options: ContextOptions, io: Io, stdin?: () => Promise<string>): Promise<number>;
+export interface EvalOptions extends ContextOptions {
+    commits?: string;
+    minRecall?: string;
+    verbose?: boolean;
+}
+/**
+ * `archdoc eval [ref]`: replays recent commits through `context` and reports
+ * how many of the files they changed the brief pointed at. Read-only: it
+ * reads the history with git log, and the model and code as they are now.
+ */
+export declare function evalCommand(ref: string | undefined, options: EvalOptions, io: Io): Promise<number>;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAGnC,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAuBD;;;;GAIG;AACH,wBAAsB,OAAO,CAC3B,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,cAAc,EACvB,EAAE,EAAE,EAAE,EACN,KAAK,GAAE,MAAM,OAAO,CAAC,MAAM,CAAa,GACvC,OAAO,CAAC,MAAM,CAAC,CA+CjB;AAED,MAAM,WAAW,WAAY,SAAQ,cAAc;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,OAAO,EAAE,WAAW,EACpB,EAAE,EAAE,EAAE,GACL,OAAO,CAAC,MAAM,CAAC,CAiCjB"}

package/dist/commands/context.js

@@ -0,0 +1,117 @@
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { isAbsolute, relative, resolve } from "node:path";
+import { contextAnswer, indexRepository } from "@archdoc/analyzers";
+import { context as contextOf, evaluate, formatContext, formatEval, hasErrors, loadModel, recentCommits, resolveGitRef, } from "@archdoc/core";
+import { readStdin } from "./trace.js";
+async function load(model, io) {
+    const m = await loadModel(model ?? ".", { cwd: io.cwd });
+    if (m.diagnostics.some((d) => d.code === "model/not-found")) {
+        io.err(m.diagnostics[0]?.message ?? "No model found.");
+        return undefined;
+    }
+    if (hasErrors(m.diagnostics)) {
+        io.err('warning: the model has errors, so answers may be incomplete. Run "archdoc validate".');
+    }
+    return m;
+}
+function formatOf(options, io) {
+    const format = options.json ? "json" : (options.format ?? "text");
+    if (format !== "text" && format !== "json") {
+        io.err("--format must be text or json.");
+        return undefined;
+    }
+    return format;
+}
+/**
+ * `archdoc context <words…|paths…>`: where to start a task. Arguments that
+ * are paths (they contain a slash, or exist) are taken relative to where the
+ * command runs; the rest are the task in words.
+ */
+export async function context(args, options, io, stdin = readStdin) {
+    const format = formatOf(options, io);
+    if (!format)
+        return 2;
+    // An error to place, or nothing (the overview): what archdoc_context answers.
+    if (options.error !== undefined || !args.length) {
+        if (format === "json") {
+            io.err("--format json works with a task or paths, not with --error or no arguments.");
+            return 2;
+        }
+        let error;
+        try {
+            if (options.error !== undefined) {
+                error =
+                    options.error === "-"
+                        ? await stdin()
+                        : await readFile(resolve(io.cwd, options.error), "utf8");
+            }
+        }
+        catch (err) {
+            io.err(err instanceof Error ? err.message : String(err));
+            return 2;
+        }
+        const words = args.filter((a) => !(a.includes("/") || a.includes("\\") || existsSync(resolve(io.cwd, a))));
+        const r = await contextAnswer({ model: options.model, cwd: io.cwd }, { task: words.join(" "), paths: args.filter((a) => !words.includes(a)), error });
+        (r.ok ? io.out : io.err)(r.text);
+        return r.ok ? 0 : 1;
+    }
+    const model = await load(options.model, io);
+    if (!model)
+        return 1;
+    const words = [];
+    const paths = [];
+    for (const arg of args) {
+        const absolute = isAbsolute(arg) ? arg : resolve(io.cwd, arg);
+        if (arg.includes("/") || arg.includes("\\") || existsSync(absolute)) {
+            paths.push(relative(model.baseDir, absolute).replace(/\\/g, "/"));
+        }
+        else {
+            words.push(arg);
+        }
+    }
+    const index = await indexRepository(model.baseDir);
+    const brief = contextOf(model, words.join(" "), { index, paths });
+    io.out(format === "json" ? JSON.stringify(brief, null, 2) : formatContext(brief));
+    return brief.start.length ? 0 : 1;
+}
+/**
+ * `archdoc eval [ref]`: replays recent commits through `context` and reports
+ * how many of the files they changed the brief pointed at. Read-only: it
+ * reads the history with git log, and the model and code as they are now.
+ */
+export async function evalCommand(ref, options, io) {
+    const format = formatOf(options, io);
+    if (!format)
+        return 2;
+    const count = Number(options.commits ?? 50);
+    if (!Number.isInteger(count) || count < 1) {
+        io.err("--commits must be a positive whole number.");
+        return 2;
+    }
+    const min = options.minRecall === undefined ? undefined : Number(options.minRecall);
+    if (min !== undefined && !(min >= 0 && min <= 1)) {
+        io.err("--min-recall must be a number from 0 to 1, such as 0.5.");
+        return 2;
+    }
+    const model = await load(options.model, io);
+    if (!model)
+        return 1;
+    const at = ref ?? "HEAD";
+    if (!(await resolveGitRef(model.baseDir, at))) {
+        io.err(`${at} is not a commit, branch, or tag.`);
+        return 2;
+    }
+    const [commits, index] = await Promise.all([
+        recentCommits(model.baseDir, at, count),
+        indexRepository(model.baseDir),
+    ]);
+    const report = evaluate(model, index, commits);
+    io.out(format === "json" ? JSON.stringify(report, null, 2) : formatEval(report, options.verbose));
+    if (min !== undefined && report.recall < min) {
+        io.err(`Recall ${Math.round(report.recall * 100)}% is below --min-recall ${Math.round(min * 100)}%.`);
+        return 1;
+    }
+    return 0;
+}
+//# sourceMappingURL=context.js.map

package/dist/commands/context.js.map

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

package/dist/commands/data.d.ts

@@ -0,0 +1,12 @@
+import type { Io } from "../io.js";
+export interface DataOptions {
+    model?: string;
+    json?: boolean;
+}
+/** `archdoc lineage <entry.field>`: where a field's value comes from and goes, across repos. */
+export declare function lineageCommand(field: string, options: DataOptions, io: Io): Promise<number>;
+/** `archdoc simulate <journey> --sample <file>`: the path a sample takes, and the records it writes. */
+export declare function simulateCommand(journey: string, options: DataOptions & {
+    sample?: string;
+}, io: Io): Promise<number>;
+//# sourceMappingURL=data.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../src/commands/data.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAEnC,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAcD,gGAAgG;AAChG,wBAAsB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAwBjG;AAED,wGAAwG;AACxG,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,WAAW,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAC1C,EAAE,EAAE,EAAE,GACL,OAAO,CAAC,MAAM,CAAC,CA8BjB"}

package/dist/commands/data.js

@@ -0,0 +1,63 @@
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { formatLineage, formatSimulation, hasErrors, lineage, loadModel, simulate, } from "@archdoc/core";
+import { parse } from "yaml";
+async function load(options, io) {
+    const model = await loadModel(options.model ?? ".", { cwd: io.cwd });
+    if (model.diagnostics.some((d) => d.code === "model/not-found")) {
+        io.err(model.diagnostics[0]?.message ?? "No model found.");
+        return undefined;
+    }
+    if (hasErrors(model.diagnostics)) {
+        io.err('warning: the model has errors, so answers may be incomplete. Run "archdoc validate".');
+    }
+    return model;
+}
+/** `archdoc lineage <entry.field>`: where a field's value comes from and goes, across repos. */
+export async function lineageCommand(field, options, io) {
+    const model = await load(options, io);
+    if (!model)
+        return 1;
+    const l = lineage(model, field);
+    if (!l) {
+        io.err(`No data entry for "${field}". Name a field as Entry.field, such as Refund.amount_cents or payments.Refund.amount_cents.`);
+        return 1;
+    }
+    io.out(options.json
+        ? JSON.stringify({
+            ...l,
+            stored: Object.fromEntries(l.stored),
+            classifications: Object.fromEntries(l.classifications),
+        }, null, 2)
+        : formatLineage(l));
+    return 0;
+}
+/** `archdoc simulate <journey> --sample <file>`: the path a sample takes, and the records it writes. */
+export async function simulateCommand(journey, options, io) {
+    const model = await load(options, io);
+    if (!model)
+        return 1;
+    let sample = {};
+    if (options.sample) {
+        try {
+            const parsed = parse(await readFile(resolve(io.cwd, options.sample), "utf8"));
+            if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+                throw new Error("it should map data entries to records, such as { RefundRequest: { amount_cents: 400 } }");
+            }
+            sample = parsed;
+        }
+        catch (err) {
+            io.err(`Couldn't read ${options.sample}: ${err instanceof Error ? err.message : String(err)}`);
+            return 2;
+        }
+    }
+    const result = simulate(model, journey, sample);
+    if (!result) {
+        io.err(`No journey "${journey}". List them with "archdoc search <words>" or "archdoc show <journey>".`);
+        return 1;
+    }
+    io.out(options.json ? JSON.stringify(result, null, 2) : formatSimulation(result));
+    // Problems (a missing input, an expression that failed) fail the run, so CI can use it.
+    return result.steps.some((s) => s.problems.length) ? 1 : 0;
+}
+//# sourceMappingURL=data.js.map

package/dist/commands/data.js.map

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

package/dist/commands/diff.d.ts

@@ -0,0 +1,17 @@
+import type { Io } from "../io.js";
+export interface DiffOptions {
+    model?: string;
+    format?: string;
+    /** Exit 1 when the model changed, like `git diff --exit-code`. */
+    exitCode?: boolean;
+}
+/**
+ * `archdoc diff [range]`. No range: HEAD against the working tree. `main`:
+ * main against the working tree. `a..b`: a against b. `a...b`: the merge base
+ * of a and b against b, which is what a pull request shows. Two model
+ * files: the first against the second.
+ */
+export declare function diff(range: string | undefined, options: DiffOptions, io: Io, 
+/** With a model path as `range`, the model to compare it with; else --model. */
+after?: string): Promise<number>;
+//# sourceMappingURL=diff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/commands/diff.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAGnC,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAID;;;;;GAKG;AACH,wBAAsB,IAAI,CACxB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,OAAO,EAAE,WAAW,EACpB,EAAE,EAAE,EAAE;AACN,gFAAgF;AAChF,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CA6CjB"}

package/dist/commands/diff.js

@@ -0,0 +1,79 @@
+import { loadRevision } from "@archdoc/analyzers";
+import { diffModels, formatDiff, isEmptyDiff, loadModel, mergeBase, } from "@archdoc/core";
+import { isModelPath } from "../model-path.js";
+const FORMATS = ["text", "markdown", "mermaid", "json"];
+/**
+ * `archdoc diff [range]`. No range: HEAD against the working tree. `main`:
+ * main against the working tree. `a..b`: a against b. `a...b`: the merge base
+ * of a and b against b, which is what a pull request shows. Two model
+ * files: the first against the second.
+ */
+export async function diff(range, options, io, 
+/** With a model path as `range`, the model to compare it with; else --model. */
+after) {
+    const format = (options.format ?? "text");
+    if (!FORMATS.includes(format)) {
+        io.err(`--format must be one of ${FORMATS.join(", ")}.`);
+        return 1;
+    }
+    const target = options.model ?? ".";
+    try {
+        // Two models on disk, such as an example and its variant: the first against the second.
+        if (range && isModelPath(io.cwd, range)) {
+            const other = after ?? target;
+            const [base, model] = await Promise.all([
+                loadModel(range, { cwd: io.cwd }),
+                loadModel(other, { cwd: io.cwd }),
+            ]);
+            warnOnErrors(base, range, io);
+            warnOnErrors(model, other, io);
+            const d = diffModels(base, model);
+            io.out(formatDiff(d, format, `${range} → ${other}`));
+            return options.exitCode && !isEmptyDiff(d) ? 1 : 0;
+        }
+        if (after) {
+            io.err(`${range} isn't a model file. Compare two model files, or give a git range.`);
+            return 2;
+        }
+        const sides = await resolveRange(range ?? "HEAD", io.cwd);
+        // Both sides as every surface reads them: schema sources and other repos' models included.
+        const at = async (ref) => {
+            const rev = await loadRevision(target, { cwd: io.cwd, ref });
+            if (!rev)
+                throw new Error(`No ArchDoc model at ${target}. Expected .archdoc/archdoc.yaml. Run archdoc init to start one.`);
+            return rev.model;
+        };
+        const [base, head] = await Promise.all([at(sides.base), at(sides.head)]);
+        warnOnErrors(base, `${sides.base}`, io);
+        warnOnErrors(head, sides.head ?? "working tree", io);
+        const d = diffModels(base, head);
+        io.out(formatDiff(d, format, `${sides.label} → ${sides.head ?? "working tree"}`));
+        return options.exitCode && !isEmptyDiff(d) ? 1 : 0;
+    }
+    catch (err) {
+        io.err(err instanceof Error ? err.message : String(err));
+        return 2;
+    }
+}
+async function resolveRange(range, cwd) {
+    const three = range.split("...");
+    if (three.length === 2) {
+        const [a, b] = three;
+        const base = await mergeBase(cwd, a || "HEAD", b || "HEAD");
+        if (!base)
+            throw new Error(`No common ancestor for ${a} and ${b}.`);
+        return { base, head: b || "HEAD", label: `merge base with ${a || "HEAD"}` };
+    }
+    const two = range.split("..");
+    if (two.length === 2) {
+        const [a, b] = two;
+        return { base: a || "HEAD", head: b || "HEAD", label: a || "HEAD" };
+    }
+    return { base: range, label: range };
+}
+function warnOnErrors(model, side, io) {
+    const errors = model.diagnostics.filter((d) => d.severity === "error" && d.code !== "model/not-found");
+    if (errors.length)
+        io.err(`warning: the model at ${side} has ${errors.length} error(s); the diff may be incomplete.`);
+}
+//# sourceMappingURL=diff.js.map

package/dist/commands/diff.js.map

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