golem15/summercms
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(01): create phase plan

Browse Source
This commit is contained in:
Jakub Zych
2026-09-16 12:30:05 +02:00
parent 0bcc422b53
commit 552cadbdf9
9 changed files with 735 additions and 18 deletions
Download Patch File Download Diff File Expand all files Collapse all files

23
.planning/phases/01-framework-kernel-foundation/01-VALIDATION.md
View File

@@ -16,14 +16,14 @@ created: 2026-09-16
| Framework | `go test` (Go 1.27.0) |
| Config file | No test harness yet; first implementation slice adds Go tests |
| Quick run | `go vet ./... && go test ./...` from repo root, then from `examples/hello` once created |
| Full suite | Both modules: `go vet ./...`, `go test ./...`, `go test -race ./...`; generated binary integration |
| Full suite | Framework, hello app and three hello plugin modules: `go vet ./...`, `go test ./...`, `go test -race ./...`; generated binary integration |
| Estimated runtime | Measure after dependencies are cached; no assumed threshold |
## Sampling Rate
- After each implementation task commit, run root `go vet ./... && go test ./...`; run the same from `examples/hello` after it exists.
- After each plan wave, run both module checks plus the relevant built-binary smoke.
- Before verify-work, run race tests in both modules and an end-to-end `summer build`/hello invocation.
- Before verify-work, run race tests in all five modules and an end-to-end `summer build`/hello invocation.
- Record actual feedback latency and single-plugin rebuild latency; no fixed performance promise has been set.
## Per-Requirement Verification Map
@@ -41,6 +41,21 @@ created: 2026-09-16
| KERN-09 | integration | Temp app source edit triggers one debounced rebuild and restart, latency line captured | Pending |
| CLI-01 | unit + integration | Plugin command discovery, injected output, non-TTY spinner/progress/table/prompt behavior | Pending |
## Per-Task Verification Map
| Task ID | Plan | Wave | Requirements | Automated check | Status |
|---|---|---|---|---|---|
| 01-01-01 | 01 | 1 | KERN-01/02/03/04, CLI-01 | Root and hello `go vet ./...` + `go test ./...` | Pending |
| 01-01-02 | 01 | 1 | KERN-04, CLI-01 | Same checks plus `summer build` and built hello command | Pending |
| 01-02-01 | 02 | 2 | KERN-01/03 | `go test ./compass ./pact`; hello tests | Pending |
| 01-02-02 | 02 | 2 | KERN-02/03/05/08 | `go test ./party ./backpack ./pact`; hello tests | Pending |
| 01-02-03 | 02 | 2 | KERN-06/07 | `go test ./festival ./towel ./backpack`; hello tests | Pending |
| 01-03-01 | 03 | 3 | KERN-04 | `go test ./internal/build ./cmd/summer`; hello tests | Pending |
| 01-03-02 | 03 | 3 | CLI-01 | `go test ./bonfire ./cmd/summer`; hello tests | Pending |
| 01-03-03 | 03 | 3 | KERN-09 | `go test ./internal/dev ./internal/build ./cmd/summer`; hello tests | Pending |
| 01-04-01 | 04 | 4 | KERN-01/02/03/05/06/07/08 | `go test -race ./compass ./party ./backpack ./festival ./towel ./pact` | Pending |
| 01-04-02 | 04 | 4 | KERN-04/09, CLI-01 | `bash scripts/check-phase1.sh` | Pending |
## Wave 0 Requirements
- [ ] First implementation slice creates `examples/hello`, its `go.mod`, and a root `go.work` that names every example module.
@@ -58,8 +73,8 @@ created: 2026-09-16
- [ ] Every plan task has an automated verification or an explicit Wave 0 dependency.
- [ ] No three consecutive implementation tasks lack automated feedback.
- [ ] Root and nested example modules both run `go vet`, tests and race tests.
- [ ] Root, hello app and three plugin modules run `go vet`, tests and race tests.
- [ ] No watch-mode flags in CI commands.
- [ ] Set `nyquist_compliant: true` after plan-task mapping is complete.
- [ ] Set `nyquist_compliant: true` after all mapped checks exist and pass.
**Approval:** pending plan verification