|
1 | 1 | # v2 Cutover Implementation Plan |
2 | 2 |
|
| 3 | +> **STATUS 2026-05-19: SHIPPED.** Executed on branch `wip/v2-cutover`. v2 is now canonical at root URLs (`/`, `/writings/`, `/<slug>/`, `/pages/<slug>/`); `/v2*` URLs return 404; `style.css` and `sections.js` deleted. See `## Shipped — Verification Snapshot` at the bottom of this doc for the final smoke results. |
| 4 | +
|
3 | 5 | > **For agentic workers:** Execute task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. |
4 | 6 |
|
5 | 7 | **Goal:** Promote v2 to canonical. The new design replaces the old at the existing live URLs (`/`, `/writings/`, `/<slug>/`, `/pages/<slug>/`). The v2 scaffolding (`/v2*` routes, `v2_*.html` templates, `v2_router` plugin) is retired. Inbound links to existing essays continue to resolve. Old `style.css` deleted. |
@@ -872,3 +874,42 @@ git revert -m 1 <merge-commit-hash> |
872 | 874 | git push origin master |
873 | 875 | ``` |
874 | 876 | This restores the parallel state — old site at `/`, v2 at `/v2*` — within one GH Actions cycle. |
| 877 | + |
| 878 | +--- |
| 879 | + |
| 880 | +## Shipped — Verification Snapshot |
| 881 | + |
| 882 | +Cutover executed 2026-05-19 on branch `wip/v2-cutover`. |
| 883 | + |
| 884 | +**Commits:** |
| 885 | +- Phase 1 — `feat(cutover): promote v2 design to canonical templates` — 11 files changed (+1085, -344) |
| 886 | +- Phase 2 — `chore(cutover): retire v2 scaffolding (templates + plugin + config)` — 10 files changed (+1, -428) |
| 887 | +- Phase 3 — `chore(cutover): retire style.css + sections.js; document cutover` — to be added by merge |
| 888 | + |
| 889 | +**Smoke test after Phase 2 (full rebuild):** |
| 890 | +- 46 articles + 4 pages rendered |
| 891 | +- All canonical URLs (`/`, `/writings/`, `/<slug>/`, `/pages/<slug>/`) → 200 |
| 892 | +- All `/v2*` URLs → 404 (paths absent from `output/`) |
| 893 | +- `/book/` and `/book/opener/` → 200 (book is served via EXTRA_PATH_METADATA, unaffected) |
| 894 | +- `theme/static/css/style.css` deleted (was 1674 lines, 91 `!important` rules) |
| 895 | +- `theme/static/js/sections.js` deleted |
| 896 | +- `theme/static/js/lightbox.js` selector updated to `.article-prose img` |
| 897 | +- `theme/templates/book-part.html` comment block updated (was referencing the deleted `style.css`) |
| 898 | + |
| 899 | +**Files retired:** |
| 900 | +| File | Old size | |
| 901 | +|---|---| |
| 902 | +| `theme/static/css/style.css` | 1674 lines | |
| 903 | +| `theme/static/css/style.css.backup` | (backup) | |
| 904 | +| `theme/static/js/sections.js` | 100+ lines | |
| 905 | +| `theme/templates/base-v2.html` | ~60 lines | |
| 906 | +| `theme/templates/v2_index.html` | ~80 lines | |
| 907 | +| `theme/templates/v2_archives.html` | ~60 lines | |
| 908 | +| `theme/templates/v2_article.html` | ~16 lines | |
| 909 | +| `theme/templates/v2_longform_article.html` | ~48 lines | |
| 910 | +| `theme/templates/v2_page.html` | ~17 lines | |
| 911 | +| `theme/templates/v2_inference_economics.html` | ~16 lines | |
| 912 | +| `theme/templates/v2_theforge.html` | ~42 lines | |
| 913 | +| `plugins/v2_router.py` | ~60 lines | |
| 914 | +| `plugins/` (directory) | empty after removal | |
| 915 | + |
0 commit comments