@ai-matrx/content-ir 0.12.0 → 0.13.0

package/CHANGELOG.md

@@ -1,5 +1,53 @@
 # Changelog
 
+## 0.13.0 — 2026-09-25
+
+**`/source` — fixes from the RC-B3 independent verification**
+(common-docs `projects/rich-content-unification/evidence/verify-RC-B3.md`).
+Every finding got a failing test first (`__tests__/source-verify-findings.test.ts`,
+14 of the 17 non-timing tests red on 0.12.0), then the fix:
+
+- **THE nested-fence rule now lives here** (`source/fence-nesting.ts`, moved from
+  matrx-frontend `components/markdown-core/fence-nesting.ts`): inside a
+  ```` ```markdown ```` / `md` / `mdx` fence, ```` ```lang ```` opens a nested
+  fence and a bare ```` ``` ```` closes the innermost one; a nested fence still
+  open at the end of the text retries strict CommonMark. The tokenizer uses it,
+  so it ends a nested markdown fence exactly where the renderer does (real row:
+  note `f9b7e9a2-…`). Generated cross-language vectors
+  `__tests__/fence-nesting-vectors.json`; aidream matrx-ai's Python twin runs a
+  byte-identical copy and fails on drift.
+- **Islands change only through `islandEdit(island, text)`.** A plain edit must
+  carry every island inside its range back byte-identical and in order —
+  otherwise `SourceSpliceError("island_edit")` names the island. Edits are
+  diffed segment by segment between islands, so anchors inside an edited
+  paragraph map exactly.
+- **Integrity is refused by default.** `requireIntegrity` defaults to `true`;
+  `false` is documented as tooling-only.
+- **Linear time on pathological input.** Every closer search goes through an
+  occurrence index; code spans use a per-paragraph run table; the single-`$`
+  scan stops at the rule's 400-character limit; embedded `__kind` probing has a
+  per-paragraph budget; `readXmlTag` takes a finder. 2 MB of `{{`: 21 s → 41 ms.
+- **A tree's root label belongs to the tree island** (the renderer splitter's
+  `findTreeBlockStart`).
+- **`$$` follows the core's pairing rule** (`source/math-pairs.ts`, ported from
+  `@ai-matrx/kit/delimiter-guard`): tokens outside code pair in order, prose
+  pairs are not math, an unpaired `$$` is literal. `$$` at the end of a line
+  pairs with a later closer, and a lone `$$` never locks the rest of a document.
+
+### Consumer action
+
+- `spliceSave` now THROWS on an island change (`island_edit`) and on disturbed
+  integrity (`integrity`). Editors change islands with `islandEdit`; tooling
+  that wants the report passes `requireIntegrity: false`.
+- matrx-frontend: import the fence rule from `@ai-matrx/content-ir/source`; the
+  local `components/markdown-core/fence-nesting.ts` is deleted.
+
+## 0.12.1
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/content-ir-core/v0.12.0..npm/content-ir-core/v0.12.1 -- apps/shared/content-ir-core`).
+No source changes intended and no consumer action required.
+
 ## 0.12.0 — 2026-09-23
 
 **`/source` — the stored text is the truth, block by block** (rich-content