@haystackeditor/cli 0.8.0 → 0.9.0

package/dist/commands/config.js

@@ -1,9 +1,69 @@
 /**
- * Config commands - manage user preferences stored on Haystack Platform
+ * Config commands - manage preferences
+ *
+ * Repo-level preferences (sandbox_enabled, 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 { loadToken } from './login.js';
+import { AI_REVIEWER_SOURCES, AI_REVIEWER_DISPLAY_NAMES } from '../types.js';
 const API_BASE = 'https://haystackeditor.com/api/preferences';
+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();
+    // Default: sandbox_enabled=true, auto_merge=false
+    const defaults = { sandbox_enabled: true, auto_merge: false };
+    return config.preferences?.[key] ?? 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() {
     const token = await loadToken();
     if (!token) {
@@ -13,7 +73,7 @@ async function requireAuth() {
     return token;
 }
 async function apiRequest(method, token, body) {
-    const response = await fetch(API_BASE, {
+    return fetch(API_BASE, {
         method,
         headers: {
             'Authorization': `Bearer ${token}`,
@@ -22,12 +82,64 @@ async function apiRequest(method, token, body) {
         },
         body: body ? JSON.stringify(body) : undefined,
     });
-    return response;
 }
-/**
- * Get current sandbox status
- */
+// ============================================================================
+// Sandbox (repo-level via .haystack.json)
+// ============================================================================
 export async function getSandboxStatus() {
+    const enabled = getPreference('sandbox_enabled');
+    console.log(chalk.bold('\nSandbox mode:'), enabled
+        ? chalk.green('enabled')
+        : chalk.yellow('disabled'));
+    console.log();
+    if (enabled) {
+        console.log(chalk.dim('Haystack can clone and store your repos for verification.'));
+        console.log(chalk.dim('All data is deleted after 24 hours.'));
+    }
+    else {
+        console.log(chalk.dim('Sandbox mode is disabled. Automated verification will not work.'));
+        console.log(chalk.dim('Enable with: haystack config sandbox on'));
+    }
+    console.log(chalk.dim('(Stored in .haystack.json — applies to all repo contributors)'));
+    console.log();
+}
+export async function enableSandbox() {
+    setPreference('sandbox_enabled', true);
+    console.log(chalk.green('\nSandbox mode enabled.\n'));
+    console.log(chalk.dim('Haystack can now clone and store your repos for verification.'));
+    console.log(chalk.dim('All data is deleted after 24 hours.'));
+    console.log(chalk.dim('Commit .haystack.json to share with your team.\n'));
+}
+export async function disableSandbox() {
+    setPreference('sandbox_enabled', false);
+    console.log(chalk.yellow('\nSandbox mode disabled.\n'));
+    console.log(chalk.dim('Automated verification will not work until you re-enable sandbox mode.'));
+    console.log(chalk.dim('Re-enable with: haystack config sandbox on'));
+    console.log(chalk.dim('Commit .haystack.json to share with your team.\n'));
+}
+export async function handleSandbox(action) {
+    switch (action?.toLowerCase()) {
+        case 'on':
+        case 'enable':
+        case 'true':
+            return enableSandbox();
+        case 'off':
+        case 'disable':
+        case 'false':
+            return disableSandbox();
+        case 'status':
+        case undefined:
+            return getSandboxStatus();
+        default:
+            console.error(chalk.red(`\nUnknown action: ${action}`));
+            console.log('\nUsage: haystack config sandbox [on|off|status]\n');
+            process.exit(1);
+    }
+}
+// ============================================================================
+// Agentic tool (user-level via API)
+// ============================================================================
+export async function getAgenticToolStatus() {
     const token = await requireAuth();
     console.log(chalk.dim('\nFetching preferences...\n'));
     try {
@@ -40,33 +152,28 @@ export async function getSandboxStatus() {
             throw new Error(`Failed to get preferences: ${response.status}`);
         }
         const data = await response.json();
-        console.log(chalk.bold('Sandbox mode:'), data.sandbox_enabled
-            ? chalk.green('enabled')
-            : chalk.yellow('disabled'));
+        const currentTool = data.agentic_tool || 'opencode';
+        console.log(chalk.bold('Agentic tool:'), chalk.cyan(AGENTIC_TOOL_LABELS[currentTool]));
         console.log();
-        if (data.sandbox_enabled) {
-            console.log(chalk.dim('Haystack can clone and store your repos for verification.'));
-            console.log(chalk.dim('All data is deleted after 24 hours.'));
-        }
-        else {
-            console.log(chalk.dim('Sandbox mode is disabled. Automated verification will not work.'));
-            console.log(chalk.dim('Enable with: haystack config sandbox on'));
+        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);
     }
 }
-/**
- * Enable sandbox mode
- */
-export async function enableSandbox() {
+export async function setAgenticTool(tool) {
     const token = await requireAuth();
-    console.log(chalk.dim('\nEnabling sandbox mode...'));
+    console.log(chalk.dim(`\nSetting agentic tool to ${tool}...`));
     try {
-        const response = await apiRequest('PUT', token, { sandbox_enabled: true });
+        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'));
@@ -75,59 +182,227 @@ export async function enableSandbox() {
             const error = await response.json().catch(() => ({}));
             throw new Error(error.error || `Failed to update preferences: ${response.status}`);
         }
-        console.log(chalk.green('\nSandbox mode enabled.\n'));
-        console.log(chalk.dim('Haystack can now clone and store your repos for verification.'));
-        console.log(chalk.dim('All data is deleted after 24 hours.\n'));
+        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);
     }
 }
-/**
- * Disable sandbox mode
- */
-export async function disableSandbox() {
-    const token = await requireAuth();
-    console.log(chalk.dim('\nDisabling sandbox mode...'));
-    try {
-        const response = await apiRequest('PUT', token, { sandbox_enabled: false });
-        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.yellow('\nSandbox mode disabled.\n'));
-        console.log(chalk.dim('Automated verification will not work until you re-enable sandbox mode.'));
-        console.log(chalk.dim('Re-enable with: haystack config sandbox on\n'));
+export async function handleAgenticTool(tool) {
+    const validTools = ['opencode', 'claude-code', 'codex'];
+    if (!tool || tool === 'status') {
+        return getAgenticToolStatus();
     }
-    catch (error) {
-        console.error(chalk.red(`\nError: ${error.message}\n`));
+    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)
+// ============================================================================
 /**
- * Handle sandbox subcommand
+ * Check if auto-merge is enabled for the current repo.
+ * Returns false if .haystack.json is missing or on error.
  */
-export async function handleSandbox(action) {
+export async function isAutoMergeEnabled() {
+    try {
+        return getPreference('auto_merge');
+    }
+    catch {
+        return false;
+    }
+}
+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'));
+    }
+    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).'));
+    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'));
+    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 enableSandbox();
+            return enableAutoMerge();
         case 'off':
         case 'disable':
         case 'false':
-            return disableSandbox();
+            return disableAutoMerge();
         case 'status':
         case undefined:
-            return getSandboxStatus();
+            return getAutoMergeStatus();
         default:
             console.error(chalk.red(`\nUnknown action: ${action}`));
-            console.log('\nUsage: haystack config sandbox [on|off|status]\n');
+            console.log('\nUsage: haystack config auto-merge [on|off|status]\n');
             process.exit(1);
     }
 }
+// ============================================================================
+// Wait-for-reviewers (repo-level via .haystack.json)
+// ============================================================================
+function getBabysitterConfig() {
+    const { config, path } = loadHaystackConfig();
+    const babysitter = config.babysitter ?? {};
+    const reviewers = babysitter.expected_ai_reviewers ?? [];
+    return { config, path, reviewers };
+}
+function saveBabysitterReviewers(config, configPath, reviewers) {
+    const babysitter = config.babysitter ?? {};
+    babysitter.expected_ai_reviewers = reviewers.length > 0 ? reviewers : undefined;
+    config.babysitter = babysitter;
+    saveHaystackConfig(config, configPath);
+}
+function printAvailableReviewers(currentReviewers) {
+    const currentSet = new Set(currentReviewers);
+    console.log(chalk.dim('Available AI reviewer sources:'));
+    for (const source of AI_REVIEWER_SOURCES) {
+        const name = AI_REVIEWER_DISPLAY_NAMES[source];
+        const active = currentSet.has(source);
+        const marker = active ? chalk.green('  ✓ ') : '    ';
+        console.log(`${marker}${chalk.cyan(source)} — ${name}`);
+    }
+    console.log();
+}
+function validateReviewerSources(sources) {
+    const validSet = new Set(AI_REVIEWER_SOURCES);
+    const invalid = sources.filter(s => !validSet.has(s));
+    if (invalid.length > 0) {
+        console.error(chalk.red(`\nUnknown reviewer source(s): ${invalid.join(', ')}`));
+        console.log(chalk.dim(`\nValid sources: ${AI_REVIEWER_SOURCES.join(', ')}`));
+        process.exit(1);
+    }
+    return sources;
+}
+export async function handleWaitForReviewers(action, reviewers) {
+    const normalizedAction = action?.toLowerCase();
+    // Default: show status
+    if (!normalizedAction || normalizedAction === 'list' || normalizedAction === 'status') {
+        const { reviewers: current } = getBabysitterConfig();
+        console.log(chalk.bold('\nMerge queue — expected AI reviewers\n'));
+        if (current.length > 0) {
+            console.log('The merge queue will wait for these external reviewers before merging:');
+            for (const source of current) {
+                const name = AI_REVIEWER_DISPLAY_NAMES[source] ?? source;
+                console.log(`  ${chalk.green(name)} ${chalk.dim(`(${source})`)}`);
+            }
+        }
+        else {
+            console.log('No external AI reviewers configured.');
+            console.log(chalk.dim('The merge queue will not wait for any external reviewers.'));
+        }
+        console.log();
+        printAvailableReviewers(current);
+        console.log(chalk.dim('Add with: haystack config wait-for-reviewers add <source>'));
+        console.log();
+        return;
+    }
+    if (normalizedAction === 'add') {
+        if (!reviewers || reviewers.length === 0) {
+            console.error(chalk.red('\nSpecify at least one reviewer source to add.'));
+            const { reviewers: current } = getBabysitterConfig();
+            console.log();
+            printAvailableReviewers(current);
+            process.exit(1);
+        }
+        const validated = validateReviewerSources(reviewers);
+        const { config, path, reviewers: current } = getBabysitterConfig();
+        const merged = Array.from(new Set([...current, ...validated]));
+        saveBabysitterReviewers(config, path, merged);
+        const added = validated.filter(s => !current.includes(s));
+        if (added.length > 0) {
+            console.log(chalk.green(`\nAdded: ${added.map(s => AI_REVIEWER_DISPLAY_NAMES[s] ?? s).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 source to remove.'));
+            process.exit(1);
+        }
+        const validated = validateReviewerSources(reviewers);
+        const { config, path, reviewers: current } = getBabysitterConfig();
+        const removeSet = new Set(validated);
+        const remaining = current.filter(s => !removeSet.has(s));
+        saveBabysitterReviewers(config, path, remaining);
+        const removed = validated.filter(s => current.includes(s));
+        if (removed.length > 0) {
+            console.log(chalk.yellow(`\nRemoved: ${removed.map(s => AI_REVIEWER_DISPLAY_NAMES[s] ?? s).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 } = getBabysitterConfig();
+        saveBabysitterReviewers(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 — maybe the user passed a reviewer name directly
+    // Try treating action + reviewers as all reviewer names for 'add'
+    const allNames = [action, ...(reviewers ?? [])];
+    const validSet = new Set(AI_REVIEWER_SOURCES);
+    if (allNames.every(n => validSet.has(n))) {
+        // Treat as implicit 'add'
+        const validated = validateReviewerSources(allNames);
+        const { config, path, reviewers: current } = getBabysitterConfig();
+        const merged = Array.from(new Set([...current, ...validated]));
+        saveBabysitterReviewers(config, path, merged);
+        console.log(chalk.green(`\nAdded: ${validated.map(s => AI_REVIEWER_DISPLAY_NAMES[s] ?? s).join(', ')}`));
+        console.log(chalk.dim('Commit .haystack.json to share with your team.\n'));
+        return;
+    }
+    console.error(chalk.red(`\nUnknown action: ${action}`));
+    console.log('\nUsage: haystack config wait-for-reviewers [list|add|remove|clear] [sources...]\n');
+    process.exit(1);
+}

package/dist/commands/hooks.d.ts

@@ -0,0 +1,17 @@
+/**
+ * haystack hooks - Install and manage git hooks for AI agent quality checks
+ *
+ * Installs:
+ *   - Entire CLI binary (session tracking, powered by https://entire.dev)
+ *   - Pre-commit hook (agent detection, truncation checking, LLM rules review)
+ *   - Git hooks for session logging (commit-msg, post-commit, pre-push, prepare-commit-msg)
+ */
+interface HooksInstallOptions {
+    version?: string;
+    force?: boolean;
+    skipEntire?: boolean;
+}
+export declare function hooksInstall(options: HooksInstallOptions): Promise<void>;
+export declare function hooksStatus(): Promise<void>;
+export declare function hooksUpdate(): Promise<void>;
+export {};