axm.sh 0.1.6

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 AgentXM, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,26 @@
+# axm.sh
+
+CLI package for `axm`.
+
+## Compile Standalone Binaries
+
+Prerequisites:
+
+- Bun installed locally
+- `pnpm install`
+
+Run:
+
+```sh
+pnpm nx run cli:compile
+```
+
+The target depends on `cli:build`, compiles from `dist/src/main.js`, and writes binaries to `packages/cli/dist/bin/`:
+
+- `axm-darwin-arm64`
+- `axm-darwin-x64`
+- `axm-linux-arm64`
+- `axm-linux-x64`
+- `axm-windows-x64.exe`
+
+The compile target also injects the package version at build time so compiled binaries report the correct `axm --version`.

package/dist/src/app.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Root CLI application.
+ */
+import { Command } from "effect/unstable/cli";
+export declare const rootCommand: Command.Command<"axm", {}, {}, never, import("packages/core/src/unstable/auth/device-login.ts").DeviceLoginInteraction>;
+export declare const run: (args?: ReadonlyArray<string>) => Promise<void>;
+//# sourceMappingURL=app.d.ts.map

package/dist/src/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/app.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAa,OAAO,EAAc,MAAM,qBAAqB,CAAC;AAsCrE,eAAO,MAAM,WAAW,yHA8CvB,CAAC;AAWF,eAAO,MAAM,GAAG,GAAU,OAAM,aAAa,CAAC,MAAM,CAAyB,KAAG,OAAO,CAAC,IAAI,CA8B3F,CAAC"}

package/dist/src/app.js

@@ -0,0 +1,96 @@
+/**
+ * Root CLI application.
+ */
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { CliOutput, Command, GlobalFlag } from "effect/unstable/cli";
+import { InteractiveRenderer, MachineRenderer } from "@agentxm/client-core/unstable/cli-renderer";
+import { removeBuiltInFlag, runCliMain } from "@agentxm/client-core/unstable/cli-runtime";
+import { InstallMethodLive } from "@agentxm/client-core/unstable/install-method";
+import { UpdateCheckLive } from "@agentxm/client-core/unstable/update-check";
+import { LearnMore, makeAxmFormatter } from "./formatter.js";
+import { withUpdateCheck, resolveNonInteractiveFromArgv } from "./update-check-startup.js";
+import { axmGlobalFlags, baseLayer, runtimeBaseLayer } from "./runtime.js";
+import { loadVersion } from "./version.js";
+import { initCommand } from "./root/init.js";
+import { skillsCommand } from "./root/skills/_skills.js";
+import { packsCommand } from "./root/packs/_packs.js";
+import { commandsCommand } from "./root/commands/_commands.js";
+import { mcpServersCommand } from "./root/mcp-servers/_mcp-servers.js";
+import { subagentsCommand } from "./root/subagents/_subagents.js";
+import { authCommand } from "./root/auth/_auth.js";
+import { loginCommand } from "./root/auth/login.js";
+import { logoutCommand } from "./root/auth/logout.js";
+import { whoamiCommand } from "./root/auth/whoami.js";
+import { tokenCommand } from "./root/auth/token.js";
+import { upgradeCommand } from "./root/upgrade/upgrade.js";
+import { doctorCommand } from "./root/doctor/command.js";
+import { syncCommand } from "./root/sync.js";
+import { discoverCommand } from "./root/discover/command.js";
+import { installCommand } from "./root/install/command.js";
+const ROOT_COMMAND = "axm";
+const version = loadVersion();
+const LEARN_MORE_FOOTER = "LEARN MORE\n  Use 'axm <command> --help' for more information about a command.";
+removeBuiltInFlag(GlobalFlag.Completions);
+removeBuiltInFlag(GlobalFlag.LogLevel);
+export const rootCommand = Command.make(ROOT_COMMAND).pipe(Command.withDescription("Open extension manager for AI coding agents.\n  Manage skills, commands, MCP servers, and extension packs across your AI coding agents from a single CLI."), Command.annotate(LearnMore, LEARN_MORE_FOOTER), Command.withExamples([
+    { command: "axm init", description: "Start managing extensions in your project" },
+    {
+        command: "axm install @acme/skills/code-review",
+        description: "Add a code review skill to your agents",
+    },
+    {
+        command: "axm packs install @acme/packs/frontend-tools",
+        description: "Install a curated set of extensions at once",
+    },
+    { command: "axm whoami", description: "Check who you're authenticated as" },
+]), Command.withSubcommands([
+    { group: "GETTING STARTED", commands: [initCommand] },
+    {
+        group: "EXTENSIONS",
+        commands: [
+            installCommand,
+            skillsCommand,
+            packsCommand,
+            commandsCommand,
+            mcpServersCommand,
+            subagentsCommand,
+            discoverCommand,
+        ],
+    },
+    {
+        group: "AUTH AND CONFIG",
+        commands: [
+            doctorCommand,
+            syncCommand,
+            authCommand,
+            loginCommand,
+            logoutCommand,
+            whoamiCommand,
+            tokenCommand,
+            upgradeCommand,
+        ],
+    },
+]), Command.withGlobalFlags(axmGlobalFlags));
+const hasExplicitJsonFlag = (args) => args.includes("--json") || args.includes("-j");
+/** Layer providing UpdateCheck and InstallMethod for the startup update check. */
+const updateCheckServicesLayer = Layer.provide(Layer.mergeAll(UpdateCheckLive, InstallMethodLive), runtimeBaseLayer);
+export const run = async (args = process.argv.slice(2)) => {
+    await runCliMain((argv) => {
+        const isJson = hasExplicitJsonFlag(argv);
+        const commandProgram = Command.runWith(rootCommand, { version })(argv);
+        const rendererLayer = isJson ? MachineRenderer() : InteractiveRenderer();
+        return withUpdateCheck(commandProgram, {
+            localVersion: version,
+            inputs: {
+                args: argv,
+                isNonInteractive: resolveNonInteractiveFromArgv(argv),
+                isJsonOutput: isJson,
+            },
+        }).pipe(
+        // Built-in --help / --version output is formatter-driven, so explicit
+        // --json has to be reflected here before Effect CLI starts rendering.
+        Effect.provide(Layer.mergeAll(baseLayer, updateCheckServicesLayer, rendererLayer, CliOutput.layer(makeAxmFormatter({ json: isJson })))));
+    }, { args });
+};
+//# sourceMappingURL=app.js.map

package/dist/src/app.js.map

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

package/dist/src/cli-flags.d.ts

@@ -0,0 +1,3 @@
+import { Flag } from "effect/unstable/cli";
+export declare const scopeFlag: Flag.Flag<"user" | "project">;
+//# sourceMappingURL=cli-flags.d.ts.map

package/dist/src/cli-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-flags.d.ts","sourceRoot":"","sources":["../../src/cli-flags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAG3C,eAAO,MAAM,SAAS,+BAGrB,CAAC"}

package/dist/src/cli-flags.js

@@ -0,0 +1,4 @@
+import { Flag } from "effect/unstable/cli";
+import { DEFAULT_WORKSPACE_SCOPE, WORKSPACE_SCOPES } from "@agentxm/client-core/unstable/workspace";
+export const scopeFlag = Flag.choice("scope", WORKSPACE_SCOPES).pipe(Flag.withDescription("Configuration scope: project (default) or user"), Flag.withDefault(DEFAULT_WORKSPACE_SCOPE));
+//# sourceMappingURL=cli-flags.js.map

package/dist/src/cli-flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-flags.js","sourceRoot":"","sources":["../../src/cli-flags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAEpG,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,IAAI,CAClE,IAAI,CAAC,eAAe,CAAC,gDAAgD,CAAC,EACtE,IAAI,CAAC,WAAW,CAAC,uBAAuB,CAAC,CAC1C,CAAC"}

package/dist/src/formatter.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Custom CLI output formatter that suppresses global flags on subcommand help
+ * and appends a "learn more" footer from command annotations.
+ */
+import * as ServiceMap from "effect/ServiceMap";
+import { CliOutput } from "effect/unstable/cli";
+/**
+ * Annotation key for "learn more" footer text.
+ * Attach to commands via `Command.annotate(LearnMore, "...")`.
+ */
+export declare const LearnMore: ServiceMap.Reference<string>;
+/**
+ * Creates a custom CLI output formatter that wraps the Effect default
+ * formatter with two enhancements:
+ *
+ * 1. Global flag suppression on subcommand help output
+ * 2. "Learn more" footer appended from the `LearnMore` command annotation
+ */
+export declare const makeAxmFormatter: (options?: {
+    readonly json?: boolean | undefined;
+}) => CliOutput.Formatter;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/src/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/formatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAOhD;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,MAAM,CAEjD,CAAC;AAoLH;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAI,UAAU;IACzC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACrC,KAAG,SAAS,CAAC,SA2Cb,CAAC"}

package/dist/src/formatter.js

@@ -0,0 +1,170 @@
+/**
+ * Custom CLI output formatter that suppresses global flags on subcommand help
+ * and appends a "learn more" footer from command annotations.
+ */
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+import * as ServiceMap from "effect/ServiceMap";
+import { CliOutput } from "effect/unstable/cli";
+import { JsonSchemaVersion, JsonSchemaVersionSchema, } from "@agentxm/client-core/unstable/cli-runtime";
+/**
+ * Annotation key for "learn more" footer text.
+ * Attach to commands via `Command.annotate(LearnMore, "...")`.
+ */
+export const LearnMore = ServiceMap.Reference("axm/learn-more", {
+    defaultValue: () => "",
+});
+/**
+ * Determines whether a HelpDoc represents a subcommand (as opposed to the
+ * root command) by counting the command tokens in the usage string that
+ * precede any bracketed placeholder like `[flags]` or `<subcommand>`.
+ *
+ * Root usage: `"axm <subcommand> [flags]"` => 1 token ("axm")
+ * Subcommand: `"axm skills install [flags]"` => 3 tokens
+ */
+const isSubcommandDoc = (doc) => {
+    const beforeBrackets = doc.usage.replace(/\s*[[<].*$/, "").trim();
+    const tokens = beforeBrackets.split(/\s+/).filter((t) => t.length > 0);
+    return tokens.length > 1;
+};
+const getVisibleGlobalFlags = (doc) => {
+    if (!isSubcommandDoc(doc)) {
+        return doc.globalFlags;
+    }
+    const globalFlags = doc.globalFlags?.filter((flag) => flag.name === "json");
+    return globalFlags !== undefined && globalFlags.length > 0 ? globalFlags : undefined;
+};
+const getLearnMore = (doc) => ServiceMap.getReferenceUnsafe(doc.annotations, LearnMore);
+const getAdjustedHelpDoc = (doc) => {
+    if (!isSubcommandDoc(doc)) {
+        return doc;
+    }
+    const visibleGlobalFlags = getVisibleGlobalFlags(doc);
+    const { globalFlags: _globalFlags, ...rest } = doc;
+    return visibleGlobalFlags === undefined ? rest : { ...rest, globalFlags: visibleGlobalFlags };
+};
+const JsonFlagDocSchema = Schema.Struct({
+    name: Schema.String,
+    aliases: Schema.Array(Schema.String),
+    type: Schema.String,
+    required: Schema.Boolean,
+    description: Schema.optional(Schema.String),
+});
+const JsonArgDocSchema = Schema.Struct({
+    name: Schema.String,
+    type: Schema.String,
+    required: Schema.Boolean,
+    variadic: Schema.Boolean,
+    description: Schema.optional(Schema.String),
+});
+const JsonSubcommandDocSchema = Schema.Struct({
+    name: Schema.String,
+    alias: Schema.optional(Schema.String),
+    shortDescription: Schema.optional(Schema.String),
+    description: Schema.optional(Schema.String),
+});
+const JsonSubcommandGroupDocSchema = Schema.Struct({
+    group: Schema.optional(Schema.String),
+    commands: Schema.Array(JsonSubcommandDocSchema),
+});
+const JsonExampleDocSchema = Schema.Struct({
+    command: Schema.String,
+    description: Schema.optional(Schema.String),
+});
+const JsonHelpDocSchema = Schema.Struct({
+    _version: JsonSchemaVersionSchema,
+    type: Schema.Literal("help"),
+    description: Schema.String,
+    usage: Schema.String,
+    flags: Schema.Array(JsonFlagDocSchema),
+    globalFlags: Schema.optional(Schema.Array(JsonFlagDocSchema)),
+    args: Schema.optional(Schema.Array(JsonArgDocSchema)),
+    subcommands: Schema.optional(Schema.Array(JsonSubcommandGroupDocSchema)),
+    examples: Schema.optional(Schema.Array(JsonExampleDocSchema)),
+    learnMore: Schema.optional(Schema.String),
+});
+const JsonVersionDocSchema = Schema.Struct({
+    _version: JsonSchemaVersionSchema,
+    type: Schema.Literal("version"),
+    name: Schema.String,
+    version: Schema.String,
+});
+const toJsonFlagDoc = (flag) => ({
+    name: flag.name,
+    aliases: flag.aliases,
+    type: flag.type,
+    required: flag.required,
+    description: Option.getOrUndefined(flag.description),
+});
+const toJsonHelpDoc = (doc) => {
+    const adjusted = getAdjustedHelpDoc(doc);
+    const learnMore = getLearnMore(doc);
+    return {
+        _version: JsonSchemaVersion,
+        type: "help",
+        description: adjusted.description,
+        usage: adjusted.usage,
+        flags: adjusted.flags.map(toJsonFlagDoc),
+        globalFlags: adjusted.globalFlags?.map(toJsonFlagDoc),
+        args: adjusted.args?.map((arg) => ({
+            name: arg.name,
+            type: arg.type,
+            required: arg.required,
+            variadic: arg.variadic,
+            description: Option.getOrUndefined(arg.description),
+        })),
+        subcommands: adjusted.subcommands?.map((group) => ({
+            group: group.group,
+            commands: group.commands.map((command) => ({
+                name: command.name,
+                alias: command.alias,
+                shortDescription: command.shortDescription,
+                description: command.description,
+            })),
+        })),
+        examples: adjusted.examples?.map((example) => ({
+            command: example.command,
+            description: example.description,
+        })),
+        ...(learnMore !== "" && { learnMore }),
+    };
+};
+/**
+ * Creates a custom CLI output formatter that wraps the Effect default
+ * formatter with two enhancements:
+ *
+ * 1. Global flag suppression on subcommand help output
+ * 2. "Learn more" footer appended from the `LearnMore` command annotation
+ */
+export const makeAxmFormatter = (options) => {
+    const base = CliOutput.defaultFormatter();
+    const json = options?.json === true;
+    return {
+        ...base,
+        formatHelpDoc: (doc) => {
+            if (json) {
+                return JSON.stringify(Schema.encodeSync(JsonHelpDocSchema)(toJsonHelpDoc(doc)), null, 2);
+            }
+            const adjusted = getAdjustedHelpDoc(doc);
+            let output = base.formatHelpDoc(adjusted);
+            const learnMore = getLearnMore(doc);
+            if (learnMore !== "") {
+                output += "\n\n" + learnMore;
+            }
+            return output;
+        },
+        formatVersion: (name, version) => json
+            ? JSON.stringify(Schema.encodeSync(JsonVersionDocSchema)({
+                _version: JsonSchemaVersion,
+                type: "version",
+                name,
+                version,
+            }), null, 2)
+            : version,
+        // Keep usage failures human-oriented on stderr even when --json is set.
+        // Effect CLI owns the parse/help path, so this is the cleanest contract
+        // we can provide without replacing Command.runWith().
+        formatErrors: (errors) => base.formatErrors(errors),
+    };
+};
+//# sourceMappingURL=formatter.js.map

package/dist/src/formatter.js.map

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

package/dist/src/json-output.d.ts

@@ -0,0 +1,41 @@
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import { CliRenderer } from "@agentxm/client-core/unstable/cli-renderer";
+import type { CommandOutcomeSummary, SourceKind, SubjectType } from "@agentxm/client-core/unstable/cli-runtime";
+import type { PlanResolution } from "@agentxm/client-core/unstable/workspace";
+export declare const PlanResolutionResultSchema: Schema.Struct<{
+    readonly outcome: Schema.Literals<readonly ["previewed", "cancelled", "applied", "no-op"]>;
+    readonly planName: Schema.String;
+    readonly planDescription: Schema.optional<Schema.String>;
+    readonly message: Schema.optional<Schema.String>;
+    readonly totalSteps: Schema.Number;
+    readonly readyCount: Schema.Number;
+    readonly warningCount: Schema.Number;
+    readonly errorCount: Schema.Number;
+    readonly appliedCount: Schema.Number;
+    readonly failedCount: Schema.Number;
+    readonly blockedCount: Schema.Number;
+    readonly steps: Schema.$Array<Schema.Struct<{
+        readonly label: Schema.String;
+        readonly status: Schema.Literals<readonly ["ready", "warning", "error", "applied", "failed", "blocked"]>;
+        readonly message: Schema.optional<Schema.String>;
+        readonly code: Schema.optional<Schema.String>;
+    }>>;
+}>;
+export type PlanResolutionResult = typeof PlanResolutionResultSchema.Type;
+export declare const toPlanResolutionResult: (resolution: PlanResolution) => PlanResolutionResult;
+export declare const emitPlanResolutionResult: <TCommand extends string>(command: TCommand, resolution: PlanResolution) => Effect.Effect<boolean, never, CliRenderer>;
+/**
+ * Convert a PlanResolution to a CommandOutcomeSummary for telemetry.
+ * Produces normalized outcome, counts, and optional subject/source context.
+ */
+export declare const planResolutionToSummary: (resolution: PlanResolution, context: {
+    readonly subjectType?: SubjectType;
+    readonly sourceKind?: SourceKind;
+}) => CommandOutcomeSummary;
+export declare const emitNoOpResult: <TCommand extends string>(command: TCommand, args: {
+    readonly planName: string;
+    readonly planDescription?: string;
+    readonly message: string;
+}) => Effect.Effect<boolean, never, CliRenderer>;
+//# sourceMappingURL=json-output.d.ts.map

package/dist/src/json-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-output.d.ts","sourceRoot":"","sources":["../../src/json-output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AACzE,OAAO,KAAK,EACV,qBAAqB,EACrB,UAAU,EACV,WAAW,EACZ,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAGV,cAAc,EAEf,MAAM,yCAAyC,CAAC;AA6BjD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;EAsBrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,0BAA0B,CAAC,IAAI,CAAC;AAiD1E,eAAO,MAAM,sBAAsB,GAAI,YAAY,cAAc,KAAG,oBA8CnE,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,QAAQ,SAAS,MAAM,EAC9D,SAAS,QAAQ,EACjB,YAAY,cAAc,+CASxB,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GAClC,YAAY,cAAc,EAC1B,SAAS;IAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAA;CAAE,KAChF,qBAUF,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,QAAQ,SAAS,MAAM,EACpD,SAAS,QAAQ,EACjB,MAAM;IACJ,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,+CAwBC,CAAC"}

package/dist/src/json-output.js

@@ -0,0 +1,171 @@
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+import { CliRenderer } from "@agentxm/client-core/unstable/cli-renderer";
+const StepStatusSchema = Schema.Literals([
+    "ready",
+    "warning",
+    "error",
+    "applied",
+    "failed",
+    "blocked",
+]).annotate({
+    identifier: "StepStatus",
+    title: "Step Status",
+    description: "Execution status of a plan step: ready, warning, error, applied, failed, or blocked.",
+});
+const StepSchema = Schema.Struct({
+    label: Schema.String,
+    status: StepStatusSchema,
+    message: Schema.optional(Schema.String),
+    code: Schema.optional(Schema.String),
+}).annotate({
+    identifier: "Step",
+    title: "Plan Step",
+    description: "A single step in a plan resolution result with label, status, and optional details.",
+});
+export const PlanResolutionResultSchema = Schema.Struct({
+    outcome: Schema.Literals(["previewed", "cancelled", "applied", "no-op"]).annotate({
+        identifier: "PlanOutcome",
+        title: "Plan Outcome",
+        description: "Final outcome of a plan resolution: previewed, cancelled, applied, or 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(StepSchema),
+}).annotate({
+    identifier: "PlanResolutionResult",
+    title: "Plan Resolution Result",
+    description: "Result of a plan resolution including outcome, step counts, and individual step details.",
+});
+const PlanResolutionDocumentFields = {
+    result: PlanResolutionResultSchema,
+};
+const plannedStepToStep = (step) => {
+    switch (step.readiness) {
+        case "ready":
+            return { label: step.label, status: "ready" };
+        case "warn":
+            return {
+                label: step.label,
+                status: "warning",
+                message: step.warnMessage,
+            };
+        case "error":
+            return {
+                label: step.label,
+                status: "error",
+                message: step.errorMessage,
+            };
+    }
+};
+const completedStepToStep = (step) => {
+    if (step.result.result === "success") {
+        return {
+            label: step.label,
+            status: "applied",
+            ...(step.result.message.length > 0 ? { message: step.result.message } : {}),
+        };
+    }
+    const code = step.result.error.code;
+    return {
+        label: step.label,
+        status: code === "PLAN_STEP_BLOCKED" ? "blocked" : "failed",
+        ...(step.result.message.length > 0 ? { message: step.result.message } : {}),
+        code,
+    };
+};
+const flattenExecutedSteps = (plan) => plan.jobs.flatMap((job) => [...job.steps]);
+const planDescription = (resolution) => Option.getOrUndefined(resolution.description);
+export const toPlanResolutionResult = (resolution) => {
+    switch (resolution._tag) {
+        case "PreviewedPlan":
+        case "CancelledPlan": {
+            const steps = resolution.jobs.flatMap((job) => [...job.steps]).map(plannedStepToStep);
+            const readyCount = steps.filter((step) => step.status === "ready").length;
+            const warningCount = steps.filter((step) => step.status === "warning").length;
+            const errorCount = steps.filter((step) => step.status === "error").length;
+            const description = planDescription(resolution);
+            return {
+                outcome: resolution._tag === "PreviewedPlan" ? "previewed" : "cancelled",
+                planName: resolution.name,
+                ...(description !== undefined ? { planDescription: description } : {}),
+                totalSteps: steps.length,
+                readyCount,
+                warningCount,
+                errorCount,
+                appliedCount: 0,
+                failedCount: 0,
+                blockedCount: 0,
+                steps,
+            };
+        }
+        case "ExecutedPlan": {
+            const steps = flattenExecutedSteps(resolution).map(completedStepToStep);
+            const appliedCount = steps.filter((step) => step.status === "applied").length;
+            const failedCount = steps.filter((step) => step.status === "failed").length;
+            const blockedCount = steps.filter((step) => step.status === "blocked").length;
+            const description = planDescription(resolution);
+            return {
+                outcome: "applied",
+                planName: resolution.name,
+                ...(description !== undefined ? { planDescription: description } : {}),
+                totalSteps: steps.length,
+                readyCount: 0,
+                warningCount: 0,
+                errorCount: 0,
+                appliedCount,
+                failedCount,
+                blockedCount,
+                steps,
+            };
+        }
+    }
+};
+export const emitPlanResolutionResult = (command, resolution) => Effect.gen(function* () {
+    const renderer = yield* CliRenderer;
+    return yield* renderer.document(command, { result: toPlanResolutionResult(resolution) }, PlanResolutionDocumentFields);
+});
+/**
+ * Convert a PlanResolution to a CommandOutcomeSummary for telemetry.
+ * Produces normalized outcome, counts, and optional subject/source context.
+ */
+export const planResolutionToSummary = (resolution, context) => {
+    const result = toPlanResolutionResult(resolution);
+    return {
+        outcome: result.outcome,
+        ...(context.subjectType !== undefined ? { subjectType: context.subjectType } : {}),
+        ...(context.sourceKind !== undefined ? { sourceKind: context.sourceKind } : {}),
+        ...(result.appliedCount > 0 ? { appliedCount: result.appliedCount } : {}),
+        ...(result.failedCount > 0 ? { failedCount: result.failedCount } : {}),
+        ...(result.blockedCount > 0 ? { blockedCount: result.blockedCount } : {}),
+    };
+};
+export const emitNoOpResult = (command, args) => Effect.gen(function* () {
+    const renderer = yield* CliRenderer;
+    return yield* renderer.document(command, {
+        result: {
+            outcome: "no-op",
+            planName: args.planName,
+            ...(args.planDescription !== undefined ? { planDescription: args.planDescription } : {}),
+            message: args.message,
+            totalSteps: 0,
+            readyCount: 0,
+            warningCount: 0,
+            errorCount: 0,
+            appliedCount: 0,
+            failedCount: 0,
+            blockedCount: 0,
+            steps: [],
+        },
+    }, PlanResolutionDocumentFields);
+});
+//# sourceMappingURL=json-output.js.map

package/dist/src/json-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-output.js","sourceRoot":"","sources":["../../src/json-output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AAazE,MAAM,gBAAgB,GAAG,MAAM,CAAC,QAAQ,CAAC;IACvC,OAAO;IACP,SAAS;IACT,OAAO;IACP,SAAS;IACT,QAAQ;IACR,SAAS;CACD,CAAC,CAAC,QAAQ,CAAC;IACnB,UAAU,EAAE,YAAY;IACxB,KAAK,EAAE,aAAa;IACpB,WAAW,EACT,sFAAsF;CACzF,CAAC,CAAC;AAEH,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM;IACpB,MAAM,EAAE,gBAAgB;IACxB,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;CACrC,CAAC,CAAC,QAAQ,CAAC;IACV,UAAU,EAAE,MAAM;IAClB,KAAK,EAAE,WAAW;IAClB,WAAW,EACT,qFAAqF;CACxF,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC,MAAM,CAAC;IACtD,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,CAAU,CAAC,CAAC,QAAQ,CAAC;QACzF,UAAU,EAAE,aAAa;QACzB,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,8EAA8E;KAC5F,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC,MAAM;IACvB,eAAe,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC,MAAM;IACzB,UAAU,EAAE,MAAM,CAAC,MAAM;IACzB,YAAY,EAAE,MAAM,CAAC,MAAM;IAC3B,UAAU,EAAE,MAAM,CAAC,MAAM;IACzB,YAAY,EAAE,MAAM,CAAC,MAAM;IAC3B,WAAW,EAAE,MAAM,CAAC,MAAM;IAC1B,YAAY,EAAE,MAAM,CAAC,MAAM;IAC3B,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC;CAChC,CAAC,CAAC,QAAQ,CAAC;IACV,UAAU,EAAE,sBAAsB;IAClC,KAAK,EAAE,wBAAwB;IAC/B,WAAW,EACT,0FAA0F;CAC7F,CAAC,CAAC;AAGH,MAAM,4BAA4B,GAAG;IACnC,MAAM,EAAE,0BAA0B;CACJ,CAAC;AAEjC,MAAM,iBAAiB,GAAG,CAAC,IAAoB,EAAQ,EAAE;IACvD,QAAQ,IAAI,CAAC,SAAS,EAAE,CAAC;QACvB,KAAK,OAAO;YACV,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAChD,KAAK,MAAM;YACT,OAAO;gBACL,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,MAAM,EAAE,SAAS;gBACjB,OAAO,EAAE,IAAI,CAAC,WAAW;aAC1B,CAAC;QACJ,KAAK,OAAO;YACV,OAAO;gBACL,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,MAAM,EAAE,OAAO;gBACf,OAAO,EAAE,IAAI,CAAC,YAAY;aAC3B,CAAC;IACN,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,CAAC,IAAsB,EAAQ,EAAE;IAC3D,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,SAAS;YACjB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5E,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;IACpC,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,IAAI,KAAK,mBAAmB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;QAC3D,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,IAAI;KACL,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,IAAkB,EAAmC,EAAE,CACnF,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAE7C,MAAM,eAAe,GAAG,CAAC,UAA0B,EAAsB,EAAE,CACzE,MAAM,CAAC,cAAc,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAEhD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,UAA0B,EAAwB,EAAE;IACzF,QAAQ,UAAU,CAAC,IAAI,EAAE,CAAC;QACxB,KAAK,eAAe,CAAC;QACrB,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;YACtF,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;YAC1E,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;YAC9E,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;YAC1E,MAAM,WAAW,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;YAEhD,OAAO;gBACL,OAAO,EAAE,UAAU,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW;gBACxE,QAAQ,EAAE,UAAU,CAAC,IAAI;gBACzB,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtE,UAAU,EAAE,KAAK,CAAC,MAAM;gBACxB,UAAU;gBACV,YAAY;gBACZ,UAAU;gBACV,YAAY,EAAE,CAAC;gBACf,WAAW,EAAE,CAAC;gBACd,YAAY,EAAE,CAAC;gBACf,KAAK;aACN,CAAC;QACJ,CAAC;QACD,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,KAAK,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;YACxE,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;YAC9E,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC;YAC5E,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;YAC9E,MAAM,WAAW,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;YAEhD,OAAO;gBACL,OAAO,EAAE,SAAS;gBAClB,QAAQ,EAAE,UAAU,CAAC,IAAI;gBACzB,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtE,UAAU,EAAE,KAAK,CAAC,MAAM;gBACxB,UAAU,EAAE,CAAC;gBACb,YAAY,EAAE,CAAC;gBACf,UAAU,EAAE,CAAC;gBACb,YAAY;gBACZ,WAAW;gBACX,YAAY;gBACZ,KAAK;aACN,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACtC,OAAiB,EACjB,UAA0B,EAC1B,EAAE,CACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,WAAW,CAAC;IACpC,OAAO,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAC7B,OAAO,EACP,EAAE,MAAM,EAAE,sBAAsB,CAAC,UAAU,CAAC,EAAE,EAC9C,4BAA4B,CAC7B,CAAC;AACJ,CAAC,CAAC,CAAC;AAEL;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,UAA0B,EAC1B,OAAiF,EAC1D,EAAE;IACzB,MAAM,MAAM,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAClD,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClF,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/E,GAAG,CAAC,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,GAAG,CAAC,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1E,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,OAAiB,EACjB,IAIC,EACD,EAAE,CACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,WAAW,CAAC;IACpC,OAAO,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAC7B,OAAO,EACP;QACE,MAAM,EAAE;YACN,OAAO,EAAE,OAAO;YAChB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,GAAG,CAAC,IAAI,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxF,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,CAAC;YACb,UAAU,EAAE,CAAC;YACb,YAAY,EAAE,CAAC;YACf,UAAU,EAAE,CAAC;YACb,YAAY,EAAE,CAAC;YACf,WAAW,EAAE,CAAC;YACd,YAAY,EAAE,CAAC;YACf,KAAK,EAAE,EAAE;SACV;KACF,EACD,4BAA4B,CAC7B,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/src/main.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/src/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/main.ts"],"names":[],"mappings":""}

package/dist/src/main.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { run } from "./app.js";
+void run();
+//# sourceMappingURL=main.js.map

package/dist/src/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,KAAK,GAAG,EAAE,CAAC"}