erosolar-cli 1.7.191 → 1.7.192

package/dist/tools/devTools.js

@@ -488,6 +488,560 @@ export function createDevTools(workingDir) {
             },
         },
         // ========================================================================
+        // PyPI Publishing Tools
+        // ========================================================================
+        {
+            name: 'python_publish',
+            description: 'Publish Python package to PyPI. Handles the full workflow: check auth, commit changes, bump version, build, and publish.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    versionBump: {
+                        type: 'string',
+                        enum: ['patch', 'minor', 'major'],
+                        description: 'Version bump type (default: patch)',
+                    },
+                    commitMessage: {
+                        type: 'string',
+                        description: 'Commit message for uncommitted changes (if any)',
+                    },
+                    dryRun: {
+                        type: 'boolean',
+                        description: 'If true, performs all steps except the actual publish',
+                    },
+                    testPypi: {
+                        type: 'boolean',
+                        description: 'Publish to TestPyPI instead of PyPI (default: false)',
+                    },
+                },
+                additionalProperties: false,
+            },
+            handler: async (args) => {
+                const versionBump = typeof args['versionBump'] === 'string' ? args['versionBump'] : 'patch';
+                const commitMessage = typeof args['commitMessage'] === 'string' ? args['commitMessage'] : undefined;
+                const dryRun = args['dryRun'] === true;
+                const testPypi = args['testPypi'] === true;
+                const steps = [];
+                const errors = [];
+                try {
+                    // Step 1: Detect Python project type and check auth
+                    steps.push('## Step 1: Detecting project type and checking authentication');
+                    const hasPoetry = existsSync(join(workingDir, 'pyproject.toml'));
+                    const hasSetupPy = existsSync(join(workingDir, 'setup.py'));
+                    const hasSetupCfg = existsSync(join(workingDir, 'setup.cfg'));
+                    let projectType = 'unknown';
+                    let currentVersion = '';
+                    if (hasPoetry) {
+                        const pyprojectContent = readFileSync(join(workingDir, 'pyproject.toml'), 'utf-8');
+                        if (pyprojectContent.includes('[tool.poetry]')) {
+                            projectType = 'poetry';
+                            const versionMatch = pyprojectContent.match(/version\s*=\s*"([^"]+)"/);
+                            if (versionMatch)
+                                currentVersion = versionMatch[1] || '';
+                            steps.push(`✓ Detected Poetry project (v${currentVersion})`);
+                            // Check Poetry auth
+                            try {
+                                await execAsync('poetry config pypi-token.pypi', { cwd: workingDir, timeout: 10000 });
+                                steps.push('✓ Poetry PyPI token configured');
+                            }
+                            catch {
+                                steps.push('⚠ PyPI token may not be configured. Run: poetry config pypi-token.pypi <token>');
+                            }
+                        }
+                    }
+                    if (projectType === 'unknown' && (hasSetupPy || hasSetupCfg)) {
+                        projectType = 'setuptools';
+                        // Try to get version from setup.py or setup.cfg
+                        if (hasSetupPy) {
+                            const setupContent = readFileSync(join(workingDir, 'setup.py'), 'utf-8');
+                            const versionMatch = setupContent.match(/version\s*=\s*['"]([^'"]+)['"]/);
+                            if (versionMatch)
+                                currentVersion = versionMatch[1] || '';
+                        }
+                        steps.push(`✓ Detected setuptools project${currentVersion ? ` (v${currentVersion})` : ''}`);
+                        // Check twine auth
+                        try {
+                            await execAsync('twine --version', { cwd: workingDir, timeout: 10000 });
+                            steps.push('✓ Twine is available');
+                        }
+                        catch {
+                            errors.push('✗ Twine not found. Install with: pip install twine');
+                            return [...steps, '', '## Errors', ...errors].join('\n');
+                        }
+                    }
+                    if (projectType === 'unknown') {
+                        errors.push('✗ Could not detect Python project type. Need pyproject.toml (Poetry) or setup.py/setup.cfg (setuptools)');
+                        return [...steps, '', '## Errors', ...errors].join('\n');
+                    }
+                    // Step 2: Check for uncommitted changes
+                    steps.push('');
+                    steps.push('## Step 2: Checking git status');
+                    try {
+                        const { stdout: gitStatus } = await execAsync('git status --porcelain', { cwd: workingDir, timeout: 10000 });
+                        if (gitStatus.trim()) {
+                            if (commitMessage) {
+                                steps.push(`Found uncommitted changes, committing with message: "${commitMessage}"`);
+                                await execAsync('git add .', { cwd: workingDir, timeout: 30000 });
+                                await execAsync(`git commit -m "${commitMessage.replace(/"/g, '\\"')}"`, { cwd: workingDir, timeout: 30000 });
+                                steps.push('✓ Changes committed');
+                            }
+                            else {
+                                errors.push('✗ Uncommitted changes found. Provide a commitMessage or commit manually first.');
+                                gitStatus.trim().split('\n').forEach(line => errors.push(`  ${line}`));
+                                return [...steps, '', '## Errors', ...errors].join('\n');
+                            }
+                        }
+                        else {
+                            steps.push('✓ Working directory clean');
+                        }
+                    }
+                    catch (e) {
+                        steps.push(`Warning: Could not check git status: ${e.message}`);
+                    }
+                    // Step 3: Bump version
+                    steps.push('');
+                    steps.push('## Step 3: Bumping version');
+                    try {
+                        if (projectType === 'poetry') {
+                            const { stdout: versionOut } = await execAsync(`poetry version ${versionBump}`, {
+                                cwd: workingDir,
+                                timeout: 30000,
+                            });
+                            steps.push(`✓ ${versionOut.trim()}`);
+                        }
+                        else {
+                            // For setuptools, use bump2version if available, otherwise manual
+                            try {
+                                await execAsync(`bump2version ${versionBump}`, { cwd: workingDir, timeout: 30000 });
+                                steps.push(`✓ Version bumped with bump2version`);
+                            }
+                            catch {
+                                steps.push(`⚠ bump2version not available. Please manually update version in setup.py/setup.cfg`);
+                            }
+                        }
+                    }
+                    catch (e) {
+                        errors.push(`✗ Version bump failed: ${e.message}`);
+                        return [...steps, '', '## Errors', ...errors].join('\n');
+                    }
+                    // Step 4: Build
+                    steps.push('');
+                    steps.push('## Step 4: Building package');
+                    try {
+                        if (projectType === 'poetry') {
+                            await execAsync('poetry build', {
+                                cwd: workingDir,
+                                timeout: 120000,
+                                maxBuffer: 1024 * 1024 * 10,
+                            });
+                            steps.push('✓ Built with Poetry');
+                        }
+                        else {
+                            // Clean old builds
+                            await execAsync('rm -rf dist/ build/ *.egg-info', { cwd: workingDir, timeout: 10000, shell: '/bin/bash' });
+                            await execAsync('python -m build', {
+                                cwd: workingDir,
+                                timeout: 120000,
+                                maxBuffer: 1024 * 1024 * 10,
+                            });
+                            steps.push('✓ Built with python -m build');
+                        }
+                    }
+                    catch (e) {
+                        errors.push(`✗ Build failed: ${e.message}`);
+                        return [...steps, '', '## Errors', ...errors].join('\n');
+                    }
+                    // Step 5: Publish
+                    steps.push('');
+                    steps.push('## Step 5: Publishing to PyPI');
+                    const repository = testPypi ? 'testpypi' : 'pypi';
+                    if (dryRun) {
+                        steps.push(`⚠ DRY RUN - would publish to ${repository}`);
+                        steps.push('Files that would be uploaded:');
+                        try {
+                            const { stdout: distFiles } = await execAsync('ls -la dist/', { cwd: workingDir, timeout: 10000 });
+                            steps.push(distFiles);
+                        }
+                        catch {
+                            steps.push('  (could not list dist files)');
+                        }
+                    }
+                    else {
+                        try {
+                            if (projectType === 'poetry') {
+                                const publishCmd = testPypi
+                                    ? 'poetry publish -r testpypi'
+                                    : 'poetry publish';
+                                await execAsync(publishCmd, {
+                                    cwd: workingDir,
+                                    timeout: 120000,
+                                    maxBuffer: 1024 * 1024 * 10,
+                                });
+                            }
+                            else {
+                                const uploadUrl = testPypi
+                                    ? '--repository-url https://test.pypi.org/legacy/'
+                                    : '';
+                                await execAsync(`twine upload ${uploadUrl} dist/*`, {
+                                    cwd: workingDir,
+                                    timeout: 120000,
+                                    maxBuffer: 1024 * 1024 * 10,
+                                });
+                            }
+                            steps.push(`✓ Published to ${repository}`);
+                        }
+                        catch (e) {
+                            errors.push(`✗ Publish failed: ${e.message}`);
+                            return [...steps, '', '## Errors', ...errors].join('\n');
+                        }
+                    }
+                    // Step 6: Git commit version bump and push
+                    steps.push('');
+                    steps.push('## Step 6: Committing version bump and pushing');
+                    try {
+                        const { stdout: gitStatus } = await execAsync('git status --porcelain', { cwd: workingDir, timeout: 10000 });
+                        if (gitStatus.trim()) {
+                            await execAsync('git add .', { cwd: workingDir, timeout: 30000 });
+                            await execAsync('git commit -m "Bump version"', { cwd: workingDir, timeout: 30000 });
+                            steps.push('✓ Version bump committed');
+                        }
+                        await execAsync('git push && git push --tags', { cwd: workingDir, timeout: 60000 });
+                        steps.push('✓ Pushed to remote');
+                    }
+                    catch (e) {
+                        steps.push(`Warning: Could not push to git: ${e.message}`);
+                    }
+                    // Summary
+                    steps.push('');
+                    steps.push('## Summary');
+                    steps.push(`✓ Python package ${dryRun ? '(dry run)' : 'published'} to ${repository}`);
+                    return steps.join('\n');
+                }
+                catch (error) {
+                    errors.push(`Unexpected error: ${error.message}`);
+                    return [...steps, '', '## Errors', ...errors].join('\n');
+                }
+            },
+        },
+        {
+            name: 'pypi_check_auth',
+            description: 'Check PyPI authentication status for both Poetry and twine',
+            parameters: {
+                type: 'object',
+                properties: {},
+                additionalProperties: false,
+            },
+            handler: async () => {
+                const output = ['# PyPI Authentication Status', ''];
+                // Check Poetry
+                output.push('## Poetry');
+                try {
+                    const { stdout: poetryConfig } = await execAsync('poetry config --list 2>/dev/null | grep pypi', {
+                        cwd: workingDir,
+                        timeout: 10000,
+                        shell: '/bin/bash',
+                    });
+                    if (poetryConfig.includes('pypi-token')) {
+                        output.push('✓ PyPI token configured in Poetry');
+                    }
+                    else {
+                        output.push('✗ No PyPI token in Poetry');
+                        output.push('  Set with: poetry config pypi-token.pypi <your-token>');
+                    }
+                }
+                catch {
+                    output.push('Poetry not available or not configured');
+                }
+                // Check twine/pip
+                output.push('');
+                output.push('## Twine/pip');
+                try {
+                    await execAsync('twine --version', { cwd: workingDir, timeout: 10000 });
+                    output.push('✓ Twine is installed');
+                    // Check for .pypirc
+                    const homedir = process.env['HOME'] || '';
+                    if (existsSync(join(homedir, '.pypirc'))) {
+                        output.push('✓ .pypirc found in home directory');
+                    }
+                    else {
+                        output.push('⚠ No .pypirc found. Twine will prompt for credentials.');
+                    }
+                }
+                catch {
+                    output.push('✗ Twine not installed');
+                    output.push('  Install with: pip install twine');
+                }
+                // Check for TWINE_* env vars
+                output.push('');
+                output.push('## Environment Variables');
+                const twineUser = process.env['TWINE_USERNAME'];
+                const twinePass = process.env['TWINE_PASSWORD'];
+                if (twineUser) {
+                    output.push(`✓ TWINE_USERNAME set: ${twineUser}`);
+                }
+                if (twinePass) {
+                    output.push('✓ TWINE_PASSWORD is set');
+                }
+                if (!twineUser && !twinePass) {
+                    output.push('No TWINE_* environment variables set');
+                }
+                return output.join('\n');
+            },
+        },
+        // ========================================================================
+        // Cargo (Rust) Publishing Tools
+        // ========================================================================
+        {
+            name: 'cargo_publish',
+            description: 'Publish Rust crate to crates.io. Handles the full workflow: check auth, commit changes, bump version, build, and publish.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    versionBump: {
+                        type: 'string',
+                        enum: ['patch', 'minor', 'major'],
+                        description: 'Version bump type (default: patch)',
+                    },
+                    commitMessage: {
+                        type: 'string',
+                        description: 'Commit message for uncommitted changes (if any)',
+                    },
+                    dryRun: {
+                        type: 'boolean',
+                        description: 'If true, performs all steps except the actual publish',
+                    },
+                    allowDirty: {
+                        type: 'boolean',
+                        description: 'Allow publishing with uncommitted changes (default: false)',
+                    },
+                },
+                additionalProperties: false,
+            },
+            handler: async (args) => {
+                const versionBump = typeof args['versionBump'] === 'string' ? args['versionBump'] : 'patch';
+                const commitMessage = typeof args['commitMessage'] === 'string' ? args['commitMessage'] : undefined;
+                const dryRun = args['dryRun'] === true;
+                const allowDirty = args['allowDirty'] === true;
+                const steps = [];
+                const errors = [];
+                try {
+                    // Step 1: Check Cargo.toml exists and auth
+                    steps.push('## Step 1: Checking project and authentication');
+                    const cargoTomlPath = join(workingDir, 'Cargo.toml');
+                    if (!existsSync(cargoTomlPath)) {
+                        errors.push('✗ Cargo.toml not found. This is not a Rust project.');
+                        return [...steps, '', '## Errors', ...errors].join('\n');
+                    }
+                    const cargoContent = readFileSync(cargoTomlPath, 'utf-8');
+                    const nameMatch = cargoContent.match(/name\s*=\s*"([^"]+)"/);
+                    const versionMatch = cargoContent.match(/version\s*=\s*"([^"]+)"/);
+                    const crateName = nameMatch ? nameMatch[1] : 'unknown';
+                    const currentVersion = versionMatch ? versionMatch[1] : '0.0.0';
+                    steps.push(`✓ Found crate: ${crateName} v${currentVersion}`);
+                    // Check cargo login
+                    try {
+                        const { stdout: whoami } = await execAsync('cargo owner --list 2>/dev/null | head -1', {
+                            cwd: workingDir,
+                            timeout: 30000,
+                            shell: '/bin/bash',
+                        });
+                        if (whoami.trim()) {
+                            steps.push(`✓ Logged in to crates.io`);
+                        }
+                    }
+                    catch {
+                        steps.push('⚠ Could not verify crates.io login. Make sure you ran `cargo login`');
+                    }
+                    // Step 2: Check for uncommitted changes
+                    steps.push('');
+                    steps.push('## Step 2: Checking git status');
+                    try {
+                        const { stdout: gitStatus } = await execAsync('git status --porcelain', { cwd: workingDir, timeout: 10000 });
+                        if (gitStatus.trim()) {
+                            if (commitMessage) {
+                                steps.push(`Found uncommitted changes, committing with message: "${commitMessage}"`);
+                                await execAsync('git add .', { cwd: workingDir, timeout: 30000 });
+                                await execAsync(`git commit -m "${commitMessage.replace(/"/g, '\\"')}"`, { cwd: workingDir, timeout: 30000 });
+                                steps.push('✓ Changes committed');
+                            }
+                            else if (!allowDirty) {
+                                errors.push('✗ Uncommitted changes found. Provide a commitMessage, commit manually, or use allowDirty=true.');
+                                gitStatus.trim().split('\n').forEach(line => errors.push(`  ${line}`));
+                                return [...steps, '', '## Errors', ...errors].join('\n');
+                            }
+                            else {
+                                steps.push('⚠ Uncommitted changes present (allowDirty=true)');
+                            }
+                        }
+                        else {
+                            steps.push('✓ Working directory clean');
+                        }
+                    }
+                    catch (e) {
+                        steps.push(`Warning: Could not check git status: ${e.message}`);
+                    }
+                    // Step 3: Bump version
+                    steps.push('');
+                    steps.push('## Step 3: Bumping version');
+                    // Parse current version
+                    const versionParts = (currentVersion || '0.0.0').split('.').map(p => parseInt(p, 10) || 0);
+                    let [major = 0, minor = 0, patch = 0] = versionParts;
+                    switch (versionBump) {
+                        case 'major':
+                            major++;
+                            minor = 0;
+                            patch = 0;
+                            break;
+                        case 'minor':
+                            minor++;
+                            patch = 0;
+                            break;
+                        case 'patch':
+                        default:
+                            patch++;
+                            break;
+                    }
+                    const newVersion = `${major}.${minor}.${patch}`;
+                    // Update Cargo.toml
+                    const updatedCargo = cargoContent.replace(/version\s*=\s*"[^"]+"/, `version = "${newVersion}"`);
+                    const fs = await import('node:fs/promises');
+                    await fs.writeFile(cargoTomlPath, updatedCargo, 'utf-8');
+                    steps.push(`✓ Version bumped: ${currentVersion} → ${newVersion}`);
+                    // Update Cargo.lock
+                    try {
+                        await execAsync('cargo check', { cwd: workingDir, timeout: 120000 });
+                        steps.push('✓ Cargo.lock updated');
+                    }
+                    catch (e) {
+                        steps.push(`Warning: cargo check had issues: ${e.message}`);
+                    }
+                    // Step 4: Build and test
+                    steps.push('');
+                    steps.push('## Step 4: Building and testing');
+                    try {
+                        await execAsync('cargo build --release', {
+                            cwd: workingDir,
+                            timeout: 300000,
+                            maxBuffer: 1024 * 1024 * 10,
+                        });
+                        steps.push('✓ Release build successful');
+                        await execAsync('cargo test', {
+                            cwd: workingDir,
+                            timeout: 300000,
+                            maxBuffer: 1024 * 1024 * 10,
+                        });
+                        steps.push('✓ Tests passed');
+                    }
+                    catch (e) {
+                        errors.push(`✗ Build/test failed: ${e.message}`);
+                        return [...steps, '', '## Errors', ...errors].join('\n');
+                    }
+                    // Step 5: Publish
+                    steps.push('');
+                    steps.push('## Step 5: Publishing to crates.io');
+                    if (dryRun) {
+                        steps.push('⚠ DRY RUN - would publish to crates.io');
+                        try {
+                            const { stdout: dryRunOut } = await execAsync('cargo publish --dry-run', {
+                                cwd: workingDir,
+                                timeout: 120000,
+                                maxBuffer: 1024 * 1024 * 10,
+                            });
+                            steps.push('Dry run output:');
+                            steps.push(dryRunOut.substring(0, 2000));
+                        }
+                        catch (e) {
+                            steps.push(`Dry run notes: ${e.message}`);
+                        }
+                    }
+                    else {
+                        try {
+                            const publishFlags = allowDirty ? '--allow-dirty' : '';
+                            await execAsync(`cargo publish ${publishFlags}`, {
+                                cwd: workingDir,
+                                timeout: 180000,
+                                maxBuffer: 1024 * 1024 * 10,
+                            });
+                            steps.push(`✓ Published ${crateName}@${newVersion} to crates.io`);
+                        }
+                        catch (e) {
+                            errors.push(`✗ Publish failed: ${e.message}`);
+                            return [...steps, '', '## Errors', ...errors].join('\n');
+                        }
+                    }
+                    // Step 6: Git commit and push
+                    steps.push('');
+                    steps.push('## Step 6: Committing and pushing');
+                    try {
+                        await execAsync('git add Cargo.toml Cargo.lock', { cwd: workingDir, timeout: 10000 });
+                        await execAsync(`git commit -m "Release v${newVersion}"`, { cwd: workingDir, timeout: 30000 });
+                        await execAsync(`git tag -a "v${newVersion}" -m "Release v${newVersion}"`, { cwd: workingDir, timeout: 10000 });
+                        steps.push(`✓ Created tag v${newVersion}`);
+                        await execAsync('git push && git push --tags', { cwd: workingDir, timeout: 60000 });
+                        steps.push('✓ Pushed to remote');
+                    }
+                    catch (e) {
+                        steps.push(`Warning: Could not push to git: ${e.message}`);
+                    }
+                    // Summary
+                    steps.push('');
+                    steps.push('## Summary');
+                    steps.push(`✓ ${crateName}@${newVersion} ${dryRun ? '(dry run)' : 'published to crates.io'}`);
+                    return steps.join('\n');
+                }
+                catch (error) {
+                    errors.push(`Unexpected error: ${error.message}`);
+                    return [...steps, '', '## Errors', ...errors].join('\n');
+                }
+            },
+        },
+        {
+            name: 'cargo_check_auth',
+            description: 'Check crates.io authentication status',
+            parameters: {
+                type: 'object',
+                properties: {},
+                additionalProperties: false,
+            },
+            handler: async () => {
+                const output = ['# Crates.io Authentication Status', ''];
+                // Check if cargo is available
+                try {
+                    const { stdout: cargoVersion } = await execAsync('cargo --version', { cwd: workingDir, timeout: 10000 });
+                    output.push(`✓ ${cargoVersion.trim()}`);
+                }
+                catch {
+                    output.push('✗ Cargo not found. Install Rust from https://rustup.rs');
+                    return output.join('\n');
+                }
+                // Check credentials file
+                const homedir = process.env['HOME'] || '';
+                const credentialsPath = join(homedir, '.cargo', 'credentials.toml');
+                const legacyCredentialsPath = join(homedir, '.cargo', 'credentials');
+                output.push('');
+                output.push('## Credentials');
+                if (existsSync(credentialsPath) || existsSync(legacyCredentialsPath)) {
+                    output.push('✓ Credentials file found');
+                    output.push('  To update token, run: cargo login');
+                }
+                else {
+                    output.push('✗ No credentials file found');
+                    output.push('  Run: cargo login <your-api-token>');
+                    output.push('  Get token from: https://crates.io/settings/tokens');
+                }
+                // Check CARGO_REGISTRY_TOKEN env var
+                output.push('');
+                output.push('## Environment Variables');
+                if (process.env['CARGO_REGISTRY_TOKEN']) {
+                    output.push('✓ CARGO_REGISTRY_TOKEN is set');
+                }
+                else {
+                    output.push('CARGO_REGISTRY_TOKEN not set (optional)');
+                }
+                return output.join('\n');
+            },
+        },
+        // ========================================================================
         // Git Workflow Tools
         // ========================================================================
         {