docs(35): complete update cli self-update phase

Adds verification report and updates roadmap/state for
Phase 35 completion.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: pRizz

.planning/ROADMAP.md

@@ -46,6 +46,7 @@ Decimal phases appear between their surrounding integers in numeric order.
 - [ ] **Phase 32: Make automated (or manually triggered) scripts/github actions in CI for generating and uploading an AWS AMI so that cloud formation/installation can be streamlined and quickened** - TBD
 - [ ] **Phase 33: Investigate and implement a way for users that get created and configured in the container are persisted after we update the container** - TBD
 - [ ] **Phase 34: Disable Cockpit User-Facing Surface** - TBD
+- [x] **Phase 35: Can we add a new update subcommand to update the opencode-cloud binary itself? We might need to be careful with respect to how the binary was installed with which package manager and whether it is the rust or npm binary** - Add update CLI subcommand for self-updating opencode-cloud
 
 ## Phase Details
 
@@ -609,6 +610,19 @@ Plans:
 **Details:**
 [To be added during planning]
 
+### Phase 35: Can we add a new update subcommand to update the opencode-cloud binary itself? We might need to be careful with respect to how the binary was installed with which package manager and whether it is the rust or npm binary
+
+**Goal:** Add a CLI update subcommand that can reinstall opencode-cloud using the detected install method (cargo or npm) and restart the service afterward.
+**Depends on:** Phase 34
+**Requirements:** None (enhancement)
+**Plans:** 1 plan
+
+Plans:
+- [x] 35-01-PLAN.md — Add update CLI subcommand and documentation
+
+**Details:**
+Implemented `occ update cli` with install detection, restart flow, and docs guidance.
+
 ## Progress
 
 **Execution Order:**
@@ -650,7 +664,8 @@ Phases execute in numeric order: 1 -> 2 -> 3 -> ... -> 28 -> 29 -> 30 -> 31 -> 3
 | 32. Make automated (or manually triggered) scripts/github actions in CI for generating and uploading an AWS AMI so that cloud formation/installation can be streamlined and quickened | 0/0 | Not started | - |
 | 33. Investigate and implement a way for users that get created and configured in the container are persisted after we update the container | 0/0 | Not started | - |
 | 34. Disable Cockpit User-Facing Surface | 0/0 | Not started | - |
+| 35. Update opencode-cloud self-update | 1/1 | Complete | 2026-01-31 |
 
 ---
 *Roadmap created: 2026-01-18*
-*Last updated: 2026-01-25 (Phase 18 expanded with prebuilt binary distribution)*
+*Last updated: 2026-01-31 (Phase 35 complete: update cli subcommand)*

.planning/STATE.md

@@ -9,11 +9,11 @@ See: .planning/PROJECT.md (updated 2026-01-18)
 
 ## Current Position
 
-Phase: 21 of 21 (Use opencode Fork with PAM Authentication)
-Plan: 2 of 2 in current phase
+Phase: 35 of 35 (Update opencode-cloud self-update)
+Plan: 1 of 1 in current phase
 Status: Phase complete
 **Next Phase:** 33 (Investigate and implement a way for users that get created and configured in the container are persisted after we update the container)
-Last activity: 2026-01-26 - Executed 21-01, 21-02 (Dockerfile fork installation, broker, PAM config, documentation)
+Last activity: 2026-01-31 - Executed 35-01 (opencode-cloud self-update subcommand and docs)
 
 Progress: [##############################] 100%
 
@@ -22,7 +22,7 @@ Note: Phases 12 (Web Desktop UI) and 13 (Container Security Tools) are DEFERRED.
 ## Performance Metrics
 
 **Velocity:**
-- Total plans completed: 48
+- Total plans completed: 49
 - Average duration: 5 min
 - Total execution time: ~4.5 hours
 
@@ -245,6 +245,8 @@ Recent decisions affecting current work:
 - Phase 32 added: Make automated (or manually triggered) scripts/github actions in CI for generating and uploading an AWS AMI so that cloud formation/installation can be streamlined and quickened
 - Phase 33 added: Investigate and implement a way for users that get created and configured in the container are persisted after we update the container
 - Phase 34 added: Disable Cockpit user-facing surface (hide UI/CLI/docs, keep code)
+- Phase 35 added: Can we add a new update subcommand to update the opencode-cloud binary itself? We might need to be careful with respect to how the binary was installed with which package manager and whether it is the rust or npm binary
+- Phase 35 completed: update cli self-update flow and docs
 
 ### Blockers/Concerns
 

.planning/phases/35-can-we-add-a-new-update-subcommand-to-update-the-opencode-cloud-binary-itself-we-might-need-to-be-careful-with-respect-to-how-the-binary-was-installed-with-which-package-manager-and-whether-it-is-the-rust-or-npm-binary/35-can-we-add-a-new-update-subcommand-to-update-the-opencode-cloud-binary-itself-we-might-need-to-be-careful-with-respect-to-how-the-binary-was-installed-with-which-package-manager-and-whether-it-is-the-rust-or-npm-binary-VERIFICATION.md

@@ -0,0 +1,72 @@
+---
+phase: 35-can-we-add-a-new-update-subcommand-to-update-the-opencode-cloud-binary-itself-we-might-need-to-be-careful-with-respect-to-how-the-binary-was-installed-with-which-package-manager-and-whether-it-is-the-rust-or-npm-binary
+verified: 2026-01-31T23:45:39Z
+status: passed
+score: 3/3 must-haves verified
+re_verification:
+  previous_status: gaps_found
+  previous_score: 2/3
+  gaps_closed:
+    - "Users get a clear error when install method cannot be detected"
+  gaps_remaining: []
+  regressions: []
+---
+
+# Phase 35: Can we add a new update subcommand to update the opencode-cloud binary itself? We might need to be careful with respect to how the binary was installed with which package manager and whether it is the rust or npm binary Verification Report
+
+**Phase Goal:** Add a new update subcommand that updates the opencode-cloud binary itself, choosing the correct installation method (cargo or npm) when possible and restarting the service afterward. Provide a clear error/help message when the install method cannot be detected.
+**Verified:** 2026-01-31T23:45:39Z
+**Status:** passed
+**Re-verification:** Yes — after gap closure
+
+## Goal Achievement
+
+### Observable Truths
+
+| #   | Truth | Status | Evidence |
+| --- | ----- | ------ | -------- |
+| 1 | Update CLI can re-install opencode-cloud when the install method is known | ✓ VERIFIED | `cmd_update_cli` maps detected install method to `cargo install opencode-cloud` or `npm install -g opencode-cloud`. |
+| 2 | Users get a clear error when install method cannot be detected | ✓ VERIFIED | `cmd_update_cli` prints guidance with cargo/npm commands and a note for other package managers when detection fails. |
+| 3 | Service restarts after a successful opencode-cloud update | ✓ VERIFIED | `cmd_update_cli` calls `cmd_restart` after update success. |
+
+**Score:** 3/3 truths verified
+
+### Required Artifacts
+
+| Artifact | Expected | Status | Details |
+| -------- | -------- | ------ | ------- |
+| `packages/cli-rust/src/commands/update.rs` | Update subcommand flow for opencode-cloud binary | ✓ VERIFIED | Exists, substantive implementation, wired via `UpdateCommand::Cli`. |
+| `README.md` | User-facing instructions for updating the CLI | ✓ VERIFIED | Usage includes `occ update cli`. |
+
+### Key Link Verification
+
+| From | To | Via | Status | Details |
+| ---- | --- | --- | ------ | ------- |
+| `cmd_update_cli` | `InstallMethod::run_update` | `detect_install_method()` | ✓ WIRED | Detects method and runs cargo/npm update command. |
+| `cmd_update_cli` | `cmd_restart` | restart call | ✓ WIRED | Service restart invoked after update success. |
+| `cmd_update_cli` | error guidance | `detect_install_method()` fallback | ✓ WIRED | Guidance includes cargo/npm commands and alternate-package-manager note. |
+
+### Requirements Coverage
+
+| Requirement | Status | Blocking Issue |
+| ----------- | ------ | -------------- |
+| No Phase 35 requirements found in `REQUIREMENTS.md` | N/A | N/A |
+
+### Anti-Patterns Found
+
+| File | Line | Pattern | Severity | Impact |
+| ---- | ---- | ------- | -------- | ------ |
+| None | - | - | - | - |
+
+### Human Verification Required
+
+None.
+
+### Gaps Summary
+
+No gaps found. All must-haves are verified.
+
+---
+
+_Verified: 2026-01-31T23:45:39Z_
+_Verifier: Claude (gsd-verifier)_