[docs] Update documentation for features from 2026-03-27

[danielmeppiel]

Documentation Updates - 2026-03-27

This PR updates the documentation based on features merged in the last 24 hours.

Features Documented

• Deterministic Build IDs across platforms (from fix: sort instruction discovery order for deterministic Build IDs across platforms #468)

Changes Made

• Updated CHANGELOG.md to add a Fixed entry for the sorted instruction discovery order fix
• Updated docs/src/content/docs/guides/compilation.md (Deterministic Output section) to:
  • Clarify that sorted iteration order prevents filesystem-native ordering differences between platforms (APFS on macOS, ext4 on Linux)
  • Update "Consistent Build IDs across machines" to reflect cross-platform correctness
  • Add a note that apm compile is now safe to use in pre-commit hooks
  • Include a brief pre-commit hook example using --dry-run

Merged PRs Referenced

• fix: sort instruction discovery order for deterministic Build IDs across platforms #468 - fix: sort instruction discovery order for deterministic Build IDs across platforms

Notes

The fix in #468 sorted os.walk() results in _get_all_files() and pattern_instructions lists in template_builder, distributed_compiler, and claude_formatter. The documentation already claimed "Consistent Build IDs across machines" but that claim was not accurate until this fix landed. The updated docs now accurately reflect the behavior and highlight the pre-commit hook use case that was unblocked by the fix.

Generated by Daily Documentation Updater · ◷

To install this agentic workflow, run

gh aw add githubnext/agentics/workflows/daily-doc-updater.md@b87234850bf9664d198f28a02df0f937d0447295

• expires on Mar 29, 2026, 3:45 AM UTC