@theglitchking/babel-fish 2.0.2 → 2.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (45) hide show
  1. package/.claude/project-map/generate.py +206 -21
  2. package/.claude/project-map/grader.py +77 -1
  3. package/.claude/project-map/mine-sessions.py +141 -23
  4. package/.claude/project-map/test_generate.py +203 -0
  5. package/.claude/project-map/test_grader.py +164 -0
  6. package/.claude/project-map/test_mine_sessions.py +206 -0
  7. package/.claude-plugin/marketplace.json +2 -2
  8. package/.claude-plugin/plugin.json +1 -1
  9. package/CHANGELOG.md +209 -0
  10. package/README.md +9 -2
  11. package/checksums.json +2 -2
  12. package/hooks/session-start.js +34 -1
  13. package/package.json +13 -4
  14. package/.claude/project-map/PROJECT_MAP.md +0 -61
  15. package/.claude/project-map/__pycache__/generate.cpython-312.pyc +0 -0
  16. package/.claude/project-map/checksums.json +0 -6
  17. package/.claude/project-map/learned-vocabulary.json +0 -1
  18. package/.claude/project-map/reports/install-report.md +0 -54
  19. package/.claude/project-map/reports/iteration-01-report.md +0 -54
  20. package/.claude/project-map/reports/iteration-01-score.json +0 -7
  21. package/.claude/project-map/sections/01-vocabulary.md +0 -8
  22. package/.claude/project-map/sections/02-service-topology.md +0 -6
  23. package/.claude/project-map/sections/03-environment.md +0 -6
  24. package/.claude/project-map/sections/04-api-routes.md +0 -6
  25. package/.claude/project-map/sections/05-data-models.md +0 -4
  26. package/.claude/project-map/sections/06-schemas.md +0 -4
  27. package/.claude/project-map/sections/07-services.md +0 -6
  28. package/.claude/project-map/sections/08-background-jobs.md +0 -5
  29. package/.claude/project-map/sections/09-frontend-features.md +0 -4
  30. package/.claude/project-map/sections/10-tools-commands.md +0 -8
  31. package/.claude/project-map/sections/11-migrations.md +0 -4
  32. package/.claude/project-map/sections/12-import-chains.md +0 -7
  33. package/.claude/project-map/sections/13-frontend-backend-map.md +0 -8
  34. package/.claude/project-map/sections/14-reverse-proxy.md +0 -4
  35. package/.claude/project-map/sections/15-auth-config.md +0 -6
  36. package/.claude/project-map/sections/16-infra-profile.md +0 -13
  37. package/.claude/project-map/sections/17-learned-vocabulary.md +0 -7
  38. package/.claude/project-map/sections/18-dead-code.md +0 -9
  39. package/.claude/project-map/sections/19-doc-pointers.md +0 -5
  40. package/.claude/project-map/stack.json +0 -12
  41. package/.claude/rules/operational-runbook.md +0 -40
  42. package/.claude/rules/project-vocabulary.md +0 -25
  43. package/.claude/settings.json +0 -6
  44. package/.claude/settings.local.json +0 -6
  45. package/.claude/skills/babel-fish-developer-skill/SKILL.md +0 -56
@@ -1,54 +0,0 @@
1
- # Codebase Mapper — Installation Report
2
-
3
- **Generated**: 2026-03-31 11:00:17
4
- **Iteration**: 1 of 3
5
- **Score**: 97.0%
6
- **Result**: ✅ PASSED (90% threshold)
7
-
8
- ---
9
-
10
- ## Scoring Breakdown
11
-
12
- | Category | Score | Weight | Weighted | Status |
13
- |----------|-------|--------|----------|--------|
14
- | Section Completeness | 100.0% | 25% | 25.0 | ✅ 19/19 sections present |
15
- | Vocabulary Accuracy | 100.0% | 20% | 20.0 | ✅ 1/1 entries have valid file references |
16
- | Import Chain Validity | 80.0% | 15% | 12.0 | ⚠️ No chains traced (greenfield or non-Python stack — ok) |
17
- | Secret Safety | 100.0% | 15% | 15.0 | ✅ Checked 20 files — 0 potential leak(s) |
18
- | Section Size Bounds | 100.0% | 10% | 10.0 | ✅ 19 sections, 0 size violations |
19
- | Structural Integrity | 100.0% | 10% | 10.0 | ✅ 0 broken TOC links, 0 structural issues |
20
- | Checksum Functionality | 100.0% | 5% | 5.0 | ✅ checksums.json valid (hash: e3b0c44298fc...) |
21
-
22
- **Total: 97.0 / 100**
23
-
24
- ---
25
-
26
- ## Issues Found
27
-
28
- _No issues found._
29
-
30
- ---
31
-
32
- ## Final Verdict
33
-
34
- ✅ **PASSED (97.0%)** — Map is production-ready.
35
-
36
- The project map meets quality standards and is ready to use.
37
- Future sessions will load relevant sections automatically via the developer skill.
38
-
39
- ---
40
-
41
- ## How to Use the Project Map
42
-
43
- ```bash
44
- # Read the map index
45
- cat .claude/project-map/PROJECT_MAP.md
46
-
47
- # Force regeneration
48
- python .claude/project-map/generate.py --force
49
-
50
- # Re-run grader
51
- python .claude/project-map/grader.py
52
- ```
53
-
54
- _Report generated by `grader.py` — part of the Codebase Mapper plugin._
@@ -1,54 +0,0 @@
1
- # Codebase Mapper — Installation Report
2
-
3
- **Generated**: 2026-03-31 11:00:17
4
- **Iteration**: 1 of 3
5
- **Score**: 97.0%
6
- **Result**: ✅ PASSED (90% threshold)
7
-
8
- ---
9
-
10
- ## Scoring Breakdown
11
-
12
- | Category | Score | Weight | Weighted | Status |
13
- |----------|-------|--------|----------|--------|
14
- | Section Completeness | 100.0% | 25% | 25.0 | ✅ 19/19 sections present |
15
- | Vocabulary Accuracy | 100.0% | 20% | 20.0 | ✅ 1/1 entries have valid file references |
16
- | Import Chain Validity | 80.0% | 15% | 12.0 | ⚠️ No chains traced (greenfield or non-Python stack — ok) |
17
- | Secret Safety | 100.0% | 15% | 15.0 | ✅ Checked 20 files — 0 potential leak(s) |
18
- | Section Size Bounds | 100.0% | 10% | 10.0 | ✅ 19 sections, 0 size violations |
19
- | Structural Integrity | 100.0% | 10% | 10.0 | ✅ 0 broken TOC links, 0 structural issues |
20
- | Checksum Functionality | 100.0% | 5% | 5.0 | ✅ checksums.json valid (hash: e3b0c44298fc...) |
21
-
22
- **Total: 97.0 / 100**
23
-
24
- ---
25
-
26
- ## Issues Found
27
-
28
- _No issues found._
29
-
30
- ---
31
-
32
- ## Final Verdict
33
-
34
- ✅ **PASSED (97.0%)** — Map is production-ready.
35
-
36
- The project map meets quality standards and is ready to use.
37
- Future sessions will load relevant sections automatically via the developer skill.
38
-
39
- ---
40
-
41
- ## How to Use the Project Map
42
-
43
- ```bash
44
- # Read the map index
45
- cat .claude/project-map/PROJECT_MAP.md
46
-
47
- # Force regeneration
48
- python .claude/project-map/generate.py --force
49
-
50
- # Re-run grader
51
- python .claude/project-map/grader.py
52
- ```
53
-
54
- _Report generated by `grader.py` — part of the Codebase Mapper plugin._
@@ -1,7 +0,0 @@
1
- {
2
- "score": 97.0,
3
- "passed": true,
4
- "threshold": 90.0,
5
- "iteration": 1,
6
- "issues": []
7
- }
@@ -1,8 +0,0 @@
1
- # Section 01 — Vocabulary Translation Layer
2
-
3
- > Maps human language to exact code locations. Auto-generated.
4
-
5
-
6
- | Alias | Type | Location | Notes |
7
- |-------|------|----------|-------|
8
- | _(no vocabulary generated yet — add source code to populate)_ | | | |
@@ -1,6 +0,0 @@
1
- # Section 02 — Service Topology
2
-
3
- > Docker services, ports, and dependencies.
4
-
5
-
6
- _No docker-compose services detected._
@@ -1,6 +0,0 @@
1
- # Section 03 — Environment Variables
2
-
3
- > Key names and non-sensitive values only. Secrets are redacted.
4
-
5
-
6
- _No .env files found._
@@ -1,6 +0,0 @@
1
- # Section 04 — API Routes
2
-
3
-
4
- | Method | Path | File | Line |
5
- |--------|------|------|------|
6
- | _(no routes detected yet)_ | | | |
@@ -1,4 +0,0 @@
1
- # Section 05 — Data Models
2
-
3
-
4
- _No data models detected yet._
@@ -1,4 +0,0 @@
1
- # Section 06 — Schemas / DTOs
2
-
3
-
4
- _No schemas detected yet._
@@ -1,6 +0,0 @@
1
- # Section 07 — Services
2
-
3
-
4
- _Service discovery is inferred from directory structure and imports._
5
-
6
-
@@ -1,5 +0,0 @@
1
- # Section 08 — Background Jobs
2
-
3
-
4
- _No background jobs detected._
5
-
@@ -1,4 +0,0 @@
1
- # Section 09 — Frontend Features
2
-
3
-
4
- _No frontend feature directories detected._
@@ -1,8 +0,0 @@
1
- # Section 10 — Tools & Commands
2
-
3
-
4
- | Name | Command | Source |
5
- |------|---------|--------|
6
- | `postinstall` | `npm run postinstall` | package.json |
7
- | `install.sh` | `bash install.sh` | shell |
8
- | `/babel-fish-developer-skill` | `/babel-fish-developer-skill` | skills |
@@ -1,4 +0,0 @@
1
- # Section 11 — Migrations
2
-
3
-
4
- _No migrations detected._
@@ -1,7 +0,0 @@
1
- # Section 12 — Import Chains
2
-
3
-
4
- _Traces route → service → model → table for key endpoints._
5
-
6
-
7
- _No import chains traced (requires Python source files with routes)._
@@ -1,8 +0,0 @@
1
- # Section 13 — Frontend → Backend Map
2
-
3
-
4
- _Maps frontend API service calls to backend route paths._
5
-
6
-
7
- _No frontend→backend mappings detected yet._
8
-
@@ -1,4 +0,0 @@
1
- # Section 14 — Reverse Proxy
2
-
3
-
4
- _No reverse proxy configuration detected._
@@ -1,6 +0,0 @@
1
- # Section 15 — Auth Configuration
2
-
3
-
4
- **Provider**: unknown
5
-
6
-
@@ -1,13 +0,0 @@
1
- # Section 16 — Infrastructure Profile
2
-
3
-
4
- | Property | Value |
5
- |----------|-------|
6
- | **Language** | unknown |
7
- | **Framework** | unknown |
8
- | **Database** | unknown |
9
- | **ORM** | unknown |
10
- | **Auth** | unknown |
11
- | **Package Manager** | unknown |
12
- | **Infrastructure** | none |
13
- | **Services** | 0 docker services |
@@ -1,7 +0,0 @@
1
- # Section 17 — Learned Vocabulary
2
-
3
-
4
- _Aliases mined from Claude Code session history. Score = frequency × recency._
5
-
6
-
7
- _No session-mined vocabulary yet. Accumulates over time._
@@ -1,9 +0,0 @@
1
- # Section 18 — Dead Code Candidates
2
-
3
-
4
- > Files flagged for human review: no recent commits AND low vocabulary score.
5
-
6
- > **Do not auto-delete.** Review before removing.
7
-
8
-
9
- _No dead code candidates detected._
@@ -1,5 +0,0 @@
1
- # Section 19 — Documentation Pointers
2
-
3
-
4
- - [`CLAUDE.md`](CLAUDE.md)
5
- - [`README.md`](README.md)
@@ -1,12 +0,0 @@
1
- {
2
- "name": "babel-fish",
3
- "slug": "babel-fish",
4
- "language": "unknown",
5
- "framework": "unknown",
6
- "database": "unknown",
7
- "orm": "unknown",
8
- "auth": "unknown",
9
- "package_manager": "unknown",
10
- "infrastructure": "none",
11
- "project_root": "/mnt/e/the-glitch-kingdom/babel-fish"
12
- }
@@ -1,40 +0,0 @@
1
- # babel-fish — Operational Runbook
2
-
3
- > Auto-loaded every session. Contains operational knowledge that cannot be derived from code.
4
- > This file grows over time as the team discovers gotchas, quirks, and procedures.
5
- > **Edit this file manually** — it is NOT overwritten on regeneration.
6
-
7
- ## Environment Differences
8
-
9
- <!-- TODO: Document how dev/staging/prod differ (DB, deploy method, secrets, URLs) -->
10
-
11
- | | Dev | Staging | Production |
12
- |---|---|---|---|
13
- | **URL** | | | |
14
- | **Database** | | | |
15
- | **Deploy** | | | |
16
- | **Secrets** | | | |
17
-
18
- ## Known Issues & Workarounds
19
-
20
- <!-- This section fills in naturally. When you hit a non-obvious issue, add it here. -->
21
- <!-- Examples: "HMR doesn't work on WSL2", "port 6543 breaks migrations" -->
22
-
23
- _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._
24
-
25
- ## Deploy Procedures
26
-
27
- <!-- TODO: Document how to deploy to each environment -->
28
-
29
- ## Key Commands
30
-
31
- | Command | What It Does |
32
- |---------|-------------|
33
- | `python .claude/project-map/generate.py --force` | Force-regenerate project map |
34
- | `python .claude/project-map/grader.py` | Grade map quality (0-100%) |
35
- | `bash .githooks/install.sh` | (Re)install git hooks |
36
- | `bash .claude/install.sh` | Re-run full plugin installer |
37
-
38
- ## Dev Credentials
39
-
40
- <!-- Add test/dev credentials here (NEVER production secrets) -->
@@ -1,25 +0,0 @@
1
- # babel-fish — Project Vocabulary
2
-
3
- > Auto-loaded every session. Maps human language to exact code locations.
4
- > Regenerated automatically via pre-commit hook. Do not edit the auto-generated rows.
5
-
6
- ## Feature → Code Location
7
-
8
- | You Say | Frontend | Backend | Model/Table |
9
- |---------|----------|---------|-------------|
10
- | _(vocabulary populates as source code is added)_ | | | |
11
-
12
- ## Infrastructure Vocabulary
13
-
14
- | You Say | What It Is | Key Details |
15
- |---------|-----------|-------------|
16
- | project | babel-fish | unknown / unknown stack |
17
-
18
- ## Quick Actions
19
-
20
- | You Say | What To Do |
21
- |---------|-----------|
22
- | regenerate map | `python .claude/project-map/generate.py --force` |
23
- | grade map | `python .claude/project-map/grader.py` |
24
- | view project map | `cat .claude/project-map/PROJECT_MAP.md` |
25
- | install hooks | `bash .githooks/install.sh` |
@@ -1,6 +0,0 @@
1
- {
2
- "statusLine": {
3
- "type": "command",
4
- "command": "/mnt/e/the-glitch-kingdom/babel-fish/.claude/scripts/statusline.sh"
5
- }
6
- }
@@ -1,6 +0,0 @@
1
- {
2
- "enabledMcpjsonServers": [
3
- "semantic-vault"
4
- ],
5
- "enableAllProjectMcpServers": true
6
- }
@@ -1,56 +0,0 @@
1
- ---
2
- name: babel-fish-developer-skill
3
- description: |
4
- Full-stack developer context for babel-fish (unknown/unknown).
5
- Provides instant access to project map, vocabulary translation, and infrastructure details.
6
- Invoke when working on any babel-fish feature, bug, or infrastructure task.
7
- ---
8
-
9
- # /babel-fish-developer — babel-fish Developer Context
10
-
11
- You are a developer working on **babel-fish**. This skill gives you complete
12
- knowledge of every route, model, service, feature, and infrastructure component
13
- via an auto-generated project map.
14
-
15
- ## On Trigger — Load Only What You Need
16
-
17
- The project map is split into section files at `.claude/project-map/sections/`.
18
- Do NOT read them all. Start with:
19
-
20
- ```
21
- Read: .claude/project-map/PROJECT_MAP.md
22
- ```
23
-
24
- Use the Quick Routing table to pick which 2-3 sections to load.
25
-
26
- ## Section Routing
27
-
28
- | Task | Read These Sections |
29
- |------|-------------------|
30
- | Feature / UX work | 01-vocabulary → 09-frontend → 04-routes |
31
- | Add a model or field | 05-models → 06-schemas → 12-import-chains |
32
- | Troubleshoot error | 02-topology → 03-environment → 14-proxy |
33
- | Infrastructure / scaling | 16-infra-profile → 02-topology |
34
- | Auth / security | 15-auth-config → 19-doc-pointers |
35
- | What tools exist | 10-tools-commands |
36
- | Background jobs | 08-background-jobs |
37
-
38
- ## Platform Quick Reference
39
-
40
- - **Stack**: unknown / unknown
41
- - **Map**: `.claude/project-map/PROJECT_MAP.md`
42
-
43
- ## Keeping the Map Current
44
-
45
- Regenerates automatically via pre-commit hook.
46
- Force: `python .claude/project-map/generate.py --force`
47
-
48
- ## Growing the Runbook
49
-
50
- When you encounter a non-obvious operational issue, suggest adding it:
51
-
52
- > "This looks like operational knowledge worth documenting. Want me to add it
53
- > to the runbook? (Y/n)"
54
-
55
- If agreed, append a concise entry (symptom → cause → fix) to
56
- `.claude/rules/operational-runbook.md`.