Tree: 269b1af82b

master

v0.1a

Branches Tags

${ item.name }

Create tag ${ searchTerm }

Create branch ${ searchTerm }

from '269b1af82b'

${ noResults }

Commit Graph

12 Commits (269b1af82b6c37e6df5d3939bdb5acc2a6ef292e)

Author	SHA1	Message	Date
Julian Noble	bc958300b1	G-093 rework: punk::path *** pathglob + separable lattice; runtests passthrough targeting ... User-approved contract amendment replacing the day-1 file-relpath filter: one directory-oriented pathglob semantics at every layer, with the ergonomics gap closed in the syntax itself. punk::path 0.4.0: - *** as a whole segment matches ZERO or more segments (join-aware regex in pathglob_as_re: an adjacent separator is absorbed into an optional group), so X/*** = X and everything below - the subtree spelling; ***/f.txt matches at any depth including the root. - include separability fix: an exact or single-segment-glob full match no longer sets allbelow (the deep walk previously dragged the whole subtree in for X and X/* patterns; the zipfs walk was already separable). - exclude separability fix (new exclude_state classifier, both walks): only **|***-tail patterns prune the matched subtree; other matches exclude just that directory's files - the **/_aside vs **/_aside/** argdoc distinction is now real. Dead _path_matches_any removed. - legacy bare-* include collapse removed (a * in -include-paths is the one-below lattice form, not a match-everything alias; no caller used it). - globmatchpath default-nocase driveletter exception rewritten as a direct regex-head rewrite (the regex-text file-split broke on c:/***'s glued group and accepted non-alpha drives). - path.test +5 lattice/*** pins (40 total). runtests.tcl: - -include-paths/-exclude-paths pass through to treefilenames unchanged; argdocs teach the separable X | X/* | X/** | X/*** lattice; directory and file-name axes independent (tails); single-file targeting = exact dir pattern + file tail. - -serial-paths reconciled to the same directory-of-file reading (default now modules/punk/console/*** modules/opunk/console/*** via runtests_discovery::dir_matches_any) - the pre-existing file-path serial matching was the other same-option-different-referent divergence. - per-pattern zero-match stderr advisory (the X/**-for-subtree foot-gun points at X/***). - json report emitter: whitespace-padded entier-looking values now take the quoted-escaped path ('string is entier -strict' accepts surrounding whitespace - a failed test's "0\n" result_was embedded a raw newline and truncated the parseable report line). - testsupport/discovery.tcl now a thin passthrough (requires punk::path 0.4.0-); pathdiscovery.test rewritten to the directory-semantics contract (22 tests incl. the X/** zero-match advisory characterization); AGENTS.md targeting guidance swept to /*** across src/tests and src/modules/opunk. Verification (native tclsh 9.0.3, piped, serialized): 45-probe matrix, path suite 40/40, runner suite 22/22; vs the pre-G-093 baseline the default discovery FILE SET differs by exactly the added runner suite and result parity only by the five new path tests (+ that suite); mode parity -jobs 16 vs singleproc: PARITY ok (94/1037/failed=1 exec-14.3). Goal contract amended in the detail file; full record there. Claude-Session: https://claude.ai/code/session_01BNUVVkYq9vHa6G3S9a3XTZ Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	2 weeks ago
Julian Noble	1eb9dc690b	punk::path 0.3.0: extensionless tcl scripts via lib: (first-line identification) ... scriptlib_resolve now lets an extensionless (or unknown-extension) lib:<name> call match a file named exactly <name> when its first lines identify it as tcl: a leading '# tcl' comment (prefix, case-insensitive), a shebang naming tclsh/tclkit/wish, or the portable sh-trampoline ('#!/bin/sh' with a commented 'exec tclsh' continuation - detected within the first 4 lines). New internal punk::path::system::scriptfile_is_tcl does the bounded sniff (512 bytes, UTF-8 BOM and CRLF tolerated, directories/unreadable files rejected). When both <name> and <name>.tcl exist, the spelling matching the call wins, checked per scriptlib location so kit-internal directory precedence is never crossed by a spelling preference. .kit joins the known extensions: lib:<name>.kit previously had .tcl appended (searched <name>.kit.tcl), which made the shell subcommand's do_tclkit dispatch arms unreachable - lib: kit dispatch is now restored. Result dict reworked: scripttype (tcl/kit/py/pl/ps1/sh or empty) + notes keys added, scriptname is now the matched relative name, and matches require file isfile. app-punkshell and app_shellrun lib: handling refactored onto the shared resolver (previously independent inline copies of the policy), fixing two silent-failure bugs in that copy: no message at all when a scriptlib dir existed but lacked the script, and the error listing showing <kit>/scriptlib rather than the <kit>/app/scriptlib actually checked. app-punkscript's post-resolve gate now uses scripttype and its not-found report includes the identification skip notes. The unused has_globchars vestige is dropped. Fixtures scriptlib/_punktest/{extless,dual,dual.tcl,shebang_sh,notatcl} and 5 new scriptexec.test cases (extensionless resolve, both precedence directions, trampoline shebang + argv, non-tcl skip note on not-found); suite passes 17/17 against a freshly built punk902z kit. Sniff helper unit checks pass under tclsh 9.0.3 and 8.6. punkshell project 0.13.0 -> 0.14.0. Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	2 weeks ago
Julian Noble	2b46e2d86a	shell tests: E3 piped-session proof of n/ namespace continuity and subshell carry-over (shellnavns.test) ... New shell/testsuites/punkexe/shellnavns.test - one hang-proof punk_run piped session against the built executable in src launch mode (dev modules, so current punk::repl/nav source is exercised without a rebuild): PROVEN end-to-end: - n/ sets ::punk::nav::ns::ns_current in the running shell - the current namespace continues into `subshell punk` and back out, and the 0.5.2 stray-namespace seeding fix holds live (no phantom ns_current namespace in the subshell context) - navigation inside the subshell takes effect; the session exits cleanly (exitcode 0, no timeout, exit unwinds subshell -> parent -> terminate) FINDINGS from the E3 probes (pinned in the test with markers): - the FIRST subshell evaluates in the SAME code interp as the parent shell - the "first subshell asymmetry" already TODO-documented in repl::init. Continuity therefore manifests via shared state at shell level (SHARED marker: a variable set in the subshell is visible to the parent after exit, and the parent adopts the subshell''s final namespace). The repl::start seeding template - the carry-over mechanism for genuinely separate code interps - is proven at module level in punk/repl nscurrent.test. A G-002-style isolated subshell would flip these pins. - KNOWN GAP: piped-session submissions evaluate at :: even after n/ sets ns_current - the inscope application proven interactively and at module level does not take effect for subsequent piped submissions in this spawn shape. Root cause undetermined (piped-path evaluation vs kit/codethread interplay); flagged for investigation alongside G-038 session-context work. Verified: shell/** suite 42 total / 40 passed / 0 failed (2 gated skips) under Tcl 9.0.3. AGENTS updated (shell contracts bullet; punk/repl module index E3 reference). Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	2 weeks ago
Julian Noble	7ea1deaae5	G-030 achieved: make.tcl dogfoods punk::args - tabled usage, declared subcommands, -confirm prompt policy ... All 15 make.tcl subcommands are punk::args-declared ((script)::punkboot + (script)::punkboot::<sub>, built from single-source summary/help/opt dicts with shared option fragments and explicit @form -synopsis). Bare make.tcl / -help, 'help ?subcommand?' and '<subcommand> -help' render tabled usage; invalid flags/subcommands raise punk::args usage errors (exit 1) with unambiguous prefix resolution; 'shell' is a declared passthrough. Prompt policy: new -confirm 0|1 (default 1) on every confirmation point (bootsupport minor-staleness gate, vfscommonupdate REPLACE, kit-type mismatch). Default prompts only on an interactive terminal and aborts fast with guidance on non-interactive stdin (::punkboot::lib::stdin_is_interactive; Tcl 8.6 lacks the -inputmode probe and is assumed interactive). -confirm 0 proceeds (staleness, REPLACE) or skips the mismatched kit. The piped-y agent workflow is retired; the old vfscommonupdate decline half-abort (printed done, exit 0) now exits 1. Degrade rule: punk::args/punk::ansi/textblock boot requires guarded; definition load caught with fallback to a self-contained scan (-k/-dirty-abort/-confirm supported) + plain punkboot_gethelp (availability NOTE factored into punkboot_availability_note, shared by both paths); rendering degrades independently of parsing (errorstyle minimal / plain help when the ANSI stack is unhealthy); PUNKBOOT_PLAIN=1 forces degraded mode. punk::args joins the bootstrap-tracked _runtime_deps staleness set (parsing contract only - the rendering stack degrades instead; contract docs updated in src/bootsupport/AGENTS.md + src/modules/AGENTS.md, workflow docs in src/AGENTS.md + src/tests/shell/AGENTS.md). Verified: usage/help/error paths, vfscommonupdate fail-fast and -confirm 0 runs with closed stdin, staleness flag route live (args 0.5.0->0.12.0 tripped the gate), degraded-mode help/check/info, full 'project -k -confirm 0' kit build. Dogfooding finding recorded in the goal file: punk::args 0.12.0 reports generic overflow where 0.5.0 reported choiceviolation for optional-choice mismatches (worked around with required leaders; candidate error-selection improvement). Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	49ec22a928	doc: restore 'dev doc.validate' - wrap tcllib dtplite as bin/dtplite.cmd ... 'dev doc.validate' invokes a bare dtplite command which the repl unknown-handler resolves via auto_execok on PATH - no dtplite executable existed (only the legacy misnamed bin/dtplite_run.bat), giving "invalid command name dtplite". - src/scriptapps/dtplite.tcl: LF-converted (polyglot payloads are embedded verbatim into the LF-only multishell output); fall back to the project-vendored tcllib (src/vendorlib_tcl9/<arch>/tcllib*) when the invoking tclsh lacks the dtplite package - src/scriptapps/dtplite_wrap.toml: new scriptset config (tclsh nextshell on all platforms) - bin/dtplite.cmd: generated polyglot via punk::mix::commandset::scriptwrap::multishell (checkfile-clean, LF-only) - src/tests/shell/testsuites/binscripts/dtplite.test: artifact pins (LF-only, checkfile, byte-identical round-trip re-wrap) + execution usecases (usage error, validate good/bad file, validate directory tree, html generation) - 8/8 pass under runtests - AGENTS.md (bin, src/scriptapps): record the dtplite scriptset, its test pin and the LF-only payload requirement - punkproject.toml: 0.12.22 -> 0.12.23 Verified: 'dev doc.validate' in punk902z src validates all 64 src/doc .man files clean. The doctools pipeline remains interim - punk::args is the intended doc source of truth. 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	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	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	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	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	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