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

package/dist/extractor/doc-extractor.js

@@ -1,481 +0,0 @@
-/**
- * @architect
- * @architect-core @architect-extractor
- * @architect-pattern Document Extractor
- * @architect-status completed
- * @architect-arch-role service
- * @architect-arch-context extractor
- * @architect-arch-layer application
- * @architect-include pipeline-stages
- * @architect-uses Pattern Scanner, Tag Registry, Zod
- * @architect-used-by Orchestrator, Generators
- * @architect-usecase "When converting scanned files to ExtractedPattern objects"
- * @architect-usecase "When inferring pattern names and categories from exports"
- *
- * ## Document Extractor - Pattern Extraction and Metadata Generation
- *
- * Converts scanned file data into complete ExtractedPattern objects with
- * unique IDs, inferred names, categories, and timestamps. Second stage of
- * the pipeline: Scanner → **Extractor** → Generator.
- *
- * ### When to Use
- *
- * - Transforming directives to structured patterns
- * - Inferring metadata from tags and exports
- * - Validating pattern structure against schemas
- *
- * ### Key Concepts
- *
- * - **Category Inference**: Uses tag registry priorities to determine primary category
- * - **Name Inference**: Extracts from exports or JSDoc title when not explicit
- * - **Deterministic IDs**: MD5 hash of file path + line number ensures stable identifiers
- */
-import * as fs from 'fs';
-import * as path from 'path';
-import { processExtractShapesTag, discoverTaggedShapes } from './shape-extractor.js';
-import { Result } from '../types/index.js';
-import { asPatternId, asCategoryName, asSourceFilePath, createPatternValidationError, } from '../types/index.js';
-import { ExtractedPatternSchema, createDefaultTagRegistry, } from '../validation-schemas/index.js';
-import { generatePatternId } from '../utils/index.js';
-/**
- * Convert scanned files to extracted patterns
- *
- * **Result Pattern**: Collects both successful extractions AND validation errors,
- * enabling partial success scenarios.
- *
- * @param scannedFiles - Files scanned for directives
- * @param baseDir - Base directory for relative path calculation
- * @param registry - Tag registry for category inference and aggregation tags (optional, defaults to generic registry)
- * @returns Extraction results with patterns and errors
- *
- * @example
- * ```typescript
- * import { scanPatterns } from '@libar-dev/code-first-docs/scanner';
- * import { extractPatterns } from '@libar-dev/code-first-docs/extractor';
- *
- * const scanResult = await scanPatterns(config);
- * if (scanResult.ok) {
- *   const extraction = extractPatterns(scanResult.value.files, '/path/to/project');
- *   console.log(`Extracted ${extraction.patterns.length} patterns`);
- *   console.log(`Failed ${extraction.errors.length} validations`);
- * }
- * ```
- */
-export function extractPatterns(scannedFiles, baseDir, registry) {
-    const patterns = [];
-    const errors = [];
-    const effectiveRegistry = registry ?? createDefaultTagRegistry();
-    for (const scannedFile of scannedFiles) {
-        for (const item of scannedFile.directives) {
-            const result = buildPattern(item.directive, item.code, item.exports, scannedFile.filePath, baseDir, effectiveRegistry);
-            if (Result.isOk(result)) {
-                patterns.push(result.value);
-            }
-            else {
-                errors.push(result.error);
-            }
-        }
-    }
-    return { patterns, errors };
-}
-/**
- * Build a complete ExtractedPattern from components
- *
- * **Schema-First Enforcement**: Validates constructed pattern against schema
- * to ensure data integrity at the boundary.
- *
- * @param directive - Parsed JSDoc directive
- * @param code - Extracted code snippet
- * @param exports - Exported symbols from code block
- * @param filePath - Absolute file path
- * @param baseDir - Base directory for relative path calculation
- * @param registry - Tag registry for category inference
- * @returns Result containing validated pattern or validation error
- *
- * @example
- * ```typescript
- * const result = buildPattern(
- *   directive,
- *   codeSnippet,
- *   exports,
- *   '/project/src/utils.ts',
- *   '/project',
- *   tagRegistry
- * );
- *
- * if (result.ok) {
- *   console.log(result.value.id);        // 'pattern-a1b2c3d4'
- *   console.log(result.value.source.file); // 'src/utils.ts'
- * }
- * ```
- */
-export function buildPattern(directive, code, exports, filePath, baseDir, registry) {
-    const relativePath = path.relative(baseDir, filePath);
-    const id = asPatternId(generatePatternId(relativePath, directive.position.startLine));
-    const name = inferPatternName(directive, exports, registry);
-    const category = asCategoryName(inferCategory(directive.tags, registry));
-    // Shape extraction: both @architect-extract-shapes (pattern-level) and
-    // @architect-shape (declaration-level) contribute to extractedShapes.
-    // Read file once for both paths.
-    let extractedShapes;
-    const extractionWarnings = [];
-    // Only TypeScript files can have shapes
-    if (filePath.endsWith('.ts') || filePath.endsWith('.tsx')) {
-        const jsx = filePath.endsWith('.tsx');
-        let sourceContent;
-        try {
-            sourceContent = fs.readFileSync(filePath, 'utf-8');
-        }
-        catch (error) {
-            extractionWarnings.push(`[shape-extraction] Failed to read file: ${filePath} - ${error instanceof Error ? error.message : String(error)}`);
-        }
-        // Path 1: Existing @architect-extract-shapes tag processing
-        if (sourceContent !== undefined &&
-            directive.extractShapes !== undefined &&
-            directive.extractShapes.length > 0) {
-            const shapeResult = processExtractShapesTag(sourceContent, directive.extractShapes.join(', '), { jsx });
-            extractedShapes = shapeResult.shapes;
-            extractionWarnings.push(...shapeResult.warnings);
-        }
-        // Path 2: Declaration-level @architect-shape discovery
-        // Performance note: when both paths fire, sourceCode is parsed by typescript-estree
-        // twice (once in processExtractShapesTag, once in discoverTaggedShapes). Acceptable
-        // for v1 — future optimization could accept a pre-parsed AST.
-        if (sourceContent?.includes('architect-shape') === true) {
-            const taggedResult = discoverTaggedShapes(sourceContent, { jsx });
-            if (taggedResult.ok && taggedResult.value.shapes.length > 0) {
-                const existingByName = new Map((extractedShapes ?? []).map((s) => [s.name, s]));
-                const newShapes = taggedResult.value.shapes.filter((s) => !existingByName.has(s.name));
-                // Merge group and includes from tagged shapes onto existing Path 1 shapes
-                for (const tagged of taggedResult.value.shapes) {
-                    const existing = existingByName.get(tagged.name);
-                    if (existing !== undefined) {
-                        if (tagged.group !== undefined) {
-                            existing.group = tagged.group;
-                        }
-                        if (tagged.includes !== undefined) {
-                            existing.includes = tagged.includes;
-                        }
-                    }
-                }
-                extractedShapes = [...(extractedShapes ?? []), ...newShapes];
-                extractionWarnings.push(...taggedResult.value.warnings);
-            }
-            else if (!taggedResult.ok) {
-                extractionWarnings.push(`[shape-discovery] ${taggedResult.error.message}`);
-            }
-        }
-    }
-    else if (directive.extractShapes !== undefined && directive.extractShapes.length > 0) {
-        // Non-TS file with extract-shapes tag — non-TS extraction path
-        try {
-            const sourceContent = fs.readFileSync(filePath, 'utf-8');
-            const shapeResult = processExtractShapesTag(sourceContent, directive.extractShapes.join(', '));
-            extractedShapes = shapeResult.shapes;
-            extractionWarnings.push(...shapeResult.warnings);
-        }
-        catch (error) {
-            extractionWarnings.push(`[shape-extraction] Failed to read file: ${filePath} - ${error instanceof Error ? error.message : String(error)}`);
-        }
-    }
-    // Note: extractionWarnings are collected but currently not surfaced
-    // Future enhancement: add warnings field to ExtractedPattern schema
-    // Build pattern object
-    const pattern = {
-        id,
-        name,
-        category,
-        directive,
-        code,
-        source: {
-            file: asSourceFilePath(relativePath),
-            lines: [directive.position.startLine, directive.position.endLine],
-        },
-        exports: [...exports],
-        extractedAt: new Date().toISOString(),
-        // Include optional fields only if present in directive
-        ...(directive.patternName !== undefined && { patternName: directive.patternName }),
-        ...(directive.status !== undefined && { status: directive.status }),
-        ...(directive.isCore === true && { isCore: directive.isCore }),
-        ...(directive.useCases !== undefined &&
-            directive.useCases.length > 0 && { useCases: directive.useCases }),
-        ...(directive.whenToUse !== undefined && { whenToUse: directive.whenToUse }),
-        ...(directive.uses !== undefined && directive.uses.length > 0 && { uses: directive.uses }),
-        ...(directive.usedBy !== undefined &&
-            directive.usedBy.length > 0 && { usedBy: directive.usedBy }),
-        // Roadmap integration fields
-        ...(directive.phase !== undefined && { phase: directive.phase }),
-        ...(directive.brief !== undefined && { brief: directive.brief }),
-        ...(directive.dependsOn !== undefined &&
-            directive.dependsOn.length > 0 && { dependsOn: directive.dependsOn }),
-        ...(directive.enables !== undefined &&
-            directive.enables.length > 0 && { enables: directive.enables }),
-        // UML-inspired relationship fields (PatternRelationshipModel)
-        ...(directive.implements !== undefined &&
-            directive.implements.length > 0 && { implementsPatterns: directive.implements }),
-        ...(directive.extends !== undefined && { extendsPattern: directive.extends }),
-        // Cross-reference and API navigation fields (PatternRelationshipModel enhancement)
-        ...(directive.seeAlso !== undefined &&
-            directive.seeAlso.length > 0 && { seeAlso: directive.seeAlso }),
-        ...(directive.apiRef !== undefined &&
-            directive.apiRef.length > 0 && { apiRef: directive.apiRef }),
-        // Design session stub metadata fields
-        ...(directive.target !== undefined && { targetPath: directive.target }),
-        ...(directive.since !== undefined && { since: directive.since }),
-        // Architecture diagram generation fields
-        ...(directive.archRole !== undefined && { archRole: directive.archRole }),
-        ...(directive.archContext !== undefined && { archContext: directive.archContext }),
-        ...(directive.archLayer !== undefined && { archLayer: directive.archLayer }),
-        ...(directive.include !== undefined &&
-            directive.include.length > 0 && { include: directive.include }),
-        ...(directive.claudeModule !== undefined && { claudeModule: directive.claudeModule }),
-        ...(directive.claudeSection !== undefined && { claudeSection: directive.claudeSection }),
-        ...(directive.claudeTags !== undefined &&
-            directive.claudeTags.length > 0 && { claudeTags: directive.claudeTags }),
-        // PRD metadata fields
-        ...(directive.productArea !== undefined && { productArea: directive.productArea }),
-        // Shape extraction fields (extracted from source file when @architect-extract-shapes present)
-        ...(extractedShapes && extractedShapes.length > 0 && { extractedShapes }),
-        // Convention tags for reference document generation
-        ...(directive.convention !== undefined &&
-            directive.convention.length > 0 && { convention: directive.convention }),
-    };
-    // Validate against schema (schema-first enforcement)
-    const validation = ExtractedPatternSchema.safeParse(pattern);
-    if (!validation.success) {
-        const errorMessages = validation.error.issues.map((issue) => `${issue.path.join('.')}: ${issue.message}`);
-        const error = createPatternValidationError(asSourceFilePath(relativePath), name, 'Pattern validation failed', errorMessages);
-        return Result.err(error);
-    }
-    return Result.ok(validation.data);
-}
-/**
- * Infer pattern name from directive or exports
- *
- * Uses fallback chain:
- * 1. Explicit pattern tag value (highest priority)
- * 2. First line of description (if not a tag)
- * 3. First export name
- * 4. Generated from primary tag
- *
- * @param directive - Parsed JSDoc directive
- * @param exports - Exported symbols from code block
- * @param registry - Tag registry for prefix-aware tag stripping
- * @returns Inferred pattern name
- *
- * @example
- * ```typescript
- * // From explicit pattern tag (highest priority)
- * const name0 = inferPatternName(
- *   { patternName: 'Decider Pattern', description: 'Some description', tags: [...] },
- *   [],
- *   registry
- * );
- * console.log(name0); // 'Decider Pattern'
- *
- * // From description
- * const name1 = inferPatternName(
- *   { description: 'User Authentication\n...', tags: [...] },
- *   [],
- *   registry
- * );
- * console.log(name1); // 'User Authentication'
- *
- * // From export
- * const name2 = inferPatternName(
- *   { description: '@architect-core', tags: [...] },
- *   [{ name: 'createUser', type: 'function' }],
- *   registry
- * );
- * console.log(name2); // 'createUser'
- *
- * // From tag
- * const name3 = inferPatternName(
- *   { description: '', tags: ['@architect-domain-auth'] },
- *   [],
- *   registry
- * );
- * console.log(name3); // 'domain-pattern'
- * ```
- */
-export function inferPatternName(directive, exports, registry) {
-    // Priority 1: Explicit pattern tag value
-    if (directive.patternName) {
-        return directive.patternName;
-    }
-    // Priority 2: Try to extract name from first line of description
-    const lines = directive.description.split('\n');
-    const firstLine = lines[0];
-    if (firstLine?.trim() && !firstLine.trim().startsWith('@')) {
-        // Strip markdown header prefixes (##, ###, etc.)
-        const cleanedName = firstLine.trim().replace(/^#+\s*/, '');
-        if (cleanedName) {
-            return cleanedName;
-        }
-    }
-    // Fall back to first export name
-    const firstExport = exports[0];
-    if (firstExport) {
-        return firstExport.name;
-    }
-    // Last resort: generate from tags using registry prefix
-    const tagPrefix = registry.tagPrefix;
-    const firstTag = directive.tags[0];
-    const primaryTag = firstTag?.replace(tagPrefix, '') ?? 'unknown';
-    return `${primaryTag}-pattern`;
-}
-/**
- * Infer category from @architect-* tags using priority system
- *
- * Categories are selected based on priority order:
- * domain > arch > infra > validation > testing > performance > security > core
- *
- * @param tags - Array of @architect-* tags
- * @returns Inferred category string
- *
- * @example
- * ```typescript
- * // Priority-based selection
- * const cat1 = inferCategory([
- *   '@architect-core',
- *   '@architect-domain-auth'
- * ]);
- * console.log(cat1); // 'domain' (higher priority than 'core')
- *
- * // From first tag
- * const cat2 = inferCategory(['@architect-validation-zod']);
- * console.log(cat2); // 'validation'
- *
- * // No tags
- * const cat3 = inferCategory([]);
- * console.log(cat3); // 'uncategorized'
- * ```
- */
-export function inferCategory(tags, registry) {
-    // Build priority map from registry (includes aliases)
-    // Also track canonical tag for each alias
-    const priorityMap = new Map();
-    const canonicalMap = new Map(); // Maps alias → canonical tag
-    for (const cat of registry.categories) {
-        priorityMap.set(cat.tag, cat.priority);
-        canonicalMap.set(cat.tag, cat.tag); // Canonical tags map to themselves
-        // Include aliases with same priority, mapping to canonical tag
-        for (const alias of cat.aliases) {
-            priorityMap.set(alias, cat.priority);
-            canonicalMap.set(alias, cat.tag); // Alias maps to canonical tag
-        }
-    }
-    // Extract category names from tags (remove prefix)
-    const prefix = registry.tagPrefix;
-    const categoryTags = [];
-    for (const tag of tags) {
-        if (!tag.startsWith(prefix))
-            continue;
-        // Remove prefix to get tag content
-        const withoutPrefix = tag.substring(prefix.length);
-        // Find ALL matching categories in this tag
-        // This handles cases like "@architect-utils-validation" which contains both "utils" and "validation"
-        const matches = [];
-        // Check for exact match first
-        if (priorityMap.has(withoutPrefix)) {
-            matches.push(withoutPrefix);
-        }
-        else {
-            // Check all possible contiguous subsequences for category matches
-            // e.g., for "utils-validation" check: "utils-validation", "utils", "validation"
-            const parts = withoutPrefix.split('-');
-            // Try all contiguous subsequences from longest to shortest
-            for (let len = parts.length; len > 0; len--) {
-                for (let start = 0; start <= parts.length - len; start++) {
-                    const candidate = parts.slice(start, start + len).join('-');
-                    if (priorityMap.has(candidate)) {
-                        matches.push(candidate);
-                    }
-                }
-            }
-        }
-        // Add all matches to categoryTags
-        categoryTags.push(...matches);
-    }
-    // Find tag with highest priority (lowest number)
-    // Use canonical tags (normalize aliases)
-    let selectedCategory = null;
-    let highestPriority = Infinity;
-    for (const categoryTag of categoryTags) {
-        const priority = priorityMap.get(categoryTag);
-        if (priority !== undefined && priority < highestPriority) {
-            highestPriority = priority;
-            // Use canonical tag (normalizes aliases like "infrastructure" → "infra")
-            selectedCategory = canonicalMap.get(categoryTag) ?? categoryTag;
-        }
-    }
-    // If found by priority, return it
-    if (selectedCategory !== null) {
-        return selectedCategory;
-    }
-    // Fallback: Extract category from first tag
-    const firstTag = tags[0];
-    if (firstTag?.startsWith(prefix) === true) {
-        const withoutPrefix = firstTag.substring(prefix.length);
-        const parts = withoutPrefix.split('-');
-        const firstPart = parts[0];
-        if (firstPart) {
-            return firstPart;
-        }
-    }
-    return 'uncategorized';
-}
-/**
- * Check if directive has specific aggregation tag
- *
- * Generic helper for checking any aggregation tag. Replaces individual
- * hasOverviewTag/hasDecisionTag/hasIntroTag helpers with a unified approach.
- *
- * @param tags - Directive tags to check
- * @param aggregationTagName - Name of aggregation tag (e.g., "overview", "decision", "intro")
- * @param registry - Tag registry
- * @returns True if directive has the specified aggregation tag
- *
- * @example
- * ```typescript
- * hasAggregationTag(['@architect-core', '@architect-overview'], "overview", registry); // true
- * hasAggregationTag(['@architect-core'], "overview", registry); // false
- * hasAggregationTag(['@architect-arch', '@architect-decision'], "decision", registry); // true
- * ```
- */
-export function hasAggregationTag(tags, aggregationTagName, registry) {
-    const aggregationTag = registry.aggregationTags.find((t) => t.tag === aggregationTagName);
-    if (!aggregationTag)
-        return false;
-    const fullTag = `${registry.tagPrefix}${aggregationTag.tag}`;
-    return tags.some((t) => t === fullTag);
-}
-/**
- * Extract aggregation tags from pattern tags
- *
- * Identifies which aggregated documents a pattern should appear in.
- * Patterns can appear in multiple documents if they have multiple aggregation tags.
- *
- * @param tags - Array of @architect-* tags
- * @param registry - Tag registry for aggregation tag lookup
- * @returns Object indicating which aggregated docs to include pattern in
- *
- * @example
- * ```typescript
- * // Pattern with both overview and decision tags
- * getAggregationTags(['@architect-overview', '@architect-decision'], registry);
- * // { overview: true, decision: true, intro: false }
- *
- * // Pattern with only core tag (no aggregation)
- * getAggregationTags(['@architect-core'], registry);
- * // { overview: false, decision: false, intro: false }
- * ```
- */
-export function getAggregationTags(tags, registry) {
-    return {
-        overview: hasAggregationTag(tags, 'overview', registry),
-        decision: hasAggregationTag(tags, 'decision', registry),
-        intro: hasAggregationTag(tags, 'intro', registry),
-    };
-}
-//# sourceMappingURL=doc-extractor.js.map

package/dist/extractor/doc-extractor.js.map

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

package/dist/extractor/dual-source-extractor.d.ts

@@ -1,161 +0,0 @@
-/**
- * @architect
- * @architect-extractor
- * @architect-pattern DualSourceExtractor
- * @architect-status completed
- * @architect-uses DocExtractor, GherkinExtractor, GherkinScanner
- * @architect-used-by Orchestrator
- * @architect-arch-role service
- * @architect-arch-context extractor
- * @architect-arch-layer application
- *
- * ## DualSourceExtractor - Compose Pattern Data from Code + Features
- *
- * Extracts pattern metadata from both TypeScript code stubs (@architect-*)
- * and Gherkin feature files (@architect-*), validates consistency,
- * and composes unified pattern data for documentation generation.
- *
- * ### When to Use
- *
- * - When implementing USDP Pattern 2 (Standard) or higher
- * - When you have both code stubs AND timeline features
- * - When generating artifacts that need both timeless and temporal data
- * - When validating cross-source consistency (pattern name, phase alignment)
- *
- * ### Key Concepts
- *
- * - **Code Source**: @architect-* tags define timeless pattern graph
- * - **Feature Source**: @architect-* tags add temporal process metadata
- * - **Cross-Validation**: Pattern name + phase must match across sources
- * - **Deliverables**: Parsed from Gherkin Background tables in features
- */
-import type { ExtractedPattern } from '../types/index.js';
-import { type ScannedGherkinFile, type ProcessMetadata, type Deliverable, type CrossValidationError, type ValidationSummary } from '../validation-schemas/index.js';
-export type { ProcessMetadata, Deliverable, CrossValidationError, ValidationSummary };
-/**
- * Results from dual-source extraction
- *
- * Contains patterns successfully matched across sources, orphaned
- * code/feature patterns, and cross-validation errors.
- */
-export interface DualSourceResults {
-    /** Patterns with both code + process data */
-    readonly patterns: readonly DualSourcePattern[];
-    /** Patterns from code only (no matching feature) */
-    readonly codeOnly: readonly ExtractedPattern[];
-    /** Features without matching code stubs */
-    readonly featureOnly: readonly ProcessMetadata[];
-    /** Cross-validation errors */
-    readonly validationErrors: readonly CrossValidationError[];
-    /** Non-fatal warnings (e.g., pattern name collisions) */
-    readonly warnings: readonly string[];
-}
-/**
- * Combined pattern data from code + features
- *
- * When multiple code files define the same pattern (e.g., ServiceIndependence
- * with ECST and Reservation sub-patterns), they are merged into a single
- * dual-source pattern with the `sources` array containing all variants.
- */
-export interface DualSourcePattern extends ExtractedPattern {
-    /** Process metadata from feature file (optional) */
-    readonly process?: ProcessMetadata;
-    /** Deliverables from feature Background table (optional) */
-    readonly deliverables?: readonly Deliverable[];
-    /**
-     * Multiple source patterns when there's a name collision (optional)
-     * Present when multiple code files use the same @architect-pattern name
-     */
-    readonly sources?: readonly ExtractedPattern[];
-}
-/**
- * Extract process metadata from Gherkin feature tags
- *
- * Uses schema validation instead of type assertions to ensure data integrity.
- * Returns null if required tags are missing OR if validation fails.
- *
- * @param feature - Scanned Gherkin feature
- * @returns Process metadata or null if missing required tags or validation fails
- */
-export declare function extractProcessMetadata(feature: ScannedGherkinFile): ProcessMetadata | null;
-/**
- * Extract deliverables from Gherkin Background table
- *
- * Parses Background section looking for DataTables with a "Deliverable" column.
- * Expected table 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")
- *
- * @param feature - Scanned Gherkin feature with optional background
- * @returns Array of deliverables or empty array if no table found
- *
- * @example
- * ```gherkin
- * Background: Deliverables
- *   Given the following deliverables:
- *     | Deliverable | Status | Tests | Location | Finding | Release |
- *     | Fix parseArgs() call | Done | Yes | src/cli/generate-docs.ts | CODE-001 | v0.2.0 |
- *     | Update README.md | Done | No | README.md | DOC-001 | v0.2.0 |
- * ```
- */
-export declare function extractDeliverables(feature: ScannedGherkinFile): readonly Deliverable[];
-/**
- * Combine patterns from code and features into dual-source patterns
- *
- * Validates that pattern names and phases match across sources.
- * Creates unified pattern objects with both code and process metadata.
- *
- * **Pattern Name Collisions:**
- * When multiple code files use the same `@architect-pattern` name (e.g.,
- * ServiceIndependence with ECST and Reservation sub-patterns), they are
- * automatically merged:
- * - Categories, dependencies, and enables are unioned across all sources
- * - Primary pattern (first in array) provides base metadata
- * - All source patterns are preserved in the `sources` array
- * - Console warning is emitted for visibility
- *
- * @param codePatterns - Patterns extracted from TypeScript code
- * @param featureFiles - Scanned Gherkin feature files
- * @returns Dual-source extraction results
- *
- * @example
- * ```typescript
- * // Extract from both sources
- * const codeScan = await scanPatterns({ patterns: 'packages/**\/*.ts' });
- * const featureScan = await scanGherkinFiles({ patterns: 'tests/features/**\/*.feature' });
- *
- * if (codeScan.ok && featureScan.ok) {
- *   const codeExtraction = extractPatterns(codeScan.value.files, '/project');
- *   const dualSource = combineSources(codeExtraction.patterns, featureScan.value.files);
- *
- *   console.log(`Combined: ${dualSource.patterns.length}`);
- *   console.log(`Code-only: ${dualSource.codeOnly.length}`);
- *   console.log(`Feature-only: ${dualSource.featureOnly.length}`);
- *   console.log(`Validation errors: ${dualSource.validationErrors.length}`);
- *
- *   // Check for collisions
- *   for (const pattern of dualSource.patterns) {
- *     if (pattern.sources) {
- *       console.log(`${pattern.patternName} has ${pattern.sources.length} implementations`);
- *     }
- *   }
- * }
- * ```
- */
-export declare function combineSources(codePatterns: readonly ExtractedPattern[], featureFiles: readonly ScannedGherkinFile[]): DualSourceResults;
-/**
- * Validate dual-source consistency
- *
- * Checks that patterns are properly aligned across sources.
- * Reports code stubs without features and features without code.
- *
- * @param results - Dual-source extraction results
- * @returns Validation summary
- */
-export declare function validateDualSource(results: DualSourceResults): ValidationSummary;
-//# sourceMappingURL=dual-source-extractor.d.ts.map

package/dist/extractor/dual-source-extractor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dual-source-extractor.d.ts","sourceRoot":"","sources":["../../src/extractor/dual-source-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAI1D,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,gCAAgC,CAAC;AAIxC,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,CAAC;AAEtF;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAChD,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC/C,2CAA2C;IAC3C,QAAQ,CAAC,WAAW,EAAE,SAAS,eAAe,EAAE,CAAC;IACjD,8BAA8B;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC3D,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACzD,oDAAoD;IACpD,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;IACnC,4DAA4D;IAC5D,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/C;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAChD;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,kBAAkB,GAAG,eAAe,GAAG,IAAI,CA4E1F;AAmCD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,GAAG,SAAS,WAAW,EAAE,CA8EvF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,cAAc,CAC5B,YAAY,EAAE,SAAS,gBAAgB,EAAE,EACzC,YAAY,EAAE,SAAS,kBAAkB,EAAE,GAC1C,iBAAiB,CAuHnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,CA6BhF"}