@theglitchking/babel-fish 1.0.1 → 2.0.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 (56) hide show
  1. package/.claude/install.sh +666 -0
  2. package/.claude/project-map/PROJECT_MAP.md +61 -0
  3. package/.claude/project-map/checksums.json +6 -0
  4. package/.claude/project-map/generate.py +1481 -0
  5. package/.claude/project-map/grader.py +583 -0
  6. package/.claude/project-map/learned-vocabulary.json +1 -0
  7. package/.claude/project-map/mine-sessions.py +419 -0
  8. package/.claude/project-map/reports/install-report.md +54 -0
  9. package/.claude/project-map/reports/iteration-01-report.md +54 -0
  10. package/.claude/project-map/reports/iteration-01-score.json +7 -0
  11. package/.claude/project-map/sections/01-vocabulary.md +8 -0
  12. package/.claude/project-map/sections/02-service-topology.md +6 -0
  13. package/.claude/project-map/sections/03-environment.md +6 -0
  14. package/.claude/project-map/sections/04-api-routes.md +6 -0
  15. package/.claude/project-map/sections/05-data-models.md +4 -0
  16. package/.claude/project-map/sections/06-schemas.md +4 -0
  17. package/.claude/project-map/sections/07-services.md +6 -0
  18. package/.claude/project-map/sections/08-background-jobs.md +5 -0
  19. package/.claude/project-map/sections/09-frontend-features.md +4 -0
  20. package/.claude/project-map/sections/10-tools-commands.md +8 -0
  21. package/.claude/project-map/sections/11-migrations.md +4 -0
  22. package/.claude/project-map/sections/12-import-chains.md +7 -0
  23. package/.claude/project-map/sections/13-frontend-backend-map.md +8 -0
  24. package/.claude/project-map/sections/14-reverse-proxy.md +4 -0
  25. package/.claude/project-map/sections/15-auth-config.md +6 -0
  26. package/.claude/project-map/sections/16-infra-profile.md +13 -0
  27. package/.claude/project-map/sections/17-learned-vocabulary.md +7 -0
  28. package/.claude/project-map/sections/18-dead-code.md +9 -0
  29. package/.claude/project-map/sections/19-doc-pointers.md +5 -0
  30. package/.claude/project-map/stack.json +12 -0
  31. package/.claude/rules/operational-runbook.md +40 -0
  32. package/.claude/rules/project-vocabulary.md +25 -0
  33. package/.claude/scripts/detect-stack.sh +222 -0
  34. package/.claude/scripts/ensure-python.sh +100 -0
  35. package/.claude/scripts/statusline.sh +27 -0
  36. package/.claude/scripts/validate.sh +59 -0
  37. package/.claude/settings.json +6 -0
  38. package/.claude/skills/babel-fish-developer-skill/SKILL.md +56 -0
  39. package/.claude/templates/SKILL.md.template +56 -0
  40. package/.claude/templates/operational-runbook.md.template +40 -0
  41. package/.claude/templates/project-vocabulary.md.template +25 -0
  42. package/.claude-plugin/marketplace.json +2 -2
  43. package/.claude-plugin/plugin.json +1 -1
  44. package/.githooks/install.sh +4 -0
  45. package/.githooks/pre-commit +22 -0
  46. package/CHANGELOG.md +72 -0
  47. package/README.md +18 -0
  48. package/bin/babel-fish.js +78 -71
  49. package/commands/policy.md +16 -0
  50. package/commands/relink.md +6 -0
  51. package/commands/status.md +6 -0
  52. package/commands/update.md +6 -0
  53. package/hooks/hooks.json +15 -0
  54. package/hooks/session-start.js +11 -0
  55. package/package.json +17 -4
  56. package/scripts/link-skills.js +31 -0
@@ -0,0 +1,61 @@
1
+ # babel-fish — Project Map
2
+
3
+ > Auto-generated by `generate.py` on 2026-04-01 20:29. Do not edit manually.
4
+
5
+
6
+ ## Stats
7
+
8
+ | Metric | Count |
9
+ |--------|-------|
10
+ | API Routes | 0 |
11
+ | Data Models | 0 |
12
+ | Schemas/DTOs | 0 |
13
+ | Frontend Features | 0 |
14
+ | Migrations | 0 |
15
+ | Docker Services | 0 |
16
+ | Vocabulary Entries | 0 |
17
+ | Stack | unknown / unknown |
18
+
19
+ ## Section Index
20
+
21
+ | # | Section | Size | When to Read |
22
+ |---|---------|------|--------------|
23
+ | [01](sections/01-vocabulary.md) | 01 Vocabulary | 0.3 KB | Any task — start here if you don't know where the code lives |
24
+ | [02](sections/02-service-topology.md) | 02 Service Topology | 0.1 KB | Debugging connectivity, adding a service, understanding ports |
25
+ | [03](sections/03-environment.md) | 03 Environment | 0.1 KB | Environment setup, missing vars, config issues |
26
+ | [04](sections/04-api-routes.md) | 04 Api Routes | 0.1 KB | Adding/editing API endpoints, checking what routes exist |
27
+ | [05](sections/05-data-models.md) | 05 Data Models | 0.1 KB | Changing database schema, adding fields, understanding relations |
28
+ | [06](sections/06-schemas.md) | 06 Schemas | 0.1 KB | Adding DTOs, changing request/response shapes |
29
+ | [07](sections/07-services.md) | 07 Services | 0.1 KB | Adding service logic, understanding service boundaries |
30
+ | [08](sections/08-background-jobs.md) | 08 Background Jobs | 0.1 KB | Working with background jobs, queues, scheduled tasks |
31
+ | [09](sections/09-frontend-features.md) | 09 Frontend Features | 0.1 KB | Frontend feature work, understanding UI structure |
32
+ | [10](sections/10-tools-commands.md) | 10 Tools Commands | 0.3 KB | Available commands, scripts, developer tooling |
33
+ | [11](sections/11-migrations.md) | 11 Migrations | 0.1 KB | Database migrations, schema history |
34
+ | [12](sections/12-import-chains.md) | 12 Import Chains | 0.2 KB | Tracing data flow from HTTP request to DB |
35
+ | [13](sections/13-frontend-backend-map.md) | 13 Frontend Backend Map | 0.1 KB | Understanding which frontend calls which backend endpoint |
36
+ | [14](sections/14-reverse-proxy.md) | 14 Reverse Proxy | 0.1 KB | Proxy routing, nginx/caddy config |
37
+ | [15](sections/15-auth-config.md) | 15 Auth Config | 0.1 KB | Auth flow, sessions, permissions |
38
+ | [16](sections/16-infra-profile.md) | 16 Infra Profile | 0.3 KB | Infrastructure overview, tech stack summary |
39
+ | [17](sections/17-learned-vocabulary.md) | 17 Learned Vocabulary | 0.2 KB | Vocabulary learned from past sessions |
40
+ | [18](sections/18-dead-code.md) | 18 Dead Code | 0.2 KB | Dead code review |
41
+ | [19](sections/19-doc-pointers.md) | 19 Doc Pointers | 0.1 KB | Finding documentation, READMEs, wikis |
42
+
43
+ ## Quick Routing
44
+
45
+ | Task | Read Sections |
46
+ |------|--------------|
47
+ | Feature / UX work | 01 → 09 → 04 |
48
+ | Add model or field | 05 → 06 → 12 |
49
+ | Troubleshoot error | 02 → 03 → 14 |
50
+ | Infrastructure / scaling | 16 → 02 |
51
+ | Auth / security | 15 → 19 |
52
+ | What tools exist | 10 |
53
+ | Background jobs | 08 |
54
+ | Migration history | 11 |
55
+
56
+ ## Regenerate
57
+
58
+ ```bash
59
+ python .claude/project-map/generate.py # skip if unchanged
60
+ python .claude/project-map/generate.py --force # always regenerate
61
+ ```
@@ -0,0 +1,6 @@
1
+ {
2
+ "input_hash": "01b723fba1eeffe29b8a71be2fbd81197a22fc0e4fec0eb10a096361b4b3d054",
3
+ "generated_at": "2026-04-01T20:29:02.877707",
4
+ "route_count": 0,
5
+ "model_count": 0
6
+ }