@libar-dev/architect 1.0.0-pre.3 → 1.0.0-pre.4

package/docs/DOCS-GAP-ANALYSIS.md

@@ -74,22 +74,22 @@ generated equivalents. Work packages in this gap analysis should map to its phas
 
 **Deliverable Status (from spec Background):**
 
-| Deliverable                                 | Status   | Phase | Maps to WP                                      |
-| ------------------------------------------- | -------- | ----- | ----------------------------------------------- |
-| Preamble capability on ReferenceDocConfig   | complete | --    | N/A (done)                                      |
-| Phase 1 - Taxonomy consolidation            | pending  | 35    | Taxonomy deprecation                            |
-| Phase 2 - Codec listings extraction         | complete | 35    | N/A (done)                                      |
-| Phase 3 - Process Guard consolidation       | pending  | 35    | WP-5                                            |
-| Phase 4 - Architecture decomposition        | complete | 35    | N/A (done)                                      |
-| Phase 5 - Guide trimming                    | pending  | 35    | WP-9                                            |
-| Phase 6 - Index navigation update           | pending  | 35    | WP-2                                            |
-| Phase 37 - docs-live/ consolidation         | complete | 37    | N/A (done, commit 223ace6)                      |
-| Phase 38 - Generated doc quality            | pending  | 38    | WP-9                                            |
-| Phase 39 - Session workflow module gen      | pending  | 39    | Blocked on Phase 25                             |
-| Phase 40 - PUBLISHING.md relocation         | complete | 40    | N/A (done)                                      |
-| Phase 41 - GHERKIN-PATTERNS.md restructure  | pending  | 41    | WP-7                                            |
-| Phase 42 - README.md rationalization        | pending  | 42    | Not in this analysis                            |
-| Phase 43 - PROCESS-API.md hybrid generation | complete | 43    | N/A (done); WP-6 extends with recipe generation |
+| Deliverable                                | Status   | Phase | Maps to WP                                      |
+| ------------------------------------------ | -------- | ----- | ----------------------------------------------- |
+| Preamble capability on ReferenceDocConfig  | complete | --    | N/A (done)                                      |
+| Phase 1 - Taxonomy consolidation           | pending  | 35    | Taxonomy deprecation                            |
+| Phase 2 - Codec listings extraction        | complete | 35    | N/A (done)                                      |
+| Phase 3 - Process Guard consolidation      | pending  | 35    | WP-5                                            |
+| Phase 4 - Architecture decomposition       | complete | 35    | N/A (done)                                      |
+| Phase 5 - Guide trimming                   | pending  | 35    | WP-9                                            |
+| Phase 6 - Index navigation update          | pending  | 35    | WP-2                                            |
+| Phase 37 - docs-live/ consolidation        | complete | 37    | N/A (done, commit 223ace6)                      |
+| Phase 38 - Generated doc quality           | pending  | 38    | WP-9                                            |
+| Phase 39 - Session workflow module gen     | pending  | 39    | Blocked on Phase 25                             |
+| Phase 40 - PUBLISHING.md relocation        | complete | 40    | N/A (done)                                      |
+| Phase 41 - GHERKIN-PATTERNS.md restructure | pending  | 41    | WP-7                                            |
+| Phase 42 - README.md rationalization       | pending  | 42    | Not in this analysis                            |
+| Phase 43 - CLI.md hybrid generation        | complete | 43    | N/A (done); WP-6 extends with recipe generation |
 
 **Key Invariants from Spec:**
 
@@ -113,10 +113,10 @@ generated equivalents. Work packages in this gap analysis should map to its phas
 | `publishing-relocation.feature`              | PublishingRelocation            | completed | 40    | Moved PUBLISHING.md to MAINTAINERS.md            |
 | `codec-driven-reference-generation.feature`  | CodecDrivenReferenceGeneration  | completed | 27    | Foundation: config-driven codec factory          |
 | `doc-generation-proof-of-concept.feature`    | DocGenerationProofOfConcept     | completed | 27    | Historical: ADR-021 POC (superseded)             |
-| `process-api-hybrid-generation.feature`      | ProcessApiHybridGeneration      | completed | 43    | CLI schema as single source for reference tables |
+| `cli-reference-generation.feature`           | CliReferenceGeneration          | completed | 43    | CLI schema as single source for reference tables |
 | `claude-module-generation.feature`           | ClaudeModuleGeneration          | completed | 25    | Claude module tags + behavior spec sourcing      |
 | `reference-doc-showcase.feature`             | ReferenceDocShowcase            | completed | 30    | All 9 content block types across 3 detail levels |
-| `validator-read-model-consolidation.feature` | ValidatorReadModelConsolidation | completed | 100   | MasterDataset as single read model (ADR-006)     |
+| `validator-read-model-consolidation.feature` | ValidatorReadModelConsolidation | completed | 100   | PatternGraph as single read model (ADR-006)      |
 
 **Query these specs:** `pnpm architect:query -- decisions DocsConsolidationStrategy`
 
@@ -183,7 +183,7 @@ Step 5: Replace manual doc section with pointer to generated output
 | Tag Value               | Used By                | Produces                             |
 | ----------------------- | ---------------------- | ------------------------------------ |
 | `codec-registry`        | ARCHITECTURE-CODECS.md | All 20 codecs with factory patterns  |
-| `pipeline-architecture` | ARCHITECTURE-TYPES.md  | MasterDataset interface, shapes      |
+| `pipeline-architecture` | ARCHITECTURE-TYPES.md  | PatternGraph interface, shapes       |
 | `taxonomy-rules`        | REFERENCE-SAMPLE.md    | Tag rules + 6 diagram types showcase |
 
 ### What This Means for New Work
@@ -216,17 +216,17 @@ architect/
 
 ### What `pnpm docs:all` Generates (9 generators)
 
-| Generator               | Output Location           | Files | Content                                          |
-| ----------------------- | ------------------------- | ----- | ------------------------------------------------ |
-| `adrs`                  | docs-live/decisions/      | 8     | ADR index + 7 individual ADRs                    |
-| `business-rules`        | docs-live/business-rules/ | 8     | Overview + 7 area breakdowns (569 rules)         |
-| `taxonomy`              | docs-live/taxonomy/       | 4     | Overview + categories, formats, metadata tags    |
-| `validation-rules`      | docs-live/validation/     | 4     | Overview + error catalog, FSM, protection levels |
-| `reference-docs`        | docs-live/reference/      | 4     | Codecs, types, process-API ref, sample           |
-| `product-area-docs`     | docs-live/product-areas/  | 8     | Overview + 7 area docs with diagrams             |
-| `claude-modules`        | docs-live/\_claude-md/    | 10    | Compact AI context modules                       |
-| `process-api-reference` | docs-live/reference/      | 1     | CLI command reference                            |
-| `cli-recipe`            | docs-live/reference/      | 1     | CLI recipes & workflow guide                     |
+| Generator           | Output Location           | Files | Content                                          |
+| ------------------- | ------------------------- | ----- | ------------------------------------------------ |
+| `adrs`              | docs-live/decisions/      | 8     | ADR index + 7 individual ADRs                    |
+| `business-rules`    | docs-live/business-rules/ | 8     | Overview + 7 area breakdowns (569 rules)         |
+| `taxonomy`          | docs-live/taxonomy/       | 4     | Overview + categories, formats, metadata tags    |
+| `validation-rules`  | docs-live/validation/     | 4     | Overview + error catalog, FSM, protection levels |
+| `reference-docs`    | docs-live/reference/      | 4     | Codecs, types, process-API ref, sample           |
+| `product-area-docs` | docs-live/product-areas/  | 8     | Overview + 7 area docs with diagrams             |
+| `claude-modules`    | docs-live/\_claude-md/    | 10    | Compact AI context modules                       |
+| `cli-reference`     | docs-live/reference/      | 1     | CLI command reference                            |
+| `cli-recipe`        | docs-live/reference/      | 1     | CLI recipes & workflow guide                     |
 
 ### What `pnpm docs:all-preview` Adds (14 more generators)
 
@@ -301,17 +301,17 @@ reference content from `docs-live/` instead of `docs-generated/`.
 
 These `docs-live/` subdirectories exist but have no sync function:
 
-| Directory                       | Files    | Content                                                                                                              |
-| ------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------- |
-| `docs-live/reference/`          | 5 files  | ARCHITECTURE-CODECS.md, ARCHITECTURE-TYPES.md, PROCESS-API-RECIPES.md, PROCESS-API-REFERENCE.md, REFERENCE-SAMPLE.md |
-| `docs-live/taxonomy/`           | 3 files  | categories.md, format-types.md, metadata-tags.md                                                                     |
-| `docs-live/validation/`         | 3 files  | error-catalog.md, fsm-transitions.md, protection-levels.md                                                           |
-| `docs-live/business-rules/`     | 7 files  | Per-area business rule extractions                                                                                   |
-| `docs-live/_claude-md/`         | 10 files | AI context (may not need website publishing)                                                                         |
-| `docs-live/INDEX.md`            | 1 file   | Generated docs master index                                                                                          |
-| `docs-live/TAXONOMY.md`         | 1 file   | Taxonomy overview                                                                                                    |
-| `docs-live/VALIDATION-RULES.md` | 1 file   | Validation rules overview                                                                                            |
-| `docs-live/BUSINESS-RULES.md`   | 1 file   | Business rules overview                                                                                              |
+| Directory                       | Files    | Content                                                                                              |
+| ------------------------------- | -------- | ---------------------------------------------------------------------------------------------------- |
+| `docs-live/reference/`          | 5 files  | ARCHITECTURE-CODECS.md, ARCHITECTURE-TYPES.md, CLI-RECIPES.md, CLI-REFERENCE.md, REFERENCE-SAMPLE.md |
+| `docs-live/taxonomy/`           | 3 files  | categories.md, format-types.md, metadata-tags.md                                                     |
+| `docs-live/validation/`         | 3 files  | error-catalog.md, fsm-transitions.md, protection-levels.md                                           |
+| `docs-live/business-rules/`     | 7 files  | Per-area business rule extractions                                                                   |
+| `docs-live/_claude-md/`         | 10 files | AI context (may not need website publishing)                                                         |
+| `docs-live/INDEX.md`            | 1 file   | Generated docs master index                                                                          |
+| `docs-live/TAXONOMY.md`         | 1 file   | Taxonomy overview                                                                                    |
+| `docs-live/VALIDATION-RULES.md` | 1 file   | Validation rules overview                                                                            |
+| `docs-live/BUSINESS-RULES.md`   | 1 file   | Business rules overview                                                                              |
 
 ---
 
@@ -334,7 +334,7 @@ These `docs-live/` subdirectories exist but have no sync function:
 | **ARCHITECTURE.md**     | 1,638 | docs-live/product-areas/GENERATION.md (1,065 lines) + docs-live/reference/ARCHITECTURE-CODECS.md (630 lines) + docs-live/reference/ARCHITECTURE-TYPES.md (429 lines) | Partial      | Generated covers pipeline stages and codec listings well. Missing: executive summary, data flow diagrams, workflow integration section, "Extending the System" guide, programmatic usage examples, quick reference card.                                                                            |
 | **GHERKIN-PATTERNS.md** | 366   | None                                                                                                                                                                 | None         | Authoring style guide: 4 essential patterns, DataTable/DocString usage, tag conventions, feature file rich content rules, step linting reference. Pure editorial guidance -- no annotation source exists.                                                                                           |
 | **ANNOTATION-GUIDE.md** | 270   | docs-live/taxonomy/metadata-tags.md (649 lines)                                                                                                                      | Partial      | Generated has exhaustive tag reference (56 tags). Missing: getting-started guide, shape extraction modes explanation, "Zod schema gotcha" documentation, verification steps, common issues troubleshooting table.                                                                                   |
-| **PROCESS-API.md**      | ~60   | docs-live/reference/PROCESS-API-REFERENCE.md + PROCESS-API-RECIPES.md                                                                                                | **Replaced** | Trimmed to pointer file with operational reference (JSON envelope, exit codes, piping). All prose content now generated by CliRecipeCodec (WP-6 complete).                                                                                                                                          |
+| **CLI.md**              | ~60   | docs-live/reference/CLI-REFERENCE.md + CLI-RECIPES.md                                                                                                                | **Replaced** | Trimmed to pointer file with operational reference (JSON envelope, exit codes, piping). All prose content now generated by CliRecipeCodec (WP-6 complete).                                                                                                                                          |
 | **PROCESS-GUARD.md**    | 341   | docs-live/validation/error-catalog.md (79 lines) + docs-live/validation/fsm-transitions.md (49 lines) + docs-live/validation/protection-levels.md                    | Partial      | Generated has error types, FSM matrix, protection levels. Missing: error fix rationale ("why this rule exists"), escape hatch alternatives, pre-commit setup instructions (Husky), programmatic API guide, Decider pattern architecture diagram.                                                    |
 | **VALIDATION.md**       | 418   | docs-live/product-areas/VALIDATION.md (1,115 lines)                                                                                                                  | Partial      | Generated has pattern listings and business rules. Missing: "Which command do I run?" decision tree, 32+ individual lint rule explanations with code examples, anti-pattern detection rationale, CI/CD integration patterns (GitHub Actions YAML), vitest-cucumber two-pattern problem explanation. |
 | **TAXONOMY.md**         | 107   | docs-live/TAXONOMY.md (199 lines) + docs-live/taxonomy/ (3 files)                                                                                                    | Good         | Generated taxonomy reference is actually more comprehensive than manual. Manual adds: architecture explanation (file structure of src/taxonomy/), preset-to-taxonomy mapping, generation commands. Small gap.                                                                                       |
@@ -354,18 +354,18 @@ These `docs-live/` subdirectories exist but have no sync function:
 
 ### 7.1 Missing Content Types in Generated Docs
 
-| Content Type                 | Present in docs/                         | Present in docs-live/        | Examples                                                                          |
-| ---------------------------- | ---------------------------------------- | ---------------------------- | --------------------------------------------------------------------------------- |
-| Decision trees               | Yes (3 docs)                             | No                           | "Which validation command?", "Which session type?", "When to use design session?" |
-| Step-by-step checklists      | Yes (SESSION-GUIDES)                     | No                           | Planning session checklist, implementation 5-step execution order                 |
-| CLI recipes with output      | Yes (PROCESS-API)                        | Yes (PROCESS-API-RECIPES.md) | WP-6 complete: generated from CLI_SCHEMA                                          |
-| Error fix guides             | Yes (PROCESS-GUARD)                      | Partial (error-catalog)      | "completed-protection: add unlock-reason tag" with alternatives                   |
-| Code examples (before/after) | Yes (VALIDATION)                         | No                           | Lint rule violation + fix side-by-side                                            |
-| Philosophical rationale      | Yes (METHODOLOGY)                        | No                           | USDP inversion thesis, event sourcing analogy                                     |
-| Integration patterns         | Yes (VALIDATION, PROCESS-GUARD)          | No                           | Husky pre-commit, GitHub Actions YAML, package.json scripts                       |
-| Getting-started guides       | Yes (ANNOTATION-GUIDE)                   | No                           | "Add your first annotation" walkthrough                                           |
-| Gotcha documentation         | Yes (ANNOTATION-GUIDE, GHERKIN-PATTERNS) | No                           | "Zod schema needs constant not type alias", "# kills Gherkin parsing"             |
-| Audience-based navigation    | Yes (INDEX)                              | No                           | "New user read X, Developer read Y, Team Lead read Z"                             |
+| Content Type                 | Present in docs/                         | Present in docs-live/   | Examples                                                                          |
+| ---------------------------- | ---------------------------------------- | ----------------------- | --------------------------------------------------------------------------------- |
+| Decision trees               | Yes (3 docs)                             | No                      | "Which validation command?", "Which session type?", "When to use design session?" |
+| Step-by-step checklists      | Yes (SESSION-GUIDES)                     | No                      | Planning session checklist, implementation 5-step execution order                 |
+| CLI recipes with output      | Yes (PROCESS-API)                        | Yes (CLI-RECIPES.md)    | WP-6 complete: generated from CLI_SCHEMA                                          |
+| Error fix guides             | Yes (PROCESS-GUARD)                      | Partial (error-catalog) | "completed-protection: add unlock-reason tag" with alternatives                   |
+| Code examples (before/after) | Yes (VALIDATION)                         | No                      | Lint rule violation + fix side-by-side                                            |
+| Philosophical rationale      | Yes (METHODOLOGY)                        | No                      | USDP inversion thesis, event sourcing analogy                                     |
+| Integration patterns         | Yes (VALIDATION, PROCESS-GUARD)          | No                      | Husky pre-commit, GitHub Actions YAML, package.json scripts                       |
+| Getting-started guides       | Yes (ANNOTATION-GUIDE)                   | No                      | "Add your first annotation" walkthrough                                           |
+| Gotcha documentation         | Yes (ANNOTATION-GUIDE, GHERKIN-PATTERNS) | No                      | "Zod schema needs constant not type alias", "# kills Gherkin parsing"             |
+| Audience-based navigation    | Yes (INDEX)                              | No                      | "New user read X, Developer read Y, Team Lead read Z"                             |
 
 ### 7.2 Structural Quality Comparison
 
@@ -559,9 +559,9 @@ This replaces the manual PROCESS-GUARD.md "Error Messages and Fixes" section.
 **Type:** Design + Implementation
 **Scope:** architect repo
 **Effort:** Medium (2-3 sessions)
-**Spec alignment:** Extends ProcessApiHybridGeneration (Phase 43, completed). Phase 43
+**Spec alignment:** Extends CliReferenceGeneration (Phase 43, completed). Phase 43
 generated reference tables from CLI schema; this adds recipe/guide content. The manual
-PROCESS-API.md prose was explicitly kept in Phase 43 -- this WP addresses that remainder.
+CLI.md prose was explicitly kept in Phase 43 -- this WP addresses that remainder.
 
 Create a codec that generates CLI recipe guides from:
 
@@ -569,11 +569,11 @@ Create a codec that generates CLI recipe guides from:
 - New `**Recipe:**` annotation in feature files
 - Session type metadata
 
-This replaces manual PROCESS-API.md "Common Recipes" and "Session Workflow Commands".
+This replaces manual CLI.md "Common Recipes" and "Session Workflow Commands".
 
 **Design questions for session:**
 
-- Extend `ProcessApiReferenceGenerator` or create separate recipe generator?
+- Extend `CliReferenceGenerator` or create separate recipe generator?
 - Where should recipe annotations live? (CLI schema? Feature files? New recipe files?)
 - How to handle "Why Use This" motivational prose? (Preamble?)
 
@@ -623,7 +623,7 @@ METHODOLOGY.md (238 lines) contains philosophy that cannot be extracted from cod
 The master spec already decided to keep it. Design session should confirm and decide:
 
 1. **Keep as-is** (aligned with master spec)
-2. **Encode as invariants** in a feature file for queryability via Process Data API
+2. **Encode as invariants** in a feature file for queryability via Data API
 3. **Merge relevant parts into README.md** as part of Phase 42
 
 **Recommendation:** Option 1, with option 2 as enhancement. The philosophy is
@@ -692,7 +692,7 @@ All other work packages are complete.
 | TAXONOMY.md         | Now (generated version is better) | WP-1 (sync fix)                         |
 | ARCHITECTURE.md     | WP-3 + WP-9                       | Architecture generator + quality polish |
 | PROCESS-GUARD.md    | WP-5                              | Error guide codec                       |
-| PROCESS-API.md      | Done (WP-6 complete)              | Trimmed to pointer file                 |
+| CLI.md              | Done (WP-6 complete)              | Trimmed to pointer file                 |
 | ANNOTATION-GUIDE.md | WP-7 (partial)                    | Guide codec with getting-started        |
 | VALIDATION.md       | WP-5 + WP-7                       | Error guide + procedural guides         |
 | SESSION-GUIDES.md   | WP-7                              | Procedural guide codec                  |
@@ -736,10 +736,10 @@ ProceduralGuideCodec) have completed design sessions with findings and code stub
   load time by a shared `loadPreambleFromMarkdown()` utility (DD-7/DD-8).
 - **ErrorGuideCodec** extends the existing `ValidationRulesCodec` with a new
   `includeErrorGuide` toggle and convention-tagged annotations on `src/lint/` source.
-- **CliRecipeCodec** creates a sibling `CliRecipeGenerator` to `ProcessApiReferenceGenerator`,
+- **CliRecipeCodec** creates a sibling `CliRecipeGenerator` to `CliReferenceGenerator`,
   both standalone `DocumentGenerator` implementations consuming `CLI_SCHEMA` directly.
 - **EnhancedIndexGeneration** creates a new `IndexCodec` registered in `CodecRegistry`,
-  composing MasterDataset-driven statistics with editorial preamble navigation content.
+  composing PatternGraph-driven statistics with editorial preamble navigation content.
 
 **Master spec status:** 11/15 deliverables complete. WP-2 (IndexCodec) implementation
 is complete but manual docs/ files are preserved as reference — Phase 1 (taxonomy
@@ -761,7 +761,7 @@ pending until generated docs reach quality parity for manual doc archival. Phase
 | CONFIGURATION.md    | 357   | Partial (options auto, rationale manual)    |
 | GHERKIN-PATTERNS.md | 366   | Low (style guide is editorial)              |
 | METHODOLOGY.md      | 238   | None (philosophy)                           |
-| PROCESS-API.md      | ~60   | Complete (pointer file + generated recipes) |
+| CLI.md              | ~60   | Complete (pointer file + generated recipes) |
 | PROCESS-GUARD.md    | 341   | Partial (rules auto, fix guides manual)     |
 | SESSION-GUIDES.md   | 389   | Low (checklists are procedural)             |
 | TAXONOMY.md         | 107   | High (generated version is better)          |
@@ -782,7 +782,7 @@ adr-001 through adr-006, adr-021
 annotation.md, configuration.md, core-types.md, data-api.md, generation.md, process.md, validation.md
 
 **Reference (5 files):**
-ARCHITECTURE-CODECS.md, ARCHITECTURE-TYPES.md, PROCESS-API-RECIPES.md, PROCESS-API-REFERENCE.md, REFERENCE-SAMPLE.md
+ARCHITECTURE-CODECS.md, ARCHITECTURE-TYPES.md, CLI-RECIPES.md, CLI-REFERENCE.md, REFERENCE-SAMPLE.md
 
 **Taxonomy (3 files):**
 categories.md, format-types.md, metadata-tags.md
@@ -806,6 +806,6 @@ error-catalog.md, fsm-transitions.md, protection-levels.md
 
 ### D. Codec Inventory (22 total)
 
-**In docs:all (9):** adrs, business-rules, taxonomy, validation-rules, reference-docs, product-area-docs, claude-modules, process-api-reference, cli-recipe
+**In docs:all (9):** adrs, business-rules, taxonomy, validation-rules, reference-docs, product-area-docs, claude-modules, cli-reference, cli-recipe
 
 **In docs:all-preview only (14):** patterns, roadmap, milestones, requirements, session, remaining, current, session-plan, session-findings, pr-changes, changelog, traceability, architecture, overview-rdm

package/docs/INDEX.md

@@ -29,7 +29,7 @@
 | Write Gherkin specs         | [GHERKIN-PATTERNS.md](./GHERKIN-PATTERNS.md) | 1-515  |
 | Enforce process rules       | [PROCESS-GUARD.md](./PROCESS-GUARD.md)       | 1-341  |
 | Validate annotation quality | [VALIDATION.md](./VALIDATION.md)             | 1-281  |
-| Query process state via CLI | [PROCESS-API.md](./PROCESS-API.md)           | 1-507  |
+| Query pattern graph via CLI | [CLI.md](./CLI.md)                           | 1-507  |
 | Understand the taxonomy     | [TAXONOMY.md](./TAXONOMY.md)                 | 1-105  |
 | Publish to npm              | [MAINTAINERS.md](../MAINTAINERS.md)          | —      |
 | Learn annotation patterns   | [ANNOTATION-GUIDE.md](./ANNOTATION-GUIDE.md) | 1-268  |
@@ -48,8 +48,8 @@
 
 ### For Developers / AI
 
-4. **[ARCHITECTURE.md](./ARCHITECTURE.md)** — Four-stage pipeline, codecs, MasterDataset
-5. **[PROCESS-API.md](./PROCESS-API.md)** — Data API CLI query interface
+4. **[ARCHITECTURE.md](./ARCHITECTURE.md)** — Four-stage pipeline, codecs, PatternGraph
+5. **[CLI.md](./CLI.md)** — Data API CLI query interface
 6. **[SESSION-GUIDES.md](./SESSION-GUIDES.md)** — Planning/Design/Implementation workflows
 7. **[GHERKIN-PATTERNS.md](./GHERKIN-PATTERNS.md)** — Writing effective Gherkin specs
 8. **[ANNOTATION-GUIDE.md](./ANNOTATION-GUIDE.md)** — Annotation mechanics, shape extraction, tag quick reference
@@ -117,22 +117,22 @@
 
 ### ARCHITECTURE.md (Lines 1-1638)
 
-| Section                    | Lines     | Key Topics                                                        |
-| -------------------------- | --------- | ----------------------------------------------------------------- |
-| Executive Summary          | 28-69     | What it does, key principles (incl. Single Read Model), overview  |
-| Configuration Architecture | 70-139    | Entry point, pipeline effects, resolution                         |
-| Four-Stage Pipeline        | 140-343   | Scanner → Extractor → Pipeline Factory → Transformer → Codec      |
-| Unified Transformation     | 345-478   | MasterDataset schema (relationshipIndex + archIndex), single-pass |
-| Codec Architecture         | 481-527   | Concepts, block vocabulary, factory, 3 renderers                  |
-| Available Codecs           | 529-870   | All 20 codecs with options tables                                 |
-| Progressive Disclosure     | 871-917   | Split logic, detail levels                                        |
-| Source Systems             | 919-1024  | TypeScript scanner, Gherkin scanner                               |
-| Key Design Patterns        | 1026-1105 | Result monad, schema-first, tag registry                          |
-| Data Flow Diagrams         | 1107-1290 | Pipeline flow, factory entry point, MasterDataset views, codecs   |
-| Workflow Integration       | 1292-1401 | Planning, implementing, release workflows                         |
-| Programmatic Usage         | 1403-1458 | Direct codec usage, generateDocument                              |
-| Extending the System       | 1460-1527 | Custom codec, custom generator                                    |
-| Quick Reference            | 1529-1604 | Codec-to-generator mapping, CLI, filters                          |
+| Section                    | Lines     | Key Topics                                                       |
+| -------------------------- | --------- | ---------------------------------------------------------------- |
+| Executive Summary          | 28-69     | What it does, key principles (incl. Single Read Model), overview |
+| Configuration Architecture | 70-139    | Entry point, pipeline effects, resolution                        |
+| Four-Stage Pipeline        | 140-343   | Scanner → Extractor → Pipeline Factory → Transformer → Codec     |
+| Unified Transformation     | 345-478   | PatternGraph schema (relationshipIndex + archIndex), single-pass |
+| Codec Architecture         | 481-527   | Concepts, block vocabulary, factory, 3 renderers                 |
+| Available Codecs           | 529-870   | All 20 codecs with options tables                                |
+| Progressive Disclosure     | 871-917   | Split logic, detail levels                                       |
+| Source Systems             | 919-1024  | TypeScript scanner, Gherkin scanner                              |
+| Key Design Patterns        | 1026-1105 | Result monad, schema-first, tag registry                         |
+| Data Flow Diagrams         | 1107-1290 | Pipeline flow, factory entry point, PatternGraph views, codecs   |
+| Workflow Integration       | 1292-1401 | Planning, implementing, release workflows                        |
+| Programmatic Usage         | 1403-1458 | Direct codec usage, generateDocument                             |
+| Extending the System       | 1460-1527 | Custom codec, custom generator                                   |
+| Quick Reference            | 1529-1604 | Codec-to-generator mapping, CLI, filters                         |
 
 #### Available Codecs Reference
 
@@ -194,7 +194,7 @@
 
 ---
 
-### PROCESS-API.md (Lines 1-507)
+### CLI.md (Lines 1-507)
 
 | Section                   | Lines   | Key Topics                                                  |
 | ------------------------- | ------- | ----------------------------------------------------------- |
@@ -231,18 +231,18 @@
 
 ### VALIDATION.md (Lines 1-281)
 
-| Section               | Lines   | Key Topics                                        |
-| --------------------- | ------- | ------------------------------------------------- |
-| Which Command?        | 7-24    | Decision tree for validation commands             |
-| Command Summary       | 26-35   | lint-patterns, lint-steps, lint-process, validate |
-| lint-patterns         | 37-74   | 8 rules table, CLI flags                          |
-| lint-steps            | 76-98   | 12 rules, 3 categories, vitest-cucumber traps     |
-| lint-process          | 100-121 | What it validates, reference links                |
-| validate-patterns     | 123-197 | CLI flags, checks, anti-patterns, DoD             |
-| CI/CD Integration     | 199-238 | Consumer scripts, hooks, GitHub Actions           |
-| Exit Codes            | 240-248 | Per-command exit code table                       |
-| Programmatic API      | 250-272 | Import paths for all validators                   |
-| Related Documentation | 274-281 | Links to GHERKIN-PATTERNS, PROCESS-GUARD, CONFIG  |
+| Section               | Lines   | Key Topics                                           |
+| --------------------- | ------- | ---------------------------------------------------- |
+| Which Command?        | 7-24    | Decision tree for validation commands                |
+| Command Summary       | 26-35   | lint-patterns, lint-steps, architect-guard, validate |
+| lint-patterns         | 37-74   | 8 rules table, CLI flags                             |
+| lint-steps            | 76-98   | 12 rules, 3 categories, vitest-cucumber traps        |
+| architect-guard       | 100-121 | What it validates, reference links                   |
+| validate-patterns     | 123-197 | CLI flags, checks, anti-patterns, DoD                |
+| CI/CD Integration     | 199-238 | Consumer scripts, hooks, GitHub Actions              |
+| Exit Codes            | 240-248 | Per-command exit code table                          |
+| Programmatic API      | 250-272 | Import paths for all validators                      |
+| Related Documentation | 274-281 | Links to GHERKIN-PATTERNS, PROCESS-GUARD, CONFIG     |
 
 ---
 
@@ -301,7 +301,7 @@ deferred ──→ roadmap
 
 The CLI is the **recommended way** to gather context in any session type.
 It queries annotated sources in real time — not generated snapshots.
-See [PROCESS-API.md](./PROCESS-API.md).
+See [CLI.md](./CLI.md).
 
 ```bash
 pnpm architect:query -- scope-validate MyPattern implement      # ALWAYS run first
@@ -320,7 +320,7 @@ pnpm architect:query -- handoff --pattern MyPattern              # Capture sessi
 | METHODOLOGY.md      | Everyone    | Why — core thesis, principles     |
 | CONFIGURATION.md    | Users       | Setup — presets, tags, config     |
 | ARCHITECTURE.md     | Developers  | How — pipeline, codecs, schemas   |
-| PROCESS-API.md      | AI/Devs     | Data API CLI query interface      |
+| CLI.md              | AI/Devs     | Data API CLI query interface      |
 | SESSION-GUIDES.md   | AI/Devs     | Workflow — day-to-day usage       |
 | GHERKIN-PATTERNS.md | Writers     | Specs — writing effective Gherkin |
 | PROCESS-GUARD.md    | Team Leads  | Governance — enforcement rules    |

package/docs/MCP-SETUP.md

@@ -1,6 +1,6 @@
 # MCP Server Setup
 
-> Architect MCP server exposes ProcessStateAPI as native Claude Code tools with sub-millisecond dispatch.
+> Architect MCP server exposes PatternGraphAPI as native Claude Code tools with sub-millisecond dispatch.
 
 ## Quick Start
 
@@ -78,8 +78,8 @@ Override config auto-detection for monorepo setups:
 The MCP server:
 
 1. **Loads the pipeline once** — config detection, scanning, extraction, transformation (~1-2s)
-2. **Keeps MasterDataset in memory** — all subsequent queries are O(1) lookups
-3. **Exposes 25 tools** — each wrapping a ProcessStateAPI method or CLI subcommand
+2. **Keeps PatternGraph in memory** — all subsequent queries are O(1) lookups
+3. **Exposes 25 tools** — each wrapping a PatternGraphAPI method or CLI subcommand
 4. **Optionally watches files** — auto-rebuilds on source changes (500ms debounce)
 
 ## Available Tools

package/docs/METHODOLOGY.md

@@ -27,7 +27,7 @@ Event sourcing teaches us: **derive state, don't store it**. Apply this to docum
 
 - **Events** = Git commits (changes to annotated code)
 - **Projections** = Generated docs (PATTERNS.md, ROADMAP.md)
-- **Read Model** = MasterDataset (consumed by codecs, validators, and Data API CLI)
+- **Read Model** = PatternGraph (consumed by codecs, validators, and Data API CLI)
 
 When you run `architect-generate`, you're rebuilding read models from the event stream. The source annotations are always authoritative.
 

package/docs/SESSION-GUIDES.md

@@ -104,7 +104,7 @@ pnpm architect:query -- dep-tree <PatternName>                  # Dependency cha
 pnpm architect:query -- stubs <PatternName>                     # Existing design stubs
 ```
 
-Use these **before** launching explore agents. See [PROCESS-API.md](./PROCESS-API.md).
+Use these **before** launching explore agents. See [CLI.md](./CLI.md).
 
 ### When Required
 
@@ -181,7 +181,7 @@ pnpm architect:query -- files <PatternName> --related
 
 The `scope-validate` command replaces the manual pre-flight checklist — it checks
 dependency completion, deliverable definitions, FSM validity, and design decisions.
-See [PROCESS-API.md](./PROCESS-API.md#scope-validate).
+See [CLI.md](./CLI.md#scope-validate).
 
 ### Execution Checklist
 
@@ -387,5 +387,5 @@ Valid transitions: See [METHODOLOGY.md#fsm-enforced-workflow](./METHODOLOGY.md#f
 | [GHERKIN-PATTERNS.md](./GHERKIN-PATTERNS.md) | DataTables, DocStrings, Rule blocks               |
 | [CONFIGURATION.md](./CONFIGURATION.md)       | Tag prefixes, presets                             |
 | [TAXONOMY.md](./TAXONOMY.md)                 | Tag taxonomy concepts and API                     |
-| [PROCESS-API.md](./PROCESS-API.md)           | Data API CLI commands for all session types       |
+| [CLI.md](./CLI.md)                           | Data API CLI commands for all session types       |
 | [VALIDATION.md](./VALIDATION.md)             | CLI flags for lint-patterns and validate-patterns |

package/docs/VALIDATION.md

@@ -16,7 +16,7 @@ Need to check vitest-cucumber compatibility?
 ├─ Yes → lint-steps
 │
 Need FSM workflow validation?
-├─ Yes → lint-process
+├─ Yes → architect-guard
 │
 Need cross-source or DoD validation?
 ├─ Yes → validate-patterns
@@ -234,7 +234,7 @@ Step files:     tests/steps/**/*.steps.ts
 
 ---
 
-## lint-process
+## architect-guard
 
 FSM validation for delivery workflow (PDR-005). Enforces status transitions and protection levels.
 
@@ -298,7 +298,7 @@ npx validate-patterns \
 
 ### Architecture Note (ADR-006)
 
-Cross-source validation now consumes the `MasterDataset` via the shared pipeline factory (`buildMasterDataset()`) with `mergeConflictStrategy: 'concatenate'`. This enables implements-aware matching through `relationshipIndex.implementedBy` — the validator no longer re-derives cross-source relationships from raw scanner output.
+Cross-source validation now consumes the `PatternGraph` via the shared pipeline factory (`buildPatternGraph()`) with `mergeConflictStrategy: 'concatenate'`. This enables implements-aware matching through `relationshipIndex.implementedBy` — the validator no longer re-derives cross-source relationships from raw scanner output.
 
 Raw scans are retained only for DoD and anti-pattern detection, which are stage-1 consumers that validate annotation syntax directly on scanned files (no relationship resolution needed).
 
@@ -402,7 +402,7 @@ import { deriveProcessState, validateChanges } from '@libar-dev/architect/lint';
 import { detectAntiPatterns, validateDoD } from '@libar-dev/architect/validation';
 ```
 
-`validatePatterns()` now accepts a `RuntimeMasterDataset`. Build one via `buildMasterDataset()` from `@libar-dev/architect/generators`.
+`validatePatterns()` now accepts a `RuntimePatternGraph`. Build one via `buildPatternGraph()` from `@libar-dev/architect/generators`.
 
 See [ARCHITECTURE.md](./ARCHITECTURE.md) for detailed API documentation.