@libar-dev/architect 1.0.0-pre.3

package/dist/extractor/doc-extractor.js

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

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

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

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