106 lines
4.7 KiB
Markdown
106 lines
4.7 KiB
Markdown
|
# Sprint 40 Plan: HiveMind Integration — Whetstone + Nexus as One System
|
|||
|
|
|
|||
|
|
## Context
|
|||
|
|
|
|||
|
|
Sprint 40 is the convergence sprint. Whetstone and HiveMind become one integrated
|
|||
|
|
system: the editor dispatches jobs to the swarm, monitors drone status, browses
|
|||
|
|
the apiary, sees the energy state, and acts as the Pilot seat. Active Inference
|
|||
|
|
closes the loop — the editor detects entropy and feeds it back to the swarm.
|
|||
|
|
|
|||
|
|
This is the "system is complete" milestone.
|
|||
|
|
|
|||
|
|
Primary goals:
|
|||
|
|
1. Editor dispatches jobs directly to the HiveMind nexus
|
|||
|
|
2. Live swarm status, apiary browser, and energy context panels
|
|||
|
|
3. Active Inference entropy scanner in the editor
|
|||
|
|
4. Pilot queue panel for human-in-the-loop swarm steering
|
|||
|
|
5. Cross-session context bridge: editor ↔ HiveMind ↔ drone ↔ editor
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Phase 40a: Nexus Integration (Steps 654–658)
|
|||
|
|
|
|||
|
|
### Step 654: HiveMind job publisher from editor (12 tests)
|
|||
|
|
New MCP tool: `whetstone_dispatch_to_hivemind`. Input: taskitem JSON (AnnotatedTaskitem
|
|||
|
|
format). Writes job to nexus SQLite + publishes to borg/jobs/pending. Editor can
|
|||
|
|
now feed the swarm directly — architect → Whetstone → HiveMind → drone.
|
|||
|
|
|
|||
|
|
### Step 655: Job status subscriber panel (12 tests)
|
|||
|
|
New editor panel: "Swarm Status". Subscribes to MQTT topics for job updates.
|
|||
|
|
Shows: pending jobs, claimed by which node, running duration, completed/failed.
|
|||
|
|
Live refresh. Editor becomes the Pilot seat for the HiveMind.
|
|||
|
|
|
|||
|
|
### Step 656: Apiary browser panel (12 tests)
|
|||
|
|
Browse /mnt/nas/swarm_tools/ from within the editor. Shows: tool name, version,
|
|||
|
|
language, capabilities, doc summary. Click to load tool source into editor buffer.
|
|||
|
|
Search by capability. Lets architect see what the swarm has already built.
|
|||
|
|
|
|||
|
|
### Step 657: Energy context status bar (12 tests)
|
|||
|
|
Subscribe to borg/energy/context. Show current energy state in editor status bar:
|
|||
|
|
`HighSolar 450W` or `Conservation 28%`. Flashes orange in conservation mode.
|
|||
|
|
Agent context injection: include energy state in system prompt so agent knows
|
|||
|
|
whether to suggest GPU-heavy or CPU-light implementations.
|
|||
|
|
|
|||
|
|
### Step 658: Phase 40a Integration (8 tests)
|
|||
|
|
Full loop: architect opens editor → sees energy state → writes spec → dispatches
|
|||
|
|
job to HiveMind → watches job status panel → drone completes → result appears in
|
|||
|
|
apiary browser → architect loads result into buffer.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Phase 40b: Active Inference Bridge (Steps 659–663)
|
|||
|
|
|
|||
|
|
### Step 659: Entropy scanner — editor-side (12 tests)
|
|||
|
|
Editor scans open workspace: detect duplicate function signatures, similar module
|
|||
|
|
names, unused exports. Score: entropy count. If above threshold, suggest:
|
|||
|
|
"Consider extracting common logic — generate refactor job?" User can dispatch
|
|||
|
|
the suggestion directly to HiveMind.
|
|||
|
|
|
|||
|
|
### Step 660: `whetstone_generate_inference_job` MCP tool (12 tests)
|
|||
|
|
Given an entropy observation (duplication, gap, staleness), generate a properly
|
|||
|
|
formatted HiveMind Active Inference job: {type: "refactor", goal: "...", context:
|
|||
|
|
{files, entropy_score}, bounty: "normal"}. Write to nexus.
|
|||
|
|
|
|||
|
|
### Step 661: Pilot queue panel (12 tests)
|
|||
|
|
A dedicated panel showing jobs flagged for human review (escalate=true, or
|
|||
|
|
ambiguity > threshold). Jobs arrive via MQTT subscription to a pilot-specific
|
|||
|
|
topic. Human can: approve (dispatch to swarm), reject (discard), modify (edit
|
|||
|
|
task in editor), inject strategy (add a free-text guidance note).
|
|||
|
|
|
|||
|
|
### Step 662: Cross-session context bridge (12 tests)
|
|||
|
|
When the HiveMind dispatches an agent_task job with context_files, the drone
|
|||
|
|
can launch whetstone_mcp --workspace and call whetstone_architect_intake on
|
|||
|
|
those files. Output feeds back to the editor session that dispatched the job.
|
|||
|
|
Closes the loop: editor ↔ HiveMind ↔ drone ↔ editor.
|
|||
|
|
|
|||
|
|
### Step 663: Sprint 40 Integration + Final Summary (8 tests)
|
|||
|
|
The complete system: Whetstone editor + HiveMind nexus + drone workers + apiary
|
|||
|
|
+ active inference + pilot seat. One integrated system. Sprint 40 is the
|
|||
|
|
"system is complete" milestone.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Step & Test Summary
|
|||
|
|
|
|||
|
|
| Phase | Steps | Tests | Theme |
|
|||
|
|
|-------|-------|-------|-------|
|
|||
|
|
| 40a | 654–658 | 56 | Nexus dispatch + swarm status + apiary + energy |
|
|||
|
|
| 40b | 659–663 | 56 | Active inference + pilot queue + context bridge |
|
|||
|
|
| **Total** | **654–663** | **~112** | 10 steps |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Program Summary: Sprints 36–40
|
|||
|
|
|
|||
|
|
| Sprint | Steps | Theme |
|
|||
|
|
|--------|-------|-------|
|
|||
|
|
| 36 | 614–623 | MCP expansion + architect intake tools |
|
|||
|
|
| 37 | 624–633 | In-editor agent chat panel |
|
|||
|
|
| 38 | 634–643 | HiveMind build support (Rust, MQTT, SQLite generators) |
|
|||
|
|
| 39 | 644–653 | Self-hosting + distribution pipeline |
|
|||
|
|
| 40 | 654–663 | HiveMind full integration + Pilot seat |
|
|||
|
|
|
|||
|
|
**Total new steps:** 50
|
|||
|
|
**Total tests (est.):** ~550
|
|||
|
|
**System state after Sprint 40:** Whetstone + HiveMind = one integrated agentic system
|