backpack-ontology 0.7.13 → 0.8.1

package/dist/cli/commands/open.js

@@ -0,0 +1,88 @@
+import * as path from "node:path";
+import { spawn } from "node:child_process";
+import { getGraphSummary } from "../../ops/graphs.js";
+import { getContext } from "../../ops/context.js";
+import { red, dim, green, yellow } from "../colors.js";
+const VIEWER_URL = process.env.BACKPACK_VIEWER_URL || "http://127.0.0.1:5173";
+async function syncViewerContext() {
+    const ctx = await getContext();
+    let switchName = null;
+    if (ctx.source === "local" && ctx.backpackPath) {
+        switchName = path.basename(ctx.backpackPath);
+    }
+    else if (ctx.source === "cloud") {
+        switchName = ctx.cloudContainer ? `__cloud__:${ctx.cloudContainer}` : "__cloud__";
+    }
+    if (!switchName)
+        return { ok: false, switchName: null, error: "no active context" };
+    try {
+        const res = await fetch(`${VIEWER_URL}/api/backpacks/switch`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ name: switchName }),
+        });
+        if (!res.ok)
+            return { ok: false, switchName, error: `viewer returned HTTP ${res.status}` };
+        return { ok: true, switchName };
+    }
+    catch (err) {
+        return { ok: false, switchName, error: err.message };
+    }
+}
+export async function runOpen(args) {
+    const name = args.positional[0];
+    if (!name) {
+        process.stderr.write(`bp open: graph name required.\nusage: bp open <name>\n`);
+        return 1;
+    }
+    try {
+        const summary = await getGraphSummary(name);
+        if (!summary) {
+            process.stderr.write(`${red("✗")} graph "${name}" not found in the current scope.\n`);
+            return 1;
+        }
+    }
+    catch (err) {
+        process.stderr.write(`${red("✗")} ${err.message}\n`);
+        return 1;
+    }
+    const sync = await syncViewerContext();
+    if (sync.ok) {
+        process.stdout.write(`${dim("·")} viewer switched to ${sync.switchName}\n`);
+    }
+    else if (sync.error?.includes("ECONNREFUSED") || sync.error?.includes("fetch failed")) {
+        process.stdout.write(`${yellow("!")} viewer doesn't appear to be running at ${VIEWER_URL} — opening anyway.\n`);
+        process.stdout.write(dim(`  start it with: npx backpack-viewer@latest\n`));
+    }
+    else if (sync.error) {
+        process.stdout.write(`${yellow("!")} couldn't sync viewer context (${sync.error}) — opening anyway.\n`);
+    }
+    const url = `${VIEWER_URL}/#${encodeURIComponent(name)}`;
+    process.stdout.write(`${green("→")} ${url}\n`);
+    let cmd;
+    let cmdArgs;
+    if (process.platform === "darwin") {
+        cmd = "open";
+        cmdArgs = [url];
+    }
+    else if (process.platform === "win32") {
+        cmd = "cmd";
+        cmdArgs = ["/c", "start", "", url];
+    }
+    else {
+        cmd = "xdg-open";
+        cmdArgs = [url];
+    }
+    try {
+        const child = spawn(cmd, cmdArgs, { detached: true, stdio: "ignore" });
+        child.on("error", () => {
+            process.stdout.write(dim("  (couldn't auto-launch — copy the URL above into your browser)\n"));
+        });
+        child.unref();
+    }
+    catch {
+        process.stdout.write(dim("  (couldn't auto-launch — copy the URL above into your browser)\n"));
+    }
+    return 0;
+}
+//# sourceMappingURL=open.js.map

package/dist/cli/commands/open.js.map

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

package/dist/cli/commands/search.d.ts

@@ -0,0 +1,3 @@
+import { ParsedArgs } from "../parser.js";
+export declare function runSearch(args: ParsedArgs): Promise<number>;
+//# sourceMappingURL=search.d.ts.map

package/dist/cli/commands/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAc,MAAM,cAAc,CAAC;AAItD,wBAAsB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAqDjE"}

package/dist/cli/commands/search.js

@@ -0,0 +1,59 @@
+import { flagString } from "../parser.js";
+import { searchGraphs } from "../../ops/graphs.js";
+import { resolveFormat, emitList } from "../output.js";
+import { dim, bold, red, yellow } from "../colors.js";
+export async function runSearch(args) {
+    const query = args.positional.join(" ").trim();
+    if (!query) {
+        process.stderr.write(`bp search: query required.\nusage: bp search <query>\n`);
+        return 1;
+    }
+    const maxGraphs = parseInt(flagString(args, "max-graphs") ?? "", 10);
+    try {
+        const result = await searchGraphs(query, {
+            maxGraphs: Number.isFinite(maxGraphs) && maxGraphs > 0 ? maxGraphs : undefined,
+        });
+        const fmt = resolveFormat(args.flags);
+        if (fmt === "json" || fmt === "yaml") {
+            emitList({
+                rows: result.hits,
+                pluralLabel: "hits",
+                cols: [
+                    { header: "GRAPH", get: (r) => r.graphName },
+                    { header: "TYPE", get: (r) => r.nodeType },
+                    { header: "LABEL", get: (r) => r.label },
+                    { header: "ID", get: (r) => r.nodeId },
+                ],
+            }, { format: fmt });
+            return 0;
+        }
+        emitList({
+            rows: result.hits,
+            pluralLabel: "hits",
+            empty: dim(`no matches for "${query}".`),
+            cols: [
+                { header: "GRAPH", get: (r) => r.graphName, max: 32 },
+                { header: "TYPE", get: (r) => r.nodeType, max: 20 },
+                { header: "LABEL", get: (r) => r.label, max: 60 },
+                { header: "ID", get: (r) => r.nodeId, dim: true, wide: true },
+            ],
+        }, { format: fmt });
+        if (fmt === "names")
+            return 0;
+        const notes = [];
+        if (result.hits.length > 0)
+            notes.push(`${result.hits.length} match${result.hits.length === 1 ? "" : "es"} for "${bold(query)}"`);
+        if (result.graphsSkipped > 0)
+            notes.push(yellow(`skipped ${result.graphsSkipped} encrypted graph${result.graphsSkipped === 1 ? "" : "s"}`));
+        if (result.truncated)
+            notes.push(yellow(`only scanned the first ${result.graphsScanned} of ${result.graphsInScope} graphs — pass --max-graphs to widen`));
+        if (notes.length > 0)
+            process.stdout.write("\n  " + dim(notes.join(" · ")) + "\n");
+        return 0;
+    }
+    catch (err) {
+        process.stderr.write(`${red("✗")} ${err.message}\n`);
+        return 1;
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/cli/commands/search.js.map

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

package/dist/cli/commands/show.d.ts

@@ -0,0 +1,3 @@
+import { ParsedArgs } from "../parser.js";
+export declare function runShow(args: ParsedArgs): Promise<number>;
+//# sourceMappingURL=show.d.ts.map

package/dist/cli/commands/show.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/show.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAI1C,wBAAsB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAqE/D"}

package/dist/cli/commands/show.js

@@ -0,0 +1,74 @@
+import { getGraph, getGraphSummary } from "../../ops/graphs.js";
+import { resolveFormat, emitOne } from "../output.js";
+import { bold, dim, red, yellow, cyan } from "../colors.js";
+export async function runShow(args) {
+    const name = args.positional[0];
+    if (!name) {
+        process.stderr.write(`bp show: graph name required.\nusage: bp show <name>\n`);
+        return 1;
+    }
+    let summary;
+    try {
+        summary = await getGraphSummary(name);
+    }
+    catch (err) {
+        process.stderr.write(`${red("✗")} ${err.message}\n`);
+        return 1;
+    }
+    if (!summary) {
+        process.stderr.write(`${red("✗")} graph "${name}" not found in the current scope.\n`);
+        return 1;
+    }
+    const fmt = resolveFormat(args.flags);
+    if (fmt !== "human") {
+        let data;
+        if (!summary.encrypted) {
+            const r = await getGraph(name).catch(() => null);
+            if (r && r.kind === "ok")
+                data = r.data;
+        }
+        emitOne({ ...summary, data }, { format: fmt });
+        return 0;
+    }
+    process.stdout.write(`${bold(summary.name)}${summary.encrypted ? "  " + yellow("[encrypted]") : ""}${summary.origin === "cloud" ? "  " + dim("(cloud)") : ""}\n`);
+    if (summary.description)
+        process.stdout.write(`  ${summary.description}\n`);
+    process.stdout.write(`  ${cyan(String(summary.nodeCount))} nodes, ${cyan(String(summary.edgeCount))} edges\n`);
+    if (summary.tags && summary.tags.length > 0) {
+        process.stdout.write(`  ${dim("tags:")} ${summary.tags.join(", ")}\n`);
+    }
+    if (summary.sourceBackpack) {
+        process.stdout.write(`  ${dim("container:")} ${summary.sourceBackpack}\n`);
+    }
+    if (summary.encrypted) {
+        process.stdout.write(`\n  ${yellow("encrypted graph — open in your local viewer to inspect contents.")}\n`);
+        return 0;
+    }
+    const HISTOGRAM_NODE_LIMIT = 50000;
+    try {
+        const r = await getGraph(name);
+        if (r.kind === "ok" && Array.isArray(r.data.nodes)) {
+            if (r.data.nodes.length > HISTOGRAM_NODE_LIMIT) {
+                process.stdout.write(dim(`\n  (graph has ${r.data.nodes.length} nodes — type histogram skipped; use \`bp cat ${name} | jq '.nodes | group_by(.type)'\`)\n`));
+            }
+            else {
+                const types = new Map();
+                for (const n of r.data.nodes)
+                    types.set(n.type, (types.get(n.type) ?? 0) + 1);
+                if (types.size > 0) {
+                    process.stdout.write("\n  " + bold("types") + "\n");
+                    const sorted = [...types.entries()].sort((a, b) => b[1] - a[1]);
+                    for (const [t, c] of sorted.slice(0, 12)) {
+                        process.stdout.write(`    ${cyan(String(c).padStart(4))}  ${t}\n`);
+                    }
+                    if (sorted.length > 12)
+                        process.stdout.write(dim(`    … ${sorted.length - 12} more\n`));
+                }
+            }
+        }
+    }
+    catch {
+    }
+    return 0;
+}
+//# sourceMappingURL=show.js.map

package/dist/cli/commands/show.js.map

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

package/dist/cli/commands/version.d.ts

@@ -0,0 +1,2 @@
+export declare function runVersion(): Promise<number>;
+//# sourceMappingURL=version.d.ts.map

package/dist/cli/commands/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/version.ts"],"names":[],"mappings":"AAGA,wBAAsB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAalD"}

package/dist/cli/commands/version.js

@@ -0,0 +1,16 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+export async function runVersion() {
+    const dir = path.dirname(fileURLToPath(import.meta.url));
+    const pkgPath = path.join(dir, "..", "..", "..", "package.json");
+    let version = "unknown";
+    try {
+        const raw = await fs.readFile(pkgPath, "utf8");
+        version = JSON.parse(raw).version ?? "unknown";
+    }
+    catch { }
+    process.stdout.write(`bp ${version}  (node ${process.version})\n`);
+    return 0;
+}
+//# sourceMappingURL=version.js.map

package/dist/cli/commands/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../src/cli/commands/version.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,MAAM,CAAC,KAAK,UAAU,UAAU;IAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;IACjE,IAAI,OAAO,GAAG,SAAS,CAAC;IACxB,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC/C,OAAO,GAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAEvB,CAAC,OAAO,IAAI,SAAS,CAAC;IAC5B,CAAC;IACD,MAAM,CAAC,CAAC,CAAC;IACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,OAAO,WAAW,OAAO,CAAC,OAAO,KAAK,CAAC,CAAC;IACnE,OAAO,CAAC,CAAC;AACb,CAAC"}

package/dist/cli/help.d.ts

@@ -0,0 +1,3 @@
+export declare function printHint(): void;
+export declare function printFullHelp(): void;
+//# sourceMappingURL=help.d.ts.map

package/dist/cli/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AACA,wBAAgB,SAAS,IAAI,IAAI,CAahC;AA8FD,wBAAgB,aAAa,IAAI,IAAI,CAcpC"}

package/dist/cli/help.js

@@ -0,0 +1,118 @@
+import { bold, dim, cyan } from "./colors.js";
+export function printHint() {
+    const lines = [
+        bold("bp") + dim(" — Backpack CLI"),
+        "",
+        `  ${cyan("bp ls")}                    list graphs in the current backpack`,
+        `  ${cyan("bp cat")} <name>            print a graph as JSON (pipe to jq)`,
+        `  ${cyan("bp show")} <name>           human-friendly summary`,
+        `  ${cyan("bp where")}                 show current scope`,
+        `  ${cyan("bp doctor")}                check auth + connectivity`,
+        "",
+        dim(`  try \`bp help\` for everything`),
+    ];
+    process.stdout.write(lines.join("\n") + "\n");
+}
+const FULL_HELP_SECTIONS = [
+    {
+        title: "Common",
+        commands: [
+            ["bp ls [resource]", "list graphs / containers / kbs in the current scope"],
+            ["bp cat <name>", "print a graph as JSON (pipe to jq, sed, etc.)"],
+            ["bp show <name>", "human-friendly summary + type histogram"],
+            ["bp open <name>", "open the graph in the local viewer"],
+            ["bp search <query>", "full-text search across graph properties"],
+            ["bp rm <name>", "shortcut for `bp graphs delete`"],
+            ["bp mv <old> <new>", "shortcut for `bp graphs rename`"],
+        ],
+    },
+    {
+        title: "Auth & scope",
+        commands: [
+            ["bp login", "sign in to backpack-app via the browser"],
+            ["bp logout", "sign out everywhere"],
+            ["bp whoami", "show signed-in identity"],
+            ["bp where", "show current scope (backpack / container / identity)"],
+            ["bp use <name>", "switch context (local backpack or cloud container)"],
+            ["bp use", "list available contexts"],
+        ],
+    },
+    {
+        title: "Graphs",
+        commands: [
+            ["bp graphs list", "list graphs in the current scope"],
+            ["bp graphs get <name>", "print as JSON (pipeable)"],
+            ["bp graphs describe <name>", "human summary"],
+            ["bp graphs create <name> [--description=…]", "new empty graph"],
+            ["bp graphs create <name> --from-file <f>", "create from a JSON file"],
+            ["bp graphs apply -f <file>", "upsert from a JSON file"],
+            ["bp graphs edit <name>", "open in $EDITOR, save back atomically"],
+            ["bp graphs rename <old> <new>", "rename in place"],
+            ["bp graphs delete <name>", "delete with confirm (or -y)"],
+            ["bp graphs move <name> --to <container>", "relocate between cloud containers"],
+        ],
+    },
+    {
+        title: "KB documents",
+        commands: [
+            ["bp kbs list", "list KB docs in the current scope"],
+            ["bp kbs get <id>", "print body (pipeable)"],
+            ["bp kbs create -f <file.md>", "create from a markdown file"],
+            ["bp kbs create --title=… --content=…", "create from flags"],
+            ["bp kbs edit <id>", "edit body in $EDITOR"],
+            ["bp kbs delete <id>", "delete with confirm"],
+            ["bp kbs move <id> --to <container>", "relocate between cloud containers"],
+        ],
+    },
+    {
+        title: "Cloud containers",
+        commands: [
+            ["bp containers list", "list your cloud sync_backpacks"],
+            ["bp containers create <name> [--color=#xxx] [--tags=a,b]", "new cloud container"],
+            ["bp containers rename <old> <new>", "rename / recolor / retag"],
+            ["bp containers delete <name>", "delete (refuses if non-empty)"],
+        ],
+    },
+    {
+        title: "Project setup",
+        commands: [
+            ["bp init [path]", "initialize a new local backpack root in CWD (or path)"],
+            ["bp completion <shell>", "print shell-completion script (bash | zsh | fish)"],
+        ],
+    },
+    {
+        title: "Diagnostics",
+        commands: [
+            ["bp doctor", "auth, connectivity, version skew checks"],
+            ["bp version", "print version"],
+        ],
+    },
+];
+const GLOBAL_FLAGS = [
+    ["--json", "machine-readable JSON (the stable contract)"],
+    ["--yaml", "machine-readable YAML"],
+    ["--names", "names only, one per line"],
+    ["--wide", "show extra columns"],
+    ["--no-color", "disable ANSI colors"],
+    ["-y, --yes", "skip confirmation on destructive ops"],
+    ["-h, --help", "help for any command"],
+];
+export function printFullHelp() {
+    const lines = [bold("bp") + dim(" — the Backpack CLI"), ""];
+    for (const section of FULL_HELP_SECTIONS) {
+        lines.push(bold(section.title));
+        for (const [cmd, desc] of section.commands) {
+            lines.push(`  ${padRight(cmd, 40)}  ${dim(desc)}`);
+        }
+        lines.push("");
+    }
+    lines.push(bold("Global flags"));
+    for (const [f, d] of GLOBAL_FLAGS) {
+        lines.push(`  ${padRight(f, 40)}  ${dim(d)}`);
+    }
+    process.stdout.write(lines.join("\n") + "\n");
+}
+function padRight(s, width) {
+    return s.length >= width ? s : s + " ".repeat(width - s.length);
+}
+//# sourceMappingURL=help.js.map

package/dist/cli/help.js.map

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

package/dist/cli/output.d.ts

@@ -0,0 +1,23 @@
+export type OutputFormat = "human" | "json" | "yaml" | "names" | "wide";
+export interface Column<T> {
+    header: string;
+    get: (row: T) => string;
+    max?: number;
+    dim?: boolean;
+    wide?: boolean;
+    numeric?: boolean;
+}
+export interface ListOptions<T> {
+    rows: T[];
+    cols: Column<T>[];
+    nameKey?: (row: T) => string;
+    pluralLabel: string;
+    empty?: string;
+}
+export interface FormatChoice {
+    format: OutputFormat;
+}
+export declare function emitList<T>(opts: ListOptions<T>, choice: FormatChoice): void;
+export declare function emitOne(value: unknown, choice: FormatChoice): void;
+export declare function resolveFormat(flags: Record<string, string | boolean>): OutputFormat;
+//# sourceMappingURL=output.d.ts.map

package/dist/cli/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AACxE,MAAM,WAAW,MAAM,CAAC,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AACD,MAAM,WAAW,WAAW,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AACD,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,YAAY,CAAC;CACxB;AACD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA2B5E;AACD,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAuBlE;AA+HD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,YAAY,CAUnF"}

package/dist/cli/output.js

@@ -0,0 +1,189 @@
+import { dim, bold, gray, visibleWidth } from "./colors.js";
+export function emitList(opts, choice) {
+    const { rows, cols, pluralLabel, nameKey, empty } = opts;
+    switch (choice.format) {
+        case "json":
+            process.stdout.write(JSON.stringify({ [pluralLabel]: rows }, null, 2) + "\n");
+            return;
+        case "yaml":
+            process.stdout.write(toYaml({ [pluralLabel]: rows }) + "\n");
+            return;
+        case "names": {
+            const getName = nameKey ?? ((r) => stripAnsi(cols[0].get(r)));
+            for (const r of rows)
+                process.stdout.write(getName(r) + "\n");
+            return;
+        }
+        case "wide":
+            process.stdout.write(renderTable(rows, cols, true) + "\n");
+            return;
+        case "human":
+        default:
+            if (rows.length === 0 && empty) {
+                process.stdout.write(dim(empty) + "\n");
+                return;
+            }
+            process.stdout.write(renderTable(rows, cols, false) + "\n");
+            return;
+    }
+}
+export function emitOne(value, choice) {
+    switch (choice.format) {
+        case "json":
+        case "wide":
+        case "human":
+            if (choice.format === "human") {
+                process.stdout.write(humanizeOne(value) + "\n");
+            }
+            else {
+                process.stdout.write(JSON.stringify(value, null, 2) + "\n");
+            }
+            return;
+        case "yaml":
+            process.stdout.write(toYaml(value) + "\n");
+            return;
+        case "names":
+            if (value && typeof value === "object" && "name" in value) {
+                process.stdout.write(String(value.name) + "\n");
+            }
+            return;
+    }
+}
+function renderTable(rows, cols, wide) {
+    const visible = cols.filter((c) => wide || !c.wide);
+    if (visible.length === 0)
+        return "";
+    const termWidth = process.stdout.columns ?? 100;
+    const widths = visible.map((c) => {
+        const headerW = visibleWidth(c.header);
+        const maxRow = rows.reduce((m, r) => Math.max(m, visibleWidth(c.get(r))), 0);
+        const desired = Math.max(headerW, maxRow);
+        if (c.numeric)
+            return desired;
+        return c.max ? Math.min(desired, c.max) : desired;
+    });
+    const totalGap = (visible.length - 1) * 2;
+    const totalContent = widths.reduce((a, b) => a + b, 0);
+    if (totalContent + totalGap > termWidth - 2) {
+        let budget = termWidth - 2 - totalGap;
+        if (budget < visible.length * 6) {
+            return rows.map((r) => visible.map((c, i) => `${dim(visible[i].header)}: ${c.get(r)}`).join("\n")).join("\n\n");
+        }
+        while (widths.reduce((a, b) => a + b, 0) > budget) {
+            const idx = widths.indexOf(Math.max(...widths));
+            widths[idx]--;
+            if (widths[idx] < 4)
+                break;
+        }
+    }
+    const lines = [];
+    lines.push(visible.map((c, i) => padRight(bold(c.header), widths[i])).join("  "));
+    for (const r of rows) {
+        lines.push(visible.map((c, i) => {
+            let cell = c.get(r);
+            const w = widths[i];
+            if (visibleWidth(cell) > w)
+                cell = truncate(cell, w);
+            cell = padRight(cell, w);
+            return c.dim ? dim(cell) : cell;
+        }).join("  "));
+    }
+    return lines.join("\n");
+}
+function humanizeOne(value) {
+    if (value === null || value === undefined)
+        return dim("(empty)");
+    if (typeof value !== "object")
+        return String(value);
+    const lines = [];
+    for (const [k, v] of Object.entries(value)) {
+        if (v === undefined)
+            continue;
+        const formatted = typeof v === "object" && v !== null
+            ? JSON.stringify(v, null, 2).split("\n").map((l, i) => i === 0 ? l : "  " + l).join("\n")
+            : String(v);
+        lines.push(`${gray(k + ":")} ${formatted}`);
+    }
+    return lines.join("\n");
+}
+function padRight(s, width) {
+    const w = visibleWidth(s);
+    if (w >= width)
+        return s;
+    return s + " ".repeat(width - w);
+}
+function truncate(s, width) {
+    if (visibleWidth(s) <= width)
+        return s;
+    const plain = stripAnsi(s);
+    if (plain.length <= width)
+        return s;
+    return plain.slice(0, Math.max(0, width - 1)) + "…";
+}
+function stripAnsi(s) {
+    return s.replace(/\x1b\[[0-9;]*m/g, "");
+}
+function toYaml(v, indent = 0) {
+    const pad = "  ".repeat(indent);
+    if (v === null || v === undefined)
+        return "null";
+    if (typeof v === "string")
+        return yamlScalar(v);
+    if (typeof v === "number" || typeof v === "boolean")
+        return String(v);
+    if (Array.isArray(v)) {
+        if (v.length === 0)
+            return "[]";
+        return v.map((item) => {
+            if (item !== null && typeof item === "object") {
+                const inner = toYaml(item, indent + 1);
+                const lines = inner.split("\n");
+                const firstNonEmpty = lines.findIndex((l) => l.trim().length > 0);
+                if (firstNonEmpty === -1)
+                    return `${pad}- {}`;
+                const first = lines[firstNonEmpty].replace(/^\s+/, "");
+                const rest = lines.slice(firstNonEmpty + 1).join("\n");
+                return rest ? `${pad}- ${first}\n${rest}` : `${pad}- ${first}`;
+            }
+            return `${pad}- ${toYaml(item, indent + 1)}`;
+        }).join("\n");
+    }
+    if (typeof v === "object") {
+        const entries = Object.entries(v).filter(([, val]) => val !== undefined);
+        if (entries.length === 0)
+            return "{}";
+        return entries.map(([k, val]) => {
+            if (val !== null && typeof val === "object") {
+                const inner = toYaml(val, indent + 1);
+                if (Array.isArray(val) && val.length === 0)
+                    return `${pad}${k}: []`;
+                if (!Array.isArray(val) && Object.keys(val).length === 0)
+                    return `${pad}${k}: {}`;
+                return `${pad}${k}:\n${inner}`;
+            }
+            return `${pad}${k}: ${toYaml(val, indent + 1)}`;
+        }).join("\n");
+    }
+    return String(v);
+}
+function yamlScalar(s) {
+    const hasControl = /[\x00-\x1f]/.test(s);
+    if (hasControl ||
+        s === "" ||
+        /[:#\[\]{},&*!|>'"%@`]|^\s|\s$|^-|^\?|^(null|true|false|yes|no)$|^-?\d/.test(s)) {
+        return JSON.stringify(s);
+    }
+    return s;
+}
+export function resolveFormat(flags) {
+    if (flags.json)
+        return "json";
+    if (flags.yaml)
+        return "yaml";
+    if (flags.names)
+        return "names";
+    if (flags.wide)
+        return "wide";
+    return "human";
+}
+//# sourceMappingURL=output.js.map