Move A7 to Zig 0.16 and simplify docs

Author: code5717

.github/workflows/ci.yml

@@ -15,9 +15,9 @@ concurrency:
 
 env:
   FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
-  ZIG_VERSION: "0.15.2"
-  ZIG_URL: https://ziglang.org/download/0.15.2/zig-x86_64-linux-0.15.2.tar.xz
-  ZIG_SHA256: 02aa270f183da276e5b5920b1dac44a63f1a49e55050ebde3aecc9eb82f93239
+  ZIG_VERSION: "0.16.0"
+  ZIG_URL: https://ziglang.org/download/0.16.0/zig-x86_64-linux-0.16.0.tar.xz
+  ZIG_SHA256: 70e49664a74374b48b51e6f3fdfbf437f6395d42509050588bd49abe52ba3d00
 
 jobs:
   python:

.github/workflows/release.yml

@@ -15,9 +15,9 @@ concurrency:
 
 env:
   FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
-  ZIG_VERSION: "0.15.2"
-  ZIG_URL: https://ziglang.org/download/0.15.2/zig-x86_64-linux-0.15.2.tar.xz
-  ZIG_SHA256: 02aa270f183da276e5b5920b1dac44a63f1a49e55050ebde3aecc9eb82f93239
+  ZIG_VERSION: "0.16.0"
+  ZIG_URL: https://ziglang.org/download/0.16.0/zig-x86_64-linux-0.16.0.tar.xz
+  ZIG_SHA256: 70e49664a74374b48b51e6f3fdfbf437f6395d42509050588bd49abe52ba3d00
 
 jobs:
   build-release:
@@ -106,22 +106,23 @@ jobs:
         run: tar -czf dist/a7-docs-site.tar.gz -C site dist
 
       - name: Archive release example artifacts
-        run: tar -czf dist/a7-example-artifacts-linux-x86_64-zig0.15.2-release.tar.gz -C build release
+        run: tar -czf dist/a7-example-artifacts-linux-x86_64-zig0.16.0-release.tar.gz -C build release
 
       - name: Verify release archive contents
         run: |
+          example_count="$(uv run python scripts/project_status.py --field example_count)"
           uv run python scripts/verify_archive_contents.py dist/a7-docs-site.tar.gz \
             --require dist/llms.txt \
             --require dist/llms-full.txt \
             --require dist/docs/index.md \
             --require dist/docs/agent-usage.md \
             --require dist/docs/release.md \
             --require dist/docs/status.md
-          uv run python scripts/verify_archive_contents.py dist/a7-example-artifacts-linux-x86_64-zig0.15.2-release.tar.gz \
+          uv run python scripts/verify_archive_contents.py dist/a7-example-artifacts-linux-x86_64-zig0.16.0-release.tar.gz \
             --require release/zig/src/001_hello.zig \
             --require release/zig/bin/001_hello \
-            --require-glob-count 'release/zig/src/*.zig=38' \
-            --require-glob-count 'release/zig/bin/*=38'
+            --require-glob-count "release/zig/src/*.zig=${example_count}" \
+            --require-glob-count "release/zig/bin/*=${example_count}"
 
       - name: Generate release checksums
         run: |
@@ -132,7 +133,7 @@ jobs:
             --require "$sdist" \
             --require "$wheel" \
             --require dist/a7-docs-site.tar.gz \
-            --require dist/a7-example-artifacts-linux-x86_64-zig0.15.2-release.tar.gz
+            --require dist/a7-example-artifacts-linux-x86_64-zig0.16.0-release.tar.gz
           uv run python scripts/verify_release_manifest.py dist/SHA256SUMS
 
       - name: Generate release artifact attestations
@@ -143,7 +144,7 @@ jobs:
             dist/a7_py-*.tar.gz
             dist/a7_py-*.whl
             dist/a7-docs-site.tar.gz
-            dist/a7-example-artifacts-linux-x86_64-zig0.15.2-release.tar.gz
+            dist/a7-example-artifacts-linux-x86_64-zig0.16.0-release.tar.gz
 
       - name: Upload release bundles
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a
@@ -152,7 +153,7 @@ jobs:
           path: |
             dist/SHA256SUMS
             dist/a7-docs-site.tar.gz
-            dist/a7-example-artifacts-linux-x86_64-zig0.15.2-release.tar.gz
+            dist/a7-example-artifacts-linux-x86_64-zig0.16.0-release.tar.gz
           if-no-files-found: error
           retention-days: 7
 
@@ -196,4 +197,4 @@ jobs:
             dist/a7_py-*.tar.gz
             dist/a7_py-*.whl
             dist/a7-docs-site.tar.gz
-            dist/a7-example-artifacts-linux-x86_64-zig0.15.2-release.tar.gz
+            dist/a7-example-artifacts-linux-x86_64-zig0.16.0-release.tar.gz

AGENTS.md

@@ -1,7 +1,7 @@
 # AGENTS.md
 
 Guidance for coding agents working in this repository. Keep changes consistent
-with `README.md` and `RELEASE.md`; those are the authoritative user-facing docs.
+with `README.md` and `docs/RELEASE.md`; those are the authoritative user-facing docs.
 For terminal/curl workflows, `site/public/llms.txt`,
 `site/public/llms-full.txt`, and `site/public/docs/index.md` are the
 agent-readable docs entry points derived from the authoritative docs.
@@ -41,7 +41,7 @@ non-trivial.
 
 The public docs site also ships Markdown entry points for agent tooling under
 `site/public/llms.txt`, `site/public/llms-full.txt`, and `site/public/docs/`.
-Keep those files aligned with `README.md`, `RELEASE.md`, and user-visible site
+Keep those files aligned with `README.md`, `docs/RELEASE.md`, and user-visible site
 navigation when docs structure changes.
 
 ## A7 Source Rules
@@ -65,7 +65,7 @@ navigation when docs structure changes.
   or prefix `*` as reference operations; pass lvalues directly to `ref`
   parameters and use ordinary field access after nil checks.
 - Native release archives are named with platform/toolchain context
-  (`a7-example-artifacts-linux-x86_64-zig0.15.2-<profile>.tar.gz`); keep
+  (`a7-example-artifacts-linux-x86_64-zig0.16.0-<profile>.tar.gz`); keep
   any docs or scripts that reference these filenames in sync.
 - This rule applies to A7 source only. Compiler internals already use
   iterative AST traversals; keep them that way.
@@ -76,18 +76,17 @@ After making major changes (new language features, bug fixes, backend
 additions, refactors), ensure the following docs are up to date before
 committing:
 
-1. **CHANGELOG.md** — add an entry for the change
+1. **docs/CHANGELOG.md** — add a short release-facing entry
 2. **README.md** — update usage, feature lists, or examples if affected
 3. **docs/SPEC.md** — update if language semantics or syntax changed
-4. **MISSING_FEATURES.md** — mark completed gaps or document new ones
-5. **TODO.md** — check off completed items or add newly discovered work
-6. **site/public/llms.txt**, **site/public/llms-full.txt**, and
+4. **docs/STATUS.md** — update current gaps, priorities, or roadmap
+5. **site/public/llms.txt**, **site/public/llms-full.txt**, and
    **site/public/docs/** — update agent/curl.md entry points if site
    navigation, release commands, CLI behavior, or public docs structure
    changed
 
 Keep examples and docs aligned across `README.md`, `docs/SPEC.md`,
-`CHANGELOG.md`, `MISSING_FEATURES.md`, `TODO.md`, `site/public/llms.txt`,
+`docs/CHANGELOG.md`, `docs/STATUS.md`, `site/public/llms.txt`,
 `site/public/llms-full.txt`, and `site/public/docs/` — drift between them is
 treated as a bug.