From c5b4b35a2ef71e9962bb448dbb15fd18f294e219 Mon Sep 17 00:00:00 2001 From: tegwick Date: Wed, 28 Oct 2026 00:31:07 +0100 Subject: [PATCH] Adopt staged WORK-RECORDS generation and catch the index up. The generated index had drifted from the workplan files. The opt-in lets the pre-commit hook rebuild WORK-RECORDS.md in the same commit as the workplan it indexes. Assistant: grok Assistant-Session: 01a17f9d-fe9d-7d72-9a22-6304f1a2a790 --- .generated-work-records.json | 1 + .generated-work-records.mk | 8 ++++++++ SCOPE.md | 13 +++++++++++++ WORK-RECORDS.md | 8 ++++---- 4 files changed, 26 insertions(+), 4 deletions(-) create mode 100644 .generated-work-records.json create mode 100644 .generated-work-records.mk diff --git a/.generated-work-records.json b/.generated-work-records.json new file mode 100644 index 0000000..e16a813 --- /dev/null +++ b/.generated-work-records.json @@ -0,0 +1 @@ +{"version":1,"repo_slug":"pqrst-practice"} diff --git a/.generated-work-records.mk b/.generated-work-records.mk new file mode 100644 index 0000000..7fb16a4 --- /dev/null +++ b/.generated-work-records.mk @@ -0,0 +1,8 @@ +# Explicit opt-in recipe; no environment files or external make includes. +CUSTODIAN_SOURCE ?= /home/worsch/the-custodian +GENERATED_REPO_SLUG ?= pqrst-practice +.PHONY: generated-work-records generated-work-records-check +generated-work-records: + python3 "$(CUSTODIAN_SOURCE)/scripts/generate_staged_work_records.py" --repo . --repo-slug "$(GENERATED_REPO_SLUG)" +generated-work-records-check: + python3 "$(CUSTODIAN_SOURCE)/scripts/generate_staged_work_records.py" --repo . --repo-slug "$(GENERATED_REPO_SLUG)" --check diff --git a/SCOPE.md b/SCOPE.md index 458c581..4ff9be2 100644 --- a/SCOPE.md +++ b/SCOPE.md @@ -125,3 +125,16 @@ ambitious and structured than a task"), with workplan prefix `PQRST-WP`. - Changes that alter the meaning of a dimension, the validation rules, or the stored record format are **breaking**: they make older records less comparable, and must say so explicitly. - Editorial changes — clarification, examples, wording — do not require a version bump. - Source drafts in `history/` are never edited, only added to. + +## Generated work-record index + +This repository opts into staged-source WORK-RECORDS.md generation through +`.generated-work-records.json` and the isolated `.generated-work-records.mk` +recipe. `make generated-work-records` reuses the State Hub renderer through +the Custodian adapter; `make generated-work-records-check` verifies byte-exact +agreement with staged Markdown. The pre-commit hook uses the isolated recipe, +preserves unstaged index edits by refusing them, and retains the generated-only +commit guard. It does not contact the hub, alter workplan statuses, or grant +deployment authority. This consumes shared tooling; it does not make this +repository the provider of the generator capability. + diff --git a/WORK-RECORDS.md b/WORK-RECORDS.md index d67f109..dd612af 100644 --- a/WORK-RECORDS.md +++ b/WORK-RECORDS.md @@ -9,12 +9,12 @@ | Kind | ID | Status | Lane | Source | | --- | --- | --- | --- | --- | | workplan | PQRST-WP-0001 | finished | — | workplans/PQRST-WP-0001-statehub-bootstrap.md | -| workplan | PQRST-WP-0002 | proposed | — | workplans/PQRST-WP-0002-validate-v01-against-real-sessions.md | +| workplan | PQRST-WP-0002 | finished | — | workplans/PQRST-WP-0002-validate-v01-against-real-sessions.md | | task | PQRST-WP-0001-T01 | done | — | workplans/PQRST-WP-0001-statehub-bootstrap.md | | task | PQRST-WP-0001-T02 | done | — | workplans/PQRST-WP-0001-statehub-bootstrap.md | | task | PQRST-WP-0001-T03 | done | — | workplans/PQRST-WP-0001-statehub-bootstrap.md | -| task | PQRST-WP-0002-T01 | todo | — | workplans/PQRST-WP-0002-validate-v01-against-real-sessions.md | -| task | PQRST-WP-0002-T02 | todo | — | workplans/PQRST-WP-0002-validate-v01-against-real-sessions.md | -| task | PQRST-WP-0002-T03 | todo | — | workplans/PQRST-WP-0002-validate-v01-against-real-sessions.md | +| task | PQRST-WP-0002-T01 | done | — | workplans/PQRST-WP-0002-validate-v01-against-real-sessions.md | +| task | PQRST-WP-0002-T02 | done | — | workplans/PQRST-WP-0002-validate-v01-against-real-sessions.md | +| task | PQRST-WP-0002-T03 | done | — | workplans/PQRST-WP-0002-validate-v01-against-real-sessions.md | | task | PQRST-WP-0002-T04 | done | — | workplans/PQRST-WP-0002-validate-v01-against-real-sessions.md | | task | PQRST-WP-0002-T05 | done | — | workplans/PQRST-WP-0002-validate-v01-against-real-sessions.md |