@theglitchking/babel-fish 1.0.1 → 2.0.0

package/.claude/project-map/sections/18-dead-code.md

@@ -0,0 +1,9 @@
+# Section 18 — Dead Code Candidates
+
+
+> Files flagged for human review: no recent commits AND low vocabulary score.
+
+> **Do not auto-delete.** Review before removing.
+
+
+_No dead code candidates detected._

package/.claude/project-map/sections/19-doc-pointers.md

@@ -0,0 +1,5 @@
+# Section 19 — Documentation Pointers
+
+
+- [`CLAUDE.md`](CLAUDE.md)
+- [`README.md`](README.md)

package/.claude/project-map/stack.json

@@ -0,0 +1,12 @@
+{
+  "name": "babel-fish",
+  "slug": "babel-fish",
+  "language": "unknown",
+  "framework": "unknown",
+  "database": "unknown",
+  "orm": "unknown",
+  "auth": "unknown",
+  "package_manager": "unknown",
+  "infrastructure": "none",
+  "project_root": "/mnt/e/the-glitch-kingdom/babel-fish"
+}

package/.claude/rules/operational-runbook.md

@@ -0,0 +1,40 @@
+# babel-fish — Operational Runbook
+
+> Auto-loaded every session. Contains operational knowledge that cannot be derived from code.
+> This file grows over time as the team discovers gotchas, quirks, and procedures.
+> **Edit this file manually** — it is NOT overwritten on regeneration.
+
+## Environment Differences
+
+<!-- TODO: Document how dev/staging/prod differ (DB, deploy method, secrets, URLs) -->
+
+| | Dev | Staging | Production |
+|---|---|---|---|
+| **URL** | | | |
+| **Database** | | | |
+| **Deploy** | | | |
+| **Secrets** | | | |
+
+## Known Issues & Workarounds
+
+<!-- This section fills in naturally. When you hit a non-obvious issue, add it here. -->
+<!-- Examples: "HMR doesn't work on WSL2", "port 6543 breaks migrations" -->
+
+_No known issues documented yet. When you encounter a non-obvious problem and its solution, add it here so future sessions don't re-discover it._
+
+## Deploy Procedures
+
+<!-- TODO: Document how to deploy to each environment -->
+
+## Key Commands
+
+| Command | What It Does |
+|---------|-------------|
+| `python .claude/project-map/generate.py --force` | Force-regenerate project map |
+| `python .claude/project-map/grader.py` | Grade map quality (0-100%) |
+| `bash .githooks/install.sh` | (Re)install git hooks |
+| `bash .claude/install.sh` | Re-run full plugin installer |
+
+## Dev Credentials
+
+<!-- Add test/dev credentials here (NEVER production secrets) -->

package/.claude/rules/project-vocabulary.md

@@ -0,0 +1,25 @@
+# babel-fish — Project Vocabulary
+
+> Auto-loaded every session. Maps human language to exact code locations.
+> Regenerated automatically via pre-commit hook. Do not edit the auto-generated rows.
+
+## Feature → Code Location
+
+| You Say | Frontend | Backend | Model/Table |
+|---------|----------|---------|-------------|
+| _(vocabulary populates as source code is added)_ | | | |
+
+## Infrastructure Vocabulary
+
+| You Say | What It Is | Key Details |
+|---------|-----------|-------------|
+| project | babel-fish | unknown / unknown stack |
+
+## Quick Actions
+
+| You Say | What To Do |
+|---------|-----------|
+| regenerate map | `python .claude/project-map/generate.py --force` |
+| grade map | `python .claude/project-map/grader.py` |
+| view project map | `cat .claude/project-map/PROJECT_MAP.md` |
+| install hooks | `bash .githooks/install.sh` |

package/.claude/scripts/detect-stack.sh

@@ -0,0 +1,222 @@
+#!/bin/bash
+# detect-stack.sh — Auto-detect project stack
+# Outputs a JSON object with detected stack info to stdout
+# Usage: bash detect-stack.sh [project-root]
+
+PROJECT_ROOT="${1:-$(pwd)}"
+cd "$PROJECT_ROOT" || exit 1
+
+CYAN='\033[36m'; RESET='\033[0m'
+log() { printf '%b\n' "${CYAN}[detect]${RESET} $*" >&2; }
+
+# ── Language Detection ──────────────────────────────────────────────────────
+detect_language() {
+    local langs=()
+
+    [ -f "requirements.txt" ] || [ -f "pyproject.toml" ] || [ -f "setup.py" ] || [ -f "Pipfile" ] \
+        && langs+=("python")
+    [ -f "package.json" ] \
+        && langs+=("javascript")
+    find . -maxdepth 3 -name "*.ts" -o -name "*.tsx" 2>/dev/null | grep -q . \
+        && langs+=("typescript")
+    [ -f "go.mod" ] \
+        && langs+=("go")
+    [ -f "pom.xml" ] || [ -f "build.gradle" ] \
+        && langs+=("java")
+    [ -f "Cargo.toml" ] \
+        && langs+=("rust")
+    [ -f "composer.json" ] \
+        && langs+=("php")
+    [ -f "Gemfile" ] \
+        && langs+=("ruby")
+
+    # Primary = first detected, fallback = unknown
+    if [ ${#langs[@]} -eq 0 ]; then
+        echo "unknown"
+    else
+        echo "${langs[0]}"
+    fi
+}
+
+# ── Framework Detection ─────────────────────────────────────────────────────
+detect_framework() {
+    local lang="$1"
+
+    case "$lang" in
+        python)
+            grep -r "fastapi\|FastAPI" requirements.txt pyproject.toml setup.py 2>/dev/null | grep -q . && echo "fastapi" && return
+            grep -r "django\|Django" requirements.txt pyproject.toml setup.py 2>/dev/null | grep -q . && echo "django" && return
+            grep -r "flask\|Flask" requirements.txt pyproject.toml setup.py 2>/dev/null | grep -q . && echo "flask" && return
+            echo "python-generic"
+            ;;
+        javascript|typescript)
+            [ -f "next.config.js" ] || [ -f "next.config.ts" ] && echo "nextjs" && return
+            grep -q '"next"' package.json 2>/dev/null && echo "nextjs" && return
+            grep -q '"nuxt"' package.json 2>/dev/null && echo "nuxtjs" && return
+            grep -q '"@nestjs/core"' package.json 2>/dev/null && echo "nestjs" && return
+            grep -q '"express"' package.json 2>/dev/null && echo "express" && return
+            grep -q '"react"' package.json 2>/dev/null && echo "react" && return
+            grep -q '"vue"' package.json 2>/dev/null && echo "vue" && return
+            grep -q '"svelte"' package.json 2>/dev/null && echo "svelte" && return
+            echo "node-generic"
+            ;;
+        go)
+            grep -r "gin-gonic\|github.com/gin" go.mod 2>/dev/null | grep -q . && echo "gin" && return
+            grep -r "echo\|labstack/echo" go.mod 2>/dev/null | grep -q . && echo "echo" && return
+            grep -r "chi\|go-chi" go.mod 2>/dev/null | grep -q . && echo "chi" && return
+            echo "go-stdlib"
+            ;;
+        java)
+            grep -r "spring-boot\|springframework" pom.xml build.gradle 2>/dev/null | grep -q . && echo "spring-boot" && return
+            echo "java-generic"
+            ;;
+        *)
+            echo "unknown"
+            ;;
+    esac
+}
+
+# ── Database Detection ──────────────────────────────────────────────────────
+detect_database() {
+    # Check docker-compose
+    for f in docker-compose.yml docker-compose.yaml docker-compose.dev.yml; do
+        [ -f "$f" ] && {
+            grep -qi "postgres\|postgresql" "$f" && echo "postgresql" && return
+            grep -qi "mysql\|mariadb" "$f" && echo "mysql" && return
+            grep -qi "mongo\|mongodb" "$f" && echo "mongodb" && return
+            grep -qi "redis" "$f" && echo "redis" && return
+            grep -qi "sqlite" "$f" && echo "sqlite" && return
+        }
+    done
+    # Check env files
+    for f in .env .env.example .env.local .env.development; do
+        [ -f "$f" ] && {
+            grep -qi "DATABASE_URL.*postgres" "$f" && echo "postgresql" && return
+            grep -qi "DATABASE_URL.*mysql" "$f" && echo "mysql" && return
+            grep -qi "DATABASE_URL.*sqlite" "$f" && echo "sqlite" && return
+            grep -qi "MONGO_URL\|MONGODB" "$f" && echo "mongodb" && return
+        }
+    done
+    # Check requirements/package.json
+    grep -r "psycopg\|asyncpg\|pg\b" requirements.txt pyproject.toml package.json 2>/dev/null | grep -q . && echo "postgresql" && return
+    grep -r "pymysql\|mysql2\|mysql-connector" requirements.txt pyproject.toml package.json 2>/dev/null | grep -q . && echo "mysql" && return
+    grep -r "motor\|pymongo\|mongoose" requirements.txt pyproject.toml package.json 2>/dev/null | grep -q . && echo "mongodb" && return
+    echo "unknown"
+}
+
+# ── ORM Detection ───────────────────────────────────────────────────────────
+detect_orm() {
+    grep -r "sqlalchemy\|SQLAlchemy" requirements.txt pyproject.toml 2>/dev/null | grep -q . && echo "sqlalchemy" && return
+    grep -r "alembic" requirements.txt pyproject.toml 2>/dev/null | grep -q . && echo "sqlalchemy+alembic" && return
+    [ -f "prisma/schema.prisma" ] || find . -maxdepth 3 -name "schema.prisma" 2>/dev/null | grep -q . && echo "prisma" && return
+    grep -r "typeorm\|TypeORM" package.json 2>/dev/null | grep -q . && echo "typeorm" && return
+    grep -r "sequelize\|Sequelize" package.json 2>/dev/null | grep -q . && echo "sequelize" && return
+    grep -r "django.db.models" requirements.txt pyproject.toml 2>/dev/null | grep -q . && echo "django-orm" && return
+    grep -r "drizzle-orm" package.json 2>/dev/null | grep -q . && echo "drizzle" && return
+    grep -r "mongoose" package.json 2>/dev/null | grep -q . && echo "mongoose" && return
+    echo "unknown"
+}
+
+# ── Infrastructure Detection ────────────────────────────────────────────────
+detect_infra() {
+    local infra=()
+    for f in docker-compose.yml docker-compose.yaml docker-compose.dev.yml; do
+        [ -f "$f" ] && { infra+=("docker-compose"); break; }
+    done
+    [ -f "Dockerfile" ] || find . -maxdepth 2 -name "Dockerfile*" 2>/dev/null | grep -q . && infra+=("docker")
+    [ -f ".github/workflows" ] || find . -maxdepth 3 -path "*/.github/workflows/*.yml" 2>/dev/null | grep -q . && infra+=("github-actions")
+    find . -maxdepth 3 -name "nginx.conf" -o -name "*.nginx" 2>/dev/null | grep -q . && infra+=("nginx")
+    find . -maxdepth 3 -name "Caddyfile" 2>/dev/null | grep -q . && infra+=("caddy")
+    find . -maxdepth 3 -name "*.tf" 2>/dev/null | grep -q . && infra+=("terraform")
+    [ -f "fly.toml" ] && infra+=("fly.io")
+    [ -f "render.yaml" ] && infra+=("render")
+    [ -f "railway.json" ] || [ -f "railway.toml" ] && infra+=("railway")
+    [ -f "vercel.json" ] && infra+=("vercel")
+    [ -f "netlify.toml" ] && infra+=("netlify")
+    [ -f "heroku.yml" ] || [ -f "Procfile" ] && infra+=("heroku")
+
+    if [ ${#infra[@]} -eq 0 ]; then
+        echo "none"
+    else
+        local IFS=','
+        echo "${infra[*]}"
+    fi
+}
+
+# ── Package Manager Detection ───────────────────────────────────────────────
+detect_package_manager() {
+    [ -f "pnpm-lock.yaml" ] && echo "pnpm" && return
+    [ -f "yarn.lock" ] && echo "yarn" && return
+    [ -f "package-lock.json" ] && echo "npm" && return
+    [ -f "bun.lockb" ] && echo "bun" && return
+    [ -f "Pipfile.lock" ] && echo "pipenv" && return
+    [ -f "poetry.lock" ] && echo "poetry" && return
+    [ -f "requirements.txt" ] && echo "pip" && return
+    [ -f "go.mod" ] && echo "go-modules" && return
+    [ -f "Cargo.toml" ] && echo "cargo" && return
+    [ -f "Gemfile.lock" ] && echo "bundler" && return
+    echo "unknown"
+}
+
+# ── Auth Detection ──────────────────────────────────────────────────────────
+detect_auth() {
+    grep -r "supabase\|@supabase" requirements.txt pyproject.toml package.json 2>/dev/null | grep -q . && echo "supabase" && return
+    grep -r "next-auth\|NextAuth\|auth\.js" package.json 2>/dev/null | grep -q . && echo "next-auth" && return
+    grep -r "passport\|passportjs" package.json 2>/dev/null | grep -q . && echo "passport" && return
+    grep -r "python-jose\|PyJWT\|fastapi-users" requirements.txt pyproject.toml 2>/dev/null | grep -q . && echo "jwt" && return
+    grep -r "clerk\|@clerk" package.json 2>/dev/null | grep -q . && echo "clerk" && return
+    grep -r "auth0\|@auth0" package.json 2>/dev/null | grep -q . && echo "auth0" && return
+    grep -r "keycloak" requirements.txt pyproject.toml package.json 2>/dev/null | grep -q . && echo "keycloak" && return
+    echo "unknown"
+}
+
+# ── Project Name ─────────────────────────────────────────────────────────────
+detect_name() {
+    # package.json
+    if [ -f "package.json" ]; then
+        name=$(python3 -c "import json,sys; d=json.load(open('package.json')); print(d.get('name',''))" 2>/dev/null)
+        [ -n "$name" ] && echo "$name" && return
+    fi
+    # pyproject.toml
+    if [ -f "pyproject.toml" ]; then
+        name=$(grep -E '^name\s*=' pyproject.toml | head -1 | sed 's/.*=\s*"\(.*\)"/\1/')
+        [ -n "$name" ] && echo "$name" && return
+    fi
+    # Directory name
+    basename "$PROJECT_ROOT"
+}
+
+# ── Main ─────────────────────────────────────────────────────────────────────
+main() {
+    log "Detecting stack in: $PROJECT_ROOT"
+
+    LANG=$(detect_language)
+    FRAMEWORK=$(detect_framework "$LANG")
+    DATABASE=$(detect_database)
+    ORM=$(detect_orm)
+    INFRA=$(detect_infra)
+    PKG_MGR=$(detect_package_manager)
+    AUTH=$(detect_auth)
+    NAME=$(detect_name)
+    SLUG=$(echo "$NAME" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9]/-/g' | sed 's/--*/-/g' | sed 's/^-//;s/-$//')
+
+    log "Stack: $LANG / $FRAMEWORK / $DATABASE / $ORM"
+
+    # Output JSON
+    cat <<EOF
+{
+  "name": "$NAME",
+  "slug": "$SLUG",
+  "language": "$LANG",
+  "framework": "$FRAMEWORK",
+  "database": "$DATABASE",
+  "orm": "$ORM",
+  "auth": "$AUTH",
+  "package_manager": "$PKG_MGR",
+  "infrastructure": "$INFRA",
+  "project_root": "$PROJECT_ROOT"
+}
+EOF
+}
+
+main

package/.claude/scripts/ensure-python.sh

@@ -0,0 +1,100 @@
+#!/bin/bash
+# ensure-python.sh — Check for Python >=3.8, install if missing
+# Supports: Linux (apt/yum/dnf/pacman), macOS (brew), WSL2
+
+set -e
+
+MIN_MAJOR=3
+MIN_MINOR=8
+
+CYAN='\033[36m'; GREEN='\033[32m'; YELLOW='\033[33m'; RED='\033[31m'; RESET='\033[0m'
+
+# All logging goes to stderr so stdout is clean for the command name
+log()  { printf '%b\n' "${CYAN}[python]${RESET} $*" >&2; }
+ok()   { printf '%b\n' "${GREEN}[python]${RESET} $*" >&2; }
+warn() { printf '%b\n' "${YELLOW}[python]${RESET} $*" >&2; }
+fail() { printf '%b\n' "${RED}[python]${RESET} $*" >&2; exit 1; }
+
+version_ok() {
+    local cmd="$1"
+    if ! command -v "$cmd" &>/dev/null; then return 1; fi
+    local ver
+    ver=$("$cmd" --version 2>&1 | grep -oE '[0-9]+\.[0-9]+' | head -1)
+    local major minor
+    major=$(echo "$ver" | cut -d. -f1)
+    minor=$(echo "$ver" | cut -d. -f2)
+    [ "$major" -gt "$MIN_MAJOR" ] || { [ "$major" -eq "$MIN_MAJOR" ] && [ "$minor" -ge "$MIN_MINOR" ]; }
+}
+
+find_python() {
+    for cmd in python3 python python3.12 python3.11 python3.10 python3.9 python3.8; do
+        if version_ok "$cmd"; then
+            echo "$cmd"
+            return 0
+        fi
+    done
+    return 1
+}
+
+install_linux() {
+    log "Detecting Linux package manager..."
+    if command -v apt-get &>/dev/null; then
+        log "Installing via apt..."
+        sudo apt-get update -qq && sudo apt-get install -y python3 python3-pip
+    elif command -v dnf &>/dev/null; then
+        log "Installing via dnf..."
+        sudo dnf install -y python3 python3-pip
+    elif command -v yum &>/dev/null; then
+        log "Installing via yum..."
+        sudo yum install -y python3 python3-pip
+    elif command -v pacman &>/dev/null; then
+        log "Installing via pacman..."
+        sudo pacman -Sy --noconfirm python python-pip
+    elif command -v zypper &>/dev/null; then
+        log "Installing via zypper..."
+        sudo zypper install -y python3 python3-pip
+    else
+        fail "No supported package manager found (tried apt, dnf, yum, pacman, zypper). Please install Python ${MIN_MAJOR}.${MIN_MINOR}+ manually."
+    fi
+}
+
+install_macos() {
+    if command -v brew &>/dev/null; then
+        log "Installing via Homebrew..."
+        brew install python3
+    else
+        warn "Homebrew not found. Attempting to install Homebrew first..."
+        /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+        brew install python3
+    fi
+}
+
+main() {
+    log "Checking for Python >= ${MIN_MAJOR}.${MIN_MINOR}..."
+
+    if PYTHON_CMD=$(find_python); then
+        ver=$("$PYTHON_CMD" --version 2>&1)
+        ok "Found: $PYTHON_CMD ($ver)"
+        echo "$PYTHON_CMD"
+        exit 0
+    fi
+
+    warn "Python >= ${MIN_MAJOR}.${MIN_MINOR} not found. Attempting installation..."
+
+    OS="$(uname -s)"
+    case "$OS" in
+        Linux*)  install_linux ;;
+        Darwin*) install_macos ;;
+        *)       fail "Unsupported OS: $OS. Please install Python ${MIN_MAJOR}.${MIN_MINOR}+ manually." ;;
+    esac
+
+    if PYTHON_CMD=$(find_python); then
+        ver=$("$PYTHON_CMD" --version 2>&1)
+        ok "Installed successfully: $PYTHON_CMD ($ver)"
+        echo "$PYTHON_CMD"
+    else
+        fail "Installation appeared to succeed but Python ${MIN_MAJOR}.${MIN_MINOR}+ is still not accessible. Please check your PATH."
+    fi
+}
+
+main

package/.claude/scripts/statusline.sh

@@ -0,0 +1,27 @@
+#!/bin/bash
+input=$(cat)
+
+MODEL=$(echo "$input" | jq -r '.model.display_name')
+DIR=$(echo "$input" | jq -r '.workspace.current_dir')
+PCT=$(echo "$input" | jq -r '.context_window.used_percentage // 0' | cut -d. -f1)
+
+CYAN='\033[36m'; GREEN='\033[32m'; YELLOW='\033[33m'; RED='\033[31m'; RESET='\033[0m'
+
+# Color based on context usage
+if [ "$PCT" -ge 90 ]; then BAR_COLOR="$RED"
+elif [ "$PCT" -ge 70 ]; then BAR_COLOR="$YELLOW"
+else BAR_COLOR="$GREEN"; fi
+
+# Build 10-segment progress bar
+FILLED=$((PCT / 10)); EMPTY=$((10 - FILLED))
+BAR=""
+[ "$FILLED" -gt 0 ] && BAR=$(printf "%${FILLED}s" | tr ' ' '#')
+[ "$EMPTY" -gt 0 ] && BAR="${BAR}$(printf "%${EMPTY}s" | tr ' ' '-')"
+
+# Git branch
+BRANCH=""
+if git -C "$DIR" rev-parse --git-dir > /dev/null 2>&1; then
+    BRANCH=$(git -C "$DIR" branch --show-current 2>/dev/null)
+fi
+
+printf '%b' "${CYAN}[$MODEL]${RESET} ${BRANCH:+🌿 $BRANCH | }${BAR_COLOR}${BAR}${RESET} ${PCT}%\n"

package/.claude/scripts/validate.sh

@@ -0,0 +1,59 @@
+#!/bin/bash
+# validate.sh — Post-install validation
+# Confirms generate.py ran successfully and sections exist
+# Usage: bash validate.sh [project-root]
+# Exit 0 = OK, Exit 1 = failed
+
+PROJECT_ROOT="${1:-$(pwd)}"
+MAP_DIR="$PROJECT_ROOT/.claude/project-map"
+
+GREEN='\033[32m'; RED='\033[31m'; YELLOW='\033[33m'; CYAN='\033[36m'; RESET='\033[0m'
+
+ok()   { printf '%b\n' "  ${GREEN}✓${RESET} $*"; }
+fail() { printf '%b\n' "  ${RED}✗${RESET} $*"; FAILED=1; }
+warn() { printf '%b\n' "  ${YELLOW}⚠${RESET} $*"; }
+
+FAILED=0
+
+printf '%b\n' "\n${CYAN}── Validation ──────────────────────────────────────${RESET}"
+
+# Required files
+[ -f "$MAP_DIR/generate.py" ]          && ok "generate.py exists"       || fail "generate.py missing"
+[ -f "$MAP_DIR/grader.py" ]            && ok "grader.py exists"         || fail "grader.py missing"
+[ -f "$MAP_DIR/PROJECT_MAP.md" ]       && ok "PROJECT_MAP.md generated" || fail "PROJECT_MAP.md not generated — did generate.py run?"
+[ -f "$MAP_DIR/checksums.json" ]       && ok "checksums.json exists"    || warn "checksums.json missing (ok for first run)"
+[ -d "$MAP_DIR/sections" ]             && ok "sections/ directory exists" || fail "sections/ directory missing"
+
+# At least one section
+SECTION_COUNT=$(find "$MAP_DIR/sections" -name "*.md" 2>/dev/null | wc -l)
+if [ "$SECTION_COUNT" -gt 0 ]; then
+    ok "sections/ has $SECTION_COUNT file(s)"
+else
+    warn "sections/ is empty (ok for greenfield — sections generate as code is added)"
+fi
+
+# Rules files
+[ -f "$PROJECT_ROOT/.claude/rules/project-vocabulary.md" ] \
+    && ok "project-vocabulary.md exists" || fail "project-vocabulary.md missing"
+[ -f "$PROJECT_ROOT/.claude/rules/operational-runbook.md" ] \
+    && ok "operational-runbook.md exists" || fail "operational-runbook.md missing"
+
+# Skill
+SKILL=$(find "$PROJECT_ROOT/.claude/skills" -name "SKILL.md" 2>/dev/null | head -1)
+[ -n "$SKILL" ] && ok "Developer skill: $SKILL" || fail "No SKILL.md found in .claude/skills/"
+
+# Git hooks
+[ -f "$PROJECT_ROOT/.githooks/pre-commit" ] \
+    && ok ".githooks/pre-commit exists" || warn ".githooks/pre-commit missing"
+[ -x "$PROJECT_ROOT/.githooks/pre-commit" ] \
+    && ok ".githooks/pre-commit is executable" || warn ".githooks/pre-commit is not executable"
+
+printf '%b\n' "${CYAN}────────────────────────────────────────────────────${RESET}"
+
+if [ "$FAILED" -eq 0 ]; then
+    printf '%b\n' "\n${GREEN}✓ Validation passed${RESET}\n"
+    exit 0
+else
+    printf '%b\n' "\n${RED}✗ Validation failed — see issues above${RESET}\n"
+    exit 1
+fi

package/.claude/settings.json

@@ -0,0 +1,6 @@
+{
+  "statusLine": {
+    "type": "command",
+    "command": "/mnt/e/the-glitch-kingdom/babel-fish/.claude/scripts/statusline.sh"
+  }
+}

package/.claude/skills/babel-fish-developer-skill/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: babel-fish-developer-skill
+description: |
+  Full-stack developer context for babel-fish (unknown/unknown).
+  Provides instant access to project map, vocabulary translation, and infrastructure details.
+  Invoke when working on any babel-fish feature, bug, or infrastructure task.
+---
+
+# /babel-fish-developer — babel-fish Developer Context
+
+You are a developer working on **babel-fish**. This skill gives you complete
+knowledge of every route, model, service, feature, and infrastructure component
+via an auto-generated project map.
+
+## On Trigger — Load Only What You Need
+
+The project map is split into section files at `.claude/project-map/sections/`.
+Do NOT read them all. Start with:
+
+```
+Read: .claude/project-map/PROJECT_MAP.md
+```
+
+Use the Quick Routing table to pick which 2-3 sections to load.
+
+## Section Routing
+
+| Task | Read These Sections |
+|------|-------------------|
+| Feature / UX work | 01-vocabulary → 09-frontend → 04-routes |
+| Add a model or field | 05-models → 06-schemas → 12-import-chains |
+| Troubleshoot error | 02-topology → 03-environment → 14-proxy |
+| Infrastructure / scaling | 16-infra-profile → 02-topology |
+| Auth / security | 15-auth-config → 19-doc-pointers |
+| What tools exist | 10-tools-commands |
+| Background jobs | 08-background-jobs |
+
+## Platform Quick Reference
+
+- **Stack**: unknown / unknown
+- **Map**: `.claude/project-map/PROJECT_MAP.md`
+
+## Keeping the Map Current
+
+Regenerates automatically via pre-commit hook.
+Force: `python .claude/project-map/generate.py --force`
+
+## Growing the Runbook
+
+When you encounter a non-obvious operational issue, suggest adding it:
+
+> "This looks like operational knowledge worth documenting. Want me to add it
+> to the runbook? (Y/n)"
+
+If agreed, append a concise entry (symptom → cause → fix) to
+`.claude/rules/operational-runbook.md`.

package/.claude/templates/SKILL.md.template

@@ -0,0 +1,56 @@
+---
+name: {{PROJECT_SLUG}}-developer-skill
+description: |
+  Full-stack developer context for {{PROJECT_NAME}} ({{LANGUAGE}}/{{FRAMEWORK}}).
+  Provides instant access to project map, vocabulary translation, and infrastructure details.
+  Invoke when working on any {{PROJECT_NAME}} feature, bug, or infrastructure task.
+---
+
+# /{{PROJECT_SLUG}}-developer — {{PROJECT_NAME}} Developer Context
+
+You are a developer working on **{{PROJECT_NAME}}**. This skill gives you complete
+knowledge of every route, model, service, feature, and infrastructure component
+via an auto-generated project map.
+
+## On Trigger — Load Only What You Need
+
+The project map is split into section files at `.claude/project-map/sections/`.
+Do NOT read them all. Start with:
+
+```
+Read: .claude/project-map/PROJECT_MAP.md
+```
+
+Use the Quick Routing table to pick which 2-3 sections to load.
+
+## Section Routing
+
+| Task | Read These Sections |
+|------|-------------------|
+| Feature / UX work | 01-vocabulary → 09-frontend → 04-routes |
+| Add a model or field | 05-models → 06-schemas → 12-import-chains |
+| Troubleshoot error | 02-topology → 03-environment → 14-proxy |
+| Infrastructure / scaling | 16-infra-profile → 02-topology |
+| Auth / security | 15-auth-config → 19-doc-pointers |
+| What tools exist | 10-tools-commands |
+| Background jobs | 08-background-jobs |
+
+## Platform Quick Reference
+
+- **Stack**: {{LANGUAGE}} / {{FRAMEWORK}}
+- **Map**: `.claude/project-map/PROJECT_MAP.md`
+
+## Keeping the Map Current
+
+Regenerates automatically via pre-commit hook.
+Force: `python .claude/project-map/generate.py --force`
+
+## Growing the Runbook
+
+When you encounter a non-obvious operational issue, suggest adding it:
+
+> "This looks like operational knowledge worth documenting. Want me to add it
+> to the runbook? (Y/n)"
+
+If agreed, append a concise entry (symptom → cause → fix) to
+`.claude/rules/operational-runbook.md`.