specweave 0.16.7 → 0.16.12

package/dist/src/utils/model-selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-selection.d.ts","sourceRoot":"","sources":["../../../src/utils/model-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEpD,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AA4BD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,IAAI,EACV,OAAO,GAAE;IACP,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;CACtB,GACL,eAAe,CAkGjB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,GAAE;IACP,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;CACtB,GACL,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAS9B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAQxD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAU7D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,eAAe,GAAE,MAAa,GAC7B,MAAM,CASR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,EACvC,oBAAoB,GAAE,MAAa,GAClC;IACD,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB,CAkBA"}

package/dist/src/utils/model-selection.js

@@ -0,0 +1,204 @@
+/**
+ * Model Selection Utilities
+ *
+ * Intelligent model selection for SpecWeave tasks based on complexity,
+ * instruction detail, and task characteristics.
+ *
+ * Strategy:
+ * - Haiku: Detailed instructions, clear acceptance criteria, mechanical work
+ * - Sonnet: Complex decisions, architecture, creative problem-solving
+ * - Opus: Critical architecture, high-stakes decisions (rare)
+ */
+/**
+ * Keywords that suggest complex thinking is required (Sonnet territory)
+ */
+const COMPLEX_KEYWORDS = [
+    'design', 'architecture', 'architect', 'evaluate', 'choose', 'decide',
+    'compare', 'analyze', 'research', 'investigate', 'plan', 'strategy',
+    'refactor', 'optimize', 'tradeoff', 'consider', 'assess', 'review'
+];
+/**
+ * Keywords that suggest simple implementation (Haiku territory)
+ */
+const SIMPLE_KEYWORDS = [
+    'implement', 'create', 'add', 'update', 'fix', 'write', 'install',
+    'configure', 'setup', 'integrate', 'connect', 'deploy', 'build',
+    'test', 'validate', 'document', 'format', 'style', 'lint'
+];
+/**
+ * Keywords that suggest creative/critical work (Sonnet/Opus territory)
+ */
+const CREATIVE_KEYWORDS = [
+    'novel', 'innovative', 'unique', 'creative', 'original', 'new approach',
+    'alternative', 'improve', 'enhance', 'redesign', 'rethink'
+];
+/**
+ * Detects the optimal model for a given task
+ *
+ * @param task - The task to analyze
+ * @param options - Additional context (spec detail level, etc.)
+ * @returns Detection result with model recommendation and reasoning
+ */
+export function detectModelForTask(task, options = {}) {
+    const taskText = `${task.content} ${task.description || ''}`.toLowerCase();
+    // Score-based detection
+    let haikuScore = 0;
+    let sonnetScore = 0;
+    let opusScore = 0;
+    // 1. Keyword analysis
+    COMPLEX_KEYWORDS.forEach(keyword => {
+        if (taskText.includes(keyword)) {
+            sonnetScore += 2;
+        }
+    });
+    SIMPLE_KEYWORDS.forEach(keyword => {
+        if (taskText.includes(keyword)) {
+            haikuScore += 1;
+        }
+    });
+    CREATIVE_KEYWORDS.forEach(keyword => {
+        if (taskText.includes(keyword)) {
+            sonnetScore += 3;
+            opusScore += 1;
+        }
+    });
+    // 2. Spec/plan reference analysis
+    if (task.specReference && options.specDetailLevel && options.specDetailLevel > 0.7) {
+        haikuScore += 3; // Has detailed spec reference
+    }
+    if (options.hasDetailedPlan) {
+        haikuScore += 2; // Implementation approach already defined
+    }
+    if (options.isArchitectural) {
+        sonnetScore += 4; // Architectural decisions need thinking
+        opusScore += 2;
+    }
+    // 3. Acceptance criteria analysis
+    if (task.acceptanceCriteria && task.acceptanceCriteria.length >= 3) {
+        haikuScore += 2; // Clear, specific criteria = can use Haiku
+    }
+    // 4. Priority analysis (P1 might need more careful attention)
+    if (task.priority === 'P1' && !options.hasDetailedPlan) {
+        sonnetScore += 1; // Critical work without plan = need thinking
+    }
+    // 5. Task complexity indicators
+    const hasFileReference = /src\/[a-zA-Z0-9\/\-_.]+\.(ts|js|tsx|jsx|py|java|go)/.test(taskText);
+    if (hasFileReference) {
+        haikuScore += 2; // Specific file paths = concrete instructions
+    }
+    const hasMultipleSteps = taskText.split(/\n|;|,/).length > 3;
+    if (hasMultipleSteps && options.hasDetailedPlan) {
+        haikuScore += 1; // Multi-step with plan = can execute mechanically
+    }
+    // Calculate confidence and select model
+    const totalScore = haikuScore + sonnetScore + opusScore;
+    const haikuConfidence = totalScore > 0 ? haikuScore / totalScore : 0;
+    const sonnetConfidence = totalScore > 0 ? sonnetScore / totalScore : 0;
+    const opusConfidence = totalScore > 0 ? opusScore / totalScore : 0;
+    // Decision logic
+    let selectedModel;
+    let confidence;
+    let reasoning;
+    if (opusScore > 5 && opusConfidence > 0.3) {
+        selectedModel = 'opus';
+        confidence = opusConfidence;
+        reasoning = 'Critical architectural decision requiring deep reasoning';
+    }
+    else if (haikuScore > sonnetScore && haikuConfidence > 0.5) {
+        selectedModel = 'haiku';
+        confidence = haikuConfidence;
+        reasoning = 'Clear instructions with detailed spec/plan - suitable for fast execution';
+    }
+    else if (sonnetScore > haikuScore || sonnetConfidence > 0.4) {
+        selectedModel = 'sonnet';
+        confidence = sonnetConfidence;
+        reasoning = 'Requires decision-making or complex implementation';
+    }
+    else {
+        // Default to sonnet for safety
+        selectedModel = 'sonnet';
+        confidence = 0.5;
+        reasoning = 'Default to sonnet for balanced quality and speed';
+    }
+    return {
+        model: selectedModel,
+        confidence,
+        reasoning
+    };
+}
+/**
+ * Batch detect models for multiple tasks
+ * Useful when generating tasks.md from plan.md
+ */
+export function detectModelsForTasks(tasks, options = {}) {
+    const results = new Map();
+    tasks.forEach(task => {
+        const result = detectModelForTask(task, options);
+        results.set(task.id, result);
+    });
+    return results;
+}
+/**
+ * Format model hint for tasks.md
+ *
+ * @param model - The model tier
+ * @returns Formatted string for inclusion in tasks.md
+ */
+export function formatModelHint(model) {
+    const icons = {
+        haiku: '⚡', // Fast
+        sonnet: '🧠', // Thinking
+        opus: '💎' // Premium
+    };
+    return `${icons[model]} ${model}`;
+}
+/**
+ * Parse model hint from tasks.md line
+ *
+ * @param line - A line from tasks.md
+ * @returns Detected model or null
+ */
+export function parseModelHint(line) {
+    const haikuMatch = /⚡\s*haiku|model:\s*haiku/i.test(line);
+    const sonnetMatch = /🧠\s*sonnet|model:\s*sonnet/i.test(line);
+    const opusMatch = /💎\s*opus|model:\s*opus/i.test(line);
+    if (haikuMatch)
+        return 'haiku';
+    if (sonnetMatch)
+        return 'sonnet';
+    if (opusMatch)
+        return 'opus';
+    return null;
+}
+/**
+ * Cost estimation utilities
+ */
+export function estimateTaskCost(model, estimatedTokens = 2000) {
+    // Approximate costs per 1M tokens (input + output blended)
+    const costPer1M = {
+        haiku: 1.25, // $0.25 input + $1.25 output = ~$1.25 blended
+        sonnet: 15.00, // $3 input + $15 output = ~$15 blended
+        opus: 75.00 // $15 input + $75 output = ~$75 blended
+    };
+    return (estimatedTokens / 1000000) * costPer1M[model];
+}
+/**
+ * Calculate total cost savings when using smart model selection
+ */
+export function calculateCostSavings(tasksWithModels, averageTokensPerTask = 2000) {
+    let optimizedCost = 0;
+    let allSonnetCost = 0;
+    tasksWithModels.forEach((model) => {
+        optimizedCost += estimateTaskCost(model, averageTokensPerTask);
+        allSonnetCost += estimateTaskCost('sonnet', averageTokensPerTask);
+    });
+    const savings = allSonnetCost - optimizedCost;
+    const savingsPercent = (savings / allSonnetCost) * 100;
+    return {
+        optimizedCost,
+        allSonnetCost,
+        savings,
+        savingsPercent
+    };
+}
+//# sourceMappingURL=model-selection.js.map

package/dist/src/utils/model-selection.js.map

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

package/dist/src/utils/plugin-validator.d.ts

@@ -0,0 +1,161 @@
+/**
+ * Plugin Validation System
+ *
+ * Proactively validates SpecWeave plugin installation before workflow commands.
+ * Ensures marketplace is registered, core plugin is installed, and context-specific
+ * plugins are available.
+ *
+ * @module plugin-validator
+ * @since 0.9.4
+ */
+/**
+ * Result of plugin installation attempt
+ */
+export interface InstallResult {
+    success: boolean;
+    component: string;
+    error?: string;
+    details?: string;
+}
+/**
+ * Options for plugin validation
+ */
+export interface ValidationOptions {
+    /** Auto-install missing components (default: false) */
+    autoInstall?: boolean;
+    /** Increment description for context-aware plugin detection */
+    context?: string;
+    /** Show what would be installed without installing (default: false) */
+    dryRun?: boolean;
+    /** Show detailed validation steps (default: false) */
+    verbose?: boolean;
+}
+/**
+ * Result of plugin validation
+ */
+export interface ValidationResult {
+    /** True if all required components are installed */
+    valid: boolean;
+    /** Timestamp of validation */
+    timestamp: number;
+    /** Missing components */
+    missing: {
+        marketplace: boolean;
+        corePlugin: boolean;
+        contextPlugins: string[];
+    };
+    /** Installed components */
+    installed: {
+        corePlugin: boolean;
+        corePluginVersion?: string;
+        contextPlugins: string[];
+    };
+    /** Recommendations for user */
+    recommendations: string[];
+    /** Errors encountered during validation */
+    errors: string[];
+    /** Cache information */
+    cache?: {
+        hit: boolean;
+        age: number;
+    };
+}
+/**
+ * Plugin keyword mappings
+ * Maps plugin names to keywords that should trigger their suggestion
+ * Scoring: 2+ keyword matches = high confidence (plugin suggested)
+ */
+export declare const PLUGIN_KEYWORDS: Record<string, string[]>;
+/**
+ * Plugin Validator
+ *
+ * Validates SpecWeave plugin installation and provides auto-installation
+ * capabilities. Uses caching to minimize validation overhead.
+ */
+export declare class PluginValidator {
+    private cacheFile;
+    private verbose;
+    constructor();
+    /**
+     * Main validation entry point
+     *
+     * @param options - Validation options
+     * @returns Validation result with missing/installed components
+     */
+    validate(options?: ValidationOptions): Promise<ValidationResult>;
+    /**
+     * Check if SpecWeave marketplace is registered
+     *
+     * @returns True if marketplace is registered correctly
+     */
+    checkMarketplace(): Promise<boolean>;
+    /**
+     * Check if core plugin (specweave) is installed
+     *
+     * @returns Plugin installation info
+     */
+    checkCorePlugin(): Promise<{
+        installed: boolean;
+        version?: string;
+    }>;
+    /**
+     * Check if a specific plugin is installed
+     *
+     * @param pluginName - Name of plugin to check
+     * @returns Plugin installation info
+     */
+    checkPlugin(pluginName: string): Promise<{
+        installed: boolean;
+        version?: string;
+    }>;
+    /**
+     * Detect required plugins based on keywords in description
+     *
+     * @param description - Increment description or context
+     * @returns List of required plugin names
+     */
+    detectRequiredPlugins(description: string): string[];
+    /**
+     * Install SpecWeave marketplace
+     *
+     * @returns Installation result
+     */
+    installMarketplace(): Promise<InstallResult>;
+    /**
+     * Install a plugin
+     *
+     * @param pluginName - Name of plugin to install
+     * @returns Installation result
+     */
+    installPlugin(pluginName: string): Promise<InstallResult>;
+    /**
+     * Get cached validation result
+     *
+     * @returns Cached result if valid, null otherwise
+     */
+    private getCachedValidation;
+    /**
+     * Set cached validation result
+     *
+     * @param result - Validation result to cache
+     */
+    private setCachedValidation;
+    /**
+     * Log message if verbose mode enabled
+     */
+    private log;
+}
+/**
+ * Validate plugins (convenience function)
+ *
+ * @param options - Validation options
+ * @returns Validation result
+ */
+export declare function validatePlugins(options?: ValidationOptions): Promise<ValidationResult>;
+/**
+ * Check if SpecWeave is properly installed
+ *
+ * @returns True if marketplace and core plugin are installed
+ */
+export declare function isSpecWeaveInstalled(): Promise<boolean>;
+//# sourceMappingURL=plugin-validator.d.ts.map

package/dist/src/utils/plugin-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-validator.d.ts","sourceRoot":"","sources":["../../../src/utils/plugin-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAcH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,KAAK,EAAE,OAAO,CAAC;IACf,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,OAAO,EAAE;QACP,WAAW,EAAE,OAAO,CAAC;QACrB,UAAU,EAAE,OAAO,CAAC;QACpB,cAAc,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC;IACF,2BAA2B;IAC3B,SAAS,EAAE;QACT,UAAU,EAAE,OAAO,CAAC;QACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,cAAc,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC;IACF,+BAA+B;IAC/B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,2CAA2C;IAC3C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,wBAAwB;IACxB,KAAK,CAAC,EAAE;QACN,GAAG,EAAE,OAAO,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAgCD;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAsHpD,CAAC;AAqBF;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAkB;;IAUjC;;;;;OAKG;IACG,QAAQ,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA0I1E;;;;OAIG;IACG,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;IA4C1C;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC;QAC/B,SAAS,EAAE,OAAO,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IAIF;;;;;OAKG;IACG,WAAW,CACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAsCpD;;;;;OAKG;IACH,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE;IAoBpD;;;;OAIG;IACG,kBAAkB,IAAI,OAAO,CAAC,aAAa,CAAC;IAqClD;;;;;OAKG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA6C/D;;;;OAIG;YACW,mBAAmB;IAsBjC;;;;OAIG;YACW,mBAAmB;IAmBjC;;OAEG;IACH,OAAO,CAAC,GAAG;CAKZ;AAMD;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAG3B;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC,CAI7D"}