92 lines
4.6 KiB
Markdown
92 lines
4.6 KiB
Markdown
|
# Deletion Audit — the-nexus
|
||
|
|
|
||
|
|
Per direction shift (#542) and ticket #548.
|
||
|
|
Deletion is more valuable than extraction.
|
||
|
|
|
||
|
|
Every file categorized against the three pillars: **Heartbeat**, **Harness**, **Portal Interface**.
|
||
|
|
|
||
|
|
## Summary
|
||
|
|
|
||
|
|
| Verdict | Count | Lines/Bytes Removed |
|
||
|
|
|---------|-------|---------------------|
|
||
|
|
| DELETE | 16 | ~136 KB |
|
||
|
|
| KEEP | 22 | Core infrastructure |
|
||
|
|
| REWRITE | 1 | CI needs updating |
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## DELETE — Does not serve the three pillars
|
||
|
|
|
||
|
|
| File | Size | Justification |
|
||
|
|
|------|------|---------------|
|
||
|
|
| `app.js` | 59 KB | Three.js 3D world. The frontend is dead. Biggest single file. |
|
||
|
|
| `archon_assembler.js` | 8.7 KB | 3D avatar system for the deleted world. |
|
||
|
|
| `style.css` | 15 KB | Styles for the 3D world frontend. |
|
||
|
|
| `index.html` | 9.5 KB | Entry point for the 3D world. Not the heartbeat. |
|
||
|
|
| `service-worker.js` | 951 B | PWA for the deleted frontend. |
|
||
|
|
| `manifest.json` | 452 B | PWA manifest for the deleted frontend. |
|
||
|
|
| `icons/icon-192x192.png` | 19 B | PWA icon (placeholder). |
|
||
|
|
| `icons/icon-512x512.png` | 19 B | PWA icon (placeholder). |
|
||
|
|
| `icons/` | — | Empty directory after icon deletion. |
|
||
|
|
| `server.js` | 729 B | Express server proxying Gitea commits for the 3D world. |
|
||
|
|
| `nginx.conf` | 474 B | Nginx config serving the 3D frontend + proxying to server.js. |
|
||
|
|
| `package.json` | 142 B | express + node-fetch deps for server.js. |
|
||
|
|
| `package-lock.json` | 33 KB | Lockfile for deleted Node deps. |
|
||
|
|
| `send_ws.py` | 311 B | One-off websocket test utility. Not part of any pipeline. |
|
||
|
|
| `tests/smoke.spec.js` | 8.9 KB | Playwright tests for the 3D world frontend. |
|
||
|
|
| `tests/playwright.config.js` | 681 B | Playwright config for deleted tests. |
|
||
|
|
| `tests/run-smoke.sh` | 1.1 KB | Shell wrapper for deleted tests. |
|
||
|
|
| `tests/` | — | Empty directory after test deletion. |
|
||
|
|
|
||
|
|
## KEEP — Serves the three pillars
|
||
|
|
|
||
|
|
| File | Pillar | Justification |
|
||
|
|
|------|--------|---------------|
|
||
|
|
| `nexus/__init__.py` | Heartbeat | Python package entry, imports perception/experience/trajectory. |
|
||
|
|
| `nexus/perception_adapter.py` | Heartbeat | Perception loop — core of the heartbeat cycle. |
|
||
|
|
| `nexus/experience_store.py` | Heartbeat | Memory/experience storage — heartbeat state. |
|
||
|
|
| `nexus/trajectory_logger.py` | Harness | Logs trajectories for DPO training data capture. |
|
||
|
|
| `nexus/nexus_think.py` | Heartbeat | Reasoning engine — the decision step. |
|
||
|
|
| `nexus/groq_worker.py` | Harness | Cloud model fallback worker (cascade router component). |
|
||
|
|
| `nexus/BIRTH.md` | Heartbeat | Timmy's birth certificate / conscience — identity document. |
|
||
|
|
| `server.py` | Heartbeat | WebSocket broadcast server — heartbeat communication layer. |
|
||
|
|
| `portals.json` | Portal | Portal definitions (Morrowind, Bannerlord, etc). |
|
||
|
|
| `vision.json` | Heartbeat | Core vision statements (sovereignty, connectivity, etc). |
|
||
|
|
| `docker-compose.yml` | Infra | Container orchestration for the harness. |
|
||
|
|
| `Dockerfile` | Infra | Container build for deployment. |
|
||
|
|
| `deploy.sh` | Infra | Deployment script. |
|
||
|
|
| `CLAUDE.md` | Process | Agent instructions — defines PR rules, architecture. |
|
||
|
|
| `CONTRIBUTING.md` | Process | Contribution guidelines. |
|
||
|
|
| `README.md` | Process | Project documentation. |
|
||
|
|
| `FIRST_LIGHT_REPORT.md` | Heartbeat | First successful test report — historical record. |
|
||
|
|
| `.gitignore` | Infra | Standard gitignore. |
|
||
|
|
| `.githooks/pre-commit` | Process | 777-line JS limit enforcement. May need update post-deletion. |
|
||
|
|
| `.gitea/workflows/deploy.yml` | Infra | Deployment pipeline. |
|
||
|
|
| `.gitea/workflows/auto-merge.yml` | Process | Auto-merge stub. |
|
||
|
|
|
||
|
|
## REWRITE — Needs updating after deletion
|
||
|
|
|
||
|
|
| File | Issue |
|
||
|
|
|------|-------|
|
||
|
|
| `.gitea/workflows/ci.yml` | Currently validates `index.html` (deleted), JS files (deleted), and enforces 777-line JS limit (irrelevant after `app.js` removal). Rewrite to validate Python (`nexus/`) and JSON configs only. |
|
||
|
|
| `Dockerfile` | Currently builds Node.js + Nginx to serve the 3D world. Rewrite to serve the Python heartbeat loop instead. |
|
||
|
|
| `docker-compose.yml` | Port mapping (4200:80, 3001:3001) is for the deleted frontend. Update to expose heartbeat/WS port only. |
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Post-Deletion State
|
||
|
|
|
||
|
|
After executing this audit, the repo contains:
|
||
|
|
- `nexus/` — Python heartbeat/harness package (~45 KB across 7 files)
|
||
|
|
- `server.py` — WebSocket server (~1 KB)
|
||
|
|
- `portals.json`, `vision.json` — Config (~3 KB)
|
||
|
|
- Infrastructure: Dockerfile, docker-compose.yml, deploy.sh, CI workflows
|
||
|
|
- Docs: README, CLAUDE.md, CONTRIBUTING.md, FIRST_LIGHT_REPORT.md, BIRTH.md
|
||
|
|
|
||
|
|
No JavaScript. No CSS. No HTML. No Node.js. No Nginx.
|
||
|
|
The repo becomes a pure Python heartbeat engine with config.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
*Awaiting Alexander's approval before any deletion.*
|