szn

Documentation Bundle Log

This file tracks all modifications, extensions, and updates to the szn documentation bundle in chronological order.

Timestamp Document Action Description
2026-11-21T03:15:00Z algorithm-optimization-plan.md, index.md Created / Updated Created prioritized algorithmic optimization plan (P0 reflow quadratic scans & copy-mode fast path, P1 O(N) ByteQueue drains, P1 sixel refcount guard & containment mask, P2 bounded PTY drain & border dirty preservation, P3 region rotate / charWidth / status cleanups) with empirical two-layer benchmark methodology, doubling scaling exponent (α) gates, and dual Zig 0.16/0.17 verification criteria; linked from development index.
2026-10-30T15:25:00Z v0.11.0.md Created Created release notes for v0.11.0 (dual Zig 0.16/0.17 toolchain support, lifecycle memory reclamation, Lao script reflow, RPM packaging, and 61-bug stability sweep).
2026-10-30T15:25:00Z index.md, README.md Updated Added v0.11.0 to releases index, updated binary sizes for Zig 0.17.0 (1,053,312 bytes x86-64 Linux, 834,864 bytes aarch64 macOS).
2026-10-30T15:25:00Z progress.md, build.zig.zon, szn.spec Updated Bumped version to 0.11.0 and documented v0.11.0 release milestone.
2026-10-30T07:40:00Z bugs/562, bugs/index.md, README.md, AGENTS.md, build-run.md, progress.md Created / Updated Filed and resolved #562: the destroyPane deinitializes the last pane of a window test read pane1.deinited after Session.killWindow → Layout.deinit had freed the pane. It passed by luck on Zig 0.16 (DebugAllocator) and segfaulted on Zig 0.17 (non-reusing SafeAllocator). The test now checks session/window state instead. Regenerated the index tables (560 entries — 535 resolved / 25 false_positive / 0 open). Refreshed the test counts to 1,082 (1082/1082 on both toolchains, -Doptimize=ReleaseFast, clean cache) in README.md, build-run.md and progress.md. Dropped the hardcoded test count from AGENTS.md, which now just requires zero failures on both toolchains, so it can’t drift. Removed the stale-socket caveat from README.md and build-run.md: the suite no longer leaves szn.sock behind and passes with a pre-existing stale socket. Added a “tests on 0.17 SafeAllocator” rule to AGENTS.md.
2026-10-29T16:15:00Z bugs/542-561, bugs/index.md Created Filed 20 findings (#542–#561) from the 2026-10-29 dual-toolchain deep-analysis review (4 CRITICAL, 9 HIGH, 4 MEDIUM, 1 MEDIUM performance, 1 LOW, 1 LOW code quality; all open) and regenerated bugs/index.md summary tables (559 entries — 514 resolved / 25 false_positive / 20 open).
2026-10-22T00:00:00Z bugs/532-538 Created Filed 7 findings from the 2026-10-22 deep-analysis review (unguarded max_buffers eviction, dead GridLine.dirty state, test-only Term, duplicated Window.removePane/extractPane, redundant layout.extractPane alias, zig fmt drift, unstructured client I/O logging). All open.
2026-10-07T09:20:00Z render.zig, thai.zig, README.md, architecture.md, text_reflow.md, progress.md, build-run.md, AGENTS.md Updated Refactored SARA AM / Lao SARA AM redraw repair: centralized cell resolution (resolveCell) to prevent copy-mode drift, extracted isSaraAm into thai.zig, replaced magic poison sentinel with REDRAW_POISON_CHAR / poisonCell(), added symmetric consonant-change and Lao regression tests (1,064 tests), and updated README and documentation.
2026-10-05T06:46:00Z 531.md, options.zig Resolved Fixed stack-use-after-return in Options.coerceValue numeric choice arm: return the static candidate c from def.choices rather than a slice of the stack-local buf (bug #531).
2026-10-04T17:46:00Z bugs/511-529 Created Filed 19 findings from the 2026-10-05 dual-toolchain deep audit (5 parallel subsystem passes plus line-by-line re-verification by the auditor). 11 confirmed by reading live source: #511 resize-pane never updates the layout tree (HIGH), #512 capture-pane emits NUL bytes for blank/padding cells (HIGH), #513 IRM sixel refcount under-count (MEDIUM — reverses the 2026-08-31 audit’s H2 false-positive verdict, superseded by the #491 re-increment rule), #514 U+00A0 NBSP classified zero-width, #515 pushOwned double-free regression introduced by the #456 fix, #516 numeric-valued choice options unsettable, #517 list-keys output not round-trippable, #518 thirteen inert option-table entries, #519 drifted SGR attribute tables (21 vs 4:2), #520 duplication cluster 4, #529 the port’s own AGENTS.md @hasField rule contradicted by four OS-ABI gates (fixed). 8 recorded as unverified static-analysis leads: #521 processInput UAF after detach (#428 follow-up), #522 display-client behind flag never cleared, #523 DECOM unwired, #524 NEL does not reset the column, #525 origin-mode row overflow, #526 CBT divide-by-zero guard, #527 FreeBSD VMIN/VTIME indices, #528 splitPane OOM tree/panes desync. Re-reports of #424 (dead Term, key.zig mod computation, loop.hasFd, message_reader serializers) were identified and deliberately not filed.
2026-10-04T17:46:00Z bugs/index.md Updated Regenerated both summary tables from frontmatter: 527 entries — 487 resolved / 22 false-positive / 18 open, severity 527. The status table had drifted to 481/22/0 against a 508 severity total; the two now agree. Added the #511–#529 batch to the coverage note, appended 19 rows to the All Bugs table, and documented the new unverified value of the verified field.
2026-10-04T17:20:00Z compat.zig, README.md, AGENTS.md, build-run.md, architecture.md, progress.md Updated Added dual-toolchain support: szn now compiles on Zig 0.16.0 and 0.17.0 from one source tree. Replaced the APIs 0.17 removed or renamed (Allocator.dupeZ, std.fmt.bufPrintZ, std.meta.fields, std.ascii.indexOfIgnoreCase, the ** array-repetition operator, the OptimizeMode.Debug tag, Build.build_root) with spellings that exist in both releases; added src/compat.zig for the three shims with no shared form; confined all version branching to two comptime @hasField gates in build.zig. Documented the rule in AGENTS.md, corrected the toolchain prerequisite and the stale 944 test count in build-run.md, and fixed a stale src/cmd/mod.zig source citation in architecture.md. Verified 1042/1042 tests passing on both toolchains.
2026-09-27T11:06:00Z 506-510 Resolved All five findings from the whole-project review fixed, with 6 new regression tests (1,035 → 1,041). #506: codepoint-widths/variation-selector-always-wide declared server-scoped via options.isServerScoped and redirected to the server store, so a bare set-option no longer writes a per-session copy of a process-wide value. #507: the “no global state” claim in AGENTS.md and architecture.md qualified with its three exception groups. #510: log_fd made atomic, and disable now clears the gate before closing the descriptor. #509: .workbuddy-ai/ (and .claude/) declared in .gitignore. #508: README and progress.md test counts corrected to 1,041.
2026-09-27T10:46:00Z bugs/506-510 Created Filed 5 findings from the 2026-09-27 whole-project review, all open: codepoint-widths session-scoped but process-global (HIGH), the “No global state” claim contradicted by 11 module globals, stale README test count, .workbuddy-ai/ missing from .gitignore, and a non-atomic log fd behind an atomic gate.
2026-09-27T10:46:00Z BUGS.md Updated Added #506–#510 rows, updated severity and status tables, coverage note now reads #1–#300, #303–#510 / 508 entries with 5 open.
2026-09-27T10:12:00Z 66 docs Updated Rewrote 226 links that escaped the docs/ bundle to absolute https://github.com/cwt/szn/blob/main/... URLs (217 source files, 66 carrying #L line anchors, plus build.zig.zon and the repo README.md). docs/ is published as a standalone GitHub Pages site, so ../../../src/grid.zig resolved against the Pages origin and 404’d.
2026-09-27T10:12:00Z bundle-wide Updated Documented the split convention: intra-bundle concept links stay relative (OKF 2.5, and they resolve correctly under Pages), while links to repository assets outside the bundle are absolute. Links escaping docs/ now 227 -> 0.
2026-09-27T10:12:00Z index.md Fixed Corrected the OKF specification link to the canonical GoogleCloudPlatform/open-knowledge-format repo; the previously recorded github.com/google/okf returned 404.
2026-09-27T10:12:00Z log.md Fixed Repaired a broken ../text_reflow.md link that resolved to the repository root instead of docs/text_reflow.md.
2026-09-27T09:58:00Z bugs/*.md Updated Backfilled stale_after on 451 bug entries and normalized 4 outliers to the directory majority 2026-12-31T00:00:00Z; all 503 bug entries now carry the freshness signal.
2026-09-27T09:58:00Z bugs/.md](development/bugs/), [releases/v.md Updated Backfilled tags on 503 bug entries ([bugs, tracker]) and 16 release notes ([releases, changelog]).
2026-09-27T09:58:00Z bugs/502-505, text_reflow.md Updated Corrected 5 timestamp values that recorded local +07:00 time under a Z suffix, making them future-dated; rewritten to the true UTC instant of the commit that authored them. 10 log rows corrected the same way.
2026-09-27T09:58:00Z 52 docs Updated Normalized verified quoting — the value was quoted in 52 files and unquoted in 483; unquoted wins so frontmatter parsers see one form.
2026-09-27T09:58:00Z improvements.md Updated type: improvements was a one-off archetype; mapped to the standard project_priority that progress.md already uses for the same document shape (a catalog sorted by effort-to-impact).
2026-09-27T09:58:00Z szn-audit-2026-08-31.md Updated Added missing stale_after to the audit report.
2026-09-27T09:58:00Z index.md Updated Recorded the bundle’s metadata conventions, including the two deliberate exemptions (reserved index.md/log.md filenames, and immutable release notes carry no stale_after).
2026-09-27T09:52:00Z bugs/*.md Updated Normalized status: frontmatter across all 503 bug docs to the closed slug vocabulary resolved / false_positive / open (OKF v0.2 machine-parseable lifecycle value). Resolution prose was already carried in each body, so no detail was lost.
2026-09-27T09:52:00Z bugs/306-310, 349, 391, 454-477 Updated Repaired 29 body **Status:** lines still reading “Open” while their frontmatter and this index recorded the bug as closed — the #306–#310 and #454–#477 batches were reconciled in the index but not in the individual files.
2026-09-27T09:52:00Z bugs/347, 359, 362, 427, 441-444 Updated Replaced 24 absolute file:/// links with repo-relative paths (OKF rule 2.5); they leaked the authoring machine’s filesystem layout and resolved nowhere else. Prose mentions of the scheme in releases/v0.8.0.md left intact as historical record.
2026-09-27T09:52:00Z BUGS.md Updated Aligned both summary tables and the All Bugs status column to the new slug vocabulary; documented the closed value set.
2026-09-27T09:45:00Z progress.md Updated Refreshed timestamp; corrected test count to 1,035 total (1,034 passing, 1 skipped); added the #502–#505 Thai reflow sweep and extended the stability sweep range to #441–#505.
2026-09-27T09:15:49Z 505.md Resolved Corrected text_reflow.md sources, documented two-tier libthai architecture and fallback backtracking, and added Sara Am width-1 rationale (bug #505).
2026-09-27T09:15:49Z BUGS.md Updated Marked #505 Fixed, bumped Fixed/Resolved total (481 entries, 0 open).
2026-09-27T09:13:24Z 504.md Resolved Synchronized LibThai loading and deinitialization with atomic state transitions and documented server-thread lifecycle (bug #504).
2026-09-27T09:13:24Z BUGS.md Updated Marked #504 Fixed, bumped Fixed/Resolved total (480 entries).
2026-09-27T09:10:28Z 503.md Resolved Simplified cellHasMaiHanAkat to strictly test combiningCodepoint on table indices, eliminating dead raw-codepoint check (bug #503).
2026-09-27T09:10:28Z BUGS.md Updated Marked #503 Fixed, bumped Fixed/Resolved total (479 entries).
2026-09-27T09:08:20Z 502.md Resolved Fixed Thai cluster segmentation in findThaiClusterEnd to consume consecutive following vowels in compound syllables like เ-าะ (bug #502).
2026-09-27T09:08:20Z BUGS.md Updated Marked #502 Fixed, bumped Fixed/Resolved total (478 entries).
2026-09-27T09:02:13Z bugs 502-505 Created Filed 4 bug entries (#502–#505) from Thai reflow and text architecture review: 1 MEDIUM (#502: เ-าะ compound vowel cluster split), 3 LOW (#503: cellHasMaiHanAkat dead raw-codepoint check, #504: libthai unsynchronized globals, #505: text_reflow.md stale references and omitted libthai docs).
2026-09-27T09:02:13Z BUGS.md Updated Added #502–#505 rows, bumped severity totals and open count (503 entries).
2026-09-27T01:20:00Z v0.10.0.md Created Created release notes for v0.10.0 (hot-path performance architecture, VS16 emoji promotion, hardened sixel graphics engine, and 61-bug stability sweep).
2026-09-27T01:20:00Z index.md, README.md Updated Added v0.10.0 to releases index, documented variation-selector-always-wide option, and updated test count to 1,032.
2026-09-27T01:20:00Z progress.md Updated Updated test count to 1,032; documented v0.10.0 release milestone.
2026-09-27T01:20:00Z build.zig.zon Updated Bumped version to 0.10.0.
2026-09-04T09:18:00Z index.md, text_reflow.md, migration.md, progress.md, szn-audit-2026-08-31.md Updated Upgraded bundle to OKF v0.2: renamed all-capitals documents to lowercase, adopted v0.2 trust signals (status, sources, verified, stale_after), added frontmatter and index linkage to audit report.
2026-08-31T07:15:00Z 442.md Created Filed and resolved bug #442 for automatic window renaming latency via zero-overhead PGID change detection.
2026-08-31T07:05:00Z 441.md Created Filed and resolved bug #441 for status cache invalidation lag, auto-rename and OSC title triggers, and pane switch invalidation.
2026-08-31T06:45:00Z v0.9.1.md Created Created release notes for v0.9.1 hotfix (global window status format routing, status cache invalidation on active window change, single-quoted format strings, and per-window format resolution).
2026-08-31T06:45:00Z index.md, README.md Updated Added v0.9.1 to releases index and README.
2026-08-31T06:45:00Z progress.md Updated Updated test count to 970; documented v0.9.1 hotfix release and 49 commands.
2026-08-31T06:45:00Z build.zig.zon Updated Bumped version to 0.9.1.
2026-08-31T06:35:00Z 440.md Created Filed and resolved bug #440 for global window status format option routing and status cache freeze.
2026-08-31T00:00:00Z v0.9.0.md Created Created release notes for v0.9.0 (configurable scrollback history, zero-allocation ring buffer, runtime log control, command line quoting, and 44-bug stability sweep).
2026-08-31T00:00:00Z index.md Updated Added v0.9.0 to releases index.
2026-08-31T00:00:00Z progress.md Updated Updated test count to 959; documented v0.9.0 release.
2026-08-31T00:00:00Z build.zig.zon Updated Bumped version to 0.9.0.
2026-08-30T16:20:00Z architecture.md Updated Rewrote to cite symbols instead of line numbers; ~25 line citations had all drifted (e.g. Server.run was documented at server.zig:277, actually 605). Added a referencing-convention note.
2026-08-30T16:20:00Z ipc-protocol.md Updated Corrected MAX_PACKET_SIZE from 1 MiB to the actual 16 MiB; added the missing redraw (0x0A) and client_log (0x85) message types; retired the deleted 0x02/0x03/0x07 slots; documented validPacketLength (#375) and Packet.make truncation (#389); replaced 21 stale line citations with symbol names.
2026-08-30T16:20:00Z concepts.md Updated Removed 8 stale line citations in favour of file+symbol references.
2026-08-30T16:20:00Z build-run.md Updated Corrected the test count from ~730 to 944; fixed three stale build.zig citations; documented the stale-socket caveat that makes 3 tests fail on re-runs; corrected log-file to server-log-file.
2026-08-30T16:20:00Z BUGS.md Updated Regenerated both summary tables from frontmatter: severity rows previously summed to 422 while claiming 426 (actual 425; HIGH 103→105, LOW 100→102); status Fixed/Resolved 405→404, False Positive 18→19. Normalised row #247’s status label and corrected the stale “all OPEN” note for #395–#427.
2026-08-30T16:20:00Z progress.md Updated Test count 927→944 (verified); command count 33+→48; removed err.zig from the Phase 0 file list; noted that per-phase test figures are historical snapshots rather than a partition of 944.
2026-08-30T16:20:00Z README.md Updated Test count 927→944, command count 47→48, plus a caveat about the stale $TMPDIR/szn.sock breaking 3 tests on re-runs.
2026-08-30T16:20:00Z migration.md Updated Flagged the Phase 0 file list as historical and noted that src/err.zig was removed (bug #36).
2026-08-30T16:20:00Z index.md, text_reflow.md, bug 343 Updated Refreshed frontmatter timestamps that lagged their last modification.
2026-08-30T00:00:00Z bugs 395-426 Created Filed 32 new bug entries (#395-#426) from the 2026-08-30 deep-audit sweep: 3 CRITICAL (Pty.spawn double-free, border-cache cross-allocator free, format empty-pattern server abort), 6 HIGH, 14 MEDIUM, 9 LOW.
2026-08-30T00:00:00Z BUGS.md Updated Added #395-#426 rows, bumped severity/status totals (425 entries).
2026-08-24T00:00:00Z v0.8.2.md Created Created release notes for v0.8.2 (stability, memory hardening, terminal emulation fidelity, and UX polish).
2026-08-24T00:00:00Z index.md Updated Added v0.8.2 to releases index.
2026-08-24T00:00:00Z progress.md Updated Updated test count to 927; documented v0.8.2 release.
2026-08-24T00:00:00Z build.zig.zon Updated Bumped version to 0.8.2.
2026-08-09T00:00:00Z v0.8.1.md Created Created release notes for v0.8.1.
2026-08-09T00:00:00Z index.md Updated Added v0.8.1 to releases index.
2026-08-09T00:00:00Z build.zig.zon Updated Bumped version to 0.8.1.
2026-08-03T07:30:00Z bugs #300/#303/#304/#305/#307/#309/#310 Updated Documented corrected fixes: #309 status-line double-free crash, #303 behind_count disconnect leak, #304/#307 generation counter now bumped by cmdSetOption, #300 auto-rename 1 s rate limit, #305 valid-flag caveat.
2026-08-03T07:30:00Z bugs/index.md Updated Marked #300–#310 statuses (7 fixed, #306/#308 false positive), removed duplicate #310 row, kept counts (293 fixed / 14 FP / 1 intentional / 0 open).
2026-08-03T00:00:00Z BUGS.md Split Split 299 bug entries into individual files in docs/development/bugs/001.md–299.md with index.md and README.md symlink.
2026-08-03T00:00:00Z index.md Updated Changed Bugs link from BUGS.md to bugs/index.md; bumped timestamp.
2026-08-03T00:00:00Z index.md Created Bug tracker index with summary tables and links to all 299 bug files.
2026-08-03T00:00:00Z v0.8.0.md Created Created release notes for v0.8.0.
2026-08-03T00:00:00Z index.md Updated Added v0.8.0 to releases index; bumped timestamp.
2026-08-03T00:00:00Z progress.md Updated Updated current state description for v0.8.0; bumped timestamp.
2026-08-03T00:00:00Z build.zig.zon Updated Bumped version to 0.8.0.
2026-07-30T22:14:00Z BUGS.md Updated Added entry #277 for render cursor clamping bug.
2026-07-30T00:00:00Z index.md Updated Added log.md link and bumped timestamp.
2026-07-30T00:00:00Z index.md Updated Added improvements.md link and bumped timestamp.
2026-07-30T00:00:00Z progress.md Updated Updated test count from 770 to 802 passing tests.
2026-07-30T00:00:00Z BUGS.md Updated Bumped timestamp to reflect latest entries (#210-#276).
2026-07-25T00:00:00Z BUGS.md Updated Added entries #249-#276 from post-v0.7.0 code audit.
2026-07-24T00:00:00Z BUGS.md Updated Added entries #226-#248 from v0.7.0 QA + deep static code review audit.
2026-07-22T00:00:00Z BUGS.md Updated Added entries #216-#225 from comprehensive codebase audit.
2026-07-21T00:00:00Z BUGS.md Updated Added entries #212-#215 from status-bar / pane-border rework audit.
2026-07-21T00:00:00Z BUGS.md Updated Added entries #210-#211 from emoji-width and DECAWM fixes.
2026-07-20T06:00:00Z v0.7.0.md Created Created release notes for v0.7.0.
2026-07-20T06:00:00Z index.md Updated Added v0.7.0 to releases index and bumped timestamp.
2026-07-20T16:00:00Z improvements.md Created Created performance and optimization opportunities catalog.
2026-07-20T03:40:00Z BUGS.md Updated Added entry 209 for SGR delta color bleeding bug, corrected summary totals, and updated timestamp.
2026-07-20T03:40:00Z progress.md Updated Updated test count to 770 passing tests.
2026-07-20T03:40:00Z log.md Updated Documented SGR delta color bleeding fix and doc updates.
2026-07-20T03:33:00Z log.md Updated Documented v0.6.0 release notes creation and index updates.
2026-07-20T03:33:00Z v0.6.0.md Created Created release notes for v0.6.0.
2026-07-20T03:33:00Z index.md Updated Added v0.6.0 to releases index and bumped timestamp.
2026-07-20T03:33:00Z build.zig.zon Updated Bumped version to 0.6.0.
2026-07-20T03:25:00Z log.md Created Initialize documentation modification log.
2026-07-20T03:25:00Z BUGS.md Updated Added entries 207 and 208 for non-blocking socket buffer truncation and skipped render frame bugs, and updated summary count.
2026-07-20T03:25:00Z progress.md Updated Updated test count to 769 passing tests.
2026-07-20T03:25:00Z index.md Updated Bumped index timestamp.
2026-07-20T03:25:00Z index.md Updated Bumped development index timestamp.