CND 0.5.0 production: declaration 0.2.0, builder, matching v2, CLI, visitors

[Maxanox]

This is the last plan of the CND 0.5.0 series. It ports everything that was still on the old format, and leaves no test module parked. With it merged, format-0-5-0 is ready for main; only the release steps remain.

What changes

• Writer. Cnd.to_json() writes a CND without its default-valued fields. Reading the output back gives the same CND and the same content hash. Every CND the SDK writes goes through it.
• Declaration 0.2.0.
  • A text can be written as a plain string or as the full rich-text object, which can carry hyperlinks.
  • The numbering name is authored, and a nested numbering.value is refused.
  • Every value object is strict.
  • A 0.1 declaration is refused with an error that names its version.
• Builder.
  • It mints ids for every node, including content nested in containers and footnotes.
  • It numbers the full walk.
  • It threads heading_path through containers.
  • It reports numbering-without-engine when an authored numbering cannot be resolved.
  • It never shares a mutable object with the declaration.
• Version checks. A CND or declaration of another version is refused before its shape is checked, by the CLI loaders and by validate() (rule cnd-version-unsupported).
• Reconciliation, matching v2 (ADR 0029, extends 0018).
  • It walks the full tree, uses the spec §8 paths, and keys footnote content by its note's label.
  • Containers are keyed on their own hash plus a digest of their contents, so twin containers keep their own ids.
  • A last container-hash pass pairs a container whose content was edited and which also moved.
  • The vectors gain cases 08–11.
• Visitors and display.
  • BaseVisitor dispatches every 0.5 node type. visit(cnd, full=True) also walks footnotes, with spec paths.
  • cnd inspect shows the new nodes, and never reads CND text as Rich markup.
• CLI. Every command works on 0.5 documents. hash --nodes lists the full walk, as hashes.json does.
• Typst package. cnd.table(kind: …) replaces content_kind:. The hint is stored under its own state key, table-kind, so author metadata is never touched.
• Closing the series.
  • Every vector is regenerated and reproducible.
  • The parking list is gone.
  • Spec §12 is rewritten and proposal 0013 is marked implemented.
  • The CHANGELOG has an [Unreleased] entry.

Review

• Every task had its own review. Reconciliation needed four fix rounds and the display one.
• The final whole-branch review ran the full production path on a declaration using every 0.5 element: declaration, build, write, validate, hash, Markdown, HTML, rebuild, reconcile. Nothing was lost and every id was kept. Its findings were fixed in one wave and re-reviewed.
• 1155 tests pass. The Typst compile tests run when typst is installed.

Before main

Two release steps remain:

• bump pyproject to 0.9.0;
• tag the release.

Follow-ups: CND-26, CND-50, CND-51.

Part of CND-40

🤖 Generated with Claude Code

https://claude.ai/code/session_01XxXUiDn2QyzNTYnZpeVFVS