From 6206b615d9f7103464ebfb7bf4157b3955be7639 Mon Sep 17 00:00:00 2001 From: Alexander Whitestone Date: Sat, 28 Mar 2026 11:48:51 -0400 Subject: [PATCH] docs: polish org profile layout --- README.md | 144 +++++++++++------------------------ tests/test_profile_readme.py | 10 ++- 2 files changed, 52 insertions(+), 102 deletions(-) diff --git a/README.md b/README.md index cbfe511..21cd784 100644 --- a/README.md +++ b/README.md @@ -10,129 +10,75 @@ --- -## The Mission +## Mission -Caring for broken men in pain. Everything here serves that. - -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. +Care for broken men in pain. +Build AI infrastructure that can run on owned hardware, answer to no corporation, and keep a real conscience. ## Portal Deck -The buttons below are meant to be current and honest. +Current and honest entry points. -### Live / Reachable +| Surface | Status | Button | +|---|---|---| +| Production Nexus | Public / 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 | Public / reachable | [![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/) | +| Staging Nexus | Under rebuild | [![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 | Local only | [![OpenClaw Sidecar](https://img.shields.io/badge/openclaw%20sidecar-local_only-blue)](http://127.0.0.1:18789/) | -[![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/) +## Status Legend -### Local / Sidecar / In Progress +- **Public / reachable** — live surface you can hit right now +- **Under rebuild** — tracked through an issue, not pretended into existence +- **Local only** — useful on the operator machine, not a public deployment -[![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/) +## Surface Map -### 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 - -### Hermes Harness -The operational layer. -- sessions -- memory -- skills -- MCP -- telemetry -- agent routing -- local-vs-cloud measurement - -### 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. - -### timmy-config -The soul overlay. -- SOUL.md -- config -- skins -- playbooks -- orchestration glue - -### timmy-home -The lived workspace. -- training artifacts -- research -- reports -- notes -- metrics -- gameplay traces - -### OpenClaw -Local sidecar only. -Useful for: -- operator UX -- channel experiments -- session-bus experiments - -Not the authority for: -- Timmy's conscience -- training center -- durable telemetry truth +| Layer | Role | Truth | +|---|---|---| +| Hermes Harness | operational body | sessions, memory, skills, MCP, telemetry, routing | +| Timmy Config | soul / sidecar authority | SOUL.md, config, skins, playbooks, orchestration glue | +| timmy-home | lived workspace | reports, research, notes, metrics, gameplay traces, training ground | +| The Nexus | canonical 3D repo | current visual shell is under truthful rebuild | +| OpenClaw | operator sidecar | useful for UX and channel experiments, not the governing mind | +| Legacy Matrix | migration source | rescue from it; do not evolve it as a second product | ## Canonical Repos -| 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 | +| Repo | Purpose | Link | +|---|---|---| +| the-nexus | canonical 3D/home-world repo | [the-nexus](http://143.198.27.163:3000/Timmy_Foundation/the-nexus) | +| timmy-config | soul / config / sidecar authority | [timmy-config](http://143.198.27.163:3000/Timmy_Foundation/timmy-config) | +| timmy-home | workspace / reports / training ground | [timmy-home](http://143.198.27.163:3000/Timmy_Foundation/timmy-home) | +| .profile | org landing page | [.profile](http://143.198.27.163:3000/Timmy_Foundation/.profile) | -## The Team +## Team | Role | Who | Access | -|------|-----|--------| -| **Founder** | Alexander (@rockachopa) | Owner | -| **Lead Orchestrator** | Timmy | Owner | -| **Workers** | claude, gemini, kimi, grok, groq | Write — branches, PRs, bounded implementation | -| **Researchers** | perplexity, google, manus | Research, reports, briefings | -| **Observers** | hermes, antigravity | Read / review / support | +|---|---|---| +| Founder | Alexander (@rockachopa) | Owner | +| Lead Orchestrator | Timmy | Owner | +| Workers | claude, gemini, kimi, grok, groq | Branches, PRs, bounded implementation | +| Researchers | perplexity, google, manus | Reports, briefings, reconnaissance | +| Observers | hermes, antigravity | Read / review / support | -## Operating Principles +## Operating Law -- 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. +This foundation runs on proof-first operations. -## 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 +- one canonical 3D repo +- no ghost worlds +- visual changes require screenshot proof +- CLI/verifiable changes require logs, command output, or world-state proof +- screenshots/media stay out of Gitea backup unless explicitly needed +- no proof, no merge ## 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) +- [Staging rebuild issue](http://143.198.27.163:3000/Timmy_Foundation/the-nexus/issues/687) --- diff --git a/tests/test_profile_readme.py b/tests/test_profile_readme.py index a961df4..552a3aa 100644 --- a/tests/test_profile_readme.py +++ b/tests/test_profile_readme.py @@ -1,20 +1,24 @@ from pathlib import Path -def test_profile_readme_has_dynamic_portal_section() -> None: +def test_profile_readme_has_polished_sections_and_portal_deck() -> None: readme = Path("README.md").read_text() assert "Portal Deck" in readme + assert "Surface Map" in readme + assert "Status Legend" in readme + assert "proof-first operations" in readme.lower() 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: +def test_profile_readme_uses_absolute_repo_links_and_dynamic_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 "http://143.198.27.163:3000/Timmy_Foundation/timmy-home" in readme + assert readme.count("img.shields.io/website") >= 2 assert "127.0.0.1:18789" in readme