Skip to content

Commit 53df27a

Browse files
cursoragentpRizz
andcommitted
docs(planning): rename remaining 2fa roadmap wording to totp
Co-authored-by: Peter Ryszkiewicz <pRizz@users.noreply.github.com>
1 parent 76243eb commit 53df27a

6 files changed

Lines changed: 10 additions & 10 deletions

File tree

.planning/ROADMAP.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ Decimal phases appear between their surrounding integers in numeric order.
4747
- [x] **Phase 33: Investigate and implement a way for users that get created and configured in the container are persisted after we update the container** - Persist container users across updates
4848
- [ ] **Phase 34: Disable Cockpit User-Facing Surface** - TBD
4949
- [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
50-
- [ ] **Phase 36: Investigate and persist the 2FA setup file (~/.google_authenticator) across container upgrades** - TBD
50+
- [ ] **Phase 36: Investigate and persist the TOTP setup file (~/.google_authenticator) across container upgrades** - TBD
5151
- [x] **Phase 37: extract the "/usr/local/bin/opencode-cloud-setup.sh" content from infra/aws/cloudformation/opencode-cloud-quick.yaml into a script or multiple scrips in the opencode-cloud repo and use those instead of having the content in infra/aws/cloudformation/opencode-cloud-quick.yaml; we should do the same for infra/aws/cloud-init/opencode-cloud-quick.yaml; we should do this to improve provisioning reusability for other cloud providers** - Complete
5252

5353
## Phase Details
@@ -625,7 +625,7 @@ Plans:
625625
**Details:**
626626
Implemented `occ update cli` with install detection, restart flow, and docs guidance.
627627

628-
### Phase 36: Investigate and persist the 2FA setup file (~/.google_authenticator) across container upgrades
628+
### Phase 36: Investigate and persist the TOTP setup file (~/.google_authenticator) across container upgrades
629629

630630
**Goal:** [To be planned]
631631
**Depends on:** Phase 35
@@ -691,7 +691,7 @@ Phases execute in numeric order: 1 -> 2 -> 3 -> ... -> 33 -> 34 -> 35 -> 36 -> 3
691691
| 33. Investigate and implement a way for users that get created and configured in the container are persisted after we update the container | 1/1 | Complete | 2026-02-01 |
692692
| 34. Disable Cockpit User-Facing Surface | 0/0 | Not started | - |
693693
| 35. Update opencode-cloud self-update | 1/1 | Complete | 2026-01-31 |
694-
| 36. Investigate and persist the 2FA setup file (~/.google_authenticator) across container upgrades | 0/0 | Not started | - |
694+
| 36. Investigate and persist the TOTP setup file (~/.google_authenticator) across container upgrades | 0/0 | Not started | - |
695695
| 37. Extract opencode-cloud setup scripts | 1/1 | Complete | 2026-02-02 |
696696

697697
---

.planning/STATE.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -250,7 +250,7 @@ Recent decisions affecting current work:
250250
- Phase 34 added: Disable Cockpit user-facing surface (hide UI/CLI/docs, keep code)
251251
- 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
252252
- Phase 35 completed: update cli self-update flow and docs
253-
- Phase 36 added: Investigate and persist the 2FA setup file (~/.google_authenticator) across container upgrades
253+
- Phase 36 added: Investigate and persist the TOTP setup file (~/.google_authenticator) across container upgrades
254254
- Phase 37 added: extract the "/usr/local/bin/opencode-cloud-setup.sh" content from infra/aws/cloudformation/opencode-cloud-quick.yaml into a script or multiple scrips in the opencode-cloud repo and use those instead of having the content in infra/aws/cloudformation/opencode-cloud-quick.yaml; we should do the same for infra/aws/cloud-init/opencode-cloud-quick.yaml; we should do this to improve provisioning reusability for other cloud providers
255255
- Phase 37 completed: extracted shared provisioning scripts and bootstrapped AWS templates
256256

.planning/phases/21-use-opencode-fork-with-pam-auth/21-01-PLAN.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -169,7 +169,7 @@ RUN printf '%s\n' \
169169
'auth required pam_unix.so' \
170170
'account required pam_unix.so' \
171171
'' \
172-
'# Optional: Enable TOTP 2FA (uncomment when pam_google_authenticator is installed)' \
172+
'# Optional: Enable TOTP authentication (uncomment when pam_google_authenticator is installed)' \
173173
'# auth required pam_google_authenticator.so' \
174174
> /etc/pam.d/opencode \
175175
&& chmod 644 /etc/pam.d/opencode
@@ -181,7 +181,7 @@ RUN ls -la /etc/pam.d/opencode && cat /etc/pam.d/opencode
181181
**Key points:**
182182
- Switch to root user (PAM config must be in /etc/pam.d/)
183183
- Create file with standard UNIX authentication
184-
- Include commented 2FA option for future use
184+
- Include commented TOTP option for future use
185185
- Set appropriate permissions (644)
186186
- Verify file creation
187187

.planning/phases/21-use-opencode-fork-with-pam-auth/21-01-SUMMARY.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ metrics:
4141

4242
- **opencode-broker build:** Added section to clone fork, build Rust broker binary from `packages/opencode-broker`, install to `/usr/local/bin/opencode-broker` with setuid permissions (4755) for PAM access.
4343

44-
- **PAM configuration:** Created `/etc/pam.d/opencode` with standard UNIX authentication (`pam_unix.so`) for both auth and account modules. Includes commented 2FA option for future use.
44+
- **PAM configuration:** Created `/etc/pam.d/opencode` with standard UNIX authentication (`pam_unix.so`) for both auth and account modules. Includes commented TOTP option for future use.
4545

4646
- **opencode-broker.service:** Created systemd unit file with Type=notify, security hardening settings, RuntimeDirectory for socket creation, and enabled via symlink.
4747

@@ -62,6 +62,6 @@ metrics:
6262

6363
- Bun is installed inline during opencode build (not pre-installed in Dockerfile)
6464
- Broker build runs as root to set setuid permissions, then switches back to opencode user
65-
- PAM config uses standard UNIX authentication; 2FA support is commented for future use
65+
- PAM config uses standard UNIX authentication; TOTP support is commented for future use
6666
- opencode.json config is created during build to ensure auth is enabled by default
6767
- Both services are enabled via symlinks (systemctl doesn't work during Docker build)

.planning/phases/21-use-opencode-fork-with-pam-auth/21-CONTEXT.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -162,7 +162,7 @@ Target state:
162162
- **File**: `packages/opencode-broker/service/opencode.pam`
163163
- **Install location**: `/etc/pam.d/opencode`
164164
- **Contents**: Standard UNIX auth (`pam_unix.so`) for auth and account
165-
- **Optional**: 2FA support via `pam_google_authenticator.so` (deferred for now)
165+
- **Optional**: TOTP support via `pam_google_authenticator.so` (deferred for now)
166166

167167
### opencode Configuration
168168
- **Config file**: `~/.config/opencode/opencode.json` or similar

.planning/phases/21-use-opencode-fork-with-pam-auth/21-VERIFICATION.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -147,7 +147,7 @@ None. All code follows expected patterns:
147147
**PAM configuration (lines 465-479):**
148148
- ✓ Creates /etc/pam.d/opencode
149149
- ✓ Contains pam_unix.so for auth and account
150-
- ✓ Includes commented 2FA option
150+
- ✓ Includes commented TOTP option
151151
- ✓ Sets 644 permissions
152152
- ✓ Verifies file creation
153153

0 commit comments

Comments
 (0)