specweave 0.21.1 → 0.21.3

package/dist/src/init/research/ReportGenerator.js

@@ -0,0 +1,125 @@
+/**
+ * Market Research Report Generator
+ *
+ * Generates markdown reports summarizing vision analysis results.
+ */
+import fs from 'fs/promises';
+import path from 'path';
+/**
+ * ReportGenerator - Generates market research reports
+ *
+ * **Usage**:
+ * ```typescript
+ * await ReportGenerator.generate(insights);
+ * // Creates .specweave/reports/market-research.md
+ * ```
+ */
+export class ReportGenerator {
+    /**
+     * Generate market research report
+     *
+     * @param insights - Vision insights to include in report
+     * @param reportPath - Optional custom report path
+     */
+    static async generate(insights, reportPath = ReportGenerator.REPORT_PATH) {
+        const markdown = ReportGenerator.createMarkdown(insights);
+        // Ensure reports directory exists
+        const dir = path.dirname(reportPath);
+        await fs.mkdir(dir, { recursive: true });
+        // Write report
+        await fs.writeFile(reportPath, markdown, 'utf-8');
+    }
+    /**
+     * Create markdown content from insights
+     *
+     * @param insights - Vision insights
+     * @returns Markdown string
+     */
+    static createMarkdown(insights) {
+        const timestamp = new Date().toISOString();
+        const date = new Date().toLocaleDateString('en-US', {
+            year: 'numeric',
+            month: 'long',
+            day: 'numeric'
+        });
+        const sections = [];
+        // Header
+        sections.push('# Market Research Report');
+        sections.push('');
+        sections.push(`**Generated**: ${date}`);
+        sections.push(`**Timestamp**: ${timestamp}`);
+        sections.push('');
+        sections.push('---');
+        sections.push('');
+        // Vision
+        sections.push('## Product Vision');
+        sections.push('');
+        sections.push(insights.rawVision);
+        sections.push('');
+        // Keywords
+        sections.push('## Keywords & Domain Focus');
+        sections.push('');
+        sections.push('**Extracted Keywords**:');
+        sections.push('');
+        insights.keywords.forEach(keyword => {
+            sections.push(`- ${keyword}`);
+        });
+        sections.push('');
+        // Market Category
+        sections.push('## Market Classification');
+        sections.push('');
+        sections.push(`**Category**: ${insights.market}`);
+        sections.push(`**Confidence**: ${(insights.confidence * 100).toFixed(0)}%`);
+        sections.push('');
+        // Opportunity Score
+        sections.push('## Opportunity Analysis');
+        sections.push('');
+        sections.push(`**Opportunity Score**: ${insights.opportunityScore}/10`);
+        sections.push(`**Viral Potential**: ${insights.viralPotential ? 'Yes' : 'No'}`);
+        sections.push('');
+        // Competitors
+        if (insights.competitors.length > 0) {
+            sections.push('## Competitive Landscape');
+            sections.push('');
+            sections.push('**Similar Products**:');
+            sections.push('');
+            sections.push('| Product | URL | Similarity | Strengths | Weaknesses |');
+            sections.push('|---------|-----|------------|-----------|------------|');
+            insights.competitors.forEach(comp => {
+                const similarity = 'N/A'; // Similarity scoring not yet implemented
+                const strengths = comp.strengths.join(', ') || 'N/A';
+                const weaknesses = comp.weaknesses.join(', ') || 'N/A';
+                sections.push(`| ${comp.name} | ${comp.url || 'N/A'} | ${similarity} | ${strengths} | ${weaknesses} |`);
+            });
+            sections.push('');
+        }
+        else {
+            sections.push('## Competitive Landscape');
+            sections.push('');
+            sections.push('No similar products identified.');
+            sections.push('');
+        }
+        // Follow-up Questions
+        if (insights.followUpQuestions.length > 0) {
+            sections.push('## Recommended Next Steps');
+            sections.push('');
+            sections.push('To refine your product strategy, consider these questions:');
+            sections.push('');
+            insights.followUpQuestions.forEach((q, idx) => {
+                sections.push(`${idx + 1}. **${q.question}**`);
+                sections.push('');
+            });
+        }
+        // Footer
+        sections.push('---');
+        sections.push('');
+        sections.push('*This report was generated by SpecWeave Strategic Init*');
+        sections.push('');
+        return sections.join('\n');
+    }
+}
+/**
+ * Default report path
+ */
+ReportGenerator.REPORT_PATH = '.specweave/reports/market-research.md';
+//# sourceMappingURL=ReportGenerator.js.map

package/dist/src/init/research/ReportGenerator.js.map

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

package/dist/src/init/research/VisionAnalyzer.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Vision & Market Research Analyzer
+ *
+ * Analyzes product vision descriptions using AI to extract:
+ * - Keywords and domain focus
+ * - Market category classification
+ * - Competitor analysis
+ * - Opportunity scoring
+ * - Viral potential detection
+ * - Adaptive follow-up questions
+ *
+ * This is the foundation of SpecWeave's research-driven init flow.
+ */
+import { VisionInsights } from './types.js';
+/**
+ * Configuration for VisionAnalyzer
+ */
+export interface VisionAnalyzerConfig {
+    /** Cache duration for analysis results (in milliseconds) */
+    cacheDuration?: number;
+    /** Maximum number of competitors to return */
+    maxCompetitors?: number;
+    /** Maximum number of follow-up questions */
+    maxFollowUpQuestions?: number;
+    /** Minimum keyword score threshold */
+    minKeywordScore?: number;
+}
+/**
+ * VisionAnalyzer - Main class for vision analysis
+ *
+ * **Usage**:
+ * ```typescript
+ * const analyzer = new VisionAnalyzer();
+ * const insights = await analyzer.analyze('A Figma-like design tool for remote teams');
+ * console.log(insights.market); // 'productivity-saas'
+ * console.log(insights.keywords); // ['design', 'collaboration', 'remote teams']
+ * console.log(insights.viralPotential); // true
+ * ```
+ */
+export declare class VisionAnalyzer {
+    private config;
+    private cache;
+    /**
+     * Create a new VisionAnalyzer
+     *
+     * @param config - Optional configuration
+     */
+    constructor(config?: VisionAnalyzerConfig);
+    /**
+     * Analyze product vision and return insights
+     *
+     * This is the primary method that orchestrates the entire analysis:
+     * 1. Check cache
+     * 2. Extract keywords (LLM or rules)
+     * 3. Detect market category (LLM or rules)
+     * 4. Identify competitors (LLM or empty)
+     * 5. Calculate opportunity score
+     * 6. Detect viral potential
+     * 7. Generate follow-up questions
+     * 8. Validate and return results
+     *
+     * @param vision - User's product vision (1-3 sentences)
+     * @returns VisionInsights with validated data
+     *
+     * @example
+     * ```typescript
+     * const insights = await analyzer.analyze(
+     *   'A project management tool for agile teams with real-time collaboration'
+     * );
+     * ```
+     */
+    analyze(vision: string): Promise<VisionInsights>;
+    /**
+     * Perform the actual analysis
+     *
+     * Implementation status:
+     * - ✅ T-002: Keyword extraction (pattern-based)
+     * - ✅ T-003: Market detection (rule-based classification)
+     * - ✅ T-004: Competitor analysis (keyword similarity)
+     * - ✅ T-005: Opportunity scoring (algorithmic)
+     * - ✅ T-006: Follow-up questions (adaptive)
+     *
+     * @param vision - Trimmed vision text
+     * @returns VisionInsights
+     */
+    private performAnalysis;
+    /**
+     * Get cached insights if available and not expired
+     *
+     * @param vision - Vision text (cache key)
+     * @returns Cached insights or undefined
+     */
+    private getCached;
+    /**
+     * Store insights in cache
+     *
+     * @param vision - Vision text (cache key)
+     * @param insights - Insights to cache
+     */
+    private setCached;
+    /**
+     * Clear cache (useful for testing)
+     */
+    clearCache(): void;
+    /**
+     * Get current configuration
+     */
+    getConfig(): Readonly<Required<VisionAnalyzerConfig>>;
+    /**
+     * Update configuration
+     *
+     * @param config - Partial config to merge
+     */
+    updateConfig(config: Partial<VisionAnalyzerConfig>): void;
+    /**
+     * Save vision insights to .specweave/config.json
+     *
+     * @param insights - Vision insights to save
+     * @param configPath - Optional custom config path
+     *
+     * @example
+     * ```typescript
+     * const insights = await analyzer.analyze(vision);
+     * await VisionAnalyzer.saveToConfig(insights);
+     * ```
+     */
+    static saveToConfig(insights: VisionInsights, configPath?: string): Promise<void>;
+}
+//# sourceMappingURL=VisionAnalyzer.d.ts.map

package/dist/src/init/research/VisionAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VisionAnalyzer.d.ts","sourceRoot":"","sources":["../../../../src/init/research/VisionAnalyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,cAAc,EAAwC,MAAM,YAAY,CAAC;AAGlF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,4CAA4C;IAC5C,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B,sCAAsC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAYD;;;;;;;;;;;GAWG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,KAAK,CAA+D;IAE5E;;;;OAIG;gBACS,MAAM,GAAE,oBAAyB;IAK7C;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IA2BtD;;;;;;;;;;;;OAYG;YACW,eAAe;IA2D7B;;;;;OAKG;IACH,OAAO,CAAC,SAAS;IAmBjB;;;;;OAKG;IACH,OAAO,CAAC,SAAS;IAOjB;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;IAIrD;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI;IAIzD;;;;;;;;;;;OAWG;WACU,YAAY,CAAC,QAAQ,EAAE,cAAc,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAIxF"}

package/dist/src/init/research/VisionAnalyzer.js

@@ -0,0 +1,212 @@
+/**
+ * Vision & Market Research Analyzer
+ *
+ * Analyzes product vision descriptions using AI to extract:
+ * - Keywords and domain focus
+ * - Market category classification
+ * - Competitor analysis
+ * - Opportunity scoring
+ * - Viral potential detection
+ * - Adaptive follow-up questions
+ *
+ * This is the foundation of SpecWeave's research-driven init flow.
+ */
+import { VisionInsightsSchema } from './types.js';
+import { extractKeywords } from './keyword-extractor.js';
+/**
+ * Default configuration
+ */
+const DEFAULT_CONFIG = {
+    cacheDuration: 24 * 60 * 60 * 1000, // 24 hours
+    maxCompetitors: 5,
+    maxFollowUpQuestions: 3,
+    minKeywordScore: 0.5
+};
+/**
+ * VisionAnalyzer - Main class for vision analysis
+ *
+ * **Usage**:
+ * ```typescript
+ * const analyzer = new VisionAnalyzer();
+ * const insights = await analyzer.analyze('A Figma-like design tool for remote teams');
+ * console.log(insights.market); // 'productivity-saas'
+ * console.log(insights.keywords); // ['design', 'collaboration', 'remote teams']
+ * console.log(insights.viralPotential); // true
+ * ```
+ */
+export class VisionAnalyzer {
+    /**
+     * Create a new VisionAnalyzer
+     *
+     * @param config - Optional configuration
+     */
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.cache = new Map();
+    }
+    /**
+     * Analyze product vision and return insights
+     *
+     * This is the primary method that orchestrates the entire analysis:
+     * 1. Check cache
+     * 2. Extract keywords (LLM or rules)
+     * 3. Detect market category (LLM or rules)
+     * 4. Identify competitors (LLM or empty)
+     * 5. Calculate opportunity score
+     * 6. Detect viral potential
+     * 7. Generate follow-up questions
+     * 8. Validate and return results
+     *
+     * @param vision - User's product vision (1-3 sentences)
+     * @returns VisionInsights with validated data
+     *
+     * @example
+     * ```typescript
+     * const insights = await analyzer.analyze(
+     *   'A project management tool for agile teams with real-time collaboration'
+     * );
+     * ```
+     */
+    async analyze(vision) {
+        // Validate input
+        if (!vision || vision.trim().length === 0) {
+            throw new Error('Vision description cannot be empty');
+        }
+        const trimmedVision = vision.trim();
+        // Check cache
+        const cached = this.getCached(trimmedVision);
+        if (cached) {
+            return cached;
+        }
+        // Perform analysis (stub implementation for now)
+        // This will be implemented in subsequent tasks
+        const insights = await this.performAnalysis(trimmedVision);
+        // Validate results
+        const validated = VisionInsightsSchema.parse(insights);
+        // Cache results
+        this.setCached(trimmedVision, validated);
+        return validated;
+    }
+    /**
+     * Perform the actual analysis
+     *
+     * Implementation status:
+     * - ✅ T-002: Keyword extraction (pattern-based)
+     * - ✅ T-003: Market detection (rule-based classification)
+     * - ✅ T-004: Competitor analysis (keyword similarity)
+     * - ✅ T-005: Opportunity scoring (algorithmic)
+     * - ✅ T-006: Follow-up questions (adaptive)
+     *
+     * @param vision - Trimmed vision text
+     * @returns VisionInsights
+     */
+    async performAnalysis(vision) {
+        // Import needed modules
+        const { detectMarketCategory } = await import('./MarketDetector.js');
+        const { analyzeCompetitors } = await import('./CompetitorAnalyzer.js');
+        const { calculateOpportunityScore, estimateInnovationFactor } = await import('./OpportunityScorer.js');
+        const { generateFollowUpQuestions } = await import('./QuestionGenerator.js');
+        // ✅ T-002: Extract keywords using pattern matching
+        const keywords = extractKeywords(vision);
+        // ✅ T-003: Detect market category using rule-based classification
+        const marketClassification = detectMarketCategory(vision);
+        const market = marketClassification.category;
+        const confidence = marketClassification.confidence;
+        // ✅ T-004: Analyze competitors using keyword similarity
+        const competitors = analyzeCompetitors(keywords, this.config.maxCompetitors);
+        // ✅ T-005: Calculate opportunity score
+        const innovation = estimateInnovationFactor(keywords, competitors.length);
+        // Detect viral potential (simple heuristic)
+        const viralKeywords = ['viral', 'social', 'share', 'network', 'community', 'collaboration', 'real-time'];
+        const viralPotential = keywords.some(k => viralKeywords.some(vk => k.toLowerCase().includes(vk)));
+        const opportunityResult = calculateOpportunityScore(market, competitors.length, viralPotential, innovation);
+        // ✅ T-006: Generate adaptive follow-up questions
+        const followUpQuestions = generateFollowUpQuestions({
+            marketCategory: market,
+            viralPotential,
+            opportunityScore: opportunityResult.score,
+            keywords,
+            competitorCount: competitors.length
+        }, this.config.maxFollowUpQuestions);
+        const insights = {
+            keywords,
+            market,
+            competitors,
+            opportunityScore: opportunityResult.score,
+            viralPotential,
+            followUpQuestions,
+            confidence,
+            rawVision: vision
+        };
+        return insights;
+    }
+    /**
+     * Get cached insights if available and not expired
+     *
+     * @param vision - Vision text (cache key)
+     * @returns Cached insights or undefined
+     */
+    getCached(vision) {
+        const cached = this.cache.get(vision);
+        if (!cached) {
+            return undefined;
+        }
+        const now = Date.now();
+        const age = now - cached.timestamp;
+        if (age > this.config.cacheDuration) {
+            // Expired, remove from cache
+            this.cache.delete(vision);
+            return undefined;
+        }
+        return cached.insights;
+    }
+    /**
+     * Store insights in cache
+     *
+     * @param vision - Vision text (cache key)
+     * @param insights - Insights to cache
+     */
+    setCached(vision, insights) {
+        this.cache.set(vision, {
+            insights,
+            timestamp: Date.now()
+        });
+    }
+    /**
+     * Clear cache (useful for testing)
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    /**
+     * Get current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Update configuration
+     *
+     * @param config - Partial config to merge
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+    /**
+     * Save vision insights to .specweave/config.json
+     *
+     * @param insights - Vision insights to save
+     * @param configPath - Optional custom config path
+     *
+     * @example
+     * ```typescript
+     * const insights = await analyzer.analyze(vision);
+     * await VisionAnalyzer.saveToConfig(insights);
+     * ```
+     */
+    static async saveToConfig(insights, configPath) {
+        const { ConfigManager } = await import('../../config/ConfigManager.js');
+        await ConfigManager.updateResearch({ vision: insights }, configPath);
+    }
+}
+//# sourceMappingURL=VisionAnalyzer.js.map

package/dist/src/init/research/VisionAnalyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VisionAnalyzer.js","sourceRoot":"","sources":["../../../../src/init/research/VisionAnalyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAkB,oBAAoB,EAAkB,MAAM,YAAY,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAmBzD;;GAEG;AACH,MAAM,cAAc,GAAmC;IACrD,aAAa,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,WAAW;IAC/C,cAAc,EAAE,CAAC;IACjB,oBAAoB,EAAE,CAAC;IACvB,eAAe,EAAE,GAAG;CACrB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,cAAc;IAIzB;;;;OAIG;IACH,YAAY,SAA+B,EAAE;QAC3C,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;QAC/C,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;IACzB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,KAAK,CAAC,OAAO,CAAC,MAAc;QAC1B,iBAAiB;QACjB,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QAED,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAEpC,cAAc;QACd,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QAC7C,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,iDAAiD;QACjD,+CAA+C;QAC/C,MAAM,QAAQ,GAAmB,MAAM,IAAI,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;QAE3E,mBAAmB;QACnB,MAAM,SAAS,GAAG,oBAAoB,CAAC,KAAK,CAAC,QAAQ,CAAmB,CAAC;QAEzE,gBAAgB;QAChB,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;QAEzC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;;;;;;;;OAYG;IACK,KAAK,CAAC,eAAe,CAAC,MAAc;QAC1C,wBAAwB;QACxB,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;QACrE,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;QACvE,MAAM,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;QACvG,MAAM,EAAE,yBAAyB,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;QAE7E,mDAAmD;QACnD,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QAEzC,kEAAkE;QAClE,MAAM,oBAAoB,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,oBAAoB,CAAC,QAAQ,CAAC;QAC7C,MAAM,UAAU,GAAG,oBAAoB,CAAC,UAAU,CAAC;QAEnD,wDAAwD;QACxD,MAAM,WAAW,GAAG,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QAE7E,uCAAuC;QACvC,MAAM,UAAU,GAAG,wBAAwB,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;QAC1E,4CAA4C;QAC5C,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,WAAW,CAAC,CAAC;QACzG,MAAM,cAAc,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CACvC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CACvD,CAAC;QAEF,MAAM,iBAAiB,GAAG,yBAAyB,CACjD,MAAM,EACN,WAAW,CAAC,MAAM,EAClB,cAAc,EACd,UAAU,CACX,CAAC;QAEF,iDAAiD;QACjD,MAAM,iBAAiB,GAAG,yBAAyB,CACjD;YACE,cAAc,EAAE,MAAM;YACtB,cAAc;YACd,gBAAgB,EAAE,iBAAiB,CAAC,KAAK;YACzC,QAAQ;YACR,eAAe,EAAE,WAAW,CAAC,MAAM;SACpC,EACD,IAAI,CAAC,MAAM,CAAC,oBAAoB,CACjC,CAAC;QAEF,MAAM,QAAQ,GAAmB;YAC/B,QAAQ;YACR,MAAM;YACN,WAAW;YACX,gBAAgB,EAAE,iBAAiB,CAAC,KAAK;YACzC,cAAc;YACd,iBAAiB;YACjB,UAAU;YACV,SAAS,EAAE,MAAM;SAClB,CAAC;QAEF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;OAKG;IACK,SAAS,CAAC,MAAc;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAEtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC;QAEnC,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YACpC,6BAA6B;YAC7B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC1B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,MAAM,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACK,SAAS,CAAC,MAAc,EAAE,QAAwB;QACxD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE;YACrB,QAAQ;YACR,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,YAAY,CAAC,MAAqC;QAChD,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IAC9C,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,QAAwB,EAAE,UAAmB;QACrE,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,+BAA+B,CAAC,CAAC;QACxE,MAAM,aAAa,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,UAAU,CAAC,CAAC;IACvE,CAAC;CACF"}

package/dist/src/init/research/keyword-extractor.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Keyword Extractor - Pattern-Based Intelligence
+ *
+ * Extracts domain-specific keywords from product vision using intelligent
+ * pattern matching. No external LLM API calls - all intelligence is encoded
+ * at spec-time using domain knowledge.
+ *
+ * **Approach**:
+ * 1. Define domain patterns (design, collaboration, productivity, etc.)
+ * 2. Match vision text against patterns
+ * 3. Score and rank keywords by relevance
+ * 4. Deduplicate and return top 5-10 keywords
+ *
+ * **Benefits**:
+ * - Zero external dependencies
+ * - Instant execution (no API latency)
+ * - 100% deterministic and testable
+ * - Works offline
+ */
+/**
+ * Domain pattern definitions
+ *
+ * Each pattern maps to a domain category and contains:
+ * - Regex pattern for matching
+ * - Weight (importance multiplier)
+ * - Related keywords
+ */
+export interface DomainPattern {
+    /** Domain category name */
+    domain: string;
+    /** Regex pattern for matching */
+    pattern: RegExp;
+    /** Weight multiplier (1.0 = normal, 2.0 = high priority) */
+    weight: number;
+    /** Related keywords for this domain */
+    keywords: string[];
+}
+/**
+ * Keyword match result
+ */
+export interface KeywordMatch {
+    /** Matched keyword */
+    keyword: string;
+    /** Domain category */
+    domain: string;
+    /** Relevance score (higher = more relevant) */
+    score: number;
+    /** Number of times this keyword appeared */
+    frequency: number;
+}
+/**
+ * Domain patterns encoded with intelligence from spec generation time
+ *
+ * This is where the AI intelligence lives - as smart patterns designed
+ * by Claude during spec generation, not as runtime LLM calls!
+ */
+export declare const DOMAIN_PATTERNS: DomainPattern[];
+/**
+ * Extract keywords from vision text using pattern matching
+ *
+ * @param vision - Product vision text (1-3 sentences)
+ * @returns Array of 5-10 keywords sorted by relevance score
+ *
+ * @example
+ * ```typescript
+ * const keywords = extractKeywords('A Figma-like design tool for remote teams');
+ * // Returns: ['design', 'collaboration', 'creative', 'team', 'visual', ...]
+ * ```
+ */
+export declare function extractKeywords(vision: string): string[];
+/**
+ * Get detailed keyword analysis (useful for debugging/testing)
+ *
+ * @param vision - Product vision text
+ * @returns Array of KeywordMatch objects with scores and domains
+ */
+export declare function analyzeKeywords(vision: string): KeywordMatch[];
+//# sourceMappingURL=keyword-extractor.d.ts.map

package/dist/src/init/research/keyword-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyword-extractor.d.ts","sourceRoot":"","sources":["../../../../src/init/research/keyword-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IAEf,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAEhB,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IAEf,uCAAuC;IACvC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAEhB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IAEf,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IAEd,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,aAAa,EAwG1C,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAyExD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,CAwC9D"}