harnery 0.35.0 → 0.37.0

package/dist/core/agents/state/live-coordination-view.js

@@ -1,12 +1,12 @@
-import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, writeFileSync, } from "node:fs";
-import { dirname, join } from "node:path";
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
 import { readCoordinationViewV3, requireAuthoritySafeCoordinationViewV3, } from "../../events/v3/coordination-view.js";
-import { liveInstanceIdV3, nativeInstanceIdV3, resolveLiveEventLedgerRouteV3, } from "../../events/v3/live-routing.js";
+import { liveInstanceIdV3, nativeInstanceIdV3, observeLiveEventLedgerRouteV3, } from "../../events/v3/live-route-observer.js";
 import { readHeartbeat } from "./heartbeat-reader.js";
 import { resolveName } from "./names.js";
 /** Read the live coordination rows through the hard-cut ledger route. */
 export function readLiveCoordinationRows(coordRoot) {
-    const route = resolveLiveEventLedgerRouteV3(coordRoot);
+    const route = observeLiveEventLedgerRouteV3(coordRoot);
     if (route.state === "blocked")
         return [];
     let view;
@@ -29,7 +29,7 @@ export function readLiveCoordinationRows(coordRoot) {
 }
 /** Read one current row from the authority-safe V3 projection. */
 export function readLiveCoordinationRow(coordRoot, nativeInstanceId) {
-    const route = resolveLiveEventLedgerRouteV3(coordRoot);
+    const route = observeLiveEventLedgerRouteV3(coordRoot);
     if (route.state === "blocked")
         return null;
     try {
@@ -41,7 +41,7 @@ export function readLiveCoordinationRow(coordRoot, nativeInstanceId) {
         const parent = generation.parent_generation_id
             ? Object.values(view.instances).find((candidate) => candidate.generation_id === generation.parent_generation_id)
             : undefined;
-        return projectHeartbeatV3(coordRoot, generation, isCurrentCache(cache, generation) ? cache : undefined, nativeInstanceId, parent);
+        return projectHeartbeatV3(coordRoot, generation, isCurrentV3HeartbeatCache(cache, generation) ? cache : undefined, nativeInstanceId, parent);
     }
     catch {
         return null;
@@ -53,84 +53,19 @@ export function readLiveCoordinationRow(coordRoot, nativeInstanceId) {
  * callers must never substitute another adapter when this function succeeds.
  */
 export function liveCoordinationAdapterV3(coordRoot, nativeInstanceId) {
-    const route = resolveLiveEventLedgerRouteV3(coordRoot);
+    const route = observeLiveEventLedgerRouteV3(coordRoot);
     if (route.state === "blocked")
         throw new Error(`event_v3_coordination_view:${route.reason}`);
     const view = requireAuthoritySafeCoordinationViewV3(readCoordinationViewV3(coordRoot));
     const generation = view.instances[liveInstanceIdV3(nativeInstanceId)];
     if (!generation?.authority_eligible)
         return null;
-    const adapter = observedAdapter(generation);
-    if (!isAdapter(adapter)) {
+    const adapter = observedAdapterV3(generation);
+    if (!isAdapterV3(adapter)) {
         throw new Error("event_v3_coordination_view:adapter_not_observed");
     }
     return adapter;
 }
-/**
- * Ensure the current V3 generation has a mutation target. The resulting file
- * is explicitly generation-bound and disposable: V3 remains the source of
- * truth, while the cache gives the crash-safe authority outbox an atomic local
- * state to reconcile.
- */
-export function ensureLiveCoordinationHeartbeat(coordRoot, nativeInstanceId, nativeSessionId, _adapter, model) {
-    const route = resolveLiveEventLedgerRouteV3(coordRoot);
-    if (route.state === "blocked")
-        throw new Error(`event_v3_coordination_view:${route.reason}`);
-    const view = requireAuthoritySafeCoordinationViewV3(readCoordinationViewV3(coordRoot));
-    const generation = view.instances[liveInstanceIdV3(nativeInstanceId)];
-    if (!generation?.authority_eligible)
-        return null;
-    const generationAdapter = observedAdapter(generation);
-    if (!isAdapter(generationAdapter)) {
-        throw new Error("event_v3_coordination_view:adapter_not_observed");
-    }
-    const current = readHeartbeat(coordRoot, nativeInstanceId);
-    if (isCurrentCache(current, generation) && current.platform === generationAdapter)
-        return current;
-    const resolved = resolveName(coordRoot, nativeInstanceId, nativeSessionId);
-    const projected = projectHeartbeatV3(coordRoot, generation, undefined, nativeInstanceId);
-    // A generation reopen (resume, mid-flight onboarding) discards the stale
-    // cache, but the adapter tab it names is unchanged: same native session,
-    // same agent identity. Rebuilding without the naming evidence re-mints a
-    // fresh suggested name on the next set-task, so a multi-day session
-    // accumulates titles it is asked to display over and over. Carry the
-    // naming evidence across generations; everything else re-projects from V3.
-    // Same native session id means the same adapter tab; drop the carry only
-    // when the durable identity observably changed (a reassumed name would make
-    // the old "Agent <name> - …" block wrong for the new owner).
-    const identityUnchanged = !resolved?.name || !current?.name || resolved.name === current.name;
-    const carriedNaming = current && current.session_id === nativeSessionId && identityUnchanged
-        ? {
-            ...(current.suggested_session_name
-                ? { suggested_session_name: current.suggested_session_name }
-                : {}),
-            ...(current.session_name_seen_for
-                ? { session_name_seen_for: current.session_name_seen_for }
-                : {}),
-            ...(current.session_name_seen_at
-                ? { session_name_seen_at: current.session_name_seen_at }
-                : {}),
-        }
-        : {};
-    const materialized = {
-        ...projected,
-        ...carriedNaming,
-        schema_version: 2,
-        instance_id: nativeInstanceId,
-        session_id: nativeSessionId,
-        name: resolved?.name ?? "",
-        kind: resolved?.kind ?? projected.kind,
-        agent_id: resolved?.agent_id ?? (resolved?.kind === "subagent" ? nativeInstanceId : ""),
-        model: projected.model ?? model ?? "",
-        platform: generationAdapter,
-        v3_instance_id: generation.instance_id,
-        v3_generation_id: generation.generation_id,
-        v3_projection_event_id: generation.last_event_id,
-        v3_task_state: generation.task_state === "set" ? "set" : "cleared",
-    };
-    writeHeartbeatCache(coordRoot, nativeInstanceId, materialized);
-    return materialized;
-}
 function readCacheRows(coordRoot) {
     const dir = join(coordRoot, ".harnery", "active");
     if (!existsSync(dir))
@@ -152,15 +87,15 @@ function readV3Caches(coordRoot) {
     return readCacheRows(coordRoot).filter((row) => row.schema_version === 2 && typeof row.v3_generation_id === "string");
 }
 function matchingCache(caches, generation) {
-    return caches.find((cache) => isCurrentCache(cache, generation));
+    return caches.find((cache) => isCurrentV3HeartbeatCache(cache, generation));
 }
-function isCurrentCache(cache, generation) {
+export function isCurrentV3HeartbeatCache(cache, generation) {
     return (cache?.schema_version === 2 &&
         cache.v3_instance_id === generation.instance_id &&
         cache.v3_generation_id === generation.generation_id);
 }
-function projectHeartbeatV3(coordRoot, generation, cache, nativeInstanceId, parent) {
-    const adapter = observedAdapter(generation) ?? cache?.platform ?? "unknown";
+export function projectHeartbeatV3(coordRoot, generation, cache, nativeInstanceId, parent) {
+    const adapter = observedAdapterV3(generation) ?? cache?.platform ?? "unknown";
     const model = observedModel(generation) ?? cache?.model ?? "";
     const instanceId = nativeInstanceId ?? cache?.instance_id ?? nativeInstanceIdV3(generation.instance_id);
     const durableIdentity = resolveName(coordRoot, instanceId, cache?.session_id ?? generation.session_id);
@@ -207,11 +142,11 @@ function projectHeartbeatV3(coordRoot, generation, cache, nativeInstanceId, pare
         v3_task_state: taskIsSet ? "set" : "cleared",
     };
 }
-function observedAdapter(generation) {
+export function observedAdapterV3(generation) {
     const observation = generation.runtime_attestation.adapter;
     return observation.state === "observed" ? observation.value.id : undefined;
 }
-function isAdapter(value) {
+export function isAdapterV3(value) {
     return value === "claude-code" || value === "cursor" || value === "codex";
 }
 function observedModel(generation) {
@@ -221,13 +156,3 @@ function observedModel(generation) {
 function isLifecycleState(value) {
     return value === "active" || value === "blocked" || value === "done";
 }
-function writeHeartbeatCache(coordRoot, instanceId, heartbeat) {
-    if (!/^[a-zA-Z0-9._-]{1,128}$/.test(instanceId)) {
-        throw new Error("instance_id is unsafe for heartbeat materialization");
-    }
-    const path = join(coordRoot, ".harnery", "active", `${instanceId}.json`);
-    mkdirSync(dirname(path), { recursive: true });
-    const temporary = `${path}.tmp.${process.pid}`;
-    writeFileSync(temporary, JSON.stringify(heartbeat, null, 2), "utf8");
-    renameSync(temporary, path);
-}

package/dist/core/agents/state/live-coordination-writer.d.ts

@@ -0,0 +1,12 @@
+import type { Adapter } from "../../adapter.js";
+import { type Heartbeat } from "./heartbeat-reader.js";
+/**
+ * Ensure the current V3 generation has a mutation target. The resulting file
+ * is explicitly generation-bound and disposable: V3 remains the source of
+ * truth, while the cache gives the crash-safe authority outbox an atomic local
+ * state to reconcile.
+ */
+export declare function ensureLiveCoordinationHeartbeat(coordRoot: string, nativeInstanceId: string, nativeSessionId: string, _adapter: Adapter, model?: string): Heartbeat | null;
+/** Rebuild a disposable cache from V3 even when its generation markers look current. */
+export declare function repairLiveCoordinationHeartbeat(coordRoot: string, nativeInstanceId: string, nativeSessionId: string, adapter: Adapter, model?: string): Heartbeat | null;
+//# sourceMappingURL=live-coordination-writer.d.ts.map

package/dist/core/agents/state/live-coordination-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-coordination-writer.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/live-coordination-writer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAMhD,OAAO,EAAE,KAAK,SAAS,EAAiB,MAAM,uBAAuB,CAAC;AAUtE;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EACxB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,OAAO,EACjB,KAAK,CAAC,EAAE,MAAM,GACb,SAAS,GAAG,IAAI,CASlB;AAED,wFAAwF;AACxF,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EACxB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,OAAO,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,SAAS,GAAG,IAAI,CASlB"}

package/dist/core/agents/state/live-coordination-writer.js

@@ -0,0 +1,92 @@
+import { mkdirSync, renameSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { readCoordinationViewV3, requireAuthoritySafeCoordinationViewV3, } from "../../events/v3/coordination-view.js";
+import { liveInstanceIdV3, resolveLiveEventLedgerRouteV3 } from "../../events/v3/live-routing.js";
+import { readHeartbeat } from "./heartbeat-reader.js";
+import { isAdapterV3, isCurrentV3HeartbeatCache, observedAdapterV3, projectHeartbeatV3, } from "./live-coordination-view.js";
+import { resolveName } from "./names.js";
+/**
+ * Ensure the current V3 generation has a mutation target. The resulting file
+ * is explicitly generation-bound and disposable: V3 remains the source of
+ * truth, while the cache gives the crash-safe authority outbox an atomic local
+ * state to reconcile.
+ */
+export function ensureLiveCoordinationHeartbeat(coordRoot, nativeInstanceId, nativeSessionId, _adapter, model) {
+    return materializeLiveCoordinationHeartbeat(coordRoot, nativeInstanceId, nativeSessionId, _adapter, model, false);
+}
+/** Rebuild a disposable cache from V3 even when its generation markers look current. */
+export function repairLiveCoordinationHeartbeat(coordRoot, nativeInstanceId, nativeSessionId, adapter, model) {
+    return materializeLiveCoordinationHeartbeat(coordRoot, nativeInstanceId, nativeSessionId, adapter, model, true);
+}
+function materializeLiveCoordinationHeartbeat(coordRoot, nativeInstanceId, nativeSessionId, _adapter, model, force) {
+    const route = resolveLiveEventLedgerRouteV3(coordRoot);
+    if (route.state === "blocked")
+        throw new Error(`event_v3_coordination_view:${route.reason}`);
+    const view = requireAuthoritySafeCoordinationViewV3(readCoordinationViewV3(coordRoot));
+    const generation = view.instances[liveInstanceIdV3(nativeInstanceId)];
+    if (!generation?.authority_eligible)
+        return null;
+    const generationAdapter = observedAdapterV3(generation);
+    if (!isAdapterV3(generationAdapter)) {
+        throw new Error("event_v3_coordination_view:adapter_not_observed");
+    }
+    const current = readHeartbeat(coordRoot, nativeInstanceId);
+    if (!force &&
+        isCurrentV3HeartbeatCache(current, generation) &&
+        current.platform === generationAdapter) {
+        return current;
+    }
+    const resolved = resolveName(coordRoot, nativeInstanceId, nativeSessionId);
+    const projected = projectHeartbeatV3(coordRoot, generation, undefined, nativeInstanceId);
+    // A generation reopen (resume, mid-flight onboarding) discards the stale
+    // cache, but the adapter tab it names is unchanged: same native session,
+    // same agent identity. Rebuilding without the naming evidence re-mints a
+    // fresh suggested name on the next set-task, so a multi-day session
+    // accumulates titles it is asked to display over and over. Carry the
+    // naming evidence across generations; everything else re-projects from V3.
+    // Same native session id means the same adapter tab; drop the carry only
+    // when the durable identity observably changed (a reassumed name would make
+    // the old "Agent <name> - …" block wrong for the new owner).
+    const identityUnchanged = !resolved?.name || !current?.name || resolved.name === current.name;
+    const carriedNaming = current && current.session_id === nativeSessionId && identityUnchanged
+        ? {
+            ...(current.suggested_session_name
+                ? { suggested_session_name: current.suggested_session_name }
+                : {}),
+            ...(current.session_name_seen_for
+                ? { session_name_seen_for: current.session_name_seen_for }
+                : {}),
+            ...(current.session_name_seen_at
+                ? { session_name_seen_at: current.session_name_seen_at }
+                : {}),
+        }
+        : {};
+    const materialized = {
+        ...projected,
+        ...carriedNaming,
+        schema_version: 2,
+        instance_id: nativeInstanceId,
+        session_id: nativeSessionId,
+        name: resolved?.name ?? "",
+        kind: resolved?.kind ?? projected.kind,
+        agent_id: resolved?.agent_id ?? (resolved?.kind === "subagent" ? nativeInstanceId : ""),
+        model: projected.model ?? model ?? "",
+        platform: generationAdapter,
+        v3_instance_id: generation.instance_id,
+        v3_generation_id: generation.generation_id,
+        v3_projection_event_id: generation.last_event_id,
+        v3_task_state: generation.task_state === "set" ? "set" : "cleared",
+    };
+    writeHeartbeatCache(coordRoot, nativeInstanceId, materialized);
+    return materialized;
+}
+function writeHeartbeatCache(coordRoot, instanceId, heartbeat) {
+    if (!/^[a-zA-Z0-9._-]{1,128}$/.test(instanceId)) {
+        throw new Error("instance_id is unsafe for heartbeat materialization");
+    }
+    const path = join(coordRoot, ".harnery", "active", `${instanceId}.json`);
+    mkdirSync(dirname(path), { recursive: true });
+    const temporary = `${path}.tmp.${process.pid}`;
+    writeFileSync(temporary, JSON.stringify(heartbeat, null, 2), "utf8");
+    renameSync(temporary, path);
+}

package/dist/core/artifacts/index.d.ts

@@ -28,8 +28,9 @@ export interface ArtifactManifestV1 {
     };
     released_at?: string;
     released_by?: ArtifactActor;
+    oversize_acknowledged?: boolean;
 }
-export type ArtifactClassification = "managed-active" | "managed-current" | "managed-expired" | "managed-tracked" | "invalid-manifest" | "unmanaged" | "symlink" | "unknown";
+export type ArtifactClassification = "managed-active" | "managed-current" | "managed-expired" | "managed-oversize" | "managed-over-budget" | "managed-tracked" | "invalid-manifest" | "unmanaged" | "symlink" | "unknown";
 export interface ArtifactInventoryEntry {
     name: string;
     path: string;
@@ -44,6 +45,7 @@ export interface ArtifactInventoryEntry {
     last_modified_at: string | null;
     expires_at: string | null;
     owner_instance_id: string | null;
+    oversize_acknowledged: boolean;
 }
 export interface ArtifactCreateInput {
     slug: string;
@@ -52,11 +54,25 @@ export interface ArtifactCreateInput {
     actor?: ArtifactActor;
     now?: Date;
     id?: string;
+    big?: boolean;
 }
 export interface ArtifactMutationInput {
     actor?: ArtifactActor;
     now?: Date;
 }
+export interface ArtifactAdoptionResult {
+    candidates: Array<{
+        path: string;
+        name: string;
+        bytes: number;
+        kind: "file" | "directory";
+    }>;
+    candidate_bytes: number;
+    requires_big: boolean;
+    adopted_artifact_id: string | null;
+    adopted_path: string | null;
+    adopted_directories: number;
+}
 export declare function artifactsRoot(repoRoot: string): string;
 /** Public config-aware default for embedding hosts that create artifact units. */
 export declare function configuredArtifactRetentionDays(repoRoot: string): number;
@@ -77,10 +93,40 @@ export declare function showArtifact(repoRoot: string, ref: string, opts?: {
 };
 export declare function renewArtifact(repoRoot: string, ref: string, days: number, reason: string, input?: ArtifactMutationInput): ArtifactManifestV1;
 export declare function releaseArtifact(repoRoot: string, ref: string, input?: ArtifactMutationInput): ArtifactManifestV1;
+/** Adopt untracked loose files and legacy directories without changing directory paths. */
+export declare function adoptUnmanagedArtifactFiles(repoRoot: string, input: {
+    yes?: boolean;
+    big?: boolean;
+    purpose: string;
+    retentionDays: number;
+    actor?: ArtifactActor;
+    now?: Date;
+}): ArtifactAdoptionResult;
 export declare function cleanArtifacts(repoRoot: string, opts?: {
     yes?: boolean;
     now?: Date;
     freshnessSeconds?: number;
 }): ArtifactInventoryEntry[];
+export interface ArtifactAutoCleanResult {
+    ran: boolean;
+    reason: "swept" | "disabled" | "fresh" | "no-root";
+    deleted: number;
+    bytes: number;
+}
+/**
+ * Throttled expired-artifact sweep, fired as a SessionStart effect.
+ *
+ * Retention was previously enforced only when someone remembered to run
+ * `artifacts clean --yes`, so expired workspaces accumulated indefinitely on
+ * busy hosts. This runs the exact same guarded deletion (only
+ * `managed-expired` entries, each re-classified immediately before removal;
+ * unmanaged and legacy directories are never touched) at most once per
+ * interval (default 24h), claim-first via a stamp file so concurrent session
+ * starts do not double-sweep. Disable with `artifacts.auto_clean: false` or
+ * `HARNERY_ARTIFACT_AUTO_CLEAN=0`.
+ */
+export declare function autoCleanArtifacts(repoRoot: string, opts?: {
+    now?: Date;
+}): ArtifactAutoCleanResult;
 export declare function resolveArtifactRef(repoRoot: string, ref: string): string;
 //# sourceMappingURL=index.d.ts.map

package/dist/core/artifacts/index.d.ts.map

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

package/dist/core/artifacts/index.js

@@ -12,7 +12,7 @@ import { randomUUID } from "node:crypto";
 import { existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, writeFileSync, } from "node:fs";
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { readLiveCoordinationRow } from "../agents/state/live-coordination-view.js";
-import { artifactDefaultRetentionDays } from "../config.js";
+import { artifactAutoCleanEnabled, artifactAutoCleanIntervalHours, artifactDefaultRetentionDays, artifactMaxBytes, artifactMaxUnitBytes, } from "../config.js";
 import { ARTIFACT_MANIFEST, ARTIFACT_SCHEMA_VERSION, ARTIFACTS_DIR } from "./constants.js";
 export { ARTIFACT_MANIFEST, ARTIFACT_SCHEMA_VERSION, ARTIFACTS_DIR } from "./constants.js";
 export function artifactsRoot(repoRoot) {
@@ -51,6 +51,7 @@ export function createArtifact(repoRoot, input) {
         retention: {
             expires_at: addDays(now, retentionDays).toISOString(),
         },
+        ...(input.big ? { oversize_acknowledged: true } : {}),
     };
     atomicWriteManifest(path, manifest);
     return { path, manifest };
@@ -75,11 +76,13 @@ export function inventoryArtifacts(repoRoot, opts = {}) {
     for (const name of names) {
         rows.push(classifyArtifactPath(repoRoot, join(root, name), now, freshnessSeconds));
     }
-    return rows;
+    return applyArtifactBudgets(repoRoot, rows);
 }
 export function showArtifact(repoRoot, ref, opts = {}) {
     const path = resolveArtifactRef(repoRoot, ref);
-    const entry = classifyArtifactPath(repoRoot, path, opts.now ?? new Date(), opts.freshnessSeconds ?? 600);
+    const entry = inventoryArtifacts(repoRoot, opts).find((row) => row.path === path);
+    if (!entry)
+        throw new Error(`artifact "${ref}" was not found`);
     const parsed = readManifest(path);
     if (!parsed.ok)
         throw new Error(parsed.reason);
@@ -122,6 +125,98 @@ export function releaseArtifact(repoRoot, ref, input = {}) {
     atomicWriteManifest(path, manifest);
     return manifest;
 }
+/** Adopt untracked loose files and legacy directories without changing directory paths. */
+export function adoptUnmanagedArtifactFiles(repoRoot, input) {
+    const now = input.now ?? new Date();
+    const candidates = [];
+    for (const row of inventoryArtifacts(repoRoot, { now })) {
+        if (row.classification !== "unmanaged")
+            continue;
+        try {
+            const stat = lstatSync(row.path);
+            if (stat.isSymbolicLink() || containsTrackedPath(repoRoot, row.path))
+                continue;
+            if (stat.isFile()) {
+                candidates.push({ path: row.path, name: row.name, bytes: stat.size, kind: "file" });
+                continue;
+            }
+            if (stat.isDirectory() && !existsSync(join(row.path, ARTIFACT_MANIFEST))) {
+                const bytes = safeTreeSize(row.path);
+                if (bytes !== null && normalizeSlug(row.name)) {
+                    candidates.push({ path: row.path, name: row.name, bytes, kind: "directory" });
+                }
+            }
+        }
+        catch {
+            // A racing or unreadable entry stays unmanaged.
+        }
+    }
+    const candidateBytes = candidates.reduce((sum, row) => sum + row.bytes, 0);
+    const fileBytes = candidates.reduce((sum, row) => sum + (row.kind === "file" ? row.bytes : 0), 0);
+    const maxUnitBytes = artifactMaxUnitBytes(repoRoot);
+    const requiresBig = fileBytes > maxUnitBytes ||
+        candidates.some((row) => row.kind === "directory" && row.bytes > maxUnitBytes);
+    const preview = {
+        candidates,
+        candidate_bytes: candidateBytes,
+        requires_big: requiresBig,
+        adopted_artifact_id: null,
+        adopted_path: null,
+        adopted_directories: 0,
+    };
+    if (!input.yes || candidates.length === 0)
+        return preview;
+    if (requiresBig && !input.big) {
+        throw new Error("unmanaged adoption exceeds the per-bundle ceiling; repeat with --big");
+    }
+    // Revalidate every exact source before creating a destination. A changed,
+    // tracked, linked, or non-regular entry aborts the whole adoption.
+    for (const candidate of candidates) {
+        const stat = lstatSync(candidate.path);
+        const bytes = stat.isDirectory() ? safeTreeSize(candidate.path) : stat.size;
+        if (stat.isSymbolicLink() ||
+            bytes !== candidate.bytes ||
+            containsTrackedPath(repoRoot, candidate.path)) {
+            throw new Error(`unmanaged entry changed before adoption: ${candidate.name}`);
+        }
+        if (candidate.kind === "file" ? !stat.isFile() : !stat.isDirectory()) {
+            throw new Error(`unmanaged entry changed before adoption: ${candidate.name}`);
+        }
+    }
+    const files = candidates.filter((candidate) => candidate.kind === "file");
+    const created = files.length
+        ? createArtifact(repoRoot, {
+            slug: "adopted-unmanaged",
+            purpose: input.purpose,
+            retentionDays: input.retentionDays,
+            actor: input.actor,
+            now,
+            big: input.big,
+        })
+        : null;
+    for (const candidate of files)
+        renameSync(candidate.path, join(created.path, candidate.name));
+    const retentionDays = positiveDays(input.retentionDays);
+    const directories = candidates.filter((candidate) => candidate.kind === "directory");
+    for (const candidate of directories) {
+        atomicWriteManifest(candidate.path, {
+            schema_version: ARTIFACT_SCHEMA_VERSION,
+            artifact_id: randomUUID(),
+            slug: normalizeSlug(candidate.name),
+            purpose: `${input.purpose}: ${candidate.name}`,
+            created_at: now.toISOString(),
+            created_by: input.actor,
+            retention: { expires_at: addDays(now, retentionDays).toISOString() },
+            ...(input.big ? { oversize_acknowledged: true } : {}),
+        });
+    }
+    return {
+        ...preview,
+        adopted_artifact_id: created?.manifest.artifact_id ?? null,
+        adopted_path: created?.path ?? null,
+        adopted_directories: directories.length,
+    };
+}
 export function cleanArtifacts(repoRoot, opts = {}) {
     const now = opts.now ?? new Date();
     const freshnessSeconds = opts.freshnessSeconds ?? 600;
@@ -129,13 +224,21 @@ export function cleanArtifacts(repoRoot, opts = {}) {
     if (!opts.yes)
         return rows;
     return rows.map((entry) => {
-        if (entry.classification !== "managed-expired")
+        if (entry.action !== "would-delete")
             return entry;
         // Reclassify immediately before removal. A renewal, release-state change,
         // heartbeat, symlink swap, or tracked file added since inventory must win.
-        const current = classifyArtifactPath(repoRoot, entry.path, now, freshnessSeconds);
-        if (current.classification !== "managed-expired")
+        const current = inventoryArtifacts(repoRoot, { now, freshnessSeconds }).find((row) => row.path === entry.path);
+        if (!current) {
+            return { ...entry, classification: "unknown", reason: "entry disappeared", action: "keep" };
+        }
+        if (current.action !== "would-delete" ||
+            current.artifact_id !== entry.artifact_id ||
+            current.bytes !== entry.bytes ||
+            current.last_modified_at !== entry.last_modified_at ||
+            current.expires_at !== entry.expires_at) {
             return current;
+        }
         try {
             const top = lstatSync(current.path);
             if (!top.isDirectory() || top.isSymbolicLink()) {
@@ -159,6 +262,51 @@ export function cleanArtifacts(repoRoot, opts = {}) {
         }
     });
 }
+/** Sibling of the artifacts root so the stamp never appears in the inventory scan. */
+const AUTO_CLEAN_STAMP = ".harnery/artifacts-auto-clean.json";
+/**
+ * Throttled expired-artifact sweep, fired as a SessionStart effect.
+ *
+ * Retention was previously enforced only when someone remembered to run
+ * `artifacts clean --yes`, so expired workspaces accumulated indefinitely on
+ * busy hosts. This runs the exact same guarded deletion (only
+ * `managed-expired` entries, each re-classified immediately before removal;
+ * unmanaged and legacy directories are never touched) at most once per
+ * interval (default 24h), claim-first via a stamp file so concurrent session
+ * starts do not double-sweep. Disable with `artifacts.auto_clean: false` or
+ * `HARNERY_ARTIFACT_AUTO_CLEAN=0`.
+ */
+export function autoCleanArtifacts(repoRoot, opts = {}) {
+    const now = opts.now ?? new Date();
+    assertValidDate(now, "now");
+    if (!existsSync(artifactsRoot(repoRoot))) {
+        return { ran: false, reason: "no-root", deleted: 0, bytes: 0 };
+    }
+    if (!artifactAutoCleanEnabled(repoRoot)) {
+        return { ran: false, reason: "disabled", deleted: 0, bytes: 0 };
+    }
+    const stampPath = join(resolve(repoRoot), AUTO_CLEAN_STAMP);
+    const intervalMs = artifactAutoCleanIntervalHours() * 60 * 60 * 1000;
+    try {
+        const stamp = JSON.parse(readFileSync(stampPath, "utf8"));
+        const last = Date.parse(stamp.last_run_at ?? "");
+        if (Number.isFinite(last) && now.getTime() - last < intervalMs) {
+            return { ran: false, reason: "fresh", deleted: 0, bytes: 0 };
+        }
+    }
+    catch {
+        // Missing or unreadable stamp: sweep now and write a fresh one.
+    }
+    // Claim first: a crash mid-sweep costs one skipped interval, while claiming
+    // after would let two concurrent session starts both walk the store.
+    writeFileSync(stampPath, `${JSON.stringify({ last_run_at: now.toISOString() }, null, 2)}\n`);
+    const rows = cleanArtifacts(repoRoot, { yes: true, now });
+    const deletedRows = rows.filter((row) => row.action === "deleted");
+    const deleted = deletedRows.length;
+    const bytes = deletedRows.reduce((sum, row) => sum + (row.bytes ?? 0), 0);
+    writeFileSync(stampPath, `${JSON.stringify({ last_run_at: now.toISOString(), deleted, bytes }, null, 2)}\n`);
+    return { ran: true, reason: "swept", deleted, bytes };
+}
 export function resolveArtifactRef(repoRoot, ref) {
     const root = artifactsRoot(repoRoot);
     const candidate = isAbsolute(ref) ? resolve(ref) : resolve(root, ref);
@@ -219,6 +367,7 @@ function classifyArtifactPath(repoRoot, path, now, freshnessSeconds) {
         last_modified_at: new Date(effectiveLastModifiedMs).toISOString(),
         expires_at: effectiveExpiresAt,
         owner_instance_id: manifest.created_by?.instance_id ?? null,
+        oversize_acknowledged: manifest.oversize_acknowledged === true,
     });
     if (base.bytes === null || lastModifiedMs === null) {
         return {
@@ -264,6 +413,38 @@ function classifyArtifactPath(repoRoot, path, now, freshnessSeconds) {
         action: "would-delete",
     };
 }
+function applyArtifactBudgets(repoRoot, inputRows) {
+    const maxUnitBytes = artifactMaxUnitBytes(repoRoot);
+    const maxBytes = artifactMaxBytes(repoRoot);
+    const rows = inputRows.map((row) => ({ ...row }));
+    for (const row of rows) {
+        if (row.classification === "managed-current" &&
+            row.bytes !== null &&
+            row.bytes > maxUnitBytes &&
+            !row.oversize_acknowledged) {
+            row.classification = "managed-oversize";
+            row.reason = `bundle uses ${row.bytes} bytes, above the ${maxUnitBytes}-byte ceiling without --big`;
+            row.action = "would-delete";
+        }
+    }
+    const managedBytes = rows.reduce((sum, row) => sum + (row.artifact_id && row.bytes !== null ? row.bytes : 0), 0);
+    let retainedBytes = managedBytes -
+        rows.reduce((sum, row) => sum + (row.action === "would-delete" && row.bytes !== null ? row.bytes : 0), 0);
+    if (retainedBytes <= maxBytes)
+        return rows;
+    const candidates = rows
+        .filter((row) => row.classification === "managed-current" && row.action === "keep" && row.bytes !== null)
+        .sort((left, right) => `${left.expires_at ?? ""}\0${left.created_at ?? ""}\0${left.name}`.localeCompare(`${right.expires_at ?? ""}\0${right.created_at ?? ""}\0${right.name}`));
+    for (const row of candidates) {
+        if (retainedBytes <= maxBytes)
+            break;
+        row.classification = "managed-over-budget";
+        row.reason = `repository artifact budget is ${maxBytes} bytes; earliest-expiring inactive bundles are removed first`;
+        row.action = "would-delete";
+        retainedBytes -= row.bytes ?? 0;
+    }
+    return rows;
+}
 function readManifest(path) {
     const manifestPath = join(path, ARTIFACT_MANIFEST);
     if (!existsSync(manifestPath)) {
@@ -312,6 +493,9 @@ function readManifest(path) {
     if (m.released_by !== undefined && !validActor(m.released_by)) {
         return { ok: false, reason: "invalid released_by" };
     }
+    if (m.oversize_acknowledged !== undefined && typeof m.oversize_acknowledged !== "boolean") {
+        return { ok: false, reason: "invalid oversize_acknowledged" };
+    }
     return { ok: true, manifest: m };
 }
 function atomicWriteManifest(path, manifest) {
@@ -415,6 +599,7 @@ function rowFor(path, name, repoRoot, classification, reason, bytes = safeTreeSi
         last_modified_at: null,
         expires_at: null,
         owner_instance_id: null,
+        oversize_acknowledged: false,
     };
 }
 function normalizeSlug(value) {