punkshell

1 Tag

176 MiB

Author	SHA1	Message	Date
Julian Noble	2339e4065e	G-168 achieved: selection-sound launch definitions - script/tclsh forms match dispatch reality (punkexe moduledoc 0.7.0) User-directed activation and implementation in one arc (proposed -> active at the user's word with the activation-freshness survey recorded, -> achieved + archived on acceptance). The declarations follow the 2026-08-05 pre-test findings exactly - no engine change was needed. (script)::punkexe::script: the file form fences scriptfile with -regexprefail {^-e$} and a -regexprefailmsg naming the ./-e reachability (word-1 '-e' is the ONLY fenced word - every other dash-led word remains a file path, matching app-punkscript's word-1 test); the oneliner form declares the '-e' word as a real element - a required -type none flag (the auto_exec::hash -r/-d shape) ahead of the existing required script value, so a bare {-e} reports noformmatch with the oneliner form verdicting viable-incomplete via the G-164 re-probe (the app's "-e requires a script argument" reality) and the file form invalid. (script)::punkexe::tclsh: scriptfile gains -regexprefail {^-} (stock tclMain.c: a dash-led word in script-file position means NO script) and the stdin form's first word is a declared fenced element 'firstarg' (-regexprefail {^[^-]} - a non-dash first word IS a script file; not an option, stays in ::argv). Selection now matches stock classification on every line except the recorded LIMIT: the complete '-encoding <name> <scriptfile>' shape word-shape-matches both forms (a dash-led encoding NAME included - the engine consumes dash-led option values, matching stock's unconstrained argv[2]) and stock's arity-priority rule is not expressible per-word - the pair is declared @form -overlapallowed {scriptfile} on the stdin form (formcheck sanction) while parse raises multipleformmatches naming both forms per the G-041 no-silent-preference contract. Dispatch never parses these ids, so the ambiguity surfaces only in declaration-driven consumers (help dry-runs, completion), where the two-form diagnosis is the honest answer. Decisions recorded in the archived detail file: dispatch parse-gating NOT adopted (punkboot_core.tcl untouched; script/tclsh stay declared passthrough surfaces - boot-path parse cost, stock-parity conflict with the LIMIT, app error surfaces already honest and pinned, and the declaration-driven consumers get parse-trueness without gating; no latency delta applicable); the <punkexe> @form -synopsis overrides KEPT (neither the raw (script) id nor @cmd -name is an invocable name; the stdin override keeps the user-facing '?arg ...?' line over the model's firstarg/arg split) - the G-144 archived follow-on flipped to declined accordingly (make.tcl's own override retirement had already landed in the 0.41.0 arc). A real-vs-model probe matrix (G-055 method; bin/punk91 dispatch + app-punkscript real side) is recorded in the detail file - model matches real classification on every line except the two complete-'-encoding' rows (the sanctioned LIMIT). Tests: new args/punkexemodel.test (6 - script/tclsh selection matrices against the real ids with the real-side oracle referenced, the bare-'-e' viable-incomplete verdict, the ./-e fence message, -encoding fall-through statuses (scriptfile invalid vs incomplete, stdin selected), the LIMIT pins naming {scriptfile stdin} for both complete shapes); formcheck.test punkexe GAPs flipped deliberately per the acceptance: formcheck_punkexe_script_forms_discriminated (zero findings), formcheck_punkexe_tclsh_forms_sanctioned (unsanctioned empty + the stdin form's -overlapallowed pinned via get_spec; the positional-chain witness derivation misses option-dependent overlaps - formcheck's documented miss direction - so the sanction also future-proofs improved derivation), formcheck_punkexe_primary_inputs_selection_sound (dispatch-true forms for every primary line; empty input still selects file/stdin uniquely). Full modules/punk/args subtree 337 passed / 3 pre-existing skips / 0 failed on BOTH native tclsh90 (9.0.3) and tclsh87; src/tests/shell/testsuites/punkexe/launcherhelp.test 24/24 unchanged per acceptance (its 'help script'/'help tclsh' pins glob only @cmd -name strings - row additions verified safe post-bake as well). Minted modules/punk/args/moduledoc/punkexe-0.7.0.tm via make.tcl modules; kits/bootsupport carry 0.6.1 until the next promotion/bake cycle. Goals: G-168 entry moved to GOALS-archive.md, detail file to goals/archive/ with the probe matrix, both decisions and verification evidence; one open Follow-on (arity-priority expressibility would flip the LIMIT pins; the broader selection-soundness sweep stays recorded in G-150's archive). Activation survey Related: line added (G-169 back-pointer). Reference sweep: G-169 coordination note updated (G-168 landed first - the re-homed definitions carry this fencing shape), G-170 dependency marked satisfied (its dry-run arm inherits the recorded LIMIT). src/tests/modules AGENTS.md punk/args bullet extended. goals_lint clean (82 active / 88 archived). Claude-Session: https://claude.ai/code/session_0156PuejSCGjgeGb7jiABrDU Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	b0f206f53b	G-168/G-169/G-170 drafted: launcher definition/documentation/help-depth family (user-approved) Three [proposed] goals from the 2026-08-05 formhint-arc discussion of why launcher help stops at the subject word: G-168 selection-sound launch definitions - script/tclsh forms made parse-discriminable with EXISTING vocabulary (file form -regexprefail {^-e$} + oneliner '-e' element; tclsh scriptfile-vs-stdin via candidacy fall-through matching stock semantics). Corrects the discussion's earlier assumption that G-072 negation was required: -regexprefail participates in form matching (G-143-arc verified; the G-150 hash declaration is the dash-led precedent). Includes the dispatch parse-gating decision (tabled vs app-plain errors, latency measured if adopted). G-169 app-owned launch-subcommand documentation - app-punkscript owns (script)::punkexe::script via inert registration, launcher resolves lazily (the existing argsid/package/docpackages machinery), single definer per id, ownership rule recorded (app-owned for app-handled, moduledoc for core-owned like tclsh), and the *_main.tcl declaration surface (summary/package/argsid/parse) documented as the official authoring mechanism. G-170 launcher help depth - 'help <sub> <formname\|index>' narrowing (G-150 usage -form precedent), make.tcl-style dry-run gated on parse-trueness (G-168 built-ins, project parse=1) with the prepend-help idiom preserved for passthrough subcommands, and the punkexe 0.6.1 interim -formhint suppression flipped to real ' <punkexe> help <sub> %formname%' templates. Follow-on handling (user-approved leans): G-144's override-set follow-on flipped => goal G-168 (the make.tcl half landed in the G-143 arc; the punkexe-moduledoc half is now G-168's recorded decision); G-150's selection-soundness sweep follow-on stays open (broader than these two definitions - G-168's Notes record the partial enactment). Overlap survey per the authoring workflow: G-089/G-055/G-072/G-075/G-042/G-043/G-044 relationships recorded in the detail files; app-punkscript intersects no live goals. goals_lint clean (84 active, 86 archived). Claude-Session: https://claude.ai/code/session_01QgaxV27VZkmEec7oNbEVFc Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	4ec0a1109f	G-159: archive retrofit - 30 files gain ## Follow-ons disposition sections All vocabulary-flagged archived detail files structured under the v4 grammar: 24 files with real items, 6 with (none - incidental vocabulary) notes. Census at acceptance: 50 structured follow-ons - 25 open, 17 became goals (incl. G-101''s seven-item block onto G-158/G-130/G-131, G-057+G-128 RT_VERSION onto G-137, G-155 keep-list onto G-156), 6 landed (evidence-backed: G-036 udp swap DONE record, G-046 same-day fix, G-031 tomlish-found core arms), 2 declined (G-036 immunity question academic, G-096 0.15.2 migration superseded by 0.16.0 adoption). Zero unstructured-vocabulary files remain; goals_lint clean (grammar + goal refs validated). goals_followons.tcl: lsort -dictionary for zero-padded ids. Evidence + open-items census recorded in the G-159 detail file. Claude-Session: https://claude.ai/code/session_01QgaxV27VZkmEec7oNbEVFc Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	543dd1df40	G-144 achieved: punk::args auto-synopsis @cmd -name fallback for (script) ids Auto-generated synopses for (script)-prefixed constructed definition ids now lead with the declared @cmd -name (the invocation name - e.g 'make.tcl modules' for (script)::punkboot::modules) instead of the raw id, across punk::args::synopsis full/summary renders and the usage/arg_error synopsis sections that funnel through them (punk::args 0.12.7 -> 0.13.0). The fallback is gated on the (script) prefix only (user-confirmed narrowing): (autodef) ids are excluded - their id-minus-tag IS the invocation (arg_error's existing tag strip surfaces it) while their @cmd -name is a display label ('destroy', 'Object: ::x'); (shared)/(package)/(default)/(widgetcommand) doc ids declare no invocation-style -name today and render the id as before. Real command ids render byte-identical (full args testsuite passes with no pin updates). Six new synopsis.test pins: (script) full/summary/multiform/ surfaces, no-name constructed id, autodef unchanged, real-id byte-identical. Goal tiers: index entry archived to GOALS-archive.md, detail file moved to goals/archive/ (G-143's pending-tense Related line rewritten to reflect achievement + follow-through pointer: make.tcl's @form -synopsis overrides are now optional, retirement under G-143 or a follow-on edit). Docs: @form -synopsis directive known-case text, synopsis -help, src/modules/AGENTS.md ergonomics bullet. Project 0.39.5 -> 0.39.6 (patch: latent capability, no shipped definition renders differently today). Bootsupport refresh (make.tcl modules + bootsupport): snapshot gains args-0.13.0.tm and picks up two lagging source syncs - mix/commandset::layout 0.2.0 -> 0.3.0, mix/commandset::project 0.4.0 -> 0.4.1, and the shellfilter 0.2.4 G-145 comment; superseded copies pruned. Assisted-by: harness=opencode; primary-model=openrouter/moonshotai/kimi-k3; api-location=openrouter.ai	4 weeks ago

4 Commits (43973fa5fdbb68482fdaff9530e5ce7ff7fca73f)