@kynver-app/runtime 0.1.73 → 0.1.76

package/dist/active-harness-workers.d.ts

@@ -0,0 +1,11 @@
+export interface ActiveHarnessWorkerRef {
+    runId: string;
+    workerName: string;
+    taskId: string;
+    pid?: number;
+    writeSetPrefixes?: string[];
+    ownedPaths?: string[];
+    allowConcurrentHotspot?: boolean;
+}
+/** Live harness workers in one run — matches dispatch-next occupancy reporting. */
+export declare function collectRunActiveHarnessWorkers(runId: string): ActiveHarnessWorkerRef[];

package/dist/cleanup-evidence.d.ts

@@ -0,0 +1,10 @@
+import type { CleanupAction, CleanupSkipReason } from "./cleanup-types.js";
+export declare function collectPreservedLivePaths(actions: CleanupAction[], skips: Array<{
+    path: string;
+    reason: CleanupSkipReason;
+    detail?: string;
+}>): Array<{
+    path: string;
+    reason: CleanupSkipReason;
+    detail?: string;
+}>;

package/dist/cleanup-execute.d.ts

@@ -2,6 +2,7 @@ import type { CleanupAction, CleanupCandidate, CleanupSkipReason } from "./clean
 export declare function removeNodeModules(candidate: CleanupCandidate, execute: boolean): CleanupAction;
 export declare function removeNextCache(candidate: CleanupCandidate, execute: boolean): CleanupAction;
 export declare function removeBuildCache(candidate: CleanupCandidate, execute: boolean): CleanupAction;
+export declare function removeRunDirectory(candidate: CleanupCandidate, execute: boolean): CleanupAction;
 export declare function removeWorktree(candidate: CleanupCandidate, execute: boolean): CleanupAction;
 export declare function isHarnessNodeModulesPath(targetPath: string, harnessRoot: string, worktreesDir: string): CleanupSkipReason | null;
 export declare function isHarnessNextCachePath(targetPath: string, harnessRoot: string, worktreesDir: string): CleanupSkipReason | null;

package/dist/cleanup-guards.d.ts

@@ -10,6 +10,8 @@ export interface WorktreeGuardInput {
     worktreePath: string;
     includeOrphans: boolean;
     worktreesAgeMs: number;
+    /** Shorter age gate for harness runs already marked terminal. */
+    terminalWorktreesAgeMs: number;
     ageMs: number;
     /**
      * Filesystem-derived skip reason for orphan candidates (computed by

package/dist/cleanup-retention-config.d.ts

@@ -5,6 +5,9 @@ export interface ResolvedHarnessRetention {
     finalizeStaleRuns: boolean;
     nodeModulesAgeMs: number;
     worktreesAgeMs: number;
+    terminalWorktreesAgeMs: number;
+    runDirectoriesAgeMs: number;
+    maxActionsPerSweep: number;
     includeOrphans: boolean;
     runIdFilter?: string;
     accountBytes: boolean;

package/dist/cleanup-run-directory.d.ts

@@ -0,0 +1,20 @@
+import type { CleanupCandidate, CleanupSkipReason } from "./cleanup-types.js";
+import type { ActiveWorktreeGuardSnapshot } from "./cleanup-active-worktrees.js";
+export interface ScanRunDirectoryOptions {
+    harnessRoot: string;
+    worktreesDir: string;
+    runDirectoriesAgeMs: number;
+    runIdFilter?: string;
+    activeGuards: ActiveWorktreeGuardSnapshot;
+    now: number;
+}
+export declare function skipRunDirectoryRemoval(input: {
+    harnessRoot: string;
+    runId: string;
+    runPath: string;
+    ageMs: number;
+    runDirectoriesAgeMs: number;
+    activeGuards: ActiveWorktreeGuardSnapshot;
+}): CleanupSkipReason | null;
+/** Empty per-run folders under `worktrees/<runId>/` after worker worktrees are gone. */
+export declare function scanStaleRunDirectoryCandidates(opts: ScanRunDirectoryOptions): CleanupCandidate[];

package/dist/cleanup-types.d.ts

@@ -1,4 +1,4 @@
-export type CleanupActionKind = "remove_node_modules" | "remove_next_cache" | "remove_build_cache" | "remove_worktree";
+export type CleanupActionKind = "remove_node_modules" | "remove_next_cache" | "remove_build_cache" | "remove_worktree" | "remove_run_directory";
 export type CleanupSkipReason = "dry_run" | "below_age_threshold" | "active_worker" | "dirty_worktree" | "landing_blocked" | "pr_or_unmerged_commits" | "completion_blocked" | "run_still_active" | "path_outside_harness" | "worktrees_disabled" | "orphan_without_flag" | "missing_worktree" | "remove_failed"
 /** AgentOS / operator lifecycle overlay blocked removal (see `detail`). */
  | "board_lifecycle_blocked";
@@ -67,6 +67,14 @@ export interface HarnessCleanupSummary {
     };
     /** Disk-pressure evidence — present when bytes accounting is enabled. */
     storage?: HarnessStorageSnapshotShape;
+    /** Sample of paths kept because workers/runs are still live (for operator summaries). */
+    preservedLivePaths?: Array<{
+        path: string;
+        reason: CleanupSkipReason;
+        detail?: string;
+    }>;
+    /** Empty harness worktree run directories removed after worker worktrees were reclaimed. */
+    removedRunDirectories?: number;
 }
 export interface WorktreeRemovalGuardInput {
     worktreePath: string;
@@ -92,6 +100,15 @@ export interface HarnessCleanupOptions {
     nodeModulesAgeMs?: number;
     /** When 0 or unset, worktree removal is disabled. */
     worktreesAgeMs?: number;
+    /**
+     * Age threshold for worktrees whose harness run is already terminal
+     * (`completed` / `failed` / `cancelled` / `done`). Salvage gates still apply.
+     */
+    terminalWorktreesAgeMs?: number;
+    /** Minimum age before removing an empty `worktrees/<runId>/` directory. */
+    runDirectoriesAgeMs?: number;
+    /** Cap actions evaluated per sweep (cron/watchdog boundedness). */
+    maxActionsPerSweep?: number;
     /** Allow cleaning `node_modules` under worktrees with no worker index entry. */
     includeOrphans?: boolean;
     /** When set, only consider workers for this harness run (pipeline tick scope). */
@@ -104,3 +121,10 @@ export interface HarnessCleanupOptions {
 export declare const DEFAULT_NODE_MODULES_AGE_MS: number;
 /** Seven days — only used when worktree cleanup is explicitly enabled. */
 export declare const DEFAULT_WORKTREES_AGE_MS: number;
+/** Terminal runs: salvage-first worktree removal after workers finish (6h default). */
+export declare const DEFAULT_TERMINAL_WORKTREES_AGE_MS: number;
+/** Empty per-run worktree folders under `worktrees/<runId>/`. */
+export declare const DEFAULT_RUN_DIRECTORIES_AGE_MS: number;
+/** Bounded cron/watchdog scan — skip remaining candidates when exceeded. */
+export declare const DEFAULT_MAX_ACTIONS_PER_SWEEP = 120;
+export declare const MAX_PRESERVED_LIVE_PATH_SAMPLES = 24;