@theglitchking/babel-fish 2.5.0 → 2.6.0

package/.claude/install.sh

@@ -102,6 +102,11 @@ POST-INSTALL COMMANDS
     python .claude/project-map/context-check.py
     python .claude/project-map/context-check.py --budget 80000 --map-style
 
+  Check files land where .claude/structure.toml says (opt-in; see --help):
+    python .claude/project-map/structure-check.py              # no manifest: explains the options
+    python .claude/project-map/structure-check.py --detect     # repo facts: mode, environments, folders
+    python .claude/project-map/structure-check.py --bootstrap  # write a starting manifest (never overwrites)
+
   Re-install git hooks (if you cloned a fresh copy):
     bash .githooks/install.sh
 
@@ -125,7 +130,8 @@ KEY FILES AFTER INSTALL
   .claude/rules/project-vocabulary.md       — Auto-loaded every session
   .claude/rules/operational-runbook.md      — Edit manually to grow over time
   .claude/skills/<slug>-developer-skill/    — Your developer skill
-  .githooks/pre-commit                      — Regenerates map; checks auto-loaded context
+  .githooks/pre-commit                      — Regenerates map; checks auto-loaded context + structure
+  .claude/templates/structure/*.toml        — Layout templates (single, monorepo, multi-repo)
 
 GRADING CATEGORIES (90% to pass)
   Section completeness  25%  — All 19 sections generated
@@ -403,6 +409,28 @@ if git diff --cached --name-only 2>/dev/null | grep -qE '^(\.claude/)?CLAUDE(\.l
 fi
 # ── End Context Check ────────────────────────────────────────────────────────
 SNIPPET
+)
+
+    local structure_snippet
+    structure_snippet=$(cat <<'SNIPPET'
+# ── Structure Check: files land where .claude/structure.toml says (#22) ──────
+# Opt-in: runs only once the repo has a manifest. On Python < 3.11 it warns and passes.
+if [ -f ".claude/structure.toml" ]; then
+    CHECK_SCRIPT=".claude/project-map/structure-check.py"
+    if [ -f "$CHECK_SCRIPT" ]; then
+        PYTHON=""
+        if [ -f ".venv/bin/python3" ]; then PYTHON=".venv/bin/python3"
+        elif command -v python3 &>/dev/null; then PYTHON="python3"
+        elif command -v python &>/dev/null; then PYTHON="python"
+        fi
+        if [ -n "$PYTHON" ] && ! $PYTHON "$CHECK_SCRIPT" --staged; then
+            echo "[structure-check] Commit blocked. Each FAIL above has a fix: line -- or change .claude/structure.toml if the structure should change." >&2
+            exit 1
+        fi
+    fi
+fi
+# ── End Structure Check ──────────────────────────────────────────────────────
+SNIPPET
 )
 
     if [ ! -f "$pre_commit" ]; then
@@ -421,6 +449,12 @@ SNIPPET
     else
         ok "pre-commit hook already contains Context Check snippet"
     fi
+    if ! grep -q 'Structure Check' "$pre_commit" 2>/dev/null; then
+        { echo ""; echo "$structure_snippet"; } >> "$pre_commit"
+        ok "Added Structure Check to pre-commit hook"
+    else
+        ok "pre-commit hook already contains Structure Check snippet"
+    fi
 
     chmod +x "$pre_commit"
 
@@ -512,7 +546,7 @@ if $DRY_RUN; then
     _dry "mkdir -p $CLAUDE_DIR/rules"
     _dry "mkdir -p $CLAUDE_DIR/skills/<project>-developer-skill/"
     _dry "copy  scripts/*.sh         → $CLAUDE_DIR/scripts/"
-    _dry "copy  templates/*.template → $CLAUDE_DIR/templates/"
+    _dry "copy  templates/*.template, templates/structure/*.toml → $CLAUDE_DIR/templates/"
     _dry "copy  project-map/*.py     → $CLAUDE_DIR/project-map/"
     _dry "write $CLAUDE_DIR/project-map/PROJECT_MAP.md"
     _dry "write $CLAUDE_DIR/project-map/sections/01-vocabulary.md  (+ 18 more sections)"
@@ -545,6 +579,8 @@ if [ "$PLUGIN_SOURCE_DIR" != "$CLAUDE_DIR" ]; then
     cp -r "$PLUGIN_SOURCE_DIR/project-map/grader.py" "$CLAUDE_DIR/project-map/" 2>/dev/null || true
     cp -r "$PLUGIN_SOURCE_DIR/project-map/mine-sessions.py" "$CLAUDE_DIR/project-map/" 2>/dev/null || true
     cp -r "$PLUGIN_SOURCE_DIR/project-map/context-check.py" "$CLAUDE_DIR/project-map/" 2>/dev/null || true
+    cp -r "$PLUGIN_SOURCE_DIR/project-map/structure-check.py" "$CLAUDE_DIR/project-map/" 2>/dev/null || true
+    # Never copies .claude/structure.toml: the manifest is the repo's own data (#22).
 fi
 
 # ── Step 1: Ensure Python ─────────────────────────────────────────────────────

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

@@ -1522,6 +1522,30 @@ def write_glossary(vocab: list[dict], stack: dict) -> Path:
 # ║  PROJECT MAP TOC                                                         ║
 # ╚══════════════════════════════════════════════════════════════════════════╝
 
+def build_structure_pointer() -> list[str]:
+    """Where files go (#22): a pointer to the manifest, never a copy of it."""
+    manifest = PROJECT_ROOT / '.claude' / 'structure.toml'
+    if not manifest.is_file():
+        return []
+    lines = [
+        "",
+        "## Repo Structure\n",
+        "Where files go — approved folders, environments, related repos: "
+        "`.claude/structure.toml`. Checked on commit by `structure-check.py`.",
+    ]
+    try:
+        import tomllib
+        m = tomllib.loads(manifest.read_text(encoding='utf-8'))
+    except Exception:  # Python < 3.11 or a broken manifest: the pointer alone still helps
+        return lines
+    repos = [r for r in m.get('repo', []) if isinstance(r, dict)]
+    if repos:
+        lines.append("\nRelated repos — each keeps its own map:\n")
+        lines += [f"- **{r.get('name', '?')}** `{r.get('path') or r.get('url', '')}`"
+                  + (f" — {r['purpose']}" if r.get('purpose') else '') for r in repos]
+    return lines
+
+
 def build_project_map(
     stack: dict,
     routes: list[dict],
@@ -1596,6 +1620,7 @@ def build_project_map(
         when = WHEN_TO_READ.get(num, '')
         lines.append(f"| [{num}](sections/{path.name}) | {display} | {size_kb:.1f} KB | {when} |")
 
+    lines += build_structure_pointer()
     lines += [
         "",
         "## Quick Routing\n",