things-api 0.8.0 → 0.10.0

package/dist/cli/verb-hint.js

@@ -0,0 +1,138 @@
+import { errorEnvelope, ExitCode, openThings } from "../index.js";
+import { indexPastLeadingFlags, subcommandsOf, WRITE_GROUP_ORDER } from "./resolve-invocation.js";
+import { shellQuote } from "./shell-quote.js";
+/** The type-group a resolved reference maps to a write namespace by. */
+const KIND_GROUP = { "to-do": "todo", project: "project", area: "area" };
+/** Split the raw argv into verb, ref, echo-tail, and the global read opts. */
+function parse(args) {
+    const at = indexPastLeadingFlags(args) ?? 0;
+    const verb = args[at] ?? "";
+    const after = args.slice(at + 1);
+    let json = false;
+    let db;
+    let ref = null;
+    const tail = [];
+    for (let i = 0; i < after.length; i++) {
+        const tok = after[i] ?? "";
+        if (tok === "--json") {
+            json = true;
+        }
+        else if (tok === "--db") {
+            db = after[++i];
+        }
+        else if (tok.startsWith("--db=")) {
+            db = tok.slice("--db=".length);
+        }
+        else if (!tok.startsWith("-") && ref === null) {
+            ref = tok; // the first positional is the write target
+        }
+        else {
+            tail.push(tok);
+        }
+    }
+    // A leading --json/--db (before the verb) still governs output/target.
+    for (let i = 0; i < at; i++) {
+        const tok = args[i] ?? "";
+        if (tok === "--json")
+            json = true;
+        else if (tok === "--db")
+            db = args[++i];
+        else if (tok.startsWith("--db="))
+            db = tok.slice("--db=".length);
+    }
+    return { verb, ref, tail, json, db };
+}
+/** Build `things <group> <verb> <ref?> <trailing flags…>` for the suggestion echo. */
+function typedForm(group, verb, ref, tail) {
+    const parts = ["things", group, verb, ...(ref !== null ? [shellQuote(ref)] : []), ...tail];
+    return parts.join(" ");
+}
+/** The write groups (in a stable order) whose registered verbs include `verb`. */
+function groupsWithVerb(program, verb) {
+    return WRITE_GROUP_ORDER.filter((g) => subcommandsOf(program, g).has(verb));
+}
+/** Classify the ref's type with the read client; null when it does not uniquely resolve. */
+function resolvedGroup(db, ref) {
+    let client = null;
+    try {
+        client = openThings(db ? { dbPath: db } : {});
+        const target = client.read.showTarget(ref);
+        return KIND_GROUP[target.kind] ?? null;
+    }
+    catch {
+        // Ambiguous, unresolvable, or an unreadable db all fall to the generic hint.
+        return null;
+    }
+    finally {
+        client?.close();
+    }
+}
+/**
+ * Compose the suggestion set for a bare verb. The first line is the best guess;
+ * the rest are the other namespaced forms worth offering.
+ */
+function suggestionsFor(program, p) {
+    const verbLower = p.verb.toLowerCase();
+    // add/create: the target is a NEW title, so a name never "resolves" — offer
+    // to-do first (the common intent), then the container namespaces.
+    if (verbLower === "add" || verbLower === "create") {
+        if (p.ref === null)
+            return [];
+        return [
+            typedForm("todo", "add", p.ref, p.tail),
+            typedForm("project", "add", p.ref, p.tail),
+            typedForm("area", "add", p.ref, p.tail),
+        ];
+    }
+    const applicable = groupsWithVerb(program, verbLower);
+    // A ref that uniquely resolves to an area/project/to-do gets ONE concrete
+    // suggestion — but only when that type actually offers the verb.
+    if (p.ref !== null) {
+        const group = resolvedGroup(p.db, p.ref);
+        if (group !== null && applicable.includes(group)) {
+            return [typedForm(group, p.verb, p.ref, p.tail)];
+        }
+    }
+    // Generic: every namespace that offers the verb (fall back to all write
+    // groups if the verb is a synonym none register directly).
+    const groups = applicable.length > 0 ? applicable : WRITE_GROUP_ORDER;
+    return groups.map((g) => typedForm(g, p.verb, p.ref, p.tail));
+}
+/** Human render: the error line, the suggestion(s), and the writes signpost. */
+function renderHuman(verb, suggestions) {
+    const lines = [];
+    if (suggestions.length === 0) {
+        lines.push(`error: \`things ${verb}\` is a write verb but names no target — writes are namespaced.`);
+    }
+    else if (suggestions.length === 1) {
+        lines.push(`error: \`things ${verb} …\` is not a command — did you mean:`);
+        lines.push(`  ${suggestions[0]}`);
+    }
+    else {
+        lines.push(`error: \`things ${verb} …\` is not a command — writes are namespaced. Try:`);
+        for (const s of suggestions)
+            lines.push(`  ${s}`);
+    }
+    lines.push("", "See `things help writes` for the full write grammar.");
+    return lines.join("\n");
+}
+/**
+ * Run the bare-verb hint: emit the suggestion(s) and set the Usage exit code.
+ * Never opens the write pipeline — this only reads to classify the ref.
+ */
+export function runVerbHint(program, args) {
+    const p = parse(args);
+    const suggestions = suggestionsFor(program, p);
+    if (p.json) {
+        const meta = { dbVersion: null, fingerprint: "unknown", elapsedMs: 0 };
+        const message = suggestions.length === 1
+            ? `\`things ${p.verb} …\` is not a command — did you mean \`${suggestions[0]}\``
+            : `\`things ${p.verb} …\` is not a command — writes are namespaced (see \`things help writes\`)`;
+        process.stdout.write(`${JSON.stringify(errorEnvelope({ code: "usage", message, details: { suggestions } }, meta))}\n`);
+    }
+    else {
+        process.stderr.write(`${renderHuman(p.verb, suggestions)}\n`);
+    }
+    process.exitCode = ExitCode.Usage;
+}
+//# sourceMappingURL=verb-hint.js.map

package/dist/cli/verb-hint.js.map

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

package/dist/cli/width.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Width-aware TTY row fitting (docs/design/width-aware-tty.md). Terminal list
+ * rows never wrap: like the Things GUI, an over-long row truncates its title
+ * with a trailing `…` and folds its tags, keeping the always-present metadata
+ * (uuid, box, chips, tail markers, the full deadline token) intact. Everything
+ * here is pure and takes the target width explicitly, so it is unit-testable
+ * without a TTY and byte-stable off one: fitting engages ONLY when the driver
+ * resolves a positive width (setFitWidth) — the default is null (no fitting),
+ * so pipes, grep, and `--json` are untouched by construction.
+ *
+ * No runtime dependency (guest e2e bundles ship node + dist + commander only),
+ * so the display-width math is a small vendored wcwidth: SGR escapes strip to
+ * zero, East-Asian-Wide + emoji-presentation codepoints count two cells, the
+ * rest count one. ZWJ-sequence emoji can be off by a cell (accepted — worst
+ * case a row runs a hair short); the glyph vocabulary (★ ⏾ ⚑ ↻ ⍾ ≡ ◷) is all
+ * ambiguous/narrow class and counts one, so the layout math matches the render.
+ */
+/** Drop every SGR (color/dim/bold/…) escape, leaving the visible characters. */
+export declare function stripSgr(s: string): string;
+/** Terminal cells a single codepoint occupies: 0 (combining/zero-width), 2 (wide), else 1. */
+export declare function charWidth(cp: number): number;
+/** Visible terminal width of a string: SGR-stripped, summed per codepoint. */
+export declare function visibleWidth(s: string): number;
+/**
+ * Truncate PLAIN text (no SGR) to at most `cols` terminal cells, never splitting
+ * a wide codepoint across the boundary. Used to clip a raw title before its
+ * styling wrappers are re-applied, so the ellipsis/clip boundary lands OUTSIDE
+ * the SGR runs (the fitter never cuts an escape sequence).
+ */
+export declare function clipPlain(s: string, cols: number): string;
+/**
+ * The title's protected minimum, in columns. NOT a per-row clamp: it is the
+ * input to the derived floors (render.ts FULL_FIT_FLOOR / COMPACT_FIT_FLOOR =
+ * worst-case furniture + TITLE_MIN) and the threshold the sacrifice order
+ * protects the title down to. Because the driver fits every row to at least the
+ * compact floor (max(width, COMPACT_FIT_FLOOR)),
+ * the worst-furniture row's title lands at exactly TITLE_MIN and every lighter
+ * row's title is automatically wider — so this floor is always satisfiable and
+ * there is no sub-floor clip (below the floor the terminal wraps, losing nothing).
+ */
+export declare const TITLE_MIN = 16;
+/**
+ * The named, ordered stages of a row's collapse — the ratified sacrifice order
+ * (docs/design/width-aware-tty.md, GUI-measured oracle + the CLI-only container
+ * rule). Reordering the sacrifice is editing this list plus {@link fitRow}.
+ */
+export type FitStage = "full" | "both-shrink" | "container-drop" | "tags-bare";
+/**
+ * The segments of a row the fitter composes. Fixed parts are pre-styled strings
+ * (measured, never altered); the two collapsible parts arrive as raw material
+ * plus their styling closures so truncation happens on plain text and the SGR
+ * wraps the result:
+ *  - `left`     uuid column + box + meta chips (measured; the space before the
+ *               title is added by the fitter)
+ *  - `rawTitle` + `styleTitle` — the plain title text and its wrapper
+ *  - `tail`     trailing markers (count chip, ◷ ≡ ≔) — pre-styled incl. its
+ *               leading space, or ""
+ *  - `tagNames` raw tag names (no `#`) + `styleTags` wrapping a `#a #b` form
+ *               (incl. the leading space) — the fitter folds the list
+ *  - `context`  the ` (container)` suffix — pre-styled incl. leading space, or ""
+ *  - `deadline` the full ⚑ token — pre-styled incl. leading space, or ""
+ *  - `full`     the fully-composed row (the byte-identical no-fit output)
+ */
+export interface RowSegments {
+    left: string;
+    rawTitle: string;
+    styleTitle: (text: string) => string;
+    tail: string;
+    tagNames: string[];
+    styleTags: (form: string) => string;
+    context: string;
+    deadline: string;
+    full: string;
+}
+/**
+ * Fit one row into `width` terminal cells per the ratified collapse order. The
+ * always-present parts (uuid, box, meta chips, tail markers, full deadline)
+ * never shrink; title and tags divvy up what remains LAZILY — tags fold to the
+ * widest progressive level that fits and the 4:1 ratio arbitrates only when both
+ * genuinely contend (slack an under-share side leaves flows to the other). Then
+ * the CLI-only container is sacrificed WHOLE (before the last tag folds), then
+ * the last tag folds to bare `#…`, and the title bottoms at TITLE_MIN. `width` is
+ * the caller's effective width (already max'd with COMPACT_FIT_FLOOR), so the final
+ * stage always satisfies the floor; a sub-floor width would simply let the
+ * terminal wrap (the title is kept whole rather than clipped). A row that already
+ * fits keeps its full content; the only always-applied transform is the
+ * experimental deadline gutter ({@link alignDeadline}), which right-pins the `⚑`.
+ */
+export declare function fitRow(seg: RowSegments, width: number): string;
+/**
+ * The resolved fit for a view: the effective width every row is fitted to, plus
+ * whether deadline tokens render in the COMPACT form (the Things iOS narrow-
+ * width oracle — `8/12`, `58d ago` — docs/design/width-aware-tty.md § Compact
+ * deadline forms). `compact` is decided ONCE from the effective width against
+ * the two derived floors, never per row, so a view's right-pinned gutter never
+ * mixes `Aug 12` and `8/12`.
+ */
+export interface EffectiveFit {
+    /** Width to fit each row to — the raw fit width clamped up to the compact floor. */
+    width: number;
+    /** True when the effective width sits below the full-form floor. */
+    compact: boolean;
+}
+/**
+ * Resolve the effective fit from the once-resolved fit width and the two
+ * glyph-derived floors (`render.ts`: FULL_FIT_FLOOR / COMPACT_FIT_FLOOR). This
+ * is the SINGLE decision point for the full-vs-compact deadline form:
+ *   - `width ≥ full`        → full forms, fit to width (today's behavior);
+ *   - `compact ≤ width < full` → all deadlines compact, fit to width;
+ *   - `width < compact`     → clamp to the compact floor and wrap (sub-floor
+ *                             rule at the lower floor), still compact.
+ * The floors live in render.ts because their derivation needs the glyph
+ * inventory; the branching lives here so it is pure and unit-testable.
+ */
+export declare function resolveFit(fitWidth: number, fullFloor: number, compactFloor: number): EffectiveFit;
+/**
+ * Set the process-wide fit width (columns), resolved ONCE by the CLI driver at
+ * startup. `null` disables fitting (the default — every non-TTY path stays
+ * byte-stable). Tests set this explicitly and reset it afterward.
+ */
+export declare function setFitWidth(width: number | null): void;
+/** The current fit width, or null when fitting is disabled. */
+export declare function getFitWidth(): number | null;
+/**
+ * Resolve the fit width from the environment and stdout: `THINGS_WIDTH` wins
+ * when set (a positive integer forces that width; `0` disables fitting), else
+ * the terminal's column count when stdout is a TTY, else null (pipes, grep,
+ * captured output — no fitting, byte-stable). A malformed `THINGS_WIDTH` is
+ * ignored (falls through to the TTY/null resolution).
+ */
+export declare function resolveWidth(opts: {
+    env: Record<string, string | undefined>;
+    columns: number | undefined;
+    isTTY: boolean;
+}): number | null;

package/dist/cli/width.js

@@ -0,0 +1,313 @@
+/**
+ * Width-aware TTY row fitting (docs/design/width-aware-tty.md). Terminal list
+ * rows never wrap: like the Things GUI, an over-long row truncates its title
+ * with a trailing `…` and folds its tags, keeping the always-present metadata
+ * (uuid, box, chips, tail markers, the full deadline token) intact. Everything
+ * here is pure and takes the target width explicitly, so it is unit-testable
+ * without a TTY and byte-stable off one: fitting engages ONLY when the driver
+ * resolves a positive width (setFitWidth) — the default is null (no fitting),
+ * so pipes, grep, and `--json` are untouched by construction.
+ *
+ * No runtime dependency (guest e2e bundles ship node + dist + commander only),
+ * so the display-width math is a small vendored wcwidth: SGR escapes strip to
+ * zero, East-Asian-Wide + emoji-presentation codepoints count two cells, the
+ * rest count one. ZWJ-sequence emoji can be off by a cell (accepted — worst
+ * case a row runs a hair short); the glyph vocabulary (★ ⏾ ⚑ ↻ ⍾ ≡ ◷) is all
+ * ambiguous/narrow class and counts one, so the layout math matches the render.
+ */
+const SGR = new RegExp(`${String.fromCharCode(27)}\\[[0-9;]*m`, "g");
+/** Drop every SGR (color/dim/bold/…) escape, leaving the visible characters. */
+export function stripSgr(s) {
+    return s.replace(SGR, "");
+}
+// Codepoint ranges that occupy TWO terminal cells: the East-Asian Wide/Fullwidth
+// core plus the default-emoji-presentation set (so "⭐️" counts 2 while the
+// ambiguous-class "★" counts 1 — the property that keeps our glyph set narrow).
+const WIDE_RANGES = [
+    [0x1100, 0x115f], // Hangul Jamo
+    [0x2e80, 0x303e], // CJK radicals … Kangxi
+    [0x3041, 0x33ff], // Hiragana … CJK compat
+    [0x3400, 0x4dbf], // CJK Ext A
+    [0x4e00, 0x9fff], // CJK Unified
+    [0xa000, 0xa4cf], // Yi
+    [0xac00, 0xd7a3], // Hangul Syllables
+    [0xf900, 0xfaff], // CJK Compat Ideographs
+    [0xfe30, 0xfe4f], // CJK Compat Forms
+    [0xff00, 0xff60], // Fullwidth Forms
+    [0xffe0, 0xffe6], // Fullwidth signs
+    // Emoji-presentation (default-wide) — the codepoints Unicode marks
+    // Emoji_Presentation=Yes outside the SMP blocks below.
+    [0x231a, 0x231b],
+    [0x23e9, 0x23ec],
+    [0x23f0, 0x23f0],
+    [0x23f3, 0x23f3],
+    [0x25fd, 0x25fe],
+    [0x2614, 0x2615],
+    [0x2648, 0x2653],
+    [0x267f, 0x267f],
+    [0x2693, 0x2693],
+    [0x26a1, 0x26a1],
+    [0x26aa, 0x26ab],
+    [0x26bd, 0x26be],
+    [0x26c4, 0x26c5],
+    [0x26ce, 0x26ce],
+    [0x26d4, 0x26d4],
+    [0x26ea, 0x26ea],
+    [0x26f2, 0x26f3],
+    [0x26f5, 0x26f5],
+    [0x26fa, 0x26fa],
+    [0x26fd, 0x26fd],
+    [0x2705, 0x2705],
+    [0x270a, 0x270b],
+    [0x2728, 0x2728],
+    [0x274c, 0x274c],
+    [0x274e, 0x274e],
+    [0x2753, 0x2755],
+    [0x2757, 0x2757],
+    [0x2795, 0x2797],
+    [0x27b0, 0x27b0],
+    [0x27bf, 0x27bf],
+    [0x2b1b, 0x2b1c],
+    [0x2b50, 0x2b50], // ⭐ WHITE MEDIUM STAR (Emoji_Presentation — 2 cells)
+    [0x2b55, 0x2b55],
+    [0x1f000, 0x1faff], // SMP emoji blocks (mahjong … symbols & pictographs ext)
+    [0x20000, 0x3fffd], // CJK Ext B+ (SIP/TIP)
+];
+// Zero-width: combining marks, ZW(SP/NJ/J), and variation selectors. Treating
+// VS16 (FE0F) as zero-width means an emoji-presentation base already counted 2
+// stays 2 (rather than 3) — the "⭐️" case.
+const ZERO_RANGES = [
+    [0x0300, 0x036f], // combining diacritics
+    [0x200b, 0x200f], // ZWSP … RLM (incl. ZWJ 200d)
+    [0xfe00, 0xfe0f], // variation selectors
+];
+function inRanges(cp, ranges) {
+    for (const [lo, hi] of ranges)
+        if (cp >= lo && cp <= hi)
+            return true;
+    return false;
+}
+/** Terminal cells a single codepoint occupies: 0 (combining/zero-width), 2 (wide), else 1. */
+export function charWidth(cp) {
+    if (cp === 0)
+        return 0;
+    if (inRanges(cp, ZERO_RANGES))
+        return 0;
+    if (inRanges(cp, WIDE_RANGES))
+        return 2;
+    return 1;
+}
+/** Visible terminal width of a string: SGR-stripped, summed per codepoint. */
+export function visibleWidth(s) {
+    let w = 0;
+    for (const ch of stripSgr(s))
+        w += charWidth(ch.codePointAt(0) ?? 0);
+    return w;
+}
+/**
+ * Truncate PLAIN text (no SGR) to at most `cols` terminal cells, never splitting
+ * a wide codepoint across the boundary. Used to clip a raw title before its
+ * styling wrappers are re-applied, so the ellipsis/clip boundary lands OUTSIDE
+ * the SGR runs (the fitter never cuts an escape sequence).
+ */
+export function clipPlain(s, cols) {
+    if (cols <= 0)
+        return "";
+    let w = 0;
+    let out = "";
+    for (const ch of s) {
+        const cw = charWidth(ch.codePointAt(0) ?? 0);
+        if (w + cw > cols)
+            break;
+        out += ch;
+        w += cw;
+    }
+    return out;
+}
+// ── Row fitting ─────────────────────────────────────────────────────────────
+/**
+ * TITLE : TAGS relative max-width ratio (tunable — ONE place). It arbitrates the
+ * collapsible budget ONLY under contention — when BOTH segments' natural widths
+ * exceed their shares. Otherwise the fit is lazy: the side within its share keeps
+ * its natural width and the other takes everything left (see {@link fitRow}). 4:1
+ * keeps the title dominant when they do genuinely contend.
+ */
+const TITLE_RATIO = 4;
+const TAGS_RATIO = 1;
+/**
+ * The title's protected minimum, in columns. NOT a per-row clamp: it is the
+ * input to the derived floors (render.ts FULL_FIT_FLOOR / COMPACT_FIT_FLOOR =
+ * worst-case furniture + TITLE_MIN) and the threshold the sacrifice order
+ * protects the title down to. Because the driver fits every row to at least the
+ * compact floor (max(width, COMPACT_FIT_FLOOR)),
+ * the worst-furniture row's title lands at exactly TITLE_MIN and every lighter
+ * row's title is automatically wider — so this floor is always satisfiable and
+ * there is no sub-floor clip (below the floor the terminal wraps, losing nothing).
+ */
+export const TITLE_MIN = 16;
+/** Overflow marker for folded tags (dim styling applied by the row's styleTags). */
+const TAG_OVERFLOW = "#…";
+/**
+ * Plain form (no styling, no leading space) of the tag run showing the first `k`
+ * real tags; when `k` is below the total, the dropped tags fold into the dim
+ * `#…` marker. `k === 0` is the bare marker.
+ */
+function tagForm(names, k) {
+    const shown = names.slice(0, k).map((n) => `#${n}`);
+    if (k < names.length)
+        shown.push(TAG_OVERFLOW);
+    return shown.join(" ");
+}
+/** Visible width of the rendered tag run at level `k` (its leading space + form). */
+function tagWidth(names, k) {
+    if (names.length === 0)
+        return 0;
+    return 1 + visibleWidth(tagForm(names, k));
+}
+/** Widest tag level (most real tags) whose render fits `cap`, floored at `floorK`. */
+function pickTagLevel(names, cap, floorK) {
+    for (let k = names.length; k >= floorK; k--) {
+        if (tagWidth(names, k) <= cap)
+            return k;
+    }
+    return floorK;
+}
+/**
+ * EXPERIMENTAL — the right-aligned deadline gutter (GUI flag-column parity). When
+ * fitting is active, every fitted row's `⚑` token is pushed flush to the effective
+ * width so all deadlines in a view line up in one gutter, exactly like the app's
+ * right-pinned flag column. `body` is the composed row WITHOUT its deadline and
+ * `deadline` the pre-styled ` ⚑ …` segment (its leading space + token) or "".
+ * The padding is plain spaces OUTSIDE the styled token, and there is always ≥ 1
+ * space — so a row that already fills the width is byte-identical to the inline
+ * (unguttered) form, and a row with no deadline is returned untouched (ragged
+ * right, as the GUI leaves flag-less rows). This is only ever reached from
+ * {@link fitRow} (fitting active), so the byte-stable null path never sees it.
+ * Reverting the experiment is deleting this function and its two `fitRow` calls.
+ */
+function alignDeadline(body, deadline, width) {
+    if (deadline === "")
+        return body;
+    // deadline = " " + token; swap that single inline space for the gutter run.
+    const pad = width - visibleWidth(body) - visibleWidth(deadline) + 1;
+    return `${body}${" ".repeat(Math.max(1, pad))}${deadline.slice(1)}`;
+}
+/**
+ * Fit one row into `width` terminal cells per the ratified collapse order. The
+ * always-present parts (uuid, box, meta chips, tail markers, full deadline)
+ * never shrink; title and tags divvy up what remains LAZILY — tags fold to the
+ * widest progressive level that fits and the 4:1 ratio arbitrates only when both
+ * genuinely contend (slack an under-share side leaves flows to the other). Then
+ * the CLI-only container is sacrificed WHOLE (before the last tag folds), then
+ * the last tag folds to bare `#…`, and the title bottoms at TITLE_MIN. `width` is
+ * the caller's effective width (already max'd with COMPACT_FIT_FLOOR), so the final
+ * stage always satisfies the floor; a sub-floor width would simply let the
+ * terminal wrap (the title is kept whole rather than clipped). A row that already
+ * fits keeps its full content; the only always-applied transform is the
+ * experimental deadline gutter ({@link alignDeadline}), which right-pins the `⚑`.
+ */
+export function fitRow(seg, width) {
+    const names = seg.tagNames;
+    const wLeft = visibleWidth(seg.left) + 1; // + the space before the title
+    const wTail = visibleWidth(seg.tail);
+    const wCtx = visibleWidth(seg.context);
+    const wDead = visibleWidth(seg.deadline);
+    const wTitle = visibleWidth(seg.rawTitle);
+    // A naturally short title never floors at TITLE_MIN — it simply fits whole.
+    const titleNeed = Math.min(TITLE_MIN, wTitle);
+    const fixed = (ctx) => wLeft + wTail + wDead + (ctx ? wCtx : 0);
+    const fitTitle = (budget) => wTitle <= budget
+        ? seg.styleTitle(seg.rawTitle)
+        : seg.styleTitle(`${clipPlain(seg.rawTitle, budget - 1)}…`);
+    const renderRow = (title, k, ctx) => {
+        const tags = names.length > 0 ? seg.styleTags(tagForm(names, k)) : "";
+        const body = `${seg.left} ${title}${seg.tail}${tags}${ctx ? seg.context : ""}`;
+        return alignDeadline(body, seg.deadline, width);
+    };
+    // Stage "full": everything fits with tags whole and the container present.
+    // (The deadline is still pushed to the gutter — GUI flags pin right even on a
+    // short row — but the null path returns seg.full before reaching the fitter.)
+    const budgetFull = width - fixed(true);
+    if (wTitle + tagWidth(names, names.length) <= budgetFull) {
+        const body = seg.full.slice(0, seg.full.length - seg.deadline.length);
+        return alignDeadline(body, seg.deadline, width);
+    }
+    // Stage "both-shrink": tags fold LAZILY — to the WIDEST progressive level that
+    // fits, not an eager 1/5 cap. The 4:1 ratio arbitrates ONLY under contention
+    // (both natural widths exceed their shares of the collapsible budget). When the
+    // title is within its 4/5 share it keeps its natural width and the tags get
+    // everything left (their widest fitting level); when instead the tags are
+    // within their 1/5 share they stay whole and the title gets the rest. Either
+    // way, slack a discrete tag level does not consume flows BACK to the title, and
+    // neither side is shrunk below what the budget actually forces. Container kept.
+    const tagShare = Math.floor((budgetFull * TAGS_RATIO) / (TITLE_RATIO + TAGS_RATIO));
+    const titleShare = budgetFull - tagShare;
+    const tagCap = wTitle <= titleShare ? budgetFull - wTitle : tagShare;
+    const k = pickTagLevel(names, tagCap, 1);
+    const titleBudgetB = budgetFull - tagWidth(names, k);
+    if (titleBudgetB >= titleNeed)
+        return renderRow(fitTitle(titleBudgetB), k, true);
+    // Stage "container-drop": the CLI-only container yields WHOLE (a truncated
+    // parenthetical is worse than none) BEFORE the last tag folds — tags hold at
+    // `#first #…`, the reclaimed width goes to the title.
+    const budgetNoCtx = width - fixed(false);
+    const titleBudgetC = budgetNoCtx - tagWidth(names, 1);
+    if (titleBudgetC >= titleNeed)
+        return renderRow(fitTitle(titleBudgetC), 1, false);
+    // Stage "tags-bare": the last tag folds to the bare `#…` marker (container
+    // already gone), the title floors at TITLE_MIN. No end-clip: at an effective
+    // width this budget clears the floor; a sub-floor width keeps the title whole
+    // and lets the terminal wrap (never dropping the deadline).
+    const titleBudgetD = budgetNoCtx - tagWidth(names, 0);
+    const dTitle = titleBudgetD >= 1 ? fitTitle(titleBudgetD) : seg.styleTitle(seg.rawTitle);
+    return renderRow(dTitle, 0, false);
+}
+/**
+ * Resolve the effective fit from the once-resolved fit width and the two
+ * glyph-derived floors (`render.ts`: FULL_FIT_FLOOR / COMPACT_FIT_FLOOR). This
+ * is the SINGLE decision point for the full-vs-compact deadline form:
+ *   - `width ≥ full`        → full forms, fit to width (today's behavior);
+ *   - `compact ≤ width < full` → all deadlines compact, fit to width;
+ *   - `width < compact`     → clamp to the compact floor and wrap (sub-floor
+ *                             rule at the lower floor), still compact.
+ * The floors live in render.ts because their derivation needs the glyph
+ * inventory; the branching lives here so it is pure and unit-testable.
+ */
+export function resolveFit(fitWidth, fullFloor, compactFloor) {
+    const width = Math.max(fitWidth, compactFloor);
+    return { width, compact: width < fullFloor };
+}
+// ── Width resolution + the module-level fit width ────────────────────────────
+let fitWidth = null;
+/**
+ * Set the process-wide fit width (columns), resolved ONCE by the CLI driver at
+ * startup. `null` disables fitting (the default — every non-TTY path stays
+ * byte-stable). Tests set this explicitly and reset it afterward.
+ */
+export function setFitWidth(width) {
+    fitWidth = width;
+}
+/** The current fit width, or null when fitting is disabled. */
+export function getFitWidth() {
+    return fitWidth;
+}
+/**
+ * Resolve the fit width from the environment and stdout: `THINGS_WIDTH` wins
+ * when set (a positive integer forces that width; `0` disables fitting), else
+ * the terminal's column count when stdout is a TTY, else null (pipes, grep,
+ * captured output — no fitting, byte-stable). A malformed `THINGS_WIDTH` is
+ * ignored (falls through to the TTY/null resolution).
+ */
+export function resolveWidth(opts) {
+    const raw = opts.env["THINGS_WIDTH"];
+    if (raw !== undefined) {
+        const n = Number(raw);
+        if (Number.isInteger(n) && n >= 0)
+            return n === 0 ? null : n;
+        // malformed — fall through to the TTY resolution
+    }
+    if (opts.isTTY && typeof opts.columns === "number" && opts.columns > 0)
+        return opts.columns;
+    return null;
+}
+//# sourceMappingURL=width.js.map

package/dist/cli/width.js.map

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