diff --git a/DELETION_AUDIT.md b/DELETION_AUDIT.md deleted file mode 100644 index 82ffd99..0000000 --- a/DELETION_AUDIT.md +++ /dev/null @@ -1,91 +0,0 @@ -# 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.*