crewly 1.20.359 → 1.20.360

package/dist/backend/backend/src/services/worktree/worktree-tiers.js

@@ -0,0 +1,279 @@
+/**
+ * Worktree age tiers — what the janitor does with a worktree it must keep
+ * (unmerged or dirty) once nobody has touched it for days (crewly#1354).
+ *
+ * The 1.20.159 janitor removes only worktrees whose work has landed. Every
+ * other one stayed forever with a full `node_modules` (2–3 GB each; one Mac
+ * kept 21 of them, ~15 GB). Two tiers now apply to a kept worktree that is
+ * untouched — no file, no index write, no commit newer — and has no process
+ * inside:
+ *
+ * - **strip** (idle ≥ 3 days; 1 day under low disk or once its WorkItem
+ *   finished): delete its regenerable dirs (`node_modules`, `.next`, `dist`,
+ *   `.turbo`, `.cache`) — never a directory git tracks anything under, never
+ *   source. Reversible with `npm install` / a rebuild.
+ * - **archive** (idle ≥ 14 days): save its tracked changes (`git diff HEAD
+ *   --binary`) and its untracked, non-regenerable files as one patch under
+ *   `<CREWLY_HOME>/worktree-archive/<repo>/<name>-<date>.patch` (size-capped),
+ *   keep its branch (its commits stay in the repo; a detached HEAD gets a
+ *   `refs/crewly-archive/...` ref), then remove the worktree.
+ *
+ * The lead of the owning team is told once per worktree per tier. This file
+ * holds the decisions, the patch writer and the wording; the service wires
+ * them into its pass.
+ *
+ * @module services/worktree/worktree-tiers
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { WORKTREE_JANITOR_CONSTANTS } from '../../constants.js';
+import { formatBytes } from './worktree-janitor.git.js';
+import { isRegenerablePath } from './worktree-dirty.js';
+/** An empty tier state. */
+export function emptyTierState() {
+    return { stripped: {}, archived: {}, finished: {} };
+}
+/**
+ * Normalise whatever was read from disk into a {@link TierState}.
+ *
+ * @param raw - Parsed JSON, or null
+ * @returns A complete state (missing maps are empty)
+ */
+export function normalizeTierState(raw) {
+    const out = emptyTierState();
+    if (!raw || typeof raw !== 'object')
+        return out;
+    const r = raw;
+    for (const key of ['stripped', 'archived', 'finished']) {
+        const m = r[key];
+        if (!m || typeof m !== 'object')
+            continue;
+        for (const [p, at] of Object.entries(m)) {
+            if (typeof at === 'number' && Number.isFinite(at))
+                out[key][p] = at;
+        }
+    }
+    return out;
+}
+/**
+ * Drop entries too old to matter so the state file does not grow forever.
+ * Stripped / archived records of worktrees that no longer exist are dropped
+ * too (the caller passes the paths it still sees).
+ *
+ * @param state - Tier state
+ * @param now - Current epoch ms
+ * @param existing - Worktree paths that still exist (others' strip records go)
+ * @returns A pruned copy
+ */
+export function pruneTierState(state, now, existing) {
+    const maxAge = WORKTREE_JANITOR_CONSTANTS.TIER_STATE_MAX_AGE_MS;
+    const out = emptyTierState();
+    for (const [p, at] of Object.entries(state.stripped))
+        if (existing.has(p))
+            out.stripped[p] = at;
+    for (const [p, at] of Object.entries(state.archived))
+        if (now - at < maxAge)
+            out.archived[p] = at;
+    for (const [p, at] of Object.entries(state.finished))
+        if (now - at < maxAge && existing.has(p))
+            out.finished[p] = at;
+    return out;
+}
+/**
+ * How long a worktree has been untouched, for the tier decision: the newest
+ * of its shallow tree mtime, its git-dir mtime (index / HEAD / reflog) and
+ * its newest commit. Unknown parts are ignored; all unknown = null.
+ *
+ * @param input - Current time and the three "last touched" signals (ms epoch or null)
+ * @returns Idle ms, or null when nothing is known
+ */
+export function tierIdleMs(input) {
+    const known = [input.treeMtimeMs, input.gitMtimeMs, input.newestCommitMs].filter((v) => typeof v === 'number' && Number.isFinite(v));
+    if (known.length === 0)
+        return null;
+    return Math.max(0, input.now - Math.max(...known));
+}
+/**
+ * Which tier a kept worktree has reached.
+ *
+ * @param input - Idle ms (null = unknown → none), low-disk mode, when its WorkItem finished (ms epoch or undefined)
+ * @returns `archive` at 14 days, `strip` at 3 days (1 day under low disk or after a finished WorkItem), else null
+ *
+ * @example
+ * ```typescript
+ * tierFor({ idleMs: 4 * DAY, lowDisk: false });                     // 'strip'
+ * tierFor({ idleMs: 30 * HOUR, lowDisk: true });                    // 'strip'
+ * tierFor({ idleMs: 30 * HOUR, lowDisk: false, finishedAt: t });    // 'strip'
+ * tierFor({ idleMs: 15 * DAY, lowDisk: false });                    // 'archive'
+ * ```
+ */
+export function tierFor(input) {
+    if (input.idleMs === null)
+        return null;
+    if (input.idleMs >= WORKTREE_JANITOR_CONSTANTS.ARCHIVE_MIN_IDLE_MS)
+        return 'archive';
+    const stripAfter = input.lowDisk || input.finishedAt !== undefined
+        ? WORKTREE_JANITOR_CONSTANTS.STRIP_MIN_IDLE_LOW_DISK_MS
+        : WORKTREE_JANITOR_CONSTANTS.STRIP_MIN_IDLE_MS;
+    return input.idleMs >= stripAfter ? 'strip' : null;
+}
+/** Date part of an ISO timestamp (`2026-10-17`). */
+function dateStamp(now) {
+    return new Date(now).toISOString().slice(0, 10);
+}
+/**
+ * Where a worktree's archive patch goes:
+ * `<archiveRoot>/<repo basename>/<worktree basename>-<date>.patch`, with a
+ * numeric suffix when that file already exists.
+ *
+ * @param archiveRoot - `<CREWLY_HOME>/worktree-archive`
+ * @param repoMain - Main worktree of the repo
+ * @param worktreePath - The worktree
+ * @param now - Current epoch ms (for the date)
+ * @returns Absolute patch path (not created)
+ */
+export function archivePatchPath(archiveRoot, repoMain, worktreePath, now) {
+    const dir = path.join(archiveRoot, path.basename(repoMain));
+    const base = `${path.basename(worktreePath)}-${dateStamp(now)}`;
+    let candidate = path.join(dir, `${base}.patch`);
+    for (let i = 2; fs.existsSync(candidate) && i < 100; i++)
+        candidate = path.join(dir, `${base}-${i}.patch`);
+    return candidate;
+}
+/**
+ * Write a worktree's uncommitted work as one patch file: a `#` header (repo,
+ * worktree, branch, HEAD, how to apply), `git diff HEAD --binary` (tracked
+ * changes, staged or not), then one `git diff --no-index` hunk per untracked,
+ * non-regenerable file. The patch is capped at ARCHIVE_PATCH_MAX_BYTES and
+ * ARCHIVE_MAX_UNTRACKED_FILES; files that would push it over are listed in
+ * the trailer instead. `git apply --3way <file>` restores it on a checkout
+ * of the same HEAD. Throws when the tracked diff alone is over the cap or the
+ * file cannot be written (the caller then keeps the worktree).
+ *
+ * @param git - git runner
+ * @param facts - Header facts
+ * @param file - Destination (its directory is created)
+ * @param now - Current epoch ms
+ * @returns What was written
+ * @throws When git cannot read the worktree, the tracked diff exceeds the cap, or the write fails
+ */
+export async function writeArchivePatch(git, facts, file, now) {
+    const cap = WORKTREE_JANITOR_CONSTANTS.ARCHIVE_PATCH_MAX_BYTES;
+    const wt = facts.worktreePath;
+    const tracked = await git(['-C', wt, 'diff', '--binary', 'HEAD']);
+    if (tracked.code !== 0)
+        throw new Error(`git diff failed: ${tracked.stderr.trim().slice(0, 200)}`);
+    if (Buffer.byteLength(tracked.stdout) > cap)
+        throw new Error(`tracked changes exceed the ${formatBytes(cap)} archive cap`);
+    const others = await git(['-C', wt, 'ls-files', '--others', '--exclude-standard', '-z']);
+    if (others.code !== 0)
+        throw new Error(`git ls-files failed: ${others.stderr.trim().slice(0, 200)}`);
+    const untracked = others.stdout.split('\0').filter((p) => p !== '' && !isRegenerablePath(p));
+    const header = [
+        '# Crewly worktree archive (crewly#1354)',
+        `# repo: ${facts.repoMain}`,
+        `# worktree: ${wt}`,
+        `# branch: ${facts.branch ?? 'detached HEAD'}`,
+        `# head: ${facts.head ?? 'unknown'}`,
+        `# default: ${facts.defaultRef ?? 'none'}${facts.commitsNotOnDefault !== null ? ` (${facts.commitsNotOnDefault} commit(s) of this worktree are not on it; ${facts.branch ? 'the branch was kept' : facts.keepRef ? `kept under ${facts.keepRef}` : 'none to keep'})` : ''}`,
+        `# archived: ${new Date(now).toISOString()}`,
+        `# apply: git worktree add <dir> ${facts.head ?? '<head>'} && git -C <dir> apply --3way ${path.basename(file)}`,
+        '',
+    ].join('\n');
+    const parts = [header];
+    let bytes = Buffer.byteLength(header) + Buffer.byteLength(tracked.stdout);
+    if (tracked.stdout.trim() !== '')
+        parts.push(tracked.stdout.endsWith('\n') ? tracked.stdout : `${tracked.stdout}\n`);
+    const skipped = [];
+    let written = 0;
+    for (const rel of untracked) {
+        const full = path.join(wt, rel);
+        let size = 0;
+        try {
+            const st = await fs.promises.lstat(full);
+            if (!st.isFile())
+                continue;
+            size = st.size;
+        }
+        catch {
+            continue;
+        }
+        if (written >= WORKTREE_JANITOR_CONSTANTS.ARCHIVE_MAX_UNTRACKED_FILES || bytes + size > cap) {
+            skipped.push({ path: rel, bytes: size });
+            continue;
+        }
+        const d = await git(['-C', wt, 'diff', '--no-index', '--binary', '--', '/dev/null', rel]);
+        // `--no-index` exits 1 when the files differ, which they always do here.
+        if (d.code !== 0 && d.code !== 1) {
+            skipped.push({ path: rel, bytes: size });
+            continue;
+        }
+        const hunk = d.stdout.endsWith('\n') ? d.stdout : `${d.stdout}\n`;
+        const hunkBytes = Buffer.byteLength(hunk);
+        if (bytes + hunkBytes > cap) {
+            skipped.push({ path: rel, bytes: size });
+            continue;
+        }
+        parts.push(hunk);
+        bytes += hunkBytes;
+        written += 1;
+    }
+    if (skipped.length > 0) {
+        const trailer = ['', '# not included (over the archive cap):', ...skipped.map((s) => `#   ${s.path} (${formatBytes(s.bytes)})`), ''].join('\n');
+        parts.push(trailer);
+        bytes += Buffer.byteLength(trailer);
+    }
+    await fs.promises.mkdir(path.dirname(file), { recursive: true });
+    await fs.promises.writeFile(file, parts.join(''), { flag: 'wx' });
+    return { file, bytes, trackedChanges: tracked.stdout.trim() !== '', untrackedFiles: written, skippedUntracked: skipped };
+}
+/**
+ * Name of the ref that keeps an archived detached worktree's commits alive.
+ *
+ * @param worktreePath - The worktree
+ * @param now - Current epoch ms
+ * @returns `refs/crewly-archive/<name>-<date>`
+ */
+export function archiveKeepRef(worktreePath, now) {
+    const name = path.basename(worktreePath).replace(/[^A-Za-z0-9._-]+/g, '-');
+    return `${WORKTREE_JANITOR_CONSTANTS.ARCHIVE_REF_PREFIX}${name}-${dateStamp(now)}`;
+}
+/**
+ * The message to a lead when a worktree's regenerable dirs were stripped.
+ *
+ * @param f - Path, reason the worktree is kept, idle days, dirs, bytes
+ * @returns Message text
+ */
+export function buildStripNotice(f) {
+    const days = Math.floor(f.idleMs / (24 * 60 * 60 * 1000));
+    const why = f.reason === 'dirty' ? 'has uncommitted changes' : 'has work that is not merged';
+    return (`Worktree ${f.path} ${why} and nobody touched it for ${days} day${days === 1 ? '' : 's'}, so I removed its re-installable output ` +
+        `(${f.dirs.map((d) => path.relative(f.path, d) || path.basename(d)).join(', ')}; ${formatBytes(f.freedBytes)}). The source is untouched; run \`npm install\` before using it again. ` +
+        `If the work is finished, merge it and remove the worktree; after ${Math.round(WORKTREE_JANITOR_CONSTANTS.ARCHIVE_MIN_IDLE_MS / (24 * 60 * 60 * 1000))} days untouched it is saved as a patch and removed.`);
+}
+/**
+ * The message to a lead when a worktree was archived and removed.
+ *
+ * @param f - Path, branch, patch file, what the patch holds, idle days
+ * @returns Message text
+ */
+export function buildArchiveNotice(f) {
+    const days = Math.floor(f.idleMs / (24 * 60 * 60 * 1000));
+    const held = [];
+    if (f.patch.trackedChanges)
+        held.push('uncommitted changes to tracked files');
+    if (f.patch.untrackedFiles > 0)
+        held.push(`${f.patch.untrackedFiles} untracked file${f.patch.untrackedFiles === 1 ? '' : 's'}`);
+    const skipped = f.patch.skippedUntracked.length > 0 ? ` ${f.patch.skippedUntracked.length} file(s) were too large for the patch and are listed in its header.` : '';
+    const commits = f.commitsNotOnDefault && f.commitsNotOnDefault > 0
+        ? f.branch
+            ? ` Its ${f.commitsNotOnDefault} unmerged commit(s) are still on branch ${f.branch}.`
+            : f.keepRef
+                ? ` Its ${f.commitsNotOnDefault} unmerged commit(s) are kept under ${f.keepRef}.`
+                : ''
+        : '';
+    return (`Worktree ${f.path} was untouched for ${days} days, so I archived and removed it. ` +
+        `Its ${held.length > 0 ? held.join(' and ') : 'working tree (nothing uncommitted)'} ${held.length > 0 ? 'are' : 'is'} saved in ${f.patch.file} (${formatBytes(f.patch.bytes)}).${commits}${skipped} ` +
+        'To continue: check out the branch in a new worktree and `git apply --3way` the patch.');
+}
+//# sourceMappingURL=worktree-tiers.js.map

package/dist/backend/backend/src/services/worktree/worktree-tiers.js.map

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

package/dist/backend/build-info.json

@@ -1,4 +1,4 @@
 {
-  "commit": "39e1e6bf2e8373ffcef8f254d28c671955678d2c",
-  "builtAt": "2026-10-17T04:14:33.156Z"
+  "commit": "70b3fb38a86bb77c99a6bde03c4055b1729197e6",
+  "builtAt": "2026-10-17T13:47:52.647Z"
 }

package/dist/cli/backend/src/constants.d.ts

@@ -2198,6 +2198,60 @@ export declare const WORK_RECORD_CONSTANTS: {
     /** WorkItem types that are bookkeeping, never recorded. */
     readonly SKIPPED_TYPES: readonly string[];
 };
+/**
+ * Memory-aware boot (crewly#1353). On 2026-10-17 a 16 GB Mac kernel-panicked
+ * a minute after a Crewly restart: 10 agents restored back-to-back, then the
+ * wiki, memory and work-record boot passes on fixed delays, while the machine
+ * was already swapping. Pressure mode only engages after two 30 s samples,
+ * so the boot restore reads the raw snapshot itself and the boot maintenance
+ * passes wait for a quiet machine. Env overrides exist for the two memory
+ * thresholds and the launch spacing.
+ */
+export declare const BOOT_PRESSURE_CONSTANTS: {
+    /** Swap in use at or above this share counts as tight for the boot (`CREWLY_BOOT_PRESSURE_SWAP_PERCENT`). */
+    readonly SWAP_USED_PERCENT: 80;
+    /** Free memory below this counts as tight for the boot (`CREWLY_BOOT_PRESSURE_MIN_FREE_MB`). */
+    readonly MIN_FREE_MB: number;
+    /** Minimum gap between two boot launches, pressure or not, so RSS growth is visible before the next (`CREWLY_RESTORE_LAUNCH_SPACING_MS`). */
+    readonly MIN_LAUNCH_SPACING_MS: number;
+    /** Under pressure: how long after an agent registered its process counts as settled before the next launch. */
+    readonly SETTLE_AFTER_READY_MS: number;
+    /** Under pressure: how often the snapshot is re-read while a launch waits for the machine to calm down. */
+    readonly PRESSURE_POLL_MS: number;
+    /** A held launch is logged on the first poll and then every this many polls (once a minute at the default poll). */
+    readonly PRESSURE_HOLD_LOG_EVERY_POLLS: 6;
+    /** Under pressure: an owner-waiting agent waits at most this long for the machine to calm, then launches anyway. */
+    readonly PRESSURE_HOLD_MAX_MS: number;
+    /** Under pressure: at most this many boot launches in flight at once. */
+    readonly PRESSURE_MAX_CONCURRENCY: 2;
+    /** Boot maintenance passes re-check the restore queue and the snapshot this often. */
+    readonly MAINTENANCE_POLL_MS: number;
+    /** Boot maintenance passes give up waiting after this long and run reduced. */
+    readonly MAINTENANCE_WAIT_MAX_MS: number;
+    /** Work records written by the boot pass when it runs reduced (instead of CATCHUP_MAX_PER_PASS). */
+    readonly WORK_RECORD_REDUCED_BATCH: 50;
+    /** A vault log larger than this is rotated by streaming (tail read, header count) instead of being read whole. */
+    readonly ROTATION_STREAM_BYTES: number;
+    /** Bytes read from the end of a streamed log to pick the entries carried forward. */
+    readonly ROTATION_TAIL_BYTES: number;
+    /** Chunk size of the streaming entry count. */
+    readonly ROTATION_CHUNK_BYTES: number;
+    /** The owner gets one line when boot restores have been held back for longer than this. */
+    readonly OWNER_NOTE_AFTER_MS: number;
+    /**
+     * Boot launches outside the restore queue (the deferred-start retry) are
+     * held for memory at most this long after boot; afterwards the pressure
+     * mode cap alone decides, because macOS swap stays full for hours after
+     * the pressure is gone and a held agent is still owed something.
+     */
+    readonly RETRY_HOLD_MAX_MS: number;
+    /** Env override of SWAP_USED_PERCENT. */
+    readonly ENV_SWAP_PERCENT: "CREWLY_BOOT_PRESSURE_SWAP_PERCENT";
+    /** Env override of MIN_FREE_MB. */
+    readonly ENV_MIN_FREE_MB: "CREWLY_BOOT_PRESSURE_MIN_FREE_MB";
+    /** Env override of MIN_LAUNCH_SPACING_MS. */
+    readonly ENV_LAUNCH_SPACING_MS: "CREWLY_RESTORE_LAUNCH_SPACING_MS";
+};
 /**
  * Startup briefing content (#1345): wiki pages, recent lessons and open
  * owner threads an agent gets at registration, on top of its session memory.
@@ -2301,6 +2355,16 @@ export declare const WORKTREE_CONSTANTS: {
     readonly INCLUDE_MAX_ENTRIES: 50;
     /** Heavy directories symlinked (not copied) from the repo root when present and untracked. */
     readonly DEFAULT_SHARED_DIRS: readonly string[];
+    /**
+     * Workspace packages' install dirs (`backend/node_modules`,
+     * `packages/ui/node_modules`) are symlinked too when the lock file is
+     * identical in repo and worktree (crewly#1354): searched this deep.
+     */
+    readonly NESTED_INSTALL_DEPTH: 2;
+    /** Lock files compared (first one present in the repo decides). */
+    readonly LOCK_FILES: readonly string[];
+    /** Directories never descended into while looking for nested install dirs. */
+    readonly NESTED_INSTALL_SKIP_DIRS: readonly string[];
     /** Marker line for the entries this feature adds to `.git/info/exclude`. */
     readonly EXCLUDE_MARKER: "# crewly worktree shared paths (#814) — never commit these";
     /** Timeout for local git commands (checkout of a large repo can take minutes under load). */
@@ -3135,7 +3199,7 @@ export declare const WORKTREE_JANITOR_CONSTANTS: {
     /** Timeout of the `lsof` that finds a file's writers (ms). */
     readonly RUNAWAY_LSOF_TIMEOUT_MS: 10000;
     /** One line added to every agent's start prompt. */
-    readonly PROMPT_HINT: "Disk hygiene: never let a command or script write an unbounded file. When you redirect or concatenate output (`> file`, `>> file`, `cat a b > all.md`), cap it (`| head -c 50M`, `| head -n 100000`) and never build a file from its own output. A file in your scratch dir or worktree that grows past a few GB is stopped by Crewly and the owner is alerted. Worktree hygiene: deploy only from a commit that is on main (merge first, never from a side branch); remove your worktree once its ticket is done.";
+    readonly PROMPT_HINT: "Disk hygiene: never let a command or script write an unbounded file. When you redirect or concatenate output (`> file`, `>> file`, `cat a b > all.md`), cap it (`| head -c 50M`, `| head -n 100000`) and never build a file from its own output. A file in your scratch dir or worktree that grows past a few GB is stopped by Crewly and the owner is alerted. Worktree hygiene: deploy only from a commit that is on main (merge first, never from a side branch); remove your worktree once its ticket is done. In a new worktree, do not run `npm install` when package-lock.json is unchanged: symlink `node_modules` (root and per-package) from the main checkout instead (`ln -s <main>/node_modules node_modules`). Crewly strips node_modules from worktrees untouched for 3 days and archives untouched ones as a patch after 14 days.";
     /** State file under CREWLY_HOME remembering when the owner was last told about low disk. */
     readonly STATE_FILENAME: "disk-janitor-state.json";
     /** File (in CREWLY_HOME) remembering which unmerged worktrees their lead was already told about. */
@@ -3174,7 +3238,11 @@ export declare const WORKTREE_JANITOR_CONSTANTS: {
     readonly REGENERABLE_DIRS: readonly string[];
     /** File suffixes treated as regenerable output (logs). */
     readonly REGENERABLE_FILE_SUFFIXES: readonly string[];
-    /** Directories deleted from kept (dirty / not-merged) worktrees under low disk — reinstalled by `npm install` / rebuilt by `next build`. */
+    /**
+     * Directories deleted from kept (dirty / not-merged) worktrees by the strip
+     * tier — reinstalled by `npm install` / rebuilt by the build. A directory
+     * git tracks anything under is never deleted (a repo that commits `dist`).
+     */
     readonly RECLAIM_DIRS: readonly string[];
     /** A kept worktree must be idle this long before its regenerable dirs are reclaimed under low disk (24 hours). */
     readonly RECLAIM_MIN_IDLE_MS: number;
@@ -3200,6 +3268,66 @@ export declare const WORKTREE_JANITOR_CONSTANTS: {
     readonly GH_PR_LIMIT: 20;
     /** Max bytes of command output kept (stdout/stderr each). */
     readonly MAX_OUTPUT_BYTES: number;
+    /** A kept worktree untouched (no file, index or commit newer) for this long loses its regenerable dirs (3 days). */
+    readonly STRIP_MIN_IDLE_MS: number;
+    /** Under low disk, or once its WorkItem finished, the strip tier needs only this much idle (1 day). */
+    readonly STRIP_MIN_IDLE_LOW_DISK_MS: number;
+    /** A kept worktree untouched for this long is archived as a patch and removed (14 days). */
+    readonly ARCHIVE_MIN_IDLE_MS: number;
+    /** Directory under CREWLY_HOME holding archived worktree patches (`<repo>/<name>-<date>.patch`). */
+    readonly ARCHIVE_DIR: "worktree-archive";
+    /** Cap on one archive patch; untracked files that would push it past the cap are listed in the header instead (64 MB). */
+    readonly ARCHIVE_PATCH_MAX_BYTES: number;
+    /** Cap on untracked files written into one archive patch. */
+    readonly ARCHIVE_MAX_UNTRACKED_FILES: 2000;
+    /** Ref namespace that keeps the commits of an archived detached worktree alive (`refs/crewly-archive/<name>-<date>`). */
+    readonly ARCHIVE_REF_PREFIX: "refs/crewly-archive/";
+    /** How many levels below a worktree root count for its "last touched" time in the tier decision. */
+    readonly TIER_MTIME_DEPTH: 2;
+    /** State file under CREWLY_HOME: per-worktree strip / archive / finished-work timestamps. */
+    readonly TIER_STATE_FILENAME: "worktree-tiers.json";
+    /** Finished-work records (task-end hook) older than this are dropped from the state file (30 days). */
+    readonly TIER_STATE_MAX_AGE_MS: number;
+    /**
+     * Every delete added in crewly#1354 (strip, archive, transcripts, tmp, logs)
+     * is dry-run only until this long after the first real pass that saw it
+     * (one day): the first pass logs what it would do, the next day it does it.
+     */
+    readonly RETENTION_ARM_DELAY_MS: number;
+    /** An agent transcript (and its sibling tool-results dir) untouched for this long is pruned (14 days). */
+    readonly TRANSCRIPT_MAX_AGE_MS: number;
+    /** The transcript sweep runs at most this often (24 hours). */
+    readonly TRANSCRIPT_SWEEP_INTERVAL_MS: number;
+    /** Bytes read from the head of a transcript to find Claude Code's `agentSetting` entry. */
+    readonly TRANSCRIPT_HEAD_BYTES: number;
+    /** Handover files newer than this are scanned for conversation ids (30 days). */
+    readonly TRANSCRIPT_HANDOVER_SCAN_MAX_AGE_MS: number;
+    /** Kinds that handover file names carry between the session name and the timestamp (`<session>-<kind>-<ISO>.md`). */
+    readonly HANDOVER_KINDS: readonly string[];
+    /** Sub-directory of a Claude home that holds per-cwd transcript folders. */
+    readonly TRANSCRIPT_PROJECTS_DIR: "projects";
+    /** Transcript file extension. */
+    readonly TRANSCRIPT_EXT: ".jsonl";
+    /** Directory under CREWLY_HOME that agents and skills use as scratch space. */
+    readonly TMP_DIR: "tmp";
+    /** A top-level entry of CREWLY_HOME/tmp untouched for this long is removed (7 days). */
+    readonly TMP_MAX_AGE_MS: number;
+    /** Sub-directories of CREWLY_HOME/tmp swept per child with their own age (ms); the directory itself stays. */
+    readonly TMP_CHILD_POLICIES: Readonly<Record<string, number>>;
+    /** How many levels below a tmp entry count for its "last touched" time. */
+    readonly TMP_MTIME_DEPTH: 2;
+    /** The tmp / logs sweep runs at most this often (6 hours). */
+    readonly TMP_SWEEP_INTERVAL_MS: number;
+    /** Cap on CREWLY_HOME/logs/archive; the oldest archives go first (300 MB). */
+    readonly LOG_ARCHIVE_CAP_BYTES: number;
+    /** Cap on CREWLY_HOME/logs/sessions; the oldest logs of sessions that are not live go first (100 MB). */
+    readonly LOG_SESSIONS_CAP_BYTES: number;
+    /** A log written within this long is never deleted by the cap (1 hour). */
+    readonly LOG_CAP_MIN_AGE_MS: number;
+    /** Low disk is free < max(LOW_DISK_BYTES, this fraction of the disk) (8 %). */
+    readonly LOW_DISK_FRACTION: 0.08;
+    /** Critical is free < max(CRITICAL_DISK_BYTES, this fraction of the disk) (3 %). */
+    readonly CRITICAL_DISK_FRACTION: 0.03;
 };
 /**
  * Constants for cron next-run computation (`getNextRunTime`).