Timmy_Foundation/.profile
16
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: polish org profile layout #2

Merged
Timmy merged 1 commits from docs/polish-profile-v2 into main 2026-03-28 15:49:54 +00:00
Conversation 0 Commits 1 Files Changed 2 +52 -102
2 changed files with 52 additions and 102 deletions
Download Patch File Download Diff File Expand all files Collapse all files

144
README.md
View File

@@ -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)
---

10
tests/test_profile_readme.py
View File

@@ -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