Julian Noble 2dbf635b99 Project-version bake gate - bump-before-bake machine-enforced (punkshell 0.56.1) The project version is a bake input (kit stamp punkkit-stamp.toml project_version + versioned-scheme output names), but nothing enforced the step (2) bump -> step (8) bake order; a 2026-08-06 session baked at 0.55.1, bumped to 0.56.0 and paid a full 11-kit re-bake. Every other release-sequence edge already had a mechanical gate (provenance, bootsupport staleness, boot precondition) - this was the un-gated one. - ::punkboot::get_projectversion_status: shared staleness/consistency computation (projectversion advisory, check report, gate); states ok/overdue/bump_uncommitted/unavailable. - project-version gate on bake/bakehouse/bin: a pending-looking bump (src/ commits since punkproject.toml last changed, none staged) prompts y/N on a terminal and aborts fast non-interactively unless -expect-projectversion asserts the intended version. -confirm 0 deliberately does not waive the gate. A staged-but-uncommitted bump passes (bake reads the working-tree value); degraded bootsupport reduces the gate to a NOTE. - -expect-projectversion <ver> (bake/bakehouse/bin argdocs + degraded scan): assertion verified in every state - a mismatch with punkproject.toml always aborts before any kit work; unavailable status aborts a supplied assertion as unverifiable rather than silently losing the requested strictness. - projectversion overdue warning now states the consequence and prints the ready-made assertion command; check reports the gate state and current staleness verdict; workflow text ([K2] bake-input + gate, [K6] no-waiver exception, steps (2)/(8)) and gethelp/HELPTEXTS/OPT_CONFIRM document it; root AGENTS.md gains "The version is a bake input (bump BEFORE bake)" + an Enforcement gate paragraph; src/AGENTS.md closeout bullet extended. - maketclprojectversion.test: piped characterization (8 tests) - check report, advisory read-only, and git-fixture verdicts for pending-abort, assert-match proceed, assert-mismatch abort, bump-staged proceed, no-git NOTE. maketclhelp.test bakehouse-synopsis pin updated for the new flag. - Thin-layout + templates-modpod make.tcl copies synced via make.tcl modules. Claude-Session: https://claude.ai/code/session_01EukjNTv2r5msFgHzWgaCdS Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com		4 days ago
..
assets/logo	G-057 achieved: flip, archive record, reference sweep, owning-doc pointers	2 weeks ago
bin	…
bootsupport	G-169/G-170 follow-on landed: coherent-set promotion + bake - launcher help depth reaches the kits (punkshell 0.56.0)	4 days ago
buildsuites	G-165 runtime-side follow-on landed: retire mkimg from the buildsuite wrap lane	5 days ago
decktemplates	G-087 stages 4+5: overlay merge primitive, marker/matrix retirement, version seeding	3 weeks ago
defaultconfigs	…
doc	…
embedded	…
lib	G-170 achieved: launcher help depth - form narrowing, parse-true dry-run, actionable form hints (core 0.7.0, punkexe moduledoc 0.9.0, app-punkscript 1.3)	4 days ago
lib_tcl8	…
lib_tcl9	…
modules	Project-version bake gate - bump-before-bake machine-enforced (punkshell 0.56.1)	4 days ago
modules_tcl8	…
modules_tcl9	…
project_layouts	Project-version bake gate - bump-before-bake machine-enforced (punkshell 0.56.1)	4 days ago
runtime	G-165 achieved 2026-08-04: driver-invariant kit assembly (single zip writer path, punkzip acceleration, file-relative opt-in) (punkshell 0.52.0)	5 days ago
scriptapps	retire src/scriptapps/punk.tcl (stale pre-G-155 _build dev-launch shim)	7 days ago
testansi	…
testdata	…
tests	Project-version bake gate - bump-before-bake machine-enforced (punkshell 0.56.1)	4 days ago
text	…
tools	G-165 achieved 2026-08-04: driver-invariant kit assembly (single zip writer path, punkzip acceleration, file-relative opt-in) (punkshell 0.52.0)	5 days ago
vendorlib	kettle tilde fix: punk::mix::cli 0.6.1 + vendored kettle app.tcl local patch (tcl9)	1 week ago
vendorlib_tcl8	G-139 retirement: vendored tcllib trees removed (artifact path proven)	1 week ago
vendorlib_tcl9	G-139 retirement: vendored tcllib trees removed (artifact path proven)	1 week ago
vendormodules	G-111: modpod 0.1.6 tidy + first test baseline (0.47.2)	1 week ago
vendormodules_tcl8	cookfs1.9.0: relocate misplaced pkgIndex library to vendorlib_tcl8/win32-x86_64	3 weeks ago
vendormodules_tcl9	…
vfs	G-169/G-170 follow-on landed: coherent-set promotion + bake - launcher help depth reaches the kits (punkshell 0.56.0)	4 days ago
AGENTS.md	Project-version bake gate - bump-before-bake machine-enforced (punkshell 0.56.1)	4 days ago
README.md	G-155 increment A: stage vocabulary landed - mint/promote/bake strict, BAKE-WARNING, _mint/_bake workdirs (payload-frozen)	1 week ago
Tcl9icon.six	…
Tcl9icon.svg	…
build.cmd	…
build.ps1	…
build.tcl	…
error_overtype.txt	…
make.tcl	Project-version bake gate - bump-before-bake machine-enforced (punkshell 0.56.1)	4 days ago
test.txt	…

README.md

punk shell

Runtimes

#run from project root:  
./bin/punk-runtime.cmd list -remote
# This is a cross-platform polyglot wrapper that should run from bash, or with tclsh or in windows directly in powershell/cmd.exe
./bin/punk-runtime.cmd fetch

#if no retrievable runtime for your platform, you'll need a vfs capable tclkit or a zipfs capable tclsh with an attached vfs

#todo: exact notes on creating suitable runtimes (plain tclsh will likely be missing zipfs vfs to mount)

Make Instructions (mint / promote / bake)

Use tclsh|<punkruntime> make.tcl <commandname> to mint .tm modules and rebake the punk executables In normal use it should be called from the project root. e.g

 tclsh src/make.tcl vendorupdate   ;# if needed

 tclsh src/make.tcl packages       ;# mint the libs / modules from src to <projectroot> (version-stamped)
 # or separately:
 # tclsh src/make.tcl modules      ;# src/modules -> /modules (etc)
 # tclsh src/make.tcl libs         ;# src/lib     -> /lib (etc)

 tclsh src/make.tcl vfscommonupdate ;copy the  libs/modules that are now in <projectroot>/modules to vfs system for inclusion in the binary.

 # If make.tcl dependencies are modified:
 # tclsh src/make.tcl bootsupport  ;# src/modules -> src/bootsupport/modules,  src/lib -> src/bootsupport/lib (etc)

 tclsh src/make.tcl bake            ;# assemble kit/zipkit executables from the promoted vfs payload + runtimes
 # (consumer path from a CLEAN checkout: 'tclsh src/make.tcl bakehouse' = packages + bake in one run;
 #  'make.tcl workflow' prints the full data-flow overview.)

A common interactive test scenario (after running src/tests/runtests.tcl to test the unversioned source)
is to run 'tclsh src/make.tcl modules'
Then '<punkexecutable> dev'
This will source modules/libs from <projectroot>/modules and <projectroot>/lib intead of from the executable's vfs.

Then Use tclsh|punk build.tcl to run the 'kettle' system to build doc files,
or - use the pmix KettleShell command from within the punk shell to perform kettle operations. Confirm with user or ask user to manually run.

(The name 'build.tcl' is the standard name used by the Kettle system - it is not for building the punk project.)