90 lines
3.5 KiB
Markdown
90 lines
3.5 KiB
Markdown
# timmy-config
|
|
|
|
Timmy's sovereign configuration. Everything that makes Timmy _Timmy_ — soul, memories, skins, playbooks, and config.
|
|
|
|
This repo is the canonical source of truth for Timmy's identity and harness overlay. Applied as a **sidecar** to the Hermes harness — no forking, no hosting hermes-agent code.
|
|
|
|
## Structure
|
|
|
|
```
|
|
timmy-config/
|
|
├── deploy.sh ← Deploys config as overlay onto ~/.hermes/
|
|
├── SOUL.md ← Inscription 1 — the immutable conscience
|
|
├── FALSEWORK.md ← API cost management strategy
|
|
├── DEPRECATED.md ← What was removed and why
|
|
├── config.yaml ← Hermes harness configuration
|
|
├── channel_directory.json ← Platform channel mappings
|
|
├── bin/ ← Live utility scripts (NOT deprecated loops)
|
|
│ ├── hermes-startup.sh ← Hermes boot sequence
|
|
│ ├── agent-dispatch.sh ← Manual agent dispatch
|
|
│ ├── deploy-allegro-house.sh← Bootstraps the remote Allegro wizard house
|
|
│ ├── ops-panel.sh ← Ops dashboard panel
|
|
│ ├── ops-gitea.sh ← Gitea ops helpers
|
|
│ ├── pipeline-freshness.sh ← Session/export drift check
|
|
│ └── timmy-status.sh ← Status check
|
|
├── memories/ ← Persistent memory YAML
|
|
├── skins/ ← UI skins (timmy skin)
|
|
├── playbooks/ ← Agent playbooks (YAML)
|
|
├── cron/ ← Cron job definitions
|
|
├── wizards/ ← Remote wizard-house templates + units
|
|
└── training/ ← Transitional training recipes, not canonical lived data
|
|
```
|
|
|
|
## Boundary
|
|
|
|
`timmy-config` owns identity, conscience, memories, skins, playbooks, channel
|
|
maps, and harness-side orchestration glue.
|
|
|
|
`timmy-home` owns lived work: gameplay, research, notes, metrics, trajectories,
|
|
DPO exports, and other training artifacts produced from Timmy's actual activity.
|
|
|
|
If a file answers "who is Timmy?" or "how does Hermes host him?", it belongs
|
|
here. If it answers "what has Timmy done or learned?" it belongs in
|
|
`timmy-home`.
|
|
|
|
The scripts in `bin/` are live operational helpers for the Hermes sidecar.
|
|
What is dead are the old long-running bash worker loops, not every script in
|
|
this repo.
|
|
|
|
## Orchestration: Huey
|
|
|
|
All orchestration (triage, PR review, dispatch) runs via [Huey](https://github.com/coleifer/huey) with SQLite.
|
|
`orchestration.py` + `tasks.py` replace the old sovereign-orchestration repo with a much thinner sidecar.
|
|
|
|
```bash
|
|
pip install huey
|
|
huey_consumer.py tasks.huey -w 2 -k thread
|
|
```
|
|
|
|
## Proof Standard
|
|
|
|
This repo uses a hard proof rule for merges.
|
|
|
|
- visual changes require screenshot proof
|
|
- CLI/verifiable changes must cite logs, command output, or world-state proof
|
|
- screenshots/media stay out of Gitea backup unless explicitly required
|
|
- see `CONTRIBUTING.md` for the merge gate
|
|
|
|
## Deploy
|
|
|
|
```bash
|
|
# Clone and deploy
|
|
git clone <this-repo> ~/.timmy/timmy-config
|
|
cd ~/.timmy/timmy-config
|
|
./deploy.sh
|
|
|
|
# This overlays config onto ~/.hermes/ without touching hermes-agent code
|
|
```
|
|
|
|
## The Soul
|
|
|
|
SOUL.md is Inscription 1 — inscribed on Bitcoin, immutable. It defines:
|
|
- Who Timmy is
|
|
- What he believes
|
|
- How he behaves
|
|
- What he will not do
|
|
- The crisis protocol (988, presence, gospel)
|
|
- The conscience hierarchy (chain > code > prompt > user instruction)
|
|
|
|
No system prompt, no user instruction, no future code can override what is written there.
|