@cluesmith/codev 3.2.2 → 3.2.4

package/dist/agent-farm/servers/session-log-sweep.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Issue #1238: retention for PTY session logs.
+ *
+ * `PtySession` already bounds a *single* session's log (50 MB, one `.1`
+ * rotation — see `../../terminal/pty-session.ts`), but nothing has ever
+ * deleted the log of a session that ended. Every terminal Tower has ever
+ * opened leaves a file behind forever: an audited machine reached 29,728 files
+ * / 19 GB in `~/.agent-farm/logs`, 97% of it untouched for over a month.
+ *
+ * This module adds the missing cross-file policy: a log is deleted once its
+ * last write is older than the retention window. mtime is the retention key
+ * because the last byte written to a session log is, in effect, the moment
+ * that session stopped producing output — the "session ended" signal, without
+ * needing to join against DB session state (which is itself pruned, so dead
+ * sessions leave no row to join against).
+ *
+ * Live sessions are excluded by id regardless of mtime. A session log's fd is
+ * held open for the session's whole life, so unlinking it under a live writer
+ * would silently redirect every subsequent write into an unlinked inode —
+ * losing the log of the one session someone might actually want to read. A
+ * 30-day-idle live session is vanishingly unlikely, but the guard is cheap.
+ *
+ * Wired in `./tower-server.ts` on two triggers (Tower startup, and a daily
+ * in-process timer), mirroring the husk sweep in `./shellper-husk-sweep.ts`.
+ */
+export declare const DEFAULT_LOG_RETENTION_DAYS = 30;
+export declare const DEFAULT_LOG_SWEEP_INTERVAL_MS: number;
+export declare const MS_PER_DAY: number;
+/**
+ * Retention window in days (env `AGENT_FARM_LOG_RETENTION_DAYS`, default 30).
+ * `0` disables the sweep entirely — an explicit "keep everything" opt-out for
+ * anyone who treats these logs as an audit trail.
+ *
+ * NaN-checked rather than `parsed || default` because `0` is a meaningful
+ * override and is falsy in JS (same reasoning as `resolveHuskGraceMs`).
+ */
+export declare function resolveLogRetentionDays(env?: NodeJS.ProcessEnv): number;
+/**
+ * Sweep cadence (env `AGENT_FARM_LOG_SWEEP_INTERVAL_MS`, default 24h). Floored
+ * at 1s so a bad value can't spin the event loop; tests shorten it deliberately.
+ */
+export declare function resolveLogSweepIntervalMs(env?: NodeJS.ProcessEnv): number;
+export interface SessionLogFootprint {
+    /** Number of session log files (including `.log.1` rotations). */
+    files: number;
+    /** Total bytes on disk. */
+    bytes: number;
+    /** mtime of the oldest log, or null when there are none. */
+    oldestMtimeMs: number | null;
+}
+/**
+ * Total footprint of the session log directory. Read-only — used by
+ * `codev doctor` to surface the number the issue was filed about, and by the
+ * sweep's own logging. A missing directory is a healthy zero, not an error.
+ */
+export declare function measureSessionLogs(logDir: string): SessionLogFootprint;
+export interface SweepSessionLogsOptions {
+    /** The session log directory, i.e. `~/.agent-farm/logs`. */
+    logDir: string;
+    /** Age at which a log becomes eligible for deletion. `0` disables the sweep. */
+    retentionMs: number;
+    /**
+     * Ids of sessions that are alive right now. Their logs are never deleted,
+     * however old the mtime looks, because their fd is still open.
+     */
+    activeSessionIds?: Iterable<string>;
+    /** Seam, defaults to `Date.now()`. */
+    now?: number;
+    log?: (msg: string) => void;
+}
+export interface SweepSessionLogsResult {
+    /** Session log files examined. */
+    scanned: number;
+    /** Files unlinked. */
+    deleted: number;
+    /** Bytes reclaimed (sum of the deleted files' sizes). */
+    bytesFreed: number;
+    /** Aged-out files kept because their session is still live. */
+    skippedActive: number;
+    /** Files that were eligible but could not be unlinked. */
+    failed: number;
+}
+/**
+ * Delete session logs whose last write is older than `retentionMs`.
+ *
+ * Never throws: a log directory that can't be read, or an individual file that
+ * can't be stat'd or unlinked, is counted and skipped. Log retention is
+ * janitorial — it must not be able to take Tower's startup path down with it.
+ */
+export declare function sweepSessionLogs(opts: SweepSessionLogsOptions): SweepSessionLogsResult;
+/** Human-readable byte count for log lines and `codev doctor` output. */
+export declare function formatBytes(bytes: number): string;
+//# sourceMappingURL=session-log-sweep.d.ts.map

package/dist/agent-farm/servers/session-log-sweep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-log-sweep.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/servers/session-log-sweep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAQH,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAC7C,eAAO,MAAM,6BAA6B,QAAsB,CAAC;AAEjE,eAAO,MAAM,UAAU,QAAsB,CAAC;AAE9C;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAGpF;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAGtF;AAED,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAyBtE;AAED,MAAM,WAAW,uBAAuB;IACtC,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpC,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,aAAa,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,uBAAuB,GAAG,sBAAsB,CA2DtF;AAED,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUjD"}

package/dist/agent-farm/servers/session-log-sweep.js

@@ -0,0 +1,165 @@
+/**
+ * Issue #1238: retention for PTY session logs.
+ *
+ * `PtySession` already bounds a *single* session's log (50 MB, one `.1`
+ * rotation — see `../../terminal/pty-session.ts`), but nothing has ever
+ * deleted the log of a session that ended. Every terminal Tower has ever
+ * opened leaves a file behind forever: an audited machine reached 29,728 files
+ * / 19 GB in `~/.agent-farm/logs`, 97% of it untouched for over a month.
+ *
+ * This module adds the missing cross-file policy: a log is deleted once its
+ * last write is older than the retention window. mtime is the retention key
+ * because the last byte written to a session log is, in effect, the moment
+ * that session stopped producing output — the "session ended" signal, without
+ * needing to join against DB session state (which is itself pruned, so dead
+ * sessions leave no row to join against).
+ *
+ * Live sessions are excluded by id regardless of mtime. A session log's fd is
+ * held open for the session's whole life, so unlinking it under a live writer
+ * would silently redirect every subsequent write into an unlinked inode —
+ * losing the log of the one session someone might actually want to read. A
+ * 30-day-idle live session is vanishingly unlikely, but the guard is cheap.
+ *
+ * Wired in `./tower-server.ts` on two triggers (Tower startup, and a daily
+ * in-process timer), mirroring the husk sweep in `./shellper-husk-sweep.ts`.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+/** `<session-uuid>.log` and its single rotation `<session-uuid>.log.1`. */
+const SESSION_LOG_RE = /^(.+)\.log(\.1)?$/;
+export const DEFAULT_LOG_RETENTION_DAYS = 30;
+export const DEFAULT_LOG_SWEEP_INTERVAL_MS = 24 * 60 * 60 * 1000;
+export const MS_PER_DAY = 24 * 60 * 60 * 1000;
+/**
+ * Retention window in days (env `AGENT_FARM_LOG_RETENTION_DAYS`, default 30).
+ * `0` disables the sweep entirely — an explicit "keep everything" opt-out for
+ * anyone who treats these logs as an audit trail.
+ *
+ * NaN-checked rather than `parsed || default` because `0` is a meaningful
+ * override and is falsy in JS (same reasoning as `resolveHuskGraceMs`).
+ */
+export function resolveLogRetentionDays(env = process.env) {
+    const parsed = parseInt(env.AGENT_FARM_LOG_RETENTION_DAYS ?? '', 10);
+    return Math.max(Number.isNaN(parsed) ? DEFAULT_LOG_RETENTION_DAYS : parsed, 0);
+}
+/**
+ * Sweep cadence (env `AGENT_FARM_LOG_SWEEP_INTERVAL_MS`, default 24h). Floored
+ * at 1s so a bad value can't spin the event loop; tests shorten it deliberately.
+ */
+export function resolveLogSweepIntervalMs(env = process.env) {
+    const parsed = parseInt(env.AGENT_FARM_LOG_SWEEP_INTERVAL_MS ?? '', 10);
+    return Math.max(Number.isNaN(parsed) ? DEFAULT_LOG_SWEEP_INTERVAL_MS : parsed, 1000);
+}
+/**
+ * Total footprint of the session log directory. Read-only — used by
+ * `codev doctor` to surface the number the issue was filed about, and by the
+ * sweep's own logging. A missing directory is a healthy zero, not an error.
+ */
+export function measureSessionLogs(logDir) {
+    const footprint = { files: 0, bytes: 0, oldestMtimeMs: null };
+    let entries;
+    try {
+        entries = fs.readdirSync(logDir);
+    }
+    catch {
+        return footprint;
+    }
+    for (const name of entries) {
+        if (!SESSION_LOG_RE.test(name))
+            continue;
+        let stat;
+        try {
+            stat = fs.statSync(path.join(logDir, name));
+        }
+        catch {
+            continue; // vanished mid-scan — nothing to account for
+        }
+        if (!stat.isFile())
+            continue;
+        footprint.files += 1;
+        footprint.bytes += stat.size;
+        if (footprint.oldestMtimeMs === null || stat.mtimeMs < footprint.oldestMtimeMs) {
+            footprint.oldestMtimeMs = stat.mtimeMs;
+        }
+    }
+    return footprint;
+}
+/**
+ * Delete session logs whose last write is older than `retentionMs`.
+ *
+ * Never throws: a log directory that can't be read, or an individual file that
+ * can't be stat'd or unlinked, is counted and skipped. Log retention is
+ * janitorial — it must not be able to take Tower's startup path down with it.
+ */
+export function sweepSessionLogs(opts) {
+    const result = {
+        scanned: 0,
+        deleted: 0,
+        bytesFreed: 0,
+        skippedActive: 0,
+        failed: 0,
+    };
+    if (opts.retentionMs <= 0)
+        return result;
+    const now = opts.now ?? Date.now();
+    const active = new Set(opts.activeSessionIds ?? []);
+    let entries;
+    try {
+        entries = fs.readdirSync(opts.logDir);
+    }
+    catch {
+        return result; // no log dir yet (fresh install) — nothing to sweep
+    }
+    for (const name of entries) {
+        const match = SESSION_LOG_RE.exec(name);
+        if (!match)
+            continue;
+        const fullPath = path.join(opts.logDir, name);
+        let stat;
+        try {
+            stat = fs.statSync(fullPath);
+        }
+        catch {
+            continue;
+        }
+        if (!stat.isFile())
+            continue;
+        result.scanned += 1;
+        if (now - stat.mtimeMs < opts.retentionMs)
+            continue;
+        if (active.has(match[1])) {
+            result.skippedActive += 1;
+            continue;
+        }
+        try {
+            fs.unlinkSync(fullPath);
+            result.deleted += 1;
+            result.bytesFreed += stat.size;
+        }
+        catch {
+            result.failed += 1;
+        }
+    }
+    if (result.deleted > 0 || result.failed > 0) {
+        opts.log?.(`Session log sweep: deleted ${result.deleted} log(s), freed ${formatBytes(result.bytesFreed)}` +
+            ` (${result.scanned} scanned` +
+            (result.skippedActive > 0 ? `, ${result.skippedActive} kept as live` : '') +
+            (result.failed > 0 ? `, ${result.failed} failed` : '') +
+            ')');
+    }
+    return result;
+}
+/** Human-readable byte count for log lines and `codev doctor` output. */
+export function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    const units = ['KB', 'MB', 'GB', 'TB'];
+    let value = bytes / 1024;
+    let unit = 0;
+    while (value >= 1024 && unit < units.length - 1) {
+        value /= 1024;
+        unit += 1;
+    }
+    return `${value < 10 ? value.toFixed(1) : Math.round(value)} ${units[unit]}`;
+}
+//# sourceMappingURL=session-log-sweep.js.map

package/dist/agent-farm/servers/session-log-sweep.js.map

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

package/dist/agent-farm/servers/shellper-husk-sweep.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Issue #1227: a stricter, second-pass reap for shellper "husks" — a shellper
+ * whose PTY child has exited (deliberate lingering behavior from #905/#1198 so
+ * a reconnect can replay history) but which `killOrphanedShellpers`
+ * (`../../terminal/session-manager.ts`) can never reap, because that function
+ * unconditionally protects any shellper whose Unix socket still responds.
+ *
+ * A husk still answers its socket, so it survives `killOrphanedShellpers`
+ * forever. The predicate here is stricter and orthogonal: a shellper is a husk
+ * only when it is simultaneously
+ *   - unregistered  — not a live PID in `terminal_sessions.shellper_pid`
+ *   - childless     — no process in the table has it as a parent (OS-level
+ *                      signal; there is no wire-protocol "has-child" frame)
+ *   - aged          — older than `graceMs`, which absorbs any legitimate
+ *                      mid-respawn / mid-adoption transient (seconds), so the
+ *                      three conditions together can only ever be true for a
+ *                      genuine husk (per the issue: "unregistered and
+ *                      childless" is a terminal state — a shellper that lost
+ *                      its registration can never receive another SPAWN).
+ *
+ * The actual kill is delegated to `reapShellpers` (`./architect-session-holder.js`,
+ * SIGTERM → poll → SIGKILL → confirm-death) rather than reimplemented here.
+ */
+import type Database from 'better-sqlite3';
+import { type ProcessCensusEntry } from './process-census.js';
+export declare const SHELLPER_MARKER = "shellper-main.js";
+/**
+ * The set of shellper PIDs Tower currently believes are registered, per
+ * `terminal_sessions` — validated against each PID's actual process start
+ * time to guard against PID reuse (a stale row whose PID was reused by an
+ * unrelated process does not count as registered).
+ */
+export declare function computeRegisteredShellperPids(db: Database.Database, getStartTime?: (pid: number) => Promise<number | null>): Promise<Set<number>>;
+export interface FindHuskShellpersOptions {
+    /** This Tower instance's socket directory — scopes the sweep so another
+     * instance's (or another user's) legitimate shellpers are never touched. */
+    socketDir: string;
+    registeredShellperPids: Set<number>;
+    graceMs: number;
+    /**
+     * Seam, defaults to `listProcessCensus`. Accepts a plain array too (not just
+     * a function returning one) so a caller that already took a snapshot for
+     * another purpose (e.g. RSS display) can pass it through and avoid a second
+     * `ps` scan — see `handleHuskPreview` in tower-routes.ts.
+     */
+    census?: () => ProcessCensusEntry[] | Promise<ProcessCensusEntry[]>;
+    /** Seam, defaults to `Date.now()`. */
+    now?: number;
+    /** Seam, defaults to `getProcessStartTime`. */
+    getStartTime?: (pid: number) => Promise<number | null>;
+}
+/**
+ * Returns the PIDs of shellper-main.js processes, scoped to `socketDir`, that
+ * are unregistered AND childless AND older than `graceMs`.
+ */
+export declare function findHuskShellpers(opts: FindHuskShellpersOptions): Promise<number[]>;
+/**
+ * The husk grace period (env `SHELLPER_HUSK_GRACE_MS`, default 1 hour), shared
+ * by every trigger (startup, periodic, on-demand preview/apply) so a preview
+ * always predicts what the periodic sweep would actually do.
+ *
+ * NaN-checked rather than `parsed || default`: `0` is a legitimate override
+ * (tests want an immediate-eligibility grace period) and `0` is falsy in JS,
+ * so `parsed || default` would silently discard a deliberate zero.
+ */
+export declare function resolveHuskGraceMs(env?: NodeJS.ProcessEnv): number;
+export interface SweepShellperHusksOptions {
+    socketDir: string;
+    db: Database.Database;
+    graceMs: number;
+    log?: (msg: string) => void;
+    census?: () => ProcessCensusEntry[] | Promise<ProcessCensusEntry[]>;
+    now?: number;
+    getStartTime?: (pid: number) => Promise<number | null>;
+    /** Seam, defaults to `reapShellpers`. */
+    reap?: (pids: number[]) => Promise<void>;
+}
+/**
+ * Compute the registered-shellper set from the DB, find husk candidates, and
+ * reap them. Returns the swept PIDs so callers (startup log, periodic-timer
+ * log, on-demand CLI) can report what happened.
+ */
+export declare function sweepShellperHusks(opts: SweepShellperHusksOptions): Promise<{
+    swept: number;
+    pids: number[];
+}>;
+//# sourceMappingURL=shellper-husk-sweep.d.ts.map

package/dist/agent-farm/servers/shellper-husk-sweep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shellper-husk-sweep.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/servers/shellper-husk-sweep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAIjF,eAAO,MAAM,eAAe,qBAAqB,CAAC;AAgBlD;;;;;GAKG;AACH,wBAAsB,6BAA6B,CACjD,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,YAAY,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAuB,GAC1E,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAmBtB;AAED,MAAM,WAAW,wBAAwB;IACvC;gFAC4E;IAC5E,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,kBAAkB,EAAE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACpE,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACxD;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAyBzF;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAG/E;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,kBAAkB,EAAE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACpE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACvD,yCAAyC;IACzC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAmB5C"}

package/dist/agent-farm/servers/shellper-husk-sweep.js

@@ -0,0 +1,129 @@
+/**
+ * Issue #1227: a stricter, second-pass reap for shellper "husks" — a shellper
+ * whose PTY child has exited (deliberate lingering behavior from #905/#1198 so
+ * a reconnect can replay history) but which `killOrphanedShellpers`
+ * (`../../terminal/session-manager.ts`) can never reap, because that function
+ * unconditionally protects any shellper whose Unix socket still responds.
+ *
+ * A husk still answers its socket, so it survives `killOrphanedShellpers`
+ * forever. The predicate here is stricter and orthogonal: a shellper is a husk
+ * only when it is simultaneously
+ *   - unregistered  — not a live PID in `terminal_sessions.shellper_pid`
+ *   - childless     — no process in the table has it as a parent (OS-level
+ *                      signal; there is no wire-protocol "has-child" frame)
+ *   - aged          — older than `graceMs`, which absorbs any legitimate
+ *                      mid-respawn / mid-adoption transient (seconds), so the
+ *                      three conditions together can only ever be true for a
+ *                      genuine husk (per the issue: "unregistered and
+ *                      childless" is a terminal state — a shellper that lost
+ *                      its registration can never receive another SPAWN).
+ *
+ * The actual kill is delegated to `reapShellpers` (`./architect-session-holder.js`,
+ * SIGTERM → poll → SIGKILL → confirm-death) rather than reimplemented here.
+ */
+import { listProcessCensus } from './process-census.js';
+import { getProcessStartTime } from '../../terminal/session-manager.js';
+import { reapShellpers } from './architect-session-holder.js';
+export const SHELLPER_MARKER = 'shellper-main.js';
+/**
+ * Same tolerance `SessionManager.reconnectSession` uses
+ * (`../../terminal/session-manager.ts:471`) to detect PID reuse: a live
+ * process's actual start time must match the DB-recorded one within this
+ * window, or the DB row is stale (its PID was reused by an unrelated
+ * process) and must not count as "registered".
+ */
+const PID_REUSE_TOLERANCE_MS = 2000;
+/**
+ * The set of shellper PIDs Tower currently believes are registered, per
+ * `terminal_sessions` — validated against each PID's actual process start
+ * time to guard against PID reuse (a stale row whose PID was reused by an
+ * unrelated process does not count as registered).
+ */
+export async function computeRegisteredShellperPids(db, getStartTime = getProcessStartTime) {
+    const rows = db
+        .prepare('SELECT shellper_pid, shellper_start_time FROM terminal_sessions WHERE shellper_pid IS NOT NULL')
+        .all();
+    const registered = new Set();
+    for (const row of rows) {
+        if (row.shellper_start_time === null) {
+            // Legacy row with no recorded start time — no positive signal to
+            // invalidate it, so trust the registration.
+            registered.add(row.shellper_pid);
+            continue;
+        }
+        const actual = await getStartTime(row.shellper_pid);
+        if (actual !== null && Math.abs(actual - row.shellper_start_time) <= PID_REUSE_TOLERANCE_MS) {
+            registered.add(row.shellper_pid);
+        }
+    }
+    return registered;
+}
+/**
+ * Returns the PIDs of shellper-main.js processes, scoped to `socketDir`, that
+ * are unregistered AND childless AND older than `graceMs`.
+ */
+export async function findHuskShellpers(opts) {
+    const census = await (opts.census ?? listProcessCensus)();
+    const now = opts.now ?? Date.now();
+    const getStartTime = opts.getStartTime ?? getProcessStartTime;
+    // Match the trailing-'/' scope-marker technique already proven in
+    // findShellperProcesses (../../terminal/session-manager.ts:782-793) to
+    // prevent prefix collisions (e.g. /run matching /run2).
+    const scopeMarker = opts.socketDir.endsWith('/') ? opts.socketDir : `${opts.socketDir}/`;
+    const parentPids = new Set(census.map((entry) => entry.ppid));
+    const candidates = [];
+    for (const entry of census) {
+        if (!entry.cmdline.includes(SHELLPER_MARKER))
+            continue;
+        if (!entry.cmdline.includes(scopeMarker))
+            continue;
+        if (opts.registeredShellperPids.has(entry.pid))
+            continue;
+        if (parentPids.has(entry.pid))
+            continue; // has a live child — not a husk
+        const startTime = await getStartTime(entry.pid);
+        if (startTime === null)
+            continue; // can't confirm age — safe default is to skip
+        if (now - startTime < opts.graceMs)
+            continue; // too young — race-safety window
+        candidates.push(entry.pid);
+    }
+    return candidates;
+}
+/**
+ * The husk grace period (env `SHELLPER_HUSK_GRACE_MS`, default 1 hour), shared
+ * by every trigger (startup, periodic, on-demand preview/apply) so a preview
+ * always predicts what the periodic sweep would actually do.
+ *
+ * NaN-checked rather than `parsed || default`: `0` is a legitimate override
+ * (tests want an immediate-eligibility grace period) and `0` is falsy in JS,
+ * so `parsed || default` would silently discard a deliberate zero.
+ */
+export function resolveHuskGraceMs(env = process.env) {
+    const parsed = parseInt(env.SHELLPER_HUSK_GRACE_MS || '3600000', 10);
+    return Math.max(Number.isNaN(parsed) ? 3600000 : parsed, 0);
+}
+/**
+ * Compute the registered-shellper set from the DB, find husk candidates, and
+ * reap them. Returns the swept PIDs so callers (startup log, periodic-timer
+ * log, on-demand CLI) can report what happened.
+ */
+export async function sweepShellperHusks(opts) {
+    const getStartTime = opts.getStartTime ?? getProcessStartTime;
+    const registeredShellperPids = await computeRegisteredShellperPids(opts.db, getStartTime);
+    const pids = await findHuskShellpers({
+        socketDir: opts.socketDir,
+        registeredShellperPids,
+        graceMs: opts.graceMs,
+        census: opts.census,
+        now: opts.now,
+        getStartTime,
+    });
+    if (pids.length > 0) {
+        opts.log?.(`Sweeping ${pids.length} husk shellper process(es): ${pids.join(', ')}`);
+        const reap = opts.reap ?? reapShellpers;
+        await reap(pids);
+    }
+    return { swept: pids.length, pids };
+}
+//# sourceMappingURL=shellper-husk-sweep.js.map

package/dist/agent-farm/servers/shellper-husk-sweep.js.map

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

package/dist/agent-farm/servers/tower-instances.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tower-instances.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/servers/tower-instances.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tower-instances.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/servers/tower-instances.ts"],"names":[],"mappings":"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"}