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

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

@@ -1,80 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,73 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,210 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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

@@ -1,248 +0,0 @@
-/**
- * @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

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