Skip to content

chore: refresh docs, enforce MSRV, tighten CI, lock spec parity with a test#54

Merged
MotherSphere merged 1 commit into
mainfrom
chore/docs-ci-msrv
Jul 20, 2026
Merged

chore: refresh docs, enforce MSRV, tighten CI, lock spec parity with a test#54
MotherSphere merged 1 commit into
mainfrom
chore/docs-ci-msrv

Conversation

@MotherSphere

Copy link
Copy Markdown
Member

Lot C (autonomie validée par Lin) - les derniers items docs/CI de l'audit

  1. architecture.md rafraîchie - 62 tests annoncés vs 106 réels, carte des modules complétée (icons.rs, markdown_blocks.rs, tutorial.rs), séquence self-update alignée sur l'écriture des octets vérifiés.
  2. rust-version = 1.80 - le README promettait « Rust 1.80+ » sans rien pour l'appliquer ; cargo échoue proprement désormais.
  3. CI - annulation de concurrence + suppression du step check redondant (clippy compile déjà la même chose).
  4. Test de parité spec/code - un échantillon de manifest utilisant chaque champ documenté (noms camelCase exacts) + assertion que chaque valeur de catégorie documentée (alias compris) mappe une vraie catégorie. La spec était exacte à l'audit ; un rename qui la casserait fait maintenant échouer la suite en premier.

Validation

106 tests verts, clippy 0, fmt OK, YAML CI validé.

…a test

- docs/architecture.md was stale in verifiable ways: 62 claimed tests
  vs 106 actual, a module map missing icons.rs / markdown_blocks.rs /
  tutorial.rs, and a self-update description predating the verified-
  bytes write. All refreshed, including the new coverage areas.
- rust-version = 1.80 in Cargo.toml: the README claimed 'Rust 1.80+'
  (std::sync::LazyLock floor) with nothing enforcing it - cargo now
  fails politely on older toolchains.
- CI: concurrency cancellation (a newer push obsoletes the running
  build) and the redundant cargo-check step removed (clippy performs
  the same compilation).
- A spec-parity test deserializes a manifest sample using every
  documented field with the spec's exact camelCase names, and asserts
  every documented category value (aliases included) maps to a real
  category: docs/colony-spec.md was verified accurate by the audit, and
  now a rename that would break it fails the suite first.
@MotherSphere
MotherSphere merged commit eeb1aff into main Jul 20, 2026
3 checks passed
@MotherSphere
MotherSphere deleted the chore/docs-ci-msrv branch July 20, 2026 20:07
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