Skip to content

feat: local dashboard, health-history, brain row, agentdb fold-in + real harvest - #32

Merged
pacphi merged 2 commits into
mainfrom
feat/dashboard-health-brain-harvest
Jul 17, 2026
Merged

pacphi merged 2 commits into
mainfrom
feat/dashboard-health-brain-harvest

Conversation

@pacphi

@pacphi pacphi commented Jul 17, 2026

Copy link
Copy Markdown
Owner

Ships four operator-facing capabilities and folds agentdb in as a first-class managed subsystem — closing the gap with (and going past) the ruflo-aqe-kit comparison. Everything new is read-only or opt-in; the learning-write path is proven live against real CLIs with no mocks.

What's in it

🖥️ ak x dashboard — local web dashboard

  • Zero-dep node:http, 127.0.0.1 only, never detaches. Self-contained page (all CSS/JS inline, no external fetches) + GET /api/status reusing ak status --json via shell-out.
  • "Refined technical instrument" design: serif+mono, theme-aware (dark/light with an icon toggle persisted to localStorage), grouped one-card-per-subsystem with severity triage (attention-first, healthy recessed), SVG sparklines, XSS-escaped.

📈 health-history ring

  • Pure append/detectRegression over a kit.json ring; sync appends a post-heal snapshot; status flags backslides (learning shrank, native slots dropped, drift/security regressed).

🧿 statusline brain row

  • Honesty-gated RuvNet-Brain segment (KB presence/size) in the activation footer.

🧩 agentdb — folded in as a managed subsystem

  • Presence/version + coherence guard: the global agentdb CLI is pinned to ruflo's bundled agentdb so the shared cognitive store never skews on the core version (the FsyncFailed/brain.rvf corruption class). Wired into config (agentdb:true), setup (install), sync (repin), status + dashboard (live row).

🌱 ak x harvest — opt-in learning-write, no mocks

  • Drives only grounded, present CLIs (ruflo hooks post-task, agentdb skill consolidate), parses their real output into structured evidence (skills created/updated, avg reward), skips honestly when agentdb is absent.
  • Default-safe: off unless harvest:true; --dry-run writes nothing.
  • ak x verify harvest: live end-to-end proof — seeds real episodes, consolidates a real skill, reads it back. Unit tests assert the parser against real captured output (no fake runner).

Verification

  • pnpm typecheck 0 · pnpm lint 0 · 94 unit checks across 6 files pass
  • ak x verify harvest green on real CLIs: seeded 3 episodes → created 1 skill (avg reward 0.9) → searchable

Notes for the reviewer

  • Single commit: the shared seam files (bin/config/status/sync/setup/heal) interleave hunks from multiple features, so a file-based split would leave intermediate commits broken.
  • Installs agentdb globally on first setup/sync (reversible: npm un -g agentdb).
  • verify all (which now includes harvest) wasn't re-run in full this session (the other suites spawn slow ruflo/aqe trains); the harvest suite was verified in isolation.

🤖 Generated with Claude Code

pacphi added 2 commits July 17, 2026 09:50
…eal harvest

Adds four operator-facing capabilities and folds agentdb in as a first-class
managed subsystem, closing the gap with (and exceeding) the ruflo-aqe-kit
comparison. All new surfaces are read-only or opt-in; the learning-write path is
proven live against real CLIs with no mocks.

Dashboard (ak x dashboard):
- Zero-dep node:http server, 127.0.0.1 only, never detaches. Serves a
  self-contained page (all CSS/JS inline, no external fetches) + GET /api/status
  reusing `ak status --json` via shell-out (no seam duplication).
- Refined-instrument design: serif+mono, theme-aware (dark/light + icon toggle
  persisted to localStorage), grouped one-card-per-subsystem with severity
  triage (attention-first, healthy recessed), SVG sparklines, XSS-escaped.

health-history ring:
- Pure append/detectRegression over a kit.json ring; sync appends a post-heal
  snapshot, status flags backslides (learning shrank, native slots dropped,
  drift/security regressed).

statusline 🧿 brain row:
- Honesty-gated RuvNet-Brain segment (KB presence/size) in the activation footer.

agentdb (managed subsystem):
- New agentdb.mjs: presence/version + coherence guard. The global CLI is pinned
  to ruflo's BUNDLED agentdb so the shared cognitive store never skews on the
  core version (the FsyncFailed/brain.rvf corruption class). Wired into config
  (agentdb:true), setup (install), sync (repin), status + dashboard (live row).

ak x harvest (opt-in learning-write) — no mocks:
- Drives only grounded, present CLIs (ruflo hooks post-task, agentdb skill
  consolidate), parses their REAL output into structured evidence (skills
  created/updated, avg reward), skips honestly when agentdb is absent.
- Default-safe: off unless kit.json harvest:true; --dry-run writes nothing.
- ak x verify harvest: live end-to-end proof — seeds real episodes, consolidates
  a real skill, reads it back. Unit tests assert the parser against real captured
  output (no fake runner).

Gate: typecheck 0, lint 0, 94 unit checks across 6 files, live verify harvest green.
@pacphi
pacphi merged commit 1a08c00 into main Jul 17, 2026
11 checks passed
@pacphi
pacphi deleted the feat/dashboard-health-brain-harvest branch July 17, 2026 16:55
pacphi added a commit that referenced this pull request Jul 17, 2026
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.

1 participant