Engine-primitive pins landed green ahead of activating the launcher
definition/documentation/help-depth goals (args subtree 321 tests: 318 pass,
3 known-bug skips, 0 fail on native tclsh90 9.0.3 and tcl87):
- forms.test: candidacy fencing/fall-through group (G-168 pre-work) -
regexprefail-fenced autoselection fixture pin (args-tier twin of the G-150
cmdhelp.test pins), a -regexprefail rejection on an OPTIONAL value slot is
form-fatal with NO re-landing on later permissive slots (contrast
optional-choice rejection), unknown-option / dangling-option /
option-satisfied-but-values-unmet failures fall through to sibling forms as
successful parses, option-VALUE fences participate in candidacy, and the
documented per-word limit: a complete '-encoding <name> <file>' line
double-matches a fenced scriptfile form vs a dash-tolerant stdin form
(stock's scriptfile-wins-when-complete priority is not expressible
per-word - multipleformmatches per the G-041 contract).
- formviability.test: dangling-OPTIONAL-option verdict conservatism - the
G-164 re-probe re-seats only words naming missing REQUIRED options, so the
tclsh '-encoding' dangling class stays invalid although completable.
- errorselection.test: a dangling optional value-taking option word seats as
a trailing value and overflows a zero-value window as plain
toomanyarguments (no -badarg attribution).
- formcheck.test: GAP before-state pins of the punkexe launch definitions -
unsanctioned structural overlaps for script file/oneliner and tclsh
scriptfile/stdin, and every primary launch line double-matching; flipped
deliberately when G-168 lands per its Acceptance.
- docpackages.test (new): registered-namespace lazy definition loading
characterization (G-169 pre-work) - inert registration with scan-vs-load
split, id_exists never triggers loading, real_id/usage lazily resolve
tag-prefixed script-level id families, duplicate definers resolve
last-loaded-wins with only a stderr undefine notice (the engine's recorded
detect-duplicates todo), degraded paths clean.
Goal notes (non-contract): pre-test findings recorded in G-168 (including the
'-e'-must-be-a-required-flag declaration constraint and the residual-overlap
design limit) and G-169 (handover must withdraw the moduledoc entry in the
same change-set - no duplicate warning surface exists); G-170<->G-151
Related: cross-links added both ways - the dry-run arm renders G-151's
punk::args-level landing report, a link the path-based overlap surveys could
not surface. src/tests/modules AGENTS.md punk/args bullet extended for the
new coverage. goals_lint clean (84 active, 86 archived).
Claude-Session: https://claude.ai/code/session_0156PuejSCGjgeGb7jiABrDU
Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com
