chris-c-thomas · chris-c-thomas · Apr 22, 2026 · Apr 22, 2026
diff --git a/.changeset/multi-granularity-converter.md b/.changeset/multi-granularity-converter.md
diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
@@ -1,5 +1,31 @@
 # @lexbuild/cli
 
+## 1.25.0
+
+### Minor Changes
+
+- 6298069: Add single-pass multi-granularity conversion. The `convert-usc` and `convert-ecfr`
+  commands now accept `--granularities section,chapter,title[,part]` together with
+  `--output-chapter`, `--output-title`, and `--output-part` (eCFR only) to produce
+  every requested granularity from one parse of the source XML. The builders'
+  `emitAt` option accepts a `ReadonlySet<LevelType>` in addition to a single
+  `LevelType`, and deeper levels emit first so that higher-level emissions see the
+  complete subtree. Update scripts (`update-usc.sh`, `update-ecfr.sh`) collapse
+  their N `convert-*` invocations into one, yielding a ~40-50% reduction in the
+  incremental convert step's wall-clock on multi-granularity runs.
+
+  Back-compat: the existing `-g/--granularity` + `-o/--output` single-granularity
+  form continues to work unchanged and is mutually exclusive with
+  `--granularities`.
+
+### Patch Changes
+
+- Updated dependencies [6298069]
+  - @lexbuild/ecfr@1.25.0
+  - @lexbuild/core@1.25.0
+  - @lexbuild/usc@1.25.0
+  - @lexbuild/fr@1.25.0
+
 ## 1.24.1
 
 ### Patch Changes

diff --git a/packages/cli/package.json b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@lexbuild/cli",
-  "version": "1.24.1",
+  "version": "1.25.0",
   "description": "Compiler for legal and civic texts. Converts disparate statutory data into structured formats optimized for AI, RAG, and semantic search.",
   "author": "Chris Thomas",
   "license": "MIT",

diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
@@ -1,5 +1,23 @@
 # @lexbuild/core
 
+## 1.25.0
+
+### Minor Changes
+
+- 6298069: Add single-pass multi-granularity conversion. The `convert-usc` and `convert-ecfr`
+  commands now accept `--granularities section,chapter,title[,part]` together with
+  `--output-chapter`, `--output-title`, and `--output-part` (eCFR only) to produce
+  every requested granularity from one parse of the source XML. The builders'
+  `emitAt` option accepts a `ReadonlySet<LevelType>` in addition to a single
+  `LevelType`, and deeper levels emit first so that higher-level emissions see the
+  complete subtree. Update scripts (`update-usc.sh`, `update-ecfr.sh`) collapse
+  their N `convert-*` invocations into one, yielding a ~40-50% reduction in the
+  incremental convert step's wall-clock on multi-granularity runs.
+
+  Back-compat: the existing `-g/--granularity` + `-o/--output` single-granularity
+  form continues to work unchanged and is mutually exclusive with
+  `--granularities`.
+
 ## 1.24.1
 
 ### Patch Changes

diff --git a/packages/core/package.json b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@lexbuild/core",
-  "version": "1.24.1",
+  "version": "1.25.0",
   "description": "Core AST definitions, parsing infrastructure, and format-agnostic renderers for the LexBuild ecosystem.",
   "author": "Chris Thomas",
   "license": "MIT",

diff --git a/packages/ecfr/CHANGELOG.md b/packages/ecfr/CHANGELOG.md
@@ -1,5 +1,28 @@
 # @lexbuild/ecfr
 
+## 1.25.0
+
+### Minor Changes
+
+- 6298069: Add single-pass multi-granularity conversion. The `convert-usc` and `convert-ecfr`
+  commands now accept `--granularities section,chapter,title[,part]` together with
+  `--output-chapter`, `--output-title`, and `--output-part` (eCFR only) to produce
+  every requested granularity from one parse of the source XML. The builders'
+  `emitAt` option accepts a `ReadonlySet<LevelType>` in addition to a single
+  `LevelType`, and deeper levels emit first so that higher-level emissions see the
+  complete subtree. Update scripts (`update-usc.sh`, `update-ecfr.sh`) collapse
+  their N `convert-*` invocations into one, yielding a ~40-50% reduction in the
+  incremental convert step's wall-clock on multi-granularity runs.
+
+  Back-compat: the existing `-g/--granularity` + `-o/--output` single-granularity
+  form continues to work unchanged and is mutually exclusive with
+  `--granularities`.
+
+### Patch Changes
+
+- Updated dependencies [6298069]
+  - @lexbuild/core@1.25.0
+
 ## 1.24.1
 
 ### Patch Changes

diff --git a/packages/ecfr/package.json b/packages/ecfr/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@lexbuild/ecfr",
-  "version": "1.24.1",
+  "version": "1.25.0",
   "description": "Electronic Code of Federal Regulations (eCFR) to Markdown converter for LexBuild",
   "author": "Chris Thomas",
   "license": "MIT",

diff --git a/packages/fr/CHANGELOG.md b/packages/fr/CHANGELOG.md
@@ -1,5 +1,28 @@
 # @lexbuild/fr
 
+## 1.25.0
+
+### Minor Changes
+
+- 6298069: Add single-pass multi-granularity conversion. The `convert-usc` and `convert-ecfr`
+  commands now accept `--granularities section,chapter,title[,part]` together with
+  `--output-chapter`, `--output-title`, and `--output-part` (eCFR only) to produce
+  every requested granularity from one parse of the source XML. The builders'
+  `emitAt` option accepts a `ReadonlySet<LevelType>` in addition to a single
+  `LevelType`, and deeper levels emit first so that higher-level emissions see the
+  complete subtree. Update scripts (`update-usc.sh`, `update-ecfr.sh`) collapse
+  their N `convert-*` invocations into one, yielding a ~40-50% reduction in the
+  incremental convert step's wall-clock on multi-granularity runs.
+
+  Back-compat: the existing `-g/--granularity` + `-o/--output` single-granularity
+  form continues to work unchanged and is mutually exclusive with
+  `--granularities`.
+
+### Patch Changes
+
+- Updated dependencies [6298069]
+  - @lexbuild/core@1.25.0
+
 ## 1.24.1
 
 ### Patch Changes

diff --git a/packages/fr/package.json b/packages/fr/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@lexbuild/fr",
-  "version": "1.24.1",
+  "version": "1.25.0",
   "description": "Federal Register XML to Markdown converter for LexBuild",
   "author": "Chris Thomas",
   "license": "MIT",

diff --git a/packages/mcp/CHANGELOG.md b/packages/mcp/CHANGELOG.md
@@ -1,5 +1,23 @@
 # @lexbuild/mcp
 
+## 1.25.0
+
+### Minor Changes
+
+- 6298069: Add single-pass multi-granularity conversion. The `convert-usc` and `convert-ecfr`
+  commands now accept `--granularities section,chapter,title[,part]` together with
+  `--output-chapter`, `--output-title`, and `--output-part` (eCFR only) to produce
+  every requested granularity from one parse of the source XML. The builders'
+  `emitAt` option accepts a `ReadonlySet<LevelType>` in addition to a single
+  `LevelType`, and deeper levels emit first so that higher-level emissions see the
+  complete subtree. Update scripts (`update-usc.sh`, `update-ecfr.sh`) collapse
+  their N `convert-*` invocations into one, yielding a ~40-50% reduction in the
+  incremental convert step's wall-clock on multi-granularity runs.
+
+  Back-compat: the existing `-g/--granularity` + `-o/--output` single-granularity
+  form continues to work unchanged and is mutually exclusive with
+  `--granularities`.
+
 ## 1.24.1
 
 ### Patch Changes

diff --git a/packages/mcp/package.json b/packages/mcp/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@lexbuild/mcp",
-  "version": "1.24.1",
+  "version": "1.25.0",
   "description": "Model Context Protocol server for LexBuild. Exposes U.S. legal sources to AI agents.",
   "author": "Chris Thomas",
   "license": "MIT",

diff --git a/packages/usc/CHANGELOG.md b/packages/usc/CHANGELOG.md
@@ -1,5 +1,28 @@
 # @lexbuild/usc
 
+## 1.25.0
+
+### Minor Changes
+
+- 6298069: Add single-pass multi-granularity conversion. The `convert-usc` and `convert-ecfr`
+  commands now accept `--granularities section,chapter,title[,part]` together with
+  `--output-chapter`, `--output-title`, and `--output-part` (eCFR only) to produce
+  every requested granularity from one parse of the source XML. The builders'
+  `emitAt` option accepts a `ReadonlySet<LevelType>` in addition to a single
+  `LevelType`, and deeper levels emit first so that higher-level emissions see the
+  complete subtree. Update scripts (`update-usc.sh`, `update-ecfr.sh`) collapse
+  their N `convert-*` invocations into one, yielding a ~40-50% reduction in the
+  incremental convert step's wall-clock on multi-granularity runs.
+
+  Back-compat: the existing `-g/--granularity` + `-o/--output` single-granularity
+  form continues to work unchanged and is mutually exclusive with
+  `--granularities`.
+
+### Patch Changes
+
+- Updated dependencies [6298069]
+  - @lexbuild/core@1.25.0
+
 ## 1.24.1
 
 ### Patch Changes

diff --git a/packages/usc/package.json b/packages/usc/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@lexbuild/usc",
-  "version": "1.24.1",
+  "version": "1.25.0",
   "description": "Federal U.S. Code specific element handlers and downloader for LexBuild",
   "author": "Chris Thomas",
   "license": "MIT",