punkshell

Julian Noble 47c9f99eff G-057 achieved: flip, archive record, reference sweep, owning-doc pointers Acceptance verified in full on 2026-07-29 (evidence in the detail file's Progress section): windows-host bakes embed the default punkshell.ico into all 10 buildable win32 kits across zip (x64 + ix86), sdx-metakit and stamped-concat assembly, verified by twapi resource inspection byte-matching the source ico; override round-trip proven and reverted; boots for zip, metakit and concat images from scratch copies; linux cross-target kit gets its sidecar with NOT APPLICABLE; the two incapable-host conditions produce their distinct notices in REAL bakes (mingw tclsh86: twapi not loadable; WSL linux cross-bake: cross-host with the G-128 remedy named - and the cross-baked kit boots on windows, the recorded known shortcoming live); idempotence converges; runtime store originals untouched; vendored-twapi no-toolchain arm proven under tclsh9.0.5-punk. Index entry moves to GOALS-archive.md (ID position); the detail-file move to goals/archive/ follows as its own pure-rename commit. Reference sweep: G-023, G-028, G-127 and G-128 notes gain achieved/archive markers plus what each consumes from the delivered mechanism (G-128: the seam now exists - kit_icon_process entry point, sidecar record, cross-host notice naming it as remedy; G-028: the stub-first ordering concentrates the locked-target exposure at deploy, punk9_beta observed). AGENTS.md owning-doc pointers land alongside: src/vfs (override convention), src/runtime (default-icon role + derivation sidecar), src/assets/logo (propagation honesty: G-057 consumes the src/runtime copy - syncing the four build-consumed copies after artwork changes stays deliberate, with assetorigin stale-detection as the drift signal), and an ARCHITECTURE.md build-section bullet (architecture_lint clean). Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com		2 days ago
..
AGENTS.md	G-057 achieved: flip, archive record, reference sweep, owning-doc pointers	2 days ago
Readme.md	…
mapvfs.config	G-133: bake payload/target consistency checks - advisory arch scan + smoke-require probe	4 days ago
punkshell.ico	Project icon: punk1.ico -> punkshell.ico, artwork from the src/assets/logo master	3 days ago
punkshell.ico.assetorigin.toml	G-135: platform-neutral icon generator + per-asset assetorigin sidecars	2 days ago
tclkit.ico	…
vendorlib_vfs.toml	contextual sweep: deprecated make.tcl subcommand references (user-directed, incl. contract lines)	6 days ago

Readme.md

Use mapvfs.config to configure building of a kit (metakit or zipfs) executable from customized .vfs folders within src/vfs

A runtime must be installed in the appropriate bin/runtime/ folder to build the executable. These can be installed by running: bin/runtime.cmd fetch or alternatively by downloading from an artifact source such as : https://www.gitea1.intx.com.au/jn/punkbin

Appropriate runtimes should be self-contained Tcl executables that are either metakit or zipfs aware, and have an attached vfs with 'info library' support files.

A plain tclsh, even if it has zipfs support, is unlikely to work unless it has the tcl_library folder (with init.tcl and others) and possibly some other required modules such as msgcat placed within the .vfs folder being used to build the executable.

A plain tclsh may commonly depend on shared libraries elsewhere on the system, and so the resulting executable may not be as portable.