@thanhvn14/csvibe 0.1.0 → 0.1.2

package/dist/utils/errors.d.ts

@@ -2,25 +2,79 @@
  * Error handling utilities and custom error classes
  */
 /**
- * Base error class for CSVibe CLI errors
+ * Abstract base error class for CSVibe CLI errors
+ * All custom errors should extend this class
  */
-export declare class CsvibeError extends Error {
-    readonly code: string;
+export declare abstract class CSVibeError extends Error {
     readonly exitCode: number;
-    constructor(message: string, code: string, exitCode?: number);
+    abstract code: string;
+    abstract recoveryHint: string;
+    constructor(message: string, exitCode?: number);
 }
 /**
- * Error for gh CLI related issues
+ * GitHub authentication error
  */
-export declare class GhCliError extends CsvibeError {
-    constructor(message: string, code: string);
+export declare class GitHubAuthError extends CSVibeError {
+    code: string;
+    recoveryHint: string;
+    constructor(message?: string);
 }
 /**
- * Error for validation failures
+ * Project not found error
  */
-export declare class ValidationError extends CsvibeError {
-    constructor(message: string, code: string);
+export declare class ProjectNotFoundError extends CSVibeError {
+    code: string;
+    recoveryHint: string;
+    constructor(message?: string);
 }
+/**
+ * Config validation error
+ */
+export declare class ConfigValidationError extends CSVibeError {
+    code: string;
+    recoveryHint: string;
+    constructor(message?: string);
+}
+/**
+ * Network error
+ */
+export declare class NetworkError extends CSVibeError {
+    code: string;
+    recoveryHint: string;
+    constructor(message?: string);
+}
+/**
+ * Dependency error
+ */
+export declare class DependencyError extends CSVibeError {
+    code: string;
+    recoveryHint: string;
+    constructor(message?: string);
+}
+/**
+ * Legacy error classes for backward compatibility
+ */
+export declare class CsvibeError extends CSVibeError {
+    code: string;
+    recoveryHint: string;
+    constructor(message: string, code?: string, exitCode?: number);
+}
+export declare class GhCliError extends GitHubAuthError {
+    constructor(message: string, _code?: string);
+}
+export declare class ValidationError extends CSVibeError {
+    code: string;
+    recoveryHint: string;
+    constructor(message: string, code?: string);
+}
+/**
+ * Format error with color-coded output and recovery hints
+ */
+export declare function formatError(error: CSVibeError): string;
+/**
+ * Log error to file for debugging
+ */
+export declare function logError(error: Error): Promise<void>;
 /**
  * Global error handler for CLI
  */

package/dist/utils/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;aAGlB,IAAI,EAAE,MAAM;aACZ,QAAQ,EAAE,MAAM;gBAFhC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAU;CAKvC;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,WAAW;gBAC7B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAI1C;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,WAAW;gBAClC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAI1C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAejD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,EAC1E,EAAE,EAAE,CAAC,GACJ,CAAC,CAQH"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH;;;GAGG;AACH,8BAAsB,WAAY,SAAQ,KAAK;aAM3B,QAAQ,EAAE,MAAM;IALlC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAG5B,OAAO,EAAE,MAAM,EACC,QAAQ,GAAE,MAAU;CAMvC;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,IAAI,SAAe;IACnB,YAAY,SAA+F;gBAE/F,OAAO,GAAE,MAAuC;CAG7D;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,WAAW;IACnD,IAAI,SAAyB;IAC7B,YAAY,SAAkG;gBAElG,OAAO,GAAE,MAA0C;CAGhE;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,WAAW;IACpD,IAAI,SAAsB;IAC1B,YAAY,SAA2E;gBAE3E,OAAO,GAAE,MAA0C;CAGhE;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,WAAW;IAC3C,IAAI,SAAe;IACnB,YAAY,SAAyF;gBAEzF,OAAO,GAAE,MAAiC;CAGvD;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,IAAI,SAAkB;IACtB,YAAY,SAAiE;gBAEjE,OAAO,GAAE,MAAwC;CAG9D;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C,IAAI,SAAe;IACnB,YAAY,SAAmF;gBAG7F,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,EACb,QAAQ,GAAE,MAAU;CAKvB;AAED,qBAAa,UAAW,SAAQ,eAAe;gBACjC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAG5C;AAED,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,IAAI,SAAkB;IACtB,YAAY,SAAoD;gBAEpD,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAI3C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAkBtD;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB1D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAkBjD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,EAC1E,EAAE,EAAE,CAAC,GACJ,CAAC,CAQH"}

package/dist/utils/errors.js

@@ -6,54 +6,168 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ValidationError = exports.GhCliError = exports.CsvibeError = void 0;
+exports.ValidationError = exports.GhCliError = exports.CsvibeError = exports.DependencyError = exports.NetworkError = exports.ConfigValidationError = exports.ProjectNotFoundError = exports.GitHubAuthError = exports.CSVibeError = void 0;
+exports.formatError = formatError;
+exports.logError = logError;
 exports.handleError = handleError;
 exports.withErrorHandling = withErrorHandling;
 const chalk_1 = __importDefault(require("chalk"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
 /**
- * Base error class for CSVibe CLI errors
+ * Abstract base error class for CSVibe CLI errors
+ * All custom errors should extend this class
  */
-class CsvibeError extends Error {
-    constructor(message, code, exitCode = 1) {
+class CSVibeError extends Error {
+    constructor(message, exitCode = 1) {
         super(message);
-        this.code = code;
         this.exitCode = exitCode;
-        this.name = 'CsvibeError';
+        this.name = this.constructor.name;
+        Error.captureStackTrace(this, this.constructor);
     }
 }
-exports.CsvibeError = CsvibeError;
+exports.CSVibeError = CSVibeError;
 /**
- * Error for gh CLI related issues
+ * GitHub authentication error
  */
-class GhCliError extends CsvibeError {
-    constructor(message, code) {
-        super(message, code, 1);
-        this.name = 'GhCliError';
+class GitHubAuthError extends CSVibeError {
+    constructor(message = 'GitHub authentication failed') {
+        super(message, 1);
+        this.code = 'E_GH_AUTH';
+        this.recoveryHint = 'Run "gh auth login" to authenticate with GitHub, or set GITHUB_TOKEN environment variable';
     }
 }
-exports.GhCliError = GhCliError;
+exports.GitHubAuthError = GitHubAuthError;
+/**
+ * Project not found error
+ */
+class ProjectNotFoundError extends CSVibeError {
+    constructor(message = 'Project configuration not found') {
+        super(message, 1);
+        this.code = 'E_PROJECT_NOT_FOUND';
+        this.recoveryHint = 'Ensure you are in a valid project directory with package.json, pyproject.toml, or Cargo.toml';
+    }
+}
+exports.ProjectNotFoundError = ProjectNotFoundError;
 /**
- * Error for validation failures
+ * Config validation error
  */
-class ValidationError extends CsvibeError {
+class ConfigValidationError extends CSVibeError {
+    constructor(message = 'Configuration validation failed') {
+        super(message, 1);
+        this.code = 'E_CONFIG_INVALID';
+        this.recoveryHint = 'Check .csvibe/config.yml for syntax errors or missing required fields';
+    }
+}
+exports.ConfigValidationError = ConfigValidationError;
+/**
+ * Network error
+ */
+class NetworkError extends CSVibeError {
+    constructor(message = 'Network request failed') {
+        super(message, 1);
+        this.code = 'E_NETWORK';
+        this.recoveryHint = 'Check your internet connection and GitHub API status (https://www.githubstatus.com)';
+    }
+}
+exports.NetworkError = NetworkError;
+/**
+ * Dependency error
+ */
+class DependencyError extends CSVibeError {
+    constructor(message = 'Required dependency not found') {
+        super(message, 1);
+        this.code = 'E_DEPENDENCY';
+        this.recoveryHint = 'Install the missing dependency or ensure it is in your PATH';
+    }
+}
+exports.DependencyError = DependencyError;
+/**
+ * Legacy error classes for backward compatibility
+ */
+class CsvibeError extends CSVibeError {
+    constructor(message, code, exitCode = 1) {
+        super(message, exitCode);
+        this.code = 'E_UNKNOWN';
+        this.recoveryHint = 'Please report this issue at https://github.com/thanhvn14/csvibe-engine/issues';
+        if (code)
+            this.code = code;
+    }
+}
+exports.CsvibeError = CsvibeError;
+class GhCliError extends GitHubAuthError {
+    constructor(message, _code) {
+        super(message);
+    }
+}
+exports.GhCliError = GhCliError;
+class ValidationError extends CSVibeError {
     constructor(message, code) {
-        super(message, code, 1);
-        this.name = 'ValidationError';
+        super(message, 1);
+        this.code = 'E_VALIDATION';
+        this.recoveryHint = 'Check the validation error message for details';
+        if (code)
+            this.code = code;
     }
 }
 exports.ValidationError = ValidationError;
+/**
+ * Format error with color-coded output and recovery hints
+ */
+function formatError(error) {
+    const lines = [
+        '',
+        chalk_1.default.red.bold('✗ Error: ') + chalk_1.default.white(error.message),
+        chalk_1.default.gray('  Code: ') + chalk_1.default.yellow(error.code),
+        '',
+        chalk_1.default.cyan('💡 Recovery Hint:'),
+        chalk_1.default.white('  ' + error.recoveryHint),
+        ''
+    ];
+    if (error.stack && process.env.VERBOSE) {
+        lines.push(chalk_1.default.gray('Stack trace:'));
+        lines.push(chalk_1.default.gray(error.stack));
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/**
+ * Log error to file for debugging
+ */
+async function logError(error) {
+    try {
+        const logDir = path_1.default.join(os_1.default.homedir(), '.csvibe', 'logs');
+        await fs_extra_1.default.ensureDir(logDir);
+        const logFile = path_1.default.join(logDir, 'errors.log');
+        const timestamp = new Date().toISOString();
+        const logEntry = [
+            `[${timestamp}] ${error.name}: ${error.message}`,
+            error.stack || '',
+            '---',
+            ''
+        ].join('\n');
+        await fs_extra_1.default.appendFile(logFile, logEntry);
+    }
+    catch (logErr) {
+        // Silent fail - don't crash on logging errors
+    }
+}
 /**
  * Global error handler for CLI
  */
 function handleError(error) {
-    if (error instanceof CsvibeError) {
-        // Custom errors already have formatted messages
-        console.error('\n' + error.message);
+    if (error instanceof CSVibeError) {
+        // Format and display custom errors with recovery hints
+        console.error(formatError(error));
+        logError(error).catch(() => { }); // Async log, don't wait
         process.exit(error.exitCode);
     }
     else if (error instanceof Error) {
-        // Generic errors
-        console.error(chalk_1.default.red('\n✗ Error: ') + error.message + '\n');
+        // Generic errors - wrap in CSVibeError
+        const wrappedError = new CsvibeError(error.message);
+        console.error(formatError(wrappedError));
+        logError(error).catch(() => { });
         process.exit(1);
     }
     else {

package/dist/utils/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;AAyCH,kCAeC;AAKD,8CAUC;AArED,kDAA0B;AAE1B;;GAEG;AACH,MAAa,WAAY,SAAQ,KAAK;IACpC,YACE,OAAe,EACC,IAAY,EACZ,WAAmB,CAAC;QAEpC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAQ;QACZ,aAAQ,GAAR,QAAQ,CAAY;QAGpC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AATD,kCASC;AAED;;GAEG;AACH,MAAa,UAAW,SAAQ,WAAW;IACzC,YAAY,OAAe,EAAE,IAAY;QACvC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AALD,gCAKC;AAED;;GAEG;AACH,MAAa,eAAgB,SAAQ,WAAW;IAC9C,YAAY,OAAe,EAAE,IAAY;QACvC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AALD,0CAKC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;QACjC,gDAAgD;QAChD,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QACpC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;SAAM,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAClC,iBAAiB;QACjB,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;QAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;SAAM,CAAC;QACN,iBAAiB;QACjB,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC,CAAC;QAC5D,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAC/B,EAAK;IAEL,OAAO,CAAC,KAAK,EAAE,GAAG,IAAmB,EAAE,EAAE;QACvC,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CAAM,CAAC;AACV,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"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"}

package/dist/utils/gh-cli.d.ts

@@ -1,5 +1,6 @@
 /**
  * GitHub CLI (gh) validation and operations
+ * Now uses multi-tier authentication and @octokit/rest
  */
 /**
  * Check if gh CLI is installed
@@ -21,9 +22,10 @@ export declare function isGhAuthenticated(): Promise<boolean>;
  */
 export declare function checkRepoAccess(repo: string): Promise<boolean>;
 /**
- * Validate all gh CLI prerequisites
+ * Validate GitHub authentication and repository access
+ * Uses multi-tier authentication (gh CLI → env → config → keychain → prompt)
  * @param repo - Repository to check access (default: csvibe-engine)
- * @throws {GhCliError} If validation fails
+ * @throws {GitHubAuthError} If validation fails
  */
 export declare function validateGhCli(repo?: string): Promise<void>;
 /**

package/dist/utils/gh-cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gh-cli.d.ts","sourceRoot":"","sources":["../../src/utils/gh-cli.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAOtD;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAS3D;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC,CAO1D;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAYpE;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,IAAI,GAAE,MAA4B,GAAG,OAAO,CAAC,IAAI,CAAC,CAgErF;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAO5D"}
+{"version":3,"file":"gh-cli.d.ts","sourceRoot":"","sources":["../../src/utils/gh-cli.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAOtD;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAS3D;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC,CAO1D;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAYpE;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,IAAI,GAAE,MAA4B,GAAG,OAAO,CAAC,IAAI,CAAC,CAmDrF;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAO5D"}

package/dist/utils/gh-cli.js

@@ -1,6 +1,7 @@
 "use strict";
 /**
  * GitHub CLI (gh) validation and operations
+ * Now uses multi-tier authentication and @octokit/rest
  */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
@@ -17,6 +18,7 @@ const chalk_1 = __importDefault(require("chalk"));
 const constants_1 = require("../config/constants");
 const errors_1 = require("./errors");
 const logger_1 = require("./logger");
+const github_1 = require("../domains/github");
 /**
  * Check if gh CLI is installed
  */
@@ -76,56 +78,49 @@ async function checkRepoAccess(repo) {
     }
 }
 /**
- * Validate all gh CLI prerequisites
+ * Validate GitHub authentication and repository access
+ * Uses multi-tier authentication (gh CLI → env → config → keychain → prompt)
  * @param repo - Repository to check access (default: csvibe-engine)
- * @throws {GhCliError} If validation fails
+ * @throws {GitHubAuthError} If validation fails
  */
 async function validateGhCli(repo = constants_1.CONSTANTS.REPO_FULL) {
-    // Check gh CLI installed
-    if (!(await isGhInstalled())) {
-        throw new errors_1.GhCliError(chalk_1.default.red('✗ Error: gh CLI not found\n\n') +
-            '  CSVibe requires GitHub CLI (gh) to download vibecoding assets.\n\n' +
-            '  Install gh CLI:\n' +
-            chalk_1.default.cyan('  • macOS:   ') + 'brew install gh\n' +
-            chalk_1.default.cyan('  • Windows: ') + 'winget install GitHub.cli\n' +
-            chalk_1.default.cyan('  • Linux:   ') + constants_1.CONSTANTS.GH_CLI_INSTALL + '\n\n' +
-            '  After installing, authenticate:\n' +
-            chalk_1.default.cyan('  gh auth login'), 'GH_NOT_INSTALLED');
-    }
-    // Check authenticated
-    if (!(await isGhAuthenticated())) {
-        throw new errors_1.GhCliError(chalk_1.default.red('✗ Error: gh CLI not authenticated\n\n') +
-            '  Please authenticate GitHub CLI:\n' +
-            chalk_1.default.cyan('  gh auth login\n\n') +
-            '  Then try again:\n' +
-            chalk_1.default.cyan('  csvibe init'), 'GH_NOT_AUTHENTICATED');
-    }
-    // Check repo access
-    const spinner = logger_1.logger.spinner(`Checking access to ${repo}...`);
+    const spinner = logger_1.logger.spinner('Authenticating with GitHub...');
     try {
-        const hasAccess = await checkRepoAccess(repo);
-        if (!hasAccess) {
-            spinner.fail();
-            throw new errors_1.GhCliError(chalk_1.default.red(`✗ Error: Cannot access private repository '${repo}'\n\n`) +
-                '  Possible causes:\n' +
-                '  1. Repository doesn\'t exist\n' +
-                '  2. Your GitHub account lacks access\n' +
-                '  3. gh CLI authentication expired\n\n' +
-                '  Contact repository administrator for access.', 'GH_NO_REPO_ACCESS');
+        // Try multi-tier authentication
+        const { token, method } = await (0, github_1.getGitHubToken)();
+        spinner.succeed(`Authenticated via ${chalk_1.default.cyan((0, github_1.getAuthMethodDescription)(method))}`);
+        // Check repo access using GitHub client
+        const repoSpinner = logger_1.logger.spinner(`Checking access to ${repo}...`);
+        try {
+            const client = await github_1.GitHubClient.create();
+            const [owner, repoName] = repo.split('/');
+            const hasAccess = await client.hasRepoAccess(owner, repoName);
+            if (!hasAccess) {
+                repoSpinner.fail();
+                throw new errors_1.GitHubAuthError(chalk_1.default.red(`✗ Error: Cannot access private repository '${repo}'\n\n`) +
+                    '  Possible causes:\n' +
+                    '  1. Repository doesn\'t exist\n' +
+                    '  2. Your GitHub account lacks access\n' +
+                    '  3. Token lacks required scopes (needs: repo, read:org)\n\n' +
+                    '  Contact repository administrator for access.');
+            }
+            repoSpinner.succeed(`Access to ${repo} verified`);
+        }
+        catch (error) {
+            repoSpinner.fail();
+            throw error;
         }
-        spinner.succeed(`Access to ${repo} verified`);
     }
     catch (error) {
         spinner.fail();
-        // Re-throw if already a GhCliError
-        if (error instanceof errors_1.GhCliError) {
+        // Re-throw if already a GitHubAuthError
+        if (error instanceof errors_1.GitHubAuthError) {
             throw error;
         }
         // Generic network/API errors
-        throw new errors_1.GhCliError(chalk_1.default.red(`✗ Error: Failed to check repository access\n\n`) +
-            `  Repository: ${repo}\n` +
+        throw new errors_1.GitHubAuthError(chalk_1.default.red(`✗ Error: Failed to authenticate with GitHub\n\n`) +
             `  Details: ${error instanceof Error ? error.message : String(error)}\n\n` +
-            '  Check your internet connection and try again.', 'GH_API_ERROR');
+            '  Check your internet connection and authentication method.');
     }
 }
 /**

package/dist/utils/gh-cli.js.map

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

package/dist/utils/progress.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Progress indicators and spinners using cli-progress
+ */
+import * as cliProgress from 'cli-progress';
+export interface ProgressOptions {
+    label: string;
+    total: number;
+    unit?: string;
+}
+/**
+ * Create a progress bar with ETA
+ */
+export declare function createProgressBar(options: ProgressOptions): cliProgress.SingleBar;
+/**
+ * Create a download progress bar with file size
+ */
+export declare function createDownloadProgress(label: string, totalBytes: number): cliProgress.SingleBar;
+/**
+ * Update download progress with speed calculation
+ */
+export declare function updateDownloadProgress(bar: cliProgress.SingleBar, downloaded: number, total: number, startTime: number): void;
+/**
+ * Multi-bar progress for parallel operations
+ */
+export declare class MultiProgress {
+    private multibar;
+    constructor();
+    /**
+     * Add a progress bar to the multi-bar
+     */
+    addBar(label: string, total: number): cliProgress.SingleBar;
+    /**
+     * Stop all progress bars
+     */
+    stop(): void;
+}
+//# sourceMappingURL=progress.d.ts.map

package/dist/utils/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/utils/progress.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,WAAW,MAAM,cAAc,CAAC;AAE5C,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,WAAW,CAAC,SAAS,CAiBjF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,CAAC,SAAS,CAoB/F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,WAAW,CAAC,SAAS,EAC1B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,IAAI,CAUN;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAuB;;IAavC;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC,SAAS;IAI3D;;OAEG;IACH,IAAI,IAAI,IAAI;CAGb"}

package/dist/utils/progress.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * Progress indicators and spinners using cli-progress
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultiProgress = void 0;
+exports.createProgressBar = createProgressBar;
+exports.createDownloadProgress = createDownloadProgress;
+exports.updateDownloadProgress = updateDownloadProgress;
+const chalk_1 = __importDefault(require("chalk"));
+const cliProgress = __importStar(require("cli-progress"));
+/**
+ * Create a progress bar with ETA
+ */
+function createProgressBar(options) {
+    const { label, total, unit = 'items' } = options;
+    const bar = new cliProgress.SingleBar({
+        format: `${chalk_1.default.cyan(label)} [{bar}] {percentage}% | ETA: {eta}s | {value}/{total} ${unit}`,
+        barCompleteChar: '\u2588',
+        barIncompleteChar: '\u2591',
+        hideCursor: true,
+        clearOnComplete: false,
+        stopOnComplete: true,
+    }, cliProgress.Presets.shades_classic);
+    bar.start(total, 0);
+    return bar;
+}
+/**
+ * Create a download progress bar with file size
+ */
+function createDownloadProgress(label, totalBytes) {
+    const bar = new cliProgress.SingleBar({
+        format: `${chalk_1.default.cyan(label)} [{bar}] {percentage}% | ETA: {eta}s | {downloadedMB}/{totalMB} MB | {speedMBps} MB/s`,
+        barCompleteChar: '\u2588',
+        barIncompleteChar: '\u2591',
+        hideCursor: true,
+        clearOnComplete: false,
+        stopOnComplete: true,
+    }, cliProgress.Presets.shades_classic);
+    bar.start(totalBytes, 0, {
+        downloadedMB: '0.00',
+        totalMB: (totalBytes / (1024 * 1024)).toFixed(2),
+        speedMBps: '0.00',
+    });
+    return bar;
+}
+/**
+ * Update download progress with speed calculation
+ */
+function updateDownloadProgress(bar, downloaded, total, startTime) {
+    const elapsedSeconds = (Date.now() - startTime) / 1000;
+    const speedBytesPerSecond = downloaded / elapsedSeconds;
+    const speedMBps = (speedBytesPerSecond / (1024 * 1024)).toFixed(2);
+    bar.update(downloaded, {
+        downloadedMB: (downloaded / (1024 * 1024)).toFixed(2),
+        totalMB: (total / (1024 * 1024)).toFixed(2),
+        speedMBps,
+    });
+}
+/**
+ * Multi-bar progress for parallel operations
+ */
+class MultiProgress {
+    constructor() {
+        this.multibar = new cliProgress.MultiBar({
+            clearOnComplete: false,
+            hideCursor: true,
+            format: '{label} [{bar}] {percentage}% | ETA: {eta}s | {value}/{total}',
+        }, cliProgress.Presets.shades_grey);
+    }
+    /**
+     * Add a progress bar to the multi-bar
+     */
+    addBar(label, total) {
+        return this.multibar.create(total, 0, { label: chalk_1.default.cyan(label) });
+    }
+    /**
+     * Stop all progress bars
+     */
+    stop() {
+        this.multibar.stop();
+    }
+}
+exports.MultiProgress = MultiProgress;
+//# sourceMappingURL=progress.js.map

package/dist/utils/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../src/utils/progress.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcH,8CAiBC;AAKD,wDAoBC;AAKD,wDAeC;AA1ED,kDAA0B;AAC1B,0DAA4C;AAQ5C;;GAEG;AACH,SAAgB,iBAAiB,CAAC,OAAwB;IACxD,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,EAAE,GAAG,OAAO,CAAC;IAEjD,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,SAAS,CACnC;QACE,MAAM,EAAE,GAAG,eAAK,CAAC,IAAI,CAAC,KAAK,CAAC,0DAA0D,IAAI,EAAE;QAC5F,eAAe,EAAE,QAAQ;QACzB,iBAAiB,EAAE,QAAQ;QAC3B,UAAU,EAAE,IAAI;QAChB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;KACrB,EACD,WAAW,CAAC,OAAO,CAAC,cAAc,CACnC,CAAC;IAEF,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACpB,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB,CAAC,KAAa,EAAE,UAAkB;IACtE,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,SAAS,CACnC;QACE,MAAM,EAAE,GAAG,eAAK,CAAC,IAAI,CAAC,KAAK,CAAC,uFAAuF;QACnH,eAAe,EAAE,QAAQ;QACzB,iBAAiB,EAAE,QAAQ;QAC3B,UAAU,EAAE,IAAI;QAChB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;KACrB,EACD,WAAW,CAAC,OAAO,CAAC,cAAc,CACnC,CAAC;IAEF,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,EAAE;QACvB,YAAY,EAAE,MAAM;QACpB,OAAO,EAAE,CAAC,UAAU,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAChD,SAAS,EAAE,MAAM;KAClB,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB,CACpC,GAA0B,EAC1B,UAAkB,EAClB,KAAa,EACb,SAAiB;IAEjB,MAAM,cAAc,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC;IACvD,MAAM,mBAAmB,GAAG,UAAU,GAAG,cAAc,CAAC;IACxD,MAAM,SAAS,GAAG,CAAC,mBAAmB,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAEnE,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE;QACrB,YAAY,EAAE,CAAC,UAAU,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QACrD,OAAO,EAAE,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAC3C,SAAS;KACV,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAa,aAAa;IAGxB;QACE,IAAI,CAAC,QAAQ,GAAG,IAAI,WAAW,CAAC,QAAQ,CACtC;YACE,eAAe,EAAE,KAAK;YACtB,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,+DAA+D;SACxE,EACD,WAAW,CAAC,OAAO,CAAC,WAAW,CAChC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAa,EAAE,KAAa;QACjC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,eAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,IAAI;QACF,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;CACF;AA3BD,sCA2BC"}

package/dist/utils/prompts.d.ts

@@ -1,5 +1,5 @@
 /**
- * Interactive prompt utilities
+ * Interactive prompt utilities using @clack/prompts
  */
 export interface JiraCredentials {
     url: string;
@@ -15,6 +15,10 @@ export declare function promptJiraCredentials(): Promise<JiraCredentials>;
  * Confirm overwrite of existing setup
  */
 export declare function confirmOverwrite(): Promise<boolean>;
+/**
+ * Confirm Jira setup (optional configuration)
+ */
+export declare function confirmJiraSetup(): Promise<boolean>;
 /**
  * Show API token creation instructions
  */

package/dist/utils/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/utils/prompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,eAAe,CAAC,CA4DtE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAUzD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAM/C"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/utils/prompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,eAAe,CAAC,CA0EtE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAYzD;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAYzD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAa/C"}