61 lines
2.5 KiB
Markdown
61 lines
2.5 KiB
Markdown
# 🗺️ Final Implementation Plan — Grok Build TUI Agent (`grok`) Integration
|
||
|
||
- **Planner**: `planner-reviewer-claude-01`
|
||
- **Creator**: `creator-agy-01`
|
||
- **Job ID**: a0689b27
|
||
- **Version**: Rev.2 (Consensus)
|
||
|
||
---
|
||
|
||
## 1. Overview & Architecture
|
||
Integrate Grok Build TUI (`grok` 1.0.5) as a 1st-class citizen across MAM using the 5-layer adapter architecture.
|
||
|
||
---
|
||
|
||
## 2. Exhaustive Enumeration Sites (~34 Sites)
|
||
|
||
### 2.1 Core Adapter Framework
|
||
1. `.agents/skills/lib_py/agents/adapters/grok.py`: Implement `GrokAgentAdapter(BaseAgentAdapter)`.
|
||
2. `.agents/skills/lib_py/agents/registry.py`: Import and add `grok` to `_ADAPTERS`.
|
||
3. `.agents/skills/lib_py/agents/sanitize.py`: Ensure grok session naming passes regex.
|
||
|
||
### 2.2 Shell Runtime & Lifecycle
|
||
4. `lib.sh:357-371`: Herdr kind mapping (`*-creator-grok|*-planner-grok|*-reviewer-grok`).
|
||
5. `lib.sh:385`: Binary name recognition tuple (`" claude agy hermes cline grok "`).
|
||
6. `lib.sh:1760-1790`: `send_keys_safe` input prompt delimiters (`❯`, `───`).
|
||
7. `create_session.sh`: CLI options and validation for `--agent grok`.
|
||
8. `resume_session.sh`: Resume CLI spec dispatch and fallback.
|
||
9. `stop_session.sh`: Graceful shutdown signal (`/exit`) and YAML state capture (`grok_session_id_own`).
|
||
10. `reconcile.sh`: Monitor reconciler session discovery for grok.
|
||
11. `status.sh`: Status table formatting for grok agent rows.
|
||
12. `orc_onboard.sh`: Orchestrator UUID registration.
|
||
|
||
### 2.3 Skills Documentation & Prompt Updates
|
||
13-20. Update `SKILL.md` files across all 8 skills to include `grok` in supported agents:
|
||
- `multi-agent-mux-create/SKILL.md`
|
||
- `multi-agent-mux-resume/SKILL.md`
|
||
- `multi-agent-mux-stop/SKILL.md`
|
||
- `multi-agent-mux-status/SKILL.md`
|
||
- `multi-agent-mux-monitor/SKILL.md`
|
||
- `multi-agent-mux-delegate-job/SKILL.md`
|
||
- `multi-agent-mux-loop/SKILL.md`
|
||
- `multi-agent-mux-orc-onboard/SKILL.md`
|
||
|
||
### 2.4 Test Suites
|
||
21. `tests/test_a4_adapter_contract.py`: Registry, property contract, facts bridge eval.
|
||
22. `tests/test_tier1_unit.py`: Unit tests for grok adapter lifecycle.
|
||
|
||
---
|
||
|
||
## 3. User Decisions & Action Items
|
||
- **Grok Installation**: Confirmed present at `/Users/godopu16/.local/bin/grok` (v1.0.5).
|
||
- **Authentication**: `~/.grok/auth.json` is already configured.
|
||
- **Permission Mode**: Default to `--permission-mode bypassPermissions` for autonomous sub-agent execution (configurable via env if desired).
|
||
|
||
---
|
||
|
||
## 4. Definition of Done
|
||
- [ ] `GrokAgentAdapter` passes all contract tests.
|
||
- [ ] `pytest tests/` passes with 0 regressions.
|
||
- [ ] Grok can be created, stopped, and resumed via MAM CLI.
|