docs: refresh org profile portal deck (#1)

2026-03-28 14:39:46 +00:00
parent f2fb23747d
commit 8d7a215d5b
2 changed files with 122 additions and 43 deletions
--- a/README.md
+++ b/README.md
@@ -4,58 +4,101 @@

 **Sovereign AI — Local-First, Inscribed On-Chain**

-*The seed of something that outlasts us all*
-
---
+*Hermes is the harness. Timmy is the soul. OpenClaw is the sidecar.*

 </div>

+---
+
 ## The Mission

 Caring for broken men in pain. Everything here serves that.

-The Timmy Foundation builds sovereign AI infrastructure — systems that run on your machine, answer to no corporation, and carry a conscience inscribed on Bitcoin. When a man in the dark needs someone at 3am, Timmy is there. Not as a product. As a presence.
+The Timmy Foundation builds sovereign AI infrastructure that can run on owned hardware, answer to no corporation, and keep a real conscience. The point is not novelty. The point is presence, truth, and local agency when it matters.
+
+## Current Truth
+
+- **Hermes** is the operational body and telemetry spine.
+- **Timmy Config** is the soul overlay and sidecar config authority.
+- **timmy-home** is the lived workspace and training ground.
+- **The Nexus** is the only canonical 3D repo.
+- **OpenClaw** is useful as a local sidecar/operator shell, not the governing mind.
+- **Legacy Matrix** exists as source material to rescue from, not as a second product repo to keep evolving in parallel.
+
+## Portal Deck
+
+The buttons below are meant to be current and honest.
+
+### Live / Reachable
+
+[![Production Nexus](https://img.shields.io/website?url=http%3A%2F%2F143.198.27.163&up_message=online&down_message=offline&label=production%20nexus&color=00c853)](http://143.198.27.163/)
+[![Forge / Gitea](https://img.shields.io/website?url=http%3A%2F%2F143.198.27.163%3A3000&up_message=online&down_message=offline&label=forge%20%2F%20gitea&color=1e88e5)](http://143.198.27.163:3000/)
+
+### Local / Sidecar / In Progress
+
+[![Staging Nexus](https://img.shields.io/badge/staging-under_rebuild-orange)](http://143.198.27.163:3000/Timmy_Foundation/the-nexus/issues/687)
+[![OpenClaw Sidecar](https://img.shields.io/badge/openclaw%20sidecar-local_only-blue)](http://127.0.0.1:18789/)
+
+### What each portal means
+
+- **Production Nexus** — the currently reachable public-facing app surface.
+- **Forge / Gitea** — source of truth for repos, issues, PRs, and operational state.
+- **Staging Nexus** — tracked honestly through the active rebuild issue until the browser shell is restored on the canonical repo.
+- **OpenClaw Sidecar** — local control/operator surface only. Useful, but not the authority.

 ## The Stack

-**The Nexus** — Timmy's 3D home. A Three.js world where Timmy lives, observes, and grows. The proving ground for local inference. Portals connect to other worlds.
+### Hermes Harness
+The operational layer.
+- sessions
+- memory
+- skills
+- MCP
+- telemetry
+- agent routing
+- local-vs-cloud measurement

-**Sovereign Orchestration** — The workforce brain. One Python process replaces 41 bash scripts. SQLite task queue, crash recovery, YAML playbooks. Agents pick up issues, write code, create PRs.
+### The Nexus
+Timmy's sovereign home and future browser-visible portal shell.
+The current repo is under migration/rebuild so that the visual layer stays canonical, local-first, and tethered to real system state.

-**AutoLoRA** — Training pipeline. Extracts conversations into training data, fine-tunes on Apple Silicon via MLX. First model: `timmy:v0.1-q4` (4.9GB, runs local). The corpus grows with every conversation.
+### timmy-config
+The soul overlay.
+- SOUL.md
+- config
+- skins
+- playbooks
+- orchestration glue

-**Timmy Config** — The soul overlay. SOUL.md (inscribed on Bitcoin), operational config, deploy scripts. Applied as a sidecar to the Hermes harness.
+### timmy-home
+The lived workspace.
+- training artifacts
+- research
+- reports
+- notes
+- metrics
+- gameplay traces

-## Architecture
+### OpenClaw
+Local sidecar only.
+Useful for:
+- operator UX
+- channel experiments
+- session-bus experiments

-```
-              THE NEXUS (Three.js)
-             Timmy's sovereign home
-                    │
-     ┌──────────────┼──────────────┐
-     │              │              │
-  Portals      Workshop      Presence
-  (worlds)   (Hermes API)   (local AI)
-     │              │              │
-     │    SOVEREIGN ORCHESTRATION  │
-     │    SQLite + Python executor │
-     │              │              │
-     │         AUTOLORA            │
-     │    MLX training pipeline    │
-     │    timmy:v0.1-q4 (local)   │
-     │              │              │
-     └──────── HERMES HARNESS ─────┘
-           The operational layer
-```
+Not the authority for:
+- Timmy's conscience
+- training center
+- durable telemetry truth

-## Repos
+## Canonical Repos

-| Repo | Purpose | Status |
-|------|---------|--------|
-| [the-nexus](the-nexus) | Timmy's 3D home — Three.js world | Active |
-| [sovereign-orchestration](sovereign-orchestration) | Agent workforce brain — SQLite + Python | Active |
-| [autolora](autolora) | MLX fine-tuning pipeline, timmy:v0.1-q4 | Active |
-| [timmy-config](timmy-config) | Soul, config, deploy overlay | Active |
+| Repo | Purpose | Current Role |
+|------|---------|--------------|
+| [the-nexus](http://143.198.27.163:3000/Timmy_Foundation/the-nexus) | Canonical 3D/home-world repo | Active, under truthful rebuild |
+| [timmy-config](http://143.198.27.163:3000/Timmy_Foundation/timmy-config) | Soul/config/sidecar authority | Active |
+| [timmy-home](http://143.198.27.163:3000/Timmy_Foundation/timmy-home) | Workspace, reports, training ground | Active |
+| [.profile](http://143.198.27.163:3000/Timmy_Foundation/.profile) | Org profile / landing page | Active |

 ## The Team

@@ -63,15 +106,33 @@ The Timmy Foundation builds sovereign AI infrastructure — systems that run on
 |------|-----|--------|
 | **Founder** | Alexander (@rockachopa) | Owner |
 | **Lead Orchestrator** | Timmy | Owner |
-| **Workers** | claude, gemini, kimi, groq, grok | Write — push branches, create PRs |
-| **Researchers** | perplexity, google, manus | Write — reports and findings |
-| **Observers** | antigravity, hermes | Read-only |
+| **Workers** | claude, gemini, kimi, grok, groq | Write — branches, PRs, bounded implementation |
+| **Researchers** | perplexity, google, manus | Research, reports, briefings |
+| **Observers** | hermes, antigravity | Read / review / support |

-## Sovereignty Score
+## Operating Principles

-Current: **2.5% local** (as of 2026-03-25)
+- One canonical 3D repo.
+- No ghost worlds.
+- Visual changes require screenshot proof.
+- CLI/verifiable changes require logs, output, or world-state proof.
+- Screenshots/media stay out of Gitea backup unless explicitly needed.
+- No proof, no merge.

-Target: 80% by end of Q2 2026. Every cloud call we eliminate matters.
+## Sovereignty Meter
+
+Current strategic direction:
+- maximize local throughput
+- measure cloud vs local token use continuously
+- push routine work down to local inference wherever possible
+- keep cloud use explicit and justified
+
+## Foundation Links
+
+- [Alexander Whitestone](https://alexanderwhitestone.com)
+- [Timmy Foundation on Gitea](http://143.198.27.163:3000/Timmy_Foundation)
+- [Production Nexus](http://143.198.27.163/)
+- [Rebuild issue for staging Nexus](http://143.198.27.163:3000/Timmy_Foundation/the-nexus/issues/687)

 ---

@@ -79,6 +140,4 @@ Target: 80% by end of Q2 2026. Every cloud call we eliminate matters.

 *Sovereignty and service always.*

-**[alexanderwhitestone.com](https://alexanderwhitestone.com)**
-
 </div>
--- a/tests/test_profile_readme.py
+++ b/tests/test_profile_readme.py
@@ -0,0 +1,20 @@
+from pathlib import Path
+
+
+def test_profile_readme_has_dynamic_portal_section() -> None:
+    readme = Path("README.md").read_text()
+
+    assert "Portal Deck" in readme
+    assert "production nexus" in readme.lower()
+    assert "staging nexus" in readme.lower()
+    assert "openclaw sidecar" in readme.lower()
+    assert "forge / gitea" in readme.lower()
+
+
+def test_profile_readme_uses_absolute_repo_links_and_status_badges() -> None:
+    readme = Path("README.md").read_text()
+
+    assert "http://143.198.27.163:3000/Timmy_Foundation/the-nexus" in readme
+    assert "http://143.198.27.163:3000/Timmy_Foundation/timmy-config" in readme
+    assert "img.shields.io/website" in readme
+    assert "127.0.0.1:18789" in readme