Julian Noble 663f1cba91 G-097 achieved: layout channel folded in (user-approved); flip + archive Layout fold ("fold stale layout fixes into this"): both layout stores (src/project_layouts/vendor/punk/project-0.1/bin and the modpod-templates equivalent) had shipped a stale 2025-era runtime.cmd and a pre-G-096 getzig.cmd - the getzig rename had missed this channel entirely, so generated projects still received old-named, stale utilities. Both renamed via git mv AND refreshed to byte-copies of the current bin/punk-runtime.cmd + bin/punk-getzig.cmd; the layout src/runtime/Readme.md references updated in both stores (the layout bin/runtime/ data-dir READMEs are gitignored - updated on disk only, like the root bin/runtime/README.md); residual old-name scan of the layout trees clean. The built modpod zips (root modules/ + bootsupport templates-0.2.0.tm) carry old names until their normal re-vendor cycles. Layout paths join the goal Scope per the approved fold. Flip mechanics: detail file to goals/archive with Status achieved 2026-07-21 (verification in its Progress section: full rename sweep, pins retargeted and passing 26/25/1/0, drift findings recorded), GOALS.md entry removed, GOALS-archive record appended (amended Scope + Acceptance verbatim), reference sweep: G-103 scope parenthetical (both tiers) + Relationships and the G-099/G-103 sequencing notes annotated with the achievement; G-096's archive gains a note recording the layout-channel gap and its closure. goals_lint clean (75 active-index goals, 31 archived). Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com		1 week ago
..
bin	…
bootsupport	make.tcl bootsupport re-vendor: punk::lib 0.5.1 (fixed compat lpop for the runner's toplevel boot); project 0.17.4	1 week ago
buildsuites	G-102 follow-up: drop echo banner steps - scrubbed-env transitive failure	1 week ago
decktemplates	G-087 stages 4+5: overlay merge primitive, marker/matrix retirement, version seeding	2 weeks ago
defaultconfigs	…
doc	…
embedded	…
lib	punk::path 0.3.0: extensionless tcl scripts via lib: (first-line identification)	2 weeks ago
lib_tcl8	…
lib_tcl9	…
modules	G-097 achieved: layout channel folded in (user-approved); flip + archive	1 week ago
modules_tcl8	refactor AGENTS.md files	1 month ago
modules_tcl9	refactor AGENTS.md files	1 month ago
project_layouts	G-097 achieved: layout channel folded in (user-approved); flip + archive	1 week ago
runtime	mapvfs.config: restore punk86 kit mapping on the 8.6.17 dyn tclkit	1 week ago
scriptapps	G-097: bin utility naming sweep - punk-bits, punk-runtime, punk-tclargs, selfsign	1 week ago
testansi	…
testdata	…
tests	runtests: version-floor the runner's requires (fossilized-kit rejection); concurrency child floor	1 week ago
text	…
vendorlib	tablelist 6.22 -> 7.11: vendor as pkgIndex lib instead of tm modules	2 weeks ago
vendorlib_tcl8	executable stdin handline, + various	1 month ago
vendorlib_tcl9	vendored tcludp 1.0.12 -> 1.0.13 in tcl9 kit vfs folders - G-036 wedge remedy - 0.4.3	3 weeks ago
vendormodules	vendormodules: fauxlink 0.2.0 - link_as encoder implemented upstream	2 weeks ago
vendormodules_tcl8	…
vendormodules_tcl9	…
vfs	make.tcl vfscommonupdate outputs: punkcheck 0.6.0, punk::lib 0.5.1, cli 0.5.1 into _vfscommon; project 0.17.5	1 week ago
AGENTS.md	G-087 stage 3: thin layouts + generation-time bootsupport injection (sources)	2 weeks ago
README.md	G-097: bin utility naming sweep - punk-bits, punk-runtime, punk-tclargs, selfsign	1 week ago
Tcl9icon.six	…
Tcl9icon.svg	…
build.cmd	…
build.ps1	…
build.tcl	…
error_overtype.txt	…
make.tcl	G-087 stages 4+5: overlay merge primitive, marker/matrix retirement, version seeding	2 weeks 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)

Build Instructions

Use tclsh|<punkruntime> make.tcl <commandname> to build .tm modules and rebuild the punk executable 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       ;# build/install the unversioned libs / modules to <projectroot>
 # 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 project

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