Timmy_Foundation/the-nexus
15
1
Fork 2
Code Issues 80 Pull Requests 77 Actions Packages Projects Releases Wiki Activity
Files
b46fb9d2bfe37a24a6fd8d8c0914b5195f5dcc99
the-nexus/README.md
Alexander Whitestone 2be5b5c5b6
Some checks failed
Review Approval Gate / verify-review (pull_request) Failing after 9s
Details
CI / validate (pull_request) Failing after 38s
Details
CI / test (pull_request) Failing after 13m26s
Details
fix: remove duplicate content blocks on page 
- README.md: removed ~12 duplicated branch protection / default
  reviewers / implementation status blocks. Kept one clean version
  at the bottom with CONTRIBUTING.md cross-reference.
- index.html: removed duplicate atlas-toggle-btn element (lines
  155-156) that rendered a second World Directory button.

Closes #1338
2026-04-13 17:23:57 -04:00

2.7 KiB
Raw Blame History

The Nexus

Timmy's canonical 3D home-world — a local-first training ground and wizardly visualization surface for the living system.

Current Truth

Current main does not ship a browser 3D world. A clean checkout contains:

  • Python heartbeat / cognition files under nexus/
  • server.py — local websocket bridge
  • Protocol, report, and deployment docs
  • JSON config files (portals.json, vision.json)

It does not currently contain an active root frontend (index.html, app.js, style.css).

One Canonical 3D Repo

Timmy_Foundation/the-nexus is the only canonical 3D repo.

The legacy browser app at /Users/apayne/the-matrix is source material for migration, not a second repo to keep evolving in parallel. Useful work from it must be audited and migrated here.

See LEGACY_MATRIX_AUDIT.md.

Why This Matters

We do not want to lose real quality work. We also do not want to keep two drifting 3D repos alive by accident.

The rule:

  • Rescue good work from legacy Matrix
  • Rebuild inside the-nexus
  • Keep telemetry and durable truth flowing through the Hermes harness

Active Migration Backlog

Issue Work
#684 Sync docs to repo truth
#685 Preserve legacy Matrix quality work
#686 Rebuild browser smoke / visual validation
#687 Restore wizardly local-first visual shell
#672 Rebuild portal stack (Timmy → Reflex → Pilot)
#673 Deterministic Morrowind pilot loop
#674 Reflex tactical layer + trajectory logging
#675 Deterministic context compaction

Running Locally

There is no root browser app on current main. Do not static-serve the repo root expecting a world.

You can run:

  • python3 server.py — local websocket bridge
  • Python modules under nexus/ — heartbeat / cognition work

The browser-facing Nexus must be rebuilt through the migration backlog using audited Matrix components.

Branch Protection & Review Policy

All repositories enforce these rules on main:

Rule Status
Require Pull Request for merge ✅ Enabled
Require 1 approval before merge ✅ Enabled
Dismiss stale approvals on new commits ✅ Enabled
Require CI to pass (where CI exists) ⚠️ Conditional
Block force pushes to main ✅ Enabled
Block deletion of main branch ✅ Enabled

Default reviewers:

  • @perplexity — all repositories (QA gate)
  • @Timmy — hermes-agent only (owner gate)

CI status:

  • hermes-agent: ✅ Active
  • the-nexus: ⚠️ Runner pending (#915)
  • timmy-home: ❌ No CI
  • timmy-config: ❌ Limited CI

See CONTRIBUTING.md for full details.

One 3D repo. One migration path. No more ghost worlds.

Reference in New Issue View Git Blame Copy Permalink