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

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

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

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

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

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

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

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

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

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