@codexa/cli 9.0.5 → 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.5",
+  "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/",