@lexbuild/cli 1.0.0 → 1.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chris Thomas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,114 @@
+# @lexbuild/cli
+
+[![npm](https://img.shields.io/npm/v/%40lexbuild%2Fcli?style=flat-square)](https://www.npmjs.com/package/@lexbuild/cli)
+[![CI](https://img.shields.io/github/actions/workflow/status/chris-c-thomas/lexbuild/ci.yml?style=flat-square&label=CI)](https://github.com/chris-c-thomas/lexbuild/actions/workflows/ci.yml)
+[![license](https://img.shields.io/github/license/chris-c-thomas/lexbuild?style=flat-square)](https://github.com/chris-c-thomas/lexbuild/blob/main/LICENSE)
+
+This package is part of the [LexBuild](https://github.com/chris-c-thomas/lexbuild) monorepo, a tool that converts U.S. legislative XML into structured Markdown optimized for AI, RAG pipelines, and semantic search. See the monorepo for full documentation, architecture details, and contribution guidelines.
+
+It provides the CLI entry point for downloading and converting legal and civic texts. Currently supports the [United States Code](https://uscode.house.gov/) via [`@lexbuild/usc`](https://www.npmjs.com/package/@lexbuild/usc), with additional sources (CFR, state statutes) planned.
+
+## Install
+
+```bash
+npm install -g @lexbuild/cli
+```
+
+Or run directly with npx:
+
+```bash
+npx @lexbuild/cli download --all
+npx @lexbuild/cli convert --all
+```
+
+## Quick Start
+
+```bash
+# Download and convert all 54 titles
+lexbuild download --all && lexbuild convert --all
+
+# Start small — download and convert Title 1
+lexbuild download --titles 1 && lexbuild convert --titles 1
+
+# Download and convert a range
+lexbuild download --titles 1-5 && lexbuild convert --titles 1-5
+```
+
+## Commands
+
+### `lexbuild download`
+
+Fetch U.S. Code XML files from the OLRC.
+
+```bash
+lexbuild download --titles 1           # Single title
+lexbuild download --titles 1-5,8,11    # Range + specific titles
+lexbuild download --all                # All 54 titles (single bulk zip)
+```
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `--titles <spec>` | — | Title(s) to download: `1`, `1-5`, `1-5,8,11` |
+| `--all` | — | Download all 54 titles |
+| `-o, --output <dir>` | `./downloads/usc/xml` | Output directory |
+| `--release-point <id>` | current | OLRC release point |
+
+### `lexbuild convert`
+
+Convert downloaded XML to Markdown.
+
+```bash
+lexbuild convert --titles 1                          # By title number
+lexbuild convert --all                               # All downloaded titles
+lexbuild convert ./downloads/usc/xml/usc01.xml       # Direct file path
+lexbuild convert --titles 1 -g chapter               # Chapter-level output
+lexbuild convert --titles 1 --link-style canonical   # OLRC website links
+lexbuild convert --titles 42 --dry-run               # Preview without writing
+```
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `--titles <spec>` | — | Title(s) to convert |
+| `--all` | — | Convert all titles in input directory |
+| `-i, --input-dir <dir>` | `./downloads/usc/xml` | Input directory for XML files |
+| `-o, --output <dir>` | `./output` | Output directory |
+| `-g, --granularity <level>` | `section` | `section` or `chapter` |
+| `--link-style <style>` | `plaintext` | `plaintext`, `canonical`, or `relative` |
+| `--no-include-source-credits` | — | Exclude source credits |
+| `--no-include-notes` | — | Exclude all notes |
+| `--include-editorial-notes` | — | Include editorial notes only |
+| `--include-statutory-notes` | — | Include statutory notes only |
+| `--include-amendments` | — | Include amendment notes only |
+| `--dry-run` | — | Parse and report without writing files |
+| `-v, --verbose` | — | Verbose logging |
+
+## Output
+
+```
+output/usc/
+  title-01/
+    README.md
+    _meta.json
+    chapter-01/
+      _meta.json
+      section-1.md
+      section-2.md
+```
+
+Each section file includes YAML frontmatter (identifier, title, chapter, section, status, source credit) followed by the statutory text with bold inline numbering.
+
+## Performance
+
+The full U.S. Code — all 54 titles, 60,000+ sections, ~85 million estimated tokens — converts in about 20-30 seconds on modern machines. SAX streaming keeps memory bounded for even the largest titles (100MB+ XML).
+
+## Documentation
+
+- [Monorepo README](https://github.com/chris-c-thomas/lexbuild#readme)
+- [Architecture](https://github.com/chris-c-thomas/lexbuild/blob/main/docs/architecture.md)
+- [Output Format](https://github.com/chris-c-thomas/lexbuild/blob/main/docs/output-format.md)
+- [XML Element Reference](https://github.com/chris-c-thomas/lexbuild/blob/main/docs/xml-element-reference.md)
+- [Extending](https://github.com/chris-c-thomas/lexbuild/blob/main/docs/extending.md)
+
+## License
+
+[MIT](https://github.com/chris-c-thomas/lexbuild/blob/main/LICENSE)

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@lexbuild/cli",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "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",
-  "homepage": "https://github.com/chris-c-thomas/lexbuild#readme",
+  "homepage": "https://github.com/chris-c-thomas/lexbuild/tree/main/packages/cli#readme",
   "bugs": {
     "url": "https://github.com/chris-c-thomas/lexbuild/issues"
   },
@@ -47,24 +47,15 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "lint": "eslint src",
-    "lint:fix": "eslint src --fix"
-  },
   "dependencies": {
-    "@lexbuild/core": "workspace:*",
-    "@lexbuild/usc": "workspace:*",
     "chalk": "^5.6.2",
     "cli-table3": "^0.6.5",
     "commander": "^13.1.0",
     "ora": "^8.2.0",
     "pino": "^9.6.0",
-    "pino-pretty": "^13.0.0"
+    "pino-pretty": "^13.0.0",
+    "@lexbuild/core": "1.0.2",
+    "@lexbuild/usc": "1.0.2"
   },
   "devDependencies": {
     "@types/node": "^25.3.2",
@@ -77,5 +68,14 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix"
   }
 }