Tree: 276eff850d

master

v0.1a

Branches Tags

${ item.name }

Create tag ${ searchTerm }

Create branch ${ searchTerm }

from '276eff850d'

${ noResults }

Commit Graph

1 Commits (276eff850d29dcaf3c1674b29403e0c01c56dc00)

Author	SHA1	Message	Date
Julian Noble	75cffe21f3	punk::args 0.12.6 + punk::ns 0.9.0: LLM-oriented usage output; tcl-whatis agent skill ... punk::ns 0.9.0: cmdhelp (i) gains -return text - plain-text argument documentation for machine/LLM consumption: no ANSI, no table layout, the argument section of every command form rendered in one output under a common header ('i -return text after' shows all six forms), G-041 form selection still honoured when argument words are supplied, no advisory-parse error preamble (-return dict remains the parse-status surface). Implementation delegates resolution to the -return dict recursion and renders per-form via the string renderer. punk::args 0.12.6 (user direction; string-form layout explicitly not frozen - no external consumers yet): - arg_error renders the error message + per-form match detail exactly once, BELOW the usage display (was above and below); bottom append suppressed for empty messages. - string renderer argument rows are single-line 'name TYPE:type(constraints) ?DEFAULT:'val'? ?MULTI:yes?' - type constraints parenthesize onto the base type instead of line-breaking mid-row; empty DEFAULT/MULTI labels and whitespace-only help blocks omitted. - choices render as markdown-subset bullets '- `choice` - label' with label continuations at a fixed deeper indent - choice names are now machine-distinguishable from label text without ANSI. Structural contract: column-0 lines bearing TYPE: are argument rows, indented lines are documentation, backticked bullets are choices. Table cells unchanged. New scriptlib/developer/whatis.tcl (runtime command introspection for agents): resolved name, subcommand-chain resolution via punk::ns::cmdinfo ('whatis string is'), kind, providing package + loaded version, origin file, proc definition file:line, punk::args synopsis; -body appends the runtime body with file-relative line numbers, -doc the full plain-text argdoc via cmdhelp -return text (with fallback for older punk::ns). Backing the cross-framework tcl-whatis agent skill: canonical .agents/skills/tcl-whatis/ (Agent Skills standard - pi/OpenCode/Codex) with byte-identical copy in .claude/skills/ for Claude Code; .gitignore gains !.claude/skills/ with the fossil ignore-glob comment + exception-set docs updated per the dual-VCS contract (fossil adds staged). Root AGENTS.md: .agents/skills index entry, whatis pointer in Repo-wide Notes, scriptlib/developer example. Tests: new pins cmdhelp_return_text_all_forms/_argword_form_selection/ _single_form_plain_marker (cmdhelp.test), rendering_stringmode_singleline_argrows + rendering_stringmode_choice_bullets (rendering.test); deliberate-change pin updates: errorselection.test message matches gained leading * and cmdhelp.test message pins sample the last line (message placement). Full source-tree suite 963/979 pass, sole failure the pre-existing exec-14.3 baseline; make.tcl modules clean. Project version 0.12.42 -> 0.13.0 with CHANGELOG.md entry. Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	2 weeks ago