2d3cea8127
- add crucible_mcp_server.py with Z3-backed proof tools - ship scheduling, dependency ordering, and capacity templates - log SAT/UNSAT proof trails to ~/.hermes/logs/crucible/ - wire crucible MCP server into config.yaml - teach deploy.sh to ensure z3-solver is installed - add verified-logic playbook and docs for first cut
105 lines
4.6 KiB
Markdown
105 lines
4.6 KiB
Markdown
# timmy-config
|
|
|
|
Timmy's sovereign configuration. Everything that makes Timmy _Timmy_ — soul, memories, skins, playbooks, operational scripts, and config.
|
|
|
|
This repo is the canonical source of truth for Timmy's identity and operational state. Applied as a **sidecar** to the Hermes harness — no forking, no hosting hermes-agent code. Pull upstream updates to hermes-agent, overlay timmy-config on top.
|
|
|
|
## Structure
|
|
|
|
```
|
|
timmy-config/
|
|
├── deploy.sh ← Deploys config as overlay onto ~/.hermes/
|
|
├── SOUL.md ← Inscription 1 — the immutable conscience
|
|
├── FALSEWORK.md ← API cost management strategy
|
|
├── config.yaml ← Hermes harness configuration
|
|
├── channel_directory.json ← Platform channel mappings
|
|
├── bin/ ← Operational scripts
|
|
│ ├── claude-loop.sh ← Parallel Claude Code agent dispatch
|
|
│ ├── gemini-loop.sh ← Parallel Gemini Code agent dispatch
|
|
│ ├── timmy-orchestrator.sh ← PR review, triage, merge orchestration
|
|
│ ├── workforce-manager.py ← Agent assignment and scoring
|
|
│ ├── agent-dispatch.sh ← Single-issue agent launcher
|
|
│ ├── agent-loop.sh ← Generic agent loop template
|
|
│ ├── nexus-merge-bot.sh ← Auto-merge passing PRs
|
|
│ ├── claudemax-watchdog.sh ← Claude quota monitoring
|
|
│ ├── hermes-startup.sh ← Boot sequence
|
|
│ ├── ops-panel.sh ← Operational dashboard
|
|
│ ├── ops-helpers.sh ← Shared shell functions
|
|
│ ├── ops-gitea.sh ← Gitea API helpers
|
|
│ ├── timmy-status.sh ← Git + Gitea status display
|
|
│ ├── timmy-loopstat.sh ← Queue and perf stats
|
|
│ ├── hotspot-keepalive.sh ← Network keepalive
|
|
│ └── crucible_mcp_server.py ← Z3-backed verification sidecar (MCP)
|
|
├── memories/
|
|
│ ├── MEMORY.md ← Persistent agent memory
|
|
│ └── USER.md ← User profile (Alexander)
|
|
├── skins/
|
|
│ ├── timmy.yaml ← Timmy personality skin
|
|
│ └── trismegistus.yaml ← Trismegistus personality skin
|
|
├── playbooks/
|
|
│ ├── bug-fixer.yaml ← Test-first bug fixing
|
|
│ ├── refactor-specialist.yaml
|
|
│ ├── test-writer.yaml
|
|
│ ├── security-auditor.yaml
|
|
│ ├── issue-triager.yaml
|
|
│ ├── pr-reviewer.yaml
|
|
│ └── verified-logic.yaml ← Crucible-first proof playbook
|
|
├── cron/
|
|
│ └── jobs.json ← Scheduled job definitions
|
|
└── docs/
|
|
└── design-log/ ← Historical design decisions
|
|
```
|
|
|
|
## Deployment
|
|
|
|
```bash
|
|
# One command deploys everything
|
|
./deploy.sh
|
|
|
|
# Deploy and restart the gateway so new MCP tools load
|
|
./deploy.sh --restart-gateway
|
|
|
|
# Deploy and restart everything (gateway + loops)
|
|
./deploy.sh --restart-all
|
|
```
|
|
|
|
This overlays timmy-config onto `~/.hermes/` and `~/.timmy/`:
|
|
- `SOUL.md` → `~/.timmy/`
|
|
- `config.yaml` → `~/.hermes/`
|
|
- `bin/*` → `~/.hermes/bin/`
|
|
- `skins/*` → `~/.hermes/skins/`
|
|
- `memories/*` → `~/.hermes/memories/`
|
|
- `playbooks/*` → `~/.hermes/playbooks/`
|
|
|
|
## Crucible First Cut
|
|
|
|
The first neuro-symbolic slice ships as a sidecar MCP server:
|
|
- `mcp_crucible_schedule_tasks`
|
|
- `mcp_crucible_order_dependencies`
|
|
- `mcp_crucible_capacity_fit`
|
|
|
|
These tools log proof trails under `~/.hermes/logs/crucible/` and return SAT/UNSAT plus witness models.
|
|
|
|
## Architecture: Sidecar, Not Fork
|
|
|
|
```
|
|
hermes-agent (upstream) timmy-config (this repo)
|
|
┌─────────────────────┐ ┌──────────────────────┐
|
|
│ Engine │ │ Driver's seat │
|
|
│ Tools, routing, │ │ SOUL, memories, │
|
|
│ agent loop, gateway │ │ skins, scripts, │
|
|
│ │ │ config, playbooks │
|
|
└─────────┬───────────┘ └──────────┬───────────┘
|
|
│ │
|
|
└────────────┬───────────────┘
|
|
▼
|
|
~/.hermes/ (merged at deploy time)
|
|
```
|
|
|
|
Never modify hermes-agent. Pull updates like any upstream dependency. Everything custom lives here.
|
|
|
|
## Origin
|
|
|
|
Migrated from `hermes/hermes-config` (archived).
|
|
Owned by Timmy_Foundation. Sovereignty and service always.
|