@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.
- package/.claude/project-map/generate.py +206 -21
- package/.claude/project-map/grader.py +77 -1
- package/.claude/project-map/mine-sessions.py +141 -23
- package/.claude/project-map/test_generate.py +203 -0
- package/.claude/project-map/test_grader.py +164 -0
- package/.claude/project-map/test_mine_sessions.py +206 -0
- package/.claude-plugin/marketplace.json +2 -2
- package/.claude-plugin/plugin.json +1 -1
- package/CHANGELOG.md +209 -0
- package/README.md +9 -2
- package/checksums.json +2 -2
- package/hooks/session-start.js +34 -1
- package/package.json +13 -4
- package/.claude/project-map/PROJECT_MAP.md +0 -61
- package/.claude/project-map/__pycache__/generate.cpython-312.pyc +0 -0
- package/.claude/project-map/checksums.json +0 -6
- package/.claude/project-map/learned-vocabulary.json +0 -1
- package/.claude/project-map/reports/install-report.md +0 -54
- package/.claude/project-map/reports/iteration-01-report.md +0 -54
- package/.claude/project-map/reports/iteration-01-score.json +0 -7
- package/.claude/project-map/sections/01-vocabulary.md +0 -8
- package/.claude/project-map/sections/02-service-topology.md +0 -6
- package/.claude/project-map/sections/03-environment.md +0 -6
- package/.claude/project-map/sections/04-api-routes.md +0 -6
- package/.claude/project-map/sections/05-data-models.md +0 -4
- package/.claude/project-map/sections/06-schemas.md +0 -4
- package/.claude/project-map/sections/07-services.md +0 -6
- package/.claude/project-map/sections/08-background-jobs.md +0 -5
- package/.claude/project-map/sections/09-frontend-features.md +0 -4
- package/.claude/project-map/sections/10-tools-commands.md +0 -8
- package/.claude/project-map/sections/11-migrations.md +0 -4
- package/.claude/project-map/sections/12-import-chains.md +0 -7
- package/.claude/project-map/sections/13-frontend-backend-map.md +0 -8
- package/.claude/project-map/sections/14-reverse-proxy.md +0 -4
- package/.claude/project-map/sections/15-auth-config.md +0 -6
- package/.claude/project-map/sections/16-infra-profile.md +0 -13
- package/.claude/project-map/sections/17-learned-vocabulary.md +0 -7
- package/.claude/project-map/sections/18-dead-code.md +0 -9
- package/.claude/project-map/sections/19-doc-pointers.md +0 -5
- package/.claude/project-map/stack.json +0 -12
- package/.claude/rules/operational-runbook.md +0 -40
- package/.claude/rules/project-vocabulary.md +0 -25
- package/.claude/settings.json +0 -6
- package/.claude/settings.local.json +0 -6
- 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,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,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,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` |
|
package/.claude/settings.json
DELETED
|
@@ -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`.
|