From bfe6bf7c56fd0adbe221d0519e7deafd784b77b5 Mon Sep 17 00:00:00 2001
From: Julian Noble <julian@precisium.com.au>
Date: Fri, 31 Jul 2026 16:17:08 +1000
Subject: [PATCH] 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
---
 goals/G-065-declarative-vendoring.md | 31 ++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/goals/G-065-declarative-vendoring.md b/goals/G-065-declarative-vendoring.md
index 4226eb34..3d475736 100644
--- a/goals/G-065-declarative-vendoring.md
+++ b/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.