fix(cli): fail commands returning projected analysis errors (#506)

Signed-off-by: Rudy Celekli <47457359+rudycelekli@users.noreply.github.com>

src/cliLogging.test.ts

@@ -1,9 +1,15 @@
 import { describe, expect, it } from "vitest";
 
+import { ConfigurationError, projectAnalysisError } from "./domain/errors.js";
+
 import { isCliOperationFailure } from "./cliLogging.js";
 
 describe("CLI operation status classification", () => {
   it.each([
+    [
+      "projected error",
+      projectAnalysisError(new ConfigurationError("invalid setting")),
+    ],
     ["typed error", { error: "Analysis failed", category: "timeout" }],
     ["unhealthy diagnostic", { healthy: false, checks: [] }],
     ["failed status", { status: "failed" }],
@@ -15,6 +21,16 @@ describe("CLI operation status classification", () => {
   });
 
   it.each([
+    [
+      "ordinary data with code",
+      { code: "configuration_invalid", message: "source data" },
+    ],
+    [
+      "evidence about an error",
+      {
+        result: projectAnalysisError(new ConfigurationError("source setting")),
+      },
+    ],
     ["ready setup", { status: "ready" }],
     ["complete uninstall", { status: "complete" }],
     ["current version", { status: "current" }],

src/cliLogging.ts

@@ -1,3 +1,4 @@
+import { analysisErrorProjectionSchema } from "./contracts/errorSchemas.js";
 import type { Logger } from "./logger.js";
 
 const isRecord = (value: unknown): value is Readonly<Record<string, unknown>> =>
@@ -7,6 +8,7 @@ const isRecord = (value: unknown): value is Readonly<Record<string, unknown>> =>
 export const isCliOperationFailure = (value: unknown): boolean => {
   if (!isRecord(value)) return false;
   if (typeof value.error === "string") return true;
+  if (analysisErrorProjectionSchema.safeParse(value).success) return true;
   if (value.healthy === false) return true;
   return (
     value.status === "failed" ||