@kgdiff/cli 0.0.0-stage → 0.2.0

package/dist/diff-command.js

@@ -0,0 +1,236 @@
+/**
+ * `kgdiff <before> <after>`: read, parse, diff, then write every requested output.
+ */
+import { join } from 'node:path';
+import { diff, diffToJSON, } from '@kgdiff/core';
+import { STDIO } from './args.js';
+import { CliError, describeError, formatWarning, isKgdiffError } from './errors.js';
+import { parseInput, readInput, readPair, resolvePath } from './inputs.js';
+import { messages } from './locale.js';
+import { overview } from './model.js';
+import { outputContext, writeOutputFile } from './output.js';
+import { checkNoOverwrite } from './overwrite.js';
+import { renderNameStatus, renderStat, renderSummary, totalsText, } from './summary.js';
+import { cliVersion } from './version.js';
+import { sanitize } from './width.js';
+/** Upper bound of the layout width, however wide the terminal. */
+const MAX_WIDTH = 120;
+/** Narrowest layout: below it lines are laid out for 40 columns (and wrap in the terminal). */
+export const MIN_WIDTH = 40;
+/** Width assumed when stdout is not a terminal and `COLUMNS` is unset. */
+const PIPE_WIDTH = 120;
+/**
+ * Columns available for text output: the terminal width on a TTY (falling back to `COLUMNS`,
+ * then 80, when the terminal reports none), else `COLUMNS` or 120; clamped to 40–120.
+ */
+export function outputWidth(io) {
+    const fromEnv = Number(io.env.COLUMNS);
+    const env = Number.isFinite(fromEnv) && fromEnv > 0 ? fromEnv : undefined;
+    const terminal = io.columns !== undefined && io.columns > 0 ? io.columns : undefined;
+    const columns = io.isTTY ? (terminal ?? env ?? 80) : (env ?? PIPE_WIDTH);
+    return Math.max(MIN_WIDTH, Math.min(MAX_WIDTH, Math.floor(columns)));
+}
+/** Display name of one side: `name version` from graph meta, else the file name. */
+export function graphLabel(meta, input) {
+    const name = typeof meta?.name === 'string' && meta.name.trim() ? meta.name.trim() : undefined;
+    const version = typeof meta?.version === 'string' && meta.version.trim() ? meta.version.trim() : undefined;
+    if (name && version)
+        return `${name} ${version}`;
+    return name ?? input.display;
+}
+/**
+ * Default title: `name v1 → v2` when both sides share a name, `label → label` when their
+ * labels differ, else the inputs as given (`a/g.json → b/g.json`).
+ */
+export function defaultTitle(before, after) {
+    const lb = graphLabel(before.meta, before.input);
+    const la = graphLabel(after.meta, after.input);
+    const nb = before.meta?.name;
+    const vb = before.meta?.version;
+    const va = after.meta?.version;
+    if (typeof nb === 'string' &&
+        nb.trim() &&
+        nb === after.meta?.name &&
+        typeof vb === 'string' &&
+        typeof va === 'string' &&
+        vb.trim() &&
+        va.trim() &&
+        vb !== va) {
+        return `${nb.trim()} ${vb.trim()} → ${va.trim()}`;
+    }
+    return lb !== la ? `${lb} → ${la}` : `${before.input.display} → ${after.input.display}`;
+}
+function reportParseWarnings(ctx, input, warnings) {
+    const byCode = new Map();
+    for (const w of warnings)
+        byCode.set(w.code, [...(byCode.get(w.code) ?? []), w]);
+    for (const list of byCode.values()) {
+        const first = list[0];
+        const where = first.line !== undefined ? `${input.display}:${first.line}` : input.display;
+        const more = list.length > 1 ? ` (and ${list.length - 1} more like this)` : '';
+        ctx.notice(formatWarning(`${where}: ${sanitize(first.message)}${more}`, ctx.errPaint));
+    }
+}
+function reportIssues(ctx, input, issues) {
+    const byCode = new Map();
+    for (const issue of issues)
+        byCode.set(issue.code, [...(byCode.get(issue.code) ?? []), issue]);
+    for (const list of byCode.values()) {
+        const first = list[0];
+        const more = list.length > 1 ? ` (and ${list.length - 1} more like this)` : '';
+        ctx.notice(formatWarning(`${input.display}: ${sanitize(first.message)}${more}`, ctx.errPaint));
+    }
+}
+function checkOutputPaths(o, io) {
+    return checkNoOverwrite(io, [
+        { role: '<before>', path: o.before },
+        { role: '<after>', path: o.after },
+    ], [
+        { role: '--json', path: o.json },
+        { role: '--delta', path: o.delta },
+        { role: '--markdown', path: o.markdown },
+        { role: '--html', path: o.html },
+    ]);
+}
+function json(value, pretty) {
+    return `${JSON.stringify(value, null, pretty ? 2 : undefined)}\n`;
+}
+function runDiffEngine(before, after, o) {
+    try {
+        return diff(before.graph, after.graph, o.diff);
+    }
+    catch (error) {
+        if (isKgdiffError(error) && error.code === 'invalid-input') {
+            throw new CliError('input', error.message, 'Check the diff options. Run `kgdiff --help` for usage.', {
+                cause: error,
+            });
+        }
+        throw error;
+    }
+}
+/** Short description of the diff (HTML meta description and `<noscript>`). */
+export function describeDiff(result, locale) {
+    const m = messages(locale);
+    const ov = overview(result);
+    const totals = totalsText(result, m);
+    return ov.hunks === 0
+        ? `${m.identical} · ${totals}`
+        : `${m.changes(ov.changes, ov.hunks)} · ${totals}`;
+}
+/**
+ * The viewer's compute add-on for reports laid out around their changes, unless
+ * `--no-compute`. A missing add-on only costs the ability to expand collapsed groups, so it is
+ * a warning, not an error.
+ */
+async function loadCompute(o, io, ctx) {
+    if (!o.compute)
+        return undefined;
+    try {
+        return await io.loadViewerBundle('compute');
+    }
+    catch (error) {
+        ctx.notice(formatWarning(`${describeError(error).message} The report is written without it: collapsed groups cannot be expanded. Pass --no-compute to skip it.`, ctx.errPaint));
+        return undefined;
+    }
+}
+/** Run the diff command. Returns the exit code. */
+export async function runDiff(o, io) {
+    const ctx = outputContext(io, o);
+    await checkOutputPaths(o, io);
+    const wantsHtml = o.html !== undefined || o.open;
+    // Fail fast, before any parsing, when the HTML report cannot be built.
+    const bundle = wantsHtml ? await io.loadViewerBundle('main') : undefined;
+    const [beforeInput, afterInput] = await readPair(readInput(io, o.before, '<before>', { allowEmpty: o.allowEmpty }), readInput(io, o.after, '<after>', { allowEmpty: o.allowEmpty }));
+    const before = parseInput(beforeInput, {
+        format: o.beforeFormat,
+        formatFlag: o.beforeFormat === o.afterFormat ? '--format' : '--before-format',
+        ...(o.languages ? { languages: o.languages } : {}),
+    });
+    const after = parseInput(afterInput, {
+        format: o.afterFormat,
+        formatFlag: o.beforeFormat === o.afterFormat ? '--format' : '--after-format',
+        ...(o.languages ? { languages: o.languages } : {}),
+    });
+    reportParseWarnings(ctx, beforeInput, before.warnings);
+    reportParseWarnings(ctx, afterInput, after.warnings);
+    const result = runDiffEngine(before, after, o);
+    reportIssues(ctx, beforeInput, result.before.issues);
+    reportIssues(ctx, afterInput, result.after.issues);
+    const title = o.title ??
+        defaultTitle({ meta: before.graph.meta, input: beforeInput }, { meta: after.graph.meta, input: afterInput });
+    const generator = `kgdiff ${cliVersion()}`;
+    // HTML: written to -o, or to a temporary file when only --open was given.
+    let htmlPath = o.html;
+    if (htmlPath === undefined && o.open) {
+        // A fresh private directory (mkdtemp): no predictable path another user could pre-create.
+        htmlPath = join(await io.makeTempDir(), 'kgdiff-report.html');
+    }
+    const files = [];
+    let stdoutText;
+    if (o.json !== undefined && o.json !== STDIO) {
+        files.push({ path: o.json, content: json(diffToJSON(result), o.pretty), label: 'diff' });
+    }
+    if (o.delta !== undefined && o.delta !== STDIO) {
+        files.push({ path: o.delta, content: json(result.delta, o.pretty), label: 'delta' });
+    }
+    if (o.markdown !== undefined) {
+        const { renderMarkdown } = await import('./markdown.js');
+        const md = renderMarkdown(result, { locale: ctx.locale, title, generator });
+        if (o.markdown !== STDIO)
+            files.push({ path: o.markdown, content: md, label: 'Markdown summary' });
+        else
+            stdoutText = md;
+    }
+    if (bundle !== undefined && htmlPath !== undefined) {
+        const { buildReportHtml } = await import('./report.js');
+        const html = await buildReportHtml(result, {
+            title,
+            generator,
+            ...(o.reproducible ? {} : { generatedAt: io.now().toISOString() }),
+            before: { name: graphLabel(before.graph.meta, beforeInput), format: before.format },
+            after: { name: graphLabel(after.graph.meta, afterInput), format: after.format },
+            view: {
+                ...(o.mode ? { mode: o.mode } : {}),
+                ...(o.theme ? { theme: o.theme } : {}),
+                locale: ctx.locale,
+            },
+        }, { main: bundle, compute: () => loadCompute(o, io, ctx) }, describeDiff(result, ctx.locale));
+        files.push({ path: htmlPath, content: html, label: 'report' });
+    }
+    for (const file of files)
+        await writeOutputFile(ctx, file.path, file.content, file.label);
+    if (o.open && htmlPath !== undefined) {
+        try {
+            await io.openFile(resolvePath(io, htmlPath));
+        }
+        catch (error) {
+            ctx.notice(formatWarning(`Could not open the report (${error instanceof Error ? error.message : String(error)}). Open ${sanitize(htmlPath)} manually.`, ctx.errPaint));
+        }
+    }
+    if (stdoutText === undefined && !o.quiet) {
+        const text = {
+            paint: ctx.paint,
+            locale: ctx.locale,
+            width: outputWidth(io),
+            limit: o.limit,
+        };
+        if (o.json === STDIO)
+            stdoutText = json(diffToJSON(result), o.pretty);
+        else if (o.delta === STDIO)
+            stdoutText = json(result.delta, o.pretty);
+        else if (o.stat || o.nameStatus) {
+            const parts = [];
+            if (o.stat)
+                parts.push(renderStat(result, title, text));
+            if (o.nameStatus)
+                parts.push(renderNameStatus(result, text, io.isTTY));
+            stdoutText = parts.filter(Boolean).join('\n');
+        }
+        else
+            stdoutText = renderSummary(result, title, text);
+    }
+    if (stdoutText !== undefined)
+        ctx.stdout(stdoutText);
+    return o.exitCode && !result.stats.identical ? 1 : 0;
+}
+//# sourceMappingURL=diff-command.js.map

package/dist/diff-command.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Error reporting: every failure becomes one friendly line on stderr (plus a hint), exit code 2.
+ * Stack traces only with `DEBUG=kgdiff`.
+ */
+import type { Painter } from './style.js';
+export type CliErrorCode = 
+/** Bad command line. */
+'usage'
+/** A file or stdin could not be read, or its content is not a graph / delta. */
+ | 'input'
+/** An output file could not be written. */
+ | 'output'
+/** The standalone viewer bundle is missing. */
+ | 'viewer-missing';
+/** An error with a message meant for the user and an optional hint on how to fix it. */
+export declare class CliError extends Error {
+    readonly code: CliErrorCode;
+    readonly hint?: string | undefined;
+    readonly name = "CliError";
+    constructor(code: CliErrorCode, message: string, hint?: string | undefined, options?: {
+        readonly cause?: unknown;
+    });
+}
+/** Shape of `KgdiffError` (checked structurally so `--help` never loads `@kgdiff/core`). */
+interface KgdiffErrorLike {
+    readonly name: 'KgdiffError';
+    readonly code: string;
+    readonly message: string;
+    readonly details?: Readonly<Record<string, unknown>>;
+}
+export declare function isKgdiffError(error: unknown): error is KgdiffErrorLike;
+/** Node.js system error code (`ENOENT`, `EACCES`…), if any. */
+export declare function systemErrorCode(error: unknown): string | undefined;
+/** Short human reason for a system error code. */
+export declare function systemReason(error: unknown): string;
+/** User-facing message and hint for any thrown value. */
+export declare function describeError(error: unknown): {
+    message: string;
+    hint?: string;
+};
+/** True when `DEBUG` enables kgdiff diagnostics (`kgdiff`, `kgdiff*`, `*`, comma-separated). */
+export declare function debugEnabled(debug: string | undefined): boolean;
+/** The text written to stderr for an error (ends with a newline). */
+export declare function formatError(error: unknown, paint: Painter, debug: boolean): string;
+/** A warning line for stderr. */
+export declare function formatWarning(message: string, paint: Painter): string;
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG1C,MAAM,MAAM,YAAY;AACtB,wBAAwB;AACtB,OAAO;AACT,gFAAgF;GAC9E,OAAO;AACT,2CAA2C;GACzC,QAAQ;AACV,+CAA+C;GAC7C,gBAAgB,CAAC;AAErB,wFAAwF;AACxF,qBAAa,QAAS,SAAQ,KAAK;IAG/B,QAAQ,CAAC,IAAI,EAAE,YAAY;IAE3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM;IAJxB,SAAkB,IAAI,cAAc;IACpC,YACW,IAAI,EAAE,YAAY,EAC3B,OAAO,EAAE,MAAM,EACN,IAAI,CAAC,EAAE,MAAM,YAAA,EACtB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAGvC;CACF;AAED,4FAA4F;AAC5F,UAAU,eAAe;IACvB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAMtE;AAED,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGlE;AAcD,kDAAkD;AAClD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGnD;AAYD,yDAAyD;AACzD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAchF;AAED,gGAAgG;AAChG,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAI/D;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAoBlF;AAED,iCAAiC;AACjC,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAErE"}

package/dist/errors.js

@@ -0,0 +1,92 @@
+import { sanitize, sanitizeLines } from './width.js';
+/** An error with a message meant for the user and an optional hint on how to fix it. */
+export class CliError extends Error {
+    code;
+    hint;
+    name = 'CliError';
+    constructor(code, message, hint, options) {
+        super(message, options);
+        this.code = code;
+        this.hint = hint;
+    }
+}
+export function isKgdiffError(error) {
+    return (error instanceof Error &&
+        error.name === 'KgdiffError' &&
+        typeof error.code === 'string');
+}
+/** Node.js system error code (`ENOENT`, `EACCES`…), if any. */
+export function systemErrorCode(error) {
+    const code = error?.code;
+    return typeof code === 'string' && /^E[A-Z]+$/.test(code) ? code : undefined;
+}
+const SYSTEM_REASONS = {
+    ENOENT: 'no such file or directory',
+    EISDIR: 'is a directory',
+    ENOTDIR: 'a path component is not a directory',
+    EACCES: 'permission denied',
+    EPERM: 'operation not permitted',
+    EROFS: 'read-only file system',
+    ENOSPC: 'no space left on device',
+    EMFILE: 'too many open files',
+    EEXIST: 'file already exists',
+};
+/** Short human reason for a system error code. */
+export function systemReason(error) {
+    const code = systemErrorCode(error);
+    return (code && SYSTEM_REASONS[code]) ?? (error instanceof Error ? error.message : String(error));
+}
+const KGDIFF_HINTS = {
+    'delta-base-mismatch': 'The delta was made for a different version of this graph. Use --no-strict to apply it anyway.',
+    'delta-conflict': 'The graph changed since the delta was made. --no-strict skips the failing operations.',
+    'unsupported-version': 'Upgrade kgdiff (npm install -g @kgdiff/cli@latest), or check that the file is a kgdiff delta.',
+    'dangling-edge': 'An edge refers to a node the graph does not define.',
+};
+/** User-facing message and hint for any thrown value. */
+export function describeError(error) {
+    if (error instanceof CliError) {
+        return error.hint ? { message: error.message, hint: error.hint } : { message: error.message };
+    }
+    if (isKgdiffError(error)) {
+        const hint = KGDIFF_HINTS[error.code];
+        return hint ? { message: error.message, hint } : { message: error.message };
+    }
+    const code = systemErrorCode(error);
+    if (code)
+        return { message: systemReason(error) };
+    return {
+        message: `Unexpected error: ${error instanceof Error ? error.message : String(error)}`,
+        hint: 'This is a bug in kgdiff. Run again with DEBUG=kgdiff and report the output.',
+    };
+}
+/** True when `DEBUG` enables kgdiff diagnostics (`kgdiff`, `kgdiff*`, `*`, comma-separated). */
+export function debugEnabled(debug) {
+    return (debug ?? '')
+        .split(/[\s,]+/)
+        .some((d) => d === '*' || d === 'kgdiff' || d === 'kgdiff*' || d === 'kgdiff:*');
+}
+/** The text written to stderr for an error (ends with a newline). */
+export function formatError(error, paint, debug) {
+    // Messages quote user input (paths, parser snippets, JSON.parse excerpts): never let it
+    // carry escape sequences or bidi controls to the terminal.
+    const { message, hint } = describeError(error);
+    const lines = [`${paint.bold(paint.tone('removed', 'error:'))} ${sanitize(message)}`];
+    if (hint)
+        lines.push(`${paint.tone('accent', 'hint:')} ${sanitize(hint)}`);
+    if (debug) {
+        let current = error;
+        for (let depth = 0; current instanceof Error && depth < 5; depth++) {
+            lines.push('', paint.dim(sanitizeLines(current.stack ?? `${current.name}: ${current.message}`)));
+            if (isKgdiffError(current) && current.details) {
+                lines.push(paint.dim(sanitize(`details: ${JSON.stringify(current.details)}`)));
+            }
+            current = current.cause;
+        }
+    }
+    return `${lines.join('\n')}\n`;
+}
+/** A warning line for stderr. */
+export function formatWarning(message, paint) {
+    return `${paint.bold(paint.tone('content', 'warning:'))} ${sanitize(message)}\n`;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/help.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `kgdiff --help` and `kgdiff apply --help`: grouped options, defaults, examples and exit
+ * codes, aligned and wrapped to the terminal width.
+ */
+import type { Painter } from './style.js';
+/**
+ * Render help text. `width` is the terminal width (descriptions wrap to it; below 60 columns
+ * they go under their flags).
+ */
+export declare function renderHelp(topic: 'main' | 'apply', version: string, paint: Painter, width: number): string;
+//# sourceMappingURL=help.d.ts.map

package/dist/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAuN1C;;;GAGG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,GAAG,OAAO,EACvB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ,MAAM,CAyDR"}