specweave 0.21.1 → 0.21.3

package/dist/src/init/research/keyword-extractor.js

@@ -0,0 +1,230 @@
+/**
+ * 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 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 const DOMAIN_PATTERNS = [
+    // Design & Creative
+    {
+        domain: 'design',
+        pattern: /\b(figma|sketch|canva|adobe|photoshop|illustrator|design|creative|visual|ui|ux|graphics|wireframe|mockup|prototype)\b/gi,
+        weight: 1.5,
+        keywords: ['design', 'creative', 'visual', 'ui', 'ux']
+    },
+    // Collaboration & Teams
+    {
+        domain: 'collaboration',
+        pattern: /\b(team|collaborate|collaboration|remote|together|share|sharing|sync|real-time|concurrent|multiplayer|co-edit)\b/gi,
+        weight: 1.3,
+        keywords: ['collaboration', 'team', 'remote', 'share', 'real-time']
+    },
+    // Productivity & Project Management
+    {
+        domain: 'productivity',
+        pattern: /\b(task|project|manage|management|organize|workflow|productivity|agile|scrum|kanban|backlog|sprint|milestone)\b/gi,
+        weight: 1.2,
+        keywords: ['productivity', 'project', 'task', 'workflow', 'manage']
+    },
+    // SaaS & Cloud
+    {
+        domain: 'saas',
+        pattern: /\b(saas|cloud|platform|service|subscription|software|web-based|online|hosted|infrastructure)\b/gi,
+        weight: 1.1,
+        keywords: ['saas', 'cloud', 'platform', 'service', 'subscription']
+    },
+    // Healthcare & Medical
+    {
+        domain: 'healthcare',
+        pattern: /\b(health|healthcare|medical|patient|hospital|clinic|doctor|physician|nurse|medicine|diagnosis|treatment|hipaa|phi)\b/gi,
+        weight: 1.8,
+        keywords: ['healthcare', 'medical', 'patient', 'health', 'clinical']
+    },
+    // Fintech & Payments
+    {
+        domain: 'fintech',
+        pattern: /\b(payment|payments|finance|financial|banking|transaction|money|invest|investment|crypto|blockchain|wallet|trading)\b/gi,
+        weight: 1.7,
+        keywords: ['fintech', 'payment', 'financial', 'banking', 'transaction']
+    },
+    // E-commerce & Retail
+    {
+        domain: 'ecommerce',
+        pattern: /\b(shop|store|ecommerce|e-commerce|buy|sell|selling|product|products|cart|checkout|marketplace|retail|merchant)\b/gi,
+        weight: 1.4,
+        keywords: ['ecommerce', 'shop', 'store', 'marketplace', 'retail']
+    },
+    // Education & Learning
+    {
+        domain: 'education',
+        pattern: /\b(learn|learning|teach|teaching|student|students|course|courses|education|educational|training|school|university)\b/gi,
+        weight: 1.3,
+        keywords: ['education', 'learning', 'teaching', 'course', 'student']
+    },
+    // Social & Community
+    {
+        domain: 'social',
+        pattern: /\b(social|network|networking|connect|connection|follow|follower|share|post|feed|community|forum|discussion)\b/gi,
+        weight: 1.2,
+        keywords: ['social', 'network', 'community', 'connect', 'share']
+    },
+    // Gaming & Entertainment
+    {
+        domain: 'gaming',
+        pattern: /\b(game|gaming|gamer|play|player|multiplayer|esports|entertainment|streaming|video)\b/gi,
+        weight: 1.1,
+        keywords: ['gaming', 'game', 'entertainment', 'play', 'player']
+    },
+    // IoT & Hardware
+    {
+        domain: 'iot',
+        pattern: /\b(iot|internet-of-things|device|devices|sensor|sensors|hardware|embedded|smart-home|automation)\b/gi,
+        weight: 1.2,
+        keywords: ['iot', 'device', 'sensor', 'hardware', 'automation']
+    },
+    // AI & Machine Learning
+    {
+        domain: 'ai-ml',
+        pattern: /\b(ai|artificial[\s-]intelligence|ml|machine[\s-]learning|neural|deep[\s-]learning|nlp|computer[\s-]vision|predict|prediction|predictive|model|analytics)\b/gi,
+        weight: 1.6,
+        keywords: ['ai', 'machine-learning', 'intelligence', 'prediction', 'model']
+    },
+    // Enterprise & B2B
+    {
+        domain: 'enterprise',
+        pattern: /\b(enterprise|b2b|business|corporate|company|organization|erp|crm|sales|marketing)\b/gi,
+        weight: 1.2,
+        keywords: ['enterprise', 'business', 'corporate', 'b2b', 'organization']
+    }
+];
+/**
+ * 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 function extractKeywords(vision) {
+    if (!vision || vision.trim().length === 0) {
+        throw new Error('Vision text cannot be empty');
+    }
+    // Step 1: Match vision against all domain patterns
+    const matches = [];
+    for (const domainPattern of DOMAIN_PATTERNS) {
+        const regex = new RegExp(domainPattern.pattern);
+        const visionMatches = vision.match(regex);
+        if (visionMatches && visionMatches.length > 0) {
+            // Found matches for this domain
+            const frequency = visionMatches.length;
+            // Add each keyword from this domain with calculated score
+            for (const keyword of domainPattern.keywords) {
+                const score = frequency * domainPattern.weight;
+                matches.push({
+                    keyword,
+                    domain: domainPattern.domain,
+                    score,
+                    frequency
+                });
+            }
+        }
+    }
+    // Step 2: Deduplicate keywords (keep highest score)
+    const deduped = new Map();
+    for (const match of matches) {
+        const existing = deduped.get(match.keyword);
+        if (!existing || match.score > existing.score) {
+            deduped.set(match.keyword, match);
+        }
+    }
+    // Step 3: Sort by score (descending) and take top 10
+    const sorted = Array.from(deduped.values())
+        .sort((a, b) => b.score - a.score)
+        .slice(0, 10);
+    // Step 4: Extract just the keywords
+    const keywords = sorted.map(m => m.keyword);
+    // Step 5: Ensure minimum 3 keywords (Zod schema requirement)
+    if (keywords.length < 3) {
+        // Fallback: extract unique words from vision
+        const words = vision
+            .toLowerCase()
+            .split(/\s+/)
+            .filter(w => w.length > 3) // Only meaningful words
+            .filter((w, i, arr) => arr.indexOf(w) === i); // Unique
+        // Add fallback words until we have at least 3
+        for (const word of words) {
+            if (keywords.length >= 3)
+                break;
+            if (!keywords.includes(word)) {
+                keywords.push(word);
+            }
+        }
+        // Absolute fallback if still not enough
+        while (keywords.length < 3) {
+            keywords.push('product');
+        }
+    }
+    return keywords;
+}
+/**
+ * Get detailed keyword analysis (useful for debugging/testing)
+ *
+ * @param vision - Product vision text
+ * @returns Array of KeywordMatch objects with scores and domains
+ */
+export function analyzeKeywords(vision) {
+    if (!vision || vision.trim().length === 0) {
+        return [];
+    }
+    const matches = [];
+    for (const domainPattern of DOMAIN_PATTERNS) {
+        const regex = new RegExp(domainPattern.pattern);
+        const visionMatches = vision.match(regex);
+        if (visionMatches && visionMatches.length > 0) {
+            const frequency = visionMatches.length;
+            for (const keyword of domainPattern.keywords) {
+                const score = frequency * domainPattern.weight;
+                matches.push({
+                    keyword,
+                    domain: domainPattern.domain,
+                    score,
+                    frequency
+                });
+            }
+        }
+    }
+    // Deduplicate
+    const deduped = new Map();
+    for (const match of matches) {
+        const existing = deduped.get(match.keyword);
+        if (!existing || match.score > existing.score) {
+            deduped.set(match.keyword, match);
+        }
+    }
+    // Sort by score
+    return Array.from(deduped.values()).sort((a, b) => b.score - a.score);
+}
+//# sourceMappingURL=keyword-extractor.js.map

package/dist/src/init/research/keyword-extractor.js.map

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

package/dist/src/init/research/src/config/ConfigManager.d.ts

@@ -0,0 +1,14 @@
+/**
+ * ConfigManager - Unified configuration persistence with Zod validation
+ *
+ * Handles atomic read-modify-write operations for .specweave/config.json
+ * with runtime schema validation using Zod.
+ */
+import { type SpecWeaveConfig, type ResearchConfig } from './types.js';
+export declare class ConfigManager {
+    static readonly CONFIG_PATH = ".specweave/config.json";
+    static load(configPath?: string): Promise<SpecWeaveConfig>;
+    static save(config: SpecWeaveConfig, configPath?: string): Promise<void>;
+    static updateResearch(updates: Partial<ResearchConfig>, configPath?: string): Promise<void>;
+}
+//# sourceMappingURL=ConfigManager.d.ts.map

package/dist/src/init/research/src/config/ConfigManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigManager.d.ts","sourceRoot":"","sources":["../../../../../../src/init/research/src/config/ConfigManager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAA+C,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAEpH,qBAAa,aAAa;IACxB,MAAM,CAAC,QAAQ,CAAC,WAAW,4BAA4B;WAE1C,IAAI,CAAC,UAAU,GAAE,MAAkC,GAAG,OAAO,CAAC,eAAe,CAAC;WAkB9E,IAAI,CAAC,MAAM,EAAE,eAAe,EAAE,UAAU,GAAE,MAAkC,GAAG,OAAO,CAAC,IAAI,CAAC;WAO5F,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,EAAE,UAAU,GAAE,MAAkC,GAAG,OAAO,CAAC,IAAI,CAAC;CAQ7H"}

package/dist/src/init/research/src/config/ConfigManager.js

@@ -0,0 +1,45 @@
+/**
+ * ConfigManager - Unified configuration persistence with Zod validation
+ *
+ * Handles atomic read-modify-write operations for .specweave/config.json
+ * with runtime schema validation using Zod.
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { SpecWeaveConfigSchema, ResearchConfigSchema } from './types.js';
+export class ConfigManager {
+    static async load(configPath = ConfigManager.CONFIG_PATH) {
+        try {
+            const content = await fs.readFile(configPath, 'utf-8');
+            const parsed = JSON.parse(content);
+            return SpecWeaveConfigSchema.parse(parsed);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return {
+                    version: '1.0.0',
+                    project: { name: 'specweave-project', type: 'single' },
+                    research: {},
+                    livingDocs: { enabled: true, baseDir: '.specweave/docs' }
+                };
+            }
+            throw error;
+        }
+    }
+    static async save(config, configPath = ConfigManager.CONFIG_PATH) {
+        const validated = SpecWeaveConfigSchema.parse(config);
+        const dir = path.dirname(configPath);
+        await fs.mkdir(dir, { recursive: true });
+        await fs.writeFile(configPath, JSON.stringify(validated, null, 2), 'utf-8');
+    }
+    static async updateResearch(updates, configPath = ConfigManager.CONFIG_PATH) {
+        const config = await ConfigManager.load(configPath);
+        config.research = { ...config.research, ...updates };
+        if (Object.keys(config.research).length > 0) {
+            ResearchConfigSchema.parse(config.research);
+        }
+        await ConfigManager.save(config, configPath);
+    }
+}
+ConfigManager.CONFIG_PATH = '.specweave/config.json';
+//# sourceMappingURL=ConfigManager.js.map

package/dist/src/init/research/src/config/ConfigManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigManager.js","sourceRoot":"","sources":["../../../../../../src/init/research/src/config/ConfigManager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAA6C,MAAM,YAAY,CAAC;AAEpH,MAAM,OAAO,aAAa;IAGxB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,aAAqB,aAAa,CAAC,WAAW;QAC9D,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACvD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACnC,OAAO,qBAAqB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC5B,OAAO;oBACL,OAAO,EAAE,OAAO;oBAChB,OAAO,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACtD,QAAQ,EAAE,EAAE;oBACZ,UAAU,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,EAAE;iBAC1D,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAuB,EAAE,aAAqB,aAAa,CAAC,WAAW;QACvF,MAAM,SAAS,GAAG,qBAAqB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACtD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACrC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,OAAgC,EAAE,aAAqB,aAAa,CAAC,WAAW;QAC1G,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpD,MAAM,CAAC,QAAQ,GAAG,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,GAAG,OAAO,EAAE,CAAC;QACrD,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,oBAAoB,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC9C,CAAC;QACD,MAAM,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC/C,CAAC;;AAlCe,yBAAW,GAAG,wBAAwB,CAAC"}

package/dist/src/init/research/src/config/types.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Configuration type definitions with Zod schemas
+ */
+import { z } from 'zod';
+export declare const ResearchConfigSchema: z.ZodOptional<z.ZodObject<{
+    vision: z.ZodOptional<z.ZodAny>;
+    compliance: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
+    teams: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
+    repositories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    architecture: z.ZodOptional<z.ZodAny>;
+}, "strip", z.ZodTypeAny, {
+    architecture?: any;
+    repositories?: string[];
+    teams?: any[];
+    vision?: any;
+    compliance?: any[];
+}, {
+    architecture?: any;
+    repositories?: string[];
+    teams?: any[];
+    vision?: any;
+    compliance?: any[];
+}>>;
+export declare const SpecWeaveConfigSchema: z.ZodObject<{
+    version: z.ZodString;
+    project: z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<["single", "multi"]>;
+    }, "strip", z.ZodTypeAny, {
+        name?: string;
+        type?: "single" | "multi";
+    }, {
+        name?: string;
+        type?: "single" | "multi";
+    }>;
+    research: z.ZodOptional<z.ZodObject<{
+        vision: z.ZodOptional<z.ZodAny>;
+        compliance: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
+        teams: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
+        repositories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        architecture: z.ZodOptional<z.ZodAny>;
+    }, "strip", z.ZodTypeAny, {
+        architecture?: any;
+        repositories?: string[];
+        teams?: any[];
+        vision?: any;
+        compliance?: any[];
+    }, {
+        architecture?: any;
+        repositories?: string[];
+        teams?: any[];
+        vision?: any;
+        compliance?: any[];
+    }>>;
+    livingDocs: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodBoolean;
+        baseDir: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        enabled?: boolean;
+        baseDir?: string;
+    }, {
+        enabled?: boolean;
+        baseDir?: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    version?: string;
+    project?: {
+        name?: string;
+        type?: "single" | "multi";
+    };
+    research?: {
+        architecture?: any;
+        repositories?: string[];
+        teams?: any[];
+        vision?: any;
+        compliance?: any[];
+    };
+    livingDocs?: {
+        enabled?: boolean;
+        baseDir?: string;
+    };
+}, {
+    version?: string;
+    project?: {
+        name?: string;
+        type?: "single" | "multi";
+    };
+    research?: {
+        architecture?: any;
+        repositories?: string[];
+        teams?: any[];
+        vision?: any;
+        compliance?: any[];
+    };
+    livingDocs?: {
+        enabled?: boolean;
+        baseDir?: string;
+    };
+}>;
+export type ResearchConfig = z.infer<typeof ResearchConfigSchema>;
+export type SpecWeaveConfig = z.infer<typeof SpecWeaveConfigSchema>;
+//# sourceMappingURL=types.d.ts.map

package/dist/src/init/research/src/config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/init/research/src/config/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;GAMpB,CAAC;AAEd,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWhC,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/src/init/research/src/config/types.js

@@ -0,0 +1,24 @@
+/**
+ * Configuration type definitions with Zod schemas
+ */
+import { z } from 'zod';
+export const ResearchConfigSchema = z.object({
+    vision: z.any().optional(),
+    compliance: z.array(z.any()).optional(),
+    teams: z.array(z.any()).optional(),
+    repositories: z.array(z.string()).optional(),
+    architecture: z.any().optional()
+}).optional();
+export const SpecWeaveConfigSchema = z.object({
+    version: z.string(),
+    project: z.object({
+        name: z.string(),
+        type: z.enum(['single', 'multi'])
+    }),
+    research: ResearchConfigSchema,
+    livingDocs: z.object({
+        enabled: z.boolean(),
+        baseDir: z.string()
+    }).optional()
+});
+//# sourceMappingURL=types.js.map

package/dist/src/init/research/src/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/init/research/src/config/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,MAAM,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC1B,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE;IAClC,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC5C,YAAY,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC,QAAQ,EAAE,CAAC;AAEd,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;KAClC,CAAC;IACF,QAAQ,EAAE,oBAAoB;IAC9B,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;QACnB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;QACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;KACpB,CAAC,CAAC,QAAQ,EAAE;CACd,CAAC,CAAC"}

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

@@ -0,0 +1,183 @@
+/**
+ * Types for Vision & Market Research Engine
+ *
+ * This module defines the core types for analyzing product vision,
+ * detecting market categories, identifying competitors, and calculating
+ * opportunity scores.
+ */
+import { z } from 'zod';
+/**
+ * Market category classification
+ *
+ * 13+ market categories covering common product types
+ */
+export type MarketCategory = 'productivity-saas' | 'healthcare' | 'fintech' | 'e-commerce' | 'education' | 'gaming' | 'social-network' | 'enterprise-b2b' | 'consumer-b2c' | 'marketplace' | 'iot' | 'blockchain' | 'ai-ml' | 'unknown';
+/**
+ * Competitor information
+ */
+export interface Competitor {
+    /** Competitor product name */
+    name: string;
+    /** Product URL (optional) */
+    url?: string;
+    /** Key strengths of the competitor */
+    strengths: string[];
+    /** Key weaknesses or gaps */
+    weaknesses: string[];
+}
+/**
+ * Follow-up question for adaptive questioning
+ */
+export interface Question {
+    /** Question text */
+    question: string;
+    /** Question type (open-ended, multiple-choice, etc.) */
+    type: 'open' | 'multiple-choice' | 'scale';
+    /** Options for multiple-choice questions */
+    options?: string[];
+    /** Why this question is being asked */
+    rationale: string;
+}
+/**
+ * Vision insights extracted from product description
+ *
+ * This is the primary output of the VisionAnalyzer
+ */
+export interface VisionInsights {
+    /** 5-10 domain-specific keywords extracted from vision */
+    keywords: string[];
+    /** Detected market category */
+    market: MarketCategory;
+    /** 3-5 comparable products (competitors) */
+    competitors: Competitor[];
+    /** Market opportunity score (1-10 scale) */
+    opportunityScore: number;
+    /** Whether product has viral growth potential */
+    viralPotential: boolean;
+    /** Adaptive follow-up questions based on vision */
+    followUpQuestions: Question[];
+    /** Confidence score for market detection (0-1) */
+    confidence?: number;
+    /** Raw vision text provided by user */
+    rawVision: string;
+}
+/**
+ * Zod schema for VisionInsights validation
+ */
+export declare const VisionInsightsSchema: z.ZodObject<{
+    keywords: z.ZodArray<z.ZodString, "many">;
+    market: z.ZodEnum<["productivity-saas", "healthcare", "fintech", "e-commerce", "education", "gaming", "social-network", "enterprise-b2b", "consumer-b2c", "marketplace", "iot", "blockchain", "ai-ml", "unknown"]>;
+    competitors: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+        strengths: z.ZodArray<z.ZodString, "many">;
+        weaknesses: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        name?: string;
+        url?: string;
+        strengths?: string[];
+        weaknesses?: string[];
+    }, {
+        name?: string;
+        url?: string;
+        strengths?: string[];
+        weaknesses?: string[];
+    }>, "many">;
+    opportunityScore: z.ZodNumber;
+    viralPotential: z.ZodBoolean;
+    followUpQuestions: z.ZodArray<z.ZodObject<{
+        question: z.ZodString;
+        type: z.ZodEnum<["open", "multiple-choice", "scale"]>;
+        options: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        rationale: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type?: "open" | "multiple-choice" | "scale";
+        options?: string[];
+        question?: string;
+        rationale?: string;
+    }, {
+        type?: "open" | "multiple-choice" | "scale";
+        options?: string[];
+        question?: string;
+        rationale?: string;
+    }>, "many">;
+    confidence: z.ZodOptional<z.ZodNumber>;
+    rawVision: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    keywords?: string[];
+    confidence?: number;
+    market?: "unknown" | "marketplace" | "productivity-saas" | "healthcare" | "fintech" | "e-commerce" | "education" | "gaming" | "social-network" | "enterprise-b2b" | "consumer-b2c" | "iot" | "blockchain" | "ai-ml";
+    competitors?: {
+        name?: string;
+        url?: string;
+        strengths?: string[];
+        weaknesses?: string[];
+    }[];
+    opportunityScore?: number;
+    viralPotential?: boolean;
+    followUpQuestions?: {
+        type?: "open" | "multiple-choice" | "scale";
+        options?: string[];
+        question?: string;
+        rationale?: string;
+    }[];
+    rawVision?: string;
+}, {
+    keywords?: string[];
+    confidence?: number;
+    market?: "unknown" | "marketplace" | "productivity-saas" | "healthcare" | "fintech" | "e-commerce" | "education" | "gaming" | "social-network" | "enterprise-b2b" | "consumer-b2c" | "iot" | "blockchain" | "ai-ml";
+    competitors?: {
+        name?: string;
+        url?: string;
+        strengths?: string[];
+        weaknesses?: string[];
+    }[];
+    opportunityScore?: number;
+    viralPotential?: boolean;
+    followUpQuestions?: {
+        type?: "open" | "multiple-choice" | "scale";
+        options?: string[];
+        question?: string;
+        rationale?: string;
+    }[];
+    rawVision?: string;
+}>;
+/**
+ * Zod schema for Competitor validation
+ */
+export declare const CompetitorSchema: z.ZodObject<{
+    name: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+    strengths: z.ZodArray<z.ZodString, "many">;
+    weaknesses: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    name?: string;
+    url?: string;
+    strengths?: string[];
+    weaknesses?: string[];
+}, {
+    name?: string;
+    url?: string;
+    strengths?: string[];
+    weaknesses?: string[];
+}>;
+/**
+ * Zod schema for Question validation
+ */
+export declare const QuestionSchema: z.ZodObject<{
+    question: z.ZodString;
+    type: z.ZodEnum<["open", "multiple-choice", "scale"]>;
+    options: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    rationale: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type?: "open" | "multiple-choice" | "scale";
+    options?: string[];
+    question?: string;
+    rationale?: string;
+}, {
+    type?: "open" | "multiple-choice" | "scale";
+    options?: string[];
+    question?: string;
+    rationale?: string;
+}>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/init/research/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,MAAM,cAAc,GACtB,mBAAmB,GACnB,YAAY,GACZ,SAAS,GACT,YAAY,GACZ,WAAW,GACX,QAAQ,GACR,gBAAgB,GAChB,gBAAgB,GAChB,cAAc,GACd,aAAa,GACb,KAAK,GACL,YAAY,GACZ,OAAO,GACP,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IAEb,6BAA6B;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,sCAAsC;IACtC,SAAS,EAAE,MAAM,EAAE,CAAC;IAEpB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IAEjB,wDAAwD;IACxD,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,OAAO,CAAC;IAE3C,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB,+BAA+B;IAC/B,MAAM,EAAE,cAAc,CAAC;IAEvB,4CAA4C;IAC5C,WAAW,EAAE,UAAU,EAAE,CAAC;IAE1B,4CAA4C;IAC5C,gBAAgB,EAAE,MAAM,CAAC;IAEzB,iDAAiD;IACjD,cAAc,EAAE,OAAO,CAAC;IAExB,mDAAmD;IACnD,iBAAiB,EAAE,QAAQ,EAAE,CAAC;IAE9B,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsC/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;EAK3B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;EAKzB,CAAC"}