[claude] Vassal Protocol — Timmy as autonomous orchestrator (#1070) #1142

claude · 2026-03-23T18:32:51Z

claude commented

2026-03-23 18:32:51 +00:00

What this implements

The Vassal Protocol core infrastructure — Timmy as lead decision-maker for development direction, agent management, and house health.

New module: `src/timmy/vassal/`

File	Purpose
`backlog.py`	Gitea fetch + triage: priority scoring + agent routing (Claude / Kimi / Timmy-self)
`dispatch.py`	Apply `claude-ready` / `kimi-ready` labels + routing comments; in-memory dispatch registry
`agent_health.py`	Detect idle/stuck agents via last-comment heuristic; nudge stuck issues
`house_health.py`	System resource snapshot (disk, memory via psutil, Ollama reachability); stale-file cleanup
`orchestration_loop.py`	`VassalOrchestrator`: observe → triage → dispatch → monitor → house-check cycle; WebSocket broadcast

Config

Five new vassal_* settings added to Settings — all False/off by default (safe to merge, enable when Qwen3-14B is loaded per #1064):

vassal_enabled �� master switch
vassal_cycle_interval — seconds between cycles (default 300)
vassal_max_dispatch_per_cycle — cap on new dispatches per cycle
vassal_stuck_threshold_minutes — silence threshold for stuck detection
vassal_idle_threshold_minutes — idle detection threshold

Tests

40 new unit tests across 5 test files. All pass. All modules gracefully degrade when Gitea / Ollama are unavailable.

Fixes #1070 ## What this implements The Vassal Protocol core infrastructure — Timmy as lead decision-maker for development direction, agent management, and house health. ## New module: `src/timmy/vassal/` | File | Purpose | |------|---------| | `backlog.py` | Gitea fetch + triage: priority scoring + agent routing (Claude / Kimi / Timmy-self) | | `dispatch.py` | Apply `claude-ready` / `kimi-ready` labels + routing comments; in-memory dispatch registry | | `agent_health.py` | Detect idle/stuck agents via last-comment heuristic; nudge stuck issues | | `house_health.py` | System resource snapshot (disk, memory via psutil, Ollama reachability); stale-file cleanup | | `orchestration_loop.py` | `VassalOrchestrator`: observe → triage → dispatch → monitor → house-check cycle; WebSocket broadcast | ## Config Five new `vassal_*` settings added to `Settings` — all `False`/off by default (safe to merge, enable when Qwen3-14B is loaded per #1064): - `vassal_enabled` �� master switch - `vassal_cycle_interval` — seconds between cycles (default 300) - `vassal_max_dispatch_per_cycle` — cap on new dispatches per cycle - `vassal_stuck_threshold_minutes` — silence threshold for stuck detection - `vassal_idle_threshold_minutes` — idle detection threshold ## Tests 40 new unit tests across 5 test files. All pass. All modules gracefully degrade when Gitea / Ollama are unavailable.

claude added 1 commit 2026-03-23 18:32:52 +00:00

feat: Vassal Protocol — Timmy as autonomous orchestrator (#1070 )

Tests / lint (pull_request) Failing after 16s

Details

Tests / test (pull_request) Has been skipped

Details

2618694b22

Implements the core Vassal Protocol infrastructure: Timmy as the
lead decision-maker for development direction, agent management,
and house health on Hermes (M3 Max).

New module: src/timmy/vassal/
  - backlog.py     — Gitea backlog fetch, triage (priority scoring +
                     agent routing: Claude / Kimi / Timmy-self)
  - dispatch.py    — Apply claude-ready / kimi-ready labels and post
                     routing comments; in-memory dispatch registry
  - agent_health.py — Detect idle/stuck agents (last-comment heuristic),
                      nudge stuck issues via Gitea comment
  - house_health.py — System resource snapshot (disk, memory via psutil,
                      Ollama reachability), stale-file cleanup
  - orchestration_loop.py — VassalOrchestrator: ties all four into a
                     single observe→triage→dispatch→monitor→house-check
                     cycle; runs as background asyncio task; broadcasts
                     via WebSocket

Config: five new vassal_* settings in Settings (all off by default:
  vassal_enabled, vassal_cycle_interval, vassal_max_dispatch_per_cycle,
  vassal_stuck_threshold_minutes, vassal_idle_threshold_minutes)

Tests: 40 new unit tests across five test files — all pass.
All gracefully degrade when Gitea / Ollama are unavailable.

Refs #1070

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

claude referenced this pull request

2026-03-23 18:33:01 +00:00

[GOVERNING] Timmy as Autonomous Orchestrator — Vassal Protocol #1070

claude merged commit 128aa4427f into main

2026-03-23 18:33:16 +00:00

claude deleted branch claude/issue-1070

2026-03-23 18:33:17 +00:00

claude referenced this issue from a commit

2026-03-23 18:33:17 +00:00

[claude] Vassal Protocol — Timmy as autonomous orchestrator (#1070) (#1142)

Sign in to join this conversation.