punkshell

1 Tag

192 MiB

Author	SHA1	Message	Date
Julian Noble	59bdb1ec49	G-033 achieved: flip, archive, reference sweep (proj: visitor mode live) Activation and achievement same day at user direction ('activate and start on it'). Activation freshness survey (goals_xref score G-033) recorded in the detail file: G-043's one-directional reference is the only unlinked real relationship; G-123/G-127/G-131 overlap by punk_main.tcl/bin co-location only. Detail file gains the Progress record (option (a) inline-walk decision, verification evidence on the rebaked punk91 kit, the moduledoc-0.1.1 live-help note and the pending vfscommonupdate promotion) and moves content-identical to goals/archive/; index entry moves GOALS.md -> GOALS-archive.md. Reference sweep: G-016/G-047 relationship notes point at the archive and the ::punkboot::proj_root_find delivery; G-032's Approach now says the packagemode leader text is LIVE and its remaining lane is rendering/parse wiring; G-089's Related note records that the visitor root walk it rides is live, remains defined post-boot, and that the boot-interface packagemode hint it needs is still absent; G-031 gains the fork-drift datapoint (proj: landed in punk_main.tcl only, project_main.tcl still lacks src mode and proj:); G-018/G-035/G-043 mentions gain achieved/archive markers. goals_lint clean (85 active, 51 archived), architecture_lint clean. Claude-Session: https://claude.ai/code/session_0156PuejSCGjgeGb7jiABrDU Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 days ago
Julian Noble	46af2a74c0	G-118 achieved: flip, archive, reference sweep (tclsh subcommand review complete) Acceptance verified in full: all 11 issue-list items dispositioned (2026-07-24) with decided fixes landed (items 3/4/5/9 in 0.20.0, items 1/7 via the G-117-cycle patch rev, item 10 docs in 0.20.1, item 11 console test) and items 2/6/8 documented-as-intended in the item-10 definitions; durable doc home = punk::args::moduledoc::punkexe; tclshcmd.test 19 piped tests green vs punk902z + punk9_beta; dorepl console-reopen path console-driven (punkconsole gate, 21/21 with PUNK_TEST_CONSOLE=1). Flip: detail file status achieved 2026-07-25 + flip evidence record; entry moved to GOALS-archive.md; detail file to goals/archive/. Reference sweep: ARCHITECTURE.md tclsh bullet marked achieved + G-118 removed from the in-flux launch-surface list; G-031/G-032/G-077/G-120 notes updated with archive markers and landed-state wording (G-032 now points at the shipped punkexe moduledoc ids as its source material; G-077 notes the boundary text to update when -e lands). goals_lint clean, architecture_lint clean, goals_xref report carries no G-118-bridged unlinked pairs. Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	6 days ago
Julian Noble	d3dcc31dc4	goals system v2: semicolon Scope delimiters, version marker, lint delimiter check - GOALS.md: "Goals-system: v2" front matter; canonical "Goals system versions" section; Scope structure rule (elements separated by '; ' at top level, commas only inside parens/braces); Child DOX Index note in root AGENTS.md - goals_lint.tcl: new finding for top-level commas in Scope lines (paren/brace depth-aware) - goals_xref.tcl: repo-local configuration via goals/xref.conf (path roots, stop words, file extensions, reference containers, module dirs, bare_path_roots, prefix_anchors); defaults byte-identical to previous behaviour (verified on this tree) - goals/AGENTS.md: cross-repo goal references drop the G- prefix; xref.conf documented in Verification - Scope delimiter normalisation across GOALS.md, GOALS-archive.md and all detail files, live and archived: 224 lines, top-level commas only; conservation verified (goals_xref report byte-identical pre/post, diff hunks are Scope lines only). Archived tier converted under explicit user approval; sanctioned exception recorded in GOALS-archive.md. Assisted-by: harness=opencode; primary-model=openrouter/moonshotai/kimi-k3; api-location=openrouter.ai	6 days ago
Julian Noble	05f9a24012	goals: G-025<->G-117 and G-032<->G-118 overlap reconciliation; G-118 progress Cross-references recorded after user-prompted overlap review (none of the four files referenced its counterpart): G-117 embedded runtime record vs G-025 kit-layer stamp (record expected to survive kit wrap - two-layer provenance, build_id linkage for the stamp's runtime field, namespaced filenames); G-118 item 10 refined to G-032-COMPATIBLE punk::args definitions as the docs home (rendering/parsing/degradation stay with G-032; item-4 file-exists precedent noted for G-032's reclassification rule); item 9 duplication interim pending G-031; G-077 tclsh -e boundary note. G-118 Progress records items 3/4/5/9 landed (0.20.0) with verification evidence. Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	1 week 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	2 weeks ago
Julian Noble	99af43c8be	goals: G-062 achieved archival + archive-loss prevention (sweep rules, backlink markers, goals_lint) Finalises the G-062 achieved flip staged by the prior session (punkshell 0.12.1): LICENSE.txt (BSD-2-Clause, Julian Marcel Noble 2023-2026) at the repo root, README/punkproject.toml/AGENTS.md license declarations, index record to GOALS-archive.md and detail file to goals/archive/. Archive-loss prevention, from the G-015 incident (its achieved-status verification parenthetical was silently dropped by the 2026-07-11 two-tier restructure's Status-line normalisation; the text is restored to the G-015 archive file's Notes with provenance): - root AGENTS.md 'Doc Restructures': deleted-line conservation check before committing bulk doc migrations, structured-field-normalisation hazard (relocate prose to body sections first), moves separated from edits - goals/AGENTS.md: lintable header field grammar (one line per field, bare Status values), flip-time verification evidence recorded in the body, the archive move content-identical, and a new archive-time reference sweep: pending-tense mentions of the archived goal updated in the live tier, and actionable archived notes pointed to from the affected live goal's Notes - GOALS.md maintenance rules: achieved-flip clause extended to require the evidence write-up and the reference sweep Retroactive reference sweep over all 12 archived goals (25 live detail files): pending-tense fixes (G-002 G-008 G-013 G-016 G-017 G-021 G-022 G-031 G-042 G-044 G-050 - G-017's Goal/Acceptance annotated as gate-satisfied, contract meaning unchanged), forward pointers pushed from archived notes (G-062 license-seeding follow-on -> G-012/G-027, G-037 vendorlib/vfs drift semantics -> G-024, G-058 static-baseline mechanism -> G-005), and one 'Archived-goal references' Notes bullet per remaining referencing file so every live mention of an archived goal is resolvable without consulting the archive index. scriptlib/developer/goals_lint.tcl (new, plain tclsh): validates detail-file header grammar, strict status values in both tiers, orphan rules in both directions, Status/Scope mirror consistency, plus an informational (never fatal) warning for live files referencing an archived goal with no achieved/archive marker - baseline now zero warnings. Root AGENTS.md scriptlib/developer ownership note widened to cover developer utilities. 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	062ec6fe93	G-033 revised: proj: scope prefix, kit-first canonical, help text persisted Design review outcomes (2026-07-07): - Syntax: proj is not a fifth ordered token (category error - the dash list is an ordered sequence of path blocks whose order IS the same-version tie-break dial, per the verified tm rules and punk_main''s own comment). Decided form: [proj:]<block>[-<block>...] - the prefix scopes WHICH project root dev/src resolve against (cwd walk-up to the nearest VCS repo root vs exe-relative), staying outside the ordered list whose semantics are untouched. Explicit prefix = no silent rebind on cd. Rejected: auto-detection, an explicit flag (less convenient), token-attached qualifiers. - Shadowing: visitor mode makes cross-lineage same-version-different-code ties structurally expected (binary and visited project snapshots are different vintages by definition). Order only arbitrates exact ties - dev-versioned, higher-versioned and kit-absent modules come from the project in either order. Canonical documented invocation is proj:internal-src (kit-first: the visiting shell''s infrastructure survives ties; for a standalone downloaded binary the kit is its only trustworthy lineage and internal is location-independent); proj:src documented as the faithful-vintage variant. Trimmed kits (G-019) compose gracefully - kit-first only arbitrates ties. - Required boot notice: detected root + effective precedence. - packagemode help text drafted and persisted in the detail file as the designated G-032 source (live only when the prefix ships); G-032 detail cross-references it. Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago
Julian Noble	c662ed1ed5	add goals G-031/G-032: componentized kit boot + punk::args launcher G-031: split the monolithic vfs main (punk_main.tcl: 1190-line apply block - ~1060 lines boot machinery, ~100 lines dispatch tail) into a layout-owned boot core (shipped via _vfscommon.vfs, sourced by vfs-relative path since no package paths exist at boot; pull-updatable per the G-027 ownership model) and a thin project-owned main declaring app subcommands at commented customization points. Fork cost measured: tomlish_main.tcl carries ~20 custom lines on a stale 500-line 2025 vintage copy; project_main.tcl (901 lines) same at template vintage - boot improvements never reach derived projects. Acceptance: behaviour parity across dispatch cases and vfs types, project subcommand added by editing only the thin main (tomlish the proving ground), boot core versioned/reportable (G-025). G-032: the default dispatch defines subcommands via punk::args - tabled -help enumerating built-in and project-registered subcommands, parsed options with tabled usage errors (script/G-015 or version-report/G-025 as first candidates), G-030 degradation rules (guarded require; parsing falls back to switch semantics, help to a plain list; rendering degrades independently). Parked decision: the silent unknown-arg->script reclassification should stop swallowing typos (candidate rule: reclassify only when the argument names an existing file). Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com	3 weeks ago

9 Commits (e5f4d2ae16692e863d83d0897c11087739503b36)