docs(11.1-02): complete docs accuracy gates, theme and docs:serve plan

- SUMMARY with coverage, deviations and verification
- STATE, ROADMAP and REQUIREMENTS (DOCS-02, DOCS-04, DOCS-05, DOCS-08)
- deferred items: README summary backticks in leads
This commit is contained in:
Jakub Zych
2026-09-30 22:00:46 +02:00
parent dd11bdb0c7
commit f77b1d8688
5 changed files with 330 additions and 18 deletions

View File

@@ -4,16 +4,16 @@ milestone: v1.0
current_phase: "11.1"
current_phase_name: SummerCMS documentation for humans and AI agents (INSERTED)
status: executing
stopped_at: Completed 11.1-01-PLAN.md
last_updated: "2026-09-30T19:28:23.430Z"
stopped_at: Completed 11.1-02-PLAN.md
last_updated: "2026-09-30T20:00:38.713Z"
last_activity: 2026-09-30
last_activity_desc: Phase 11.1 execution started
state_head: e75490e8925112cc018899c3e212c086f423ea7f
state_head: dd11bdb0c7443b69cb1df3df4574fa6a8024cdb8
progress:
total_phases: 19
completed_phases: 9
total_plans: 92
completed_plans: 87
completed_plans: 88
milestone_name: milestone
---
@@ -29,7 +29,7 @@ See: .planning/PROJECT.md (updated 2026-09-16)
## Current Position
Phase: 11.1 (SummerCMS documentation for humans and AI agents (INSERTED)) — EXECUTING
Plan: 2 of 6
Plan: 3 of 6
Status: Ready to execute
Last activity: 2026-09-30 — Phase 11.1 execution started
@@ -142,6 +142,7 @@ Progress: [██████░░░░] 60%
| Phase 11 P07 | 59min | 3 tasks | 40 files |
| Phase 11 P08 | unknown (manual close-out) | 3 tasks | 13 files |
| Phase 11.1 P01 | 15min | 3 tasks | 18 files |
| Phase 11.1 P02 | 30min | 3 tasks | 53 files |
## Accumulated Context
@@ -389,6 +390,9 @@ Recent decisions affecting current work:
- [Phase 11]: Phase gates accept a pending skip only by exact test name and pending text (TestBroadcastGoldens/created and /updated until Phase 12), in check-phase11.sh and check-phase10.1.sh
- [Phase 11]: Phase 11-08: lagoon.AfterCommit inside a foreign plain GORM transaction warns and skips the callback instead of running it immediately; Cabana writes and SaveAlbum run in lagoon.Transaction — Lagoon cannot observe a foreign commit; running early sent uncommitted, pre-pivot or rolled-back Album state to Typesense (CR-01)
- [Phase 11]: Phase 11-08: a nested lagoon.Transaction given a root handle returns an error (WR-03) — Treating it as a savepoint would commit independently while its callbacks waited on the parent buffer
- [Phase 11.1]: 11.1-02: The identifier index resolves promoted members itself; go doc does not resolve embedding and stays only as the fallback
- [Phase 11.1]: 11.1-02: docsCommands() collects app command names from the real constructors on backpack.New(&compass.Config{}); TestDocsCommandsMirrorGeneratedMain keeps it in step with internal/build
- [Phase 11.1]: 11.1-02: chroma/v2 v2.27.0 is the only new direct dependency (D-15); tokens map onto tok-* classes without chroma's HTML formatter
### Pending Todos
@@ -419,6 +423,6 @@ Items acknowledged and carried forward from previous milestone close:
## Session Continuity
Last session: 2026-09-30T19:28:22.944Z
Stopped at: Completed 11.1-01-PLAN.md
Last session: 2026-09-30T20:00:38.048Z
Stopped at: Completed 11.1-02-PLAN.md
Resume file: None