Browse Source

Goals: activate G-155 (user-directed) - leans adopted, G-029 retitled (pre-approved)

Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com
master
Julian Noble 1 week ago
parent
commit
a30d400e51
  1. 4
      GOALS.md
  2. 2
      goals/G-029-testmodules-from-srctests.md
  3. 32
      goals/G-155-mint-stage-vocabulary.md

4
GOALS.md

@ -169,7 +169,7 @@ Detail: goals/G-027-derived-project-pull-updates.md
Scope: src/modules/punkboot/utils-999999.0a1.0.tm (locker-report helper); src/make.tcl (kit deploy failure reporting)
Detail: goals/G-028-file-locker-identification.md
### G-029 [proposed] Build packaged test::<modulename> #modpod modules from src/tests
### G-029 [proposed] Mint packaged test::<modulename> #modpod modules from src/tests
Scope: src/make.tcl (test-module packaging step); src/tests/ (source of truth); src/modules/test/ (generated #modpod targets); src/modules/punk/mix/ (modpod tooling as needed)
Detail: goals/G-029-testmodules-from-srctests.md
@ -406,7 +406,7 @@ Detail: goals/G-150-cmdhelp-form-narrowing.md
Scope: src/modules/punk/args-999999.0a1.0.tm (parse-result presentation); src/tests/modules/punk/args/testsuites/args/
Detail: goals/G-151-punkargs-annotated-success-render.md
### G-155 [proposed] Stage-true vocabulary part 2: mint stage named, build reserved for compiling, _mint/_bake workdirs
### G-155 [active] Stage-true vocabulary part 2: mint stage named, build reserved for compiling, _mint/_bake workdirs
Scope: src/make.tcl (SUMMARIES/HELPTEXTS/SUBGROUPS, workflow_text + new TERMINOLOGY block, BUILD-WARNING -> BAKE-WARNING, bakelist vocabulary, workdir paths); src/modules/punk/mix/base-999999.0a1.0.tm + src/modules/punk/mix/cli-999999.0a1.0.tm (workdir paths, antidir/antipattern/reserved lists, legacy vfs-cksums trio disposition); src/vfs/_config/punk_main.tcl + src/vfs/_config/project_main.tcl (dev-mode src/_build path logic); .gitignore + .fossil-settings/ignore-glob (_build glob split per dual-VCS derivation); src/project_layouts (make.tcl copies, gitignore.in + ignore-glob payloads, via established sync channels); src/tests/shell/testsuites/punkexe/ + src/tests/modules/punkboot/ + src/tests/modules/punkcheck/ (pinned tokens: BUILD-WARNING, nobuild, _build paths); AGENTS.md + src/AGENTS.md + src/modules/AGENTS.md + src/vfs/AGENTS.md + src/runtime/AGENTS.md + bin/AGENTS.md + README.md + src/README.md + ARCHITECTURE.md (prose sweep); GOALS.md G-029 entry title (coordinated proposal-first edit)
Detail: goals/G-155-mint-stage-vocabulary.md

2
goals/G-029-testmodules-from-srctests.md

@ -1,4 +1,4 @@
# G-029 Build packaged test::<modulename> #modpod modules from src/tests
# G-029 Mint packaged test::<modulename> #modpod modules from src/tests
Status: proposed
Scope: src/make.tcl (test-module packaging step); src/tests/ (source of truth); src/modules/test/ (generated #modpod targets); src/modules/punk/mix/ (modpod tooling as needed)

32
goals/G-155-mint-stage-vocabulary.md

@ -1,6 +1,6 @@
# G-155 stage-true vocabulary part 2: mint stage named, build reserved for compiling, _mint/_bake workdirs
Status: proposed
Status: active
Scope: src/make.tcl (SUMMARIES/HELPTEXTS/SUBGROUPS, workflow_text + new TERMINOLOGY block, BUILD-WARNING -> BAKE-WARNING, bakelist vocabulary, workdir paths); src/modules/punk/mix/base-999999.0a1.0.tm + src/modules/punk/mix/cli-999999.0a1.0.tm (workdir paths, antidir/antipattern/reserved lists, legacy vfs-cksums trio disposition); src/vfs/_config/punk_main.tcl + src/vfs/_config/project_main.tcl (dev-mode src/_build path logic); .gitignore + .fossil-settings/ignore-glob (_build glob split per dual-VCS derivation); src/project_layouts (make.tcl copies, gitignore.in + ignore-glob payloads, via established sync channels); src/tests/shell/testsuites/punkexe/ + src/tests/modules/punkboot/ + src/tests/modules/punkcheck/ (pinned tokens: BUILD-WARNING, nobuild, _build paths); AGENTS.md + src/AGENTS.md + src/modules/AGENTS.md + src/vfs/AGENTS.md + src/runtime/AGENTS.md + bin/AGENTS.md + README.md + src/README.md + ARCHITECTURE.md (prose sweep); GOALS.md G-029 entry title (coordinated proposal-first edit)
Goal: The pipeline vocabulary is stage-true end to end: 'build' means compiling source to binary and lives only in the arm's-length factories (buildsuite, tool), the src -> projectroot packaging stage is named 'mint' (stamp real versions, pack modpods, prune superseded, install) with packages/modules/libs keeping their G-112 subcommand names, bake-domain prose and tags stop borrowing 'build' (BAKE-WARNING, bake product, rebake), the workdirs teach the same words (src/_bake for kit assembly, per-srcdir _mint for module staging, src/buildsuites/_build unchanged), and ::punkboot::workflow_text carries a TERMINOLOGY block defining the stage verbs so the vocabulary travels into layout copies and generated projects.
Acceptance: (1) 'make.tcl help' and 'make.tcl workflow' describe modules/libs/packages with mint vocabulary and no module-stage or bake-domain verb-'build', the persona header reads "one mint stage, two promotion gates, one bake", and the TERMINOLOGY block renders in workflow output; (2) every recap-warning emit site prints BAKE-WARNING (PROVENANCE-WARNING untouched) and BUILD-WARNING survives only in historical records (CHANGELOG, GOALS-archive.md, goals/archive/); (3) on a clean checkout 'make.tcl bakehouse -confirm 0' completes with kit products in src/_bake and module staging under per-srcdir _mint folders, kits byte-comparable to same-tree pre-rename products (allowing only known-nondeterministic zip metadata), src/buildsuites/_build untouched and no new _build content created outside src/buildsuites; (4) bakelist's deployed-state vocabulary agrees with the rename (nobuild -> nobake or a recorded keep-decision) and the punk::mix vfs-cksums trio (store_vfs_build_cksums calls the undefined get_vfs_build_cksums) is repaired or retired; (5) ignore rules updated in both VCS per the derivation rules, layout make.tcl + ignore payloads synced, templates modpod repacked, docs in Scope swept, pinned testsuites updated and passing against kits baked under the new vocabulary, and the project version bumped with a CHANGELOG entry.
@ -86,20 +86,22 @@ identity stays.
## Open decisions
To resolve at activation (G-112 pattern):
- bakelist deployed-state token: nobuild -> nobake (recommended - bakelist is young (G-121, achieved -
see goals/archive/G-121-bakelist-selective-bake.md) and its consumers are in-repo tests) vs keep with
a recorded reason. Column-stable output contract either way.
- get_build_workdir -> get_bake_workdir proc rename: the folder rename works without it; renaming is an
API change that rides the bootsupport dance. Recommended: rename in the same pass (callers are
make.tcl + punk::mix only - verify at activation).
- BUILDCOPY punkcheck event + runtime_buildcopyname: recommended keep (recorded punkcheck vocabulary);
BAKECOPY only with a future punkcheck format change.
- G-029 retitle exact wording ("Mint packaged test::<modulename> #modpod modules from src/tests") -
proposal-first at that goal's entry.
- Whether README/ARCHITECTURE get a terminology pointer line or the block stays workflow_text-only
(recommended: workflow_text canonical + one-line pointers).
RESOLVED at activation 2026-08-02 (user-directed: recorded leans adopted, G-029 rewording
pre-approved):
- bakelist deployed-state token: RENAME nobuild -> nobake (bakelist is young (G-121, achieved - see
goals/archive/G-121-bakelist-selective-bake.md) and its consumers are in-repo tests). Column-stable
output contract preserved under the new token.
- get_build_workdir: RENAME to get_bake_workdir in the same pass (API change rides the bootsupport
dance; callers verified at activation: make.tcl + punk::mix internals only).
- BUILDCOPY punkcheck event + runtime_buildcopyname: KEEP (recorded punkcheck vocabulary); BAKECOPY
only with a future punkcheck format change.
- G-029 retitle: PRE-APPROVED wording applied at activation ("Mint packaged test::<modulename>
#modpod modules from src/tests") - title in both tiers; its Goal/Acceptance lines otherwise
untouched (contract), body prose rides the sweep.
- TERMINOLOGY placement: workflow_text canonical + one-line pointers in README/ARCHITECTURE.
- Environment note at activation: only punk901t.exe running (user-confirmed; expected outside the
configured bake set - verified against bakelist before the deploy phase).
## Notes

Loading…
Cancel
Save