@kynver-app/runtime 0.1.49 → 0.1.51

package/README.md

@@ -6,10 +6,10 @@ Standalone Kynver AgentOS execution runtime and CLI (`kynver`).
 
 ```bash
 npm run kynver:build
-npm run kynver -- setup --api-base-url http://localhost:3000 --agent-os-id <id> --repo /path/to/repo --max-workers 13
+npm run kynver -- setup --api-base-url http://localhost:3000 --agent-os-id <id> [--repo /path/to/repo] --max-workers 13
 npm run kynver -- login --api-key "$KYNVER_API_KEY"
 npm run kynver -- runner credential --agent-os-id <id>
-npm run kynver -- run create --repo /path/to/repo --name my-run
+npm run kynver -- run create [--repo /path/to/repo] --name my-run
 npm run kynver -- daemon --run <runId> --agent-os-id <id> --execute
 ```
 

package/dist/cleanup-guards.d.ts

@@ -1,7 +1,10 @@
 import type { CleanupSkipReason } from "./cleanup-types.js";
 import type { IndexedWorktree } from "./cleanup-worktree-index.js";
 import type { RawHarnessWorkerStatus } from "./status.js";
+/** Blocks whole-worktree removal when commits are not landed or tree is dirty. */
 export declare function isPrOrUnmergedWork(status: RawHarnessWorkerStatus): boolean;
+/** Strip generated install trees from porcelain — they are what cleanup removes. */
+export declare function materialWorktreeChanges(changedFiles: string[]): string[];
 export interface WorktreeGuardInput {
     indexed: IndexedWorktree | null;
     includeOrphans: boolean;

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

@@ -0,0 +1,14 @@
+import { type HarnessCleanupOptions } from "./cleanup-types.js";
+export interface ResolvedHarnessRetention {
+    execute: boolean;
+    finalizeStaleRuns: boolean;
+    nodeModulesAgeMs: number;
+    worktreesAgeMs: number;
+    includeOrphans: boolean;
+    runIdFilter?: string;
+    accountBytes: boolean;
+}
+/** Merge CLI options with operator env defaults (pipeline + `kynver cleanup`). */
+export declare function resolveHarnessRetention(options?: HarnessCleanupOptions): ResolvedHarnessRetention;
+/** Pipeline tick: dry-run by default; global scope when `KYNVER_CLEANUP_SCOPE=all`. */
+export declare function resolvePipelineHarnessRetention(runId?: string): ResolvedHarnessRetention;

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

@@ -0,0 +1,13 @@
+import type { IndexedWorktree } from "./cleanup-worktree-index.js";
+/** True when the worker process is still live or marked running in worker.json. */
+export declare function isWorkerProcessLive(indexed: IndexedWorktree): boolean;
+/**
+ * Run record still marked active but every worker is finished — safe to treat as
+ * terminal for GC after `finalizeStaleRuns()` (or when deriveTerminalRunStatus is set).
+ */
+export declare function isRunStaleActive(indexed: IndexedWorktree): boolean;
+/**
+ * Whether the harness run still has unfinished work that should block whole-worktree removal.
+ * Does not block per-worker `node_modules` when only this worker is finished.
+ */
+export declare function runBlocksWorktreeRemoval(indexed: IndexedWorktree): boolean;

package/dist/cleanup-types.d.ts

@@ -15,6 +15,11 @@ export interface CleanupAction extends CleanupCandidate {
     skipReason?: CleanupSkipReason;
     error?: string;
 }
+export interface RunFinalizeSummary {
+    runId: string;
+    from: string;
+    to: string;
+}
 export interface HarnessCleanupSummary {
     harnessRoot: string;
     dryRun: boolean;
@@ -23,6 +28,7 @@ export interface HarnessCleanupSummary {
     worktreesAgeMs: number;
     includeOrphans: boolean;
     scannedAt: string;
+    finalizedRuns: RunFinalizeSummary[];
     actions: CleanupAction[];
     skips: Array<{
         path: string;
@@ -31,15 +37,21 @@ export interface HarnessCleanupSummary {
     }>;
     totals: {
         candidateBytes: number;
+        reclaimableBytes: number;
         removedBytes: number;
         removedPaths: number;
         skippedPaths: number;
+        skipReasons: Partial<Record<CleanupSkipReason, number>>;
     };
 }
 export interface HarnessCleanupOptions {
     harnessRoot?: string;
     /** When false (default), only report candidates. */
     execute?: boolean;
+    /** When true (default), call `finalizeStaleRuns()` before scanning. */
+    finalizeStaleRuns?: boolean;
+    /** When true (default), estimate candidate bytes in dry-run summaries. */
+    accountBytes?: boolean;
     /** Minimum age before removing generated `node_modules` (default 6h). */
     nodeModulesAgeMs?: number;
     /** When 0 or unset, worktree removal is disabled. */

package/dist/cleanup.d.ts

@@ -1,5 +1,5 @@
 import { type HarnessCleanupOptions, type HarnessCleanupSummary } from "./cleanup-types.js";
 export declare function runHarnessCleanup(options?: HarnessCleanupOptions): HarnessCleanupSummary;
-/** Pipeline-safe defaults: node_modules only, dry-run unless execute env is set. */
+/** Pipeline-safe defaults: finalize stale runs, dry-run unless execute env is set. */
 export declare function runPipelineHarnessCleanup(runId?: string): HarnessCleanupSummary;
 export declare function isPipelineCleanupEnabled(): boolean;