@haystackeditor/cli 0.8.0 → 0.9.0

package/dist/commands/hooks.js

@@ -0,0 +1,269 @@
+/**
+ * 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)
+ */
+import chalk from 'chalk';
+import { existsSync, accessSync, constants } from 'fs';
+import * as path from 'path';
+import { execSync } from 'child_process';
+import { findGitRoot, ENTIRE_DEFAULT_VERSION, ENTIRE_BIN_PATH, getInstalledEntireVersion, getLatestEntireVersion, downloadEntireBinary, copyHookFiles, installHookDeps, copyLlmRulesTemplate, createEntireConfig, updateGitignore, } from '../utils/hooks.js';
+export async function hooksInstall(options) {
+    console.log(chalk.cyan('\nHaystack Hooks Setup\n'));
+    // Step 1: Validate git repo
+    const gitRoot = findGitRoot();
+    if (!gitRoot) {
+        console.error(chalk.red('Not a git repository. Run this from inside a git repo.\n'));
+        process.exit(1);
+    }
+    const hooksDir = path.join(gitRoot, 'hooks');
+    // Step 2: Check for existing installation
+    if (existsSync(hooksDir) && !options.force) {
+        console.error(chalk.yellow('hooks/ directory already exists. Use --force to overwrite.\n'));
+        process.exit(1);
+    }
+    if (existsSync(hooksDir) && options.force) {
+        console.log(chalk.yellow('Overwriting existing hooks...'));
+    }
+    // Step 3: Download Entire binary
+    if (!options.skipEntire) {
+        const version = options.version || ENTIRE_DEFAULT_VERSION;
+        const installedVersion = await getInstalledEntireVersion();
+        if (installedVersion === version) {
+            console.log(chalk.green(`✓ Entire CLI v${version} already installed`));
+        }
+        else {
+            console.log(chalk.dim(`Downloading Entire CLI v${version}...`));
+            try {
+                await downloadEntireBinary(version);
+                console.log(chalk.green(`✓ Entire CLI v${version} installed to ~/.haystack/bin/entire`));
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                console.error(chalk.red(`Failed to download Entire CLI: ${message}\n`));
+                process.exit(1);
+            }
+        }
+    }
+    else {
+        console.log(chalk.dim('Skipping Entire CLI download (--skip-entire)'));
+    }
+    // Step 4: Copy hook files
+    try {
+        await copyHookFiles(hooksDir);
+        console.log(chalk.green('✓ Hook scripts installed to hooks/'));
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(chalk.red(`Failed to copy hook files: ${message}\n`));
+        process.exit(1);
+    }
+    // Step 5: Install hook dependencies
+    console.log(chalk.dim('Installing hook dependencies (tree-sitter)...'));
+    try {
+        await installHookDeps(hooksDir);
+        console.log(chalk.green('✓ Hook dependencies installed'));
+    }
+    catch {
+        console.log(chalk.yellow('⚠ Failed to install hook dependencies. Run `npm install` in hooks/ manually.'));
+    }
+    // Step 6: Configure git hooks path
+    try {
+        execSync('git config core.hooksPath hooks', { cwd: gitRoot, stdio: 'pipe' });
+        console.log(chalk.green('✓ Git configured to use hooks/ directory'));
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(chalk.red(`Failed to set git hooks path: ${message}\n`));
+        process.exit(1);
+    }
+    // Step 7: Create .entire/ configuration
+    try {
+        await createEntireConfig(gitRoot);
+        console.log(chalk.green('✓ Created .entire/settings.json'));
+    }
+    catch {
+        console.log(chalk.yellow('⚠ Failed to create .entire/ configuration'));
+    }
+    // Step 8: Create LLM_RULES.md if needed
+    try {
+        const created = await copyLlmRulesTemplate(gitRoot);
+        if (created) {
+            console.log(chalk.green('✓ Created LLM_RULES.md (customize this for your project)'));
+        }
+        else {
+            console.log(chalk.dim('  LLM_RULES.md already exists'));
+        }
+    }
+    catch {
+        console.log(chalk.yellow('⚠ Failed to create LLM_RULES.md'));
+    }
+    // Step 9: Update .gitignore
+    try {
+        const updated = await updateGitignore(gitRoot);
+        if (updated) {
+            console.log(chalk.green('✓ Updated .gitignore'));
+        }
+    }
+    catch {
+        console.log(chalk.yellow('⚠ Failed to update .gitignore'));
+    }
+    // Summary
+    console.log(chalk.green('\n✓ Haystack hooks installed!\n'));
+    console.log(chalk.dim('Hooks installed:'));
+    console.log(chalk.dim('  pre-commit           Agent detection, truncation check, LLM rules review'));
+    console.log(chalk.dim('  commit-msg           Session tracking (powered by Entire)'));
+    console.log(chalk.dim('  post-commit          Session condensing (powered by Entire)'));
+    console.log(chalk.dim('  pre-push             Session log push (powered by Entire)'));
+    console.log(chalk.dim('  prepare-commit-msg   Commit preparation (powered by Entire)'));
+    console.log('');
+    console.log(chalk.dim('Files to commit:'));
+    console.log(chalk.dim('  hooks/               Hook scripts and TypeScript modules'));
+    console.log(chalk.dim('  .entire/settings.json'));
+    console.log(chalk.dim('  .entire/.gitignore'));
+    console.log(chalk.dim('  LLM_RULES.md         Customize this for your project'));
+    console.log('');
+}
+// ============================================================================
+// haystack hooks status
+// ============================================================================
+export async function hooksStatus() {
+    const gitRoot = findGitRoot();
+    if (!gitRoot) {
+        console.error(chalk.red('Not a git repository.\n'));
+        process.exit(1);
+    }
+    console.log(chalk.cyan('\nHaystack Hooks Status\n'));
+    const hooksDir = path.join(gitRoot, 'hooks');
+    // Check hooks directory
+    if (!existsSync(hooksDir)) {
+        console.log(chalk.red('✗ hooks/ directory not found'));
+        console.log(chalk.dim('  Run: haystack hooks install\n'));
+        return;
+    }
+    console.log(chalk.green('✓ hooks/ directory exists'));
+    // Check each hook script
+    const requiredHooks = [
+        'pre-commit',
+        'commit-msg',
+        'post-commit',
+        'pre-push',
+        'prepare-commit-msg',
+    ];
+    for (const hook of requiredHooks) {
+        const hookPath = path.join(hooksDir, hook);
+        if (existsSync(hookPath)) {
+            try {
+                accessSync(hookPath, constants.X_OK);
+                console.log(chalk.green(`✓ ${hook}`));
+            }
+            catch {
+                console.log(chalk.yellow(`⚠ ${hook} (not executable)`));
+            }
+        }
+        else {
+            console.log(chalk.red(`✗ ${hook} missing`));
+        }
+    }
+    // Check TypeScript modules
+    const agentContextDir = path.join(hooksDir, 'agent-context');
+    const truncationDir = path.join(hooksDir, 'truncation-checker');
+    console.log(existsSync(agentContextDir)
+        ? chalk.green('✓ agent-context/ module')
+        : chalk.red('✗ agent-context/ missing'));
+    console.log(existsSync(truncationDir)
+        ? chalk.green('✓ truncation-checker/ module')
+        : chalk.red('✗ truncation-checker/ missing'));
+    // Check hook dependencies
+    const nodeModules = path.join(hooksDir, 'node_modules');
+    console.log(existsSync(nodeModules)
+        ? chalk.green('✓ Hook dependencies installed')
+        : chalk.yellow('⚠ Hook dependencies not installed (run npm install in hooks/)'));
+    // Check git core.hooksPath
+    try {
+        const hooksPath = execSync('git config core.hooksPath', {
+            cwd: gitRoot,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        if (hooksPath === 'hooks') {
+            console.log(chalk.green('✓ Git core.hooksPath = hooks'));
+        }
+        else {
+            console.log(chalk.yellow(`⚠ Git core.hooksPath = ${hooksPath} (expected: hooks)`));
+        }
+    }
+    catch {
+        console.log(chalk.red('✗ Git core.hooksPath not set'));
+    }
+    // Check Entire binary
+    const installedVersion = await getInstalledEntireVersion();
+    if (installedVersion) {
+        console.log(chalk.green(`✓ Entire CLI v${installedVersion}`));
+    }
+    else if (existsSync(ENTIRE_BIN_PATH)) {
+        console.log(chalk.yellow('⚠ Entire CLI binary exists but failed to run'));
+    }
+    else {
+        console.log(chalk.yellow('⚠ Entire CLI not installed (~/.haystack/bin/entire)'));
+    }
+    // Check .entire/settings.json
+    const settingsPath = path.join(gitRoot, '.entire', 'settings.json');
+    if (existsSync(settingsPath)) {
+        console.log(chalk.green('✓ .entire/settings.json'));
+    }
+    else {
+        console.log(chalk.yellow('⚠ .entire/settings.json not found'));
+    }
+    // Check LLM_RULES.md
+    const rulesPath = path.join(gitRoot, 'LLM_RULES.md');
+    if (existsSync(rulesPath)) {
+        console.log(chalk.green('✓ LLM_RULES.md'));
+    }
+    else {
+        console.log(chalk.yellow('⚠ LLM_RULES.md not found'));
+    }
+    console.log('');
+}
+// ============================================================================
+// haystack hooks update
+// ============================================================================
+export async function hooksUpdate() {
+    console.log(chalk.cyan('\nUpdating Entire CLI...\n'));
+    // Check current version
+    const currentVersion = await getInstalledEntireVersion();
+    if (currentVersion) {
+        console.log(chalk.dim(`Current version: v${currentVersion}`));
+    }
+    else {
+        console.log(chalk.dim('Entire CLI not currently installed.'));
+    }
+    // Fetch latest version
+    let latestVersion;
+    try {
+        latestVersion = await getLatestEntireVersion();
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(chalk.red(`Failed to check for updates: ${message}\n`));
+        process.exit(1);
+    }
+    console.log(chalk.dim(`Latest version:  v${latestVersion}`));
+    if (currentVersion === latestVersion) {
+        console.log(chalk.green('\n✓ Already up to date.\n'));
+        return;
+    }
+    // Download and install
+    try {
+        await downloadEntireBinary(latestVersion);
+        console.log(chalk.green(`\n✓ Updated Entire CLI to v${latestVersion}\n`));
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(chalk.red(`Failed to update: ${message}\n`));
+        process.exit(1);
+    }
+}

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>;