@navbook/cli 0.1.2 → 0.2.0

package/dist/core/frontmatter.js

@@ -1,149 +0,0 @@
-/**
- * YAML frontmatter — spec 02 §2.4.
- *
- * Every Navbook file is UTF-8 Markdown that begins, at byte 0, with a `---`
- * delimited YAML block. Unknown keys MUST be preserved when a tool rewrites a
- * file, so this module is built on the `yaml` package's Document API (which
- * keeps key order and comments) and additionally replays the original YAML text
- * verbatim whenever nothing was actually changed.
- */
-import { Document, isMap, isScalar, isSeq, parseDocument } from "yaml";
-export class FrontmatterError extends Error {
-}
-const DELIMITER = /^---[ \t]*\r?$/;
-/** Split a Navbook file into its YAML block and its body. */
-export function splitFrontmatter(text) {
-    const lines = text.split("\n");
-    if (!DELIMITER.test(lines[0] ?? "")) {
-        throw new FrontmatterError("file must start with a '---' frontmatter delimiter at byte 0");
-    }
-    for (let i = 1; i < lines.length; i++) {
-        if (DELIMITER.test(lines[i])) {
-            const yaml = lines.slice(1, i).join("\n");
-            const body = lines.slice(i + 1).join("\n");
-            return { yaml: yaml === "" ? "" : `${yaml}\n`, body };
-        }
-    }
-    throw new FrontmatterError("frontmatter block is not closed by a '---' line");
-}
-/** Parse a Navbook file into a {@link NavDoc}. Throws only on a missing block. */
-export function parseDoc(text) {
-    const { yaml, body } = splitFrontmatter(text);
-    const doc = parseDocument(yaml, { keepSourceTokens: false });
-    const errors = doc.errors.map((e) => e.message);
-    return { doc, rawYaml: yaml, body, dirty: false, errors };
-}
-/** Build a fresh document with no keys and an empty body. */
-export function emptyDoc() {
-    const doc = new Document({});
-    return { doc, rawYaml: "", body: "", dirty: true, errors: [] };
-}
-/** Serialize a {@link NavDoc} back to file text. */
-export function serializeDoc(nav) {
-    const yaml = nav.dirty ? serializeYaml(nav.doc) : nav.rawYaml;
-    return `---\n${yaml}---\n${nav.body}`;
-}
-function serializeYaml(doc) {
-    if (doc.errors.length > 0) {
-        // The YAML parser refuses to stringify a document it could not parse, and
-        // a caller rewriting frontmatter would otherwise get its bare message.
-        throw new FrontmatterError(`frontmatter is not valid YAML and cannot be rewritten: ${doc.errors[0]?.message ?? "parse error"}`);
-    }
-    if (doc.contents === null || doc.contents === undefined)
-        return "";
-    if (isMap(doc.contents) && doc.contents.items.length === 0)
-        return "";
-    const text = doc.toString({
-        lineWidth: 0,
-        defaultKeyType: "PLAIN",
-        flowCollectionPadding: false,
-    });
-    return text.endsWith("\n") ? text : `${text}\n`;
-}
-/** All frontmatter as plain JavaScript values (unknown keys included). */
-export function toPlain(nav) {
-    const value = nav.doc.toJS({ maxAliasCount: 100 });
-    return value && typeof value === "object" && !Array.isArray(value)
-        ? value
-        : {};
-}
-const NULL_SOURCES = new Set(["", "~", "null", "Null", "NULL"]);
-/**
- * Read a scalar as the string the author wrote.
- *
- * YAML resolves some strings to other types — an all-digit commit SHA becomes a
- * (lossy) number, `title: 42` becomes an integer. Recovering the scalar's source
- * text keeps those hand-written files usable instead of merely diagnosable.
- */
-export function stringAt(nav, path) {
-    const node = path.length === 1 ? nav.doc.get(path[0], true) : nav.doc.getIn(path, true);
-    if (node === undefined || node === null)
-        return undefined;
-    if (!isScalar(node))
-        return undefined;
-    if (typeof node.value === "string")
-        return node.value;
-    const source = node.source;
-    if (node.value === null)
-        return source !== undefined && NULL_SOURCES.has(source) ? undefined : source;
-    return source ?? String(node.value);
-}
-/** Number of items in a sequence at `path`, or null when it is not a sequence. */
-export function seqLength(nav, path) {
-    const node = path.length === 1 ? nav.doc.get(path[0], true) : nav.doc.getIn(path, true);
-    return isSeq(node) ? node.items.length : null;
-}
-/** True when the frontmatter has the key at all (even with a null value). */
-export function hasKey(nav, key) {
-    return isMap(nav.doc.contents) && nav.doc.has(key);
-}
-/** Ordered list of frontmatter keys, as they appear in the file. */
-export function keysInOrder(nav) {
-    if (!isMap(nav.doc.contents))
-        return [];
-    return nav.doc.contents.items.map((item) => String(item.key?.value ?? ""));
-}
-/**
- * Set or delete frontmatter keys. A value of `undefined` deletes the key; new
- * keys are appended after the existing ones so hand-authored ordering survives.
- */
-export function patchDoc(nav, changes) {
-    for (const [key, value] of Object.entries(changes)) {
-        if (value === undefined) {
-            if (nav.doc.has(key)) {
-                nav.doc.delete(key);
-                nav.dirty = true;
-            }
-            continue;
-        }
-        nav.doc.set(key, value);
-        nav.dirty = true;
-    }
-    return nav;
-}
-/**
- * Set a list of plain scalars in flow style (`labels: [bug, auth]`), matching
- * the spec's own examples. Flow scalar sequences are inside the conservative
- * YAML subset of spec 05 §5.3.
- */
-export function setFlowList(nav, key, items) {
-    const node = nav.doc.createNode(items);
-    if (isSeq(node))
-        node.flow = true;
-    nav.doc.set(key, node);
-    nav.dirty = true;
-    return nav;
-}
-/** Append an item to a block-style list, creating the list if necessary. */
-export function appendListItem(nav, key, item) {
-    const existing = nav.doc.get(key, true);
-    if (isSeq(existing)) {
-        existing.add(nav.doc.createNode(item));
-    }
-    else {
-        nav.doc.set(key, nav.doc.createNode([item]));
-    }
-    nav.dirty = true;
-    return nav;
-}
-//# sourceMappingURL=frontmatter.js.map

package/dist/core/frontmatter.js.map

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

package/dist/core/id.d.ts

@@ -1,46 +0,0 @@
-/**
- * Navbook identifiers — spec 02 §2.2.
- *
- * Grammar: exactly 8 characters, `^[a-z][a-z0-9]{7}$`, containing at least one
- * digit. The leading letter keeps YAML from parsing an ID as a number; the
- * mandatory digit keeps English words from being mistaken for IDs.
- */
-/** Source of randomness, injected so that `core` stays pure and browser-safe. */
-export type RandomBytes = (n: number) => Uint8Array;
-export declare const ID_LENGTH = 8;
-export declare const ID_ALPHABET = "abcdefghijklmnopqrstuvwxyz0123456789";
-export declare const ID_PATTERN: RegExp;
-/** Minimum length of an ID prefix accepted wherever a CLI takes an ID (§2.2). */
-export declare const MIN_PREFIX_LENGTH = 4;
-/** True if `s` is a syntactically valid Navbook ID. */
-export declare function isId(s: string): boolean;
-/**
- * Mint a fresh ID by rejection sampling: draw 8 uniform characters from the
- * 36-character alphabet, discarding candidates that violate the grammar.
- *
- * Bytes ≥ 252 are discarded before the modulo so the character distribution is
- * exactly uniform (252 = 7 × 36).
- */
-export declare function mintId(randomBytes: RandomBytes): string;
-export type PrefixResolution = {
-    ok: true;
-    id: string;
-} | {
-    ok: false;
-    reason: "too-short";
-    matches: [];
-} | {
-    ok: false;
-    reason: "not-found";
-    matches: [];
-} | {
-    ok: false;
-    reason: "ambiguous";
-    matches: string[];
-};
-/**
- * Resolve an ID prefix against known IDs. Exact matches win outright; otherwise
- * the prefix must be at least {@link MIN_PREFIX_LENGTH} characters and match
- * exactly one candidate.
- */
-export declare function resolvePrefix(prefix: string, candidates: readonly string[]): PrefixResolution;

package/dist/core/id.js

@@ -1,66 +0,0 @@
-/**
- * Navbook identifiers — spec 02 §2.2.
- *
- * Grammar: exactly 8 characters, `^[a-z][a-z0-9]{7}$`, containing at least one
- * digit. The leading letter keeps YAML from parsing an ID as a number; the
- * mandatory digit keeps English words from being mistaken for IDs.
- */
-export const ID_LENGTH = 8;
-export const ID_ALPHABET = "abcdefghijklmnopqrstuvwxyz0123456789";
-export const ID_PATTERN = /^[a-z][a-z0-9]{7}$/;
-/** Minimum length of an ID prefix accepted wherever a CLI takes an ID (§2.2). */
-export const MIN_PREFIX_LENGTH = 4;
-/** True if `s` is a syntactically valid Navbook ID. */
-export function isId(s) {
-    return ID_PATTERN.test(s) && /[0-9]/.test(s);
-}
-/**
- * Mint a fresh ID by rejection sampling: draw 8 uniform characters from the
- * 36-character alphabet, discarding candidates that violate the grammar.
- *
- * Bytes ≥ 252 are discarded before the modulo so the character distribution is
- * exactly uniform (252 = 7 × 36).
- */
-export function mintId(randomBytes) {
-    const limit = 252;
-    for (let attempt = 0; attempt < 1000; attempt++) {
-        const chars = [];
-        // Draw generously so a single call usually suffices even with rejections.
-        let pool = randomBytes(ID_LENGTH * 2);
-        let i = 0;
-        while (chars.length < ID_LENGTH) {
-            if (i >= pool.length) {
-                pool = randomBytes(ID_LENGTH * 2);
-                i = 0;
-            }
-            const byte = pool[i++];
-            if (byte >= limit)
-                continue;
-            chars.push(ID_ALPHABET[byte % ID_ALPHABET.length]);
-        }
-        const candidate = chars.join("");
-        if (isId(candidate))
-            return candidate;
-    }
-    /* c8 ignore next */
-    throw new Error("failed to mint an ID: random source is not producing usable bytes");
-}
-/**
- * Resolve an ID prefix against known IDs. Exact matches win outright; otherwise
- * the prefix must be at least {@link MIN_PREFIX_LENGTH} characters and match
- * exactly one candidate.
- */
-export function resolvePrefix(prefix, candidates) {
-    const needle = prefix.toLowerCase();
-    if (candidates.includes(needle))
-        return { ok: true, id: needle };
-    if (needle.length < MIN_PREFIX_LENGTH)
-        return { ok: false, reason: "too-short", matches: [] };
-    const matches = candidates.filter((c) => c.startsWith(needle)).sort();
-    if (matches.length === 1)
-        return { ok: true, id: matches[0] };
-    if (matches.length === 0)
-        return { ok: false, reason: "not-found", matches: [] };
-    return { ok: false, reason: "ambiguous", matches };
-}
-//# sourceMappingURL=id.js.map

package/dist/core/id.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/core/id.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC;AAC3B,MAAM,CAAC,MAAM,WAAW,GAAG,sCAAsC,CAAC;AAClE,MAAM,CAAC,MAAM,UAAU,GAAG,oBAAoB,CAAC;AAE/C,iFAAiF;AACjF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAEnC,uDAAuD;AACvD,MAAM,UAAU,IAAI,CAAC,CAAS;IAC5B,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CAAC,WAAwB;IAC7C,MAAM,KAAK,GAAG,GAAG,CAAC;IAClB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC;QAChD,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,0EAA0E;QAC1E,IAAI,IAAI,GAAG,WAAW,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,OAAO,KAAK,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBACrB,IAAI,GAAG,WAAW,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;gBAClC,CAAC,GAAG,CAAC,CAAC;YACR,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,EAAE,CAAW,CAAC;YACjC,IAAI,IAAI,IAAI,KAAK;gBAAE,SAAS;YAC5B,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,GAAG,WAAW,CAAC,MAAM,CAAW,CAAC,CAAC;QAC/D,CAAC;QACD,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjC,IAAI,IAAI,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;IACxC,CAAC;IACD,oBAAoB;IACpB,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;AACvF,CAAC;AAQD;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,UAA6B;IACzE,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACpC,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;IACjE,IAAI,MAAM,CAAC,MAAM,GAAG,iBAAiB;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC9F,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACtE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC,CAAW,EAAE,CAAC;IACxE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACjF,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;AACrD,CAAC"}

package/dist/core/index.d.ts

@@ -1,19 +0,0 @@
-/**
- * Navbook core — pure format logic with no I/O and no git.
- *
- * This is the module that later runs in a browser and the one the planned Rust
- * rewrite must reproduce function for function (spec 05 §5.2).
- */
-export * from "./comments.ts";
-export * from "./files.ts";
-export * from "./frontmatter.ts";
-export * from "./id.ts";
-export * from "./json.ts";
-export * from "./ops.ts";
-export * from "./person.ts";
-export * from "./query.ts";
-export * from "./refs.ts";
-export * from "./slug.ts";
-export * from "./time.ts";
-export * from "./tree.ts";
-export * from "./validate.ts";

package/dist/core/index.js

@@ -1,20 +0,0 @@
-/**
- * Navbook core — pure format logic with no I/O and no git.
- *
- * This is the module that later runs in a browser and the one the planned Rust
- * rewrite must reproduce function for function (spec 05 §5.2).
- */
-export * from "./comments.js";
-export * from "./files.js";
-export * from "./frontmatter.js";
-export * from "./id.js";
-export * from "./json.js";
-export * from "./ops.js";
-export * from "./person.js";
-export * from "./query.js";
-export * from "./refs.js";
-export * from "./slug.js";
-export * from "./time.js";
-export * from "./tree.js";
-export * from "./validate.js";
-//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC"}

package/dist/core/json.d.ts

@@ -1,18 +0,0 @@
-/**
- * Canonical machine-readable projection — spec 04 §4.2.
- *
- * The shape lives in `core` so every implementation emits byte-identical
- * `--json` output and differential testing stays meaningful. Output is
- * newline-delimited JSON: one object per entity, one object per line.
- *
- * `list` emits entity objects alone; `show` adds a `comments` array. No key
- * ever changes type between commands.
- */
-import type { CommentRecord, EntityRecord } from "./tree.ts";
-export declare const NAVBOOK_ROOT = ".navbook";
-/** One entity: identity first, then its frontmatter in file order, then body. */
-export declare function entityJson(entity: EntityRecord, extra?: Record<string, unknown>): Record<string, unknown>;
-/** One comment, including any review fields it carries. */
-export declare function commentJson(comment: CommentRecord): Record<string, unknown>;
-/** Serialize objects as newline-delimited JSON (one per line). */
-export declare function toNdjson(objects: readonly Record<string, unknown>[]): string;

package/dist/core/json.js

@@ -1,51 +0,0 @@
-/**
- * Canonical machine-readable projection — spec 04 §4.2.
- *
- * The shape lives in `core` so every implementation emits byte-identical
- * `--json` output and differential testing stays meaningful. Output is
- * newline-delimited JSON: one object per entity, one object per line.
- *
- * `list` emits entity objects alone; `show` adds a `comments` array. No key
- * ever changes type between commands.
- */
-import { keysInOrder } from "./frontmatter.js";
-export const NAVBOOK_ROOT = ".navbook";
-/** One entity: identity first, then its frontmatter in file order, then body. */
-export function entityJson(entity, extra = {}) {
-    const out = {
-        id: entity.id,
-        slug: entity.slug,
-        kind: entity.kind,
-        status: entity.status,
-        path: `${NAVBOOK_ROOT}/${entity.dirPath}`,
-    };
-    if (entity.archived)
-        out.archived = true;
-    for (const key of keysInOrder(entity.parsed.nav)) {
-        if (key === "" || key in out)
-            continue;
-        out[key] = entity.fm[key];
-    }
-    out.body = entity.body.trim();
-    return { ...out, ...extra };
-}
-/** One comment, including any review fields it carries. */
-export function commentJson(comment) {
-    const out = {
-        id: comment.id,
-        path: `${NAVBOOK_ROOT}/${comment.path}`,
-        created: comment.stamp,
-    };
-    for (const key of keysInOrder(comment.parsed.nav)) {
-        if (key === "" || key in out)
-            continue;
-        out[key] = comment.parsed.fm[key];
-    }
-    out.body = comment.body.trim();
-    return out;
-}
-/** Serialize objects as newline-delimited JSON (one per line). */
-export function toNdjson(objects) {
-    return objects.map((o) => JSON.stringify(o)).join("\n");
-}
-//# sourceMappingURL=json.js.map

package/dist/core/json.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/core/json.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;AAEvC,iFAAiF;AACjF,MAAM,UAAU,UAAU,CACxB,MAAoB,EACpB,QAAiC,EAAE;IAEnC,MAAM,GAAG,GAA4B;QACnC,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,IAAI,EAAE,GAAG,YAAY,IAAI,MAAM,CAAC,OAAO,EAAE;KAC1C,CAAC;IACF,IAAI,MAAM,CAAC,QAAQ;QAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC;IACzC,KAAK,MAAM,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACjD,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,IAAI,GAAG;YAAE,SAAS;QACvC,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IACD,GAAG,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC9B,OAAO,EAAE,GAAG,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;AAC9B,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,WAAW,CAAC,OAAsB;IAChD,MAAM,GAAG,GAA4B;QACnC,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,IAAI,EAAE,GAAG,YAAY,IAAI,OAAO,CAAC,IAAI,EAAE;QACvC,OAAO,EAAE,OAAO,CAAC,KAAK;KACvB,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,IAAI,GAAG;YAAE,SAAS;QACvC,GAAG,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IACD,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC/B,OAAO,GAAG,CAAC;AACb,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,QAAQ,CAAC,OAA2C;IAClE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1D,CAAC"}

package/dist/core/ops.d.ts

@@ -1,92 +0,0 @@
-/**
- * Operation planners.
- *
- * Every mutating Navbook command is a pure function from the current tree to a
- * list of {@link FileOp}s plus a commit plan. Nothing here touches the file
- * system or git, which keeps the whole mutation surface testable in memory and
- * gives the future Rust rewrite a function-for-function target.
- */
-import { type Revision } from "./files.ts";
-import { type EntityKind, type EntityRecord } from "./tree.ts";
-export type FileOp = 
-/** Create or overwrite a file, creating parent directories as needed. */
-{
-    op: "write";
-    path: string;
-    content: string;
-}
-/** Rename a file or a whole directory; refuses when the destination exists. */
- | {
-    op: "move";
-    from: string;
-    to: string;
-};
-export interface Trailer {
-    key: "Refs" | "Closes";
-    id: string;
-}
-export interface Plan {
-    ops: FileOp[];
-    message: string;
-    trailers: Trailer[];
-}
-/** Paths (relative to `.navbook/`) an operation may legitimately touch. */
-export declare function planPaths(plan: Plan): string[];
-/**
- * Commit subject for a change to one entity, e.g. `docs(issue): close #bqlybac0`.
- *
- * Conventional Commits, scoped by entity kind: history readers filter Navbook's
- * commits with the same `docs` type they already use for documentation, and the
- * scope says at a glance whether an issue or a pull request moved (spec 03 §3.2).
- */
-export declare function docsSubject(kind: EntityKind, action: string, id: string): string;
-/** The `.navbook/` skeleton, with `.gitkeep` files so empty status dirs commit. */
-export declare function planInit(): Plan;
-export interface OpenResult {
-    plan: Plan;
-    id: string;
-    slug: string;
-    dirPath: string;
-    filePath: string;
-}
-/**
- * Create an entity directory holding the given file text.
- *
- * The caller renders the file (with {@link newIssueFile}/{@link newPrFile}, or
- * straight from an editor buffer) and passes the title that names the slug, so
- * a title edited in the buffer still decides the directory name.
- */
-export declare function planEntityOpen(kind: EntityKind, id: string, title: string, content: string): OpenResult;
-export interface CommentResult {
-    plan: Plan;
-    id: string;
-    path: string;
-}
-/** Add a comment (or review) file to an entity's `comments/` directory. */
-export declare function planComment(entity: EntityRecord, id: string, date: Date, content: string, opts?: {
-    review?: boolean;
-}): CommentResult;
-export interface CloseInput {
-    resolution?: string;
-    duplicateOf?: string;
-}
-/** Move an entity to `closed/`, optionally recording a resolution. */
-export declare function planClose(entity: EntityRecord, input?: CloseInput): Plan;
-/** Move an entity back to `open/`, clearing the resolution it was closed with. */
-export declare function planReopen(entity: EntityRecord): Plan;
-/** Move a merged pull request into `prs/merged/` (spec 03 §3.5). */
-export declare function planArchiveMerged(entity: EntityRecord): Plan;
-/** Apply frontmatter changes to an entity file, or null when nothing changes. */
-export declare function rewriteFrontmatter(entity: EntityRecord, changes: Record<string, unknown>): string | null;
-export declare class RevisionUnchangedError extends Error {
-}
-/** Append a revision entry; entries are append-only (§2.7). */
-export declare function planPrUpdate(entity: EntityRecord, revision: Revision): Plan;
-export interface MergedBlock {
-    date: string;
-    by: string;
-    /** Absent after a fast-forward, which creates no merge commit to name. */
-    commit?: string;
-}
-/** Record the `merged:` block after the merge commit exists (§2.7). */
-export declare function planMergedBlock(entity: EntityRecord, merged: MergedBlock): Plan;

package/dist/core/ops.js

@@ -1,173 +0,0 @@
-/**
- * Operation planners.
- *
- * Every mutating Navbook command is a pure function from the current tree to a
- * list of {@link FileOp}s plus a commit plan. Nothing here touches the file
- * system or git, which keeps the whole mutation surface testable in memory and
- * gives the future Rust rewrite a function-for-function target.
- */
-import { commentFileName } from "./comments.js";
-import { readRevisions } from "./files.js";
-import { appendListItem, parseDoc, patchDoc, serializeDoc } from "./frontmatter.js";
-import { dirName as makeDirName, slugify } from "./slug.js";
-import { statusDir } from "./tree.js";
-/** Paths (relative to `.navbook/`) an operation may legitimately touch. */
-export function planPaths(plan) {
-    const paths = new Set();
-    for (const op of plan.ops) {
-        if (op.op === "write")
-            paths.add(op.path);
-        else {
-            paths.add(op.from);
-            paths.add(op.to);
-        }
-    }
-    return [...paths];
-}
-/**
- * Commit subject for a change to one entity, e.g. `docs(issue): close #bqlybac0`.
- *
- * Conventional Commits, scoped by entity kind: history readers filter Navbook's
- * commits with the same `docs` type they already use for documentation, and the
- * scope says at a glance whether an issue or a pull request moved (spec 03 §3.2).
- */
-export function docsSubject(kind, action, id) {
-    return `docs(${kind}): ${action} #${id}`;
-}
-/* --------------------------------------------------------------------- init */
-/** The `.navbook/` skeleton, with `.gitkeep` files so empty status dirs commit. */
-export function planInit() {
-    const dirs = ["issues/open", "issues/closed", "prs/open", "prs/merged", "prs/closed"];
-    return {
-        ops: dirs.map((dir) => ({ op: "write", path: `${dir}/.gitkeep`, content: "" })),
-        // No entity to scope to: init creates the whole skeleton.
-        message: "docs: initialize navbook",
-        trailers: [],
-    };
-}
-/**
- * Create an entity directory holding the given file text.
- *
- * The caller renders the file (with {@link newIssueFile}/{@link newPrFile}, or
- * straight from an editor buffer) and passes the title that names the slug, so
- * a title edited in the buffer still decides the directory name.
- */
-export function planEntityOpen(kind, id, title, content) {
-    const slug = slugify(title);
-    const dirPath = `${statusDir(kind, "open")}/${makeDirName(id, slug)}`;
-    const filePath = `${dirPath}/${kind === "issue" ? "issue.md" : "pr.md"}`;
-    return {
-        plan: {
-            ops: [{ op: "write", path: filePath, content }],
-            message: docsSubject(kind, "open", id),
-            trailers: [],
-        },
-        id,
-        slug,
-        dirPath,
-        filePath,
-    };
-}
-/** Add a comment (or review) file to an entity's `comments/` directory. */
-export function planComment(entity, id, date, content, opts = {}) {
-    const path = `${entity.dirPath}/comments/${commentFileName(date, id)}`;
-    return {
-        plan: {
-            ops: [{ op: "write", path, content }],
-            message: docsSubject(entity.kind, opts.review ? "review" : "comment on", entity.id),
-            trailers: [{ key: "Refs", id: entity.id }],
-        },
-        id,
-        path,
-    };
-}
-/** Move an entity to `closed/`, optionally recording a resolution. */
-export function planClose(entity, input = {}) {
-    const resolution = input.resolution ?? (input.duplicateOf ? "duplicate" : undefined);
-    const changes = {};
-    if (resolution)
-        changes.resolution = resolution;
-    if (input.duplicateOf)
-        changes["duplicate-of"] = input.duplicateOf;
-    return {
-        ops: moveWithFrontmatter(entity, "closed", changes),
-        message: docsSubject(entity.kind, "close", entity.id),
-        trailers: [{ key: "Closes", id: entity.id }],
-    };
-}
-/** Move an entity back to `open/`, clearing the resolution it was closed with. */
-export function planReopen(entity) {
-    const changes = { resolution: undefined };
-    if (entity.fm.resolution === "duplicate")
-        changes["duplicate-of"] = undefined;
-    if (entity.fm.resolution === "superseded")
-        changes["superseded-by"] = undefined;
-    return {
-        ops: moveWithFrontmatter(entity, "open", changes),
-        message: docsSubject(entity.kind, "reopen", entity.id),
-        trailers: [{ key: "Refs", id: entity.id }],
-    };
-}
-/** Move a merged pull request into `prs/merged/` (spec 03 §3.5). */
-export function planArchiveMerged(entity) {
-    return {
-        ops: moveWithFrontmatter(entity, "merged", {}),
-        message: docsSubject(entity.kind, "archive merged", entity.id),
-        trailers: [{ key: "Refs", id: entity.id }],
-    };
-}
-/**
- * Move an entity between status directories, applying frontmatter changes to
- * the file at its *new* location so the ops apply in order.
- */
-function moveWithFrontmatter(entity, status, changes) {
-    const ops = [];
-    const targetDir = `${statusDir(entity.kind, status)}/${entity.dirName}`;
-    const moved = targetDir !== entity.dirPath;
-    if (moved)
-        ops.push({ op: "move", from: entity.dirPath, to: targetDir });
-    const fileName = entity.kind === "issue" ? "issue.md" : "pr.md";
-    const rewritten = rewriteFrontmatter(entity, changes);
-    if (rewritten !== null) {
-        ops.push({ op: "write", path: `${targetDir}/${fileName}`, content: rewritten });
-    }
-    return ops;
-}
-/** Apply frontmatter changes to an entity file, or null when nothing changes. */
-export function rewriteFrontmatter(entity, changes) {
-    const meaningful = Object.entries(changes).filter(([key, value]) => value === undefined ? entity.fm[key] !== undefined : entity.fm[key] !== value);
-    if (meaningful.length === 0)
-        return null;
-    const nav = parseDoc(serializeDoc(entity.parsed.nav));
-    patchDoc(nav, Object.fromEntries(meaningful));
-    return serializeDoc(nav);
-}
-/* ------------------------------------------------------------ pull requests */
-export class RevisionUnchangedError extends Error {
-}
-/** Append a revision entry; entries are append-only (§2.7). */
-export function planPrUpdate(entity, revision) {
-    const existing = readRevisions(entity.fm);
-    const last = existing[existing.length - 1];
-    if (last && last.head === revision.head) {
-        throw new RevisionUnchangedError(`HEAD ${revision.head.slice(0, 8)} is already the latest recorded revision of #${entity.id}`);
-    }
-    const nav = parseDoc(serializeDoc(entity.parsed.nav));
-    appendListItem(nav, "revisions", revision);
-    return {
-        ops: [{ op: "write", path: entity.filePath, content: serializeDoc(nav) }],
-        message: docsSubject(entity.kind, "update", entity.id),
-        trailers: [{ key: "Refs", id: entity.id }],
-    };
-}
-/** Record the `merged:` block after the merge commit exists (§2.7). */
-export function planMergedBlock(entity, merged) {
-    const nav = parseDoc(serializeDoc(entity.parsed.nav));
-    patchDoc(nav, { merged });
-    return {
-        ops: [{ op: "write", path: entity.filePath, content: serializeDoc(nav) }],
-        message: docsSubject(entity.kind, "merge", entity.id),
-        trailers: [{ key: "Refs", id: entity.id }],
-    };
-}
-//# sourceMappingURL=ops.js.map