feat: add granular feature switches

Author: T0UGH

README.md

@@ -141,6 +141,8 @@ csep recall --recent
 
 `session-start`、`session-stop`、`session-archive`、`session-ingest` 主要给 hook 和底层排障使用。完整列表见 [docs/getting-started.md](docs/getting-started.md)。
 
+三条主线可在 `~/.codex-self-evolution/config.toml` 里独立关闭：`[stable_memory] enabled = false` 关闭启动记忆注入，`[session_recall] enabled = false` 关闭 recall policy / 查询 / Stop 归档，`[session_reflection] enabled = false` 关闭后台 reflection worker。需要更细时，还可以用 `session_recall.session_start_policy`、`session_recall.manual_query`、`session_recall.stop_hook_archive`、`session_reflection.trigger.memory_review`、`session_reflection.trigger.skill_review` 分别控制子能力。
+
 ## 性能和运行方式
 
 `SessionStart` / `Stop` 前台只做轻量文件读写、归档触发和状态判断；模型 reflection 在后台运行，不阻塞 Codex 正常退出。

docs/getting-started.md

@@ -55,6 +55,9 @@ csep config validate
 ```toml
 schema_version = 2
 
+[stable_memory]
+enabled = true
+
 [session_reflection]
 enabled = true
 backend = "codex-app-server"
@@ -68,6 +71,8 @@ max_concurrent_jobs = 1
 
 [session_reflection.trigger]
 enabled = true
+memory_review = true
+skill_review = true
 memory_stop_interval = 3
 memory_context_chars = 16000
 skill_tool_call_interval = 15
@@ -77,6 +82,8 @@ active_job_stale_seconds = 1800
 
 [session_recall]
 enabled = true
+session_start_policy = true
+manual_query = true
 stop_hook_archive = true
 
 [log]
@@ -85,6 +92,20 @@ retention_days = 14
 
 默认的 `sandbox = "danger-full-access"` 和 `approval_policy = "never"` 是为了让后台 reflection 能无阻塞完成写入和 receipt 落盘。它的信任边界不在 child 自述，而在父进程的 receipt validation：路径、hash、job identity、memory root 和 `csep-reflect-*` skill namespace 都会被校验。低信任或共享环境可以调低这两个值，但后台 reflection 可能因此需要人工确认或无法完成。
 
+三条主线都可以独立关闭：
+
+- `[stable_memory] enabled = false`：`SessionStart` 不读取或注入 `MEMORY.md`。
+- `[session_recall] enabled = false`：`SessionStart` 不注入 recall policy，`csep recall` 返回空结果，`Stop` hook 不归档 transcript。
+- `[session_reflection] enabled = false`：`Stop` hook 不再创建后台 reflection job。
+
+也可以只关子能力：
+
+- `session_recall.session_start_policy = false`：保留 recall 数据库和手动查询，但启动时不注入 recall policy。
+- `session_recall.manual_query = false`：保留 Stop 归档，但 `csep recall` 不读库。
+- `session_recall.stop_hook_archive = false`：保留手动查询已有库，但 Stop hook 不再归档新 transcript。
+- `session_reflection.trigger.memory_review = false`：trigger 不再因为 memory counter / memory keyword 创建 memory review。
+- `session_reflection.trigger.skill_review = false`：trigger 不再因为 tool counter / skill keyword 创建 skill review。
+
 ## 3. 检查 Codex Plugin Hooks
 
 `csep setup` 会写入或更新 `~/.codex/config.toml`：

docs/session-reflection.md

@@ -122,6 +122,9 @@ Parent 校验：
 核心配置：
 
 ```toml
+[stable_memory]
+enabled = true
+
 [session_reflection]
 enabled = true
 backend = "codex-app-server"
@@ -135,6 +138,8 @@ max_concurrent_jobs = 1
 
 [session_reflection.trigger]
 enabled = true
+memory_review = true
+skill_review = true
 memory_stop_interval = 3
 memory_context_chars = 16000
 skill_tool_call_interval = 15

src/codex_self_evolution/config_file.py

@@ -11,12 +11,24 @@
 from .config import DEFAULT_LOCK_STALE_SECONDS, REFLECT_SKILL_PREFIX
 
 
+@dataclass
+class StableMemoryConfig:
+    """SessionStart stable memory injection configuration."""
+
+    # Whether SessionStart reads and injects project MEMORY.md.
+    enabled: bool = True
+
+
 @dataclass
 class SessionReflectionTriggerConfig:
     """Deterministic Stop-hook trigger policy configuration."""
 
     # Whether Stop-hook trigger evaluation is active.
     enabled: bool = True
+    # Whether trigger policy may request memory review.
+    memory_review: bool = True
+    # Whether trigger policy may request skill review.
+    skill_review: bool = True
     # Number of Stop events between memory-reflection nudges.
     memory_stop_interval: int = 3
     # Maximum transcript context sent to the memory-reflection decision path.
@@ -63,6 +75,10 @@ class SessionRecallConfig:
 
     # Whether focused recall and archive storage are enabled.
     enabled: bool = True
+    # Whether SessionStart injects the recall policy pointer.
+    session_start_policy: bool = True
+    # Whether manual `csep recall` queries may read the recall store.
+    manual_query: bool = True
     # Whether the Stop hook archives transcripts into session recall.
     stop_hook_archive: bool = True
 
@@ -81,6 +97,8 @@ class PluginConfig:
 
     # Configuration schema version supported by this loader.
     schema_version: int = 2
+    # Stable Memory startup injection configuration.
+    stable_memory: StableMemoryConfig = field(default_factory=StableMemoryConfig)
     # Session reflection worker and trigger configuration.
     session_reflection: SessionReflectionConfig = field(default_factory=SessionReflectionConfig)
     # Session recall archive and recall configuration.
@@ -116,13 +134,16 @@ class LoadResult:
 
 _KNOWN_TOP_LEVEL_KEYS = {
     "schema_version",
+    "stable_memory",
     "session_reflection",
     "session_recall",
     "log",
 }
 
 _KNOWN_PATHS = {
     "schema_version",
+    "stable_memory",
+    "stable_memory.enabled",
     "session_reflection",
     "session_reflection.enabled",
     "session_reflection.backend",
@@ -135,6 +156,8 @@ class LoadResult:
     "session_reflection.max_concurrent_jobs",
     "session_reflection.trigger",
     "session_reflection.trigger.enabled",
+    "session_reflection.trigger.memory_review",
+    "session_reflection.trigger.skill_review",
     "session_reflection.trigger.memory_stop_interval",
     "session_reflection.trigger.memory_context_chars",
     "session_reflection.trigger.skill_tool_call_interval",
@@ -143,6 +166,8 @@ class LoadResult:
     "session_reflection.trigger.active_job_stale_seconds",
     "session_recall",
     "session_recall.enabled",
+    "session_recall.session_start_policy",
+    "session_recall.manual_query",
     "session_recall.stop_hook_archive",
     "log",
     "log.retention_days",
@@ -199,6 +224,15 @@ def load_config(
     sources = _default_sources(config)
     sources["schema_version"] = "config.toml" if "schema_version" in raw_toml else "default"
 
+    stable_memory_toml = _table(raw_toml, "stable_memory", warnings)
+    _apply_bool(
+        config.stable_memory,
+        "enabled",
+        stable_memory_toml,
+        "stable_memory.enabled",
+        sources,
+    )
+
     reflection_toml = _table(raw_toml, "session_reflection", warnings)
     _apply_bool(
         config.session_reflection,
@@ -278,6 +312,20 @@ def load_config(
         "session_reflection.trigger.enabled",
         sources,
     )
+    _apply_bool(
+        config.session_reflection.trigger,
+        "memory_review",
+        trigger_toml,
+        "session_reflection.trigger.memory_review",
+        sources,
+    )
+    _apply_bool(
+        config.session_reflection.trigger,
+        "skill_review",
+        trigger_toml,
+        "session_reflection.trigger.skill_review",
+        sources,
+    )
     for field_name in (
         "memory_stop_interval",
         "memory_context_chars",
@@ -352,6 +400,20 @@ def load_config(
         "session_recall.enabled",
         sources,
     )
+    _apply_bool(
+        config.session_recall,
+        "session_start_policy",
+        recall_toml,
+        "session_recall.session_start_policy",
+        sources,
+    )
+    _apply_bool(
+        config.session_recall,
+        "manual_query",
+        recall_toml,
+        "session_recall.manual_query",
+        sources,
+    )
     _apply_bool(
         config.session_recall,
         "stop_hook_archive",

src/codex_self_evolution/config_file_template.py

@@ -8,6 +8,9 @@
 
 schema_version = 2
 
+[stable_memory]
+enabled = true
+
 [session_reflection]
 enabled = true
 backend = "codex-app-server"
@@ -21,6 +24,8 @@
 
 [session_reflection.trigger]
 enabled = true
+memory_review = true
+skill_review = true
 memory_stop_interval = 3
 memory_context_chars = 16000
 skill_tool_call_interval = 15
@@ -30,6 +35,8 @@
 
 [session_recall]
 enabled = true
+session_start_policy = true
+manual_query = true
 stop_hook_archive = true
 
 [log]

src/codex_self_evolution/diagnostics.py

@@ -21,6 +21,7 @@
 
 from . import __version__
 from .config import PROJECTS_SUBDIR, SESSION_REFLECTION_SUBDIR, get_home_dir
+from .config_file import ConfigError, config_to_dict, load_config
 from .session_reflection.runner import session_reflection_status
 from .session_recall.archive import default_db_path
 from .session_recall.store import SessionRecallStore
@@ -41,9 +42,11 @@ def collect_status(
 ) -> dict[str, Any]:
     """Assemble the retained diagnostic snapshot without mutating state."""
     home_dir = Path(home).expanduser().resolve() if home else get_home_dir()
+    config_status = _check_config(home_dir)
     return {
         "timestamp": datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ"),
         "home": str(home_dir),
+        "config": config_status,
         "plugin_hooks": _check_plugin_hook_bundle(),
         "stable_memory": _check_stable_memory(home_dir),
         "session_reflection": session_reflection_status(home=home_dir),
@@ -53,6 +56,46 @@ def collect_status(
     }
 
 
+def _check_config(home_dir: Path) -> dict[str, Any]:
+    """Return resolved feature-switch status without leaking sensitive values."""
+    try:
+        loaded = load_config(home=home_dir)
+    except ConfigError as exc:
+        return {
+            "status": "parse_error",
+            "error": str(exc),
+            "feature_switches": None,
+        }
+    resolved = config_to_dict(loaded.config)
+    return {
+        "status": "ok" if not loaded.warnings else "warnings",
+        "config_path": str(loaded.config_path),
+        "config_exists": loaded.config_exists,
+        "feature_switches": {
+            "stable_memory": bool(resolved["stable_memory"]["enabled"]),
+            "session_recall": bool(resolved["session_recall"]["enabled"]),
+            "session_reflection": bool(resolved["session_reflection"]["enabled"]),
+        },
+        "sub_switches": {
+            "session_recall.session_start_policy": bool(
+                resolved["session_recall"]["session_start_policy"]
+            ),
+            "session_recall.manual_query": bool(resolved["session_recall"]["manual_query"]),
+            "session_recall.stop_hook_archive": bool(resolved["session_recall"]["stop_hook_archive"]),
+            "session_reflection.trigger.enabled": bool(
+                resolved["session_reflection"]["trigger"]["enabled"]
+            ),
+            "session_reflection.trigger.memory_review": bool(
+                resolved["session_reflection"]["trigger"]["memory_review"]
+            ),
+            "session_reflection.trigger.skill_review": bool(
+                resolved["session_reflection"]["trigger"]["skill_review"]
+            ),
+        },
+        "warnings": loaded.warnings,
+    }
+
+
 def _check_plugin_hook_bundle(plugin_root: Path | None = None) -> dict[str, Any]:
     root = plugin_root or _default_plugin_root()
     manifest_path = root / ".codex-plugin" / "plugin.json"

src/codex_self_evolution/hooks/session_start.py

@@ -4,35 +4,47 @@
 from typing import Any
 
 from ..config import PACKAGE_ROOT, build_paths
+from ..config_file import load_config
 from ..storage import ensure_runtime_dirs, load_stable_memory, repo_fingerprint
 
 
 def session_start(cwd: str | Path | None = None, state_dir: str | Path | None = None) -> dict:
     paths = build_paths(repo_root=cwd, state_dir=state_dir)
-    ensure_runtime_dirs(paths)
-    policy = (PACKAGE_ROOT / "session_recall" / "policy.md").read_text(encoding="utf-8")
-    memory_text = load_stable_memory(paths)
-    combined_prefix = "\n\n".join(
-        section
-        for section in [
+    config = load_config(home=Path(state_dir).expanduser().resolve() if state_dir else None).config
+    stable_memory_enabled = config.stable_memory.enabled
+    session_recall_enabled = config.session_recall.enabled
+    if stable_memory_enabled:
+        ensure_runtime_dirs(paths)
+        memory_text = load_stable_memory(paths)
+    else:
+        memory_text = ""
+    policy = ""
+    if session_recall_enabled and config.session_recall.session_start_policy:
+        policy = (PACKAGE_ROOT / "session_recall" / "policy.md").read_text(encoding="utf-8")
+    stable_background_sections = []
+    if stable_memory_enabled:
+        stable_background_sections = [
             "# Stable Background",
             "## MEMORY.md\n" + (memory_text or "_No entries yet._\n"),
         ]
-        if section
+    combined_prefix = "\n\n".join(
+        section for section in stable_background_sections if section
     )
     return {
         "hook": "SessionStart",
         "cwd": str(paths.repo_root),
         "repo_fingerprint": repo_fingerprint(paths.repo_root),
         "state_dir": str(paths.state_dir),
         "stable_background": {
+            "enabled": stable_memory_enabled,
             "current_memory_md": memory_text,
             "memory_path": str(paths.memory_dir / "MEMORY.md"),
             "memory_refs_dir": str(paths.memory_refs_dir),
             "legacy_user_md_ignored": (paths.memory_dir / "USER.md").exists(),
             "combined_prefix": combined_prefix,
         },
         "recall": {
+            "enabled": session_recall_enabled,
             "policy": policy,
             "skill": {
                 "skill_id": "csep-session-recall",

src/codex_self_evolution/session_recall/workflow.py

@@ -30,8 +30,8 @@ def build_focused_recall(
 ) -> dict[str, Any]:
     """Build model-readable recall from the session_recall SQLite/FTS store only."""
     scope = "global" if global_scope else "repo"
-    config = load_config().config
-    if not config.session_recall.enabled:
+    config = load_config(home=Path(state_dir).expanduser().resolve() if state_dir else None).config
+    if not config.session_recall.enabled or not config.session_recall.manual_query:
         return _empty_payload(query=query, scope=scope)
 
     db_path = default_db_path(state_dir=state_dir)

src/codex_self_evolution/session_reflection/state.py

@@ -112,8 +112,8 @@ def create_job_from_payload(
     if decision_provided:
         job.update(
             {
-                "review_memory": True,
-                "review_skills": True,
+                "review_memory": bool(decision.get("review_memory", True)),
+                "review_skills": bool(decision.get("review_skills", True)),
                 "trigger_reasons": list(decision.get("trigger_reasons") or []),
                 "skill_generation_mode": skill_generation_mode,
                 "covered_byte_offset": int(covered_byte_offset),