@codexa/cli 9.0.4 → 9.0.6

package/errors.ts

@@ -0,0 +1,59 @@
+/**
+ * Codexa error hierarchy.
+ * Thrown instead of process.exit() on critical paths.
+ * Caught by wrapAction() in workflow.ts which prints the message and exits.
+ */
+
+export class CodexaError extends Error {
+  readonly exitCode: number;
+
+  constructor(message: string, exitCode: number = 1) {
+    super(message);
+    this.name = "CodexaError";
+    this.exitCode = exitCode;
+  }
+}
+
+export interface RecoverySuggestion {
+  diagnostic: string;
+  steps: string[];
+  command?: string;
+}
+
+export class GateError extends CodexaError {
+  readonly gateName: string;
+  readonly resolution: string;
+  readonly recovery?: RecoverySuggestion;
+
+  constructor(reason: string, resolution: string, gateName?: string, recovery?: RecoverySuggestion) {
+    super(`BLOQUEADO: ${reason}\nResolva: ${resolution}`);
+    this.name = "GateError";
+    this.gateName = gateName || "";
+    this.resolution = resolution;
+    this.recovery = recovery;
+  }
+}
+
+export class ValidationError extends CodexaError {
+  constructor(message: string) {
+    super(message, 2);
+    this.name = "ValidationError";
+  }
+}
+
+export class TaskStateError extends CodexaError {
+  constructor(message: string) {
+    super(message, 2);
+    this.name = "TaskStateError";
+  }
+}
+
+export class KnowledgeBlockError extends CodexaError {
+  readonly unackedItems: any[];
+
+  constructor(message: string, unackedItems: any[]) {
+    super(message);
+    this.name = "KnowledgeBlockError";
+    this.unackedItems = unackedItems;
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codexa/cli",
-  "version": "9.0.4",
+  "version": "9.0.6",
   "description": "Orchestrated workflow system for Claude Code - manages feature development through parallel subagents with structured phases, gates, and quality enforcement.",
   "type": "module",
   "bin": {
@@ -8,6 +8,7 @@
   },
   "files": [
     "workflow.ts",
+    "errors.ts",
     "commands/",
     "db/",
     "gates/",

package/workflow.ts

@@ -48,7 +48,7 @@ import pkg from "./package.json";
 import { CodexaError, ValidationError, GateError } from "./errors";
 
 function checkVersionSync(): void {
-  // 1. Check CLI vs Plugin (dev repo only)
+  // 1. Check CLI vs Plugin (dev repo only — igualdade estrita)
   try {
     const gitRoot = execSync("git rev-parse --show-toplevel", { encoding: "utf-8" }).trim();
     const pluginJson = join(gitRoot, "plugins", "codexa-workflow", ".claude-plugin", "plugin.json");
@@ -62,11 +62,12 @@ function checkVersionSync(): void {
         );
       }
     }
-  } catch {
+  } catch (e) {
+    if (e instanceof CodexaError) throw e;
     // Not in dev repo — skip
   }
 
-  // 2. Check CLI vs project's stored version (client projects)
+  // 2. Track CLI version in project DB (informativo, migracoes garantem compatibilidade)
   try {
     const dbPath = join(process.cwd(), ".codexa", "db", "workflow.db");
     if (!existsSync(dbPath)) return;
@@ -77,7 +78,6 @@ function checkVersionSync(): void {
     if (!project) return;
 
     if (!project.cli_version) {
-      // Projeto existente sem versao gravada (pre-v8.7) — registrar versao atual
       db.run(
         `UPDATE project SET cli_version = ? WHERE id = 'default'`,
         [pkg.version]
@@ -87,12 +87,13 @@ function checkVersionSync(): void {
     }
 
     if (project.cli_version !== pkg.version) {
-      throw new CodexaError(
-        `✘ Versao incompativel: CLI=${pkg.version} Projeto=${project.cli_version}\n` +
-        `  O projeto foi configurado com CLI v${project.cli_version} mas voce esta usando v${pkg.version}.\n` +
-        `  Opcoes:\n` +
-        `    1. Atualize o CLI: bun add -g @codexa/cli@${project.cli_version}\n` +
-        `    2. Reconfigure o projeto: codexa discover reset && codexa discover start`
+      console.log(
+        `ℹ Projeto configurado com CLI v${project.cli_version}, rodando v${pkg.version}. ` +
+        `Migracoes aplicadas automaticamente.`
+      );
+      db.run(
+        `UPDATE project SET cli_version = ? WHERE id = 'default'`,
+        [pkg.version]
       );
     }
   } catch {