claude-git-hooks 2.20.0 → 2.30.1

package/lib/commands/setup-linear.js

@@ -0,0 +1,96 @@
+/**
+ * File: setup-linear.js
+ * Purpose: Interactive Linear authentication setup command
+ *
+ * Handles:
+ * - Checking existing token
+ * - Prompting user for new token
+ * - Validating token via Linear API
+ * - Saving token to .claude/settings.local.json
+ */
+
+import { testConnection, loadLinearToken } from '../utils/linear-connector.js';
+import { saveToken } from '../utils/token-store.js';
+import {
+    promptConfirmation,
+    promptEditField,
+    showSuccess,
+    showError,
+    showInfo,
+    showWarning
+} from '../utils/interactive-ui.js';
+import logger from '../utils/logger.js';
+
+/**
+ * Run Linear authentication setup
+ * Why: Interactive flow to configure Linear token for PR analysis enrichment
+ *
+ * @returns {Promise<void>}
+ */
+export async function runSetupLinear() {
+    showInfo('Linear Authentication Setup');
+
+    // Check existing token
+    const existingToken = loadLinearToken();
+    if (existingToken) {
+        showInfo('Existing Linear token found. Validating...');
+
+        const healthy = await testConnection(existingToken);
+        if (healthy) {
+            showSuccess('Linear token is valid and connected.');
+
+            const reconfigure = await promptConfirmation('Configure a different token?', false);
+            if (!reconfigure) {
+                return;
+            }
+        } else {
+            showWarning('Existing token is invalid or expired.');
+        }
+    }
+
+    // Show instructions
+    logger.info('Create a Linear API key:');
+    logger.info('  1. Go to: https://linear.app/settings/api');
+    logger.info('  2. Click "Create key"');
+    logger.info('  3. Give it a label (e.g., "claude-hooks")');
+    logger.info('  4. Copy the key (starts with lin_api_...)');
+
+    // Prompt for token
+    const token = await promptEditField('Paste your Linear API key (lin_api_...)', '');
+
+    if (!token || token.trim() === '') {
+        showWarning('No token provided. Setup cancelled.');
+        return;
+    }
+
+    const trimmedToken = token.trim();
+
+    // Basic format check
+    if (!trimmedToken.startsWith('lin_api_')) {
+        showWarning('Token format looks unusual (expected lin_api_...)');
+        const proceed = await promptConfirmation('Continue anyway?', false);
+        if (!proceed) {
+            return;
+        }
+    }
+
+    // Save token
+    const saveResult = saveToken('linearToken', trimmedToken);
+    if (!saveResult.success) {
+        showError(`Failed to save token: ${saveResult.error}`);
+        return;
+    }
+    showSuccess(`Token saved to ${saveResult.path}`);
+
+    // Validate with Linear API
+    showInfo('Validating token...');
+
+    const healthy = await testConnection(trimmedToken);
+    if (healthy) {
+        showSuccess('Linear connection verified.');
+    } else {
+        showWarning('Token validation failed - may not work correctly');
+    }
+
+    showSuccess('Setup complete! Linear ticket context will be used in: claude-hooks analyze-pr');
+}