Browse Source

G-065 Notes: bootsupport tcllib-subset survey + tclpackages.toml sketch status (assessment 2026-07-31)

Records the user-directed findings: tclpackages.toml is an unread
2026-06-23 format outline (checkout-level paper record per G-087's
archived note), the hand-placed tcllib subset exists as vendormodules
.tm pulls (copy-provenance only) plus the mechanism-less pkgIndex-form
bootsupport/lib tree, and the candidate resolution is per-module
declared trims under this goal's manifest with G-066 as the
pkgIndex->tm adoption tool and G-026 as pull enforcement. The sketch's
[libs] binary entries are recorded as a pre-zig-era mis-step (G-004
scope; G-102/G-123/G-139 are the live binary routes); the empty
lib_tcl<N>/<arch> scaffolds are untracked local dirs only.

Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com
master
Julian Noble 1 day ago
parent
commit
bfe6bf7c56
  1. 31
      goals/G-065-declarative-vendoring.md

31
goals/G-065-declarative-vendoring.md

@ -77,3 +77,34 @@ remains the punkshell format (G-024 direction).
replace/supersedes). Per its drafting note, this goal should absorb or
reference that pattern rather than duplicate it - see
goals/archive/G-139-punkbin-library-consumption.md.
- Bootsupport tcllib-subset survey (assessment 2026-07-31, user-directed;
candidate adoption case for this goal): the deliberately-partial tcllib
content punkshell boot machinery relies on exists in TWO forms, neither
with upstream provenance. (a) tcllib-origin .tm modules (cksum, cmdline,
md5, sha1, struct, textutil, uuid, ...) ride src/vendormodules ->
src/bootsupport/modules via the include_modules.config pull (punkcheck
records the COPY only). (b) the pkgIndex-form src/bootsupport/lib tree
(base64, control, debug, fileutil, snit, struct, tar, term, vfszip,
virtchannel_*; ~119 files) has NO pull mechanism at all -
src/bootsupport/tclpackages.toml (2026-06-23 "initial outline of format",
no reader anywhere in the tree; described by the archived G-087 notes as
checkout-level governance only) SKETCHES governing it, and the
vendormodules config's own header records the toml-conversion desire
("#todo - change to include_modules.toml ... programatically editable
whilst retaining comments"). Candidate resolution when this goal
activates: declare the subset as per-module trims of the tcllib upstream
in this goal's manifest (keeping the subset posture - the whole-package
artifact tier serves the lib_tcl<N>/kit consumers, G-139/G-141 lane);
G-066's pkgIndex->tm conversion with embedded metadata is the natural
tool for adopting form (b) into the modules pull; G-026 keeps the
pull-hygiene enforcement. Also recorded: tclpackages.toml's
[libs.<gen>.<arch>] BINARY entries (thread dll trees, tcllib incl.
binary parts; source lines now stale post-G-139 removal - inert, no
reader) are a pre-zig-era mis-step per the user - binaries arrive via
the bin/runtime + bin/packages consent-gated fetch tiers or zig builds
(G-004 names src/bootsupport in its no-committed-binaries scope;
G-102/G-123/G-139 are the live routes); the empty
src/bootsupport/lib_tcl<N>/<arch> + bin scaffolds are UNTRACKED local
dirs only (git tracks no files there; the project-0.1 layout ships
bootsupport without them), so retiring the sketch's [libs] platform
sections retires the committed footprint.

Loading…
Cancel
Save