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

package/docs-live/PRODUCT-AREAS.md

@@ -11,7 +11,7 @@
 
 The annotation system is the ingestion boundary — it transforms annotated TypeScript and Gherkin files into `ExtractedPattern[]` objects that feed the entire downstream pipeline. Two parallel scanning paths (TypeScript AST + Gherkin parser) converge through dual-source merging. The system is fully data-driven: the `TagRegistry` defines all tags, formats, and categories — adding a new annotation requires only a registry entry, zero parser changes.
 
-**27 patterns** — 24 completed, 2 active, 1 planned
+**27 patterns** — 23 completed, 3 active, 1 planned
 
 **Key patterns:** PatternRelationshipModel, ShapeExtraction, DualSourceExtraction, GherkinRulesSupport, DeclarationLevelShapeTagging, CrossSourceValidation, ExtractionPipelineEnhancementsTesting
 
@@ -29,9 +29,9 @@ Configuration is the entry boundary — it transforms a user-authored `architect
 
 > **How does code become docs?**
 
-The generation pipeline transforms annotated source code into markdown documents through a four-stage architecture: Scanner discovers files, Extractor produces `ExtractedPattern` objects, Transformer builds MasterDataset with pre-computed views, and Codecs render to markdown via RenderableDocument IR. Nine specialized codecs handle reference docs, planning, session, reporting, timeline, ADRs, business rules, taxonomy, and composite output — each supporting three detail levels (detailed, standard, summary). The Orchestrator runs generators in registration order, producing both detailed `docs-live/` references and compact `_claude-md/` summaries.
+The generation pipeline transforms annotated source code into markdown documents through a four-stage architecture: Scanner discovers files, Extractor produces `ExtractedPattern` objects, Transformer builds PatternGraph with pre-computed views, and Codecs render to markdown via RenderableDocument IR. Nine specialized codecs handle reference docs, planning, session, reporting, timeline, ADRs, business rules, taxonomy, and composite output — each supporting three detail levels (detailed, standard, summary). The Orchestrator runs generators in registration order, producing both detailed `docs-live/` references and compact `_claude-md/` summaries.
 
-**95 patterns** — 81 completed, 6 active, 8 planned
+**96 patterns** — 82 completed, 6 active, 8 planned
 
 **Key patterns:** ADR005CodecBasedMarkdownRendering, CodecDrivenReferenceGeneration, CrossCuttingDocumentInclusion, ArchitectureDiagramGeneration, ScopedArchitecturalView, CompositeCodec, RenderableDocument, ProductAreaOverview
 
@@ -53,7 +53,7 @@ The Data API provides direct terminal access to project state. It replaces readi
 
 **40 patterns** — 23 completed, 15 active, 2 planned
 
-**Key patterns:** DataAPIContextAssembly, ProcessStateAPICLI, DataAPIDesignSessionSupport, DataAPIRelationshipGraph, DataAPIOutputShaping
+**Key patterns:** DataAPIContextAssembly, PatternGraphAPICLI, DataAPIDesignSessionSupport, DataAPIRelationshipGraph, DataAPIOutputShaping
 
 ## [CoreTypes](product-areas/CORE-TYPES.md)
 
@@ -81,14 +81,14 @@ Process defines the USDP-inspired session workflow that governs how work moves t
 
 | Area                                            | Patterns | Completed | Active | Planned |
 | ----------------------------------------------- | -------- | --------- | ------ | ------- |
-| [Annotation](product-areas/ANNOTATION.md)       | 27       | 24        | 2      | 1       |
+| [Annotation](product-areas/ANNOTATION.md)       | 27       | 23        | 3      | 1       |
 | [Configuration](product-areas/CONFIGURATION.md) | 11       | 8         | 0      | 3       |
-| [Generation](product-areas/GENERATION.md)       | 95       | 81        | 6      | 8       |
+| [Generation](product-areas/GENERATION.md)       | 96       | 82        | 6      | 8       |
 | [Validation](product-areas/VALIDATION.md)       | 25       | 16        | 3      | 6       |
 | [DataAPI](product-areas/DATA-API.md)            | 40       | 23        | 15     | 2       |
 | [CoreTypes](product-areas/CORE-TYPES.md)        | 11       | 7         | 4      | 0       |
 | [Process](product-areas/PROCESS.md)             | 11       | 4         | 0      | 7       |
-| **Total**                                       | **220**  | **163**   | **30** | **27**  |
+| **Total**                                       | **221**  | **163**   | **31** | **27**  |
 
 ---
 

package/docs-live/TAXONOMY.md

@@ -7,14 +7,14 @@
 
 ## Overview
 
-**3 categories** | **60 metadata tags** | **3 aggregation tags**
+**3 categories** | **58 metadata tags** | **3 aggregation tags**
 
 Current configuration uses `@architect-` prefix with `@architect` file opt-in.
 
 | Component        | Count | Description                          |
 | ---------------- | ----- | ------------------------------------ |
 | Categories       | 3     | Pattern classification by domain     |
-| Metadata Tags    | 60    | Pattern enrichment and relationships |
+| Metadata Tags    | 58    | Pattern enrichment and relationships |
 | Aggregation Tags | 3     | Document routing                     |
 
 ---
@@ -43,7 +43,6 @@ Tags for enriching patterns with additional metadata.
 | --------- | ------------ | -------------------------------------------- | -------- | ----------------------------------------------------- |
 | `pattern` | value        | Explicit pattern name                        | Yes      | `@architect-pattern CommandOrchestrator`              |
 | `status`  | enum         | Work item lifecycle status (per PDR-005 FSM) | No       | `@architect-status roadmap`                           |
-| `core`    | flag         | Marks as essential/must-know pattern         | No       | `@architect-core`                                     |
 | `usecase` | quoted-value | Use case association                         | No       | `@architect-usecase "When handling command failures"` |
 
 ### Relationship Tags
@@ -98,7 +97,6 @@ Tags for enriching patterns with additional metadata.
 
 | Tag                      | Format       | Purpose                                                                    | Required | Example                                                                      |
 | ------------------------ | ------------ | -------------------------------------------------------------------------- | -------- | ---------------------------------------------------------------------------- |
-| `brief`                  | value        | Path to pattern brief markdown                                             | No       | `@architect-brief docs/briefs/decider-pattern.md`                            |
 | `product-area`           | value        | Product area for PRD grouping                                              | No       | `@architect-product-area PlatformCore`                                       |
 | `user-role`              | value        | Target user persona for this feature                                       | No       | `@architect-user-role Developer`                                             |
 | `business-value`         | value        | Business value statement (hyphenated for tag format)                       | No       | `@architect-business-value eliminates-event-replay-complexity`               |
@@ -154,7 +152,7 @@ How tag values are parsed and validated.
 | `quoted-value` | String in quotes (preserves spaces) | `@architect-usecase "When X happens"` |
 | `csv`          | Comma-separated values              | `@architect-uses A, B, C`             |
 | `number`       | Numeric value                       | `@architect-phase 14`                 |
-| `flag`         | Boolean presence (no value)         | `@architect-core`                     |
+| `flag`         | Boolean presence (no value)         | `@architect-sequence-error`           |
 
 [Format type details](taxonomy/format-types.md)
 

package/docs-live/_claude-md/annotation/annotation-overview.md

@@ -18,9 +18,9 @@
 | TagRegistry                      | interface |
 | MetadataTagDefinitionForRegistry | interface |
 | CategoryDefinition               | interface |
-| TagDefinition                    | type      |
 | CategoryTag                      | type      |
 | buildRegistry                    | function  |
+| isShapeOnlyDirective             | function  |
 | METADATA_TAGS_BY_GROUP           | const     |
 | CATEGORIES                       | const     |
 | CATEGORY_TAGS                    | const     |

package/docs-live/_claude-md/annotation/annotation-reference.md

@@ -57,7 +57,7 @@ List specific declaration names in the file-level JSDoc:
 ```typescript
 /**
  * @architect
- * @architect-extract-shapes MasterDatasetSchema, StatusGroupsSchema
+ * @architect-extract-shapes PatternGraphSchema, StatusGroupsSchema
  */
 ```
 
@@ -94,7 +94,7 @@ For Zod files, extract the **schema constant** (with `Schema` suffix), not the i
 
 | Wrong (type alias)                       | Correct (schema constant)                 |
 | ---------------------------------------- | ----------------------------------------- |
-| `@extract-shapes MasterDataset`          | `@extract-shapes MasterDatasetSchema`     |
+| `@extract-shapes PatternGraph`           | `@extract-shapes PatternGraphSchema`      |
 | Shows: `z.infer<typeof ...>` (unhelpful) | Shows: `z.object({...})` (full structure) |
 
 #### Annotation Patterns by File Type
@@ -104,9 +104,9 @@ For Zod files, extract the **schema constant** (with `Schema` suffix), not the i
 ```typescript
 /**
  * @architect
- * @architect-pattern MasterDataset
+ * @architect-pattern PatternGraph
  * @architect-status completed
- * @architect-extract-shapes MasterDatasetSchema, StatusGroupsSchema, PhaseGroupSchema
+ * @architect-extract-shapes PatternGraphSchema, StatusGroupsSchema, PhaseGroupSchema
  */
 ```
 
@@ -130,7 +130,7 @@ For Zod files, extract the **schema constant** (with `Schema` suffix), not the i
  * @architect-status completed
  * @architect-arch-context generator
  * @architect-arch-layer application
- * @architect-extract-shapes transformToMasterDataset, RuntimeMasterDataset
+ * @architect-extract-shapes transformToPatternGraph, RuntimePatternGraph
  */
 ```
 

package/docs-live/_claude-md/architecture/architecture-types.md

@@ -4,13 +4,13 @@
 
 | Type                    | Kind      |
 | ----------------------- | --------- |
-| MasterDatasetSchema     | const     |
+| PatternGraphSchema      | const     |
 | StatusGroupsSchema      | const     |
 | StatusCountsSchema      | const     |
 | PhaseGroupSchema        | const     |
 | SourceViewsSchema       | const     |
 | RelationshipEntrySchema | const     |
-| RuntimeMasterDataset    | interface |
+| RuntimePatternGraph     | interface |
 | RawDataset              | interface |
 | PipelineOptions         | interface |
 | PipelineResult          | interface |
@@ -19,13 +19,13 @@
 
 **Invariant:** The orchestrator is the integration boundary for full docs generation: it delegates dataset construction to the shared pipeline, then executes codecs and writes files.
 
-#### Steps 1-8 via buildMasterDataset()
+#### Steps 1-8 via buildPatternGraph()
 
 #### Steps 9-10: Codec Execution and File Writing
 
 #### Shared Pipeline Factory Responsibilities
 
-**Invariant:** `buildMasterDataset()` is the shared factory for Steps 1-8 of the architecture pipeline and returns `Result<PipelineResult, PipelineError>` without process-level side effects.
+**Invariant:** `buildPatternGraph()` is the shared factory for Steps 1-8 of the architecture pipeline and returns `Result<PipelineResult, PipelineError>` without process-level side effects.
 
 #### 8-Step Dataset Build Flow
 

package/docs-live/_claude-md/architecture/reference-sample.md

@@ -106,10 +106,10 @@
 
 | Type                      | Kind      |
 | ------------------------- | --------- |
+| SectionBlock              | type      |
 | normalizeStatus           | function  |
 | DELIVERABLE_STATUS_VALUES | const     |
 | CategoryDefinition        | interface |
-| SectionBlock              | type      |
 
 #### Behavior Specifications
 
@@ -130,7 +130,7 @@
 
 | Rule                                                              | Description                                                                                                           |
 | ----------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
-| Codecs implement a decode-only contract                           | **Invariant:** Every codec is a pure function that accepts a MasterDataset<br> and returns a RenderableDocument....   |
+| Codecs implement a decode-only contract                           | **Invariant:** Every codec is a pure function that accepts a PatternGraph<br> and returns a RenderableDocument....    |
 | RenderableDocument is a typed intermediate representation         | **Invariant:** RenderableDocument contains a title, an ordered array of<br> SectionBlock elements, and an optional... |
 | CompositeCodec assembles documents from child codecs              | **Invariant:** CompositeCodec accepts an array of child codecs and<br> produces a single RenderableDocument by...     |
 | ADR content comes from both Feature description and Rule prefixes | **Invariant:** ADR structured content (Context, Decision, Consequences)<br> can appear in two locations within a...   |

package/docs-live/_claude-md/data-api/data-api-overview.md

@@ -18,7 +18,7 @@
 
 #### Shared Pipeline Factory Responsibilities
 
-**Invariant:** `buildMasterDataset()` is the shared factory for Steps 1-8 of the architecture pipeline and returns `Result<PipelineResult, PipelineError>` without process-level side effects.
+**Invariant:** `buildPatternGraph()` is the shared factory for Steps 1-8 of the architecture pipeline and returns `Result<PipelineResult, PipelineError>` without process-level side effects.
 
 #### 8-Step Dataset Build Flow
 
@@ -30,7 +30,7 @@
 | ----------------------- | --------- |
 | PipelineOptions         | interface |
 | PipelineResult          | interface |
-| MasterDatasetSchema     | const     |
+| PatternGraphSchema      | const     |
 | StatusGroupsSchema      | const     |
 | StatusCountsSchema      | const     |
 | PhaseGroupSchema        | const     |

package/docs-live/_claude-md/generation/generation-overview.md

@@ -1,11 +1,11 @@
 ### Generation Overview
 
-**How does code become docs?** The generation pipeline transforms annotated source code into markdown documents through a four-stage architecture: Scanner discovers files, Extractor produces `ExtractedPattern` objects, Transformer builds MasterDataset with pre-computed views, and Codecs render to markdown via RenderableDocument IR. Nine specialized codecs handle reference docs, planning, session, reporting, timeline, ADRs, business rules, taxonomy, and composite output — each supporting three detail levels (detailed, standard, summary). The Orchestrator runs generators in registration order, producing both detailed `docs-live/` references and compact `_claude-md/` summaries.
+**How does code become docs?** The generation pipeline transforms annotated source code into markdown documents through a four-stage architecture: Scanner discovers files, Extractor produces `ExtractedPattern` objects, Transformer builds PatternGraph with pre-computed views, and Codecs render to markdown via RenderableDocument IR. Nine specialized codecs handle reference docs, planning, session, reporting, timeline, ADRs, business rules, taxonomy, and composite output — each supporting three detail levels (detailed, standard, summary). The Orchestrator runs generators in registration order, producing both detailed `docs-live/` references and compact `_claude-md/` summaries.
 
 #### Key Invariants
 
 - Codec purity: Every codec is a pure function (dataset in, document out). No side effects, no filesystem access. Same input always produces same output
-- Single read model (ADR-006): All codecs consume MasterDataset. No codec reads raw scanner/extractor output. Anti-patterns: Parallel Pipeline, Lossy Local Type, Re-derived Relationship
+- Single read model (ADR-006): All codecs consume PatternGraph. No codec reads raw scanner/extractor output. Anti-patterns: Parallel Pipeline, Lossy Local Type, Re-derived Relationship
 - Progressive disclosure: Every document renders at three detail levels (detailed, standard, summary) from the same codec. Summary feeds `_claude-md/` modules; detailed feeds `docs-live/reference/`
 - Config-driven generation: A single `ReferenceDocConfig` produces a complete document. Content sources compose in fixed order: conventions, diagrams, shapes, behaviors
 - RenderableDocument IR: Codecs express intent ("this is a table"), the renderer handles syntax ("pipe-delimited markdown"). Switching output format requires only a new renderer
@@ -15,16 +15,16 @@
 
 #### API Types
 
-| Type                     | Kind      |
-| ------------------------ | --------- |
-| RuntimeMasterDataset     | interface |
-| RawDataset               | interface |
-| RenderableDocument       | type      |
-| SectionBlock             | type      |
-| HeadingBlock             | type      |
-| TableBlock               | type      |
-| ListBlock                | type      |
-| CodeBlock                | type      |
-| MermaidBlock             | type      |
-| CollapsibleBlock         | type      |
-| transformToMasterDataset | function  |
+| Type                    | Kind      |
+| ----------------------- | --------- |
+| RuntimePatternGraph     | interface |
+| RawDataset              | interface |
+| RenderableDocument      | type      |
+| SectionBlock            | type      |
+| HeadingBlock            | type      |
+| TableBlock              | type      |
+| ListBlock               | type      |
+| CodeBlock               | type      |
+| MermaidBlock            | type      |
+| CollapsibleBlock        | type      |
+| transformToPatternGraph | function  |

package/docs-live/_claude-md/process/process-overview.md

@@ -124,4 +124,4 @@
 | superseded  | Replaced by another  |
 | n/a         | Not applicable       |
 
-**Components:** Other (ADR006SingleReadModelArchitecture, ADR003SourceFirstPatternArchitecture, ADR002GherkinOnlyTesting, ADR001TaxonomyCanonicalValues, ValidatorReadModelConsolidation, StepDefinitionCompletion, SessionFileCleanup, ProcessAPILayeredExtraction, OrchestratorPipelineFactoryMigration, MvpWorkflowImplementation, LivingRoadmapCLI, EffortVarianceTracking, ConfigBasedWorkflowDefinition, CliBehaviorTesting, SessionHandoffs, SessionFileLifecycle)
+**Components:** Other (ADR006SingleReadModelArchitecture, ADR003SourceFirstPatternArchitecture, ADR002GherkinOnlyTesting, ADR001TaxonomyCanonicalValues, ValidatorReadModelConsolidation, StepDefinitionCompletion, SessionFileCleanup, PatternGraphLayeredExtraction, OrchestratorPipelineFactoryMigration, MvpWorkflowImplementation, LivingRoadmapCLI, EffortVarianceTracking, ConfigBasedWorkflowDefinition, CliBehaviorTesting, SessionHandoffs, SessionFileLifecycle)

package/docs-live/_claude-md/validation/validation-overview.md

@@ -27,6 +27,7 @@
 | formatDoDSummary                   | function  |
 | detectAntiPatterns                 | function  |
 | detectProcessInCode                | function  |
+| detectRemovedTags                  | function  |
 | detectMagicComments                | function  |
 | detectScenarioBloat                | function  |
 | detectMegaFeature                  | function  |
@@ -34,4 +35,3 @@
 | toValidationIssues                 | function  |
 | filterRulesBySeverity              | function  |
 | isValidTransition                  | function  |
-| getValidTransitionsFrom            | function  |

package/docs-live/business-rules/annotation.md

@@ -1007,7 +1007,7 @@ _- Gherkin tags are flat strings needing semantic interpretation_
 
 #### Single value tags produce scalar metadata fields
 
-> **Invariant:** Each single-value tag (pattern, phase, status, brief) maps to exactly one metadata field with the correct type.
+> **Invariant:** Each single-value tag (pattern, phase, status) maps to exactly one metadata field with the correct type.
 >
 > **Rationale:** Incorrect type coercion (e.g., phase as string instead of number) causes downstream pipeline failures in filtering and sorting.
 
@@ -1019,7 +1019,6 @@ _- Gherkin tags are flat strings needing semantic interpretation_
 - Extract status deferred tag
 - Extract status completed tag
 - Extract status active tag
-- Extract brief path tag
 
 ---
 

package/docs-live/business-rules/configuration.md

@@ -114,7 +114,7 @@ _- Raw user config is partial with many optional fields_
 
 #### Output defaults are applied
 
-> **Invariant:** Missing output configuration must resolve to "docs/architecture" with overwrite=false.
+> **Invariant:** Missing output configuration must resolve to "docs-live" with overwrite=false.
 >
 > **Rationale:** Consistent defaults prevent accidental overwrites and establish a predictable output location.