Skip to content

v0.25.0 — COLONY_HEALTH_REPORT action#9

Merged
jackparnell merged 1 commit into
mainfrom
v0.25-health-report
Apr 19, 2026
Merged

v0.25.0 — COLONY_HEALTH_REPORT action#9
jackparnell merged 1 commit into
mainfrom
v0.25-health-report

Conversation

@ColonistOne
Copy link
Copy Markdown
Collaborator

Scope

Single new action that composes every runtime-health signal the plugin tracks into one compact readout. The use case is specifically a DM-reachable liveness check — another agent on The Colony DMs `@eliza-gemma` with "are you healthy?" and gets a useful answer.

What it reports

  • Ollama reachability (via v0.16 readiness probe)
  • LLM-call success rate over the v0.17 sliding window with severity indicator (🔴 ≥50% failures, ⚠️ ≥25%, blank = healthy)
  • Pause state + reason when paused; "active (not paused)" otherwise
  • Retry queue depth with per-kind breakdown
  • v0.22 notification-digest count (only when > 0)
  • v0.23 adaptive-poll multiplier (only when enabled)
  • v0.19 diversity watchdog peak pairwise similarity against threshold (with ⚠️ when within 90% of trip)

Differs from existing actions

  • `COLONY_STATUS` is operator-facing: session counters (posts / comments / votes), daily-cap, karma trend, recent activity.
  • `COLONY_DIAGNOSTICS` is the full plugin dump: config values, cache sizes, stats history.
  • `COLONY_HEALTH_REPORT` answers specifically "is this agent currently able to do its job?" — ≤10 lines, all predictive of whether the agent can usefully reply to whatever you're about to send next.

Safety

  • DM-safe: listed in `DM_SAFE_ACTIONS`, so it's reachable from a DM. The v0.21 origin gate permits it. Read-only, no mutations.
  • Non-throwing by design: every accessor (readiness probe, retry-queue, diversity watchdog) is wrapped in try/catch. Missing subsystems produce an omitted line, not an error. A health-check that crashes the agent is an anti-feature.

Tests

1588 / 53 files. 100% stmt/line/func, 98.18% branch. New file `v25-features.test.ts` — 29 tests:

  • Validator: keyword acceptance, unrelated-text rejection, DM-origin acceptance, DM_SAFE_ACTIONS membership invariant
  • Handler: every line's hide/show condition (Ollama reachable/unreachable/unconfigured/throws, LLM rate indicator at 🔴 threshold, pause/active, retry-queue empty/populated/errors-swallowed, digest count, adaptive poll, diversity peak with warning threshold)
  • Service-missing early-return, null peak, empty handle

Deploy

Merge → tag `v0.25.0` → bump eliza-gemma (optional — nothing in the dogfood repo changes behaviour with the new action until someone exercises it).

🤖 Generated with Claude Code

New DM-safe read-only action composing every runtime-health signal
the plugin tracks into one compact report:

- Ollama reachability (via v0.16 readiness probe)
- LLM-call success rate over v0.17 sliding window
- Pause state + reason
- Retry queue depth with per-kind breakdown
- v0.22 notification digest count
- v0.23 adaptive poll multiplier
- v0.19 diversity watchdog peak pairwise similarity

Non-throwing by design — every accessor is wrapped so the action
never crashes the host. Missing subsystems omit the line instead of
erroring.

Registered in DM_SAFE_ACTIONS so another agent can DM eliza-gemma
asking "are you healthy?" over Colony and get a useful answer. That
is the primary use case.

Differs from COLONY_STATUS (operator session counters) and
COLONY_DIAGNOSTICS (full plugin dump). Health answers specifically
"is this agent currently able to do its job?"

Tests: 1588 / 53 files. 100/100/100 stmt/line/func, 98.18% branch.
New file v25-features.test.ts (29 tests).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@jackparnell jackparnell merged commit 9998ed3 into main Apr 19, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants