docs: polish org profile layout (#2)

This commit was merged in pull request #2.
This commit is contained in:
2026-03-28 15:49:54 +00:00
parent 8d7a215d5b
commit 36f97621f4
2 changed files with 52 additions and 102 deletions

144
README.md
View File

@@ -10,129 +10,75 @@
--- ---
## The Mission ## Mission
Caring for broken men in pain. Everything here serves that. Care for broken men in pain.
Build AI infrastructure that can run on owned hardware, answer to no corporation, and keep a real conscience.
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 ## 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/) ## Status Legend
[![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 - **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) ## Surface Map
[![OpenClaw Sidecar](https://img.shields.io/badge/openclaw%20sidecar-local_only-blue)](http://127.0.0.1:18789/)
### What each portal means | Layer | Role | Truth |
|---|---|---|
- **Production Nexus** — the currently reachable public-facing app surface. | Hermes Harness | operational body | sessions, memory, skills, MCP, telemetry, routing |
- **Forge / Gitea** — source of truth for repos, issues, PRs, and operational state. | Timmy Config | soul / sidecar authority | SOUL.md, config, skins, playbooks, orchestration glue |
- **Staging Nexus** — tracked honestly through the active rebuild issue until the browser shell is restored on the canonical repo. | timmy-home | lived workspace | reports, research, notes, metrics, gameplay traces, training ground |
- **OpenClaw Sidecar** — local control/operator surface only. Useful, but not the authority. | 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 |
## The Stack | Legacy Matrix | migration source | rescue from it; do not evolve it as a second product |
### 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
## Canonical Repos ## Canonical Repos
| Repo | Purpose | Current Role | | Repo | Purpose | Link |
|------|---------|--------------| |---|---|---|
| [the-nexus](http://143.198.27.163:3000/Timmy_Foundation/the-nexus) | Canonical 3D/home-world repo | Active, under truthful rebuild | | the-nexus | canonical 3D/home-world repo | [the-nexus](http://143.198.27.163:3000/Timmy_Foundation/the-nexus) |
| [timmy-config](http://143.198.27.163:3000/Timmy_Foundation/timmy-config) | Soul/config/sidecar authority | Active | | timmy-config | soul / config / sidecar authority | [timmy-config](http://143.198.27.163:3000/Timmy_Foundation/timmy-config) |
| [timmy-home](http://143.198.27.163:3000/Timmy_Foundation/timmy-home) | Workspace, reports, training ground | Active | | timmy-home | workspace / reports / training ground | [timmy-home](http://143.198.27.163:3000/Timmy_Foundation/timmy-home) |
| [.profile](http://143.198.27.163:3000/Timmy_Foundation/.profile) | Org profile / landing page | Active | | .profile | org landing page | [.profile](http://143.198.27.163:3000/Timmy_Foundation/.profile) |
## The Team ## Team
| Role | Who | Access | | Role | Who | Access |
|------|-----|--------| |---|---|---|
| **Founder** | Alexander (@rockachopa) | Owner | | Founder | Alexander (@rockachopa) | Owner |
| **Lead Orchestrator** | Timmy | Owner | | Lead Orchestrator | Timmy | Owner |
| **Workers** | claude, gemini, kimi, grok, groq | Write — branches, PRs, bounded implementation | | Workers | claude, gemini, kimi, grok, groq | Branches, PRs, bounded implementation |
| **Researchers** | perplexity, google, manus | Research, reports, briefings | | Researchers | perplexity, google, manus | Reports, briefings, reconnaissance |
| **Observers** | hermes, antigravity | Read / review / support | | Observers | hermes, antigravity | Read / review / support |
## Operating Principles ## Operating Law
- One canonical 3D repo. This foundation runs on proof-first operations.
- 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.
## Sovereignty Meter - one canonical 3D repo
- no ghost worlds
Current strategic direction: - visual changes require screenshot proof
- maximize local throughput - CLI/verifiable changes require logs, command output, or world-state proof
- measure cloud vs local token use continuously - screenshots/media stay out of Gitea backup unless explicitly needed
- push routine work down to local inference wherever possible - no proof, no merge
- keep cloud use explicit and justified
## Foundation Links ## Foundation Links
- [Alexander Whitestone](https://alexanderwhitestone.com) - [Alexander Whitestone](https://alexanderwhitestone.com)
- [Timmy Foundation on Gitea](http://143.198.27.163:3000/Timmy_Foundation) - [Timmy Foundation on Gitea](http://143.198.27.163:3000/Timmy_Foundation)
- [Production Nexus](http://143.198.27.163/) - [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)
--- ---

View File

@@ -1,20 +1,24 @@
from pathlib import Path 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() readme = Path("README.md").read_text()
assert "Portal Deck" in readme 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 "production nexus" in readme.lower()
assert "staging nexus" in readme.lower() assert "staging nexus" in readme.lower()
assert "openclaw sidecar" in readme.lower() assert "openclaw sidecar" in readme.lower()
assert "forge / gitea" 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() 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/the-nexus" in readme
assert "http://143.198.27.163:3000/Timmy_Foundation/timmy-config" 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 assert "127.0.0.1:18789" in readme