looply-cli 0.0.0-stage → 0.3.0

package/dist/verify-pass.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERIFY_LANE = void 0;
+exports.draftsToVerify = draftsToVerify;
+exports.verifyDrafts = verifyDrafts;
+const core_1 = require("@looply/core");
+const verify_apply_1 = require("./verify-apply");
+/**
+ * The verification pass: draft items become pickable, or they do not.
+ *
+ * This closes the gap between the two commands the product is built around.
+ * `scan` writes items in `draft`, because a finding an agent volunteered is a
+ * claim and not yet a task. `run` picks only `ready`. Nothing joined the two,
+ * so a freshly scanned project could not be run at all: `run` refused with "no
+ * ready items" and told the user to mark one from the phone — advice that is
+ * useless on an unpaired machine and wrong even on a paired one, since marking
+ * an item ready by hand is exactly the unchecked premise verification exists to
+ * prevent.
+ *
+ * The pass is deliberately its own command as well as an automatic step. It is
+ * the cheapest agent work looply does and the easiest to reason about, so being
+ * able to run it alone — see what survives contact with the code before
+ * spending a round on anything — is worth more than the tidiness of hiding it.
+ *
+ * A pass is not a run: no round happens and nothing is committed. It mints a
+ * run-shaped id and marks the lane, exactly as a scan does, so the ledger and
+ * the app can tell the three apart without a schema change.
+ */
+exports.VERIFY_LANE = 'verify';
+/** Not `runner`: no round ran, so the run report must not count this as work. */
+const VERIFY_ACTOR = 'system';
+/**
+ * What a pass would check, in queue order.
+ *
+ * Includes items stuck in `verifying`. That state is held only for the length
+ * of one verifier call, so an item still in it when a pass begins is one whose
+ * process died mid-call — killed run, closed laptop, crash. Left out, it is
+ * stranded permanently: pickable by nothing, and never looked at again. The
+ * version check on the write makes reclaiming it safe if something really is
+ * still working on it — that write loses and is reported, rather than racing.
+ */
+function draftsToVerify(items, opts = {}) {
+    const wanted = opts.only ? new Set(opts.only) : null;
+    const open = items.filter((i) => (i.state === 'draft' || i.state === 'verifying') && (wanted === null || wanted.has(i.id)));
+    return opts.max === undefined ? open : open.slice(0, opts.max);
+}
+async function verifyDrafts(deps, opts = {}) {
+    const passId = (0, core_1.newId)('run', deps.now());
+    const report = { checked: 0, ready: 0, byVerdict: {}, failed: 0 };
+    const emit = async (kind, data) => {
+        await deps.ledger.append({
+            ts: new Date(deps.now()).toISOString(),
+            runId: passId,
+            projectId: deps.projectId,
+            lane: exports.VERIFY_LANE,
+            actor: VERIFY_ACTOR,
+            kind,
+            data,
+        });
+    };
+    for (const draft of draftsToVerify(deps.queue.list(), opts)) {
+        // Re-read: a long pass runs beside a daemon that may have moved this item,
+        // and the version is what makes the update safe.
+        const current = deps.queue.get(draft.id);
+        if (current === undefined || (current.state !== 'draft' && current.state !== 'verifying'))
+            continue;
+        const head = await deps.headSha();
+        const marked = await deps.queue.update(current.id, current.version, { state: 'verifying' });
+        if (!marked.ok) {
+            report.failed += 1;
+            continue;
+        }
+        let outcome;
+        try {
+            outcome = await deps.verify(marked.item);
+        }
+        catch (err) {
+            // A dead agent binary must not strand the item in `verifying`, which is
+            // pickable by nothing and verifiable by nothing. Back to draft, so the
+            // next pass simply tries again.
+            const why = err instanceof Error ? err.message : String(err);
+            outcome = { verdict: 'unclear', note: `verifier invocation failed: ${why}` };
+        }
+        const decided = (0, verify_apply_1.applyVerifyVerdict)(marked.item, outcome, (id) => deps.queue.get(id));
+        await emit('item.verified', { itemId: marked.item.id, ...decided.outcome });
+        const after = deps.queue.get(marked.item.id);
+        const written = await deps.queue.update(marked.item.id, after?.version ?? marked.item.version, decided.patch);
+        if (!written.ok) {
+            report.failed += 1;
+            continue;
+        }
+        if (decided.cacheEvidence)
+            await deps.cachePut(marked.item.id, head, decided.cacheEvidence);
+        report.checked += 1;
+        const v = decided.outcome.verdict;
+        report.byVerdict[v] = (report.byVerdict[v] ?? 0) + 1;
+        if (decided.next === 'ready')
+            report.ready += 1;
+        deps.onVerdict?.(marked.item, decided.outcome);
+    }
+    return report;
+}
+//# sourceMappingURL=verify-pass.js.map

package/dist/verify-pass.js.map

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

package/dist/welcome.d.ts

@@ -0,0 +1,43 @@
+/**
+ * What `looply` on its own prints.
+ *
+ * Not a wall of flags. A bare invocation is almost always somebody orienting
+ * themselves, so this answers "where am I and what now" first, and lists the
+ * commands second. The next step is spelled out as a command you can paste,
+ * because the gap between "you are not paired" and knowing what to type about
+ * it is where people give up.
+ */
+export interface CliState {
+    paired: boolean;
+    machineName?: string;
+    serverUrl?: string;
+    /** True when `.looply/config.yaml` exists here. */
+    configured: boolean;
+    projectName?: string;
+    /** Items in the queue that a run could pick up right now. */
+    readyItems?: number;
+    /** Items waiting on a verification pass. */
+    draftItems?: number;
+    runLive?: boolean;
+    currentItem?: string | null;
+}
+export interface CommandSpec {
+    name: string;
+    args: string;
+    blurb: string;
+    group: 'start' | 'work' | 'watch';
+}
+export declare const COMMANDS: readonly CommandSpec[];
+/**
+ * The single most useful thing to do next.
+ *
+ * Ordered by what actually blocks you: without a config nothing runs, without a
+ * queue a run has nothing to pick, and pairing is optional throughout — looply
+ * works alone, the phone is an addition.
+ */
+export declare function nextStep(state: CliState): {
+    text: string;
+    command: string;
+} | null;
+export declare function renderWelcome(state: CliState, version: string): string;
+//# sourceMappingURL=welcome.d.ts.map

package/dist/welcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"welcome.d.ts","sourceRoot":"","sources":["../src/welcome.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;CACnC;AAED,eAAO,MAAM,QAAQ,EAAE,SAAS,WAAW,EAgB1C,CAAC;AAQF;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAqBlF;AAYD,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAuDtE"}

package/dist/welcome.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMMANDS = void 0;
+exports.nextStep = nextStep;
+exports.renderWelcome = renderWelcome;
+const ui_1 = require("./ui");
+exports.COMMANDS = [
+    { name: 'pair', args: '', blurb: 'connect this machine to your phone', group: 'start' },
+    { name: 'init', args: '', blurb: 'look at this project and draft its config', group: 'start' },
+    { name: 'doctor', args: '', blurb: 'check the config and run every check once', group: 'start' },
+    { name: 'scan', args: '', blurb: 'read the code and fill the queue with real work', group: 'work' },
+    { name: 'verify', args: '', blurb: 'check what a scan found against the code', group: 'work' },
+    { name: 'run', args: '[--hours N]', blurb: 'start working through the queue', group: 'work' },
+    { name: 'stop', args: '', blurb: 'finish the current task, then stop', group: 'work' },
+    { name: 'pause', args: '', blurb: 'hold between rounds; `resume` lets it go again', group: 'work' },
+    { name: 'status', args: '', blurb: 'what it is doing right now', group: 'watch' },
+    { name: 'queue', args: '', blurb: 'everything waiting, and why', group: 'watch' },
+    { name: 'report', args: '', blurb: 'what a finished run actually did', group: 'watch' },
+    { name: 'daemon', args: '', blurb: 'stay connected so your phone can drive it', group: 'watch' },
+    { name: 'agent', args: '[--json]', blurb: 'machine-readable state, for other tools', group: 'watch' },
+];
+const GROUP_TITLES = {
+    start: 'getting set up',
+    work: 'doing the work',
+    watch: 'keeping an eye on it',
+};
+/**
+ * The single most useful thing to do next.
+ *
+ * Ordered by what actually blocks you: without a config nothing runs, without a
+ * queue a run has nothing to pick, and pairing is optional throughout — looply
+ * works alone, the phone is an addition.
+ */
+function nextStep(state) {
+    if (!state.configured) {
+        return { text: 'looply has not looked at this project yet.', command: 'looply init' };
+    }
+    if ((state.readyItems ?? 0) === 0 && (state.draftItems ?? 0) === 0) {
+        return { text: 'the queue is empty — find some work first.', command: 'looply scan' };
+    }
+    if ((state.readyItems ?? 0) === 0 && (state.draftItems ?? 0) > 0) {
+        return {
+            text: `${state.draftItems} found, none checked yet.`,
+            command: 'looply verify',
+        };
+    }
+    if (state.runLive)
+        return null;
+    if (!state.paired) {
+        return {
+            text: `${state.readyItems} ready. Pair a phone first if you want to watch it from anywhere.`,
+            command: 'looply run',
+        };
+    }
+    return { text: `${state.readyItems} ready to go.`, command: 'looply run' };
+}
+/** Just the host. A full URL makes the box wider than the screen it sits in. */
+function hostOf(url) {
+    if (!url)
+        return '';
+    try {
+        return new URL(url).host;
+    }
+    catch {
+        return url;
+    }
+}
+function renderWelcome(state, version) {
+    const out = [];
+    out.push('');
+    out.push(`  ${(0, ui_1.bold)((0, ui_1.wordmark)(state.runLive === true))}  ${(0, ui_1.dim)(version)}`);
+    out.push(`  ${(0, ui_1.grey)('your coding agent does the work — looply decides what, and what is kept')}`);
+    out.push('');
+    const rows = [];
+    rows.push(['project', state.configured ? (state.projectName ?? 'this folder') : (0, ui_1.dim)('not set up here')]);
+    rows.push([
+        'machine',
+        state.paired
+            ? `${(0, ui_1.ok)('paired')} ${(0, ui_1.dim)(hostOf(state.serverUrl))}`
+            : (0, ui_1.dim)('not paired'),
+    ]);
+    if (state.configured) {
+        const ready = state.readyItems ?? 0;
+        const draft = state.draftItems ?? 0;
+        rows.push([
+            'queue',
+            ready || draft
+                ? `${(0, ui_1.volt)(String(ready))} ready${draft ? (0, ui_1.grey)(`, ${draft} waiting to be checked`) : ''}`
+                : (0, ui_1.dim)('empty'),
+        ]);
+    }
+    if (state.runLive) {
+        rows.push(['now', `${(0, ui_1.volt)('working')} ${(0, ui_1.grey)('·')} ${state.currentItem ?? 'picking something'}`]);
+    }
+    out.push((0, ui_1.box)((0, ui_1.fields)(rows), { title: 'where you are' }));
+    out.push('');
+    for (const group of ['start', 'work', 'watch']) {
+        const inGroup = exports.COMMANDS.filter((c) => c.group === group);
+        const nameWidth = Math.max(...exports.COMMANDS.map((c) => c.name.length + c.args.length + 1));
+        out.push(`  ${(0, ui_1.grey)(GROUP_TITLES[group])}`);
+        for (const c of inGroup)
+            out.push((0, ui_1.commandLine)(c.name, c.args, c.blurb, nameWidth));
+        out.push('');
+    }
+    const next = nextStep(state);
+    if (next) {
+        out.push((0, ui_1.box)([next.text, '', `${(0, ui_1.step)('')}${(0, ui_1.volt)(next.command)}`], { title: 'next', tone: ui_1.volt }));
+        out.push('');
+    }
+    if (!state.paired) {
+        out.push(`  ${(0, ui_1.warn)((0, ui_1.grey)('run ') + (0, ui_1.volt)('looply pair') + (0, ui_1.grey)(' to watch runs and answer questions from your phone'))}`);
+        out.push('');
+    }
+    return out.join('\n');
+}
+//# sourceMappingURL=welcome.js.map

package/dist/welcome.js.map

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

package/dist/workspace-provisioner.d.ts

@@ -0,0 +1,65 @@
+import { GitDriver } from './git-driver';
+/**
+ * THE MACHINE MAKES ITS OWN CHECKOUT — when the project asked it to (M4-1).
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * Until now only a person created a workspace (`looply run --new-workspace`),
+ * and a scheduler with room under `machine.max_workspaces` and no idle checkout
+ * waited every cadence saying so. With `machine.provision_workspaces: true` the
+ * scheduler may emit ONE `provision` action per tick, and this file answers it
+ * after the tick: the same `createWorkspace` a person uses, from the main
+ * checkout's HEAD, named the way a person's is (`ws-<stamp>-<entropy>`), on its
+ * own branch. The creation marker is cleared once the checkout is complete —
+ * left in place it would read as "being created" for as long as this daemon
+ * lives, and the next tick would never find the checkout idle.
+ *
+ * ⚠️ ONE PER CADENCE, AND A FAILURE IS A LINE. Two goals waiting on a checkout
+ * get one checkout this cadence and one the next; a `git worktree add` that
+ * fails is logged and tried again next cadence, never a stopped daemon.
+ *
+ * ⚠️ AND IT KNOWS NOTHING ABOUT GOALS. A checkout is a checkout; whom it was
+ * asked for is the daemon's to say, in the reason it hands over. That is what
+ * keeps this file off the goal-knowledge roster.
+ *
+ * 🔴 NOTHING IS REAPED, MOVED OR DELETED HERE.
+ *
+ * 🔴 AND IT CARRIES WHAT THE PROJECT SAID A CHECKOUT NEEDS — IT DID NOT.
+ * `run --new-workspace` hands `createWorkspace` the project's
+ * `run.carry_into_checkouts`; this, the MACHINE's way of making the same
+ * checkout, handed it nothing. A worktree holds only what git tracks and the
+ * contained gate has no network, so every checkout the daemon made could not
+ * pass a gate that needs `node_modules`. MEASURED, LIVE, 2026-09-24 (LIVE-2):
+ * two Starts, nine rounds, every one red on `build` in about a second with
+ * the same output digest, while each implementer turn tried to repair a
+ * missing toolchain it could not see — the exact failure `checkout-carry.ts`
+ * was written for, on the one path that did not use it.
+ *
+ * Read from the project's config at the moment of provisioning, as the person's
+ * path reads it, so the two ways of making a checkout cannot disagree about
+ * what it needs. Empty means nothing is copied — byte-identical to before.
+ */
+export type WorkspaceProvisioner = () => Promise<string>;
+export interface ProvisionRequest {
+    /** The daemon's whole reason — whom it was asked for and why — quoted in the log. */
+    readonly because: string;
+}
+export interface ProvisionerDeps {
+    readonly git?: GitDriver;
+    readonly now?: () => number;
+    /** Where the workspaces root lives; the user's home unless a test says otherwise. */
+    readonly home?: string;
+    readonly entropy?: () => string;
+    /** What to carry; read from the project's config when not given (tests give it). */
+    readonly carry?: () => readonly string[];
+}
+export declare function nodeWorkspaceProvisioner(cwd: string, deps?: ProvisionerDeps): WorkspaceProvisioner;
+export type ProvisionOutcome = 'provisioned' | 'failed' | 'none';
+/**
+ * Answer the tick's request, if there was one and provisioning is on. The log
+ * line names the checkout and the daemon's reason; a failure names itself.
+ */
+export declare function provisionOnce(request: ProvisionRequest | null, provisioner: WorkspaceProvisioner | null, log: (line: string) => void): Promise<{
+    outcome: ProvisionOutcome;
+    path: string | null;
+}>;
+//# sourceMappingURL=workspace-provisioner.d.ts.map

package/dist/workspace-provisioner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-provisioner.d.ts","sourceRoot":"","sources":["../src/workspace-provisioner.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAA0B,MAAM,cAAc,CAAC;AAIjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,qFAAqF;IACrF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,qFAAqF;IACrF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,MAAM,CAAC;IAChC,oFAAoF;IACpF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,eAAoB,GAAG,oBAAoB,CAkBtG;AAeD,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEjE;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,gBAAgB,GAAG,IAAI,EAChC,WAAW,EAAE,oBAAoB,GAAG,IAAI,EACxC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC1B,OAAO,CAAC;IAAE,OAAO,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAe7D"}

package/dist/workspace-provisioner.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nodeWorkspaceProvisioner = nodeWorkspaceProvisioner;
+exports.provisionOnce = provisionOnce;
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const node_fs_1 = require("node:fs");
+const config_1 = require("./config");
+const git_driver_1 = require("./git-driver");
+const reaper_1 = require("./reaper");
+const workspace_1 = require("./workspace");
+function nodeWorkspaceProvisioner(cwd, deps = {}) {
+    const git = deps.git ?? new git_driver_1.GitDriver((0, git_driver_1.nodeGitExec)(cwd));
+    const now = deps.now ?? (() => Date.now());
+    const entropy = deps.entropy ?? (() => Math.floor(Math.random() * 1e6).toString(36));
+    return async () => {
+        const base = await git.headSha();
+        const stamp = new Date(now()).toISOString().replace(/[-:T]/g, '').slice(0, 14);
+        const name = `ws-${stamp}-${entropy()}`;
+        // Its own branch from the outset, as a person's is: a worktree cannot share
+        // a checked-out branch with another, and the round runner cuts its run
+        // branch inside.
+        const carry = deps.carry ? deps.carry() : declaredCarry(cwd);
+        const path = await (0, workspace_1.createWorkspace)(git, cwd, name, `looply/${name}`, base, deps.home ?? (0, node_os_1.homedir)(), carry);
+        (0, workspace_1.clearCreationMarker)((0, node_path_1.join)(path, git_driver_1.STATE_DIR, 'state'));
+        // M4-4: the fact that the MACHINE made it, for the reaper — a person's checkout has no such marker.
+        (0, reaper_1.writeProvisionedMarker)((0, node_path_1.join)(path, git_driver_1.STATE_DIR, 'state'), new Date(now()).toISOString(), process.pid);
+        return path;
+    };
+}
+/**
+ * `run.carry_into_checkouts` from the project's config. No config file means
+ * nothing declared — nothing carried, exactly as before. A config that EXISTS
+ * and does not parse throws: `provisionOnce` turns that into a line and tries
+ * again next cadence, rather than making a checkout that silently lacks what
+ * the file meant to say it needs.
+ */
+function declaredCarry(cwd) {
+    const file = (0, node_path_1.join)(cwd, git_driver_1.STATE_DIR, 'config.yaml');
+    if (!(0, node_fs_1.existsSync)(file))
+        return [];
+    return (0, config_1.parseConfig)((0, node_fs_1.readFileSync)(file, 'utf8')).run.carryIntoCheckouts ?? [];
+}
+/**
+ * Answer the tick's request, if there was one and provisioning is on. The log
+ * line names the checkout and the daemon's reason; a failure names itself.
+ */
+async function provisionOnce(request, provisioner, log) {
+    if (request === null)
+        return { outcome: 'none', path: null };
+    if (provisioner === null) {
+        log(`daemon  : the scheduler asked for a checkout ${request.because}, but provisioning is off — not created`);
+        return { outcome: 'none', path: null };
+    }
+    try {
+        const path = await provisioner();
+        log(`daemon  : provisioned workspace ${path} ${request.because}`);
+        // The path comes back so the caller can keep the reaper off it this cadence (M4-4).
+        return { outcome: 'provisioned', path };
+    }
+    catch (e) {
+        log(`daemon  : could not provision a workspace ${request.because} — ${e.message}`);
+        return { outcome: 'failed', path: null };
+    }
+}
+//# sourceMappingURL=workspace-provisioner.js.map

package/dist/workspace-provisioner.js.map

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

package/dist/workspace-quarantine.d.ts

@@ -0,0 +1,64 @@
+/**
+ * A WORKSPACE LOOPLY HAS DECIDED IT MUST NOT TOUCH, AND WHY, DURABLY.
+ *
+ * 🔴 EVERY WORKSPACE STATE IN PHASE 1 IS RECOMPUTED FROM THE FILESYSTEM.
+ *
+ * `reapWorkspace` asks `workspaceResidue` whether a checkout holds files
+ * nothing else has a copy of, refuses if it does, and forgets. Next command,
+ * same question, same walk, same answer. That works — and it means the reason a
+ * checkout is being kept exists only for the length of one process. Nothing
+ * records that looply LOOKED, nothing records what it found, and a person
+ * running `looply runs` tomorrow sees a directory described as "abandoned" with
+ * no hint that the machine has already decided, three times, not to remove it.
+ *
+ * ⚠️ AND ONE OF THE THREE CONDITIONS IS NOT RECOMPUTABLE. A live orphaned agent
+ * is gone by the time anyone looks; a `repoConfigTrouble` surfaces today only
+ * as a caught throw inside `workspaceResidue`, indistinguishable from a
+ * permissions error. A judgement that cannot be re-derived has to be written
+ * down or it is not a judgement, it is a coincidence.
+ *
+ * ⚠️ IT NEVER RESETS ITSELF. Nothing here clears a quarantine — not a clean
+ * tree, not a later run, not a reap. The one thing that clears it is a person
+ * typing `looply runs --release <workspace>`, which is the same posture
+ * `recovery.ts` already takes: looply cannot tell whose changes those are.
+ *
+ * ⚠️ WHERE IT LIVES, AND THE TWO CANDIDATES THAT DO NOT WORK.
+ * `<workspace>/.looply/state/` is invisible to `workspaceResidue` (which skips
+ * `.looply/state`), which is what you want — but `retainEvidence` MOVES that
+ * whole directory on a successful reap, and `worktree remove` deletes the rest,
+ * so the record dies with the thing it describes. The project state directory
+ * survives both, is readable from every checkout of the repository, and is
+ * where the run registry already lives.
+ */
+export interface Quarantine {
+    /** The workspace directory, as it was resolved when the decision was made. */
+    readonly workspace: string;
+    /** Why looply will not touch it. A sentence for a person, not a code. */
+    readonly because: string;
+    /** What noticed: the reaper, a residue walk, a config check. */
+    readonly noticedBy: string;
+    readonly at: string;
+}
+export declare function quarantineDir(cwd: string): string;
+/**
+ * Record that looply must not touch this checkout.
+ *
+ * ⚠️ THE FIRST DECISION STANDS. A later refusal for a different reason does not
+ * overwrite the first: the reason a person needs is the one that started it,
+ * and a record that kept changing would make the history unreadable at exactly
+ * the moment somebody is trying to understand what happened.
+ */
+export declare function quarantine(cwd: string, workspace: string, because: string, noticedBy: string, now?: () => number): Quarantine | null;
+/** The quarantine on this workspace, or null. Unreadable counts as quarantined. */
+export declare function quarantineOf(cwd: string, workspace: string): Quarantine | null;
+/** Every quarantined workspace this project knows about. */
+export declare function listQuarantined(cwd: string): Quarantine[];
+/**
+ * A person says the checkout is theirs to deal with now.
+ *
+ * ⚠️ THE ONLY THING THAT CLEARS ONE, and it removes the RECORD, never the
+ * directory. Whatever made looply refuse is still there; what changed is that
+ * a person has looked at it.
+ */
+export declare function clearQuarantine(cwd: string, workspace: string): boolean;
+//# sourceMappingURL=workspace-quarantine.d.ts.map

package/dist/workspace-quarantine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-quarantine.d.ts","sourceRoot":"","sources":["../src/workspace-quarantine.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,WAAW,UAAU;IACzB,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAeD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AA4BD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,GAAG,GAAE,MAAM,MAAyB,GACnC,UAAU,GAAG,IAAI,CA2BnB;AAED,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAY9E;AAkBD,4DAA4D;AAC5D,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,EAAE,CAazD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CASvE"}