From 711f5a1ade003acd338d3b9b17dc24bfd0b7c768 Mon Sep 17 00:00:00 2001 From: Julian Noble Date: Sat, 1 Aug 2026 02:14:59 +1000 Subject: [PATCH] G-141 Scope rewording (user-approved): stale "format coordinated with G-127" clause updated to the achieved surface Index + detail-file mirror in step: the src/vfs/*.vfs.toml entry now reads "the achieved G-115 surface carrying the achieved G-127 platform axis" - same treatment the clause received when G-115 flipped (852d684a precedent). Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com --- GOALS.md | 2 +- goals/G-141-libfetch-target-selection.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/GOALS.md b/GOALS.md index bb7ae040..cf48bd72 100644 --- a/GOALS.md +++ b/GOALS.md @@ -391,7 +391,7 @@ Scope: src/tools/punkres/ (VS_VERSIONINFO construction, set-version + field-leve Detail: goals/G-137-kit-version-resources.md ### G-141 [proposed] libfetch consumption-derived target selection with explicit overrides -Scope: src/make.tcl (libfetch target-set derivation + narrow/widen options; VFSLIBS missing-source hint; PACKAGES phase as the host-need input); src/runtime/libpackages.toml (declaration surface as consumed); src/vfs/*.vfs.toml (source_root="packages" entries as the kit-consumption input - the achieved G-115 successor surface; format coordinated with G-127); src/tests/shell/testsuites/punkexe/maketcllibfetch.test (characterization: derivation, narrowing, widening); bin/AGENTS.md + src/runtime/AGENTS.md (derivation rule documentation) +Scope: src/make.tcl (libfetch target-set derivation + narrow/widen options; VFSLIBS missing-source hint; PACKAGES phase as the host-need input); src/runtime/libpackages.toml (declaration surface as consumed); src/vfs/*.vfs.toml (source_root="packages" entries as the kit-consumption input - the achieved G-115 surface carrying the achieved G-127 platform axis); src/tests/shell/testsuites/punkexe/maketcllibfetch.test (characterization: derivation, narrowing, widening); bin/AGENTS.md + src/runtime/AGENTS.md (derivation rule documentation) Detail: goals/G-141-libfetch-target-selection.md ### G-142 [proposed] Punkbin curated listing manifests: per-tier artifact grouping with named groups diff --git a/goals/G-141-libfetch-target-selection.md b/goals/G-141-libfetch-target-selection.md index e7b3372f..31784bb2 100644 --- a/goals/G-141-libfetch-target-selection.md +++ b/goals/G-141-libfetch-target-selection.md @@ -1,7 +1,7 @@ # G-141 libfetch consumption-derived target selection Status: proposed -Scope: src/make.tcl (libfetch target-set derivation + narrow/widen options; VFSLIBS missing-source hint; PACKAGES phase as the host-need input); src/runtime/libpackages.toml (declaration surface as consumed); src/vfs/*.vfs.toml (source_root="packages" entries as the kit-consumption input - the achieved G-115 successor surface; format coordinated with G-127); src/tests/shell/testsuites/punkexe/maketcllibfetch.test (characterization: derivation, narrowing, widening); bin/AGENTS.md + src/runtime/AGENTS.md (derivation rule documentation) +Scope: src/make.tcl (libfetch target-set derivation + narrow/widen options; VFSLIBS missing-source hint; PACKAGES phase as the host-need input); src/runtime/libpackages.toml (declaration surface as consumed); src/vfs/*.vfs.toml (source_root="packages" entries as the kit-consumption input - the achieved G-115 surface carrying the achieved G-127 platform axis); src/tests/shell/testsuites/punkexe/maketcllibfetch.test (characterization: derivation, narrowing, widening); bin/AGENTS.md + src/runtime/AGENTS.md (derivation rule documentation) Goal: 'make.tcl libfetch' fetches what the checkout will consume rather than everything declared - the default target set is derived from the consumption declarations already in the tree (the host's lib_tcl deploy needs plus the lib-tier targets consumed by the kit set in play), with explicit options to narrow (a selective bake's kit set) and widen (the full declared set) - so libpackages.toml can grow across platforms, architectures and libraries without every host downloading every artifact. Acceptance: a linux host preparing the linux kit set obtains exactly its consumed set - allplatforms + linux-x86_64 fetched, win32-x86_64 NOT fetched, observable in the libfetch action report - via the default derivation or a single derived invocation libfetch/the bake names; the canonical win32 host's default stays bake-sufficient (linux-x86_64 derived for the punk9linux.vfs cross-target need; a default fetch then a full bake hits no missing-packages-source error); an explicit widening option fetches the full declared set (mirror priming / prepopulation); libfetch reports the derived targets and which declaration pulled each in; the VFSLIBS missing-source message names an invocation that fetches what the failing bake actually needs; maketcllibfetch.test characterizes derivation, narrowing and widening through the existing PUNK_LIBFETCH_CONFIG / PUNK_LIBFETCH_PACKAGES seams; the derivation rule is documented in the tier docs.