feat: unify runtime logging (rotating files, log root, scripts, desktop)

Co-authored-by: Cursor <cursoragent@cursor.com>

svc/config/log_paths.py

@@ -0,0 +1,40 @@
+"""Runtime log root (gateway / channel workers / stack scripts).
+
+Matches ``AIA_RUNTIME_LOG_DIR`` or ``<parent of assistant DB file>/logs`` — same rule as
+``runtime.operations.runtime.assistant_runtime_log_dir`` but lives under ``svc.config`` to avoid
+import cycles when HTTP or workers configure logging early.
+"""
+
+from __future__ import annotations
+
+import os
+from pathlib import Path
+
+from svc.config.paths import db_path
+
+
+def oclaw_log_root() -> Path:
+    p = str(os.getenv("AIA_RUNTIME_LOG_DIR") or "").strip()
+    if p:
+        return Path(p).expanduser().resolve()
+    return Path(db_path()).resolve().parent / "logs"
+
+
+def oclaw_hooks_log_dir(*, state_dir_if_legacy: Path) -> Path:
+    """Directory for bundled hook file logs (``command-logger``, ``boot-md``).
+
+    Default: ``oclaw_log_root() / "hooks"`` (same tree as gateway/channel ``start_service`` logs).
+
+    Set ``OCLAW_HOOK_LOG_USE_STATE_DIR=1`` to restore the legacy layout
+    ``state_dir_if_legacy / "logs"`` (typically ``~/.oclaw/logs``).
+    """
+    raw = str(os.getenv("OCLAW_HOOK_LOG_USE_STATE_DIR") or "").strip().lower()
+    if raw in ("1", "true", "yes", "on"):
+        out = state_dir_if_legacy / "logs"
+    else:
+        out = oclaw_log_root() / "hooks"
+    out.mkdir(parents=True, exist_ok=True)
+    return out
+
+
+__all__ = ["oclaw_hooks_log_dir", "oclaw_log_root"]