fix(agents): claude follows CLAUDE_CONFIG_DIR (Issue #31, review)

CLAUDE_CONFIG_DIR moves claude's whole config root, sessions/ included, so a
live session started under it was not seen and a stopped one left
file-history and the rest behind. The config root is now CLAUDE_CONFIG_DIR,
else <home>/.claude; the purge and residual scans look at ctx.claude_dir and
the root's own projects/, each once. The test guard drops the variable for
every test like the other agent-home variables (test_issue55 l1 requires
every *_DIR the adapters read to be accounted for).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

.agents/skills/lib_py/agents/adapters/claude.py

@@ -5,7 +5,21 @@ from lib_py.verify_session import workspace_key
 
 
 def _config_dir(ctx: DiscoveryContext) -> str:
-    return os.path.join(ctx.home_dir, ".claude")
+    """claude's config root: CLAUDE_CONFIG_DIR moves all of it (sessions/,
+    file-history/, session-env/, jobs/, projects/)."""
+    return os.environ.get("CLAUDE_CONFIG_DIR") or os.path.join(ctx.home_dir, ".claude")
+
+
+def _projects_dirs(ctx: DiscoveryContext) -> list:
+    """ctx.claude_dir (CLAUDE_PROJECT_DIR, else <home>/.claude/projects) and
+    the config root's own projects/, each once."""
+    dirs, seen = [], set()
+    for d in (ctx.claude_dir, os.path.join(_config_dir(ctx), "projects")):
+        real = os.path.realpath(d)
+        if real not in seen:
+            seen.add(real)
+            dirs.append(d)
+    return dirs
 
 
 def _tmp_roots() -> list:
@@ -211,10 +225,12 @@ class ClaudeAgentAdapter(BaseAgentAdapter):
         if not _plausible_id(uuid):
             return []
         cfg = _config_dir(ctx)
-        jsonl = self.artifact_path(uuid, ctx)
+        paths = []
-        paths = [p for p in (jsonl, jsonl[:-len(".jsonl")],
+        for pdir in _projects_dirs(ctx):
-                             os.path.join(cfg, "file-history", uuid),
+            base = os.path.join(pdir, ctx.ws_key, uuid)
-                             os.path.join(cfg, "session-env", uuid)) if os.path.lexists(p)]
+            paths += [p for p in (base + ".jsonl", base) if os.path.lexists(p)]
+        paths += [p for p in (os.path.join(cfg, "file-history", uuid),
+                              os.path.join(cfg, "session-env", uuid)) if os.path.lexists(p)]
         job = self._owned_job(uuid, ctx)
         if job:
             paths.append(job)
@@ -264,20 +280,22 @@ class ClaudeAgentAdapter(BaseAgentAdapter):
         if not _plausible_id(uuid):
             return []
         cfg = _config_dir(ctx)
-        found = set(scan_names(cfg, uuid, skip=(os.path.join(cfg, "projects"), ctx.claude_dir)))
+        pdirs = _projects_dirs(ctx)
-        try:
+        found = set(scan_names(cfg, uuid, skip=pdirs))
-            keys = sorted(os.listdir(ctx.claude_dir))
+        for pdir in pdirs:
-        except OSError:
+            try:
-            keys = []
+                keys = sorted(os.listdir(pdir))
-        for key in keys:
+            except OSError:
-            kdir = os.path.join(ctx.claude_dir, key)
+                keys = []
-            if uuid in key:
+            for key in keys:
-                found.add(kdir)
+                kdir = os.path.join(pdir, key)
-            elif os.path.isdir(kdir):
+                if uuid in key:
-                try:
+                    found.add(kdir)
-                    found.update(os.path.join(kdir, n) for n in os.listdir(kdir) if uuid in n)
+                elif os.path.isdir(kdir):
-                except OSError:
+                    try:
-                    pass
+                        found.update(os.path.join(kdir, n) for n in os.listdir(kdir) if uuid in n)
+                    except OSError:
+                        pass
         job = self._owned_job(uuid, ctx)
         if job:
             found.add(job)

tests/_agent_home_guard.py

@@ -18,7 +18,7 @@ import tempfile
 
 # The pane-inherited variables conftest._isolate_agent_homes drops for every
 # test, so HOME (which the tests set) governs, as it does in a plain shell.
-DROPPED_VARS = ("HOME_DIR", "CLAUDE_PROJECT_DIR", "CODEX_HOME", "LOCAL_BIN")
+DROPPED_VARS = ("HOME_DIR", "CLAUDE_PROJECT_DIR", "CLAUDE_CONFIG_DIR", "CODEX_HOME", "LOCAL_BIN")
 # Read by the code under test but left alone, on purpose: HOME is where the
 # real herdr tests and the shim bootstrap find the server socket, and it is
 # what the suite's own tests set for an isolated home; XDG_CONFIG_HOME and