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

package/docs-live/CHANGELOG-GENERATED.md

@@ -17,7 +17,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - **Deliverable Status Taxonomy**: Canonical status values for deliverables in Gherkin Background tables.
 - **MCP Tool Registry**: Defines all MCP tools with Zod input schemas and handler functions.
 - **MCP Server Impl**: Main entry point for the Architect MCP server.
-- **MCP Pipeline Session**: Manages the in-memory MasterDataset lifecycle for the MCP server.
+- **MCP Pipeline Session**: Manages the in-memory PatternGraph lifecycle for the MCP server.
 - **MCP Module**: Public API for the MCP server module.
 - **MCP File Watcher**: Watches source file globs and triggers debounced pipeline rebuilds.
 - **Git Name Status Parser**: Parses NUL-delimited git name-status output into categorized file lists.
@@ -30,60 +30,62 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - **Source Merger**: Computes effective sources for a specific generator by applying per-generator overrides to the base resolved sources.
 - **Define Config**: Identity function for type-safe project configuration.
 - **File Cache**: Simple Map-based cache for file contents during a single generation run.
-- **Process State Types**: :MasterDataset Type definitions for the ProcessStateAPI query interface.
-- **Pattern Summarizer Impl**: Projects the full ExtractedPattern (~3.5KB per pattern) down to a PatternSummary (~100 bytes) for list queries.
-- **Stub Resolver Impl**: Identifies design session stubs in the MasterDataset and resolves them against the filesystem to determine...
-- **Process State API**: TypeScript interface for querying project state.
-- **Pattern Helpers**: Common helper functions used by context-assembler, arch-queries, and other API modules that need pattern name...
-- **API Module**: Central export for the Process State API, providing a TypeScript interface for querying project state.
-- **Fuzzy Matcher Impl**: Provides fuzzy matching for pattern names with tiered scoring: exact (1.0) > prefix (0.9) > substring (0.7) >...
-- **Coverage Analyzer Impl**: Reports annotation completeness by comparing scannable files (from glob) against annotated patterns in MasterDataset.
-- **Context Formatter Impl**: First plain-text formatter in the codebase.
-- **Context Assembler Impl**: Pure function composition over MasterDataset.
-- **Arch Queries Impl**: Pure functions over MasterDataset for deep architecture exploration.
 - **Repl Mode**: Loads the pipeline once and accepts multiple queries on stdin.
-- **Process API CLI Impl**: Exposes ProcessStateAPI methods as CLI subcommands with JSON output.
+- **Pattern Graph CLI Impl**: Exposes PatternGraphAPI methods as CLI subcommands with JSON output.
 - **Output Pipeline Impl**: Post-processing pipeline that transforms raw API results into shaped CLI output.
 - **MCP Server Bin**: Handles stdout isolation, CLI arg parsing, and process lifecycle.
 - **Lint Process CLI**: Validates git changes against workflow rules.
-- **Dataset Cache**: Caches the full PipelineResult (MasterDataset + ValidationSummary + warnings) to a JSON file.
+- **Dataset Cache**: Caches the full PipelineResult (PatternGraph + ValidationSummary + warnings) to a JSON file.
+- **Pattern Graph API Types**: :PatternGraph Type definitions for the PatternGraphAPI query interface.
+- **Pattern Summarizer Impl**: Projects the full ExtractedPattern (~3.5KB per pattern) down to a PatternSummary (~100 bytes) for list queries.
+- **Stub Resolver Impl**: Identifies design session stubs in the PatternGraph and resolves them against the filesystem to determine...
+- **Pattern Helpers**: Common helper functions used by context-assembler, arch-queries, and other API modules that need pattern name...
+- **Pattern Graph API**: TypeScript interface for querying project state.
+- **API Module**: Central export for the PatternGraphAPI, providing a TypeScript interface for querying the pattern graph and delivery...
+- **Fuzzy Matcher Impl**: Provides fuzzy matching for pattern names with tiered scoring: exact (1.0) > prefix (0.9) > substring (0.7) >...
+- **Coverage Analyzer Impl**: Reports annotation completeness by comparing scannable files (from glob) against annotated patterns in PatternGraph.
+- **Context Formatter Impl**: First plain-text formatter in the codebase.
+- **Context Assembler Impl**: Pure function composition over PatternGraph.
+- **Arch Queries Impl**: Pure functions over PatternGraph for deep architecture exploration.
 - **FSM Validator**: :PDR005MvpWorkflow Pure validation functions following the Decider pattern: - No I/O, no side effects - Return...
 - **FSM Transitions**: :PDR005MvpWorkflow Defines valid transitions between FSM states per PDR-005: ``` roadmap ──→ active ──→ completed │ ...
 - **FSM States**: :PDR005MvpWorkflow Defines the 4-state FSM from PDR-005 MVP Workflow: - roadmap: Planned work (fully editable) -...
 - **FSM Module**: :PDR005MvpWorkflow Central export for the 4-state FSM defined in PDR-005: ``` roadmap ──→ active ──→ completed │ ...
 - **Reference Document Codec**: :Generation A single codec factory that creates reference document codecs from configuration objects.
-- **Design Review Codec**: :Generation Transforms MasterDataset into a RenderableDocument containing design review artifacts: sequence diagrams,...
+- **Design Review Codec**: :Generation Transforms PatternGraph into a RenderableDocument containing design review artifacts: sequence diagrams,...
 - **Composite Codec**: :Generation Assembles reference documents from multiple codec outputs by concatenating RenderableDocument sections.
-- **Claude Module Codec**: :Generation Transforms MasterDataset into RenderableDocuments for CLAUDE.md module generation.
+- **Codec Registry Barrel**: Collects all codecMeta exports into a single array.
+- **Claude Module Codec**: :Generation Transforms PatternGraph into RenderableDocuments for CLAUDE.md module generation.
 - **Process Guard Types**: :FSMValidator Defines types for the process guard linter including: - Process state derived from file annotations -...
 - **Process Guard Module**: :FSMValidator,DeriveProcessState,DetectChanges,ProcessGuardDecider Enforces workflow rules by validating changes...
 - **Detect Changes**: Detects changes from git diff including: - Modified, added, deleted files - Status transitions (@architect-status...
 - **Derive Process State**: :GherkinScanner,FSMValidator Derives process state from @architect-\* annotations in files.
 - **Process Guard Decider**: :FSMValidator,DeriveProcessState,DetectChanges Pure function that validates changes against process rules.
+- **Reference Generator Registration**: Registers all reference document generators.
+- **Design Review Generator**: :Generation Generates design review documents for patterns with sequence annotations.
 - **Transform Types**: Type definitions for the dataset transformation pipeline.
 - **Sequence Transform Utils**: :Generation Builds pre-computed SequenceIndexEntry objects from patterns that have sequence diagram annotations.
 - **Relationship Resolver**: Computes reverse relationship lookups (implementedBy, extendedBy, enables, usedBy) and detects dangling references in...
-- **Reference Generator Registration**: Registers all reference document generators.
-- **Design Review Generator**: :Generation Generates design review documents for patterns with sequence annotations.
-- **MCP Server Integration**: Claude Code accesses ProcessStateAPI through subprocess calls to the process-api CLI.
+- **MCP Server Integration**: Claude Code accesses PatternGraphAPI through subprocess calls to the pattern-graph-cli CLI.
 - **Design Review Generation**: Design reviews require manual creation of sequence and component diagrams that duplicate information already captured...
+- **Workflow Config Schemas Validation**: The workflow configuration module defines Zod schemas for validating delivery workflow definitions with statuses,...
+- **Tag Registry Schemas Validation**: The tag registry configuration module provides schema-validated taxonomy definitions for organizing patterns by...
+- **Codec Utils Validation**: The codec utilities provide factory functions for creating type-safe JSON parsing and serialization pipelines using...
 - **Git Branch Diff Testing**: The branch diff utility returns changed files relative to a base branch for PR-scoped generation.
 - **File Cache Testing**: The file cache provides request-scoped content caching for generation runs.
 - **Tag Registry Builder Testing**: The tag registry builder constructs a complete TagRegistry from TypeScript constants.
 - **Normalized Status Testing**: The normalized status module maps any status input — raw FSM states (roadmap, active, completed, deferred),...
 - **Deliverable Status Taxonomy Testing**: The deliverable status module defines the 6 canonical status values for deliverables in Gherkin Background tables:...
-- **Workflow Config Schemas Validation**: The workflow configuration module defines Zod schemas for validating delivery workflow definitions with statuses,...
-- **Tag Registry Schemas Validation**: The tag registry configuration module provides schema-validated taxonomy definitions for organizing patterns by...
-- **Codec Utils Validation**: The codec utilities provide factory functions for creating type-safe JSON parsing and serialization pipelines using...
 - **Load Preamble Parser**: The parseMarkdownToBlocks function converts raw markdown content into a readonly SectionBlock[] array using a 5-state...
 - **Design Review Generation Tests**: Tests the full design review generation pipeline: sequence annotations are extracted from patterns with business...
 - **Design Review Generator Lifecycle Tests**: The design review generator cleans up stale markdown files when annotated patterns are renamed or removed from the...
+- **Claude Metadata Parity Testing**: The extractor must preserve Claude routing metadata from TypeScript directives and keep the sync and async Gherkin...
 - **Architecture Doc Refactoring Testing**: Validates that ARCHITECTURE.md retains its full reference content and that generated documents in docs-live/ coexist...
-- **Process Api Cli Repl**: Interactive REPL mode keeps the pipeline loaded for multi-query sessions and supports reload.
-- **Process Api Cli Metadata**: Response metadata includes validation summary and pipeline timing for diagnostics.
-- **Process Api Cli Help**: Per-subcommand help displays usage, flags, and examples for individual subcommands.
-- **Process Api Cli Dry Run**: Dry-run mode shows pipeline scope without processing data.
-- **Process Api Cli Cache**: MasterDataset caching between CLI invocations: cache hits, mtime invalidation, and --no-cache bypass.
+- **Pattern Graph Cli Repl**: Interactive REPL mode keeps the pipeline loaded for multi-query sessions and supports reload.
+- **Pattern Graph Cli Metadata**: Response metadata includes validation summary and pipeline timing for diagnostics.
+- **Pattern Graph Cli Help**: Per-subcommand help displays usage, flags, and examples for individual subcommands.
+- **Pattern Graph Cli Dry Run**: Dry-run mode shows pipeline scope without processing data.
+- **Pattern Graph Cli Cache**: PatternGraph caching between CLI invocations: cache hits, mtime invalidation, and --no-cache bypass.
 - **Uses Tag Testing**: Tests extraction and processing of @architect-uses and @architect-used-by relationship tags from TypeScript files.
 - **Depends On Tag Testing**: Tests extraction of @architect-depends-on and @architect-enables relationship tags from Gherkin files.
 - **Stub Taxonomy Tag Tests**: Stub metadata (target path, design session) was stored as plain text in JSDoc descriptions, invisible to structured...
@@ -116,10 +118,17 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 ### Added
 
 - **Public API**: Main entry point for the @libar-dev/architect package.
+- **MCPToolRegistry — Tool Definitions with Zod Schemas**: Defines 25 MCP tools mapping to PatternGraphAPI methods and CLI subcommands.
+- **MCPServer — Entry Point and Lifecycle Manager**: Main entry point for the Architect MCP server.
+- **PipelineSessionManager — In-Memory PatternGraph Lifecycle**: Manages the persistent PatternGraph that all MCP tool calls read from.
+- **McpFileWatcher — Debounced Source File Watcher**: Watches TypeScript and Gherkin source files for changes, triggering debounced pipeline rebuilds.
+- **Index Preamble Configuration — DD-3, DD-4 Decisions**: Decision DD-3 (Audience paths: preamble vs annotation-derived): Use full preamble for audience reading paths.
+- **IndexCodec Factory — DD-1 Implementation Stub**: Creates the IndexCodec as a Zod codec (PatternGraph -> RenderableDocument).
+- **IndexCodecOptions — DD-1, DD-5 Decisions**: Decision DD-1 (New IndexCodec vs extend existing): Create a new IndexCodec registered in CodecRegistry, NOT a...
 - **Workflow Config Schema**: Zod schemas for validating workflow configuration files that define status models, phase definitions, and artifact...
 - **Tag Registry Configuration**: Defines the structure and validation for tag taxonomy configuration.
+- **Pattern Graph**: Defines the schema for a pre-computed dataset that holds all extracted patterns along with derived views (by status,...
 - **Output Schemas**: Zod schemas for JSON output formats used by CLI tools.
-- **Master Dataset**: Defines the schema for a pre-computed dataset that holds all extracted patterns along with derived views (by status,...
 - **Extracted Shape Schema**: Zod schema for TypeScript type definitions extracted from source files via the @architect-extract-shapes tag.
 - **Extracted Pattern Schema**: Zod schema for validating complete extracted patterns with code, metadata, relationships, and source information.
 - **Dual Source Schemas**: Zod schemas for dual-source extraction types.
@@ -133,12 +142,6 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - **Utils Module**: Common helper functions used across the Architect package.
 - **Pattern Id Generator**: Generates unique, deterministic pattern IDs based on file path and line number.
 - **Collection Utilities**: Provides shared utilities for working with arrays and collections, such as grouping items by a key function.
-- **Result Monad Types**: Explicit error handling via discriminated union.
-- **Error Factory Types**: Structured, discriminated error types with factory functions.
-- **Pattern Scanner**: Discovers TypeScript files matching glob patterns and filters to only those with `@architect` opt-in.
-- **Gherkin Scanner**: Scans .feature files for pattern metadata encoded in Gherkin tags.
-- **Gherkin AST Parser**: Parses Gherkin feature files using @cucumber/gherkin and extracts structured data including feature metadata, tags,...
-- **TypeScript AST Parser**: Parses TypeScript source files using @typescript-eslint/typescript-estree to extract @architect-\* directives with...
 - **Status Values**: THE single source of truth for FSM state values in the monorepo (per PDR-005 FSM).
 - **Risk Levels**: Three-tier risk classification for roadmap planning.
 - **Tag Registry Builder**: Constructs a complete TagRegistry from TypeScript constants.
@@ -147,6 +150,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - **Hierarchy Levels**: Three-level hierarchy for organizing work: - epic: Multi-quarter strategic initiatives - phase: Standard work units...
 - **Format Types**: Defines how tag values are parsed and validated.
 - **Category Definitions**: Categories are used to classify patterns and organize documentation.
+- **Pattern Scanner**: Discovers TypeScript files matching glob patterns and filters to only those with `@architect` opt-in.
+- **Gherkin Scanner**: Scans .feature files for pattern metadata encoded in Gherkin tags.
+- **Gherkin AST Parser**: Parses Gherkin feature files using @cucumber/gherkin and extracts structured data including feature metadata, tags,...
+- **TypeScript AST Parser**: Parses TypeScript source files using @typescript-eslint/typescript-estree to extract @architect-\* directives with...
 - **Renderable Utils**: Utility functions for document codecs.
 - **Renderable Document**: Universal intermediate format for all generated documentation.
 - **Universal Renderer**: Converts RenderableDocument to output strings.
@@ -155,6 +162,11 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - **Lint Rules**: Defines lint rules that check @architect-\* directives for completeness and quality.
 - **Lint Module**: Provides lint rules and engine for pattern annotation quality checking.
 - **Lint Engine**: Orchestrates lint rule execution against parsed directives.
+- **Shape Extractor**: Extracts TypeScript type definitions (interfaces, type aliases, enums, function signatures) from source files for...
+- **Layer Inference**: Infers feature file layer (timeline, domain, integration, e2e, component) from directory path patterns.
+- **Gherkin Extractor**: Transforms scanned Gherkin feature files into ExtractedPattern objects for inclusion in generated documentation.
+- **Dual Source Extractor**: Extracts pattern metadata from both TypeScript code stubs (@architect-_) and Gherkin feature files (@architect-_),...
+- **Document Extractor**: Converts scanned file data into complete ExtractedPattern objects with unique IDs, inferred names, categories, and...
 - **Warning Collector**: Provides a unified system for capturing, categorizing, and reporting non-fatal issues during document generation.
 - **Generator Types**: Minimal interface for pluggable generators that produce documentation from patterns.
 - **Source Mapping Validator**: Performs pre-flight checks on source mapping tables before extraction begins.
@@ -163,11 +175,6 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - **Documentation Generation Orchestrator**: Invariant: The orchestrator is the integration boundary for full docs generation: it delegates dataset construction...
 - **Content Deduplicator**: Identifies and merges duplicate sections extracted from multiple sources.
 - **Codec Based Generator**: Adapts the new RenderableDocument Model (RDM) codec system to the existing DocumentGenerator interface.
-- **Shape Extractor**: Extracts TypeScript type definitions (interfaces, type aliases, enums, function signatures) from source files for...
-- **Layer Inference**: Infers feature file layer (timeline, domain, integration, e2e, component) from directory path patterns.
-- **Gherkin Extractor**: Transforms scanned Gherkin feature files into ExtractedPattern objects for inclusion in generated documentation.
-- **Dual Source Extractor**: Extracts pattern metadata from both TypeScript code stubs (@architect-_) and Gherkin feature files (@architect-_),...
-- **Document Extractor**: Converts scanned file data into complete ExtractedPattern objects with unique IDs, inferred names, categories, and...
 - **Workflow Loader**: Provides the default 6-phase workflow as an inline constant and loads custom workflow overrides from JSON files via...
 - **Configuration Types**: Type definitions for the Architect configuration system.
 - **Regex Builders**: Type-safe regex factory functions for tag detection and normalization.
@@ -175,54 +182,53 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - **Architect Factory**: Main factory function for creating configured Architect instances.
 - **Configuration Defaults**: Centralized default constants for the Architect package.
 - **Config Loader**: Discovers and loads `architect.config.ts` or `architect.config.js` files for hierarchical configuration.
-- **Scope Validator Impl**: Pure function composition over ProcessStateAPI and MasterDataset.
-- **Rules Query Module**: Pure query function for business rules extracted from Gherkin Rule: blocks.
-- **Handoff Generator Impl**: Pure function that assembles a handoff document from ProcessStateAPI and MasterDataset.
+- **Result Monad Types**: Explicit error handling via discriminated union.
+- **Error Factory Types**: Structured, discriminated error types with factory functions.
 - **CLI Version Helper**: Reads package version from package.json for CLI --version flag.
 - **Validate Patterns CLI**: Cross-validates TypeScript patterns vs Gherkin feature files.
 - **Lint Patterns CLI**: Validates pattern annotations for quality and completeness.
 - **Documentation Generator CLI**: Replaces multiple specialized CLIs with one unified interface that supports multiple generators in a single run.
 - **CLI Error Handler**: Provides type-safe error handling for all CLI commands using the DocError discriminated union pattern.
 - **CLI Schema**: :DataAPI Declarative schema defining all CLI options for the architect command.
-- **MCPToolRegistry — Tool Definitions with Zod Schemas**: Defines 25 MCP tools mapping to ProcessStateAPI methods and CLI subcommands.
-- **MCPServer — Entry Point and Lifecycle Manager**: Main entry point for the Architect MCP server.
-- **PipelineSessionManager — In-Memory MasterDataset Lifecycle**: Manages the persistent MasterDataset that all MCP tool calls read from.
-- **McpFileWatcher — Debounced Source File Watcher**: Watches TypeScript and Gherkin source files for changes, triggering debounced pipeline rebuilds.
-- **Index Preamble Configuration — DD-3, DD-4 Decisions**: Decision DD-3 (Audience paths: preamble vs annotation-derived): Use full preamble for audience reading paths.
-- **IndexCodec Factory — DD-1 Implementation Stub**: Creates the IndexCodec as a Zod codec (MasterDataset -> RenderableDocument).
-- **IndexCodecOptions — DD-1, DD-5 Decisions**: Decision DD-1 (New IndexCodec vs extend existing): Create a new IndexCodec registered in CodecRegistry, NOT a...
-- **Validation Rules Codec**: :Generation Transforms MasterDataset into a RenderableDocument for Process Guard validation rules reference.
+- **Scope Validator Impl**: Pure function composition over PatternGraphAPI and PatternGraph.
+- **Rules Query Module**: Pure query function for business rules extracted from Gherkin Rule: blocks.
+- **Handoff Generator Impl**: Pure function that assembles a handoff document from PatternGraphAPI and PatternGraph.
+- **Validation Rules Codec**: :Generation Transforms PatternGraph into a RenderableDocument for Process Guard validation rules reference.
 - **Timeline Codec**: :Generation Purpose: Development roadmap organized by phase with progress tracking.
-- **Taxonomy Codec**: :Generation Transforms MasterDataset into a RenderableDocument for taxonomy reference output.
+- **Taxonomy Codec**: :Generation Transforms PatternGraph into a RenderableDocument for taxonomy reference output.
 - **Shared Codec Schema**: Provides a simplified RenderableDocument output schema for use with Zod 4 codecs.
 - **Session Codec**: :Generation Purpose: Current session context for AI agents and developers.
-- **Requirements Codec**: :Generation Transforms MasterDataset into RenderableDocument for PRD/requirements output.
+- **Requirements Codec**: :Generation Transforms PatternGraph into RenderableDocument for PRD/requirements output.
 - **Reporting Codecs**: :Generation Purpose: Keep a Changelog format changelog grouped by release version.
-- **Pr Changes Codec**: :Generation Transforms MasterDataset into RenderableDocument for PR-scoped output.
+- **Reference Codec**: All type/interface definitions and shared constants used across the ReferenceDocumentCodec module family.
+- **Reference Codec**: All diagram builder functions: collectScopePatterns, collectNeighborPatterns, prepareDiagramContext, and the five...
+- **Reference Codec**: Section builder functions that transform extracted data into SectionBlock arrays.
+- **Reference Codec**: Static data: PRODUCT_AREA_ARCH_CONTEXT_MAP and PRODUCT_AREA_META.
+- **Pr Changes Codec**: :Generation Transforms PatternGraph into RenderableDocument for PR-scoped output.
 - **Planning Codecs**: :Generation Purpose: Pre-planning questions and Definition of Done validation.
-- **Patterns Codec**: :Generation Transforms MasterDataset into a RenderableDocument for pattern registry output.
+- **Patterns Codec**: :Generation Transforms PatternGraph into a RenderableDocument for pattern registry output.
 - **Document Codecs**: Barrel export for all document codecs.
-- **Index Codec**: :Generation Purpose: Navigation hub composing editorial preamble with MasterDataset statistics.
+- **Index Codec**: :Generation Purpose: Navigation hub composing editorial preamble with PatternGraph statistics.
 - **Rich Content Helpers**: Shared helper functions for rendering Gherkin rich content in document codecs.
 - **Mermaid Diagram Utils**: Sanitization and formatting helpers shared across architecture.ts and reference.ts diagram builders.
 - **Decision Doc Codec**: Parses decision documents (ADR/PDR in .feature format) and extracts content for documentation generation.
-- **Business Rules Codec**: :Generation Transforms MasterDataset into a RenderableDocument for business rules output.
-- **Architecture Codec**: :Generation Transforms MasterDataset into a RenderableDocument containing architecture diagrams (Mermaid) generated...
-- **Adr Document Codec**: :Generation Transforms MasterDataset into RenderableDocument for Architecture Decision Records.
-- **Transform Dataset**: Transforms raw extracted patterns into a MasterDataset with all pre-computed views.
-- **Merge Patterns**: Merges patterns from TypeScript and Gherkin sources with conflict detection.
-- **Pipeline Module**: Barrel export for the unified transformation pipeline components.
-- **Context Inference Impl**: Auto-infers bounded context from file paths using configurable rules.
-- **Pipeline Factory**: Invariant: `buildMasterDataset()` is the shared factory for Steps 1-8 of the architecture pipeline and returns...
-- **Process Api Reference Generator**: :Generation Generates `PROCESS-API-REFERENCE.md` from the declarative CLI schema.
+- **Business Rules Codec**: :Generation Transforms PatternGraph into a RenderableDocument for business rules output.
+- **Architecture Codec**: :Generation Transforms PatternGraph into a RenderableDocument containing architecture diagrams (Mermaid) generated...
+- **Adr Document Codec**: :Generation Transforms PatternGraph into RenderableDocument for Architecture Decision Records.
 - **Built In Generators**: Registers all codec-based generators on import using the RDM (RenderableDocument Model) architecture.
 - **Decision Doc Generator**: Orchestrates the full pipeline for generating documentation from decision documents (ADR/PDR in .feature format): 1.
 - **Codec Generator Registration**: Registers codec-based generators for the RenderableDocument Model (RDM) system.
-- **Codec Base Options**: Shared types, interfaces, and utilities for all document codecs.
+- **Cli Reference Generator**: :Generation Generates `CLI-REFERENCE.md` from the declarative CLI schema.
+- **Transform Dataset**: Transforms raw extracted patterns into a PatternGraph with all pre-computed views.
+- **Merge Patterns**: Merges patterns from TypeScript and Gherkin sources with conflict detection.
+- **Pipeline Module**: Barrel export for the unified transformation pipeline components.
+- **Context Inference Impl**: Auto-infers bounded context from file paths using configurable rules.
+- **Pipeline Factory**: Invariant: `buildPatternGraph()` is the shared factory for Steps 1-8 of the architecture pipeline and returns...
+- **Codec Base Options**: :Add-createDecodeOnlyCodec-helper Shared types, interfaces, and utilities for all document codecs.
 - **ADR 006 Single Read Model Architecture**: The Architect package applies event sourcing to itself: git is the event store, annotated source files are...
-- **ADR 005 Codec Based Markdown Rendering**: The documentation generator needs to transform structured pattern data (MasterDataset) into markdown files.
+- **ADR 005 Codec Based Markdown Rendering**: The documentation generator needs to transform structured pattern data (PatternGraph) into markdown files.
 - **ADR 002 Gherkin Only Testing**: A package that generates documentation from `.feature` files had dual test approaches: 97 legacy `.test.ts` files...
-- **Validator Read Model Consolidation**: `validate-patterns.ts` is the only feature consumer that bypasses the MasterDataset.
+- **Validator Read Model Consolidation**: `validate-patterns.ts` is the only feature consumer that bypasses the PatternGraph.
 - **Universal Doc Generator Robustness**: This feature transforms the PoC document generator into a production-ready universal generator capable of operating...
 - **Step Lint Vitest Cucumber**: Hours are lost debugging vitest-cucumber-specific issues that only surface at test runtime.
 - **Step Lint Extended Rules**: The initial lint-steps CLI catches 8 vitest-cucumber traps, but 4 documented traps from...
@@ -232,11 +238,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - **Reference Doc Showcase**: The Reference Generation Sample document exercises a small fraction of the reference codec's capabilities: 2...
 - **Readme Rationalization**: `README.md` is 504 lines and serves three different audiences in one document: (a) npm package consumers who need...
 - **Publishing Relocation**: `docs/PUBLISHING.md` (144 lines) is deployed to libar.dev as part of the `docs/` directory, but its content is...
-- **Process State API Relationship Queries**: Problem: ProcessStateAPI currently supports dependency queries (`uses`, `usedBy`, `dependsOn`, `enables`) but lacks...
-- **Process State API CLI**: The ProcessStateAPI provides 27 typed query methods for efficient state queries, but Claude Code sessions cannot use...
-- **Process API Layered Extraction**: `process-api.ts` is 1,700 lines containing two remaining architectural violations of ADR-006: 1.
-- **Process Api Hybrid Generation**: `docs/PROCESS-API.md` (509 lines) contains three reference tables that manually mirror CLI definitions in source...
 - **Procedural Guide Codec**: Two manual docs contain procedural content with no annotation source for generation: `docs/SESSION-GUIDES.md` (389...
+- **Pattern Graph Layered Extraction**: `pattern-graph-cli.ts` is 1,700 lines containing two remaining architectural violations of ADR-006: 1.
+- **Pattern Graph API Relationship Queries**: Problem: PatternGraphAPI currently supports dependency queries (`uses`, `usedBy`, `dependsOn`, `enables`) but lacks...
+- **Pattern Graph API CLI**: The PatternGraphAPI provides 27 typed query methods for efficient state queries, but Claude Code sessions cannot use...
 - **Orchestrator Pipeline Factory Migration**: `orchestrator.ts` is the last feature consumer that wires the 8-step scan-extract-merge-transform pipeline inline...
 - **Gherkin Patterns Restructure**: `docs/GHERKIN-PATTERNS.md` is 515 lines and mixes two distinct concerns: (a) a writing guide for Gherkin authoring...
 - **Generated Doc Quality**: Four quality issues reduce the usefulness of generated docs for both Claude agents and human developers: (1)...
@@ -248,22 +253,20 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - **Declaration Level Shape Tagging**: The current shape extraction system operates at file granularity.
 - **Data API Stub Integration**: Design sessions produce code stubs in `architect/stubs/` with rich metadata: `@architect-target` (destination file...
 - **Data API Design Session Support**: Starting a design or implementation session requires manually compiling elaborate context prompts.
-- **Data API Platform Integration**: The process-api CLI requires subprocess invocation for every query, adding shell overhead and preventing stateful...
-- **Data API Output Shaping**: The ProcessStateAPI CLI returns raw `ExtractedPattern` objects via `JSON.stringify`.
+- **Data API Platform Integration**: The pattern-graph-cli CLI requires subprocess invocation for every query, adding shell overhead and preventing...
+- **Data API Output Shaping**: The PatternGraphAPI CLI returns raw `ExtractedPattern` objects via `JSON.stringify`.
 - **Data API Context Assembly**: Starting a Claude Code design or implementation session requires assembling 30-100KB of curated, multi-source context...
-- **Data API CLI Ergonomics**: The process-api CLI runs the full pipeline (scan, extract, transform) on every invocation, taking 2-5 seconds.
+- **Data API CLI Ergonomics**: The pattern-graph-cli CLI runs the full pipeline (scan, extract, transform) on every invocation, taking 2-5 seconds.
 - **Data API Architecture Queries**: The current `arch` subcommand provides basic queries (roles, context, layer, graph) but lacks deeper analysis needed...
 - **Cross Cutting Document Inclusion**: The reference doc codec assembles content from four sources, each with its own selection mechanism: conventionTags...
-- **Config Based Workflow Definition**: Every `pnpm process:query` and `pnpm docs:*` invocation prints: `Failed to load default workflow (6-phase-standard):...
+- **Config Based Workflow Definition**: Every `pnpm architect:query` and `pnpm docs:*` invocation prints: `Failed to load default workflow...
 - **Codec Driven Reference Generation**: Each reference document (Process Guard, Taxonomy, Validation, etc.) required a hand-coded recipe feature that...
-- **Cli Recipe Codec**: `docs/PROCESS-API.md` (~509 lines) retains ~460 lines of editorial prose after Phase 43 (ProcessApiHybridGeneration)...
+- **Cli Reference Generation**: `docs/CLI.md` (509 lines) contains three reference tables that manually mirror CLI definitions in source code: Global...
+- **Cli Recipe Codec**: `docs/CLI.md` (~509 lines) retains ~460 lines of editorial prose after Phase 43 (CliReferenceGeneration) extracted 3...
 - **Claude Module Generation**: Problem: CLAUDE.md modules are hand-written markdown files that drift from source code over time.
 - **Architecture Doc Refactoring**: ARCHITECTURE.md is 1,287 lines of manually-maintained documentation covering 14 sections.
 - **Architecture Diagram Core**: Problem: Architecture documentation requires manually maintaining mermaid diagrams that duplicate information already...
 - **Architecture Diagram Advanced**: Problem: Core diagram generation (see ArchitectureDiagramCore) produces component-level diagrams from `arch-*` tags.
-- **String Utils**: String utilities provide consistent text transformations across the codebase.
-- **Result Monad**: The Result type provides explicit error handling via a discriminated union.
-- **Error Factories**: Error factories create structured, discriminated error types with consistent message formatting.
 - **Status Transition Detection Testing**: Tests for the detectStatusTransitions function that parses git diff output.
 - **Process Guard Testing**: Pure validation functions for enforcing delivery process rules per PDR-005.
 - **FSM Validator Testing**: Pure validation functions for the 4-state FSM defined in PDR-005.
@@ -271,6 +274,9 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - **Detect Changes Testing**: Tests for the detectDeliverableChanges function that parses git diff output.
 - **Config Schema Validation**: Configuration schemas validate scanner and generator inputs with security constraints to prevent path traversal...
 - **Anti Pattern Detector Testing**: Detects violations of the dual-source documentation architecture and process hygiene issues that lead to...
+- **String Utils**: String utilities provide consistent text transformations across the codebase.
+- **Result Monad**: The Result type provides explicit error handling via a discriminated union.
+- **Error Factories**: Error factories create structured, discriminated error types with consistent message formatting.
 - **Gherkin Ast Parser**: The Gherkin AST parser extracts feature metadata, scenarios, and steps from .feature files for timeline generation...
 - **File Discovery**: The file discovery system uses glob patterns to find TypeScript files for documentation extraction.
 - **Doc String Media Type**: DocString language hints (mediaType) should be preserved through the parsing pipeline from feature files to rendered...
@@ -287,20 +293,20 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - **Pr Changes Options**: Tests the PrChangesCodec filtering capabilities for generating PR-scoped documentation.
 - **Documentation Orchestrator**: Tests the orchestrator's pattern merging, conflict detection, and generator coordination capabilities.
 - **Codec Based Generator Testing**: Tests the CodecBasedGenerator which adapts the RenderableDocument Model (RDM) codec system to the DocumentGenerator...
-- **Business Rules Document Codec**: Tests the BusinessRulesCodec transformation from MasterDataset to RenderableDocument.
+- **Business Rules Document Codec**: Tests the BusinessRulesCodec transformation from PatternGraph to RenderableDocument.
 - **Shape Extraction Types Testing**: Validates the shape extraction system that extracts TypeScript type definitions (interfaces, type aliases, enums,...
 - **Shape Extraction Rendering Testing**: Validates the shape extraction system that extracts TypeScript type definitions (interfaces, type aliases, enums,...
 - **Extraction Pipeline Enhancements Testing**: Validates extraction pipeline capabilities for ReferenceDocShowcase: function signature surfacing, full...
 - **Dual Source Extractor Testing**: Extracts and combines pattern metadata from both TypeScript code stubs (@architect-) and Gherkin feature files...
 - **Declaration Level Shape Tagging Testing**: Tests the discoverTaggedShapes function that scans TypeScript source code for declarations annotated with the...
-- **Claude Metadata Parity Testing**: The extractor must preserve Claude routing metadata from TypeScript directives and keep the sync and async Gherkin...
 - **Warning Collector Testing**: The warning collector provides a unified system for capturing, categorizing, and reporting non-fatal issues during...
-- **Validation Rules Codec Testing**: Validates the Validation Rules Codec that transforms MasterDataset into a RenderableDocument for Process Guard...
-- **Taxonomy Codec Testing**: Validates the Taxonomy Codec that transforms MasterDataset into a RenderableDocument for tag taxonomy reference...
+- **Validation Rules Codec Testing**: Validates the Validation Rules Codec that transforms PatternGraph into a RenderableDocument for Process Guard...
+- **Taxonomy Codec Testing**: Validates the Taxonomy Codec that transforms PatternGraph into a RenderableDocument for tag taxonomy reference...
 - **Source Mapping Validator Testing**: Context: Source mappings reference files that may not exist, use invalid extraction methods, or have incompatible...
 - **Source Mapper Testing**: The Source Mapper aggregates content from multiple source files based on source mapping tables parsed from decision...
 - **Robustness Integration**: Context: Document generation pipeline needs validation, deduplication, and warning collection to work together...
 - **Poc Integration**: End-to-end integration tests that exercise the full documentation generation pipeline using the actual POC decision...
+- **Index Codec Testing**: Validates the Index Codec that transforms PatternGraph into a RenderableDocument for the main documentation...
 - **Decision Doc Generator Testing**: The Decision Doc Generator orchestrates the full documentation generation pipeline from decision documents (ADR/PDR in .
 - **Decision Doc Codec Testing**: Validates the Decision Doc Codec that parses decision documents (ADR/PDR in .feature format) and extracts content for...
 - **Content Deduplication**: Context: Multiple sources may extract identical content, leading to duplicate sections in generated documentation.
@@ -312,13 +318,13 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - **Config Resolution**: resolveProjectConfig transforms a raw ArchitectProjectConfig into a fully resolved ResolvedConfig with all defaults...
 - **Config Loader Testing**: The config loader discovers and loads `architect.config.ts` files for hierarchical configuration, enabling...
 - **Validate Patterns Cli**: Command-line interface for cross-validating TypeScript patterns vs Gherkin feature files.
-- **Process Api Cli Subcommands**: Discovery subcommands: list, search, context assembly, tags/sources, extended arch, unannotated.
-- **Process Api Cli Modifiers And Rules**: Output modifiers, arch health, and rules subcommand.
-- **Process Api Cli Core**: Core CLI infrastructure: help, version, input validation, status, query, pattern, arch basics, missing args, edge cases.
+- **Pattern Graph Cli Subcommands**: Discovery subcommands: list, search, context assembly, tags/sources, extended arch, unannotated.
+- **Pattern Graph Cli Modifiers And Rules**: Output modifiers, arch health, and rules subcommand.
+- **Pattern Graph Cli Core**: Core CLI infrastructure: help, version, input validation, status, query, pattern, arch basics, missing args, edge cases.
 - **Lint Process Cli**: Command-line interface for validating changes against delivery process rules.
 - **Lint Patterns Cli**: Command-line interface for validating pattern annotation quality.
 - **Generate Docs Cli**: Command-line interface for generating documentation from annotated TypeScript.
-- **Transform Dataset Testing**: The transformToMasterDataset function transforms raw extracted patterns into a MasterDataset with all pre-computed...
+- **Transform Dataset Testing**: The transformToPatternGraph function transforms raw extracted patterns into a PatternGraph with all pre-computed...
 - **Session Handoffs**: The delivery process supports mid-phase handoffs between sessions and coordination across multiple developers through...
 - **Session File Lifecycle**: Orphaned session files are automatically cleaned up during generation, maintaining a clean docs-living/sessions/...
 - **Scanner Core**: The scanPatterns function orchestrates file discovery, directive detection, and AST parsing to extract documentation...
@@ -328,7 +334,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - **Remaining Work Summary Accuracy**: Summary totals in REMAINING-WORK.md must match the sum of phase table rows.
 - **Remaining Work Enhancement**: Enhanced REMAINING-WORK.md generation with priority-based sorting, quarter grouping, and progressive disclosure for...
 - **Pr Changes Generation**: The delivery process generates PR-CHANGES.md from active or completed phases, formatted for PR descriptions, code...
-- **Patterns Codec Testing**: The PatternsDocumentCodec transforms MasterDataset into a RenderableDocument for generating PATTERNS.md and category...
+- **Patterns Codec Testing**: The PatternsDocumentCodec transforms PatternGraph into a RenderableDocument for generating PATTERNS.md and category...
 - **Pattern Tag Extraction**: The extractPatternTags function parses Gherkin feature tags into structured metadata objects for pattern processing.
 - **Layer Inference Testing**: The layer inference module classifies feature files into testing layers (timeline, domain, integration, e2e,...
 - **Kebab Case Slugs**: As a documentation generator I need to generate readable, URL-safe slugs from pattern names So that generated file...
@@ -340,35 +346,35 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - **Description Header Normalization**: Pattern descriptions should not create duplicate headers when rendered.
 - **Context Inference**: Patterns in standard directories (src/validation/, src/scanner/) should automatically receive architecture context...
 - **Zod Codec Migration**: All JSON parsing and serialization uses type-safe Zod codec pattern, replacing raw JSON.parse/stringify with...
-- **Process State API Testing**: Programmatic interface for querying delivery process state.
+- **Pattern Graph API Testing**: Programmatic interface for querying the pattern graph and delivery process state.
 - **Mermaid Relationship Rendering**: Tests for rendering all relationship types in Mermaid dependency graphs with distinct visual styles per relationship...
 - **Linter Validation Testing**: Tests for lint rules that validate relationship integrity, detect conflicts, and ensure bidirectional traceability...
 - **Implements Tag Processing**: Tests for the @architect-implements tag which links implementation files to their corresponding roadmap pattern...
 - **Extends Tag Testing**: Tests for the @architect-extends tag which establishes generalization relationships between patterns (pattern...
-- **Timeline Codec Testing**: The timeline codecs (RoadmapDocumentCodec, CompletedMilestonesCodec, CurrentWorkCodec) transform MasterDataset into...
+- **Pattern Graph Cli Reference Tests**: Verifies that the declarative CLI schema drives reference table generation and stays in sync with the parser...
+- **Layered Diagram Generation**: As a documentation generator I want to generate layered architecture diagrams from metadata So that system...
+- **Arch Generator Registration**: As a CLI user I want an architecture generator registered in the generator registry So that I can run pnpm...
+- **Component Diagram Generation**: As a documentation generator I want to generate component diagrams from architecture metadata So that system...
+- **Arch Tag Extraction**: As a documentation generator I want architecture tags extracted from source code So that I can generate accurate...
+- **Arch Index Dataset**: As a documentation generator I want an archIndex built during dataset transformation So that I can efficiently look...
+- **Timeline Codec Testing**: The timeline codecs (RoadmapDocumentCodec, CompletedMilestonesCodec, CurrentWorkCodec) transform PatternGraph into...
 - **Shape Selector Testing**: Tests the filterShapesBySelectors function that provides fine-grained shape selection via structural discriminated...
 - **Shape Matcher Testing**: Matches file paths against glob patterns for TypeScript shape extraction.
-- **Session Codec Testing**: The session codecs (SessionContextCodec, RemainingWorkCodec) transform MasterDataset into RenderableDocuments for AI...
-- **Requirements Adr Codec Testing**: The RequirementsDocumentCodec and AdrDocumentCodec transform MasterDataset into RenderableDocuments for PRD-style and...
-- **Reporting Codec Testing**: The reporting codecs (ChangelogCodec, TraceabilityCodec, OverviewCodec) transform MasterDataset into...
+- **Session Codec Testing**: The session codecs (SessionContextCodec, RemainingWorkCodec) transform PatternGraph into RenderableDocuments for AI...
+- **Requirements Adr Codec Testing**: The RequirementsDocumentCodec and AdrDocumentCodec transform PatternGraph into RenderableDocuments for PRD-style and...
+- **Reporting Codec Testing**: The reporting codecs (ChangelogCodec, TraceabilityCodec, OverviewCodec) transform PatternGraph into...
 - **Reference Generator Testing**: Registers reference document generators from project config.
 - **Reference Codec Diagram Testing**: Scoped diagram generation from diagramScopes config, including archContext, include, archLayer, patterns filters, and...
 - **Reference Codec Diagram Type Testing**: Diagram type controls Mermaid output format including flowchart, sequenceDiagram, stateDiagram-v2, C4Context, and...
 - **Reference Codec Detail Rendering**: Standard detail level behavior, deep behavior rendering with structured annotations, shape JSDoc prose,...
 - **Reference Codec Core Testing**: Parameterized codec factory that creates reference document codecs from configuration objects.
-- **Pr Changes Codec Rendering Testing**: The PrChangesCodec transforms MasterDataset into RenderableDocument for PR-scoped documentation.
-- **Pr Changes Codec Options Testing**: The PrChangesCodec transforms MasterDataset into RenderableDocument for PR-scoped documentation.
-- **Planning Codec Testing**: The planning codecs (PlanningChecklistCodec, SessionPlanCodec, SessionFindingsCodec) transform MasterDataset into...
+- **Pr Changes Codec Rendering Testing**: The PrChangesCodec transforms PatternGraph into RenderableDocument for PR-scoped documentation.
+- **Pr Changes Codec Options Testing**: The PrChangesCodec transforms PatternGraph into RenderableDocument for PR-scoped documentation.
+- **Planning Codec Testing**: The planning codecs (PlanningChecklistCodec, SessionPlanCodec, SessionFindingsCodec) transform PatternGraph into...
 - **Generated Doc Quality Tests**: Tests for the four quality fixes in GeneratedDocQuality (Phase 38): duplicate table removal, Generation compact...
 - **Dedent Helper**: The dedent helper function normalizes indentation in code blocks extracted from DocStrings.
-- **Convention Extractor Testing**: Extracts convention content from MasterDataset decision records tagged with @architect-convention.
+- **Convention Extractor Testing**: Extracts convention content from PatternGraph decision records tagged with @architect-convention.
 - **Composite Codec Testing**: Assembles reference documents from multiple codec outputs by concatenating RenderableDocument sections.
-- **Process Api Reference Tests**: Verifies that the declarative CLI schema drives reference table generation and stays in sync with the parser...
-- **Layered Diagram Generation**: As a documentation generator I want to generate layered architecture diagrams from metadata So that system...
-- **Arch Generator Registration**: As a CLI user I want an architecture generator registered in the generator registry So that I can run pnpm...
-- **Component Diagram Generation**: As a documentation generator I want to generate component diagrams from architecture metadata So that system...
-- **Arch Tag Extraction**: As a documentation generator I want architecture tags extracted from source code So that I can generate accurate...
-- **Arch Index Dataset**: As a documentation generator I want an archIndex built during dataset transformation So that I can efficiently look...
 - **Scope Validator Tests**: Starting an implementation or design session without checking prerequisites wastes time when blockers are discovered...
 - **Handoff Generator Tests**: Multi-session work loses critical state between sessions when handoff documentation is manual or forgotten.
 

package/docs-live/INDEX.md

@@ -10,7 +10,7 @@
 | ----------------- | ------------------------------------------------------ |
 | **Package**       | @libar-dev/architect                                   |
 | **Purpose**       | Context engineering platform for AI-assisted codebases |
-| **Patterns**      | 395 tracked (262 completed, 81 active, 52 planned)     |
+| **Patterns**      | 401 tracked (266 completed, 83 active, 52 planned)     |
 | **Product Areas** | 7                                                      |
 | **License**       | MIT                                                    |
 
@@ -27,13 +27,13 @@
 | Understand the tag taxonomy    | [TAXONOMY.md](TAXONOMY.md)                                      |
 | Check validation rules         | [VALIDATION-RULES.md](VALIDATION-RULES.md)                      |
 | Browse the changelog           | [CHANGELOG-GENERATED.md](CHANGELOG-GENERATED.md)                |
-| Query process state via CLI    | [Process API Reference](reference/PROCESS-API-REFERENCE.md)     |
-| Find CLI workflow recipes      | [Process API Recipes](reference/PROCESS-API-RECIPES.md)         |
+| Query process state via CLI    | [CLI Reference](reference/CLI-REFERENCE.md)                     |
+| Find CLI workflow recipes      | [CLI Recipes](reference/CLI-RECIPES.md)                         |
 | Run AI coding sessions         | [Session Workflow Guide](reference/SESSION-WORKFLOW-GUIDE.md)   |
 | Enforce delivery process rules | [Process Guard Reference](reference/PROCESS-GUARD-REFERENCE.md) |
 | Learn annotation mechanics     | [Annotation Reference](reference/ANNOTATION-REFERENCE.md)       |
 | See codec patterns and options | [Architecture Codecs](reference/ARCHITECTURE-CODECS.md)         |
-| Understand MasterDataset types | [Architecture Types](reference/ARCHITECTURE-TYPES.md)           |
+| Understand PatternGraph types  | [Architecture Types](reference/ARCHITECTURE-TYPES.md)           |
 
 ---
 
@@ -55,7 +55,7 @@
 
 1. **[Annotation Reference](reference/ANNOTATION-REFERENCE.md)** -- Annotation mechanics and tag reference
 2. **[Session Workflow Guide](reference/SESSION-WORKFLOW-GUIDE.md)** -- Planning, Design, Implementation workflows
-3. **[Process API Reference](reference/PROCESS-API-REFERENCE.md)** -- CLI command reference with flags and examples
+3. **[CLI Reference](reference/CLI-REFERENCE.md)** -- Pattern Graph CLI command reference with flags and examples
 4. **[Process Guard Reference](reference/PROCESS-GUARD-REFERENCE.md)** -- Pre-commit hooks, error codes, programmatic API
 
 ---
@@ -73,11 +73,11 @@
 | CHANGELOG-GENERATED.md  | Everyone   | Project changelog from release specs             |
 | Annotation Reference    | Developers | Annotation mechanics, shape extraction           |
 | Session Workflow Guide  | AI/Devs    | Session decision trees and workflow checklists   |
-| Process API Reference   | AI/Devs    | CLI command reference with flags and examples    |
-| Process API Recipes     | AI/Devs    | CLI workflow recipes and session guides          |
+| CLI Reference           | AI/Devs    | CLI command reference with flags and examples    |
+| CLI Recipes             | AI/Devs    | CLI workflow recipes and session guides          |
 | Process Guard Reference | Team Leads | Pre-commit hooks, error codes, programmatic API  |
 | Architecture Codecs     | Developers | All codecs with factory patterns and options     |
-| Architecture Types      | Developers | MasterDataset interface and type shapes          |
+| Architecture Types      | Developers | PatternGraph interface and type shapes           |
 
 ---
 
@@ -85,11 +85,11 @@
 
 **Delivery Process** -- A code-first documentation and workflow toolkit. Extracts patterns from annotated TypeScript and Gherkin sources, generates markdown documentation, and validates delivery workflow via pre-commit hooks.
 
-**Pattern** -- An annotated unit of work tracked by the delivery process. Each pattern has a status (roadmap, active, completed, deferred), belongs to a product area, and has deliverables. Patterns are the atomic unit of the MasterDataset.
+**Pattern** -- An annotated unit of work tracked by the delivery process. Each pattern has a status (roadmap, active, completed, deferred), belongs to a product area, and has deliverables. Patterns are the atomic unit of the PatternGraph.
 
-**MasterDataset** -- The single read model (ADR-006) containing all extracted patterns with pre-computed views (byProductArea, byPhase, byStatus, byCategory). All codecs and the Data API consume this dataset.
+**PatternGraph** -- The single read model (ADR-006) containing all extracted patterns with pre-computed views (byProductArea, byPhase, byStatus, byCategory). All codecs and the Data API consume this dataset.
 
-**Codec** -- A Zod-based transformer that decodes MasterDataset into a RenderableDocument. Each codec produces a specific document type. Codecs are pure functions with no I/O.
+**Codec** -- A Zod-based transformer that decodes PatternGraph into a RenderableDocument. Each codec produces a specific document type. Codecs are pure functions with no I/O.
 
 **Dual-Source Architecture** -- Feature files own planning metadata (status, phase, dependencies). TypeScript files own implementation metadata (uses, used-by, category). This split prevents ownership conflicts.
 
@@ -122,11 +122,11 @@
 | --------------------------------------------------------------- | -------------------------------------------------------------------- | ---------- |
 | [Annotation Reference](reference/ANNOTATION-REFERENCE.md)       | Annotation mechanics, shape extraction, tag reference                | Developers |
 | [Session Workflow Guide](reference/SESSION-WORKFLOW-GUIDE.md)   | Planning, Design, Implementation session workflows                   | AI/Devs    |
-| [Process API Reference](reference/PROCESS-API-REFERENCE.md)     | CLI command reference with flags and examples                        | AI/Devs    |
-| [Process API Recipes](reference/PROCESS-API-RECIPES.md)         | CLI workflow recipes and session guides                              | AI/Devs    |
+| [CLI Reference](reference/CLI-REFERENCE.md)                     | Pattern Graph CLI command reference with flags and examples          | AI/Devs    |
+| [CLI Recipes](reference/CLI-RECIPES.md)                         | Pattern Graph CLI workflow recipes and session guides                | AI/Devs    |
 | [Process Guard Reference](reference/PROCESS-GUARD-REFERENCE.md) | Pre-commit hooks, error codes, programmatic API                      | Team Leads |
 | [Architecture Codecs](reference/ARCHITECTURE-CODECS.md)         | All codecs with factory patterns and options                         | Developers |
-| [Architecture Types](reference/ARCHITECTURE-TYPES.md)           | MasterDataset interface and type shapes                              | Developers |
+| [Architecture Types](reference/ARCHITECTURE-TYPES.md)           | PatternGraph interface and type shapes                               | Developers |
 | [Configuration Guide](reference/CONFIGURATION-GUIDE.md)         | Presets, config files, sources, output, and monorepo setup           | Users      |
 | [Validation Tools Guide](reference/VALIDATION-TOOLS-GUIDE.md)   | lint-patterns, lint-steps, lint-process, validate-patterns reference | CI/CD      |
 | [Gherkin Authoring Guide](reference/GHERKIN-AUTHORING-GUIDE.md) | Roadmap specs, Rule blocks, DataTables, tag conventions              | Developers |
@@ -149,25 +149,25 @@
 
 | Area          | Patterns | Completed | Active | Planned | Progress                   |
 | ------------- | -------- | --------- | ------ | ------- | -------------------------- |
-| Annotation    | 27       | 24        | 2      | 1       | [███████░] 24/27 89%       |
+| Annotation    | 27       | 23        | 3      | 1       | [███████░] 23/27 85%       |
 | Configuration | 11       | 8         | 0      | 3       | [██████░░] 8/11 73%        |
 | CoreTypes     | 11       | 7         | 4      | 0       | [█████░░░] 7/11 64%        |
 | DataAPI       | 40       | 23        | 15     | 2       | [█████░░░] 23/40 57%       |
-| Generation    | 95       | 81        | 6      | 8       | [███████░] 81/95 85%       |
+| Generation    | 96       | 82        | 6      | 8       | [███████░] 82/96 85%       |
 | Process       | 11       | 4         | 0      | 7       | [███░░░░░] 4/11 36%        |
 | Validation    | 25       | 16        | 3      | 6       | [█████░░░] 16/25 64%       |
-| **Total**     | **220**  | **163**   | **30** | **27**  | **[██████░░] 163/220 74%** |
+| **Total**     | **221**  | **163**   | **31** | **27**  | **[██████░░] 163/221 74%** |
 
 ---
 
 ## Phase Progress
 
-**395** patterns total: **262** completed (66%), **81** active, **52** planned. [█████████████░░░░░░░] 262/395
+**401** patterns total: **266** completed (66%), **83** active, **52** planned. [█████████████░░░░░░░] 266/401
 
 | Status    | Count | Percentage |
 | --------- | ----- | ---------- |
-| Completed | 262   | 66%        |
-| Active    | 81    | 21%        |
+| Completed | 266   | 66%        |
+| Active    | 83    | 21%        |
 | Planned   | 52    | 13%        |
 
 ### By Phase
@@ -226,6 +226,6 @@ pnpm docs:business-rules        # Business rules
 pnpm docs:taxonomy              # Taxonomy reference
 pnpm docs:validation            # Validation rules
 pnpm docs:claude-modules        # Claude context modules
-pnpm docs:process-api-reference # Process API CLI reference
+pnpm docs:cli-reference         # Pattern Graph CLI reference
 pnpm docs:cli-recipe            # CLI recipes & workflow guide
 ```