docs(14-01): complete framework helpers plan

This commit is contained in:
Jakub Zych
2026-10-03 20:03:29 +02:00
parent 7700c6da28
commit 43b869d613
4 changed files with 297 additions and 18 deletions

View File

@@ -2,18 +2,18 @@
gsd_state_version: "1.0"
milestone: v1.0
current_phase: 14
current_phase_name: domain-jobs-and-external-integrations
current_phase_name: Domain jobs and external integrations
status: executing
stopped_at: Phase 14 context gathered
last_updated: "2026-10-03T17:16:09.658Z"
stopped_at: Completed 14-01-PLAN.md
last_updated: "2026-10-03T18:03:25.034Z"
last_activity: 2026-10-03
last_activity_desc: Phase 13 execution started
state_head: ed4d4c380cf50b6d683fd221a29166e550deae25
last_activity_desc: Phase 14 execution started
state_head: 7700c6da28cf98db6ff54a0965a2a4b9f195e984
progress:
total_phases: 22
completed_phases: 11
total_plans: 118
completed_plans: 112
completed_plans: 113
milestone_name: milestone
---
@@ -24,14 +24,14 @@ milestone_name: milestone
See: .planning/PROJECT.md (updated 2026-09-16)
**Core value:** An existing WinterCMS-shaped app can be ported plugin by plugin to a single Go binary without its frontend noticing: the PHP version's API contract is the acceptance test.
**Current focus:** Phase 13 — Płytarium API — wishlist, notifications, CSV, credentials, public routes
**Current focus:** Phase 14 — Domain jobs and external integrations
## Current Position
Phase: 14 (domain-jobs-and-external-integrations) — READY TO EXECUTE
Plan: 6 of 6
Phase: 14 (Domain jobs and external integrations) — EXECUTING
Plan: 2 of 6
Status: Ready to execute
Last activity: 2026-10-03 — Phase 13 execution started
Last activity: 2026-10-03 — Phase 14 execution started
Progress: [██████░░░░] 60%
@@ -166,6 +166,7 @@ Progress: [██████░░░░] 60%
| Phase 13 P04 | 80min | 3 tasks | 141 files |
| Phase 13 P05 | 34 min | 3 tasks | 53 files |
| Phase 13 P06 | 70 min | 3 tasks | 59 files |
| Phase 14 P01 | 25min | 5 tasks | 42 files |
## Accumulated Context
@@ -502,6 +503,10 @@ Recent decisions affecting current work:
- [Phase 13]: 13-05: the public search is SearchAlbums with AlbumSearchParams.Public (TEXT_FIELDS_PUBLIC, no ratings join, collection-only re-gate); authenticated callers unchanged
- [Phase 13]: 13-06: the user plugin controllers floor is its pre-phase 68.8% (now 70.6%); T-13-SC reviewed at its strictest declaration (medium, mitigate) with golang.org/x/text pinned at v0.42.0 by the gate
- [Phase 13]: 13-06: tests that queue River jobs run on dedicated databases; a process booting several apps boots the job-writing one last (process-wide job dispatcher, deferred)
- [Phase 14]: 14-01: fetchguard.Fetch ignores TrustedMode; only Client honours it
- [Phase 14]: 14-01: upstream sidecars refuse unmasked Authorization/X-Api-Key; multipart file parts stored as sha256 only
- [Phase 14]: 14-01: generated mains call sunscreen.InstallDefault(os.Stderr) before compass.Load; sunscreen also redacts dashed sk- keys
- [Phase 14]: 14-01: INTG-01/INTG-02/API-08/SRCH-02 stay Pending until 14-02..14-06 deliver them
### Pending Todos
@@ -550,6 +555,6 @@ Items acknowledged and carried forward from previous milestone close:
## Session Continuity
Last session: 2026-10-03T15:27:13.097Z
Stopped at: Phase 14 context gathered
Resume file: .planning/phases/14-domain-jobs-and-external-integrations/14-CONTEXT.md
Last session: 2026-10-03T18:03:24.486Z
Stopped at: Completed 14-01-PLAN.md
Resume file: None