humanish 0.105.0 → 0.106.1

package/dist/run-paths.js

@@ -1,355 +0,0 @@
-import { lstat, mkdir, readdir, realpath } from "node:fs/promises";
-import path from "node:path";
-export const RUNS_RELATIVE_ROOT = path.join(".humanish", "runs");
-export const LATEST_RUN_RELATIVE_PATH = path.join(RUNS_RELATIVE_ROOT, "latest.json");
-/**
- * Run ids are directory names, not paths. Keep the accepted grammar broad so
- * existing runs remain readable while rejecting every path-shaped input.
- */
-export function isSafeRunIdSegment(runId) {
-    return runId.length > 0
-        && runId !== "."
-        && runId !== ".."
-        && !runId.includes("/")
-        && !runId.includes("\\")
-        && !runId.includes("\0");
-}
-export function resolveRunsRoot(cwdInput) {
-    return path.resolve(cwdInput, RUNS_RELATIVE_ROOT);
-}
-export function resolveRunDirectory(cwdInput, runId) {
-    if (!isSafeRunIdSegment(runId)) {
-        throw new Error("Run id must be one non-empty path segment.");
-    }
-    const runsRoot = resolveRunsRoot(cwdInput);
-    const runRoot = path.resolve(runsRoot, runId);
-    if (!isPathInside(runsRoot, runRoot) || path.dirname(runRoot) !== runsRoot) {
-        throw new Error("Run directory must stay inside the Humanish runs root.");
-    }
-    return runRoot;
-}
-export function tryResolveRunDirectory(cwdInput, runId) {
-    try {
-        return resolveRunDirectory(cwdInput, runId);
-    }
-    catch {
-        return null;
-    }
-}
-export function resolveRunArtifactPaths(cwdInput, runId) {
-    if (runId === "latest.json") {
-        throw new Error("Run id is reserved; choose a different run id.");
-    }
-    const absoluteRunRoot = resolveRunDirectory(cwdInput, runId);
-    return {
-        absoluteRunRoot,
-        relativeRunRoot: path.join(RUNS_RELATIVE_ROOT, runId),
-        absoluteLatestPointer: path.resolve(cwdInput, LATEST_RUN_RELATIVE_PATH),
-        relativeLatestPointer: LATEST_RUN_RELATIVE_PATH
-    };
-}
-export async function prepareRunArtifactPaths(cwdInput, runId) {
-    const paths = resolveRunArtifactPaths(cwdInput, runId);
-    const prepared = await prepareHumanishStorageDirectory(cwdInput, "runs", runId);
-    if (prepared !== paths.absoluteRunRoot) {
-        throw new Error("Run directory resolved outside the expected storage root.");
-    }
-    await assertNoSymlinkDescendants(prepared);
-    await assertRegularFileOrMissing(paths.absoluteLatestPointer);
-    return validatePreparedRunArtifactPaths(await capturePreparedRunArtifactPaths(paths, prepared));
-}
-export async function validatePreparedRunArtifactPaths(prepared) {
-    await validatePreparedRunRootIdentity(prepared);
-    await assertNoSymlinkDescendants(prepared.physicalRunRoot);
-    await assertRegularFileOrMissing(prepared.physicalLatestPointer);
-    return prepared;
-}
-/** Cheap revalidation for repeated contained reads/writes within one prepared run. */
-export async function validatePreparedRunRootIdentity(prepared) {
-    const [lexicalRunsRoot, lexicalRunRoot] = await Promise.all([
-        realpath(path.dirname(prepared.absoluteRunRoot)),
-        realpath(prepared.absoluteRunRoot)
-    ]);
-    if (lexicalRunsRoot !== prepared.physicalRunsRoot || lexicalRunRoot !== prepared.physicalRunRoot) {
-        throw new Error("Prepared Humanish run storage changed physical destination.");
-    }
-    await Promise.all([
-        assertDirectoryIdentity(prepared.physicalRunsRoot, prepared.runsRootIdentity),
-        assertDirectoryIdentity(prepared.physicalRunRoot, prepared.runRootIdentity)
-    ]);
-    return prepared;
-}
-/** Bind an already-existing safe run as a new identity; this is not prior-preparation proof. */
-export async function bindExistingRunArtifactPaths(cwdInput, runId) {
-    const paths = resolveRunArtifactPaths(cwdInput, runId);
-    const existing = await resolveExistingRunDirectory(cwdInput, runId);
-    if (!existing || existing !== paths.absoluteRunRoot) {
-        throw new Error("Run directory is not an existing Humanish run directory.");
-    }
-    await assertNoSymlinkDescendants(existing);
-    await assertRegularFileOrMissing(paths.absoluteLatestPointer);
-    return validatePreparedRunArtifactPaths(await capturePreparedRunArtifactPaths(paths, existing));
-}
-export async function resolveExistingRunDirectory(cwdInput, runId) {
-    const expected = tryResolveRunDirectory(cwdInput, runId);
-    if (!expected) {
-        return null;
-    }
-    const existing = await resolveExistingHumanishStorageDirectory(cwdInput, "runs", runId);
-    return existing === expected ? existing : null;
-}
-/**
- * A latest pointer is valid only when both fields identify the same direct
- * child of .humanish/runs. Callers must never use pointer.path directly.
- */
-export function resolveLatestRunDirectory(cwdInput, pointer) {
-    const expected = tryResolveRunDirectory(cwdInput, pointer.runId);
-    if (!expected || !isProjectRelativePath(pointer.path)) {
-        return null;
-    }
-    const declared = path.resolve(cwdInput, pointer.path);
-    return declared === expected ? expected : null;
-}
-export async function resolveExistingLatestRunDirectory(cwdInput, pointer) {
-    const expected = resolveLatestRunDirectory(cwdInput, pointer);
-    if (!expected) {
-        return null;
-    }
-    const existing = await resolveExistingRunDirectory(cwdInput, pointer.runId);
-    return existing === expected ? existing : null;
-}
-export async function isRegularHumanishStorageFile(cwdInput, ...segments) {
-    const parent = await resolveExistingHumanishStorageDirectory(cwdInput, ...segments.slice(0, -1));
-    const fileName = segments.at(-1);
-    if (!parent || !fileName || !isSafeStorageSegment(fileName)) {
-        return false;
-    }
-    try {
-        const stats = await lstat(path.join(parent, fileName));
-        return stats.isFile() && !stats.isSymbolicLink() && stats.nlink === 1;
-    }
-    catch (error) {
-        if (isNodeError(error) && error.code === "ENOENT") {
-            return false;
-        }
-        throw error;
-    }
-}
-export async function prepareHumanishStorageDirectory(cwdInput, ...segments) {
-    const prepared = await walkHumanishStorage(cwdInput, segments, true);
-    if (!prepared) {
-        throw new Error("Humanish storage directory could not be created.");
-    }
-    return prepared;
-}
-export async function prepareReusableHumanishStorageDirectory(cwdInput, ...segments) {
-    const prepared = await prepareHumanishStorageDirectory(cwdInput, ...segments);
-    await assertNoSymlinkDescendants(prepared);
-    return prepared;
-}
-export async function prepareExclusiveHumanishStorageDirectories(cwdInput, segmentSets) {
-    const targets = [];
-    for (const segments of segmentSets) {
-        assertSafeStorageSegments(segments);
-        const name = segments.at(-1);
-        if (!name) {
-            throw new Error("Exclusive Humanish storage directory needs a leaf segment.");
-        }
-        const parent = await prepareHumanishStorageDirectory(cwdInput, ...segments.slice(0, -1));
-        const target = path.join(parent, name);
-        try {
-            await lstat(target);
-            throw new Error("Humanish storage id already exists; choose a new id.");
-        }
-        catch (error) {
-            if (!isNodeError(error) || error.code !== "ENOENT") {
-                throw error;
-            }
-        }
-        targets.push(target);
-    }
-    for (const target of targets) {
-        try {
-            await mkdir(target);
-        }
-        catch (error) {
-            if (isNodeError(error) && error.code === "EEXIST") {
-                throw new Error("Humanish storage id already exists; choose a new id.");
-            }
-            throw error;
-        }
-    }
-    return targets;
-}
-export async function prepareExclusiveHumanishStorageDirectory(cwdInput, ...segments) {
-    const [target] = await prepareExclusiveHumanishStorageDirectories(cwdInput, [segments]);
-    if (!target) {
-        throw new Error("Exclusive Humanish storage directory was not created.");
-    }
-    return target;
-}
-export async function prepareHumanishStorageFile(cwdInput, ...segments) {
-    const fileName = segments.at(-1);
-    if (!fileName || !isSafeStorageSegment(fileName)) {
-        throw new Error("Humanish storage file must use a non-empty path segment.");
-    }
-    const parent = await prepareHumanishStorageDirectory(cwdInput, ...segments.slice(0, -1));
-    const filePath = path.join(parent, fileName);
-    await assertRegularFileOrMissing(filePath);
-    return filePath;
-}
-export function resolveHumanishStorageDirectory(cwdInput, ...segments) {
-    assertSafeStorageSegments(segments);
-    const humanishRoot = path.resolve(cwdInput, ".humanish");
-    const resolved = path.resolve(humanishRoot, ...segments);
-    if (!isPathInside(humanishRoot, resolved)) {
-        throw new Error("Humanish storage directory must stay inside .humanish.");
-    }
-    return resolved;
-}
-export async function resolveExistingHumanishStorageDirectory(cwdInput, ...segments) {
-    return walkHumanishStorage(cwdInput, segments, false);
-}
-export function isPathInside(rootInput, candidateInput) {
-    const root = path.resolve(rootInput);
-    const candidate = path.resolve(candidateInput);
-    const relative = path.relative(root, candidate);
-    return relative === ""
-        || (relative !== ".." && !relative.startsWith(`..${path.sep}`) && !path.isAbsolute(relative));
-}
-function isProjectRelativePath(value) {
-    const parts = value.replace(/\\/g, "/").split("/");
-    return value.length > 0
-        && !path.isAbsolute(value)
-        && !path.posix.isAbsolute(value)
-        && !path.win32.isAbsolute(value)
-        && !value.includes("\0")
-        && !parts.some((part) => part === "." || part === "..");
-}
-async function walkHumanishStorage(cwdInput, segments, create) {
-    assertSafeStorageSegments(segments);
-    let current = path.resolve(cwdInput);
-    for (const segment of [".humanish", ...segments]) {
-        current = path.join(current, segment);
-        let stats;
-        try {
-            stats = await lstat(current);
-        }
-        catch (error) {
-            if (!isNodeError(error) || error.code !== "ENOENT") {
-                throw error;
-            }
-            if (!create) {
-                return null;
-            }
-            try {
-                await mkdir(current);
-            }
-            catch (mkdirError) {
-                if (!isNodeError(mkdirError) || mkdirError.code !== "EEXIST") {
-                    throw mkdirError;
-                }
-            }
-            stats = await lstat(current);
-        }
-        if (stats.isSymbolicLink()) {
-            throw new Error("Humanish storage directories must not be symbolic links.");
-        }
-        if (!stats.isDirectory()) {
-            throw new Error("ENOTDIR: Humanish storage path must be a directory.");
-        }
-    }
-    return current;
-}
-function assertSafeStorageSegments(segments) {
-    if (!segments.every(isSafeStorageSegment)) {
-        throw new Error("Humanish storage paths must use non-empty path segments.");
-    }
-}
-function isSafeStorageSegment(segment) {
-    return segment.length > 0
-        && segment !== "."
-        && segment !== ".."
-        && !segment.includes("/")
-        && !segment.includes("\\")
-        && !segment.includes("\0");
-}
-function isNodeError(error) {
-    return error instanceof Error && "code" in error;
-}
-async function assertRegularFileOrMissing(filePath) {
-    try {
-        const stats = await lstat(filePath);
-        if (stats.isSymbolicLink() || !stats.isFile() || stats.nlink > 1) {
-            throw new Error("Humanish storage files must be single-link regular files, not symbolic links or hardlinks.");
-        }
-    }
-    catch (error) {
-        if (isNodeError(error) && error.code === "ENOENT") {
-            return;
-        }
-        throw error;
-    }
-}
-async function assertNoSymlinkDescendants(directory) {
-    const entries = await readdir(directory, { withFileTypes: true });
-    for (const entry of entries) {
-        const child = path.join(directory, entry.name);
-        // A run directory can be written CONCURRENTLY with this walk — the atomic writer creates a
-        // `.humanish-write-*.tmp` sibling and renames it, and a run now also refreshes its own status
-        // record on a cadence. An entry that vanished between readdir and lstat therefore proves
-        // nothing except that it is gone, and a path that no longer exists cannot be a symlink escape:
-        // skip it rather than failing the containment check on a benign race. (Latent before the status
-        // record existed — the mid-run bundle flush had the same exposure.)
-        let stats;
-        try {
-            stats = await lstat(child);
-        }
-        catch (error) {
-            if (isNodeError(error) && error.code === "ENOENT") {
-                continue;
-            }
-            throw error;
-        }
-        if (stats.isSymbolicLink()) {
-            throw new Error("Humanish run directories must not contain symbolic links.");
-        }
-        if (stats.isDirectory()) {
-            await assertNoSymlinkDescendants(child);
-        }
-        else if (!stats.isFile() || stats.nlink > 1) {
-            throw new Error("Humanish run leaves must be single-link regular files, not hardlinks or special files.");
-        }
-    }
-}
-async function capturePreparedRunArtifactPaths(paths, runRoot) {
-    const physicalRunRoot = await realpath(runRoot);
-    const physicalRunsRoot = await realpath(path.dirname(runRoot));
-    const [runStats, runsStats] = await Promise.all([
-        lstat(physicalRunRoot, { bigint: true }),
-        lstat(physicalRunsRoot, { bigint: true })
-    ]);
-    if (!runStats.isDirectory() || runStats.isSymbolicLink() || !runsStats.isDirectory() || runsStats.isSymbolicLink()) {
-        throw new Error("Prepared Humanish run storage must use physical directories.");
-    }
-    return Object.freeze({
-        ...paths,
-        physicalLatestPointer: path.join(physicalRunsRoot, "latest.json"),
-        physicalRunRoot,
-        physicalRunsRoot,
-        runRootIdentity: Object.freeze({ birthtimeNs: runStats.birthtimeNs, dev: runStats.dev, ino: runStats.ino }),
-        runsRootIdentity: Object.freeze({ birthtimeNs: runsStats.birthtimeNs, dev: runsStats.dev, ino: runsStats.ino })
-    });
-}
-async function assertDirectoryIdentity(directory, identity) {
-    const stats = await lstat(directory, { bigint: true });
-    if (stats.isSymbolicLink()
-        || !stats.isDirectory()
-        || stats.birthtimeNs !== identity.birthtimeNs
-        || stats.dev !== identity.dev
-        || stats.ino !== identity.ino
-        || await realpath(directory) !== directory) {
-        throw new Error("Prepared Humanish run storage identity changed.");
-    }
-}
-//# sourceMappingURL=run-paths.js.map

package/dist/run-paths.js.map

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

package/dist/run-projection.d.ts

@@ -1,186 +0,0 @@
-import type { RunIndexEntry } from "./run-index.js";
-/** One lab as the labs list shows it. */
-export interface LabRollup {
-    labId: string;
-    /** Total runs attributed to this lab. */
-    runs: number;
-    /** Runs whose status record is fresh right now. */
-    live: number;
-    /** The newest run of this lab, whatever its state. */
-    latest?: RunIndexEntry;
-    /** Live runs, newest first — the labs list shows the first one inline. */
-    liveRuns: RunIndexEntry[];
-}
-/**
- * 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 declare function groupRunsByLab(entries: readonly RunIndexEntry[]): {
-    labs: LabRollup[];
-    unattributed: RunIndexEntry[];
-};
-/**
- * What the launch screen may claim about a lab, and on what evidence. Every figure carries the
- * number of runs it came from; `sample: 0` means there is nothing to claim and the caller must
- * say so rather than showing an empty number.
- */
-export interface LabExpectation {
-    /** How many completed runs of this lab the figures are drawn from. */
-    sample: number;
-    medianDurationMs?: number;
-    /** Range across the sample, so the UI can show a span instead of a false point estimate. */
-    durationRangeMs?: {
-        min: number;
-        max: number;
-    };
-    medianCostUsd?: number;
-    /** Completed runs whose cost was declared absent — excluded from the median, reported here so
-     *  a partial sample can never masquerade as a full one. */
-    costUnknown: number;
-}
-/**
- * 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 declare function expectationFor(entries: readonly RunIndexEntry[], mode?: "dry-run" | "live"): LabExpectation;
-/**
- * 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 declare function expectationLine(expectation: LabExpectation): string;
-/**
- * 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 declare function labSummaryLine(row: Pick<LabRow, "runs" | "declared" | "expectation" | "liveExpectation">): string;
-/** Compact duration: seconds under a minute, then m/s, then h/m. */
-export declare function formatDuration(ms: number): string;
-export interface NormalizedThought {
-    lines: string[];
-    /** True when the source text did not fit and was cut — shown, never silent. */
-    truncated: boolean;
-}
-/**
- * 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 declare function normalizeThought(text: string, options: {
-    width: number;
-    maxLines: number;
-}): NormalizedThought;
-/**
- * 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 declare function listWindow(args: {
-    total: number;
-    selected: number;
-    viewport: number;
-    /** Rows of context to keep above/below the selection when scrolling. */
-    margin?: number;
-}): {
-    start: number;
-    end: number;
-};
-/** The label for a run's state, in the register the surfaces share. */
-export declare function livenessLabel(entry: Pick<RunIndexEntry, "liveness" | "verdict">): string;
-/** A lab as the labs list shows it: what is declared, joined to what actually happened. */
-export interface LabRow {
-    /**
-     * Stable identity for THIS ROW. A manifest's path when it has one, else the lab id — because two
-     * manifests can declare the same id, and keying rows by id makes them collapse into a pair of
-     * indistinguishable duplicates.
-     */
-    key: string;
-    /** The declared id. Run history attributes to this, so it is NOT unique across manifests. */
-    labId: string;
-    /**
-     * The handle an operator would actually type. Lab resolution is by FILENAME, so the manifest
-     * `\`.humanish/labs/persona-contrast-live.yaml\`` is reached as `persona-contrast-live` even when
-     * the id inside it says something else.
-     */
-    name: string;
-    /** The manifest's own title, when it has one. */
-    title?: string;
-    /**
-     * The shortest label that is UNIQUE among the rows it is listed with: the title when no other
-     * lab shares it, else the filename, else the full path. A list is only navigable if every row can
-     * be told from every other one, and a title is not guaranteed to be distinct — two manifests in
-     * this repo carry the same title AND the same declared id, differing only by filename.
-     */
-    label: string;
-    /** The manifest's own words, for the list to say what this study IS. */
-    description?: string;
-    /** Repo-relative manifest path, absent for a lab known only from run history. */
-    path?: string;
-    origin?: "committed" | "ignored" | "explicit";
-    /**
-     * False for a lab that has runs but NO manifest here — renamed, deleted, or run from a path that
-     * is gone. Its runs are still evidence and must stay reachable, so it is listed and marked rather
-     * than dropped.
-     */
-    declared: boolean;
-    /**
-     * How many OTHER manifests declare this same lab id. Above zero, the run history below is shared
-     * between them and cannot be attributed to one file — worth saying, because it is a
-     * misconfiguration the operator almost certainly does not know about.
-     */
-    sharesIdWith: number;
-    runs: number;
-    live: number;
-    latest?: RunIndexEntry;
-    liveRuns: RunIndexEntry[];
-    /** Across every finished run, whatever its mode. A summary, never attached to a spend decision. */
-    expectation: LabExpectation;
-    /** Live runs only — the figure that belongs beside anything that spends money. */
-    liveExpectation: LabExpectation;
-}
-/** The addressable handle for a manifest: its filename without directory or extension. */
-export declare function labNameFromPath(manifestPath: string): string;
-export interface DeclaredLab {
-    id: string;
-    title?: string;
-    /** The manifest's own description, so a list of studies can say what each one is. */
-    description?: string;
-    path?: string;
-    origin?: "committed" | "ignored" | "explicit";
-}
-/**
- * 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 declare function labRows(declared: readonly DeclaredLab[], entries: readonly RunIndexEntry[]): {
-    rows: LabRow[];
-    unattributed: RunIndexEntry[];
-};