diff --git a/GOALS.md b/GOALS.md index b168b63a..bf4a4915 100644 --- a/GOALS.md +++ b/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:: #modpod modules from src/tests +### G-029 [proposed] Mint packaged test:: #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 diff --git a/goals/G-029-testmodules-from-srctests.md b/goals/G-029-testmodules-from-srctests.md index 2a039d37..a95be679 100644 --- a/goals/G-029-testmodules-from-srctests.md +++ b/goals/G-029-testmodules-from-srctests.md @@ -1,4 +1,4 @@ -# G-029 Build packaged test:: #modpod modules from src/tests +# G-029 Mint packaged test:: #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) diff --git a/goals/G-155-mint-stage-vocabulary.md b/goals/G-155-mint-stage-vocabulary.md index a09619cc..569ea7ae 100644 --- a/goals/G-155-mint-stage-vocabulary.md +++ b/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:: #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:: + #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