@thanhvn14/csvibe 0.1.1 → 0.1.3

package/dist/utils/directory-analyzer.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * Directory structure analysis
+ * Analyzes project directory structure to identify source, test, and config directories
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeDirectories = analyzeDirectories;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const project_detector_1 = require("./project-detector");
+/**
+ * Analyze project directory structure
+ * Uses predefined candidate lists to identify common directory patterns
+ *
+ * @param projectRoot - Root directory of the project
+ * @param projectType - Detected project type
+ * @returns Directory structure with source, test, and config directories
+ */
+async function analyzeDirectories(projectRoot, projectType) {
+    const result = {
+        source: [],
+        tests: [],
+        config: ['.'] // Root always has config files
+    };
+    try {
+        const entries = await fs_extra_1.default.readdir(projectRoot, { withFileTypes: true });
+        const dirs = entries.filter(e => e.isDirectory()).map(e => e.name);
+        // Source directories - common patterns across ecosystems
+        const sourceCandidates = ['src', 'lib', 'app', 'components', 'packages', 'apps'];
+        for (const candidate of sourceCandidates) {
+            if (dirs.includes(candidate)) {
+                result.source.push(candidate);
+            }
+        }
+        // Test directories - common test directory names
+        const testCandidates = ['test', 'tests', '__tests__', 'spec', '__test__'];
+        for (const candidate of testCandidates) {
+            if (dirs.includes(candidate)) {
+                result.tests.push(candidate);
+            }
+        }
+        // Additional config directories for monorepos
+        if (projectType === project_detector_1.ProjectType.NodeMonorepo) {
+            // Scan packages/ for individual package configs
+            if (dirs.includes('packages')) {
+                const packagesDir = path_1.default.join(projectRoot, 'packages');
+                try {
+                    const packageDirs = await fs_extra_1.default.readdir(packagesDir, { withFileTypes: true });
+                    packageDirs
+                        .filter(e => e.isDirectory())
+                        .forEach(e => result.config.push(`packages/${e.name}`));
+                }
+                catch {
+                    // Ignore if packages/ is not accessible
+                }
+            }
+            // Scan apps/ for individual app configs
+            if (dirs.includes('apps')) {
+                const appsDir = path_1.default.join(projectRoot, 'apps');
+                try {
+                    const appDirs = await fs_extra_1.default.readdir(appsDir, { withFileTypes: true });
+                    appDirs
+                        .filter(e => e.isDirectory())
+                        .forEach(e => result.config.push(`apps/${e.name}`));
+                }
+                catch {
+                    // Ignore if apps/ is not accessible
+                }
+            }
+        }
+    }
+    catch (error) {
+        // Return empty structure on error (graceful degradation)
+        console.warn(`Warning: Could not analyze directories: ${error}`);
+    }
+    return result;
+}
+//# sourceMappingURL=directory-analyzer.js.map

package/dist/utils/directory-analyzer.js.map

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

package/dist/utils/downloader.d.ts

@@ -1,12 +1,12 @@
 /**
- * GitHub asset download utilities
+ * GitHub asset download utilities using @octokit/rest
  */
 /**
- * Download .github directory from private repo
+ * Download .github directory from private repo using GitHub client
  */
 export declare function downloadGithubAssets(repo?: string, branch?: string, targetDir?: string): Promise<void>;
 /**
- * Download config template from repo
+ * Download config template from repo using GitHub client
  */
 export declare function downloadConfigTemplate(repo?: string): Promise<string>;
 //# sourceMappingURL=downloader.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"downloader.d.ts","sourceRoot":"","sources":["../../src/utils/downloader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,GAAE,MAA4B,EAClC,MAAM,GAAE,MAAe,EACvB,SAAS,GAAE,MAAsB,GAChC,OAAO,CAAC,IAAI,CAAC,CAqEf;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,GAAE,MAA4B,GACjC,OAAO,CAAC,MAAM,CAAC,CAiBjB"}
+{"version":3,"file":"downloader.d.ts","sourceRoot":"","sources":["../../src/utils/downloader.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,GAAE,MAA4B,EAClC,MAAM,GAAE,MAAe,EACvB,SAAS,GAAE,MAAsB,GAChC,OAAO,CAAC,IAAI,CAAC,CA6Cf;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,GAAE,MAA4B,GACjC,OAAO,CAAC,MAAM,CAAC,CAiBjB"}

package/dist/utils/downloader.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * GitHub asset download utilities
+ * GitHub asset download utilities using @octokit/rest
  */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
@@ -8,98 +8,68 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.downloadGithubAssets = downloadGithubAssets;
 exports.downloadConfigTemplate = downloadConfigTemplate;
-const execa_1 = require("execa");
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
 const constants_1 = require("../config/constants");
 const logger_1 = require("./logger");
+const github_1 = require("../domains/github");
+const progress_1 = require("./progress");
 /**
- * Download .github directory from private repo
+ * Download .github directory from private repo using GitHub client
  */
 async function downloadGithubAssets(repo = constants_1.CONSTANTS.REPO_FULL, branch = 'main', targetDir = process.cwd()) {
     const spinner = logger_1.logger.spinner(`Downloading assets from ${repo}...`);
-    const tempDir = path_1.default.join(targetDir, '.csvibe-tmp');
     try {
-        // Create temp directory
-        await fs_extra_1.default.ensureDir(tempDir);
-        // Clone repo with sparse checkout (only .github/)
-        // Using gh repo clone with --depth=1 and --filter=blob:none
-        await (0, execa_1.execa)('gh', [
-            'repo',
-            'clone',
-            repo,
-            tempDir,
-            '--',
-            '--depth=1',
-            '--filter=blob:none',
-            '--sparse'
-        ]);
-        // Sparse checkout .github/ directory
-        await (0, execa_1.execa)('git', [
-            '-C',
-            tempDir,
-            'sparse-checkout',
-            'set',
-            '.github'
-        ]);
-        // Copy .github/ to target directory
-        const sourceGithub = path_1.default.join(tempDir, '.github');
-        const targetGithub = path_1.default.join(targetDir, '.github');
-        if (await fs_extra_1.default.pathExists(sourceGithub)) {
-            // Copy agents
-            await copyDirectory(path_1.default.join(sourceGithub, 'agents'), path_1.default.join(targetGithub, 'agents'));
-            // Copy prompts (if exists)
-            if (await fs_extra_1.default.pathExists(path_1.default.join(sourceGithub, 'prompts'))) {
-                await copyDirectory(path_1.default.join(sourceGithub, 'prompts'), path_1.default.join(targetGithub, 'prompts'));
-            }
-            // Copy instructions (if exists)
-            if (await fs_extra_1.default.pathExists(path_1.default.join(sourceGithub, 'instructions'))) {
-                await copyDirectory(path_1.default.join(sourceGithub, 'instructions'), path_1.default.join(targetGithub, 'instructions'));
-            }
-            spinner.succeed('Assets downloaded successfully');
-        }
-        else {
+        const [owner, repoName] = repo.split('/');
+        const client = await github_1.GitHubClient.create();
+        // Download .github directory contents
+        const files = await client.downloadDirectory(owner, repoName, '.github', branch);
+        if (files.length === 0) {
             spinner.fail('No .github directory found in repository');
             throw new Error('Repository does not contain .github directory');
         }
+        // Create progress bar for file writing
+        const progressBar = (0, progress_1.createProgressBar)({
+            label: 'Writing files',
+            total: files.length,
+            unit: 'files',
+        });
+        let written = 0;
+        // Write files to target directory
+        for (const file of files) {
+            const targetPath = path_1.default.join(targetDir, file.path);
+            // Ensure directory exists
+            await fs_extra_1.default.ensureDir(path_1.default.dirname(targetPath));
+            // Write file
+            await fs_extra_1.default.writeFile(targetPath, file.content);
+            // Update progress
+            written++;
+            progressBar.update(written);
+        }
+        progressBar.stop();
+        spinner.succeed(`Assets downloaded successfully (${files.length} files)`);
     }
     catch (error) {
         spinner.fail('Failed to download assets');
         throw error;
     }
-    finally {
-        // Cleanup temp directory
-        await fs_extra_1.default.remove(tempDir);
-    }
 }
 /**
- * Download config template from repo
+ * Download config template from repo using GitHub client
  */
 async function downloadConfigTemplate(repo = constants_1.CONSTANTS.REPO_FULL) {
     try {
-        // Use gh api to get file content
-        const { stdout } = await (0, execa_1.execa)('gh', [
-            'api',
-            `repos/${repo}/contents/templates/config.yml.template`,
-            '--jq',
-            '.content'
-        ]);
-        // Decode base64 content
-        const content = Buffer.from(stdout, 'base64').toString('utf-8');
-        return content;
+        const [owner, repoName] = repo.split('/');
+        const client = await github_1.GitHubClient.create();
+        // Download config template
+        const content = await client.downloadFile(owner, repoName, 'templates/config.yml.template');
+        return content.toString('utf-8');
     }
     catch (error) {
         // Return default template if not found
         return getDefaultConfigTemplate();
     }
 }
-/**
- * Copy directory recursively
- */
-async function copyDirectory(src, dest) {
-    await fs_extra_1.default.ensureDir(dest);
-    await fs_extra_1.default.copy(src, dest, { overwrite: true });
-}
 /**
  * Default config template (fallback)
  */

package/dist/utils/downloader.js.map

@@ -1 +1 @@
-{"version":3,"file":"downloader.js","sourceRoot":"","sources":["../../src/utils/downloader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"downloader.js","sourceRoot":"","sources":["../../src/utils/downloader.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;AAYH,oDAiDC;AAKD,wDAmBC;AAnFD,wDAA0B;AAC1B,gDAAwB;AACxB,mDAAgD;AAChD,qCAAkC;AAClC,8CAAiD;AACjD,yCAA+C;AAE/C;;GAEG;AACI,KAAK,UAAU,oBAAoB,CACxC,OAAe,qBAAS,CAAC,SAAS,EAClC,SAAiB,MAAM,EACvB,YAAoB,OAAO,CAAC,GAAG,EAAE;IAEjC,MAAM,OAAO,GAAG,eAAM,CAAC,OAAO,CAAC,2BAA2B,IAAI,KAAK,CAAC,CAAC;IAErE,IAAI,CAAC;QACH,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,qBAAY,CAAC,MAAM,EAAE,CAAC;QAE3C,sCAAsC;QACtC,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QAEjF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;YACzD,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QAED,uCAAuC;QACvC,MAAM,WAAW,GAAG,IAAA,4BAAiB,EAAC;YACpC,KAAK,EAAE,eAAe;YACtB,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,IAAI,EAAE,OAAO;SACd,CAAC,CAAC;QAEH,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,kCAAkC;QAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAEnD,0BAA0B;YAC1B,MAAM,kBAAE,CAAC,SAAS,CAAC,cAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;YAE7C,aAAa;YACb,MAAM,kBAAE,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YAE7C,kBAAkB;YAClB,OAAO,EAAE,CAAC;YACV,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;QAED,WAAW,CAAC,IAAI,EAAE,CAAC;QACnB,OAAO,CAAC,OAAO,CAAC,mCAAmC,KAAK,CAAC,MAAM,SAAS,CAAC,CAAC;IAC5E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAC1C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,sBAAsB,CAC1C,OAAe,qBAAS,CAAC,SAAS;IAElC,IAAI,CAAC;QACH,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,qBAAY,CAAC,MAAM,EAAE,CAAC;QAE3C,2BAA2B;QAC3B,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,YAAY,CACvC,KAAK,EACL,QAAQ,EACR,+BAA+B,CAChC,CAAC;QAEF,OAAO,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,uCAAuC;QACvC,OAAO,wBAAwB,EAAE,CAAC;IACpC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,wBAAwB;IAC/B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCR,CAAC;AACF,CAAC"}

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"}