@riddledc/riddle-proof 0.5.10 → 0.5.12

package/README.md

@@ -91,6 +91,13 @@ Set `RIDDLE_PROOF_WORKTREE_ROOT` to choose an explicit location. Set
 `RIDDLE_PROOF_USE_WORKSPACE_WORKTREE_ROOT=1` to keep the previous behavior of
 placing proof worktrees next to the active repository.
 
+When local scratch storage is low, setup prunes stale
+`riddle-proof-*` worktrees from the scratch root before creating the next run.
+This preserves the dependency cache for speed while avoiding old failed runs
+filling `/tmp`. Set `RIDDLE_PROOF_KEEP_SCRATCH_WORKTREES=1` to disable that
+cleanup for debugging, or tune the low-space threshold with
+`RIDDLE_PROOF_MIN_SCRATCH_FREE_MB`.
+
 ## Capture Diagnostics
 
 `@riddledc/riddle-proof/diagnostics` standardizes the evidence contract around

package/dist/{chunk-GVPCSXN7.js → chunk-7ZJAUEUN.js}

@@ -1,5 +1,6 @@
 import {
   compactRecord,
+  isTerminalStatus,
   nonEmptyString,
   recordValue
 } from "./chunk-TMMKRKY5.js";
@@ -172,6 +173,8 @@ function createRunStatusSnapshot(state, at = timestamp()) {
   return compactRecord({
     run_id: runId,
     status: state.status,
+    is_terminal: isTerminalStatus(state.status),
+    monitor_should_continue: !isTerminalStatus(state.status),
     current_stage: state.current_stage ?? null,
     state_path: state.state_path ?? null,
     worktree_path: state.worktree_path ?? null,

package/dist/{chunk-VSEKLCNU.js → chunk-F6VFKS7K.js}

@@ -3,7 +3,7 @@ import {
   appendStageHeartbeat,
   createRunState,
   setRunStatus
-} from "./chunk-GVPCSXN7.js";
+} from "./chunk-7ZJAUEUN.js";
 import {
   createRunResult
 } from "./chunk-TMMKRKY5.js";

package/dist/{chunk-7KP34QRG.js → chunk-URO4JVMA.js}

@@ -5,7 +5,7 @@ import {
   createRunStatusSnapshot,
   normalizeRunParams,
   setRunStatus
-} from "./chunk-GVPCSXN7.js";
+} from "./chunk-7ZJAUEUN.js";
 import {
   applyTerminalMetadata,
   compactRecord,

package/dist/engine-harness.cjs

@@ -2623,6 +2623,9 @@ var import_node_path3 = __toESM(require("path"), 1);
 var import_node_crypto2 = __toESM(require("crypto"), 1);
 
 // src/result.ts
+function isTerminalStatus(status) {
+  return status === "blocked" || status === "failed" || status === "ready_to_ship" || status === "shipped" || status === "completed";
+}
 function isSuccessfulStatus(status) {
   return status !== "blocked" && status !== "failed";
 }
@@ -2966,6 +2969,8 @@ function createRunStatusSnapshot(state, at = timestamp()) {
   return compactRecord({
     run_id: runId,
     status: state.status,
+    is_terminal: isTerminalStatus(state.status),
+    monitor_should_continue: !isTerminalStatus(state.status),
     current_stage: state.current_stage ?? null,
     state_path: state.state_path ?? null,
     worktree_path: state.worktree_path ?? null,

package/dist/engine-harness.js

@@ -2,8 +2,8 @@ import {
   createDisabledRiddleProofAgentAdapter,
   readRiddleProofRunStatus,
   runRiddleProofEngineHarness
-} from "./chunk-7KP34QRG.js";
-import "./chunk-GVPCSXN7.js";
+} from "./chunk-URO4JVMA.js";
+import "./chunk-7ZJAUEUN.js";
 import "./chunk-TMMKRKY5.js";
 export {
   createDisabledRiddleProofAgentAdapter,

package/dist/index.cjs

@@ -3022,6 +3022,8 @@ function createRunStatusSnapshot(state, at = timestamp()) {
   return compactRecord({
     run_id: runId,
     status: state.status,
+    is_terminal: isTerminalStatus(state.status),
+    monitor_should_continue: !isTerminalStatus(state.status),
     current_stage: state.current_stage ?? null,
     state_path: state.state_path ?? null,
     worktree_path: state.worktree_path ?? null,

package/dist/index.js

@@ -13,10 +13,10 @@ import {
   createDisabledRiddleProofAgentAdapter,
   readRiddleProofRunStatus,
   runRiddleProofEngineHarness
-} from "./chunk-7KP34QRG.js";
+} from "./chunk-URO4JVMA.js";
 import {
   runRiddleProof
-} from "./chunk-VSEKLCNU.js";
+} from "./chunk-F6VFKS7K.js";
 import {
   RIDDLE_PROOF_RUN_STATE_VERSION,
   appendRunEvent,
@@ -28,7 +28,7 @@ import {
   normalizePrLifecycleState,
   normalizeRunParams,
   setRunStatus
-} from "./chunk-GVPCSXN7.js";
+} from "./chunk-7ZJAUEUN.js";
 import {
   applyTerminalMetadata,
   compactRecord,

package/dist/openclaw.js

@@ -1,7 +1,7 @@
 import {
   normalizeIntegrationContext,
   normalizeRunParams
-} from "./chunk-GVPCSXN7.js";
+} from "./chunk-7ZJAUEUN.js";
 import {
   compactRecord
 } from "./chunk-TMMKRKY5.js";

package/dist/proof-run-engine.d.cts

@@ -262,7 +262,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     blocking?: boolean;
     details?: Record<string, unknown>;
     ok: boolean;
-    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "ship" | "setup" | "recon" | "author" | "implement" | "verify" | "run";
     state_path: string;
     stage: any;
     summary: string;
@@ -342,7 +342,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     continueWithStage?: WorkflowStage | null;
     blocking?: boolean;
     details?: Record<string, unknown>;
-    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "ship" | "setup" | "recon" | "author" | "implement" | "verify" | "run";
     state_path: string;
     stage: any;
     checkpoint: string;
@@ -589,7 +589,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     error?: undefined;
 } | {
     ok: boolean;
-    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "ship" | "setup" | "recon" | "author" | "implement" | "verify" | "run";
     state_path: string;
     stage: any;
     summary: string;

package/dist/proof-run-engine.d.ts

@@ -262,7 +262,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     blocking?: boolean;
     details?: Record<string, unknown>;
     ok: boolean;
-    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "ship" | "setup" | "recon" | "author" | "implement" | "verify" | "run";
     state_path: string;
     stage: any;
     summary: string;
@@ -342,7 +342,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     continueWithStage?: WorkflowStage | null;
     blocking?: boolean;
     details?: Record<string, unknown>;
-    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "ship" | "setup" | "recon" | "author" | "implement" | "verify" | "run";
     state_path: string;
     stage: any;
     checkpoint: string;
@@ -589,7 +589,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     error?: undefined;
 } | {
     ok: boolean;
-    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "ship" | "setup" | "recon" | "author" | "implement" | "verify" | "run";
     state_path: string;
     stage: any;
     summary: string;

package/dist/runner.js

@@ -1,7 +1,7 @@
 import {
   runRiddleProof
-} from "./chunk-VSEKLCNU.js";
-import "./chunk-GVPCSXN7.js";
+} from "./chunk-F6VFKS7K.js";
+import "./chunk-7ZJAUEUN.js";
 import "./chunk-TMMKRKY5.js";
 export {
   runRiddleProof

package/dist/state.cjs

@@ -34,6 +34,9 @@ __export(state_exports, {
 module.exports = __toCommonJS(state_exports);
 
 // src/result.ts
+function isTerminalStatus(status) {
+  return status === "blocked" || status === "failed" || status === "ready_to_ship" || status === "shipped" || status === "completed";
+}
 function compactRecord(input) {
   return Object.fromEntries(Object.entries(input).filter(([, value]) => value !== void 0 && value !== null && value !== ""));
 }
@@ -212,6 +215,8 @@ function createRunStatusSnapshot(state, at = timestamp()) {
   return compactRecord({
     run_id: runId,
     status: state.status,
+    is_terminal: isTerminalStatus(state.status),
+    monitor_should_continue: !isTerminalStatus(state.status),
     current_stage: state.current_stage ?? null,
     state_path: state.state_path ?? null,
     worktree_path: state.worktree_path ?? null,

package/dist/state.js

@@ -9,7 +9,7 @@ import {
   normalizePrLifecycleState,
   normalizeRunParams,
   setRunStatus
-} from "./chunk-GVPCSXN7.js";
+} from "./chunk-7ZJAUEUN.js";
 import "./chunk-TMMKRKY5.js";
 export {
   RIDDLE_PROOF_RUN_STATE_VERSION,

package/dist/types.d.cts

@@ -146,6 +146,8 @@ interface RiddleProofRunResult {
 interface RiddleProofRunStatusSnapshot {
     run_id: string;
     status: RiddleProofStatus;
+    is_terminal?: boolean;
+    monitor_should_continue?: boolean;
     current_stage?: RiddleProofStage | null;
     state_path?: string | null;
     worktree_path?: string | null;

package/dist/types.d.ts

@@ -146,6 +146,8 @@ interface RiddleProofRunResult {
 interface RiddleProofRunStatusSnapshot {
     run_id: string;
     status: RiddleProofStatus;
+    is_terminal?: boolean;
+    monitor_should_continue?: boolean;
     current_stage?: RiddleProofStage | null;
     state_path?: string | null;
     worktree_path?: string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riddledc/riddle-proof",
-  "version": "0.5.10",
+  "version": "0.5.12",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",

package/runtime/lib/setup.py

@@ -170,6 +170,113 @@ def resolve_worktree_root(repo_dir):
     return os.path.join(tempfile.gettempdir(), '.riddle-proof-worktrees')
 
 
+def env_flag(name, default=False):
+    raw = os.environ.get(name, '').strip().lower()
+    if raw in ('1', 'true', 'yes', 'on'):
+        return True
+    if raw in ('0', 'false', 'no', 'off'):
+        return False
+    return default
+
+
+def env_int(name, default):
+    raw = os.environ.get(name, '').strip()
+    try:
+        value = int(raw)
+    except Exception:
+        return default
+    return value if value > 0 else default
+
+
+def disk_free_bytes(path):
+    probe = path
+    while probe and not os.path.exists(probe):
+        parent = os.path.dirname(probe)
+        if parent == probe:
+            break
+        probe = parent
+    try:
+        return shutil.disk_usage(probe or tempfile.gettempdir()).free
+    except Exception:
+        return 0
+
+
+def prune_scratch_worktrees(worktree_root, keep_dirs, repo_dir):
+    report = {
+        'requested': True,
+        'worktree_root': worktree_root,
+        'removed': [],
+        'errors': [],
+    }
+    if env_flag('RIDDLE_PROOF_KEEP_SCRATCH_WORKTREES', False):
+        report['skipped'] = 'RIDDLE_PROOF_KEEP_SCRATCH_WORKTREES'
+        return report
+    if not worktree_root:
+        report['skipped'] = 'missing_worktree_root'
+        return report
+
+    root = os.path.abspath(os.path.expanduser(worktree_root))
+    temp_root = os.path.abspath(tempfile.gettempdir())
+    if root in ('/', temp_root) or not root.endswith('.riddle-proof-worktrees'):
+        report['skipped'] = 'unsafe_worktree_root'
+        return report
+    if not os.path.isdir(root):
+        report['skipped'] = 'worktree_root_missing'
+        return report
+
+    min_free_bytes = env_int('RIDDLE_PROOF_MIN_SCRATCH_FREE_MB', 2048) * 1024 * 1024
+    free_before = disk_free_bytes(root)
+    report['free_before_bytes'] = free_before
+    report['min_free_bytes'] = min_free_bytes
+    if free_before >= min_free_bytes:
+        report['skipped'] = 'enough_free_space'
+        return report
+
+    keep = set(os.path.abspath(os.path.expanduser(p)) for p in keep_dirs if p)
+    candidates = []
+    for name in os.listdir(root):
+        if not name.startswith('riddle-proof-'):
+            continue
+        path = os.path.join(root, name)
+        resolved = os.path.abspath(path)
+        if resolved in keep or not os.path.isdir(path):
+            continue
+        try:
+            mtime = os.path.getmtime(path)
+        except Exception:
+            mtime = 0
+        candidates.append((mtime, path))
+    candidates.sort()
+
+    for _, path in candidates:
+        if disk_free_bytes(root) >= min_free_bytes:
+            break
+        removed_by_git = False
+        git_error = ''
+        if repo_dir and os.path.exists(os.path.join(repo_dir, '.git')):
+            remove_result = sp.run(
+                'git worktree remove --force ' + shell_quote(path),
+                shell=True,
+                cwd=repo_dir,
+                capture_output=True,
+                text=True,
+            )
+            removed_by_git = remove_result.returncode == 0
+            if remove_result.returncode != 0 and os.path.exists(path):
+                git_error = (remove_result.stderr or remove_result.stdout or '')[:300]
+        if os.path.exists(path):
+            shutil.rmtree(path, ignore_errors=True)
+        if not os.path.exists(path):
+            report['removed'].append({'path': path, 'via': 'git' if removed_by_git else 'filesystem'})
+        elif git_error:
+            report['errors'].append({'path': path, 'git_error': git_error})
+
+    if repo_dir and os.path.exists(os.path.join(repo_dir, '.git')):
+        git('git worktree prune', repo_dir)
+    report['free_after_bytes'] = disk_free_bytes(root)
+    return report
+
+
 def cleanup_legacy_branch_worktrees(repo_dir, branch_name):
     if not repo_dir or not os.path.exists(os.path.join(repo_dir, '.git')):
         return
@@ -370,6 +477,11 @@ s['worktree_root'] = WORKTREE_ROOT
 save_state(s)
 print('Prepared workspace via ' + setup.get('source', 'workspace_core') + ': ' + repo_dir)
 os.makedirs(WORKTREE_ROOT, exist_ok=True)
+scratch_cleanup = prune_scratch_worktrees(WORKTREE_ROOT, (BEFORE_DIR, AFTER_DIR), repo_dir)
+if scratch_cleanup.get('removed') or scratch_cleanup.get('errors'):
+    print('Scratch cleanup: removed ' + str(len(scratch_cleanup.get('removed') or [])) + ' stale proof worktree(s)')
+s['scratch_cleanup'] = scratch_cleanup
+save_state(s)
 cleanup_legacy_branch_worktrees(repo_dir, base_branch)
 
 # Clean any stale worktrees for this run and the legacy fixed paths