@haystackeditor/cli 0.25.1 → 0.26.0

package/dist/commands/config.js

@@ -1,549 +0,0 @@
-/**
- * Config commands - manage preferences
- *
- * Repo-level preferences (auto_merge) are stored in .haystack.json.
- * User-level preferences (agentic_tool) are stored on the Haystack Platform API.
- */
-import chalk from 'chalk';
-import { readFileSync, writeFileSync } from 'fs';
-import { resolve } from 'path';
-import { execSync } from 'child_process';
-import { resolveAuthContext } from '../utils/auth.js';
-import { AI_REVIEWER_SOURCES, AI_REVIEWER_DISPLAY_NAMES, AI_REVIEWER_BOT_USERNAMES } from '../types.js';
-const API_BASE = 'https://haystackeditor.com/api/preferences';
-const REPO_PREFERENCE_DEFAULTS = {
-    auto_merge: false,
-    auto_fix: false,
-};
-const AGENTIC_TOOL_LABELS = {
-    'opencode': 'OpenCode (Haystack billing)',
-    'claude-code': 'Claude Code (your Claude Max subscription)',
-    'codex': 'Codex CLI (your ChatGPT subscription)',
-};
-// ============================================================================
-// .haystack.json helpers (repo-level preferences)
-// ============================================================================
-function findRepoRoot() {
-    try {
-        return execSync('git rev-parse --show-toplevel', { encoding: 'utf-8' }).trim();
-    }
-    catch {
-        console.error(chalk.red('\nNot inside a git repository.\n'));
-        process.exit(1);
-    }
-}
-function loadHaystackConfig() {
-    const root = findRepoRoot();
-    const configPath = resolve(root, '.haystack.json');
-    try {
-        const raw = readFileSync(configPath, 'utf-8');
-        return { config: JSON.parse(raw), path: configPath };
-    }
-    catch (err) {
-        if (err.code === 'ENOENT') {
-            console.error(chalk.red(`\nNo .haystack.json found at ${configPath}`));
-            console.log(chalk.dim('Create one with: haystack init\n'));
-            process.exit(1);
-        }
-        throw err;
-    }
-}
-function saveHaystackConfig(config, configPath) {
-    writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
-}
-function getPreference(key) {
-    const { config } = loadHaystackConfig();
-    return config.preferences?.[key] ?? REPO_PREFERENCE_DEFAULTS[key];
-}
-function setPreference(key, value) {
-    const { config, path } = loadHaystackConfig();
-    if (!config.preferences) {
-        config.preferences = {};
-    }
-    config.preferences[key] = value;
-    saveHaystackConfig(config, path);
-}
-// ============================================================================
-// API helpers (user-level preferences)
-// ============================================================================
-async function requireAuth() {
-    try {
-        const authContext = await resolveAuthContext();
-        return authContext.token;
-    }
-    catch (err) {
-        console.error(chalk.red(`\n${err.message}\n`));
-        process.exit(1);
-    }
-}
-async function apiRequest(method, token, body) {
-    return fetch(API_BASE, {
-        method,
-        headers: {
-            'Authorization': `Bearer ${token}`,
-            'Content-Type': 'application/json',
-            'User-Agent': 'Haystack-CLI',
-        },
-        body: body ? JSON.stringify(body) : undefined,
-    });
-}
-// ============================================================================
-// Agentic tool (user-level via API)
-// ============================================================================
-export async function getAgenticToolStatus() {
-    const token = await requireAuth();
-    console.log(chalk.dim('\nFetching preferences...\n'));
-    try {
-        const response = await apiRequest('GET', token);
-        if (!response.ok) {
-            if (response.status === 401) {
-                console.error(chalk.red('Session expired. Run `haystack login` again.\n'));
-                process.exit(1);
-            }
-            throw new Error(`Failed to get preferences: ${response.status}`);
-        }
-        const data = await response.json();
-        const currentTool = data.agentic_tool || 'opencode';
-        console.log(chalk.bold('Agentic tool:'), chalk.cyan(AGENTIC_TOOL_LABELS[currentTool]));
-        console.log();
-        console.log(chalk.dim('Available options:'));
-        for (const [key, label] of Object.entries(AGENTIC_TOOL_LABELS)) {
-            const marker = key === currentTool ? chalk.green('  ✓ ') : '    ';
-            console.log(`${marker}${chalk.dim(key)} - ${label}`);
-        }
-        console.log();
-        console.log(chalk.dim('Change with: haystack config agentic-tool <tool>'));
-        console.log();
-    }
-    catch (error) {
-        console.error(chalk.red(`\nError: ${error.message}\n`));
-        process.exit(1);
-    }
-}
-export async function setAgenticTool(tool) {
-    const token = await requireAuth();
-    console.log(chalk.dim(`\nSetting agentic tool to ${tool}...`));
-    try {
-        const response = await apiRequest('PUT', token, { agentic_tool: tool });
-        if (!response.ok) {
-            if (response.status === 401) {
-                console.error(chalk.red('Session expired. Run `haystack login` again.\n'));
-                process.exit(1);
-            }
-            const error = await response.json().catch(() => ({}));
-            throw new Error(error.error || `Failed to update preferences: ${response.status}`);
-        }
-        console.log(chalk.green(`\nAgentic tool set to: ${AGENTIC_TOOL_LABELS[tool]}\n`));
-        if (tool === 'claude-code') {
-            console.log(chalk.dim('Note: Requires Claude Max subscription.'));
-            console.log(chalk.dim('Connect your account in the dashboard settings.\n'));
-        }
-        else if (tool === 'codex') {
-            console.log(chalk.dim('Note: Requires ChatGPT Plus, Pro, or Team subscription.'));
-            console.log(chalk.dim('Connect your account in the dashboard settings.\n'));
-        }
-    }
-    catch (error) {
-        console.error(chalk.red(`\nError: ${error.message}\n`));
-        process.exit(1);
-    }
-}
-export async function handleAgenticTool(tool) {
-    const validTools = ['opencode', 'claude-code', 'codex'];
-    if (!tool || tool === 'status') {
-        return getAgenticToolStatus();
-    }
-    const normalizedTool = tool.toLowerCase();
-    if (!validTools.includes(normalizedTool)) {
-        console.error(chalk.red(`\nUnknown tool: ${tool}`));
-        console.log('\nValid options:');
-        for (const [key, label] of Object.entries(AGENTIC_TOOL_LABELS)) {
-            console.log(`  ${chalk.cyan(key)} - ${label}`);
-        }
-        console.log('\nUsage: haystack config agentic-tool [opencode|claude-code|codex|status]\n');
-        process.exit(1);
-    }
-    return setAgenticTool(normalizedTool);
-}
-// ============================================================================
-// Auto-merge (repo-level via .haystack.json)
-// ============================================================================
-/**
- * Surface unexpected errors when reading repo-level preferences while keeping
- * the silent fallback for the expected "no .haystack.json" case. ENOENT means
- * the user simply hasn't opted in; everything else (parse errors, permission
- * denied, not-a-git-repo) is a config problem the user should see — silently
- * defaulting to disabled would otherwise hide the misconfiguration.
- */
-function logPreferenceLookupFailure(preference, err) {
-    if (err?.code === 'ENOENT')
-        return;
-    const message = err instanceof Error ? err.message : String(err);
-    console.error(chalk.dim(`[haystack] Could not resolve ${preference} preference (${message}); defaulting to disabled.`));
-}
-/**
- * Check if auto-merge is enabled for the current repo.
- * Returns false if .haystack.json is missing or on error.
- *
- * NOTE: This does NOT go through loadHaystackConfig() because that function
- * calls process.exit(1) when .haystack.json is missing — which is uncatchable
- * by try/catch. We read the file directly so missing config safely returns false.
- */
-export async function isAutoMergeEnabled() {
-    try {
-        const root = execSync('git rev-parse --show-toplevel', { encoding: 'utf-8' }).trim();
-        const raw = readFileSync(resolve(root, '.haystack.json'), 'utf-8');
-        const config = JSON.parse(raw);
-        return config.preferences?.auto_merge ?? false;
-    }
-    catch (err) {
-        logPreferenceLookupFailure('auto_merge', err);
-        return false;
-    }
-}
-/** Read the two queue-side toggles that depend on auto-merge. We re-read the
- *  file rather than calling getPreference() because those settings live under
- *  `merge_queue.*` instead of `preferences.*`. Returns null fields when the
- *  config is missing or can't be parsed — callers treat null as "not set".
- *  Note: loadHaystackConfig() process.exit(1)s on ENOENT, so this catch only
- *  fires for unexpected failures (parse errors, permission denied). We use the
- *  same logging helper as the other preference readers so failures surface in
- *  stderr instead of silently rolling back to defaults. */
-function readDependentToggles() {
-    try {
-        const { config } = loadHaystackConfig();
-        return {
-            autoResolveConflicts: config.merge_queue?.auto_resolve_conflicts ?? null,
-            autoFixCiFailures: config.merge_queue?.auto_fix_ci_failures ?? null,
-        };
-    }
-    catch (err) {
-        logPreferenceLookupFailure('merge_queue dependent toggles', err);
-        return { autoResolveConflicts: null, autoFixCiFailures: null };
-    }
-}
-function printDependencyNote(autoMergeEnabled) {
-    const deps = readDependentToggles();
-    // Only mention dependents that are explicitly configured — silent for repos
-    // that never set them. Both rely on auto-merge because they're merge-queue
-    // features that only fire on enqueued PRs.
-    const items = [];
-    if (deps.autoResolveConflicts != null)
-        items.push(`auto-resolve-conflicts (${deps.autoResolveConflicts ? 'on' : 'off'})`);
-    if (deps.autoFixCiFailures != null)
-        items.push(`auto-fix-ci-failures (${deps.autoFixCiFailures ? 'on' : 'off'})`);
-    if (items.length === 0)
-        return;
-    if (autoMergeEnabled) {
-        console.log(chalk.dim(`Tied to auto-merge: ${items.join(', ')}.`));
-    }
-    else {
-        console.log(chalk.yellow(`Note: ${items.join(', ')} won't run while auto-merge is off — these are merge-queue features that only fire on enqueued PRs.`));
-    }
-}
-export async function getAutoMergeStatus() {
-    const enabled = getPreference('auto_merge');
-    console.log(chalk.bold('\nAuto-merge:'), enabled
-        ? chalk.green('enabled')
-        : chalk.yellow('disabled'));
-    console.log();
-    if (enabled) {
-        console.log(chalk.dim('PRs submitted via `haystack submit` will be auto-merged'));
-        console.log(chalk.dim('when analysis finds no issues (safe to merge).'));
-    }
-    else {
-        console.log(chalk.dim('Auto-merge is disabled. PRs require manual merge.'));
-        console.log(chalk.dim('Enable with: haystack config auto-merge on'));
-    }
-    printDependencyNote(enabled);
-    console.log(chalk.dim('(Stored in .haystack.json — applies to all repo contributors)'));
-    console.log();
-}
-export async function enableAutoMerge() {
-    setPreference('auto_merge', true);
-    console.log(chalk.green('\nAuto-merge enabled.\n'));
-    console.log(chalk.dim('PRs submitted via `haystack submit` will be auto-merged'));
-    console.log(chalk.dim('when analysis finds no issues (safe to merge).'));
-    printDependencyNote(true);
-    console.log(chalk.dim('Commit .haystack.json to share with your team.\n'));
-}
-export async function disableAutoMerge() {
-    setPreference('auto_merge', false);
-    console.log(chalk.yellow('\nAuto-merge disabled.\n'));
-    console.log(chalk.dim('PRs will require manual merge after analysis.'));
-    console.log(chalk.dim('Re-enable with: haystack config auto-merge on'));
-    printDependencyNote(false);
-    console.log(chalk.dim('Commit .haystack.json to share with your team.\n'));
-}
-export async function handleAutoMerge(action) {
-    switch (action?.toLowerCase()) {
-        case 'on':
-        case 'enable':
-        case 'true':
-            return enableAutoMerge();
-        case 'off':
-        case 'disable':
-        case 'false':
-            return disableAutoMerge();
-        case 'status':
-        case undefined:
-            return getAutoMergeStatus();
-        default:
-            console.error(chalk.red(`\nUnknown action: ${action}`));
-            console.log('\nUsage: haystack config auto-merge [on|off|status]\n');
-            process.exit(1);
-    }
-}
-// ============================================================================
-// Auto-fix (repo-level via .haystack.json) — alpha
-// ============================================================================
-/**
- * Check if auto-fix is enabled for the current repo.
- * Returns false if .haystack.json is missing or on error.
- *
- * Mirrors isAutoMergeEnabled() — direct file read so missing config returns
- * false instead of process.exit(1).
- */
-export async function isAutoFixEnabled() {
-    try {
-        const root = execSync('git rev-parse --show-toplevel', { encoding: 'utf-8' }).trim();
-        const raw = readFileSync(resolve(root, '.haystack.json'), 'utf-8');
-        const config = JSON.parse(raw);
-        return config.preferences?.auto_fix ?? false;
-    }
-    catch (err) {
-        logPreferenceLookupFailure('auto_fix', err);
-        return false;
-    }
-}
-export async function getAutoFixStatus() {
-    const enabled = getPreference('auto_fix');
-    console.log(chalk.bold('\nAuto-fix (alpha):'), enabled
-        ? chalk.green('enabled')
-        : chalk.yellow('disabled'));
-    console.log();
-    if (enabled) {
-        console.log(chalk.dim('PRs submitted via `haystack submit` will be labeled'));
-        console.log(chalk.dim('haystack:auto-fix. Analysis will dispatch the alpha'));
-        console.log(chalk.dim('sandbox fixer for straightforward mechanical issues.'));
-    }
-    else {
-        console.log(chalk.dim('Auto-fix is disabled. Issues surface in the Feed for review.'));
-        console.log(chalk.dim('Enable with: haystack config auto-fix on'));
-    }
-    console.log(chalk.yellow('⚠ Auto-fix is alpha. Expect rough edges.'));
-    console.log(chalk.dim('(Stored in .haystack.json — applies to all repo contributors)'));
-    console.log();
-}
-export async function enableAutoFix() {
-    setPreference('auto_fix', true);
-    console.log(chalk.green('\nAuto-fix (alpha) enabled.\n'));
-    console.log(chalk.dim('PRs submitted via `haystack submit` will be labeled'));
-    console.log(chalk.dim('haystack:auto-fix. The sandbox fixer will attempt'));
-    console.log(chalk.dim('straightforward mechanical fixes before issues hit the Feed.'));
-    console.log(chalk.yellow('⚠ Auto-fix is alpha. Expect rough edges.'));
-    console.log(chalk.dim('Commit .haystack.json to share with your team.\n'));
-}
-export async function disableAutoFix() {
-    setPreference('auto_fix', false);
-    console.log(chalk.yellow('\nAuto-fix disabled.\n'));
-    console.log(chalk.dim('Issues will surface in the Feed for human review.'));
-    console.log(chalk.dim('Re-enable with: haystack config auto-fix on'));
-    console.log(chalk.dim('Commit .haystack.json to share with your team.\n'));
-}
-export async function handleAutoFix(action) {
-    switch (action?.toLowerCase()) {
-        case 'on':
-        case 'enable':
-        case 'true':
-            return enableAutoFix();
-        case 'off':
-        case 'disable':
-        case 'false':
-            return disableAutoFix();
-        case 'status':
-        case undefined:
-            return getAutoFixStatus();
-        default:
-            console.error(chalk.red(`\nUnknown action: ${action}`));
-            console.log('\nUsage: haystack config auto-fix [on|off|status]\n');
-            process.exit(1);
-    }
-}
-// ============================================================================
-// Wait-for-reviewers (repo-level via .haystack.json)
-// ============================================================================
-/** Reverse map: bot username → friendly source name */
-const BOT_USERNAME_TO_SOURCE = {};
-for (const source of AI_REVIEWER_SOURCES) {
-    BOT_USERNAME_TO_SOURCE[AI_REVIEWER_BOT_USERNAMES[source]] = source;
-}
-function getMergeQueueConfig() {
-    const { config, path } = loadHaystackConfig();
-    const mergeConfig = config.merge_queue ?? {};
-    const bots = mergeConfig.wait_for_reviewer?.bots ?? [];
-    return { config, path, bots };
-}
-function saveMergeQueueBots(config, configPath, bots, timeoutMinutes) {
-    const mergeConfig = config.merge_queue ?? {};
-    if (bots.length > 0) {
-        mergeConfig.wait_for_reviewer = {
-            bots,
-            ...(timeoutMinutes != null ? { timeout_minutes: timeoutMinutes } : mergeConfig.wait_for_reviewer?.timeout_minutes != null ? { timeout_minutes: mergeConfig.wait_for_reviewer.timeout_minutes } : {}),
-        };
-    }
-    else {
-        delete mergeConfig.wait_for_reviewer;
-    }
-    // Always write to merge_queue (new key)
-    config.merge_queue = mergeConfig;
-    saveHaystackConfig(config, configPath);
-}
-function printAvailableReviewers(currentBots) {
-    const currentSet = new Set(currentBots);
-    console.log(chalk.dim('Available AI reviewer sources:'));
-    for (const source of AI_REVIEWER_SOURCES) {
-        const name = AI_REVIEWER_DISPLAY_NAMES[source];
-        const botUsername = AI_REVIEWER_BOT_USERNAMES[source];
-        const active = currentSet.has(botUsername);
-        const marker = active ? chalk.green('  ✓ ') : '    ';
-        console.log(`${marker}${chalk.cyan(source)} — ${name} ${chalk.dim(`(${botUsername})`)}`);
-    }
-    console.log();
-}
-/**
- * Resolve a source name (e.g. "cursor") to its GitHub bot username. Raw bot
- * usernames (anything ending in `[bot]`) pass through unchanged.
- *
- * Unknown names are REJECTED, not stored: this value must exactly match a
- * GitHub bot login or the merge queue waits forever for a reviewer that can
- * never post. (A typo used to be saved verbatim and reported as success.)
- */
-export function resolveToBot(input) {
-    const lower = input.toLowerCase();
-    if (AI_REVIEWER_SOURCES.includes(lower)) {
-        return AI_REVIEWER_BOT_USERNAMES[lower];
-    }
-    if (input.endsWith('[bot]')) {
-        return input;
-    }
-    throw new Error(`Unknown reviewer: "${input}".\n\n` +
-        `Use a friendly name (${AI_REVIEWER_SOURCES.join(', ')})\n` +
-        `or an exact GitHub bot username ending in [bot] (e.g. cursor-bugbot[bot]).`);
-}
-/** Like resolveToBot, but unknown names pass through verbatim (for `remove`). */
-function resolveToBotLenient(input) {
-    const lower = input.toLowerCase();
-    if (AI_REVIEWER_SOURCES.includes(lower)) {
-        return AI_REVIEWER_BOT_USERNAMES[lower];
-    }
-    return input;
-}
-function displayName(botUsername) {
-    const source = BOT_USERNAME_TO_SOURCE[botUsername];
-    if (source) {
-        return `${AI_REVIEWER_DISPLAY_NAMES[source]} (${botUsername})`;
-    }
-    return botUsername;
-}
-export async function handleWaitForReviewers(action, reviewers) {
-    const normalizedAction = action?.toLowerCase();
-    // Default: show status
-    if (!normalizedAction || normalizedAction === 'list' || normalizedAction === 'status') {
-        const { bots } = getMergeQueueConfig();
-        console.log(chalk.bold('\nWait for AI reviewers\n'));
-        if (bots.length > 0) {
-            console.log('Haystack will wait for ALL of these bots to post before showing PRs in the inbox:');
-            for (const bot of bots) {
-                console.log(`  ${chalk.green(displayName(bot))}`);
-            }
-            console.log();
-            console.log(chalk.dim('Note: AI reviewers with check runs (CodeRabbit, Greptile, Cursor BugBot, etc.)'));
-            console.log(chalk.dim('are detected automatically. Only configure review-only bots here (e.g. Copilot).'));
-        }
-        else {
-            console.log('No review-only AI reviewers configured.');
-            console.log(chalk.dim('AI reviewers with check runs are still detected automatically.'));
-        }
-        console.log();
-        printAvailableReviewers(bots);
-        console.log(chalk.dim('Add with:    haystack config wait-for-reviewers add cursor coderabbit'));
-        console.log(chalk.dim('Or raw bot:  haystack config wait-for-reviewers add cursor-bugbot[bot]'));
-        console.log();
-        return;
-    }
-    if (normalizedAction === 'add') {
-        if (!reviewers || reviewers.length === 0) {
-            console.error(chalk.red('\nSpecify at least one reviewer to add.'));
-            const { bots } = getMergeQueueConfig();
-            console.log();
-            printAvailableReviewers(bots);
-            process.exit(1);
-            return; // unreachable — satisfies TS narrowing
-        }
-        let resolved;
-        try {
-            resolved = reviewers.map(resolveToBot);
-        }
-        catch (err) {
-            console.error(chalk.red(`\n${err.message}\n`));
-            process.exit(1);
-            return; // unreachable — satisfies TS narrowing
-        }
-        const { config, path, bots: current } = getMergeQueueConfig();
-        const merged = Array.from(new Set([...current, ...resolved]));
-        saveMergeQueueBots(config, path, merged);
-        const added = resolved.filter(b => !current.includes(b));
-        if (added.length > 0) {
-            console.log(chalk.green(`\nAdded: ${added.map(displayName).join(', ')}`));
-        }
-        else {
-            console.log(chalk.dim('\nAll specified reviewers were already configured.'));
-        }
-        console.log(chalk.dim('Commit .haystack.json to share with your team.\n'));
-        return;
-    }
-    if (normalizedAction === 'remove') {
-        if (!reviewers || reviewers.length === 0) {
-            console.error(chalk.red('\nSpecify at least one reviewer to remove.'));
-            process.exit(1);
-            return; // unreachable — satisfies TS narrowing
-        }
-        // Lenient on remove: stored entries may predate strict validation
-        // (arbitrary strings used to be saved verbatim), and removing them must
-        // stay possible.
-        const resolved = reviewers.map(resolveToBotLenient);
-        const { config, path, bots: current } = getMergeQueueConfig();
-        const removeSet = new Set(resolved);
-        const remaining = current.filter(b => !removeSet.has(b));
-        saveMergeQueueBots(config, path, remaining);
-        const removed = resolved.filter(b => current.includes(b));
-        if (removed.length > 0) {
-            console.log(chalk.yellow(`\nRemoved: ${removed.map(displayName).join(', ')}`));
-        }
-        else {
-            console.log(chalk.dim('\nNone of the specified reviewers were configured.'));
-        }
-        console.log(chalk.dim('Commit .haystack.json to share with your team.\n'));
-        return;
-    }
-    if (normalizedAction === 'clear') {
-        const { config, path } = getMergeQueueConfig();
-        saveMergeQueueBots(config, path, []);
-        console.log(chalk.yellow('\nCleared all expected AI reviewers.'));
-        console.log(chalk.dim('The merge queue will not wait for any external reviewers.'));
-        console.log(chalk.dim('Commit .haystack.json to share with your team.\n'));
-        return;
-    }
-    // Unknown action — reject it. This used to fall through to an implicit
-    // "add", so a typo'd action (`wait-for-reviewers ad cursor`) silently
-    // stored a bogus bot named "ad" and reported success.
-    console.error(chalk.red(`\nUnknown action: "${action}".`));
-    console.log('\nActions:');
-    console.log('  list            Show configured reviewer bots (default)');
-    console.log('  add <names>     Add one or more reviewer bots');
-    console.log('  remove <names>  Remove one or more reviewer bots');
-    console.log('  clear           Remove all reviewer bots');
-    console.log(chalk.dim('\nExample: haystack config wait-for-reviewers add cursor\n'));
-    process.exit(1);
-}