[luv-23] Add --safe to luv --clean -f (spare folders <24h) (#23)

* [luv-23] Add --safe to luv --clean -f to spare folders younger than 24h

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* [luv-23] Reject --safe outside --clean -f instead of silently ignoring

Per CodeRabbit review on #23.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>

Author: NiveditJain

README.md

@@ -64,6 +64,7 @@ All workspaces live under `~/prs/`. The number comes from the repo's GitHub issu
 | `luv [org/]<repo> -pr <number> [prompt]` | Open a PR by repo + number |
 | `luv --clean` | Delete workspaces where the branch is fully pushed/merged |
 | `luv --clean -f` | Force delete all workspaces |
+| `luv --clean --safe -f` | Force delete only workspaces older than 24h |
 
 ### Flags
 
@@ -75,6 +76,7 @@ All workspaces live under `~/prs/`. The number comes from the repo's GitHub issu
 | `-nit` | Non-interactive: run `claude -p <prompt>` and exit (no REPL); streams `stream-json` events to stdout |
 | `-e` | Env: pass `LUV_*` environment variables (with prefix stripped) into the session |
 | `-f`, `--force` | Skip safety checks (with `--clean`) |
+| `--safe` | With `--clean -f`, only delete workspaces older than 24h (mtime) |
 
 ## Docker dev environments
 
@@ -134,7 +136,7 @@ Docker mode works with all flags: `-n` opens a bash shell in the container, `-r`
 - No unpushed commits
 - If the remote branch is gone, verifies the PR was merged and local HEAD matches
 
-Use `luv --clean -f` to skip all safety checks and delete everything.
+Use `luv --clean -f` to skip all safety checks and delete everything. Add `--safe` (i.e. `luv --clean --safe -f`) to restrict force-delete to workspaces whose folder mtime is older than 24 hours, leaving recently-touched workspaces alone.
 
 ## Configuration
 

luv/__init__.py

@@ -6,6 +6,7 @@
 import subprocess
 import sys
 import tempfile
+import time
 from pathlib import Path
 
 LUV_DIR = Path.home() / ".luv"
@@ -391,14 +392,18 @@ def launch(clone_dir: Path, prompt: str | None, plan_mode: bool = False,
         os.execv(claude_bin, [claude_bin] + common_flags + mode_flags + initial_args)
 
 
-def cmd_clean(force: bool = False) -> None:
+SAFE_AGE_SECONDS = 24 * 3600
+
+
+def cmd_clean(force: bool = False, safe: bool = False) -> None:
     """Scan ~/prs/ and delete fully-pushed, clean work folders."""
     if not PRS_DIR.exists():
         print("luv: nothing to clean (~/prs/ does not exist)")
         return
 
     cleaned: list[str] = []
     skipped: list[tuple[str, str]] = []
+    now = time.time()
 
     for entry in sorted(PRS_DIR.iterdir()):
         if not entry.is_dir():
@@ -409,6 +414,9 @@ def cmd_clean(force: bool = False) -> None:
             continue  # doesn't match {repo}-{number} — skip silently
 
         if force:
+            if safe and (now - entry.stat().st_mtime) < SAFE_AGE_SECONDS:
+                skipped.append((entry.name, "younger than 24h (--safe)"))
+                continue
             shutil.rmtree(entry)
             cleaned.append(entry.name)
             continue
@@ -589,8 +597,9 @@ def main() -> None:
     plan_mode = "-p" in args
     non_interactive = "-nit" in args
     force = "-f" in args or "--force" in args
+    safe = "--safe" in args
     env_mode = "-e" in args
-    args = [a for a in args if a not in ("-n", "-r", "-e", "-f", "--force", "-p", "-nit")]
+    args = [a for a in args if a not in ("-n", "-r", "-e", "-f", "--force", "-p", "-nit", "--safe")]
     extra_env = collect_luv_env() if env_mode else {}
 
     if not args or args[0] in ("-h", "--help"):
@@ -604,6 +613,7 @@ def main() -> None:
   -nit          non-interactive: run claude -p <prompt> and exit (no REPL)
   -e            env: pass LUV_* environment variables (with prefix stripped) into the session
   -f, --force   (with --clean) skip safety checks and delete all work folders
+  --safe        (with --clean -f) only delete folders older than 24h
 
 Commands:
   luv --init                              configure default GitHub org
@@ -613,7 +623,7 @@ def main() -> None:
   luv [org/]<repo> -pr <number> [prompt]  open a GitHub PR by repo + number
   luv [org/]<repo> -n                     open shell in latest local clone
   luv [org/]<repo> -r                     resume Claude in latest local clone
-  luv --clean [-f]                        delete fully-pushed work folders
+  luv --clean [-f] [--safe]               delete fully-pushed work folders
 
 Org resolution:
   Explicit org/repo overrides the default. Run 'luv --init' to set a default.
@@ -625,8 +635,11 @@ def main() -> None:
   "dev-environment" service. Torn down automatically on exit.""")
         sys.exit(0)
 
+    if safe and (args[0] != "--clean" or not force):
+        die("--safe only works with --clean -f")
+
     if args[0] == "--clean":
-        cmd_clean(force=force)
+        cmd_clean(force=force, safe=safe)
         return
 
     if args[0] == "--init":

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "luv-cli"
-version = "0.0.16"
+version = "0.0.17"
 description = "Launch Claude Code agents on GitHub repos with isolated workspaces and optional Docker dev environments"
 requires-python = ">=3.10"
 license = "MIT"