@libar-dev/architect 1.0.0-pre.3

package/dist/taxonomy/status-values.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @architect
+ * @architect-pattern StatusValues
+ * @architect-status completed
+ * @architect-core
+ * @architect-extract-shapes PROCESS_STATUS_VALUES, ProcessStatusValue, ACCEPTED_STATUS_VALUES, AcceptedStatusValue, DEFAULT_STATUS, VALID_PROCESS_STATUS_SET
+ *
+ * ## Process Workflow Status Values
+ *
+ * THE single source of truth for FSM state values in the monorepo (per PDR-005 FSM).
+ *
+ * FSM transitions (canonical source: src/validation/fsm/transitions.ts):
+ * - roadmap to active (start work)
+ * - roadmap to deferred (postpone)
+ * - deferred to roadmap (resume planning)
+ * - active to completed (finish work)
+ * - active to roadmap (blocked/regressed)
+ *
+ * **When to Use:** When validating or referencing FSM state values — import these constants instead of hardcoding status strings.
+ */
+export declare const PROCESS_STATUS_VALUES: readonly ["roadmap", "active", "completed", "deferred"];
+/**
+ * Status values accepted for extraction and validation
+ *
+ * FSM states that can be used in annotations.
+ * Use only these canonical values: roadmap, active, completed, deferred.
+ */
+export declare const ACCEPTED_STATUS_VALUES: readonly ["roadmap", "active", "completed", "deferred"];
+export type AcceptedStatusValue = (typeof ACCEPTED_STATUS_VALUES)[number];
+export type ProcessStatusValue = (typeof PROCESS_STATUS_VALUES)[number];
+/**
+ * Default status for new items
+ */
+export declare const DEFAULT_STATUS: ProcessStatusValue;
+/**
+ * Pre-built set of valid process statuses for O(1) membership checks.
+ */
+export declare const VALID_PROCESS_STATUS_SET: ReadonlySet<string>;
+//# sourceMappingURL=status-values.d.ts.map

package/dist/taxonomy/status-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-values.d.ts","sourceRoot":"","sources":["../../src/taxonomy/status-values.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,qBAAqB,yDAKxB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,yDAAsC,CAAC;AAE1E,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,kBAA8B,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAAC,MAAM,CAA0C,CAAC"}

package/dist/taxonomy/status-values.js

@@ -0,0 +1,42 @@
+/**
+ * @architect
+ * @architect-pattern StatusValues
+ * @architect-status completed
+ * @architect-core
+ * @architect-extract-shapes PROCESS_STATUS_VALUES, ProcessStatusValue, ACCEPTED_STATUS_VALUES, AcceptedStatusValue, DEFAULT_STATUS, VALID_PROCESS_STATUS_SET
+ *
+ * ## Process Workflow Status Values
+ *
+ * THE single source of truth for FSM state values in the monorepo (per PDR-005 FSM).
+ *
+ * FSM transitions (canonical source: src/validation/fsm/transitions.ts):
+ * - roadmap to active (start work)
+ * - roadmap to deferred (postpone)
+ * - deferred to roadmap (resume planning)
+ * - active to completed (finish work)
+ * - active to roadmap (blocked/regressed)
+ *
+ * **When to Use:** When validating or referencing FSM state values — import these constants instead of hardcoding status strings.
+ */
+export const PROCESS_STATUS_VALUES = [
+    'roadmap', // Planned work, fully editable
+    'active', // In progress, scope-locked
+    'completed', // Done, hard-locked
+    'deferred', // On hold, fully editable
+];
+/**
+ * Status values accepted for extraction and validation
+ *
+ * FSM states that can be used in annotations.
+ * Use only these canonical values: roadmap, active, completed, deferred.
+ */
+export const ACCEPTED_STATUS_VALUES = [...PROCESS_STATUS_VALUES];
+/**
+ * Default status for new items
+ */
+export const DEFAULT_STATUS = 'roadmap';
+/**
+ * Pre-built set of valid process statuses for O(1) membership checks.
+ */
+export const VALID_PROCESS_STATUS_SET = new Set(PROCESS_STATUS_VALUES);
+//# sourceMappingURL=status-values.js.map

package/dist/taxonomy/status-values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-values.js","sourceRoot":"","sources":["../../src/taxonomy/status-values.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,SAAS,EAAE,+BAA+B;IAC1C,QAAQ,EAAE,4BAA4B;IACtC,WAAW,EAAE,oBAAoB;IACjC,UAAU,EAAE,0BAA0B;CAC9B,CAAC;AAEX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,GAAG,qBAAqB,CAAU,CAAC;AAM1E;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAuB,SAAS,CAAC;AAE5D;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAwB,IAAI,GAAG,CAAS,qBAAqB,CAAC,CAAC"}

package/dist/types/branded.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Branded type helper
+ * Creates nominal types for better compile-time safety
+ *
+ * @architect-shape
+ * @architect-include core-types
+ */
+type Branded<T, Brand extends string> = T & {
+    readonly __brand: Brand;
+};
+/**
+ * Unique identifier for a documentation pattern
+ * Format: pattern-{8-char-hex}
+ */
+export type PatternId = Branded<string, 'PatternId'>;
+/**
+ * Convert string to PatternId
+ * @param id - String identifier to brand
+ * @returns Branded PatternId
+ */
+export declare function asPatternId(id: string): PatternId;
+/**
+ * Unique identifier for a documentation module
+ * Currently same as PatternId (one module per pattern)
+ */
+export type ModuleId = PatternId;
+/**
+ * Convert string to ModuleId
+ * @param id - String identifier to brand
+ * @returns Branded ModuleId
+ */
+export declare function asModuleId(id: string): ModuleId;
+/**
+ * Category name for organizing patterns
+ * Examples: core, domain, arch, infra, validation
+ */
+export type CategoryName = Branded<string, 'CategoryName'>;
+/**
+ * Convert string to CategoryName
+ * @param name - Category name to brand
+ * @returns Branded CategoryName
+ */
+export declare function asCategoryName(name: string): CategoryName;
+/**
+ * Source file path relative to base directory
+ * Examples: src/types/index.ts, packages/core/src/index.ts
+ */
+export type SourceFilePath = Branded<string, 'SourceFilePath'>;
+/**
+ * Convert string to SourceFilePath
+ * @param path - File path to brand
+ * @returns Branded SourceFilePath
+ */
+export declare function asSourceFilePath(path: string): SourceFilePath;
+/**
+ * Output file path for generated documentation
+ * Examples: docs/core/pattern-name.md
+ */
+export type OutputFilePath = Branded<string, 'OutputFilePath'>;
+/**
+ * Convert string to OutputFilePath
+ * @param path - Output path to brand
+ * @returns Branded OutputFilePath
+ */
+export declare function asOutputFilePath(path: string): OutputFilePath;
+/**
+ * Registry file path
+ * Examples: registry.json, docs/registry.json
+ */
+export type RegistryFilePath = Branded<string, 'RegistryFilePath'>;
+/**
+ * Convert string to RegistryFilePath
+ * @param path - Registry path to brand
+ * @returns Branded RegistryFilePath
+ */
+export declare function asRegistryFilePath(path: string): RegistryFilePath;
+/**
+ * Directive tag name
+ * Format: @architect-{category} or @architect-{category}-{subcategory}
+ */
+export type DirectiveTag = Branded<string, 'DirectiveTag'>;
+/**
+ * Convert string to DirectiveTag
+ * @param tag - Tag string to brand
+ * @returns Branded DirectiveTag
+ */
+export declare function asDirectiveTag(tag: string): DirectiveTag;
+export {};
+//# sourceMappingURL=branded.d.ts.map

package/dist/types/branded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branded.d.ts","sourceRoot":"","sources":["../../src/types/branded.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,KAAK,OAAO,CAAC,CAAC,EAAE,KAAK,SAAS,MAAM,IAAI,CAAC,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAA;CAAE,CAAC;AAExE;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAEjD;AAED;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,SAAS,CAAC;AAEjC;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,CAE/C;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAE3D;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAEzD;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAE/D;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAE7D;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAE/D;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAE7D;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAEnE;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAEjE;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAE3D;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAExD"}

package/dist/types/branded.js

@@ -0,0 +1,57 @@
+/**
+ * Convert string to PatternId
+ * @param id - String identifier to brand
+ * @returns Branded PatternId
+ */
+export function asPatternId(id) {
+    return id;
+}
+/**
+ * Convert string to ModuleId
+ * @param id - String identifier to brand
+ * @returns Branded ModuleId
+ */
+export function asModuleId(id) {
+    return id;
+}
+/**
+ * Convert string to CategoryName
+ * @param name - Category name to brand
+ * @returns Branded CategoryName
+ */
+export function asCategoryName(name) {
+    return name;
+}
+/**
+ * Convert string to SourceFilePath
+ * @param path - File path to brand
+ * @returns Branded SourceFilePath
+ */
+export function asSourceFilePath(path) {
+    return path;
+}
+/**
+ * Convert string to OutputFilePath
+ * @param path - Output path to brand
+ * @returns Branded OutputFilePath
+ */
+export function asOutputFilePath(path) {
+    return path;
+}
+/**
+ * Convert string to RegistryFilePath
+ * @param path - Registry path to brand
+ * @returns Branded RegistryFilePath
+ */
+export function asRegistryFilePath(path) {
+    return path;
+}
+/**
+ * Convert string to DirectiveTag
+ * @param tag - Tag string to brand
+ * @returns Branded DirectiveTag
+ */
+export function asDirectiveTag(tag) {
+    return tag;
+}
+//# sourceMappingURL=branded.js.map

package/dist/types/branded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branded.js","sourceRoot":"","sources":["../../src/types/branded.ts"],"names":[],"mappings":"AAeA;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,OAAO,EAAe,CAAC;AACzB,CAAC;AAQD;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,OAAO,EAAc,CAAC;AACxB,CAAC;AAQD;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAoB,CAAC;AAC9B,CAAC;AAQD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,IAAsB,CAAC;AAChC,CAAC;AAQD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,IAAsB,CAAC;AAChC,CAAC;AAQD;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,IAAwB,CAAC;AAClC,CAAC;AAQD;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO,GAAmB,CAAC;AAC7B,CAAC"}

package/dist/types/errors.d.ts

@@ -0,0 +1,342 @@
+/**
+ * @architect
+ * @architect-core
+ * @architect-pattern ErrorFactoryTypes
+ * @architect-status completed
+ * @architect-implements ErrorFactories
+ * @architect-product-area CoreTypes
+ *
+ * ## Error Factories - Type Definitions
+ *
+ * Structured, discriminated error types with factory functions.
+ * Each error type has a unique `type` discriminator for exhaustive pattern matching.
+ *
+ * **When to Use:** When creating or handling domain-specific errors — use these factory types instead of plain Error for exhaustive matching.
+ */
+import type { SourceFilePath } from './branded.js';
+/**
+ * Base error interface for all documentation errors
+ *
+ * @architect-shape
+ * @architect-include core-types
+ */
+export interface BaseDocError {
+    /** Error type discriminator for pattern matching */
+    readonly type: string;
+    /** Human-readable error message */
+    readonly message: string;
+}
+/**
+ * File system error - file not found, permission denied, etc.
+ */
+export interface FileSystemError extends BaseDocError {
+    readonly type: 'FILE_SYSTEM_ERROR';
+    readonly file: string;
+    readonly reason: 'NOT_FOUND' | 'NO_PERMISSION' | 'NOT_A_FILE' | 'OTHER';
+    readonly originalError?: unknown;
+}
+/**
+ * File parsing error - invalid TypeScript, malformed syntax
+ */
+export interface FileParseError extends BaseDocError {
+    readonly type: 'FILE_PARSE_ERROR';
+    readonly file: string;
+    readonly reason: string;
+    readonly line?: number;
+    readonly column?: number;
+    readonly originalError?: unknown;
+}
+/**
+ * Directive validation error - invalid @architect-* format
+ */
+export interface DirectiveValidationError extends BaseDocError {
+    readonly type: 'DIRECTIVE_VALIDATION_ERROR';
+    readonly file: string;
+    readonly line: number;
+    readonly reason: string;
+    readonly directive?: string;
+}
+/**
+ * Pattern validation error - pattern doesn't conform to schema
+ */
+export interface PatternValidationError extends BaseDocError {
+    readonly type: 'PATTERN_VALIDATION_ERROR';
+    readonly file: SourceFilePath;
+    readonly patternName: string;
+    readonly reason: string;
+    readonly validationErrors?: string[];
+}
+/**
+ * Registry validation error - invalid registry format or data
+ */
+export interface RegistryValidationError extends BaseDocError {
+    readonly type: 'REGISTRY_VALIDATION_ERROR';
+    readonly registryPath: string;
+    readonly reason: string;
+    readonly validationErrors?: string[];
+}
+/**
+ * Markdown generation error - failed to generate output
+ */
+export interface MarkdownGenerationError extends BaseDocError {
+    readonly type: 'MARKDOWN_GENERATION_ERROR';
+    readonly patternId: string;
+    readonly reason: string;
+    readonly originalError?: unknown;
+}
+/**
+ * File write error - failed to write markdown or registry
+ */
+export interface FileWriteError extends BaseDocError {
+    readonly type: 'FILE_WRITE_ERROR';
+    readonly file: string;
+    readonly reason: string;
+    readonly originalError?: unknown;
+}
+/**
+ * Feature file parse error - failed to parse .feature file
+ */
+export interface FeatureParseError extends BaseDocError {
+    readonly type: 'FEATURE_PARSE_ERROR';
+    readonly file: string;
+    readonly reason: string;
+    readonly originalError?: unknown;
+}
+/**
+ * Configuration error - invalid scanner or generator config
+ */
+export interface ConfigError extends BaseDocError {
+    readonly type: 'CONFIG_ERROR';
+    readonly field: string;
+    readonly reason: string;
+    readonly value?: unknown;
+}
+/**
+ * Process metadata validation error - invalid @architect-* tag values
+ *
+ * Raised when extracting process metadata from Gherkin feature tags
+ * and the values don't conform to ProcessMetadataSchema.
+ */
+export interface ProcessMetadataValidationError extends BaseDocError {
+    readonly type: 'PROCESS_METADATA_VALIDATION_ERROR';
+    readonly file: string;
+    readonly reason: string;
+    readonly validationErrors?: readonly string[];
+}
+/**
+ * Deliverable validation error - invalid deliverable table data
+ *
+ * Raised when extracting deliverables from Gherkin Background tables
+ * and the data doesn't conform to DeliverableSchema.
+ */
+export interface DeliverableValidationError extends BaseDocError {
+    readonly type: 'DELIVERABLE_VALIDATION_ERROR';
+    readonly file: string;
+    readonly deliverableName?: string;
+    readonly reason: string;
+    readonly validationErrors?: readonly string[];
+}
+/**
+ * Gherkin pattern extraction error - pattern failed schema validation
+ *
+ * Raised when building ExtractedPattern from Gherkin features and
+ * the result doesn't conform to ExtractedPatternSchema.
+ */
+export interface GherkinPatternValidationError extends BaseDocError {
+    readonly type: 'GHERKIN_PATTERN_VALIDATION_ERROR';
+    readonly file: string;
+    readonly patternName: string;
+    readonly reason: string;
+    readonly validationErrors?: readonly string[];
+}
+/**
+ * Discriminated union of all possible errors
+ *
+ * **Benefits**:
+ * - Exhaustive pattern matching in switch statements
+ * - Type narrowing based on `type` field
+ * - Compile-time verification of error handling
+ *
+ * @architect-shape
+ * @architect-include core-types
+ */
+export type DocError = FileSystemError | FileParseError | DirectiveValidationError | PatternValidationError | RegistryValidationError | MarkdownGenerationError | FileWriteError | FeatureParseError | ConfigError | ProcessMetadataValidationError | DeliverableValidationError | GherkinPatternValidationError;
+/**
+ * Specialized error types for different operations
+ */
+/** Errors that can occur during scanning */
+export type ScanError = FileSystemError | FileParseError | DirectiveValidationError;
+/** Errors that can occur during extraction */
+export type ExtractionError = PatternValidationError | DirectiveValidationError | ProcessMetadataValidationError | DeliverableValidationError | GherkinPatternValidationError;
+/** Errors that can occur during generation */
+export type GenerationError = MarkdownGenerationError | FileWriteError | RegistryValidationError;
+/**
+ * Error with collected failures from batch operations
+ *
+ * Used when processing multiple files or patterns where some succeed
+ * and others fail. Preserves all failure information for reporting.
+ */
+export interface BatchError<E extends DocError> extends BaseDocError {
+    readonly type: 'BATCH_ERROR';
+    readonly errors: readonly E[];
+    readonly successCount: number;
+    readonly failureCount: number;
+}
+/**
+ * Create a FileSystemError
+ *
+ * @param file - File path that caused the error
+ * @param reason - Specific reason for the failure
+ * @param originalError - Optional underlying error
+ * @returns Structured FileSystemError
+ *
+ * @example
+ * ```typescript
+ * const error = createFileSystemError(
+ *   '/path/to/file.ts',
+ *   'NOT_FOUND',
+ *   new Error('ENOENT')
+ * );
+ * ```
+ */
+export declare function createFileSystemError(file: string, reason: FileSystemError['reason'], originalError?: unknown): FileSystemError;
+/**
+ * Create a FileParseError
+ *
+ * @param file - File path that failed to parse
+ * @param reason - Description of parsing failure
+ * @param location - Optional line/column information
+ * @param originalError - Optional underlying error
+ * @returns Structured FileParseError
+ *
+ * @example
+ * ```typescript
+ * const error = createFileParseError(
+ *   '/path/to/file.ts',
+ *   'Unexpected token',
+ *   { line: 42, column: 10 },
+ *   originalError
+ * );
+ * ```
+ */
+export declare function createFileParseError(file: string, reason: string, location?: {
+    line: number;
+    column: number;
+}, originalError?: unknown): FileParseError;
+/**
+ * Create a DirectiveValidationError
+ *
+ * @param file - Source file containing invalid directive
+ * @param line - Line number where directive was found
+ * @param reason - Why validation failed
+ * @param directive - Optional directive text snippet
+ * @returns Structured DirectiveValidationError
+ *
+ * @example
+ * ```typescript
+ * const error = createDirectiveValidationError(
+ *   'src/utils.ts',
+ *   42,
+ *   'Missing required tags',
+ *   '@architect-'
+ * );
+ * ```
+ */
+export declare function createDirectiveValidationError(file: string, line: number, reason: string, directive?: string): DirectiveValidationError;
+/**
+ * Create a PatternValidationError
+ *
+ * @param file - Source file containing invalid pattern
+ * @param patternName - Name of the invalid pattern
+ * @param reason - Why validation failed
+ * @param validationErrors - Specific validation errors from schema
+ * @returns Structured PatternValidationError
+ *
+ * @example
+ * ```typescript
+ * const error = createPatternValidationError(
+ *   asSourceFilePath('src/types.ts'),
+ *   'User Schema',
+ *   'Invalid pattern structure',
+ *   ['tags: Required', 'description: Must be non-empty']
+ * );
+ * ```
+ */
+export declare function createPatternValidationError(file: SourceFilePath, patternName: string, reason: string, validationErrors?: string[]): PatternValidationError;
+/**
+ * Create a FeatureParseError
+ *
+ * @param file - Feature file path that failed to parse
+ * @param reason - Description of parsing failure
+ * @param originalError - Optional underlying error
+ * @returns Structured FeatureParseError
+ *
+ * @example
+ * ```typescript
+ * const error = createFeatureParseError(
+ *   '/path/to/test.feature',
+ *   'Invalid Gherkin syntax',
+ *   originalError
+ * );
+ * ```
+ */
+export declare function createFeatureParseError(file: string, reason: string, originalError?: unknown): FeatureParseError;
+/**
+ * Create a ProcessMetadataValidationError
+ *
+ * @param file - Feature file path containing invalid process metadata
+ * @param reason - Description of validation failure
+ * @param validationErrors - Specific Zod validation errors
+ * @returns Structured ProcessMetadataValidationError
+ *
+ * @example
+ * ```typescript
+ * const error = createProcessMetadataValidationError(
+ *   '/path/to/test.feature',
+ *   'Schema validation failed',
+ *   ['status: Invalid enum value', 'phase: Expected number']
+ * );
+ * ```
+ */
+export declare function createProcessMetadataValidationError(file: string, reason: string, validationErrors?: readonly string[]): ProcessMetadataValidationError;
+/**
+ * Create a DeliverableValidationError
+ *
+ * @param file - Feature file path containing invalid deliverable
+ * @param reason - Description of validation failure
+ * @param deliverableName - Optional name of the invalid deliverable
+ * @param validationErrors - Specific Zod validation errors
+ * @returns Structured DeliverableValidationError
+ *
+ * @example
+ * ```typescript
+ * const error = createDeliverableValidationError(
+ *   '/path/to/test.feature',
+ *   'Invalid deliverable data',
+ *   'MyDeliverable',
+ *   ['name: Required', 'tests: Expected number']
+ * );
+ * ```
+ */
+export declare function createDeliverableValidationError(file: string, reason: string, deliverableName?: string, validationErrors?: readonly string[]): DeliverableValidationError;
+/**
+ * Create a GherkinPatternValidationError
+ *
+ * @param file - Feature file path containing invalid pattern
+ * @param patternName - Name of the pattern that failed validation
+ * @param reason - Description of validation failure
+ * @param validationErrors - Specific Zod validation errors
+ * @returns Structured GherkinPatternValidationError
+ *
+ * @example
+ * ```typescript
+ * const error = createGherkinPatternValidationError(
+ *   '/path/to/test.feature',
+ *   'MyPattern',
+ *   'Pattern schema validation failed',
+ *   ['id: Required', 'category: Invalid enum']
+ * );
+ * ```
+ */
+export declare function createGherkinPatternValidationError(file: string, patternName: string, reason: string, validationErrors?: readonly string[]): GherkinPatternValidationError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"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"}