@haystackeditor/cli 0.8.1 → 0.10.0

package/dist/commands/init.js

@@ -7,7 +7,8 @@ import chalk from 'chalk';
 import * as path from 'path';
 import { detectProject } from '../utils/detect.js';
 import { saveConfig, configExists } from '../utils/config.js';
-import { createSkillFile, createClaudeCommand } from '../utils/skill.js';
+// HIDDEN: Verification flow — uncomment to re-enable
+// import { createSkillFile, createClaudeCommand } from '../utils/skill.js';
 import { validateConfigSecurity, formatSecurityReport } from '../utils/secrets.js';
 export async function initCommand(options) {
     console.log(chalk.cyan('\n🌾 Haystack Setup\n'));
@@ -36,23 +37,17 @@ export async function initCommand(options) {
     const config = buildConfigFromDetection(detected);
     const configPath = await saveConfig(config);
     console.log(chalk.green(`✓ Created ${configPath}`));
-    // Create skill file for agent discovery
-    const skillPath = await createSkillFile();
-    console.log(chalk.green(`✓ Created ${skillPath}`));
-    // Create Claude Code slash command
-    const commandPath = await createClaudeCommand();
-    console.log(chalk.green(`✓ Created ${commandPath}`));
+    // HIDDEN: Verification flow — uncomment to re-enable
+    // // Create skill file for agent discovery
+    // const skillPath = await createSkillFile();
+    // console.log(chalk.green(`✓ Created ${skillPath}`));
+    //
+    // // Create Claude Code slash command
+    // const commandPath = await createClaudeCommand();
+    // console.log(chalk.green(`✓ Created ${commandPath}`));
     // Security validation
     await runSecurityCheck(configPath);
-    // Print next steps - direct to skill
-    console.log(chalk.cyan('\n━'.repeat(60)));
-    console.log(chalk.cyan.bold('\n📋 NEXT: Add verification flows\n'));
-    console.log(chalk.white('Base config created. Now an AI agent needs to add flows.\n'));
-    console.log(chalk.bold('Option 1: Claude Code'));
-    console.log(chalk.dim('  Run /setup-haystack in Claude Code\n'));
-    console.log(chalk.bold('Option 2: Other AI agents'));
-    console.log(chalk.dim('  Give your agent: "Read .agents/skills/setup-haystack.md and follow it"\n'));
-    console.log(chalk.cyan('━'.repeat(60) + '\n'));
+    console.log(chalk.green('\nDone! Run `haystack setup` to configure rules, signals, and policies.\n'));
 }
 /**
  * Run security check on config file
@@ -91,12 +86,13 @@ function buildConfigFromDetection(detected) {
             version: '1',
             name: path.basename(process.cwd()),
             services,
-            verification: {
-                commands: [
-                    { name: 'build', run: `${detected.packageManager} build` },
-                    { name: 'lint', run: `${detected.packageManager} lint` },
-                ],
-            },
+            // HIDDEN: Verification flow — uncomment to re-enable
+            // verification: {
+            //   commands: [
+            //     { name: 'build', run: `${detected.packageManager} build` },
+            //     { name: 'lint', run: `${detected.packageManager} lint` },
+            //   ],
+            // },
         };
     }
     return {
@@ -108,11 +104,12 @@ function buildConfigFromDetection(detected) {
             ready_pattern: detected.suggestedReadyPattern || 'Local:',
             ...(Object.keys(env).length > 0 ? { env } : {}),
         },
-        verification: {
-            commands: [
-                { name: 'build', run: `${detected.packageManager} build` },
-                { name: 'lint', run: `${detected.packageManager} lint` },
-            ],
-        },
+        // HIDDEN: Verification flow — uncomment to re-enable
+        // verification: {
+        //   commands: [
+        //     { name: 'build', run: `${detected.packageManager} build` },
+        //     { name: 'lint', run: `${detected.packageManager} lint` },
+        //   ],
+        // },
     };
 }

package/dist/commands/install-session-hooks.d.ts

@@ -0,0 +1,16 @@
+/**
+ * install-session-hooks — Wire up session-start hooks for coding CLIs.
+ *
+ * When a CLI session starts, `haystack check-pending --hook` runs automatically
+ * and shows the user whether their pending PRs are "Good to merge" or "Need input".
+ *
+ * Supported CLIs:
+ *   - Claude Code: Native SessionStart hook in .claude/settings.json
+ *   - Codex CLI:   AGENTS.md instructions (no native hook support)
+ *   - Gemini CLI:  GEMINI.md instructions (no native hook support)
+ */
+export interface InstallSessionOptions {
+    cli?: string;
+}
+export declare function installSessionHooks(options: InstallSessionOptions): Promise<void>;
+export declare function sessionHooksStatus(): Promise<void>;

package/dist/commands/install-session-hooks.js

@@ -0,0 +1,302 @@
+/**
+ * install-session-hooks — Wire up session-start hooks for coding CLIs.
+ *
+ * When a CLI session starts, `haystack check-pending --hook` runs automatically
+ * and shows the user whether their pending PRs are "Good to merge" or "Need input".
+ *
+ * Supported CLIs:
+ *   - Claude Code: Native SessionStart hook in .claude/settings.json
+ *   - Codex CLI:   AGENTS.md instructions (no native hook support)
+ *   - Gemini CLI:  GEMINI.md instructions (no native hook support)
+ */
+import { execSync } from 'child_process';
+import chalk from 'chalk';
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { findGitRoot } from '../utils/git.js';
+// ============================================================================
+// CLI detection (reused from triage runner pattern)
+// ============================================================================
+function isCLIInstalled(name) {
+    try {
+        execSync(process.platform === 'win32' ? `where ${name}` : `which ${name}`, {
+            stdio: 'ignore',
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function detectInstalledCLIs() {
+    const installed = [];
+    if (isCLIInstalled('claude'))
+        installed.push('claude');
+    if (isCLIInstalled('codex'))
+        installed.push('codex');
+    if (isCLIInstalled('gemini'))
+        installed.push('gemini');
+    return installed;
+}
+// ============================================================================
+// Claude Code: Native SessionStart hook
+// ============================================================================
+const HAYSTACK_HOOK_COMMAND = 'haystack check-pending --hook';
+function installClaudeHook(gitRoot) {
+    const settingsDir = join(gitRoot, '.claude');
+    const settingsPath = join(settingsDir, 'settings.json');
+    try {
+        // Ensure .claude directory exists
+        if (!existsSync(settingsDir)) {
+            mkdirSync(settingsDir, { recursive: true });
+        }
+        // Read or create settings
+        let settings = {};
+        if (existsSync(settingsPath)) {
+            settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+        }
+        // Ensure hooks object exists
+        const hooks = (settings.hooks || {});
+        settings.hooks = hooks;
+        // Ensure SessionStart array exists
+        const sessionStart = (hooks.SessionStart || []);
+        hooks.SessionStart = sessionStart;
+        // Check if haystack hook already installed
+        const alreadyInstalled = sessionStart.some(entry => entry.hooks?.some(h => h.command?.includes('haystack check-pending')));
+        if (alreadyInstalled) {
+            console.log(chalk.dim('  Claude Code hook already installed.'));
+            return true;
+        }
+        // Add the hook
+        sessionStart.push({
+            matcher: '',
+            hooks: [
+                {
+                    type: 'command',
+                    command: HAYSTACK_HOOK_COMMAND,
+                },
+            ],
+        });
+        writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+        return true;
+    }
+    catch (err) {
+        console.error(chalk.red(`  Failed to update .claude/settings.json: ${err}`));
+        return false;
+    }
+}
+function checkClaudeHook(gitRoot) {
+    const settingsPath = join(gitRoot, '.claude', 'settings.json');
+    if (!existsSync(settingsPath))
+        return false;
+    try {
+        const settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+        const sessionStart = settings?.hooks?.SessionStart || [];
+        return sessionStart.some((entry) => entry.hooks?.some((h) => h.command?.includes('haystack check-pending')));
+    }
+    catch {
+        return false;
+    }
+}
+// ============================================================================
+// Codex CLI: AGENTS.md instructions
+// ============================================================================
+const CODEX_HOOK_MARKER = '<!-- haystack-session-hook -->';
+const CODEX_HOOK_BLOCK = `
+${CODEX_HOOK_MARKER}
+## Haystack Session Check
+
+When starting a new session, run this command first to check for pending PR analysis results:
+
+\`\`\`bash
+haystack check-pending --hook
+\`\`\`
+
+This shows whether your submitted PRs are "Good to merge" or "Need your input".
+`;
+function installCodexHook(gitRoot) {
+    const agentsPath = join(gitRoot, 'AGENTS.md');
+    try {
+        let content = '';
+        if (existsSync(agentsPath)) {
+            content = readFileSync(agentsPath, 'utf-8');
+            if (content.includes(CODEX_HOOK_MARKER)) {
+                console.log(chalk.dim('  Codex AGENTS.md already has session hook.'));
+                return true;
+            }
+        }
+        content += CODEX_HOOK_BLOCK;
+        writeFileSync(agentsPath, content);
+        return true;
+    }
+    catch (err) {
+        console.error(chalk.red(`  Failed to update AGENTS.md: ${err}`));
+        return false;
+    }
+}
+function checkCodexHook(gitRoot) {
+    const agentsPath = join(gitRoot, 'AGENTS.md');
+    if (!existsSync(agentsPath))
+        return false;
+    try {
+        const content = readFileSync(agentsPath, 'utf-8');
+        return content.includes(CODEX_HOOK_MARKER);
+    }
+    catch {
+        return false;
+    }
+}
+// ============================================================================
+// Gemini CLI: GEMINI.md instructions
+// ============================================================================
+const GEMINI_HOOK_MARKER = '<!-- haystack-session-hook -->';
+const GEMINI_HOOK_BLOCK = `
+${GEMINI_HOOK_MARKER}
+## Haystack Session Check
+
+When starting a new session, run this command first to check for pending PR analysis results:
+
+\`\`\`bash
+haystack check-pending --hook
+\`\`\`
+
+This shows whether your submitted PRs are "Good to merge" or "Need your input".
+`;
+function installGeminiHook(gitRoot) {
+    const geminiPath = join(gitRoot, 'GEMINI.md');
+    try {
+        let content = '';
+        if (existsSync(geminiPath)) {
+            content = readFileSync(geminiPath, 'utf-8');
+            if (content.includes(GEMINI_HOOK_MARKER)) {
+                console.log(chalk.dim('  Gemini GEMINI.md already has session hook.'));
+                return true;
+            }
+        }
+        content += GEMINI_HOOK_BLOCK;
+        writeFileSync(geminiPath, content);
+        return true;
+    }
+    catch (err) {
+        console.error(chalk.red(`  Failed to update GEMINI.md: ${err}`));
+        return false;
+    }
+}
+function checkGeminiHook(gitRoot) {
+    const geminiPath = join(gitRoot, 'GEMINI.md');
+    if (!existsSync(geminiPath))
+        return false;
+    try {
+        const content = readFileSync(geminiPath, 'utf-8');
+        return content.includes(GEMINI_HOOK_MARKER);
+    }
+    catch {
+        return false;
+    }
+}
+// ============================================================================
+// CLI config registry
+// ============================================================================
+const CLI_HOOKS = {
+    claude: {
+        name: 'claude',
+        displayName: 'Claude Code',
+        hasNativeHook: true,
+        install: installClaudeHook,
+        check: checkClaudeHook,
+    },
+    codex: {
+        name: 'codex',
+        displayName: 'Codex CLI',
+        hasNativeHook: false,
+        install: installCodexHook,
+        check: checkCodexHook,
+    },
+    gemini: {
+        name: 'gemini',
+        displayName: 'Gemini CLI',
+        hasNativeHook: false,
+        install: installGeminiHook,
+        check: checkGeminiHook,
+    },
+};
+// ============================================================================
+// Commands
+// ============================================================================
+export async function installSessionHooks(options) {
+    console.log(chalk.cyan('\nHaystack Session Hooks\n'));
+    const gitRoot = findGitRoot();
+    if (!gitRoot) {
+        console.error(chalk.red('Not a git repository.\n'));
+        process.exit(1);
+    }
+    // Determine which CLIs to install for
+    let targets;
+    if (options.cli) {
+        const cli = options.cli.toLowerCase();
+        if (cli === 'all') {
+            targets = detectInstalledCLIs();
+        }
+        else if (cli in CLI_HOOKS) {
+            targets = [cli];
+        }
+        else {
+            console.error(chalk.red(`Unknown CLI: ${options.cli}`));
+            console.log(chalk.dim('Supported: claude, codex, gemini, all'));
+            process.exit(1);
+        }
+    }
+    else {
+        // Auto-detect
+        targets = detectInstalledCLIs();
+    }
+    if (targets.length === 0) {
+        console.log(chalk.yellow('No supported coding CLI detected.\n'));
+        console.log(chalk.dim('Supported CLIs: Claude Code, Codex CLI, Gemini CLI'));
+        console.log(chalk.dim('Install one and try again, or specify --cli <name>.\n'));
+        return;
+    }
+    console.log(chalk.dim(`Installing for: ${targets.map(t => CLI_HOOKS[t].displayName).join(', ')}\n`));
+    for (const target of targets) {
+        const config = CLI_HOOKS[target];
+        const hookType = config.hasNativeHook ? 'native hook' : 'markdown instructions';
+        console.log(`  Installing ${config.displayName} (${hookType})...`);
+        const success = config.install(gitRoot);
+        if (success) {
+            console.log(chalk.green(`  ✓ ${config.displayName} configured`));
+        }
+        else {
+            console.log(chalk.red(`  ✗ ${config.displayName} failed`));
+        }
+    }
+    console.log(chalk.green('\n✓ Session hooks installed!\n'));
+    console.log(chalk.dim('When you start a new session, you\'ll see:'));
+    console.log(chalk.green('  [Haystack] ✓ PR #42 "Fix auth": Good to merge'));
+    console.log(chalk.yellow('  [Haystack] ⚠ PR #37 "Refactor API": Needs your input (2 bugs)'));
+    console.log('');
+}
+export async function sessionHooksStatus() {
+    console.log(chalk.cyan('\nHaystack Session Hooks Status\n'));
+    const gitRoot = findGitRoot();
+    if (!gitRoot) {
+        console.error(chalk.red('Not a git repository.\n'));
+        process.exit(1);
+    }
+    const installed = detectInstalledCLIs();
+    for (const cli of ['claude', 'codex', 'gemini']) {
+        const config = CLI_HOOKS[cli];
+        const isInstalled = installed.includes(cli);
+        const hookConfigured = config.check(gitRoot);
+        const cliIcon = isInstalled ? chalk.green('✓') : chalk.dim('-');
+        const hookIcon = hookConfigured ? chalk.green('✓') : chalk.red('✗');
+        console.log(`  ${cliIcon} ${config.displayName} ${isInstalled ? '(installed)' : '(not found)'}`);
+        if (isInstalled) {
+            console.log(`    ${hookIcon} Session hook ${hookConfigured ? 'configured' : 'not configured'}`);
+        }
+    }
+    const anyMissing = installed.some(cli => !CLI_HOOKS[cli].check(gitRoot));
+    if (anyMissing) {
+        console.log(chalk.dim('\nRun: haystack hooks install-session'));
+    }
+    console.log('');
+}

package/dist/commands/login.js

@@ -32,7 +32,7 @@ async function startDeviceFlow() {
  * Poll for access token
  */
 async function pollForToken(deviceCode, interval) {
-    while (true) {
+    for (;;) {
         await new Promise(resolve => setTimeout(resolve, interval * 1000));
         const response = await fetch('https://github.com/login/oauth/access_token', {
             method: 'POST',

package/dist/commands/policy.d.ts

@@ -0,0 +1,31 @@
+/**
+ * haystack policy - Manage review policies
+ *
+ * Commands:
+ *   list    - List all review policies
+ *   add     - Add a new policy interactively
+ *   remove  - Remove a policy by name
+ *   init    - Create initial review-policy.md
+ */
+/**
+ * List all review policies
+ */
+export declare function listPolicies(): Promise<void>;
+/**
+ * Add a new review policy interactively
+ */
+export declare function addPolicy(nameArg?: string): Promise<void>;
+/**
+ * Remove a policy by name
+ */
+export declare function removePolicy(name: string): Promise<void>;
+/**
+ * Add a review instruction
+ */
+export declare function addInstruction(text?: string): Promise<void>;
+/**
+ * Create initial review-policy.md with example policies
+ */
+export declare function initPolicies(options: {
+    force?: boolean;
+}): Promise<void>;