@dura-run/cli 0.3.0 → 0.3.1

package/dist/dura.js

@@ -2834,6 +2834,22 @@ var init_hello = __esm(() => {
   HELLO_TEMPLATE = GET_TEMPLATE;
 });
 
+// src/lib/handle-api-error.ts
+function reportApiError(output, err, fallbackCode) {
+  if (err instanceof ApiClientError) {
+    output.error(err.code, err.message, err.suggestion);
+    return;
+  }
+  if (err instanceof Error) {
+    output.error(fallbackCode, err.message);
+    return;
+  }
+  output.error(fallbackCode, String(err));
+}
+var init_handle_api_error = __esm(() => {
+  init_api_client();
+});
+
 // src/commands/new.ts
 var exports_new = {};
 __export(exports_new, {
@@ -2890,11 +2906,7 @@ function registerNewCommand(program2) {
 Set required secrets: ${result.requiredSecrets.join(", ")}`);
         }
       } catch (err) {
-        if (err instanceof ApiClientError) {
-          output.error(err.code, err.message, err.suggestion);
-        } else if (err instanceof Error) {
-          output.error("FORK_FAILED", err.message);
-        }
+        reportApiError(output, err, "FORK_FAILED");
       }
       return;
     }
@@ -2948,6 +2960,7 @@ var init_new = __esm(() => {
   init_hello();
   init_api_client();
   init_config_store();
+  init_handle_api_error();
 });
 
 // src/lib/project-id.ts
@@ -3002,9 +3015,7 @@ function registerSecretsCommand(program2) {
       const result = await client.put(`/api/v1/projects/${projectId}/secrets`, { name, value });
       output.success(result);
     } catch (err) {
-      if (err instanceof Error) {
-        output.error("SECRET_SET_FAILED", err.message);
-      }
+      reportApiError(output, err, "SECRET_SET_FAILED");
     }
   });
   secrets.command("list").description("List secret names (values never shown)").option("--project <id>", "Project ID (defaults to dura.json)").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (opts, cmd) => {
@@ -3017,9 +3028,7 @@ function registerSecretsCommand(program2) {
       const result = await client.get(`/api/v1/projects/${projectId}/secrets`);
       output.table(["Name", "Created", "Updated"], result.map((s) => [s.name, s.createdAt, s.updatedAt]));
     } catch (err) {
-      if (err instanceof Error) {
-        output.error("SECRET_LIST_FAILED", err.message);
-      }
+      reportApiError(output, err, "SECRET_LIST_FAILED");
     }
   });
   secrets.command("remove <name>").description("Remove a secret").option("--project <id>", "Project ID (defaults to dura.json)").option("--confirm", "Confirm this destructive operation").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (name, opts, cmd) => {
@@ -3036,9 +3045,7 @@ function registerSecretsCommand(program2) {
       await client.delete(`/api/v1/projects/${projectId}/secrets/${name}`);
       output.success({ deleted: true, name });
     } catch (err) {
-      if (err instanceof Error) {
-        output.error("SECRET_REMOVE_FAILED", err.message);
-      }
+      reportApiError(output, err, "SECRET_REMOVE_FAILED");
     }
   });
   secrets.command("pull").description("Write secrets to .env.local for local development").option("--project <id>", "Project ID (defaults to dura.json)").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").option("--dir <path>", "Directory to write .env.local to", ".").action(async (opts, cmd) => {
@@ -3059,9 +3066,7 @@ function registerSecretsCommand(program2) {
         count: Object.keys(values).length
       });
     } catch (err) {
-      if (err instanceof Error) {
-        output.error("SECRET_PULL_FAILED", err.message);
-      }
+      reportApiError(output, err, "SECRET_PULL_FAILED");
     }
   });
 }
@@ -3069,6 +3074,7 @@ var init_secrets = __esm(() => {
   init_src3();
   init_api_client();
   init_config_store();
+  init_handle_api_error();
   init_project_id();
 });
 
@@ -13884,9 +13890,7 @@ function registerConfigCommand(program2) {
       setManifestValue(opts.dir, path, parsed);
       output.success({ path, value: parsed });
     } catch (err) {
-      if (err instanceof Error) {
-        output.error("CONFIG_SET_FAILED", err.message);
-      }
+      reportApiError(output, err, "CONFIG_SET_FAILED");
     }
   });
   config.command("get <path>").description("Get a config value using dot-path notation").option("--dir <path>", "Project directory", ".").action((path, opts, cmd) => {
@@ -13899,15 +13903,14 @@ function registerConfigCommand(program2) {
       }
       output.success({ path, value });
     } catch (err) {
-      if (err instanceof Error) {
-        output.error("CONFIG_GET_FAILED", err.message);
-      }
+      reportApiError(output, err, "CONFIG_GET_FAILED");
     }
   });
 }
 var init_config = __esm(() => {
   init_src3();
   init_manifest2();
+  init_handle_api_error();
 });
 
 // src/commands/status.ts
@@ -13929,9 +13932,7 @@ function registerStatusCommand(program2) {
       const project = await client.get(`/api/v1/orgs/${opts.org}/projects/${opts.project}`);
       output.success(project);
     } catch (err) {
-      if (err instanceof Error) {
-        output.error("STATUS_FAILED", err.message);
-      }
+      reportApiError(output, err, "STATUS_FAILED");
     }
   });
 }
@@ -13939,6 +13940,7 @@ var init_status = __esm(() => {
   init_src3();
   init_api_client();
   init_config_store();
+  init_handle_api_error();
 });
 
 // src/commands/audit.ts
@@ -13970,9 +13972,7 @@ function registerAuditCommand(program2) {
         e.userId
       ]));
     } catch (err) {
-      if (err instanceof Error) {
-        output.error("AUDIT_FAILED", err.message);
-      }
+      reportApiError(output, err, "AUDIT_FAILED");
     }
   });
 }
@@ -13980,6 +13980,7 @@ var init_audit = __esm(() => {
   init_src3();
   init_api_client();
   init_config_store();
+  init_handle_api_error();
 });
 
 // src/lib/manifest-generator.ts
@@ -14230,11 +14231,7 @@ Live at:`);
         }
       }
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("DEPLOY_FAILED", err.message);
-      }
+      reportApiError(output, err, "DEPLOY_FAILED");
     }
   });
 }
@@ -14244,6 +14241,7 @@ var init_deploy = __esm(() => {
   init_config_store();
   init_bundler();
   init_manifest2();
+  init_handle_api_error();
 });
 
 // src/commands/rollback.ts
@@ -14273,11 +14271,7 @@ function registerRollbackCommand(program2) {
         activatedAt: deployment.activatedAt
       });
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("ROLLBACK_FAILED", err.message);
-      }
+      reportApiError(output, err, "ROLLBACK_FAILED");
     }
   });
 }
@@ -14285,6 +14279,7 @@ var init_rollback = __esm(() => {
   init_src3();
   init_api_client();
   init_config_store();
+  init_handle_api_error();
 });
 
 // src/commands/openapi.ts
@@ -14306,9 +14301,7 @@ function registerOpenApiCommand(program2) {
       const spec = await client.get(`/api/v1/projects/${opts.project}/openapi/_dura/openapi.json`, { projectId: opts.project });
       output.success(spec);
     } catch (err) {
-      if (err instanceof Error) {
-        output.error("OPENAPI_FAILED", err.message);
-      }
+      reportApiError(output, err, "OPENAPI_FAILED");
     }
   });
 }
@@ -14316,6 +14309,7 @@ var init_openapi = __esm(() => {
   init_src3();
   init_api_client();
   init_config_store();
+  init_handle_api_error();
 });
 
 // src/commands/logs.ts
@@ -14579,11 +14573,7 @@ Error: ${name}
         ]));
       }
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("LOGS_FAILED", err.message);
-      }
+      reportApiError(output, err, "LOGS_FAILED");
     }
   });
 }
@@ -14592,6 +14582,7 @@ var init_logs = __esm(() => {
   init_api_client();
   init_config_store();
   init_project_id();
+  init_handle_api_error();
 });
 
 // src/commands/run.ts
@@ -14625,11 +14616,7 @@ function registerRunCommand(program2) {
       });
       output.success(result);
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("RUN_FAILED", err.message);
-      }
+      reportApiError(output, err, "RUN_FAILED");
     }
   });
 }
@@ -14637,6 +14624,7 @@ var init_run = __esm(() => {
   init_src3();
   init_api_client();
   init_config_store();
+  init_handle_api_error();
 });
 
 // src/commands/schedule.ts
@@ -14672,11 +14660,7 @@ function registerScheduleCommand(program2) {
       });
       output.success(result);
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("SCHEDULE_FAILED", err.message);
-      }
+      reportApiError(output, err, "SCHEDULE_FAILED");
     }
   });
   schedule.command("list").description("List cron schedules for a project").option("--project <id>", "Project ID (defaults to dura.json)").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (opts, cmd) => {
@@ -14695,11 +14679,7 @@ function registerScheduleCommand(program2) {
       const result = await auth.client.get(`/api/v1/projects/${projectId}/schedules`);
       output.success(result);
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("SCHEDULE_LIST_FAILED", err.message);
-      }
+      reportApiError(output, err, "SCHEDULE_LIST_FAILED");
     }
   });
   schedule.command("remove <schedule-id>").description("Remove a cron schedule").option("--project <id>", "Project ID (defaults to dura.json)").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").option("--confirm", "Confirm the destructive delete operation").action(async (scheduleId, opts, cmd) => {
@@ -14722,11 +14702,7 @@ function registerScheduleCommand(program2) {
       const result = await auth.client.delete(`/api/v1/projects/${projectId}/schedules/${scheduleId}`);
       output.success(result);
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("SCHEDULE_REMOVE_FAILED", err.message);
-      }
+      reportApiError(output, err, "SCHEDULE_REMOVE_FAILED");
     }
   });
 }
@@ -14735,6 +14711,7 @@ var init_schedule = __esm(() => {
   init_api_client();
   init_config_store();
   init_project_id();
+  init_handle_api_error();
 });
 
 // src/lib/dev-trust.ts
@@ -16582,9 +16559,7 @@ Add this TXT record to your DNS:
 Then run: dura domains verify ${result.id} --project ${projectId}`);
       }
     } catch (err) {
-      if (err instanceof Error) {
-        output.error("DOMAIN_ADD_FAILED", err.message);
-      }
+      reportApiError(output, err, "DOMAIN_ADD_FAILED");
     }
   });
   domains.command("list").description("List custom domains").option("--project <id>", "Project ID (defaults to dura.json)").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (opts, cmd) => {
@@ -16602,9 +16577,7 @@ Then run: dura domains verify ${result.id} --project ${projectId}`);
         d.createdAt
       ]));
     } catch (err) {
-      if (err instanceof Error) {
-        output.error("DOMAIN_LIST_FAILED", err.message);
-      }
+      reportApiError(output, err, "DOMAIN_LIST_FAILED");
     }
   });
   domains.command("remove <domainId>").description("Remove a custom domain").option("--project <id>", "Project ID (defaults to dura.json)").option("--confirm", "Confirm this destructive operation").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (domainId, opts, cmd) => {
@@ -16621,9 +16594,7 @@ Then run: dura domains verify ${result.id} --project ${projectId}`);
       await client.delete(`/api/v1/projects/${projectId}/domains/${domainId}`);
       output.success({ deleted: true, domainId });
     } catch (err) {
-      if (err instanceof Error) {
-        output.error("DOMAIN_REMOVE_FAILED", err.message);
-      }
+      reportApiError(output, err, "DOMAIN_REMOVE_FAILED");
     }
   });
   domains.command("verify <domainId>").description("Verify a domain's DNS TXT record").option("--project <id>", "Project ID (defaults to dura.json)").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (domainId, opts, cmd) => {
@@ -16636,9 +16607,7 @@ Then run: dura domains verify ${result.id} --project ${projectId}`);
       const result = await client.post(`/api/v1/projects/${projectId}/domains/${domainId}/verify`, {});
       output.success(result);
     } catch (err) {
-      if (err instanceof Error) {
-        output.error("DOMAIN_VERIFY_FAILED", err.message);
-      }
+      reportApiError(output, err, "DOMAIN_VERIFY_FAILED");
     }
   });
 }
@@ -16647,6 +16616,7 @@ var init_domains = __esm(() => {
   init_api_client();
   init_config_store();
   init_project_id();
+  init_handle_api_error();
 });
 
 // src/commands/endpoint-keys.ts
@@ -16686,9 +16656,7 @@ function registerEndpointKeysCommand(program2) {
         output.warn("Save the key now — it will not be shown again.");
       }
     } catch (err) {
-      if (err instanceof Error) {
-        output.error("ENDPOINT_KEY_CREATE_FAILED", err.message);
-      }
+      reportApiError(output, err, "ENDPOINT_KEY_CREATE_FAILED");
     }
   });
   keys.command("list").description("List endpoint keys for a project").option("--project <id>", "Project ID (defaults to dura.json)").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (opts, cmd) => {
@@ -16708,9 +16676,7 @@ function registerEndpointKeysCommand(program2) {
         k.createdAt
       ]));
     } catch (err) {
-      if (err instanceof Error) {
-        output.error("ENDPOINT_KEY_LIST_FAILED", err.message);
-      }
+      reportApiError(output, err, "ENDPOINT_KEY_LIST_FAILED");
     }
   });
   keys.command("revoke <keyId>").description("Revoke an endpoint key").option("--project <id>", "Project ID (defaults to dura.json)").option("--confirm", "Confirm this destructive operation").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (keyId, opts, cmd) => {
@@ -16727,9 +16693,7 @@ function registerEndpointKeysCommand(program2) {
       await client.post(`/api/v1/projects/${projectId}/endpoint-keys/${keyId}/revoke`, {});
       output.success({ revoked: true, keyId });
     } catch (err) {
-      if (err instanceof Error) {
-        output.error("ENDPOINT_KEY_REVOKE_FAILED", err.message);
-      }
+      reportApiError(output, err, "ENDPOINT_KEY_REVOKE_FAILED");
     }
   });
 }
@@ -16738,6 +16702,81 @@ var init_endpoint_keys2 = __esm(() => {
   init_api_client();
   init_config_store();
   init_project_id();
+  init_handle_api_error();
+});
+
+// src/commands/events.ts
+var exports_events = {};
+__export(exports_events, {
+  resolvePayload: () => resolvePayload,
+  registerEventsCommand: () => registerEventsCommand
+});
+import { readFileSync as readFileSync8 } from "node:fs";
+function resolvePayload(opts) {
+  if (opts.payload !== undefined && opts.payloadFile !== undefined) {
+    throw new Error("Use either --payload or --payload-file, not both");
+  }
+  if (opts.payload === undefined && opts.payloadFile === undefined) {
+    throw new Error("--payload or --payload-file is required");
+  }
+  const raw = opts.payload !== undefined ? opts.payload : readFileSync8(opts.payloadFile, "utf-8");
+  try {
+    return JSON.parse(raw);
+  } catch (err) {
+    throw new Error(`Invalid JSON in payload: ${err.message}`);
+  }
+}
+function registerEventsCommand(program2) {
+  const events = program2.command("events").description("Emit and inspect project events");
+  events.command("emit <source>").description("Emit an event to all matching event triggers").option("--payload <json>", "Inline JSON payload").option("--payload-file <path>", "Path to a JSON file containing the payload").option("--project <id>", "Project ID (defaults to dura.json)").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (source, opts, cmd) => {
+    const output = getOutput(cmd);
+    let payload;
+    try {
+      payload = resolvePayload(opts);
+    } catch (err) {
+      output.error("INVALID_PAYLOAD", err.message);
+      return;
+    }
+    const projectId = resolveProjectId({ project: opts.project });
+    if (!projectId) {
+      output.error("PROJECT_REQUIRED", "No project ID. Use --project or run this command inside a dura.json project.");
+      return;
+    }
+    const token = opts.token || getAuthToken();
+    if (!token) {
+      output.error("AUTH_REQUIRED", "Not logged in", "Run: dura login");
+      return;
+    }
+    const apiUrl = opts.apiUrl || getApiUrl();
+    const client = new ApiClient(apiUrl, token);
+    try {
+      const result = await client.post(`/api/v1/projects/${projectId}/events`, { source, payload });
+      if (output.isJson()) {
+        output.success(result);
+        return;
+      }
+      if (result.jobs.length === 0) {
+        process.stdout.write(`Event "${source}" emitted — no subscribers matched.
+`);
+        return;
+      }
+      process.stdout.write(`Event "${source}" emitted — enqueued ${result.jobs.length} execution(s):
+`);
+      for (const job of result.jobs) {
+        process.stdout.write(`  • ${job.automationName} → execution ${job.trigger.executionId}
+`);
+      }
+    } catch (err) {
+      const e = err;
+      output.error(e.code ?? "EMIT_FAILED", e.message);
+    }
+  });
+}
+var init_events = __esm(() => {
+  init_src3();
+  init_api_client();
+  init_config_store();
+  init_project_id();
 });
 
 // src/commands/usage.ts
@@ -16824,11 +16863,7 @@ function registerUsageCommand(program2) {
         browserTime: formatMs(summary.totals.totalBrowserSessionMs)
       });
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("USAGE_QUERY_FAILED", err.message);
-      }
+      reportApiError(output, err, "USAGE_QUERY_FAILED");
     }
   });
 }
@@ -16836,6 +16871,7 @@ var init_usage = __esm(() => {
   init_src3();
   init_api_client();
   init_config_store();
+  init_handle_api_error();
 });
 
 // src/commands/marketplace.ts
@@ -16873,11 +16909,7 @@ function registerMarketplaceCommand(program2) {
         status: adapter.status
       });
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("PUBLISH_FAILED", err.message);
-      }
+      reportApiError(output, err, "PUBLISH_FAILED");
     }
   });
   marketplace.command("install").description("Install an adapter into a project").requiredOption("--project <id>", "Project ID").requiredOption("--adapter <id>", "Adapter ID").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (opts, cmd) => {
@@ -16898,11 +16930,7 @@ function registerMarketplaceCommand(program2) {
         version: install.adapterVersion
       });
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("INSTALL_FAILED", err.message);
-      }
+      reportApiError(output, err, "INSTALL_FAILED");
     }
   });
   marketplace.command("list").description("List available adapters").option("--category <cat>", "Filter by category").option("--query <q>", "Search query").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (opts, cmd) => {
@@ -16938,11 +16966,7 @@ function registerMarketplaceCommand(program2) {
         a.status
       ]));
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("LIST_FAILED", err.message);
-      }
+      reportApiError(output, err, "LIST_FAILED");
     }
   });
   marketplace.command("uninstall").description("Uninstall an adapter from a project").requiredOption("--project <id>", "Project ID").requiredOption("--adapter <id>", "Adapter ID").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").option("--confirm", "Confirm the destructive uninstall operation").action(async (opts, cmd) => {
@@ -16962,11 +16986,7 @@ function registerMarketplaceCommand(program2) {
       await client.post(`/api/v1/projects/${opts.project}/adapters/uninstall`, { adapterId: opts.adapter });
       output.success({ uninstalled: true, adapterId: opts.adapter });
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("UNINSTALL_FAILED", err.message);
-      }
+      reportApiError(output, err, "UNINSTALL_FAILED");
     }
   });
 }
@@ -16974,6 +16994,7 @@ var init_marketplace2 = __esm(() => {
   init_src3();
   init_api_client();
   init_config_store();
+  init_handle_api_error();
 });
 
 // src/commands/export.ts
@@ -16985,7 +17006,7 @@ __export(exports_export, {
 });
 import {
   existsSync as existsSync10,
-  readFileSync as readFileSync8,
+  readFileSync as readFileSync9,
   readdirSync as readdirSync3,
   statSync,
   writeFileSync as writeFileSync8
@@ -17005,7 +17026,7 @@ function collectExportFiles(baseDir, currentDir) {
       }
     } else if (stat.isFile()) {
       if (!EXCLUDED_FILES.has(item)) {
-        const content = readFileSync8(fullPath, "utf-8");
+        const content = readFileSync9(fullPath, "utf-8");
         entries.push({ relativePath: relPath, content });
       }
     }
@@ -17036,7 +17057,7 @@ function registerExportCommand(program2) {
     }
     let projectName;
     try {
-      const manifestContent = readFileSync8(manifestPath, "utf-8");
+      const manifestContent = readFileSync9(manifestPath, "utf-8");
       const manifest = JSON.parse(manifestContent);
       projectName = manifest.name ?? "unnamed-project";
     } catch {
@@ -17124,11 +17145,7 @@ function registerReplayCommand(program2) {
       const result = await client.post(`/api/v1/projects/${projectId}/executions/${executionId}/replay`, { overrides });
       output.success(result);
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("REPLAY_FAILED", err.message);
-      }
+      reportApiError(output, err, "REPLAY_FAILED");
     }
   });
 }
@@ -17165,11 +17182,7 @@ function registerReplaysCommand(program2) {
         r.replayOf ?? "-"
       ]));
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("REPLAYS_FAILED", err.message);
-      }
+      reportApiError(output, err, "REPLAYS_FAILED");
     }
   });
 }
@@ -17178,6 +17191,7 @@ var init_replay = __esm(() => {
   init_api_client();
   init_config_store();
   init_project_id();
+  init_handle_api_error();
 });
 
 // src/commands/kv.ts
@@ -17224,11 +17238,7 @@ function registerKvCommand(program2) {
       }
       output.table(["Key"], keys.map((k) => [k]));
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("KV_LIST_FAILED", err.message);
-      }
+      reportApiError(output, err, "KV_LIST_FAILED");
     }
   });
   kv.command("get <key>").description("Get the value for a key").option("--project <id>", "Project ID (defaults to dura.json)").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (key, opts, cmd) => {
@@ -17241,11 +17251,7 @@ function registerKvCommand(program2) {
       const result = await client.get(`/api/v1/projects/${projectId}/kv/${encodeURIComponent(key)}`);
       output.success(result);
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("KV_GET_FAILED", err.message);
-      }
+      reportApiError(output, err, "KV_GET_FAILED");
     }
   });
   kv.command("set <key> <value>").description("Set a value for a key").option("--project <id>", "Project ID (defaults to dura.json)").option("--ttl <seconds>", "Time-to-live in seconds (0 = no expiry)").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (key, valueStr, opts, cmd) => {
@@ -17268,11 +17274,7 @@ function registerKvCommand(program2) {
       const result = await client.put(`/api/v1/projects/${projectId}/kv/${encodeURIComponent(key)}`, body);
       output.success(result);
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("KV_SET_FAILED", err.message);
-      }
+      reportApiError(output, err, "KV_SET_FAILED");
     }
   });
   kv.command("delete <key>").description("Delete a key from the KV namespace").option("--project <id>", "Project ID (defaults to dura.json)").option("--confirm", "Required to actually perform the delete").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (key, opts, cmd) => {
@@ -17289,11 +17291,7 @@ function registerKvCommand(program2) {
       await client.delete(`/api/v1/projects/${projectId}/kv/${encodeURIComponent(key)}`);
       output.success({ deleted: true, key });
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("KV_DELETE_FAILED", err.message);
-      }
+      reportApiError(output, err, "KV_DELETE_FAILED");
     }
   });
   kv.command("flush").description("Remove all keys in the project KV namespace").option("--project <id>", "Project ID (defaults to dura.json)").option("--confirm", "Required to actually perform the flush").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (opts, cmd) => {
@@ -17310,11 +17308,7 @@ function registerKvCommand(program2) {
       await client.delete(`/api/v1/projects/${projectId}/kv`);
       output.success({ flushed: true });
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("KV_FLUSH_FAILED", err.message);
-      }
+      reportApiError(output, err, "KV_FLUSH_FAILED");
     }
   });
   kv.command("stats").description("Show KV usage statistics for the project").option("--project <id>", "Project ID (defaults to dura.json)").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (opts, cmd) => {
@@ -17327,11 +17321,7 @@ function registerKvCommand(program2) {
       const stats = await client.get(`/api/v1/projects/${projectId}/kv/stats`);
       output.success(stats);
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("KV_STATS_FAILED", err.message);
-      }
+      reportApiError(output, err, "KV_STATS_FAILED");
     }
   });
 }
@@ -17340,6 +17330,7 @@ var init_kv2 = __esm(() => {
   init_api_client();
   init_config_store();
   init_project_id();
+  init_handle_api_error();
 });
 
 // src/commands/webhook.ts
@@ -17406,9 +17397,7 @@ Webhook relay "${result.name}" created.
 ` + `ID: ${result.id}`);
       }
     } catch (err) {
-      if (err instanceof Error) {
-        output.error("WEBHOOK_CREATE_FAILED", err.message);
-      }
+      reportApiError(output, err, "WEBHOOK_CREATE_FAILED");
     }
   });
   webhook.command("list").description("List webhook relays").requiredOption("--project <id>", "Project ID").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (opts, cmd) => {
@@ -17431,9 +17420,7 @@ Webhook relay "${result.name}" created.
         ]));
       }
     } catch (err) {
-      if (err instanceof Error) {
-        output.error("WEBHOOK_LIST_FAILED", err.message);
-      }
+      reportApiError(output, err, "WEBHOOK_LIST_FAILED");
     }
   });
   webhook.command("show <nameOrId>").description("Show webhook relay details").requiredOption("--project <id>", "Project ID").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (nameOrId, opts, cmd) => {
@@ -17446,9 +17433,7 @@ Webhook relay "${result.name}" created.
       const result = await client.get(`${webhookBase(opts.project)}/${nameOrId}`);
       output.success(result);
     } catch (err) {
-      if (err instanceof Error) {
-        output.error("WEBHOOK_SHOW_FAILED", err.message);
-      }
+      reportApiError(output, err, "WEBHOOK_SHOW_FAILED");
     }
   });
   webhook.command("update <nameOrId>").description("Update a webhook relay").requiredOption("--project <id>", "Project ID").option("--name <name>", "New relay name").option("--events <events>", "New comma-separated event types").option("--forward <url>", "New destination URL").option("--transform <json>", "New transform template JSON").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (nameOrId, opts, cmd) => {
@@ -17482,9 +17467,7 @@ Webhook relay "${result.name}" created.
       const result = await client.patch(`${webhookBase(opts.project)}/${nameOrId}`, patch);
       output.success(result);
     } catch (err) {
-      if (err instanceof Error) {
-        output.error("WEBHOOK_UPDATE_FAILED", err.message);
-      }
+      reportApiError(output, err, "WEBHOOK_UPDATE_FAILED");
     }
   });
   webhook.command("delete <nameOrId>").description("Delete a webhook relay").requiredOption("--project <id>", "Project ID").option("--confirm", "Confirm this destructive operation").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (nameOrId, opts, cmd) => {
@@ -17501,9 +17484,7 @@ Webhook relay "${result.name}" created.
       await client.delete(`${webhookBase(opts.project)}/${nameOrId}`);
       output.success({ deleted: true, nameOrId });
     } catch (err) {
-      if (err instanceof Error) {
-        output.error("WEBHOOK_DELETE_FAILED", err.message);
-      }
+      reportApiError(output, err, "WEBHOOK_DELETE_FAILED");
     }
   });
   webhook.command("enable <nameOrId>").description("Enable a webhook relay").requiredOption("--project <id>", "Project ID").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (nameOrId, opts, cmd) => {
@@ -17516,9 +17497,7 @@ Webhook relay "${result.name}" created.
       const result = await client.patch(`${webhookBase(opts.project)}/${nameOrId}`, { enabled: true });
       output.success(result);
     } catch (err) {
-      if (err instanceof Error) {
-        output.error("WEBHOOK_ENABLE_FAILED", err.message);
-      }
+      reportApiError(output, err, "WEBHOOK_ENABLE_FAILED");
     }
   });
   webhook.command("disable <nameOrId>").description("Disable a webhook relay").requiredOption("--project <id>", "Project ID").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (nameOrId, opts, cmd) => {
@@ -17531,9 +17510,7 @@ Webhook relay "${result.name}" created.
       const result = await client.patch(`${webhookBase(opts.project)}/${nameOrId}`, { enabled: false });
       output.success(result);
     } catch (err) {
-      if (err instanceof Error) {
-        output.error("WEBHOOK_DISABLE_FAILED", err.message);
-      }
+      reportApiError(output, err, "WEBHOOK_DISABLE_FAILED");
     }
   });
   webhook.command("test <nameOrId>").description("Test a webhook relay with a sample payload").requiredOption("--project <id>", "Project ID").option("--payload <json>", "JSON payload to send", "{}").option("--event <type>", "Event type (sets X-GitHub-Event header for github sources)").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (nameOrId, opts, cmd) => {
@@ -17570,9 +17547,7 @@ Webhook relay "${result.name}" created.
         }
       }
     } catch (err) {
-      if (err instanceof Error) {
-        output.error("WEBHOOK_TEST_FAILED", err.message);
-      }
+      reportApiError(output, err, "WEBHOOK_TEST_FAILED");
     }
   });
   webhook.command("deliveries <nameOrId>").description("Show recent deliveries for a webhook relay").requiredOption("--project <id>", "Project ID").option("--last <n>", "Number of recent deliveries to show", "10").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (nameOrId, opts, cmd) => {
@@ -17605,9 +17580,7 @@ Webhook relay "${result.name}" created.
         ]));
       }
     } catch (err) {
-      if (err instanceof Error) {
-        output.error("WEBHOOK_DELIVERIES_FAILED", err.message);
-      }
+      reportApiError(output, err, "WEBHOOK_DELIVERIES_FAILED");
     }
   });
 }
@@ -17615,6 +17588,7 @@ var init_webhook = __esm(() => {
   init_src3();
   init_api_client();
   init_config_store();
+  init_handle_api_error();
 });
 
 // src/commands/template.ts
@@ -17656,11 +17630,7 @@ function registerTemplateCommand(program2) {
         String(t.starCount)
       ]));
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("LIST_FAILED", err.message);
-      }
+      reportApiError(output, err, "LIST_FAILED");
     }
   });
   const template = program2.command("template").description("Manage project templates");
@@ -17689,11 +17659,7 @@ function registerTemplateCommand(program2) {
       }
       output.success({ slug: t.slug, bundleRef: t.bundleRef });
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("SHOW_FAILED", err.message);
-      }
+      reportApiError(output, err, "SHOW_FAILED");
     }
   });
   template.command("publish").description("Publish a project as a template").requiredOption("--name <name>", "Template name").requiredOption("--slug <slug>", "Unique slug").requiredOption("--description <desc>", "Short description").requiredOption("--version <ver>", "Semver version (e.g. 1.0.0)").requiredOption("--bundle-ref <ref>", "Bundle storage reference (bucket/key)").option("--category <cat>", "Category", "general").option("--tags <tags>", "Comma-separated tags").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (opts, cmd) => {
@@ -17725,11 +17691,7 @@ function registerTemplateCommand(program2) {
         status: t.status
       });
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("PUBLISH_FAILED", err.message);
-      }
+      reportApiError(output, err, "PUBLISH_FAILED");
     }
   });
   program2.command("fork <slug>").description("Fork a template into a new project").requiredOption("--name <name>", "New project name").option("--org <id>", "Organization ID").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (slug, opts, cmd) => {
@@ -17765,11 +17727,7 @@ Set required secrets: ${result.requiredSecrets.join(", ")}`);
         output.info("Run: dura secrets set <name> <value>");
       }
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("FORK_FAILED", err.message);
-      }
+      reportApiError(output, err, "FORK_FAILED");
     }
   });
 }
@@ -17777,6 +17735,7 @@ var init_template = __esm(() => {
   init_src3();
   init_api_client();
   init_config_store();
+  init_handle_api_error();
 });
 
 // src/commands/deployments.ts
@@ -17818,11 +17777,7 @@ function registerDeploymentsCommand(program2) {
       }
       output.table(["ID", "Status", "Created At"], deploymentList.map((d) => [d.id, d.status, d.createdAt]));
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("DEPLOYMENTS_LIST_FAILED", err.message);
-      }
+      reportApiError(output, err, "DEPLOYMENTS_LIST_FAILED");
     }
   });
   deployments2.command("get").description("Show details for a specific deployment").option("--project <id>", "Project ID (defaults to dura.json)").requiredOption("--id <deploymentId>", "Deployment ID").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (opts, cmd) => {
@@ -17835,11 +17790,7 @@ function registerDeploymentsCommand(program2) {
       const deployment = await client.get(`/api/v1/projects/${projectId}/deployments/${opts.id}`);
       output.success(deployment);
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("DEPLOYMENTS_GET_FAILED", err.message);
-      }
+      reportApiError(output, err, "DEPLOYMENTS_GET_FAILED");
     }
   });
 }
@@ -17848,6 +17799,7 @@ var init_deployments2 = __esm(() => {
   init_api_client();
   init_config_store();
   init_project_id();
+  init_handle_api_error();
 });
 
 // src/commands/diagnose.ts
@@ -17957,11 +17909,7 @@ Analyzing execution ${targetExecutionId}...`);
         output.info(formatDiagnosisHuman(diagnosis));
       }
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("DIAGNOSE_FAILED", err.message);
-      }
+      reportApiError(output, err, "DIAGNOSE_FAILED");
     }
   });
 }
@@ -17970,6 +17918,7 @@ var init_diagnose = __esm(() => {
   init_api_client();
   init_config_store();
   init_project_id();
+  init_handle_api_error();
 });
 
 // src/commands/create.ts
@@ -17982,7 +17931,7 @@ import {
   existsSync as existsSync11,
   mkdirSync as mkdirSync6,
   writeFileSync as writeFileSync9,
-  readFileSync as readFileSync9,
+  readFileSync as readFileSync10,
   readdirSync as readdirSync4
 } from "node:fs";
 import { join as join12, resolve as resolve5, dirname as dirname2 } from "node:path";
@@ -18055,11 +18004,7 @@ function registerCreateCommand(program2) {
     try {
       generateResult = await client.post(`/api/v1/projects/${projectId}/ai/generate`, { description });
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("GENERATE_FAILED", err.message);
-      }
+      reportApiError(output, err, "GENERATE_FAILED");
       return;
     }
     output.info(`Generated ${generateResult.files.length} file(s): ${generateResult.files.map((f) => f.path).join(", ")}`);
@@ -18113,7 +18058,7 @@ function registerAddCommand(program2) {
     const existingRoutes = getExistingRoutes(projectDir);
     let projectConfig = {};
     try {
-      projectConfig = JSON.parse(readFileSync9(duraJsonPath, "utf-8"));
+      projectConfig = JSON.parse(readFileSync10(duraJsonPath, "utf-8"));
     } catch {}
     const apiUrl = getApiUrl();
     const client = new ApiClient(apiUrl, token);
@@ -18128,11 +18073,7 @@ function registerAddCommand(program2) {
         }
       });
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("GENERATE_FAILED", err.message);
-      }
+      reportApiError(output, err, "GENERATE_FAILED");
       return;
     }
     output.info(`Generated ${generateResult.files.length} file(s): ${generateResult.files.map((f) => f.path).join(", ")}`);
@@ -18163,6 +18104,7 @@ var init_create = __esm(() => {
   init_src3();
   init_api_client();
   init_config_store();
+  init_handle_api_error();
 });
 
 // src/commands/workflow.ts
@@ -18207,11 +18149,7 @@ function registerWorkflowsCommand(program2) {
         d.createdAt
       ]));
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("WORKFLOWS_LIST_FAILED", err.message);
-      }
+      reportApiError(output, err, "WORKFLOWS_LIST_FAILED");
     }
   });
 }
@@ -18240,11 +18178,7 @@ function registerWorkflowCommand(program2) {
       }
       output.info(`Workflow run started: ${result.runId}`);
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("WORKFLOW_RUN_FAILED", err.message);
-      }
+      reportApiError(output, err, "WORKFLOW_RUN_FAILED");
     }
   });
   workflow.command("runs <name>").description("List workflow runs").requiredOption("--project <id>", "Project ID").option("--status <status>", "Filter by status (pending/running/completed/failed)").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (name, opts, cmd) => {
@@ -18268,11 +18202,7 @@ function registerWorkflowCommand(program2) {
       }
       output.table(["ID", "Status", "Trigger", "Created"], runs.map((r) => [r.id, r.status, r.triggerType, r.createdAt]));
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("WORKFLOW_RUNS_FAILED", err.message);
-      }
+      reportApiError(output, err, "WORKFLOW_RUNS_FAILED");
     }
   });
   workflow.command("cancel <run-id>").description("Cancel a running workflow").requiredOption("--project <id>", "Project ID").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").option("--confirm", "Confirm the destructive cancel operation").action(async (runId, opts, cmd) => {
@@ -18289,11 +18219,7 @@ function registerWorkflowCommand(program2) {
       await client.post(`/api/v1/projects/${opts.project}/workflow-runs/${encodeURIComponent(runId)}/cancel`, {});
       output.info(`Workflow run ${runId} cancelled.`);
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("WORKFLOW_CANCEL_FAILED", err.message);
-      }
+      reportApiError(output, err, "WORKFLOW_CANCEL_FAILED");
     }
   });
 }
@@ -18325,11 +18251,7 @@ function registerApprovalsCommand(program2) {
         a.createdAt
       ]));
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("APPROVALS_LIST_FAILED", err.message);
-      }
+      reportApiError(output, err, "APPROVALS_LIST_FAILED");
     }
   });
 }
@@ -18344,11 +18266,7 @@ function registerApproveCommand(program2) {
       await client.post(`/api/v1/projects/${opts.project}/approvals/${encodeURIComponent(approvalId)}/approve`, { decidedBy: opts.decidedBy });
       output.info(`Approval ${approvalId} approved.`);
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("APPROVE_FAILED", err.message);
-      }
+      reportApiError(output, err, "APPROVE_FAILED");
     }
   });
 }
@@ -18363,11 +18281,7 @@ function registerRejectCommand(program2) {
       await client.post(`/api/v1/projects/${opts.project}/approvals/${encodeURIComponent(approvalId)}/reject`, { decidedBy: opts.decidedBy, reason: opts.reason });
       output.info(`Approval ${approvalId} rejected.`);
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("REJECT_FAILED", err.message);
-      }
+      reportApiError(output, err, "REJECT_FAILED");
     }
   });
 }
@@ -18375,6 +18289,7 @@ var init_workflow = __esm(() => {
   init_src3();
   init_api_client();
   init_config_store();
+  init_handle_api_error();
 });
 
 // src/commands/env.ts
@@ -18416,11 +18331,7 @@ function registerEnvCommand(program2) {
       });
       output.success(env2);
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("ENV_CREATE_FAILED", err.message);
-      }
+      reportApiError(output, err, "ENV_CREATE_FAILED");
     }
   });
   env.command("list").description("List all environments for a project").option("--project <id>", "Project ID (defaults to dura.json)").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (opts, cmd) => {
@@ -18433,11 +18344,7 @@ function registerEnvCommand(program2) {
       const envs = await client.get(`/api/v1/projects/${projectId}/environments`);
       output.success(envs);
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("ENV_LIST_FAILED", err.message);
-      }
+      reportApiError(output, err, "ENV_LIST_FAILED");
     }
   });
   env.command("delete <name>").description("Delete an environment").option("--project <id>", "Project ID (defaults to dura.json)").option("--env-id <id>", "Environment ID (alternative to name)").option("--confirm", "Confirm deletion (required for destructive operation)").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (name, opts, cmd) => {
@@ -18464,11 +18371,7 @@ function registerEnvCommand(program2) {
       await client.delete(`/api/v1/projects/${projectId}/environments/${envId}`);
       output.success({ deleted: true, name });
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("ENV_DELETE_FAILED", err.message);
-      }
+      reportApiError(output, err, "ENV_DELETE_FAILED");
     }
   });
   env.command("diff <env1> <env2>").description("Compare two environments").option("--project <id>", "Project ID (defaults to dura.json)").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (env1, env2, opts, cmd) => {
@@ -18496,11 +18399,7 @@ function registerEnvCommand(program2) {
       };
       output.success(diff);
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("ENV_DIFF_FAILED", err.message);
-      }
+      reportApiError(output, err, "ENV_DIFF_FAILED");
     }
   });
 }
@@ -18553,11 +18452,7 @@ function registerPromoteCommand(program2) {
       });
       output.success(promotion);
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("PROMOTE_FAILED", err.message);
-      }
+      reportApiError(output, err, "PROMOTE_FAILED");
     }
   });
 }
@@ -18581,11 +18476,7 @@ function registerCanaryCommand(program2) {
       const canary2 = await client.get(`/api/v1/projects/${projectId}/canary?envId=${opts.env}`);
       output.success(canary2);
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("CANARY_STATUS_FAILED", err.message);
-      }
+      reportApiError(output, err, "CANARY_STATUS_FAILED");
     }
   });
   canary.command("complete").description("Force-complete an active canary (100% traffic to new)").option("--project <id>", "Project ID (defaults to dura.json)").requiredOption("--canary-id <id>", "Canary deployment ID").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (opts, cmd) => {
@@ -18606,11 +18497,7 @@ function registerCanaryCommand(program2) {
       const canary2 = await client.post(`/api/v1/projects/${projectId}/canary/complete`, { canaryId: opts.canaryId });
       output.success(canary2);
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("CANARY_COMPLETE_FAILED", err.message);
-      }
+      reportApiError(output, err, "CANARY_COMPLETE_FAILED");
     }
   });
   canary.command("rollback").description("Force-rollback an active canary (restore old deployment)").option("--project <id>", "Project ID (defaults to dura.json)").requiredOption("--canary-id <id>", "Canary deployment ID").option("--reason <reason>", "Reason for rollback").option("--confirm", "Confirm rollback (required)").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (opts, cmd) => {
@@ -18635,11 +18522,7 @@ function registerCanaryCommand(program2) {
       const canary2 = await client.post(`/api/v1/projects/${projectId}/canary/rollback`, { canaryId: opts.canaryId, reason: opts.reason });
       output.success(canary2);
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("CANARY_ROLLBACK_FAILED", err.message);
-      }
+      reportApiError(output, err, "CANARY_ROLLBACK_FAILED");
     }
   });
 }
@@ -18667,6 +18550,7 @@ var init_env = __esm(() => {
   init_api_client();
   init_config_store();
   init_project_id();
+  init_handle_api_error();
 });
 
 // src/commands/reports.ts
@@ -18983,16 +18867,13 @@ function parseChannelSpec(spec) {
   return null;
 }
 function handleError(err, output, defaultCode) {
-  if (err instanceof ApiClientError) {
-    output.error(err.code, err.message, err.suggestion);
-  } else if (err instanceof Error) {
-    output.error(defaultCode, err.message);
-  }
+  reportApiError(output, err, defaultCode);
 }
 var init_reports = __esm(() => {
   init_src3();
   init_api_client();
   init_config_store();
+  init_handle_api_error();
 });
 
 // src/commands/heal.ts
@@ -19110,11 +18991,7 @@ Healing configuration:
         }
       }
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("HEAL_CONFIG_FAILED", err.message);
-      }
+      reportApiError(output, err, "HEAL_CONFIG_FAILED");
     }
   });
   heal.command("list").description("List healing records").requiredOption("--project <id>", "Project ID").option("--status <status>", "Filter by status (e.g. suggested, deployed)").option("--limit <n>", "Max records to show", parseInt).option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (opts, cmd) => {
@@ -19146,11 +19023,7 @@ ${records.length} healing record(s):
         }
       }
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("HEAL_LIST_FAILED", err.message);
-      }
+      reportApiError(output, err, "HEAL_LIST_FAILED");
     }
   });
   heal.command("show <record-id>").description("Show healing record details").requiredOption("--project <id>", "Project ID").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (recordId, opts, cmd) => {
@@ -19169,11 +19042,7 @@ ${records.length} healing record(s):
 ${formatRecord(record)}`);
       }
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("HEAL_SHOW_FAILED", err.message);
-      }
+      reportApiError(output, err, "HEAL_SHOW_FAILED");
     }
   });
   heal.command("trigger <execution-id>").description("Manually trigger healing for a failed execution").requiredOption("--project <id>", "Project ID").requiredOption("--automation <name>", "Automation name").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (executionId, opts, cmd) => {
@@ -19193,11 +19062,7 @@ Healing triggered. Record: ${record.id}`);
         output.info(`Status: ${record.status}`);
       }
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("HEAL_TRIGGER_FAILED", err.message);
-      }
+      reportApiError(output, err, "HEAL_TRIGGER_FAILED");
     }
   });
   heal.command("approve <record-id>").description("Approve a suggested fix and deploy it").requiredOption("--project <id>", "Project ID").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (recordId, opts, cmd) => {
@@ -19215,11 +19080,7 @@ Healing triggered. Record: ${record.id}`);
         output.info(`Fix ${recordId} approved and queued for deployment.`);
       }
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("HEAL_APPROVE_FAILED", err.message);
-      }
+      reportApiError(output, err, "HEAL_APPROVE_FAILED");
     }
   });
   heal.command("reject <record-id>").description("Reject a suggested fix").requiredOption("--project <id>", "Project ID").option("--reason <reason>", "Reason for rejection").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (recordId, opts, cmd) => {
@@ -19237,11 +19098,7 @@ Healing triggered. Record: ${record.id}`);
         output.info(`Fix ${recordId} rejected.`);
       }
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("HEAL_REJECT_FAILED", err.message);
-      }
+      reportApiError(output, err, "HEAL_REJECT_FAILED");
     }
   });
   heal.command("rollback <record-id>").description("Rollback a deployed fix").requiredOption("--project <id>", "Project ID").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (recordId, opts, cmd) => {
@@ -19259,11 +19116,7 @@ Healing triggered. Record: ${record.id}`);
         output.info(`Fix ${recordId} rolled back.`);
       }
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("HEAL_ROLLBACK_FAILED", err.message);
-      }
+      reportApiError(output, err, "HEAL_ROLLBACK_FAILED");
     }
   });
   heal.command("diff <record-id>").description("Show the generated code patch (diff view)").requiredOption("--project <id>", "Project ID").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (recordId, opts, cmd) => {
@@ -19287,11 +19140,7 @@ Healing triggered. Record: ${record.id}`);
 ${formatDiff(record)}`);
       }
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("HEAL_DIFF_FAILED", err.message);
-      }
+      reportApiError(output, err, "HEAL_DIFF_FAILED");
     }
   });
 }
@@ -19299,10 +19148,11 @@ var init_heal = __esm(() => {
   init_src3();
   init_api_client();
   init_config_store();
+  init_handle_api_error();
 });
 
 // src/lib/skill-installer.ts
-import { existsSync as existsSync12, mkdirSync as mkdirSync7, readFileSync as readFileSync10, writeFileSync as writeFileSync10 } from "node:fs";
+import { existsSync as existsSync12, mkdirSync as mkdirSync7, readFileSync as readFileSync11, writeFileSync as writeFileSync10 } from "node:fs";
 import { join as join13, dirname as dirname3 } from "node:path";
 import { homedir as homedir2 } from "node:os";
 import { fileURLToPath } from "node:url";
@@ -19325,7 +19175,7 @@ function installSkills(targetDir) {
   for (const file of SKILL_FILES) {
     const sourcePath = join13(sourceDir, file);
     const targetPath = join13(targetDir, file);
-    const content = readFileSync10(sourcePath, "utf-8");
+    const content = readFileSync11(sourcePath, "utf-8");
     writeFileSync10(targetPath, content, "utf-8");
     installedFiles.push(targetPath);
   }
@@ -19484,11 +19334,7 @@ function registerProjectsCommand(program2) {
       const project = await client.get(`/api/v1/orgs/${orgId}/projects/${projectId}`);
       output.success(project);
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("PROJECTS_GET_FAILED", err.message);
-      }
+      reportApiError(output, err, "PROJECTS_GET_FAILED");
     }
   });
   projects2.command("list").description("List all projects in the organization").option("--org <id>", "Organization ID").option("--api-url <url>", "API base URL").option("--token <token>", "Auth token").action(async (opts, cmd) => {
@@ -19522,11 +19368,7 @@ function registerProjectsCommand(program2) {
         ]));
       }
     } catch (err) {
-      if (err instanceof ApiClientError) {
-        output.error(err.code, err.message, err.suggestion);
-      } else if (err instanceof Error) {
-        output.error("PROJECTS_LIST_FAILED", err.message);
-      }
+      reportApiError(output, err, "PROJECTS_LIST_FAILED");
     }
   });
 }
@@ -19534,6 +19376,7 @@ var init_projects2 = __esm(() => {
   init_src3();
   init_api_client();
   init_config_store();
+  init_handle_api_error();
 });
 
 // src/index.ts
@@ -19575,6 +19418,7 @@ async function registerAllCommands(program2) {
   const { registerTestCommand: registerTestCommand2 } = await Promise.resolve().then(() => (init_test(), exports_test));
   const { registerDomainsCommand: registerDomainsCommand2 } = await Promise.resolve().then(() => (init_domains(), exports_domains));
   const { registerEndpointKeysCommand: registerEndpointKeysCommand2 } = await Promise.resolve().then(() => (init_endpoint_keys2(), exports_endpoint_keys));
+  const { registerEventsCommand: registerEventsCommand2 } = await Promise.resolve().then(() => (init_events(), exports_events));
   const { registerUsageCommand: registerUsageCommand2 } = await Promise.resolve().then(() => (init_usage(), exports_usage));
   const { registerMarketplaceCommand: registerMarketplaceCommand2 } = await Promise.resolve().then(() => (init_marketplace2(), exports_marketplace));
   const { registerExportCommand: registerExportCommand2 } = await Promise.resolve().then(() => (init_export(), exports_export));
@@ -19619,6 +19463,7 @@ async function registerAllCommands(program2) {
   registerTestCommand2(program2);
   registerRunCommand2(program2);
   registerScheduleCommand2(program2);
+  registerEventsCommand2(program2);
   registerStatusCommand2(program2);
   registerLogsCommand2(program2);
   registerUsageCommand2(program2);
@@ -19640,7 +19485,7 @@ async function registerAllCommands(program2) {
   registerOpenApiCommand2(program2);
   return program2;
 }
-var CLI_VERSION = "0.3.0";
+var CLI_VERSION = "0.3.1";
 var init_src3 = __esm(() => {
   init_esm();
   if (import.meta.url === `file://${realpathSync(process.argv[1] ?? "").replace(/\\/g, "/")}`) {
@@ -19657,4 +19502,4 @@ export {
   CLI_VERSION
 };
 
-//# debugId=4BAA174E1BA4BE2C64756E2164756E21
+//# debugId=A22178BD000AEBBE64756E2164756E21