Skip to content

feat(mcp): add hivemind active task map#2

Merged
NagyVikt merged 4 commits intomainfrom
agent/codex/cavemem-hivemind-tool-2026-04-23
Apr 23, 2026
Merged

feat(mcp): add hivemind active task map#2
NagyVikt merged 4 commits intomainfrom
agent/codex/cavemem-hivemind-tool-2026-04-23

Conversation

@NagyVikt
Copy link
Copy Markdown
Collaborator

Summary

  • add a compact hivemind MCP tool for active proxy-runtime session/task state
  • read .omx/state/active-sessions/*.json plus AGENT.lock telemetry fallback without returning observation bodies
  • document Codex skill usage and add a changeset for @cavemem/mcp-server

Verification

  • pnpm exec biome check apps/mcp-server/src/server.ts apps/mcp-server/src/hivemind.ts apps/mcp-server/test/server.test.ts docs/mcp.md .changeset/hivemind-mcp-tool.md
  • pnpm --filter @cavemem/mcp-server test
  • pnpm --filter @cavemem/mcp-server typecheck
  • pnpm --filter @cavemem/mcp-server build

NagyVikt added 2 commits April 23, 2026 11:00
Expose a compact hivemind MCP tool so Codex skills can ask Cavemem which proxy-runtime sessions own which tasks before reading memory bodies. The tool reads only local active-session JSON and AGENT.lock telemetry, keeps stale active records from hiding fresh lock telemetry, and documents the skill-first usage path.

Constraint: MCP compact tools must preserve progressive disclosure and avoid raw observation bodies.

Rejected: Persisting runtime task state in Cavemem storage | runtime ownership is transient and already emitted by proxy/Guardex state files.

Confidence: high

Scope-risk: narrow

Tested: pnpm exec biome check apps/mcp-server/src/server.ts apps/mcp-server/src/hivemind.ts apps/mcp-server/test/server.test.ts docs/mcp.md .changeset/hivemind-mcp-tool.md

Tested: pnpm --filter @cavemem/mcp-server test

Tested: pnpm --filter @cavemem/mcp-server typecheck

Tested: pnpm --filter @cavemem/mcp-server build
Current origin/main introduced tracked Active Agents files that make the repo-wide CI lint gate fail before the MCP change is tested. Apply Biome formatting and remove the no-op continue so the existing CI gate can run cleanly.

Constraint: CI runs `pnpm lint` across the whole repository, not only changed MCP files.

Rejected: Ignore the red CI check | the PR would remain unmergeable even though the failure is formatting drift.

Confidence: high

Scope-risk: narrow

Tested: pnpm lint

Tested: pnpm typecheck

Tested: pnpm test

Tested: pnpm build
@NagyVikt NagyVikt force-pushed the agent/codex/cavemem-hivemind-tool-2026-04-23 branch from c3480c4 to 1563b79 Compare April 23, 2026 09:07
NagyVikt added 2 commits April 23, 2026 11:20
Vitest runs before the build gate in CI, so clean checkouts do not have package dist outputs yet. Route workspace package imports to source during tests while preserving published dist exports for runtime consumers.

Constraint: CI executes pnpm test before pnpm build.

Rejected: Move the CI build before tests | would mask the clean pre-build test contract instead of fixing package resolution.

Confidence: high

Scope-risk: narrow

Tested: pnpm clean; pnpm test; pnpm lint; pnpm typecheck; pnpm build
The new `hivemind` MCP tool only helps if review flows call it before pulling
full memory bodies. This adds a repo-local `reviewer` skill so Codex can map
active branches and worktrees first, then drill into targeted session evidence
only when needed.

Constraint: Keep the repo-local skill lean and dependency-free
Rejected: README-only guidance | skill discovery needs an executable workflow surface
Confidence: high
Scope-risk: narrow
Reversibility: clean
Directive: Keep the skill hivemind-first; do not broaden it into a general review replacement without validating the trigger surface
Tested: git diff --check; reviewed skill metadata and unignored file state
Not-tested: pnpm typecheck; pnpm lint; pnpm test; pnpm build (docs-only follow-up on a previously verified PR branch)
@NagyVikt NagyVikt merged commit f853481 into main Apr 23, 2026
3 checks passed
@NagyVikt NagyVikt deleted the agent/codex/cavemem-hivemind-tool-2026-04-23 branch April 23, 2026 09:39
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