ccjk 9.13.0 → 9.14.0

package/dist/chunks/init.mjs

@@ -197,6 +197,130 @@ async function installCometixLine() {
   }
 }
 
+function formatError(error, context) {
+  const errorMsg = typeof error === "string" ? error : error.message;
+  const patterns = [
+    {
+      pattern: /not initialized|Call initialize/i,
+      formatter: () => ({
+        title: "\u26A0\uFE0F  Configuration Not Ready",
+        message: "CCJK needs to be initialized first.",
+        suggestion: "Run the initialization command to set up your environment.",
+        command: "ccjk init"
+      })
+    },
+    {
+      pattern: /Failed to (start|connect|fetch)/i,
+      formatter: (match) => ({
+        title: "\u274C Connection Failed",
+        message: `Unable to ${match[1]} the service.`,
+        suggestion: "Check your internet connection and try again.",
+        command: "ccjk doctor"
+      })
+    },
+    {
+      pattern: /does not exist|not found/i,
+      formatter: () => ({
+        title: "\u{1F50D} File Not Found",
+        message: "The requested file or directory does not exist.",
+        suggestion: "Verify the path and try again."
+      })
+    },
+    {
+      pattern: /permission denied|EACCES/i,
+      formatter: () => ({
+        title: "\u{1F512} Permission Denied",
+        message: "You do not have permission to access this resource.",
+        suggestion: "Check file permissions or run with appropriate privileges.",
+        command: "sudo ccjk <command>"
+      })
+    },
+    {
+      pattern: /network|timeout|ETIMEDOUT|ECONNREFUSED/i,
+      formatter: () => ({
+        title: "\u{1F310} Network Error",
+        message: "Unable to connect to the server.",
+        suggestion: "Check your internet connection and firewall settings."
+      })
+    }
+  ];
+  for (const { pattern, formatter } of patterns) {
+    const match = errorMsg.match(pattern);
+    if (match) {
+      return formatter(match);
+    }
+  }
+  return {
+    title: "\u274C Error",
+    message: errorMsg,
+    suggestion: context ? `Context: ${context}` : "Run ccjk doctor for diagnostics.",
+    command: "ccjk doctor"
+  };
+}
+function displayError(error, context) {
+  const formatted = formatError(error, context);
+  console.error();
+  console.error(ansis.red.bold(formatted.title));
+  console.error(ansis.white(formatted.message));
+  if (formatted.suggestion) {
+    console.error();
+    console.error(ansis.yellow("\u{1F4A1} Suggestion:"), ansis.white(formatted.suggestion));
+  }
+  if (formatted.command) {
+    console.error(ansis.cyan("   Run:"), ansis.green(formatted.command));
+  }
+  if (formatted.docsUrl) {
+    console.error(ansis.cyan("   Docs:"), ansis.blue(formatted.docsUrl));
+  }
+  console.error();
+}
+
+class ProgressTracker {
+  currentStep = 0;
+  totalSteps;
+  steps;
+  startTime;
+  constructor(steps) {
+    this.steps = steps;
+    this.totalSteps = steps.length;
+    this.startTime = Date.now();
+  }
+  start() {
+    console.log();
+    console.log(ansis.cyan.bold("\u{1F680} Starting setup..."));
+    console.log(ansis.gray(`   ${this.totalSteps} steps to complete`));
+    console.log();
+  }
+  nextStep(message) {
+    this.currentStep++;
+    const stepName = message || this.steps[this.currentStep - 1];
+    const progress = Math.round(this.currentStep / this.totalSteps * 100);
+    const bar = this.renderProgressBar(progress);
+    console.log();
+    console.log(ansis.cyan(`[${this.currentStep}/${this.totalSteps}]`), ansis.white(stepName));
+    console.log(ansis.gray(`   ${bar} ${progress}%`));
+  }
+  complete() {
+    const duration = ((Date.now() - this.startTime) / 1e3).toFixed(1);
+    console.log();
+    console.log(ansis.green.bold("\u2705 Setup complete!"));
+    console.log(ansis.gray(`   Completed in ${duration}s`));
+    console.log();
+  }
+  error(message) {
+    console.log();
+    console.log(ansis.red.bold("\u274C Setup failed"));
+    console.log(ansis.white(`   ${message}`));
+    console.log();
+  }
+  renderProgressBar(percent) {
+    const width = 20;
+    const filled = Math.round(percent / 100 * width);
+    const empty = width - filled;
+    return ansis.green("\u2588".repeat(filled)) + ansis.gray("\u2591".repeat(empty));
+  }
+}
+
 async function validateSkipPromptOptions(options) {
   if (options.allLang) {
     if (options.allLang === "zh-CN" || options.allLang === "en") {
@@ -405,7 +529,20 @@ async function init(options = {}) {
     await validateSkipPromptOptions(options);
   }
   try {
+    const tracker = new ProgressTracker([
+      "Reading configuration",
+      "Selecting code tool",
+      "Configuring API",
+      "Installing MCP services",
+      "Setting up workflows",
+      "Finalizing setup"
+    ]);
+    if (!options.skipPrompt && !options.skipBanner) {
+      tracker.start();
+    }
+    if (!options.skipPrompt && !options.skipBanner) tracker.nextStep();
     const zcfConfig = readZcfConfig();
+    if (!options.skipPrompt && !options.skipBanner) tracker.nextStep();
     let codeToolType;
     try {
       codeToolType = await resolveCodeType(options.codeType);
@@ -645,6 +782,7 @@ async function init(options = {}) {
     } else if (options.skipPrompt && options.configAction) {
       action = options.configAction;
     }
+    if (!options.skipPrompt && !options.skipBanner) tracker.nextStep("Configuring API");
     let apiConfig = null;
     const isNewInstall = !existsSync(SETTINGS_FILE);
     if (action !== "docs-only" && (isNewInstall || ["backup", "merge", "new"].includes(action))) {
@@ -814,6 +952,7 @@ async function init(options = {}) {
           console.log(ansis.gray(`  Opus: ${options.apiOpusModel}`));
       }
     }
+    if (!options.skipPrompt && !options.skipBanner) tracker.nextStep("Installing MCP services");
     if (action !== "docs-only") {
       let shouldConfigureMcp = false;
       if (options.skipPrompt) {
@@ -895,7 +1034,7 @@ async function init(options = {}) {
               console.log(formatPerformanceWarning(perfWarning, i18n.language));
             }
           } catch (error) {
-            console.error(ansis.red(`${i18n.t("errors:failedToWriteMcpConfig")} ${error}`));
+            displayError(error, "MCP configuration");
           }
         }
       }
@@ -932,6 +1071,7 @@ async function init(options = {}) {
     } catch {
       console.log(ansis.gray(`\u2139 ${i18n.t("smartGuide:skipped")}`));
     }
+    if (!options.skipPrompt && !options.skipBanner) tracker.nextStep("Finalizing setup");
     updateZcfConfig({
       version,
       preferredLang: i18n.language,
@@ -963,6 +1103,7 @@ async function init(options = {}) {
         console.log();
       }
     }
+    if (!options.skipPrompt && !options.skipBanner) tracker.complete();
     console.log("");
     console.log(ansis.bold.green("\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557"));
     console.log(ansis.bold.green("\u2551") + ansis.bold.white(padToDisplayWidth(`  ${i18n.t("configuration:setupCompleteTitle")}`, 62)) + ansis.bold.green("\u2551"));
@@ -984,6 +1125,7 @@ async function init(options = {}) {
     console.log("");
   } catch (error) {
     if (!handleExitPromptError(error)) {
+      displayError(error, "Initialization");
       handleGeneralError(error);
     }
   }
@@ -1017,7 +1159,7 @@ async function handleMultiConfigurations(options, codeToolType) {
     }
     console.log(ansis.green(`\u2714 ${i18n.t("multi-config:configsAddedSuccessfully")}`));
   } catch (error) {
-    console.error(ansis.red(`${i18n.t("multi-config:configsFailed")}: ${error instanceof Error ? error.message : String(error)}`));
+    displayError(error, "Multi-config setup");
     throw error;
   }
 }

package/dist/chunks/package.mjs

@@ -1,4 +1,4 @@
-const version = "9.13.0";
+const version = "9.14.0";
 const homepage = "https://github.com/miounet11/ccjk";
 
 export { homepage, version };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ccjk",
   "type": "module",
-  "version": "9.13.0",
+  "version": "9.14.0",
   "packageManager": "pnpm@10.17.1",
   "description": "The missing toolkit for Claude Code. One command setup, 73% token savings, persistent memory, cloud sync, and Agent Teams. Zero config, 10x productivity.",
   "author": {