From f6af510716004465a051547f3bfee2eb5546676d Mon Sep 17 00:00:00 2001 From: Jakub Zych Date: Fri, 18 Sep 2026 14:14:13 +0200 Subject: [PATCH] docs(state): record 04-04 completion and mark phase 04 complete Co-authored-by: Cursor --- .planning/ROADMAP.md | 6 +++--- .planning/STATE.md | 23 +++++++++++++---------- 2 files changed, 16 insertions(+), 13 deletions(-) diff --git a/.planning/ROADMAP.md b/.planning/ROADMAP.md index b2c053f..ef2a1e0 100644 --- a/.planning/ROADMAP.md +++ b/.planning/ROADMAP.md @@ -16,7 +16,7 @@ Decimal phases appear between their surrounding integers in numeric order. - [x] **Phase 1: Framework kernel foundation** - Config, plugin registry, event bus, container and CLI skeleton boot the `summer` binary (completed 2026-09-16) - [x] **Phase 2: API parity harness bootstrap** - Fixture recorder + replay-and-diff harness against the live PHP backend, built on the Phase 1 command kernel (completed 2026-09-17) - [x] **Phase 3: First vertical slice — genres end to end** - `GET /_fonoteka/api/v1/genres` passes the parity diff through every layer (completed 2026-09-17) -- [ ] **Phase 4: CLI scaffolding, i18n and mail** - Scaffolding commands, translated/pluralized strings, mail templates +- [x] **Phase 4: CLI scaffolding, i18n and mail** - Scaffolding commands, translated/pluralized strings, mail templates (completed 2026-09-18) - [ ] **Phase 5: Data layer full fidelity** - All 25 models and 27 migrations with fillable/hidden/cast/soft-delete discipline - [ ] **Phase 6: HTTP routing, auth groups and rate limiting** - Three auth groups, named rate buckets, OAuth-safe middleware structure - [ ] **Phase 7: User plugin and authentication** - Registration, login, JWT, organizations, personal tokens, must-change-password @@ -167,7 +167,7 @@ Plans: **Wave 4** *(blocked on Wave 3 completion)* -- [ ] 04-04-PLAN.md — Verify scaffolding, translation and mail with unit and SMTP integration tests +- [x] 04-04-PLAN.md — Verify scaffolding, translation and mail with unit and SMTP integration tests ### Phase 5: Data layer full fidelity @@ -367,7 +367,7 @@ Phases execute in numeric order: 1 → 2 → 3 → 4 → 5 → 6 → 7 → 8 → | 1. Framework kernel foundation | 4/4 | Complete | 2026-09-16 | | 2. API parity harness bootstrap | 5/5 | Complete | 2026-09-17 | | 3. First vertical slice — genres end to end | 4/4 | Complete | 2026-09-17 | -| 4. CLI scaffolding, i18n and mail | 3/4 | In Progress| | +| 4. CLI scaffolding, i18n and mail | 4/4 | Complete | 2026-09-18 | | 5. Data layer full fidelity | 0/TBD | Not started | - | | 6. HTTP routing, auth groups and rate limiting | 0/TBD | Not started | - | | 7. User plugin and authentication | 0/TBD | Not started | - | diff --git a/.planning/STATE.md b/.planning/STATE.md index 053cb03..ed8fd35 100644 --- a/.planning/STATE.md +++ b/.planning/STATE.md @@ -2,16 +2,16 @@ gsd_state_version: 1.0 milestone: v1.0 milestone_name: milestone -status: executing -stopped_at: Completed 04-03-PLAN.md -last_updated: "2026-09-18T12:03:33.022Z" +status: verifying +stopped_at: Completed 04-04-PLAN.md +last_updated: "2026-09-18T12:14:08.793Z" last_activity: 2026-09-18 progress: total_phases: 15 - completed_phases: 3 + completed_phases: 4 total_plans: 17 - completed_plans: 16 - percent: 20 + completed_plans: 17 + percent: 27 --- # Project State @@ -27,10 +27,10 @@ See: .planning/PROJECT.md (updated 2026-09-16) Phase: 04 (cli-scaffolding-i18n-and-mail) — EXECUTING Plan: 4 of 4 -Status: Ready to execute +Status: Phase complete — ready for verification Last activity: 2026-09-18 -Progress: [█████████░] 94% +Progress: [██████████] 100% ## Performance Metrics @@ -61,6 +61,7 @@ Progress: [█████████░] 94% | Phase 04 P01 | 11 min | 3 tasks | 14 files | | Phase 04 P04-02 | 10 min | 3 tasks | 11 files | | Phase 04 P04-03 | 6 min | 3 tasks | 15 files | +| Phase 04 P04-04 | 8 min | 3 tasks | 9 files | ## Accumulated Context @@ -113,6 +114,8 @@ Recent decisions affecting current work: - [Phase 04]: Goldmark v1.8.6 is used without html.WithUnsafe; final HTML is rejected if script/iframe, event handlers, or javascript/vbscript/data schemes remain — D-07 and T-04-08: Goldmark default rejects raw HTML; a second pass keeps layout HTML trusted only as template.HTML - [Phase 04]: postcard.Mailer is published after Register and before Boot; each HasMailTemplates catalog is validated at that plugin Boot transition — D-20 D-21: plugin Boot can Lookup the mailer; missing files fail as party: boot with the dotted name - [Phase 04]: mail.smtp.tls defaults to mandatory STARTTLS; none/notls is opt-in for Mailpit and is never inferred — D-18 T-04-10: no silent production TLS downgrade; Mailpit needs explicit NoTLS +- [Phase 04]: Mailpit image is axllent/mailpit:v1.31.1; receipt is polled from /api/v1/messages then /api/v1/message/{ID} — D-19: a successful Send claim requires observed receipt through a separate HTTP API; pin a released Mailpit tag +- [Phase 04]: fstest.MapFS WalkDir cannot host '..' keys; malformed lang paths are extra-segment and wrong-suffix files — MapFS Open/WalkDir follows .. into an infinite directory loop; parseLangPath still rejects cleaned traversal ### Pending Todos @@ -134,6 +137,6 @@ Items acknowledged and carried forward from previous milestone close: ## Session Continuity -Last session: 2026-09-18T12:03:18.199Z -Stopped at: Completed 04-03-PLAN.md +Last session: 2026-09-18T12:13:20.925Z +Stopped at: Completed 04-04-PLAN.md Resume file: None