fix(zeroclaw): add install playbook, fix manifest, add tests

.planning/PROJECT.md

@@ -29,7 +29,7 @@ Users can manage all their AI assistants from one place with consistent configur
 ### Out of Scope
 
 - Cloud services — fully local, no external dependencies
-- Non-Ubuntu distros — Ubuntu only for v1, other distros later
+- Non-Debian-based distros — Ubuntu and Debian for v1, other distros later
 - Other claw types — OpenClaw only for v1, ZeroClaw/NemoClaw later
 - GUI — CLI/TUI only, no web interface
 - Multi-user/auth — single user for v1
@@ -59,7 +59,7 @@ Users can manage all their AI assistants from one place with consistent configur
 
 - **Tech stack**: Python + Typer CLI, ansible-runner for execution, uv/uvx for packaging
 - **Security**: No sudo permissions — Clawrium prompts user when privileged commands needed
-- **Platform**: Ubuntu only for v1
+- **Platform**: Ubuntu and Debian for v1
 - **Claw support**: OpenClaw only for v1
 - **Deployment**: Fully local, no cloud dependencies
 

.planning/REQUIREMENTS.md

@@ -28,10 +28,10 @@ Requirements for initial release: OpenClaw on single Ubuntu host.
 
 ### Claw Installation
 
-- [ ] **INST-01**: User can install OpenClaw via interactive flow (`clm install`)
-- [ ] **INST-02**: Installation validates compatibility before proceeding
-- [ ] **INST-03**: Installation streams progress in real-time
-- [ ] **INST-04**: Installation fails fast with clear error messages
+- [x] **INST-01**: User can install OpenClaw via interactive flow (`clm install`)
+- [x] **INST-02**: Installation validates compatibility before proceeding
+- [x] **INST-03**: Installation streams progress in real-time
+- [x] **INST-04**: Installation fails fast with clear error messages
 
 ### Secrets Management
 
@@ -41,7 +41,7 @@ Requirements for initial release: OpenClaw on single Ubuntu host.
 
 ### Fleet Status
 
-- [ ] **STAT-01**: User can view fleet status (`clm status`)
+- [x] **STAT-01**: User can view fleet status (`clm status`)
 
 ## v2 Requirements
 
@@ -99,14 +99,14 @@ Which phases cover which requirements. Updated during roadmap creation.
 | REG-01 | Phase 3 | Complete |
 | REG-02 | Phase 3 | Complete |
 | REG-03 | Phase 3 | Complete |
-| SEC-01 | Phase 4 | Pending |
-| SEC-02 | Phase 4 | Pending |
-| SEC-03 | Phase 4 | Pending |
-| INST-01 | Phase 5 | Pending |
-| INST-02 | Phase 5 | Pending |
-| INST-03 | Phase 5 | Pending |
-| INST-04 | Phase 5 | Pending |
-| STAT-01 | Phase 5 | Pending |
+| INST-01 | Phase 4 | Complete |
+| INST-02 | Phase 4 | Complete |
+| INST-03 | Phase 4 | Complete |
+| INST-04 | Phase 4 | Complete |
+| STAT-01 | Phase 4 | Complete |
+| SEC-01 | Phase 5 | Pending |
+| SEC-02 | Phase 5 | Pending |
+| SEC-03 | Phase 5 | Pending |
 
 **Coverage:**
 - v1 requirements: 17 total
@@ -115,4 +115,4 @@ Which phases cover which requirements. Updated during roadmap creation.
 
 ---
 *Requirements defined: 2026-03-20*
-*Last updated: 2026-03-20 after initial definition*
+*Last updated: 2026-03-21 after phase 4 planning*

.planning/ROADMAP.md

@@ -14,9 +14,9 @@ Decimal phases appear between their surrounding integers in numeric order.
 
 - [x] **Phase 1: Foundation Setup** - Initialize Clawrium configuration and verify dependencies (completed 2026-03-21)
 - [x] **Phase 2: Host Management** - Add, list, remove hosts with hardware capability detection (completed 2026-03-21)
-- [ ] **Phase 3: Registry & Compatibility** - Load claw manifests and validate hardware compatibility
-- [ ] **Phase 4: Secrets Management** - Secure storage and retrieval of API keys and credentials
-- [ ] **Phase 5: Installation & Fleet Status** - Install OpenClaw instances and view fleet status
+- [x] **Phase 3: Registry & Compatibility** - Load claw manifests and validate hardware compatibility (completed 2026-03-21)
+- [ ] **Phase 4: Installation & Fleet Status** - Install OpenClaw instances and view fleet status
+- [ ] **Phase 5: Secrets Management** - Secure storage and retrieval of API keys and credentials
 
 ## Phase Details
 
@@ -68,29 +68,32 @@ Plans:
 - [x] 03-03-PLAN.md — Implement compatibility checking function (REG-03)
 - [x] 03-04-PLAN.md — Registry CLI commands (list, show) (REG-02)
 
-### Phase 4: Secrets Management
-**Goal**: Users can securely store and manage secrets for claw instances
-**Depends on**: Phase 1
-**Requirements**: SEC-01, SEC-02, SEC-03
-**Success Criteria** (what must be TRUE):
-  1. User can set a secret with `clm secret set` and it's stored with mode 600
-  2. User can list secret keys with `clm secret list` and values are never displayed
-  3. Secrets file is created with correct permissions (600) on first write
-**Plans**: TBD
-
-Plans:
-- [ ] 04-01: TBD
-
-### Phase 5: Installation & Fleet Status
+### Phase 4: Installation & Fleet Status
 **Goal**: Users can install OpenClaw on Ubuntu hosts and view fleet status
-**Depends on**: Phase 2, Phase 3, Phase 4
+**Depends on**: Phase 2, Phase 3
 **Requirements**: INST-01, INST-02, INST-03, INST-04, STAT-01
 **Success Criteria** (what must be TRUE):
-  1. User runs `clm install` and flows through: pick claw → pick host → validate compatibility → configure → install
+  1. User runs `clm install` and flows through: pick claw → pick host → validate compatibility → install
   2. Installation validates compatibility before proceeding and fails fast if host is incompatible
   3. User sees real-time progress during installation (base setup, dependencies, claw installation)
   4. Installation fails fast with clear error messages if any step fails
   5. User runs `clm status` and sees all hosts with their claw instances, agents, and status
+**Plans**: 4 plans
+
+Plans:
+- [x] 04-01-PLAN.md — Core install module and Ansible playbooks (INST-02, INST-04)
+- [x] 04-02-PLAN.md — Install CLI with interactive flow and progress (INST-01, INST-03)
+- [x] 04-03-PLAN.md — Install state tracking and health check module (INST-04, STAT-01)
+- [x] 04-04-PLAN.md — Fleet status CLI command (STAT-01)
+
+### Phase 5: Secrets Management
+**Goal**: Users can securely store and manage secrets for claw instances
+**Depends on**: Phase 1
+**Requirements**: SEC-01, SEC-02, SEC-03
+**Success Criteria** (what must be TRUE):
+  1. User can set a secret with `clm secret set` and it's stored with mode 600
+  2. User can list secret keys with `clm secret list` and values are never displayed
+  3. Secrets file is created with correct permissions (600) on first write
 **Plans**: TBD
 
 Plans:
@@ -105,6 +108,6 @@ Phases execute in numeric order: 1 → 2 → 3 → 4 → 5
 |-------|----------------|--------|-----------|
 | 1. Foundation Setup | 2/2 | Complete   | 2026-03-21 |
 | 2. Host Management | 4/4 | Complete | 2026-03-21 |
-| 3. Registry & Compatibility | 0/4 | Planned | - |
-| 4. Secrets Management | 0/0 | Not started | - |
-| 5. Installation & Fleet Status | 0/0 | Not started | - |
+| 3. Registry & Compatibility | 4/4 | Complete | 2026-03-21 |
+| 4. Installation & Fleet Status | 0/4 | Planning complete | - |
+| 5. Secrets Management | 0/0 | Not started | - |

.planning/STATE.md

@@ -3,14 +3,14 @@ gsd_state_version: 1.0
 milestone: v1.0
 milestone_name: milestone
 status: unknown
-stopped_at: Completed 03-04-PLAN.md
-last_updated: "2026-03-21T22:42:48.527Z"
-last_activity: 2026-03-21
+stopped_at: Completed 04-04-PLAN.md
+last_updated: "2026-03-22T04:38:50.124Z"
+last_activity: 2026-03-22
 progress:
   total_phases: 5
-  completed_phases: 3
-  total_plans: 10
-  completed_plans: 10
+  completed_phases: 4
+  total_plans: 14
+  completed_plans: 14
 ---
 
 # Project State
@@ -20,11 +20,11 @@ progress:
 See: .planning/PROJECT.md (updated 2026-03-20)
 
 **Core value:** Users can manage all their AI assistants from one place with consistent configuration and security practices.
-**Current focus:** Phase 03 — registry-compatibility
+**Current focus:** Phase 04 — installation-fleet-status
 
 ## Current Position
 
-Phase: 4
+Phase: 5
 Plan: Not started
 
 ## Performance Metrics
@@ -51,6 +51,10 @@ Plan: Not started
 | Phase 03 P02 | 127 | 1 tasks | 2 files |
 | Phase 03 P03 | 128 | 1 tasks | 2 files |
 | Phase 03 P04 | 156 | 2 tasks | 3 files |
+| Phase 04 P01 | 237 | 2 tasks | 5 files |
+| Phase 04 P02 | 280 | 1 tasks | 3 files |
+| Phase 04 P03 | 336 | 2 tasks | 5 files |
+| Phase 04-installation-fleet-status P04 | 128 | 1 tasks | 3 files |
 
 ## Accumulated Context
 
@@ -77,6 +81,14 @@ Recent decisions affecting current work:
 - [Phase 03]: OS names normalized to lowercase (Ubuntu → ubuntu) for consistent compatibility checking
 - [Phase 03-03]: Sparse matrix compatibility matching: only explicit manifest entries valid, no partial matches
 - [Phase 03-04]: Implemented both list and show commands in single module following existing CLI patterns
+- [Phase 04-01]: Base playbook located at project root (platform/) not in src/ for easier discovery
+- [Phase 04-01]: OpenClaw user naming pattern: opc-<hostname> using inventory_hostname variable
+- [Phase 04-02]: Hybrid invocation pattern for CLI commands (interactive prompts when flags missing, direct with flags)
+- [Phase 04-02]: Rich Panel for confirmation dialogs, Rich Progress for long-running operations
+- [Phase 04-03]: Use ISO 8601 timestamps for installed_at field in claw tracking
+- [Phase 04-03]: Use pgrep for process detection in health checks (simple, portable)
+- [Phase 04-installation-fleet-status]: Claw-centric grouping: display organized by claw type rather than by host for better fleet visibility
+- [Phase 04-installation-fleet-status]: Rich Progress spinner for health checks provides UX feedback on potentially slow SSH operations
 
 ### Pending Todos
 
@@ -97,6 +109,6 @@ None yet.
 
 ## Session Continuity
 
-Last activity: 2026-03-21
-Stopped at: Completed 03-04-PLAN.md
+Last activity: 2026-03-22
+Stopped at: Completed 04-04-PLAN.md
 Resume file: None