crewly 1.20.358 → 1.20.360

package/dist/backend/backend/src/services/worktree/tmp-janitor.js

@@ -0,0 +1,199 @@
+/**
+ * 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
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { WORKTREE_JANITOR_CONSTANTS } from '../../constants.js';
+import { EventLoopYielder, findGitCheckouts, isPathInside, latestTreeMtimeMs } from './worktree-janitor.git.js';
+/** Bytes of a path by a bounded stat walk (no symlinks followed). */
+export async function shallowBytes(p, depth = 6) {
+    let total = 0;
+    const yielder = new EventLoopYielder();
+    const walk = async (q, level) => {
+        await yielder.tick();
+        let st;
+        try {
+            st = await fs.promises.lstat(q);
+        }
+        catch {
+            return;
+        }
+        total += st.size;
+        if (!st.isDirectory() || level >= depth)
+            return;
+        let names;
+        try {
+            names = await fs.promises.readdir(q);
+        }
+        catch {
+            return;
+        }
+        for (const n of names)
+            await walk(path.join(q, n), level + 1);
+    };
+    await walk(p, 0);
+    return total;
+}
+/**
+ * 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 async function sweepTmp(input) {
+    const summary = { root: input.root, removed: 0, wouldRemove: 0, freedBytes: 0, wouldFreeBytes: 0, kept: 0, keptReasons: {}, entries: [] };
+    const policies = input.childPolicies ?? WORKTREE_JANITOR_CONSTANTS.TMP_CHILD_POLICIES;
+    const defaultAge = input.maxAgeMs ?? WORKTREE_JANITOR_CONSTANTS.TMP_MAX_AGE_MS;
+    let top;
+    try {
+        top = await fs.promises.readdir(input.root, { withFileTypes: true });
+    }
+    catch {
+        return summary;
+    }
+    const keep = (v) => {
+        summary.kept += 1;
+        summary.keptReasons[v.reason] = (summary.keptReasons[v.reason] ?? 0) + 1;
+        if (v.reason !== 'recent')
+            summary.entries.push(v);
+    };
+    const sizeOf = async (p) => (input.sizeOf ? await input.sizeOf(p) : null) ?? (await shallowBytes(p));
+    const consider = async (entry, full, maxAge) => {
+        const base = { path: full, bytes: 0, removed: false };
+        if (entry.isSymbolicLink())
+            return keep({ ...base, decision: 'keep', reason: 'symlink' });
+        if (input.busy === null)
+            return keep({ ...base, decision: 'keep', reason: 'cwd-probe-failed' });
+        const hit = input.busy.find((b) => isPathInside(b.cwd, full));
+        if (hit)
+            return keep({ ...base, decision: 'keep', reason: hit.source === 'agent-session' ? 'agent-session-inside' : 'process-inside' });
+        const mtime = await latestTreeMtimeMs(full, WORKTREE_JANITOR_CONSTANTS.TMP_MTIME_DEPTH);
+        const idleMs = mtime === null ? undefined : Math.max(0, input.now - mtime);
+        if (idleMs === undefined || idleMs < maxAge)
+            return keep({ ...base, decision: 'keep', reason: 'recent', idleMs });
+        if (entry.isDirectory()) {
+            const repos = await findGitCheckouts(full, WORKTREE_JANITOR_CONSTANTS.TMP_MTIME_DEPTH, 5000);
+            if (repos.length > 0)
+                return keep({ ...base, decision: 'keep', reason: 'contains-git', idleMs });
+        }
+        const bytes = await sizeOf(full);
+        const verdict = { ...base, bytes, decision: 'remove', reason: 'old', idleMs };
+        if (input.dryRun) {
+            summary.wouldRemove += 1;
+            summary.wouldFreeBytes += bytes;
+            summary.entries.push(verdict);
+            return;
+        }
+        try {
+            await fs.promises.rm(full, { recursive: true, force: true });
+            verdict.removed = true;
+            summary.removed += 1;
+            summary.freedBytes += bytes;
+            summary.entries.push(verdict);
+        }
+        catch (err) {
+            keep({ ...verdict, decision: 'keep', reason: 'remove-failed', error: err instanceof Error ? err.message : String(err) });
+        }
+    };
+    const yielder = new EventLoopYielder();
+    for (const entry of top) {
+        await yielder.tick();
+        const full = path.join(input.root, entry.name);
+        const childAge = policies[entry.name];
+        if (childAge !== undefined && entry.isDirectory()) {
+            let children;
+            try {
+                children = await fs.promises.readdir(full, { withFileTypes: true });
+            }
+            catch {
+                continue;
+            }
+            for (const child of children)
+                await consider(child, path.join(full, child.name), childAge);
+            continue;
+        }
+        await consider(entry, full, defaultAge);
+    }
+    return summary;
+}
+/**
+ * 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 async function capDirectoryBytes(input) {
+    const summary = { dir: input.dir, totalBytes: 0, capBytes: input.capBytes, deleted: [], freedBytes: 0, wouldDelete: [], wouldFreeBytes: 0, overCapBytes: 0 };
+    let names;
+    try {
+        names = await fs.promises.readdir(input.dir);
+    }
+    catch {
+        return summary;
+    }
+    const minAge = input.minAgeMs ?? WORKTREE_JANITOR_CONSTANTS.LOG_CAP_MIN_AGE_MS;
+    const files = [];
+    for (const name of names) {
+        if (input.filter && !input.filter(name))
+            continue;
+        try {
+            const st = await fs.promises.lstat(path.join(input.dir, name));
+            if (!st.isFile())
+                continue;
+            const locked = (input.protect?.(name) ?? false) || input.now - st.mtimeMs < minAge;
+            files.push({ name, bytes: st.size, mtimeMs: st.mtimeMs, locked });
+            summary.totalBytes += st.size;
+        }
+        catch {
+            // vanished
+        }
+    }
+    let total = summary.totalBytes;
+    files.sort((a, b) => a.mtimeMs - b.mtimeMs);
+    for (const f of files) {
+        if (total <= input.capBytes)
+            break;
+        if (f.locked)
+            continue;
+        if (input.dryRun) {
+            summary.wouldDelete.push(f.name);
+            summary.wouldFreeBytes += f.bytes;
+            total -= f.bytes;
+            continue;
+        }
+        try {
+            await fs.promises.unlink(path.join(input.dir, f.name));
+            summary.deleted.push(f.name);
+            summary.freedBytes += f.bytes;
+            total -= f.bytes;
+        }
+        catch {
+            // busy — try the next one
+        }
+    }
+    summary.overCapBytes = Math.max(0, total - input.capBytes);
+    return summary;
+}
+//# sourceMappingURL=tmp-janitor.js.map

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

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

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

@@ -0,0 +1,154 @@
+/**
+ * Transcript janitor — prunes Claude Code conversation transcripts of
+ * sessions Crewly launched (crewly#1354).
+ *
+ * Claude Code keeps every conversation under `<claude home>/projects/<cwd
+ * slug>/<id>.jsonl`, plus a sibling `<id>/` dir of tool results, and cleans
+ * them up after 30 days at most. Agents write far more than a person: one
+ * Mac held 10 GB, half older than a week. Agents on the default account share
+ * `~/.claude` with the owner's own sessions, so a blanket shorter retention
+ * would hit the owner too. This sweep therefore prunes only conversations it
+ * can prove Crewly launched:
+ *
+ * - the conversation id is one Crewly recorded (`session-state.json`,
+ *   `last-conversations.json`, a handover file), or
+ * - the transcript's head carries Claude Code's `agentSetting` entry naming
+ *   a known Crewly session (Crewly launches `claude --agent <session>`).
+ *
+ * Everything else is `foreign` and never touched. A transcript (and its
+ * sibling dir) goes when it is Crewly-launched, untouched for 14 days, and
+ * not the current conversation of a live or persisted session (`keepIds`).
+ * The first real pass only logs; deletion starts the next day (the service's
+ * arming rule).
+ *
+ * @module services/worktree/transcript-janitor
+ */
+/** What identifies Crewly's conversations. */
+export interface TranscriptSources {
+    /** Session names Crewly has launched (teams, persisted sessions, handover files, the orchestrator) */
+    knownSessionNames: ReadonlySet<string>;
+    /** Conversation ids Crewly recorded anywhere */
+    recordedIds: ReadonlySet<string>;
+    /** Conversation ids of live / persisted / remembered sessions — never pruned */
+    keepIds: ReadonlySet<string>;
+}
+/** Why a transcript was pruned or kept. */
+export type TranscriptReason = 'old' | 'live-session' | 'recent' | 'foreign' | 'remove-failed';
+/** Verdict for one transcript. */
+export interface TranscriptVerdict {
+    /** Transcript file */
+    path: string;
+    /** Conversation id */
+    id: string;
+    /** Bytes of the transcript plus its sibling dir */
+    bytes: number;
+    /** What the sweep decided */
+    decision: 'prune' | 'keep';
+    /** The deciding rule */
+    reason: TranscriptReason;
+    /** `agentSetting` found in the head, when read */
+    agentSetting?: string | null;
+    /** True when deleted */
+    removed: boolean;
+    /** Error text when deletion failed */
+    error?: string;
+}
+/** Result of one transcript sweep. */
+export interface TranscriptSweepSummary {
+    /** Claude homes scanned */
+    homes: string[];
+    /** Transcripts seen */
+    scanned: number;
+    /** Transcripts identified as Crewly-launched (any age) */
+    crewlyLaunched: number;
+    /** Deleted */
+    pruned: number;
+    /** Dry run: would be deleted */
+    wouldPrune: number;
+    /** Bytes freed */
+    freedBytes: number;
+    /** Dry run: bytes that would be freed */
+    wouldFreeBytes: number;
+    /** Kept, by reason (`recent` and `foreign` are counted here but not listed) */
+    keptReasons: Record<string, number>;
+    /** Verdicts for pruned / would-prune / live-session / failed transcripts */
+    transcripts: TranscriptVerdict[];
+}
+/** Input of {@link sweepTranscripts}. */
+export interface TranscriptSweepInput {
+    /** Claude homes (`~/.claude`, each account's config dir) */
+    claudeHomes: readonly string[];
+    /** What identifies Crewly's conversations */
+    sources: TranscriptSources;
+    /** Current time (ms) */
+    now: number;
+    /** Max age before pruning (default TRANSCRIPT_MAX_AGE_MS) */
+    maxAgeMs?: number;
+    /** When true, nothing is deleted */
+    dryRun: boolean;
+    /** Size probe for sibling dirs (default: shallow stat walk) */
+    sizeOf?: (p: string) => Promise<number | null>;
+    /** Bytes read from a transcript head (default TRANSCRIPT_HEAD_BYTES) */
+    headBytes?: number;
+}
+/**
+ * The `agentSetting` Claude Code wrote at the top of a transcript, if any.
+ * Only the first `headBytes` are read.
+ *
+ * @param file - Transcript
+ * @param headBytes - Bytes to read (default TRANSCRIPT_HEAD_BYTES)
+ * @returns The agent name, or null when absent / unreadable
+ */
+export declare function readAgentSetting(file: string, headBytes?: number): string | null;
+/**
+ * Session name a handover file belongs to, from its name.
+ *
+ * @param fileName - `crewly-orc-restart-2026-10-10T22-44-14-888Z.md`
+ * @returns `crewly-orc`, or null when the name has another shape
+ */
+export declare function sessionNameFromHandoverFile(fileName: string): string | null;
+/**
+ * Every UUID in a text (lower-cased, de-duplicated).
+ *
+ * @param text - Any text
+ * @returns Ids
+ */
+export declare function collectUuids(text: string): string[];
+/**
+ * Claude homes to sweep: `~/.claude` and every account config dir under
+ * `<CREWLY_HOME>/claude-accounts/` that has a `projects/` folder.
+ *
+ * @param crewlyHome - CREWLY_HOME
+ * @param defaultHome - The default Claude home (default `~/.claude`)
+ * @returns Existing homes, de-duplicated
+ */
+export declare function defaultClaudeHomes(crewlyHome: string, defaultHome?: string): string[];
+/** Mutable builder for {@link TranscriptSources}. */
+export interface TranscriptSourceSets {
+    knownSessionNames: Set<string>;
+    recordedIds: Set<string>;
+    keepIds: Set<string>;
+}
+/**
+ * Read Crewly's own records under CREWLY_HOME: `session-state.json`
+ * (persisted sessions: names + current ids, kept), `last-conversations.json`
+ * (stopped sessions: names + ids, kept) and the handover dir (names from file
+ * names; ids from the bodies of files newer than 30 days, recorded). Pure
+ * file reads — the live session backend and the teams store are added by the
+ * service.
+ *
+ * @param crewlyHome - CREWLY_HOME
+ * @param now - Current time (ms)
+ * @param into - Sets to add to (default: new ones)
+ * @returns The sets
+ */
+export declare function readCrewlyRecords(crewlyHome: string, now: number, into?: TranscriptSourceSets): Promise<TranscriptSourceSets>;
+/**
+ * One transcript sweep over the given Claude homes. Never throws; a home or
+ * project dir that cannot be read is skipped.
+ *
+ * @param input - Homes, sources, clock, dry-run flag
+ * @returns What was pruned and kept
+ */
+export declare function sweepTranscripts(input: TranscriptSweepInput): Promise<TranscriptSweepSummary>;
+//# sourceMappingURL=transcript-janitor.d.ts.map

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

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