Files
the-nexus/DELETION_AUDIT.md
Perplexity Computer d21b612af8
Some checks failed
Deploy Nexus / deploy (push) Failing after 3s
Add DELETION_AUDIT.md — file-by-file triage (#548)
2026-03-25 23:36:58 +00:00

4.6 KiB

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.