@libar-dev/architect 1.0.0-pre.3

package/dist/extractor/gherkin-extractor.js

@@ -0,0 +1,543 @@
+/**
+ * @architect
+ * @architect-extractor
+ * @architect-pattern GherkinExtractor
+ * @architect-status completed
+ * @architect-implements GherkinRulesSupport
+ * @architect-uses GherkinTypes, GherkinASTParser
+ * @architect-used-by DualSourceExtractor, Orchestrator
+ * @architect-arch-role service
+ * @architect-arch-context extractor
+ * @architect-arch-layer application
+ *
+ * ## GherkinExtractor - Convert Feature Files to Pattern Documentation
+ *
+ * Transforms scanned Gherkin feature files into ExtractedPattern objects
+ * for inclusion in generated documentation. Maps feature tags, descriptions,
+ * and scenarios to pattern metadata.
+ *
+ * ### When to Use
+ *
+ * - When building multi-source documentation (TypeScript + Gherkin)
+ * - When converting acceptance criteria to pattern documentation
+ * - When defining roadmap patterns in .feature files before implementation
+ *
+ * ### Key Concepts
+ *
+ * - **Feature → Pattern**: Feature name becomes pattern name
+ * - **Tags → Metadata**: @pattern:Name, @phase:N map to pattern fields
+ * - **Scenarios → Use Cases**: Acceptance criteria become "When to Use" examples
+ */
+// TODO: Abstract filesystem operations for future Convex migration.
+// Direct fs/path usage should be moved to injected interface (via GherkinExtractorConfig)
+// or deferred to CLI-layer orchestration. See PR-79 comment #042.
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { ExtractedPatternSchema, } from '../validation-schemas/extracted-pattern.js';
+import { extractPatternTags } from '../scanner/gherkin-ast-parser.js';
+import { asPatternId, asCategoryName, asSourceFilePath, asDirectiveTag } from '../types/branded.js';
+import { inferFeatureLayer } from './layer-inference.js';
+import { extractDeliverables } from './dual-source-extractor.js';
+import { createGherkinPatternValidationError, } from '../types/errors.js';
+import { generatePatternId } from '../utils/index.js';
+import { getPatternName } from '../api/pattern-helpers.js';
+// =============================================================================
+// Constants
+// =============================================================================
+/**
+ * Semantic tags for scenario categorization.
+ *
+ * These tags identify the nature of a scenario (e.g., happy-path, validation)
+ * and are extracted from scenario tags during pattern extraction.
+ */
+export const SEMANTIC_SCENARIO_TAGS = [
+    'happy-path',
+    'validation',
+    'business-failure',
+    'business-rule',
+    'compensation',
+    'idempotency',
+    'expiration',
+    'workflow-state',
+];
+/**
+ * Assign a property to an object only if the value is defined (not undefined/null).
+ *
+ * Performance optimization: Avoids creating intermediate objects from conditional spreads.
+ * Instead of `...(x && { field: x })` which creates a temporary object,
+ * this directly assigns to the target object.
+ *
+ * @internal
+ */
+function assignIfDefined(obj, key, value) {
+    if (value !== undefined && value !== null) {
+        obj[key] = value;
+    }
+}
+/**
+ * Assign a property to an object only if the array is non-empty.
+ *
+ * @internal
+ */
+function assignIfNonEmpty(obj, key, arr) {
+    if (arr && arr.length > 0) {
+        obj[key] = arr;
+    }
+}
+/**
+ * Shared Gherkin raw-pattern builder.
+ *
+ * Keeps the sync and async extraction paths aligned so metadata fields
+ * do not drift when one path is updated independently.
+ */
+function buildGherkinRawPattern(input) {
+    const { relativePath, filePath, patternId, patternName, primaryCategory, feature, metadata, whenToUse, scenarios, rules, deliverables, behaviorFile, behaviorFileVerified, } = input;
+    const rawPattern = {
+        id: patternId,
+        name: patternName,
+        category: asCategoryName(primaryCategory),
+        directive: {
+            tags: feature.tags.map((tag) => asDirectiveTag(`@architect-${tag}`)),
+            description: feature.description,
+            examples: [],
+            position: { startLine: feature.line, endLine: feature.line },
+            status: metadata.status,
+            phase: metadata.phase,
+        },
+        code: '',
+        source: {
+            file: asSourceFilePath(relativePath),
+            lines: [feature.line, feature.line],
+        },
+        exports: [],
+        extractedAt: new Date().toISOString(),
+    };
+    assignIfDefined(rawPattern, 'patternName', metadata.pattern);
+    assignIfDefined(rawPattern, 'status', metadata.status);
+    assignIfDefined(rawPattern, 'phase', metadata.phase);
+    assignIfDefined(rawPattern, 'release', metadata.release);
+    assignIfDefined(rawPattern, 'brief', metadata.brief);
+    assignIfNonEmpty(rawPattern, 'dependsOn', metadata.dependsOn);
+    assignIfNonEmpty(rawPattern, 'enables', metadata.enables);
+    assignIfNonEmpty(rawPattern, 'implementsPatterns', metadata.implementsPatterns);
+    assignIfDefined(rawPattern, 'extendsPattern', metadata.extendsPattern);
+    assignIfDefined(rawPattern, 'targetPath', metadata.target);
+    assignIfDefined(rawPattern, 'since', metadata.since);
+    assignIfDefined(rawPattern, 'quarter', metadata.quarter);
+    assignIfDefined(rawPattern, 'completed', metadata.completed);
+    assignIfDefined(rawPattern, 'effort', metadata.effort);
+    assignIfDefined(rawPattern, 'effortActual', metadata.effortActual);
+    assignIfDefined(rawPattern, 'team', metadata.team);
+    assignIfDefined(rawPattern, 'workflow', metadata.workflow);
+    assignIfDefined(rawPattern, 'risk', metadata.risk);
+    assignIfDefined(rawPattern, 'priority', metadata.priority);
+    assignIfDefined(rawPattern, 'productArea', metadata.productArea);
+    assignIfDefined(rawPattern, 'userRole', metadata.userRole);
+    assignIfDefined(rawPattern, 'businessValue', metadata.businessValue);
+    assignIfDefined(rawPattern, 'level', metadata.level);
+    assignIfDefined(rawPattern, 'parent', metadata.parent);
+    assignIfNonEmpty(rawPattern, 'discoveredGaps', metadata.discoveredGaps);
+    assignIfNonEmpty(rawPattern, 'discoveredImprovements', metadata.discoveredImprovements);
+    assignIfNonEmpty(rawPattern, 'discoveredRisks', metadata.discoveredRisks);
+    assignIfNonEmpty(rawPattern, 'discoveredLearnings', metadata.discoveredLearnings);
+    assignIfNonEmpty(rawPattern, 'constraints', metadata.constraints);
+    assignIfDefined(rawPattern, 'adr', metadata.adr);
+    assignIfDefined(rawPattern, 'adrStatus', metadata.adrStatus);
+    assignIfDefined(rawPattern, 'adrCategory', metadata.adrCategory);
+    assignIfDefined(rawPattern, 'adrSupersedes', metadata.adrSupersedes);
+    assignIfDefined(rawPattern, 'adrSupersededBy', metadata.adrSupersededBy);
+    assignIfDefined(rawPattern, 'adrTheme', metadata.adrTheme);
+    assignIfDefined(rawPattern, 'adrLayer', metadata.adrLayer);
+    assignIfNonEmpty(rawPattern, 'convention', metadata.convention);
+    assignIfNonEmpty(rawPattern, 'include', metadata.include);
+    assignIfDefined(rawPattern, 'claudeModule', metadata.claudeModule);
+    assignIfDefined(rawPattern, 'claudeSection', metadata.claudeSection);
+    assignIfNonEmpty(rawPattern, 'claudeTags', metadata.claudeTags);
+    assignIfDefined(rawPattern, 'sequenceOrchestrator', metadata.sequenceOrchestrator);
+    assignIfNonEmpty(rawPattern, 'whenToUse', whenToUse);
+    assignIfNonEmpty(rawPattern, 'deliverables', deliverables);
+    if (scenarios.length > 0) {
+        rawPattern['scenarios'] = scenarios.map((scenario) => {
+            const scenarioRef = {
+                featureFile: relativePath,
+                featureName: feature.name,
+                featureDescription: feature.description,
+                scenarioName: scenario.name,
+                semanticTags: scenario.tags.filter((tag) => SEMANTIC_SCENARIO_TAGS.includes(tag)),
+                tags: scenario.tags,
+                layer: inferFeatureLayer(filePath),
+                line: scenario.line,
+            };
+            if (scenario.steps.length > 0) {
+                scenarioRef['steps'] = scenario.steps.map((step) => {
+                    const stepObj = { keyword: step.keyword, text: step.text };
+                    assignIfDefined(stepObj, 'dataTable', step.dataTable);
+                    assignIfDefined(stepObj, 'docString', step.docString);
+                    return stepObj;
+                });
+            }
+            return scenarioRef;
+        });
+    }
+    assignIfDefined(rawPattern, 'behaviorFile', behaviorFile);
+    if (behaviorFileVerified !== undefined) {
+        rawPattern['behaviorFileVerified'] = behaviorFileVerified;
+    }
+    if (rules && rules.length > 0) {
+        rawPattern['rules'] = rules.map((rule) => {
+            const errorNames = rule.scenarios
+                .filter((s) => s.tags.some((t) => t === 'sequence-error'))
+                .map((s) => s.name);
+            return {
+                name: rule.name,
+                description: rule.description,
+                scenarioCount: rule.scenarios.length,
+                scenarioNames: rule.scenarios.map((s) => s.name),
+                ...(rule.tags.length > 0 && { tags: rule.tags }),
+                ...(errorNames.length > 0 && { errorScenarioNames: errorNames }),
+            };
+        });
+    }
+    return rawPattern;
+}
+/**
+ * Extract patterns from scanned Gherkin feature files
+ *
+ * Converts feature file metadata into ExtractedPattern objects that can be
+ * merged with TypeScript-sourced patterns for unified documentation generation.
+ *
+ * Returns both successfully extracted patterns and validation errors for
+ * patterns that failed extraction. This enables partial success scenarios.
+ *
+ * @param scannedFiles - Array of scanned Gherkin files
+ * @param config - Extractor configuration (requires baseDir for relative paths)
+ * @returns Object containing extracted patterns and any validation errors
+ *
+ * @example
+ * ```typescript
+ * const scanResult = await scanGherkinFiles({
+ *   patterns: 'tests/features/roadmap/**\/*.feature'
+ * });
+ *
+ * if (scanResult.ok) {
+ *   const { patterns, errors } = extractPatternsFromGherkin(scanResult.value.files, {
+ *     baseDir: process.cwd()
+ *   });
+ *   console.log(`${patterns.length} patterns extracted, ${errors.length} errors`);
+ * }
+ * ```
+ */
+export function extractPatternsFromGherkin(scannedFiles, config) {
+    const patterns = [];
+    const errors = [];
+    const { baseDir } = config;
+    const scenariosAsUseCases = config.scenariosAsUseCases ?? true;
+    for (const file of scannedFiles) {
+        const { feature, scenarios, rules, filePath } = file;
+        // Convert absolute path to relative path from baseDir
+        const relativePath = path.relative(baseDir, filePath);
+        // Extract pattern metadata from feature tags
+        const metadata = extractPatternTags(feature.tags);
+        // Skip if no @architect opt-in marker (consistent with TypeScript requirement)
+        // The marker normalizes to 'architect' after stripping the @ prefix
+        const hasOptIn = feature.tags.some((tag) => tag === 'architect');
+        if (!hasOptIn) {
+            continue;
+        }
+        // Skip if no pattern tag (not a pattern definition)
+        if (!metadata.pattern) {
+            continue;
+        }
+        // Skip if no status tag (pattern reference for scenario mapping, not a pattern definition)
+        // Roadmap patterns MUST have @status:roadmap, @status:active, or @status:completed
+        if (!metadata.status) {
+            continue;
+        }
+        // Determine pattern name (from @pattern:Name tag or feature name)
+        const patternName = metadata.pattern || feature.name;
+        // Determine category (from category tags or default to first one)
+        const categories = metadata.categories ?? [];
+        const primaryCategory = categories[0] ?? 'ddd';
+        // Extract "When to Use" from scenarios if enabled
+        const whenToUse = [];
+        if (scenariosAsUseCases) {
+            for (const scenario of scenarios) {
+                // Only include scenarios tagged with @acceptance-criteria
+                if (scenario.tags.includes('acceptance-criteria')) {
+                    whenToUse.push(`When ${scenario.name.toLowerCase()}`);
+                }
+            }
+        }
+        // Create pattern ID from file path and line number (deterministic)
+        const patternId = asPatternId(generatePatternId(relativePath, feature.line));
+        // Extract deliverables from Background table
+        const deliverables = extractDeliverables(file);
+        // Infer and verify behavior file for traceability
+        let behaviorFile = metadata.behaviorFile;
+        let behaviorFileVerified;
+        if (!behaviorFile) {
+            // Infer from convention: timeline/phase-N-name.feature → behavior/name.feature
+            const inferred = inferBehaviorFilePath(relativePath);
+            if (inferred) {
+                behaviorFile = inferred;
+                // Verify file exists on disk
+                const absolutePath = path.join(baseDir, inferred);
+                behaviorFileVerified = fileExistsSync(absolutePath);
+            }
+        }
+        else {
+            // Verify explicit tag path exists
+            const absolutePath = path.join(baseDir, behaviorFile);
+            behaviorFileVerified = fileExistsSync(absolutePath);
+        }
+        const rawPattern = buildGherkinRawPattern({
+            relativePath,
+            filePath,
+            patternId,
+            patternName,
+            primaryCategory,
+            feature,
+            metadata,
+            whenToUse,
+            scenarios,
+            rules,
+            deliverables,
+            behaviorFile,
+            behaviorFileVerified,
+        });
+        // Validate against schema (schema-first enforcement)
+        const validation = ExtractedPatternSchema.safeParse(rawPattern);
+        if (!validation.success) {
+            // Collect validation error instead of console.warn
+            errors.push(createGherkinPatternValidationError(relativePath, patternName, 'Schema validation failed', validation.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`)));
+            continue;
+        }
+        patterns.push(validation.data);
+    }
+    return { patterns, errors };
+}
+/**
+ * Infer behavior file path from timeline feature file path using convention
+ *
+ * Convention: `timeline/phase-N[suffix]-name.feature` → `behavior/name.feature`
+ *
+ * Handles edge cases:
+ * - `phase-37-remaining-work-enhancement.feature` → `remaining-work-enhancement.feature`
+ * - `phase-02b-enhanced-dogfooding.feature` → `enhanced-dogfooding.feature`
+ * - `phase-03-watch-mode.feature` → `watch-mode.feature`
+ *
+ * @param timelineFilePath - Relative path to timeline feature file
+ * @returns Inferred behavior file path, or undefined if not a timeline file
+ */
+export function inferBehaviorFilePath(timelineFilePath) {
+    // Match: phase-NN[a-z]?-name.feature (supports phase-02b, phase-37, etc.)
+    const match = /phase-\d+[a-z]?-(.+)\.feature$/.exec(timelineFilePath);
+    if (match?.[1]) {
+        return `tests/features/behavior/${match[1]}.feature`;
+    }
+    return undefined;
+}
+/**
+ * Check if a file exists at the given path (sync)
+ *
+ * @param filePath - Absolute path to check
+ * @returns true if file exists, false otherwise
+ */
+function fileExistsSync(filePath) {
+    try {
+        return fs.existsSync(filePath);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if a file exists at the given path (async)
+ *
+ * @param filePath - Absolute path to check
+ * @returns Promise resolving to true if file exists, false otherwise
+ */
+async function fileExistsAsync(filePath) {
+    try {
+        await fs.promises.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Extract patterns from scanned Gherkin feature files (async variant)
+ *
+ * This is the async version of `extractPatternsFromGherkin` that performs
+ * file existence checks asynchronously in parallel, avoiding event loop blocking.
+ *
+ * Use this variant when processing many feature files or when running on
+ * systems with slow disk I/O.
+ *
+ * @param scannedFiles - Array of scanned Gherkin files
+ * @param config - Extractor configuration (requires baseDir for relative paths)
+ * @returns Promise resolving to extracted patterns and validation errors
+ *
+ * @example
+ * ```typescript
+ * const scanResult = await scanGherkinFiles({
+ *   patterns: 'tests/features/roadmap/**\/*.feature'
+ * });
+ *
+ * if (scanResult.ok) {
+ *   const { patterns, errors } = await extractPatternsFromGherkinAsync(
+ *     scanResult.value.files,
+ *     { baseDir: process.cwd() }
+ *   );
+ * }
+ * ```
+ */
+export async function extractPatternsFromGherkinAsync(scannedFiles, config) {
+    const { baseDir } = config;
+    const scenariosAsUseCases = config.scenariosAsUseCases ?? true;
+    const patternsToVerify = [];
+    const errors = [];
+    for (const file of scannedFiles) {
+        const { feature, scenarios, rules, filePath } = file;
+        const relativePath = path.relative(baseDir, filePath);
+        const metadata = extractPatternTags(feature.tags);
+        // Skip if no @architect opt-in marker (consistent with TypeScript requirement)
+        // The marker normalizes to 'architect' after stripping the @ prefix
+        const hasOptIn = feature.tags.some((tag) => tag === 'architect');
+        if (!hasOptIn)
+            continue;
+        // Skip if no pattern or status tag
+        if (!metadata.pattern || !metadata.status)
+            continue;
+        const patternName = metadata.pattern || feature.name;
+        const categories = metadata.categories ?? [];
+        const primaryCategory = categories[0] ?? 'ddd';
+        const whenToUse = [];
+        if (scenariosAsUseCases) {
+            for (const scenario of scenarios) {
+                if (scenario.tags.includes('acceptance-criteria')) {
+                    whenToUse.push(`When ${scenario.name.toLowerCase()}`);
+                }
+            }
+        }
+        const patternId = asPatternId(generatePatternId(relativePath, feature.line));
+        const deliverables = extractDeliverables(file);
+        // Infer behavior file path but DON'T verify yet
+        let behaviorFile = metadata.behaviorFile;
+        let behaviorPathToVerify;
+        if (!behaviorFile) {
+            const inferred = inferBehaviorFilePath(relativePath);
+            if (inferred) {
+                behaviorFile = inferred;
+                behaviorPathToVerify = path.join(baseDir, inferred);
+            }
+        }
+        else {
+            behaviorPathToVerify = path.join(baseDir, behaviorFile);
+        }
+        const rawPattern = buildGherkinRawPattern({
+            relativePath,
+            filePath,
+            patternId,
+            patternName,
+            primaryCategory,
+            feature,
+            metadata,
+            whenToUse,
+            scenarios,
+            rules,
+            deliverables,
+            behaviorFile,
+            behaviorFileVerified: undefined,
+        });
+        const validation = ExtractedPatternSchema.safeParse(rawPattern);
+        if (!validation.success) {
+            errors.push(createGherkinPatternValidationError(relativePath, patternName, 'Schema validation failed', validation.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`)));
+            continue;
+        }
+        // Use explicit conditional to satisfy exactOptionalPropertyTypes
+        // (undefined is not the same as "property not present")
+        if (behaviorPathToVerify !== undefined) {
+            patternsToVerify.push({ pattern: validation.data, behaviorPathToVerify });
+        }
+        else {
+            patternsToVerify.push({ pattern: validation.data });
+        }
+    }
+    // Second pass: Batch async verification of all behavior file paths
+    const verificationPromises = patternsToVerify.map(async ({ pattern, behaviorPathToVerify }) => {
+        if (behaviorPathToVerify) {
+            const exists = await fileExistsAsync(behaviorPathToVerify);
+            // Return pattern with behaviorFileVerified set
+            return { ...pattern, behaviorFileVerified: exists };
+        }
+        return pattern;
+    });
+    const patterns = await Promise.all(verificationPromises);
+    return { patterns, errors };
+}
+// NOTE: extractAdrContent() was removed as part of Issue #99.
+// ADR content (context, decision, consequences) is now derived from
+// Gherkin Rule: keywords instead of parsed markdown in feature descriptions.
+// Rules prefixed with "Context -", "Decision -", "Consequences -" are
+// semantically detected and rendered by the ADR codec.
+/**
+ * Compute children arrays from parent references
+ *
+ * Post-processing step that populates the `children` field on each pattern
+ * by finding all patterns that reference it via their `parent` field.
+ *
+ * This enables bidirectional hierarchy navigation:
+ * - Child → Parent: via `parent` field (explicit in feature file)
+ * - Parent → Children: via `children` field (computed here)
+ *
+ * **Performance Note:** This function does NOT re-validate patterns through
+ * the schema because:
+ * 1. Input patterns have already been validated by extractPatternsFromGherkin()
+ * 2. We're only adding a `children: string[]` field which matches the schema
+ * 3. Re-validation of the complex ExtractedPatternSchema is expensive (~320 lines)
+ *
+ * This invariant is safe because:
+ * - The children array is derived from validated pattern names
+ * - ExtractedPatternSchema.children is defined as `z.array(z.string()).readonly().optional()`
+ *
+ * @param patterns - Array of validated ExtractedPattern objects
+ * @returns New array with `children` populated (does not mutate input)
+ *
+ * @example
+ * ```typescript
+ * const rawPatterns = extractPatternsFromGherkin(files, config);
+ * const patternsWithHierarchy = computeHierarchyChildren(rawPatterns);
+ *
+ * // Now epic patterns have children arrays
+ * const epic = patternsWithHierarchy.find(p => p.level === 'epic');
+ * console.log(epic.children); // ["PhaseA", "PhaseB"]
+ * ```
+ */
+export function computeHierarchyChildren(patterns) {
+    // Build a map: parent name → child names
+    const parentToChildren = new Map();
+    for (const pattern of patterns) {
+        if (pattern.parent) {
+            const children = parentToChildren.get(pattern.parent) ?? [];
+            // Use patternName if available, otherwise fall back to name
+            const childName = getPatternName(pattern);
+            children.push(childName);
+            parentToChildren.set(pattern.parent, children);
+        }
+    }
+    // Apply children arrays to patterns
+    // No re-validation needed - input is already validated and we're only adding children: string[]
+    return patterns.map((pattern) => {
+        const patternName = getPatternName(pattern);
+        const children = parentToChildren.get(patternName);
+        if (children && children.length > 0) {
+            // Type-safe spread: pattern is validated ExtractedPattern, children is string[]
+            // This matches ExtractedPatternSchema.children: z.array(z.string()).readonly().optional()
+            return { ...pattern, children };
+        }
+        return pattern;
+    });
+}
+//# sourceMappingURL=gherkin-extractor.js.map

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

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

package/dist/extractor/index.d.ts

@@ -0,0 +1,7 @@
+export { extractPatterns, buildPattern, inferPatternName, inferCategory, hasAggregationTag, getAggregationTags, type ExtractionResults, type AggregationTags, } from './doc-extractor.js';
+export { extractProcessMetadata, extractDeliverables, combineSources, validateDualSource, type ProcessMetadata, type Deliverable, type DualSourcePattern, type CrossValidationError, type DualSourceResults, type ValidationSummary, } from './dual-source-extractor.js';
+export { inferFeatureLayer, FEATURE_LAYERS, type FeatureLayer } from './layer-inference.js';
+export { extractPatternsFromGherkin, extractPatternsFromGherkinAsync, computeHierarchyChildren, type GherkinExtractorConfig, type GherkinExtractionResult, } from './gherkin-extractor.js';
+export { extractShapes, processExtractShapesTag, type ProcessExtractShapesResult, } from './shape-extractor.js';
+export { renderShapesAsMarkdown } from '../renderable/codecs/helpers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/extractor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/extractor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAG5F,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,EAC/B,wBAAwB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,GAC7B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,KAAK,0BAA0B,GAChC,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/extractor/index.js

@@ -0,0 +1,11 @@
+export { extractPatterns, buildPattern, inferPatternName, inferCategory, hasAggregationTag, getAggregationTags, } from './doc-extractor.js';
+// Dual-Source Extraction (USDP)
+export { extractProcessMetadata, extractDeliverables, combineSources, validateDualSource, } from './dual-source-extractor.js';
+// Layer Inference
+export { inferFeatureLayer, FEATURE_LAYERS } from './layer-inference.js';
+// Gherkin Extraction (Feature File → Pattern)
+export { extractPatternsFromGherkin, extractPatternsFromGherkinAsync, computeHierarchyChildren, } from './gherkin-extractor.js';
+// Shape Extraction (ADR-021: Documentation Generation)
+export { extractShapes, processExtractShapesTag, } from './shape-extractor.js';
+export { renderShapesAsMarkdown } from '../renderable/codecs/helpers.js';
+//# sourceMappingURL=index.js.map

package/dist/extractor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/extractor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,kBAAkB,GAGnB,MAAM,oBAAoB,CAAC;AAE5B,gCAAgC;AAChC,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,GAOnB,MAAM,4BAA4B,CAAC;AAEpC,kBAAkB;AAClB,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAqB,MAAM,sBAAsB,CAAC;AAE5F,8CAA8C;AAC9C,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,EAC/B,wBAAwB,GAGzB,MAAM,wBAAwB,CAAC;AAEhC,uDAAuD;AACvD,OAAO,EACL,aAAa,EACb,uBAAuB,GAExB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/extractor/layer-inference.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @architect
+ * @architect-extractor
+ * @architect-pattern LayerInference
+ * @architect-status completed
+ * @architect-used-by GherkinExtractor
+ *
+ * ## LayerInference - Directory-Based Feature Classification
+ *
+ * Infers feature file layer (timeline, domain, integration, e2e, component)
+ * from directory path patterns. Enables filtering without explicit annotations.
+ *
+ * ### When to Use
+ *
+ * - When filtering scenarios by testing layer
+ * - When generating layer-specific documentation
+ * - When calculating test coverage by layer
+ */
+/**
+ * Feature layer classification based on directory structure
+ *
+ * @remarks
+ * Layers represent different testing contexts and documentation purposes:
+ * - `timeline`: Process documentation features (roadmap, milestones)
+ * - `domain`: Pure domain logic tests (deciders, command handlers)
+ * - `integration`: Full-stack integration tests with real backend
+ * - `e2e`: Browser-based end-to-end user journey tests
+ * - `component`: Tooling/infrastructure component tests
+ * - `unknown`: Unclassified features (fallback)
+ */
+export type FeatureLayer = 'timeline' | 'domain' | 'integration' | 'e2e' | 'component' | 'unknown';
+/**
+ * All valid feature layers as a readonly array
+ *
+ * @remarks
+ * Useful for validation and schema definitions
+ */
+export declare const FEATURE_LAYERS: readonly FeatureLayer[];
+/**
+ * Infer feature layer from file path
+ *
+ * Uses directory structure patterns to classify feature files:
+ * - `/timeline/` → timeline (process documentation)
+ * - `/deciders/` → domain (pure domain logic)
+ * - `/orders/`, `/inventory/` (not integration) → domain
+ * - `/integration-features/`, `/integration/` → integration
+ * - `/e2e/` → e2e (browser-based tests)
+ * - `/scanner/`, `/lint/` → component (tooling tests)
+ *
+ * @param filePath - Absolute or relative path to feature file
+ * @returns Inferred layer based on directory patterns
+ *
+ * @example
+ * ```typescript
+ * inferFeatureLayer('tests/features/timeline/phase-01.feature');
+ * // Returns: 'timeline'
+ *
+ * inferFeatureLayer('tests/features/deciders/order.decider.feature');
+ * // Returns: 'domain'
+ *
+ * inferFeatureLayer('tests/integration-features/orders/flow.feature');
+ * // Returns: 'integration'
+ * ```
+ */
+export declare function inferFeatureLayer(filePath: string): FeatureLayer;
+//# sourceMappingURL=layer-inference.d.ts.map

package/dist/extractor/layer-inference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layer-inference.d.ts","sourceRoot":"","sources":["../../src/extractor/layer-inference.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,QAAQ,GAAG,aAAa,GAAG,KAAK,GAAG,WAAW,GAAG,SAAS,CAAC;AAEnG;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAOxC,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CA0ChE"}