# 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.*