@libar-dev/architect 1.0.0-pre.3

package/dist/validation-schemas/scenario-ref.d.ts

@@ -0,0 +1,80 @@
+import { z } from 'zod';
+/**
+ * Schema for DataTable attached to scenario steps
+ */
+export declare const ScenarioDataTableSchema: z.ZodObject<{
+    headers: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+    rows: z.ZodReadonly<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodString>>>;
+}, z.core.$strict>;
+export type ScenarioDataTable = z.infer<typeof ScenarioDataTableSchema>;
+/**
+ * Schema for a DocString attached to a step
+ *
+ * DocStrings can have an optional mediaType that specifies the content language
+ * (e.g., "typescript", "json", "jsdoc") for proper syntax highlighting.
+ */
+export declare const ScenarioDocStringSchema: z.ZodObject<{
+    content: z.ZodString;
+    mediaType: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ScenarioDocString = z.infer<typeof ScenarioDocStringSchema>;
+/**
+ * Schema for scenario steps with optional DataTable/DocString
+ *
+ * Mirrors GherkinStep type but with Zod validation.
+ */
+export declare const ScenarioStepSchema: z.ZodObject<{
+    keyword: z.ZodString;
+    text: z.ZodString;
+    dataTable: z.ZodOptional<z.ZodObject<{
+        headers: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+        rows: z.ZodReadonly<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodString>>>;
+    }, z.core.$strict>>;
+    docString: z.ZodOptional<z.ZodObject<{
+        content: z.ZodString;
+        mediaType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ScenarioStep = z.infer<typeof ScenarioStepSchema>;
+/**
+ * Schema for scenario references from Gherkin feature files
+ *
+ * This schema defines the structure for scenario references
+ * used in ExtractedPattern.scenarios.
+ */
+export declare const ScenarioRefSchema: z.ZodObject<{
+    featureFile: z.ZodString;
+    featureName: z.ZodString;
+    featureDescription: z.ZodString;
+    scenarioName: z.ZodString;
+    semanticTags: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+    tags: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+    steps: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        keyword: z.ZodString;
+        text: z.ZodString;
+        dataTable: z.ZodOptional<z.ZodObject<{
+            headers: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+            rows: z.ZodReadonly<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodString>>>;
+        }, z.core.$strict>>;
+        docString: z.ZodOptional<z.ZodObject<{
+            content: z.ZodString;
+            mediaType: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>>>;
+    layer: z.ZodOptional<z.ZodEnum<{
+        timeline: "timeline";
+        domain: "domain";
+        integration: "integration";
+        e2e: "e2e";
+        component: "component";
+        unknown: "unknown";
+    }>>;
+    line: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+/**
+ * Type alias inferred from schema
+ *
+ * **Schema-First Law**: Type automatically derives from Zod schema.
+ */
+export type ScenarioRef = z.infer<typeof ScenarioRefSchema>;
+//# sourceMappingURL=scenario-ref.d.ts.map

package/dist/validation-schemas/scenario-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-ref.d.ts","sourceRoot":"","sources":["../../src/validation-schemas/scenario-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;kBAOzB,CAAC;AAEZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB;;;kBAOzB,CAAC;AAEZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;kBAWpB,CAAC;AAEZ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAqBnB,CAAC;AAEZ;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/validation-schemas/scenario-ref.js

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+import { LAYER_TYPES } from '../taxonomy/index.js';
+/**
+ * Schema for DataTable attached to scenario steps
+ */
+export const ScenarioDataTableSchema = z
+    .object({
+    /** Column headers from the first row */
+    headers: z.array(z.string()).readonly(),
+    /** Data rows (excluding header row), each row maps column name to value */
+    rows: z.array(z.record(z.string(), z.string())).readonly(),
+})
+    .strict();
+/**
+ * Schema for a DocString attached to a step
+ *
+ * DocStrings can have an optional mediaType that specifies the content language
+ * (e.g., "typescript", "json", "jsdoc") for proper syntax highlighting.
+ */
+export const ScenarioDocStringSchema = z
+    .object({
+    /** The DocString content */
+    content: z.string(),
+    /** Optional media type / language hint (e.g., "typescript", "json", "jsdoc") */
+    mediaType: z.string().optional(),
+})
+    .strict();
+/**
+ * Schema for scenario steps with optional DataTable/DocString
+ *
+ * Mirrors GherkinStep type but with Zod validation.
+ */
+export const ScenarioStepSchema = z
+    .object({
+    /** Step keyword (Given, When, Then, And, But) */
+    keyword: z.string(),
+    /** Step text */
+    text: z.string(),
+    /** Optional DataTable attached to this step */
+    dataTable: ScenarioDataTableSchema.optional(),
+    /** Optional DocString attached to this step (with content and optional mediaType) */
+    docString: ScenarioDocStringSchema.optional(),
+})
+    .strict();
+/**
+ * Schema for scenario references from Gherkin feature files
+ *
+ * This schema defines the structure for scenario references
+ * used in ExtractedPattern.scenarios.
+ */
+export const ScenarioRefSchema = z
+    .object({
+    /** Absolute path to the feature file */
+    featureFile: z.string(),
+    /** Name of the feature */
+    featureName: z.string(),
+    /** Description of the feature (from lines between Feature: and Background:/Scenario:) */
+    featureDescription: z.string(),
+    /** Name of the scenario */
+    scenarioName: z.string(),
+    /** Semantic tags on the scenario (e.g., @happy-path, @validation) */
+    semanticTags: z.array(z.string()).readonly(),
+    /** All tags on the scenario (excluding @pattern:*) */
+    tags: z.array(z.string()).readonly(),
+    /** Scenario steps with Given/When/Then (optional; not all extractors populate steps) */
+    steps: z.array(ScenarioStepSchema).readonly().optional(),
+    /** Inferred feature layer based on directory path (timeline, domain, integration, e2e, component) */
+    layer: z.enum(LAYER_TYPES).optional(),
+    /** Line number in feature file (for traceability links) */
+    line: z.number().int().positive().optional(),
+})
+    .strict();
+//# sourceMappingURL=scenario-ref.js.map

package/dist/validation-schemas/scenario-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-ref.js","sourceRoot":"","sources":["../../src/validation-schemas/scenario-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC;IACN,wCAAwC;IACxC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvC,2EAA2E;IAC3E,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC3D,CAAC;KACD,MAAM,EAAE,CAAC;AAIZ;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC;IACN,4BAA4B;IAC5B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,gFAAgF;IAChF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,MAAM,EAAE,CAAC;AAIZ;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,MAAM,CAAC;IACN,iDAAiD;IACjD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,gBAAgB;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,+CAA+C;IAC/C,SAAS,EAAE,uBAAuB,CAAC,QAAQ,EAAE;IAC7C,qFAAqF;IACrF,SAAS,EAAE,uBAAuB,CAAC,QAAQ,EAAE;CAC9C,CAAC;KACD,MAAM,EAAE,CAAC;AAIZ;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,MAAM,CAAC;IACN,wCAAwC;IACxC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,0BAA0B;IAC1B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,yFAAyF;IACzF,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC9B,2BAA2B;IAC3B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,qEAAqE;IACrE,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC5C,sDAAsD;IACtD,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,wFAAwF;IACxF,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACxD,qGAAqG;IACrG,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE;IACrC,2DAA2D;IAC3D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC7C,CAAC;KACD,MAAM,EAAE,CAAC"}

package/dist/validation-schemas/tag-registry.d.ts

@@ -0,0 +1,210 @@
+/**
+ * @architect
+ * @architect-core @architect-infra
+ * @architect-pattern Tag Registry Configuration
+ * @architect-status completed
+ *
+ * ## Tag Registry Configuration Schema
+ *
+ * Defines the structure and validation for tag taxonomy configuration.
+ * The taxonomy is defined in TypeScript at src/taxonomy/ and built via buildRegistry().
+ *
+ * ### When to Use
+ *
+ * - Validating tag registry configuration at runtime
+ * - Merging custom registry overrides with default registry
+ * - Creating Architect instances with custom categories
+ */
+import { z } from 'zod';
+/**
+ * Category definition schema
+ *
+ * Defines a documentation category (e.g., "core", "ddd", "event-sourcing").
+ * Categories organize patterns by domain and determine priority when a pattern
+ * has multiple category tags.
+ *
+ * @example
+ * ```typescript
+ * {
+ *   tag: "event-sourcing",
+ *   domain: "Event Sourcing",
+ *   priority: 4,
+ *   description: "Event store, aggregates, replay",
+ *   aliases: ["es"]
+ * }
+ * ```
+ */
+export declare const CategoryDefinitionSchema: z.ZodObject<{
+    tag: z.ZodString;
+    domain: z.ZodString;
+    priority: z.ZodNumber;
+    description: z.ZodString;
+    aliases: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+}, z.core.$strict>;
+export type CategoryDefinition = z.infer<typeof CategoryDefinitionSchema>;
+/**
+ * Metadata tag definition schema
+ *
+ * Defines a metadata tag (e.g., "pattern", "status", "usecase").
+ * Metadata tags provide additional information about patterns beyond categorization.
+ *
+ * @example
+ * ```typescript
+ * {
+ *   tag: "status",
+ *   format: "enum",
+ *   purpose: "Implementation status",
+ *   required: false,
+ *   values: ["roadmap", "active", "completed"],
+ *   default: "roadmap",
+ *   example: "@architect-status completed"
+ * }
+ * ```
+ */
+export declare const MetadataTagDefinitionSchema: z.ZodObject<{
+    tag: z.ZodString;
+    format: z.ZodEnum<{
+        number: "number";
+        value: "value";
+        enum: "enum";
+        "quoted-value": "quoted-value";
+        csv: "csv";
+        flag: "flag";
+    }>;
+    purpose: z.ZodString;
+    required: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    repeatable: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    default: z.ZodOptional<z.ZodString>;
+    example: z.ZodOptional<z.ZodString>;
+    metadataKey: z.ZodOptional<z.ZodString>;
+    transform: z.ZodOptional<z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>>;
+}, z.core.$strict>;
+export type MetadataTagDefinition = z.infer<typeof MetadataTagDefinitionSchema>;
+/**
+ * Aggregation tag definition schema
+ *
+ * Defines tags that route patterns to specific aggregated documents
+ * (e.g., OVERVIEW.md, DECISIONS.md).
+ *
+ * @example
+ * ```typescript
+ * {
+ *   tag: "overview",
+ *   targetDoc: "OVERVIEW.md",
+ *   purpose: "Architecture overview patterns"
+ * }
+ * ```
+ */
+export declare const AggregationTagDefinitionSchema: z.ZodObject<{
+    tag: z.ZodString;
+    targetDoc: z.ZodNullable<z.ZodString>;
+    purpose: z.ZodString;
+}, z.core.$strict>;
+export type AggregationTagDefinition = z.infer<typeof AggregationTagDefinitionSchema>;
+/**
+ * Complete tag registry schema
+ *
+ * Defines the full taxonomy configuration for a project, including all categories,
+ * metadata tags, aggregation tags, and format options.
+ *
+ * @example
+ * ```typescript
+ * {
+ *   version: "1.0.0",
+ *   categories: [
+ *     { tag: "core", domain: "Core", priority: 1, description: "Core utilities", aliases: [] }
+ *   ],
+ *   metadataTags: [
+ *     { tag: "pattern", format: "value", purpose: "Pattern name", required: true }
+ *   ],
+ *   aggregationTags: [
+ *     { tag: "overview", targetDoc: "OVERVIEW.md", purpose: "Overview patterns" }
+ *   ],
+ *   formatOptions: ["full", "list", "summary"],
+ *   tagPrefix: "@architect-",
+ *   fileOptInTag: "@architect"
+ * }
+ * ```
+ */
+export declare const TagRegistrySchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    version: z.ZodDefault<z.ZodString>;
+    categories: z.ZodArray<z.ZodObject<{
+        tag: z.ZodString;
+        domain: z.ZodString;
+        priority: z.ZodNumber;
+        description: z.ZodString;
+        aliases: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    }, z.core.$strict>>;
+    metadataTags: z.ZodArray<z.ZodObject<{
+        tag: z.ZodString;
+        format: z.ZodEnum<{
+            number: "number";
+            value: "value";
+            enum: "enum";
+            "quoted-value": "quoted-value";
+            csv: "csv";
+            flag: "flag";
+        }>;
+        purpose: z.ZodString;
+        required: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        repeatable: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        default: z.ZodOptional<z.ZodString>;
+        example: z.ZodOptional<z.ZodString>;
+        metadataKey: z.ZodOptional<z.ZodString>;
+        transform: z.ZodOptional<z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>>;
+    }, z.core.$strict>>;
+    aggregationTags: z.ZodArray<z.ZodObject<{
+        tag: z.ZodString;
+        targetDoc: z.ZodNullable<z.ZodString>;
+        purpose: z.ZodString;
+    }, z.core.$strict>>;
+    formatOptions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    tagPrefix: z.ZodDefault<z.ZodString>;
+    fileOptInTag: z.ZodDefault<z.ZodString>;
+}, z.core.$strict>;
+export type TagRegistry = z.infer<typeof TagRegistrySchema>;
+/**
+ * Create default tag registry
+ *
+ * Delegates to the taxonomy module's buildRegistry() function which is
+ * the single source of truth for all taxonomy definitions.
+ *
+ * @returns Default tag registry with all categories and metadata tags
+ *
+ * @see src/taxonomy/registry-builder.ts
+ *
+ * @example
+ * ```typescript
+ * const defaultRegistry = createDefaultTagRegistry();
+ * console.log(defaultRegistry.categories); // Full DDD/ES/CQRS taxonomy
+ * ```
+ */
+export declare function createDefaultTagRegistry(): TagRegistry;
+/**
+ * Merge user registry with default registry
+ *
+ * Performs deep merge where user registry extends and overrides defaults:
+ * - Categories: Merged by tag (user overrides default, user additions kept)
+ * - MetadataTags: Merged by tag (user overrides default, user additions kept)
+ * - AggregationTags: Merged by tag (user overrides default)
+ * - FormatOptions: Full replacement if specified
+ * - TagPrefix: Full replacement if specified
+ * - FileOptInTag: Full replacement if specified
+ *
+ * @param base - Base registry (usually default registry)
+ * @param override - User registry to merge on top
+ * @returns Merged registry
+ *
+ * @example
+ * ```typescript
+ * const base = createDefaultTagRegistry();
+ * const user = { categories: [{ tag: "core", domain: "Core", priority: 10, description: "..." }] };
+ * const merged = mergeTagRegistries(base, user);
+ * // merged.categories[0].priority === 10 (user override)
+ * ```
+ */
+export declare function mergeTagRegistries(base: TagRegistry, override: Partial<TagRegistry>): TagRegistry;
+//# sourceMappingURL=tag-registry.d.ts.map

package/dist/validation-schemas/tag-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag-registry.d.ts","sourceRoot":"","sources":["../../src/validation-schemas/tag-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,wBAAwB;;;;;;kBAa1B,CAAC;AAEZ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;kBAuB7B,CAAC;AAEZ,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,8BAA8B;;;;kBAShC,CAAC;AAEZ,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmBnB,CAAC;AAEZ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,IAAI,WAAW,CAiBtD;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CA6BjG"}

package/dist/validation-schemas/tag-registry.js

@@ -0,0 +1,248 @@
+/**
+ * @architect
+ * @architect-core @architect-infra
+ * @architect-pattern Tag Registry Configuration
+ * @architect-status completed
+ *
+ * ## Tag Registry Configuration Schema
+ *
+ * Defines the structure and validation for tag taxonomy configuration.
+ * The taxonomy is defined in TypeScript at src/taxonomy/ and built via buildRegistry().
+ *
+ * ### When to Use
+ *
+ * - Validating tag registry configuration at runtime
+ * - Merging custom registry overrides with default registry
+ * - Creating Architect instances with custom categories
+ */
+import { z } from 'zod';
+import { buildRegistry, FORMAT_TYPES } from '../taxonomy/index.js';
+/**
+ * Category definition schema
+ *
+ * Defines a documentation category (e.g., "core", "ddd", "event-sourcing").
+ * Categories organize patterns by domain and determine priority when a pattern
+ * has multiple category tags.
+ *
+ * @example
+ * ```typescript
+ * {
+ *   tag: "event-sourcing",
+ *   domain: "Event Sourcing",
+ *   priority: 4,
+ *   description: "Event store, aggregates, replay",
+ *   aliases: ["es"]
+ * }
+ * ```
+ */
+export const CategoryDefinitionSchema = z
+    .object({
+    /** Tag name (without prefix), e.g., "event-sourcing" */
+    tag: z.string().min(1, 'Category tag cannot be empty').max(100),
+    /** Display name for the category, e.g., "Event Sourcing" */
+    domain: z.string().min(1, 'Category domain cannot be empty').max(200),
+    /** Priority for category selection (lower number = higher priority) */
+    priority: z.number().int().positive('Priority must be a positive integer'),
+    /** Human-readable description of what this category represents */
+    description: z.string().max(1000),
+    /** Alternative tag names that map to this category */
+    aliases: z.array(z.string().max(100)).max(20).optional().default([]),
+})
+    .strict();
+/**
+ * Metadata tag definition schema
+ *
+ * Defines a metadata tag (e.g., "pattern", "status", "usecase").
+ * Metadata tags provide additional information about patterns beyond categorization.
+ *
+ * @example
+ * ```typescript
+ * {
+ *   tag: "status",
+ *   format: "enum",
+ *   purpose: "Implementation status",
+ *   required: false,
+ *   values: ["roadmap", "active", "completed"],
+ *   default: "roadmap",
+ *   example: "@architect-status completed"
+ * }
+ * ```
+ */
+export const MetadataTagDefinitionSchema = z
+    .object({
+    /** Tag name (without prefix), e.g., "status" */
+    tag: z.string().min(1, 'Metadata tag cannot be empty').max(100),
+    /** Format specifies how the tag value is parsed (from taxonomy/format-types.ts) */
+    format: z.enum(FORMAT_TYPES),
+    /** Human-readable description of the tag's purpose */
+    purpose: z.string().max(1000),
+    /** Whether this tag is required for all patterns */
+    required: z.boolean().optional().default(false),
+    /** Whether this tag can appear multiple times */
+    repeatable: z.boolean().optional().default(false),
+    /** Valid values for enum format */
+    values: z.array(z.string().max(200)).max(50).optional(),
+    /** Default value if tag is not specified */
+    default: z.string().max(200).optional(),
+    /** Example usage of this tag */
+    example: z.string().max(500).optional(),
+    /** Maps tag name to metadata object property name (defaults to kebab-to-camelCase) */
+    metadataKey: z.string().max(100).optional(),
+    /** Post-parse value transformer (runtime-only, not serializable) */
+    transform: z.function().optional(),
+})
+    .strict();
+/**
+ * Aggregation tag definition schema
+ *
+ * Defines tags that route patterns to specific aggregated documents
+ * (e.g., OVERVIEW.md, DECISIONS.md).
+ *
+ * @example
+ * ```typescript
+ * {
+ *   tag: "overview",
+ *   targetDoc: "OVERVIEW.md",
+ *   purpose: "Architecture overview patterns"
+ * }
+ * ```
+ */
+export const AggregationTagDefinitionSchema = z
+    .object({
+    /** Tag name (without prefix), e.g., "overview" */
+    tag: z.string().min(1, 'Aggregation tag cannot be empty').max(100),
+    /** Target document filename, or null for template placeholders only */
+    targetDoc: z.string().max(200).nullable(),
+    /** Human-readable description of where patterns with this tag appear */
+    purpose: z.string().max(1000),
+})
+    .strict();
+/**
+ * Complete tag registry schema
+ *
+ * Defines the full taxonomy configuration for a project, including all categories,
+ * metadata tags, aggregation tags, and format options.
+ *
+ * @example
+ * ```typescript
+ * {
+ *   version: "1.0.0",
+ *   categories: [
+ *     { tag: "core", domain: "Core", priority: 1, description: "Core utilities", aliases: [] }
+ *   ],
+ *   metadataTags: [
+ *     { tag: "pattern", format: "value", purpose: "Pattern name", required: true }
+ *   ],
+ *   aggregationTags: [
+ *     { tag: "overview", targetDoc: "OVERVIEW.md", purpose: "Overview patterns" }
+ *   ],
+ *   formatOptions: ["full", "list", "summary"],
+ *   tagPrefix: "@architect-",
+ *   fileOptInTag: "@architect"
+ * }
+ * ```
+ */
+export const TagRegistrySchema = z
+    .object({
+    /** JSON Schema reference (standard $schema property, optional) */
+    $schema: z.string().max(500).optional(),
+    /** Schema version for future compatibility */
+    version: z.string().max(20).default('1.0.0'),
+    /** Category definitions for organizing patterns */
+    categories: z.array(CategoryDefinitionSchema).max(1000),
+    /** Metadata tag definitions for pattern enrichment */
+    metadataTags: z.array(MetadataTagDefinitionSchema).max(100),
+    /** Aggregation tag definitions for document routing */
+    aggregationTags: z.array(AggregationTagDefinitionSchema).max(50),
+    /** Valid format options for template placeholders */
+    formatOptions: z.array(z.string().max(50)).max(20).default(['full', 'list', 'summary']),
+    /** Prefix used for all Architect tags */
+    tagPrefix: z.string().max(50).default('@architect-'),
+    /** File-level opt-in tag that gates extraction */
+    fileOptInTag: z.string().max(50).default('@architect'),
+})
+    .strict();
+/**
+ * Create default tag registry
+ *
+ * Delegates to the taxonomy module's buildRegistry() function which is
+ * the single source of truth for all taxonomy definitions.
+ *
+ * @returns Default tag registry with all categories and metadata tags
+ *
+ * @see src/taxonomy/registry-builder.ts
+ *
+ * @example
+ * ```typescript
+ * const defaultRegistry = createDefaultTagRegistry();
+ * console.log(defaultRegistry.categories); // Full DDD/ES/CQRS taxonomy
+ * ```
+ */
+export function createDefaultTagRegistry() {
+    const registry = buildRegistry();
+    // Convert readonly arrays to mutable for compatibility with TagRegistry type
+    return {
+        version: registry.version,
+        categories: [...registry.categories].map((c) => ({ ...c, aliases: [...c.aliases] })),
+        metadataTags: [...registry.metadataTags].map((t) => ({
+            ...t,
+            values: t.values ? [...t.values] : undefined,
+            required: t.required ?? false,
+            repeatable: t.repeatable ?? false,
+        })),
+        aggregationTags: [...registry.aggregationTags],
+        formatOptions: [...registry.formatOptions],
+        tagPrefix: registry.tagPrefix,
+        fileOptInTag: registry.fileOptInTag,
+    };
+}
+/**
+ * Merge user registry with default registry
+ *
+ * Performs deep merge where user registry extends and overrides defaults:
+ * - Categories: Merged by tag (user overrides default, user additions kept)
+ * - MetadataTags: Merged by tag (user overrides default, user additions kept)
+ * - AggregationTags: Merged by tag (user overrides default)
+ * - FormatOptions: Full replacement if specified
+ * - TagPrefix: Full replacement if specified
+ * - FileOptInTag: Full replacement if specified
+ *
+ * @param base - Base registry (usually default registry)
+ * @param override - User registry to merge on top
+ * @returns Merged registry
+ *
+ * @example
+ * ```typescript
+ * const base = createDefaultTagRegistry();
+ * const user = { categories: [{ tag: "core", domain: "Core", priority: 10, description: "..." }] };
+ * const merged = mergeTagRegistries(base, user);
+ * // merged.categories[0].priority === 10 (user override)
+ * ```
+ */
+export function mergeTagRegistries(base, override) {
+    // Helper to merge arrays by tag, with user overrides taking precedence
+    function mergeByTag(baseArr, overrideArr) {
+        if (!overrideArr)
+            return baseArr;
+        const merged = new Map();
+        // Add all base items
+        for (const item of baseArr) {
+            merged.set(item.tag, item);
+        }
+        // Override/add user items
+        for (const item of overrideArr) {
+            merged.set(item.tag, item);
+        }
+        return Array.from(merged.values());
+    }
+    return {
+        version: override.version ?? base.version,
+        categories: mergeByTag(base.categories, override.categories),
+        metadataTags: mergeByTag(base.metadataTags, override.metadataTags),
+        aggregationTags: mergeByTag(base.aggregationTags, override.aggregationTags),
+        formatOptions: override.formatOptions ?? base.formatOptions,
+        tagPrefix: override.tagPrefix ?? base.tagPrefix,
+        fileOptInTag: override.fileOptInTag ?? base.fileOptInTag,
+    };
+}
+//# sourceMappingURL=tag-registry.js.map

package/dist/validation-schemas/tag-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag-registry.js","sourceRoot":"","sources":["../../src/validation-schemas/tag-registry.ts"],"names":[],"mappings":"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"}