clavix 4.12.0 → 5.0.1

package/dist/core/git-manager.d.ts

@@ -1,126 +0,0 @@
-/**
- * GitManager - Manages git auto-commit functionality for task implementation
- *
- * This class handles:
- * - Checking git repository status
- * - Creating commits based on user preferences
- * - Generating commit messages
- * - Handling commit strategies (per task, per phase, per N tasks)
- */
-/**
- * Git commit strategy options
- */
-export type CommitStrategy = 'per-phase' | 'per-5-tasks' | 'per-task' | 'none';
-/**
- * Options for creating a commit
- */
-export interface CommitOptions {
-    message?: string;
-    description?: string;
-    tasks?: string[];
-    phase?: string;
-    projectName?: string;
-}
-/**
- * GitManager class
- *
- * Handles git operations for the implement command
- */
-export declare class GitManager {
-    /**
-     * Check if current directory is a git repository
-     */
-    isGitRepository(): Promise<boolean>;
-    /**
-     * Check if there are uncommitted changes
-     */
-    hasUncommittedChanges(): Promise<boolean>;
-    /**
-     * Create a commit with the given tasks
-     */
-    createCommit(options: CommitOptions): Promise<boolean>;
-    /**
-     * Generate commit message from tasks
-     */
-    private generateCommitMessage;
-    /**
-     * Validate that tasks are marked before committing
-     * This ensures the tasks.md file matches what we expect to commit
-     * @param tasksPath - Path to tasks.md file
-     * @param completedTaskIds - Array of task IDs that should be completed
-     * @returns Validation result with any errors
-     */
-    validateBeforeCommit(tasksPath: string, completedTaskIds: string[]): Promise<{
-        valid: boolean;
-        errors?: string[];
-    }>;
-    /**
-     * Create commit with validation
-     * Validates that tasks are marked before committing
-     * @param options - Commit options
-     * @param tasksPath - Path to tasks.md file
-     * @param completedTaskIds - Array of task IDs that should be completed
-     * @returns Commit result with validation status
-     */
-    createCommitWithValidation(options: CommitOptions, tasksPath?: string, completedTaskIds?: string[]): Promise<{
-        success: boolean;
-        validated: boolean;
-        errors?: string[];
-    }>;
-    /**
-     * Escape commit message for shell
-     */
-    private escapeCommitMessage;
-    /**
-     * Get the current branch name
-     */
-    getCurrentBranch(): Promise<string>;
-    /**
-     * Check if working directory is clean
-     */
-    isWorkingDirectoryClean(): Promise<boolean>;
-    /**
-     * Get short status for display
-     */
-    getStatus(): Promise<string>;
-    /**
-     * Validate git setup before implementing
-     */
-    validateGitSetup(): Promise<{
-        isRepo: boolean;
-        hasChanges: boolean;
-        currentBranch: string;
-    }>;
-}
-/**
- * Helper class to track when to commit based on strategy
- */
-export declare class CommitScheduler {
-    private strategy;
-    private completedTasksInPhase;
-    private completedTasksTotal;
-    private completedTasksSinceLastCommit;
-    private currentPhase;
-    constructor(strategy: CommitStrategy);
-    /**
-     * Mark a task as completed and check if commit should be made
-     */
-    taskCompleted(taskPhase: string): boolean;
-    /**
-     * Mark a phase as completed
-     */
-    phaseCompleted(): boolean;
-    /**
-     * Check if a commit should be made now
-     */
-    private shouldCommit;
-    /**
-     * Reset commit counter (after a commit is made)
-     */
-    resetCommitCounter(): void;
-    /**
-     * Get accumulated task count for commit message
-     */
-    getTaskCountSinceLastCommit(): number;
-}
-//# sourceMappingURL=git-manager.d.ts.map

package/dist/core/git-manager.js

@@ -1,282 +0,0 @@
-/**
- * GitManager - Manages git auto-commit functionality for task implementation
- *
- * This class handles:
- * - Checking git repository status
- * - Creating commits based on user preferences
- * - Generating commit messages
- * - Handling commit strategies (per task, per phase, per N tasks)
- */
-import { exec } from 'child_process';
-import { promisify } from 'util';
-const execAsync = promisify(exec);
-/**
- * GitManager class
- *
- * Handles git operations for the implement command
- */
-export class GitManager {
-    /**
-     * Check if current directory is a git repository
-     */
-    async isGitRepository() {
-        try {
-            await execAsync('git rev-parse --git-dir');
-            return true;
-        }
-        catch {
-            return false;
-        }
-    }
-    /**
-     * Check if there are uncommitted changes
-     */
-    async hasUncommittedChanges() {
-        try {
-            const { stdout } = await execAsync('git status --porcelain');
-            return stdout.trim().length > 0;
-        }
-        catch {
-            return false;
-        }
-    }
-    /**
-     * Create a commit with the given tasks
-     */
-    async createCommit(options) {
-        try {
-            // Check for changes first
-            if (!(await this.hasUncommittedChanges())) {
-                return false; // No changes to commit
-            }
-            // Stage all changes
-            await execAsync('git add .');
-            // Use provided message or generate one
-            const message = options.message ?? this.generateCommitMessage(options);
-            // Create commit
-            await execAsync(`git commit -m "${this.escapeCommitMessage(message)}"`);
-            return true;
-        }
-        catch (error) {
-            // If commit fails, log but don't throw
-            console.error('Git commit failed:', error);
-            return false;
-        }
-    }
-    /**
-     * Generate commit message from tasks
-     */
-    generateCommitMessage(options) {
-        const { description, tasks = [], phase, projectName } = options;
-        let message = '';
-        // Header
-        if (phase) {
-            message += `clavix: ${phase}\n\n`;
-        }
-        else if (description) {
-            message += `clavix: ${description}\n\n`;
-        }
-        else if (tasks.length === 1) {
-            message += `clavix: ${tasks[0]}\n\n`;
-        }
-        else if (tasks.length > 1) {
-            message += `clavix: implement ${tasks.length} tasks\n\n`;
-        }
-        else {
-            message += `clavix: task completed\n\n`;
-        }
-        // Task list (if provided)
-        if (tasks.length > 0) {
-            message += 'Completed tasks:\n';
-            tasks.forEach((task) => {
-                message += `- ${task}\n`;
-            });
-            message += '\n';
-        }
-        // Footer
-        if (projectName) {
-            message += `Project: ${projectName}\n`;
-        }
-        message += 'Generated by Clavix /clavix:implement';
-        return message;
-    }
-    /**
-     * Validate that tasks are marked before committing
-     * This ensures the tasks.md file matches what we expect to commit
-     * @param tasksPath - Path to tasks.md file
-     * @param completedTaskIds - Array of task IDs that should be completed
-     * @returns Validation result with any errors
-     */
-    async validateBeforeCommit(tasksPath, completedTaskIds) {
-        const errors = [];
-        try {
-            // Read tasks.md file
-            const fsExtra = await import('fs-extra');
-            const fs = fsExtra.default || fsExtra;
-            if (!(await fs.pathExists(tasksPath))) {
-                errors.push(`Tasks file not found: ${tasksPath}`);
-                return { valid: false, errors };
-            }
-            const content = await fs.readFile(tasksPath, 'utf-8');
-            // Check each task ID is marked as complete in the file
-            for (const taskId of completedTaskIds) {
-                // Look for the task in the file (should have [x] checkbox)
-                const hasCompleteCheckbox = content.includes(`[x]`) && content.includes(taskId);
-                if (!hasCompleteCheckbox) {
-                    errors.push(`Task ${taskId} not marked as completed in tasks.md`);
-                }
-            }
-            return {
-                valid: errors.length === 0,
-                errors: errors.length > 0 ? errors : undefined,
-            };
-        }
-        catch (error) {
-            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
-            errors.push(`Validation failed: ${errorMessage}`);
-            return { valid: false, errors };
-        }
-    }
-    /**
-     * Create commit with validation
-     * Validates that tasks are marked before committing
-     * @param options - Commit options
-     * @param tasksPath - Path to tasks.md file
-     * @param completedTaskIds - Array of task IDs that should be completed
-     * @returns Commit result with validation status
-     */
-    async createCommitWithValidation(options, tasksPath, completedTaskIds) {
-        // If validation info provided, validate first
-        if (tasksPath && completedTaskIds) {
-            const validation = await this.validateBeforeCommit(tasksPath, completedTaskIds);
-            if (!validation.valid) {
-                return {
-                    success: false,
-                    validated: false,
-                    errors: validation.errors,
-                };
-            }
-        }
-        // Create commit
-        const success = await this.createCommit(options);
-        return {
-            success,
-            validated: tasksPath !== undefined && completedTaskIds !== undefined,
-        };
-    }
-    /**
-     * Escape commit message for shell
-     */
-    escapeCommitMessage(message) {
-        return message.replace(/"/g, '\\"').replace(/\n/g, '\\n');
-    }
-    /**
-     * Get the current branch name
-     */
-    async getCurrentBranch() {
-        try {
-            const { stdout } = await execAsync('git rev-parse --abbrev-ref HEAD');
-            return stdout.trim();
-        }
-        catch {
-            return 'unknown';
-        }
-    }
-    /**
-     * Check if working directory is clean
-     */
-    async isWorkingDirectoryClean() {
-        return !(await this.hasUncommittedChanges());
-    }
-    /**
-     * Get short status for display
-     */
-    async getStatus() {
-        try {
-            const { stdout } = await execAsync('git status --short');
-            return stdout.trim();
-        }
-        catch {
-            return 'Unable to get git status';
-        }
-    }
-    /**
-     * Validate git setup before implementing
-     */
-    async validateGitSetup() {
-        const isRepo = await this.isGitRepository();
-        const hasChanges = await this.hasUncommittedChanges();
-        const currentBranch = isRepo ? await this.getCurrentBranch() : '';
-        return {
-            isRepo,
-            hasChanges,
-            currentBranch,
-        };
-    }
-}
-/**
- * Helper class to track when to commit based on strategy
- */
-export class CommitScheduler {
-    strategy;
-    completedTasksInPhase = 0;
-    completedTasksTotal = 0;
-    completedTasksSinceLastCommit = 0;
-    currentPhase = '';
-    constructor(strategy) {
-        this.strategy = strategy;
-    }
-    /**
-     * Mark a task as completed and check if commit should be made
-     */
-    taskCompleted(taskPhase) {
-        this.completedTasksTotal++;
-        this.completedTasksSinceLastCommit++;
-        if (taskPhase !== this.currentPhase) {
-            this.completedTasksInPhase = 0;
-            this.currentPhase = taskPhase;
-        }
-        this.completedTasksInPhase++;
-        return this.shouldCommit();
-    }
-    /**
-     * Mark a phase as completed
-     */
-    phaseCompleted() {
-        // Reset phase counter
-        this.completedTasksInPhase = 0;
-        // If strategy is per-phase, we should commit
-        return this.strategy === 'per-phase';
-    }
-    /**
-     * Check if a commit should be made now
-     */
-    shouldCommit() {
-        switch (this.strategy) {
-            case 'per-task':
-                return true;
-            case 'per-5-tasks':
-                return this.completedTasksSinceLastCommit >= 5;
-            case 'per-phase':
-                // Will be handled by phaseCompleted()
-                return false;
-            case 'none':
-                return false;
-            default:
-                return false;
-        }
-    }
-    /**
-     * Reset commit counter (after a commit is made)
-     */
-    resetCommitCounter() {
-        this.completedTasksSinceLastCommit = 0;
-    }
-    /**
-     * Get accumulated task count for commit message
-     */
-    getTaskCountSinceLastCommit() {
-        return this.completedTasksSinceLastCommit;
-    }
-}
-//# sourceMappingURL=git-manager.js.map

package/dist/core/intelligence/confidence-calculator.d.ts

@@ -1,93 +0,0 @@
-/**
- * v4.5 Confidence Calculator Utilities
- *
- * Shared utilities for calculating confidence scores across the intelligence system.
- * Provides type-safe confidence values and common calculation patterns.
- */
-/**
- * Confidence level as a percentage (0-100).
- * - 0-49: Low confidence
- * - 50-69: Medium confidence
- * - 70-84: High confidence
- * - 85-100: Very high confidence
- */
-export type ConfidenceLevel = number;
-/**
- * Confidence category for display purposes
- */
-export type ConfidenceCategory = 'low' | 'medium' | 'high' | 'very-high';
-/**
- * Confidence result with category and percentage
- */
-export interface ConfidenceResult {
-    percentage: ConfidenceLevel;
-    category: ConfidenceCategory;
-}
-export declare const CONFIDENCE_THRESHOLDS: {
-    readonly LOW_MAX: 49;
-    readonly MEDIUM_MAX: 69;
-    readonly HIGH_MAX: 84;
-    readonly VERY_HIGH_MIN: 85;
-};
-/**
- * Clamp a confidence value to valid range (0-100)
- */
-export declare function clampConfidence(value: number): ConfidenceLevel;
-/**
- * Get confidence category from percentage
- */
-export declare function getConfidenceCategory(percentage: ConfidenceLevel): ConfidenceCategory;
-/**
- * Create a confidence result from a percentage
- */
-export declare function createConfidenceResult(percentage: number): ConfidenceResult;
-/**
- * Calculate additive confidence based on presence of elements.
- * Common pattern: base + bonus for each element present.
- *
- * @example
- * calculateAdditiveConfidence(50, [
- *   [hasRequirements, 20],
- *   [hasGoals, 15],
- *   [hasConstraints, 15],
- * ]);
- */
-export declare function calculateAdditiveConfidence(baseConfidence: number, bonuses: Array<[boolean, number]>): ConfidenceLevel;
-/**
- * Calculate ratio-based confidence.
- * Common pattern: primary score as percentage of total score.
- *
- * @example
- * calculateRatioConfidence(primaryScore, totalScore);
- */
-export declare function calculateRatioConfidence(primaryScore: number, totalScore: number, options?: {
-    minConfidence?: number;
-    fallbackConfidence?: number;
-}): ConfidenceLevel;
-/**
- * Apply confidence penalty when competing scores are close.
- * Common pattern: reduce confidence when there's ambiguity.
- *
- * @example
- * applyCompetitionPenalty(confidence, primaryScore, secondaryScore, {
- *   threshold: 0.15,
- *   penalty: 15,
- *   minConfidence: 60,
- * });
- */
-export declare function applyCompetitionPenalty(confidence: number, primaryScore: number, secondaryScore: number, options?: {
-    threshold?: number;
-    penalty?: number;
-    minConfidence?: number;
-}): ConfidenceLevel;
-/**
- * Calculate weighted average confidence from multiple sources.
- *
- * @example
- * calculateWeightedConfidence([
- *   [intentConfidence, 0.6],
- *   [qualityConfidence, 0.4],
- * ]);
- */
-export declare function calculateWeightedConfidence(scores: Array<[number, number]>): ConfidenceLevel;
-//# sourceMappingURL=confidence-calculator.d.ts.map

package/dist/core/intelligence/confidence-calculator.js

@@ -1,124 +0,0 @@
-/**
- * v4.5 Confidence Calculator Utilities
- *
- * Shared utilities for calculating confidence scores across the intelligence system.
- * Provides type-safe confidence values and common calculation patterns.
- */
-// ============================================================================
-// Thresholds
-// ============================================================================
-export const CONFIDENCE_THRESHOLDS = {
-    LOW_MAX: 49,
-    MEDIUM_MAX: 69,
-    HIGH_MAX: 84,
-    VERY_HIGH_MIN: 85,
-};
-// ============================================================================
-// Utility Functions
-// ============================================================================
-/**
- * Clamp a confidence value to valid range (0-100)
- */
-export function clampConfidence(value) {
-    return Math.min(100, Math.max(0, Math.round(value)));
-}
-/**
- * Get confidence category from percentage
- */
-export function getConfidenceCategory(percentage) {
-    if (percentage <= CONFIDENCE_THRESHOLDS.LOW_MAX)
-        return 'low';
-    if (percentage <= CONFIDENCE_THRESHOLDS.MEDIUM_MAX)
-        return 'medium';
-    if (percentage <= CONFIDENCE_THRESHOLDS.HIGH_MAX)
-        return 'high';
-    return 'very-high';
-}
-/**
- * Create a confidence result from a percentage
- */
-export function createConfidenceResult(percentage) {
-    const clamped = clampConfidence(percentage);
-    return {
-        percentage: clamped,
-        category: getConfidenceCategory(clamped),
-    };
-}
-// ============================================================================
-// Calculation Patterns
-// ============================================================================
-/**
- * Calculate additive confidence based on presence of elements.
- * Common pattern: base + bonus for each element present.
- *
- * @example
- * calculateAdditiveConfidence(50, [
- *   [hasRequirements, 20],
- *   [hasGoals, 15],
- *   [hasConstraints, 15],
- * ]);
- */
-export function calculateAdditiveConfidence(baseConfidence, bonuses) {
-    let total = baseConfidence;
-    for (const [condition, bonus] of bonuses) {
-        if (condition) {
-            total += bonus;
-        }
-    }
-    return clampConfidence(total);
-}
-/**
- * Calculate ratio-based confidence.
- * Common pattern: primary score as percentage of total score.
- *
- * @example
- * calculateRatioConfidence(primaryScore, totalScore);
- */
-export function calculateRatioConfidence(primaryScore, totalScore, options = {}) {
-    const { minConfidence = 0, fallbackConfidence = 50 } = options;
-    if (totalScore === 0) {
-        return fallbackConfidence;
-    }
-    const ratio = primaryScore / totalScore;
-    const percentage = Math.round(ratio * 100);
-    return clampConfidence(Math.max(minConfidence, percentage));
-}
-/**
- * Apply confidence penalty when competing scores are close.
- * Common pattern: reduce confidence when there's ambiguity.
- *
- * @example
- * applyCompetitionPenalty(confidence, primaryScore, secondaryScore, {
- *   threshold: 0.15,
- *   penalty: 15,
- *   minConfidence: 60,
- * });
- */
-export function applyCompetitionPenalty(confidence, primaryScore, secondaryScore, options = {}) {
-    const { threshold = 0.15, penalty = 15, minConfidence = 60 } = options;
-    const difference = primaryScore - secondaryScore;
-    // If scores are within threshold, apply penalty
-    if (primaryScore > 0 && difference < primaryScore * threshold) {
-        return clampConfidence(Math.max(minConfidence, confidence - penalty));
-    }
-    return clampConfidence(confidence);
-}
-/**
- * Calculate weighted average confidence from multiple sources.
- *
- * @example
- * calculateWeightedConfidence([
- *   [intentConfidence, 0.6],
- *   [qualityConfidence, 0.4],
- * ]);
- */
-export function calculateWeightedConfidence(scores // [confidence, weight]
-) {
-    const totalWeight = scores.reduce((sum, [, weight]) => sum + weight, 0);
-    if (totalWeight === 0) {
-        return 50;
-    }
-    const weightedSum = scores.reduce((sum, [confidence, weight]) => sum + confidence * weight, 0);
-    return clampConfidence(weightedSum / totalWeight);
-}
-//# sourceMappingURL=confidence-calculator.js.map

package/dist/core/intelligence/index.d.ts

@@ -1,11 +0,0 @@
-export { UniversalOptimizer } from './universal-optimizer.js';
-export { IntentDetector } from './intent-detector.js';
-export { PatternLibrary } from './pattern-library.js';
-export { QualityAssessor } from './quality-assessor.js';
-export * from './types.js';
-export * from './confidence-calculator.js';
-export { BasePattern } from './patterns/base-pattern.js';
-export { ConcisenessFilter } from './patterns/conciseness-filter.js';
-export { ObjectiveClarifier } from './patterns/objective-clarifier.js';
-export { TechnicalContextEnricher } from './patterns/technical-context-enricher.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/core/intelligence/index.js

@@ -1,15 +0,0 @@
-// Main exports for the Clavix Intelligence system
-export { UniversalOptimizer } from './universal-optimizer.js';
-export { IntentDetector } from './intent-detector.js';
-export { PatternLibrary } from './pattern-library.js';
-export { QualityAssessor } from './quality-assessor.js';
-// Type exports
-export * from './types.js';
-// v4.5: Confidence calculation utilities
-export * from './confidence-calculator.js';
-// Pattern exports
-export { BasePattern } from './patterns/base-pattern.js';
-export { ConcisenessFilter } from './patterns/conciseness-filter.js';
-export { ObjectiveClarifier } from './patterns/objective-clarifier.js';
-export { TechnicalContextEnricher } from './patterns/technical-context-enricher.js';
-//# sourceMappingURL=index.js.map