specweave 0.21.1 → 0.21.3

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

@@ -0,0 +1,194 @@
+/**
+ * Opportunity Score Calculator
+ *
+ * Calculates market opportunity score (1-10 scale) based on:
+ * - Market size estimate
+ * - Competition density
+ * - Viral potential
+ * - Innovation factor
+ *
+ * **Formula**:
+ * score = (marketSize / 10) - (competitionDensity / 2) + viralBonus + innovationBonus
+ * Clamped to 1-10 range
+ *
+ * **Benefits**:
+ * - Algorithmic calculation (no LLM needed)
+ * - Transparent scoring logic
+ * - Deterministic and testable
+ */
+/**
+ * Market size estimates by category (1-10 scale)
+ *
+ * Based on general market research and industry reports
+ */
+const MARKET_SIZE_ESTIMATES = {
+    'productivity-saas': 8, // Large and growing
+    'healthcare': 10, // Massive market
+    'fintech': 9, // Very large market
+    'e-commerce': 9, // Huge market
+    'education': 8, // Large market
+    'gaming': 7, // Large but competitive
+    'social-network': 6, // Saturated market
+    'enterprise-b2b': 8, // Large market
+    'consumer-b2c': 7, // Moderate market
+    'marketplace': 7, // Good market
+    'iot': 6, // Growing market
+    'blockchain': 5, // Emerging market
+    'ai-ml': 9, // Very large market
+    'unknown': 5 // Default
+};
+/**
+ * Competition density estimates by category (1-10 scale)
+ *
+ * Higher = more competitive
+ */
+const COMPETITION_DENSITY = {
+    'productivity-saas': 8, // Very competitive
+    'healthcare': 6, // Moderate (high barriers)
+    'fintech': 7, // High competition
+    'e-commerce': 9, // Extremely competitive
+    'education': 7, // High competition
+    'gaming': 8, // Very competitive
+    'social-network': 10, // Extremely competitive
+    'enterprise-b2b': 6, // Moderate
+    'consumer-b2c': 8, // Very competitive
+    'marketplace': 8, // Very competitive
+    'iot': 5, // Moderate
+    'blockchain': 6, // Moderate (niche)
+    'ai-ml': 7, // High competition
+    'unknown': 5 // Default
+};
+/**
+ * Calculate market opportunity score
+ *
+ * @param marketCategory - Detected market category
+ * @param competitorCount - Number of direct competitors identified
+ * @param viralPotential - Whether product has viral growth potential
+ * @param innovationFactor - Innovation score (0-1) based on uniqueness
+ * @returns Opportunity score (1-10) with rationale
+ *
+ * @example
+ * ```typescript
+ * const result = calculateOpportunityScore('productivity-saas', 5, true, 0.7);
+ * // Returns: { score: 7, rationale: '...' }
+ * ```
+ */
+export function calculateOpportunityScore(marketCategory, competitorCount, viralPotential, innovationFactor = 0.5) {
+    // Get market size and competition for this category
+    const marketSize = MARKET_SIZE_ESTIMATES[marketCategory] || 5;
+    const competitionBase = COMPETITION_DENSITY[marketCategory] || 5;
+    // Adjust competition based on competitor count
+    // More competitors = higher competition
+    const competitionAdjustment = Math.min(competitorCount * 0.5, 3);
+    const competition = Math.min(competitionBase + competitionAdjustment, 10);
+    // Calculate base score
+    let score = (marketSize / 10) * 10 - (competition / 2);
+    // Viral bonus (+2 points)
+    const viralBonus = viralPotential ? 2 : 0;
+    score += viralBonus;
+    // Innovation bonus (0-2 points based on innovation factor)
+    const innovationBonus = innovationFactor * 2;
+    score += innovationBonus;
+    // Clamp to 1-10 range
+    score = Math.max(1, Math.min(10, score));
+    // Round to 1 decimal place
+    score = Math.round(score * 10) / 10;
+    // Generate rationale
+    const rationale = generateRationale(marketCategory, marketSize, competition, viralPotential, innovationFactor, score);
+    return {
+        score,
+        rationale,
+        breakdown: {
+            marketSize,
+            competition,
+            viral: viralBonus,
+            innovation: innovationBonus
+        }
+    };
+}
+/**
+ * Generate human-readable rationale for the score
+ */
+function generateRationale(category, marketSize, competition, viral, innovation, finalScore) {
+    const parts = [];
+    // Market size assessment
+    if (marketSize >= 8) {
+        parts.push('Large market size');
+    }
+    else if (marketSize >= 6) {
+        parts.push('Moderate market size');
+    }
+    else {
+        parts.push('Emerging market');
+    }
+    // Competition assessment
+    if (competition >= 8) {
+        parts.push('highly competitive landscape');
+    }
+    else if (competition >= 6) {
+        parts.push('moderate competition');
+    }
+    else {
+        parts.push('low competition');
+    }
+    // Viral potential
+    if (viral) {
+        parts.push('viral growth potential');
+    }
+    // Innovation
+    if (innovation >= 0.7) {
+        parts.push('high innovation factor');
+    }
+    else if (innovation >= 0.4) {
+        parts.push('moderate innovation');
+    }
+    // Overall assessment
+    let assessment;
+    if (finalScore >= 8) {
+        assessment = 'Strong opportunity';
+    }
+    else if (finalScore >= 6) {
+        assessment = 'Good opportunity';
+    }
+    else if (finalScore >= 4) {
+        assessment = 'Moderate opportunity';
+    }
+    else {
+        assessment = 'Challenging opportunity';
+    }
+    return `${assessment}: ${parts.join(', ')}.`;
+}
+/**
+ * Estimate innovation factor from keywords and competitors
+ *
+ * Innovation factor is based on:
+ * - Unique keyword combinations
+ * - Number of competitors (fewer = more innovative)
+ * - Presence of emerging tech keywords
+ *
+ * @param keywords - Product keywords
+ * @param competitorCount - Number of competitors
+ * @returns Innovation score (0-1)
+ */
+export function estimateInnovationFactor(keywords, competitorCount) {
+    let score = 0.5; // Start at moderate
+    // Fewer competitors suggests more innovation
+    if (competitorCount === 0) {
+        score += 0.3;
+    }
+    else if (competitorCount <= 2) {
+        score += 0.2;
+    }
+    else if (competitorCount <= 5) {
+        score += 0.1;
+    }
+    // Emerging tech keywords boost innovation
+    const emergingTech = ['ai', 'machine-learning', 'blockchain', 'crypto', 'web3', 'ar', 'vr'];
+    const hasEmergingTech = keywords.some(k => emergingTech.some(tech => k.toLowerCase().includes(tech)));
+    if (hasEmergingTech) {
+        score += 0.2;
+    }
+    // Clamp to 0-1
+    return Math.max(0, Math.min(1, score));
+}
+//# sourceMappingURL=OpportunityScorer.js.map

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

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

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

@@ -0,0 +1,68 @@
+/**
+ * Adaptive Question Generator
+ *
+ * Generates context-aware follow-up questions based on product vision,
+ * market category, and detected patterns.
+ *
+ * **Approach**:
+ * 1. Analyze vision insights (market, viral potential, etc.)
+ * 2. Select relevant question templates
+ * 3. Return 2-3 adaptive questions max
+ * 4. Prioritize most impactful questions
+ *
+ * **Benefits**:
+ * - Context-aware questioning
+ * - Progressive disclosure (not overwhelming)
+ * - Deterministic and testable
+ */
+import { MarketCategory, Question } from './types.js';
+/**
+ * Context for generating questions
+ */
+export interface QuestionContext {
+    /** Detected market category */
+    marketCategory: MarketCategory;
+    /** Viral growth potential */
+    viralPotential: boolean;
+    /** Opportunity score (1-10) */
+    opportunityScore: number;
+    /** Extracted keywords */
+    keywords: string[];
+    /** Number of competitors */
+    competitorCount: number;
+}
+/**
+ * Generate adaptive follow-up questions based on vision insights
+ *
+ * Selects the most relevant 2-3 questions based on context,
+ * sorted by priority.
+ *
+ * @param context - Question generation context
+ * @param maxQuestions - Maximum questions to return (default: 3)
+ * @returns Array of adaptive questions
+ *
+ * @example
+ * ```typescript
+ * const questions = generateFollowUpQuestions({
+ *   marketCategory: 'healthcare',
+ *   viralPotential: false,
+ *   opportunityScore: 7,
+ *   keywords: ['health', 'medical', 'patient'],
+ *   competitorCount: 3
+ * });
+ * // Returns healthcare-specific compliance and region questions
+ * ```
+ */
+export declare function generateFollowUpQuestions(context: QuestionContext, maxQuestions?: number): Question[];
+/**
+ * Get all potential questions with their priorities (useful for debugging)
+ *
+ * @param context - Question generation context
+ * @returns Array of questions with priorities and conditions
+ */
+export declare function analyzeQuestions(context: QuestionContext): Array<{
+    question: Question;
+    priority: number;
+    applicable: boolean;
+}>;
+//# sourceMappingURL=QuestionGenerator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"QuestionGenerator.d.ts","sourceRoot":"","sources":["../../../../src/init/research/QuestionGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAgBtD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,+BAA+B;IAC/B,cAAc,EAAE,cAAc,CAAC;IAE/B,6BAA6B;IAC7B,cAAc,EAAE,OAAO,CAAC;IAExB,+BAA+B;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IAEzB,yBAAyB;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB,4BAA4B;IAC5B,eAAe,EAAE,MAAM,CAAC;CACzB;AAmMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,eAAe,EACxB,YAAY,GAAE,MAAU,GACvB,QAAQ,EAAE,CAeZ;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,KAAK,CAAC;IAChE,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC,CAMD"}

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

@@ -0,0 +1,244 @@
+/**
+ * Adaptive Question Generator
+ *
+ * Generates context-aware follow-up questions based on product vision,
+ * market category, and detected patterns.
+ *
+ * **Approach**:
+ * 1. Analyze vision insights (market, viral potential, etc.)
+ * 2. Select relevant question templates
+ * 3. Return 2-3 adaptive questions max
+ * 4. Prioritize most impactful questions
+ *
+ * **Benefits**:
+ * - Context-aware questioning
+ * - Progressive disclosure (not overwhelming)
+ * - Deterministic and testable
+ */
+/**
+ * Question templates organized by context
+ *
+ * Each template has:
+ * - Condition: When to ask this question
+ * - Generator: How to build the question
+ * - Priority: How important this question is
+ */
+const QUESTION_TEMPLATES = [
+    // Viral Potential → Ask about scaling and growth
+    {
+        condition: (ctx) => ctx.viralPotential,
+        priority: 10,
+        generate: () => ({
+            question: 'What are your expected user growth targets in the first 6 months?',
+            type: 'multiple-choice',
+            options: [
+                '< 1,000 users (slow growth)',
+                '1K - 10K users (moderate growth)',
+                '10K - 100K users (viral growth)',
+                '100K+ users (explosive growth)'
+            ],
+            rationale: 'Understanding growth expectations helps recommend scalable architecture (serverless vs traditional).'
+        })
+    },
+    // Viral Potential → Ask about viral mechanisms
+    {
+        condition: (ctx) => ctx.viralPotential,
+        priority: 9,
+        generate: () => ({
+            question: 'How will users discover and share your product?',
+            type: 'multiple-choice',
+            options: [
+                'Social sharing (built-in share features)',
+                'Network effects (more users = more value)',
+                'User-generated content',
+                'Referral program',
+                'Paid advertising'
+            ],
+            rationale: 'Viral mechanisms influence product architecture and feature priorities.'
+        })
+    },
+    // Enterprise/Healthcare → Ask about compliance
+    {
+        condition: (ctx) => ctx.marketCategory === 'enterprise-b2b' ||
+            ctx.marketCategory === 'healthcare',
+        priority: 10,
+        generate: (ctx) => ({
+            question: `Will you handle sensitive data? (${ctx.marketCategory === 'healthcare' ? 'PHI, medical records' : 'confidential business data'})`,
+            type: 'multiple-choice',
+            options: [
+                'Yes - Healthcare data (PHI)',
+                'Yes - Payment data (PCI)',
+                'Yes - Personal data (GDPR/CCPA)',
+                'Yes - Government data (FedRAMP)',
+                'No sensitive data'
+            ],
+            rationale: 'Compliance requirements determine architecture, team structure, and costs.'
+        })
+    },
+    // Healthcare specific
+    {
+        condition: (ctx) => ctx.marketCategory === 'healthcare',
+        priority: 9,
+        generate: () => ({
+            question: 'What regions will your healthcare product operate in?',
+            type: 'multiple-choice',
+            options: [
+                'United States only (HIPAA)',
+                'European Union (GDPR + local)',
+                'Global (multiple compliance standards)',
+                'Not decided yet'
+            ],
+            rationale: 'Regional compliance affects team requirements and infrastructure choices.'
+        })
+    },
+    // Fintech specific
+    {
+        condition: (ctx) => ctx.marketCategory === 'fintech',
+        priority: 10,
+        generate: () => ({
+            question: 'How will you handle payments and financial data?',
+            type: 'multiple-choice',
+            options: [
+                'Use Stripe/PayPal (outsource PCI compliance)',
+                'Build in-house (full PCI-DSS compliance)',
+                'Hybrid (some in-house, some third-party)',
+                'Not decided yet'
+            ],
+            rationale: 'Payment handling determines compliance overhead and team requirements.'
+        })
+    },
+    // High competition → Ask about differentiation
+    {
+        condition: (ctx) => ctx.competitorCount >= 5,
+        priority: 8,
+        generate: () => ({
+            question: 'What makes your product different from existing competitors?',
+            type: 'open',
+            rationale: 'Understanding differentiation helps identify unique technical requirements.'
+        })
+    },
+    // Low competition → Ask about barriers
+    {
+        condition: (ctx) => ctx.competitorCount <= 2,
+        priority: 7,
+        generate: () => ({
+            question: 'Why do you think this market is underserved?',
+            type: 'open',
+            rationale: 'Understanding market gaps helps validate opportunity and identify technical challenges.'
+        })
+    },
+    // B2C/Consumer → Ask about monetization
+    {
+        condition: (ctx) => ctx.marketCategory === 'consumer-b2c' ||
+            ctx.marketCategory === 'social-network',
+        priority: 7,
+        generate: () => ({
+            question: 'How will you monetize your product?',
+            type: 'multiple-choice',
+            options: [
+                'Freemium (free tier + paid upgrades)',
+                'Subscription (monthly/annual)',
+                'Advertising',
+                'Transaction fees',
+                'Not decided yet'
+            ],
+            rationale: 'Monetization strategy affects feature priorities and infrastructure needs.'
+        })
+    },
+    // Enterprise → Ask about team size
+    {
+        condition: (ctx) => ctx.marketCategory === 'enterprise-b2b',
+        priority: 8,
+        generate: () => ({
+            question: 'How large is your target customer organization?',
+            type: 'multiple-choice',
+            options: [
+                'Small businesses (< 50 employees)',
+                'Mid-market (50-500 employees)',
+                'Enterprise (500-5000 employees)',
+                'Large enterprise (5000+ employees)'
+            ],
+            rationale: 'Customer size affects feature complexity, compliance needs, and support requirements.'
+        })
+    },
+    // Default → Ask about timeline
+    {
+        condition: () => true, // Always applicable
+        priority: 5,
+        generate: () => ({
+            question: 'What is your target launch timeline?',
+            type: 'multiple-choice',
+            options: [
+                'MVP in 1-3 months',
+                'Beta in 3-6 months',
+                'Full launch in 6-12 months',
+                'Longer than 1 year'
+            ],
+            rationale: 'Timeline affects technology choices and architectural decisions (YAGNI vs future-proof).'
+        })
+    },
+    // Default → Ask about budget
+    {
+        condition: () => true,
+        priority: 6,
+        generate: () => ({
+            question: 'What is your development approach?',
+            type: 'multiple-choice',
+            options: [
+                'Bootstrapped (self-funded)',
+                'Pre-seed / Angel funded',
+                'Seed / Series A funded',
+                'Series B+ funded',
+                'Learning project (non-commercial)'
+            ],
+            rationale: 'Funding stage affects architecture recommendations and cloud credit eligibility.'
+        })
+    }
+];
+/**
+ * Generate adaptive follow-up questions based on vision insights
+ *
+ * Selects the most relevant 2-3 questions based on context,
+ * sorted by priority.
+ *
+ * @param context - Question generation context
+ * @param maxQuestions - Maximum questions to return (default: 3)
+ * @returns Array of adaptive questions
+ *
+ * @example
+ * ```typescript
+ * const questions = generateFollowUpQuestions({
+ *   marketCategory: 'healthcare',
+ *   viralPotential: false,
+ *   opportunityScore: 7,
+ *   keywords: ['health', 'medical', 'patient'],
+ *   competitorCount: 3
+ * });
+ * // Returns healthcare-specific compliance and region questions
+ * ```
+ */
+export function generateFollowUpQuestions(context, maxQuestions = 3) {
+    // Filter templates based on conditions
+    const applicable = QUESTION_TEMPLATES.filter(template => template.condition(context));
+    // Sort by priority (descending)
+    applicable.sort((a, b) => b.priority - a.priority);
+    // Take top N and generate questions
+    const questions = applicable
+        .slice(0, maxQuestions)
+        .map(template => template.generate(context));
+    return questions;
+}
+/**
+ * Get all potential questions with their priorities (useful for debugging)
+ *
+ * @param context - Question generation context
+ * @returns Array of questions with priorities and conditions
+ */
+export function analyzeQuestions(context) {
+    return QUESTION_TEMPLATES.map(template => ({
+        question: template.generate(context),
+        priority: template.priority,
+        applicable: template.condition(context)
+    })).sort((a, b) => b.priority - a.priority);
+}
+//# sourceMappingURL=QuestionGenerator.js.map

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

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

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

@@ -0,0 +1,36 @@
+/**
+ * Market Research Report Generator
+ *
+ * Generates markdown reports summarizing vision analysis results.
+ */
+import type { VisionInsights } from './types.js';
+/**
+ * ReportGenerator - Generates market research reports
+ *
+ * **Usage**:
+ * ```typescript
+ * await ReportGenerator.generate(insights);
+ * // Creates .specweave/reports/market-research.md
+ * ```
+ */
+export declare class ReportGenerator {
+    /**
+     * Default report path
+     */
+    private static readonly REPORT_PATH;
+    /**
+     * Generate market research report
+     *
+     * @param insights - Vision insights to include in report
+     * @param reportPath - Optional custom report path
+     */
+    static generate(insights: VisionInsights, reportPath?: string): Promise<void>;
+    /**
+     * Create markdown content from insights
+     *
+     * @param insights - Vision insights
+     * @returns Markdown string
+     */
+    private static createMarkdown;
+}
+//# sourceMappingURL=ReportGenerator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ReportGenerator.d.ts","sourceRoot":"","sources":["../../../../src/init/research/ReportGenerator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAC1B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAA2C;IAE9E;;;;;OAKG;WACU,QAAQ,CACnB,QAAQ,EAAE,cAAc,EACxB,UAAU,GAAE,MAAoC,GAC/C,OAAO,CAAC,IAAI,CAAC;IAWhB;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;CA+F9B"}