@navbook/cli 0.1.0

package/dist/cli/main.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+/**
+ * `nav` entry point.
+ */
+import { realpathSync } from "node:fs";
+import { CommanderError } from "commander";
+import { makeContext } from "./context.js";
+import { NavError } from "./errors.js";
+import { buildProgram } from "./program.js";
+/** Run the CLI and return its exit code. Never throws for expected failures. */
+export function run(opts = {}) {
+    const argv = opts.argv ?? process.argv.slice(2);
+    const stdout = opts.stdout ?? process.stdout;
+    const stderr = opts.stderr ?? process.stderr;
+    let ctx = null;
+    const getCtx = () => {
+        ctx ??= makeContext({ cwd: opts.cwd, env: opts.env, stdout, stderr });
+        return ctx;
+    };
+    const program = buildProgram(getCtx);
+    program.exitOverride();
+    program.configureOutput({
+        writeOut: (text) => stdout.write(text),
+        writeErr: (text) => stderr.write(text),
+    });
+    try {
+        program.parse(argv, { from: "user" });
+        return 0;
+    }
+    catch (error) {
+        return report(error, stderr);
+    }
+}
+function report(error, stderr) {
+    if (error instanceof CommanderError) {
+        // Commander already wrote help or the version string.
+        if (error.code === "commander.helpDisplayed" || error.code === "commander.version")
+            return 0;
+        if (error.code === "commander.help")
+            return 0;
+        return error.exitCode === 0 ? 0 : 1;
+    }
+    if (error instanceof NavError) {
+        stderr.write(`nav: ${error.message}\n`);
+        for (const line of error.details)
+            stderr.write(`${line}\n`);
+        return error.exitCode;
+    }
+    stderr.write(`nav: ${error instanceof Error ? error.message : String(error)}\n`);
+    return 1;
+}
+/**
+ * A closed pipe is a normal way for a command to end — `nav issue list | head`
+ * closes stdout as soon as it has enough. Without this, node turns that into an
+ * unhandled EPIPE and a stack trace.
+ */
+function exitQuietlyOnClosedPipe(stream) {
+    stream.on("error", (error) => {
+        if (error.code === "EPIPE")
+            process.exit(0);
+        throw error;
+    });
+}
+/**
+ * True when this file is the program being run.
+ *
+ * The paths are resolved through symlinks first: npm installs the binary as a
+ * link in `node_modules/.bin`, so `process.argv[1]` is the link while
+ * `import.meta.filename` is its target. Comparing them raw makes the installed
+ * CLI silently do nothing.
+ */
+function invokedDirectly() {
+    const entry = process.argv[1];
+    if (entry === undefined)
+        return false;
+    try {
+        return realpathSync(entry) === realpathSync(import.meta.filename);
+    }
+    catch {
+        return false;
+    }
+}
+if (invokedDirectly()) {
+    exitQuietlyOnClosedPipe(process.stdout);
+    exitQuietlyOnClosedPipe(process.stderr);
+    process.exitCode = run();
+}
+//# sourceMappingURL=main.js.map

package/dist/cli/main.js.map

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

package/dist/cli/program.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Command tree — spec 04 §4.3: noun-verb, with one verb vocabulary shared by
+ * both entity kinds, plus root-level utilities.
+ */
+import { Command, Option } from "commander";
+import type { EntityKind } from "../core/tree.ts";
+import { type CloseOptions, type ExtraColumn } from "./commands/entity.ts";
+import type { Ctx } from "./context.ts";
+export declare const VERSION = "0.1.0";
+export declare function buildProgram(getCtx: () => Ctx): Command;
+export interface SharedVerbOptions {
+    extraColumns: ExtraColumn[];
+    /** Extra options the noun's `list` accepts, e.g. `--all-refs` for PRs. */
+    configureList?: (command: Command) => void;
+    /** Listing implementation, when the noun needs more than the shared one. */
+    runList?: (ctx: Ctx, terms: string[], options: Record<string, unknown>) => void;
+    /** Close implementation, when the noun needs more than the shared one. */
+    runClose?: (ctx: Ctx, id: string, options: CloseOptions) => void;
+}
+/** Register the verbs both nouns share, so their behavior can never drift. */
+export declare function addSharedVerbs(parent: Command, kind: EntityKind, getCtx: () => Ctx, shared: SharedVerbOptions): void;
+export declare function collect(value: string, previous: string[]): string[];
+export { Option };

package/dist/cli/program.js

@@ -0,0 +1,204 @@
+/**
+ * Command tree — spec 04 §4.3: noun-verb, with one verb vocabulary shared by
+ * both entity kinds, plus root-level utilities.
+ */
+import { Command, Option } from "commander";
+import { cmdComplete } from "./commands/complete.js";
+import { cmdDoctor } from "./commands/doctor.js";
+import { cmdClose, cmdComment, cmdEdit, cmdList, cmdReopen, cmdShow, } from "./commands/entity.js";
+import { cmdId, cmdInit } from "./commands/init.js";
+import { cmdInstall, cmdUninstall } from "./commands/install.js";
+import { cmdIssueOpen } from "./commands/issue.js";
+import { cmdPrClose, cmdPrList, cmdPrMerge, cmdPrOpen, cmdPrReview, cmdPrUpdate, } from "./commands/pr.js";
+export const VERSION = "0.1.0";
+const QUERY_HELP = `Query terms AND together. Terms:
+  status:open|closed|merged   entity status (path); 'merged' is PR-only
+  label:L                     L is among the entity's labels (repeatable, ANDs)
+  assignee:EMAIL              assignee address, or a fragment of its domain
+  author:EMAIL                author address, same matching
+  milestone:M                 exact milestone
+  WORD or "some phrase"       case-insensitive substring of the title,
+                              description, or any comment body
+Same-key terms OR for single-valued fields (status, author, milestone) and AND
+for multi-valued ones (label, assignee). The default query is status:open.`;
+/** Help for `--commit`, naming the subject the verb commits under (spec 03 §3.2). */
+function commitHelp(kind) {
+    return `wrap the change in a 'docs${kind ? `(${kind})` : ""}:' commit`;
+}
+export function buildProgram(getCtx) {
+    const program = new Command();
+    program
+        .name("nav")
+        .description("Git-native issue and pull-request tracking, stored as files in your repository")
+        .version(VERSION, "-V, --version")
+        .showHelpAfterError()
+        .enablePositionalOptions();
+    program
+        .command("init")
+        .description("create the .navbook/ skeleton at the repository root")
+        .option("--commit", commitHelp())
+        .action((opts) => cmdInit(getCtx(), opts));
+    program
+        .command("id")
+        .description("mint and print a fresh Navbook ID")
+        .option("-n, --count <n>", "how many IDs to print", (value) => Number.parseInt(value, 10), 1)
+        .action((opts) => cmdId(getCtx(), opts));
+    program
+        .command("doctor")
+        .description("check the tree against the specification")
+        .option("--staged", "check only what is staged in the index (used by the pre-commit hook)")
+        .option("--fix", "apply the mechanical repairs offered by the diagnostics")
+        .option("--json", "one JSON object per diagnostic, newline-delimited")
+        .action((opts) => cmdDoctor(getCtx(), opts));
+    program
+        .command("install")
+        .description("set up the git alias, merge config, pre-commit hook and completions")
+        .addOption(new Option("--alias [name]", "git alias name (default: nav)"))
+        .option("--hooks", "install the pre-commit hook")
+        .addOption(new Option("--completions [shell]", "bash, zsh or fish (default: $SHELL)"))
+        .option("--merge-config", "set merge.directoryRenames=true in this repository")
+        .option("-y, --yes", "do not ask for confirmation")
+        .action((opts) => cmdInstall(getCtx(), opts));
+    program
+        .command("uninstall")
+        .description("remove what nav install set up")
+        .addOption(new Option("--alias [name]", "git alias name (default: nav)"))
+        .option("--hooks", "remove the pre-commit hook block")
+        .addOption(new Option("--completions [shell]", "bash, zsh or fish (default: $SHELL)"))
+        .option("--merge-config", "unset merge.directoryRenames")
+        .option("-y, --yes", "do not ask for confirmation")
+        .action((opts) => cmdUninstall(getCtx(), opts));
+    program
+        .command("__complete", { hidden: true })
+        .description("internal: print completion candidates for the words typed so far")
+        .argument("[words...]")
+        .action((words) => cmdComplete(getCtx(), words));
+    program.addCommand(buildIssueCommand(getCtx));
+    program.addCommand(buildPrCommand(getCtx));
+    return program;
+}
+function buildPrCommand(getCtx) {
+    const pr = new Command("pr").description("work with pull requests");
+    pr.command("open")
+        .description("open a pull request from the current branch")
+        .option("--target <branch>", "branch to merge into (default: the repository's default branch)")
+        .option("--title <text>", "one-line summary (default: the last commit's subject)")
+        .option("-m, --message <text>", "description text; without it $EDITOR is opened")
+        .option("--draft", "not yet requesting review")
+        .option("--label <label>", "add a label (repeatable)", collect, [])
+        .option("--assignee <email>", "assign to a person (repeatable)", collect, [])
+        .option("--milestone <name>", "milestone")
+        .option("--commit", commitHelp("pr"))
+        .action((opts) => cmdPrOpen(getCtx(), opts));
+    pr.command("update")
+        .argument("<id>", "ID or unambiguous prefix")
+        .description("append a revision pinning the current HEAD")
+        .option("--commit", commitHelp("pr"))
+        .action((id, opts) => cmdPrUpdate(getCtx(), id, opts));
+    pr.command("review")
+        .argument("<id>", "ID or unambiguous prefix")
+        .description("review a pull request, bound to a specific revision")
+        .option("--approve", "record an approving verdict")
+        .option("--request-changes", "record a request-changes verdict")
+        .option("-m, --message <text>", "review text; without it $EDITOR is opened")
+        .option("--revision <sha>", "bind to this revision instead of the latest")
+        .option("--file <path>", "anchor the comment to a file")
+        .option("--line <n|start-end>", "anchor the comment to a line or range")
+        .option("--commit", commitHelp("pr"))
+        .action((id, opts) => cmdPrReview(getCtx(), id, opts));
+    pr.command("merge")
+        .argument("[id]", "ID or unambiguous prefix")
+        .description("merge a pull request into the checked-out target branch")
+        .option("--no-ff", "always create a merge commit")
+        .option("--continue", "finish a merge that stopped for conflict resolution")
+        // Commander models `--no-ff` as the negation of an implicit `--ff`.
+        .action((id, opts) => cmdPrMerge(getCtx(), id, { ...opts, noFf: opts.ff === false }));
+    addSharedVerbs(pr, "pr", getCtx, {
+        extraColumns: [{ header: "target", value: (entity) => stringOf(entity, "target") }],
+        runClose: (ctx, id, options) => cmdPrClose(ctx, id, options),
+        configureList: (command) => {
+            command.option("--all-refs", "scan all local and fetched remote branches, not just this one");
+        },
+        runList: (ctx, terms, options) => cmdPrList(ctx, terms, options),
+    });
+    return pr;
+}
+function stringOf(entity, key) {
+    const value = entity.fm[key];
+    return typeof value === "string" ? value : "";
+}
+function buildIssueCommand(getCtx) {
+    const issue = new Command("issue").description("work with issues");
+    issue
+        .command("open")
+        .argument("<title>", "one-line summary")
+        .description("file a new issue")
+        .option("-m, --message <text>", "description text; without it $EDITOR is opened")
+        .option("--label <label>", "add a label (repeatable)", collect, [])
+        .option("--assignee <email>", "assign to a person (repeatable)", collect, [])
+        .option("--milestone <name>", "milestone")
+        .option("--commit", commitHelp("issue"))
+        .action((title, opts) => cmdIssueOpen(getCtx(), title, opts));
+    addSharedVerbs(issue, "issue", getCtx, { extraColumns: [] });
+    return issue;
+}
+/** Register the verbs both nouns share, so their behavior can never drift. */
+export function addSharedVerbs(parent, kind, getCtx, shared) {
+    const noun = kind === "issue" ? "issue" : "pull request";
+    const { extraColumns } = shared;
+    const list = parent
+        .command("list")
+        .argument("[query...]", "query terms; default status:open")
+        .description(`list ${kind === "issue" ? "issues" : "pull requests"} matching a query`)
+        .addHelpText("after", `\n${QUERY_HELP}`)
+        .option("--json", "one JSON object per entity, newline-delimited");
+    shared.configureList?.(list);
+    list.action((terms, opts) => shared.runList
+        ? shared.runList(getCtx(), terms, { ...opts, extraColumns })
+        : cmdList(getCtx(), kind, terms, { ...opts, extraColumns }));
+    parent
+        .command("show")
+        .argument("<id>", "ID or unambiguous prefix")
+        .description(`render one ${noun} and its comments`)
+        .option("--json", "emit a single JSON object including comments")
+        .action((id, opts) => cmdShow(getCtx(), kind, id, opts));
+    parent
+        .command("edit")
+        .argument("<id>", "ID or unambiguous prefix")
+        .description(`open the ${noun}'s file in $EDITOR`)
+        .option("--commit", commitHelp(kind))
+        .action((id, opts) => cmdEdit(getCtx(), kind, id, opts));
+    parent
+        .command("comment")
+        .argument("<id>", "ID or unambiguous prefix")
+        .description(`add a comment to a ${noun}`)
+        .option("-m, --message <text>", "comment text; without it $EDITOR is opened")
+        .option("--reply-to <comment-id>", "comment this one replies to")
+        .option("--commit", commitHelp(kind))
+        .action((id, opts) => cmdComment(getCtx(), kind, id, opts));
+    parent
+        .command("close")
+        .argument("<id>", "ID or unambiguous prefix")
+        .description(`move the ${noun} to closed/`)
+        .option("--resolution <value>", "why it was closed, e.g. fixed, wontfix, duplicate")
+        .option("--duplicate-of <id>", "the entity this duplicates (implies duplicate)")
+        .option("--commit", commitHelp(kind))
+        .action((id, opts) => {
+        const options = { ...opts, duplicateOf: opts.duplicateOf };
+        if (shared.runClose)
+            shared.runClose(getCtx(), id, options);
+        else
+            cmdClose(getCtx(), kind, id, options);
+    });
+    parent
+        .command("reopen")
+        .argument("<id>", "ID or unambiguous prefix")
+        .description(`move the ${noun} back to open/ and clear its resolution`)
+        .option("--commit", commitHelp(kind))
+        .action((id, opts) => cmdReopen(getCtx(), kind, id, opts));
+}
+export function collect(value, previous) {
+    return [...previous, value];
+}
+export { Option };
+//# sourceMappingURL=program.js.map

package/dist/cli/program.js.map

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

package/dist/cli/prompt.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Confirmation for commands that change files or configuration.
+ *
+ * Following `apt`: print the exact actions first, then ask. `--yes` skips the
+ * question but never the printing, so a scripted run still leaves a record of
+ * what it did.
+ */
+import type { Ctx } from "./context.ts";
+export interface Action {
+    /** One line describing what will happen, e.g. the exact command to be run. */
+    description: string;
+    perform: () => void;
+}
+export interface ConfirmOptions {
+    title: string;
+    actions: readonly Action[];
+    assumeYes?: boolean;
+}
+/** Print the planned actions, ask once, then perform them. */
+export declare function confirmAndPerform(ctx: Ctx, opts: ConfirmOptions): boolean;
+/** Ask a yes/no question; anything but `y`/`yes` — including EOF — is a no. */
+export declare function askYesNo(ctx: Ctx, question: string): boolean;

package/dist/cli/prompt.js

@@ -0,0 +1,51 @@
+/**
+ * Confirmation for commands that change files or configuration.
+ *
+ * Following `apt`: print the exact actions first, then ask. `--yes` skips the
+ * question but never the printing, so a scripted run still leaves a record of
+ * what it did.
+ */
+import { readSync } from "node:fs";
+/** Print the planned actions, ask once, then perform them. */
+export function confirmAndPerform(ctx, opts) {
+    if (opts.actions.length === 0) {
+        ctx.stdout.write("Nothing to do.\n");
+        return true;
+    }
+    ctx.stdout.write(`${opts.title}\n`);
+    for (const action of opts.actions)
+        ctx.stdout.write(`  ${action.description}\n`);
+    if (!opts.assumeYes && !askYesNo(ctx, "Continue? [y/N] ")) {
+        ctx.stdout.write("Aborted.\n");
+        return false;
+    }
+    for (const action of opts.actions)
+        action.perform();
+    return true;
+}
+/** Ask a yes/no question; anything but `y`/`yes` — including EOF — is a no. */
+export function askYesNo(ctx, question) {
+    ctx.stdout.write(question);
+    const answer = readLineFromStdin();
+    if (!ctx.stdout.isTTY)
+        ctx.stdout.write("\n");
+    return /^y(es)?$/i.test(answer.trim());
+}
+function readLineFromStdin() {
+    const chunk = Buffer.alloc(256);
+    let text = "";
+    while (!text.includes("\n")) {
+        let read;
+        try {
+            read = readSync(0, chunk, 0, chunk.length, null);
+        }
+        catch {
+            break;
+        }
+        if (read === 0)
+            break;
+        text += chunk.subarray(0, read).toString("utf8");
+    }
+    return text.split("\n")[0] ?? "";
+}
+//# sourceMappingURL=prompt.js.map

package/dist/cli/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/cli/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAenC,8DAA8D;AAC9D,MAAM,UAAU,iBAAiB,CAAC,GAAQ,EAAE,IAAoB;IAC9D,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;IACpC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO;QAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,WAAW,IAAI,CAAC,CAAC;IAEjF,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAC,EAAE,CAAC;QAC1D,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO;QAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IACpD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,QAAQ,CAAC,GAAQ,EAAE,QAAgB;IACjD,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC3B,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACnC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK;QAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9C,OAAO,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,iBAAiB;IACxB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YACH,IAAI,GAAG,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,MAAM;QACR,CAAC;QACD,IAAI,IAAI,KAAK,CAAC;YAAE,MAAM;QACtB,IAAI,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACnC,CAAC"}

package/dist/cli/render/colors.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Terminal color, enabled only for a TTY that has not opted out.
+ *
+ * `--json` output and every fixture comparison therefore run uncolored.
+ */
+import pc from "picocolors";
+export type Colors = ReturnType<typeof pc.createColors>;
+export declare function colorEnabled(stream: {
+    isTTY?: boolean;
+}, env: NodeJS.ProcessEnv): boolean;
+export declare function makeColors(stream: {
+    isTTY?: boolean;
+}, env: NodeJS.ProcessEnv): Colors;

package/dist/cli/render/colors.js

@@ -0,0 +1,19 @@
+/**
+ * Terminal color, enabled only for a TTY that has not opted out.
+ *
+ * `--json` output and every fixture comparison therefore run uncolored.
+ */
+import pc from "picocolors";
+export function colorEnabled(stream, env) {
+    if (env.NO_COLOR !== undefined && env.NO_COLOR !== "")
+        return false;
+    if (env.FORCE_COLOR !== undefined && env.FORCE_COLOR !== "" && env.FORCE_COLOR !== "0")
+        return true;
+    if (env.TERM === "dumb")
+        return false;
+    return stream.isTTY === true;
+}
+export function makeColors(stream, env) {
+    return pc.createColors(colorEnabled(stream, env));
+}
+//# sourceMappingURL=colors.js.map

package/dist/cli/render/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../../src/cli/render/colors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAI5B,MAAM,UAAU,YAAY,CAAC,MAA2B,EAAE,GAAsB;IAC9E,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,GAAG,CAAC,QAAQ,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IACpE,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,GAAG,CAAC,WAAW,KAAK,EAAE,IAAI,GAAG,CAAC,WAAW,KAAK,GAAG;QACpF,OAAO,IAAI,CAAC;IACd,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IACtC,OAAO,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAA2B,EAAE,GAAsB;IAC5E,OAAO,EAAE,CAAC,YAAY,CAAC,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;AACpD,CAAC"}

package/dist/cli/render/detail.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The `show` rendering: an entity's metadata, description and comment thread.
+ */
+import type { EntityRecord } from "../../core/tree.ts";
+import type { Colors } from "./colors.ts";
+export interface DetailOptions {
+    colors: Colors;
+}
+/** Render one entity with its full comment thread. */
+export declare function renderDetail(entity: EntityRecord, opts: DetailOptions): string;

package/dist/cli/render/detail.js

@@ -0,0 +1,105 @@
+/**
+ * The `show` rendering: an entity's metadata, description and comment thread.
+ */
+import { threadOrder } from "../../core/comments.js";
+import { readAssignees, readLabels, readMerged, readRevisions } from "../../core/files.js";
+import { NAVBOOK_ROOT } from "../../core/json.js";
+import { toIsoSeconds } from "../../core/time.js";
+/** Render one entity with its full comment thread. */
+export function renderDetail(entity, opts) {
+    const c = opts.colors;
+    const lines = [];
+    lines.push(`${c.bold(`#${entity.id}`)} ${entity.title}`);
+    const labelWidth = 11;
+    for (const [label, value] of metadataRows(entity)) {
+        // A continuation row (empty label) is indented to line up under the value.
+        const cell = label === "" ? " ".repeat(labelWidth) : c.dim(`${label}:`.padEnd(labelWidth));
+        lines.push(`${cell}${value}`);
+    }
+    const body = entity.body.trim();
+    if (body !== "") {
+        lines.push("");
+        lines.push(body);
+    }
+    lines.push("");
+    lines.push(c.dim(`comments (${entity.comments.length}):`));
+    if (entity.comments.length === 0) {
+        lines.push(c.dim("  none"));
+    }
+    else {
+        for (const { comment, depth } of threadOrder(entity.comments)) {
+            lines.push("");
+            lines.push(...renderComment(comment, depth, c));
+        }
+    }
+    return lines.join("\n");
+}
+function metadataRows(entity) {
+    const rows = [];
+    rows.push(["status", entity.archived ? `${entity.status} (archived)` : entity.status]);
+    rows.push(["author", stringField(entity, "author")]);
+    rows.push(["created", stringField(entity, "created")]);
+    if (entity.kind === "pr") {
+        rows.push(["target", stringField(entity, "target")]);
+        const source = stringField(entity, "source");
+        if (source !== "")
+            rows.push(["source", source]);
+        if (entity.fm.draft === true)
+            rows.push(["draft", "yes"]);
+        const revisions = readRevisions(entity.fm);
+        revisions.forEach((revision, index) => {
+            rows.push([
+                index === 0 ? "revisions" : "",
+                `${index + 1}. head ${revision.head.slice(0, 12)}  base ${revision.base.slice(0, 12)}  ${revision.date}`,
+            ]);
+        });
+        const merged = readMerged(entity.fm);
+        if (merged) {
+            rows.push(["merged", `${merged.date ?? "?"} by ${merged.by ?? "?"}`]);
+            if (typeof merged.commit === "string")
+                rows.push(["", `commit ${merged.commit.slice(0, 12)}`]);
+        }
+    }
+    const labels = readLabels(entity.fm);
+    if (labels.length > 0)
+        rows.push(["labels", labels.join(", ")]);
+    const assignees = readAssignees(entity.fm);
+    if (assignees.length > 0)
+        rows.push(["assignee", assignees.join(", ")]);
+    for (const key of ["milestone", "resolution", "duplicate-of", "superseded-by"]) {
+        const value = stringField(entity, key);
+        if (value !== "")
+            rows.push([key, value]);
+    }
+    rows.push(["path", `${NAVBOOK_ROOT}/${entity.dirPath}/`]);
+    return rows;
+}
+function stringField(entity, key) {
+    const value = entity.fm[key];
+    return typeof value === "string" ? value : "";
+}
+function renderComment(comment, depth, c) {
+    const indent = "  ".repeat(depth + 1);
+    const head = [c.bold(`#${comment.id}`), comment.author, toIsoSeconds(comment.date)];
+    const verdict = comment.parsed.fm.verdict;
+    if (typeof verdict === "string") {
+        const paint = verdict === "approve" ? c.green : c.yellow;
+        head.push(paint(`[${verdict}]`));
+    }
+    const revision = comment.parsed.fm.revision;
+    if (typeof revision === "string")
+        head.push(c.dim(`@${revision.slice(0, 12)}`));
+    const file = comment.parsed.fm.file;
+    if (typeof file === "string") {
+        const line = comment.parsed.fm.line;
+        head.push(c.dim(`${file}${line === undefined ? "" : `:${line}`}`));
+    }
+    if (comment.replyTo)
+        head.push(c.dim(`reply to #${comment.replyTo}`));
+    const lines = [`${indent}${head.join("  ")}`];
+    for (const line of comment.body.trim().split("\n")) {
+        lines.push(line === "" ? "" : `${indent}  ${line}`);
+    }
+    return lines;
+}
+//# sourceMappingURL=detail.js.map

package/dist/cli/render/detail.js.map

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

package/dist/cli/render/table.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Column-aligned listings for `nav issue list` / `nav pr list`.
+ */
+import type { Colors } from "./colors.ts";
+export interface Column {
+    header: string;
+    /** Cells are truncated to this width when the terminal is narrow. */
+    flexible?: boolean;
+    minWidth?: number;
+}
+export interface TableOptions {
+    colors: Colors;
+    /** Total width available; unlimited when undefined. */
+    width?: number;
+}
+/** Render a table, shrinking flexible columns to fit the terminal width. */
+export declare function renderTable(columns: readonly Column[], rows: readonly string[][], opts: TableOptions): string;
+/** Truncate to `width`, marking the cut with a single ellipsis character. */
+export declare function truncate(text: string, width: number): string;