@k-l-lambda/portolan 0.0.0-stage → 0.1.0

package/dist/history.d.ts

@@ -0,0 +1,90 @@
+import type { RhumbDocument } from "./types.ts";
+export interface LineTime {
+    /** Unix seconds. */
+    time: number;
+    /** `commit`: from git blame; `local`: uncommitted change, dated by file mtime. */
+    source: "commit" | "local";
+    sha: string | null;
+}
+export interface Commit {
+    sha: string;
+    time: number;
+    summary: string;
+}
+export interface FileHistory {
+    /** Repository root, or null when the file is not inside a git work tree. */
+    repo: string | null;
+    head: string | null;
+    tracked: boolean;
+    /** File modification time, unix seconds. */
+    mtime: number;
+    /** Lines that differ from HEAD (1-based). */
+    dirtyLines: number;
+    /** Most recent commit that touched this file. */
+    lastCommit: Commit | null;
+    /** Index 0 is line 1. */
+    lines: LineTime[];
+    commits: Record<string, Commit>;
+}
+export interface NodeTime {
+    line: number;
+    /** Unix seconds: the time used for freshness. */
+    time: number;
+    /**
+     * `commit` / `local`: the node line's own time (see LineTime). `link`: the node links to a
+     * dated entry (e.g. `diary:2026/1008`) that is earlier than its commit time, so the
+     * linked date is a better estimate of when the work happened than when the map was committed.
+     * `children`: the node has no links but has child nodes; it takes the newest child's time.
+     */
+    source: "commit" | "local" | "link" | "children";
+    /** Time of the node's own line, kept so the UI can show both. */
+    lineTime: LineTime;
+    /** The dated link that set `time`, when source is `link`. */
+    link: {
+        date: string;
+        target: string;
+    } | null;
+    /** The child whose time was used, when source is `children`. */
+    child: {
+        line: number;
+        id: string | null;
+    } | null;
+}
+/** Parses `git blame --line-porcelain` output. */
+export declare function parseBlame(out: string): {
+    lines: {
+        sha: string;
+        time: number;
+    }[];
+    commits: Record<string, Commit>;
+};
+/** Tracks git history for files; one instance per server. */
+export declare class HistoryTracker {
+    private repoOf;
+    private heads;
+    private cache;
+    private polling;
+    /** Repository root containing `dir`, or null. */
+    repo(dir: string): Promise<string | null>;
+    private head;
+    /** Re-reads HEAD of every known repo; returns the repos whose HEAD changed. */
+    pollHeads(): Promise<string[]>;
+    file(abs: string, version: string): Promise<FileHistory>;
+    private compute;
+}
+/**
+ * Date in a link path: `2026/1008`, `2026-10-08` or `2026/10/08` (a separator after the year
+ * is required, so issue numbers like `20251201` are not dates). Returns the date and the end
+ * of that local day in unix seconds, or null.
+ */
+export declare function linkDate(target: string): {
+    date: string;
+    time: number;
+} | null;
+/**
+ * Update time of each node: the time of the node's own line, unless the node links to a
+ * dated entry whose day is before the day of the line's own time (its commit, or the file
+ * mtime for an uncommitted line); then the latest such linked date wins (end of that day).
+ * A link dated the same day does not count as earlier.
+ */
+export declare function nodeTimes(doc: RhumbDocument, history: FileHistory): NodeTime[];

package/dist/history.js

@@ -0,0 +1,182 @@
+// Per-line update times for .rhumb files, from git history.
+//
+// A line changed in the working tree (or a file that is untracked or outside any repo)
+// is dated by the file's modification time; every other line by the commit that last
+// touched it (`git blame`). Results are cached per file content, mtime and repo HEAD.
+import { execFile } from "node:child_process";
+import { statSync } from "node:fs";
+import { basename, dirname } from "node:path";
+const ZERO_SHA = "0".repeat(40);
+const GIT_ENV = { ...process.env, GIT_OPTIONAL_LOCKS: "0", LC_ALL: "C" };
+function git(cwd, args) {
+    return new Promise((resolve, reject) => {
+        execFile("git", args, { cwd, env: GIT_ENV, timeout: 10_000, maxBuffer: 32 << 20 }, (err, stdout) => err ? reject(err) : resolve(stdout));
+    });
+}
+/** Parses `git blame --line-porcelain` output. */
+export function parseBlame(out) {
+    const lines = [];
+    const commits = {};
+    let sha = "";
+    let time = 0;
+    let summary = "";
+    for (const row of out.split("\n")) {
+        const header = /^([0-9a-f]{40}) \d+ (\d+)/.exec(row);
+        if (header) {
+            sha = header[1];
+            continue;
+        }
+        if (row.startsWith("committer-time "))
+            time = Number(row.slice(15));
+        else if (row.startsWith("summary "))
+            summary = row.slice(8);
+        else if (row.startsWith("\t")) {
+            lines.push({ sha, time });
+            if (sha !== ZERO_SHA && !commits[sha])
+                commits[sha] = { sha, time, summary };
+        }
+    }
+    return { lines, commits };
+}
+/** Tracks git history for files; one instance per server. */
+export class HistoryTracker {
+    repoOf = new Map();
+    heads = new Map();
+    cache = new Map();
+    polling = false;
+    /** Repository root containing `dir`, or null. */
+    repo(dir) {
+        let p = this.repoOf.get(dir);
+        if (!p) {
+            p = git(dir, ["rev-parse", "--show-toplevel"]).then((s) => s.trim() || null, () => null);
+            this.repoOf.set(dir, p);
+        }
+        return p;
+    }
+    async head(repo) {
+        if (!this.heads.has(repo)) {
+            this.heads.set(repo, await git(repo, ["rev-parse", "HEAD"]).then((s) => s.trim(), () => null));
+        }
+        return this.heads.get(repo);
+    }
+    /** Re-reads HEAD of every known repo; returns the repos whose HEAD changed. */
+    async pollHeads() {
+        if (this.polling)
+            return [];
+        this.polling = true;
+        try {
+            const changed = [];
+            for (const [repo, old] of this.heads) {
+                const now = await git(repo, ["rev-parse", "HEAD"]).then((s) => s.trim(), () => null);
+                if (now !== old) {
+                    this.heads.set(repo, now);
+                    changed.push(repo);
+                }
+            }
+            return changed;
+        }
+        finally {
+            this.polling = false;
+        }
+    }
+    async file(abs, version) {
+        const mtime = Math.floor(statSync(abs).mtimeMs / 1000);
+        const repo = await this.repo(dirname(abs));
+        const head = repo ? await this.head(repo) : null;
+        const key = `${version}:${mtime}:${head}`;
+        const hit = this.cache.get(abs);
+        if (hit?.key === key)
+            return hit.value;
+        const value = await this.compute(abs, repo, head, mtime);
+        this.cache.set(abs, { key, value });
+        return value;
+    }
+    async compute(abs, repo, head, mtime) {
+        const local = (count) => Array.from({ length: count }, () => ({ time: mtime, source: "local", sha: null }));
+        const base = {
+            repo, head, tracked: false, mtime, dirtyLines: 0, lastCommit: null, lines: [], commits: {},
+        };
+        if (!repo || !head)
+            return base;
+        let blame;
+        try {
+            blame = parseBlame(await git(dirname(abs), ["blame", "--line-porcelain", "--", basename(abs)]));
+        }
+        catch {
+            return base; // untracked: every line is local
+        }
+        const lines = blame.lines.map((l) => l.sha === ZERO_SHA ? { time: mtime, source: "local", sha: null } : { time: l.time, source: "commit", sha: l.sha });
+        const last = await git(dirname(abs), ["log", "-1", "--format=%H%x00%ct%x00%s", "--", basename(abs)])
+            .then((s) => s.trim().split("\0"), () => []);
+        return {
+            ...base,
+            tracked: true,
+            dirtyLines: lines.filter((l) => l.source === "local").length,
+            lastCommit: last.length === 3 ? { sha: last[0], time: Number(last[1]), summary: last[2] } : null,
+            lines: lines.length > 0 ? lines : local(0),
+            commits: blame.commits,
+        };
+    }
+}
+/**
+ * Date in a link path: `2026/1008`, `2026-10-08` or `2026/10/08` (a separator after the year
+ * is required, so issue numbers like `20251201` are not dates). Returns the date and the end
+ * of that local day in unix seconds, or null.
+ */
+export function linkDate(target) {
+    const path = target.split("#")[0];
+    const re = /(?:^|[^0-9])(20\d\d|19\d\d)[-/](\d\d)[-/]?(\d\d)(?![0-9])/g;
+    for (let m; (m = re.exec(path));) {
+        const [y, mo, d] = [Number(m[1]), Number(m[2]), Number(m[3])];
+        const day = new Date(y, mo - 1, d, 23, 59, 59);
+        if (day.getFullYear() === y && day.getMonth() === mo - 1 && day.getDate() === d) {
+            return { date: `${m[1]}-${m[2]}-${m[3]}`, time: Math.floor(day.getTime() / 1000) };
+        }
+    }
+    return null;
+}
+/** Local calendar day of a unix time, as `YYYY-MM-DD`. */
+function localDay(time) {
+    const d = new Date(time * 1000);
+    return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+}
+/**
+ * Update time of each node: the time of the node's own line, unless the node links to a
+ * dated entry whose day is before the day of the line's own time (its commit, or the file
+ * mtime for an uncommitted line); then the latest such linked date wins (end of that day).
+ * A link dated the same day does not count as earlier.
+ */
+export function nodeTimes(doc, history) {
+    const out = [];
+    // Returns the node's time after its children are computed, so parents can use them.
+    const visit = (n) => {
+        const slot = out.length;
+        out.push(null); // keep pre-order output
+        const kids = n.children.map(visit);
+        const lineTime = history.lines[n.line - 1] ?? { time: history.mtime, source: "local", sha: null };
+        const base = { line: n.line, lineTime, link: null, child: null };
+        let t;
+        if (n.anchors.length === 0 && kids.length > 0) {
+            // No links: the node is as fresh as its newest child.
+            const newest = kids.reduce((a, b) => (b.time > a.time ? b : a));
+            const child = n.children[kids.indexOf(newest)];
+            t = { ...base, time: newest.time, source: "children", child: { line: child.line, id: child.id } };
+        }
+        else {
+            let link = null;
+            for (const a of n.anchors) {
+                const d = linkDate(a.kind === "url" ? a.target : a.path ?? a.target);
+                if (d && (!link || d.time > link.time))
+                    link = { ...d, target: a.target };
+            }
+            t = link !== null && link.date < localDay(lineTime.time)
+                ? { ...base, time: link.time, source: "link", link: { date: link.date, target: link.target } }
+                : { ...base, time: lineTime.time, source: lineTime.source };
+        }
+        out[slot] = t;
+        return t;
+    };
+    doc.nodes.forEach(visit);
+    return out;
+}
+//# sourceMappingURL=history.js.map

package/dist/history.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { isStarred, parse, RHUMB_VERSION } from "./parse.ts";
+export { applyEdit, EditError, type EditOp, type EditResult } from "./edit.ts";
+export { format, type FormatResult } from "./format.ts";
+export { derive, type Derived, type NodeState } from "./derive.ts";
+export { checkAnchors, contextFor, excerpt, githubSlug, resolveAnchor, type ResolveContext, type Resolved } from "./resolve.ts";
+export { foldThreads, ThreadStore, type Message, type Thread, type ThreadAction, type ThreadEvent } from "./threads.ts";
+export { createRhumbServer, versionOf, type ServerOptions } from "./server.ts";
+export { HistoryTracker, linkDate, nodeTimes, parseBlame, type Commit, type FileHistory, type LineTime, type NodeTime } from "./history.ts";
+export type * from "./types.ts";

package/dist/index.js

@@ -0,0 +1,9 @@
+export { isStarred, parse, RHUMB_VERSION } from "./parse.js";
+export { applyEdit, EditError } from "./edit.js";
+export { format } from "./format.js";
+export { derive } from "./derive.js";
+export { checkAnchors, contextFor, excerpt, githubSlug, resolveAnchor } from "./resolve.js";
+export { foldThreads, ThreadStore } from "./threads.js";
+export { createRhumbServer, versionOf } from "./server.js";
+export { HistoryTracker, linkDate, nodeTimes, parseBlame } from "./history.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAgC,MAAM,WAAW,CAAC;AAC/E,OAAO,EAAE,MAAM,EAAqB,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,MAAM,EAAgC,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAsC,MAAM,cAAc,CAAC;AAChI,OAAO,EAAE,WAAW,EAAE,WAAW,EAAkE,MAAM,cAAc,CAAC;AACxH,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAsB,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAA+D,MAAM,cAAc,CAAC"}

package/dist/parse.d.ts

@@ -0,0 +1,33 @@
+import type { Diagnostic, EdgeKind, RhumbDocument, RhumbNode } from "./types.ts";
+export declare const RHUMB_VERSION = "0.1";
+export declare const EDGE_KINDS: Set<EdgeKind>;
+export declare const HAND_ID: RegExp;
+export declare const GEN_ID: RegExp;
+export declare function diagnostic(code: string, line: number, message: string): Diagnostic;
+export interface ParseOptions {
+    /** Used as the default title when front matter has none. */
+    fileName?: string;
+}
+export declare function parse(source: string, options?: ParseOptions): RhumbDocument;
+/** Leading whitespace width with tabs advancing to the next multiple of 4 (CommonMark). */
+export declare function splitIndent(line: string): {
+    indent: number;
+    rest: string;
+};
+export interface Fragment {
+    slug: string | null;
+    text_fragment: string | null;
+    line_prefix: string | null;
+    line_offset: number | null;
+    lines: [number, number] | null;
+    error: string | null;
+}
+/**
+ * Parses the part after `#`, narrowing left to right:
+ *   `slug`, then `:~:text=…` (rest of the fragment) or `^=prefix` / ``^=`prefix` ``, then `+L3` / `-L2`;
+ *   or an absolute `L42` / `L42-L50`.
+ * GitHub slugs are lowercase and never contain `+ ^ = \` : ~`, so these separators are unambiguous.
+ */
+export declare function parseFragment(raw: string): Fragment;
+/** A node is starred only with `{star: true}`; any other value (W010) counts as not starred. */
+export declare function isStarred(node: Pick<RhumbNode, "attrs">): boolean;