@melra/cli 0.3.0-alpha.11 → 0.3.0-alpha.12

package/dist/isolation.js

@@ -0,0 +1,66 @@
+// Copyright 2026 XAGI Labs Private Limited
+// SPDX-License-Identifier: Apache-2.0
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+/**
+ * Read the restrictions out of `/proc/self/status` and `/proc/self/mountinfo`.
+ * Pure, so the parsing is testable without a container.
+ */
+export function parseIsolation(status, mountinfo, container) {
+    const field = (name) => new RegExp(`^${name}:\\s*(\\S+)`, "m").exec(status)?.[1];
+    const capabilities = field("CapEff");
+    // mountinfo: id parent major:minor root mount-point options ...
+    const root = mountinfo
+        .split("\n")
+        .map((line) => line.split(" "))
+        .filter((parts) => parts[4] === "/")
+        .at(-1); // the last mount over / is the one in effect
+    return {
+        noCapabilities: capabilities !== undefined && /^0+$/.test(capabilities),
+        noNewPrivileges: field("NoNewPrivs") === "1",
+        seccomp: field("Seccomp") === "2",
+        readOnlyRoot: root?.[5]?.split(",").includes("ro") ?? false,
+        container,
+    };
+}
+export async function detectIsolation() {
+    if (process.platform !== "linux")
+        return undefined;
+    try {
+        const [status, mountinfo] = await Promise.all([
+            readFile("/proc/self/status", "utf8"),
+            readFile("/proc/self/mountinfo", "utf8"),
+        ]);
+        return parseIsolation(status, mountinfo, existsSync("/.dockerenv") || existsSync("/run/.containerenv"));
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * The doctor line. Never a `fail`: isolation is the operator's to arrange, and
+ * a laptop in developer mode needs none. Enforced mode with nothing in effect
+ * is a `warn`, because that is the case the operator should know about.
+ */
+export function isolationCheck(isolation, mode) {
+    const name = "isolation";
+    const unbacked = mode === "enforced" ? "warn" : "pass";
+    if (isolation === undefined) {
+        return {
+            name,
+            status: unbacked,
+            detail: `not visible on ${process.platform}; a macOS sandbox profile or a Windows Job Object cannot be read from inside`,
+        };
+    }
+    const active = [
+        isolation.container && "container",
+        isolation.noCapabilities && "no capabilities",
+        isolation.noNewPrivileges && "no_new_privs",
+        isolation.seccomp && "seccomp filter",
+        isolation.readOnlyRoot && "read-only root",
+    ].filter((item) => item !== false);
+    return active.length === 0
+        ? { name, status: unbacked, detail: "none in effect: full capabilities, no seccomp filter, writable root" }
+        : { name, status: "pass", detail: active.join(", ") };
+}
+//# sourceMappingURL=isolation.js.map

package/dist/isolation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isolation.js","sourceRoot":"","sources":["../src/isolation.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,sCAAsC;AAEtC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAqB5C;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,SAAiB,EAAE,SAAkB;IAClF,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,IAAI,IAAI,aAAa,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACzF,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IACrC,gEAAgE;IAChE,MAAM,IAAI,GAAG,SAAS;SACnB,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;SAC9B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC;SACnC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,6CAA6C;IACxD,OAAO;QACL,cAAc,EAAE,YAAY,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC;QACvE,eAAe,EAAE,KAAK,CAAC,YAAY,CAAC,KAAK,GAAG;QAC5C,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK,GAAG;QACjC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK;QAC3D,SAAS;KACV,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC;IACnD,IAAI,CAAC;QACH,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC5C,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;YACrC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;SACzC,CAAC,CAAC;QACH,OAAO,cAAc,CACnB,MAAM,EACN,SAAS,EACT,UAAU,CAAC,aAAa,CAAC,IAAI,UAAU,CAAC,oBAAoB,CAAC,CAC9D,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,SAAgC,EAChC,IAA8B;IAE9B,MAAM,IAAI,GAAG,WAAW,CAAC;IACzB,MAAM,QAAQ,GAAG,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IACvD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO;YACL,IAAI;YACJ,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,kBAAkB,OAAO,CAAC,QAAQ,8EAA8E;SACzH,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG;QACb,SAAS,CAAC,SAAS,IAAI,WAAW;QAClC,SAAS,CAAC,cAAc,IAAI,iBAAiB;QAC7C,SAAS,CAAC,eAAe,IAAI,cAAc;QAC3C,SAAS,CAAC,OAAO,IAAI,gBAAgB;QACrC,SAAS,CAAC,YAAY,IAAI,gBAAgB;KAC3C,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC;IACnD,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC;QACxB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,qEAAqE,EAAE;QAC3G,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC1D,CAAC"}

package/dist/jsonc.d.ts

@@ -0,0 +1,24 @@
+export interface JsoncMember {
+    key: string;
+    keyStart: number;
+    value: JsoncNode;
+}
+export interface JsoncNode {
+    start: number;
+    end: number;
+    value: unknown;
+    members?: JsoncMember[];
+    trailingComma?: number;
+}
+export declare function parseJsonc(text: string): JsoncNode;
+/**
+ * Set `path` to `value` in JSONC `text`, rewriting only that member and
+ * leaving every other byte (comments, trailing commas, formatting, key order,
+ * line endings) as it was. A missing member is inserted into the deepest
+ * object that exists, indented to match its siblings. With `keepExisting`, a
+ * member that is already there is left alone. Throws when the root or a step
+ * of the path is not an object, or a step appears twice in one object, since
+ * which duplicate a client honours is not knowable from here.
+ */
+export declare function upsertJsonc(text: string, path: string[], value: unknown, keepExisting?: boolean): string;
+//# sourceMappingURL=jsonc.d.ts.map

package/dist/jsonc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonc.d.ts","sourceRoot":"","sources":["../src/jsonc.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IAExB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IAGf,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IAExB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAMD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAoHlD;AAqCD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,OAAO,EACd,YAAY,UAAQ,GACnB,MAAM,CA0ER"}

package/dist/jsonc.js

@@ -0,0 +1,238 @@
+// Copyright 2026 XAGI Labs Private Limited
+// SPDX-License-Identifier: Apache-2.0
+const NUMBER_OR_LITERAL = /-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?|true|false|null/y;
+export function parseJsonc(text) {
+    let at = 0;
+    const error = (what) => new Error(`${what} at line ${text.slice(0, at).split("\n").length}`);
+    const skip = () => {
+        for (;;) {
+            const c = text[at];
+            if (c === " " || c === "\t" || c === "\n" || c === "\r" || (c === "" && at === 0)) {
+                at++;
+            }
+            else if (text.startsWith("//", at)) {
+                const newline = text.indexOf("\n", at);
+                at = newline === -1 ? text.length : newline;
+            }
+            else if (text.startsWith("/*", at)) {
+                const close = text.indexOf("*/", at + 2);
+                if (close === -1)
+                    throw error("unterminated comment");
+                at = close + 2;
+            }
+            else {
+                return;
+            }
+        }
+    };
+    // Find the closing quote by hand so `//` or `/*` inside a string is never
+    // taken for a comment, then let JSON.parse decode and validate the escapes.
+    const string = () => {
+        const start = at++;
+        for (;;) {
+            const c = text[at];
+            if (c === undefined)
+                throw error("unterminated string");
+            at += c === "\\" ? 2 : 1;
+            if (c === '"')
+                break;
+        }
+        try {
+            return JSON.parse(text.slice(start, at));
+        }
+        catch {
+            throw error("invalid string");
+        }
+    };
+    const object = () => {
+        const start = at++;
+        const members = [];
+        const value = {};
+        let trailingComma;
+        skip();
+        while (text[at] !== "}") {
+            if (text[at] !== '"')
+                throw error("expected a quoted key or '}'");
+            const keyStart = at;
+            const key = string();
+            skip();
+            if (text[at] !== ":")
+                throw error("expected ':'");
+            at++;
+            const node = parse();
+            members.push({ key, keyStart, value: node });
+            // defineProperty, not assignment, so a `__proto__` key stays plain data.
+            Object.defineProperty(value, key, {
+                value: node.value,
+                enumerable: true,
+                writable: true,
+                configurable: true,
+            });
+            skip();
+            trailingComma = undefined;
+            if (text[at] === ",") {
+                trailingComma = at++;
+                skip();
+            }
+            else if (text[at] !== "}") {
+                throw error("expected ',' or '}'");
+            }
+        }
+        at++;
+        return { start, end: at, value, members, ...(trailingComma === undefined ? {} : { trailingComma }) };
+    };
+    const array = () => {
+        const start = at++;
+        const items = [];
+        skip();
+        while (text[at] !== "]") {
+            items.push(parse().value);
+            skip();
+            if (text[at] === ",") {
+                at++;
+                skip();
+            }
+            else if (text[at] !== "]") {
+                throw error("expected ',' or ']'");
+            }
+        }
+        at++;
+        return { start, end: at, value: items };
+    };
+    const parse = () => {
+        skip();
+        const start = at;
+        const c = text[at];
+        if (c === "{")
+            return object();
+        if (c === "[")
+            return array();
+        if (c === '"') {
+            const value = string();
+            return { start, end: at, value };
+        }
+        NUMBER_OR_LITERAL.lastIndex = at;
+        const match = NUMBER_OR_LITERAL.exec(text);
+        if (match === null) {
+            throw error(c === undefined ? "unexpected end of file" : `unexpected ${JSON.stringify(c)}`);
+        }
+        at = NUMBER_OR_LITERAL.lastIndex;
+        return { start, end: at, value: JSON.parse(match[0]) };
+    };
+    const root = parse();
+    skip();
+    if (at < text.length)
+        throw error("unexpected content after the value");
+    return root;
+}
+const splice = (text, from, to, insert) => `${text.slice(0, from)}${insert}${text.slice(to)}`;
+const lineStart = (text, offset) => text.lastIndexOf("\n", offset - 1) + 1;
+// The run of spaces and tabs that starts the line holding `offset`.
+const lineIndent = (text, offset) => /^[ \t]*/.exec(text.slice(lineStart(text, offset), offset))?.[0] ?? "";
+const startsLine = (text, offset) => text.slice(lineStart(text, offset), offset).trim() === "";
+// The end of the line after `from` when only blanks and comments follow it
+// there, so a member inserted after `"a": 1, // why` lands below the comment
+// instead of stealing it; otherwise `from` itself.
+function endOfTriviaLine(text, from) {
+    let at = from;
+    for (;;) {
+        while (text[at] === " " || text[at] === "\t")
+            at++;
+        if (text.startsWith("//", at)) {
+            const newline = text.indexOf("\n", at);
+            if (newline === -1)
+                return from;
+            at = newline;
+        }
+        else if (text.startsWith("/*", at)) {
+            const close = text.indexOf("*/", at);
+            if (close === -1 || text.slice(at, close).includes("\n"))
+                return from;
+            at = close + 2;
+            continue;
+        }
+        if (text[at] === "\r" && text[at + 1] === "\n")
+            return at;
+        if (text[at] === "\n")
+            return text[at - 1] === "\r" ? at - 1 : at;
+        return from;
+    }
+}
+/**
+ * Set `path` to `value` in JSONC `text`, rewriting only that member and
+ * leaving every other byte (comments, trailing commas, formatting, key order,
+ * line endings) as it was. A missing member is inserted into the deepest
+ * object that exists, indented to match its siblings. With `keepExisting`, a
+ * member that is already there is left alone. Throws when the root or a step
+ * of the path is not an object, or a step appears twice in one object, since
+ * which duplicate a client honours is not knowable from here.
+ */
+export function upsertJsonc(text, path, value, keepExisting = false) {
+    const root = parseJsonc(text);
+    if (root.members === undefined)
+        throw new Error("it does not hold a JSON object");
+    const eol = text.includes("\r\n") ? "\r\n" : "\n";
+    const rootIndent = lineIndent(text, root.start);
+    const nested = root.members.find((member) => startsLine(text, member.keyStart));
+    const unit = (nested === undefined ? "" : lineIndent(text, nested.keyStart).slice(rootIndent.length)) ||
+        "  ";
+    // An object written on one line gets its new member on that line too.
+    const render = (data, indent, inline) => inline
+        ? JSON.stringify(data)
+        : JSON.stringify(data, null, unit).replaceAll("\n", `${eol}${indent}`);
+    let object = root;
+    for (const [depth, key] of path.entries()) {
+        const name = JSON.stringify(path.slice(0, depth + 1).join("."));
+        const matches = object.members.filter((member) => member.key === key);
+        if (matches.length > 1) {
+            throw new Error(`${name} appears more than once, so which one is read is ambiguous`);
+        }
+        const inline = !text.slice(object.start, object.end).includes("\n");
+        const found = matches[0];
+        if (found !== undefined && depth === path.length - 1) {
+            if (keepExisting)
+                return text;
+            const indent = lineIndent(text, found.keyStart);
+            return splice(text, found.value.start, found.value.end, render(value, indent, inline));
+        }
+        if (found !== undefined) {
+            if (found.value.members === undefined)
+                throw new Error(`${name} is not an object`);
+            object = found.value;
+            continue;
+        }
+        // Insert `"key": value`, wrapping it in whatever of the path is missing.
+        const data = path
+            .slice(depth + 1)
+            .reduceRight((inner, step) => ({ [step]: inner }), value);
+        const last = object.members.at(-1);
+        const objectIndent = lineIndent(text, object.start);
+        const indent = last !== undefined && startsLine(text, last.keyStart)
+            ? lineIndent(text, last.keyStart)
+            : `${objectIndent}${unit}`;
+        const member = `${JSON.stringify(key)}: ${render(data, indent, inline && last !== undefined)}`;
+        if (last === undefined) {
+            const close = object.end - 1;
+            if (text.slice(object.start + 1, close).trim() === "") {
+                return splice(text, object.start + 1, close, `${eol}${indent}${member}${eol}${objectIndent}`);
+            }
+            // Only comments inside: keep them, and put the member just above `}`.
+            if (startsLine(text, close)) {
+                const at = lineStart(text, close);
+                return splice(text, at, at, `${indent}${member}${eol}`);
+            }
+            return splice(text, close, close, `${eol}${indent}${member}${eol}${objectIndent}`);
+        }
+        // Append after the last member, keeping the object's trailing-comma style:
+        // with one, the new last member gets one too; without, the old last
+        // member gains the separating comma.
+        const comma = object.trailingComma;
+        const anchor = comma === undefined ? last.value.end : comma + 1;
+        const at = inline ? anchor : endOfTriviaLine(text, anchor);
+        const added = splice(text, at, at, `${inline ? " " : `${eol}${indent}`}${member}${comma === undefined ? "" : ","}`);
+        return comma === undefined ? splice(added, anchor, anchor, ",") : added;
+    }
+    // Only reachable with an empty path, which no caller passes.
+    throw new Error("nothing to set");
+}
+//# sourceMappingURL=jsonc.js.map

package/dist/jsonc.js.map

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

package/dist/output.d.ts

@@ -0,0 +1,28 @@
+export type Status = "pass" | "warn" | "fail";
+/** A readable report for this invocation, rather than JSON. */
+export declare function isHuman(args: readonly string[], stream?: {
+    isTTY?: boolean;
+}): boolean;
+export declare const paint: {
+    ok: (text: string) => string;
+    warn: (text: string) => string;
+    fail: (text: string) => string;
+    dim: (text: string) => string;
+    bold: (text: string) => string;
+};
+/** The coloured status symbol: ✓ ⚠ ✗, or [ok] [warn] [fail] where those would not render. */
+export declare function mark(status: Status): string;
+/**
+ * Rows as aligned columns, one line per row. Every column but the last is
+ * padded to its widest cell, so a two-column table is a key/value list.
+ */
+export declare function table(rows: readonly (readonly string[])[], options?: {
+    indent?: number;
+}): string;
+/**
+ * The one place a command decides between its JSON and its human report. The
+ * JSON branch is exactly what the CLI has always written, so a script cannot
+ * tell this function exists.
+ */
+export declare function printJsonOrHuman<T>(value: T, renderHuman: (value: T) => string, args: readonly string[]): void;
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAE9C,+DAA+D;AAC/D,wBAAgB,OAAO,CACrB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,MAAM,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAmB,GAC3C,OAAO,CAET;AAkBD,eAAO,MAAM,KAAK;eAHkC,MAAM;iBAAN,MAAM;iBAAN,MAAM;gBAAN,MAAM;iBAAN,MAAM;CASzD,CAAC;AAYF,6FAA6F;AAC7F,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQ3C;AAKD;;;GAGG;AACH,wBAAgB,KAAK,CACnB,IAAI,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,EACpC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAChC,MAAM,CAqBR;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,KAAK,EAAE,CAAC,EACR,WAAW,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,EACjC,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,IAAI,CAIN"}

package/dist/output.js

@@ -0,0 +1,77 @@
+// Copyright 2026 XAGI Labs Private Limited
+// SPDX-License-Identifier: Apache-2.0
+/** A readable report for this invocation, rather than JSON. */
+export function isHuman(args, stream = process.stdout) {
+    return !args.includes("--json") && stream.isTTY === true;
+}
+// https://no-color.org: a non-empty NO_COLOR turns colour off whatever else is
+// set. FORCE_COLOR follows Node's own reading ("0"/"false" off, anything else
+// on). Checked here rather than through `tty.WriteStream.hasColors()`, which
+// answers the same but prints a process warning when both are set.
+function colorEnabled() {
+    const { NO_COLOR, FORCE_COLOR, TERM } = process.env;
+    if (NO_COLOR !== undefined && NO_COLOR !== "")
+        return false;
+    if (FORCE_COLOR !== undefined)
+        return FORCE_COLOR !== "0" && FORCE_COLOR !== "false";
+    return process.stdout.isTTY === true && TERM !== "dumb";
+}
+// Read per call, not once at load, so a test can change the environment. An
+// empty string stays empty, so a blank table cell leaves no trailing codes.
+const sgr = (open, close) => (text) => text !== "" && colorEnabled() ? `\u001b[${open}m${text}\u001b[${close}m` : text;
+export const paint = {
+    ok: sgr(32, 39),
+    warn: sgr(33, 39),
+    fail: sgr(31, 39),
+    dim: sgr(2, 22),
+    bold: sgr(1, 22),
+};
+// The legacy Windows console renders ✓ ⚠ ✗ as boxes. Windows Terminal (which
+// sets WT_SESSION) and VS Code's terminal do not, so only the old one gets ASCII.
+function unicode() {
+    return (process.platform !== "win32" ||
+        process.env.WT_SESSION !== undefined ||
+        process.env.TERM_PROGRAM === "vscode");
+}
+/** The coloured status symbol: ✓ ⚠ ✗, or [ok] [warn] [fail] where those would not render. */
+export function mark(status) {
+    const [symbol, ascii, color] = status === "pass"
+        ? ["✓", "[ok]", paint.ok]
+        : status === "warn"
+            ? ["⚠", "[warn]", paint.warn]
+            : ["✗", "[fail]", paint.fail];
+    return color(unicode() ? symbol : ascii);
+}
+// Colour codes take no columns on screen, so alignment measures without them.
+const width = (text) => text.replace(/\u001b\[[0-9;]*m/g, "").length;
+/**
+ * Rows as aligned columns, one line per row. Every column but the last is
+ * padded to its widest cell, so a two-column table is a key/value list.
+ */
+export function table(rows, options = {}) {
+    const widths = [];
+    for (const row of rows) {
+        row.forEach((cell, column) => {
+            widths[column] = Math.max(widths[column] ?? 0, width(cell));
+        });
+    }
+    const indent = " ".repeat(options.indent ?? 0);
+    return rows
+        .map((row) => indent +
+        row
+            .map((cell, column) => column === row.length - 1
+            ? cell
+            : cell + " ".repeat((widths[column] ?? 0) - width(cell)))
+            .join("  ")
+            .trimEnd())
+        .join("\n");
+}
+/**
+ * The one place a command decides between its JSON and its human report. The
+ * JSON branch is exactly what the CLI has always written, so a script cannot
+ * tell this function exists.
+ */
+export function printJsonOrHuman(value, renderHuman, args) {
+    process.stdout.write(isHuman(args) ? `${renderHuman(value)}\n` : `${JSON.stringify(value, null, 2)}\n`);
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@melra/cli",
-  "version": "0.3.0-alpha.11",
+  "version": "0.3.0-alpha.12",
   "description": "MELRA autonomy kernel and command-line interface.",
   "license": "Apache-2.0",
   "repository": {
@@ -25,14 +25,14 @@
     "README.md"
   ],
   "dependencies": {
-    "@modelcontextprotocol/sdk": "1.30.0",
-    "@melra/browser-runtime": "0.3.0-alpha.11",
-    "@melra/computer-runtime": "0.3.0-alpha.11",
-    "@melra/policy-core": "0.3.0-alpha.11",
-    "@melra/runtime-core": "0.3.0-alpha.11",
-    "@melra/protocol": "0.3.0-alpha.11",
-    "@melra/storage-sqlite": "0.3.0-alpha.11",
-    "@melra/server": "0.3.0-alpha.11"
+    "@modelcontextprotocol/sdk": "1.32.1",
+    "@melra/browser-runtime": "0.3.0-alpha.12",
+    "@melra/computer-runtime": "0.3.0-alpha.12",
+    "@melra/policy-core": "0.3.0-alpha.12",
+    "@melra/runtime-core": "0.3.0-alpha.12",
+    "@melra/server": "0.3.0-alpha.12",
+    "@melra/protocol": "0.3.0-alpha.12",
+    "@melra/storage-sqlite": "0.3.0-alpha.12"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json && chmod +x dist/bin.js dist/index.js",
@@ -41,6 +41,6 @@
     "start": "tsx src/index.ts",
     "pack:check": "npm pack --dry-run",
     "test": "vitest run --testTimeout=20000",
-    "typecheck": "tsc -p tsconfig.json --noEmit"
+    "typecheck": "tsc -p tsconfig.test.json"
   }
 }