@meltstudio/meltctl 4.38.0 → 4.38.1

package/dist/commands/init.js

@@ -1,520 +0,0 @@
-import chalk from 'chalk';
-import { checkbox, confirm } from '@inquirer/prompts';
-import fs from 'fs-extra';
-import path from 'path';
-import { isAuthenticated } from '../utils/auth.js';
-import { fetchTemplates } from '../utils/templates.js';
-const SKILL_FRONTMATTER = {
-    setup: `---
-user-invocable: true
-description: >-
-  Analyze the project and customize AGENTS.md for this codebase.
-  Use when setting up a new project, after running meltctl init,
-  or when AGENTS.md has placeholder markers. Detects tech stack,
-  fills in project-specific sections, and merges existing standards.
----
-
-`,
-    plan: `---
-user-invocable: true
-description: >-
-  Design an implementation approach before writing code. Use when
-  starting a feature, tackling a complex task, or when the developer
-  says "plan this" or "how should we approach this". Gathers requirements,
-  explores codebase, and presents a step-by-step plan for approval.
----
-
-`,
-    review: `---
-user-invocable: true
-description: >-
-  Review code changes against project standards and address PR feedback.
-  Use when the developer asks to review changes, check code quality,
-  or respond to PR reviewer comments. Categorizes findings as must-fix,
-  should-fix, or suggestions.
----
-
-`,
-    pr: `---
-user-invocable: true
-description: >-
-  Create a well-structured pull request from current changes. Use when
-  the developer is ready to submit work, says "create a PR", or "open
-  a pull request". Analyzes changes, runs pre-flight checks, drafts
-  description, and creates the PR via gh CLI.
----
-
-`,
-    debug: `---
-user-invocable: true
-description: >-
-  Systematically investigate and fix bugs. Use when the developer
-  reports a bug, encounters an error, or says "debug this" or "why
-  is this failing". Reproduces the issue, isolates root cause, writes
-  regression test, and implements minimal fix.
----
-
-`,
-    audit: `---
-user-invocable: true
-description: >-
-  Run a comprehensive project compliance audit against team standards.
-  Use when the developer wants to assess project health, check compliance,
-  or says "audit this project". Checks 15 categories including documentation,
-  testing, CI/CD, security, and AI tool setup. Produces a structured
-  report with scores and actionable fixes.
----
-
-`,
-    'ux-audit': `---
-user-invocable: true
-description: >-
-  Review the project's UI against usability heuristics using Chrome DevTools
-  MCP. Use when the developer wants to check UX quality, says "review the UI",
-  or "UX audit". In full audit mode, crawls the entire app. During an active
-  plan, scopes to the current feature and appends results to the plan file.
----
-
-`,
-    'security-audit': `---
-user-invocable: true
-description: >-
-  Run a comprehensive security posture audit across the entire platform.
-  Use when the developer wants to assess security, says "security audit",
-  or "check our security posture". Covers infrastructure, encryption, auth,
-  application security, data protection, CI/CD, and compliance readiness.
-  Investigates all platform repositories for a holistic view.
----
-
-`,
-    validate: `---
-user-invocable: true
-description: >-
-  Run the validation plan from the plan document after implementation.
-  Use when the developer says "validate this", "test the feature", or
-  after finishing implementation. Validates end-to-end using browser,
-  API, or CLI testing, suggests test coverage improvements, then prompts
-  the developer for mandatory manual sign-off.
----
-
-`,
-    update: `---
-user-invocable: true
-description: >-
-  Update Melt skills and standards to the latest version. Use when the
-  developer wants the latest skill templates, says "update melt", or
-  after a new meltctl version is released. Fetches latest templates,
-  preserves project customizations in AGENTS.md, and merges changes.
----
-
-`,
-    help: `---
-user-invocable: true
-description: >-
-  Answer questions about the AI-First Development Playbook and team
-  workflow. Use when the developer asks about the development process,
-  what step they're on, how validation works, or any workflow question.
-  This is a reference skill — it explains the process, not executes it.
----
-
-`,
-    link: `---
-user-invocable: true
-description: >-
-  Connect and verify required integrations (ticket tracker, browser
-  testing). Use after melt-setup, when tools aren't working, or when
-  a skill reports missing MCP connections. Guides setup, verifies
-  each tool works, and updates AGENTS.md connection status.
----
-
-`,
-};
-const OPENCODE_COMMAND_FRONTMATTER = {
-    setup: `---
-description: Analyze the project and customize AGENTS.md for this codebase.
----
-
-`,
-    plan: `---
-description: Design an implementation approach before writing code.
----
-
-`,
-    review: `---
-description: Review code changes against project standards and address PR feedback.
----
-
-`,
-    pr: `---
-description: Create a well-structured pull request from current changes.
----
-
-`,
-    debug: `---
-description: Systematically investigate and fix bugs.
----
-
-`,
-    audit: `---
-description: Run a comprehensive project compliance audit against team standards.
----
-
-`,
-    'ux-audit': `---
-description: Review the project's UI against usability heuristics using Chrome DevTools MCP.
----
-
-`,
-    'security-audit': `---
-description: Run a comprehensive security posture audit across the entire platform.
----
-
-`,
-    validate: `---
-description: Run the validation plan from the plan document after implementation.
----
-
-`,
-    update: `---
-description: Update Melt skills and standards to the latest version.
----
-
-`,
-    help: `---
-description: Answer questions about the AI-First Development Playbook and team workflow.
----
-
-`,
-    link: `---
-description: Connect and verify required integrations (ticket tracker, browser testing).
----
-
-`,
-};
-const GITIGNORE_ENTRIES = ['.env.local', '.claude/settings.local.json'];
-function detectExistingTools(cwd) {
-    return {
-        claude: fs.pathExistsSync(path.join(cwd, '.claude/settings.json')),
-        cursor: fs.pathExistsSync(path.join(cwd, '.cursor/commands')),
-        opencode: fs.pathExistsSync(path.join(cwd, '.opencode/commands')),
-    };
-}
-async function promptToolSelection(existingTools) {
-    const choices = [];
-    if (!existingTools?.claude) {
-        choices.push({ name: 'Claude Code', value: 'claude', checked: true });
-    }
-    if (!existingTools?.cursor) {
-        choices.push({ name: 'Cursor', value: 'cursor', checked: true });
-    }
-    if (!existingTools?.opencode) {
-        choices.push({ name: 'OpenCode', value: 'opencode', checked: true });
-    }
-    choices.push({
-        name: 'Other — contact us in #dev on Slack to request support',
-        value: 'other',
-    });
-    const selected = await checkbox({
-        message: 'Which AI coding tools do you use?',
-        choices,
-    });
-    return {
-        claude: selected.includes('claude'),
-        cursor: selected.includes('cursor'),
-        opencode: selected.includes('opencode'),
-        other: selected.includes('other'),
-    };
-}
-export async function initCommand(options) {
-    // Check authentication before anything else to avoid wasted prompts
-    if (!(await isAuthenticated())) {
-        console.error(chalk.red('Not authenticated. Run `npx @meltstudio/meltctl@latest login` first.'));
-        process.exit(1);
-    }
-    const cwd = process.cwd();
-    // Warn if not in a git repository — likely the wrong directory
-    const isGitRepo = await fs.pathExists(path.join(cwd, '.git'));
-    if (!isGitRepo) {
-        console.log(chalk.yellow(`Warning: ${cwd} is not a git repository.`));
-        console.log(chalk.dim('meltctl init should be run from the root of your project.'));
-        console.log();
-        const proceed = await confirm({
-            message: 'Continue initializing here anyway?',
-            default: false,
-        });
-        if (!proceed) {
-            console.log(chalk.dim('Aborted. cd into your project root and try again.'));
-            return;
-        }
-        console.log();
-    }
-    const alreadyInitialized = await fs.pathExists(path.join(cwd, 'AGENTS.md'));
-    let isReInit = false;
-    let tools;
-    if (alreadyInitialized && !options.force) {
-        // Re-init scenario: project already set up, developer wants to add another tool
-        const existing = detectExistingTools(cwd);
-        const existingNames = [
-            existing.claude ? 'Claude Code' : '',
-            existing.cursor ? 'Cursor' : '',
-            existing.opencode ? 'OpenCode' : '',
-        ]
-            .filter(Boolean)
-            .join(', ');
-        if (existing.claude && existing.cursor && existing.opencode) {
-            console.log(chalk.yellow('Project already initialized with all tools. Use --force to overwrite.'));
-            process.exit(1);
-        }
-        console.log(chalk.dim(`Project already initialized${existingNames ? ` with ${existingNames}` : ''}.`));
-        isReInit = true;
-        if (options.claude || options.cursor || options.opencode) {
-            // Non-interactive: use flags directly, skip confirm prompt
-            tools = {
-                claude: !!options.claude,
-                cursor: !!options.cursor,
-                opencode: !!options.opencode,
-                other: false,
-            };
-        }
-        else {
-            const addMore = await confirm({
-                message: 'Add configuration for another tool?',
-                default: true,
-            });
-            if (!addMore) {
-                process.exit(0);
-            }
-            tools = await promptToolSelection(existing);
-        }
-    }
-    else {
-        // Fresh init or --force
-        if (options.claude || options.cursor || options.opencode) {
-            tools = {
-                claude: !!options.claude,
-                cursor: !!options.cursor,
-                opencode: !!options.opencode,
-                other: false,
-            };
-        }
-        else {
-            tools = await promptToolSelection();
-        }
-    }
-    if (!tools.claude && !tools.cursor && !tools.opencode && !tools.other) {
-        console.log(chalk.yellow('No tools selected. Nothing to do.'));
-        process.exit(0);
-    }
-    let templates;
-    try {
-        templates = await fetchTemplates();
-    }
-    catch (error) {
-        if (error instanceof Error && error.message.includes('expired')) {
-            console.error(chalk.red('Session expired. Run `npx @meltstudio/meltctl@latest login` to re-authenticate.'));
-        }
-        else if (error instanceof Error && error.message.includes('fetch')) {
-            console.error(chalk.red('Could not reach Melt API. Check your connection.'));
-        }
-        else {
-            console.error(chalk.red(`Failed to fetch templates: ${error instanceof Error ? error.message : 'Unknown error'}`));
-        }
-        process.exit(1);
-    }
-    console.log(chalk.bold('Initializing Melt development tools...'));
-    console.log();
-    const createdFiles = [];
-    const workflows = [
-        'setup',
-        'plan',
-        'validate',
-        'review',
-        'pr',
-        'debug',
-        'audit',
-        'ux-audit',
-        'security-audit',
-        'update',
-        'help',
-        'link',
-    ];
-    // Shared files (skip on re-init)
-    if (!isReInit) {
-        const agentsMd = templates['agents-md.md'];
-        if (agentsMd) {
-            await fs.writeFile(path.join(cwd, 'AGENTS.md'), agentsMd, 'utf-8');
-            createdFiles.push('AGENTS.md');
-        }
-        const mcpConfig = templates['mcp-configs/base.json'];
-        if (mcpConfig) {
-            await mergeMcpConfig(cwd, mcpConfig);
-            createdFiles.push('.mcp.json');
-        }
-        await updateGitignore(cwd);
-    }
-    // Claude Code files
-    if (tools.claude) {
-        const claudeSettings = templates['claude-settings.json'];
-        if (claudeSettings) {
-            await fs.ensureDir(path.join(cwd, '.claude'));
-            await mergeClaudeSettings(cwd, claudeSettings);
-            createdFiles.push('.claude/settings.json');
-        }
-        for (const name of workflows) {
-            const workflowContent = templates[`workflows/${name}.md`];
-            if (workflowContent) {
-                const skillDir = path.join(cwd, `.claude/skills/melt-${name}`);
-                await fs.ensureDir(skillDir);
-                const skillContent = SKILL_FRONTMATTER[name] + workflowContent;
-                await fs.writeFile(path.join(skillDir, 'SKILL.md'), skillContent, 'utf-8');
-            }
-        }
-        createdFiles.push('.claude/skills/melt-{setup,plan,validate,review,pr,debug,audit,ux-audit,security-audit,update,help}/SKILL.md');
-    }
-    // Cursor files
-    if (tools.cursor) {
-        await fs.ensureDir(path.join(cwd, '.cursor/commands'));
-        for (const name of workflows) {
-            const workflowContent = templates[`workflows/${name}.md`];
-            if (workflowContent) {
-                await fs.writeFile(path.join(cwd, `.cursor/commands/melt-${name}.md`), workflowContent, 'utf-8');
-            }
-        }
-        createdFiles.push('.cursor/commands/melt-{setup,plan,validate,review,pr,debug,audit,ux-audit,security-audit,update,help}.md');
-    }
-    // OpenCode files
-    if (tools.opencode) {
-        await fs.ensureDir(path.join(cwd, '.opencode/commands'));
-        for (const name of workflows) {
-            const workflowContent = templates[`workflows/${name}.md`];
-            if (workflowContent) {
-                const commandContent = OPENCODE_COMMAND_FRONTMATTER[name] + workflowContent;
-                await fs.writeFile(path.join(cwd, `.opencode/commands/melt-${name}.md`), commandContent, 'utf-8');
-            }
-        }
-        createdFiles.push('.opencode/commands/melt-{setup,plan,validate,review,pr,debug,audit,ux-audit,security-audit,update,help}.md');
-    }
-    // Print summary
-    console.log(chalk.green('Created files:'));
-    for (const file of createdFiles) {
-        console.log(chalk.dim(`  ${file}`));
-    }
-    console.log();
-    if (tools.other) {
-        console.log(chalk.cyan('Want support for your tool? Let us know in #dev on Slack'));
-        console.log();
-    }
-    const commandNames = 'melt-setup, melt-plan, melt-validate, melt-review, melt-pr, melt-debug, melt-audit, melt-ux-audit, melt-security-audit, melt-update, melt-help';
-    if (tools.claude) {
-        console.log(chalk.dim(`Available skills: /${commandNames.replace(/, /g, ', /')}`));
-    }
-    if (tools.cursor) {
-        console.log(chalk.dim(`Available Cursor commands: ${commandNames}`));
-    }
-    if (tools.opencode) {
-        console.log(chalk.dim(`Available OpenCode commands: /${commandNames.replace(/, /g, ', /')}`));
-    }
-    if (tools.claude || tools.cursor || tools.opencode) {
-        console.log();
-    }
-    if (!isReInit) {
-        console.log(chalk.bold.cyan('  Next step: run /melt-setup to customize AGENTS.md for your project'));
-        console.log();
-        const toolInstructions = [];
-        if (tools.claude) {
-            toolInstructions.push({
-                name: 'Claude Code',
-                steps: [
-                    'Type /melt-setup in the chat prompt, or',
-                    'Open the skills menu and select melt-setup',
-                ],
-            });
-        }
-        if (tools.cursor) {
-            toolInstructions.push({
-                name: 'Cursor',
-                steps: ['Open the command menu (Cmd+K) and search for melt-setup'],
-            });
-        }
-        if (tools.opencode) {
-            toolInstructions.push({
-                name: 'OpenCode',
-                steps: ['Type /melt-setup in the chat prompt'],
-            });
-        }
-        if (toolInstructions.length === 1 && toolInstructions[0]) {
-            console.log(chalk.dim(`  In ${toolInstructions[0].name}:`));
-            for (const step of toolInstructions[0].steps) {
-                console.log(chalk.dim(`    - ${step}`));
-            }
-        }
-        else {
-            for (const tool of toolInstructions) {
-                console.log(chalk.dim(`  ${tool.name}:`));
-                for (const step of tool.steps) {
-                    console.log(chalk.dim(`    - ${step}`));
-                }
-                console.log();
-            }
-        }
-        console.log();
-        console.log(chalk.dim('  The setup skill will analyze your project and fill in AGENTS.md.'));
-        console.log(chalk.dim('  Then run /melt-link to connect your ticket tracker and browser testing tools.'));
-        console.log();
-    }
-    console.log(chalk.green('Done!'));
-}
-async function mergeMcpConfig(cwd, templateContent) {
-    const mcpPath = path.join(cwd, '.mcp.json');
-    const templateConfig = JSON.parse(templateContent);
-    if (await fs.pathExists(mcpPath)) {
-        const existingContent = await fs.readFile(mcpPath, 'utf-8');
-        const existingConfig = JSON.parse(existingContent);
-        // Merge: add our servers without overwriting existing ones
-        existingConfig.mcpServers = {
-            ...existingConfig.mcpServers,
-            ...templateConfig.mcpServers,
-        };
-        await fs.writeFile(mcpPath, JSON.stringify(existingConfig, null, 2) + '\n', 'utf-8');
-    }
-    else {
-        await fs.writeFile(mcpPath, templateContent, 'utf-8');
-    }
-}
-async function mergeClaudeSettings(cwd, templateContent) {
-    const settingsPath = path.join(cwd, '.claude/settings.json');
-    const templateConfig = JSON.parse(templateContent);
-    if (await fs.pathExists(settingsPath)) {
-        const existingContent = await fs.readFile(settingsPath, 'utf-8');
-        const existingConfig = JSON.parse(existingContent);
-        // Merge permissions: combine allow/deny lists, deduplicate
-        const existingAllow = existingConfig.permissions?.allow ?? [];
-        const existingDeny = existingConfig.permissions?.deny ?? [];
-        const templateAllow = templateConfig.permissions?.allow ?? [];
-        const templateDeny = templateConfig.permissions?.deny ?? [];
-        existingConfig.permissions = {
-            ...existingConfig.permissions,
-            allow: [...new Set([...existingAllow, ...templateAllow])],
-            deny: [...new Set([...existingDeny, ...templateDeny])],
-        };
-        await fs.writeFile(settingsPath, JSON.stringify(existingConfig, null, 2) + '\n', 'utf-8');
-    }
-    else {
-        await fs.writeFile(settingsPath, templateContent, 'utf-8');
-    }
-}
-async function updateGitignore(cwd) {
-    const gitignorePath = path.join(cwd, '.gitignore');
-    let content = '';
-    if (await fs.pathExists(gitignorePath)) {
-        content = await fs.readFile(gitignorePath, 'utf-8');
-    }
-    const missingEntries = GITIGNORE_ENTRIES.filter(entry => !content.includes(entry));
-    if (missingEntries.length > 0) {
-        const suffix = content.endsWith('\n') || content === '' ? '' : '\n';
-        const section = missingEntries.length > 0
-            ? `${suffix}\n# Melt - local settings\n${missingEntries.join('\n')}\n`
-            : '';
-        await fs.writeFile(gitignorePath, content + section, 'utf-8');
-    }
-}

package/dist/commands/init.test.d.ts

@@ -1 +0,0 @@
-export {};