@ameshkin/ticket-mate 0.1.20

package/public/config/config-loader.js

@@ -0,0 +1,247 @@
+/**
+import { getErrorMessage } from "./../types/common";
+ * Configuration Loader
+
+ *
+ * Supports multiple config formats and sources:
+ * - jira.json
+ * - jira.config.ts
+ * - jira.config.js
+ * - Environment variables
+ *
+ * Config merging: file + env (env takes precedence)
+ */
+import { readFile, access } from "fs/promises";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { z } from "zod";
+import { logger } from "../utils/logger";
+import { getErrorMessage } from "../types/common";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Jira configuration schema
+ */
+export const JiraConfigSchema = z.object({
+    baseUrl: z.string().url(),
+    email: z.string().email(),
+    apiToken: z.string().min(1),
+    projectKey: z.string().min(1),
+    webhookSecret: z.string().optional(),
+    acceptanceCriteriaFieldId: z.string().optional(),
+    ai: z.object({
+        aiReadyLabel: z.string().optional(),
+        aiReadyStatusCategory: z.string().optional(),
+        branchPrefix: z.string().optional(),
+    }).optional(),
+    transitions: z.object({
+        inReview: z.string().optional(),
+        done: z.string().optional(),
+    }).optional(),
+}).passthrough(); // Allow additional fields
+/**
+ * Load configuration from JSON file
+ */
+async function loadFromJSON(path) {
+    try {
+        const content = await readFile(path, "utf-8");
+        const parsed = JSON.parse(content);
+        return JiraConfigSchema.parse(parsed);
+    }
+    catch (error) {
+        logger.debug("Failed to load JSON config", { path, error: getErrorMessage(error) });
+        return null;
+    }
+}
+/**
+ * Load configuration from TypeScript/JavaScript file
+ */
+async function loadFromJS(path) {
+    try {
+        // Dynamic import of config file
+        const importedModule = await import(path);
+        const config = importedModule.default || importedModule.config || importedModule;
+        return JiraConfigSchema.parse(config);
+    }
+    catch (error) {
+        logger.debug("Failed to load JS/TS config", { path, error: getErrorMessage(error) });
+        return null;
+    }
+}
+/**
+ * Load configuration from environment variables
+ */
+function loadFromEnv() {
+    const envConfig = {};
+    if (process.env.ATLASSIAN_BASE_URL) {
+        envConfig.baseUrl = process.env.ATLASSIAN_BASE_URL;
+    }
+    if (process.env.ATLASSIAN_EMAIL) {
+        envConfig.email = process.env.ATLASSIAN_EMAIL;
+    }
+    if (process.env.ATLASSIAN_API_KEY) {
+        envConfig.apiToken = process.env.ATLASSIAN_API_KEY;
+    }
+    if (process.env.ATLASSIAN_PROJECT_KEY) {
+        envConfig.projectKey = process.env.ATLASSIAN_PROJECT_KEY;
+    }
+    if (process.env.ATLASSIAN_WEBHOOK_SECRET) {
+        envConfig.webhookSecret = process.env.ATLASSIAN_WEBHOOK_SECRET;
+    }
+    if (process.env.ATLASSIAN_ACCEPTANCE_CRITERIA_FIELD_ID) {
+        envConfig.acceptanceCriteriaFieldId = process.env.ATLASSIAN_ACCEPTANCE_CRITERIA_FIELD_ID;
+    }
+    if (process.env.ATLASSIAN_AI_READY_LABEL) {
+        envConfig.ai = {
+            ...envConfig.ai,
+            aiReadyLabel: process.env.ATLASSIAN_AI_READY_LABEL,
+        };
+    }
+    if (process.env.ATLASSIAN_AI_READY_STATUS_CATEGORY) {
+        envConfig.ai = {
+            ...envConfig.ai,
+            aiReadyStatusCategory: process.env.ATLASSIAN_AI_READY_STATUS_CATEGORY,
+        };
+    }
+    return envConfig;
+}
+/**
+ * Check if file exists
+ */
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Find configuration file in directory
+ */
+async function findConfigFile(cwd) {
+    const candidates = [
+        { path: join(cwd, "jira.json"), type: "json" },
+        { path: join(cwd, "jira.config.ts"), type: "ts" },
+        { path: join(cwd, "jira.config"), type: "js" },
+        { path: join(cwd, ".jira.json"), type: "json" },
+        { path: join(cwd, ".jira.config.ts"), type: "ts" },
+        { path: join(cwd, ".jira.config"), type: "js" },
+    ];
+    for (const candidate of candidates) {
+        if (await fileExists(candidate.path)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+/**
+ * Merge configurations (file config + env config)
+ * Environment variables take precedence
+ */
+function mergeConfigs(fileConfig, envConfig) {
+    // Deep merge
+    const merged = {
+        ...fileConfig,
+        ...envConfig,
+        ai: {
+            ...fileConfig.ai,
+            ...envConfig.ai,
+        },
+        transitions: {
+            ...fileConfig.transitions,
+            ...envConfig.transitions,
+        },
+    };
+    return merged;
+}
+/**
+ * Load configuration from all sources
+ *
+ * Priority:
+ * 1. Environment variables (highest)
+ * 2. Config file (jira.json, jira.config.ts, jira.config.js)
+ * 3. Default/fallback
+ *
+ * @param cwd Working directory to search for config files
+ * @returns Configuration load result
+ */
+export async function loadConfig(cwd = process.cwd()) {
+    const errors = [];
+    let fileConfig = {};
+    let configPath;
+    let source = "default";
+    // Try to load from file
+    const configFile = await findConfigFile(cwd);
+    if (configFile) {
+        configPath = configFile.path;
+        if (configFile.type === "json") {
+            const loaded = await loadFromJSON(configFile.path);
+            if (loaded) {
+                fileConfig = loaded;
+                source = "json";
+            }
+            else {
+                errors.push(`Failed to load JSON config from ${configFile.path}`);
+            }
+        }
+        else {
+            const loaded = await loadFromJS(configFile.path);
+            if (loaded) {
+                fileConfig = loaded;
+                source = configFile.type;
+            }
+            else {
+                errors.push(`Failed to load ${configFile.type.toUpperCase()} config from ${configFile.path}`);
+            }
+        }
+    }
+    // Load from environment
+    const envConfig = loadFromEnv();
+    // Only set source to "env" if we haven't found a file config yet
+    if (Object.keys(envConfig).length > 0 && source === "default") {
+        source = "env";
+    }
+    // Merge configurations
+    const merged = mergeConfigs(fileConfig, envConfig);
+    // Validate merged config
+    try {
+        const validated = JiraConfigSchema.parse(merged);
+        return {
+            config: validated,
+            source,
+            path: configPath,
+            errors: errors.length > 0 ? errors : undefined,
+        };
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            errors.push(`Configuration validation failed: ${error.errors.map((e) => (e instanceof Error ? e.message : String(e))).join(", ")}`);
+        }
+        else {
+            errors.push(`Configuration error: ${getErrorMessage(error)}`);
+        }
+        // Return partial config even if validation fails
+        return {
+            config: merged,
+            source,
+            path: configPath,
+            errors,
+        };
+    }
+}
+/**
+ * Get configuration with fallback
+ *
+ * @param cwd Working directory
+ * @returns Configuration or null if not found
+ */
+export async function getConfig(cwd = process.cwd()) {
+    const result = await loadConfig(cwd);
+    if (result.errors && result.errors.length > 0) {
+        logger.warn("Configuration loaded with errors", { errors: result.errors });
+    }
+    return result.config;
+}
+//# sourceMappingURL=config-loader.js.map

package/public/config/config-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.js","sourceRoot":"","sources":["../../src/config/config-loader.ts"],"names":[],"mappings":"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"}

package/public/config/config-wizard.d.ts

@@ -0,0 +1,58 @@
+/**
+import { getErrorMessage } from "./../types/common";
+ * Configuration Wizard
+
+ *
+ * Interactive configuration setup and validation.
+ */
+import type { LoadedJiraConfig } from "./config-loader";
+/**
+ * Configuration wizard options
+ */
+export interface ConfigWizardOptions {
+    /**
+     * Working directory
+     */
+    cwd?: string;
+    /**
+     * Output file path (default: jira.json)
+     */
+    outputPath?: string;
+    /**
+     * Skip interactive prompts (use defaults)
+     */
+    nonInteractive?: boolean;
+    /**
+     * Test connection after setup
+     */
+    testConnection?: boolean;
+}
+/**
+ * Configuration prompt responses
+ */
+export interface ConfigPrompts {
+    baseUrl: string;
+    email: string;
+    apiToken: string;
+    projectKey: string;
+    webhookSecret?: string;
+    acceptanceCriteriaFieldId?: string;
+    aiReadyLabel?: string;
+    aiReadyStatusCategory?: string;
+}
+/**
+ * Run configuration wizard
+ *
+ * @param options Wizard options
+ * @returns Generated configuration
+ */
+export declare function runConfigWizard(options?: ConfigWizardOptions): Promise<LoadedJiraConfig>;
+/**
+ * Validate existing configuration
+ */
+export declare function validateConfig(cwd?: string): Promise<{
+    valid: boolean;
+    errors: string[];
+    config?: LoadedJiraConfig;
+}>;
+//# sourceMappingURL=config-wizard.d.ts.map

package/public/config/config-wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-wizard.d.ts","sourceRoot":"","sources":["../../src/config/config-wizard.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AA4DD;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,gBAAgB,CAAC,CAmE3B;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC;IACzE,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B,CAAC,CA0BD"}

package/public/config/config-wizard.js

@@ -0,0 +1,147 @@
+/**
+import { getErrorMessage } from "./../types/common";
+ * Configuration Wizard
+
+ *
+ * Interactive configuration setup and validation.
+ */
+import { writeFile } from "fs/promises";
+import { join } from "path";
+import { logger } from "../utils/logger";
+import { getErrorMessage } from "../types/common";
+import { listProjects } from "../client/jira-client";
+import { loadConfig, JiraConfigSchema } from "./config-loader";
+/**
+ * Prompt for configuration values
+ */
+async function promptConfig() {
+    // In a real implementation, this would use inquirer or similar
+    // For now, we'll use environment variables or return defaults
+    // This is a placeholder for interactive prompts
+    const prompts = {
+        baseUrl: process.env.ATLASSIAN_BASE_URL || "",
+        email: process.env.ATLASSIAN_EMAIL || "",
+        apiToken: process.env.ATLASSIAN_API_KEY || "",
+        projectKey: process.env.ATLASSIAN_PROJECT_KEY || "",
+        webhookSecret: process.env.ATLASSIAN_WEBHOOK_SECRET,
+        acceptanceCriteriaFieldId: process.env.ATLASSIAN_ACCEPTANCE_CRITERIA_FIELD_ID,
+        aiReadyLabel: process.env.ATLASSIAN_AI_READY_LABEL || "AI-READY",
+        aiReadyStatusCategory: process.env.ATLASSIAN_AI_READY_STATUS_CATEGORY || "In Progress",
+    };
+    return prompts;
+}
+/**
+ * Test Jira connection
+ */
+async function testConnection(config) {
+    try {
+        // Test connection by listing projects
+        const projects = await listProjects();
+        // Verify the configured project exists
+        const projectExists = projects.some((p) => p.key === config.projectKey);
+        if (!projectExists) {
+            return {
+                success: false,
+                error: `Project ${config.projectKey} not found or not accessible`,
+            };
+        }
+        return { success: true };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: getErrorMessage(error) || "Connection test failed",
+        };
+    }
+}
+/**
+ * Generate configuration file
+ */
+async function generateConfigFile(config, outputPath) {
+    const configJson = JSON.stringify(config, null, 2);
+    await writeFile(outputPath, configJson, "utf-8");
+    logger.info("Configuration file generated", { path: outputPath });
+}
+/**
+ * Run configuration wizard
+ *
+ * @param options Wizard options
+ * @returns Generated configuration
+ */
+export async function runConfigWizard(options = {}) {
+    const { cwd = process.cwd(), outputPath = join(cwd, "jira.json"), nonInteractive = false, testConnection: shouldTest = true, } = options;
+    logger.info("Starting configuration wizard", { cwd, outputPath });
+    // Check for existing config
+    const existing = await loadConfig(cwd);
+    if (existing.config && Object.keys(existing.config).length > 0) {
+        logger.info("Existing configuration found", { source: existing.source, path: existing.path });
+        if (nonInteractive) {
+            logger.info("Non-interactive mode: using existing configuration");
+            return existing.config;
+        }
+        // In interactive mode, could ask to overwrite
+        // For now, we'll use existing config
+    }
+    // Prompt for configuration
+    const prompts = await promptConfig();
+    // Validate required fields
+    if (!prompts.baseUrl || !prompts.email || !prompts.apiToken || !prompts.projectKey) {
+        throw new Error("Missing required configuration. Set ATLASSIAN_BASE_URL, ATLASSIAN_EMAIL, ATLASSIAN_API_KEY, and ATLASSIAN_PROJECT_KEY environment variables.");
+    }
+    // Build configuration object
+    const config = {
+        baseUrl: prompts.baseUrl,
+        email: prompts.email,
+        apiToken: prompts.apiToken,
+        projectKey: prompts.projectKey,
+        webhookSecret: prompts.webhookSecret,
+        acceptanceCriteriaFieldId: prompts.acceptanceCriteriaFieldId,
+        ai: prompts.aiReadyLabel || prompts.aiReadyStatusCategory ? {
+            aiReadyLabel: prompts.aiReadyLabel,
+            aiReadyStatusCategory: prompts.aiReadyStatusCategory,
+        } : undefined,
+    };
+    // Validate configuration
+    const validated = JiraConfigSchema.parse(config);
+    // Test connection if requested
+    if (shouldTest) {
+        logger.info("Testing Jira connection...");
+        const testResult = await testConnection(validated);
+        if (!testResult.success) {
+            throw new Error(`Connection test failed: ${testResult.error}`);
+        }
+        logger.info("Connection test successful");
+    }
+    // Generate config file
+    await generateConfigFile(validated, outputPath);
+    logger.info("Configuration wizard completed", { path: outputPath });
+    return validated;
+}
+/**
+ * Validate existing configuration
+ */
+export async function validateConfig(cwd = process.cwd()) {
+    const result = await loadConfig(cwd);
+    if (result.errors && result.errors.length > 0) {
+        return {
+            valid: false,
+            errors: result.errors,
+            config: result.config,
+        };
+    }
+    // Test connection
+    const testResult = await testConnection(result.config);
+    if (!testResult.success) {
+        return {
+            valid: false,
+            errors: [`Connection test failed: ${testResult.error}`],
+            config: result.config,
+        };
+    }
+    return {
+        valid: true,
+        errors: [],
+        config: result.config,
+    };
+}
+//# sourceMappingURL=config-wizard.js.map

package/public/config/config-wizard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-wizard.js","sourceRoot":"","sources":["../../src/config/config-wizard.ts"],"names":[],"mappings":"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"}

package/public/config/config.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Jira Configuration Module
+ *
+ * Loads and validates Jira configuration from environment variables and optional config file.
+ * Uses Zod for runtime validation.
+ */
+import type { JiraConfig, IssueTypeMapping, PriorityMapping } from "../types";
+/**
+ * Get Jira configuration
+ *
+ * Loads from environment variables (primary) and optional jira.json file.
+ * Validates using Zod schema.
+ *
+ * @param configPath - Optional path to jira.json file
+ * @returns Validated JiraConfig
+ * @throws Error if required fields are missing or invalid
+ */
+export declare function getJiraConfig(configPath?: string): JiraConfig;
+/**
+ * Get Jira configuration (returns null if not configured)
+ *
+ * Use this when configuration is optional.
+ */
+export declare function getJiraConfigOrNull(configPath?: string): JiraConfig | null;
+/**
+ * Check if Jira is configured
+ */
+export declare function isJiraConfigured(configPath?: string): boolean;
+/**
+ * Build Jira API authentication header
+ *
+ * @deprecated Use buildJiraHeaders() from jiraConnection.ts for unified PAT/OAuth support
+ */
+export declare function getJiraAuthHeader(config: JiraConfig): string;
+/**
+ * Get the Jira REST API base URL
+ *
+ * For scoped API tokens with cloud API:
+ *   https://api.atlassian.com/ex/jira/{cloudId}
+ *
+ * For standard tokens:
+ *   https://{host}.atlassian.net
+ *
+ * @param config - Jira configuration
+ * @returns Base URL for REST API calls (without /rest/api/3)
+ *
+ * @deprecated Use getConnectionBaseUrl() from jiraConnection.ts for unified PAT/OAuth support
+ */
+export declare function getJiraRestBaseUrl(config: JiraConfig): string;
+/**
+ * Default issue type mappings
+ */
+export declare function getDefaultIssueTypeMapping(): IssueTypeMapping;
+/**
+ * Get issue type for a category
+ */
+export declare function getIssueTypeForCategory(category: "bug_report" | "technical_issue" | "feature_request" | "sales_question", mapping?: IssueTypeMapping): string;
+/**
+ * Default priority mappings
+ */
+export declare function getDefaultPriorityMapping(): PriorityMapping;
+/**
+ * Get Jira priority for a severity level
+ */
+export declare function getPriorityForSeverity(severity: "low" | "medium" | "high" | "critical", mapping?: PriorityMapping): string;
+/**
+ * Print configuration summary (for debugging and verification)
+ */
+export declare function printConfigSummary(config?: JiraConfig): void;
+/**
+ * Test Jira configuration and connectivity
+ */
+export declare function testJiraConfig(config?: JiraConfig, verbose?: boolean): Promise<{
+    success: boolean;
+    error?: string;
+    details?: any;
+    verbose?: any;
+}>;
+//# sourceMappingURL=config.d.ts.map

package/public/config/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AA6L9E;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU,CAqF7D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAM1E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAK5D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAK7D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,gBAAgB,CAyB7D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,YAAY,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,gBAAgB,EACjF,OAAO,CAAC,EAAE,gBAAgB,GACzB,MAAM,CAGR;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,eAAe,CAO3D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,EAChD,OAAO,CAAC,EAAE,eAAe,GACxB,MAAM,CAGR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAkC5D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,CAAC,EAAE,UAAU,EACnB,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,GAAG,CAAC;IAAC,OAAO,CAAC,EAAE,GAAG,CAAA;CAAE,CAAC,CAyE7E"}