waterplane 0.0.1 → 0.1.6

package/node_modules/@waterplane/shared/dist/naming.js

@@ -0,0 +1,571 @@
+/**
+ * What a machine may call somebody else's words.
+ *
+ * ── Why this file exists ───────────────────────────────────────────────────
+ *
+ * A headline is the one string in this app that a MODEL writes FOR a person,
+ * over words the person wrote themselves. Everything else a model produces here
+ * either runs (a prompt), cites (evidence) or explains (a note); a headline sits
+ * on top of a row in a list and is the thing a reader scans instead of the
+ * sentence underneath it. That makes it the one string that can quietly replace
+ * somebody's own writing in the only place they look.
+ *
+ * So three rules, and each is enforced here rather than asked for politely:
+ *
+ *   • **It never stands in for them.** `itemHeadline` is the ONE display rule
+ *     for both ends: a title a person typed wins, always, and a derived headline
+ *     is what a row falls back to. Two copies of that rule is two answers to
+ *     "whose words are on this row".
+ *   • **It never replaces a name they typed.** Every headline and every kind
+ *     carries an AUTHOR (`NameAuthor`) and is stored with it or not at all — a
+ *     title that cannot say who wrote it cannot say whether a person may be
+ *     overwritten, so the pair travels together and is dropped together.
+ *   • **It is never guessed.** `cleanCategory` knows four words and no
+ *     synonyms: `"bugfix"` is `undefined`, never `chore`. A synonym table is a
+ *     second vocabulary, and a second vocabulary is how "no kind" becomes
+ *     "chore" for every row nobody looked at.
+ *
+ * And a fourth, which is the shape of the caps: a headline is a LABEL, so it is
+ * CLIPPED rather than dropped for length — the opposite of `assess.ts`'s
+ * prompts, which are dropped rather than cut, because half a title is still a
+ * title and half an instruction is a different instruction.
+ *
+ * ── What is deliberately NOT here ──────────────────────────────────────────
+ *
+ * No filesystem, no clock, no host imports, and — deliberately — no import of
+ * `assess.ts`, which imports THIS. The vocabulary has to be nameable by the
+ * module that judges it, so it lives one level below it.
+ */
+import { typedName } from "./schedule.js";
+export const ITEM_CATEGORIES = ["bug", "feature", "enhancement", "chore"];
+export const NAME_AUTHORS = ["hand", "assess", "name"];
+/**
+ * A headline is a LABEL, so it is clipped, never dropped for length. 80 =
+ * `cleanIntentRow`'s label cap, so the prompt and the store name one number.
+ */
+export const MAX_HEADLINE_CHARS = 80;
+/**
+ * How many refusal notes a naming document may produce.
+ *
+ * The same number as `MAX_ASSESS_NOTES`, for the same reason and kept here
+ * rather than imported because `assess.ts` imports this module and a cycle over
+ * one integer is not a trade worth making. It is nearly unreachable by
+ * construction: the notes below are AGGREGATED — one per kind of drop, with a
+ * count — so a run that mis-names two hundred rows produces four sentences, not
+ * two hundred.
+ */
+export const MAX_NAMING_NOTES = 40;
+/** The word a row shows when nothing said what kind of thing it is. Absent is
+ *  an answer, and this is how that answer is spelled — never a fifth category,
+ *  and never "chore". */
+export const NO_CATEGORY_LABEL = "no kind";
+// ── Cleaning one value ───────────────────────────────────────────────────────
+/** One pair of wrapping quotes, in the shapes a model actually emits. */
+const QUOTE_PAIRS = [
+    ['"', '"'], ["'", "'"], ["“", "”"], ["‘", "’"], ["`", "`"],
+];
+/**
+ * A title a model wrote about `text`, or nothing.
+ *
+ * Tolerant about shape — a quoted string, a trailing full stop, ragged
+ * whitespace and a run-on past the cap are all cosmetics, and refusing a whole
+ * naming run over punctuation just means the user pays for it twice. Strict
+ * about ONE thing: a "title" that is merely the first words of its own item is
+ * not a title.
+ *
+ * ── Why the test here is ONE-directional, and `typedName`'s is two ──────────
+ *
+ * `typedName` answers a different question: *is the string in the name slot a
+ * name, or is it the derivation this app itself wrote there?* Both ends fill
+ * that slot with `text.slice(0, sliceLen)` when nobody typed one, so it has to
+ * refuse in both directions — the text starting with the name (the ordinary
+ * case) AND the name starting with the text's own leading slice, which is what
+ * a multi-line prompt shorter than the slice looks like.
+ *
+ * A HEADLINE has no such derivation behind it. Nothing in this app ever writes
+ * one out of the prompt, so the only shape worth refusing is the one that means
+ * *this is a truncation of the item*: `text` starts with the headline. Borrowing
+ * the second clause refused a whole class of perfectly good titles — for any
+ * prompt under 40 characters, EVERY title that opens with the whole prompt.
+ * Text `dark mode`, title `dark mode toggle for settings`: dropped, and (before
+ * `edit()` learned to say so) dropped in silence.
+ *
+ * Both sides are whitespace-collapsed before the comparison, because `s` above
+ * already is: without it a prompt that wraps between two of its own opening
+ * words would read as a different string and the truncation would go through.
+ *
+ * `text` may be empty — a build or a capture has no prose — and an empty text is
+ * "there is nothing to be a truncation of", never "everything is one".
+ */
+export function cleanHeadline(raw, text) {
+    if (typeof raw !== "string")
+        return undefined;
+    let s = raw.trim().replace(/\s+/g, " ");
+    for (const [open, close] of QUOTE_PAIRS) {
+        if (s.length >= 2 && s.startsWith(open) && s.endsWith(close)) {
+            s = s.slice(1, -1).trim();
+            break;
+        }
+    }
+    // One trailing full stop, and only when it is alone: an ellipsis is a model
+    // saying the title was cut off, and turning "…" into ".." would keep the
+    // claim while making it look like a typo.
+    if (s.endsWith(".") && !s.endsWith(".."))
+        s = s.slice(0, -1).trim();
+    if (!s)
+        return undefined;
+    if (s.length > MAX_HEADLINE_CHARS)
+        s = s.slice(0, MAX_HEADLINE_CHARS).trim();
+    const t = (text ?? "").trim().replace(/\s+/g, " ");
+    if (t && t.startsWith(s))
+        return undefined;
+    return s;
+}
+/**
+ * **Why a title somebody typed was not written**, in one sentence.
+ *
+ * Here, beside the rule that refuses it, because the refusal and its wording
+ * are the same fact: `cleanHeadline` returning `undefined` used to be a silent
+ * drop — the editor closed, the row kept its old title, and the words a person
+ * had just typed were gone with nothing on any screen about it. CLAUDE.md's
+ * *never overwrite typed words with words nobody typed* has a quieter twin, and
+ * this is it: never DROP typed words without saying so.
+ *
+ * It names what was refused, because a sentence about "the title" on a screen
+ * with two of them is a sentence the reader has to guess at.
+ */
+export function headlineRefusedText(headline) {
+    return `"${headline.trim().replace(/\s+/g, " ").slice(0, MAX_HEADLINE_CHARS)}" is how this item already starts, so it would say the same words twice — the title you had was kept`;
+}
+/** The same, for a kind that is not one of the four. No synonym table here and
+ *  none in the sentence: it says the four words rather than guessing which was
+ *  meant (`cleanCategory`). */
+export function categoryRefusedText(category) {
+    return `"${category.trim().slice(0, 40)}" is not one of ${ITEM_CATEGORIES.join("/")} — the kind was left as it was`;
+}
+/**
+ * One of the four words, or nothing at all.
+ *
+ * Case and surrounding space are cosmetics. Everything else is refused: there
+ * is no synonym table here and there must not be one, because the cost of a
+ * wrong kind is a row filed under a heading its author never chose and would
+ * never think to look under.
+ */
+export function cleanCategory(raw) {
+    if (typeof raw !== "string")
+        return undefined;
+    const s = raw.trim().toLowerCase();
+    return ITEM_CATEGORIES.find((c) => c === s);
+}
+/** Who wrote it — one of three, or nothing. Same posture as `cleanCategory`:
+ *  an author this app does not know is not an author. */
+export function cleanAuthor(raw) {
+    if (typeof raw !== "string")
+        return undefined;
+    const s = raw.trim().toLowerCase();
+    return NAME_AUTHORS.find((a) => a === s);
+}
+/** The finished sentences, so both drops are worded once. `assess.ts` says the
+ *  same two things about its own rows and must not word them differently. */
+export function headlineDropNote(n) {
+    return `${n} headline(s) were only the first words of their item and were left off`;
+}
+export function categoryDropNote(n) {
+    return `${n} kind(s) were not one of ${ITEM_CATEGORIES.join("/")} and were left off`;
+}
+/**
+ * Whatever a naming run wrote, plus the rows it was asked about, in — one name
+ * per KNOWN row, out.
+ *
+ * `cleanAssessment`'s posture, for `cleanAssessment`'s reasons. Tolerant about
+ * SHAPE: a bare array, `{items:[…]}` and `{rows:[…]}` are all the same
+ * document, because the difference is the model's and the cost is the user's.
+ * Strict about CLAIMS: a name for an id nobody asked about is dropped, and an
+ * id named TWICE loses both names — two titles for one row say two things about
+ * what it is, neither is trustworthy, and picking the first is picking at
+ * random.
+ *
+ * The notes are AGGREGATED — one sentence per kind of drop, carrying the count.
+ * A naming run touches every row in a repo, so one note per row would be a
+ * scroll nobody reads, and the fact worth showing is "eleven of these were
+ * thrown away", not which eleven.
+ */
+export function cleanNamingDoc(raw, ids) {
+    const texts = new Map();
+    for (const t of ids) {
+        if (typeof t === "string") {
+            if (t)
+                texts.set(t, "");
+            continue;
+        }
+        if (t && typeof t.id === "string" && t.id)
+            texts.set(t.id, typeof t.text === "string" ? t.text : "");
+    }
+    const doc = (raw && typeof raw === "object" ? raw : {});
+    const arr = (v) => (Array.isArray(v) ? v : []).filter((x) => !!x && typeof x === "object");
+    const rows = Array.isArray(raw) ? arr(raw) : arr(doc.items).length ? arr(doc.items) : arr(doc.rows);
+    const names = {};
+    const seen = new Set();
+    const duplicated = new Set();
+    let unknown = 0;
+    let headlineDrops = 0;
+    let categoryDrops = 0;
+    for (const r of rows) {
+        const id = typeof r.id === "string" ? r.id.trim() : "";
+        if (!id)
+            continue;
+        if (!texts.has(id)) {
+            unknown++;
+            continue;
+        }
+        if (seen.has(id)) {
+            duplicated.add(id);
+            continue;
+        }
+        seen.add(id);
+        const headline = cleanHeadline(r.headline ?? r.title, texts.get(id) ?? "");
+        if (headline === undefined && typeof (r.headline ?? r.title) === "string")
+            headlineDrops++;
+        const category = cleanCategory(r.category ?? r.kind);
+        if (category === undefined && typeof (r.category ?? r.kind) === "string")
+            categoryDrops++;
+        if (headline === undefined && category === undefined)
+            continue;
+        names[id] = { ...(headline !== undefined ? { headline } : {}), ...(category !== undefined ? { category } : {}) };
+    }
+    for (const id of duplicated)
+        delete names[id];
+    const notes = [];
+    const note = (s) => { if (notes.length < MAX_NAMING_NOTES)
+        notes.push(s); };
+    if (unknown)
+        note(`${unknown} name(s) were for items that were not in the list and were dropped`);
+    if (duplicated.size)
+        note(`${duplicated.size} item(s) were named more than once, so neither name was used`);
+    if (headlineDrops)
+        note(headlineDropNote(headlineDrops));
+    if (categoryDrops)
+        note(categoryDropNote(categoryDrops));
+    return { names, notes };
+}
+// ── Display ──────────────────────────────────────────────────────────────────
+/**
+ * **The ONE display rule**: what this row is CALLED, on both ends.
+ *
+ * A `label` is what a person typed, so it wins — but only when it is a name and
+ * not a slice of the row's own prose, which is what `typedName` is for and what
+ * the backlog's own 40-character derivation makes the common case. A `headline`
+ * is the machine's, and stands only where a person put nothing.
+ *
+ * `null`, never the text, when neither: the caller decides whether a nameless
+ * row shows its first line or shows nothing, and that decision differs by
+ * screen. What must not differ by screen is which of the two strings wins.
+ */
+export function itemHeadline(it) {
+    const typed = typedName(it.label, it.text, 40);
+    if (typed)
+        return typed;
+    const machine = (it.headline ?? "").trim();
+    return machine || null;
+}
+/**
+ * The ONE place a kind becomes a word.
+ *
+ * The four words are their own labels today, which is exactly why this is a
+ * function: `assessVerdictLabel`'s rule — when a heading is re-worded it has to
+ * be re-worded once, and a `switch` is what makes the compiler say so when a
+ * fifth kind appears.
+ */
+export function categoryLabel(c) {
+    switch (c) {
+        case "bug": return "bug";
+        case "feature": return "feature";
+        case "enhancement": return "enhancement";
+        case "chore": return "chore";
+    }
+}
+// ── The session tab's own title ──────────────────────────────────────────────
+/**
+ * How many words a tab title may be, and how many characters that is allowed to
+ * cost.
+ *
+ * Four words, and the strip is sized for three tabs by default — the two
+ * numbers moved together, because they are the same trade seen from each end:
+ * how much of a name there is to read, and how much room there is to read it
+ * in. The words are what the SESSION SCREEN shows in full when you open it
+ * (`App.tsx`'s header), so the cap is set by what is worth having there rather
+ * than by what fits a 90 px tab, which clips to its own width regardless.
+ *
+ * The character cap is the second half of the same fact — four words can still
+ * be four long ones, and the cap is what stops one name from being the whole
+ * strip. It is a REFUSAL boundary, not a clip: see below.
+ */
+export const MAX_TAB_WORDS = 4;
+export const MAX_TAB_CHARS = 30;
+/**
+ * The ≤4-word title a model wrote for a session tab, or nothing.
+ *
+ * `cleanHeadline`'s tolerance about shape, with two differences that are both
+ * about the strip this lands in:
+ *
+ *  - **Words are CUT, never joined with an ellipsis.** A tab is a label, and
+ *    "fix the auth…" in 90 px reads as a truncation of something longer, which
+ *    is exactly what it is not: the model was asked for four words and this
+ *    keeps the first four it wrote.
+ *  - **It refuses rather than guesses.** An empty answer, a refusal sentence
+ *    ("I cannot"), or anything past the character cap once the words are cut,
+ *    comes back `undefined` — and the tab then wears the repo and branch it
+ *    always had. CLAUDE.md's rule for every heuristic here: degrade to absent,
+ *    never to a wrong number, and a wrong TITLE is the version of that which a
+ *    person taps.
+ *
+ * Deliberately not `cleanHeadline` with a smaller cap: that one clips mid-word
+ * on purpose (a headline is prose and a cut word still reads), and it also
+ * refuses a title that is how its own text starts — a rule about backlog rows
+ * that has no meaning for a terminal session, which has no "text" to be a
+ * truncation of.
+ */
+export function cleanTabTitle(raw) {
+    if (typeof raw !== "string")
+        return undefined;
+    let s = raw.trim().replace(/\s+/g, " ");
+    for (const [open, close] of QUOTE_PAIRS) {
+        if (s.length >= 2 && s.startsWith(open) && s.endsWith(close)) {
+            s = s.slice(1, -1).trim();
+            break;
+        }
+    }
+    // A trailing full stop on a two-word label is a model finishing a sentence it
+    // was not asked for. An ellipsis is left alone for `cleanHeadline`'s reason —
+    // but a title carrying one is a title the model says it cut, so it is refused
+    // below rather than shown with the claim intact.
+    if (s.endsWith(".") && !s.endsWith(".."))
+        s = s.slice(0, -1).trim();
+    if (!s || /[…]|\.\.\./.test(s))
+        return undefined;
+    const words = s.split(" ").filter(Boolean).slice(0, MAX_TAB_WORDS);
+    // Words come OFF THE END until the label fits, rather than the whole title
+    // being refused for length: two of the three words is still a title, and the
+    // model's first words are the ones it led with. Only a single word that is
+    // longer than the strip has nothing left to drop, and that one is refused —
+    // clipping it would put an ellipsis back on a label that is not prose.
+    while (words.length > 1 && words.join(" ").length > MAX_TAB_CHARS)
+        words.pop();
+    s = words.join(" ");
+    if (!s || s.length > MAX_TAB_CHARS)
+        return undefined;
+    return s;
+}
+// ── The branch a row does not need to say ────────────────────────────────────
+/**
+ * The branch names that mean "the ordinary place", and so say nothing.
+ *
+ * Two, and no pattern. `main` and `master` are the two names git itself
+ * creates; anything else was CHOSEN, and a chosen name is information. A repo
+ * whose default really is `develop` keeps seeing `develop` — which is the safe
+ * direction for a guess about somebody else's repo: the failure mode of this
+ * list is showing a word that could have been hidden, never hiding one that
+ * had to be read.
+ *
+ * There is no default-branch field on the wire to ask instead: `RepoTarget`
+ * carries the branch a worktree is ON, not the branch the repo considers home.
+ */
+export const DEFAULT_BRANCH_NAMES = ["main", "master"];
+/** Whether a branch name is one of the two git makes on its own. */
+export function isDefaultBranch(raw) {
+    return typeof raw === "string" && DEFAULT_BRANCH_NAMES.includes(raw.trim().toLowerCase());
+}
+/**
+ * What a row should SAY about the branch it is on — or nothing.
+ *
+ * `undefined` means "saying this adds nothing", and every caller falls back to
+ * the repo's own name rather than drawing a blank. On a phone the session list
+ * is one row of ~30 characters per session, and on a desktop where every repo
+ * sits on `main` that word was the FIRST thing on every row, pushing the
+ * derived name, the status tags and the age off the end of the line — the same
+ * space that now carries what the session is actually about.
+ *
+ * **Only on the PRIMARY worktree.** A worktree's branch is its whole identity —
+ * `RepoPicker` titles it with nothing else — so a worktree that happens to be
+ * on `main` still says so, or the row loses the only thing that tells it from
+ * its siblings. Pass `isPrimary: false` (or nothing) for those.
+ *
+ * This is display only. `GitView` and `BranchPicker` are ABOUT branches and
+ * never call this: hiding the current branch on the screen you switch branches
+ * from is not tidiness, it is a missing fact.
+ */
+export function branchLabel(r) {
+    const b = (r.branch ?? "").trim();
+    if (!b)
+        return undefined;
+    if (r.isPrimary && isDefaultBranch(b))
+        return undefined;
+    return b;
+}
+/** "<repo> · <branch>", with the branch dropped when it says nothing. */
+export function repoBranchLabel(r) {
+    const b = branchLabel(r);
+    return b ? `${r.repoName} · ${b}` : r.repoName;
+}
+/**
+ * A STORED session title with a trailing default branch taken off.
+ *
+ * New sessions are named `repoBranchLabel`-style and never carry the word, but
+ * a title is persisted with the session and every conversation opened before
+ * this rule still reads `myapp · main`. Trimming at the point it is DRAWN fixes
+ * those without rewriting anybody's stored title — including the ones a person
+ * renamed by hand, where an edit would be exactly the overwrite this file
+ * exists to refuse.
+ *
+ * Only the LAST segment, only when something is left in front of it: a session
+ * somebody called `main` is called `main`.
+ */
+export function trimDefaultBranch(title) {
+    const t = typeof title === "string" ? title.trim() : "";
+    const cut = t.lastIndexOf(" \u00b7 ");
+    if (cut <= 0)
+        return t;
+    return isDefaultBranch(t.slice(cut + 3)) ? t.slice(0, cut) : t;
+}
+/**
+ * **The desktop's own ≤4-word name for a session, or "".**
+ *
+ * `SessionInfo.tabTitle` is derived once per conversation by the host and is
+ * the only string in this app that says what a session is ABOUT — `s.title` is
+ * `<repo> · <branch>`, which four sessions open in one repo all share. The tab
+ * strip wears the name, the session header wears it and the launcher row wears
+ * it; every surface that asks *which session?* was still offering the repo
+ * name four times and the answer never.
+ *
+ * One reader, here beside `branchLabel` and `trimDefaultBranch`, because it is
+ * the same question those two answer: which part of a session's name a row has
+ * to SAY. Trimmed, and "" when the host has derived nothing — never an invented
+ * name, and never the repo wearing the derived name's clothes.
+ */
+export function sessionName(s) {
+    return (s.tabTitle ?? "").trim();
+}
+/**
+ * What a sentence calls a session it is WAITING on ("waiting for 'fix webkit
+ * sync'") — the derived name, else the item it was opened for, else its first
+ * prompt, and only then the title. Five hand sessions in one repo all wear
+ * `myrepo` as their title, so "waiting for 'myrepo'" named none of them; the first
+ * prompt is at least something a person recognises. Clipped by the sentence,
+ * not here. `undefined` when there is nothing to say.
+ */
+export function waitedSessionName(s, itemLabel) {
+    const firstLine = (t) => (t ?? "").split("\n")[0].trim();
+    return sessionName(s) || firstLine(itemLabel) || firstLine(s.firstPrompt) || trimDefaultBranch(s.title) || undefined;
+}
+/**
+ * A session named where there is room for exactly one string — a `<select>`
+ * option, a group head, a toast.
+ *
+ * Repo and branch FIRST, the derived name after: the first part is what tells
+ * two sessions in different repos apart and the second is what tells two in
+ * the SAME repo apart, and a picker read top to bottom needs them in that
+ * order. A row with room for two spans draws them side by side instead
+ * (`web/SessionName.tsx`), which is what the launcher does.
+ */
+export function sessionPickLabel(s) {
+    const name = sessionName(s);
+    return name ? `${s.title} · ${name}` : s.title;
+}
+// ── The commit message a model wrote for a working tree ──────────────────────
+/**
+ * How long a suggested commit message may be, subject and whole.
+ *
+ * The subject cap is a REFUSAL boundary, not a clip — same rule as
+ * `cleanTabTitle`'s. A subject is the one line every `git log` shows, and
+ * cutting one mid-thought produces a sentence nobody wrote; a model that came
+ * back with a 200-character first line ignored its contract, and the honest
+ * answer is to say so and leave the box alone.
+ *
+ * The WHOLE cap is a different kind of edge and is enforced differently: body
+ * lines come OFF THE END until it fits, because a message's first paragraph is
+ * the part that was asked for and the rest is elaboration. The subject alone is
+ * never dropped — if it does not fit on its own, the message is refused.
+ */
+export const MAX_COMMIT_SUBJECT = 100;
+export const MAX_COMMIT_CHARS = 1200;
+/**
+ * Lines a suggestion may never carry into a person's commit.
+ *
+ * The models this runs on have written a great many commits with a co-author
+ * trailer and a "generated with" line, and they reproduce them unasked. On a
+ * commit a PERSON is about to make from their phone, both are false claims
+ * about who wrote the change — the model wrote the sentence describing it and
+ * nothing else. Dropped silently rather than refused: the message around them
+ * is usually fine, and a refusal here would read as the model having failed.
+ */
+const TRAILER_RE = /^(?:co-authored-by:|claude-session:|generated with|🤖)/i;
+/** A model saying it will not answer, in the shapes it actually says it. */
+const REFUSAL_RE = /^(?:i\s+(?:cannot|can't|am unable|won't|will not)\b|sorry\b|unable to\b)/i;
+/**
+ * The commit message a model wrote for a diff, or nothing.
+ *
+ * Tolerant about the wrapper a model puts around prose — a code fence, quotes
+ * around the whole thing, `Subject:` labels, ragged blank lines — because those
+ * are cosmetics and refusing over one means the call is paid for twice. Strict
+ * about the two things that would put words nobody wrote into a commit: a
+ * refusal sentence dressed as a message, and an attribution trailer.
+ *
+ * Degrades to `undefined`, never to something approximate. The caller then says
+ * so and the box keeps whatever was typed in it — CLAUDE.md's rule that a draft
+ * is the last copy of somebody's words, and a suggestion that could not be made
+ * must never be a delete.
+ */
+export function cleanCommitMessage(raw) {
+    if (typeof raw !== "string")
+        return undefined;
+    let s = raw.replace(/\r\n?/g, "\n").trim();
+    // A whole answer inside one fence — ```text … ``` — is the commonest wrapper.
+    const fence = /^```[a-zA-Z]*\n([\s\S]*?)\n?```$/.exec(s);
+    if (fence)
+        s = fence[1].trim();
+    for (const [open, close] of QUOTE_PAIRS) {
+        if (s.length >= 2 && s.startsWith(open) && s.endsWith(close) && !s.slice(1, -1).includes("\n")) {
+            s = s.slice(1, -1).trim();
+            break;
+        }
+    }
+    if (!s || REFUSAL_RE.test(s))
+        return undefined;
+    const lines = s.split("\n")
+        .map((l) => l.replace(/\s+$/, ""))
+        .filter((l) => !TRAILER_RE.test(l.trim()));
+    // `Subject:` / `Commit message:` on the first line is a label, not the words.
+    if (lines.length)
+        lines[0] = lines[0].replace(/^(?:subject|commit message|message)\s*:\s*/i, "").trim();
+    while (lines.length && !lines[0].trim())
+        lines.shift();
+    while (lines.length && !lines[lines.length - 1].trim())
+        lines.pop();
+    if (!lines.length)
+        return undefined;
+    const subject = lines[0].trim().replace(/\.$/, "");
+    if (!subject || subject.length > MAX_COMMIT_SUBJECT)
+        return undefined;
+    lines[0] = subject;
+    // A subject with a body needs the blank line between them — git reads the
+    // second line as body otherwise and `%s` swallows the lot.
+    if (lines.length > 1 && lines[1].trim())
+        lines.splice(1, 0, "");
+    // Collapse runs of blank lines, which a model produces freely.
+    const out = [];
+    for (const l of lines) {
+        if (!l.trim() && out.length && !out[out.length - 1].trim())
+            continue;
+        out.push(l);
+    }
+    // Body lines come off the END until the whole fits. The subject never does.
+    while (out.length > 1 && out.join("\n").length > MAX_COMMIT_CHARS)
+        out.pop();
+    while (out.length > 1 && !out[out.length - 1].trim())
+        out.pop();
+    const text = out.join("\n").trim();
+    if (!text || text.length > MAX_COMMIT_CHARS)
+        return undefined;
+    return text;
+}
+//# sourceMappingURL=naming.js.map

package/node_modules/@waterplane/shared/dist/naming.js.map

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

package/node_modules/@waterplane/shared/dist/netfuse.d.ts

@@ -0,0 +1,60 @@
+/**
+ * The fuse on an HTTP request that never answers.
+ *
+ * A dead Tailscale path does not refuse a connection, it SWALLOWS it: the
+ * socket stays open, no bytes come back, and `fetch` waits for as long as the
+ * platform allows — minutes on Android, indefinitely in some WebViews. That
+ * failure mode is indistinguishable from a slow request, and everything the
+ * client does about being offline hangs off the fetch REJECTING: the reader's
+ * cached transcript, the slash cache, the gallery's stale rows. With no fuse
+ * those fallbacks are unreachable code exactly when they are the whole point —
+ * the observed symptom was a reader parked on "loading transcript…" for as
+ * long as anyone cared to watch, with a perfectly good cached document one
+ * IndexedDB read away.
+ *
+ * Deliberately a wall-clock cap rather than `pull.ts`'s stall detector: these
+ * are small JSON responses that arrive in one chunk, so "no answer within N
+ * seconds" is the entire signal. Streaming transfers (auto-download, the speed
+ * test) keep their own progress-based rules, and uploads run on XHR.
+ *
+ * Lives in `shared` for the same reason `queue.ts` and `promptid.ts` do: node
+ * has `fetch`, so the rules can be PINNED by an e2e script against a real
+ * server that hangs, instead of trusted to a comment.
+ */
+/** Generic budget for a JSON call. Long enough that a bad-but-alive link still
+ *  completes, short enough that a dead one is reported while someone is still
+ *  looking at the screen. */
+export declare const FETCH_TIMEOUT_MS = 20000;
+/** The reader polls, so its fuse is shorter than the generic one: a poll still
+ *  pending when the next is due has already failed. */
+export declare const TRANSCRIPT_TIMEOUT_MS = 12000;
+/** Endpoints that run a real command against a repo (push over a slow uplink,
+ *  checkout in a big tree) legitimately take minutes. The fuse exists to stop a
+ *  DEAD link hanging forever, not to cap honest work — cutting a push at 20 s
+ *  would report failure for something the host then completes, which is worse
+ *  than the hang it replaced. */
+export declare const SLOW_OP_TIMEOUT_MS = 180000;
+export declare class TimeoutError extends Error {
+    readonly url: string;
+    readonly ms: number;
+    constructor(url: string, ms: number);
+}
+/**
+ * True for the failures that mean "the host never answered", as opposed to a
+ * status code. Callers use it to say "offline" where they would otherwise print
+ * a stack trace at someone whose tunnel is down — the difference between
+ * "TimeoutError: timed out after 12s" and "can't reach the host".
+ * A 404/500 is NOT offline: the host answered, and the answer was no.
+ */
+export declare function isOffline(e: unknown): boolean;
+/**
+ * `fetch` that rejects with a `TimeoutError` if the host has not answered in
+ * `ms`. Composes with a caller-supplied `signal` (uploads, cancel buttons):
+ * an abort THEY caused stays their own error, so a cancel is never mislabelled
+ * as a dead link. The timer is always cleared, so a phone holding a screen open
+ * for an hour isn't holding a thousand live timers.
+ *
+ * The budget covers the RESPONSE HEADERS, which is what `fetch` resolves on —
+ * a slow body that is actually streaming is not this function's problem.
+ */
+export declare function timedFetch(url: string, init?: RequestInit, ms?: number, doFetch?: typeof fetch): Promise<Response>;