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

package/docs-live/reference/REFERENCE-SAMPLE.md

@@ -226,8 +226,8 @@ sequenceDiagram
     Orchestrator ->> Extractor: extractFromGherkin(docs)
     Extractor -->> Orchestrator: ExtractedPattern[]
     Orchestrator ->> Orchestrator: mergePatterns(ts, gherkin)
-    Orchestrator ->> Transformer: transformToMasterDataset(patterns)
-    Transformer -->> Orchestrator: MasterDataset
+    Orchestrator ->> Transformer: transformToPatternGraph(patterns)
+    Transformer -->> Orchestrator: PatternGraph
     Orchestrator ->> Codec: codec.decode(dataset)
     Codec -->> Orchestrator: RenderableDocument
     Orchestrator ->> Renderer: render(document)
@@ -255,16 +255,6 @@ classDiagram
     class Documentation_Generation_Orchestrator {
         <<service>>
     }
-    class ProcessApiReferenceGenerator {
-    }
-    class DesignReviewGenerator {
-        <<service>>
-    }
-    class DecisionDocGenerator {
-        <<service>>
-    }
-    class CliRecipeGenerator {
-    }
     class TransformTypes {
     }
     class TransformDataset {
@@ -279,16 +269,26 @@ classDiagram
     class ContextInferenceImpl {
         +ContextInferenceRule interface
     }
-    class MasterDataset
+    class DesignReviewGenerator {
+        <<service>>
+    }
+    class DecisionDocGenerator {
+        <<service>>
+    }
+    class CliReferenceGenerator {
+    }
+    class CliRecipeGenerator {
+    }
+    class PatternGraph
     class Pattern_Scanner
     class GherkinASTParser
     class ShapeExtractor
     class PatternHelpers
     class DesignReviewCodec
     class DecisionDocCodec
-    class ProcessApiHybridGeneration
     class PatternRelationshipModel
     class DesignReviewGeneration
+    class CliReferenceGeneration
     class CliRecipeCodec
     class ContextInference
     GitModule ..> GitBranchDiff : uses
@@ -297,23 +297,23 @@ classDiagram
     SourceMapper ..> ShapeExtractor : depends on
     SourceMapper ..> GherkinASTParser : depends on
     Documentation_Generation_Orchestrator ..> Pattern_Scanner : uses
-    ProcessApiReferenceGenerator ..|> ProcessApiHybridGeneration : implements
+    TransformTypes ..> PatternGraph : uses
+    TransformDataset ..> PatternGraph : uses
+    TransformDataset ..|> PatternRelationshipModel : implements
+    SequenceTransformUtils ..> PatternGraph : uses
+    SequenceTransformUtils ..|> DesignReviewGeneration : implements
+    RelationshipResolver ..> PatternHelpers : uses
+    ContextInferenceImpl ..|> ContextInference : implements
     DesignReviewGenerator ..> DesignReviewCodec : uses
-    DesignReviewGenerator ..> MasterDataset : uses
+    DesignReviewGenerator ..> PatternGraph : uses
     DesignReviewGenerator ..|> DesignReviewGeneration : implements
     DecisionDocGenerator ..> DecisionDocCodec : depends on
     DecisionDocGenerator ..> SourceMapper : depends on
+    CliReferenceGenerator ..|> CliReferenceGeneration : implements
     CliRecipeGenerator ..|> CliRecipeCodec : implements
-    TransformTypes ..> MasterDataset : uses
-    TransformDataset ..> MasterDataset : uses
-    TransformDataset ..|> PatternRelationshipModel : implements
-    SequenceTransformUtils ..> MasterDataset : uses
-    SequenceTransformUtils ..|> DesignReviewGeneration : implements
-    RelationshipResolver ..> PatternHelpers : uses
-    ContextInferenceImpl ..|> ContextInference : implements
-    DesignReviewCodec ..> MasterDataset : uses
+    DesignReviewCodec ..> PatternGraph : uses
     DesignReviewCodec ..|> DesignReviewGeneration : implements
-    CliRecipeCodec ..> ProcessApiHybridGeneration : depends on
+    CliRecipeCodec ..> CliReferenceGeneration : depends on
 ```
 
 ---
@@ -388,7 +388,7 @@ Scoped architecture diagram showing component relationships:
 ```mermaid
 graph LR
     subgraph api["Api"]
-        MasterDataset[/"MasterDataset"/]
+        PatternGraph[/"PatternGraph"/]
         PatternHelpers["PatternHelpers"]
         ArchQueriesImpl("ArchQueriesImpl")
     end
@@ -411,28 +411,28 @@ graph LR
         FSMStates[/"FSMStates"/]
     end
     subgraph related["Related"]
-        ProcessStateAPI["ProcessStateAPI"]:::neighbor
+        PatternGraphAPI["PatternGraphAPI"]:::neighbor
         TypeScriptTaxonomyImplementation["TypeScriptTaxonomyImplementation"]:::neighbor
-        ProcessApiHybridGeneration["ProcessApiHybridGeneration"]:::neighbor
         ProceduralGuideCodec["ProceduralGuideCodec"]:::neighbor
         PhaseStateMachineValidation["PhaseStateMachineValidation"]:::neighbor
         DataAPIOutputShaping["DataAPIOutputShaping"]:::neighbor
         DataAPIArchitectureQueries["DataAPIArchitectureQueries"]:::neighbor
+        CliReferenceGeneration["CliReferenceGeneration"]:::neighbor
     end
-    TagRegistryBuilder ..->|implements| TypeScriptTaxonomyImplementation
     loadPreambleFromMarkdown___Shared_Markdown_to_SectionBlock_Parser ..->|implements| ProceduralGuideCodec
-    CLISchema ..->|implements| ProcessApiHybridGeneration
     ProjectConfigTypes -->|uses| ConfigurationTypes
     ProjectConfigTypes -->|uses| ConfigurationPresets
     ConfigurationPresets -->|uses| ConfigurationTypes
+    CLISchema ..->|implements| CliReferenceGeneration
     PatternHelpers ..->|implements| DataAPIOutputShaping
-    ArchQueriesImpl -->|uses| ProcessStateAPI
-    ArchQueriesImpl -->|uses| MasterDataset
+    ArchQueriesImpl -->|uses| PatternGraphAPI
+    ArchQueriesImpl -->|uses| PatternGraph
     ArchQueriesImpl ..->|implements| DataAPIArchitectureQueries
+    TagRegistryBuilder ..->|implements| TypeScriptTaxonomyImplementation
     FSMTransitions ..->|implements| PhaseStateMachineValidation
     FSMStates ..->|implements| PhaseStateMachineValidation
-    ProcessStateAPI -->|uses| MasterDataset
-    ProcessStateAPI ..->|implements| PhaseStateMachineValidation
+    PatternGraphAPI -->|uses| PatternGraph
+    PatternGraphAPI ..->|implements| PhaseStateMachineValidation
     DataAPIArchitectureQueries -.->|depends on| DataAPIOutputShaping
     classDef neighbor stroke-dasharray: 5 5
 ```
@@ -441,6 +441,21 @@ graph LR
 
 ## API Types
 
+### SectionBlock (type)
+
+```typescript
+type SectionBlock =
+  | HeadingBlock
+  | ParagraphBlock
+  | SeparatorBlock
+  | TableBlock
+  | ListBlock
+  | CodeBlock
+  | MermaidBlock
+  | CollapsibleBlock
+  | LinkOutBlock;
+```
+
 ### normalizeStatus (function)
 
 ````typescript
@@ -535,21 +550,6 @@ interface CategoryDefinition {
 | description | Brief description of the category's purpose and typical patterns                  |
 | aliases     | Alternative tag names that map to this category (e.g., "es" for "event-sourcing") |
 
-### SectionBlock (type)
-
-```typescript
-type SectionBlock =
-  | HeadingBlock
-  | ParagraphBlock
-  | SeparatorBlock
-  | TableBlock
-  | ListBlock
-  | CodeBlock
-  | MermaidBlock
-  | CollapsibleBlock
-  | LinkOutBlock;
-```
-
 ---
 
 ## Behavior Specifications
@@ -590,7 +590,7 @@ Validation happens later at load time via Zod schema in `loadProjectConfig()`.
 [View ConfigBasedWorkflowDefinition source](architect/specs/config-based-workflow-definition.feature)
 
 **Problem:**
-Every `pnpm process:query` and `pnpm docs:*` invocation prints:
+Every `pnpm architect:query` and `pnpm docs:*` invocation prints:
 `Failed to load default workflow (6-phase-standard): Workflow file not found`
 
 The `loadDefaultWorkflow()` function resolves to `catalogue/workflows/`
@@ -633,7 +633,7 @@ Design Decisions (DS-1, 2026-02-15):
 
 **Invariant:** `loadDefaultWorkflow()` returns a `LoadedWorkflow` without file system access. It cannot fail. The default workflow constant uses only canonical status values from `src/taxonomy/status-values.ts`.
 
-**Rationale:** The file-based loading path (`catalogue/workflows/`) has been dead code since monorepo extraction. Both callers (orchestrator, process-api) already handle the failure gracefully, proving the system works without it. Making the function synchronous and infallible removes the try-catch ceremony and the warning noise.
+**Rationale:** The file-based loading path (`catalogue/workflows/`) has been dead code since monorepo extraction. Both callers (orchestrator, pattern-graph-cli) already handle the failure gracefully, proving the system works without it. Making the function synchronous and infallible removes the try-catch ceremony and the warning noise.
 
 **Verified by:**
 
@@ -707,7 +707,7 @@ Design Decisions (DS-1, 2026-02-15):
 
 **Context:**
 The documentation generator needs to transform structured pattern data
-(MasterDataset) into markdown files. The initial approach used direct
+(PatternGraph) into markdown files. The initial approach used direct
 string concatenation in generator functions, mixing data selection,
 formatting logic, and output assembly in a single pass. This made
 generators hard to test, difficult to compose, and impossible to
@@ -716,7 +716,7 @@ AI context).
 
 **Decision:**
 Adopt a codec architecture inspired by serialization codecs (encode/decode).
-Each document type has a codec that decodes a MasterDataset into a
+Each document type has a codec that decodes a PatternGraph into a
 RenderableDocument — an intermediate representation of sections, headings,
 tables, paragraphs, and code blocks. A separate renderer transforms the
 RenderableDocument into markdown. This separates data selection (what to
@@ -743,15 +743,15 @@ include) from formatting (how it looks) from serialization (markdown syntax).
 
 #### Codecs implement a decode-only contract
 
-**Invariant:** Every codec is a pure function that accepts a MasterDataset and returns a RenderableDocument. Codecs do not perform side effects, do not write files, and do not access the filesystem. The codec contract is decode-only because the transformation is one-directional: structured data becomes a document, never the reverse.
+**Invariant:** Every codec is a pure function that accepts a PatternGraph and returns a RenderableDocument. Codecs do not perform side effects, do not write files, and do not access the filesystem. The codec contract is decode-only because the transformation is one-directional: structured data becomes a document, never the reverse.
 
-**Rationale:** Pure functions are deterministic and trivially testable. For the same MasterDataset, a codec always produces the same RenderableDocument. This makes snapshot testing reliable and enables codec output comparison across versions.
+**Rationale:** Pure functions are deterministic and trivially testable. For the same PatternGraph, a codec always produces the same RenderableDocument. This makes snapshot testing reliable and enables codec output comparison across versions.
 
 **Codec call signature:**
 
 ```typescript
 interface DocumentCodec {
-  decode(dataset: MasterDataset): RenderableDocument;
+  decode(dataset: PatternGraph): RenderableDocument;
 }
 ```
 

package/docs-live/reference/SESSION-WORKFLOW-GUIDE.md

@@ -205,7 +205,7 @@ Three-layer architecture after Phase 39:
 | No CLAUDE.md drift | Session workflow section generated, not hand-authored |
 | Single annotated source | This spec owns all session workflow invariants |
 | Correct audience alignment | Public guide stays in docs/, AI context in \_claude-md/ |
-| Process API coverage | Session workflow content queryable via `pnpm process:query -- rules` |
+| Process API coverage | Session workflow content queryable via `pnpm architect:query -- rules` |
 | Immediately useful | Rule: blocks are queryable today, generation follows when Phase 25 ships |
 
 **Design Session Findings (2026-03-05):**
@@ -349,7 +349,7 @@ Three-layer architecture after Phase 39:
 - Handoff output reflects annotation state
 - Handoff output reflects annotation state
 
-  Generate handoff via: pnpm process:query -- handoff --pattern PatternName
+  Generate handoff via: pnpm architect:query -- handoff --pattern PatternName
   Options: --git (include recent commits)
 
 - --session (session identifier)
@@ -370,7 +370,7 @@ Three-layer architecture after Phase 39:
 
 **Invariant:** Phase 39 depends on ClaudeModuleGeneration (Phase 25). Adding `@architect-claude-module` and `@architect-claude-section:workflow` tags to this spec will cause ClaudeModuleGeneration to produce `_claude-md/workflow/` output files. The hand-written `_claude-md/workflow/` files are deleted after successful verified generation.
 
-**Rationale:** The annotation work (Rule blocks in this spec) is immediately useful — queryable via `pnpm process:query -- rules`. Generation deliverables cannot complete until Phase 25 ships the ClaudeModuleCodec. This sequencing is intentional: the annotation investment has standalone value regardless of whether the codec exists yet.
+**Rationale:** The annotation work (Rule blocks in this spec) is immediately useful — queryable via `pnpm architect:query -- rules`. Generation deliverables cannot complete until Phase 25 ships the ClaudeModuleCodec. This sequencing is intentional: the annotation investment has standalone value regardless of whether the codec exists yet.
 
 **Prerequisite:** Phase 25 must add `workflow` to the `claude-section` enum
 values (currently: core, process, testing, infrastructure).

package/docs-live/taxonomy/format-types.md

@@ -59,8 +59,8 @@ Detailed parsing behavior for each format type.
 | ---------------- | ------------------------------------------------------- |
 | Description      | Boolean presence (no value needed)                      |
 | Parsing Behavior | Presence of tag indicates true; absence indicates false |
-| Example          | `@architect-core`                                       |
-| Notes            | Used for boolean markers like core, overview, decision  |
+| Example          | `@architect-sequence-error`                             |
+| Notes            | Used for boolean markers like sequence-error            |
 
 ---
 

package/docs-live/taxonomy/metadata-tags.md

@@ -6,19 +6,17 @@
 
 ## Metadata Tag Definitions
 
-60 metadata tags with full details.
+58 metadata tags with full details.
 
 | Tag                      | Format       | Purpose                                                                    | Required | Repeatable | Values                                                                                                                                                                                                                               | Default  |
 | ------------------------ | ------------ | -------------------------------------------------------------------------- | -------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------- |
 | `pattern`                | value        | Explicit pattern name                                                      | Yes      | No         | -                                                                                                                                                                                                                                    | -        |
 | `status`                 | enum         | Work item lifecycle status (per PDR-005 FSM)                               | No       | No         | roadmap, active, completed, deferred                                                                                                                                                                                                 | roadmap  |
-| `core`                   | flag         | Marks as essential/must-know pattern                                       | No       | No         | -                                                                                                                                                                                                                                    | -        |
 | `usecase`                | quoted-value | Use case association                                                       | No       | Yes        | -                                                                                                                                                                                                                                    | -        |
 | `uses`                   | csv          | Patterns this depends on                                                   | No       | No         | -                                                                                                                                                                                                                                    | -        |
 | `used-by`                | csv          | Patterns that depend on this                                               | No       | No         | -                                                                                                                                                                                                                                    | -        |
 | `phase`                  | number       | Roadmap phase number (unified across monorepo)                             | No       | No         | -                                                                                                                                                                                                                                    | -        |
 | `release`                | value        | Target release version (semver or vNEXT for unreleased work)               | No       | No         | -                                                                                                                                                                                                                                    | -        |
-| `brief`                  | value        | Path to pattern brief markdown                                             | No       | No         | -                                                                                                                                                                                                                                    | -        |
 | `depends-on`             | csv          | Roadmap dependencies (pattern or phase names)                              | No       | No         | -                                                                                                                                                                                                                                    | -        |
 | `enables`                | csv          | Patterns this enables                                                      | No       | No         | -                                                                                                                                                                                                                                    | -        |
 | `implements`             | csv          | Patterns this code file realizes (realization relationship)                | No       | No         | -                                                                                                                                                                                                                                    | -        |
@@ -95,16 +93,6 @@
 | Default      | roadmap                                      |
 | Example      | `@architect-status roadmap`                  |
 
-### `core`
-
-| Property   | Value                                |
-| ---------- | ------------------------------------ |
-| Format     | flag                                 |
-| Purpose    | Marks as essential/must-know pattern |
-| Required   | No                                   |
-| Repeatable | No                                   |
-| Example    | `@architect-core`                    |
-
 ### `usecase`
 
 | Property   | Value                                                 |
@@ -155,16 +143,6 @@
 | Repeatable | No                                                           |
 | Example    | `@architect-release v0.1.0`                                  |
 
-### `brief`
-
-| Property   | Value                                             |
-| ---------- | ------------------------------------------------- |
-| Format     | value                                             |
-| Purpose    | Path to pattern brief markdown                    |
-| Required   | No                                                |
-| Repeatable | No                                                |
-| Example    | `@architect-brief docs/briefs/decider-pattern.md` |
-
 ### `depends-on`
 
 | Property   | Value                                          |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@libar-dev/architect",
-  "version": "1.0.0-pre.3",
+  "version": "1.0.0-pre.4",
   "description": "Context engineering platform: extract patterns from TypeScript and Gherkin into a queryable state with living docs, architecture graphs, and FSM-enforced workflows.",
   "type": "module",
   "sideEffects": false,
@@ -63,7 +63,7 @@
     }
   },
   "bin": {
-    "architect": "./dist/cli/process-api.js",
+    "architect": "./dist/cli/pattern-graph-cli.js",
     "architect-generate": "./dist/cli/generate-docs.js",
     "architect-lint-patterns": "./dist/cli/lint-patterns.js",
     "architect-guard": "./dist/cli/lint-process.js",
@@ -104,14 +104,14 @@
     "docs:reference": "tsx src/cli/generate-docs.ts -g reference-docs",
     "docs:product-areas": "tsx src/cli/generate-docs.ts -g product-area-docs",
     "docs:claude-modules": "tsx src/cli/generate-docs.ts -g claude-modules",
-    "docs:process-api-reference": "tsx src/cli/generate-docs.ts -g process-api-reference",
+    "docs:cli-reference": "tsx src/cli/generate-docs.ts -g cli-reference",
     "docs:cli-recipe": "tsx src/cli/generate-docs.ts -g cli-recipe",
     "docs:index": "tsx src/cli/generate-docs.ts -g index",
     "docs:design-review": "tsx src/cli/generate-docs.ts -g design-review",
-    "docs:all": "pnpm docs:decisions && pnpm docs:product-areas && pnpm docs:taxonomy && pnpm docs:business-rules && pnpm docs:validation && pnpm docs:reference && pnpm docs:claude-modules && pnpm docs:process-api-reference && pnpm docs:cli-recipe && pnpm docs:architecture && pnpm docs:changelog && pnpm docs:design-review && pnpm docs:index",
+    "docs:all": "pnpm docs:decisions && pnpm docs:product-areas && pnpm docs:taxonomy && pnpm docs:business-rules && pnpm docs:validation && pnpm docs:reference && pnpm docs:claude-modules && pnpm docs:cli-reference && pnpm docs:cli-recipe && pnpm docs:architecture && pnpm docs:changelog && pnpm docs:design-review && pnpm docs:index",
     "docs:all-preview": "pnpm docs:patterns && pnpm docs:roadmap && pnpm docs:remaining && pnpm docs:changelog && pnpm docs:architecture && pnpm docs:decisions && pnpm docs:reference && pnpm docs:product-areas && pnpm docs:taxonomy && pnpm docs:validation && pnpm docs:requirements && pnpm docs:current && pnpm docs:milestones && pnpm docs:business-rules",
-    "architect:query": "tsx src/cli/process-api.ts",
-    "architect:q": "tsx src/cli/process-api.ts",
+    "architect:query": "tsx src/cli/pattern-graph-cli.ts",
+    "architect:q": "tsx src/cli/pattern-graph-cli.ts",
     "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\" \"*.{json,md,yml}\"",
     "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\" \"*.{json,md,yml}\"",
     "preversion": "pnpm test && pnpm typecheck && pnpm lint && pnpm format:check",
@@ -162,7 +162,7 @@
     "mermaid",
     "traceability",
     "dual-source",
-    "master-dataset",
+    "pattern-graph",
     "gherkin",
     "bdd",
     "typescript-annotations",

package/dist/api/arch-queries.d.ts

@@ -1,95 +0,0 @@
-/**
- * @architect
- * @architect-pattern ArchQueriesImpl
- * @architect-status active
- * @architect-implements DataAPIArchitectureQueries
- * @architect-uses ProcessStateAPI, MasterDataset
- * @architect-used-by ProcessAPICLIImpl
- * @architect-arch-role service
- * @architect-arch-context api
- * @architect-arch-layer domain
- *
- * ## ArchQueries — Neighborhood, Comparison, Tags, Sources
- *
- * Pure functions over MasterDataset for deep architecture exploration.
- * No I/O — all data comes from pre-computed views.
- *
- * **When to Use:** When exploring architecture structure (neighborhoods, comparisons, tags, sources) via the Data API CLI.
- */
-import type { MasterDataset } from '../validation-schemas/master-dataset.js';
-import type { NeighborEntry } from './types.js';
-export interface NeighborhoodResult {
-    readonly pattern: string;
-    readonly context: string | undefined;
-    readonly role: string | undefined;
-    readonly layer: string | undefined;
-    readonly uses: readonly NeighborEntry[];
-    readonly usedBy: readonly NeighborEntry[];
-    readonly dependsOn: readonly NeighborEntry[];
-    readonly enables: readonly NeighborEntry[];
-    readonly sameContext: readonly NeighborEntry[];
-    readonly implements: readonly string[];
-    readonly implementedBy: readonly string[];
-}
-export interface ContextSummary {
-    readonly name: string;
-    readonly patternCount: number;
-    readonly patterns: readonly string[];
-    readonly allDependencies: readonly string[];
-}
-export interface IntegrationPoint {
-    readonly from: string;
-    readonly fromContext: string;
-    readonly to: string;
-    readonly toContext: string;
-    readonly relationship: string;
-}
-export interface ContextComparison {
-    readonly context1: ContextSummary;
-    readonly context2: ContextSummary;
-    readonly sharedDependencies: readonly string[];
-    readonly uniqueToContext1: readonly string[];
-    readonly uniqueToContext2: readonly string[];
-    readonly integrationPoints: readonly IntegrationPoint[];
-}
-export interface TagValueCount {
-    readonly value: string;
-    readonly count: number;
-}
-export interface TagUsageEntry {
-    readonly tag: string;
-    readonly count: number;
-    readonly values: readonly TagValueCount[] | null;
-}
-export interface TagUsageReport {
-    readonly tags: readonly TagUsageEntry[];
-    readonly patternCount: number;
-}
-export interface SourceTypeEntry {
-    readonly type: string;
-    readonly count: number;
-    readonly locationPattern: string;
-    readonly files: readonly string[];
-}
-export interface SourceInventory {
-    readonly types: readonly SourceTypeEntry[];
-    readonly totalFiles: number;
-}
-export declare function computeNeighborhood(name: string, dataset: MasterDataset): NeighborhoodResult | undefined;
-export declare function compareContexts(ctx1: string, ctx2: string, dataset: MasterDataset): ContextComparison | undefined;
-export declare function aggregateTagUsage(dataset: MasterDataset): TagUsageReport;
-export declare function buildSourceInventory(dataset: MasterDataset): SourceInventory;
-export interface OrphanEntry {
-    readonly pattern: string;
-    readonly status: string | undefined;
-    /** Empty string if pattern metadata is unavailable. */
-    readonly file: string;
-}
-/**
- * Find patterns with no relationships at all (isolated nodes in the graph).
- *
- * A pattern is an orphan if it has no uses, usedBy, dependsOn, enables,
- * implementsPatterns, implementedBy, extendedBy, seeAlso, or extendsPattern.
- */
-export declare function findOrphanPatterns(dataset: MasterDataset): readonly OrphanEntry[];
-//# sourceMappingURL=arch-queries.d.ts.map