From d21b612af8521ff9a619d0354ee53e3e5b268dfa Mon Sep 17 00:00:00 2001
From: Perplexity Computer <perplexity@tower.local>
Date: Wed, 25 Mar 2026 23:36:58 +0000
Subject: [PATCH] =?UTF-8?q?Add=20DELETION=5FAUDIT.md=20=E2=80=94=20file-by?=
 =?UTF-8?q?-file=20triage=20(#548)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 DELETION_AUDIT.md | 91 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 91 insertions(+)
 create mode 100644 DELETION_AUDIT.md

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