cctally 1.93.0 → 1.94.0

package/bin/_cctally_parser.py

@@ -2938,7 +2938,12 @@ def _build_db_parser(subparsers, name, *, help_text, xref=None):
     db_recover.add_argument(
         "--yes",
         action="store_true",
-        help="Required for --db stats (non-re-derivable; may need a re-record)",
+        help=(
+            "No longer required: --db stats is retired because stats.db is a "
+            "disposable index rebuilt from the journal (use `db rebuild --db "
+            "stats`); a pre-cutover install whose stats.db may be the only "
+            "copy of its history is repaired with `db repair --db stats --yes`"
+        ),
     )
     db_recover.set_defaults(func=c.cmd_db_recover)
     db_rebuild = db_sub.add_parser(
@@ -3046,6 +3051,50 @@ def _build_db_parser(subparsers, name, *, help_text, xref=None):
         help=argparse.SUPPRESS,
     )
     db_backup.set_defaults(func=c.cmd_db_backup)
+    db_prune = db_sub.add_parser(
+        "prune",
+        help="Reclaim retained corruption evidence the policy no longer keeps",
+        formatter_class=CLIHelpFormatter,
+        description=textwrap.dedent(
+                    """\
+                    Reclaim the quarantine incidents, forensics bundles,
+                    rebuild records and machine-written backups that the
+                    configured retention policy no longer keeps.
+
+                    Preview by default: nothing is deleted until you pass
+                    --yes. Evidence cctally cannot classify is NEVER deleted,
+                    in either mode, and the last surviving example of each
+                    distinct damage shape is always kept, for as many shapes
+                    as max_shape_examples allows.
+
+                    The policy lives at storage.artifact_retention in
+                    config.json. If it is present but malformed, this command
+                    exits 2 without deleting anything.
+
+                    Examples:
+                      cctally db prune
+                      cctally db prune --yes
+                      cctally db prune --json
+                      cctally db prune --yes --include-backups
+                    """
+                ),
+    )
+    db_prune.add_argument(
+        "--yes",
+        action="store_true",
+        help="Apply the plan (default: preview only)",
+    )
+    db_prune.add_argument(
+        "--include-backups",
+        action="store_true",
+        help="Also reclaim user-requested `cctally db backup` families",
+    )
+    db_prune.add_argument(
+        "--json",
+        action="store_true",
+        help="Emit JSON to stdout",
+    )
+    db_prune.set_defaults(func=c.cmd_db_prune)
     db_checkpoint = db_sub.add_parser(
         "checkpoint",
         help="Drain the WAL (TRUNCATE checkpoint) — fast, non-destructive",
@@ -3401,6 +3450,26 @@ def _build_stats_corruption_heal_parser(subparsers, name, *, help_text, xref=Non
     )
     worker.set_defaults(func=c.cmd_stats_corruption_heal_internal)
 
+def _build_artifact_retention_parser(subparsers, name, *, help_text, xref=None):
+    """Build the #496 S6 detached retained-artifact reclamation worker parser."""
+    c = _cctally()
+    worker = subparsers.add_parser(
+        name,
+        help=help_text,
+        formatter_class=CLIHelpFormatter,
+        description=textwrap.dedent(
+                    """\
+                    Internal subcommand: reclaim retained corruption evidence
+                    that the configured retention policy no longer keeps.
+                    Scheduled at most once a day by an ordinary successful
+                    command, and immediately whenever an interrupted sweep left
+                    a plan to finish. Always returns 0; failures are logged and
+                    remain retryable.
+                    """
+                ),
+    )
+    worker.set_defaults(func=c.cmd_artifact_retention_internal)
+
 def _build_codex_replay_drain_parser(subparsers, name, *, help_text, xref=None):
     """Build the `_codex-replay-drain` parser (public #5 §4)."""
     c = _cctally()
@@ -3504,6 +3573,7 @@ _REGISTRATION = (
     _Reg('_codex-quota-verify', _build_codex_quota_verify_parser, argparse.SUPPRESS, None, None),
     _Reg('_stats-epoch-rebuild', _build_stats_epoch_rebuild_parser, argparse.SUPPRESS, None, None),
     _Reg('_stats-corruption-heal', _build_stats_corruption_heal_parser, argparse.SUPPRESS, None, None),
+    _Reg('_artifact-retention', _build_artifact_retention_parser, argparse.SUPPRESS, None, None),
     _Reg('_codex-replay-drain', _build_codex_replay_drain_parser, argparse.SUPPRESS, None, None),
     _Reg('repair-symlinks', _build_repair_symlinks_parser, argparse.SUPPRESS, None, None),
 )

package/bin/_cctally_project.py

@@ -788,8 +788,6 @@ def cmd_project(args: argparse.Namespace) -> int:
             period_end=until_dt,
             display_tz=display_tz_str,
             version=c._share_resolve_version(),
-            theme=args.theme,
-            reveal_projects=args.reveal_projects,
         )
         c._share_render_and_emit(snap, args)
         return 0

package/bin/_cctally_record.py

@@ -5185,6 +5185,24 @@ def cmd_hook_tick(args: argparse.Namespace) -> int:
     _hook_tick_log_line(line)
     _hook_tick_log_rotate_if_needed()
 
+    # #496 S6 §5.2, the hook-tick branch. It is admitted HERE rather than from
+    # `main`'s post-command hook because the parent returns at the fork and
+    # never reaches that hook, and because the INLINE FALLBACK — `os.fork()`
+    # failed, so this body is running on Claude Code's blocking path — must not
+    # gain a spawn. `forked` is exactly that discriminator.
+    try:
+        _cctally()._load_sibling(
+            "_cctally_retention"
+        ).maybe_defer_artifact_retention(
+            command="hook-tick",
+            exit_code=0,
+            hook_forked=forked,
+            hook_explain=explain,
+            hook_foreground=foreground,
+        )
+    except Exception:
+        pass
+
     # --- Step 9: exit code ---
     if not explain:
         # Forked child: skip Python's atexit / argparse / cleanup paths

package/bin/_cctally_reporting.py

@@ -139,7 +139,6 @@ def cmd_daily(args: argparse.Namespace) -> int:
             snap = c._build_daily_snapshot(
                 view, period_start=range_start, period_end=range_end,
                 display_tz=display_tz_str, version=c._share_resolve_version(),
-                theme=args.theme, reveal_projects=args.reveal_projects,
             )
             if args.order == "desc":
                 snap = dataclasses.replace(snap, rows=tuple(reversed(snap.rows)))
@@ -249,8 +248,6 @@ def cmd_daily(args: argparse.Namespace) -> int:
             period_end=range_end,
             display_tz=display_tz_str,
             version=c._share_resolve_version(),
-            theme=args.theme,
-            reveal_projects=args.reveal_projects,
         )
         if args.order == "desc":
             snap = dataclasses.replace(snap, rows=tuple(reversed(snap.rows)))
@@ -325,8 +322,6 @@ def cmd_monthly(args: argparse.Namespace) -> int:
             period_end=range_end,
             display_tz=display_tz_str,
             version=c._share_resolve_version(),
-            theme=args.theme,
-            reveal_projects=args.reveal_projects,
         )
         if args.order == "desc":
             snap = dataclasses.replace(snap, rows=tuple(reversed(snap.rows)))
@@ -460,8 +455,6 @@ def cmd_weekly(args: argparse.Namespace) -> int:
             period_end=range_end,
             display_tz=display_tz_str,
             version=c._share_resolve_version(),
-            theme=args.theme,
-            reveal_projects=args.reveal_projects,
             breakdown_model=bool(getattr(args, "breakdown", False)),
         )
         if args.order == "desc":
@@ -618,8 +611,6 @@ def cmd_session(args: argparse.Namespace) -> int:
             period_end=range_end,
             display_tz=display_tz_str,
             version=c._share_resolve_version(),
-            theme=args.theme,
-            reveal_projects=args.reveal_projects,
             top_n=top_n,
             tz=tz,
         )