Tree: ce31d8623c

master

v0.1a

Branches Tags

${ item.name }

Create tag ${ searchTerm }

Create branch ${ searchTerm }

from 'ce31d8623c'

${ noResults }

Commit Graph

55 Commits (ce31d8623c225c4436e71c6750dd3b7ac8a32e24)

Author	SHA1	Message	Date
Julian Noble	3bafc2f195	GOALS + src/tests: test provenance comments and superseded/abandoned test-sweep rules ... - src/tests/AGENTS.md: agent-added tests carry a one-line provenance comment `#added <YYYY-MM-DD> (agent[, G-<id>])[ - <short note>]` - immutable facts only (never "G-NNN will flip this" expectations, which live in _GAP_ test names and goal files); user-added tests optional; no bulk retrofit of existing suites. Rationale: provenance must survive where VCS history does not travel - packaged test modules (G-029), git+fossil dual history, file regeneration/moves - GOALS.md maintenance rules: marking a goal superseded/abandoned includes a test sweep - grep G-<old id> (at minimum src/tests) plus the tests named in the goal's detail-file Acceptance, and record each test's disposition (transfers to the superseding goal / stands down to plain characterization / lapses) in the appropriate detail file; the sweep never deletes, skips, or weakens tests on its own - the provenance lines are what keep the supersession sweep's grep reliable over time; closes the dangling-GAP-pin risk analyzed for superseded goals - no project version bump: governance docs only Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	ae04b3f8c9	GOALS: two-tier index restructure - summary-only GOALS.md, canonical Goal/Acceptance in detail files, archive-on-flip ... - GOALS.md collapsed to summary entries (ID/status/title/Scope/detail pointer): 104.6KB -> 23KB so a full read stays cheap; Scope lines kept verbatim so path-grep goal discovery still works - canonicality split: index canonical for ID/status/title/Scope, detail file canonical for Goal:/Acceptance:; all 61 detail-file headers reconciled from the index (fixes stale copies, e.g. G-036 detail acceptance predated the achieved rework), bodies preserved untouched - detail files created for the three index-only goals G-017, G-034, G-054; every goal now has one - 10 achieved goals (G-007 G-015 G-036 G-037 G-040 G-046 G-049 G-054 G-058 G-059) archived: summary records appended to GOALS-archive.md, detail files moved to goals/archive/; archive-on-flip replaces the ~30-achieved-entries trigger - GOALS.md preamble/rules reworked: read workflow (read index in full, then detail files of scope-intersecting goals before editing), contract spans both tiers with proposal-first unchanged, next-free-ID counts the archive, achieved flip judged against the detail-file Acceptance and includes archiving - progress convention codified from G-001 increment-1 practice: index entries carry status only, never progress; incremental progress lives in the detail file's ## Progress section (landed/remaining); achieved flip requires the remaining-work list resolved - a partial increment never flips a goal - goals/AGENTS.md rewritten for the split (required 4-field header, one detail file per goal, orphan rules covering archive/); root AGENTS.md Child DOX Index + Repo-wide Notes updated; GOALS-archive.md preamble updated - stale detail-file paths updated to goals/archive/ in src/lib/app-punkscript/punkscript.tcl (comment), runtimebash_wsl.test, wslprobe.tcl and the G-042 detail file; propagated copies (root lib/, src/vfs/_vfscommon.vfs, src/_build) left to refresh via normal build steps - no project version bump: governance docs and source comments only, no user-visible shell behaviour Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	aec77ca0d1	G-001 increment 1: pluggable ::opunk::Console backends - test double, ssh-channel, tk-widget (punkshell 0.9.0) ... - three new backend modules under src/modules/opunk/console/, base ::opunk::Console and punk::console UNCHANGED (the G-001 acceptance constraint - verified diff-clean): * opunk::console::test / ::opunk::TestConsole - deterministic channel-pair test double: fixed size via -columns/-rows, is_console_or_tty/can_respond 1 (settled value wins), at_eof = plain chan eof with NO probe (pending bytes never consumed - pinned). The console seam identified by the G-044 repl characterization work * opunk::console::ssh / ::opunk::SshConsole - socket-carried terminal sessions: construction-time capability (detection is the wrong tool - per goal detail), chan-eof without byte-consuming probes, size via the registered ANSI size-query provider over the connection. Flagship test: a scripted remote terminal answers CSI 6n over a socket pair and size resolves 100x30 through punk::console machinery querying the socket * opunk::console::tk / ::opunk::TkConsole - Tk text widget as terminal: widget path in the inherited in/out slots (documented non-channel reuse), terminal_class tk-text, size from widget char dims, at_eof via backend marker (opunk::console::tk::set_eof) or widget destruction; no Tk require at module load. Verified live under punk91 src (the tk-loading experiment kit) - voo -extends subclassing pattern recorded in opunk/AGENTS.md: children inherit public accessors + field INDEX variables (not parent-private my.* accessors) - constructors initialise inherited private fields via index vars, method bodies use parent public accessor methods; virtual dispatch via the slot-0 tag needs no base changes - tests: modules/opunk/console backends.test (8 tests: dispatch, spec_resolve acceptance of subclass values, probe-free eof, settled-capability precedence, ssh capability/eof/size-over-socket/settled-0-no-emission, tk gated behind env PUNK_TEST_TK=1) - 7 green + tk skip on tcl 9.0.3 and 8.7; tk case verified standalone under punk91 - goal detail records progress + remaining work (repl -console launch wiring, output-channel parameterization, interactive acceptance verification); goal stays active Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	4bb7b3d68f	G-054 achieved: tclcore string is class choices harvested from the running interpreter (tclcore moduledoc 0.2.0, punkshell 0.8.2) ... - the ::tcl::string::is definition harvests its class set at define time from the bad-class error message of a deliberately invalid probe (safe, side-effect-free) - accept/reject parity with the loading interpreter by construction: 8.6.13 = 21 classes (no dict - the previous static 9.0 list wrongly ACCEPTED string is dict there), 8.7a6 = 23 (+dict +unicode), 9.0.3 = 22 (unicode removed). Fallback to the 9.0 set if the message format ever changes - hand-written man-page descriptions (kept verbatim, tstr-processed as before so the A_WARN highlights are unchanged) apply only to classes the runtime accepts; accepted-but-undescribed future classes get a generic label; static version notes added to dict (not in 8.6) and the new unicode entry (unreleased 8.7 only - removed in tcl 9). The per-class virtual docids (::tcl::string::is <class>) follow the harvested set automatically - new tclcoreparity.test (4 tests, gated on have_tclcoredocs): choices equal the live-harvested set and every documented choice is really accepted; per-class docids exist for every class; error-vs-ok outcome agrees between real string is and parse_status across the 23-shape probe matrix (missing args, trailing flag-like str, option/class prefixes + ambiguity, unknown option/class, -failindex var consumption, per-version dict/unicode presence, divergent-classification shapes); version-note labels conditional on presence. Expectations derived from the LIVE interpreter, never version arithmetic - green on 9.0.3, 8.7a6 and (via a direct tcltest driver, since runtests infrastructure does not run under the plain 8.6 kit) 8.6.13 - full punk/args + punk/ns trees green (219 pass + 1 pre-existing skip) incl the have_tclcoredocs cmdhelp pins Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	8c65fe9d6f	repl pre-refactor: characterize command-completeness engine + record preserve-list and testability findings ... - new commandcomplete.test (6 tests, green 9.0.3 + 8.7): punk::lib::system::incomplete pure-function characterization - the info-complete quoting quirk (a quoted word with unbalanced braces e.g set x "{*}{" is complete standalone but needs extra closers inside a proc body; the pending-opener stack { " { " shrinks per typed closer), single openers, tabs in open braces, escapes, and an incomplete<->info-complete parity property over a case battery - goals/G-044 detail: the user-specified preserve-list any repl refactor must honour (info-complete parity + quirk, closing-prompt hints incl the accepted single-candidate limitation pinned-not-fixed, raw-mode colour staging in-progress vs submitted, literal tab acceptance with raw-mode marker edit smarts, dim space dots display-only never leaking into submitted strings/history, up/down navigation of MULTILINE editbuf history with recalled entries editable) + testability findings: class_editbuf is console-coupled at its core (add_chunk renders via overtype::renderline against live terminal metrics - cursor-position size probing, DECRQPSR tabstops) so items 3-6 are not unit-characterizable until a console seam exists - G-001 (pluggable console backends / ::opunk::Console test double) is the enabling refactor, not just a feature goal - goals/G-020 detail: repl interactive-behaviour verification recorded as a driving use case (near-term windows harness: keystroke injection + capture) pending the durable pseudoconsole expect-alternative Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	3a5a68ec9b	G-059 achieved: WSL capability probing + native-filesystem staging for unix-side tests from windows ... - new src/tests/testsupport/wslprobe.tcl (::punktest::wsl): memoized capability probe for the wsllinux constraint - default distro launches and unames as Linux, tools present (bash/mktemp/wslpath + sha1 tool), native tempdir file round trip; any failure -> skip with reason, so wsl.exe-present-but-unusable installs cannot false-positive. Staging helpers (staging_create/copy_in/run_in/cleanup) enforce the design: execution on the distro NATIVE filesystem only, shared /mnt used for one-way copy-in/out, the windows checkout never operated on from inside WSL (DrvFs slowness + cross-boundary stat differences that make git re-hash its index and fossil see phantom changes). Probe uses wsl -e invocations only (wsl --status/-l emit UTF-16) - multishell.test: scriptwrap_multishell_exec_wsl_sh - the polyglot sh payload produces its marker under the distro bash from native staging (the direct isunix twin still skips on windows) - new shell/testsuites/binscripts/runtimebash_wsl.test (8 tests): runtime.bash first-ever execution on real unix - multi-candidate run errors listing candidates, use/list/run round trip with argument passing, PUNK_ACTIVE_RUNTIME override, unknown/unselectable use errors, stale-active guidance, single-candidate fallback, offline list -remote (crafted cached sha1sums.txt + PUNKBIN_URL forced fetch failure), and the checkout-untouched guard (git status --porcelain identical before/after per acceptance) - green on tcl 9.0.3 + 8.7 against Ubuntu-24.04/WSL2; suites skip cleanly when the probe fails; enablement/limitations in src/tests/AGENTS.md (known limitation: a present-but-HANGING wsl can stall the probe) - GOALS.md G-059 flipped to achieved 2026-07-11; detail file records the outcome incl the UTF-16 discovery and the 512-byte label regression this work surfaced (caught by the guardrail suite as designed) Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	7f32862d2f	runtime.cmd: active-runtime selection (use subcommand + active.toml), bash checksum parity, scriptset moved to src/scriptapps/bin (punkshell 0.7.0) ... - run no longer launches the last runtime alphabetically: resolution is PUNK_ACTIVE_RUNTIME env override -> bin/runtime/<platform>/active.toml (constrained single-key toml, written by the new 'use <name>' subcommand, marked with * in list, covered by the existing bin/* VCS ignores) -> sole installed candidate -> error listing candidates. First fetch sets active only when none recorded; later fetches never steal it. Stale active (file removed) reported with reselect guidance. - bash/zsh payload fetch reaches checksum parity with the powershell payload: fetches sha1sums.txt, locates the stored hash, skips when the local copy matches, downloads to .tmp and installs only on sha1 match; sha1 tool detection (sha1sum/shasum/sha1/openssl) with refusal of unverified downloads when none present; optional runtime-name argument added (fetch <name>) - fixes: powershell "stored hash from sha1sums.txt" printed an undefined variable ($storedhash -> $stored_sha1); bash MSYS branch invalid assignment (interp = ...); candidate listings for run/list/use exclude .tmp leftovers and non-runtime files (a stray .txt could previously be selected by run) - runtime scriptset sources relocated to src/scriptapps/bin (proper home alongside getzig.*); bin/runtime.cmd regenerated via scriptwrap from the new location - roundtrip test path updated, suite green on 9.0.3 (8 pass + unix-gated skip), runtime.bash syntax-checked under bash and zsh - verified live on windows: multiple-runtimes-no-active errors with candidates (previously silently launched tksfe-twapi-x64), use/list/run against tclsfe-x64 and env override to tclsh902z, fetch no-steal + first-fetch auto-set, checksum-match no-download path - docs: bin/AGENTS.md documents the fetch/use/run contract and updated generated-polyglot workflow paths; src/scriptapps/AGENTS.md scriptset-home wording updated Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	b11f3e5946	tests + guidance for the MULTISHELL polyglot build machinery (scriptwrap) ... - new src/tests/modules/punk/mix/testsuites/scriptwrap/multishell.test (9 tests, green on tcl 9.0.3 + 8.7, unix exec case constraint-gated): scriptset wrap via the module-provided punk.multishell.cmd template (payloads + _wrap.toml fixture) - output produced, MULTISHELL magic line, payloads embedded verbatim, configured win32 nextshell present, LF-only endings, byte-identical re-wrap determinism; checkfile 512-byte label/boundary validation reports no label location errors for a fresh wrap AND for the committed bin/runtime.cmd; the runtime scriptset ROUND-TRIP pin - re-wrapping src/scriptapps runtime.ps1+runtime.bash+runtime_wrap.toml reproduces bin/runtime.cmd byte for byte (verified identical before pinning), so hand-edits to the output or unregenerated payload changes both fail; execution smoke - cmd.exe runs the polyglot and dispatches the powershell payload (windows), sh payload execution gated to unix (on windows the shell layer deliberately relaunches via the win32 nextshell) - guidance strengthened so "fix bin/<name>.cmd" routes to sources: root AGENTS.md bin/ index entry now states the .cmd polyglots are scriptwrap-generated from src/scriptapps; bin/AGENTS.md gains a "Generated polyglot .cmd scripts - never edit in place" section with the 4-step fix workflow (edit payloads/toml, re-wrap with multishell -askme 0, heed checkfile ERRORs, commit source + regenerated output together); src/scriptapps/AGENTS.md documents the scriptset->bin/*.cmd relationship and regeneration command; tests index updated - context: the polyglot technique is deliberately maintained despite fragility (user direction 2026-07-10) until hiding techniques close in the underlying languages - these pins are the guardrails Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	d3d81c1c39	G-058 achieved: boot honours statically-linked runtime packages (punk::lib 0.4.0, punk::repl 0.3.0, punk::packagepreference 0.2.0, shellthread 1.7.0) ... - punk_main.tcl captures the runtime static baseline at kit boot: empty-filename [info loaded] prefixes probe-loaded in a throwaway interp (configurable denylist tk*/vfs/mk4tcl/vlerq/tdbc* for side-effecting/composite inits), recording only packages a load actually PROVIDES (diff on provides, not package names - probe loads can trigger index scans) into ::punkboot::static_packages/static_prefixes; the boot interp is seeded with ifneeded {load {} <prefix>} mappings - punk::lib interp_sync_package_paths/snapshot_package_paths propagate the baseline and seed fabricated interps/threads; punk::repl codethread init (new %staticprefixes%/%staticpackages% scriptmap) and shellthread worker init do the same - the repl code interp on a static runtime resolves Thread again (punk91 = tclsfe-x64 + punk9win.vfs failed with "can't find package Thread"; the appended vfs replaces the stub's //zipfs:/app mount taking its static pkgIndex files with it, and the tclsfe PostInit hook seeds per-interp auto_path only) - punk::packagepreference static-vs-bundled policy: requiring a baseline package ensures the static mapping and triggers the package unknown scan BEFORE resolution so bundled copies register and the highest version wins (newer bundled reachable, static not masked by older bundled); static registrations excluded from the loaded-shared-object same-version pinning - composite statics defer correctly: static twapi provides nothing under the probe (script layer lived in the replaced stub zip) so the bundled complete twapi is the resolution; punk91 vfs/vfs::zip warning re-diagnosed as kit content (tclsfe bundles no tclvfs) - recorded in the goal detail, not a seeding defect - tests: staticseed.test (4) + staticpolicy.test (4) un-gated simulated-baseline units (green 9.0.3 + 8.7); staticruntime.test (4) kit integration behind the capability-probed statickitavailable constraint (probes ::punkboot baseline incl Thread; env PUNK_STATICKIT_TEST_EXE override, default bin/punk91.exe) - 4/4 against the rebuilt punk91; punk902z/full shell tree/full source-tree suite baselines unchanged (exec-14.3 only) - verification runtime tclsfe-x64.exe pinned in the punkbin artifact repo (separate repo, commit b2dbbe6) with sha1sums + new AGENTS.md scaffolding - punkshell 0.6.0: CHANGELOG entry; AGENTS updates (src/vfs capture contract, tests indexes incl new punk/lib + punk/packagepreference entries, shell staticruntime contract) Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	ce2ba184cb	punk::args 0.5.0 + punk::ns 0.2.0: G-049 parse-status data model + machine-parsable cmdhelp returns ... - new punk::args::parse_status: documented status structure from a parse attempt (overall ok / status valid|invalid|incomplete / scheme / message / errorcode minus -argspecs / failureclass / badarg / form / receivednames + per-argument argstatus with class, status ok|bad|unparsed, received count/positions, value-in-effect incl -default fill); validation failures reported in the structure, not raised - arg_error -parsestatus: both renderers derive goodarg/badarg row marking and choice value-in-effect highlighting from the structure (transient goodargs/badarg locals replaced; built internally from -badarg/-parsedargs when not supplied) - per-render scheme colour resolution: documented -scheme choice value 'nocolour' now takes effect and scheme renders no longer mutate the shared arg_error_CLR array (strike-only goodarg leak fixed) - parse: new -caller option overriding the %caller% frame-walk substitution (included in parse cache key); get_dict missingrequiredvalue/missingrequiredleader now carry -badarg (type/allocation failures get badarg marking, not just choice violations) - punk::ns::cmdhelp: -return dict {origin docid cmdtype args_remaining parsestatus}; advisory parse via parse_status on both alias and main paths; explicit -scheme honoured on the parse-failure render; failure messages name the queried command instead of leaking the internal parse source line at top call depth - tests: parsestatus.test new (12); usagemarking.test G-049 GAP pins flipped + -parsestatus parity/badarg render tests (17); cmdhelp.test G-049 GAP pins flipped + cmdhelp_return_dict_* (25); punk/args + punk/ns trees green on Tcl 9.0.3 and 8.7; full source-tree suite baseline unchanged (exec-14.3 only) - punkshell 0.5.0: CHANGELOG entry; src/tests/modules/AGENTS.md test-index blurbs updated Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
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	383e4e5057	punk::args 0.4.1: ensemble autodef loads lazily-registered subcommand argdocs before id_exists checks ... First 'i <ensemble>' in a fresh shell (e.g 'i ansistring') rendered the autogenerated ensemble help without subcommand-help markers/choicelabels: ensemble_subcommands_definition tested punk::args::id_exists against argdocs whose registered namespace (::punk::args::register::NAMESPACES) had not yet been lazily loaded - the punk::ns doc-lookup entry path only loads the ensemble command's parent namespace. The generator now runs update_definitions for the namespaces its id checks could resolve in. Self-healed on later calls (autodef regenerates per 'i' invocation), which is why the defect went unnoticed; no prior test pinned the load ordering. Tests: punk/args ensembledef.test (new), punk/ns cmdhelp.test cmdhelp_ensemble_lazy_registered_argdocs. Project 0.4.14. Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	22dd6d5407	runtests.tcl: -include-paths -multiple 1 - repeated flags accumulate (last-wins footgun fixed) ... - Repeated -include-paths flags previously overrode each other silently (standard non-multiple punk::args opt semantics), quietly narrowing the test selection while reporting green - a recurring misuse driven by Unix-CLI accumulate-flag muscle memory (gcc -I / curl -H style). - The option is now -multiple 1: repeated flags accumulate, the single space-separated quoted list form is unchanged, and the unreceived default {**} passes through (the consumer flattens occurrences with concat). Help text documents both forms as equivalent. - src/tests/AGENTS.md work-guidance updated. Known remaining sibling issue: multiple trailing file-tail globs still silently match 0 files. - Verified: repeated-flag and single-list invocations select identical file sets (20 files / 189 tests) on Tcl 9.0.3, repeated-flag accumulation on 8.7, and a no-flag default run with a file-tail glob unchanged. The general strict-arity mechanism is proposed as G-053. Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	fe85dfadd0	punk::ansi 0.1.2: PUNKARGS argdoc coverage for codetype/sequence_type/ta/ansistring + characterization tests ... - 34 documentation-only PUNKARGS blocks added: punk::ansi::codetype (is_sgr_reset, has_sgr_leadingreset, is_cursor_move_in_line, has_all_effective, get_effective_types, is_gx/is_gx_open/is_gx_close, sgr_merge), punk::ansi::sequence_type (is_Fe7/is_Fe/is_Fe8, is_Fp, is_Fs, is_nF, is_3Fp, is_code7/is_code8/is_code, classify), punk::ansi::ta (detect_in_list, detectcode, detectcode_in_list, detect_g0, detect_open, detect_st_open, detect_csi, detect_sgr, split_at_codes, split_codes, split_codes_single, get_codes_single) and punk::ansi::ansistring (VIEW, COUNT, length, trimleft/trimright/trim, INDEX, INDEXCHAR, RANGE, INSERT, INDEXABSOLUTE, INDEXCOLUMNS, COLUMNINDEX). - ::punk::ansi::sequence_type added to the punk::args::register NAMESPACES list - the escape-form classifiers live there (a separate namespace from codetype) and were previously undiscoverable by the doc system. - New characterization suites: ta.test (12 tests - detect vs detectcode lone-CSI distinction, split_codes/split_codes_single/split_at_codes shapes and join round-trip, length/extract), codetype.test (11 tests - reset/leading-reset semantics, effective-state queries incl. bold-via-intensity, sgr_merge, sequence_type classify taxonomy); ansistring.test extended 1 -> 12 tests (INDEX/INDEXCODE/INDEXCHAR/RANGE/INSERT grapheme indexing with merged SGR-prefix tracking incl. end+1 state-after-string, INDEXCOLUMNS/COLUMNINDEX double-wide column mapping via a CJK fixture, INDEXABSOLUTE resolution, styled-whitespace trim, VIEW control-picture substitution). - Tests use literal escape strings (not a+) so results are independent of the punk::console colour state. Origin notes added to the usage-marking suites' local SGR helpers pointing at these canonical mechanisms and their coverage. - src/tests/modules/AGENTS.md child DOX index: entries added for the punk/ansi, punk/args and punk/ns suites (GAP-pin/goal mapping documented). - Verified: 44/44 ansi suite and the full ansi+args+ns sweep (232 passed, 1 pre-existing skip) on Tcl 9.0.3 and 8.7; make.tcl modules clean. Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	83b7e2a0de	punk::ns 0.1.3: usage-marking characterization tests (usagemarking.test, cmdhelp.test) + cmdhelp subcommand doc fix ... - punk::args level (usagemarking.test, 14 tests): pins -parsedargs/-badarg/-scheme marking primitives, goodchoice highlighting of selected and default-in-effect choice words, and scheme border selection - asserted by SGR-parameter subset against the live colour arrays. GAP pins for the documented -scheme choice 'nocolour' falling through to 'na' (renders with the previous scheme's leftover colours) and the dash-spelling '-nocolour' leaking strike-only goodarg into the shared colour array (G-049 candidates). - punk::ns level (cmdhelp.test, 19 tests): pins scheme selection (error scheme on failed parse of supplied args, info scheme + goodarg marking on success), badarg marking via choiceviolation, the early alias-resolution branch, -return string parity, goodchoice highlighting through cmdhelp, and the cmdinfo result shape. GAP pins: pseudo-command cmdtype 'notfound' despite resolved docid + space-form docid exact-word-only jump (G-051; real 'string is true'/'is tr' pins behind the have_tclcoredocs constraint), TclOO undocumented-method class-summary fallback with info-scheme parse of bogus args (G-052), synopsis marking absence and curried-alias braced-target substitution (G-050), explicit -scheme ignored on the parse-failure path and caller-attribution leaking cmdhelp's internal parse source line at top-level call depth (G-049). - punk::ns 0.1.3 (doc-only): cmdhelp 'subcommand' argument help rewritten - was described as ensemble-subcommands-only; now covers tcl::oo methods and argument words, and documents the info/error scheme display driven by argument validity. - Verified: full punk::args + punk::ns suites green on Tcl 9.0.3 and 8.7. Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	5fd3bf9330	runtests.tcl: expose kit-internal lib trees to the testinterp auto_path ... The testinterp replaces auto_path wholesale (project src/lib dirs, root lib_tcl<N>/<arch>, [info library] + parent). Under a kit executable that parent is e.g //zipfs:/app, and tclPkgUnknown scans only an entry plus its immediate children - so kit-bundled packages under //zipfs:/app/lib_tcl<N>/ <pkg> (e.g tcllib's tcl::chan::fifo2, required by the shellrun harness at testinterp setup) were unreachable. Unnoticed in punkshell because the project's own root lib_tcl9/win32-x86_64 carries tcllib2.0; projects without that payload (e.g tomlish) failed every file at 'package require shellrun' when run under a punk kit exe. Now the kit's internal lib/lib_tcl<N> dirs are appended when present, mirroring the internal-path classification in src/vfs/_config/punk_main.tcl: zipfs app mount, tclkit ::tcl::kitpath exe dir-shadow, cookfs //cookit:/ volume (default mount name only, as per punk_main.tcl). No-op under native tclsh. Verified: punk902z + tclsh902z suites pass; classification probed OK under tclkit 8.6.17, punk9cook (cookit), punk91 (zipfs 9.1), native Tcl903; tomlish suite under punk902z/punk91 goes 0 -> 149/149 with the same edit. Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	6d8228c2f8	runtests.tcl: default tcltest -tmpdir to a self-cleaning system-temp dir ... makeFile/makeDirectory output previously landed in the working directory - aborted core exec.test runs littered src/tests with untracked helper files (cat, echo, gorp.file ...). Unless -tcltestoptions supplies -tmpdir, a fresh directory from 'file tempdir' (TMPDIR/TEMP/TMP + pid fallback for tcl 8.6) is configured and deleted before exit; a hard-aborted run now leaves litter in the OS temp area rather than the source tree. Takes effect in single-process mode; multi-process mode still does not forward tcltest options to child processes (pre-existing todo). Contract documented in src/tests/AGENTS.md. Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	87eafd63b0	Tcl 9.1 compat: punk::lib 0.3.1, punk::args 0.3.2 - lseq TIP 746, safe-interp disassemble; project 0.4.12 ... TIP 746 (Tcl 9.1) removed lseq's expr-operand behaviour. punk::lib::range (lseq branch) now normalizes int[+-]int offsets via offset_expr so callers like `range 0 [llength $list]-1` keep working (punk::ansi::grepstr broke under 9.1b0, taking example-block highlighting and the punk::args examples.test with it). The lseq branch is also aligned with the tcl8 fallback contract: default 'by' now infers direction (descending ranges previously returned empty under tcl9) and 'by 0' returns empty (Tcl 9.1 lseq changed by-0 to return one element). Direct lseq expression operands expr-wrapped: punk::lib lzipn_tcl9b/c, cols, cols2; punk::args zero_based_posns. check::has_tclbug_safeinterp_compile falls back to interp invokehidden tcl:unsupported:disassemble - Tcl 9.1 safe interps hide tcl::unsupported::*. New modules/punk/lib range.test pins the range contract on 9.0 and 9.1; core tests AGENTS.md documents native-tclsh vs punk-exe exec.test baselines. Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	4541944928	punk::args rendering/quoting/choicegroups/examples characterization suite; helpers::example [a] fix ... Tests-first coverage pass (user-directed) before any changes to the definition-parsing/indentation machinery. punk/args suite: 128 tests, 15 files. - rendering.test (15): nesting independence (plain + tstr definitions render identically regardless of source-block indentation), relative-indent preservation (2-space help and 1-space choicelabel conventions, single and multiline - preservation, not enforcement), -unindentedfields (arg -help works left-margin; @cmd accepts-but-ignores it - GAP pinned), constructed (string-built) definition absolute-indent characterization ('constructed' to avoid confusion with the @dynamic directive), multiline ${[cmd]}/${$var}/ resolved_def insertions (aligned at insertion column, nesting-independent), and @dynamic ${$DYN_X} double substitution: stable across repeated resolutions, provider refresh honoured in help text, choice display and parse acceptance, textblock::frame-style art choicelabels byte-aligned - but multiline -help insertions land lines 2+ at insertion-4 (GAP pinned: the second-round subst path lacks paramindent re-alignment) - choicegroups.test (5): group/-choices union parsing, cross-group prefixes, duplicate-entry dedup, per-group titled choice tables (the punk::imap4 multi-table display), imap4-style {\Deleted}/{$MDNSent} values with labels incl. through tstr-bearing blocks; GAP pinned: prefix-normalization list-quotes special-character choices (exact '\Deleted' stores the plain string, prefix '\De' stores a one-element list) - value shape depends on input style - defquoting.test (3): container quoting rules pinned - braced values fully literal ($, [], two-char \n, bare backslashes), quoted values get Tcl backslash semantics (\n -> newline, \ -> \) with $/[] still literal, and \$\{...\} renders a literal ${...} in tstr-processed blocks - examples.test (6): helpers::example box/title/-tstr toggle (no-dedent direct-call contract pinned), ${[example ...]} insertion into @cmd help (bars at insertion column, content +2, automatic 'Example: eg <id>' row), @examples -> punk::args::eg with #<nodisplay>/@#<nodisplay> stripping (ANSI-tolerant), strip_nodisplay_lines unit, live tclcore ::lseq smoke - punk::args 0.3.1: helpers::example -title path called bare [a] (resolvable only where a punk shell's global alias exists - errored under plain tclsh); now punk::ansi::a. Found by examples.test in the runtests environment. - investigated punk::ansi::mark_columns first-call slowness (3.94s first, 60us after): argdoc -help calls a proc that calls mark_columns, whose parse resolves the same still-resolving definition - hazard already documented in-source with candidate fixes; recorded in CHANGELOG for goal consideration, deliberately not patched - project 0.4.11 (CHANGELOG entry) Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	850b7f23cc	G-040 achieved: punk::args -choicealiases with shared choiceword_match resolver; doc-lookup parity; punk::help topic collapse ... Activated and completed under user direction (2026-07-08). Aliases for choice values are now first-class: accepted at parse, normalized to their canonical choice in results, folded into the canonical entry in usage display, and resolved identically by the punk::ns doc-lookup walk. - punk::args 0.3.0: * -choicealiases {alias canonical ...} on argument lines; dict shape validated in the option switch, alias->existing-choice and no-collision cross-validated after spec merge (surfaces at resolve time - define is lazy) * the choice-word matching chain extracted from get_dict into the shared resolver punk::args::choiceword_match {word nocase allchoices choicealiases choiceprefix denylist reservelist} -> {matched exact canonical}; get_dict delegates to it (writeback/lset logic stays at the call site) - one implementation for parser and doc walk * exact aliases match under any -choiceprefix/-nocase setting; alias names join the prefix-calculation pool when -choiceprefix is true; deny applies to the matched NAME (denied alias requires the full alias; a canonical reached via its alias is exempt from the canonical's own deny entry) * display: aliases fold into the canonical entry as an '(alias: x)' / '(aliases: x|y)' label note (single convergence point covers all render paths); alias names join the display prefix calculation so highlighted minimal prefixes stay truthful * define doc gains the -choicealiases section - punk::ns 0.1.2: cmd_traverse resolves subcommand words via choiceword_match - -choiceprefixdenylist/-choiceprefixreservelist now honoured in doc lookup (the two pinned parity GAP tests flipped to agreement), aliases normalize before choiceinfo lookup, -nocase honoured in the walk - punk 0.2.3: punk::help adopts the feature - 'i help' lists one entry per registered topic (topics+help, tcl, env+environment, console+term|terminal); topic words accept aliases and unique prefixes with the user-decided minimum-prefix policy recorded in ::punk::helptopic: denylist {help} (h/he/hel stay command words), reservelist {c to tc} (fall through to command lookup; e/en and te/ter fall through naturally as ambiguous). Argless 'help' output byte-identical to the strict-80 baseline. - tests: choices.test +5 (alias exact/prefix normalization, noprefix exact- only, nocase, the punk::help policy matrix, resolve-time validation); cmdflow.test parity tests flipped from GAP to agreement + alias-traverse and display-fold assertions (+flowaliased fixture) - suites: punk/args 98 pass + 1 skip, punk/ns 28 pass, punk/lib 21 pass - G-040 flipped active -> achieved 2026-07-08; detail file records implementation and verification - project 0.4.10 (CHANGELOG entry) Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	48dccbe8c1	G-036 achieved: tcludp thread-exit bug detection (punk::lib 0.3.0 has_libbug_udp_threadexit, surfaced via 'help tcl') ... Completes G-036's remaining acceptance item - version-based detection of the vulnerable combination (tcludp < 1.0.13 on Tcl 9 Windows: the per-thread exit handler closes the process-global sockListLock/waitForSock events, silently freezing every other udp-using thread's event loop after any udp-loaded thread exits; root-caused and fixed-by-upgrade in 0.4.3). - punk::lib 0.3.0: has_libbug_udp_threadexit gathers live facts (loaded udp version, else best available registered version discovered without loading the binary via an unsatisfiable package require triggering the index scan) and delegates the verdict to the pure classifier libbug_udp_threadexit_applies (facts in, verdict out - testable). has_libbug_* is the new check family for bundled/vendored library bugs; buginfo dicts may carry a full 'url' reference key for non tcl-core trackers. - punk 0.2.1: 'help tcl' scans has_libbug_* alongside has_tclbug_*, renders the url key when present, and no longer errors on a triggered check carrying a reference without a description (latent unset-indent fix). - new checkbugs.test: classifier combination matrix, live-check dict shape and classifier consistency, and a buginfo-contract test across all existing check procs. - verified: current kit (udp 1.0.13) reports bug=0 with no warning; a simulated triggered has_libbug_* check renders description + url in the help tcl warning block. Suites: punk/lib 21 pass, punk/ns 26 pass. - G-036 flipped to achieved 2026-07-08 (index acceptance REMAINING annotated DONE; detail file gains the Detection section). Open non-gating decisions recorded in the detail file: punk8win (8.6) kit udp 1.0.12 swap; optional upstream tickets for residual tcludp trunk weaknesses. - project 0.4.7 (CHANGELOG entry) Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	93730dfda7	punk::ns 0.1.1: silence doc-lookup trace puts; -ensembleparameter characterization tests ... - commented out five development trace puts in the doc-lookup machinery: "PROC auto def"/"ENSEMBLE auto def" (generate_autodef) were emitted on STDOUT and polluted 'i'/'s' output in script/exec contexts (agent-facing per the G-015 piped-call pattern); "cmd_traverse - skipping to documented subcommand" (space-form id path), "---> cmd_traverse ensembleparam" (ensemble -parameters traversal) and "cmd_traverse 10 ... - review" (fallthrough return) were stderr noise. No functional change. - cmdflow.test: 8 new tests characterizing ensemble -parameters handling in the doc-lookup flow (the punk::netbox::man pattern - leading apicontextid before the subcommand at every ensemble level): * generate_autodef models each -parameters entry as a -ensembleparameter 1 leader with @leaders min/max = nparams+1 (single- and two-param fixtures) * cmd_traverse consumes parameter words and resolves the subcommand's explicit or autodef docid, re-presenting the parameter in args_remaining so the subcommand's own leader-based definition (as punk::netbox::man's explicit defs model the curried parameter) can parse it * nested sub-ensembles with their own -parameters re-consume the curried parameter at each level * punk::args::parse treats -ensembleparameter leaders as ordinary named leaders; cmdhelp renders a documented subcommand's usage through the parameter (end-to-end smoke) - suites: punk/ns 26 pass (was 18), punk/args 93 pass + 1 skip (unchanged) - project 0.4.6 (CHANGELOG entry) Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	e624bdc057	punk::args 0.2.3: fix @opts -any adhoc option crash; forms + validation test coverage ... - fixed "@opts -any 1" (arbitrary/adhoc option passthrough): an option not in the definition crashed get_dict with "can't read argname" at the name-mapping stage - adhoc opts now fall back to their raw supplied name, under which argstate/arg_checks were already populated at scan time (real consumers: vendored tomlish definitions declare -any 1) - commented out a debug puts stderr (">>>_get_dict_can_assign_value NOT alloc_ok...") that fired on every failed clause type assignment (visible on any multiform parse miss; its happy-path twin was already commented) - new forms.test (8 tests): @form spec structure (form_names, shared {a b}-prologue blocks), explicit -form by name/index with cross-form rejection, multiform synopsis rendering, and GAP pins for G-041 - default parse is effectively form-0-only, -form rejects the documented list-of-forms usage, and @form -synopsis overrides are stored in the spec but ignored by synopsis rendering - new validation.test (11 tests): -type validation matrix, -range/-minsize/ -maxsize, -nocase choice normalization, option -multiple accumulation, required-option enforcement, unknown-option rejection vs -any adhoc passthrough (the bugfix's regression test), -- end-of-options marker, @values -max enforcement, received-key clause ordinals, solos list, and default-vs-received distinction - src/tests/AGENTS.md: note that tcltest compares the -body return value - bodies ending in a loop must end with an explicit 'set result' - suites: punk/args 93 pass + 1 skip (was 70+1), punk/ns 18 pass; full source-tree run 569/581 with only the known exec-14.3 baseline failure - project 0.4.5 (CHANGELOG entry) Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	e45fea9b16	G-040 proposed (punk::args -choicealiases); choice-flow characterization tests; -choice* doc clarifications ... - GOALS.md: G-040 punk::args choice aliasing with parse normalization, display folding, and doc-lookup parity (user-approved); detail file records the prefix/deny/reserve collapse analysis from the punk::help work, the cmd_traverse divergence, the c/to/tc minimum-prefix policy question, and the test-first sequencing - new punk/ns cmdflow.test (10 tests): cmdwhich/cmdinfo/cmd_traverse docid flow - direct, via-alias and subhelp-choiceinfo resolution (exact + unique prefix), unknown-word fallback to parent docid, -choiceprefix 0 exact-only, space-delimited ids, cmdhelp -return string smoke; the parse-vs-doc-walk divergence (deny/reserve lists honoured by punk::args::parse, ignored by the cmd_traverse walk) pinned as GAP tests pending G-040 - choices.test: 4 new unrestricted-mode (-choicerestricted 0) tests - prefix normalization to the canonical choice, unknown/ambiguous passthrough, denylist and reservelist passthrough, and the punk::help collapse recipe (prefix+deny+reserve on a -multiple leader) - punk::args 0.2.2 (doc-only): define doc -choice* fields now state the -choicerestricted 0 passthrough semantics, -choiceprefix result normalization + minimal-prefix display highlighting, denylist behaviour for shorter prefixes in both restricted modes, and the reservelist phantom-entry idiom for per-choice minimum-prefix control - suites: punk/args 74 pass + 1 skip (was 70+1), punk/ns 18 pass (was 8) Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	5d25e2d972	shadowing pin-tests for tm tie-break rules; goal G-035 mixed-provision ... New suite src/tests/modules/punk/libunknown/testsuites/shadowing/ (7 tests, all pass) pins the .tm same-version shadowing rules verified experimentally 2026-07-06/07: tcl:™️:add PREPENDS each argument (last arg ends at the head of tcl:™️:list); the head of tcl:™️:list wins exact-version ties (single and separate add calls); a higher version wins from any position (order only arbitrates exact ties); and punk::libunknown preserves all of it (scanner parity). Shipped behaviour depends on these rules - the runtests testinterp tm ordering (bootsupport over vendormodules) and punk_main''s package-mode block precedence that G-033''s proj:/kit-first design builds on - so a Tcl or libunknown change that shifts the tie-break now goes red here instead of silently mis-resolving. Goal G-035 (proposed): characterise mixed .tm / pkgIndex.tcl provision of the same package - same or differing versions, under standard package unknown, punk::libunknown and punk::packagepreference, across scan-trigger orderings, forget/re-require crossing forms, and 8.6/9. Converts the standing informal rule ("avoid mixing provision forms for one package - unexpected behaviour even with libunknown''s improvements") from folklore into either substantiated AGENTS.md guidance with named failure modes, or retirement if mixing proves predictable. Discovery work, so goal-specified rather than written now; extends the shadowing suite when implemented. Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	25e45e0cce	tests: scriptexec.test for the script subcommand; scriptlib/_punktest fixtures ... Adds src/tests/shell/testsuites/punkexe/scriptexec.test (12 tests, all pass) covering app-punkscript / the script subcommand (G-015): piped execution and honest exit codes, error->exit 1, exitcode propagation, stdin result echo, default-env dev alias present without boilerplate, file-form argv passing, the lib:<name> scriptlib mechanism (subpath, extensionless, bare-arg reclassification, not-found location listing), and the tclsh-matching Tk main-loop behaviour (0.4.1): a serviced after-callback runs and exits, a no-exit GUI script stays alive, an errored GUI script exits promptly without hanging. Reuses the shellexit.test built-exe harness pattern (pipe stdin, half-close for EOF, timeout+force-kill) so runs are hang-proof; Tk cases gated by an auto-detected punktk constraint (probes whether the kit loads Tk). Full shell suite: 19 pass / 2 skip (console-only punkgoals) / 0 fail. lib:/Tk cases resolve committed fixtures under scriptlib/_punktest/ - a lib:-resolvable fixture cannot live in a tcltest temp dir since resolution only searches scriptlib locations relative to the exe. The subfolder is test-owned (README + do-not-edit fixture headers); root AGENTS.md carves it out as the one agent-manageable exception to scriptlib being user-only. No project version bump - tests/docs/fixtures only, no shipped shell behaviour change. Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	6d01b6e93b	shellfilter 0.2.3: survive infra errors in run; runtests tm order + Thread path ... shellfilter::run now wraps everything between tee-stack add and removal in try/finally so the callers stdout/stderr are always restored, and the decorative stack-status table rendering in log::critical blocks is catch-guarded. Previously an error there aborted the run after diverting the channels and before restoring them, leaving process stdout/stderr broken with all subsequent output silently lost - observed when a stale same-version textblock snapshot (old option-value syntax) called the new punk::ansi sgr_merge_singles inside the stack-status render during tomlish test runs. runtests.tcl: - testinterp tm path order: bootsupport moved to last test_tmlist element so it wins same-version module ties over vendormodules. Rules verified experimentally on Tcl 9.0.3 (identical under standard package unknown and punk::libunknown): tcl:™️:add prepends each argument, head of tcl:™️:list wins same-version ties, so the last element of a single-call add list wins. - testinterp auto_path gains the parent of [info library] so binary packages such as Thread (needed by shellrun) resolve in projects without a root lib_tcl<N>/<arch> payload. Project version 0.2.6. Verified: full shellspy suite at baseline (517 pass / exec-14.3 known); tomlish ported suite 184/184; reconstructed stale-module scenario now completes with captured results and live stdout instead of silent loss. Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	d88e1c1759	punkboot::utils 0.1.1: move vendorupdate dirty-checkout check into module ... Move vendor_source_dirty_warnings out of make.tcl into punkboot::utils as vcs_dirty_warnings (PUNKARGS-documented, caller-label param so the bootsupport update path can share it per G-026). make.tcl now uses a guarded lazy require and degrades to skipped-with-warning if the bootsupport snapshot lacks the proc - a stale/broken snapshot must never brick the make.tcl commands used to repair it. Chicken-and-egg-safe ordering used and now documented in src/bootsupport/AGENTS.md ("Moving make.tcl functionality into punkboot::utils"): edit src module + bump buildversion, make.tcl modules, make.tcl bootsupport, only then repoint make.tcl call sites. Boot-phase code (path setup, punkboot::lib prompts, package-availability checks) stays self-contained in make.tcl. Bootsupport snapshot refresh from the sanctioned pipeline: punkboot::utils 0.1.0->0.1.1, shellrun 0.1.2->0.1.4 (punk::args require fix catch-up), punk::console 0.7.1 content catch-up; layout mirrors via the punkcheck-tracked sync steps. New tests: src/tests/modules/punkboot/utils/testsuites/utils/vcsdirty.test (git fixture: dirty/clean/dedupe/label/unversioned/missing) - 25/25 across punkboot suites; vendorupdate verified end-to-end through the module path. Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	330ae00de3	G-022 fossil rename goal + move/rename characterization tests; fix shellrun ... Goal G-022: scriptable safe fossil move/rename in dev repo (all checkouts repointed, no phantom central config-db entries, no dangling old repo db, project-name renamable with project-code preserved), then rename this project fossil repo shellspy -> punkshell through that mechanism via a G-015 piped script call. New tests src/tests/modules/punk/mix/testsuites/repo/fossilmove.test pin current behaviour in a FOSSIL_HOME-isolated sandbox with an isolation guard: the file-copy + fossil test-move-repository sequence repoints the checkout but leaves the old db file on disk, a phantom repo: entry in the central config-db, and a stale ckout: back-reference; file moves never touch project-name. GAP-marked tests flip when G-022 lands. shellrun 0.1.4: add missing package require punk::args - the 0.1.3 migration left run/runout/runerr/runx calling punk::args::parse without requiring it, which broke shellrun in bare interps and made every src/tests/runtests.tcl run fail at test-file invocation. Full suite now back to baseline (523 tests: 508 pass, 14 skip, exec-14.3 known failure). Project version 0.2.4 (changelog entry for the shellrun fix). Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	28106ac4b2	punk::console 0.7.1: idle-reader hostage guard - fail fast instead of timeout + phantom input ... On a tcl 8.6 windows console in cooked (line) mode with a readable handler armed on stdin - the idle-at-a-line-mode-prompt condition, e.g. a query fired from an after-script or worker thread while the shell waits for input - the 8.6 channel driver has a blocking cooked-mode ReadConsole parked (arming posts it; driver reads sample the console mode at issue time), so a terminal query's response is swallowed until Enter and then leaks to the line reader as phantom input. This is the one remaining hostage window after the 0.7.1 detection fixes and repl 0.2.2 read discipline: it is the reader legitimately doing its job, so no repl-side change can remove it (and line mode remains supported for user scripts/mini-apps even once raw becomes the default). get_ansi_response_payload now detects the condition before emitting (cooked + no -inputmode key + twapi console handle + armed readable handler) and refuses fast with errorcode {PUNK CONSOLE QUERY HOSTAGE_COOKED_READ} - no emission, no ~500ms timeout, no input corruption. Mid-command queries (repl reader disarmed) and raw mode are unaffected. Best-effort by design: a parked read can outlive a removed handler, so the guard catches the systematic case only. The G-007 routing wrapper now preserves the owner-side errorcode so brokered callers can discriminate the refusal. Tests: constraint-gated guard test in probes.test (engages on a real 8.6 console, self-skips on 8.7/9 via the -inputmode key and in piped runs); ownerrouting.test passes with the errorcode-preserving wrapper. Full suite at baseline (exec-14.3 only) under Tcl 9.0.3; probes suite also verified under Tcl 8.6. Project version bumped to 0.2.2 with CHANGELOG entry per the versioning policy (user-visible failure-mode change). Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	4 weeks ago
Julian Noble	c8072d7945	Extract punkboot::utils module + tests, bump project to 0.2.1 ... Move project-version helper procs (parse_punkproject_version, read_punkproject_version, read_changelog_latest_version) out of make.tcl inline definitions into a loadable punkboot::utils module so the parsing logic is unit-testable. - src/modules/punkboot/utils-999999.0a1.0.tm: new module (0.1.0) with the 3 procs in punkboot::utils namespace, PUNKARGS argdoc blocks. - src/modules/punkboot/utils-buildversion.txt: initial 0.1.0. - src/tests/modules/punkboot/utils/testsuites/utils/utils.test: 19 tests covering section tracking, missing fields, wrong sections, whitespace, quote styles, changelog header parsing, pre-release suffixes. All pass. - src/make.tcl: inline procs removed; projectversion block now does package require punkboot::utils and calls punkboot::utils:: procs. - Layout make.tcl files (punk.shell-0.1, punk.project-0.1): same edit; punk.basic keeps inline procs (no bootsupport tree). - include_modules.config: added punkboot::utils entry (main + 2 layouts). - Bootsupport snapshots propagated via make.tcl bootsupport. - AGENTS.md: project version bump 0.2.0 -> 0.2.1 (patch: new make.tcl projectversion subcommand is part of the product surface); added clarifying line that make.tcl command interface warrants at least a patch bump; src/project_layouts/ added to directories agents should not directly modify. - CHANGELOG.md: 0.2.1 entry. Assisted-by: harness=opencode; primary-model=openrouter/z-ai/glm-5.2; api-location=openrouter.ai	4 weeks ago
Julian Noble	d68d4d4f26	punk::console 0.7.1: ensure_object_integration hardening - graceful no-op + catch-up ownership registration ... Two wiring-order holes surfaced during the G-007 interactive verification: 1. Calling ensure_object_integration before opunk::console is loaded errored into the nonexistent namespace (can't set "::opunk::console:: waiting_chunks_arrayvar": parent namespace doesn't exist). It now returns 0 as a graceful no-op without latching object_integration_done, so a later call after opunk::console loads still performs the wiring; the wired/latched path returns 1. 2. 'package require opunk::console; opunk::console::create ...' with no intervening punk::console object operation left the created console without a registered owner: the lifecycle callback that records ownership is only installed by ensure_object_integration, which is wired lazily from punk::console's object-spec paths. Behaviour was unaffected for the owning thread (share qualifiers fall back to the calling thread) but other threads could not address that console's facts. On wiring the callback, ensure_object_integration now retro-registers ownership for anchors already present in the interp - anchors are per-interp/per-thread so the anchoring context is the calling thread. Only empty registry entries are filled; existing live registrations are preserved (and the default console keeps first-registration-wins semantics). Tests: new objectintegration.test covers the no-op return (unlatched), retro-registration of a pre-wiring anchor with lifecycle forget clearing the entry, idempotency of the latched path, and normal post-wiring registration - passing under Tcl 9.0.3 and 8.6. Full suite at baseline (exec-14.3 only). Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	4 weeks ago
Julian Noble	528d1eca72	punk::console 0.7.1: fix tcl 8.6 windows console misdetection - one root cause, three sites ... Tcl 8.6 windows console channels expose no -inputmode configure key, so punk::console guards testing -inputmode/-mode classified a real 8.6 console as a pipe. A twapi console handle for stdin is now treated as definitive console detection at all three affected sites (stdin only - pipe probes still never touch the process console; mintty-as-pipes has no console handle and falls through to the env heuristics as before): 1. get_ansi_response_payload's raw-cycling gate (introduced 0.1.5) skipped the raw cycle for 8.6 line-mode queries. 2. is_input_console_or_tty returned a false negative, making settle_can_respond's layer-2 heuristic settle a real 8.6 console as unable to respond. 3. input_at_eof (introduced 0.1.2) took the pipe branch and performed its probe read on the drained console channel. This was the line-mode query killer: verified empirically against clean tclkits 8.6.13 and 8.6.17, a read on a drained 8.6 console channel makes the channel driver park a blocking cooked-mode ReadConsole; driver reads sample the console mode when issued, not when data arrives, so the query's subsequent raw flip cannot rescue it and the terminal response is swallowed until Enter. Since get_ansi_response_payload calls input_at_eof immediately before its raw cycle, every 8.6 line-mode query timed out (~500ms) with the response later leaking to the line reader as phantom input - also the source of increased ANSI artifacts (e.g. 'help env') once 0.7.0 brokering made code-interp queries actually reach the terminal. Interactively verified on punksys (tcl 8.6.13, src launch): line-mode get_cursor_pos and dec_get_mode succeed mid-command, brokered query loops run clean, and typed-ahead lines are recovered without phantom input. Known residue (documented in the G-007 detail notes): queries fired while the repl reader is armed and idle at a line-mode prompt (including some repl-init detection queries) still hit the parked-read limitation on 8.6 - repl init ordering is a follow-up; raw mode is unaffected. Tests: probes.test gains constraint-gated wiring tests for the twapi console branch of is_input_console_or_tty and input_at_eof (skip in piped runs, engage on a real console). Full suite passes at baseline (exec-14.3 only) under Tcl 9.0.3; probes suite also verified under Tcl 8.6. Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	4 weeks ago
Julian Noble	6314312aa4	punk::console 0.7.0: G-007 slice 2 - choke-point brokering of terminal queries to the console-owning thread ... A terminal query (internal::get_ansi_response_payload and every query proc layered above it - get_cursor_pos, dec_get_mode, ...) on the process-default console {stdin stdout} issued by a thread that is not the registered owner is now forwarded whole to the owning thread via synchronous thread::send, so the query queueing, raw-mode cycling, cooperative reader handling (input_chunks_waiting) and settled can_respond gating all execute in the owner's context. Owner-side errors propagate to the caller with routing context. Routing happens before the local can_respond gate deliberately: a non-owner context's anchored view of the default console may be unsettled while the owner's is settled. New internal::console_route_owner makes the decision: routing applies to the default console pair only - non-std channel names are thread-local, so an {in out} pair spec always names the calling thread's own console and operates locally (a console constructed and owned by code-interp/worker code round-trips nowhere). Unregistered, owner==caller and dead-owner (liveness-validated) cases also operate locally, preserving single-interp behaviour exactly. The synchronous send relies on the owner servicing events while the caller blocks - the property the repl-installed vt52/colour/mode aliases already depend on. Those aliases are unaffected: a call arriving in the owner resolves to owner==self and takes the local path, so no double-hop and no ping-pong. Tests: new ownerrouting.test covers the routing decision (unregistered/self/ other-live-thread/non-default-pair/dead-owner) and the transport (recorder in a worker-thread owner: args marshalled intact, execution in the owner thread, query procs above the choke point inherit the routing, owner-side error propagation). Full suite passes (baseline exec-14.3 only). G-007 remains active: the remaining acceptance verification is interactive - a terminal query from a live punk session's code interp against the default console (cooperating with the repl reader), which needs a real responding terminal. Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	4 weeks ago
Julian Noble	aca967e1a5	punk::console 0.6.0: G-007 slice 1 - tsv-backed console facts + ownership registry ... Per-console facts are now visible to every thread of a punk session: the default console {stdin stdout} keeps its legacy namespace variables as authoritative local storage, with write traces mirroring every write (including direct variable writes) into tsv punk_console_facts; non-default consoles store facts only in tsv with owner-qualified keys (non-std channel names are thread-local and would otherwise alias). console_fact_set from a non-owner thread forwards to the owning thread (vt52-alias transport) and always writes the tsv mirror itself (covers unreachable or older-version owners). New console_fact_clear for tests/maintenance. New console ownership registry (console_owner_register/get/forget, tsv punk_console_owners keyed by canonical {in out} pair): ownership is captured when an opunk::console instance is anchored - via the new pluggable ::opunk::console::lifecycle_callback (opunk::console 0.4.0, base class unchanged) wired by ensure_object_integration - and by default_console. Consult-time liveness validation clears entries for exited threads. For {stdin stdout} first registration wins and only the owner's forget releases the entry, so a thread anchoring a local view cannot steal ownership. dec_has_mode/ansi_has_mode caches moved to tsv punk_console_modecache (single-key atomic entries shared process-wide). Infrastructure tsv arrays are now punk_-prefixed to avoid collisions with application tsv usage in subshells: console -> punk_console (is_raw), with call-site patches in punk::repl 0.2.1, punk::lib 0.2.1, punk::basictelnet 0.1.1 (rule recorded in src/modules/AGENTS.md; legacy repl/codethread_*/ zzzload_pkg* arrays left for a coordinated follow-up). punk::console is now loadable in secondary threads without ::argv0 (powershell consolemode fallback guarded). Tests: consolefacts gains ownership-registry and cross-thread visibility coverage (worker-thread punk::console load, trace-mirror, forwarded set with deadline-polled sync - see comments re runtests child-interp topology); cleanups use console_fact_clear / tsv instead of poking removed internal stores. Full suite passes (baseline exec-14.3 only). G-007 flipped proposed -> active (user-confirmed); remaining acceptance work is the choke-point brokering slice. Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	4 weeks ago
Julian Noble	e2e142faa2	punk::console 0.5.0: -console migration complete - remaining query procs converted to hybrid pattern ... Migration plan phase 4 (final phase): - get_cursor_pos, get_cursor_pos_list, get_checksum_rect, get_device_status, get_device_attributes, get_device_attributes_tertiary, get_terminal_id, get_tabstops, get_tabstop_apparent_width, get_dimensions, get_xterm_size, get_xterm_pixels, dec_get_mode_line_wrap and ansi_get_mode_LNM accept -console <consolespec> (any spec form) or the legacy trailing positional, parsed by new internal::hybrid_console_spec; each carries a PUNKARGS definition (@leaders per the Argument Order rule) - get_size refactored onto internal::hybrid_console_spec (behaviour unchanged) - documentation-only PUNKARGS for input_at_eof, is_input_console_or_tty, size_via_query_mechanisms, console_size_provider and the get_size_using_* mechanism helpers (signatures unchanged - internal size mechanisms remain canonical-pair only, per the updated AGENTS.md contract) AGENTS.md migration bullet rewritten from 'incrementally migrating' to the completed-state contract. New queryprocs.test (6 tests, fed-response coverage for every converted proc across spec forms); full console suite 58/58 on Tcl 9.0.3. Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	4 weeks ago
Julian Noble	3a85fa85f5	punk::console 0.4.0: mode setters resolve console specs, -minsize 2 removed, mode caches canonicalised ... Migration plan phase 1: - dec_set_mode/dec_unset_mode/ansi_set_mode/ansi_unset_mode and cursor_style resolve -console via console_spec_resolve instead of '[lindex $terminal 1]' - anchored opunk::console instance names and ::opunk::Console object values now work (previously silently wrote to the wrong target) - the fourteen '-console -type list -minsize 2' declarations replaced with new shared fragment ::punk::console::argdoc::console_opts (the -minsize 2 constraint rejected 1-element instance-name specs at parse time); show_input_response and cell_size -console docs unified on the fragment - dec_has_mode/ansi_has_mode cache on the canonical {in out} pair - all spec forms addressing the same console share one cache entry - test_is_vt52 option -inoutchannels renamed to -console per the documented convention (experimental/broken proc, no callers) - set/unset mode argdocs corrected: <codes> are semicolon delimited AGENTS.md records the fragment usage and the -minsize 2 prohibition. 3 new tests in consolespec.test (setter spec forms, cache canonicalisation via mixed specs, test_is_vt52 -console); full console suite 52/52 on Tcl 9.0.3. Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	4 weeks ago
Julian Noble	bf8aa4c80d	punk::console 0.3.0: emit-side -console targeting + per-console facts ... 0.2.0 (emit-side console targeting, migration plan phase 2): - punk::console::ansi::* emit functions, mouse/paste toggles, start_application_mode, vt52, set_tabstop_width, titleset, top-level move, test_char_width and test_string_cursor accept an optional trailing '-console <consolespec>' (channel pair, anchored opunk::console instance name, or ::opunk::Console object value), parsed by new internal::opt_console_out/opt_console_channels helpers (+_var variants for triple-tail procs); documentation via shared PUNKARGS fragment ::punk::console::argdoc::console_emit_opts - fallback chains keep the console spec (get_tabstop_apparent_width -> test_char_width; set_tabstop_width -> get_size) - move_call_return now actually emits its cursor moves (previously discarded the string-returning ansi::move results) - get_size_using_cursorrestore uses string-returning punk::ansi::cursor_on (was emitting to stdout mid-sequence) 0.3.0 (per-console facts, migration plan phase 3): - is_vt52, tabwidth, cell_size, last_da1_result, grapheme_cluster_support and check::has_bug_* keyed by canonical {in out} pair via console_fact_get/console_fact_set; the default console {stdin stdout} stores facts in the legacy namespace variables so external readers (punk::repl, textblock, overtype, punk::ansi, punk::ns) are unaffected - vt52 state, size_via_query_mechanisms, get_cursor_pos and all vt52-aware emit wrappers consult the spec'd console's is_vt52 fact - grapheme_cluster_support and check::has_bug_* accept -console; TERM_PROGRAM shortcut restricted to the default console - check::has_bug_zwsp: cached-true path no longer errors; query verdicts are now actually cached - ansi_wanted/colour_disabled, ansi_available and raw-mode state deliberately remain process-global (documented at the store) PUNKARGS definitions follow the new Argument Order rule (@leaders for leading positionals); internal helpers carry documentation-only definitions. New suites: emitconsole.test (13) + consolefacts.test (9); full console suite 49/49 on Tcl 9.0.3. Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	4 weeks ago
Julian Noble	ea5171ae78	AGENTS: strengthen PUNKARGS documentation rules + add argument order guidance + interp_sync tests ... Root AGENTS.md closeout now includes a step to re-check modified .tm files for new procs lacking PUNKARGS argdoc blocks. src/modules/AGENTS.md Work Guidance explicitly requires argdoc blocks for all new procs in .tm files (documentation-only is acceptable). The Documentation section clarifies that 'user-facing' includes developer-facing utility procs. A new 'Argument Order In PUNKARGS' section explains the distinction between @leaders, @opts, and @values and why putting a leading argument in @values produces an incorrect synopsis. Verification section adds a check for PUNKARGS argdoc blocks on new procs. The interp_sync.test file contains 6 tcltest tests for the new punk::lib helper procs.	4 weeks ago
Julian Noble	4dc93b12b9	runtests.tcl: pass project_root to tm_path_additional_ifneeded + fix modules_tcl copy-paste bug + zipper #modpod verification test ... Both tm_path_additional_ifneeded call sites now pass \ as required by the 0.3.0 API. The second call site also passed the wrong path (../modules instead of ../modules_tcl\) due to a copy-paste bug, so Tcl-major-specific #modpod modules were never scanned. Added a zipper #modpod verification test that confirms package require zipper resolves to the 999999.0a1.0 #modpod version via the ifneeded mechanism and that initialize/addentry/finalize work correctly. All 4 tests pass under tclsh90.	4 weeks ago
Julian Noble	98d75d0716	runtests.tcl: surface full error messages and actual-vs-expected results in failure reports ... runtests_failure_summaries now includes errorinfo, result_was, and result_expected when present in the parsed testdict, so the json report (which iterates keys) and downstream consumers get the full failure context. runtests_print_failure_details prints an errorInfo fenced block for ERROR-status failures and result_was/result_expected fenced blocks for FAILED-status mismatches, with full multi-line text. The compact report appends one-line truncated message=, actual=, and expected= fields (120/80/80 chars) so compact mode stays compact while still being actionable for agents. src/tests/AGENTS.md Local Contracts and Work Guidance updated to document the new failure-detail surfacing.	4 weeks ago
Julian Noble	ed7ed009b4	superseded-module pruning with punkcheck DELETE events + virtual version sources ... Resolves the build-maintenance TODO: built module trees no longer accumulate superseded intermediate versions, and .punkcheck state stays consistent because every deletion is recorded through punkcheck's event mechanism. punkcheck (0.3.0): - installsource_add_virtual + installevent method targetset_addsource_virtual: 'virtual' named-value SOURCE records (-type virtual -path virtual:<id> -value <v>) compared by stored value, participating in targetset_source_changes. Needed because successive module versions are built from the same physical source files - the recorded virtual module_name/module_version identify which product of the source fileset a target is, at install and delete time. punk::mix::cli (0.5.0): - lib::prune_superseded_target_modules: deletes lower-version .tm siblings only when records prove the same module line (virtual module_name match, or legacy fallback: recorded sources share the keep-version's source folder(s) and name prefix). Unrecorded files are never deleted - reported to stderr instead. - lib::prune_sourcevanished_targets: mirror-prune of recorded targets whose recorded source files no longer exist (layout bootsupport copies, vendormodule copies) - intentional multi-version vendoring is preserved. - build_modules_from_source_to_base prunes after each module install/skip and records virtual module identity sources on installs. make.tcl: - bootsupport: non-glob include_modules.config entries track only the latest version - superseded recorded snapshot versions pruned; project-layout copies mirror-pruned; virtual identity recorded on snapshot installs. Calls guarded (info commands) so a stale bootsupport snapshot degrades to a warning and the two-pass modules+bootsupport bootstrap self-heals. - vendormodule copies in root modules*/ mirror-pruned after install. docs/config: - include_modules.config headers now document the entry format (non-glob = latest-only + prune; glob chars = keep all matches; unrecorded never pruned) - src/AGENTS.md TODO replaced with the durable prune contract; src/bootsupport/AGENTS.md + src/tests/modules/AGENTS.md updated tests: src/tests/modules/punk/mix/testsuites/cli/prune.test (19 tests) covering virtual source recording/comparison and prune identity/safety rules. Suites: punkcheck 64/64, full suite under Tcl 9.0.3 green except pre-existing exec-14.3. payload sync: bootsupport snapshots, project layouts and _vfscommon.vfs pruned of superseded intermediates (~570k lines of stale .tm copies removed). Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	4 weeks ago
Julian Noble	c5f17a6447	size mechanisms as overridable Console methods (subclass dispatch from punk::console) ... opunk::console (0.3.0): - base size method resolution order: -winsize fast path -> capability gate (settled or heuristic can_respond; unresponsive consoles get default_size with no query emission) -> pluggable ::opunk::console::size_query_provider -> default_size. The provider hook follows the waiting-store pattern: the class carries no punk::console dependency, and non-channel subclasses (tk widget / channel-environment terminals) simply override size. punk::console (0.1.7): - get_size dispatches object-governed calls through the virtual ::opunk::Console::size method after first-use settling - subclass size overrides are honoured from every punk::console call site - ANSI/tput mechanisms + per-pair timing cache factored into size_via_query_mechanisms, shared by the legacy channel-pair path and the registered provider (console_size_provider) - integration wiring consolidated into once-latched ensure_object_integration (probe-byte store redirect + provider registration, respecting customised providers), invoked from default_console, console_spec_resolve lazy-require sites and the get_size object path - legacy path returns the documented 80x24 fallback instead of erroring when undetermined tests: WidgetishConsole subclass override returned through punk::console::get_size for both anchored-name and object-value specs; class-level provider consultation/capability-gating with a counting fake provider; provider registration assert. Console suites 27/27 + 10/10; punkexe 6/6, goals 8/8; full suite green except pre-existing exec-14.3. Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	4 weeks ago
Julian Noble	c6ead68a89	probe-byte store unification + first-use settling for all query paths ... opunk::console (0.2.0): - probe-byte waiting store changed from dict to array (::opunk::console::waiting_chunks) and made pluggable via waiting_chunks_arrayvar: integrating layers redirect it to their established cooperative store so bytes consumed by opunk::Console probe reads stay visible to active readers. The class remains free of punk::console dependencies - redirection is the integrator's act. punk::console (0.1.6): - default_console redirects the opunk::console store to punk::console::input_chunks_waiting (closing the split-store hazard that previously made opunk-level probes invisible to the punk repl reader) - get_ansi_response_payload performs first-use active settling for persistable console specs, guarded by a recursion latch around settle_can_respond's own probe: every query path (get_cursor_pos, get_device_status, ...) now pays at most one settling probe instead of a fresh timeout per call on unsettled ambiguous consoles punk::repl (0.1.6): - repl::init routes default console construction through punk::console::default_console (deduplicates creation logic and gains the store unification) tests: store-unification and get_cursor_pos first-use settling cases in consolespec.test (zero-emission and persistence asserts); consoleclass.test store assertions converted to array form. Console suites 25/25 + 9/9; punkexe 6/6, goals 8/8; full suite green except pre-existing exec-14.3. Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	4 weeks ago
Julian Noble	f6ed50eb0c	punk::console active settling probe (settle_can_respond) + raw-mode cycling guard ... punk::console (0.1.5): - settle_can_respond: layered active settling of a console's response capability, persisted on the anchored opunk::console instance. Layer 1 certainty (input eof -> 0, no emission), layer 2 strong-negative heuristic (plain pipe, no terminal hints -> 0, no emission - piped/CI output streams stay clean), layer 3 active CSI 6n probe with timeout, only in the ambiguous zone (real consoles / pipe-presenting terminals such as mintty without winpty). -force unsettles and re-probes; -timeout_ms overrides can_respond_probe_timeout_ms (default 500). Unmatched input consumed while waiting is preserved via input_chunks_waiting. - get_size triggers first-use settling for persistable specs only (anchored instance name or the auto-attached default) so unanchored object values cannot cause per-call probes - get_ansi_response_payload only cycles console raw mode when the input channel is a console/tty: pipe-targeted probes no longer flip the real console's mode as a side effect, and a repeat-cycle deadlock under captured-channel environments (runtests runx) is fixed. (Latent enableRaw_twapi/disableRaw_twapi restore asymmetry noted for future attention.) punk::repl (0.1.5) / opunk::console (0.1.1): docs reference the active settling mechanism (no behaviour change; probe machinery stays in punk::console so the class remains free of that dependency) tests: 5 new settle_can_respond cases in consolespec.test - certainty and clean-pipe settling with zero-emission asserts, ambiguous probe timeout with emission and input-preservation asserts, response arrival settling 1 with realistic event-loop delivery then -force transition to 0, and get_size first-use settling. Console suites 23/23; full suite green except pre-existing exec-14.3. Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	4 weeks ago
Julian Noble	f0c712543a	repl shutdown/eof fixes, PUNK_PIPE_EOF policy, console query guards, opunk::console voo class, test framework fixes ... punk::repl (0.1.4): - cancel the deferred (after idle) stdin reader registration when the repl finishes - a stale registration could re-attach a reader to a completed repl (piped stdin racing shutdown produced 'error2 in repl_process_data: invalid thread handle ""') - repl_process_data drops input arriving after codethread teardown instead of erroring - repl::init constructs the process-default console object (anchored opunk::console instance 'default') and settles can_respond 1 for interactive stdin app-punkshell: - eof on the input channel now follows env(PUNK_PIPE_EOF): exit | interactive | unset=heuristic (reopen console if available, else terminate) - replaces the unconditional CONIN$/dev-tty repl restart that hung automated callers forever; documented in punk::config punk_env_vars_config ('help env') punk::console (0.1.4): - input_at_eof (certainty, with non-blocking probe read for deferred pipe eof) and is_input_console_or_tty (heuristic incl. mintty-without-winpty env hints) - get_size skips ANSI cursor-report mechanisms for non-terminal input (tput then 80x24 default) - removed erroneous repl-restart attempts from get_ansi_response_payload eof handling (re-entrancy, bypassed eof policy; one call was a typo repl::reopen) - console_spec_resolve: -console (and legacy positional inoutchannels) accepts a channel pair, an anchored opunk::console instance name, or an ::opunk::Console object value; settled can_respond 0 refuses query emission and supplies the object's default size; default_console proc + auto-attach of the anchored 'default' instance for matching channel pairs opunk::console (new, 0.1.0): - voo-based -virtual class ::opunk::Console: console as an in/out channel pair with settled capability facts; canonical instances anchored at ::opunk::console::instances::<name> with value semantics as snapshots; subclass dispatch via slot-0 tag for future channel-environment consoles (ssh, tk-widget terminals); added to bootsupport (with voo) for boot-level use tests: - src/tests/shell/testsuites/punkexe: hang-proof punk_run/punk_run_expect_alive harness; termination guards, exitcode propagation, help-env render with piped stdin, default-console smoke test, PUNK_TEST_GOALS-gated interactive drop-in goal tests - src/tests/modules/punk/console: probe helper and console-spec/integration suites - src/tests/modules/opunk/console: Console class suite incl. virtual dispatch - runtests.tcl testinterp: 'package prefer latest' (dev 999999 alpha modules no longer shadowed by stable bootsupport copies) and src/vendormodules on the module path (voo etc resolvable) AGENTS: punk::args usage policy, -console migration contract, bootsupport update workflow correction, opunk voo conventions, testinterp contracts Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	4 weeks ago
Julian Noble	df78ff9bb5	make.tcl bootstrapping fix, punkcheck refactor and tests	4 weeks ago
Julian Noble	0455efd614	startup behaviour,punk::path fixes, AGENTS guidance	4 weeks ago
Julian Noble	43e9aee128	cleaner src/tests/runtests.tcl output for agents based on new -report option etc	1 month ago
Julian Noble	7fd42ff68c	src/tests framework	1 month ago