@libar-dev/architect 1.0.0-pre.3

package/dist/validation-schemas/doc-directive.js

@@ -0,0 +1,239 @@
+/**
+ * @architect
+ * @architect-validation
+ * @architect-pattern DocDirectiveSchema
+ * @architect-status completed
+ * @architect-implements MvpWorkflowImplementation
+ * @architect-used-by DocExtractor, ExtractedPatternSchema
+ *
+ * ## DocDirectiveSchema - Parsed JSDoc Directive Validation
+ *
+ * Zod schemas for validating parsed @architect-* directives from JSDoc comments.
+ * Enforces tag format, position validity, and metadata extraction.
+ *
+ * ### When to Use
+ *
+ * - Use when parsing JSDoc comments for @architect-* tags
+ * - Use when validating directive structure at boundaries
+ */
+import { z } from 'zod';
+import { ACCEPTED_STATUS_VALUES, PROCESS_STATUS_VALUES, } from '../taxonomy/index.js';
+import { asDirectiveTag } from '../types/branded.js';
+import { CLAUDE_SECTION_VALUES } from '../taxonomy/claude-section-values.js';
+/**
+ * Position information for a directive in source code
+ */
+export const PositionSchema = z
+    .object({
+    /** Starting line number (1-indexed) */
+    startLine: z.number().int().positive('Line numbers must be positive'),
+    /** Ending line number (1-indexed) */
+    endLine: z.number().int().positive('Line numbers must be positive'),
+})
+    .strict()
+    .refine((pos) => pos.endLine >= pos.startLine, {
+    message: 'End line must be >= start line',
+});
+/**
+ * Creates a DirectiveTag schema for a given tag prefix.
+ * This factory enables projects to use custom prefixes (e.g., "@acme-" instead of "@architect-").
+ *
+ * @param tagPrefix - The tag prefix to validate against (e.g., "@acme-" or "@architect-")
+ * @returns Zod schema that validates and transforms tags with the given prefix
+ *
+ * @example
+ * ```typescript
+ * // Custom prefix
+ * const customSchema = createDirectiveTagSchema("@acme-");
+ * customSchema.parse("@acme-pattern"); // Valid
+ *
+ * // Default prefix
+ * const defaultSchema = createDirectiveTagSchema("@architect-");
+ * defaultSchema.parse("@architect-status"); // Valid
+ * ```
+ */
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
+export function createDirectiveTagSchema(tagPrefix) {
+    return z
+        .string()
+        .min(1, 'Tag cannot be empty')
+        .refine((tag) => tag.startsWith(tagPrefix), {
+        message: `Tags must start with ${tagPrefix}`,
+    })
+        .transform((tag) => asDirectiveTag(tag));
+}
+/**
+ * Directive tag validation (default prefix)
+ * Must start with @architect-
+ *
+ * For custom prefixes, use createDirectiveTagSchema().
+ */
+const DirectiveTagSchema = createDirectiveTagSchema('@architect-');
+/**
+ * Default status values for pattern implementation state
+ *
+ * Uses the single source of truth from taxonomy module (PDR-005 FSM).
+ * For registry-based status validation, use createPatternStatusSchema().
+ *
+ * @see src/taxonomy/status-values.ts
+ */
+export const DefaultPatternStatusSchema = z.enum(PROCESS_STATUS_VALUES);
+/**
+ * Status values accepted for directive validation
+ *
+ * @see src/taxonomy/status-values.ts
+ */
+export const AcceptedPatternStatusSchema = z.enum(ACCEPTED_STATUS_VALUES);
+/**
+ * Pattern status schema for directive validation
+ *
+ * Accepts canonical PDR-005 FSM states only.
+ */
+export const PatternStatusSchema = z.enum(PROCESS_STATUS_VALUES);
+/**
+ * Create pattern status schema from tag registry
+ *
+ * Builds a Zod enum schema using status values defined in the registry's
+ * metadata tags. Falls back to default schema if "status" tag not found in registry.
+ *
+ * @param registry - Tag registry containing metadata tag definitions
+ * @returns Zod enum schema for pattern status validation
+ *
+ * @example
+ * ```typescript
+ * const config = await loadConfig();
+ * const statusSchema = createPatternStatusSchema(config.tagRegistry);
+ * const result = statusSchema.safeParse("completed"); // Validates against registry values
+ * ```
+ */
+export function createPatternStatusSchema(registry) {
+    const statusTag = registry.metadataTags.find((t) => t.tag === 'status');
+    if (statusTag?.values && statusTag.values.length > 0) {
+        // Zod enum requires at least one value, and the type is [string, ...string[]]
+        const [first, ...rest] = statusTag.values;
+        if (first) {
+            return z.enum([first, ...rest]);
+        }
+    }
+    // Fallback to default if not found or invalid
+    return DefaultPatternStatusSchema;
+}
+/**
+ * Parsed @architect-* directive from JSDoc comment
+ *
+ * Schema enforces:
+ * - At least one tag
+ * - Valid position with endLine >= startLine
+ * - Strict mode to prevent extra fields
+ *
+ * Description defaults to empty string to allow tag-only directives:
+ * ```typescript
+ * /**
+ *  * @architect-core
+ *  *\/
+ * export function myFunction() {}
+ * ```
+ */
+export const DocDirectiveSchema = z
+    .object({
+    /** Tags found in comment (e.g., ['@architect-core', '@architect-types']). Empty allowed for Gherkin-sourced patterns. */
+    tags: z.array(DirectiveTagSchema).readonly(),
+    /** Full description text from JSDoc (defaults to empty for tag-only directives) */
+    description: z.string().default(''),
+    /** Examples found in JSDoc @example tags */
+    examples: z.array(z.string()).readonly().default([]),
+    /** Position in source file */
+    position: PositionSchema,
+    /** Explicit pattern name from @architect-pattern tag */
+    patternName: z.string().optional(),
+    /** Implementation status from @architect-status tag */
+    status: PatternStatusSchema.optional(),
+    /** Whether this is a core/essential pattern from @architect-core tag */
+    isCore: z.boolean().optional(),
+    /** Use cases this pattern applies to from @architect-usecase tags */
+    useCases: z.array(z.string()).readonly().optional(),
+    /** "When to use" bullet points extracted from description (### When to Use or **When to use:**) */
+    whenToUse: z.array(z.string()).readonly().optional(),
+    /** Patterns this pattern uses (from @architect-uses tag) */
+    uses: z.array(z.string()).readonly().optional(),
+    /** Patterns that use this pattern (from @architect-used-by tag) */
+    usedBy: z.array(z.string()).readonly().optional(),
+    /** Roadmap phase number (from @architect-phase tag) */
+    phase: z.number().int().positive().optional(),
+    /** Path to pattern brief markdown file (from @architect-brief tag) */
+    brief: z.string().optional(),
+    /** Patterns this pattern depends on for roadmap planning (from @architect-depends-on tag) */
+    dependsOn: z.array(z.string()).readonly().optional(),
+    /** Patterns this pattern enables/unlocks (from @architect-enables tag) */
+    enables: z.array(z.string()).readonly().optional(),
+    /** Patterns this code realizes (from @architect-implements tag) */
+    implements: z.array(z.string()).readonly().optional(),
+    /** Base pattern this extends (from @architect-extends tag) */
+    extends: z.string().optional(),
+    /** Related patterns for cross-reference without dependency (from @architect-see-also tag) */
+    seeAlso: z.array(z.string()).readonly().optional(),
+    /** File paths to implementation APIs (from @architect-api-ref tag) */
+    apiRef: z.array(z.string()).readonly().optional(),
+    /** Delivery quarter for timeline workflow (from @architect-quarter tag) */
+    quarter: z.string().optional(),
+    /** Completion date for timeline workflow (from @architect-completed tag) */
+    completed: z.string().optional(),
+    /** Effort estimate for timeline workflow (from @architect-effort tag) */
+    effort: z.string().optional(),
+    /** Actual effort logged after implementation (from @architect-effort-actual tag) */
+    effortActual: z.string().optional(),
+    /** Responsible team for process workflow (from @architect-team tag) */
+    team: z.string().optional(),
+    /** Workflow/discipline for process workflow (from @architect-workflow tag) */
+    workflow: z.string().optional(),
+    /** Risk level for process workflow (from @architect-risk tag) */
+    risk: z.string().optional(),
+    /** Priority level for process workflow (from @architect-priority tag) */
+    priority: z.string().optional(),
+    // Design session stub metadata (from @architect-target, @architect-since tags)
+    /** Target implementation path for stub files (from @architect-target tag) */
+    target: z.string().optional(),
+    /** Design session that created this pattern (from @architect-since tag) */
+    since: z.string().optional(),
+    // Architecture diagram generation fields (from @architect-arch-* tags)
+    /** Architectural role for diagram generation (from @architect-arch-role tag) */
+    archRole: z.string().optional(),
+    /** Bounded context this component belongs to (from @architect-arch-context tag) */
+    archContext: z.string().optional(),
+    /** Architectural layer (from @architect-arch-layer tag) */
+    archLayer: z.string().optional(),
+    /** Cross-cutting document inclusion for content routing and diagram scoping (from @architect-include CSV tag) */
+    include: z.array(z.string().min(1)).readonly().optional(),
+    /** Product area for PRD grouping (from @architect-product-area tag) */
+    productArea: z.string().optional(),
+    // Shape extraction fields
+    /** Shape names to extract from this file (from @architect-extract-shapes tag) */
+    extractShapes: z.array(z.string()).readonly().optional(),
+    /** Convention domains for reference document generation (from @architect-convention CSV tag) */
+    convention: z.array(z.string()).readonly().optional(),
+    // Claude module generation fields (from @architect-claude-* tags)
+    /** Module identifier for CLAUDE.md generation (from @architect-claude-module tag) */
+    claudeModule: z.string().optional(),
+    /** Target section directory in _claude-md/ (from @architect-claude-section tag) */
+    claudeSection: z.enum(CLAUDE_SECTION_VALUES).optional(),
+    /** Variation filtering tags for modular-claude-md (from @architect-claude-tags CSV tag) */
+    claudeTags: z.array(z.string()).readonly().optional(),
+})
+    .strict();
+/**
+ * Runtime type guard for DocDirective
+ *
+ * @param value - Value to check
+ * @returns True if value conforms to DocDirective schema
+ *
+ * @example
+ * ```typescript
+ * if (isDocDirective(parsed)) {
+ *   console.log(parsed.tags); // Type-safe access
+ * }
+ * ```
+ */
+export function isDocDirective(value) {
+    return DocDirectiveSchema.safeParse(value).success;
+}
+//# sourceMappingURL=doc-directive.js.map

package/dist/validation-schemas/doc-directive.js.map

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

package/dist/validation-schemas/dual-source.d.ts

@@ -0,0 +1,167 @@
+/**
+ * @architect
+ * @architect-validation
+ * @architect-pattern DualSourceSchemas
+ * @architect-status completed
+ * @architect-implements MvpWorkflowImplementation
+ * @architect-used-by DocExtractor, FeatureParser, CrossValidator
+ *
+ * ## DualSourceSchemas - Dual-Source Extraction Type Validation
+ *
+ * Zod schemas for dual-source extraction types.
+ *
+ * Following the project's schema-first pattern, all dual-source types
+ * are defined as Zod schemas with TypeScript types inferred from them.
+ *
+ * ### When to Use
+ *
+ * - When validating process metadata from Gherkin feature tags
+ * - When validating deliverables from Background tables
+ * - When performing cross-validation between code and feature files
+ */
+import { z } from 'zod';
+import { type HierarchyLevel as TaxonomyHierarchyLevel, type ProcessStatusValue, type RiskLevel as TaxonomyRiskLevel } from '../taxonomy/index.js';
+/**
+ * Process status values from Gherkin @architect-status tag
+ *
+ * Per PDR-005 MVP Workflow State Machine:
+ * - roadmap: Planned work, fully editable
+ * - active: In progress, scope-locked
+ * - completed: Done, hard-locked
+ * - deferred: On hold, fully editable
+ *
+ * @see architect/src/taxonomy/status-values.ts
+ */
+export declare const ProcessStatusSchema: z.ZodEnum<{
+    roadmap: "roadmap";
+    active: "active";
+    completed: "completed";
+    deferred: "deferred";
+}>;
+export type ProcessStatus = ProcessStatusValue;
+/**
+ * Hierarchy level values from Gherkin @architect-level tag
+ *
+ * Three-level hierarchy for organizing work:
+ * - **epic**: Multi-quarter strategic initiatives
+ * - **phase**: Standard work units (2-5 days)
+ * - **task**: Fine-grained session-level work (1-4 hours)
+ *
+ * Default is "phase".
+ *
+ * @see architect/src/taxonomy/hierarchy-levels.ts
+ */
+export declare const HierarchyLevelSchema: z.ZodEnum<{
+    epic: "epic";
+    phase: "phase";
+    task: "task";
+}>;
+export type HierarchyLevel = TaxonomyHierarchyLevel;
+/**
+ * Risk level values from Gherkin @architect-risk tag
+ *
+ * @see architect/src/taxonomy/risk-levels.ts
+ */
+export declare const RiskLevelSchema: z.ZodEnum<{
+    low: "low";
+    medium: "medium";
+    high: "high";
+}>;
+export type RiskLevel = TaxonomyRiskLevel;
+/**
+ * Process metadata from Gherkin feature tags (@architect-*)
+ *
+ * Extracted from timeline feature files to provide temporal process data
+ * (quarter, effort, team, workflow) that complements the timeless pattern
+ * graph data from TypeScript code annotations.
+ */
+export declare const ProcessMetadataSchema: z.ZodObject<{
+    pattern: z.ZodString;
+    phase: z.ZodNumber;
+    status: z.ZodEnum<{
+        roadmap: "roadmap";
+        active: "active";
+        completed: "completed";
+        deferred: "deferred";
+    }>;
+    level: z.ZodDefault<z.ZodEnum<{
+        epic: "epic";
+        phase: "phase";
+        task: "task";
+    }>>;
+    parent: z.ZodOptional<z.ZodString>;
+    quarter: z.ZodOptional<z.ZodString>;
+    effort: z.ZodOptional<z.ZodString>;
+    team: z.ZodOptional<z.ZodString>;
+    workflow: z.ZodOptional<z.ZodString>;
+    completed: z.ZodOptional<z.ZodString>;
+    effortActual: z.ZodOptional<z.ZodString>;
+    risk: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+    }>>;
+    brief: z.ZodOptional<z.ZodString>;
+    productArea: z.ZodOptional<z.ZodString>;
+    userRole: z.ZodOptional<z.ZodString>;
+    businessValue: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ProcessMetadata = z.infer<typeof ProcessMetadataSchema>;
+/**
+ * Deliverable from Gherkin Background table
+ *
+ * Parsed from Background section tables with format:
+ * | Deliverable | Status | Tests | Location |
+ *
+ * Optional columns for extended tracking:
+ * | Deliverable | Status | Tests | Location | Finding | Release |
+ *
+ * - **Finding**: Review traceability ID (e.g., "CODE-001")
+ * - **Release**: Semver version for changelog grouping (e.g., "v0.2.0")
+ */
+export declare const DeliverableSchema: z.ZodObject<{
+    name: z.ZodString;
+    status: z.ZodEnum<{
+        deferred: "deferred";
+        complete: "complete";
+        "in-progress": "in-progress";
+        pending: "pending";
+        superseded: "superseded";
+        "n/a": "n/a";
+    }>;
+    tests: z.ZodNumber;
+    location: z.ZodString;
+    finding: z.ZodOptional<z.ZodString>;
+    release: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type Deliverable = z.infer<typeof DeliverableSchema>;
+/**
+ * Cross-validation error when code and feature don't match
+ *
+ * Reports misalignment between TypeScript code annotations and
+ * Gherkin feature tags (e.g., phase number mismatch).
+ */
+export declare const CrossValidationErrorSchema: z.ZodObject<{
+    codeName: z.ZodString;
+    featureName: z.ZodString;
+    codePhase: z.ZodOptional<z.ZodNumber>;
+    featurePhase: z.ZodNumber;
+    sources: z.ZodObject<{
+        code: z.ZodString;
+        feature: z.ZodString;
+    }, z.core.$strict>;
+    message: z.ZodString;
+}, z.core.$strict>;
+export type CrossValidationError = z.infer<typeof CrossValidationErrorSchema>;
+/**
+ * Validation summary from dual-source consistency check
+ *
+ * Provides boolean validity flag and categorized errors/warnings.
+ */
+export declare const ValidationSummarySchema: z.ZodObject<{
+    isValid: z.ZodBoolean;
+    errors: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+    warnings: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export type ValidationSummary = z.infer<typeof ValidationSummarySchema>;
+//# sourceMappingURL=dual-source.d.ts.map

package/dist/validation-schemas/dual-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dual-source.d.ts","sourceRoot":"","sources":["../../src/validation-schemas/dual-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAKL,KAAK,cAAc,IAAI,sBAAsB,EAC7C,KAAK,kBAAkB,EACvB,KAAK,SAAS,IAAI,iBAAiB,EACpC,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB;;;;;EAAgC,CAAC;AACjE,MAAM,MAAM,aAAa,GAAG,kBAAkB,CAAC;AAE/C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB;;;;EAA2B,CAAC;AAC7D,MAAM,MAAM,cAAc,GAAG,sBAAsB,CAAC;AAEpD;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;EAAsB,CAAC;AACnD,MAAM,MAAM,SAAS,GAAG,iBAAiB,CAAC;AAE1C;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmCvB,CAAC;AAEZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;kBAenB,CAAC;AAEZ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;kBAoB5B,CAAC;AAEZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;kBASzB,CAAC;AAEZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/validation-schemas/dual-source.js

@@ -0,0 +1,168 @@
+/**
+ * @architect
+ * @architect-validation
+ * @architect-pattern DualSourceSchemas
+ * @architect-status completed
+ * @architect-implements MvpWorkflowImplementation
+ * @architect-used-by DocExtractor, FeatureParser, CrossValidator
+ *
+ * ## DualSourceSchemas - Dual-Source Extraction Type Validation
+ *
+ * Zod schemas for dual-source extraction types.
+ *
+ * Following the project's schema-first pattern, all dual-source types
+ * are defined as Zod schemas with TypeScript types inferred from them.
+ *
+ * ### When to Use
+ *
+ * - When validating process metadata from Gherkin feature tags
+ * - When validating deliverables from Background tables
+ * - When performing cross-validation between code and feature files
+ */
+import { z } from 'zod';
+import { DELIVERABLE_STATUS_VALUES, HIERARCHY_LEVELS, PROCESS_STATUS_VALUES, RISK_LEVELS, } from '../taxonomy/index.js';
+/**
+ * Process status values from Gherkin @architect-status tag
+ *
+ * Per PDR-005 MVP Workflow State Machine:
+ * - roadmap: Planned work, fully editable
+ * - active: In progress, scope-locked
+ * - completed: Done, hard-locked
+ * - deferred: On hold, fully editable
+ *
+ * @see architect/src/taxonomy/status-values.ts
+ */
+export const ProcessStatusSchema = z.enum(PROCESS_STATUS_VALUES);
+/**
+ * Hierarchy level values from Gherkin @architect-level tag
+ *
+ * Three-level hierarchy for organizing work:
+ * - **epic**: Multi-quarter strategic initiatives
+ * - **phase**: Standard work units (2-5 days)
+ * - **task**: Fine-grained session-level work (1-4 hours)
+ *
+ * Default is "phase".
+ *
+ * @see architect/src/taxonomy/hierarchy-levels.ts
+ */
+export const HierarchyLevelSchema = z.enum(HIERARCHY_LEVELS);
+/**
+ * Risk level values from Gherkin @architect-risk tag
+ *
+ * @see architect/src/taxonomy/risk-levels.ts
+ */
+export const RiskLevelSchema = z.enum(RISK_LEVELS);
+/**
+ * Process metadata from Gherkin feature tags (@architect-*)
+ *
+ * Extracted from timeline feature files to provide temporal process data
+ * (quarter, effort, team, workflow) that complements the timeless pattern
+ * graph data from TypeScript code annotations.
+ */
+export const ProcessMetadataSchema = z
+    .object({
+    /** Pattern name (must match code) */
+    pattern: z.string().min(1),
+    /** Phase number (must match code) */
+    phase: z.number().int().positive(),
+    /** Process status */
+    status: ProcessStatusSchema,
+    /** Hierarchy level (default: "phase") */
+    level: HierarchyLevelSchema.default('phase'),
+    /** Parent pattern name for hierarchy (from @architect-parent tag) */
+    parent: z.string().optional(),
+    /** Quarter assignment (e.g., "Q1-2025") */
+    quarter: z.string().optional(),
+    /** Effort estimate (e.g., "2w", "4d") */
+    effort: z.string().optional(),
+    /** Team assignment */
+    team: z.string().optional(),
+    /** Delivery workflow */
+    workflow: z.string().optional(),
+    /** Completion date (ISO format) */
+    completed: z.string().optional(),
+    /** Actual effort */
+    effortActual: z.string().optional(),
+    /** Risk level */
+    risk: RiskLevelSchema.optional(),
+    /** Pattern brief path */
+    brief: z.string().optional(),
+    /** Product area for PRD grouping */
+    productArea: z.string().optional(),
+    /** Target user persona */
+    userRole: z.string().optional(),
+    /** Business value statement */
+    businessValue: z.string().optional(),
+})
+    .strict();
+/**
+ * Deliverable from Gherkin Background table
+ *
+ * Parsed from Background section tables with format:
+ * | Deliverable | Status | Tests | Location |
+ *
+ * Optional columns for extended tracking:
+ * | Deliverable | Status | Tests | Location | Finding | Release |
+ *
+ * - **Finding**: Review traceability ID (e.g., "CODE-001")
+ * - **Release**: Semver version for changelog grouping (e.g., "v0.2.0")
+ */
+export const DeliverableSchema = z
+    .object({
+    /** Deliverable name/description */
+    name: z.string().min(1),
+    /** Canonical deliverable status (validated against DELIVERABLE_STATUS_VALUES) */
+    status: z.enum(DELIVERABLE_STATUS_VALUES),
+    /** Number of tests */
+    tests: z.number().int().nonnegative(),
+    /** Implementation location */
+    location: z.string(),
+    /** Optional finding ID for review traceability (e.g., "CODE-001", "ARCH-005") */
+    finding: z.string().optional(),
+    /** Optional release version for changelog grouping (e.g., "v0.2.0") */
+    release: z.string().optional(),
+})
+    .strict();
+/**
+ * Cross-validation error when code and feature don't match
+ *
+ * Reports misalignment between TypeScript code annotations and
+ * Gherkin feature tags (e.g., phase number mismatch).
+ */
+export const CrossValidationErrorSchema = z
+    .object({
+    /** Pattern name from code */
+    codeName: z.string(),
+    /** Pattern name from feature */
+    featureName: z.string(),
+    /** Phase from code (optional) */
+    codePhase: z.number().int().positive().optional(),
+    /** Phase from feature */
+    featurePhase: z.number().int().positive(),
+    /** Source file paths */
+    sources: z
+        .object({
+        code: z.string(),
+        feature: z.string(),
+    })
+        .strict(),
+    /** Error description */
+    message: z.string(),
+})
+    .strict();
+/**
+ * Validation summary from dual-source consistency check
+ *
+ * Provides boolean validity flag and categorized errors/warnings.
+ */
+export const ValidationSummarySchema = z
+    .object({
+    /** True if no errors (warnings don't fail validation) */
+    isValid: z.boolean(),
+    /** Critical errors (phase mismatches, etc.) */
+    errors: z.array(z.string()).readonly(),
+    /** Non-critical warnings (orphaned stubs, etc.) */
+    warnings: z.array(z.string()).readonly(),
+})
+    .strict();
+//# sourceMappingURL=dual-source.js.map

package/dist/validation-schemas/dual-source.js.map

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

package/dist/validation-schemas/export-info.d.ts

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+/**
+ * Discriminated union of all export types
+ *
+ * **Benefits:**
+ * - Type narrowing based on 'type' discriminant
+ * - Compile-time exhaustiveness checking
+ * - Better error messages from Zod
+ */
+export declare const ExportInfoSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"function">;
+    name: z.ZodString;
+    signature: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"type">;
+    name: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"const">;
+    name: z.ZodString;
+    signature: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"interface">;
+    name: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"class">;
+    name: z.ZodString;
+    signature: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"enum">;
+    name: z.ZodString;
+}, z.core.$strict>], "type">;
+/**
+ * Type alias inferred from discriminated union schema
+ *
+ * **Schema-First Law**: Type automatically derives from Zod schema,
+ * providing both compile-time and runtime type safety.
+ */
+export type ExportInfo = z.infer<typeof ExportInfoSchema>;
+/**
+ * Runtime type guard for ExportInfo
+ *
+ * @param value - Value to check
+ * @returns True if value conforms to ExportInfo schema
+ *
+ * @example
+ * ```typescript
+ * if (isExportInfo(parsed)) {
+ *   console.log(parsed.name); // Type-safe access
+ * }
+ * ```
+ */
+export declare function isExportInfo(value: unknown): value is ExportInfo;
+//# sourceMappingURL=export-info.d.ts.map

package/dist/validation-schemas/export-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-info.d.ts","sourceRoot":"","sources":["../../src/validation-schemas/export-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA2ExB;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;4BAO3B,CAAC;AAEH;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE"}