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. |