coulomb/pqrst-practice
5
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Adopt staged WORK-RECORDS generation and catch the index up.

Browse source 
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
This commit is contained in:
tegwick 2026-10-28 00:31:07 +01:00
parent 25d2ce38c4
commit c5b4b35a2e
4 changed files with 26 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

1
.generated-work-records.json Normal file
View file

@ -0,0 +1 @@
{"version":1,"repo_slug":"pqrst-practice"}

8
.generated-work-records.mk Normal file
View file

@ -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

13
SCOPE.md
View file

@ -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.

8
WORK-RECORDS.md
View file

@ -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 |