claude-session-backup 0.2.2__tar.gz → 0.2.3__tar.gz

{claude_session_backup-0.2.2 → claude_session_backup-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-session-backup
-Version: 0.2.2
+Version: 0.2.3
 Summary: Git-backed Claude Code session backup with timeline view, folder analysis, deletion detection, and session restore.
 Author-email: djdarcy <6962246+djdarcy@users.noreply.github.com>
 License: GPL-3.0-or-later
@@ -89,8 +89,15 @@ csb list [keyword]                    # Filter by keyword in name/project/folder
 csb list --sort expiration            # Sort by soonest-to-purge first
 csb list --sort {last-used|expiration|started|oldest|messages|size}
 csb list --deleted                    # Show deleted sessions
-csb scan [path]                       # Find sessions touching this directory
-csb scan [path] -NU                   # Prefix-only match (skip folder-usage search)
+csb scan                              # Find sessions touching cwd (path-prefix)
+csb scan <term>                       # Filter by term: name, project, folder paths
+csb scan ./<dirname>                  # Shortcut: same as -d <dirname> (no flag to remember)
+csb scan -d <pattern>                 # Path-strict: folder + descendants
+csb scan -D <pattern>                 # Path-strict: this folder only, no descendants
+csb scan -s <pattern>                 # start_folder only ("what sessions originated here?")
+csb scan -d <pattern> <term>          # Scope-then-filter combined
+csb scan -d <pattern>* / -D <pattern>* / -s <pattern>*  # Trailing-* wildcard
+csb scan ... -NU                      # Skip folder-usage search (start_folder only)
 csb status                            # Summary stats
 csb show <session-id>                 # Detailed session info with folder analysis
 csb search "query"                    # Search by session name, project, or folder

{claude_session_backup-0.2.2 → claude_session_backup-0.2.3}/README.md

@@ -58,8 +58,15 @@ csb list [keyword]                    # Filter by keyword in name/project/folder
 csb list --sort expiration            # Sort by soonest-to-purge first
 csb list --sort {last-used|expiration|started|oldest|messages|size}
 csb list --deleted                    # Show deleted sessions
-csb scan [path]                       # Find sessions touching this directory
-csb scan [path] -NU                   # Prefix-only match (skip folder-usage search)
+csb scan                              # Find sessions touching cwd (path-prefix)
+csb scan <term>                       # Filter by term: name, project, folder paths
+csb scan ./<dirname>                  # Shortcut: same as -d <dirname> (no flag to remember)
+csb scan -d <pattern>                 # Path-strict: folder + descendants
+csb scan -D <pattern>                 # Path-strict: this folder only, no descendants
+csb scan -s <pattern>                 # start_folder only ("what sessions originated here?")
+csb scan -d <pattern> <term>          # Scope-then-filter combined
+csb scan -d <pattern>* / -D <pattern>* / -s <pattern>*  # Trailing-* wildcard
+csb scan ... -NU                      # Skip folder-usage search (start_folder only)
 csb status                            # Summary stats
 csb show <session-id>                 # Detailed session info with folder analysis
 csb search "query"                    # Search by session name, project, or folder

{claude_session_backup-0.2.2 → claude_session_backup-0.2.3}/claude_session_backup/_version.py

@@ -15,13 +15,13 @@ To bump version: python scripts/sync-versions.py --bump patch
 # Version components - edit these for version bumps
 MAJOR = 0
 MINOR = 2
-PATCH = 2
+PATCH = 3
 PHASE = ""  # Per-MINOR feature set: None, "alpha", "beta", "rc1", etc.
 PRE_RELEASE_NUM = 1  # PEP 440 pre-release number (e.g., a1, b2)
 PROJECT_PHASE = "prealpha"  # Project-wide: "prealpha", "alpha", "beta", "stable"
 
 # Auto-updated by git hooks - do not edit manually
-__version__ = "0.2.2"
+__version__ = "0.2.3"
 __app_name__ = "claude-session-backup"
 
 

{claude_session_backup-0.2.2 → claude_session_backup-0.2.3}/claude_session_backup/cli.py

@@ -150,6 +150,15 @@ def build_parser():
     p_list.add_argument("--deleted", action="store_true", help="Show only deleted sessions")
     p_list.add_argument("--all", action="store_true", help="Show all sessions including deleted")
     p_list.add_argument("--json", action="store_true", help="Output as JSON")
+    p_list_folders = p_list.add_mutually_exclusive_group()
+    p_list_folders.add_argument(
+        "--top", type=int, metavar="N", default=None,
+        help="Show top N other folders per session (default: 3). Use --all-folders for everything.",
+    )
+    p_list_folders.add_argument(
+        "--all-folders", action="store_true",
+        help="Show every tracked folder per session (no cap).",
+    )
 
     # status
     p_status = sub.add_parser("status", help="Summary of sessions, deletions, git state")
@@ -172,12 +181,64 @@ def build_parser():
     p_resume.add_argument("session_id", help="Session ID (prefix match supported)")
 
     # scan
-    p_scan = sub.add_parser("scan", help="Find sessions in current directory and children")
+    p_scan = sub.add_parser(
+        "scan",
+        help="Find sessions by term, location, or both",
+        description=(
+            "Find sessions by term, location, or both.\n\n"
+            "  csb scan                  cwd path-prefix (today's default)\n"
+            "  csb scan <term>           broad metadata substring (name, project, folder paths)\n"
+            "  csb scan ./dirname        shortcut: same as -d dirname (no flag to remember)\n"
+            "  csb scan -d <pattern>     path-strict: folder + descendants (start_folder OR top-N folder_usage)\n"
+            "  csb scan -D <pattern>     path-strict: this folder only (no descendants)\n"
+            "  csb scan -s <pattern>     start_folder only: 'what sessions originated here?' (skips folder_usage)\n"
+            "  csb scan -d|-D|-s <pat> <term>   scope-then-filter combined\n\n"
+            "Patterns accept a trailing '*' for sibling-prefix expansion (amdead* matches amdead, amdead-fork, ...)."
+        ),
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
     _add_common_flags(p_scan)
-    p_scan.add_argument("path", nargs="?", default=".", help="Root path to scan (default: current directory)")
+    p_scan.add_argument(
+        "term", nargs="?", default=None,
+        help="Filter sessions whose name, project, or folder paths contain term (case-insensitive). "
+             "If this starts with `./` or `.\\` (or is a bare `.`), it's auto-promoted to implicit -d.",
+    )
+    p_scan.add_argument(
+        "term2", nargs="?", default=None,
+        help="Optional second positional. Only valid when the first positional is a "
+             "`./dirname` / `.\\dirname` shortcut -- in that case `term2` is the actual term "
+             "filter (equivalent to `csb scan -d dirname term2`). Otherwise rejected.",
+    )
     p_scan.add_argument("-n", type=int, default=20, help="Number of sessions to show")
-    p_scan.add_argument("--no-usage", "-NU", action="store_true",
-                        help="Only match by project start folder, skip folder usage search")
+    p_scan.add_argument(
+        "--no-usage", "-NU", action="store_true",
+        help="Skip folder_usage match; only consider session start_folder",
+    )
+    # -d / -D / -s mutually exclusive: path-strict modes
+    p_scan_dir = p_scan.add_mutually_exclusive_group()
+    p_scan_dir.add_argument(
+        "-d", "--directories-below", metavar="PATTERN", default=None,
+        help="Path-strict: match this folder + its descendants. Trailing '*' for sibling-prefix.",
+    )
+    p_scan_dir.add_argument(
+        "-D", "--directory-only", metavar="PATTERN", default=None,
+        help="Path-strict: match this folder only, no descendants. Trailing '*' for sibling-prefix.",
+    )
+    p_scan_dir.add_argument(
+        "-s", "--start-dir-only", metavar="PATTERN", default=None,
+        help="Path-strict: only match sessions whose start_folder is this folder + descendants. "
+             "Skips folder_usage entirely. Useful for 'what sessions originated from here?'",
+    )
+    # --top / --all-folders mutually exclusive: display + folder_usage matching gate
+    p_scan_folders = p_scan.add_mutually_exclusive_group()
+    p_scan_folders.add_argument(
+        "--top", type=int, metavar="N", default=None,
+        help="Show top N other folders per session (default: 3). Also gates -d/-D folder_usage matching.",
+    )
+    p_scan_folders.add_argument(
+        "--all-folders", action="store_true",
+        help="Show every tracked folder per session (no cap). Also removes top-N gate from -d/-D matching.",
+    )
 
     # search
     p_search = sub.add_parser("search", help="Search session metadata")