punkshell

779 Commits

1 Branch

1 Tag

192 MiB

Commit Graph

Author	SHA1	Message	Date
Julian Noble	02da46eb74	punk::args 0.4.2 + punk::ns 0.1.4: G-046 achieved - deferred display-field expansion, rendering/value-shape fixes Argument resolution no longer tstr-expands display-only content (-help on @cmd/@examples/argument records, @formdisplay bodies): ${...} there is masked with inert tokens (spec key DISPLAY_DEFERRED) and expanded at display time via private::expand_display_fields (hooks in arg_error/eg/resolved_def/@default copyfrom; separate display cache for non-dynamic defs; @dynamic re-expands per render preserving provider refresh; reentrancy guard substitutes raw sources when expansion of the same id re-enters). First parse of heavily documented commands drops accordingly (punk::ansi::mark_columns first call ~4.3s -> ~12ms; tclcore ::lseq resolve ~184ms -> ~2ms) and -help content that calls punk::args-parsing commands - including against its own definition id - resolves cleanly instead of stalling or looping. -choicelabels stays eager (punk::ns reads it from parse specs in the subcommand walk). Record splitter factored to private::split_definition_records. Also per G-046 acceptance: - @dynamic multiline -help substitutions align at the insertion column (rendering_atdynamic_multiline_help_insertion GAP flipped) - prefix/alias choice normalization keeps single-element-clause values plain-string ({\Deleted} list-wrap shape bug; choicegroups_imap_prefix_shape GAP flipped) - -return string renderer aligns cmd-help continuations under the Description: label (characterization updated) and its Example: line shows the example, not the doc url - punk::ns cmdhelp shows plain info-scheme usage when no argument words are supplied for a leader/value-requiring definition ('i string is', 'i punk::args::define') - advisory parse runs -errorstyle minimal so the discarded error no longer renders a second usage table (timing parity with pre-change: ~5.3s/4.1s on punk91 src) Tests: deferredhelp.test (new); suites green on tcl903 + tcl87; full source-tree run baseline-clean (exec-14.3 only). GOALS.md: G-046 -> achieved 2026-07-10 (activated this session at user direction); design + verification evidence in the detail file. Project 0.4.15. Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	675aa22701	G-045, G-046 proposed: punk::args authoring ergonomics; deferred -help resolution + rendering/value-shape fixes Both user-approved, drafted from the 2026-07-09 characterization findings with their acceptance criteria anchored to the pinned GAP tests. - G-045 (authoring ergonomics): parser-recognised record continuation (candidate: unquoted trailing -& with collision rules and an element-count disambiguation alternative recorded), @cmd honouring -unindentedfields, constructed (string-built) definitions able to opt into the whole-block indent normalization file-style definitions get (de-hacking ::punk::helptopic::define_docs as the consumer proof), and the braced-vs-quoted container quoting rules promoted from defquoting.test into the define documentation. - G-046 (deferred -help + fixes): headline item per user emphasis at approval - argument resolution stops processing -help/display-only fields, deferring their tstr expansion to display time with separate parse-vs-display caching (per the existing in-source review note), for measurable first-parse gains and fixing the reentrancy class reproduced with punk::ansi::mark_columns (~3.94s first call: its -help calls a proc that calls mark_columns, whose parse resolves the same still-resolving definition). Plus: @dynamic second-round multiline paramindent alignment, prefix-normalization value shape (list-wrap of backslash-containing choices), -return string renderer cmd-help continuation alignment, and the misleading goodargs 'Bad number of leading values...' prefix in 'i <cmd> <args>' output. Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago

Author

SHA1

Message

Date

Julian Noble

02da46eb74

punk::args 0.4.2 + punk::ns 0.1.4: G-046 achieved - deferred display-field expansion, rendering/value-shape fixes

Argument resolution no longer tstr-expands display-only content (-help on
@cmd/@examples/argument records, @formdisplay bodies): ${...} there is masked with
inert tokens (spec key DISPLAY_DEFERRED) and expanded at display time via
private::expand_display_fields (hooks in arg_error/eg/resolved_def/@default copyfrom;
separate display cache for non-dynamic defs; @dynamic re-expands per render preserving
provider refresh; reentrancy guard substitutes raw sources when expansion of the same
id re-enters). First parse of heavily documented commands drops accordingly
(punk::ansi::mark_columns first call ~4.3s -> ~12ms; tclcore ::lseq resolve
~184ms -> ~2ms) and -help content that calls punk::args-parsing commands - including
against its own definition id - resolves cleanly instead of stalling or looping.
-choicelabels stays eager (punk::ns reads it from parse specs in the subcommand walk).
Record splitter factored to private::split_definition_records.

Also per G-046 acceptance:
- @dynamic multiline -help substitutions align at the insertion column
  (rendering_atdynamic_multiline_help_insertion GAP flipped)
- prefix/alias choice normalization keeps single-element-clause values plain-string
  ({\Deleted} list-wrap shape bug; choicegroups_imap_prefix_shape GAP flipped)
- -return string renderer aligns cmd-help continuations under the Description: label
  (characterization updated) and its Example: line shows the example, not the doc url
- punk::ns cmdhelp shows plain info-scheme usage when no argument words are supplied
  for a leader/value-requiring definition ('i string is', 'i punk::args::define') -
  advisory parse runs -errorstyle minimal so the discarded error no longer renders a
  second usage table (timing parity with pre-change: ~5.3s/4.1s on punk91 src)

Tests: deferredhelp.test (new); suites green on tcl903 + tcl87; full source-tree run
baseline-clean (exec-14.3 only). GOALS.md: G-046 -> achieved 2026-07-10 (activated
this session at user direction); design + verification evidence in the detail file.
Project 0.4.15.

Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com

3 weeks ago

Julian Noble

675aa22701

G-045, G-046 proposed: punk::args authoring ergonomics; deferred -help resolution + rendering/value-shape fixes

Both user-approved, drafted from the 2026-07-09 characterization findings with
their acceptance criteria anchored to the pinned GAP tests.

- G-045 (authoring ergonomics): parser-recognised record continuation
  (candidate: unquoted trailing -& with collision rules and an element-count
  disambiguation alternative recorded), @cmd honouring -unindentedfields,
  constructed (string-built) definitions able to opt into the whole-block
  indent normalization file-style definitions get (de-hacking
  ::punk::helptopic::define_docs as the consumer proof), and the
  braced-vs-quoted container quoting rules promoted from defquoting.test into
  the define documentation.
- G-046 (deferred -help + fixes): headline item per user emphasis at approval
  - argument resolution stops processing -help/display-only fields, deferring
  their tstr expansion to display time with separate parse-vs-display caching
  (per the existing in-source review note), for measurable first-parse gains
  and fixing the reentrancy class reproduced with punk::ansi::mark_columns
  (~3.94s first call: its -help calls a proc that calls mark_columns, whose
  parse resolves the same still-resolving definition). Plus: @dynamic
  second-round multiline paramindent alignment, prefix-normalization value
  shape (list-wrap of backslash-containing choices), -return string renderer
  cmd-help continuation alignment, and the misleading goodargs 'Bad number of
  leading values...' prefix in 'i <cmd> <args>' output.

Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com

3 weeks ago

2 Commits (4bb7b3d68f5207694b0266f7ed69f5f50e0257a9)