Skip to content

Upgrade active wiki to Zig 0.17 and preserve migration evidence - #6

Merged
renerocksai merged 6 commits into
mainfrom
docs/zig-0.17-migration-guide
Oct 4, 2026
Merged

renerocksai merged 6 commits into
mainfrom
docs/zig-0.17-migration-guide

Conversation

@renerocksai

@renerocksai renerocksai commented Oct 4, 2026 •

Copy link
Copy Markdown
Contributor

Upgrade the wiki’s active compiler, guidance, proofs, workflows, and README to exact Zig 0.17.0. Earlier verification labels were invalidated before requalification. Historical source records, snapshots, and platform receipts retain their original bytes and scope.

The migration guide now incorporates Baz, bounded/http, Mustache, zli, and Omajot. It covers logical-bit casts versus object bytes; reflection indices and optional defaults; scalar versus packed dependency changes; borrowed slice lifetimes; Unicode generator scope; build paths and embedded assets; package exports; native Windows paths; and separate build, runtime, and watchdog budgets.

The final Omajot source packet adds 695 immutable evidence files, including initial failures, final application gates, dependency fixtures, hosted artifacts, and the five completed application merges. Application trees match their qualified feature heads. Historical records remain unchanged; earlier Baz receipts retain their older revision identities.

Important evidence boundaries:

  • Omajot and Baz pass their configured application graphs on native omarx1. Baz passes 251 tests plus five consumer tests per mode and 556 Python groups. Omajot’s final external package consumer reruns 102 tests. Final hosted Linux/macOS/Windows checks pass for both applications.
  • Direct libvaxis and zigimg Debug/Safe gates pass with their recorded skips. The image corpus has explicit GIF traversal and big-endian limitations. Unicode tailoring and generator optimization are qualified separately.
  • Unmodified uucode Safe fails one optional casing test: a pre-existing slice borrows a local row copy. Libvaxis only generates four scalar fields, excluding that getter. An isolated static-row repair passes all 167 tests in both modes; published dependency pins remain unchanged. Five synthetic probe sources were preserved but were not executed.
  • Exact-release Dispatch, Uring, and Kqueue constructors remain compiler blockers, recorded through expected-error witnesses. Tested applications use their own OS adapters.
  • The shipped Linux Threaded infinite-sleep overflow is documented. Normal verification compiles the witness and tests delegation through an injected oracle. Intentional crash reproduction requires the explicit verify-linux-none-sleep-defect target and was not run during this final ingest.
  • Windows x64 wiki proofs passed both modes. The full experimental ARM64 gate remains deferred by the user; five separate native ARM64 Debug probes preserve their narrower scope.

Final ingest validation at b60898122017f25b052b082d51c1320858eee8b3:

  • Native macOS arm64: ordinary Debug and Safe graphs pass, 93/93 steps per mode; unchanged proof executions use exact-input caches.
  • Native omarx1: final ordinary Debug/Safe graphs pass 93/93 steps per mode at this exact clean revision. Command regressions and retrieval policy also pass. No deliberate crash witness was invoked.
  • Structural lint: 53 pages, 89 source records, zero issues. Retrieval policy: 25 queries, MRR 0.98, hit@3 1.0, recall@5 0.96.
  • Clean tracked site build and deterministic comparison: 208 documents, 1,614 edges, 14 generated files.
  • Independent semantic review validates all 695 snapshot payload hashes and the source’s precise qualification boundaries.

Merged application ports: engine #9, Mustache #2, zli #2, Baz #13, and Omajot #1. No application performance comparison was run.

@renerocksai
renerocksai marked this pull request as ready for review October 4, 2026 20:55
@renerocksai
renerocksai merged commit 04f0aa6 into main Oct 4, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant