Skip to content

Commit 5bf9902

Browse files
committed
docs: record slice 41 provider convergence
1 parent eee6d59 commit 5bf9902

6 files changed

Lines changed: 345 additions & 25 deletions

File tree

docs/codealmanac-launch/deployment-rename-runbook.md

Lines changed: 68 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
# Deployment Rename Runbook
22

3-
Status: partially executed.
3+
Status: partially executed; primary GitHub, Vercel, Render, Doppler, and Modal
4+
target names are verified under CodeAlmanac.
45
Purpose: rename `usealmanac` to `codealmanac-hosted` and redeploy the cloud
56
product without leaving provider state split across old and new names.
67

@@ -58,6 +59,11 @@ After GitHub remote is correct and local worktree is clean:
5859
-> /Users/rohan/Desktop/Projects/codealmanac-hosted
5960
```
6061

62+
Not executed as of Slice 41. The dirty
63+
`/Users/rohan/Desktop/Projects/usealmanac` checkout remains in place. Active
64+
launch work is using the clean hosted worktree at
65+
`/Users/rohan/.config/superpowers/worktrees/usealmanac/hosted-baseline-convergence`.
66+
6167
## 4. Repository Text And Package Names
6268

6369
Update visible/project names:
@@ -142,6 +148,36 @@ Verified:
142148
https://www.codealmanac.com -> HTTP 200
143149
```
144150

151+
Executed on 2026-07-02 in Slice 41:
152+
153+
```text
154+
PATCH https://api.vercel.com/v9/projects/prj_sBOdSIF82roDGnkFeYrh5qdg6epp?teamId=team_bAf9K1EW16Pkf6bysSN8PMXy
155+
body: {"name":"codealmanac-hosted"}
156+
```
157+
158+
Verified:
159+
160+
```text
161+
vercel project inspect codealmanac-hosted --scope thealmanac -> found
162+
vercel project inspect usealmanac --scope thealmanac -> no project
163+
```
164+
165+
Executed on 2026-07-02 in Slice 41:
166+
167+
```bash
168+
cd /Users/rohan/.config/superpowers/worktrees/usealmanac/hosted-baseline-convergence/frontend
169+
vercel link --yes --project codealmanac-hosted --scope thealmanac
170+
vercel deploy --prod --scope thealmanac --yes
171+
```
172+
173+
Verified:
174+
175+
```text
176+
production: https://codealmanac-hosted-lasush9ur-thealmanac.vercel.app
177+
alias: https://www.codealmanac.com
178+
curl https://www.codealmanac.com -> HTTP 200
179+
```
180+
145181
## 6. Render
146182

147183
Use Render CLI/API or dashboard.
@@ -197,6 +233,20 @@ Verified deploy:
197233
dep-d930nheh2hms73d259s0 -> live
198234
```
199235

236+
Executed on 2026-07-02 in Slice 41:
237+
238+
```bash
239+
render deploys create srv-d8g8nb37uimc739vnnsg --commit a781e51 --wait --confirm --output json
240+
```
241+
242+
Verified:
243+
244+
```text
245+
dep-d938j4km0tmc73d6p3sg -> live
246+
commit -> a781e5189da4403bcf8b31d7fb9129b3779aec01
247+
https://codealmanac-backend-docker.onrender.com/api/health -> HTTP 200 {"status":"ok"}
248+
```
249+
200250
## 7. Modal
201251

202252
Use Modal CLI.
@@ -229,6 +279,10 @@ Verified deployed Modal app:
229279
codealmanac-hosted-updates
230280
```
231281

282+
Slice 41 verified that both `codealmanac-hosted-updates` and the old
283+
`usealmanac-updates` app are still deployed. Do not delete the old app except
284+
as an explicit provider-retirement operation.
285+
232286
## 8. Supabase
233287

234288
Use Supabase CLI.
@@ -313,6 +367,11 @@ USEALMANAC
313367
usealmanac
314368
```
315369

370+
Slice 41 verified `doppler secrets --project codealmanac --config prd
371+
--only-names | rg 'USEALMANAC|usealmanac'` returns no matches. The same config
372+
still contains expected active names such as `MODAL_APP_NAME`,
373+
`FRONTEND_BASE_URL`, `BACKEND_BASE_URL`, WorkOS keys, and GitHub App keys.
374+
316375
## 11. PostHog
317376

318377
Use PostHog UI/API/tooling. The official npm package is `@posthog/cli`, whose
@@ -327,6 +386,9 @@ Verify:
327386
- signup/onboarding events still arrive
328387
- run/delivery events still arrive
329388

389+
Slice 41 verified `posthog-cli api --help` exposes the agent API surface. No
390+
PostHog mutation was performed in this slice.
391+
330392
## 12. Autumn
331393

332394
Use Autumn CLI/tooling or dashboard. The Autumn CLI package is `atmn`; in the
@@ -343,6 +405,11 @@ Verify:
343405
make billing-verify
344406
```
345407

408+
Slice 41 verified `make billing-verify` through Doppler
409+
`codealmanac/dev_personal`; free, pro, and scale plans match expected pricing.
410+
Running raw `npm run billing:verify` without Doppler fails because
411+
`AUTUMN_SECRET_KEY` is absent, which is expected outside provider-backed env.
412+
346413
## 13. Final Smoke Checks
347414

348415
From `codealmanac-hosted`:

docs/codealmanac-launch/next-agent-brief.md

Lines changed: 32 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -10,45 +10,54 @@ verification, launch-folder updates, commit, push, and RelayForge update.
1010

1111
## Last Completed Slice
1212

13-
Slice 40 added hosted terminal run events.
13+
Slice 41 converged hosted product identity and provider deployment naming.
1414

1515
Implemented:
1616

1717
- hosted worktree at
1818
`/Users/rohan/.config/superpowers/worktrees/usealmanac/hosted-baseline-convergence`
1919
- hosted branch `codex/workos-authkit-api-foundation`
20-
- hosted `RunFailed` domain event
21-
- hosted `RunStale` domain event
22-
- `UpdateCompletion` dispatches `RunFailed` after failed or blocked worker
23-
completion
24-
- `UpdateCompletion` dispatches `RunStale` after delivery detects that the
25-
expected branch head moved
26-
- failed/stale run events carry repo id, account id, repo full name, source
27-
head sha, and reason; stale events also carry expected and actual head shas
28-
- pushed hosted commit
29-
`8795849 feat: emit terminal run events`
30-
- CodeAlmanac product code was unchanged; local launch docs record this slice
31-
in a follow-up docs commit.
20+
- active hosted identity strings now say `codealmanac-hosted` in agent docs,
21+
FastAPI metadata, loggers, domain-event session keys, frontend support
22+
defaults, and the clean-slate Supabase migration comment
23+
- Vercel project id `prj_sBOdSIF82roDGnkFeYrh5qdg6epp` was renamed from
24+
`thealmanac/usealmanac` to `thealmanac/codealmanac-hosted`
25+
- clean hosted frontend checkout was linked to the renamed Vercel project
26+
- hosted commit `a781e51 chore: align hosted product identity` was pushed
27+
- Vercel production deployed
28+
`https://codealmanac-hosted-lasush9ur-thealmanac.vercel.app` and aliased it
29+
to `https://www.codealmanac.com`
30+
- Render service `srv-d8g8nb37uimc739vnnsg` deployed exact commit
31+
`a781e5189da4403bcf8b31d7fb9129b3779aec01`; deploy
32+
`dep-d938j4km0tmc73d6p3sg` is live
33+
- production smoke passed for `https://www.codealmanac.com` and
34+
`https://codealmanac-backend-docker.onrender.com/api/health`
3235

3336
Verified:
3437

3538
```text
3639
cd /Users/rohan/.config/superpowers/worktrees/usealmanac/hosted-baseline-convergence/backend
37-
uv run pytest tests/test_events_contract.py tests/test_updates_contract.py tests/test_architecture_contract.py -q
40+
uv run pytest tests/test_events_contract.py tests/test_identity_auth_contract.py tests/test_architecture_contract.py -q
3841
uv run ruff check .
3942
uv run python -m compileall src modal_app -q
4043
uv run pytest -q
4144
git diff --check
45+
cd ../frontend
46+
npm run test:routes
47+
npm run test:frontend
48+
npm run lint
49+
npm run build
4250
```
4351

44-
Counts so far: hosted backend focused `108 passed`; hosted backend full
45-
`334 passed, 1 warning`; hosted ruff, compileall, and diff-check passed.
52+
Counts so far: hosted backend focused `85 passed`; hosted backend full
53+
`334 passed, 1 warning`; frontend routes `27 passed`; frontend components
54+
`44 passed`; hosted ruff, compileall, lint, build, and diff-check passed.
4655

4756
## Next Pressure Test
4857

4958
Choose the next launch-hardening slice between terminal run fanout,
5059
cloud run cancel/retry semantics, richer frontend onboarding pages, and
51-
deployment/provider rename checks.
60+
remaining provider cleanup.
5261

5362
Pressure points:
5463

@@ -61,6 +70,10 @@ Pressure points:
6170
- browser setup/onboarding entrypoints now have stable redirect URLs, but
6271
richer onboarding screens still need product UI
6372
- old inline-message conversation routes should remain compatibility-only
73+
- old Modal app `usealmanac-updates` is still deployed; retire it only in an
74+
explicit provider cleanup step
75+
- dirty `/Users/rohan/Desktop/Projects/usealmanac` still exists and should not
76+
be used for launch work until cleaned or renamed
6477

6578
## Known Repo State
6679

@@ -87,7 +100,8 @@ to origin at `fbf8b5a feat: add CLI repository trigger routes`; Slice 37 is
87100
pushed to origin at `168f9b2 feat: add CLI run read routes`; Slice 38 is
88101
pushed to origin at `ed7e765 feat: add cloud route handoff`; Slice 39 is
89102
pushed to origin at `14caf8b feat: start cloud runs from CLI`; Slice 40 is
90-
pushed to origin at `8795849 feat: emit terminal run events`.
103+
pushed to origin at `8795849 feat: emit terminal run events`; Slice 41 is
104+
pushed to origin at `a781e51 chore: align hosted product identity`.
91105

92106
The local wiki command currently fails on this checkout with:
93107

docs/codealmanac-launch/progress.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ Percentages are planning estimates, not accounting metrics.
88

99
## Latest RelayForge Update
1010

11-
Sent: 2026-07-02 after Slice 40 terminal run events.
11+
Sent: 2026-07-02 after Slice 41 hosted rename/provider convergence.
1212

1313
Route:
1414

@@ -26,11 +26,11 @@ It was not present in `codealmanac/prd` when checked.
2626

2727
| Area | Latest | Previous | Basis |
2828
| --- | ---: | ---: | --- |
29-
| CodeAlmanac backend/local | 95% | 95% | Slice 40 is hosted-only; local worker behavior is unchanged. |
30-
| CodeAlmanac CLI/public UX | 87% | 87% | Slice 40 adds no public CLI verbs. |
31-
| CodeAlmanac-hosted backend/auth/API | 85% | 84% | Hosted now emits typed `RunFailed` and `RunStale` domain events for terminal run fanout. |
32-
| Hosted frontend/onboarding | 35% | 35% | Slice 40 does not change hosted UI; richer onboarding screens remain. |
33-
| Infra/deploy rename | 15% | 15% | Slice 35 changes Supabase schema but does not change provider deployment naming/configuration. |
29+
| CodeAlmanac backend/local | 95% | 95% | Slice 41 is hosted/provider-only; local worker behavior is unchanged. |
30+
| CodeAlmanac CLI/public UX | 87% | 87% | Slice 41 adds no public CLI verbs. |
31+
| CodeAlmanac-hosted backend/auth/API | 86% | 85% | Active hosted runtime identity now says `codealmanac-hosted`; the exact commit is deployed on Render. |
32+
| Hosted frontend/onboarding | 35% | 35% | Slice 41 changes support defaults and deploy identity, not onboarding screens. |
33+
| Infra/deploy rename | 70% | 15% | GitHub repo, Vercel project, Render service, Doppler project, Modal target, production frontend, and backend health are verified under CodeAlmanac names. |
3434

3535
## Update Rule
3636

docs/codealmanac-launch/verification-matrix.md

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -635,6 +635,16 @@ Current evidence:
635635
- Slice 40 hosted verification passed with focused tests (`108 passed`), full
636636
hosted backend tests (`334 passed, 1 warning`), `uv run ruff check .`,
637637
`uv run python -m compileall src modal_app -q`, and `git diff --check`.
638+
- Slice 41 aligned active hosted product identity with `codealmanac-hosted`.
639+
`CLAUDE.md`, `MANUAL.md`, FastAPI app metadata, logger names, event
640+
dispatcher session keys, frontend support defaults, and the clean-slate
641+
Supabase migration comment no longer use active `usealmanac` naming.
642+
- Slice 41 hosted verification passed with backend focused tests
643+
(`85 passed`), full backend tests (`334 passed, 1 warning`),
644+
`uv run ruff check .`, `uv run python -m compileall src modal_app -q`,
645+
frontend route tests (`27 passed`), frontend component tests (`44 passed`),
646+
`npm run lint`, `npm run build`, and `git diff --check`. The frontend build
647+
retained the known non-blocking CSS optimizer warning about `m-* utility`.
638648
- Remaining hosted worker risks: terminal failed/stale GitHub check subscriber,
639649
cloud run cancel/retry, and richer production setup/onboarding screens
640650
still need launch-hardening.
@@ -660,3 +670,29 @@ Current evidence:
660670
`https://www.codealmanac.com`.
661671
- Slice 25 makes the hosted rename/deploy-surface changes available on a clean
662672
current-main branch before the WorkOS/AuthKit and public API slices.
673+
- Slice 41 verified GitHub repo `AlmanacCode/codealmanac-hosted`, default
674+
branch `main`, and clean hosted worktree origin
675+
`https://github.com/AlmanacCode/codealmanac-hosted.git`.
676+
- Slice 41 renamed Vercel project id `prj_sBOdSIF82roDGnkFeYrh5qdg6epp` from
677+
`thealmanac/usealmanac` to `thealmanac/codealmanac-hosted` through the
678+
documented `PATCH /v9/projects/{idOrName}` API. `vercel project inspect
679+
codealmanac-hosted --scope thealmanac` succeeds; inspecting `usealmanac`
680+
fails with no project.
681+
- Slice 41 deployed the hosted frontend to production. Vercel build
682+
`https://codealmanac-hosted-lasush9ur-thealmanac.vercel.app` was aliased to
683+
`https://www.codealmanac.com`, and `curl` returned HTTP 200.
684+
- Slice 41 deployed Render service `srv-d8g8nb37uimc739vnnsg` at exact commit
685+
`a781e5189da4403bcf8b31d7fb9129b3779aec01`. Deploy
686+
`dep-d938j4km0tmc73d6p3sg` finished `live`, and
687+
`https://codealmanac-backend-docker.onrender.com/api/health` returned HTTP
688+
200 with `{"status":"ok"}`.
689+
- Slice 41 verified Doppler project `codealmanac` configs
690+
`dev`, `dev_personal`, `stg`, and `prd`; `codealmanac/prd` has no secret
691+
names matching `usealmanac` or `USEALMANAC`.
692+
- Slice 41 verified Modal contains deployed `codealmanac-hosted-updates`.
693+
The old `usealmanac-updates` app is still deployed and should be cleaned up
694+
only in an explicit provider-retirement step.
695+
- Slice 41 verified `posthog-cli api` is available and that Autumn billing
696+
verification passes through `make billing-verify` with Doppler
697+
`codealmanac/dev_personal`. Raw `npm run billing:verify` fails without
698+
`AUTUMN_SECRET_KEY`, which is expected outside Doppler.

docs/codealmanac-launch/worklog.md

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,44 @@
22

33
## 2026-07-02
44

5+
- Planned Slice 41 in
6+
`docs/plans/2026-07-02-slice-41-hosted-rename-provider-convergence.md`.
7+
- Updated active hosted identity references from `usealmanac` to
8+
`codealmanac-hosted` in `CLAUDE.md`, `MANUAL.md`, FastAPI app metadata,
9+
logger names, event-dispatch session keys, frontend support defaults, and the
10+
clean-slate Supabase migration comment.
11+
- Renamed Vercel project `prj_sBOdSIF82roDGnkFeYrh5qdg6epp` from
12+
`thealmanac/usealmanac` to `thealmanac/codealmanac-hosted` through Vercel's
13+
documented project update API.
14+
- Linked the clean hosted frontend checkout to `thealmanac/codealmanac-hosted`
15+
for production deployment commands.
16+
- Pushed hosted commit `a781e51 chore: align hosted product identity` to
17+
`origin/codex/workos-authkit-api-foundation`.
18+
- Deployed the hosted frontend to Vercel production. Vercel produced
19+
`https://codealmanac-hosted-lasush9ur-thealmanac.vercel.app` and aliased it
20+
to `https://www.codealmanac.com`.
21+
- Deployed Render service `srv-d8g8nb37uimc739vnnsg` at exact hosted commit
22+
`a781e5189da4403bcf8b31d7fb9129b3779aec01`; deploy
23+
`dep-d938j4km0tmc73d6p3sg` finished `live`.
24+
- Verified production smoke: `https://www.codealmanac.com` returned HTTP 200
25+
and `https://codealmanac-backend-docker.onrender.com/api/health` returned
26+
HTTP 200 with `{"status":"ok"}`.
27+
- Verified provider state: GitHub repo `AlmanacCode/codealmanac-hosted`,
28+
Vercel project `thealmanac/codealmanac-hosted`, Render service
29+
`codealmanac-backend`, Doppler project `codealmanac`, Modal app
30+
`codealmanac-hosted-updates`, PostHog CLI API availability, and Autumn
31+
billing via `make billing-verify`.
32+
- Direct `npm run billing:verify` failed without `AUTUMN_SECRET_KEY`; rerunning
33+
through `make billing-verify` passed for free, pro, and scale plans.
34+
- Verified Slice 41 backend gates with focused pytest (`85 passed`), full
35+
pytest (`334 passed, 1 warning`), `uv run ruff check .`,
36+
`uv run python -m compileall src modal_app -q`, and `git diff --check`.
37+
- Verified Slice 41 frontend gates with `npm run test:routes` (`27 passed`),
38+
`npm run test:frontend` (`44 passed`), `npm run lint`, and `npm run build`.
39+
The build retained the known CSS optimizer warning about `m-* utility`.
40+
- Recorded progress as: CodeAlmanac backend/local 95%, CLI/public UX 87%,
41+
CodeAlmanac-hosted backend/auth/API 86%, hosted frontend/onboarding 35%, and
42+
infra/deploy rename 70%.
543
- Planned Slice 38 in
644
`docs/plans/2026-07-02-slice-38-cloud-open-handoff.md`.
745
- Added hosted browser-session repository resolution:

0 commit comments

Comments
 (0)