docs: polish org profile layout (#2)
This commit was merged in pull request #2.
This commit is contained in:
144
README.md
144
README.md
@@ -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 | [](http://143.198.27.163/) |
|
||||||
|
| Forge / Gitea | Public / reachable | [](http://143.198.27.163:3000/) |
|
||||||
|
| Staging Nexus | Under rebuild | [](http://143.198.27.163:3000/Timmy_Foundation/the-nexus/issues/687) |
|
||||||
|
| OpenClaw Sidecar | Local only | [](http://127.0.0.1:18789/) |
|
||||||
|
|
||||||
[](http://143.198.27.163/)
|
## Status Legend
|
||||||
[](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
|
||||||
|
|
||||||
[](http://143.198.27.163:3000/Timmy_Foundation/the-nexus/issues/687)
|
## Surface Map
|
||||||
[](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)
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
@@ -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
|
||||||
|
|||||||
Reference in New Issue
Block a user