From d373667865a0f9742537dfcae78a88053558fc4c Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 17 Oct 2026 13:22:10 +0000 Subject: [PATCH] chore(specs): archive 022 to done_022 Phase 12 shipped in #741 and the website pointer bump in #742; ticks T120 and updates in-repo references to the new path. Co-Authored-By: Claude Opus 5.5 (1M context) Signed-off-by: Claude --- api/internal/telemetry/destination.go | 2 +- api/internal/telemetry/telemetry.go | 2 +- assets/design-export/MANIFEST.md | 2 +- docs/roadmap.md | 2 +- .../OPEN-DECISIONS.md | 0 .../checklists/requirements.md | 0 .../contracts/api-telemetry-http.md | 0 .../contracts/install-config.md | 0 .../contracts/receiver-http.md | 0 .../contracts/report-schema.md | 0 .../data-model.md | 0 .../plan.md | 0 .../quickstart.md | 0 .../research.md | 0 .../spec.md | 0 .../tasks.md | 2 +- telemetry-receiver/specs.md | 4 ++-- telemetryschema/doc.go | 2 +- telemetryschema/specs.md | 4 ++-- 19 files changed, 10 insertions(+), 10 deletions(-) rename specs/{022-default-telemetry-dashboard => done_022-default-telemetry-dashboard}/OPEN-DECISIONS.md (100%) rename specs/{022-default-telemetry-dashboard => done_022-default-telemetry-dashboard}/checklists/requirements.md (100%) rename specs/{022-default-telemetry-dashboard => done_022-default-telemetry-dashboard}/contracts/api-telemetry-http.md (100%) rename specs/{022-default-telemetry-dashboard => done_022-default-telemetry-dashboard}/contracts/install-config.md (100%) rename specs/{022-default-telemetry-dashboard => done_022-default-telemetry-dashboard}/contracts/receiver-http.md (100%) rename specs/{022-default-telemetry-dashboard => done_022-default-telemetry-dashboard}/contracts/report-schema.md (100%) rename specs/{022-default-telemetry-dashboard => done_022-default-telemetry-dashboard}/data-model.md (100%) rename specs/{022-default-telemetry-dashboard => done_022-default-telemetry-dashboard}/plan.md (100%) rename specs/{022-default-telemetry-dashboard => done_022-default-telemetry-dashboard}/quickstart.md (100%) rename specs/{022-default-telemetry-dashboard => done_022-default-telemetry-dashboard}/research.md (100%) rename specs/{022-default-telemetry-dashboard => done_022-default-telemetry-dashboard}/spec.md (100%) rename specs/{022-default-telemetry-dashboard => done_022-default-telemetry-dashboard}/tasks.md (99%) diff --git a/api/internal/telemetry/destination.go b/api/internal/telemetry/destination.go index ed3e184ce..e5f8b3c7e 100644 --- a/api/internal/telemetry/destination.go +++ b/api/internal/telemetry/destination.go @@ -7,7 +7,7 @@ import ( ) // DefaultEndpoint is the project default telemetry destination, ruled in -// specs/022-default-telemetry-dashboard/OPEN-DECISIONS.md OD-1. It must stay +// specs/done_022-default-telemetry-dashboard/OPEN-DECISIONS.md OD-1. It must stay // an https URL (hack/check-telemetry-default.sh enforces this in CI). const DefaultEndpoint = "https://telemetry.gameplane.net/ingest" diff --git a/api/internal/telemetry/telemetry.go b/api/internal/telemetry/telemetry.go index f040b6951..bb39a105d 100644 --- a/api/internal/telemetry/telemetry.go +++ b/api/internal/telemetry/telemetry.go @@ -1,5 +1,5 @@ // Package telemetry sends the install's usage report to its resolved -// destination (specs/022-default-telemetry-dashboard). +// destination (specs/done_022-default-telemetry-dashboard). // // Privacy: the basic report carries only the control-plane version and // total counts. The extended report adds an install ID and environment diff --git a/assets/design-export/MANIFEST.md b/assets/design-export/MANIFEST.md index ebfead4bb..86e555500 100644 --- a/assets/design-export/MANIFEST.md +++ b/assets/design-export/MANIFEST.md @@ -2502,7 +2502,7 @@ Server Settings gets a "Game configuration" section (edit `spec.config` from the ## Spec 022 telemetry notice and settings (2026-10-07) -T041 and T052 of `specs/022-default-telemetry-dashboard/`. New frames sit in an empty region below the Admin Settings row (x 11480–21120, y 25404–28584); no existing frame changed. Destination hosts are samples while OD-1 is unruled: their text nodes are named `host (SAMPLE, OD-1 unruled)` (default) and `host (SAMPLE)` (bundled). +T041 and T052 of `specs/done_022-default-telemetry-dashboard/`. New frames sit in an empty region below the Admin Settings row (x 11480–21120, y 25404–28584); no existing frame changed. Destination hosts are samples while OD-1 is unruled: their text nodes are named `host (SAMPLE, OD-1 unruled)` (default) and `host (SAMPLE)` (bundled). | Object ID | Name | Change | | --- | --- | --- | diff --git a/docs/roadmap.md b/docs/roadmap.md index 76dd0e31b..6af552bd4 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -271,7 +271,7 @@ Status as of 2026-10-14. Task counts come from each spec's `tasks.md`. - **Spec 013, expand test coverage** (`specs/done_013-expand-test-coverage/`): 39 of 62 tasks done. No external blocker is named. Open work is the live web e2e specs, the optional-components e2e, the Postgres e2e, docs and checks, and the archive step. Some tasks wait for the first green CI run of their job, and the archive waits until every PR is merged. Open PRs for this spec are in progress. - **Spec 019, app localization and community language packs** (`specs/019-localization-language-packs/`): 0 of 105 tasks checked; the four design decisions are settled. The implementation is on open PR #668 and is not yet on `master`. Unblocked by: merging PR #668, which needs human approval. The first step is the `i18n/` module and checker. - **Spec 021, edit game configuration from server Settings** (`specs/021-settings-game-config/`): implemented, 20 of 24 tasks done, pending CI and review. Blocked: CI must go green and a human must approve the PR. Unblocked by: that approval and merge, then archiving to `done_021`. -- **Spec 022, default telemetry destination, extended telemetry and telemetry dashboard** (`specs/022-default-telemetry-dashboard/`): 109 of 119 tasks done. The shipped feature is unchanged until the version-trend amendment (2026-10-14, T101 to T110) lands. Blocked: T104 needs Pencil design work on the machine where Pencil runs; T109 needs the user's sign-off before editing existing tests `lifecycle_test.go:11` and `charts_test.go:83`; T110 waits for the PR to merge. Unblocked by: the design work, that sign-off, and the merge. +- **Spec 022, default telemetry destination, extended telemetry and telemetry dashboard** (`specs/done_022-default-telemetry-dashboard/`): 109 of 119 tasks done. The shipped feature is unchanged until the version-trend amendment (2026-10-14, T101 to T110) lands. Blocked: T104 needs Pencil design work on the machine where Pencil runs; T109 needs the user's sign-off before editing existing tests `lifecycle_test.go:11` and `charts_test.go:83`; T110 waits for the PR to merge. Unblocked by: the design work, that sign-off, and the merge. - **Spec 023, change-based test selection** (`specs/023-change-based-test-selection/`): 0 of 52 tasks done; no open decisions remain. No blocker is named. T001 creates the `ci: full-run` label. T052 needs 30 merged PRs to measure runner minutes. - **Spec 025, standalone panel and API** (`specs/025-standalone-panel/`, see [standalone panel](standalone-panel.md)): implemented and merged in PR #630; all 51 tasks done, with known gaps listed in the spec. The folder was renumbered from `023-standalone-panel` and written after the fact. Next step: archive to `done_025`. diff --git a/specs/022-default-telemetry-dashboard/OPEN-DECISIONS.md b/specs/done_022-default-telemetry-dashboard/OPEN-DECISIONS.md similarity index 100% rename from specs/022-default-telemetry-dashboard/OPEN-DECISIONS.md rename to specs/done_022-default-telemetry-dashboard/OPEN-DECISIONS.md diff --git a/specs/022-default-telemetry-dashboard/checklists/requirements.md b/specs/done_022-default-telemetry-dashboard/checklists/requirements.md similarity index 100% rename from specs/022-default-telemetry-dashboard/checklists/requirements.md rename to specs/done_022-default-telemetry-dashboard/checklists/requirements.md diff --git a/specs/022-default-telemetry-dashboard/contracts/api-telemetry-http.md b/specs/done_022-default-telemetry-dashboard/contracts/api-telemetry-http.md similarity index 100% rename from specs/022-default-telemetry-dashboard/contracts/api-telemetry-http.md rename to specs/done_022-default-telemetry-dashboard/contracts/api-telemetry-http.md diff --git a/specs/022-default-telemetry-dashboard/contracts/install-config.md b/specs/done_022-default-telemetry-dashboard/contracts/install-config.md similarity index 100% rename from specs/022-default-telemetry-dashboard/contracts/install-config.md rename to specs/done_022-default-telemetry-dashboard/contracts/install-config.md diff --git a/specs/022-default-telemetry-dashboard/contracts/receiver-http.md b/specs/done_022-default-telemetry-dashboard/contracts/receiver-http.md similarity index 100% rename from specs/022-default-telemetry-dashboard/contracts/receiver-http.md rename to specs/done_022-default-telemetry-dashboard/contracts/receiver-http.md diff --git a/specs/022-default-telemetry-dashboard/contracts/report-schema.md b/specs/done_022-default-telemetry-dashboard/contracts/report-schema.md similarity index 100% rename from specs/022-default-telemetry-dashboard/contracts/report-schema.md rename to specs/done_022-default-telemetry-dashboard/contracts/report-schema.md diff --git a/specs/022-default-telemetry-dashboard/data-model.md b/specs/done_022-default-telemetry-dashboard/data-model.md similarity index 100% rename from specs/022-default-telemetry-dashboard/data-model.md rename to specs/done_022-default-telemetry-dashboard/data-model.md diff --git a/specs/022-default-telemetry-dashboard/plan.md b/specs/done_022-default-telemetry-dashboard/plan.md similarity index 100% rename from specs/022-default-telemetry-dashboard/plan.md rename to specs/done_022-default-telemetry-dashboard/plan.md diff --git a/specs/022-default-telemetry-dashboard/quickstart.md b/specs/done_022-default-telemetry-dashboard/quickstart.md similarity index 100% rename from specs/022-default-telemetry-dashboard/quickstart.md rename to specs/done_022-default-telemetry-dashboard/quickstart.md diff --git a/specs/022-default-telemetry-dashboard/research.md b/specs/done_022-default-telemetry-dashboard/research.md similarity index 100% rename from specs/022-default-telemetry-dashboard/research.md rename to specs/done_022-default-telemetry-dashboard/research.md diff --git a/specs/022-default-telemetry-dashboard/spec.md b/specs/done_022-default-telemetry-dashboard/spec.md similarity index 100% rename from specs/022-default-telemetry-dashboard/spec.md rename to specs/done_022-default-telemetry-dashboard/spec.md diff --git a/specs/022-default-telemetry-dashboard/tasks.md b/specs/done_022-default-telemetry-dashboard/tasks.md similarity index 99% rename from specs/022-default-telemetry-dashboard/tasks.md rename to specs/done_022-default-telemetry-dashboard/tasks.md index 99ef9a583..8f7daa918 100644 --- a/specs/022-default-telemetry-dashboard/tasks.md +++ b/specs/done_022-default-telemetry-dashboard/tasks.md @@ -597,7 +597,7 @@ description: "Task list for feature 022: default telemetry destination, extended - new `telemetry-receiver/versionorder_test.go`: semver up, down, equal across `v` prefixes, pre-releases, and every non-semver label as unordered - new cases in `ingest_ext_test.go` and `population_test.go` for SC-017, including duplicates and refused reports leaving both tables unchanged, and `views_test.go` for `versionTrend` with and without extended data - **needs the user's sign-off before editing** (existing tests whose expectations change): `lifecycle_test.go:11` adds the two tables to `dailyTables` so the retention sweep covers them; `charts_test.go:83` if it asserts the old "Versions" title -- [ ] T120 Push the branch and open the PR with the `ship-branch` skill; labels `type: feature`, `area: shared`, `area: specs` through REST (rule 14). After merge, `git mv specs/022-default-telemetry-dashboard specs/done_022-default-telemetry-dashboard`, update in-repo references, and delete the branch (rules 12, 16). The re-archive waits until Phase 12 is done too. +- [X] T120 Push the branch and open the PR with the `ship-branch` skill; labels `type: feature`, `area: shared`, `area: specs` through REST (rule 14). After merge, `git mv specs/022-default-telemetry-dashboard specs/done_022-default-telemetry-dashboard`, update in-repo references, and delete the branch (rules 12, 16). The re-archive waits until Phase 12 is done too. **Checkpoint**: the trend is visible and every series matches SC-017. diff --git a/telemetry-receiver/specs.md b/telemetry-receiver/specs.md index a9d64c672..8c04caa3b 100644 --- a/telemetry-receiver/specs.md +++ b/telemetry-receiver/specs.md @@ -58,7 +58,7 @@ telemetry-receiver/ ## External interface / contracts -The full contract is `specs/022-default-telemetry-dashboard/contracts/receiver-http.md`; the report format is `contracts/report-schema.md`. +The full contract is `specs/done_022-default-telemetry-dashboard/contracts/receiver-http.md`; the report format is `contracts/report-schema.md`. ### Public listener (`LISTEN_ADDR`) @@ -180,5 +180,5 @@ Untested (main process wiring): `main()` signal handling and server startup erro - **`telemetryschema/specs.md`** — shared report contract, signing and proof-of-work helpers - **`api/internal/telemetry`** — the API's reporter that POSTs to this endpoint - **`charts/gameplane/`** — Helm chart integration (`api.telemetry.receiver.*`) -- **`specs/022-default-telemetry-dashboard/`** — feature spec and contracts +- **`specs/done_022-default-telemetry-dashboard/`** — feature spec and contracts - **`CLAUDE.md`** — project architecture summary diff --git a/telemetryschema/doc.go b/telemetryschema/doc.go index 1aee4814e..777606c39 100644 --- a/telemetryschema/doc.go +++ b/telemetryschema/doc.go @@ -1,4 +1,4 @@ // Package telemetryschema is the shared telemetry report contract used by api // and telemetry-receiver; see -// specs/022-default-telemetry-dashboard/contracts/report-schema.md. +// specs/done_022-default-telemetry-dashboard/contracts/report-schema.md. package telemetryschema diff --git a/telemetryschema/specs.md b/telemetryschema/specs.md index bb76a9eeb..71b0f9e9a 100644 --- a/telemetryschema/specs.md +++ b/telemetryschema/specs.md @@ -45,7 +45,7 @@ telemetryschema/ ## External interface / contracts -The wire contract is [`specs/022-default-telemetry-dashboard/contracts/report-schema.md`](../specs/022-default-telemetry-dashboard/contracts/report-schema.md); the rules below are what this package enforces. +The wire contract is [`specs/done_022-default-telemetry-dashboard/contracts/report-schema.md`](../specs/done_022-default-telemetry-dashboard/contracts/report-schema.md); the rules below are what this package enforces. ### Types @@ -113,7 +113,7 @@ JSON tags are the camelCase names in the contract (`installId`, `wakeOnConnect`, ### Proof-of-work -The wire contract is research R21 and [`contracts/receiver-http.md`](../specs/022-default-telemetry-dashboard/contracts/receiver-http.md). When a receiver requires proof-of-work, every report carries `Gameplane-Telemetry-PoW: :`. +The wire contract is research R21 and [`contracts/receiver-http.md`](../specs/done_022-default-telemetry-dashboard/contracts/receiver-http.md). When a receiver requires proof-of-work, every report carries `Gameplane-Telemetry-PoW: :`. | Name | Behavior | |---|---|