@ai-matrx/content-ir 0.17.0 → 0.18.1

package/CHANGELOG.md

@@ -1,5 +1,78 @@
 # Changelog
 
+## 0.18.1 — 2026-09-25
+
+**Carries: RC-B10 only** (the one code-range rule). No RC-B3 work is pending
+after the 0.18.0 tag; 0.18.0 itself (RC-B3's single-dollar release) ALSO
+carried RC-B10 stages a and b, swept onto main before that tag — recorded
+here because its entry does not mention them.
+
+**`/source`: THE one code-range rule is the renderer's rule** (RC-B10 ruling,
+REGISTER rulings ledger). `source/code-ranges.ts` owns it: a backtick fence
+opens where a line's trimmed text starts with ``` at ANY indent (list items at
+any depth), after stripping blockquote `>` prefixes; a tilde fence opens at
+≤ 3 spaces relative to its container (list content column); a backtick fence
+closes by the nested-fence rule (with the strict retry) or the renderer's
+line-end closer (`code````), and inside ```json a backtick run in a JSON
+string is text; a blockquoted fence ends with its quote. Strict CommonMark's
+"4+ spaces is not a fence" is rejected on purpose — users see what the
+renderer's splitter draws. Phases follow the renderer: the splitter's
+any-indent backtick fences first, then remark inside each prose segment
+(blockquote, list-marker-line and tilde fences, code spans).
+- New exports: `fenceOpenerOf`, `closeFence`, `FenceReader` (the streaming
+  closer), `BacktickRuns` (the code-span pairing table), `fenceLineKinds`
+  (per-line prose/open/body/close), types `FenceOpener`, `FenceLines`,
+  `FenceEnd`, `FenceLineKind`.
+- The tokenizer (0.18.0) and `XmlContainerTracker` (this release) read fences
+  only through these; their private copies are deleted.
+- Corpus: 136,662/136,662 byte-identical; every tokenizer backtick-fence
+  island (17,518) is exactly one `findCodeRanges` fence (the 0.17 rule missed
+  92); display-math pairing unchanged on every row. Renderer blocks ⊆
+  tokenizer islands (matrx-frontend `source-covers-renderer`, container
+  fences added). Vectors: `__tests__/fixtures/code-range-vectors.json` (25,
+  incl. stored-row shapes with every word replaced) and the Python twin's
+  `fence-nesting-vectors.json` (container + stored-row documents).
+- Consumer action: none — refresh to latest.
+
+## 0.18.0 — 2026-09-25
+
+**`/source` `isSingleDollarMath`: `$FC$` is math.** (RC-B9 verifier, RC-B3.)
+`where $FC$ is fixed costs.` drew literal dollars on screen and in every
+export, because the rule wanted an operator, a lone variable or a TeX
+command. It now follows Pandoc's `tex_math_dollars` delimiters (what
+remark-math approximates, and how ChatGPT and Claude render): the opener is
+followed by a non-space; the closer is preceded by a non-space and not
+followed by a digit. `$5 and $10`, `$5-$10`, `$5/$10` stay currency. On top,
+content that reads as something else is refused: an unescaped `%`; a closing
+bracket or `/` first, an opening bracket last; a straight quote at either
+end; `:` `;` `,` `/` last; a number glued to a following letter
+(`$10$N9qo…`); a placeholder (`$...$`); and prose (two plain words, a
+contraction, an abbreviation) unless a TeX command or operator is present.
+Measured before choosing (matrx-frontend
+`scripts/measure-single-dollar-rule.ts`, 85,102 assistant messages and 4,298
+notes, read-only): 128 spans become math, each one a formula on review
+(`$FC$`, `$VC$`, `$(0, 0)$`, `$2a$`, `$3x + 6 = 15$`, `$XY$`, `$p(doom)$`);
+22 spans the old rule drew as math stop (jQuery `$("#id")`, template literals
+`${id}:${…}`, a printf `%1$s`, broken TeX); 0 currency spans become math.
+Pure Pandoc would have added 36 more false positives (shell `$HOME/…:$PATH`,
+`$\ge$20% …**$`, `[$X] … [$Y]`, bcrypt costs). Shared vectors:
+`__tests__/fixtures/single-dollar-vectors.json` (red on 0.17.0). No other
+implementation of this rule exists (the Python server has none).
+
+**New: `looksLikeOpenInlineMath(partial)`** — whether an UNCLOSED `$…`
+already reads as a formula while a stream is still arriving. It keeps the
+old signal rule (a TeX command or operator, a lone variable, a single-letter
+shape; a leading digit needs a TeX command), because without a closer there
+are no delimiter facts yet: `$35 per stop` keeps showing mid-stream.
+
+Also carries the committed RC-B10 code-range work in `source/code-ranges.ts`
+and `source/tokenize.ts`. The print lane owns its entry.
+
+**Consumer action:** a streaming healer that asks `isSingleDollarMath` about
+an unclosed `$…` tail must ask `looksLikeOpenInlineMath` instead. With the
+wider rule, a price like `$35 per stop` would otherwise be held back until
+the line ends. matrx-frontend `stream-heal.ts` is the one known caller.
+
 ## 0.17.0 — 2026-09-26
 
 **`/source` streaming: what "settled" promises, pinned — and the one
@@ -69,7 +142,7 @@ Automatic changed-only republish (docs/metadata drift since the last tag — see
 `git diff npm/content-ir-core/v0.16.0..npm/content-ir-core/v0.16.1 -- apps/shared/content-ir-core`).
 No source changes intended and no consumer action required.
 
-## Unreleased
+## 0.16.2 (also shipped)
 
 **`/source` — a callout or `:::` directive nested in a list item stays in the
 list's prose block** (verify-RC-B8 round 2, SAFETY). Guard: