humanish 0.104.3 → 0.106.0

package/dist/run-projection.js

@@ -1,350 +0,0 @@
-// The disk→view-model projection (#455 PR 2). Pure functions, no I/O, no rendering: this is where
-// lab grouping, the trust line's arithmetic, thought normalization and list-window math live, so
-// the parts most likely to be wrong are testable without a terminal.
-//
-// The honesty rules these encode, because they are the ones a UI is most tempted to break:
-//   - a statistic ALWAYS carries its denominator, and says when it has none;
-//   - an unknown cost is `null` (declared absent), never 0;
-//   - truncation is reported, never silent;
-//   - a participant's reported thinking is quoted, never paraphrased or summarized.
-/**
- * Group runs by lab, newest-first within each lab and by recency between labs. Runs with no lab
- * attribution are collected under `unattributed` rather than invented into a lab — the honest
- * home for pre-contract runs and library callers.
- */
-export function groupRunsByLab(entries) {
-    const byLab = new Map();
-    const unattributed = [];
-    for (const entry of entries) {
-        const labId = entry.lab?.id;
-        if (labId === undefined) {
-            unattributed.push(entry);
-            continue;
-        }
-        const bucket = byLab.get(labId);
-        if (bucket === undefined)
-            byLab.set(labId, [entry]);
-        else
-            bucket.push(entry);
-    }
-    const labs = [...byLab.entries()].map(([labId, runs]) => {
-        const liveRuns = runs.filter((run) => run.liveness === "running");
-        return {
-            labId,
-            runs: runs.length,
-            live: liveRuns.length,
-            ...(runs[0] === undefined ? {} : { latest: runs[0] }),
-            liveRuns
-        };
-    });
-    // A lab someone is working in sorts first; otherwise most recently used.
-    labs.sort((left, right) => {
-        if (left.live !== right.live)
-            return right.live - left.live;
-        return recencyOf(right.latest) - recencyOf(left.latest);
-    });
-    return { labs, unattributed };
-}
-function recencyOf(entry) {
-    if (entry === undefined)
-        return 0;
-    for (const candidate of [entry.completedAt, entry.updatedAt, entry.startedAt]) {
-        if (candidate === undefined)
-            continue;
-        const parsed = Date.parse(candidate);
-        if (Number.isFinite(parsed))
-            return parsed;
-    }
-    return 0;
-}
-/**
- * Derive what to expect from a lab's own history. Only FINISHED runs count: an interrupted run's
- * duration is the length of an accident, not of a study, and including it would quietly bias the
- * estimate the operator uses to decide whether to press Start.
- *
- * MODE MATTERS, and mixing modes is a lie rather than an imprecision. A dry run spends nothing and
- * takes no time, so a median over nine dry runs and one live one reports that a live run is free —
- * next to a control that spends money. Pass the mode the figure is about; omit it only for a
- * summary that is not attached to an action.
- */
-export function expectationFor(entries, mode) {
-    const scoped = mode === undefined ? entries : entries.filter((entry) => entry.mode === mode);
-    const finished = scoped.filter((entry) => entry.liveness === "finished");
-    const durations = finished
-        .map((entry) => entry.durationMs)
-        .filter((value) => typeof value === "number" && Number.isFinite(value) && value >= 0)
-        .sort((a, b) => a - b);
-    const costs = finished
-        .map((entry) => entry.estimatedCostUsd)
-        .filter((value) => typeof value === "number" && Number.isFinite(value))
-        .sort((a, b) => a - b);
-    // A cost is unknown whether it was DECLARED absent (`null`) or never recorded at all
-    // (`undefined` — every fail-closed exit finalized with no outcome). Counting only the first
-    // reports "~$1.20 median · 3 runs" for a sample where two runs were never priced, which claims a
-    // denominator the figure does not have.
-    const costUnknown = finished.filter((entry) => entry.estimatedCostUsd === null || entry.estimatedCostUsd === undefined).length;
-    return {
-        sample: finished.length,
-        ...(durations.length === 0
-            ? {}
-            : {
-                medianDurationMs: median(durations),
-                durationRangeMs: { min: durations[0], max: durations[durations.length - 1] }
-            }),
-        ...(costs.length === 0 ? {} : { medianCostUsd: median(costs) }),
-        costUnknown
-    };
-}
-function median(sorted) {
-    const middle = Math.floor(sorted.length / 2);
-    if (sorted.length % 2 === 1)
-        return sorted[middle];
-    return (sorted[middle - 1] + sorted[middle]) / 2;
-}
-/**
- * The one sentence the launch screen shows about time and money, with its denominator attached.
- * A lab with no history says so plainly instead of borrowing another lab's numbers or inventing
- * a range — "no runs yet" is information, and the operator can still press Start.
- */
-export function expectationLine(expectation) {
-    if (expectation.sample === 0)
-        return "no runs yet";
-    const parts = [];
-    if (expectation.durationRangeMs !== undefined) {
-        const { min, max } = expectation.durationRangeMs;
-        parts.push(min === max ? formatDuration(min) : `${formatDuration(min)}–${formatDuration(max)}`);
-    }
-    if (expectation.medianCostUsd !== undefined) {
-        parts.push(`~$${expectation.medianCostUsd.toFixed(2)} median`);
-    }
-    const sample = `${expectation.sample} run${expectation.sample === 1 ? "" : "s"}`;
-    // "2 of 3 unpriced" and "none of them priced" are different facts, and a line that reports the
-    // second as the first reads as though a median existed for the rest.
-    const allUnpriced = expectation.sample > 0 && expectation.costUnknown === expectation.sample;
-    const unknown = expectation.costUnknown === 0 ? "" : allUnpriced ? ", none priced" : `, ${expectation.costUnknown} unpriced`;
-    if (parts.length === 0) {
-        return allUnpriced ? `${sample}, nothing recorded` : `${sample}${unknown}, nothing timed`;
-    }
-    return `${parts.join(" · ")} · ${sample}${unknown}`;
-}
-/**
- * The one line a lab may say about itself, wherever it is shown.
- *
- * Prefers LIVE figures: cost and duration are what someone reads before spending, and a median
- * diluted by dry runs reports a live study as cheaper and faster than it has ever been. With no
- * live history it reports the count and claims nothing about time or money — which is why this is
- * shared rather than reimplemented per surface, since the two disagreeing is the whole failure.
- */
-export function labSummaryLine(row) {
-    if (row.runs === 0)
-        return row.declared ? "never run" : "no runs";
-    if (row.liveExpectation.sample > 0)
-        return expectationLine(row.liveExpectation);
-    return `${row.runs} ${row.runs === 1 ? "run" : "runs"}, none live`;
-}
-/** Compact duration: seconds under a minute, then m/s, then h/m. */
-export function formatDuration(ms) {
-    const seconds = Math.max(0, Math.round(ms / 1000));
-    if (seconds < 60)
-        return `${seconds}s`;
-    const minutes = Math.floor(seconds / 60);
-    if (minutes < 60)
-        return seconds % 60 === 0 ? `${minutes}m` : `${minutes}m ${seconds % 60}s`;
-    const hours = Math.floor(minutes / 60);
-    return minutes % 60 === 0 ? `${hours}h` : `${hours}h ${minutes % 60}m`;
-}
-/**
- * Prepare a participant's recorded reasoning summary for a fixed-width surface. Provider summaries
- * arrive with markdown section leads (`**Thinking through setup**`) and hard newlines; a terminal
- * needs plain text wrapped to a line budget.
- *
- * The text is never paraphrased or shortened by meaning — only wrapped, and cut at a word boundary
- * with an ellipsis when it does not fit. `truncated` is how the surface says so.
- */
-export function normalizeThought(text, options) {
-    const width = Math.max(8, Math.floor(options.width));
-    const maxLines = Math.max(1, Math.floor(options.maxLines));
-    const flat = text
-        .replace(/\*\*([^*]+)\*\*/g, "$1") // markdown bold leads: keep the words, drop the syntax
-        .replace(/\s*\n+\s*/g, " ") // hard newlines are the provider's formatting, not the meaning
-        .replace(/\s{2,}/g, " ")
-        .trim();
-    if (flat === "")
-        return { lines: [], truncated: false };
-    const words = flat.split(" ");
-    const lines = [];
-    let current = "";
-    let index = 0;
-    for (; index < words.length; index += 1) {
-        const word = words[index];
-        const candidate = current === "" ? word : `${current} ${word}`;
-        if (candidate.length <= width) {
-            current = candidate;
-            continue;
-        }
-        if (current !== "")
-            lines.push(current);
-        current = word.length <= width ? word : `${word.slice(0, width - 1)}…`;
-        if (word.length > width) {
-            // A single unbreakable token longer than the line (a URL, a long id) is cut rather than
-            // allowed to overflow the pane.
-            lines.push(current);
-            current = "";
-        }
-        if (lines.length === maxLines)
-            break;
-    }
-    if (lines.length < maxLines && current !== "") {
-        lines.push(current);
-        index = words.length;
-    }
-    const truncated = index < words.length;
-    if (truncated && lines.length > 0) {
-        const last = lines[lines.length - 1];
-        lines[lines.length - 1] = last.length + 1 <= width ? `${last}…` : `${last.slice(0, width - 1)}…`;
-    }
-    return { lines, truncated };
-}
-/**
- * Which slice of a list to draw, keeping the selection visible with a little context around it.
- * Ink has no scroll container, so every long list windows by hand; getting this wrong is how a
- * selection disappears off the top of a phone screen.
- */
-export function listWindow(args) {
-    const total = Math.max(0, Math.floor(args.total));
-    const viewport = Math.max(1, Math.floor(args.viewport));
-    if (total <= viewport)
-        return { start: 0, end: total };
-    const selected = Math.min(Math.max(0, Math.floor(args.selected)), total - 1);
-    const margin = Math.min(Math.max(0, Math.floor(args.margin ?? 1)), Math.floor((viewport - 1) / 2));
-    let start = Math.min(Math.max(0, selected - margin), total - viewport);
-    if (selected >= start + viewport - margin)
-        start = Math.min(selected - viewport + 1 + margin, total - viewport);
-    start = Math.max(0, Math.min(start, total - viewport));
-    return { start, end: start + viewport };
-}
-/** The label for a run's state, in the register the surfaces share. */
-export function livenessLabel(entry) {
-    switch (entry.liveness) {
-        case "running":
-            return "running";
-        case "interrupted":
-            return "interrupted";
-        default:
-            return entry.verdict ?? "finished";
-    }
-}
-/** The addressable handle for a manifest: its filename without directory or extension. */
-export function labNameFromPath(manifestPath) {
-    const base = manifestPath.split("/").pop() ?? manifestPath;
-    return base.replace(/\.(ya?ml)$/i, "");
-}
-/**
- * Join declared lab manifests to run history.
- *
- * Neither side alone is the truth. A fresh project has manifests and no runs — those labs are the
- * whole screen, and a list built only from history would be empty on exactly the first visit that
- * matters. A long-lived project accumulates runs from labs whose manifest has since been renamed or
- * deleted — that evidence still exists on disk, so dropping those rows would make real runs
- * unreachable from the surface that is supposed to list them.
- *
- * ONE ROW PER MANIFEST, not per id. The two are not the same thing: a manifest is addressed by its
- * filename while its runs attribute to the id declared inside it, so several files can legitimately
- * share an id. Collapsing them hides a real file; keying by id duplicates a row with no way to tell
- * the copies apart. Both happen in practice — this repo has exactly that pair.
- *
- * Order puts a lab someone is working in first, then labs by how recently they ran, then declared
- * labs that have never run (alphabetically BY WHAT IS DISPLAYED, so the order on screen is the
- * order a reader can predict), then labs known only from history.
- */
-export function labRows(declared, entries) {
-    const { labs, unattributed } = groupRunsByLab(entries);
-    const byId = new Map(labs.map((lab) => [lab.labId, lab]));
-    const runsOf = new Map();
-    for (const entry of entries) {
-        const labId = entry.lab?.id;
-        if (labId === undefined)
-            continue;
-        const bucket = runsOf.get(labId);
-        if (bucket === undefined)
-            runsOf.set(labId, [entry]);
-        else
-            bucket.push(entry);
-    }
-    const idCounts = new Map();
-    for (const lab of declared)
-        idCounts.set(lab.id, (idCounts.get(lab.id) ?? 0) + 1);
-    const build = (labId, manifest, isDeclared) => {
-        const rollup = byId.get(labId);
-        const manifestPath = manifest?.path;
-        return {
-            key: manifestPath ?? `id:${labId}`,
-            labId,
-            name: manifestPath === undefined ? labId : labNameFromPath(manifestPath),
-            ...(manifest?.title === undefined ? {} : { title: manifest.title }),
-            ...(manifestPath === undefined ? {} : { path: manifestPath }),
-            ...(manifest?.origin === undefined ? {} : { origin: manifest.origin }),
-            declared: isDeclared,
-            // Replaced by assignLabels once the whole set is known; a label is only meaningful relative
-            // to the rows it sits beside.
-            label: manifest?.title ?? (manifestPath === undefined ? labId : labNameFromPath(manifestPath)),
-            ...(manifest?.description === undefined ? {} : { description: manifest.description }),
-            sharesIdWith: Math.max(0, (idCounts.get(labId) ?? 0) - 1),
-            runs: rollup?.runs ?? 0,
-            live: rollup?.live ?? 0,
-            ...(rollup?.latest === undefined ? {} : { latest: rollup.latest }),
-            liveRuns: rollup?.liveRuns ?? [],
-            expectation: expectationFor(runsOf.get(labId) ?? []),
-            liveExpectation: expectationFor(runsOf.get(labId) ?? [], "live")
-        };
-    };
-    const declaredIds = new Set(declared.map((lab) => lab.id));
-    const rows = [
-        ...declared.map((lab) => build(lab.id, lab, true)),
-        ...labs.filter((lab) => !declaredIds.has(lab.labId)).map((lab) => build(lab.labId, undefined, false))
-    ];
-    // Resolve each row's label BEFORE sorting, so the list is ordered by what a reader actually sees.
-    assignLabels(rows);
-    const label = (row) => row.label;
-    rows.sort((left, right) => {
-        if (left.live !== right.live)
-            return right.live - left.live;
-        const rank = (row) => (row.runs > 0 ? 0 : row.declared ? 1 : 2);
-        if (rank(left) !== rank(right))
-            return rank(left) - rank(right);
-        if (left.runs > 0 && right.runs > 0) {
-            const recency = recencyOf(right.latest) - recencyOf(left.latest);
-            if (recency !== 0)
-                return recency;
-        }
-        const byLabel = label(left).localeCompare(label(right));
-        return byLabel !== 0 ? byLabel : left.key.localeCompare(right.key);
-    });
-    return { rows, unattributed };
-}
-/**
- * Give every row the shortest label that distinguishes it: title, else filename, else path.
- *
- * Falling straight back to the filename whenever a title repeats — rather than decorating the
- * duplicate with a suffix — keeps the label something the operator can act on, because the filename
- * is exactly what `humanish lab run` takes.
- */
-function assignLabels(rows) {
-    const count = (values) => {
-        const counts = new Map();
-        for (const value of values)
-            counts.set(value, (counts.get(value) ?? 0) + 1);
-        return counts;
-    };
-    const titles = count(rows.map((row) => row.title ?? row.name));
-    const names = count(rows.map((row) => row.name));
-    for (const row of rows) {
-        const title = row.title ?? row.name;
-        if ((titles.get(title) ?? 0) === 1) {
-            row.label = title;
-            continue;
-        }
-        row.label = (names.get(row.name) ?? 0) === 1 ? row.name : (row.path ?? row.name);
-    }
-}
-//# sourceMappingURL=run-projection.js.map

package/dist/run-projection.js.map

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

package/dist/run-status.d.ts

@@ -1,139 +0,0 @@
-import { type PreparedOutputRoot } from "./selected-output-paths.js";
-export declare const RUN_STATUS_SCHEMA = "humanish.run-status.v1";
-/** The file, relative to the run directory. */
-export declare const RUN_STATUS_FILE = "status.json";
-/** How often a live run touches `updatedAt`. */
-export declare const RUN_STATUS_TOUCH_MS = 5000;
-/**
- * A `running` record whose `updatedAt` is older than this is INTERRUPTED, not alive: the process
- * died without finalizing (a dropped SSH, a killed terminal, a crash). Three touch intervals of
- * slack so an ordinary scheduling hiccup or a slow disk never mislabels a healthy run.
- */
-export declare const RUN_STATUS_STALE_MS: number;
-/** Which manifest a run came from, when it came from one. */
-export interface RunLabProvenance {
-    /** The lab id as declared in its manifest (`config.id`). */
-    id: string;
-    /** Repo-relative manifest path, when the run came from a file on disk. */
-    path?: string;
-    /** `committed` = humanish/labs, `ignored` = a local overlay, `explicit` = a path the operator passed. */
-    origin?: "committed" | "ignored" | "explicit";
-}
-export type RunStatusState = "running" | "finished";
-/** The outcome summary a finalized record carries. Derived from the bundle; never authoritative. */
-export interface RunStatusOutcome {
-    /** `review.verdict` verbatim. */
-    verdict?: string;
-    /** True when the run's own envelope reported success. */
-    ok?: boolean;
-    /** `review.participants` counts, when the run recorded any. */
-    participants?: {
-        total: number;
-        reachedGoal: number;
-        reportedFriction?: number;
-    };
-    /** The run-level estimate, `null` when declared absent (never coerced to 0). */
-    estimatedCostUsd?: number | null;
-    durationMs?: number;
-}
-export interface RunStatusRecord {
-    schema: typeof RUN_STATUS_SCHEMA;
-    runId: string;
-    state: RunStatusState;
-    mode: "dry-run" | "live";
-    /** Absent when the run did not come from a lab manifest (a library caller, a bare `run`). */
-    lab?: RunLabProvenance;
-    /** The pid that owns the run, for local liveness and (later) cancellation. */
-    pid: number;
-    startedAt: string;
-    /** Refreshed on a fixed cadence while the run is alive; the staleness signal. */
-    updatedAt: string;
-    completedAt?: string;
-    outcome?: RunStatusOutcome;
-}
-export interface RunStatusHandle {
-    /** Resolves once the initial record has landed on disk. The write itself is fire-and-forget —
-     *  starting a run must never block on its own index — but a caller that needs the record to
-     *  exist before proceeding (a test, or a launcher that hands the run id to another process)
-     *  can await this instead of polling. */
-    readonly started: Promise<void>;
-    /** Write `updatedAt` now. Called by the internal cadence; exposed for tests and for backends
-     *  that want to mark a phase boundary. Never throws. */
-    touch(): Promise<void>;
-    /** Finalize: state `finished`, `completedAt`, and the derived outcome. Stops the cadence.
-     *  Idempotent — a second call is a no-op, so a backend with several exit paths is safe. */
-    finish(outcome?: RunStatusOutcome): Promise<void>;
-    /**
-     * Stop the cadence WITHOUT claiming an outcome. For a path that is abandoning the run: the record
-     * stays `running` and goes stale, which is the honest reading.
-     *
-     * Resolves when any IN-FLIGHT write has settled, so a caller that is about to delete the run
-     * directory can be sure nothing is still writing into it. Clearing the interval alone is not
-     * enough — a write started microseconds earlier is still on its way to disk.
-     */
-    stop(): Promise<void>;
-}
-export interface BeginRunStatusOptions {
-    runId: string;
-    mode: "dry-run" | "live";
-    lab?: RunLabProvenance;
-    /** Injectable clock (tests freeze it; the repo's `now()` convention). */
-    now?: () => number;
-    /** Injectable pid so a test never depends on the real process id. */
-    pid?: number;
-    /** Cadence override; 0 disables the interval entirely (tests drive `touch()` themselves). */
-    touchMs?: number;
-}
-/** A no-op handle, so a caller that cannot write status still has a uniform interface. */
-export declare function inertRunStatus(): RunStatusHandle;
-/**
- * Bind a run's status records to the lifetime of the run itself.
- *
- * WHY THIS IS NOT A `finally` AT EACH BACKEND. A run function does not have one exit — the lab
- * backends have 18 early `return`s between opening the record and finalizing it, every one of them
- * a fail-closed path (bad subject, packing failure, missing key). Relying on each of those to
- * remember the record is the same per-call-site discipline that already failed once on this
- * contract, and the failure is silent: the run is over, the cadence keeps ticking, and the record
- * keeps saying `running` — a listing surface then shows a dead run as alive for as long as the
- * process lives. CI caught it as a deleted run directory racing a still-live writer.
- *
- * So the scope owns the lifetime. Control returning from the run function IS the run ending,
- * whatever path it took, and any record still open at that moment is finalized with NO outcome:
- * the run ended and we have no verdict to report. That is honest and it is different from both
- * neighbours — a backend that finalized properly carries its real outcome, and a process that
- * CRASHED never reaches here at all, leaving a `running` record to go stale and read as
- * `interrupted`, which is exactly what happened.
- */
-export declare function withRunStatusScope<T>(fn: () => Promise<T>): Promise<T>;
-/**
- * Start a run's status record and keep it fresh. Fire-and-forget by design: a status write that
- * fails must never fail the run it describes, so every write swallows its error. The interval is
- * `unref`'d — this file can never be the reason a process stays alive.
- */
-export declare function beginRunStatus(runPaths: PreparedOutputRoot, options: BeginRunStatusOptions): RunStatusHandle;
-/** The three ways a run reads from disk. `interrupted` is a `running` record gone stale. */
-export type RunLiveness = "running" | "interrupted" | "finished";
-/**
- * Classify a status record. Pure, so the TUI, the CLI and tests share one definition of "alive".
- * `nowMs` is passed in rather than read, so a classification is reproducible.
- */
-export declare function classifyRunStatus(record: Pick<RunStatusRecord, "state" | "updatedAt">, nowMs: number, staleMs?: number): RunLiveness;
-/** Shape guard for a record read off disk. Unknown extra fields are tolerated (additive contract). */
-export declare function isRunStatusRecord(value: unknown): value is RunStatusRecord;
-/**
- * The legacy bridge: infer a lab id for a bundle written BEFORE this contract, where the only
- * attribution was the `lab:<id>` convention on persona/scenario source strings. Deliberately
- * conservative — it reads the convention and nothing else, and a `lab:` prefix with an empty
- * remainder is not an id. Ids may contain colons (`oss:meta`), so only the FIRST segment is
- * stripped. Returns undefined when the bundle carries no such marker.
- */
-export declare function inferLegacyLabId(bundle: {
-    persona?: {
-        source?: string;
-    };
-    scenario?: {
-        source?: string;
-    };
-}): string | undefined;
-/** A monotonic elapsed-ms helper for callers that need a duration without trusting wall clocks. */
-export declare function elapsedMsSince(startNs: bigint): number;