G-149 follow-on landed: make.tcl adopts @cmd -formhint - actionable per-action help hints with honest continuation ellipsis (punkshell 0.55.1)
The multi-form definitions (tool, buildsuite) each declare
'@cmd -formhint " make.tcl help <sub> %formname% …"', so
'make.tcl help tool' / 'help buildsuite' - and every dispatch usage
error for those subcommands - label each form's synopsis line with the
concrete dry-run-help invocation (' make.tcl help tool build ...'
rendered with U+2026) instead of the repl-oriented ' i -form N ...'
default, which is unreachable for (script) ids. Renders via the
promoted bootsupport punk::args 0.17.0; under older snapshots (e.g
generated projects) the key is ignored and the default labels render.
Design decisions (user direction 2026-08-05, recorded in the follow-on
disposition): the trailing ellipsis is required for honesty - help
DRY-RUNS the form's own command line after the action (G-143), so a
hint without it misrepresents the invocation as complete. The template
was kept over empty-string suppression because the labels also render
on dispatch usage errors ('make.tcl tool frobnicate'), where the user
never typed help and the hint is the discovery route to per-action
help; suppression would lose that teaching path.
maketclhelp.test: tool formhints pin flipped to the new labels with an
olddefaulthint-absent guard; buildsuite multiform test gains the same
pair; header + provenance comments updated. The ellipsis is matched as
its utf-8 byte triple (format %c%c%c 0xe2 0x80 0xa6) because
maketcl_run reads the child pipe -translation binary, so multibyte
chars arrive byte-wise - a real U+2026 char in the pattern can never
match (first-cut pin failed green-render for exactly this). 12/12
green on tclsh90; maketcltool.test 4/4.
Sync outputs batched per policy (make.tcl modules + bootsupport): the
basic + project-0.1 layout make.tcl copies, the modpod source-tree
copy, and the bootsupport templates-0.2.0.tm repack all carry the
identical +2-line change. The archived G-149 follow-on disposition
flipped => landed 2026-08-05 (the sanctioned same-work-unit edit);
goals_lint clean. punkshell 0.55.1 + CHANGELOG (make.tcl help output
is product surface - patch). Kits pick this up at the next
vfscommonupdate + bake.
Claude-Session: https://claude.ai/code/session_01QgaxV27VZkmEec7oNbEVFc
Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com
Follow-on: make.tcl adopts the mechanism for its (script)::punkboot definitions (e.g a 'make.tcl help <subcommand><action>' hint phrasing via @cmd -formhint) after a bootsupport promotion carrying punk::args 0.17.0- (maketclhelp.test formhints pin updates with it) => open
Follow-on: make.tcl adopts the mechanism for its (script)::punkboot definitions (e.g a 'make.tcl help <subcommand><action>' hint phrasing via @cmd -formhint) after a bootsupport promotion carrying punk::args 0.17.0- (maketclhelp.test formhints pin updates with it) => landed 2026-08-05 (make.tcl tool+buildsuite @cmd -formhint " make.tcl help <sub> %formname% <U+2026>" - trailing ellipsis marks the dry-run continuation help accepts after the action (user direction: a hint without it misrepresents the line as complete); template kept over empty-string suppression because the labels also render on dispatch usage errors, where they are the discovery route to per-action help; punkshell 0.55.1; maketclhelp.test formhints pins flipped + buildsuite hint pin added (utf-8 byte-triple matching - the harness reads the pipe binary); layout make.tcl copies + templates modpod + bootsupport templates synced same unit)
# 'make.tcl help <subcommand> <action> ...' hint labels, ellipsis (U+2026)
# marking the dry-run continuation help accepts after the action (G-149
# @cmd -formhint adoption 2026-08-05 - the repl-oriented ' i -form N ...'
# default is not actionable for (script) ids and no longer renders here; the
# hints also render on dispatch usage errors, where they are the discovery
# route to per-action help)
# and the action -choicelabels in the choices area; ESC-free (G-113 piped policy)
# - 'help tool build': the build form's own argument table (-test opt + toolname);
# 'help buildsuite build': suitename-required diagnosis carrying the form's rows
@ -154,7 +160,14 @@ namespace eval ::testspace {
}
#added 2026-08-01 (agent, G-143)
test maketcl_help_tool_multiform {piped 'make.tcl help tool': exit 0, ESC-free, one synopsis line per action with i -form hints and the action choicelabel} -constraints {tclshavailable} -body {
#formhints pin updated 2026-08-05 (agent, G-149): the tool definition adopts
#'@cmd -formhint' with template ' make.tcl help tool %formname%' plus a
#trailing U+2026 ellipsis (punk::args 0.17.0), so the per-form hint labels
#are the actionable dry-run-help invocations, one per action, with the
#ellipsis honestly marking that help accepts the form's own command line
#after the action (the G-143 dry-run); the repl-oriented ' i -form N ...'
#default no longer renders.
test maketcl_help_tool_multiform {piped 'make.tcl help tool': exit 0, ESC-free, one synopsis line per action with 'make.tcl help tool <action>' hint labels and the action choicelabel} -constraints {tclshavailable} -body {
set r [maketcl_run {help tool}]
set out [dict get $r output]
set result [list]
@ -164,10 +177,15 @@ namespace eval ::testspace {
lappend result syninfo [regexp {make\.tcl tool info toolname \[toolname\]\.\.\.} $out]
#'@cmd -formhint' with the ' make.tcl help buildsuite %formname%' + trailing
#U+2026 ellipsis template, like tool above.
test maketcl_help_buildsuite_multiform {piped 'make.tcl help buildsuite': exit 0, one synopsis line per action with 'make.tcl help buildsuite <action>' hint labels} -constraints {tclshavailable} -body {
set r [maketcl_run {help buildsuite}]
set out [dict get $r output]
set result [list]
@ -231,8 +252,11 @@ namespace eval ::testspace {
lappend result synlist [regexp {make\.tcl buildsuite list} $out]
lappend result syninfo [regexp {make\.tcl buildsuite info suitename} $out]
lappend result synbuild [regexp {make\.tcl buildsuite build suitename \[driverarg\]\.\.\.} $out]
set ell [format %c%c%c 0xe2 0x80 0xa6] ;#U+2026 as utf-8 bytes (binary-read pipe - see tool test)
lappend result formhints [expr {[regexp " make\\.tcl help buildsuite list $ell" $out] && [regexp " make\\.tcl help buildsuite build $ell" $out]}]
lappend result olddefaulthint [regexp { i -form 0 } $out]
