@agentxm/client-core 0.14.1 → 0.15.1

package/dist/src/unstable/cli-runtime/operation-plan.d.ts

@@ -0,0 +1,100 @@
+import * as Schema from "effect/Schema";
+declare const OperationPlanStepArtifactSchema: Schema.Struct<{
+    readonly path: Schema.optional<Schema.String>;
+    readonly scope: Schema.Literals<readonly ["project", "user"]>;
+    readonly version: Schema.optional<Schema.String>;
+    readonly change: Schema.Literals<readonly ["created", "updated", "unchanged", "removed"]>;
+    readonly previousVersion: Schema.optional<Schema.String>;
+    readonly fileCount: Schema.optional<Schema.Number>;
+}>;
+declare const OperationPlanStepSchema: Schema.Struct<{
+    readonly label: Schema.String;
+    readonly status: Schema.Literals<readonly ["ready", "warning", "error", "applied", "unchanged", "failed", "blocked"]>;
+    readonly message: Schema.optional<Schema.String>;
+    readonly warnings: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly artifact: Schema.optional<Schema.Struct<{
+        readonly path: Schema.optional<Schema.String>;
+        readonly scope: Schema.Literals<readonly ["project", "user"]>;
+        readonly version: Schema.optional<Schema.String>;
+        readonly change: Schema.Literals<readonly ["created", "updated", "unchanged", "removed"]>;
+        readonly previousVersion: Schema.optional<Schema.String>;
+        readonly fileCount: Schema.optional<Schema.Number>;
+    }>>;
+}>;
+export declare const OperationPlanFields: {
+    outcome: Schema.Literals<readonly ["previewed", "cancelled", "applied", "no-op"]>;
+    planName: Schema.String;
+    planDescription: Schema.optional<Schema.String>;
+    message: Schema.optional<Schema.String>;
+    totalSteps: Schema.Number;
+    readyCount: Schema.Number;
+    warningCount: Schema.Number;
+    errorCount: Schema.Number;
+    appliedCount: Schema.Number;
+    failedCount: Schema.Number;
+    blockedCount: Schema.Number;
+    steps: Schema.$Array<Schema.Struct<{
+        readonly label: Schema.String;
+        readonly status: Schema.Literals<readonly ["ready", "warning", "error", "applied", "unchanged", "failed", "blocked"]>;
+        readonly message: Schema.optional<Schema.String>;
+        readonly warnings: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly artifact: Schema.optional<Schema.Struct<{
+            readonly path: Schema.optional<Schema.String>;
+            readonly scope: Schema.Literals<readonly ["project", "user"]>;
+            readonly version: Schema.optional<Schema.String>;
+            readonly change: Schema.Literals<readonly ["created", "updated", "unchanged", "removed"]>;
+            readonly previousVersion: Schema.optional<Schema.String>;
+            readonly fileCount: Schema.optional<Schema.Number>;
+        }>>;
+    }>>;
+};
+export declare const OperationPlanSchema: Schema.Struct<{
+    outcome: Schema.Literals<readonly ["previewed", "cancelled", "applied", "no-op"]>;
+    planName: Schema.String;
+    planDescription: Schema.optional<Schema.String>;
+    message: Schema.optional<Schema.String>;
+    totalSteps: Schema.Number;
+    readyCount: Schema.Number;
+    warningCount: Schema.Number;
+    errorCount: Schema.Number;
+    appliedCount: Schema.Number;
+    failedCount: Schema.Number;
+    blockedCount: Schema.Number;
+    steps: Schema.$Array<Schema.Struct<{
+        readonly label: Schema.String;
+        readonly status: Schema.Literals<readonly ["ready", "warning", "error", "applied", "unchanged", "failed", "blocked"]>;
+        readonly message: Schema.optional<Schema.String>;
+        readonly warnings: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly artifact: Schema.optional<Schema.Struct<{
+            readonly path: Schema.optional<Schema.String>;
+            readonly scope: Schema.Literals<readonly ["project", "user"]>;
+            readonly version: Schema.optional<Schema.String>;
+            readonly change: Schema.Literals<readonly ["created", "updated", "unchanged", "removed"]>;
+            readonly previousVersion: Schema.optional<Schema.String>;
+            readonly fileCount: Schema.optional<Schema.Number>;
+        }>>;
+    }>>;
+}>;
+export type OperationPlan = typeof OperationPlanSchema.Type;
+export type OperationPlanStep = typeof OperationPlanStepSchema.Type;
+export type OperationPlanStepArtifact = typeof OperationPlanStepArtifactSchema.Type;
+export declare const makeOperationPlan: (args: {
+    readonly planName: string;
+    readonly planDescription?: string;
+    readonly message?: string;
+    readonly steps: ReadonlyArray<OperationPlanStep>;
+    readonly outcome?: OperationPlan["outcome"];
+}) => OperationPlan;
+export declare const makeSingleStepOperationPlan: (args: {
+    readonly planName: string;
+    readonly planDescription?: string;
+    readonly message: string;
+    readonly stepLabel: string;
+    readonly stepStatus: OperationPlanStep["status"];
+    readonly stepMessage?: string;
+    readonly warnings?: ReadonlyArray<string>;
+    readonly artifact?: OperationPlanStepArtifact;
+    readonly outcome?: OperationPlan["outcome"];
+}) => OperationPlan;
+export {};
+//# sourceMappingURL=operation-plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operation-plan.d.ts","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/operation-plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAYxC,QAAA,MAAM,+BAA+B;;;;;;;EAOnC,CAAC;AAEH,QAAA,MAAM,uBAAuB;;;;;;;;;;;;;EAM3B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;CAaA,CAAC;AAEjC,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;EAAqC,CAAC;AAEtE,MAAM,MAAM,aAAa,GAAG,OAAO,mBAAmB,CAAC,IAAI,CAAC;AAC5D,MAAM,MAAM,iBAAiB,GAAG,OAAO,uBAAuB,CAAC,IAAI,CAAC;AACpE,MAAM,MAAM,yBAAyB,GAAG,OAAO,+BAA+B,CAAC,IAAI,CAAC;AAEpF,eAAO,MAAM,iBAAiB,GAAI,MAAM;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IACjD,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;CAC7C,KAAG,aA6BH,CAAC;AAEF,eAAO,MAAM,2BAA2B,GAAI,MAAM;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACjD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,yBAAyB,CAAC;IAC9C,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;CAC7C,KAAG,aAiBA,CAAC"}

package/dist/src/unstable/cli-runtime/operation-plan.js

@@ -0,0 +1,83 @@
+import * as Schema from "effect/Schema";
+const OperationPlanStepStatusSchema = Schema.Literals([
+    "ready",
+    "warning",
+    "error",
+    "applied",
+    "unchanged",
+    "failed",
+    "blocked",
+]);
+const OperationPlanStepArtifactSchema = Schema.Struct({
+    path: Schema.optional(Schema.String),
+    scope: Schema.Literals(["project", "user"]),
+    version: Schema.optional(Schema.String),
+    change: Schema.Literals(["created", "updated", "unchanged", "removed"]),
+    previousVersion: Schema.optional(Schema.String),
+    fileCount: Schema.optional(Schema.Number),
+});
+const OperationPlanStepSchema = Schema.Struct({
+    label: Schema.String,
+    status: OperationPlanStepStatusSchema,
+    message: Schema.optional(Schema.String),
+    warnings: Schema.optional(Schema.Array(Schema.String)),
+    artifact: Schema.optional(OperationPlanStepArtifactSchema),
+});
+export const OperationPlanFields = {
+    outcome: Schema.Literals(["previewed", "cancelled", "applied", "no-op"]),
+    planName: Schema.String,
+    planDescription: Schema.optional(Schema.String),
+    message: Schema.optional(Schema.String),
+    totalSteps: Schema.Number,
+    readyCount: Schema.Number,
+    warningCount: Schema.Number,
+    errorCount: Schema.Number,
+    appliedCount: Schema.Number,
+    failedCount: Schema.Number,
+    blockedCount: Schema.Number,
+    steps: Schema.Array(OperationPlanStepSchema),
+};
+export const OperationPlanSchema = Schema.Struct(OperationPlanFields);
+export const makeOperationPlan = (args) => {
+    const readyCount = args.steps.filter((step) => step.status === "ready").length;
+    const warningStatusCount = args.steps.filter((step) => step.status === "warning").length;
+    const warningCount = args.steps.reduce((total, step) => total + (step.warnings?.length ?? 0), warningStatusCount);
+    const errorCount = args.steps.filter((step) => step.status === "error").length;
+    const appliedCount = args.steps.filter((step) => step.status === "applied").length;
+    const failedCount = args.steps.filter((step) => step.status === "failed").length;
+    const blockedCount = args.steps.filter((step) => step.status === "blocked").length;
+    const outcome = args.outcome ??
+        (appliedCount === 0 && failedCount === 0 && blockedCount === 0 ? "no-op" : "applied");
+    return {
+        outcome,
+        planName: args.planName,
+        ...(args.planDescription !== undefined ? { planDescription: args.planDescription } : {}),
+        ...(args.message !== undefined ? { message: args.message } : {}),
+        totalSteps: args.steps.length,
+        readyCount,
+        warningCount,
+        errorCount,
+        appliedCount,
+        failedCount,
+        blockedCount,
+        steps: [...args.steps],
+    };
+};
+export const makeSingleStepOperationPlan = (args) => makeOperationPlan({
+    planName: args.planName,
+    ...(args.planDescription !== undefined ? { planDescription: args.planDescription } : {}),
+    message: args.message,
+    ...(args.outcome !== undefined ? { outcome: args.outcome } : {}),
+    steps: [
+        {
+            label: args.stepLabel,
+            status: args.stepStatus,
+            ...(args.stepMessage !== undefined ? { message: args.stepMessage } : {}),
+            ...(args.warnings !== undefined && args.warnings.length > 0
+                ? { warnings: [...args.warnings] }
+                : {}),
+            ...(args.artifact !== undefined ? { artifact: args.artifact } : {}),
+        },
+    ],
+});
+//# sourceMappingURL=operation-plan.js.map

package/dist/src/unstable/cli-runtime/operation-plan.js.map

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

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

@@ -1,4 +1,5 @@
 import * as Schema from "effect/Schema";
+import type { SuggestedAction } from "./suggested-action.js";
 export type OutputFormat = "text" | "json";
 export declare const ProgressEventSchema: Schema.Struct<{
     readonly type: Schema.Literal<"progress">;
@@ -19,6 +20,13 @@ export declare const ErrorEventSchema: Schema.Struct<{
     readonly message: Schema.String;
 }>;
 export type ErrorEvent = typeof ErrorEventSchema.Type;
+/**
+ * Construct an NDJSON `error` event — the single source of truth for the
+ * machine-mode error event shape. The full structured detail (title, metadata,
+ * suggestions) lives in the stdout envelope; the stream event carries only the
+ * stable `code` and a human `message`.
+ */
+export declare const makeErrorEvent: (code: string, message: string) => ErrorEvent;
 export declare const SuggestionEventSchema: Schema.Struct<{
     readonly type: Schema.Literal<"suggestion">;
     readonly description: Schema.String;
@@ -26,6 +34,11 @@ export declare const SuggestionEventSchema: Schema.Struct<{
     readonly url: Schema.optional<Schema.String>;
 }>;
 export type SuggestionEvent = typeof SuggestionEventSchema.Type;
+/**
+ * Construct an NDJSON `suggestion` event — the single source of truth for the
+ * machine-mode suggestion event shape, shared by the renderer and error paths.
+ */
+export declare const makeSuggestionEvent: (suggestion: SuggestedAction) => SuggestionEvent;
 export type StreamEvent = ProgressEvent | LogEvent | ErrorEvent | SuggestionEvent;
 export declare const emitEvent: (event: StreamEvent) => import("effect/Effect").Effect<void, never, never>;
 //# 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;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;;;;;EAShC,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"}
+{"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;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAM7D,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;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,SAAS,MAAM,KAAG,UAI7D,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;EAShC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,qBAAqB,CAAC,IAAI,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,YAAY,eAAe,KAAG,eAKhE,CAAC;AAEH,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

@@ -44,6 +44,17 @@ export const ErrorEventSchema = Schema.Struct({
     title: "Error Event",
     description: "NDJSON error event with a stable error code for programmatic handling.",
 });
+/**
+ * Construct an NDJSON `error` event — the single source of truth for the
+ * machine-mode error event shape. The full structured detail (title, metadata,
+ * suggestions) lives in the stdout envelope; the stream event carries only the
+ * stable `code` and a human `message`.
+ */
+export const makeErrorEvent = (code, message) => ({
+    type: "error",
+    code,
+    message,
+});
 export const SuggestionEventSchema = Schema.Struct({
     type: Schema.Literal("suggestion"),
     description: Schema.String,
@@ -54,6 +65,16 @@ export const SuggestionEventSchema = Schema.Struct({
     title: "Suggestion Event",
     description: "NDJSON suggestion event with a suggested follow-up.",
 });
+/**
+ * Construct an NDJSON `suggestion` event — the single source of truth for the
+ * machine-mode suggestion event shape, shared by the renderer and error paths.
+ */
+export const makeSuggestionEvent = (suggestion) => ({
+    type: "suggestion",
+    description: suggestion.description,
+    ...(suggestion.cmd !== undefined ? { cmd: suggestion.cmd } : {}),
+    ...(suggestion.url !== undefined ? { url: suggestion.url } : {}),
+});
 // ---------------------------------------------------------------------------
 // Event emitter — writes a single NDJSON line to stderr
 // ---------------------------------------------------------------------------

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;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,WAAW,EAAE,MAAM,CAAC,MAAM;IAC1B,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACnC,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,qDAAqD;CACnE,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"}
+{"version":3,"file":"output-mode.js","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/output-mode.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"run-cli-main.d.ts","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/run-cli-main.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAMxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;CACzC;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM,aAAa,CAAC,MAAM,CAAC,KAAG,cAE9D,CAAC;AAGH,eAAO,MAAM,UAAU,GACrB,SAAS,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAC7E,UAAU;IACR,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;CACnD,KACA,OAAO,CAAC,IAAI,CASd,CAAC"}
+{"version":3,"file":"run-cli-main.d.ts","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/run-cli-main.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AASxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;CACzC;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM,aAAa,CAAC,MAAM,CAAC,KAAG,cAE9D,CAAC;AA8GH,eAAO,MAAM,UAAU,GACrB,SAAS,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAC7E,UAAU;IACR,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;CACnD,KACA,OAAO,CAAC,IAAI,CA8Bd,CAAC"}

package/dist/src/unstable/cli-runtime/run-cli-main.js

@@ -1,4 +1,7 @@
 import * as Effect from "effect/Effect";
+import { CliError } from "effect/unstable/cli";
+import { Buffer } from "node:buffer";
+import { format as formatConsoleArgs } from "node:util";
 import { handleError } from "./handle-error.js";
 import { withGracefulShutdown } from "./graceful-shutdown.js";
 import { resolveFormatFromArgv } from "./resolve-format.js";
@@ -10,15 +13,109 @@ import { resolveVerbosityFromArgv } from "../cli-flags/resolve-verbosity.js";
 export const resolveCliContext = (args) => ({
     verbosityLevel: resolveVerbosityFromArgv(args),
 });
+const chunkToString = (chunk, encoding) => typeof chunk === "string" ? chunk : Buffer.from(chunk).toString(encoding);
+const invokeWriteCallback = (encodingOrCallback, callback) => {
+    if (typeof encodingOrCallback === "function") {
+        encodingOrCallback();
+        return;
+    }
+    callback?.();
+};
+const bufferStdout = () => {
+    const originalWrite = process.stdout.write.bind(process.stdout);
+    const originalStderrWrite = process.stderr.write.bind(process.stderr);
+    const originalConsoleLog = console.log.bind(console);
+    const chunks = [];
+    const bufferedWrite = ((chunk, encodingOrCallback, callback) => {
+        chunks.push(chunkToString(chunk, typeof encodingOrCallback === "string" ? encodingOrCallback : undefined));
+        invokeWriteCallback(encodingOrCallback, callback);
+        return true;
+    });
+    const bufferedLog = ((...args) => {
+        chunks.push(`${formatConsoleArgs(...args)}\n`);
+    });
+    process.stdout.write = bufferedWrite;
+    console.log = bufferedLog;
+    return {
+        discard: () => {
+            chunks.length = 0;
+        },
+        flushToStderr: () => {
+            for (const chunk of chunks) {
+                originalStderrWrite(chunk);
+            }
+            chunks.length = 0;
+        },
+        flushToStdout: () => {
+            for (const chunk of chunks) {
+                originalWrite(chunk);
+            }
+            chunks.length = 0;
+        },
+        restore: () => {
+            process.stdout.write = originalWrite;
+            console.log = originalConsoleLog;
+        },
+    };
+};
+const bufferStderr = () => {
+    const originalWrite = process.stderr.write.bind(process.stderr);
+    const chunks = [];
+    const bufferedWrite = ((chunk, encodingOrCallback, callback) => {
+        chunks.push(chunkToString(chunk, typeof encodingOrCallback === "string" ? encodingOrCallback : undefined));
+        invokeWriteCallback(encodingOrCallback, callback);
+        return true;
+    });
+    process.stderr.write = bufferedWrite;
+    return {
+        discard: () => {
+            chunks.length = 0;
+        },
+        flushToStderr: () => {
+            for (const chunk of chunks) {
+                originalWrite(chunk);
+            }
+            chunks.length = 0;
+        },
+        restore: () => {
+            process.stderr.write = originalWrite;
+        },
+    };
+};
+const isUsageHelpError = (error) => CliError.isCliError(error) && error._tag === "ShowHelp" && error.errors.length > 0;
 // Raw async/await: bootstraps the CLI before the Effect runtime is configured.
 export const runCliMain = async (execute, options) => {
     const args = options?.args ?? process.argv.slice(2);
     const format = resolveFormatFromArgv(args);
+    const stdoutBuffer = bufferStdout();
+    const stderrBuffer = format === "text" ? bufferStderr() : undefined;
     try {
         await Effect.runPromise(withGracefulShutdown(execute(args)));
+        stdoutBuffer.flushToStdout();
+        stderrBuffer?.flushToStderr();
     }
     catch (error) {
+        const isUsageHelp = isUsageHelpError(error);
+        if (isUsageHelp) {
+            if (format === "text") {
+                stderrBuffer?.discard();
+                stdoutBuffer.flushToStderr();
+            }
+            else {
+                stdoutBuffer.discard();
+            }
+        }
+        else {
+            stdoutBuffer.flushToStdout();
+            stderrBuffer?.flushToStderr();
+        }
+        stdoutBuffer.restore();
+        stderrBuffer?.restore();
         handleError(error, format);
     }
+    finally {
+        stdoutBuffer.restore();
+        stderrBuffer?.restore();
+    }
 };
 //# sourceMappingURL=run-cli-main.js.map

package/dist/src/unstable/cli-runtime/run-cli-main.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-cli-main.js","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/run-cli-main.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAO7E;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAA2B,EAAkB,EAAE,CAAC,CAAC;IACjF,cAAc,EAAE,wBAAwB,CAAC,IAAI,CAAC;CAC/C,CAAC,CAAC;AAEH,+EAA+E;AAC/E,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAC7B,OAA6E,EAC7E,OAEC,EACc,EAAE;IACjB,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAE3C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,UAAU,CAAC,oBAAoB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC,CAAC"}
+{"version":3,"file":"run-cli-main.js","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/run-cli-main.ts"],"names":[],"mappings":"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"}

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

@@ -5,6 +5,7 @@ import type { OutputFormat } from "./output-mode.js";
 import type { AppError } from "../app-error/index.js";
 import type { PromptCancelled } from "../cli-prompt/prompt-cancelled.js";
 import { type CliTelemetryConfigService } from "./telemetry-layer.js";
+import type { TelemetryProperties } from "../telemetry/index.js";
 import { type CliRenderer } from "../cli-renderer/index.js";
 import { Verbosity, type VerbosityLevel } from "../cli-flags/index.js";
 /**
@@ -18,6 +19,20 @@ import { Verbosity, type VerbosityLevel } from "../cli-flags/index.js";
 export declare const writeDefect: (cause: Cause.Cause<unknown>, format: OutputFormat) => void;
 export type ExpectedCliError = AppError | PromptCancelled;
 export type CliRuntimeFoundation = CliRenderer | Verbosity;
+export declare const exitCodeForSemanticProperties: (properties: TelemetryProperties) => number | undefined;
+/**
+ * Emit an expected (handled) CLI error.
+ *
+ * Rendering is delegated to `renderAppErrorChannels` — the single source of
+ * truth shared with the outer `classifyError`/`handleError` path — so the two
+ * error paths cannot diverge. Suggestions appear once per channel: a single
+ * `Next:` block in text mode, and the stderr suggestion stream plus the
+ * stdout envelope (distinct surfaces) in json mode. The earlier bug emitted a
+ * second `Next:` block on the same stderr channel in text mode.
+ *
+ * Exported for tests; production callers route through `withCliErrorHandling`.
+ */
+export declare const writeExpectedCliError: (error: ExpectedCliError, format: OutputFormat) => Effect.Effect<void, never, never>;
 /**
  * Build the foundation layer: CliRenderer + Verbosity.
  *
@@ -28,7 +43,7 @@ export declare const makeFoundationLayer: (format: OutputFormat, options?: {
     readonly envVerbose?: boolean | undefined;
     readonly envDebug?: boolean | undefined;
     readonly verbosityLevel?: VerbosityLevel | undefined;
-}) => Layer.Layer<Verbosity | CliRenderer, never, "effect/unstable/cli/GlobalFlag/axm-quiet" | "effect/unstable/cli/GlobalFlag/axm-verbose" | "effect/unstable/cli/GlobalFlag/axm-debug">;
+}) => Layer.Layer<CliRenderer | Verbosity, never, "effect/unstable/cli/GlobalFlag/axm-quiet" | "effect/unstable/cli/GlobalFlag/axm-verbose" | "effect/unstable/cli/GlobalFlag/axm-debug">;
 /**
  * Resolve the output format from the global flag + options.
  */
@@ -50,5 +65,5 @@ export interface WithCliRuntimeOptions {
     readonly command?: string | undefined;
     readonly telemetryConfig: CliTelemetryConfigService;
 }
-export declare const withCliRuntime: <A, R>(program: Effect.Effect<A, ExpectedCliError, R>, options: WithCliRuntimeOptions) => Effect.Effect<A, never, import("effect/unstable/http/HttpClient").HttpClient | "effect/unstable/cli/GlobalFlag/axm-non-interactive" | "effect/unstable/cli/GlobalFlag/axm-json" | "effect/unstable/cli/GlobalFlag/axm-quiet" | "effect/unstable/cli/GlobalFlag/axm-verbose" | "effect/unstable/cli/GlobalFlag/axm-debug" | Exclude<Exclude<Exclude<R, Verbosity | CliRenderer>, import("effect/Scope").Scope>, import("../telemetry/client.ts").TelemetryClient | import("./telemetry.js").CommandSemanticProperties>>;
+export declare const withCliRuntime: <A, R>(program: Effect.Effect<A, ExpectedCliError, R>, options: WithCliRuntimeOptions) => Effect.Effect<A, never, import("effect/unstable/http/HttpClient").HttpClient | "effect/unstable/cli/GlobalFlag/axm-non-interactive" | "effect/unstable/cli/GlobalFlag/axm-json" | "effect/unstable/cli/GlobalFlag/axm-quiet" | "effect/unstable/cli/GlobalFlag/axm-verbose" | "effect/unstable/cli/GlobalFlag/axm-debug" | Exclude<Exclude<Exclude<R, CliRenderer | Verbosity>, import("effect/Scope").Scope>, import("../telemetry/client.ts").TelemetryClient | import("./telemetry.js").CommandSemanticProperties>>;
 //# sourceMappingURL=runtime-envelope.d.ts.map

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":"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;AA8D3F;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,QAAQ,YAAY,KAAG,IA2B/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"}
+{"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;AAErD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAIzE,OAAO,EAAyB,KAAK,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAW7F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAsB,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAY3F;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,QAAQ,YAAY,KAAG,IAoB/E,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,eAAe,CAAC;AAC1D,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,SAAS,CAAC;AAU3D,eAAO,MAAM,6BAA6B,GACxC,YAAY,mBAAmB,KAC9B,MAAM,GAAG,SAIG,CAAC;AAEhB;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,GAAI,OAAO,gBAAgB,EAAE,QAAQ,YAAY,sCAuB/E,CAAC;AAML;;;;;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,wLA2CF,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,kbAyGF,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"}