Name the node every refusal came from, and close the error list

2026-08-25 09:00:47 +02:00
parent e92484eb85
commit e2ea868ac6
9 changed files with 165 additions and 113 deletions
@@ -72,6 +72,11 @@ The emitted markdown and HTML are contracts. After 1.0: previously-emitted outpu
 differently, or not at all, is MAJOR; new syntax while old output still round-trips is MINOR.
 Pre-1.0, normal 0.x rules.

+The error surface is a contract too. `ConvertError` is `{ code, message, path }` — the code from a
+closed list a consumer may switch exhaustively, the message free text, the path the node's position
+from the document root. Adding, removing or renaming a code is breaking, so a milestone meeting a
+new failure cause reuses a code where one fits; the list is complete at `0.1.0`.
+
 ## 9. Release automation

 - `package.json` version on `main` is the source of truth. CI on `main`: tests green and version