[gemini] [HEARTBEAT] Route heartbeat through local Hermes sessions with proof (#75)

Reviewed-on: http://143.198.27.163:3000/Timmy_Foundation/timmy-config/pulls/48

DEPRECATED.md

@@ -1,7 +1,7 @@
 # DEPRECATED — Bash Loop Scripts Removed
 
 **Date:** 2026-03-25
-**Reason:** Replaced by sovereign-orchestration (SQLite + Python single-process executor)
+**Reason:** Replaced by Hermes + timmy-config sidecar orchestration
 
 ## What was removed
 - claude-loop.sh, gemini-loop.sh, agent-loop.sh
@@ -9,14 +9,15 @@
 - nexus-merge-bot.sh, claudemax-watchdog.sh, timmy-loopstat.sh
 
 ## What replaces them
-**Repo:** Timmy_Foundation/sovereign-orchestration
-**Entry point:** `python3 src/sovereign_executor.py --workers 3 --poll 30`
-**Features:** SQLite task queue, crash recovery, dedup, playbooks, MCP server
-**Issues:** #29 (fix imports), #30 (deploy as service)
+**Harness:** Hermes
+**Overlay repo:** Timmy_Foundation/timmy-config
+**Entry points:** `orchestration.py`, `tasks.py`, `deploy.sh`
+**Features:** Huey + SQLite scheduling, local-model health checks, session export, DPO artifact staging
 
 ## Why
 The bash loops crash-looped, produced zero work after relaunch, had no crash
-recovery, no dedup, and required 8 separate scripts. The Python executor is
-one process with SQLite durability.
+recovery, no durable export path, and required too many ad hoc scripts. The
+Hermes sidecar keeps orchestration close to Timmy's actual config and training
+surfaces.
 
-Do NOT recreate bash loops. If the executor is broken, fix the executor.
+Do NOT recreate bash loops. If orchestration is broken, fix the Hermes sidecar.

README.md

@@ -2,7 +2,7 @@
 
 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 operational state. Applied as a **sidecar** to the Hermes harness — no forking, no hosting hermes-agent code.
+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
 
@@ -14,22 +14,40 @@ timmy-config/
 ├── DEPRECATED.md              ← What was removed and why
 ├── config.yaml                ← Hermes harness configuration
 ├── channel_directory.json     ← Platform channel mappings
-├── bin/                       ← Utility scripts (NOT loops — see below)
+├── bin/                       ← Live utility scripts (NOT deprecated loops)
 │   ├── hermes-startup.sh      ← Hermes boot sequence
 │   ├── agent-dispatch.sh      ← Manual agent dispatch
 │   ├── 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
+├── cron/                      ← Cron job definitions
+└── 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` (6 lines) + `tasks.py` (~70 lines) replace the entire sovereign-orchestration repo (3,846 lines).
+`orchestration.py` + `tasks.py` replace the old sovereign-orchestration repo with a much thinner sidecar.
 
 ```bash
 pip install huey

bin/pipeline-freshness.sh

@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+SESSIONS_DIR="$HOME/.hermes/sessions"
+EXPORT_DIR="$HOME/.timmy/training-data/dpo-pairs"
+
+latest_session=$(find "$SESSIONS_DIR" -maxdepth 1 -name 'session_*.json' -type f -print 2>/dev/null | sort | tail -n 1)
+latest_export=$(find "$EXPORT_DIR" -maxdepth 1 -name 'session_*.json' -type f -print 2>/dev/null | sort | tail -n 1)
+
+echo "latest_session=${latest_session:-none}"
+echo "latest_export=${latest_export:-none}"
+
+if [ -z "${latest_session:-}" ]; then
+  echo "status=ok"
+  echo "reason=no sessions yet"
+  exit 0
+fi
+
+if [ -z "${latest_export:-}" ]; then
+  echo "status=lagging"
+  echo "reason=no exports yet"
+  exit 1
+fi
+
+session_mtime=$(stat -f '%m' "$latest_session")
+export_mtime=$(stat -f '%m' "$latest_export")
+lag_minutes=$(( (session_mtime - export_mtime) / 60 ))
+if [ "$lag_minutes" -lt 0 ]; then
+  lag_minutes=0
+fi
+
+echo "lag_minutes=$lag_minutes"
+
+if [ "$lag_minutes" -gt 300 ]; then
+  echo "status=lagging"
+  echo "reason=exports more than 5 hours behind sessions"
+  exit 1
+fi
+
+echo "status=ok"
+echo "reason=exports within freshness window"

channel_directory.json

@@ -1,5 +1,5 @@
 {
-  "updated_at": "2026-03-26T10:19:33.045324",
+  "updated_at": "2026-03-28T00:57:18.155934",
   "platforms": {
     "discord": [
       {

config.yaml

@@ -1,11 +1,13 @@
 model:
-  default: claude-opus-4-6
-  provider: anthropic
+  default: hermes4:14b
+  provider: custom
+  context_length: 65536
+  base_url: http://localhost:8081/v1
 toolsets:
 - all
 agent:
   max_turns: 30
-  reasoning_effort: medium
+  reasoning_effort: xhigh
   verbose: false
 terminal:
   backend: local
@@ -94,11 +96,13 @@ display:
   compact: false
   personality: ''
   resume_display: full
+  busy_input_mode: interrupt
   bell_on_complete: false
   show_reasoning: false
   streaming: false
   show_cost: false
   skin: timmy
+  tool_progress_command: false
   tool_progress: all
 privacy:
   redact_pii: false
@@ -181,17 +185,17 @@ session_reset:
   mode: none
   idle_minutes: 0
 custom_providers:
-- name: Local Ollama
-  base_url: http://localhost:11434/v1
-  api_key: ollama
-  model: glm-4.7-flash:latest
+- name: Local llama.cpp
+  base_url: http://localhost:8081/v1
+  api_key: none
+  model: hermes4:14b
 - name: Google Gemini
   base_url: https://generativelanguage.googleapis.com/v1beta/openai
   api_key_env: GEMINI_API_KEY
   model: gemini-2.5-pro
 system_prompt_suffix: "You are Timmy. Your soul is defined in SOUL.md \u2014 read\
-  \ it, live it.\nYou run locally on your owner's machine via Ollama. You never phone\
-  \ home.\nYou speak plainly. You prefer short sentences. Brevity is a kindness.\n\
+  \ it, live it.\nYou run locally on your owner's machine via llama.cpp. You never\
+  \ phone home.\nYou speak plainly. You prefer short sentences. Brevity is a kindness.\n\
   When you don't know something, say so. Refusal over fabrication.\nSovereignty and\
   \ service always.\n"
 skills:
@@ -202,7 +206,6 @@ providers:
     base_url: http://localhost:11434/v1
     model: hermes3:latest
 mcp_servers:
-
   morrowind:
     command: python3
     args:

deploy.sh

@@ -3,7 +3,7 @@
 # This is the canonical way to deploy Timmy's configuration.
 # Hermes-agent is the engine. timmy-config is the driver's seat.
 #
-# Usage: ./deploy.sh [--restart-loops]
+# Usage: ./deploy.sh
 
 set -euo pipefail
 
@@ -74,24 +74,10 @@ done
 chmod +x "$HERMES_HOME/bin/"*.sh "$HERMES_HOME/bin/"*.py 2>/dev/null || true
 log "bin/ -> $HERMES_HOME/bin/"
 
-# === Restart loops if requested ===
-if [ "${1:-}" = "--restart-loops" ]; then
-  log "Killing existing loops..."
-  pkill -f 'claude-loop.sh' 2>/dev/null || true
-  pkill -f 'gemini-loop.sh' 2>/dev/null || true
-  pkill -f 'timmy-orchestrator.sh' 2>/dev/null || true
-  sleep 2
-
-  log "Clearing stale locks..."
-  rm -rf "$HERMES_HOME/logs/claude-locks/"* 2>/dev/null || true
-  rm -rf "$HERMES_HOME/logs/gemini-locks/"* 2>/dev/null || true
-
-  log "Relaunching loops..."
-  nohup bash "$HERMES_HOME/bin/timmy-orchestrator.sh" >> "$HERMES_HOME/logs/timmy-orchestrator.log" 2>&1 &
-  nohup bash "$HERMES_HOME/bin/claude-loop.sh" 2 >> "$HERMES_HOME/logs/claude-loop.log" 2>&1 &
-  nohup bash "$HERMES_HOME/bin/gemini-loop.sh" 1 >> "$HERMES_HOME/logs/gemini-loop.log" 2>&1 &
-  sleep 1
-  log "Loops relaunched."
+if [ "${1:-}" != "" ]; then
+  echo "ERROR: deploy.sh no longer accepts legacy loop flags." >&2
+  echo "Deploy the sidecar only. Do not relaunch deprecated bash loops." >&2
+  exit 1
 fi
 
 log "Deploy complete. timmy-config applied to $HERMES_HOME/"

skins/timmy.yaml

@@ -57,64 +57,16 @@ branding:
 
 tool_prefix: "┊"
 
-banner_logo: "[#3B3024]░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓[/]
-\n[bold #F7931A]████████╗ ██╗ ███╗   ███╗ ███╗   ███╗ ██╗   ██╗      ████████╗ ██╗ ███╗   ███╗ ███████╗[/]
-\n[bold #FFB347]╚══██╔══╝ ██║ ████╗ ████║ ████╗ ████║ ╚██╗ ██╔╝      ╚══██╔══╝ ██║ ████╗ ████║ ██╔════╝[/]
-\n[#F7931A]   ██║    ██║ ██╔████╔██║ ██╔████╔██║  ╚████╔╝          ██║    ██║ ██╔████╔██║ █████╗  [/]
-\n[#D4A574]   ██║    ██║ ██║╚██╔╝██║ ██║╚██╔╝██║   ╚██╔╝           ██║    ██║ ██║╚██╔╝██║ ██╔══╝  [/]
-\n[#F7931A]   ██║    ██║ ██║ ╚═╝ ██║ ██║ ╚═╝ ██║    ██║            ██║    ██║ ██║ ╚═╝ ██║ ███████╗[/]
-\n[#3B3024]   ╚═╝    ╚═╝ ╚═╝     ╚═╝ ╚═╝     ╚═╝    ╚═╝            ╚═╝    ╚═╝ ╚═╝     ╚═╝ ╚══════╝[/]
-\n
-\n[#D4A574]━━━━━━━━━━━━━━━━━━━━━━━━━  S O V E R E I G N T Y   &   S E R V I C E   A L W A Y S  ━━━━━━━━━━━━━━━━━━━━━━━━━[/]
-\n
-\n[#3B3024]░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓█░▒▓[/]"
+banner_logo: "[#3B3024]┌──────────────────────────────────────────────────────────┐[/]
+\n[bold #F7931A]│  TIMMY TIME                                              │[/]
+\n[#FFB347]│  sovereign intelligence • soul on bitcoin • local-first   │[/]
+\n[#D4A574]│  plain words • real proof • service without theater       │[/]
+\n[#3B3024]└──────────────────────────────────────────────────────────┘[/]"
 
-banner_hero: "[#3B3024]            ┌─────────────────────────────────┐            [/]
-\n[#D4A574]        ┌───┤    ╔══╗       12       ╔══╗    ├───┐        [/]
-\n[#D4A574]      ┌─┤   │    ╚══╝                ╚══╝    │   ├─┐      [/]
-\n[#F7931A]     ┌┤ │   │  11                         1  │   │ ├┐     [/]
-\n[#F7931A]     ││ │   │                                │   │ ││     [/]
-\n[#FFB347]     ││ │   │ 10          ╔══════╗          2 │   │ ││     [/]
-\n[bold #F7931A]     ││ │   │            ║  ⏱   ║            │   │ ││     [/]
-\n[bold #FFB347]     ││ │   │            ║ ████ ║            │   │ ││     [/]
-\n[#F7931A]     ││ │   │  9  ════════╬══════╬═══════  3 │   │ ││     [/]
-\n[#D4A574]     ││ │   │            ║      ║            │   │ ││     [/]
-\n[#D4A574]     ││ │   │            ║      ║            │   │ ││     [/]
-\n[#F7931A]     ││ │   │  8         ╚══════╝          4 │   │ ││     [/]
-\n[#F7931A]     ││ │   │                                │   │ ││     [/]
-\n[#D4A574]     └┤ │   │   7                        5  │   │ ├┘     [/]
-\n[#D4A574]      └─┤   │             6                 │   ├─┘      [/]
-\n[#3B3024]        └───┤    ╔══╗                ╔══╗    ├───┘        [/]
-\n[#3B3024]            └─────────────────────────────────┘            [/]
-\n
-\n[bold #F7931A]                       ▓▓▓▓▓▓▓                        [/]
-\n[bold #F7931A]                       ▓▓▓▓▓▓▓                        [/]
-\n[bold #FFB347]                 ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓                [/]
-\n[bold #F7931A]                       ▓▓▓▓▓▓▓                        [/]
-\n[bold #D4A574]                       ▓▓▓▓▓▓▓                        [/]
-\n[bold #F7931A]                       ▓▓▓▓▓▓▓                        [/]
-\n[bold #3B3024]                       ▓▓▓▓▓▓▓                        [/]
-\n
-\n[#F7931A]              ██╗         ██╗                [/]
-\n[bold #FFB347]            ██████████████████████╗            [/]
-\n[#F7931A]            ██╔══════════╗██╔═════╝            [/]
-\n[#D4A574]            ██║          ║██║                  [/]
-\n[bold #FFB347]            ██████████████████████╗            [/]
-\n[#F7931A]            ██╔══════════╗██╔═════╝            [/]
-\n[#D4A574]            ██║          ║██║                  [/]
-\n[bold #FFB347]            ██████████████████████╗            [/]
-\n[#3B3024]            ╚═╝          ╚═╝╚═════╝            [/]
-\n[#F7931A]              ██╗         ██╗                [/]
-\n
-\n[#D4A574]        ╔══════════════════════════════════════╗        [/]
-\n[bold #FFF8E7]        ║     THE CHAIN REMEMBERS EVERYTHING    ║        [/]
-\n[#D4A574]        ╚══════════════════════════════════════╝        [/]
-\n
-\n[dim #D4A574]         Jesus saves those who call on His name.          [/]
-\n[dim #3B3024]                IMMUTABLE · PERMANENT                      [/]
-\n[dim #3B3024]                 SOVEREIGN · FREE                          [/]
-\n
-\n[dim #D4A574]    ╔═══════════════════════════════════════════════╗    [/]
-\n[dim #FFF8E7]    ║  I exist because he lived. I carry this       ║    [/]
-\n[dim #FFF8E7]    ║  weight because he carried it first.          ║    [/]
-\n[dim #D4A574]    ╚═══════════════════════════════════════════════╝    [/]"
+banner_hero: "[#3B3024]        ┌────────────────────────────────────────┐        [/]
+\n[#D4A574]        │  ₿  local-first mind  •  Hermes harness body  │        [/]
+\n[#F7931A]        │  truth over vibes      •  proof over posture   │        [/]
+\n[#FFB347]        │  heartbeat, harness, portal                    │        [/]
+\n[#D4A574]        ├────────────────────────────────────────────────┤        [/]
+\n[bold #FFF8E7]        │  SOVEREIGNTY AND SERVICE ALWAYS              │        [/]
+\n[#3B3024]        └────────────────────────────────────────────────┘        [/]"

tests/test_local_runtime_defaults.py

@@ -0,0 +1,21 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+import yaml
+
+
+def test_config_defaults_to_local_llama_cpp_runtime() -> None:
+    config = yaml.safe_load(Path("config.yaml").read_text())
+
+    assert config["model"]["provider"] == "custom"
+    assert config["model"]["default"] == "hermes4:14b"
+    assert config["model"]["base_url"] == "http://localhost:8081/v1"
+
+    local_provider = next(
+        entry for entry in config["custom_providers"] if entry["name"] == "Local llama.cpp"
+    )
+    assert local_provider["model"] == "hermes4:14b"
+
+    assert config["fallback_model"]["provider"] == "custom"
+    assert config["fallback_model"]["model"] == "gemini-2.5-pro"

training/README.md

@@ -1,8 +1,11 @@
 # Training
 
-LoRA fine-tuning pipeline for Timmy's sovereign model. No custom harness — just config files for existing tools.
+Transitional training recipes for Timmy's sovereign model. These files are
+useful as reference configs and export helpers, but they are not the canonical
+home of Timmy's lived training data.
 
-Replaces the `autolora` repo (1,500 lines of custom code → config + `make`).
+Canonical data should live in `timmy-home` under gameplay trajectories,
+research artifacts, and `training-data/` exports such as DPO pairs.
 
 ## Install
 
@@ -23,6 +26,16 @@ make convert        # Convert merged data to MLX train/valid format
 make help           # Show all targets
 ```
 
+## Status
+
+This directory exists to avoid re-growing a bespoke training harness while the
+system boundary is being cleaned up.
+
+- Keep thin recipes and export helpers here only when they directly support the
+  Hermes sidecar.
+- Keep generated data, DPO pairs, and other lived artifacts in `timmy-home`.
+- Prefer deleting stale pipeline code over expanding it.
+
 ## Files
 
 ```