@agentxm/client-core 0.1.6

package/dist/src/unstable/version-resolution/version-resolution.js

@@ -0,0 +1,159 @@
+/**
+ * Version resolution logic for CLI self-upgrade.
+ *
+ * Fetches the latest CLI version from GitHub Releases, strips the `cli-v`
+ * prefix, and compares it against the local version using semver.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+import * as HttpClient from "effect/unstable/http/HttpClient";
+import * as semver from "semver";
+import { makeAppError } from "../app-error/index.js";
+// -----------------------------------------------------------------------------
+// Constants
+// -----------------------------------------------------------------------------
+const CLI_TAG_PREFIX = "cli-v";
+/** Default GitHub repository for CLI releases. */
+export const DEFAULT_GITHUB_REPO = "agentxm/axm";
+// -----------------------------------------------------------------------------
+// Schemas
+// -----------------------------------------------------------------------------
+/** Minimal GitHub release shape needed for version resolution. */
+const GitHubReleaseSchema = Schema.Struct({ tag_name: Schema.String });
+const GitHubReleaseArraySchema = Schema.Array(GitHubReleaseSchema);
+const decodeRelease = Schema.decodeUnknownEffect(GitHubReleaseSchema);
+const decodeReleaseArray = Schema.decodeUnknownEffect(GitHubReleaseArraySchema);
+// -----------------------------------------------------------------------------
+// Helpers
+// -----------------------------------------------------------------------------
+/**
+ * Strip the `cli-v` prefix from a tag name, returning `Option.none()` if the
+ * prefix is missing.
+ */
+const stripCliPrefix = (tagName) => tagName.startsWith(CLI_TAG_PREFIX)
+    ? Option.some(tagName.slice(CLI_TAG_PREFIX.length))
+    : Option.none();
+/**
+ * Fetch a JSON response from the GitHub API, mapping transport errors to
+ * `AppError`. Returns the parsed JSON value.
+ */
+const fetchGitHubJson = (httpClient, url) => Effect.gen(function* () {
+    const response = yield* httpClient
+        .get(url, {
+        headers: {
+            Accept: "application/vnd.github+json",
+            "User-Agent": "axm-cli",
+        },
+    })
+        .pipe(Effect.mapError((cause) => makeAppError({
+        code: "VERSION_RESOLUTION_NETWORK_ERROR",
+        what: "Failed to reach GitHub API",
+        details: [`URL: ${url}`],
+        howToFix: "Check your network connection and try again.",
+        cause,
+    })));
+    if (response.status !== 200) {
+        return yield* makeAppError({
+            code: "VERSION_RESOLUTION_GITHUB_ERROR",
+            what: `GitHub API returned status ${String(response.status)}`,
+            details: [`URL: ${url}`],
+            howToFix: "Check your network connection and try again. If the problem persists, GitHub may be experiencing issues.",
+        });
+    }
+    return yield* response.json.pipe(Effect.mapError((cause) => makeAppError({
+        code: "VERSION_RESOLUTION_INVALID_RESPONSE",
+        what: "Failed to parse GitHub API response as JSON",
+        details: [`URL: ${url}`],
+        howToFix: "This may indicate a GitHub API change. Please try again or report the issue.",
+        cause,
+    })));
+});
+/**
+ * Map schema decode errors to `AppError`.
+ */
+const mapDecodeError = (url) => Effect.mapError((cause) => makeAppError({
+    code: "VERSION_RESOLUTION_INVALID_RESPONSE",
+    what: "GitHub API returned an unexpected response shape",
+    details: [`URL: ${url}`],
+    howToFix: "This may indicate a GitHub API change. Please try again or report the issue.",
+    cause,
+}));
+/**
+ * Fetch the latest release from `GET /repos/{repo}/releases/latest`.
+ */
+const fetchLatestRelease = (httpClient, repo) => {
+    const url = `https://api.github.com/repos/${repo}/releases/latest`;
+    return Effect.flatMap(fetchGitHubJson(httpClient, url), (json) => decodeRelease(json).pipe(mapDecodeError(url)));
+};
+/**
+ * Fetch the list of releases from `GET /repos/{repo}/releases`.
+ */
+const fetchReleases = (httpClient, repo) => {
+    const url = `https://api.github.com/repos/${repo}/releases`;
+    return Effect.flatMap(fetchGitHubJson(httpClient, url), (json) => decodeReleaseArray(json).pipe(mapDecodeError(url)));
+};
+/**
+ * Resolve the latest CLI version from GitHub Releases.
+ *
+ * 1. Try `releases/latest` — if its tag starts with `cli-v`, strip and use it.
+ * 2. Otherwise, list releases and find the first with a `cli-v` prefix.
+ * 3. If no CLI release is found, fail.
+ */
+const resolveRemoteVersion = (httpClient, repo) => Effect.gen(function* () {
+    const release = yield* fetchLatestRelease(httpClient, repo);
+    const version = stripCliPrefix(release.tag_name);
+    if (Option.isSome(version)) {
+        return version.value;
+    }
+    // Latest release is not a CLI release — fall back to listing
+    const releases = yield* fetchReleases(httpClient, repo);
+    for (const r of releases) {
+        const v = stripCliPrefix(r.tag_name);
+        if (Option.isSome(v)) {
+            return v.value;
+        }
+    }
+    return yield* makeAppError({
+        code: "VERSION_RESOLUTION_NO_CLI_RELEASE",
+        what: "No CLI release found on GitHub",
+        details: [`Repository: ${repo}`],
+        howToFix: "Ensure the repository has at least one release tagged with the 'cli-v' prefix.",
+    });
+});
+/**
+ * Compare local and remote versions.
+ *
+ * - If `localVersion` is `"unknown"`, treat as always stale.
+ * - Otherwise, use semver comparison.
+ */
+const compareVersions = (localVersion, remoteVersion) => {
+    if (localVersion === "unknown")
+        return true;
+    const local = semver.valid(localVersion);
+    const remote = semver.valid(remoteVersion);
+    if (local === null || remote === null)
+        return true;
+    return semver.lt(local, remote);
+};
+// -----------------------------------------------------------------------------
+// Public API
+// -----------------------------------------------------------------------------
+/**
+ * Resolve the latest CLI version from GitHub Releases and compare it against
+ * the local version.
+ *
+ * @param httpClient - HTTP client for GitHub API requests
+ * @param localVersion - current CLI version (e.g. from `__AXM_VERSION__` or `package.json`)
+ * @param repo - GitHub `owner/repo` (defaults to `agentxm/axm`; callers may
+ *   read `AXM_INSTALL_GITHUB_REPO` from `Config` at the boundary)
+ */
+export const resolveLatestVersion = (httpClient, localVersion, repo = DEFAULT_GITHUB_REPO) => Effect.gen(function* () {
+    const remoteVersion = yield* resolveRemoteVersion(httpClient, repo);
+    const isStale = compareVersions(localVersion, remoteVersion);
+    return { remoteVersion, localVersion, isStale };
+});
+//# sourceMappingURL=version-resolution.js.map

package/dist/src/unstable/version-resolution/version-resolution.js.map

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

package/dist/src/unstable/workflows/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Workflow orchestration for extension management commands.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export { buildInstallCommandPlan, type InstallExtensionCommandWorkflowActions, runInstallCommandWorkflow, } from "./install-command/workflow.js";
+export { type UninstallExtensionCommandWorkflowActions, runUninstallCommandWorkflow, } from "./uninstall-command/workflow.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/unstable/workflows/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/unstable/workflows/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,uBAAuB,EACvB,KAAK,sCAAsC,EAC3C,yBAAyB,GAC1B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,KAAK,wCAAwC,EAC7C,2BAA2B,GAC5B,MAAM,iCAAiC,CAAC"}

package/dist/src/unstable/workflows/index.js

@@ -0,0 +1,9 @@
+/**
+ * Workflow orchestration for extension management commands.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export { buildInstallCommandPlan, runInstallCommandWorkflow, } from "./install-command/workflow.js";
+export { runUninstallCommandWorkflow, } from "./uninstall-command/workflow.js";
+//# sourceMappingURL=index.js.map

package/dist/src/unstable/workflows/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/unstable/workflows/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,uBAAuB,EAEvB,yBAAyB,GAC1B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAEL,2BAA2B,GAC5B,MAAM,iCAAiC,CAAC"}

package/dist/src/unstable/workflows/install-command/workflow.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Shared install command workflow orchestration.
+ *
+ * Defines the `InstallExtensionCommandWorkflowActions` interface and
+ * `runInstallCommandWorkflow` function shared by all install command handlers.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import type { AppError } from "../../app-error/index.js";
+import type { PromptCancelled } from "../../cli-prompt/prompt-cancelled.js";
+import type { Plan, PlanResolution } from "../../workspace/plan.js";
+/**
+ * Type-specific actions for install command workflows.
+ *
+ * Each extension type provides its own implementation of these actions.
+ * The generic type parameters allow full type safety per extension type.
+ *
+ * @typeParam Args - Raw command arguments from the active CLI parser
+ * @typeParam Parsed - Parsed/validated arguments
+ * @typeParam Req - Source request type (for resolution)
+ * @typeParam Ref - Extension ref type (discovery output)
+ * @typeParam Intent - Command-specific install intent
+ */
+export interface InstallExtensionCommandWorkflowActions<Args, Parsed, Req, Ref, Intent> {
+    readonly parseArgs: (args: Args) => Effect.Effect<Parsed, AppError>;
+    readonly resolveSourceRequests: (parsed: Parsed) => Effect.Effect<ReadonlyArray<Req>, AppError | PromptCancelled>;
+    readonly discoverRefs: (reqs: ReadonlyArray<Req>) => Effect.Effect<ReadonlyArray<Ref>, AppError>;
+    readonly finalizeIntent: (parsed: Parsed, refs: ReadonlyArray<Ref>) => Effect.Effect<Intent, AppError | PromptCancelled>;
+    readonly buildPlan: (intent: Intent) => Effect.Effect<Plan, AppError>;
+}
+/**
+ * Run the canonical install command workflow.
+ *
+ * Executes phases in order: parse -> resolveSource -> discover ->
+ * finalizeIntent -> buildPlan -> previewOrApplyPlan.
+ */
+export declare const buildInstallCommandPlan: <Args, Parsed, Req, Ref, Intent>(args: Args, actions: InstallExtensionCommandWorkflowActions<Args, Parsed, Req, Ref, Intent>) => Effect.Effect<Plan, AppError | PromptCancelled, never>;
+/**
+ * Run the canonical install command workflow.
+ *
+ * Executes phases in order: parse -> resolveSource -> discover ->
+ * finalizeIntent -> buildPlan -> previewOrApplyPlan.
+ */
+export declare const runInstallCommandWorkflow: <Args, Parsed, Req, Ref, Intent>(args: Args, actions: InstallExtensionCommandWorkflowActions<Args, Parsed, Req, Ref, Intent>, flags: {
+    yes: boolean;
+    force: boolean;
+    preview: boolean;
+}) => Effect.Effect<PlanResolution, AppError | PromptCancelled, import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("../../workspace/service-interface.ts").Workspace | "effect/unstable/cli/GlobalFlag/axm-non-interactive" | import("../../cli-flags/verbosity.ts").Verbosity | import("../../cli-renderer/cli-renderer.ts").CliRenderer>;
+//# sourceMappingURL=workflow.d.ts.map

package/dist/src/unstable/workflows/install-command/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/workflows/install-command/workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAOpE;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,sCAAsC,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM;IACpF,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACpE,QAAQ,CAAC,qBAAqB,EAAE,CAC9B,MAAM,EAAE,MAAM,KACX,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,QAAQ,GAAG,eAAe,CAAC,CAAC;IACnE,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;IACjG,QAAQ,CAAC,cAAc,EAAE,CACvB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,KACrB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,eAAe,CAAC,CAAC;IACvD,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;CACvE;AAMD;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAAI,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EACpE,MAAM,IAAI,EACV,SAAS,sCAAsC,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,2DAQ7E,CAAC;AAEL;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GAAI,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EACtE,MAAM,IAAI,EACV,SAAS,sCAAsC,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,EAC/E,OAAO;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,mWAKM,CAAC"}

package/dist/src/unstable/workflows/install-command/workflow.js

@@ -0,0 +1,37 @@
+/**
+ * Shared install command workflow orchestration.
+ *
+ * Defines the `InstallExtensionCommandWorkflowActions` interface and
+ * `runInstallCommandWorkflow` function shared by all install command handlers.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import { previewOrApplyPlan } from "../../workspace/resolve-plan.js";
+// -----------------------------------------------------------------------------
+// Install Command Workflow
+// -----------------------------------------------------------------------------
+/**
+ * Run the canonical install command workflow.
+ *
+ * Executes phases in order: parse -> resolveSource -> discover ->
+ * finalizeIntent -> buildPlan -> previewOrApplyPlan.
+ */
+export const buildInstallCommandPlan = (args, actions) => Effect.gen(function* () {
+    const parsed = yield* actions.parseArgs(args);
+    const sourceRequests = yield* actions.resolveSourceRequests(parsed);
+    const refs = yield* actions.discoverRefs(sourceRequests);
+    const intent = yield* actions.finalizeIntent(parsed, refs);
+    return yield* actions.buildPlan(intent);
+});
+/**
+ * Run the canonical install command workflow.
+ *
+ * Executes phases in order: parse -> resolveSource -> discover ->
+ * finalizeIntent -> buildPlan -> previewOrApplyPlan.
+ */
+export const runInstallCommandWorkflow = (args, actions, flags) => Effect.gen(function* () {
+    const plan = yield* buildInstallCommandPlan(args, actions);
+    return yield* previewOrApplyPlan(plan, flags);
+}).pipe(Effect.map((resolution) => resolution));
+//# sourceMappingURL=workflow.js.map

package/dist/src/unstable/workflows/install-command/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../../../../src/unstable/workflows/install-command/workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AA+BrE,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,IAAU,EACV,OAA+E,EAC/E,EAAE,CACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC3D,OAAO,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC,CAAC,CAAC;AAEL;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,IAAU,EACV,OAA+E,EAC/E,KAAyD,EACzD,EAAE,CACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,uBAAuB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3D,OAAO,KAAK,CAAC,CAAC,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,UAAU,EAAkB,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC"}

package/dist/src/unstable/workflows/uninstall-command/workflow.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Shared uninstall command workflow orchestration.
+ *
+ * Defines the `UninstallExtensionCommandWorkflowActions` interface and
+ * `runUninstallCommandWorkflow` function shared by all uninstall command handlers.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import type { AppError } from "../../app-error/index.js";
+import type { Plan, PlanResolution } from "../../workspace/plan.js";
+/**
+ * Type-specific actions for uninstall command workflows.
+ *
+ * Each extension type provides its own implementation of these actions.
+ * The generic type parameters allow full type safety per extension type.
+ *
+ * @typeParam Args - Raw command arguments from the active CLI parser
+ * @typeParam Parsed - Parsed/validated arguments
+ * @typeParam Intent - Command-specific uninstall intent
+ */
+export interface UninstallExtensionCommandWorkflowActions<Args, Parsed, Intent> {
+    readonly parseArgs: (args: Args) => Effect.Effect<Parsed, AppError>;
+    readonly finalizeIntent: (parsed: Parsed) => Effect.Effect<Intent, AppError>;
+    readonly buildUninstallPlan: (intent: Intent) => Effect.Effect<Plan, AppError>;
+}
+/**
+ * Run the canonical uninstall command workflow.
+ *
+ * Executes phases in order: parse -> finalizeIntent -> buildUninstallPlan ->
+ * previewOrApplyPlan.
+ */
+export declare const runUninstallCommandWorkflow: <Args, Parsed, Intent>(args: Args, actions: UninstallExtensionCommandWorkflowActions<Args, Parsed, Intent>, flags: {
+    yes: boolean;
+    force: boolean;
+    preview: boolean;
+}) => Effect.Effect<PlanResolution, AppError | import("../../cli-prompt/prompt-cancelled.ts").PromptCancelled, import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("../../workspace/service-interface.ts").Workspace | "effect/unstable/cli/GlobalFlag/axm-non-interactive" | import("../../cli-flags/verbosity.ts").Verbosity | import("../../cli-renderer/cli-renderer.ts").CliRenderer>;
+//# sourceMappingURL=workflow.d.ts.map

package/dist/src/unstable/workflows/uninstall-command/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/workflows/uninstall-command/workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAOpE;;;;;;;;;GASG;AACH,MAAM,WAAW,wCAAwC,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM;IAC5E,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACpE,QAAQ,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC7E,QAAQ,CAAC,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;CAChF;AAMD;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,GAAI,IAAI,EAAE,MAAM,EAAE,MAAM,EAC9D,MAAM,IAAI,EACV,SAAS,wCAAwC,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EACvE,OAAO;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,kZAOM,CAAC"}

package/dist/src/unstable/workflows/uninstall-command/workflow.js

@@ -0,0 +1,26 @@
+/**
+ * Shared uninstall command workflow orchestration.
+ *
+ * Defines the `UninstallExtensionCommandWorkflowActions` interface and
+ * `runUninstallCommandWorkflow` function shared by all uninstall command handlers.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import { previewOrApplyPlan } from "../../workspace/resolve-plan.js";
+// -----------------------------------------------------------------------------
+// Uninstall Command Workflow
+// -----------------------------------------------------------------------------
+/**
+ * Run the canonical uninstall command workflow.
+ *
+ * Executes phases in order: parse -> finalizeIntent -> buildUninstallPlan ->
+ * previewOrApplyPlan.
+ */
+export const runUninstallCommandWorkflow = (args, actions, flags) => Effect.gen(function* () {
+    const parsed = yield* actions.parseArgs(args);
+    const intent = yield* actions.finalizeIntent(parsed);
+    const plan = yield* actions.buildUninstallPlan(intent);
+    return yield* previewOrApplyPlan(plan, flags);
+}).pipe(Effect.map((resolution) => resolution));
+//# sourceMappingURL=workflow.js.map

package/dist/src/unstable/workflows/uninstall-command/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../../../../src/unstable/workflows/uninstall-command/workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAsBrE,gFAAgF;AAChF,6BAA6B;AAC7B,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CACzC,IAAU,EACV,OAAuE,EACvE,KAAyD,EACzD,EAAE,CACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACvD,OAAO,KAAK,CAAC,CAAC,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,UAAU,EAAkB,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC"}

package/dist/src/unstable/workspace/apply-plan.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Shared plan apply module.
+ *
+ * Iterates over plan jobs and their steps, executing `step.run()` for
+ * ready/warn steps and promoting error steps to error results without
+ * execution. Preserves inter-job blocking and intra-job continuation.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import { type AppError } from "../app-error/index.js";
+import type { ExecutedPlan, JobStepResult, Plan } from "./plan.js";
+/**
+ * Type for operation handler functions that take an operation and return
+ * an Effect producing a JobStepResult.
+ */
+export type OperationHandler<Op, R = never> = (op: Op) => Effect.Effect<JobStepResult, AppError, R>;
+/**
+ * Apply a plan by iterating jobs and executing step run closures.
+ *
+ * Ready and warn steps are executed via `step.run()`; error steps are
+ * promoted to error results. Inter-job blocking: if any step in job N
+ * produces an error result, subsequent jobs are blocked. Intra-job
+ * continuation: sibling steps in the same job continue executing.
+ *
+ * Never fails — catches AppError and converts to error results.
+ */
+export declare const applyPlan: (plan: Plan) => Effect.Effect<ExecutedPlan, never, never>;
+//# sourceMappingURL=apply-plan.d.ts.map

package/dist/src/unstable/workspace/apply-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-plan.d.ts","sourceRoot":"","sources":["../../../../src/unstable/workspace/apply-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,KAAK,EAEV,YAAY,EACZ,aAAa,EACb,IAAI,EAEL,MAAM,WAAW,CAAC;AAMnB;;;GAGG;AACH,MAAM,MAAM,gBAAgB,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;AAyDpG;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,IAAI,KAAG,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,EAAE,KAAK,CA8B9B,CAAC"}

package/dist/src/unstable/workspace/apply-plan.js

@@ -0,0 +1,91 @@
+/**
+ * Shared plan apply module.
+ *
+ * Iterates over plan jobs and their steps, executing `step.run()` for
+ * ready/warn steps and promoting error steps to error results without
+ * execution. Preserves inter-job blocking and intra-job continuation.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Array from "effect/Array";
+import * as Effect from "effect/Effect";
+import { makeAppError } from "../app-error/index.js";
+// -----------------------------------------------------------------------------
+// Implementation
+// -----------------------------------------------------------------------------
+const executeStep = (step) => {
+    switch (step.readiness) {
+        case "error":
+            return Effect.succeed({
+                label: step.label,
+                result: {
+                    result: "error",
+                    message: step.errorMessage,
+                    error: makeAppError({
+                        code: "PLAN_STEP_ERROR",
+                        what: step.errorMessage,
+                    }),
+                },
+            });
+        case "ready":
+        case "warn":
+            return step.run.pipe(Effect.map((result) => ({
+                label: step.label,
+                result,
+            })), Effect.catch((error) => {
+                const detailSuffix = error.details.length > 0 ? ` | ${error.details.join(" | ")}` : "";
+                return Effect.succeed({
+                    label: step.label,
+                    result: {
+                        result: "error",
+                        message: `${error.what} (${error.code})${detailSuffix}`,
+                        error,
+                    },
+                });
+            }));
+    }
+};
+const blockStep = (step) => ({
+    label: step.label,
+    result: {
+        result: "error",
+        message: "blocked by earlier job failure",
+        error: makeAppError({
+            code: "PLAN_STEP_BLOCKED",
+            what: "blocked by earlier job failure",
+        }),
+    },
+});
+/**
+ * Apply a plan by iterating jobs and executing step run closures.
+ *
+ * Ready and warn steps are executed via `step.run()`; error steps are
+ * promoted to error results. Inter-job blocking: if any step in job N
+ * produces an error result, subsequent jobs are blocked. Intra-job
+ * continuation: sibling steps in the same job continue executing.
+ *
+ * Never fails — catches AppError and converts to error results.
+ */
+export const applyPlan = (plan) => Effect.gen(function* () {
+    let blocked = false;
+    const jobResults = yield* Effect.forEach(plan.jobs, (job) => blocked
+        ? Effect.succeed(job.steps.map((step) => blockStep(step)))
+        : Effect.forEach(job.steps, (step) => executeStep(step), {
+            concurrency: job.concurrency,
+        }).pipe(Effect.tap((steps) => {
+            if (steps.some((step) => step.result.result === "error")) {
+                blocked = true;
+            }
+            return Effect.void;
+        })), { concurrency: 1 });
+    return {
+        _tag: "ExecutedPlan",
+        name: plan.name,
+        description: plan.description,
+        jobs: Array.map(jobResults, (steps, i) => ({
+            concurrency: plan.jobs[i]?.concurrency ?? 1,
+            steps,
+        })),
+    };
+}).pipe(Effect.withSpan("Workspace.applyPlan"));
+//# sourceMappingURL=apply-plan.js.map

package/dist/src/unstable/workspace/apply-plan.js.map

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

package/dist/src/unstable/workspace/augment-plan.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Augment a plan with lockfile reconciliation steps.
+ *
+ * Pure business logic: detects lockfile state and prepends recovery steps
+ * when the lockfile is missing or invalid. Returns an augmented result
+ * with reconciliation metadata, leaving CLI rendering to the caller.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { type AppError } from "../app-error/index.js";
+import type { Settings } from "../settings/index.js";
+import type { Plan } from "./plan.js";
+/** Lockfile health state used for reconciliation decisions. */
+export type LockfileState = "ok" | "missing" | "invalid";
+export type DegradedLockfileState = Exclude<LockfileState, "ok">;
+export interface AugmentedPlanResult {
+    readonly plan: Plan;
+    readonly reconciliationTriggered: boolean;
+    readonly reason?: DegradedLockfileState;
+}
+/**
+ * Augment a plan with lockfile reconciliation steps when the lockfile is
+ * missing or invalid. Returns the plan unchanged when lockfile is ok.
+ *
+ * The caller is responsible for CLI-specific behavior (e.g., warning
+ * the user when lockfile is invalid).
+ */
+export declare const augmentPlanWithReconciliation: (plan: Plan, getLockfileState: () => Effect.Effect<LockfileState, AppError>, baseDir: string, workspaceDir: string, readSettingsSafe: (dir: string) => Effect.Effect<Settings, AppError>, fsLayer: Layer.Layer<FileSystem.FileSystem | Path.Path>) => Effect.Effect<AugmentedPlanResult, AppError>;
+//# sourceMappingURL=augment-plan.d.ts.map

package/dist/src/unstable/workspace/augment-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"augment-plan.d.ts","sourceRoot":"","sources":["../../../../src/unstable/workspace/augment-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,IAAI,EAAkB,MAAM,WAAW,CAAC;AAQtD,+DAA+D;AAC/D,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,CAAC;AAEzD,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;AAEjE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,uBAAuB,EAAE,OAAO,CAAC;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;CACzC;AAMD;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,GACxC,MAAM,IAAI,EACV,kBAAkB,MAAM,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,QAAQ,CAAC,EAC9D,SAAS,MAAM,EACf,cAAc,MAAM,EACpB,kBAAkB,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,EACpE,SAAS,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,KACtD,MAAM,CAAC,MAAM,CAAC,mBAAmB,EAAE,QAAQ,CAiD1C,CAAC"}

package/dist/src/unstable/workspace/augment-plan.js

@@ -0,0 +1,71 @@
+/**
+ * Augment a plan with lockfile reconciliation steps.
+ *
+ * Pure business logic: detects lockfile state and prepends recovery steps
+ * when the lockfile is missing or invalid. Returns an augmented result
+ * with reconciliation metadata, leaving CLI rendering to the caller.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { DEFAULT_PROFILE } from "../settings/index.js";
+import {} from "../app-error/index.js";
+import { runReadRecoverOperation, runReconcileMaterializeOperation } from "./reconciliation.js";
+// -----------------------------------------------------------------------------
+// Implementation
+// -----------------------------------------------------------------------------
+/**
+ * Augment a plan with lockfile reconciliation steps when the lockfile is
+ * missing or invalid. Returns the plan unchanged when lockfile is ok.
+ *
+ * The caller is responsible for CLI-specific behavior (e.g., warning
+ * the user when lockfile is invalid).
+ */
+export const augmentPlanWithReconciliation = (plan, getLockfileState, baseDir, workspaceDir, readSettingsSafe, fsLayer) => Effect.gen(function* () {
+    const lockfileState = yield* getLockfileState();
+    if (lockfileState === "ok") {
+        return {
+            plan,
+            reconciliationTriggered: false,
+        };
+    }
+    const reason = lockfileState;
+    const settings = yield* readSettingsSafe(workspaceDir);
+    const reconciliationContext = {
+        baseDir,
+        now: new Date(),
+        defaultProfile: settings.profile ?? DEFAULT_PROFILE,
+        agents: settings.agents ?? [],
+        settings,
+    };
+    const readRecoverStep = {
+        readiness: "ready",
+        label: `Recover lockfile (${reason})`,
+        run: runReadRecoverOperation(reconciliationContext).pipe(Effect.provide(fsLayer)),
+    };
+    const materializeStep = {
+        readiness: "ready",
+        label: `Reconcile lockfile (${reason})`,
+        run: runReconcileMaterializeOperation(reconciliationContext, workspaceDir, reason, {
+            allowMissingDeclarations: true,
+        }).pipe(Effect.provide(fsLayer)),
+    };
+    return {
+        plan: {
+            ...plan,
+            jobs: [
+                {
+                    concurrency: 1,
+                    steps: [readRecoverStep, materializeStep],
+                },
+                ...plan.jobs,
+            ],
+        },
+        reconciliationTriggered: true,
+        reason,
+    };
+});
+//# sourceMappingURL=augment-plan.js.map

package/dist/src/unstable/workspace/augment-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"augment-plan.js","sourceRoot":"","sources":["../../../../src/unstable/workspace/augment-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAiB,MAAM,uBAAuB,CAAC;AAItD,OAAO,EAAE,uBAAuB,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AAiBhG,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAC3C,IAAU,EACV,gBAA8D,EAC9D,OAAe,EACf,YAAoB,EACpB,gBAAoE,EACpE,OAAuD,EACT,EAAE,CAChD,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,aAAa,GAAG,KAAK,CAAC,CAAC,gBAAgB,EAAE,CAAC;IAEhD,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO;YACL,IAAI;YACJ,uBAAuB,EAAE,KAAK;SAC/B,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAA0B,aAAa,CAAC;IACpD,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;IACvD,MAAM,qBAAqB,GAA0B;QACnD,OAAO;QACP,GAAG,EAAE,IAAI,IAAI,EAAE;QACf,cAAc,EAAE,QAAQ,CAAC,OAAO,IAAI,eAAe;QACnD,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,EAAE;QAC7B,QAAQ;KACT,CAAC;IAEF,MAAM,eAAe,GAAmB;QACtC,SAAS,EAAE,OAAO;QAClB,KAAK,EAAE,qBAAqB,MAAM,GAAG;QACrC,GAAG,EAAE,uBAAuB,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;KAClF,CAAC;IAEF,MAAM,eAAe,GAAmB;QACtC,SAAS,EAAE,OAAO;QAClB,KAAK,EAAE,uBAAuB,MAAM,GAAG;QACvC,GAAG,EAAE,gCAAgC,CAAC,qBAAqB,EAAE,YAAY,EAAE,MAAM,EAAE;YACjF,wBAAwB,EAAE,IAAI;SAC/B,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;KACjC,CAAC;IAEF,OAAO;QACL,IAAI,EAAE;YACJ,GAAG,IAAI;YACP,IAAI,EAAE;gBACJ;oBACE,WAAW,EAAE,CAAU;oBACvB,KAAK,EAAE,CAAC,eAAe,EAAE,eAAe,CAAC;iBAC1C;gBACD,GAAG,IAAI,CAAC,IAAI;aACb;SACF;QACD,uBAAuB,EAAE,IAAI;QAC7B,MAAM;KACP,CAAC;AACJ,CAAC,CAAC,CAAC"}