@theglitchking/babel-fish 2.4.0 → 2.4.1

package/.claude/project-map/generate.py

@@ -44,6 +44,24 @@ PROJECT_ROOT = MAP_DIR.parent.parent
 
 SECTIONS_DIR.mkdir(parents=True, exist_ok=True)
 
+
+def configure_paths(project_root: Path) -> None:
+    """Point every output at <project_root>/.claude/project-map/.
+
+    --project-root previously moved only the READ root: the map was written back
+    into whichever directory the script itself lived in, so mapping another
+    project produced nothing for the target and destroyed the script repo's own
+    map. Writes follow the root now.
+    """
+    global PROJECT_ROOT, MAP_DIR, SECTIONS_DIR, CHECKSUMS, LEARNED_VOC, GLOSSARY
+    PROJECT_ROOT = project_root
+    MAP_DIR      = project_root / '.claude' / 'project-map'
+    SECTIONS_DIR = MAP_DIR / 'sections'
+    CHECKSUMS    = MAP_DIR / 'checksums.json'
+    LEARNED_VOC  = MAP_DIR / 'learned-vocabulary.json'
+    GLOSSARY     = MAP_DIR / 'glossary.json'
+    SECTIONS_DIR.mkdir(parents=True, exist_ok=True)
+
 # ── Secrets guard ────────────────────────────────────────────────────────────
 SECRET_PATTERNS = re.compile(
     r'(?i)(password|secret|token|api_key|apikey|private_key|auth_token|'
@@ -1612,9 +1630,8 @@ def main() -> None:
     parser.add_argument('--stack-json', type=Path, default=None, help='Path to stack.json from detect-stack.sh')
     args = parser.parse_args()
 
-    global PROJECT_ROOT
     if args.project_root:
-        PROJECT_ROOT = args.project_root.resolve()
+        configure_paths(args.project_root.resolve())
 
     print(f"[generate] Project root: {PROJECT_ROOT}")
 

package/.claude/project-map/grader.py

@@ -32,6 +32,21 @@ PROJECT_ROOT = MAP_DIR.parent.parent
 
 REPORTS_DIR.mkdir(parents=True, exist_ok=True)
 
+
+def configure_paths(project_root: Path) -> None:
+    """Grade the map belonging to project_root, not the script's own.
+
+    Previously --project-root moved only the path-validation root, so the
+    script's own sections were graded against a different project's filesystem —
+    producing a confident but meaningless score (0% vocabulary accuracy).
+    """
+    global PROJECT_ROOT, MAP_DIR, SECTIONS_DIR, REPORTS_DIR
+    PROJECT_ROOT = project_root
+    MAP_DIR      = project_root / '.claude' / 'project-map'
+    SECTIONS_DIR = MAP_DIR / 'sections'
+    REPORTS_DIR  = MAP_DIR / 'reports'
+    REPORTS_DIR.mkdir(parents=True, exist_ok=True)
+
 PASS_THRESHOLD = 90.0
 
 # ── Secret pattern (mirrors generate.py) ─────────────────────────────────────
@@ -597,9 +612,8 @@ def main() -> None:
                         help='Override report output path')
     args = parser.parse_args()
 
-    global PROJECT_ROOT
     if args.project_root:
-        PROJECT_ROOT = args.project_root.resolve()
+        configure_paths(args.project_root.resolve())
 
     print(f"[grader] Grading iteration {args.iteration}/{args.total}...")
 

package/.claude/project-map/mine-sessions.py

@@ -36,6 +36,21 @@ LEARNED_VOC  = SCRIPT_DIR / "learned-vocabulary.json"
 MINE_CURSOR  = SCRIPT_DIR / ".mine-cursor.json"
 PROJECT_ROOT = SCRIPT_DIR.parent.parent
 
+
+def configure_paths(project_root: Path) -> None:
+    """Write mined aliases into project_root's map, not the script's own.
+
+    Previously --project-root selected whose TRANSCRIPTS to mine but left the
+    output pointed at the script's directory, so mining another project wrote
+    its aliases into this one's learned vocabulary.
+    """
+    global PROJECT_ROOT, LEARNED_VOC, MINE_CURSOR
+    PROJECT_ROOT = project_root
+    map_dir      = project_root / '.claude' / 'project-map'
+    LEARNED_VOC  = map_dir / 'learned-vocabulary.json'
+    MINE_CURSOR  = map_dir / '.mine-cursor.json'
+    map_dir.mkdir(parents=True, exist_ok=True)
+
 # ── Config ───────────────────────────────────────────────────────────────────
 MIN_SCORE        = 5.0     # Minimum score to include in vocabulary
 RECENCY_WINDOWS  = [       # (days_threshold, weight)
@@ -466,9 +481,8 @@ def main() -> None:
                         help='Ignore the incremental cursor and re-mine every transcript')
     args = parser.parse_args()
 
-    global PROJECT_ROOT
     if args.project_root:
-        PROJECT_ROOT = args.project_root.resolve()
+        configure_paths(args.project_root.resolve())
 
     print(f"[mine-sessions] Project root: {PROJECT_ROOT}")
 

package/.claude/project-map/test_generate.py

@@ -237,6 +237,39 @@ def test_glossary_survives_foreign_project_root(g):
     assert data["source"].endswith("01-vocabulary.md"), data["source"]
 
 
+# ── --project-root write path (#15) ──────────────────────────────────────────
+
+def test_project_root_relocates_every_output(g):
+    """--project-root used to move only the READ root: the map was written back
+    into the script's own directory, so the target got nothing and the script
+    repo's map was destroyed."""
+    target = g.PROJECT_ROOT / "elsewhere"
+    (target / "src").mkdir(parents=True)
+    (target / "src" / "app.py").write_text("# app\n")
+
+    script_owned = g.MAP_DIR
+    g.configure_paths(target)
+
+    assert g.PROJECT_ROOT == target
+    for name in ("MAP_DIR", "SECTIONS_DIR", "CHECKSUMS", "LEARNED_VOC", "GLOSSARY"):
+        p = getattr(g, name)
+        assert str(p).startswith(str(target)), f"{name} still outside the target: {p}"
+        assert not str(p).startswith(str(script_owned)), f"{name} still in the script dir: {p}"
+    assert g.SECTIONS_DIR.is_dir(), "sections dir not created under the target"
+
+
+def test_project_root_writes_land_in_the_target(g):
+    import json
+    target = g.PROJECT_ROOT / "elsewhere"
+    target.mkdir(parents=True)
+    g.configure_paths(target)
+    g.write_glossary([{"alias": "x", "type": "feature",
+                       "location": "src/x.py", "notes": "n"}], g.load_stack())
+    written = target / ".claude" / "project-map" / "glossary.json"
+    assert written.exists(), "glossary.json was not written under the target"
+    assert json.loads(written.read_text())["entry_count"] == 1
+
+
 def main() -> int:
     tests = [v for k, v in sorted(globals().items()) if k.startswith("test_")]
     failed = []

package/.claude/project-map/test_grader.py

@@ -136,6 +136,22 @@ def test_generate_emits_prose_not_a_row_for_empty_vocab():
     assert "No vocabulary generated yet" in out
 
 
+def test_project_root_relocates_grader_paths(tmp):
+    """The grader used to read its OWN sections while validating paths against
+    a different project — a confident but meaningless score."""
+    g = load_grader(tmp)
+    target = tmp / "elsewhere"
+    target.mkdir(parents=True)
+    script_owned = g.SECTIONS_DIR
+    g.configure_paths(target)
+    assert g.PROJECT_ROOT == target
+    for name in ("MAP_DIR", "SECTIONS_DIR", "REPORTS_DIR"):
+        p = getattr(g, name)
+        assert str(p).startswith(str(target)), f"{name} outside target: {p}"
+        assert p != script_owned, f"{name} still the script's: {p}"
+    assert g.REPORTS_DIR.is_dir()
+
+
 def main() -> int:
     import inspect
     tests = [v for k, v in sorted(globals().items()) if k.startswith("test_")]

package/.claude/project-map/test_mine_sessions.py

@@ -172,6 +172,19 @@ def test_junk_phrases_filtered(m, root):
     assert not any("," in g or ":" in g for g in got), got
 
 
+def test_project_root_relocates_miner_output(m, root):
+    """Mining another project used to write its aliases into THIS project's
+    learned vocabulary."""
+    target = root / "elsewhere"
+    target.mkdir(parents=True)
+    m.configure_paths(target)
+    assert m.PROJECT_ROOT == target
+    for name in ("LEARNED_VOC", "MINE_CURSOR"):
+        p = getattr(m, name)
+        assert str(p).startswith(str(target)), f"{name} outside target: {p}"
+    assert m.LEARNED_VOC.parent.is_dir()
+
+
 def main() -> int:
     import inspect
     tests = [v for k, v in sorted(globals().items()) if k.startswith("test_")]

package/.claude-plugin/marketplace.json

@@ -6,13 +6,13 @@
   },
   "metadata": {
     "description": "Official marketplace for babel-fish - Codebase introspection and vocabulary translation for AI coding assistants",
-    "version": "2.4.0"
+    "version": "2.4.1"
   },
   "plugins": [
     {
       "name": "babel-fish",
       "description": "Auto-generates a project map, vocabulary translation layer, and developer skill for any codebase. Introspects routes, models, services, features, infrastructure, and session history to give Claude instant full-stack context. Self-updates via pre-commit hook.",
-      "version": "2.4.0",
+      "version": "2.4.1",
       "author": {
         "name": "TheGlitchKing"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "babel-fish",
   "description": "Auto-generates a project map, vocabulary translation layer, and developer skill for any codebase. Introspects routes, models, services, features, infrastructure, and session history to give Claude instant full-stack context. Self-updates via pre-commit hook.",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "author": {
     "name": "TheGlitchKing",
     "email": "theglitchking@users.noreply.github.com"

package/CHANGELOG.md

@@ -2,6 +2,36 @@
 
 All notable changes to this project will be documented in this file.
 
+## [2.4.1] - 2026-09-04
+
+### Fixed
+
+- **`--project-root` changed only the read root**
+  ([#15](https://github.com/TheGlitchKing/babel-fish/issues/15)). All three
+  scripts kept writing to the directory the script itself lives in, so pointing
+  the flag at another project silently corrupted the script's own map instead of
+  mapping the target:
+
+  - `generate.py` wrote the map into its own directory — the target got nothing,
+    and the script repo's `sections/`, `glossary.json` and `checksums.json` were
+    overwritten, while the run reported success.
+  - `grader.py` graded its **own** sections while validating vocabulary paths
+    against the **target's** filesystem, producing a confident but meaningless
+    score (0% vocabulary accuracy, 77% FAIL). The nastiest of the three: it
+    neither crashed nor produced nothing.
+  - `mine-sessions.py` mined the target's transcripts and wrote the aliases into
+    its own `learned-vocabulary.json` and `.mine-cursor.json`.
+
+  Each script gained `configure_paths()`, called from `main()` after argument
+  parsing, which relocates every output under `<project-root>/.claude/project-map/`.
+  Module-level defaults are unchanged, so the common case and the test suites
+  are unaffected.
+
+  Not reachable during install: `.claude/install.sh` runs the copied scripts
+  inside the target, where `SCRIPT_DIR` and `--project-root` coincide. The
+  pre-commit hook and `babel-fish regen` / `grade` pass no `--project-root`.
+  Verified by a full install after the change.
+
 ## [2.4.0] - 2026-09-04
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theglitchking/babel-fish",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "description": "Gives your AI coding assistant instant, accurate knowledge of every route, model, service, feature, and infrastructure element in your codebase.",
   "type": "module",
   "bin": {