Function collect_status

src/codex_self_evolution/diagnostics.py:49–78

Assemble the full diagnostic snapshot. Raises nothing. ``recent_window_hours`` bounds the plugin.log scan — only entries newer than ``now - window`` contribute to the recent-activity aggregate. 24h is the default because the log rotates daily, so a full active-day view fits in exact

(
    home: str | Path | None = None,
    recent_window_hours: float = 24.0,
)

def collect_status(
    home: str | Path | None = None,
    recent_window_hours: float = 24.0,
) -> dict[str, Any]:
    """Assemble the full diagnostic snapshot. Raises nothing.

    ``recent_window_hours`` bounds the plugin.log scan — only entries newer
    than ``now - window`` contribute to the recent-activity aggregate. 24h
    is the default because the log rotates daily, so a full active-day view
    fits in exactly one file without the scanner stitching across rotations.
    """
    home_dir = Path(home).expanduser().resolve() if home else get_home_dir()
    legacy_hooks = _check_hooks()
    return {
        "timestamp": datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ"),
        "home": str(home_dir),
        # Backwards-compatible alias for one release. New consumers should use
        # legacy_user_hooks for ~/.codex/hooks.json and plugin_hooks for the
        # bundled plugin metadata path.
        "hooks": legacy_hooks,
        "legacy_user_hooks": legacy_hooks,
        "plugin_hooks": _check_plugin_hook_bundle(),
        "scheduler": _check_scheduler(),
        "skill_synthesis": _check_skill_synthesis(home_dir),
        "skills": _check_skill_counts(),
        "env_provider": _check_env_provider(home_dir),
        "tools": _check_tools(),
        "buckets": _list_buckets(home_dir),
        "recent_activity": _recent_activity(home_dir, window_hours=recent_window_hours),
    }


# ---------- hooks --------------------------------------------------------