@navbook/cli 0.1.2 → 0.2.0

package/dist/commands/feature.js

@@ -0,0 +1,202 @@
+/**
+ * `nav feature <verb>` — spec 04 §4.3.
+ *
+ * A feature has no lifecycle and no discussion, so it borrows none of the
+ * shared entity verbs: what it can be asked is what it is, what documents
+ * describe it, and what has happened to it.
+ */
+import { addSpec, applyFeatureEdit, commitReport, createFeature, currentAuthor, featureCommits, featureJson, featureMembers, findFeature, loadRepo, newFeatureFile, newSpecFile, prepareOpen, referencedFeatures, requireSpecFileName, resolveFeature, resolveFeatureForEdit, revalidateFeatureFile, specFileName, specJson, toNdjson, validateFeature, validateSpec, } from "@navbook/core";
+import { openInEditor } from "../editor.js";
+import { fail } from "../errors.js";
+import { renderTable } from "../render/table.js";
+import { composeFile } from "./compose.js";
+export function cmdFeatureOpen(ctx, title, opts) {
+    if (title.trim() === "")
+        fail("a feature needs a title");
+    const { created } = prepareOpen(ctx);
+    const composed = composeFile(ctx, {
+        ...(opts.message === undefined ? {} : { message: opts.message }),
+        bufferName: "NAVBOOK_FEATURE.md",
+        noun: "feature",
+        // A feature is named by its title; the documents beside it carry the detail.
+        allowEmptyBody: true,
+        render: (body) => newFeatureFile({ title, author: currentAuthor(ctx), created, ...(body ? { body } : {}) }),
+        validate: validateFeature,
+    });
+    const { slug, dirPath, run } = createFeature(ctx, {
+        content: composed.content,
+        ...(opts.slug === undefined ? {} : { slug: opts.slug }),
+        fallbackTitle: title,
+    }, { commit: opts.commit });
+    ctx.stdout.write(`Created ${ctx.navDir}/${dirPath}/  (${slug})\n`);
+    if (opts.commit)
+        ctx.stdout.write(`${commitReport(run)}\n`);
+}
+/* --------------------------------------------------------------------- list */
+export function cmdFeatureList(ctx, opts) {
+    const repo = loadRepo(ctx, { comments: "none" });
+    const rows = repo.features.map((feature) => {
+        const attached = featureMembers(repo, feature.slug);
+        return { feature, entities: [...attached.issues, ...attached.prs] };
+    });
+    if (opts.json) {
+        if (rows.length === 0)
+            return;
+        const objects = rows.map(({ feature, entities }) => featureJson(ctx.navDir, feature, memberIds(entities)));
+        ctx.stdout.write(`${toNdjson(objects)}\n`);
+        return;
+    }
+    if (rows.length === 0) {
+        ctx.stdout.write("No features yet.\n");
+        return;
+    }
+    const columns = [
+        { header: "slug" },
+        { header: "title", flexible: true, minWidth: 20 },
+        { header: "specs" },
+        { header: "open" },
+        { header: "closed" },
+    ];
+    const cells = rows.map(({ feature, entities }) => [
+        feature.slug,
+        feature.title,
+        String(feature.specs.length),
+        String(entities.filter((entity) => entity.status === "open").length),
+        String(entities.filter((entity) => entity.status !== "open").length),
+    ]);
+    ctx.stdout.write(`${renderTable(columns, cells, { colors: ctx.colors, width: terminalWidth(ctx) })}\n`);
+}
+/**
+ * The `issues` and `prs` keys a feature's JSON carries.
+ *
+ * Both `list` and `show` emit them, and both emit IDs: a key must not change
+ * type between commands, which is what makes the projection worth diffing
+ * across implementations (spec 04 §4.2).
+ */
+function memberIds(entities) {
+    return {
+        issues: entities.filter((e) => e.kind === "issue").map((e) => e.id),
+        prs: entities.filter((e) => e.kind === "pr").map((e) => e.id),
+    };
+}
+export function cmdFeatureShow(ctx, slug, opts) {
+    const repo = loadRepo(ctx, { comments: "none" });
+    const feature = resolveFeature(repo, slug);
+    const attached = featureMembers(repo, feature.slug);
+    if (opts.json) {
+        ctx.stdout.write(`${JSON.stringify(featureJson(ctx.navDir, feature, memberIds([...attached.issues, ...attached.prs])))}\n`);
+        return;
+    }
+    const c = ctx.colors;
+    const lines = [c.bold(feature.slug), ""];
+    const label = (text) => c.dim(`${text}:`.padEnd(11));
+    lines.push(`${label("title")}${feature.title}`);
+    if (typeof feature.fm.author === "string")
+        lines.push(`${label("author")}${feature.fm.author}`);
+    if (typeof feature.fm.created === "string")
+        lines.push(`${label("created")}${feature.fm.created}`);
+    lines.push(`${label("path")}${ctx.navDir}/${feature.dirPath}`);
+    const summary = feature.body.trim();
+    if (summary !== "")
+        lines.push("", summary);
+    lines.push("", c.dim(`specs (${feature.specs.length}):`));
+    if (feature.specs.length === 0)
+        lines.push(c.dim("  none"));
+    for (const spec of feature.specs) {
+        lines.push(`  ${spec.fileName.padEnd(28)}${spec.title}`);
+    }
+    const entities = [...attached.issues, ...attached.prs];
+    lines.push("", c.dim(`issues and pull requests (${entities.length}):`));
+    if (entities.length === 0)
+        lines.push(c.dim("  none"));
+    for (const entity of entities) {
+        lines.push(`  #${entity.id}  ${entity.status.padEnd(7)}${entity.title}`);
+    }
+    const limit = opts.commits ?? 10;
+    if (limit > 0) {
+        const commits = featureCommits(ctx, feature, attached, { limit });
+        lines.push("", c.dim(`recent commits (${commits.length}):`));
+        if (commits.length === 0)
+            lines.push(c.dim("  none"));
+        for (const commit of commits) {
+            lines.push(`  ${c.dim(commit.sha.slice(0, 8))}  ${commit.subject}`);
+        }
+    }
+    ctx.stdout.write(`${lines.join("\n")}\n`);
+}
+/* --------------------------------------------------------------------- edit */
+export function cmdFeatureEdit(ctx, slug, opts) {
+    editInPlace(ctx, slug, undefined, opts);
+}
+export function cmdSpecAdd(ctx, slug, title, opts) {
+    if (title.trim() === "")
+        fail("a specification document needs a title");
+    // Resolved first: being told the feature does not exist is worth much more
+    // before an editor has been filled in than after.
+    const feature = findFeature(ctx, slug);
+    const fileName = requireSpecFileName(opts.file ?? specFileName(title));
+    const composed = composeFile(ctx, {
+        ...(opts.message === undefined ? {} : { message: opts.message }),
+        bufferName: "NAVBOOK_SPEC.md",
+        noun: "specification document",
+        render: (body) => newSpecFile({ title, body }),
+        validate: validateSpec,
+    });
+    const added = addSpec(ctx, feature.slug, { content: composed.content, fileName }, { commit: opts.commit });
+    ctx.stdout.write(`Created ${ctx.navDir}/${added.path}\n`);
+    if (opts.commit)
+        ctx.stdout.write(`${commitReport(added.run)}\n`);
+}
+export function cmdSpecEdit(ctx, slug, file, opts) {
+    editInPlace(ctx, slug, file, opts);
+}
+export function cmdSpecList(ctx, slug, opts) {
+    const feature = findFeature(ctx, slug);
+    if (opts.json) {
+        if (feature.specs.length === 0)
+            return;
+        const objects = feature.specs.map((spec) => specJson(ctx.navDir, feature, spec));
+        ctx.stdout.write(`${toNdjson(objects)}\n`);
+        return;
+    }
+    if (feature.specs.length === 0) {
+        ctx.stdout.write(`Feature '${feature.slug}' has no specification documents yet.\n`);
+        return;
+    }
+    const columns = [{ header: "file" }, { header: "title", flexible: true, minWidth: 20 }];
+    const rows = feature.specs.map((spec) => [spec.fileName, spec.title]);
+    ctx.stdout.write(`${renderTable(columns, rows, { colors: ctx.colors, width: terminalWidth(ctx) })}\n`);
+}
+/* ------------------------------------------------------------------ helpers */
+/** Open a feature file or one of its documents in `$EDITOR` and record it. */
+function editInPlace(ctx, slug, fileName, opts) {
+    const target = resolveFeatureForEdit(ctx, slug, fileName);
+    openInEditor(ctx, target.path);
+    const problems = revalidateFeatureFile(target.path, target.spec !== undefined);
+    if (problems.length > 0) {
+        fail(`${ctx.navDir}/${target.filePath} is no longer valid; it was left as you saved it`, problems.map((problem) => `  ${problem}`));
+    }
+    const run = applyFeatureEdit(ctx, target, { commit: opts.commit });
+    ctx.stdout.write(`Edited ${ctx.navDir}/${target.filePath}\n`);
+    if (opts.commit)
+        ctx.stdout.write(`${commitReport(run)}\n`);
+}
+function terminalWidth(ctx) {
+    const columns = ctx.stdout.columns;
+    return typeof columns === "number" && columns > 0 ? columns : undefined;
+}
+/**
+ * Feature slugs offered for completion: those that exist, and those named.
+ *
+ * A slug an entity names but no directory holds is offered too — it is what
+ * somebody typed, and completing it is how they find the typo (D14).
+ */
+export function featureSlugs(ctx) {
+    try {
+        return referencedFeatures(loadRepo(ctx, { comments: "none" }));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=feature.js.map

package/dist/commands/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.js","sourceRoot":"","sources":["../../src/commands/feature.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,OAAO,EACP,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,aAAa,EAEb,cAAc,EACd,WAAW,EACX,cAAc,EACd,WAAW,EACX,QAAQ,EACR,cAAc,EACd,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,eAAe,EACf,YAAY,GACb,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAe,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAU3C,MAAM,UAAU,cAAc,CAAC,GAAQ,EAAE,KAAa,EAAE,IAAwB;IAC9E,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACzD,MAAM,EAAE,OAAO,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAErC,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE;QAChC,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QAChE,UAAU,EAAE,oBAAoB;QAChC,IAAI,EAAE,SAAS;QACf,6EAA6E;QAC7E,cAAc,EAAE,IAAI;QACpB,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CACf,cAAc,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3F,QAAQ,EAAE,eAAe;KAC1B,CAAC,CAAC;IAEH,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,aAAa,CAC1C,GAAG,EACH;QACE,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QACvD,aAAa,EAAE,KAAK;KACrB,EACD,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CACxB,CAAC;IAEF,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,MAAM,IAAI,OAAO,OAAO,IAAI,KAAK,CAAC,CAAC;IACnE,IAAI,IAAI,CAAC,MAAM;QAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC9D,CAAC;AAED,gFAAgF;AAEhF,MAAM,UAAU,cAAc,CAAC,GAAQ,EAAE,IAAiB;IACxD,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QACzC,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACpD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CACjD,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,CACtD,CAAC;QACF,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3C,OAAO;IACT,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACvC,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAa;QACxB,EAAE,MAAM,EAAE,MAAM,EAAE;QAClB,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE;QACjD,EAAE,MAAM,EAAE,OAAO,EAAE;QACnB,EAAE,MAAM,EAAE,MAAM,EAAE;QAClB,EAAE,MAAM,EAAE,QAAQ,EAAE;KACrB,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;QAChD,OAAO,CAAC,IAAI;QACZ,OAAO,CAAC,KAAK;QACb,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;QAC5B,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;QACpE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;KACrE,CAAC,CAAC;IACH,GAAG,CAAC,MAAM,CAAC,KAAK,CACd,GAAG,WAAW,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CACtF,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,SAAS,CAAC,QAAiC;IAClD,OAAO;QACL,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9D,CAAC;AACJ,CAAC;AAQD,MAAM,UAAU,cAAc,CAAC,GAAQ,EAAE,IAAY,EAAE,IAAwB;IAC7E,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,GAAG,CAAC,MAAM,CAAC,KAAK,CACd,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAC1G,CAAC;QACF,OAAO;IACT,CAAC;IAED,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC;IACrB,MAAM,KAAK,GAAa,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7D,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAChD,IAAI,OAAO,OAAO,CAAC,EAAE,CAAC,MAAM,KAAK,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;IAChG,IAAI,OAAO,OAAO,CAAC,EAAE,CAAC,OAAO,KAAK,QAAQ;QACxC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IACzD,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAE/D,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACpC,IAAI,OAAO,KAAK,EAAE;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAE5C,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,OAAO,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IAC1D,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC5D,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IACvD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,6BAA6B,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IACxE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvD,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,EAAE,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IACjC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAClE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,mBAAmB,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;QAC7D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QACtD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED,gFAAgF;AAEhF,MAAM,UAAU,cAAc,CAAC,GAAQ,EAAE,IAAY,EAAE,IAAiB;IACtE,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;AAC1C,CAAC;AASD,MAAM,UAAU,UAAU,CAAC,GAAQ,EAAE,IAAY,EAAE,KAAa,EAAE,IAAoB;IACpF,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACxE,2EAA2E;IAC3E,kDAAkD;IAClD,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;IAEvE,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE;QAChC,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QAChE,UAAU,EAAE,iBAAiB;QAC7B,IAAI,EAAE,wBAAwB;QAC9B,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC9C,QAAQ,EAAE,YAAY;KACvB,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EACH,OAAO,CAAC,IAAI,EACZ,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,EACvC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CACxB,CAAC;IACF,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;IAC1D,IAAI,IAAI,CAAC,MAAM;QAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAQ,EAAE,IAAY,EAAE,IAAY,EAAE,IAAiB;IACjF,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAQ,EAAE,IAAY,EAAE,IAAiB;IACnE,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAEvC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACvC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QACjF,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3C,OAAO;IACT,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,OAAO,CAAC,IAAI,yCAAyC,CAAC,CAAC;QACpF,OAAO;IACT,CAAC;IACD,MAAM,OAAO,GAAa,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;IAClG,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,GAAG,CAAC,MAAM,CAAC,KAAK,CACd,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CACrF,CAAC;AACJ,CAAC;AAED,gFAAgF;AAEhF,8EAA8E;AAC9E,SAAS,WAAW,CAClB,GAAQ,EACR,IAAY,EACZ,QAA4B,EAC5B,IAAiB;IAEjB,MAAM,MAAM,GAAG,qBAAqB,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC1D,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAE/B,MAAM,QAAQ,GAAG,qBAAqB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAC/E,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,IAAI,CACF,GAAG,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,QAAQ,kDAAkD,EAClF,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,CAC1C,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACnE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;IAC9D,IAAI,IAAI,CAAC,MAAM;QAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,aAAa,CAAC,GAAQ;IAC7B,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC;IACnC,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,GAAQ;IACnC,IAAI,CAAC;QACH,OAAO,kBAAkB,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/commands/init.js

@@ -0,0 +1,23 @@
+/**
+ * `nav init` and `nav id` — the repository-level utilities of spec 04 §4.3.
+ */
+import { commitReport, initWorkspace, mintIds } from "@navbook/core";
+/** Create the Navbook skeleton. */
+export function cmdInit(ctx, opts) {
+    const result = initWorkspace(ctx, { commit: opts.commit });
+    ctx.stdout.write(`Created ${ctx.navDir}/\n`);
+    if (opts.commit) {
+        ctx.stdout.write(`${commitReport(result)}\n`);
+    }
+    else {
+        // Say so plainly: a later --commit refuses to run while this is staged.
+        ctx.stdout.write("The skeleton is staged; commit it, or re-run with --commit.\n");
+    }
+    ctx.stdout.write(`Next: nav issue open "Something is broken"\n`);
+}
+/** Mint and print fresh IDs, for hand-editors and scripts. */
+export function cmdId(ctx, opts) {
+    for (const id of mintIds(ctx, opts.count ?? 1))
+        ctx.stdout.write(`${id}\n`);
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAIrE,mCAAmC;AACnC,MAAM,UAAU,OAAO,CAAC,GAAQ,EAAE,IAAiB;IACjD,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3D,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC;IAC7C,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;SAAM,CAAC;QACN,wEAAwE;QACxE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACpF,CAAC;IACD,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;AACnE,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,KAAK,CAAC,GAAQ,EAAE,IAAwB;IACtD,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;QAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAC9E,CAAC"}

package/dist/{cli/commands → commands}/install.js

@@ -5,8 +5,7 @@
  * happens without printing the exact action first: the `git config` command to
  * be run, the hook path, the completions file.
  */
-import { ALIAS_DEFAULT, aliasCommand, DIRECTORY_RENAMES_KEY, readGlobal, readLocal, setLocal, unsetGlobal, unsetLocal, } from "../../git/config.js";
-import { git } from "../../git/exec.js";
+import { ALIAS_DEFAULT, aliasCommand, DIRECTORY_RENAMES_KEY, git, readGlobal, readLocal, setLocal, unsetGlobal, unsetLocal, } from "@navbook/core";
 import { fail } from "../errors.js";
 import { completionNote, completionPath, completionScript, detectShell, installCompletions, isShell, uninstallCompletions, } from "../install/completions.js";
 import { hookPath, installHook, isInstalled, uninstallHook } from "../install/hook.js";

package/dist/commands/install.js.map

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

package/dist/commands/issue.js

@@ -0,0 +1,89 @@
+/**
+ * `nav issue <verb>` — spec 04 §4.3.
+ */
+import { commitReport, currentAuthor, executeIssueLink, findParentIssue, isCalendarDate, newIssueFile, openIssue, planIssueLink, prepareOpen, unlinkIssue, validateIssue, } from "@navbook/core";
+import { fail } from "../errors.js";
+import { askYesNo } from "../prompt.js";
+import { composeFile } from "./compose.js";
+export function cmdIssueOpen(ctx, title, opts) {
+    if (title.trim() === "")
+        fail("an issue needs a title");
+    // Refused here rather than left to the file's own validation, for the reason
+    // `--parent` is resolved here: being told a flag will not do is worth much
+    // more before an editor has been filled in than after.
+    if (opts.rank !== undefined && !Number.isFinite(opts.rank))
+        fail("--rank must be a number");
+    if (opts.deadline !== undefined && !isCalendarDate(opts.deadline)) {
+        fail("--deadline must be a calendar date, as YYYY-MM-DD");
+    }
+    const { created } = prepareOpen(ctx);
+    // Resolved before anything is composed: being told the parent does not exist
+    // is worth much more before an editor has been filled in than after.
+    const parent = opts.parent === undefined ? undefined : findParentIssue(ctx, opts.parent);
+    const composed = composeFile(ctx, {
+        message: opts.message,
+        bufferName: "NAVBOOK_ISSUE.md",
+        noun: "issue",
+        render: (body) => newIssueFile({
+            title,
+            author: currentAuthor(ctx),
+            created,
+            body,
+            labels: opts.label,
+            assignee: opts.assignee,
+            milestone: opts.milestone,
+            features: opts.feature,
+            rank: opts.rank,
+            deadline: opts.deadline,
+            parent: parent?.id,
+        }),
+        validate: validateIssue,
+    });
+    const result = openIssue(ctx, { content: composed.content, fallbackTitle: title }, { commit: opts.commit });
+    const { id, dirPath, run } = result;
+    ctx.stdout.write(`Created ${ctx.navDir}/${dirPath}/  (#${id})\n`);
+    // What the file ended up saying, which an editor session may have changed.
+    if (result.parent) {
+        ctx.stdout.write(`Filed under #${result.parent.id}  ${result.parent.title}\n`);
+    }
+    if (opts.commit)
+        ctx.stdout.write(`${commitReport(run)}\n`);
+}
+/**
+ * File one issue under another — spec 04 §4.3.
+ *
+ * An issue that already has a parent is being moved, not merely linked, and
+ * that changes a structure somebody else may be reading, so it is confirmed
+ * first. As everywhere else, an unanswerable question counts as "no".
+ */
+export function cmdIssueLink(ctx, prefix, opts) {
+    const link = planIssueLink(ctx, prefix, opts.parent, { commit: opts.commit });
+    const { child, parent, previousParentId, previousParent } = link;
+    if (previousParentId !== undefined && !opts.force) {
+        const from = previousParent
+            ? `#${previousParent.id}  ${previousParent.title}`
+            : `#${previousParentId} (not in this tree)`;
+        ctx.stdout.write(`#${child.id} is already a subtask of ${from}\n`);
+        if (!askYesNo(ctx, `Move it under #${parent.id} instead? [y/N] `)) {
+            fail(`#${child.id} was not moved`);
+        }
+    }
+    const run = executeIssueLink(ctx, link, { commit: opts.commit });
+    ctx.stdout.write(`Filed #${child.id} under #${parent.id}  ${parent.title}\n`);
+    // An issue that was claiming the subtask without its agreement stops here,
+    // and nothing else in the run would have told the user that happened.
+    for (const lister of link.unexpectedListers) {
+        ctx.stdout.write(`Removed #${child.id} from the subtasks of #${lister.id}  ${lister.title}\n`);
+    }
+    if (opts.commit)
+        ctx.stdout.write(`${commitReport(run)}\n`);
+}
+export function cmdIssueUnlink(ctx, prefix, opts) {
+    const { child, parentId, run } = unlinkIssue(ctx, prefix, { commit: opts.commit });
+    ctx.stdout.write(parentId === undefined
+        ? `Unlinked #${child.id}\n`
+        : `Unlinked #${child.id} from #${parentId}\n`);
+    if (opts.commit)
+        ctx.stdout.write(`${commitReport(run)}\n`);
+}
+//# sourceMappingURL=issue.js.map

package/dist/commands/issue.js.map

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

package/dist/commands/policy.js

@@ -0,0 +1,49 @@
+/**
+ * Saying what the review policy counts, and what it is short of.
+ *
+ * Shared by every verb that reads the policy, so a pull request short of two
+ * approvals is described in the same words wherever it is mentioned. Nothing
+ * here refuses anything: spec 02 §2.7 forbids acting on a review state, and
+ * §2.10 keeps a declared policy inside that. These are sentences, not gates.
+ */
+import { NAV_MARKER } from "@navbook/core";
+/** Warn about a marker whose policy could not be read; D15 is the full report. */
+export function warnPolicyProblems(ctx, reading) {
+    for (const problem of reading.problems) {
+        ctx.stderr.write(`${ctx.colors.yellow("warning:")} ${ctx.navDir}/${NAV_MARKER}: ${problem}; using the default\n`);
+    }
+}
+/**
+ * What stands between a pull request and its policy, or null when nothing does.
+ *
+ * Only asked of a repository that declared a policy: a decision of `pending`
+ * where nobody asked for anything is not a shortfall, and saying so on every
+ * merge would be noise about a project that never opted in.
+ */
+export function describeShortfall(summary) {
+    const blockers = summary.reviewers
+        .filter((entry) => entry.state === "request-changes")
+        .map((entry) => entry.person);
+    if (blockers.length > 0)
+        return `changes requested by ${blockers.join(", ")}`;
+    const { given, required } = summary.approvals;
+    if (given >= required)
+        return null;
+    return `${given} of ${required} required approval${required === 1 ? "" : "s"}`;
+}
+/**
+ * Decide how a merge should treat an unmet policy.
+ *
+ * Kept apart from the merge itself so every combination can be checked without
+ * a repository or a terminal, and so the one rule that matters is visible in
+ * one place: no combination returns a refusal. `--yes` proceeds, a terminal is
+ * asked, and everything else says its piece and proceeds — because a pipeline
+ * that stopped for a question nobody can answer would be the gate spec 02 §2.7
+ * forbids, arrived at by accident rather than on purpose.
+ */
+export function mergeAction(situation) {
+    if (situation.shortfall === null || situation.assumeYes)
+        return "proceed";
+    return situation.interactive ? "ask" : "warn-and-proceed";
+}
+//# sourceMappingURL=policy.js.map

package/dist/commands/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/commands/policy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAgD,MAAM,eAAe,CAAC;AAGzF,kFAAkF;AAClF,MAAM,UAAU,kBAAkB,CAAC,GAAQ,EAAE,OAA4B;IACvE,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACvC,GAAG,CAAC,MAAM,CAAC,KAAK,CACd,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,MAAM,IAAI,UAAU,KAAK,OAAO,uBAAuB,CAChG,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAsB;IACtD,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS;SAC/B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,iBAAiB,CAAC;SACpD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,wBAAwB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAE9E,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IAC9C,IAAI,KAAK,IAAI,QAAQ;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,GAAG,KAAK,OAAO,QAAQ,qBAAqB,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;AACjF,CAAC;AAcD;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,SAAyB;IACnD,IAAI,SAAS,CAAC,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1E,OAAO,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC;AAC5D,CAAC"}