crewly 1.20.358 → 1.20.360

package/dist/backend/backend/src/services/worktree/low-disk-guard.d.ts

@@ -2,10 +2,13 @@
  * Low-disk guard — pure helpers for the disk janitor's free-space check.
  *
  * The janitor checks free space on the volume holding CREWLY_HOME every
- * 10 minutes. Below 15 GB it cleans up at once with shorter idle thresholds;
- * if space is still short it tells the owner (at most once per 24 h, or once
- * per 6 h and marked urgent below 5 GB) what it could not remove and why.
- * This file holds the decisions and the wording; the service does the I/O.
+ * 10 minutes. Below the low mark — max(15 GB, 8 % of the disk), because a
+ * ~1 TB Mac already misbehaves at 5–8 % free — it cleans up at once with
+ * shorter idle thresholds; if space is still short it tells the owner (at most
+ * once per 24 h, or once per 6 h and marked urgent below max(5 GB, 3 %)) what
+ * it freed, what it could not remove and why, and that it never touches the
+ * owner's own files. This file holds the decisions and the wording; the
+ * service does the I/O.
  *
  * @module services/worktree/low-disk-guard
  */
@@ -15,17 +18,35 @@ export interface StatFsLike {
     bavail: number | bigint;
     /** Block size in bytes */
     bsize: number | bigint;
+    /** Total blocks on the volume (optional: an older probe may not report it) */
+    blocks?: number | bigint;
+}
+/** Free and total bytes of a volume. */
+export interface DiskSpace {
+    /** Free bytes for unprivileged users */
+    freeBytes: number;
+    /** Total bytes, or null when the probe did not report the size */
+    totalBytes: number | null;
 }
 /** `fs.promises.statfs`-compatible probe. */
 export type StatFsFn = (p: string) => Promise<StatFsLike>;
 /** Disk level relative to the thresholds. */
 export type DiskLevel = 'ok' | 'low' | 'critical';
-/** When the owner was last told about low disk (persisted). */
+/** Janitor state persisted under CREWLY_HOME (notice cadence, sweep cadence, arming). */
 export interface LowDiskNoticeState {
     /** Last notice of any kind (ms epoch) */
     lastNoticeAt?: number;
     /** Last urgent notice (ms epoch) */
     lastUrgentAt?: number;
+    /**
+     * First real pass that ran with the crewly#1354 retention code (ms epoch).
+     * Its deletes stay dry-run until RETENTION_ARM_DELAY_MS after this.
+     */
+    retentionArmedAt?: number;
+    /** Last transcript sweep (ms epoch) */
+    lastTranscriptSweepAt?: number;
+    /** Last tmp / logs sweep (ms epoch) */
+    lastTmpSweepAt?: number;
 }
 /** Something the janitor looked at and left on disk. */
 export interface KeptItem {
@@ -45,12 +66,51 @@ export interface KeptItem {
  */
 export declare function readFreeBytes(p: string, statfs?: StatFsFn): Promise<number | null>;
 /**
- * Classify free space.
+ * Free and total bytes of the volume holding `p`.
+ *
+ * @param p - Any path on the volume
+ * @param statfs - Probe (default `fs.promises.statfs`)
+ * @returns Free and total bytes, or null when the probe failed
+ */
+export declare function readDiskSpace(p: string, statfs?: StatFsFn): Promise<DiskSpace | null>;
+/**
+ * The low-disk mark for a volume: the absolute floor or a fraction of the
+ * disk, whichever is larger. A 926 GB disk gets ~74 GB, a 100 GB disk 15 GB.
+ *
+ * @param totalBytes - Disk size, or null when unknown (the floor is used)
+ * @returns Bytes below which free space counts as low
+ */
+export declare function lowDiskThresholdBytes(totalBytes: number | null): number;
+/**
+ * The critical mark for a volume: max(5 GB, 3 % of the disk).
+ *
+ * @param totalBytes - Disk size, or null when unknown (the floor is used)
+ * @returns Bytes below which free space counts as critical
+ */
+export declare function criticalDiskThresholdBytes(totalBytes: number | null): number;
+/**
+ * Classify free space against the volume's marks.
  *
  * @param freeBytes - Free bytes
- * @returns `critical` below CRITICAL_DISK_BYTES, `low` below LOW_DISK_BYTES, else `ok`
+ * @param totalBytes - Disk size (null / omitted: the absolute floors apply)
+ * @returns `critical` below the critical mark, `low` below the low mark, else `ok`
+ *
+ * @example
+ * ```typescript
+ * diskLevel(50 * GB, 926 * GB); // 'low' (mark is 8 % = 74 GB)
+ * diskLevel(50 * GB);           // 'ok'  (no size: 15 GB floor)
+ * ```
+ */
+export declare function diskLevel(freeBytes: number, totalBytes?: number | null): DiskLevel;
+/**
+ * Whether the crewly#1354 retention deletes are armed: the first real pass
+ * records the time and only logs; deletes start RETENTION_ARM_DELAY_MS later.
+ *
+ * @param state - Janitor state
+ * @param now - Current time (ms)
+ * @returns True when deletes may run
  */
-export declare function diskLevel(freeBytes: number): DiskLevel;
+export declare function retentionArmed(state: LowDiskNoticeState, now: number): boolean;
 /**
  * Idle threshold to use, shortened in low-disk mode.
  *
@@ -83,6 +143,26 @@ export declare function noticeToSend(level: DiskLevel, state: LowDiskNoticeState
  * @returns New state
  */
 export declare function recordNotice(state: LowDiskNoticeState, kind: 'urgent' | 'normal', now: number): LowDiskNoticeState;
+/** What one pass freed, by kind (bytes), for the owner line. */
+export interface FreedBreakdown {
+    /** Finished worktrees and scratch dirs removed */
+    worktrees: number;
+    /** node_modules / build output stripped from kept worktrees */
+    stripped: number;
+    /** Worktrees archived as a patch and removed */
+    archived: number;
+    /** Agent transcripts pruned */
+    transcripts: number;
+    /** CREWLY_HOME/tmp and logs */
+    tmp: number;
+}
+/**
+ * One short line of what a pass freed, by kind; empty when nothing was.
+ *
+ * @param freed - Bytes freed per kind
+ * @returns `"freed 3.2 GB (worktrees 2.1 GB, node_modules 1.1 GB)"` or ''
+ */
+export declare function describeFreed(freed: FreedBreakdown): string;
 /**
  * Plain-English reason for a kept item.
  *
@@ -102,6 +182,10 @@ export declare function buildLowDiskNotice(input: {
     urgent: boolean;
     freedBytes: number;
     items: KeptItem[];
+    /** Optional breakdown of what was freed (replaces the plain "cleaned up X" line) */
+    freed?: FreedBreakdown;
+    /** Optional: total disk size, so the owner sees the mark that was crossed */
+    totalBytes?: number | null;
 }): {
     title: string;
     message: string;

package/dist/backend/backend/src/services/worktree/low-disk-guard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"low-disk-guard.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/worktree/low-disk-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,kEAAkE;AAClE,MAAM,WAAW,UAAU;IAC1B,kDAAkD;IAClD,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED,6CAA6C;AAC7C,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAE1D,6CAA6C;AAC7C,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,KAAK,GAAG,UAAU,CAAC;AAElD,+DAA+D;AAC/D,MAAM,WAAW,kBAAkB;IAClC,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wDAAwD;AACxD,MAAM,WAAW,QAAQ;IACxB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAE,QAAwB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOvG;AAMD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAItD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAIxE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,kBAAkB,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAQjH;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,QAAQ,GAAG,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAElH;AAqBD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,EAAE,CAAC;CAClB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAkBrC"}
+{"version":3,"file":"low-disk-guard.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/worktree/low-disk-guard.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/worktree/low-disk-guard.js

@@ -2,10 +2,13 @@
  * Low-disk guard — pure helpers for the disk janitor's free-space check.
  *
  * The janitor checks free space on the volume holding CREWLY_HOME every
- * 10 minutes. Below 15 GB it cleans up at once with shorter idle thresholds;
- * if space is still short it tells the owner (at most once per 24 h, or once
- * per 6 h and marked urgent below 5 GB) what it could not remove and why.
- * This file holds the decisions and the wording; the service does the I/O.
+ * 10 minutes. Below the low mark — max(15 GB, 8 % of the disk), because a
+ * ~1 TB Mac already misbehaves at 5–8 % free — it cleans up at once with
+ * shorter idle thresholds; if space is still short it tells the owner (at most
+ * once per 24 h, or once per 6 h and marked urgent below max(5 GB, 3 %)) what
+ * it freed, what it could not remove and why, and that it never touches the
+ * owner's own files. This file holds the decisions and the wording; the
+ * service does the I/O.
  *
  * @module services/worktree/low-disk-guard
  */
@@ -20,30 +23,81 @@ import { formatBytes } from './worktree-janitor.git.js';
  * @returns Free bytes for unprivileged users, or null when the probe failed
  */
 export async function readFreeBytes(p, statfs = defaultStatFs) {
+    return (await readDiskSpace(p, statfs))?.freeBytes ?? null;
+}
+/**
+ * Free and total bytes of the volume holding `p`.
+ *
+ * @param p - Any path on the volume
+ * @param statfs - Probe (default `fs.promises.statfs`)
+ * @returns Free and total bytes, or null when the probe failed
+ */
+export async function readDiskSpace(p, statfs = defaultStatFs) {
     try {
         const s = await statfs(p);
-        return Number(s.bavail) * Number(s.bsize);
+        const bsize = Number(s.bsize);
+        const total = s.blocks === undefined ? null : Number(s.blocks) * bsize;
+        return { freeBytes: Number(s.bavail) * bsize, totalBytes: total !== null && Number.isFinite(total) && total > 0 ? total : null };
     }
     catch {
         return null;
     }
 }
+/**
+ * The low-disk mark for a volume: the absolute floor or a fraction of the
+ * disk, whichever is larger. A 926 GB disk gets ~74 GB, a 100 GB disk 15 GB.
+ *
+ * @param totalBytes - Disk size, or null when unknown (the floor is used)
+ * @returns Bytes below which free space counts as low
+ */
+export function lowDiskThresholdBytes(totalBytes) {
+    const floor = WORKTREE_JANITOR_CONSTANTS.LOW_DISK_BYTES;
+    return totalBytes ? Math.max(floor, Math.round(totalBytes * WORKTREE_JANITOR_CONSTANTS.LOW_DISK_FRACTION)) : floor;
+}
+/**
+ * The critical mark for a volume: max(5 GB, 3 % of the disk).
+ *
+ * @param totalBytes - Disk size, or null when unknown (the floor is used)
+ * @returns Bytes below which free space counts as critical
+ */
+export function criticalDiskThresholdBytes(totalBytes) {
+    const floor = WORKTREE_JANITOR_CONSTANTS.CRITICAL_DISK_BYTES;
+    return totalBytes ? Math.max(floor, Math.round(totalBytes * WORKTREE_JANITOR_CONSTANTS.CRITICAL_DISK_FRACTION)) : floor;
+}
 async function defaultStatFs(p) {
     return fs.promises.statfs(p);
 }
 /**
- * Classify free space.
+ * Classify free space against the volume's marks.
  *
  * @param freeBytes - Free bytes
- * @returns `critical` below CRITICAL_DISK_BYTES, `low` below LOW_DISK_BYTES, else `ok`
+ * @param totalBytes - Disk size (null / omitted: the absolute floors apply)
+ * @returns `critical` below the critical mark, `low` below the low mark, else `ok`
+ *
+ * @example
+ * ```typescript
+ * diskLevel(50 * GB, 926 * GB); // 'low' (mark is 8 % = 74 GB)
+ * diskLevel(50 * GB);           // 'ok'  (no size: 15 GB floor)
+ * ```
  */
-export function diskLevel(freeBytes) {
-    if (freeBytes < WORKTREE_JANITOR_CONSTANTS.CRITICAL_DISK_BYTES)
+export function diskLevel(freeBytes, totalBytes = null) {
+    if (freeBytes < criticalDiskThresholdBytes(totalBytes))
         return 'critical';
-    if (freeBytes < WORKTREE_JANITOR_CONSTANTS.LOW_DISK_BYTES)
+    if (freeBytes < lowDiskThresholdBytes(totalBytes))
         return 'low';
     return 'ok';
 }
+/**
+ * Whether the crewly#1354 retention deletes are armed: the first real pass
+ * records the time and only logs; deletes start RETENTION_ARM_DELAY_MS later.
+ *
+ * @param state - Janitor state
+ * @param now - Current time (ms)
+ * @returns True when deletes may run
+ */
+export function retentionArmed(state, now) {
+    return state.retentionArmedAt !== undefined && now - state.retentionArmedAt >= WORKTREE_JANITOR_CONSTANTS.RETENTION_ARM_DELAY_MS;
+}
 /**
  * Idle threshold to use, shortened in low-disk mode.
  *
@@ -92,6 +146,27 @@ export function noticeToSend(level, state, now) {
 export function recordNotice(state, kind, now) {
     return { ...state, lastNoticeAt: now, ...(kind === 'urgent' ? { lastUrgentAt: now } : {}) };
 }
+/**
+ * One short line of what a pass freed, by kind; empty when nothing was.
+ *
+ * @param freed - Bytes freed per kind
+ * @returns `"freed 3.2 GB (worktrees 2.1 GB, node_modules 1.1 GB)"` or ''
+ */
+export function describeFreed(freed) {
+    const parts = [];
+    if (freed.worktrees > 0)
+        parts.push(`finished worktrees ${formatBytes(freed.worktrees)}`);
+    if (freed.stripped > 0)
+        parts.push(`node_modules of idle worktrees ${formatBytes(freed.stripped)}`);
+    if (freed.archived > 0)
+        parts.push(`archived worktrees ${formatBytes(freed.archived)}`);
+    if (freed.transcripts > 0)
+        parts.push(`old agent transcripts ${formatBytes(freed.transcripts)}`);
+    if (freed.tmp > 0)
+        parts.push(`temp files and logs ${formatBytes(freed.tmp)}`);
+    const total = freed.worktrees + freed.stripped + freed.archived + freed.transcripts + freed.tmp;
+    return total > 0 ? `freed ${formatBytes(total)} (${parts.join(', ')})` : '';
+}
 const REASON_TEXT = {
     dirty: 'has changes that were never committed',
     'not-merged': 'has work that is not merged yet',
@@ -109,6 +184,10 @@ const REASON_TEXT = {
     'status-failed': 'git could not read it',
     'git-failed': 'git could not read it',
     'remove-failed': 'deleting it failed',
+    'archive-failed': 'saving its changes as a patch failed, so it stays',
+    'contains-git': 'holds a git checkout, which only the worktree rules may remove',
+    'live-session': 'is the conversation of a running agent',
+    foreign: 'is not an agent conversation',
 };
 /**
  * Plain-English reason for a kept item.
@@ -129,10 +208,14 @@ export function describeReason(reason) {
 export function buildLowDiskNotice(input) {
     const title = input.urgent ? 'URGENT: disk almost full' : 'Disk space is running low';
     const lines = [];
-    lines.push(`Only ${formatBytes(input.freeBytes)} free on this machine.${input.urgent ? ' Crewly and the agents may stop working soon.' : ''}`);
-    lines.push(input.freedBytes > 0
-        ? `I cleaned up ${formatBytes(input.freedBytes)} of finished work, but it is not enough.`
-        : 'I found nothing more that is safe to delete on my own.');
+    const ofDisk = input.totalBytes ? ` of ${formatBytes(input.totalBytes)}` : '';
+    lines.push(`Only ${formatBytes(input.freeBytes)}${ofDisk} free on this machine.${input.urgent ? ' Crewly and the agents may stop working soon.' : ''}`);
+    const breakdown = input.freed ? describeFreed(input.freed) : '';
+    lines.push(breakdown
+        ? `Today I ${breakdown}, but it is not enough.`
+        : input.freedBytes > 0
+            ? `I cleaned up ${formatBytes(input.freedBytes)} of finished work, but it is not enough.`
+            : 'I found nothing more that is safe to delete on my own.');
     const top = [...input.items].sort((a, b) => b.bytes - a.bytes).slice(0, WORKTREE_JANITOR_CONSTANTS.LOW_DISK_REPORT_ITEMS);
     if (top.length > 0) {
         lines.push('', 'Biggest things I left alone:');
@@ -143,6 +226,7 @@ export function buildLowDiskNotice(input) {
     else {
         lines.push('Please free up some space.');
     }
+    lines.push('I only clean what agents left behind (worktrees, scratch dirs, agent transcripts, Crewly temp files and logs); your own files, downloads and app caches I never touch.');
     return { title, message: lines.join('\n') };
 }
 //# sourceMappingURL=low-disk-guard.js.map

package/dist/backend/backend/src/services/worktree/low-disk-guard.js.map

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

package/dist/backend/backend/src/services/worktree/tmp-janitor.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Tmp and log janitor — retention for `<CREWLY_HOME>/tmp` and size caps for
+ * `<CREWLY_HOME>/logs/archive` and `logs/sessions` (crewly#1354).
+ *
+ * `~/.crewly/tmp` is where agents, skills and Crewly itself put scratch
+ * output (Slack downloads, release build dirs, previews, skill output) and
+ * nothing ever removed it (600 MB on one Mac); the log archive had a 7-day
+ * rule but no cap (600 MB) and session logs none at all (200 MB).
+ *
+ * Tmp rules: a top-level entry untouched (shallow tree mtime) for 7 days is
+ * removed. Some sub-directories are swept per child with their own age
+ * instead (`slack-files` / `slack-images` / `slack-pdfs` 30 days,
+ * `crewly-web-release` 2 days, `skill-output` 7 days) and the directory itself
+ * stays. Never removed: symlinks, anything a process or agent session has as
+ * cwd, and any entry holding a git checkout — a linked worktree in tmp
+ * belongs to the worktree rules (the service adds tmp to their discovery
+ * roots), and a clone may be the only copy of its history.
+ *
+ * Log caps: the oldest files go first until the directory fits; a file
+ * written in the last hour, or the log of a live session, is never deleted.
+ *
+ * @module services/worktree/tmp-janitor
+ */
+/** A place a live process or agent is working in (same shape as the janitor's BusyCwd). */
+export interface TmpBusyCwd {
+    cwd: string;
+    source: 'agent-session' | 'process';
+}
+/** Why a tmp entry was removed or kept. */
+export type TmpReason = 'old' | 'recent' | 'contains-git' | 'process-inside' | 'agent-session-inside' | 'cwd-probe-failed' | 'symlink' | 'remove-failed';
+/** Verdict for one tmp entry. */
+export interface TmpEntryVerdict {
+    /** Absolute path */
+    path: string;
+    /** Bytes (0 when unknown) */
+    bytes: number;
+    /** What the sweep decided */
+    decision: 'remove' | 'keep';
+    /** The deciding rule */
+    reason: TmpReason;
+    /** Ms since last touched, when known */
+    idleMs?: number;
+    /** True when deleted */
+    removed: boolean;
+    /** Error text when deletion failed */
+    error?: string;
+}
+/** Result of one tmp sweep. */
+export interface TmpSweepSummary {
+    /** The tmp root */
+    root: string;
+    /** Entries deleted */
+    removed: number;
+    /** Dry run: entries that would be deleted */
+    wouldRemove: number;
+    /** Bytes freed */
+    freedBytes: number;
+    /** Dry run: bytes that would be freed */
+    wouldFreeBytes: number;
+    /** Entries kept (`recent` ones are counted, not listed) */
+    kept: number;
+    /** Kept entries by reason */
+    keptReasons: Record<string, number>;
+    /** Verdicts (all but `recent`) */
+    entries: TmpEntryVerdict[];
+}
+/** Input of {@link sweepTmp}. */
+export interface TmpSweepInput {
+    /** `<CREWLY_HOME>/tmp` */
+    root: string;
+    /** Busy cwds, or null when the probe failed (everything is then kept) */
+    busy: TmpBusyCwd[] | null;
+    /** Current time (ms) */
+    now: number;
+    /** When true, nothing is deleted */
+    dryRun: boolean;
+    /** Age for top-level entries (default TMP_MAX_AGE_MS) */
+    maxAgeMs?: number;
+    /** Per-child policies by sub-directory name (default TMP_CHILD_POLICIES) */
+    childPolicies?: Readonly<Record<string, number>>;
+    /** Size probe (default: shallow stat walk) */
+    sizeOf?: (p: string) => Promise<number | null>;
+}
+/** Bytes of a path by a bounded stat walk (no symlinks followed). */
+export declare function shallowBytes(p: string, depth?: number): Promise<number>;
+/**
+ * One sweep of the tmp root. Never throws; an unreadable root yields an
+ * empty summary.
+ *
+ * @param input - Root, busy cwds, clock, dry-run flag
+ * @returns What was removed and kept
+ */
+export declare function sweepTmp(input: TmpSweepInput): Promise<TmpSweepSummary>;
+/** Input of {@link capDirectoryBytes}. */
+export interface DirCapInput {
+    /** Directory of files to cap (not recursive) */
+    dir: string;
+    /** Allowed total bytes */
+    capBytes: number;
+    /** Current time (ms) */
+    now: number;
+    /** When true, nothing is deleted */
+    dryRun: boolean;
+    /** Files to consider (default: every regular file) */
+    filter?: (name: string) => boolean;
+    /** Files never deleted (a live session's log) */
+    protect?: (name: string) => boolean;
+    /** A file written within this long is never deleted (default LOG_CAP_MIN_AGE_MS) */
+    minAgeMs?: number;
+}
+/** Result of {@link capDirectoryBytes}. */
+export interface DirCapSummary {
+    /** The directory */
+    dir: string;
+    /** Total bytes before */
+    totalBytes: number;
+    /** The cap */
+    capBytes: number;
+    /** Files deleted (oldest first) */
+    deleted: string[];
+    /** Bytes freed */
+    freedBytes: number;
+    /** Dry run: files that would be deleted */
+    wouldDelete: string[];
+    /** Dry run: bytes that would be freed */
+    wouldFreeBytes: number;
+    /** Bytes that stay over the cap because every remaining file is protected or too new */
+    overCapBytes: number;
+}
+/**
+ * Delete the oldest files of a directory until it fits the cap. Never
+ * throws; an unreadable directory yields an empty summary.
+ *
+ * @param input - Directory, cap, filters, clock, dry-run flag
+ * @returns What was deleted and what still exceeds the cap
+ */
+export declare function capDirectoryBytes(input: DirCapInput): Promise<DirCapSummary>;
+//# sourceMappingURL=tmp-janitor.d.ts.map

package/dist/backend/backend/src/services/worktree/tmp-janitor.d.ts.map

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