@agentxm/client-core 0.5.0 → 0.5.2

package/dist/src/unstable/cli-runtime/graceful-shutdown.js

@@ -4,7 +4,7 @@ import * as Fiber from "effect/Fiber";
  * Wrap a program in signal-aware graceful shutdown.
  *
  * SIGTERM/SIGINT → interrupt the running fiber with a 5s timeout.
- * Exit code 130 = POSIX convention for "terminated by signal" (128 + 2).
+ * Exit code follows POSIX convention (128 + signum): SIGINT=130, SIGTERM=143.
  * Uses Effect.forkChild (supervised) so the fiber dies with parent.
  */
 export const withGracefulShutdown = (program) => Effect.gen(function* () {
@@ -12,9 +12,11 @@ export const withGracefulShutdown = (program) => Effect.gen(function* () {
     const fiber = yield* Effect.forkChild(program);
     const runFork = Effect.runForkWith(services);
     const interruptAndExit = (exitCode) => {
-        runFork(Fiber.interrupt(fiber).pipe(Effect.timeout("5 seconds"), Effect.ensuring(Effect.sync(() => process.exit(exitCode)))));
+        runFork(Fiber.interrupt(fiber).pipe(Effect.timeout("5 seconds"), Effect.ensuring(Effect.sync(() => {
+            void process.exit(exitCode);
+        }))));
     };
-    const onSigterm = () => interruptAndExit(130);
+    const onSigterm = () => interruptAndExit(143);
     const onSigint = () => interruptAndExit(130);
     process.on("SIGTERM", onSigterm);
     process.on("SIGINT", onSigint);

package/dist/src/unstable/cli-runtime/graceful-shutdown.js.map

@@ -1 +1 @@
-{"version":3,"file":"graceful-shutdown.js","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/graceful-shutdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,OAA+B,EACP,EAAE,CAC1B,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,EAAK,CAAC;IAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAE7C,MAAM,gBAAgB,GAAG,CAAC,QAAgB,EAAE,EAAE;QAC5C,OAAO,CACL,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,CACzB,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAC3B,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAC3D,CACF,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC7C,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAE/B,OAAO,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAClC,MAAM,CAAC,QAAQ,CACb,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QACf,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAClC,CAAC,CAAC,CACH,CACF,CAAC;AACJ,CAAC,CAAC,CAAC"}
+{"version":3,"file":"graceful-shutdown.js","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/graceful-shutdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,OAA+B,EACP,EAAE,CAC1B,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,EAAK,CAAC;IAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAE7C,MAAM,gBAAgB,GAAG,CAAC,QAAgB,EAAE,EAAE;QAC5C,OAAO,CACL,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,CACzB,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAC3B,MAAM,CAAC,QAAQ,CACb,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;YACf,KAAK,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9B,CAAC,CAAC,CACH,CACF,CACF,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC7C,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAE/B,OAAO,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAClC,MAAM,CAAC,QAAQ,CACb,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QACf,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAClC,CAAC,CAAC,CACH,CACF,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/src/unstable/cli-runtime/handle-error.d.ts

@@ -1,27 +1,28 @@
 import type { OutputFormat } from "./output-mode.js";
+import type { ErrorEvent } from "./output-mode.js";
 /**
  * Classified error result — pure data describing what handleError should do.
  */
 export interface ErrorClassification {
     readonly exitCode: number;
+    readonly errorEvent?: ErrorEvent;
     readonly output?: {
         readonly channel: "stdout" | "stderr";
         readonly content: string;
     };
-    readonly stderrMessage?: string;
 }
 /**
  * Pure error classification — determines exit code and output without side effects.
  *
  * Channel routing per format:
  * - text:        human-readable to stderr only (no stdout pollution)
- * - json:        typed error JSON to stdout + brief message to stderr
+ * - json:        typed error JSON to stdout + NDJSON error event to stderr
  * Exit codes:
  * - ShowHelp (no errors) → 0 (help successfully displayed)
- * - ShowHelp (with errors) → 1 (help displayed due to usage error)
+ * - ShowHelp (with errors) → 2 (usage — help shown due to invocation error)
  * - EffectCliExit → custom exit code
  * - CliError → 2 (usage/validation — bad flags, missing args)
- * - Other → 1 (application/runtime)
+ * - Other → 10 (unexpected internal error)
  */
 export declare const classifyError: (error: unknown, format: OutputFormat) => ErrorClassification;
 /**

package/dist/src/unstable/cli-runtime/handle-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handle-error.d.ts","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/handle-error.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAQrD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE;QAChB,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,QAAQ,CAAC;QACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,EAAE,QAAQ,YAAY,KAAG,mBA+DpE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,EAAE,QAAQ,YAAY,KAAG,KAelE,CAAC"}
+{"version":3,"file":"handle-error.d.ts","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/handle-error.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAMnD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE;QAChB,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,QAAQ,CAAC;QACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,EAAE,QAAQ,YAAY,KAAG,mBA8FpE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,EAAE,QAAQ,YAAY,KAAG,KAelE,CAAC"}

package/dist/src/unstable/cli-runtime/handle-error.js

@@ -1,6 +1,7 @@
 import { CliError } from "effect/unstable/cli";
+import { AppError, ExitCode, exitCodeFor, renderAppError } from "../app-error/index.js";
 import { isEffectCliExit } from "./effect-cli-exit.js";
-import { makeJsonErrorEnvelope } from "./json-envelope.js";
+import { makeJsonErrorEnvelope, makeJsonErrorEnvelopeFromAppError } from "./json-envelope.js";
 const writeStderr = (message) => {
     process.stderr.write(message.endsWith("\n") ? message : `${message}\n`);
 };
@@ -9,59 +10,87 @@ const writeStderr = (message) => {
  *
  * Channel routing per format:
  * - text:        human-readable to stderr only (no stdout pollution)
- * - json:        typed error JSON to stdout + brief message to stderr
+ * - json:        typed error JSON to stdout + NDJSON error event to stderr
  * Exit codes:
  * - ShowHelp (no errors) → 0 (help successfully displayed)
- * - ShowHelp (with errors) → 1 (help displayed due to usage error)
+ * - ShowHelp (with errors) → 2 (usage — help shown due to invocation error)
  * - EffectCliExit → custom exit code
  * - CliError → 2 (usage/validation — bad flags, missing args)
- * - Other → 1 (application/runtime)
+ * - Other → 10 (unexpected internal error)
  */
 export const classifyError = (error, format) => {
     if (isEffectCliExit(error)) {
         return { exitCode: error.exitCode };
     }
+    if (error instanceof AppError) {
+        const exitCode = exitCodeFor(error.code);
+        if (format === "text") {
+            return {
+                exitCode,
+                output: { channel: "stderr", content: renderAppError(error) },
+            };
+        }
+        return {
+            exitCode,
+            errorEvent: {
+                type: "error",
+                code: error.code,
+                message: error.message,
+            },
+            output: {
+                channel: "stdout",
+                content: JSON.stringify(makeJsonErrorEnvelopeFromAppError(error), null, 2) + "\n",
+            },
+        };
+    }
     if (CliError.isCliError(error)) {
         if (error._tag === "ShowHelp") {
-            return { exitCode: error.errors.length > 0 ? 1 : 0 };
+            return { exitCode: error.errors.length > 0 ? ExitCode.Usage : ExitCode.Success };
         }
         if (format !== "text") {
             const message = "errors" in error && Array.isArray(error.errors) && error.errors.length > 0
                 ? error.errors.map((e) => e.message ?? String(e)).join("; ")
                 : error.message;
             return {
-                exitCode: 2,
+                exitCode: ExitCode.Usage,
+                errorEvent: {
+                    type: "error",
+                    code: "usage",
+                    message,
+                },
                 output: {
                     channel: "stdout",
                     content: JSON.stringify(makeJsonErrorEnvelope({
-                        code: "USAGE_ERROR",
+                        code: "usage",
                         message,
-                        exitCode: 2,
                     }), null, 2) + "\n",
                 },
             };
         }
-        return { exitCode: 2 };
+        return { exitCode: ExitCode.Usage };
     }
     const message = error instanceof Error ? error.message : String(error);
-    const code = error instanceof Error && "code" in error ? String(error.code) : "UNKNOWN_ERROR";
+    const code = "internal";
     if (format === "text") {
         return {
-            exitCode: 1,
+            exitCode: ExitCode.Internal,
             output: { channel: "stderr", content: `\u2717 ${message}` },
         };
     }
     return {
-        exitCode: 1,
+        exitCode: ExitCode.Internal,
+        errorEvent: {
+            type: "error",
+            code,
+            message,
+        },
         output: {
             channel: "stdout",
             content: JSON.stringify(makeJsonErrorEnvelope({
                 code,
                 message,
-                exitCode: 1,
             }), null, 2) + "\n",
         },
-        stderrMessage: `\u2717 ${message}`,
     };
 };
 /**
@@ -73,10 +102,10 @@ export const handleError = (error, format) => {
     const result = classifyError(error, format);
     if (result.output) {
         if (result.output.channel === "stdout") {
-            process.stdout.write(result.output.content);
-            if (result.stderrMessage) {
-                writeStderr(result.stderrMessage);
+            if (format !== "text" && result.errorEvent !== undefined) {
+                writeStderr(JSON.stringify(result.errorEvent));
             }
+            process.stdout.write(result.output.content);
         }
         else {
             writeStderr(result.output.content);

package/dist/src/unstable/cli-runtime/handle-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"handle-error.js","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/handle-error.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"handle-error.js","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/handle-error.ts"],"names":[],"mappings":"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"}

package/dist/src/unstable/cli-runtime/index.d.ts

@@ -1,7 +1,7 @@
-export type { OutputFormat, ProgressEvent, LogEvent, ErrorEvent, StreamEvent, } from "./output-mode.js";
-export { ProgressEventSchema, LogEventSchema, ErrorEventSchema, emitEvent } from "./output-mode.js";
-export { JsonSchemaVersion, JsonSchemaVersionSchema, JsonErrorEnvelopeSchema, makeJsonErrorEnvelope, makeJsonErrorEnvelopeFromAppError, type JsonErrorEnvelope, } from "./json-envelope.js";
-export { makeCommandDocument, makeCommandDocumentSchema, type CommandDocument, } from "./command-document.js";
+export type { OutputFormat, ProgressEvent, LogEvent, ErrorEvent, BreadcrumbEvent, StreamEvent, } from "./output-mode.js";
+export { ProgressEventSchema, LogEventSchema, ErrorEventSchema, BreadcrumbEventSchema, emitEvent, } from "./output-mode.js";
+export { BreadcrumbSchema, type Breadcrumb } from "./breadcrumb.js";
+export { JsonEnvelopeSchema, JsonSuccessEnvelopeSchema, JsonErrorEnvelopeSchema, makeJsonSuccessEnvelope, makeJsonErrorEnvelope, makeJsonErrorEnvelopeFromAppError, type JsonEnvelope, type JsonSuccessEnvelope, type JsonErrorEnvelope, } from "./json-envelope.js";
 export { EffectCliExit, effectCliExit, isEffectCliExit } from "./effect-cli-exit.js";
 export { resolveFormatFromArgv, resolveFormat } from "./resolve-format.js";
 export { handleError, classifyError, type ErrorClassification } from "./handle-error.js";

package/dist/src/unstable/cli-runtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,UAAU,EACV,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpG,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,qBAAqB,EACrB,iCAAiC,EACjC,KAAK,iBAAiB,GACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,KAAK,eAAe,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACrF,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACzF,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,KAAK,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAC7F,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,cAAc,EACd,KAAK,gBAAgB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,eAAe,EACf,cAAc,EACd,4BAA4B,EAC5B,4BAA4B,EAC5B,yBAAyB,EACzB,6BAA6B,EAC7B,KAAK,gCAAgC,EACrC,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,GAChC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,WAAW,EACX,KAAK,kBAAkB,EACvB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,uBAAuB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,UAAU,GAChB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,UAAU,EACV,eAAe,EACf,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,SAAS,GACV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,uBAAuB,EACvB,uBAAuB,EACvB,qBAAqB,EACrB,iCAAiC,EACjC,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACrF,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACzF,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,KAAK,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAC7F,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,cAAc,EACd,KAAK,gBAAgB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,eAAe,EACf,cAAc,EACd,4BAA4B,EAC5B,4BAA4B,EAC5B,yBAAyB,EACzB,6BAA6B,EAC7B,KAAK,gCAAgC,EACrC,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,GAChC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,WAAW,EACX,KAAK,kBAAkB,EACvB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,uBAAuB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,UAAU,GAChB,MAAM,sBAAsB,CAAC"}

package/dist/src/unstable/cli-runtime/index.js

@@ -1,6 +1,6 @@
-export { ProgressEventSchema, LogEventSchema, ErrorEventSchema, emitEvent } from "./output-mode.js";
-export { JsonSchemaVersion, JsonSchemaVersionSchema, JsonErrorEnvelopeSchema, makeJsonErrorEnvelope, makeJsonErrorEnvelopeFromAppError, } from "./json-envelope.js";
-export { makeCommandDocument, makeCommandDocumentSchema, } from "./command-document.js";
+export { ProgressEventSchema, LogEventSchema, ErrorEventSchema, BreadcrumbEventSchema, emitEvent, } from "./output-mode.js";
+export { BreadcrumbSchema } from "./breadcrumb.js";
+export { JsonEnvelopeSchema, JsonSuccessEnvelopeSchema, JsonErrorEnvelopeSchema, makeJsonSuccessEnvelope, makeJsonErrorEnvelope, makeJsonErrorEnvelopeFromAppError, } from "./json-envelope.js";
 export { EffectCliExit, effectCliExit, isEffectCliExit } from "./effect-cli-exit.js";
 export { resolveFormatFromArgv, resolveFormat } from "./resolve-format.js";
 export { handleError, classifyError } from "./handle-error.js";

package/dist/src/unstable/cli-runtime/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpG,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,qBAAqB,EACrB,iCAAiC,GAElC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,mBAAmB,EACnB,yBAAyB,GAE1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACrF,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,aAAa,EAA4B,MAAM,mBAAmB,CAAC;AACzF,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAuB,MAAM,mBAAmB,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAkC,MAAM,sBAAsB,CAAC;AAC7F,OAAO,EAGL,cAAc,EAEd,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,eAAe,EACf,cAAc,EACd,4BAA4B,EAC5B,4BAA4B,EAC5B,yBAAyB,EACzB,6BAA6B,GAI9B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,WAAW,EAEX,gBAAgB,EAChB,aAAa,EACb,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,uBAAuB,GAKxB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/index.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,SAAS,GACV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAmB,MAAM,iBAAiB,CAAC;AACpE,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,uBAAuB,EACvB,uBAAuB,EACvB,qBAAqB,EACrB,iCAAiC,GAIlC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACrF,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,aAAa,EAA4B,MAAM,mBAAmB,CAAC;AACzF,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAuB,MAAM,mBAAmB,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAkC,MAAM,sBAAsB,CAAC;AAC7F,OAAO,EAGL,cAAc,EAEd,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,eAAe,EACf,cAAc,EACd,4BAA4B,EAC5B,4BAA4B,EAC5B,yBAAyB,EACzB,6BAA6B,GAI9B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,WAAW,EAEX,gBAAgB,EAChB,aAAa,EACb,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,uBAAuB,GAKxB,MAAM,sBAAsB,CAAC"}

package/dist/src/unstable/cli-runtime/json-envelope.d.ts

@@ -1,23 +1,59 @@
 import * as Schema from "effect/Schema";
-import type { AppError } from "../app-error/index.js";
-export declare const JsonSchemaVersion = 1;
-export declare const JsonSchemaVersionSchema: Schema.Literal<1>;
+import { type AppError, type AppErrorCode } from "../app-error/index.js";
+import { type Breadcrumb } from "./breadcrumb.js";
 export declare const JsonErrorEnvelopeSchema: Schema.Struct<{
-    readonly _version: Schema.Literal<1>;
-    readonly type: Schema.Literal<"error">;
-    readonly code: Schema.String;
+    readonly ok: Schema.Literal<false>;
+    readonly code: Schema.Literals<readonly ["issues", "usage", "not_found", "auth", "forbidden", "conflict", "rate_limit", "network", "validation", "internal"]>;
     readonly message: Schema.String;
-    readonly details: Schema.optional<Schema.$Array<Schema.String>>;
-    readonly howToFix: Schema.optional<Schema.String>;
-    readonly exitCode: Schema.Number;
+    readonly breadcrumbs: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly task: Schema.String;
+        readonly description: Schema.String;
+        readonly command: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly cmd: Schema.optional<Schema.String>;
+    }>>>;
 }>;
 export type JsonErrorEnvelope = typeof JsonErrorEnvelopeSchema.Type;
+export declare const JsonSuccessEnvelopeSchema: Schema.StructWithRest<Schema.Struct<{
+    readonly ok: Schema.Literal<true>;
+    readonly summary: Schema.optional<Schema.String>;
+    readonly breadcrumbs: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly task: Schema.String;
+        readonly description: Schema.String;
+        readonly command: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly cmd: Schema.optional<Schema.String>;
+    }>>>;
+}>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>;
+export type JsonSuccessEnvelope = typeof JsonSuccessEnvelopeSchema.Type;
+export declare const JsonEnvelopeSchema: Schema.Union<readonly [Schema.StructWithRest<Schema.Struct<{
+    readonly ok: Schema.Literal<true>;
+    readonly summary: Schema.optional<Schema.String>;
+    readonly breadcrumbs: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly task: Schema.String;
+        readonly description: Schema.String;
+        readonly command: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly cmd: Schema.optional<Schema.String>;
+    }>>>;
+}>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>, Schema.Struct<{
+    readonly ok: Schema.Literal<false>;
+    readonly code: Schema.Literals<readonly ["issues", "usage", "not_found", "auth", "forbidden", "conflict", "rate_limit", "network", "validation", "internal"]>;
+    readonly message: Schema.String;
+    readonly breadcrumbs: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly task: Schema.String;
+        readonly description: Schema.String;
+        readonly command: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly cmd: Schema.optional<Schema.String>;
+    }>>>;
+}>]>;
+export type JsonEnvelope = typeof JsonEnvelopeSchema.Type;
+export declare const makeJsonSuccessEnvelope: (args?: {
+    readonly payload?: unknown;
+    readonly summary?: string;
+    readonly breadcrumbs?: ReadonlyArray<Breadcrumb>;
+}) => JsonSuccessEnvelope;
 export declare const makeJsonErrorEnvelope: (args: {
-    readonly code: string;
+    readonly code: AppErrorCode;
     readonly message: string;
-    readonly details?: ReadonlyArray<string>;
-    readonly howToFix?: string;
-    readonly exitCode: number;
+    readonly breadcrumbs?: ReadonlyArray<Breadcrumb>;
 }) => JsonErrorEnvelope;
-export declare const makeJsonErrorEnvelopeFromAppError: (error: AppError, exitCode: number) => JsonErrorEnvelope;
+export declare const makeJsonErrorEnvelopeFromAppError: (error: AppError) => JsonErrorEnvelope;
 //# sourceMappingURL=json-envelope.d.ts.map

package/dist/src/unstable/cli-runtime/json-envelope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json-envelope.d.ts","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/json-envelope.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC,eAAO,MAAM,uBAAuB,mBAAoC,CAAC;AAEzE,eAAO,MAAM,uBAAuB;;;;;;;;EAYlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,uBAAuB,CAAC,IAAI,CAAC;AAEpE,eAAO,MAAM,qBAAqB,GAAI,MAAM;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,KAAG,iBAQF,CAAC;AAEH,eAAO,MAAM,iCAAiC,GAC5C,OAAO,QAAQ,EACf,UAAU,MAAM,KACf,iBAOC,CAAC"}
+{"version":3,"file":"json-envelope.d.ts","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/json-envelope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAsB,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC7F,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAIpE,eAAO,MAAM,uBAAuB;;;;;;;;;;EASlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,uBAAuB,CAAC,IAAI,CAAC;AAEpE,eAAO,MAAM,yBAAyB;;;;;;;;;6DAWpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,yBAAyB,CAAC,IAAI,CAAC;AAExE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;IAO7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAC;AAoB1D,eAAO,MAAM,uBAAuB,GAAI,OAAO;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;CAClD,KAAG,mBAWF,CAAC;AAEH,eAAO,MAAM,qBAAqB,GAAI,MAAM;IAC1C,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;CAClD,KAAG,iBAOF,CAAC;AAEH,eAAO,MAAM,iCAAiC,GAAI,OAAO,QAAQ,KAAG,iBAKhE,CAAC"}

package/dist/src/unstable/cli-runtime/json-envelope.js

@@ -1,34 +1,73 @@
-import * as Option from "effect/Option";
 import * as Schema from "effect/Schema";
-export const JsonSchemaVersion = 1;
-export const JsonSchemaVersionSchema = Schema.Literal(JsonSchemaVersion);
+import { AppErrorCodeSchema } from "../app-error/index.js";
+import { BreadcrumbSchema } from "./breadcrumb.js";
+const ReservedSuccessEnvelopeKeys = new Set(["ok", "summary", "breadcrumbs"]);
 export const JsonErrorEnvelopeSchema = Schema.Struct({
-    _version: JsonSchemaVersionSchema,
-    type: Schema.Literal("error"),
-    code: Schema.String,
+    ok: Schema.Literal(false),
+    code: AppErrorCodeSchema,
     message: Schema.String,
-    details: Schema.optional(Schema.Array(Schema.String)),
-    howToFix: Schema.optional(Schema.String),
-    exitCode: Schema.Number,
+    breadcrumbs: Schema.optional(Schema.Array(BreadcrumbSchema)),
 }).annotate({
     identifier: "JsonErrorEnvelope",
     title: "JSON Error Envelope",
     description: "Structured JSON error envelope for machine-readable CLI error output.",
 });
+export const JsonSuccessEnvelopeSchema = Schema.StructWithRest(Schema.Struct({
+    ok: Schema.Literal(true),
+    summary: Schema.optional(Schema.String),
+    breadcrumbs: Schema.optional(Schema.Array(BreadcrumbSchema)),
+}), [Schema.Record(Schema.String, Schema.Unknown)]).annotate({
+    identifier: "JsonSuccessEnvelope",
+    title: "JSON Success Envelope",
+    description: "Structured JSON success envelope for machine-readable CLI output.",
+});
+export const JsonEnvelopeSchema = Schema.Union([
+    JsonSuccessEnvelopeSchema,
+    JsonErrorEnvelopeSchema,
+]).annotate({
+    identifier: "JsonEnvelope",
+    title: "JSON Envelope",
+    description: "Structured JSON success or error envelope for machine-readable CLI output.",
+});
+const ensurePayloadObject = (payload) => {
+    if (payload === undefined) {
+        return {};
+    }
+    if (typeof payload !== "object" || payload === null || Array.isArray(payload)) {
+        return { value: payload };
+    }
+    return Object.fromEntries(Object.entries(payload));
+};
+const ensureNoReservedPayloadKeys = (payload) => {
+    for (const key of Object.keys(payload)) {
+        if (ReservedSuccessEnvelopeKeys.has(key)) {
+            throw new Error(`JSON success payload cannot include reserved key: ${key}`);
+        }
+    }
+};
+export const makeJsonSuccessEnvelope = (args) => ({
+    ok: true,
+    ...(() => {
+        const payload = ensurePayloadObject(args?.payload);
+        ensureNoReservedPayloadKeys(payload);
+        return payload;
+    })(),
+    ...(args?.summary !== undefined ? { summary: args.summary } : {}),
+    ...(args?.breadcrumbs !== undefined && args.breadcrumbs.length > 0
+        ? { breadcrumbs: [...args.breadcrumbs] }
+        : {}),
+});
 export const makeJsonErrorEnvelope = (args) => ({
-    _version: JsonSchemaVersion,
-    type: "error",
+    ok: false,
     code: args.code,
     message: args.message,
-    ...(args.details !== undefined && args.details.length > 0 ? { details: [...args.details] } : {}),
-    ...(args.howToFix !== undefined ? { howToFix: args.howToFix } : {}),
-    exitCode: args.exitCode,
+    ...(args.breadcrumbs !== undefined && args.breadcrumbs.length > 0
+        ? { breadcrumbs: [...args.breadcrumbs] }
+        : {}),
 });
-export const makeJsonErrorEnvelopeFromAppError = (error, exitCode) => makeJsonErrorEnvelope({
+export const makeJsonErrorEnvelopeFromAppError = (error) => makeJsonErrorEnvelope({
     code: error.code,
-    message: error.what,
-    details: error.details,
-    ...(Option.isSome(error.howToFix) ? { howToFix: error.howToFix.value } : {}),
-    exitCode,
+    message: error.message,
+    breadcrumbs: error.breadcrumbs ?? [],
 });
 //# sourceMappingURL=json-envelope.js.map

package/dist/src/unstable/cli-runtime/json-envelope.js.map

@@ -1 +1 @@
-{"version":3,"file":"json-envelope.js","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/json-envelope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAEnC,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEzE,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,CAAC;IACnD,QAAQ,EAAE,uBAAuB;IACjC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrD,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC,MAAM;CACxB,CAAC,CAAC,QAAQ,CAAC;IACV,UAAU,EAAE,mBAAmB;IAC/B,KAAK,EAAE,qBAAqB;IAC5B,WAAW,EAAE,uEAAuE;CACrF,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,IAMrC,EAAqB,EAAE,CAAC,CAAC;IACxB,QAAQ,EAAE,iBAAiB;IAC3B,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,IAAI,CAAC,IAAI;IACf,OAAO,EAAE,IAAI,CAAC,OAAO;IACrB,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAChG,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,QAAQ,EAAE,IAAI,CAAC,QAAQ;CACxB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAC/C,KAAe,EACf,QAAgB,EACG,EAAE,CACrB,qBAAqB,CAAC;IACpB,IAAI,EAAE,KAAK,CAAC,IAAI;IAChB,OAAO,EAAE,KAAK,CAAC,IAAI;IACnB,OAAO,EAAE,KAAK,CAAC,OAAO;IACtB,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5E,QAAQ;CACT,CAAC,CAAC"}
+{"version":3,"file":"json-envelope.js","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/json-envelope.ts"],"names":[],"mappings":"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"}

package/dist/src/unstable/cli-runtime/output-mode.d.ts

@@ -1,8 +1,6 @@
 import * as Schema from "effect/Schema";
-import { JsonSchemaVersion } from "./json-envelope.js";
 export type OutputFormat = "text" | "json";
 export declare const ProgressEventSchema: Schema.Struct<{
-    readonly _version: Schema.Literal<1>;
     readonly type: Schema.Literal<"progress">;
     readonly phase: Schema.String;
     readonly percent: Schema.Number;
@@ -10,23 +8,25 @@ export declare const ProgressEventSchema: Schema.Struct<{
 }>;
 export type ProgressEvent = typeof ProgressEventSchema.Type;
 export declare const LogEventSchema: Schema.Struct<{
-    readonly _version: Schema.Literal<1>;
     readonly type: Schema.Literal<"log">;
     readonly level: Schema.Literals<readonly ["info", "warn", "error"]>;
     readonly message: Schema.String;
 }>;
 export type LogEvent = typeof LogEventSchema.Type;
 export declare const ErrorEventSchema: Schema.Struct<{
-    readonly _version: Schema.Literal<1>;
     readonly type: Schema.Literal<"error">;
     readonly code: Schema.String;
     readonly message: Schema.String;
-    readonly details: Schema.optional<Schema.$Array<Schema.String>>;
-    readonly howToFix: Schema.optional<Schema.String>;
-    readonly exitCode: Schema.optional<Schema.Number>;
 }>;
 export type ErrorEvent = typeof ErrorEventSchema.Type;
-export type StreamEvent = ProgressEvent | LogEvent | ErrorEvent;
+export declare const BreadcrumbEventSchema: Schema.Struct<{
+    readonly type: Schema.Literal<"breadcrumb">;
+    readonly task: Schema.String;
+    readonly description: Schema.String;
+    readonly command: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly cmd: Schema.optional<Schema.String>;
+}>;
+export type BreadcrumbEvent = typeof BreadcrumbEventSchema.Type;
+export type StreamEvent = ProgressEvent | LogEvent | ErrorEvent | BreadcrumbEvent;
 export declare const emitEvent: (event: StreamEvent) => import("effect/Effect").Effect<void, never, never>;
-export { JsonSchemaVersion };
 //# sourceMappingURL=output-mode.d.ts.map

package/dist/src/unstable/cli-runtime/output-mode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output-mode.d.ts","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/output-mode.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,iBAAiB,EAA2B,MAAM,oBAAoB,CAAC;AAMhF,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAe3C,eAAO,MAAM,mBAAmB;;;;;;EAU9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,mBAAmB,CAAC,IAAI,CAAC;AAE5D,eAAO,MAAM,cAAc;;;;;EAazB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,cAAc,CAAC,IAAI,CAAC;AAElD,eAAO,MAAM,gBAAgB;;;;;;;;EAY3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAC;AAEtD,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,UAAU,CAAC;AAMhE,eAAO,MAAM,SAAS,GAAI,OAAO,WAAW,uDAAyC,CAAC;AAEtF,OAAO,EAAE,iBAAiB,EAAE,CAAC"}
+{"version":3,"file":"output-mode.d.ts","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/output-mode.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAMxC,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAe3C,eAAO,MAAM,mBAAmB;;;;;EAS9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,mBAAmB,CAAC,IAAI,CAAC;AAE5D,eAAO,MAAM,cAAc;;;;EAYzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,cAAc,CAAC,IAAI,CAAC;AAElD,eAAO,MAAM,gBAAgB;;;;EAQ3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAC;AAEtD,eAAO,MAAM,qBAAqB;;;;;;EAUhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,qBAAqB,CAAC,IAAI,CAAC;AAEhE,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,UAAU,GAAG,eAAe,CAAC;AAMlF,eAAO,MAAM,SAAS,GAAI,OAAO,WAAW,uDAAyC,CAAC"}

package/dist/src/unstable/cli-runtime/output-mode.js

@@ -1,6 +1,5 @@
 import * as Console from "effect/Console";
 import * as Schema from "effect/Schema";
-import { JsonSchemaVersion, JsonSchemaVersionSchema } from "./json-envelope.js";
 // ---------------------------------------------------------------------------
 // NDJSON event schemas — typed contract for machine-mode stderr events
 //
@@ -14,7 +13,6 @@ import { JsonSchemaVersion, JsonSchemaVersionSchema } from "./json-envelope.js";
 //   result   → final output (emitted last, wraps command-specific data)
 // ---------------------------------------------------------------------------
 export const ProgressEventSchema = Schema.Struct({
-    _version: JsonSchemaVersionSchema,
     type: Schema.Literal("progress"),
     phase: Schema.String,
     percent: Schema.Number,
@@ -25,7 +23,6 @@ export const ProgressEventSchema = Schema.Struct({
     description: "NDJSON progress event for driving progress bars in machine mode.",
 });
 export const LogEventSchema = Schema.Struct({
-    _version: JsonSchemaVersionSchema,
     type: Schema.Literal("log"),
     level: Schema.Literals(["info", "warn", "error"]).annotate({
         identifier: "LogLevel",
@@ -39,21 +36,27 @@ export const LogEventSchema = Schema.Struct({
     description: "NDJSON log event for informational messages at different severity levels.",
 });
 export const ErrorEventSchema = Schema.Struct({
-    _version: JsonSchemaVersionSchema,
     type: Schema.Literal("error"),
     code: Schema.String,
     message: Schema.String,
-    details: Schema.optional(Schema.Array(Schema.String)),
-    howToFix: Schema.optional(Schema.String),
-    exitCode: Schema.optional(Schema.Number),
 }).annotate({
     identifier: "ErrorEvent",
     title: "Error Event",
     description: "NDJSON error event with a stable error code for programmatic handling.",
 });
+export const BreadcrumbEventSchema = Schema.Struct({
+    type: Schema.Literal("breadcrumb"),
+    task: Schema.String,
+    description: Schema.String,
+    command: Schema.optional(Schema.Array(Schema.String)),
+    cmd: Schema.optional(Schema.String),
+}).annotate({
+    identifier: "BreadcrumbEvent",
+    title: "Breadcrumb Event",
+    description: "NDJSON breadcrumb event with a suggested follow-up task.",
+});
 // ---------------------------------------------------------------------------
 // Event emitter — writes a single NDJSON line to stderr
 // ---------------------------------------------------------------------------
 export const emitEvent = (event) => Console.error(JSON.stringify(event));
-export { JsonSchemaVersion };
 //# sourceMappingURL=output-mode.js.map

package/dist/src/unstable/cli-runtime/output-mode.js.map

@@ -1 +1 @@
-{"version":3,"file":"output-mode.js","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/output-mode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAQhF,8EAA8E;AAC9E,uEAAuE;AACvE,EAAE;AACF,+EAA+E;AAC/E,yEAAyE;AACzE,4CAA4C;AAC5C,EAAE;AACF,6DAA6D;AAC7D,mEAAmE;AACnE,sEAAsE;AACtE,wEAAwE;AACxE,8EAA8E;AAE9E,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/C,QAAQ,EAAE,uBAAuB;IACjC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC,MAAM;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM;CACvB,CAAC,CAAC,QAAQ,CAAC;IACV,UAAU,EAAE,eAAe;IAC3B,KAAK,EAAE,gBAAgB;IACvB,WAAW,EAAE,kEAAkE;CAChF,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1C,QAAQ,EAAE,uBAAuB;IACjC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC,CAAC,QAAQ,CAAC;QAClE,UAAU,EAAE,UAAU;QACtB,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,gCAAgC;KAC9C,CAAC;IACF,OAAO,EAAE,MAAM,CAAC,MAAM;CACvB,CAAC,CAAC,QAAQ,CAAC;IACV,UAAU,EAAE,UAAU;IACtB,KAAK,EAAE,WAAW;IAClB,WAAW,EAAE,2EAA2E;CACzF,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5C,QAAQ,EAAE,uBAAuB;IACjC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrD,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;CACzC,CAAC,CAAC,QAAQ,CAAC;IACV,UAAU,EAAE,YAAY;IACxB,KAAK,EAAE,aAAa;IACpB,WAAW,EAAE,wEAAwE;CACtF,CAAC,CAAC;AAKH,8EAA8E;AAC9E,wDAAwD;AACxD,8EAA8E;AAE9E,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAkB,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAEtF,OAAO,EAAE,iBAAiB,EAAE,CAAC"}
+{"version":3,"file":"output-mode.js","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/output-mode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAQxC,8EAA8E;AAC9E,uEAAuE;AACvE,EAAE;AACF,+EAA+E;AAC/E,yEAAyE;AACzE,4CAA4C;AAC5C,EAAE;AACF,6DAA6D;AAC7D,mEAAmE;AACnE,sEAAsE;AACtE,wEAAwE;AACxE,8EAA8E;AAE9E,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC,MAAM;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM;CACvB,CAAC,CAAC,QAAQ,CAAC;IACV,UAAU,EAAE,eAAe;IAC3B,KAAK,EAAE,gBAAgB;IACvB,WAAW,EAAE,kEAAkE;CAChF,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC,CAAC,QAAQ,CAAC;QAClE,UAAU,EAAE,UAAU;QACtB,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,gCAAgC;KAC9C,CAAC;IACF,OAAO,EAAE,MAAM,CAAC,MAAM;CACvB,CAAC,CAAC,QAAQ,CAAC;IACV,UAAU,EAAE,UAAU;IACtB,KAAK,EAAE,WAAW;IAClB,WAAW,EAAE,2EAA2E;CACzF,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM;CACvB,CAAC,CAAC,QAAQ,CAAC;IACV,UAAU,EAAE,YAAY;IACxB,KAAK,EAAE,aAAa;IACpB,WAAW,EAAE,wEAAwE;CACtF,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC;IACjD,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC,MAAM;IACnB,WAAW,EAAE,MAAM,CAAC,MAAM;IAC1B,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrD,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;CACpC,CAAC,CAAC,QAAQ,CAAC;IACV,UAAU,EAAE,iBAAiB;IAC7B,KAAK,EAAE,kBAAkB;IACzB,WAAW,EAAE,0DAA0D;CACxE,CAAC,CAAC;AAKH,8EAA8E;AAC9E,wDAAwD;AACxD,8EAA8E;AAE9E,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAkB,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC"}

package/dist/src/unstable/cli-runtime/runtime-envelope.d.ts

@@ -1,3 +1,4 @@
+import * as Cause from "effect/Cause";
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
 import type { OutputFormat } from "./output-mode.js";
@@ -6,6 +7,15 @@ import type { PromptCancelled } from "../cli-prompt/prompt-cancelled.js";
 import { type CliTelemetryConfigService } from "./telemetry-layer.js";
 import { type CliRenderer } from "../cli-renderer/index.js";
 import { Verbosity, type VerbosityLevel } from "../cli-flags/index.js";
+/**
+ * Emit a defect (unhandled panic) to the appropriate channel.
+ *
+ * - text: human-readable message on stderr.
+ * - json: NDJSON `error` event on stderr + structured envelope on stdout.
+ *
+ * Exported for tests; production callers route through `withCliErrorHandling`.
+ */
+export declare const writeDefect: (cause: Cause.Cause<unknown>, format: OutputFormat) => void;
 export type ExpectedCliError = AppError | PromptCancelled;
 export type CliRuntimeFoundation = CliRenderer | Verbosity;
 /**

package/dist/src/unstable/cli-runtime/runtime-envelope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-envelope.d.ts","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/runtime-envelope.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAItC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAGzE,OAAO,EAAyB,KAAK,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAY7F,OAAO,EAAwC,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAClG,OAAO,EAAsB,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAO3F,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,eAAe,CAAC;AAC1D,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,SAAS,CAAC;AAuC3D;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,YAAY,EACpB,UAAU;IACR,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;CACtD,wLA+BF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,+EAG3B,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,EAAE,CAAC,EACvC,SAAS,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,EAC9C,SAAS;IACP,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,yBAAyB,CAAC;CACrD,kbA0FF,CAAC;AAMF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,eAAe,EAAE,yBAAyB,CAAC;CACrD;AAED,eAAO,MAAM,cAAc,GAAI,CAAC,EAAE,CAAC,EACjC,SAAS,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,EAC9C,SAAS,qBAAqB,2fAY5B,CAAC"}
+{"version":3,"file":"runtime-envelope.d.ts","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/runtime-envelope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAItC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAGzE,OAAO,EAAyB,KAAK,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAY7F,OAAO,EAAwC,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAClG,OAAO,EAAsB,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AA+D3F;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,QAAQ,YAAY,KAAG,IAY/E,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,eAAe,CAAC;AAC1D,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,SAAS,CAAC;AAmC3D;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,YAAY,EACpB,UAAU;IACR,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;CACtD,wLA+BF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,+EAG3B,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,EAAE,CAAC,EACvC,SAAS,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,EAC9C,SAAS;IACP,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,yBAAyB,CAAC;CACrD,kbAiGF,CAAC;AAMF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,eAAe,EAAE,yBAAyB,CAAC;CACrD;AAED,eAAO,MAAM,cAAc,GAAI,CAAC,EAAE,CAAC,EACjC,SAAS,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,EAC9C,SAAS,qBAAqB,2fAY5B,CAAC"}