@haystackeditor/cli 0.8.0 → 0.8.1

package/dist/commands/config.js

@@ -4,6 +4,11 @@
 import chalk from 'chalk';
 import { loadToken } from './login.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)',
+};
 async function requireAuth() {
     const token = await loadToken();
     if (!token) {
@@ -131,3 +136,87 @@ export async function handleSandbox(action) {
             process.exit(1);
     }
 }
+/**
+ * Get current agentic tool setting
+ */
+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);
+    }
+}
+/**
+ * Set agentic tool preference
+ */
+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);
+    }
+}
+/**
+ * Handle agentic-tool subcommand
+ */
+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);
+}

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

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/skills.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Skills command - Registers the haystack-verify MCP server with coding CLIs
+ * Supports: Claude Code, Codex CLI, Cursor, and manual setup
+ */
+export declare function installSkills(options: {
+    cli?: string;
+}): Promise<void>;
+export declare function listSkills(): Promise<void>;

package/dist/commands/skills.js

@@ -0,0 +1,215 @@
+/**
+ * Skills command - Registers the haystack-verify MCP server with coding CLIs
+ * Supports: Claude Code, Codex CLI, Cursor, and manual setup
+ */
+import { execSync } from 'child_process';
+import chalk from 'chalk';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+const CLI_CONFIGS = {
+    claude: {
+        name: 'claude',
+        displayName: 'Claude Code',
+        checkCommand: 'which claude',
+        installCommand: 'claude mcp add haystack-verify -- npx @haystackeditor/verify',
+    },
+    codex: {
+        name: 'codex',
+        displayName: 'Codex CLI',
+        checkCommand: 'which codex',
+        installCommand: 'codex mcp add haystack-verify -- npx @haystackeditor/verify',
+    },
+    cursor: {
+        name: 'cursor',
+        displayName: 'Cursor',
+        checkCommand: '', // Cursor is always "available" - we check config file
+        installCommand: '', // We modify config directly
+        configPath: join(homedir(), '.cursor', 'mcp.json'),
+    },
+    manual: {
+        name: 'manual',
+        displayName: 'Manual Setup',
+        checkCommand: '',
+        installCommand: '',
+    },
+};
+function detectAvailableCLIs() {
+    const available = [];
+    // Check Claude Code
+    try {
+        execSync('which claude', { stdio: 'ignore' });
+        available.push('claude');
+    }
+    catch { }
+    // Check Codex CLI
+    try {
+        execSync('which codex', { stdio: 'ignore' });
+        available.push('codex');
+    }
+    catch { }
+    // Check Cursor (config-based)
+    const cursorConfigDir = join(homedir(), '.cursor');
+    if (existsSync(cursorConfigDir)) {
+        available.push('cursor');
+    }
+    return available;
+}
+function installForClaude() {
+    const config = CLI_CONFIGS.claude;
+    console.log(chalk.gray(`Running: ${config.installCommand}\n`));
+    try {
+        execSync(config.installCommand, { stdio: 'inherit' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function installForCodex() {
+    const config = CLI_CONFIGS.codex;
+    console.log(chalk.gray(`Running: ${config.installCommand}\n`));
+    try {
+        execSync(config.installCommand, { stdio: 'inherit' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function installForCursor() {
+    const configPath = CLI_CONFIGS.cursor.configPath;
+    const configDir = join(homedir(), '.cursor');
+    console.log(chalk.gray(`Updating: ${configPath}\n`));
+    try {
+        // Ensure directory exists
+        if (!existsSync(configDir)) {
+            mkdirSync(configDir, { recursive: true });
+        }
+        // Read or create config
+        let config = {};
+        if (existsSync(configPath)) {
+            const content = readFileSync(configPath, 'utf-8');
+            config = JSON.parse(content);
+        }
+        // Add haystack-verify server
+        config.mcpServers = config.mcpServers || {};
+        config.mcpServers['haystack-verify'] = {
+            command: 'npx',
+            args: ['@haystackeditor/verify'],
+        };
+        // Write config
+        writeFileSync(configPath, JSON.stringify(config, null, 2));
+        return true;
+    }
+    catch (error) {
+        console.error(chalk.red(`Failed to update Cursor config: ${error}`));
+        return false;
+    }
+}
+function showManualInstructions() {
+    console.log(chalk.white('\n📋 Manual Setup Instructions\n'));
+    console.log(chalk.cyan('Claude Code:'));
+    console.log(chalk.gray('  claude mcp add haystack-verify -- npx @haystackeditor/verify\n'));
+    console.log(chalk.cyan('Codex CLI:'));
+    console.log(chalk.gray('  codex mcp add haystack-verify -- npx @haystackeditor/verify\n'));
+    console.log(chalk.cyan('Cursor:'));
+    console.log(chalk.gray('  Add to ~/.cursor/mcp.json:'));
+    console.log(chalk.gray(`  {
+    "mcpServers": {
+      "haystack-verify": {
+        "command": "npx",
+        "args": ["@haystackeditor/verify"]
+      }
+    }
+  }\n`));
+    console.log(chalk.cyan('VS Code + Continue:'));
+    console.log(chalk.gray('  Add to .continue/config.json or settings\n'));
+}
+export async function installSkills(options) {
+    console.log(chalk.cyan('\n📦 Installing Haystack skills...\n'));
+    // If CLI specified, use it directly
+    if (options.cli) {
+        const cli = options.cli.toLowerCase();
+        if (cli === 'manual') {
+            showManualInstructions();
+            return;
+        }
+        if (!['claude', 'codex', 'cursor'].includes(cli)) {
+            console.log(chalk.red(`Unknown CLI: ${options.cli}`));
+            console.log(chalk.gray('Supported: claude, codex, cursor, manual'));
+            process.exit(1);
+        }
+        const success = await installForCLI(cli);
+        if (success) {
+            showSuccessMessage(cli);
+        }
+        return;
+    }
+    // Auto-detect available CLIs
+    const available = detectAvailableCLIs();
+    if (available.length === 0) {
+        console.log(chalk.yellow('No supported coding CLI detected.\n'));
+        showManualInstructions();
+        return;
+    }
+    if (available.length === 1) {
+        // Only one CLI available, use it
+        const cli = available[0];
+        console.log(chalk.gray(`Detected: ${CLI_CONFIGS[cli].displayName}\n`));
+        const success = await installForCLI(cli);
+        if (success) {
+            showSuccessMessage(cli);
+        }
+        return;
+    }
+    // Multiple CLIs available - install for all
+    console.log(chalk.gray(`Detected: ${available.map(c => CLI_CONFIGS[c].displayName).join(', ')}\n`));
+    for (const cli of available) {
+        console.log(chalk.white(`\nInstalling for ${CLI_CONFIGS[cli].displayName}...`));
+        await installForCLI(cli);
+    }
+    console.log(chalk.green('\n✅ Haystack skills installed!\n'));
+    console.log(chalk.white('Run one of these in your coding CLI:'));
+    console.log(chalk.cyan('  /setup-haystack'));
+    console.log();
+}
+async function installForCLI(cli) {
+    switch (cli) {
+        case 'claude':
+            return installForClaude();
+        case 'codex':
+            return installForCodex();
+        case 'cursor':
+            return installForCursor();
+        default:
+            return false;
+    }
+}
+function showSuccessMessage(cli) {
+    const config = CLI_CONFIGS[cli];
+    console.log(chalk.green('\n✅ Haystack skills installed!\n'));
+    console.log(chalk.white('Available skills:'));
+    console.log(chalk.cyan('  /setup-haystack         ') + chalk.gray('- Create .haystack.json with AI assistance'));
+    console.log(chalk.cyan('  /prepare-haystack       ') + chalk.gray('- Add aria-labels and data-testid attributes'));
+    console.log(chalk.cyan('  /setup-haystack-secrets ') + chalk.gray('- Configure API keys and secrets'));
+    console.log();
+    console.log(chalk.white(`Open ${config.displayName} and run:`));
+    console.log(chalk.cyan('  /setup-haystack'));
+    console.log();
+}
+export async function listSkills() {
+    console.log(chalk.white('\nAvailable Haystack skills:\n'));
+    console.log(chalk.cyan('  /setup-haystack         ') + chalk.gray('- Master setup - creates .haystack.json'));
+    console.log(chalk.cyan('  /prepare-haystack       ') + chalk.gray('- Add accessibility attributes'));
+    console.log(chalk.cyan('  /setup-haystack-secrets ') + chalk.gray('- Configure secrets for sandboxes'));
+    console.log();
+    const available = detectAvailableCLIs();
+    if (available.length > 0) {
+        console.log(chalk.gray('Detected CLIs: ') + chalk.white(available.map(c => CLI_CONFIGS[c].displayName).join(', ')));
+    }
+    else {
+        console.log(chalk.gray('No coding CLI detected. Run: ') + chalk.white('haystack skills install --cli manual'));
+    }
+    console.log();
+}