@covibes/zeroshot 5.4.0 → 5.4.1

package/src/issue-providers/index.js

@@ -1,196 +0,0 @@
-/**
- * Issue Provider Registry
- *
- * Manages issue provider registration and auto-detection
- */
-
-const GitHubProvider = require('./github-provider');
-const GitLabProvider = require('./gitlab-provider');
-const JiraProvider = require('./jira-provider');
-const AzureDevOpsProvider = require('./azure-devops-provider');
-const { detectGitContext } = require('../../lib/git-remote-utils');
-
-/** @type {Map<string, typeof IssueProvider>} */
-const providers = new Map();
-
-/**
- * Register a provider class
- * @param {typeof IssueProvider} ProviderClass
- */
-function registerProvider(ProviderClass) {
-  if (!ProviderClass.id) {
-    throw new Error(`Provider ${ProviderClass.name} must define static id property`);
-  }
-  providers.set(ProviderClass.id, ProviderClass);
-}
-
-/**
- * Detect which provider matches the input
- * Automatically detects provider from git remote when in a git repository
- *
- * @param {string} input - User input (URL, issue key, number)
- * @param {Object} settings - User settings
- * @param {string|null} forceProvider - Force specific provider (from CLI flag)
- * @param {Object|null|undefined} [gitContextOverride] - Override git context (for testing)
- *   - undefined: auto-detect from git remote (default)
- *   - null: explicitly no git context
- *   - object: use provided git context
- * @returns {typeof IssueProvider|null}
- */
-function detectProvider(input, settings, forceProvider = null, gitContextOverride = undefined) {
-  // Force flag takes precedence
-  if (forceProvider) {
-    return providers.get(forceProvider) || null;
-  }
-
-  // Use provided gitContext or auto-detect
-  const gitContext = gitContextOverride === undefined ? detectGitContext() : gitContextOverride;
-
-  // Auto-detect by checking each provider's detectIdentifier
-  for (const ProviderClass of providers.values()) {
-    if (ProviderClass.detectIdentifier(input, settings, gitContext)) {
-      return ProviderClass;
-    }
-  }
-
-  return null;
-}
-
-/**
- * Get provider class by ID
- * @param {string} providerId - Provider identifier
- * @returns {typeof IssueProvider|null}
- */
-function getProvider(providerId) {
-  return providers.get(providerId) || null;
-}
-
-/**
- * List all registered provider IDs
- * @returns {string[]}
- */
-function listProviders() {
-  return Array.from(providers.keys());
-}
-
-/**
- * List providers that support PR/MR creation
- * @returns {string[]}
- */
-function listPRProviders() {
-  return Array.from(providers.values())
-    .filter((p) => p.supportsPR())
-    .map((p) => p.id);
-}
-
-/**
- * Determine which git platform to create PR/MR on.
- * ALWAYS uses git remote context, NEVER the issue provider.
- *
- * This is the unified replacement for platform-detector.js
- *
- * @param {string} [cwd=process.cwd()] - Working directory
- * @returns {string} Platform ID ('github', 'gitlab', 'azure-devops')
- * @throws {Error} If platform cannot be determined or doesn't support PRs
- *
- * @example
- * // In a GitHub repo
- * getPlatformForPR() // → 'github'
- *
- * @example
- * // In a GitLab repo with Jira issue
- * getPlatformForPR() // → 'gitlab' (creates GitLab MR, not related to Jira)
- */
-function getPlatformForPR(cwd = process.cwd()) {
-  const gitContext = detectGitContext(cwd);
-
-  if (!gitContext?.provider) {
-    throw new Error(
-      'Cannot determine git platform for --pr mode. ' +
-        'Ensure you are in a git repository with a remote URL from GitHub, GitLab, or Azure DevOps.'
-    );
-  }
-
-  const platform = gitContext.provider;
-  const ProviderClass = providers.get(platform);
-
-  if (!ProviderClass || !ProviderClass.supportsPR()) {
-    const supported = listPRProviders().join(', ');
-    throw new Error(
-      `Platform '${platform}' does not support --pr mode. Supported platforms: ${supported}`
-    );
-  }
-
-  return platform;
-}
-
-/**
- * Get PR tool info for a platform
- * @param {string} platform - Platform ID
- * @returns {{ name: string, checkCmd: string, installHint: string, displayName: string }|null}
- */
-function getPRToolForPlatform(platform) {
-  const ProviderClass = providers.get(platform);
-  return ProviderClass?.getPRTool() || null;
-}
-
-/**
- * Get aggregated settings schema from all issue providers
- * @returns {Object.<string, Object>} Combined settings schema
- */
-function getIssueProviderSettingsSchema() {
-  const schema = {};
-  for (const ProviderClass of providers.values()) {
-    Object.assign(schema, ProviderClass.getSettingsSchema());
-  }
-  return schema;
-}
-
-/**
- * Get default values for all issue provider settings
- * @returns {Object.<string, any>} Default values keyed by setting name
- */
-function getIssueProviderSettingsDefaults() {
-  const defaults = {};
-  const schema = getIssueProviderSettingsSchema();
-  for (const [key, config] of Object.entries(schema)) {
-    defaults[key] = config.default;
-  }
-  return defaults;
-}
-
-/**
- * Validate an issue provider setting
- * Delegates to the appropriate provider's validateSetting method
- * @param {string} key - Setting key
- * @param {any} value - Setting value
- * @returns {string|null|undefined} Error message if invalid, null if valid, undefined if not an issue provider setting
- */
-function validateIssueProviderSetting(key, value) {
-  for (const ProviderClass of providers.values()) {
-    const result = ProviderClass.validateSetting(key, value);
-    if (result !== undefined) {
-      return result;
-    }
-  }
-  return undefined; // Not an issue provider setting
-}
-
-// Auto-register providers on module load
-registerProvider(GitHubProvider);
-registerProvider(GitLabProvider);
-registerProvider(JiraProvider);
-registerProvider(AzureDevOpsProvider);
-
-module.exports = {
-  registerProvider,
-  detectProvider,
-  getProvider,
-  listProviders,
-  listPRProviders,
-  getPlatformForPR,
-  getPRToolForPlatform,
-  getIssueProviderSettingsSchema,
-  getIssueProviderSettingsDefaults,
-  validateIssueProviderSetting,
-};

package/src/issue-providers/jira-provider.js

@@ -1,239 +0,0 @@
-/**
- * Jira Provider - Fetch issues from Jira via jira CLI (go-jira)
- * Supports both Jira Cloud (*.atlassian.net) and self-hosted (Server/Data Center)
- */
-
-const IssueProvider = require('./base-provider');
-const { execSync } = require('../lib/safe-exec');
-
-class JiraProvider extends IssueProvider {
-  static id = 'jira';
-  static displayName = 'Jira';
-
-  /**
-   * Detect Jira issue keys and URLs
-   * Matches:
-   * - Jira Cloud URLs (*.atlassian.net)
-   * - Self-hosted Jira URLs (via jiraInstance setting)
-   * - Jira issue keys (KEY-123 format)
-   * - Bare numbers when defaultIssueSource=jira (requires jiraProject setting)
-   *
-   * Note: Jira doesn't use git context since it's not a git hosting platform.
-   * Git context will never match 'jira', so this provider only activates via
-   * explicit Jira URLs, Jira issue keys, or settings.
-   *
-   * @param {string} input - Issue identifier (URL, key, or number)
-   * @param {Object} settings - User settings
-   * @param {Object|null} gitContext - Git context (unused for Jira, but kept for API consistency)
-   * @returns {boolean} True if this provider should handle the input
-   */
-  static detectIdentifier(input, settings, gitContext = null) {
-    // Jira Cloud URLs
-    if (/atlassian\.net\/browse\/[A-Z][A-Z0-9]+-\d+/.test(input)) {
-      return true;
-    }
-
-    // Self-hosted Jira URLs
-    if (
-      settings.jiraInstance &&
-      input.includes(settings.jiraInstance) &&
-      /\/browse\/[A-Z][A-Z0-9]+-\d+/.test(input)
-    ) {
-      return true;
-    }
-
-    // Jira issue key pattern (KEY-123)
-    if (/^[A-Z][A-Z0-9]+-\d+$/.test(input)) {
-      return true;
-    }
-
-    // Bare numbers - use shared priority cascade logic
-    // Jira requires jiraProject setting to convert bare numbers to issue keys
-    // Note: gitContext check will never match 'jira' since Jira isn't a git host
-    return IssueProvider.detectBareNumber(input, settings, gitContext, 'jira', {
-      requiredSettings: ['jiraProject'],
-    });
-  }
-
-  static getRequiredTool() {
-    return {
-      name: 'jira',
-      checkCmd: 'jira version',
-      installHint: 'Install jira-cli: brew install go-jira (or https://github.com/go-jira/jira)',
-    };
-  }
-
-  /**
-   * Check jira CLI authentication
-   * go-jira uses config files (~/.jira.d/) rather than explicit auth commands
-   */
-  static checkAuth() {
-    try {
-      // go-jira uses 'jira session' to verify authentication
-      // If not configured, it fails with endpoint/login errors
-      execSync('jira session', { encoding: 'utf8', stdio: 'pipe', timeout: 5000 });
-      return { authenticated: true, error: null, recovery: [] };
-    } catch (err) {
-      const stderr = err.stderr || err.message || '';
-
-      // go-jira has various error patterns for auth issues
-      if (
-        stderr.includes('endpoint') ||
-        stderr.includes('login') ||
-        stderr.includes('authentication') ||
-        stderr.includes('401')
-      ) {
-        return {
-          authenticated: false,
-          error: 'Jira CLI not configured',
-          recovery: [
-            'Create ~/.jira.d/config.yml with your Jira endpoint',
-            'See: https://github.com/go-jira/jira#configuration',
-            'Example config:\n   endpoint: https://yourcompany.atlassian.net\n   login: your-email@company.com',
-            'Then verify: jira session',
-          ],
-        };
-      }
-
-      // If command just doesn't exist or times out, it's likely not configured
-      if (stderr.includes('command not found') || stderr.includes('ETIMEDOUT')) {
-        return {
-          authenticated: false,
-          error: 'Jira CLI not configured',
-          recovery: [
-            'Configure ~/.jira.d/config.yml',
-            'See: https://github.com/go-jira/jira#configuration',
-          ],
-        };
-      }
-
-      // Default: assume not authenticated
-      return {
-        authenticated: false,
-        error: stderr.trim() || 'Jira CLI not configured or authentication failed',
-        recovery: [
-          'Create ~/.jira.d/config.yml with your Jira endpoint',
-          'See: https://github.com/go-jira/jira#configuration',
-        ],
-      };
-    }
-  }
-
-  /**
-   * Jira-specific settings schema
-   */
-  static getSettingsSchema() {
-    return {
-      jiraInstance: {
-        type: 'string',
-        nullable: true,
-        default: null,
-        description: "Self-hosted Jira URL (e.g., 'jira.company.com')",
-      },
-      jiraProject: {
-        type: 'string',
-        nullable: true,
-        default: null,
-        description: "Default Jira project key for bare numbers (e.g., 'PROJ')",
-        pattern: /^[A-Z][A-Z0-9]*$/,
-        patternMsg: 'jiraProject must be a valid Jira project key (e.g., PROJ, ABC)',
-      },
-    };
-  }
-
-  fetchIssue(identifier, settings) {
-    try {
-      const issueKey = this._extractIssueKey(identifier, settings);
-
-      // Fetch issue using jira CLI
-      const cmd = `jira issue view ${issueKey} --template json`;
-      const output = execSync(cmd, { encoding: 'utf8' });
-      const issue = JSON.parse(output);
-
-      return this._parseIssue(issue);
-    } catch (error) {
-      throw new Error(`Failed to fetch Jira issue: ${error.message}`);
-    }
-  }
-
-  /**
-   * Extract Jira issue key from URL or return as-is
-   * @private
-   */
-  _extractIssueKey(identifier, settings) {
-    // URL format: https://company.atlassian.net/browse/KEY-123
-    const urlMatch = identifier.match(/\/browse\/([A-Z][A-Z0-9]+-\d+)/);
-    if (urlMatch) {
-      return urlMatch[1];
-    }
-
-    // Bare number: construct from jiraProject setting
-    if (/^\d+$/.test(identifier) && settings.jiraProject) {
-      return `${settings.jiraProject}-${identifier}`;
-    }
-
-    // Assume it's already a key
-    return identifier;
-  }
-
-  /**
-   * Parse Jira issue into standardized InputData format
-   * @private
-   */
-  _parseIssue(issue) {
-    const fields = issue.fields || {};
-    const key = issue.key;
-    const summary = fields.summary || '';
-    const description = fields.description || '';
-    const labels = fields.labels || [];
-    const comments = fields.comment?.comments || [];
-
-    let context = `# Jira Issue ${key}\n\n`;
-    context += `## Title\n${summary}\n\n`;
-
-    if (description) {
-      context += `## Description\n${description}\n\n`;
-    }
-
-    if (labels.length > 0) {
-      context += `## Labels\n`;
-      context += labels.map((l) => `- ${l}`).join('\n');
-      context += '\n\n';
-    }
-
-    if (comments.length > 0) {
-      context += `## Comments\n\n`;
-      for (const comment of comments) {
-        const author = comment.author?.displayName || comment.author?.name || 'unknown';
-        context += `### ${author} (${comment.created})\n`;
-        context += `${comment.body}\n\n`;
-      }
-    }
-
-    // Map Jira labels to GitHub format
-    const mappedLabels = labels.map((name) => ({ name }));
-
-    // Map Jira comments to GitHub format
-    const mappedComments = comments.map((comment) => ({
-      author: { login: comment.author?.displayName || comment.author?.name || 'unknown' },
-      createdAt: comment.created,
-      body: comment.body,
-    }));
-
-    // Extract issue number from key (KEY-123 → 123)
-    const numberMatch = key.match(/-(\d+)$/);
-    const number = numberMatch ? parseInt(numberMatch[1], 10) : null;
-
-    return {
-      number,
-      title: summary,
-      body: description,
-      labels: mappedLabels,
-      comments: mappedComments,
-      url: fields.self || null,
-      context,
-    };
-  }
-}
-
-module.exports = JiraProvider;