@compilr-dev/cli 0.4.0 → 0.5.1

package/dist/utils/model-tiers.js

@@ -1,48 +1,69 @@
 /**
- * Model Tier Detection
+ * Model Tier Detection (Capability Tiers)
  *
  * Categorizes LLM models by capability tier (small/medium/large)
  * and provides upgrade suggestions within the same provider.
  *
  * Used by commands like /design to warn users about model limitations
  * and suggest alternatives.
+ *
+ * NOTE: This is SEPARATE from the model registry in src/models/model-registry.ts.
+ * - Registry: Model metadata, selection UI, speed tiers (fast/balanced/powerful)
+ * - This file: Command capability requirements (small/medium/large)
+ *
+ * When adding new models to the registry, also update this file if the model
+ * should be recognized for capability tier detection.
  */
 // =============================================================================
 // Model Tier Mappings
 // =============================================================================
 const MODEL_TIERS = {
-    // Claude (Anthropic)
+    // Claude (Anthropic) - 4.5 series (current)
+    'claude-opus-4-5': { tier: 'large', provider: 'anthropic' },
+    'claude-sonnet-4-5': { tier: 'large', provider: 'anthropic' },
+    'claude-haiku-4-5': { tier: 'medium', provider: 'anthropic', suggestedUpgrade: 'claude-sonnet-4-5-20250929' },
+    // Claude legacy (for backward compatibility)
     'claude-3-opus': { tier: 'large', provider: 'anthropic' },
     'claude-opus-4': { tier: 'large', provider: 'anthropic' },
     'claude-sonnet-4': { tier: 'large', provider: 'anthropic' },
     'claude-3-5-sonnet': { tier: 'large', provider: 'anthropic' },
-    'claude-3-sonnet': { tier: 'large', provider: 'anthropic' },
-    'claude-3-5-haiku': { tier: 'medium', provider: 'anthropic', suggestedUpgrade: 'claude-sonnet-4-20250514' },
-    'claude-3-haiku': { tier: 'medium', provider: 'anthropic', suggestedUpgrade: 'claude-sonnet-4-20250514' },
-    // OpenAI
+    'claude-3-5-haiku': { tier: 'medium', provider: 'anthropic', suggestedUpgrade: 'claude-sonnet-4-5-20250929' },
+    'claude-3-haiku': { tier: 'medium', provider: 'anthropic', suggestedUpgrade: 'claude-sonnet-4-5-20250929' },
+    // OpenAI - GPT-5 series (current)
+    'gpt-5.2': { tier: 'large', provider: 'openai' },
+    'gpt-5-mini': { tier: 'large', provider: 'openai' },
+    'gpt-5-nano': { tier: 'medium', provider: 'openai', suggestedUpgrade: 'gpt-5-mini-2025-08-07' },
+    // OpenAI legacy (for backward compatibility)
     'gpt-4o': { tier: 'large', provider: 'openai' },
     'gpt-4-turbo': { tier: 'large', provider: 'openai' },
     'gpt-4': { tier: 'large', provider: 'openai' },
-    'gpt-4o-mini': { tier: 'medium', provider: 'openai', suggestedUpgrade: 'gpt-4o' },
-    'gpt-3.5-turbo': { tier: 'small', provider: 'openai', suggestedUpgrade: 'gpt-4o-mini' },
+    'gpt-4o-mini': { tier: 'medium', provider: 'openai', suggestedUpgrade: 'gpt-5-mini-2025-08-07' },
+    'gpt-3.5-turbo': { tier: 'small', provider: 'openai', suggestedUpgrade: 'gpt-5-nano-2025-08-07' },
     'o1': { tier: 'large', provider: 'openai' },
     'o1-mini': { tier: 'medium', provider: 'openai', suggestedUpgrade: 'o1' },
-    'o1-preview': { tier: 'large', provider: 'openai' },
-    // Google (Gemini)
-    'gemini-1.5-pro': { tier: 'large', provider: 'google' },
-    'gemini-2.0-flash': { tier: 'large', provider: 'google' },
+    'o3': { tier: 'large', provider: 'openai' },
+    'o4-mini': { tier: 'medium', provider: 'openai', suggestedUpgrade: 'o3' },
+    // Google (Gemini) - 3.x series (current)
+    'gemini-3-pro': { tier: 'large', provider: 'google' },
+    'gemini-3-flash': { tier: 'large', provider: 'google' },
+    'gemini-2.5-flash-lite': { tier: 'medium', provider: 'google', suggestedUpgrade: 'gemini-3-flash-preview' },
+    // Gemini legacy (for backward compatibility)
     'gemini-2.5-pro': { tier: 'large', provider: 'google' },
-    'gemini-2.5-flash': { tier: 'medium', provider: 'google', suggestedUpgrade: 'gemini-2.5-pro' },
-    'gemini-1.5-flash': { tier: 'medium', provider: 'google', suggestedUpgrade: 'gemini-1.5-pro' },
-    'gemini-2.0-flash-lite': { tier: 'small', provider: 'google', suggestedUpgrade: 'gemini-2.0-flash' },
+    'gemini-2.5-flash': { tier: 'medium', provider: 'google', suggestedUpgrade: 'gemini-3-flash-preview' },
+    'gemini-2.0-flash': { tier: 'large', provider: 'google' },
+    'gemini-1.5-pro': { tier: 'large', provider: 'google' },
+    'gemini-1.5-flash': { tier: 'medium', provider: 'google', suggestedUpgrade: 'gemini-3-flash-preview' },
     // Ollama / Local models (common ones)
-    'llama3.2': { tier: 'small', provider: 'ollama', suggestedUpgrade: 'llama3.1:70b' },
+    'llama3.2:8b': { tier: 'small', provider: 'ollama', suggestedUpgrade: 'llama3.2:70b' },
+    'llama3.2:70b': { tier: 'large', provider: 'ollama' },
+    'llama3.2': { tier: 'small', provider: 'ollama', suggestedUpgrade: 'llama3.2:70b' },
     'llama3.1': { tier: 'medium', provider: 'ollama', suggestedUpgrade: 'llama3.1:70b' },
     'llama3.1:70b': { tier: 'large', provider: 'ollama' },
     'mistral': { tier: 'small', provider: 'ollama' },
     'mixtral': { tier: 'medium', provider: 'ollama' },
     'codellama': { tier: 'medium', provider: 'ollama' },
     'deepseek-coder': { tier: 'medium', provider: 'ollama' },
+    'deepseek-coder:33b': { tier: 'large', provider: 'ollama' },
     'qwen2.5-coder': { tier: 'medium', provider: 'ollama' },
 };
 // =============================================================================
@@ -78,10 +99,11 @@ export function getCommandMinTier(command) {
         '/design': 'large',
         '/refine': 'large',
         '/arch': 'large',
+        '/scaffold': 'large',
         '/build': 'medium',
         '/prd': 'medium',
         '/sketch': 'small', // Simplified version - works with any model
-        '/init': 'small',
+        '/new': 'small',
         '/backlog': 'small',
         '/note': 'small',
     };

package/dist/utils/open-browser.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Open a URL in the default browser.
+ * Returns true if browser was opened successfully.
+ */
+export declare function openBrowser(url: string): Promise<boolean>;

package/dist/utils/open-browser.js

@@ -0,0 +1,32 @@
+/**
+ * Open a URL in the default browser.
+ * Returns true if browser was opened successfully.
+ */
+import { exec } from 'child_process';
+import * as os from 'os';
+export function openBrowser(url) {
+    return new Promise((resolve) => {
+        const platform = os.platform();
+        let cmd;
+        switch (platform) {
+            case 'darwin':
+                cmd = `open "${url}"`;
+                break;
+            case 'win32':
+                cmd = `start "" "${url}"`;
+                break;
+            default:
+                // Linux and others
+                cmd = `xdg-open "${url}"`;
+                break;
+        }
+        exec(cmd, (error) => {
+            if (error) {
+                resolve(false);
+            }
+            else {
+                resolve(true);
+            }
+        });
+    });
+}

package/dist/utils/path-safety.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Path Safety Utilities
+ *
+ * Safety validation for file operations, especially deletion.
+ * Prevents accidental deletion of system directories or unrelated folders.
+ */
+export interface DeleteValidation {
+    valid: boolean;
+    reason?: string;
+    warnings?: string[];
+}
+export interface CwdValidation {
+    matches: boolean;
+    projectPath: string;
+    cwd: string;
+}
+/**
+ * Validate a path is safe to delete
+ *
+ * @param projectPath - The path to validate for deletion
+ * @returns Validation result with valid flag, optional reason, and warnings
+ */
+export declare function validateDeletePath(projectPath: string): DeleteValidation;
+/**
+ * Validate active project matches current working directory
+ *
+ * @param project - Project with path property
+ * @returns Validation result with matches flag and paths
+ */
+export declare function validateProjectCwd(project: {
+    path: string;
+}): CwdValidation;
+/**
+ * Check if CWD validation warning should be shown
+ */
+export declare function shouldWarnCwdMismatch(project: {
+    path: string;
+}): boolean;
+/**
+ * Format a CWD mismatch warning message
+ */
+export declare function formatCwdMismatchWarning(project: {
+    path: string;
+}): string[];
+/**
+ * Format delete validation result for display
+ */
+export declare function formatDeleteValidation(validation: DeleteValidation, projectPath: string): string[];
+/**
+ * Check if a path is within the projects directory
+ */
+export declare function isWithinProjectsDir(targetPath: string): boolean;
+/**
+ * Get a safe display path (truncated if too long)
+ */
+export declare function getSafeDisplayPath(targetPath: string, maxLength?: number): string;

package/dist/utils/path-safety.js

@@ -0,0 +1,240 @@
+/**
+ * Path Safety Utilities
+ *
+ * Safety validation for file operations, especially deletion.
+ * Prevents accidental deletion of system directories or unrelated folders.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { getAllowedDeletePaths, isDeleteProtectionEnabled, isProjectMatchRequired } from '../settings/paths.js';
+import { truncatePlain as truncate } from '@compilr-dev/ui-core/utils';
+// =============================================================================
+// Dangerous Paths
+// =============================================================================
+/**
+ * Get list of dangerous system paths that should never be deleted
+ */
+function getDangerousPaths() {
+    const home = os.homedir();
+    return [
+        home, // Home directory itself
+        '/', // Root
+        '/usr',
+        '/bin',
+        '/sbin',
+        '/lib',
+        '/lib64',
+        '/opt',
+        '/etc',
+        '/var',
+        '/tmp',
+        '/dev',
+        '/proc',
+        '/sys',
+        '/boot',
+        '/root',
+        '/home', // Parent of all home directories
+        // macOS specific
+        '/System',
+        '/Library',
+        '/Applications',
+        '/Users',
+        '/Volumes',
+        '/private',
+        '/cores',
+        // Windows specific (when running under WSL or similar)
+        '/mnt/c',
+        '/mnt/c/Windows',
+        '/mnt/c/Program Files',
+        '/mnt/c/Program Files (x86)',
+        '/mnt/c/Users',
+        // Common temp directories
+        os.tmpdir(),
+        path.join(home, 'Desktop'),
+        path.join(home, 'Documents'),
+        path.join(home, 'Downloads'),
+        path.join(home, 'Pictures'),
+        path.join(home, 'Videos'),
+        path.join(home, 'Music'),
+        // CLI data directory should not be deleted via project delete
+        path.join(home, '.compilr-dev'),
+    ];
+}
+// =============================================================================
+// Validation Functions
+// =============================================================================
+/**
+ * Validate a path is safe to delete
+ *
+ * @param projectPath - The path to validate for deletion
+ * @returns Validation result with valid flag, optional reason, and warnings
+ */
+export function validateDeletePath(projectPath) {
+    const resolved = path.resolve(projectPath);
+    const warnings = [];
+    // 1. Path must be absolute (after resolve, it always is)
+    if (!path.isAbsolute(resolved)) {
+        return { valid: false, reason: 'Project path must be absolute' };
+    }
+    // 2. Check if path exists (OK to proceed if it doesn't - just skip file deletion)
+    if (!fs.existsSync(resolved)) {
+        return { valid: true, warnings: ['Path does not exist, skipping file deletion'] };
+    }
+    // 3. Prevent dangerous system paths
+    const dangerousPaths = getDangerousPaths();
+    for (const dangerous of dangerousPaths) {
+        const resolvedDangerous = path.resolve(dangerous);
+        if (resolved === resolvedDangerous) {
+            return {
+                valid: false,
+                reason: `Cannot delete system directory: ${resolved}`,
+            };
+        }
+    }
+    // 4. Check path is within allowed directories (if protection enabled)
+    if (isDeleteProtectionEnabled()) {
+        const allowedRoots = getAllowedDeletePaths();
+        const isWithinAllowed = allowedRoots.some((root) => {
+            const resolvedRoot = path.resolve(root);
+            return resolved.startsWith(resolvedRoot + path.sep) || resolved === resolvedRoot;
+        });
+        if (!isWithinAllowed) {
+            return {
+                valid: false,
+                reason: `Path is outside allowed directories. Configure allowedPaths in /config if needed.`,
+            };
+        }
+    }
+    // 5. Check for project markers (.compilr, .git, package.json)
+    const hasCompilrMarker = fs.existsSync(path.join(resolved, '.compilr'));
+    const hasGit = fs.existsSync(path.join(resolved, '.git'));
+    const hasPackageJson = fs.existsSync(path.join(resolved, 'package.json'));
+    const hasPyprojectToml = fs.existsSync(path.join(resolved, 'pyproject.toml'));
+    const hasCargoToml = fs.existsSync(path.join(resolved, 'Cargo.toml'));
+    const hasGoMod = fs.existsSync(path.join(resolved, 'go.mod'));
+    const hasProjectMarker = hasCompilrMarker || hasGit || hasPackageJson || hasPyprojectToml || hasCargoToml || hasGoMod;
+    if (!hasProjectMarker) {
+        warnings.push('Directory has no project markers (.compilr, .git, package.json, etc.)');
+    }
+    // 6. Warn if path seems too short (e.g., /home/user/a)
+    const pathParts = resolved.split(path.sep).filter(Boolean);
+    if (pathParts.length < 3) {
+        warnings.push('Path seems unusually short - double check this is correct');
+    }
+    // 7. Warn if path is very deep (might indicate system path)
+    if (pathParts.length > 15) {
+        warnings.push('Path is very deep - verify this is the correct project');
+    }
+    // 8. Check if path is a parent of current working directory
+    const cwd = process.cwd();
+    if (cwd.startsWith(resolved + path.sep) || cwd === resolved) {
+        warnings.push('This path contains or is your current working directory');
+    }
+    return { valid: true, warnings };
+}
+/**
+ * Validate active project matches current working directory
+ *
+ * @param project - Project with path property
+ * @returns Validation result with matches flag and paths
+ */
+export function validateProjectCwd(project) {
+    const cwd = process.cwd();
+    const projectPath = path.resolve(project.path);
+    // CWD should be within or equal to project path
+    const matches = cwd === projectPath || cwd.startsWith(projectPath + path.sep);
+    return { matches, projectPath, cwd };
+}
+/**
+ * Check if CWD validation warning should be shown
+ */
+export function shouldWarnCwdMismatch(project) {
+    if (!isProjectMatchRequired()) {
+        return false;
+    }
+    const { matches } = validateProjectCwd(project);
+    return !matches;
+}
+/**
+ * Format a CWD mismatch warning message
+ */
+export function formatCwdMismatchWarning(project) {
+    const { projectPath, cwd } = validateProjectCwd(project);
+    return [
+        "Current directory doesn't match active project",
+        `  Active project: ${projectPath}`,
+        `  Current dir:    ${cwd}`,
+        `  Consider: cd ${projectPath}`,
+    ];
+}
+/**
+ * Format delete validation result for display
+ */
+export function formatDeleteValidation(validation, projectPath) {
+    const lines = [];
+    if (validation.valid) {
+        lines.push('Path is within allowed directory');
+        // Check for project markers
+        if (fs.existsSync(path.join(projectPath, '.compilr'))) {
+            lines.push('Project has .compilr marker');
+        }
+        else if (fs.existsSync(path.join(projectPath, '.git'))) {
+            lines.push('Project has .git repository');
+        }
+        else if (fs.existsSync(path.join(projectPath, 'package.json'))) {
+            lines.push('Project has package.json');
+        }
+        if (validation.warnings && validation.warnings.length > 0) {
+            lines.push('');
+            lines.push('Warnings:');
+            for (const warning of validation.warnings) {
+                lines.push(`  - ${warning}`);
+            }
+        }
+    }
+    else {
+        lines.push(`Error: ${validation.reason || 'Unknown error'}`);
+        lines.push('');
+        lines.push('Allowed directories:');
+        for (const allowed of getAllowedDeletePaths()) {
+            lines.push(`  - ${allowed}`);
+        }
+        lines.push('');
+        lines.push('Options:');
+        lines.push('  1. Move the project to an allowed directory');
+        lines.push('  2. Add path to allowedPaths in /config');
+        lines.push('  3. Delete files manually and remove from database only');
+    }
+    return lines;
+}
+/**
+ * Check if a path is within the projects directory
+ */
+export function isWithinProjectsDir(targetPath) {
+    const allowedPaths = getAllowedDeletePaths();
+    const resolved = path.resolve(targetPath);
+    return allowedPaths.some((allowed) => {
+        const resolvedAllowed = path.resolve(allowed);
+        return resolved.startsWith(resolvedAllowed + path.sep) || resolved === resolvedAllowed;
+    });
+}
+/**
+ * Get a safe display path (truncated if too long)
+ */
+export function getSafeDisplayPath(targetPath, maxLength = 50) {
+    if (targetPath.length <= maxLength) {
+        return targetPath;
+    }
+    const parts = targetPath.split(path.sep);
+    if (parts.length <= 2) {
+        return truncate(targetPath, maxLength);
+    }
+    // Show first and last parts with ellipsis
+    const first = parts.slice(0, 2).join(path.sep);
+    const last = parts.slice(-2).join(path.sep);
+    if (first.length + last.length + 4 <= maxLength) {
+        return first + '/.../' + last;
+    }
+    return truncate(targetPath, maxLength);
+}

package/dist/utils/project-detection.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Project Detection Utilities
+ *
+ * Utilities for detecting project information from an existing directory.
+ * Used by the import project feature in /new wizard.
+ */
+export interface DetectedProject {
+    /** Project name from package.json or folder name */
+    name: string;
+    /** Prettified display name */
+    displayName: string;
+    /** Source of the name (package.json, go.mod, folder) */
+    nameSource: 'package.json' | 'go.mod' | 'pyproject.toml' | 'Cargo.toml' | 'folder';
+    /** Detected primary language (null if unknown) */
+    language: string | null;
+    /** Detected framework (null if not detected) */
+    framework: string | null;
+    /** Detected package manager (null if not detected) */
+    packageManager: string | null;
+    /** Whether .git directory exists */
+    hasGit: boolean;
+    /** Git remote URL (null if not configured) */
+    gitRemote: string | null;
+    /** Current git branch (null if not in git repo) */
+    gitBranch: string | null;
+    /** Whether COMPILR.md exists */
+    hasCompilrMd: boolean;
+    /** Whether CLAUDE.md exists (alternative) */
+    hasClaudeMd: boolean;
+}
+export interface GitInfo {
+    hasGit: boolean;
+    remote: string | null;
+    branch: string | null;
+}
+/**
+ * Detect project information from a directory path
+ */
+export declare function detectProjectInfo(projectPath: string): DetectedProject;
+/**
+ * Detect git repository information
+ */
+export declare function detectGitInfo(projectPath: string): GitInfo;
+/**
+ * Get a human-readable label for detected language
+ */
+export declare function getLanguageLabel(language: string | null): string;
+/**
+ * Get a human-readable label for detected framework
+ */
+export declare function getFrameworkLabel(framework: string | null): string;
+/**
+ * Check if a path is a valid directory that can be imported
+ */
+export declare function validateImportPath(importPath: string): {
+    valid: boolean;
+    error?: string;
+};