chore: rename law2md to lexbuild across monorepo

  Rename the project from law2md to lexbuild with the @lexbuild/ npm
  namespace. Updates package names, bin entry, workspace deps, imports,
  CLI program name, UI labels, GENERATOR constant, test assertions,
  fixture snapshots, all documentation, changelogs, .gitignore comments,
  and changeset config. Regenerated pnpm-lock.yaml.

  No functional changes.

Author: chris-c-thomas

.changeset/config.json

@@ -2,7 +2,7 @@
   "$schema": "https://unpkg.com/@changesets/config@3.1.2/schema.json",
   "changelog": "@changesets/cli/changelog",
   "commit": false,
-  "fixed": [["@law2md/core", "@law2md/usc", "law2md"]],
+  "fixed": [["@lexbuild/core", "@lexbuild/usc", "lexbuild"]],
   "linked": [],
   "access": "public",
   "baseBranch": "main",

.github/copilot-instructions.md

@@ -1,12 +1,12 @@
-# law2md Workspace Instructions
+# lexbuild Workspace Instructions
 
 ## Scope
 
 These instructions apply to all work in this repository. Keep changes minimal, targeted, and consistent with existing package boundaries. See `CLAUDE.md` for the full USLM schema reference, design decisions, and common pitfalls.
 
 ## Project Overview
 
-`law2md` converts U.S. legislative XML (USLM schema) into structured Markdown for AI/RAG ingestion. It is a monorepo built with Turborepo, pnpm workspaces, TypeScript, and Node.js.
+`lexbuild` converts U.S. legislative XML (USLM schema) into structured Markdown for AI/RAG ingestion. It is a monorepo built with Turborepo, pnpm workspaces, TypeScript, and Node.js.
 
 ## Build and Test
 
@@ -23,9 +23,9 @@ pnpm turbo lint
 Package-scoped pattern:
 
 ```bash
-pnpm turbo <task> --filter=@law2md/core
-pnpm turbo <task> --filter=@law2md/usc
-pnpm turbo <task> --filter=law2md
+pnpm turbo <task> --filter=@lexbuild/core
+pnpm turbo <task> --filter=@lexbuild/usc
+pnpm turbo <task> --filter=lexbuild
 ```
 
 Run the CLI locally during development:
@@ -40,9 +40,9 @@ node packages/cli/dist/index.js convert --titles 1-5 -o ./test-output
 
 This is a Turborepo + pnpm monorepo with three packages:
 
-- `packages/core` (`@law2md/core`): namespace-aware XML parsing (SAX via `saxes`), AST building, Markdown rendering, frontmatter generation, shared utilities.
-- `packages/usc` (`@law2md/usc`): USC-specific conversion pipeline and OLRC downloader. Contains `convertTitle()` which orchestrates ReadStream → SAX → AST → Markdown → file writer.
-- `packages/cli` (`law2md`): CLI commands (`convert`, `download`), terminal UI (`chalk`, `ora`, `cli-table3`), and user-facing command surface.
+- `packages/core` (`@lexbuild/core`): namespace-aware XML parsing (SAX via `saxes`), AST building, Markdown rendering, frontmatter generation, shared utilities.
+- `packages/usc` (`@lexbuild/usc`): USC-specific conversion pipeline and OLRC downloader. Contains `convertTitle()` which orchestrates ReadStream → SAX → AST → Markdown → file writer.
+- `packages/cli` (`lexbuild`): CLI commands (`convert`, `download`), terminal UI (`chalk`, `ora`, `cli-table3`), and user-facing command surface.
 
 Respect boundaries: keep generic parsing/rendering logic in `core`, USC-specific behavior in `usc`, and CLI orchestration in `cli`. Internal packages use `workspace:*` protocol for dependencies.
 

.gitignore

@@ -1,5 +1,5 @@
 # =============================================================================
-# law2md .gitignore
+# lexbuild .gitignore
 # =============================================================================
 
 # -----------------------------------------------------------------------------
@@ -118,7 +118,7 @@ tags
 .zed/
 
 # -----------------------------------------------------------------------------
-# law2md operational outputs
+# lexbuild operational outputs
 # -----------------------------------------------------------------------------
 
 # Downloaded source files (large, regenerable)

CHANGELOG.md

@@ -23,7 +23,7 @@ and this project adheres to [Conventional Commits](https://www.conventionalcommi
 
 ### Fixed
 
-- **Spurious root dependency**: removed accidental `"dependencies": { "law2md-monorepo": "link:" }` from root `package.json`
+- **Spurious root dependency**: removed accidental `"dependencies": { "lexbuild-monorepo": "link:" }` from root `package.json`
 
 ### Changed
 
@@ -105,11 +105,11 @@ and this project adheres to [Conventional Commits](https://www.conventionalcommi
 #### CI/CD
 
 - **GitHub Actions CI** (`.github/workflows/ci.yml`): lint, typecheck, and test on push to main and pull requests. Node 20/22 matrix, pnpm store caching, concurrency groups. ([`b8f45a7`](../../commit/b8f45a7))
-- **npm publish workflow** (`.github/workflows/publish.yml`): changeset-based publish via `changesets/action@v1`. Creates version PR when changesets pending, publishes `@law2md/core`, `@law2md/usc`, and `law2md` to npm when version PR merged. Requires `NPM_TOKEN` secret. ([`ef8d3b2`](../../commit/ef8d3b2))
+- **npm publish workflow** (`.github/workflows/publish.yml`): changeset-based publish via `changesets/action@v1`. Creates version PR when changesets pending, publishes `@lexbuild/core`, `@lexbuild/usc`, and `lexbuild` to npm when version PR merged. Requires `NPM_TOKEN` secret. ([`ef8d3b2`](../../commit/ef8d3b2))
 
 ### Changed
 
-- **README.md**: updated for public launch — CI badge, npm install instructions, `law2md` command in usage examples, Phase 4 status complete, test count 121→137, link to CONTRIBUTING.md ([`d33e1ff`](../../commit/d33e1ff))
+- **README.md**: updated for public launch — CI badge, npm install instructions, `lexbuild` command in usage examples, Phase 4 status complete, test count 121→137, link to CONTRIBUTING.md ([`d33e1ff`](../../commit/d33e1ff))
 
 ---
 
@@ -120,7 +120,7 @@ and this project adheres to [Conventional Commits](https://www.conventionalcommi
 #### OLRC Downloader
 
 - **Downloader** (`packages/usc/src/downloader.ts`): `downloadTitles()` fetches USC XML zips from OLRC, extracts via `yauzl`, cleans up temp files. Hardcoded `CURRENT_RELEASE_POINT` with `--release-point` override for future automation. ([`69444bc`](../../commit/69444bc))
-- **`law2md download` command** (`packages/cli/src/commands/download.ts`): `--title N` for individual titles, `--all` for all 54, `-o` for output directory. Reports per-title file sizes and elapsed time. ([`1743e7c`](../../commit/1743e7c))
+- **`lexbuild download` command** (`packages/cli/src/commands/download.ts`): `--title N` for individual titles, `--all` for all 54, `-o` for output directory. Reports per-title file sizes and elapsed time. ([`1743e7c`](../../commit/1743e7c))
 
 #### Dry-Run Mode
 
@@ -205,13 +205,13 @@ and this project adheres to [Conventional Commits](https://www.conventionalcommi
 
 #### Scaffold
 
-- **Monorepo scaffold** with pnpm workspaces, Turborepo pipeline (build/test/lint/typecheck/dev), and three packages: `@law2md/core`, `@law2md/usc`, `law2md` (CLI) ([`9f55906`](../../commit/9f55906))
+- **Monorepo scaffold** with pnpm workspaces, Turborepo pipeline (build/test/lint/typecheck/dev), and three packages: `@lexbuild/core`, `@lexbuild/usc`, `lexbuild` (CLI) ([`9f55906`](../../commit/9f55906))
 - **TypeScript 5.x strict mode** with `tsup` (ESM-only) builds, `noUncheckedIndexedAccess`, `exactOptionalPropertyTypes` ([`9f55906`](../../commit/9f55906))
 - **ESLint** flat config with `typescript-eslint` strict + Prettier integration ([`9f55906`](../../commit/9f55906))
 - **Vitest** per-package test configs with co-located test files ([`9f55906`](../../commit/9f55906))
 - **Fixture directories**: `fixtures/xml/` (gitignored, user-provided USC XML), `fixtures/fragments/` (synthetic test XML), `fixtures/expected/` (output snapshots) ([`9f55906`](../../commit/9f55906))
 
-#### Core (`@law2md/core`)
+#### Core (`@lexbuild/core`)
 
 - **XML Parser** (`src/xml/parser.ts`): streaming SAX parser wrapping `saxes` with namespace normalization — USLM default namespace elements emit bare names (`section`), other namespaces emit prefixed names (`xhtml:table`, `dc:title`). Supports `parseString()` and `parseStream()`. ([`120a553`](../../commit/120a553))
 - **Namespace constants** (`src/xml/namespace.ts`): `USLM_NS`, `XHTML_NS`, `DC_NS`, `DCTERMS_NS`, `XSI_NS`, plus element classification sets (`LEVEL_ELEMENTS`, `CONTENT_ELEMENTS`, `INLINE_ELEMENTS`, `NOTE_ELEMENTS`, etc.) ([`120a553`](../../commit/120a553))
@@ -220,13 +220,13 @@ and this project adheres to [Conventional Commits](https://www.conventionalcommi
 - **Markdown Renderer** (`src/markdown/renderer.ts`): stateless AST-to-Markdown conversion with bold inline numbering for subsections (not headings), three cross-reference link modes (plaintext/canonical/relative), source credits after horizontal rule, notes with H2/H3 headings, and blockquote rendering for quoted content ([`9c7189d`](../../commit/9c7189d))
 - **Frontmatter Generator** (`src/markdown/frontmatter.ts`): `FrontmatterData` to YAML serialization with controlled field ordering, `format_version` ("1.0.0"), and `generator` metadata ([`9c7189d`](../../commit/9c7189d))
 
-#### USC (`@law2md/usc`)
+#### USC (`@lexbuild/usc`)
 
 - **USC Converter** (`src/converter.ts`): full pipeline orchestrator for a single USC XML file — ReadStream → SAX parser → AST builder (emit at section) → Markdown renderer + frontmatter → file writer. Outputs to `usc/title-NN/chapter-NN/section-N.md`. Supports source credit toggling. Uses collect-then-write pattern to avoid async issues during SAX streaming. ([`eb22560`](../../commit/eb22560))
 
-#### CLI (`law2md`)
+#### CLI (`lexbuild`)
 
-- **`law2md convert` command** (`src/commands/convert.ts`): accepts input XML path, output directory, link style, and source credit toggle. Validates input, reports timing and section count, supports verbose mode. ([`2147c05`](../../commit/2147c05))
+- **`lexbuild convert` command** (`src/commands/convert.ts`): accepts input XML path, output directory, link style, and source credit toggle. Validates input, reports timing and section count, supports verbose mode. ([`2147c05`](../../commit/2147c05))
 
 #### Documentation
 
@@ -253,4 +253,4 @@ and this project adheres to [Conventional Commits](https://www.conventionalcommi
 
 ### Changed
 
-- **Barrel exports cleaned up**: removed legacy `USLM_NAMESPACE` / `XHTML_NAMESPACE` / `DC_NAMESPACE` / `DCTERMS_NAMESPACE` aliases from `@law2md/core`. Use `USLM_NS`, `XHTML_NS`, `DC_NS`, `DCTERMS_NS` instead. ([`d42bb21`](../../commit/d42bb21))
+- **Barrel exports cleaned up**: removed legacy `USLM_NAMESPACE` / `XHTML_NAMESPACE` / `DC_NAMESPACE` / `DCTERMS_NAMESPACE` aliases from `@lexbuild/core`. Use `USLM_NS`, `XHTML_NS`, `DC_NS`, `DCTERMS_NS` instead. ([`d42bb21`](../../commit/d42bb21))

CLAUDE.md

@@ -1,17 +1,17 @@
-# CLAUDE.md — law2md
+# CLAUDE.md — lexbuild
 
 ## Project Overview
 
-`law2md` converts U.S. legislative XML (USLM schema) into structured Markdown for AI/RAG ingestion. It is a monorepo built with Turborepo, pnpm workspaces, TypeScript, and Node.js.
+`lexbuild` converts U.S. legislative XML (USLM schema) into structured Markdown for AI/RAG ingestion. It is a monorepo built with Turborepo, pnpm workspaces, TypeScript, and Node.js.
 
 ## Repository Structure
 
 ```
-law2md/
+lexbuild/
 ├── packages/
-│   ├── core/        # @law2md/core — XML parsing, AST, Markdown rendering, shared utilities
-│   ├── usc/         # @law2md/usc — U.S. Code-specific element handlers and downloader
-│   └── cli/         # law2md — CLI binary (the published npm package users install)
+│   ├── core/        # @lexbuild/core — XML parsing, AST, Markdown rendering, shared utilities
+│   ├── usc/         # @lexbuild/usc — U.S. Code-specific element handlers and downloader
+│   └── cli/         # lexbuild — CLI binary (the published npm package users install)
 ├── downloads/
 │   └── usc/
 │       └── xml/     # Full USC XML files (usc01.xml ... usc54.xml) — gitignored
@@ -50,13 +50,13 @@ pnpm install
 pnpm turbo build
 
 # Build a specific package
-pnpm turbo build --filter=@law2md/core
+pnpm turbo build --filter=@lexbuild/core
 
 # Run all tests
 pnpm turbo test
 
 # Run tests for a specific package
-pnpm turbo test --filter=@law2md/usc
+pnpm turbo test --filter=@lexbuild/usc
 
 # Type check
 pnpm turbo typecheck
@@ -313,9 +313,9 @@ output/usc/title-{NN}/chapter-{NN}/section-{N}.md
 > **Note**: The extension architecture is aspirational. No pluggable handler interfaces exist yet — element handling is built into the `ASTBuilder` class. See `docs/extending.md` for details.
 
 1. Create a new package: `packages/cfr/` (or `packages/state-il/`, etc.)
-2. Implement a converter function analogous to `convertTitle()` in `@law2md/usc`
+2. Implement a converter function analogous to `convertTitle()` in `@lexbuild/usc`
 3. Extend or adapt the `ASTBuilder` for source-specific elements
 4. Add a new CLI command in `packages/cli`
-5. Reuse `@law2md/core` for XML parsing, AST types, Markdown rendering, and frontmatter
+5. Reuse `@lexbuild/core` for XML parsing, AST types, Markdown rendering, and frontmatter
 6. Add source-specific download logic if applicable
 7. Document the source's XML schema in the package README

CONTRIBUTING.md

@@ -1,4 +1,4 @@
-# Contributing to law2md
+# Contributing to lexbuild
 
 Thanks for your interest in contributing! This guide covers everything you need to get set up and submit changes.
 
@@ -10,8 +10,8 @@ Thanks for your interest in contributing! This guide covers everything you need
 ## Setup
 
 ```bash
-git clone https://github.com/chris-c-thomas/law2md.git
-cd law2md
+git clone https://github.com/chris-c-thomas/lexbuild.git
+cd lexbuild
 pnpm install
 pnpm turbo build
 ```
@@ -37,9 +37,9 @@ pnpm turbo dev          # Watch mode (rebuild on change)
 To scope commands to a single package:
 
 ```bash
-pnpm turbo build --filter=@law2md/core
-pnpm turbo test --filter=@law2md/usc
-pnpm turbo test --filter=law2md
+pnpm turbo build --filter=@lexbuild/core
+pnpm turbo test --filter=@lexbuild/usc
+pnpm turbo test --filter=lexbuild
 ```
 
 ### Running the CLI Locally
@@ -65,9 +65,9 @@ Formatting is enforced by Prettier (double quotes, trailing commas, 100 char pri
 
 ```
 packages/
-  core/    @law2md/core — XML parsing, AST, Markdown rendering, shared utilities
-  usc/    @law2md/usc — U.S. Code conversion logic and OLRC downloader
-  cli/    law2md — CLI entry point (the published npm package)
+  core/    @lexbuild/core — XML parsing, AST, Markdown rendering, shared utilities
+  usc/    @lexbuild/usc — U.S. Code conversion logic and OLRC downloader
+  cli/    lexbuild — CLI entry point (the published npm package)
 ```
 
 The `core` package provides the general-purpose XML-to-Markdown pipeline. The `usc` package adds U.S. Code-specific handling. The `cli` package wires everything together as a command-line tool. Internal packages use `workspace:*` protocol for dependencies.
@@ -103,7 +103,7 @@ Tests are co-located with source files (`parser.ts` → `parser.test.ts`).
 
 ```bash
 pnpm turbo test                          # Run all tests
-pnpm turbo test --filter=@law2md/usc     # Run one package
+pnpm turbo test --filter=@lexbuild/usc     # Run one package
 ```
 
 Name test cases descriptively:
@@ -128,7 +128,7 @@ Review the diff in `fixtures/expected/` to confirm only intended changes, then c
 
 - `fixtures/fragments/` — Small synthetic XML snippets for unit tests (committed)
 - `fixtures/expected/` — Pinned expected output for snapshot tests (committed)
-- `downloads/usc/xml/` — Full USC XML files (gitignored, download with `law2md download`)
+- `downloads/usc/xml/` — Full USC XML files (gitignored, download with `lexbuild download`)
 
 ## Submitting Changes