@axm.sh/cli 0.0.1

package/dist/src/utils/create-symlink.js

@@ -0,0 +1,86 @@
+import * as nodePath from "node:path";
+import * as FileSystem from "@effect/platform/FileSystem";
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { resolveParentSymlinks } from "./resolve-parent-symlinks.js";
+/**
+ * Typed error for symlink creation failures.
+ * Callers can catch this to fall back to copy mode.
+ */
+export class SymlinkError extends Data.TaggedError("SymlinkError") {
+}
+/**
+ * Creates a relative symlink from `link` to `target`, handling the full
+ * symlink lifecycle: self-reference detection, existing link inspection,
+ * ELOOP recovery, directory replacement, and parent directory creation.
+ *
+ * Relative paths are computed using resolved parent directories to handle
+ * cases where parent directories are themselves symlinks.
+ */
+export const createSymlink = (opts) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    // Resolve both paths through parent symlinks for accurate comparison
+    const resolvedTarget = yield* resolveParentSymlinks(opts.target).pipe(Effect.mapError((e) => new SymlinkError({ message: `Failed to resolve target path`, cause: e })));
+    const resolvedLink = yield* resolveParentSymlinks(opts.link).pipe(
+    // Link parent may not exist yet — fall back to the raw path
+    Effect.catchAll(() => Effect.succeed(opts.link)));
+    // Self-reference detection: skip if both resolve to the same location
+    if (resolvedTarget === resolvedLink) {
+        return "skipped";
+    }
+    // Compute relative path from resolved parent dirs
+    const resolvedLinkParent = nodePath.dirname(resolvedLink);
+    const relTarget = nodePath.relative(resolvedLinkParent, resolvedTarget);
+    // Check what currently exists at the link path
+    const existingResult = yield* inspectExisting(fs, opts.link, resolvedTarget);
+    if (existingResult === "no-op")
+        return "no-op";
+    // If something exists that needs replacing, remove it
+    if (existingResult === "replace") {
+        yield* fs.remove(opts.link, { recursive: true }).pipe(Effect.mapError((e) => new SymlinkError({
+            message: `Failed to remove existing path at ${opts.link}`,
+            cause: e,
+        })));
+    }
+    // Create parent directories
+    const linkParent = nodePath.dirname(opts.link);
+    yield* fs.makeDirectory(linkParent, { recursive: true }).pipe(Effect.mapError((e) => new SymlinkError({
+        message: `Failed to create parent directory ${linkParent}`,
+        cause: e,
+    })));
+    // Create the symlink
+    yield* fs
+        .symlink(relTarget, opts.link)
+        .pipe(Effect.mapError((e) => new SymlinkError({ message: `Failed to create symlink at ${opts.link}`, cause: e })));
+    return existingResult === "replace" ? "replaced" : "created";
+});
+/**
+ * Inspect what exists at the link path.
+ *
+ * Uses readLink to detect symlinks (since Effect's FileSystem.stat always
+ * follows symlinks — there is no lstat equivalent). Falls back to stat
+ * for non-symlink entries.
+ */
+const inspectExisting = (fs, linkPath, resolvedAbsTarget) => Effect.gen(function* () {
+    // Try readLink first — succeeds only if linkPath is a symlink
+    const linkTarget = yield* fs.readLink(linkPath).pipe(Effect.option);
+    if (Option.isSome(linkTarget)) {
+        // It's a symlink — check if it points to the correct target
+        const linkParent = nodePath.dirname(linkPath);
+        const currentAbsTarget = nodePath.resolve(linkParent, linkTarget.value);
+        // Resolve through realpath for cases where parent dirs are symlinks
+        const resolvedCurrentTarget = yield* fs
+            .realPath(currentAbsTarget)
+            .pipe(Effect.catchAll(() => Effect.succeed(currentAbsTarget)));
+        if (resolvedCurrentTarget === resolvedAbsTarget)
+            return "no-op";
+        return "replace";
+    }
+    // Not a symlink — check if anything else exists (directory, file)
+    const stat = yield* fs.stat(linkPath).pipe(Effect.option);
+    if (Option.isSome(stat))
+        return "replace";
+    return "create";
+});
+//# sourceMappingURL=create-symlink.js.map

package/dist/src/utils/create-symlink.js.map

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

package/dist/src/utils/errors.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Error formatting utilities for CLI handlers.
+ *
+ * Provides consistent error message formatting with what happened,
+ * optional details, and optional recovery guidance.
+ */
+/**
+ * Formats an error message with what happened and how to fix.
+ *
+ * Output format:
+ * ```
+ * X Could not find configuration file
+ *   Looked for: .axm/settings.json
+ *   Run 'axm init' to create one.
+ * ```
+ *
+ * @param what - What went wrong (the error message)
+ * @param details - Optional array of detail lines (context, what was tried, etc.)
+ * @param howToFix - Optional recovery guidance
+ * @returns Formatted error string
+ *
+ * @example
+ * formatError("Could not find configuration file")
+ * // => "X Could not find configuration file"
+ *
+ * @example
+ * formatError(
+ *   "Could not find configuration file",
+ *   ["Looked for: .axm/settings.json"],
+ *   "Run 'axm init' to create one."
+ * )
+ * // => "X Could not find configuration file\n  Looked for: .axm/settings.json\n  Run 'axm init' to create one."
+ */
+export declare function formatError(what: string, details?: ReadonlyArray<string>, howToFix?: string): string;
+/**
+ * Formats an error for when extension resolution returns no results.
+ *
+ * Provides guidance on valid input formats for extension resolution.
+ *
+ * @param input - The input string that failed to resolve
+ * @returns Formatted error string with format suggestions
+ *
+ * @example
+ * formatEmptyResolutionError("my-skill")
+ * // => "✗ Could not resolve \"my-skill\"\n  No matching extensions found\n  Try one of these formats:..."
+ */
+export declare function formatEmptyResolutionError(input: string): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,EAC/B,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAmBR;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAYhE"}

package/dist/src/utils/errors.js

@@ -0,0 +1,71 @@
+/**
+ * Error formatting utilities for CLI handlers.
+ *
+ * Provides consistent error message formatting with what happened,
+ * optional details, and optional recovery guidance.
+ */
+/**
+ * Formats an error message with what happened and how to fix.
+ *
+ * Output format:
+ * ```
+ * X Could not find configuration file
+ *   Looked for: .axm/settings.json
+ *   Run 'axm init' to create one.
+ * ```
+ *
+ * @param what - What went wrong (the error message)
+ * @param details - Optional array of detail lines (context, what was tried, etc.)
+ * @param howToFix - Optional recovery guidance
+ * @returns Formatted error string
+ *
+ * @example
+ * formatError("Could not find configuration file")
+ * // => "X Could not find configuration file"
+ *
+ * @example
+ * formatError(
+ *   "Could not find configuration file",
+ *   ["Looked for: .axm/settings.json"],
+ *   "Run 'axm init' to create one."
+ * )
+ * // => "X Could not find configuration file\n  Looked for: .axm/settings.json\n  Run 'axm init' to create one."
+ */
+export function formatError(what, details, howToFix) {
+    const lines = [];
+    // Main error line with X marker
+    lines.push(`\u2717 ${what}`);
+    // Add details (indented)
+    if (details && details.length > 0) {
+        for (const detail of details) {
+            lines.push(`  ${detail}`);
+        }
+    }
+    // Add recovery guidance (indented)
+    if (howToFix) {
+        lines.push(`  ${howToFix}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Formats an error for when extension resolution returns no results.
+ *
+ * Provides guidance on valid input formats for extension resolution.
+ *
+ * @param input - The input string that failed to resolve
+ * @returns Formatted error string with format suggestions
+ *
+ * @example
+ * formatEmptyResolutionError("my-skill")
+ * // => "✗ Could not resolve \"my-skill\"\n  No matching extensions found\n  Try one of these formats:..."
+ */
+export function formatEmptyResolutionError(input) {
+    return formatError(`Could not resolve "${input}"`, ["No matching extensions found"], [
+        "Try one of these formats:",
+        "  • Local path: ./path/to/skill or /absolute/path",
+        "  • GitHub: github:owner/repo or owner/repo",
+        "  • GitLab: gitlab:owner/repo",
+        "  • AXM name: @scope/name (if installed)",
+    ].join("\n"));
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,WAAW,CACzB,IAAY,EACZ,OAA+B,EAC/B,QAAiB;IAEjB,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,gCAAgC;IAChC,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;IAE7B,yBAAyB;IACzB,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,mCAAmC;IACnC,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,0BAA0B,CAAC,KAAa;IACtD,OAAO,WAAW,CAChB,sBAAsB,KAAK,GAAG,EAC9B,CAAC,8BAA8B,CAAC,EAChC;QACE,2BAA2B;QAC3B,mDAAmD;QACnD,6CAA6C;QAC7C,+BAA+B;QAC/B,0CAA0C;KAC3C,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;AACJ,CAAC"}

package/dist/src/utils/index.d.ts

@@ -0,0 +1,7 @@
+export { computeChecksum } from "./checksum.js";
+export { formatEmptyResolutionError, formatError } from "./errors.js";
+export { isPathSafe } from "./path-safety.js";
+export { resolveParentSymlinks } from "./resolve-parent-symlinks.js";
+export { createSymlink, SymlinkError, type SymlinkResult } from "./create-symlink.js";
+export { isInteractive } from "./tty.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,0BAA0B,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}

package/dist/src/utils/index.js

@@ -0,0 +1,7 @@
+export { computeChecksum } from "./checksum.js";
+export { formatEmptyResolutionError, formatError } from "./errors.js";
+export { isPathSafe } from "./path-safety.js";
+export { resolveParentSymlinks } from "./resolve-parent-symlinks.js";
+export { createSymlink, SymlinkError } from "./create-symlink.js";
+export { isInteractive } from "./tty.js";
+//# sourceMappingURL=index.js.map

package/dist/src/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,0BAA0B,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAsB,MAAM,qBAAqB,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}

package/dist/src/utils/path-safety.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Validates that a resolved target path stays within a base directory.
+ * Uses path separator boundary check to prevent prefix false positives.
+ */
+export declare function isPathSafe(base: string, target: string): boolean;
+//# sourceMappingURL=path-safety.d.ts.map

package/dist/src/utils/path-safety.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-safety.d.ts","sourceRoot":"","sources":["../../../src/utils/path-safety.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAIhE"}

package/dist/src/utils/path-safety.js

@@ -0,0 +1,11 @@
+import * as path from "node:path";
+/**
+ * Validates that a resolved target path stays within a base directory.
+ * Uses path separator boundary check to prevent prefix false positives.
+ */
+export function isPathSafe(base, target) {
+    const resolvedBase = path.resolve(base);
+    const resolvedTarget = path.resolve(target);
+    return resolvedTarget === resolvedBase || resolvedTarget.startsWith(resolvedBase + path.sep);
+}
+//# sourceMappingURL=path-safety.js.map

package/dist/src/utils/path-safety.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-safety.js","sourceRoot":"","sources":["../../../src/utils/path-safety.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,MAAc;IACrD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,OAAO,cAAc,KAAK,YAAY,IAAI,cAAc,CAAC,UAAU,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/F,CAAC"}

package/dist/src/utils/resolve-parent-symlinks.d.ts

@@ -0,0 +1,12 @@
+import type { PlatformError } from "@effect/platform/Error";
+import * as FileSystem from "@effect/platform/FileSystem";
+import * as Effect from "effect/Effect";
+/**
+ * Resolves the parent directory of a path through symlinks while
+ * preserving the final path component (basename).
+ *
+ * Needed for computing correct relative symlink paths when parent
+ * directories may themselves be symlinks.
+ */
+export declare const resolveParentSymlinks: (filePath: string) => Effect.Effect<string, PlatformError, FileSystem.FileSystem>;
+//# sourceMappingURL=resolve-parent-symlinks.d.ts.map

package/dist/src/utils/resolve-parent-symlinks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-parent-symlinks.d.ts","sourceRoot":"","sources":["../../../src/utils/resolve-parent-symlinks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,UAAU,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAChC,UAAU,MAAM,KACf,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,CAAC,UAAU,CAOzD,CAAC"}

package/dist/src/utils/resolve-parent-symlinks.js

@@ -0,0 +1,18 @@
+import * as nodePath from "node:path";
+import * as FileSystem from "@effect/platform/FileSystem";
+import * as Effect from "effect/Effect";
+/**
+ * Resolves the parent directory of a path through symlinks while
+ * preserving the final path component (basename).
+ *
+ * Needed for computing correct relative symlink paths when parent
+ * directories may themselves be symlinks.
+ */
+export const resolveParentSymlinks = (filePath) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const parent = nodePath.dirname(filePath);
+    const basename = nodePath.basename(filePath);
+    const resolvedParent = yield* fs.realPath(parent);
+    return nodePath.join(resolvedParent, basename);
+});
+//# sourceMappingURL=resolve-parent-symlinks.js.map

package/dist/src/utils/resolve-parent-symlinks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-parent-symlinks.js","sourceRoot":"","sources":["../../../src/utils/resolve-parent-symlinks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,WAAW,CAAC;AAEtC,OAAO,KAAK,UAAU,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,QAAgB,EAC6C,EAAE,CAC/D,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IACxC,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC7C,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAClD,OAAO,QAAQ,CAAC,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;AACjD,CAAC,CAAC,CAAC"}

package/dist/src/utils/tty.d.ts

@@ -0,0 +1,12 @@
+/**
+ * TTY detection utilities for CLI handlers.
+ */
+/**
+ * Returns true if stdin is a TTY, meaning the user can provide
+ * interactive input (respond to prompts, make selections, etc.).
+ *
+ * Use this before calling interactive prompt functions.
+ * When false and --yes/--non-interactive is not set, fail with a helpful error.
+ */
+export declare function isInteractive(): boolean;
+//# sourceMappingURL=tty.d.ts.map

package/dist/src/utils/tty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tty.d.ts","sourceRoot":"","sources":["../../../src/utils/tty.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC"}

package/dist/src/utils/tty.js

@@ -0,0 +1,14 @@
+/**
+ * TTY detection utilities for CLI handlers.
+ */
+/**
+ * Returns true if stdin is a TTY, meaning the user can provide
+ * interactive input (respond to prompts, make selections, etc.).
+ *
+ * Use this before calling interactive prompt functions.
+ * When false and --yes/--non-interactive is not set, fail with a helpful error.
+ */
+export function isInteractive() {
+    return process.stdin.isTTY === true;
+}
+//# sourceMappingURL=tty.js.map

package/dist/src/utils/tty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tty.js","sourceRoot":"","sources":["../../../src/utils/tty.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC;AACtC,CAAC"}

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

@@ -0,0 +1,55 @@
+/**
+ * Shared plan apply module.
+ *
+ * Iterates over plan jobs and their steps, dispatching each step expected
+ * to succeed to the matching executor from a typed registry keyed by `name`.
+ * Non-success steps are promoted with expectedResult as actualResult.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import type { Operation, OperationResult, Plan } from "./plan.js";
+declare const OperationError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "OperationError";
+} & Readonly<A>;
+/**
+ * Yielded by handlers for hard failures — applyPlan catches and converts to error result.
+ */
+export declare class OperationError extends OperationError_base<{
+    readonly operation: string;
+    readonly message: string;
+    readonly cause: unknown;
+}> {
+}
+/**
+ * Handler function for a specific operation type.
+ */
+export type OperationHandler<Op, R = never> = (op: Op) => Effect.Effect<OperationResult, OperationError, R>;
+/**
+ * Executor registry — a handler for every `name` in the operation union.
+ * TypeScript enforces exhaustiveness at compile time.
+ *
+ * R is left as a free parameter so concrete registries can carry requirements
+ * (e.g. FileSystem, Log). `ExecutionContext` extracts R from the concrete type.
+ */
+export type Handlers<Op extends Operation<string, unknown>> = {
+    [K in Op["name"]]: (op: Extract<Op, {
+        name: K;
+    }>) => Effect.Effect<OperationResult, OperationError, any>;
+};
+/**
+ * Extract the union of R (requirements) from all handler functions in the registry.
+ */
+export type ExecutionContext<T> = {
+    [K in keyof T]: T[K] extends (...args: any[]) => Effect.Effect<OperationResult, OperationError, infer R> ? R : never;
+}[keyof T];
+/**
+ * Apply a plan by iterating jobs and dispatching steps expected to succeed to the executor registry.
+ *
+ * Uses `Effect.forEach` with each job's `concurrency` setting.
+ * Only dispatches steps with `expectedResult.result === "success"` — others are promoted with expectedResult as actualResult.
+ * Never fails — catches OperationError and converts to error results.
+ */
+export declare const applyPlan: <Op extends Operation<string, unknown>, T extends Handlers<Op>>(plan: Plan<Op>, handlers: T) => Effect.Effect<Plan<Op>, never, ExecutionContext<T>>;
+export {};
+//# sourceMappingURL=apply-plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apply-plan.d.ts","sourceRoot":"","sources":["../../../src/workspace/apply-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAiB,SAAS,EAAE,eAAe,EAAE,IAAI,EAAkB,MAAM,WAAW,CAAC;;;;AAMjG;;GAEG;AACH,qBAAa,cAAe,SAAQ,oBAAmC;IACrE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;CAAG;AAEL;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,IAAI,CAC5C,EAAE,EAAE,EAAE,KACH,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,CAAC,EAAE,SAAS,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;KAC3D,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,GAAG,CACjB,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,KAEzB,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,cAAc,EAAE,GAAG,CAAC;CACzD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI;KAC/B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAE3B,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC,GACxD,CAAC,GACD,KAAK;CACV,CAAC,MAAM,CAAC,CAAC,CAAC;AAiCX;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,EAAE,SAAS,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,QAAQ,CAAC,EAAE,CAAC,EACrF,MAAM,IAAI,CAAC,EAAE,CAAC,EACd,UAAU,CAAC,KACV,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAiBlD,CAAC"}

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

@@ -0,0 +1,55 @@
+/**
+ * Shared plan apply module.
+ *
+ * Iterates over plan jobs and their steps, dispatching each step expected
+ * to succeed to the matching executor from a typed registry keyed by `name`.
+ * Non-success steps are promoted with expectedResult as actualResult.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Array from "effect/Array";
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+// -----------------------------------------------------------------------------
+// Types
+// -----------------------------------------------------------------------------
+/**
+ * Yielded by handlers for hard failures — applyPlan catches and converts to error result.
+ */
+export class OperationError extends Data.TaggedError("OperationError") {
+}
+// -----------------------------------------------------------------------------
+// Implementation
+// -----------------------------------------------------------------------------
+const applyStep = (step, handlers) => {
+    const promote = (actualResult) => ({
+        _tag: "JobStepResult",
+        operation: step.operation,
+        expectedResult: step.expectedResult,
+        actualResult,
+        label: step.label,
+    });
+    if (step.expectedResult.result !== "success") {
+        return Effect.succeed(promote(step.expectedResult));
+    }
+    // Cast needed: TS can't correlate dynamic name lookup with the Extract<Op, {name: K}> parameter
+    const handler = handlers[step.operation.name];
+    return handler(step.operation).pipe(Effect.map(promote), Effect.catchTag("OperationError", (error) => Effect.succeed(promote({ result: "error", message: error.message }))));
+};
+/**
+ * Apply a plan by iterating jobs and dispatching steps expected to succeed to the executor registry.
+ *
+ * Uses `Effect.forEach` with each job's `concurrency` setting.
+ * Only dispatches steps with `expectedResult.result === "success"` — others are promoted with expectedResult as actualResult.
+ * Never fails — catches OperationError and converts to error results.
+ */
+export const applyPlan = (plan, handlers) => Effect.map(Effect.forEach(plan.jobs, (job) => Effect.forEach(job.steps, (step) => applyStep(step, handlers), {
+    concurrency: job.concurrency,
+}), { concurrency: 1 }), (jobResults) => ({
+    ...plan,
+    jobs: Array.map(jobResults, (steps, i) => ({
+        ...plan.jobs[i],
+        steps,
+    })),
+}));
+//# sourceMappingURL=apply-plan.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apply-plan.js","sourceRoot":"","sources":["../../../src/workspace/apply-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAInE;CAAG;AAmCL,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF,MAAM,SAAS,GAAG,CAChB,IAAwB,EACxB,QAAW,EACmD,EAAE;IAChE,MAAM,OAAO,GAAG,CAAC,YAA6B,EAAqB,EAAE,CAAC,CAAC;QACrE,IAAI,EAAE,eAAe;QACrB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,YAAY;QACZ,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC,CAAC;IAEH,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC7C,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;IACtD,CAAC;IACD,gGAAgG;IAChG,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAkB,CAEc,CAAC;IACzE,OAAO,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CACjC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EACnB,MAAM,CAAC,QAAQ,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,EAAE,CAC1C,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAgB,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAC9E,CACF,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,IAAc,EACd,QAAW,EAC0C,EAAE,CACvD,MAAM,CAAC,GAAG,CACR,MAAM,CAAC,OAAO,CACZ,IAAI,CAAC,IAAI,EACT,CAAC,GAAG,EAAE,EAAE,CACN,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAA0B,EAAE,QAAQ,CAAC,EAAE;IACnF,WAAW,EAAE,GAAG,CAAC,WAAW;CAC7B,CAAC,EACJ,EAAE,WAAW,EAAE,CAAC,EAAE,CACnB,EACD,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACf,GAAG,IAAI;IACP,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACzC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAE;QAChB,KAAK;KACN,CAAC,CAAC;CACJ,CAAC,CACH,CAAC"}

package/dist/src/workspace/display-plan.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Shared plan display module.
+ *
+ * Renders a human-readable summary of any Plan<Op> via the Log service,
+ * without knowledge of the specific operation type.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import { Log } from "../tui/index.js";
+import type { Plan } from "./plan.js";
+/**
+ * Display a plan summary via the Log service.
+ *
+ * Uses `step.label` for human-readable output — never inspects `step.operation`.
+ */
+export declare const displayPlan: <Op>(plan: Plan<Op>) => Effect.Effect<void, never, Log>;
+//# sourceMappingURL=display-plan.d.ts.map

package/dist/src/workspace/display-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-plan.d.ts","sourceRoot":"","sources":["../../../src/workspace/display-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACtC,OAAO,KAAK,EAA4B,IAAI,EAAE,MAAM,WAAW,CAAC;AAMhE;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,EAAE,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC,oCAwD1C,CAAC"}

package/dist/src/workspace/display-plan.js

@@ -0,0 +1,69 @@
+/**
+ * Shared plan display module.
+ *
+ * Renders a human-readable summary of any Plan<Op> via the Log service,
+ * without knowledge of the specific operation type.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Array from "effect/Array";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { Log } from "../tui/index.js";
+// -----------------------------------------------------------------------------
+// Implementation
+// -----------------------------------------------------------------------------
+/**
+ * Display a plan summary via the Log service.
+ *
+ * Uses `step.label` for human-readable output — never inspects `step.operation`.
+ */
+export const displayPlan = (plan) => Effect.gen(function* () {
+    const log = yield* Log;
+    const allSteps = Array.flatMap(plan.jobs, (job) => [...job.steps]);
+    // Extract the relevant result based on step phase
+    const getResult = (step) => step._tag === "JobStepResult" ? step.actualResult : step.expectedResult;
+    const isApplied = allSteps.length > 0 && allSteps[0]._tag === "JobStepResult";
+    const successSteps = Array.filter(allSteps, (s) => getResult(s).result === "success");
+    const noopSteps = Array.filter(allSteps, (s) => getResult(s).result === "no-op");
+    const errorSteps = Array.filter(allSteps, (s) => getResult(s).result === "error");
+    // Heading
+    const heading = Option.match(plan.description, {
+        onNone: () => plan.name,
+        onSome: (desc) => `${plan.name}\n${desc}`,
+    });
+    yield* log.info(heading);
+    // Success items
+    if (successSteps.length > 0) {
+        for (const step of successSteps) {
+            if (isApplied) {
+                yield* log.success(`  ✓ ${step.label}`);
+            }
+            else {
+                yield* log.success(`  + ${step.label}`);
+            }
+        }
+    }
+    // No-op items
+    if (noopSteps.length > 0) {
+        for (const step of noopSteps) {
+            yield* log.warn(`  - ${step.label} (${getResult(step).message})`);
+        }
+    }
+    // Error items
+    if (errorSteps.length > 0) {
+        for (const step of errorSteps) {
+            yield* log.error(`  ✗ ${step.label} (${getResult(step).message})`);
+        }
+    }
+    // Summary with phase-appropriate tense
+    const successCount = successSteps.length;
+    const skipCount = noopSteps.length;
+    if (isApplied) {
+        yield* log.message(`${successCount} installed, ${skipCount} skipped`);
+    }
+    else {
+        yield* log.message(`${successCount} to install, ${skipCount} to skip`);
+    }
+});
+//# sourceMappingURL=display-plan.js.map

package/dist/src/workspace/display-plan.js.map

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

package/dist/src/workspace/ensure-agents.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Shared utility for resolving agents from CLI flags or settings.
+ *
+ * Validates agent IDs against the registry, prompts to add unconfigured agents
+ * to the workspace, and fails if no agents result.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import { type AgentDescriptor } from "../agents/index.js";
+import { Confirm, Log } from "../tui/index.js";
+import { Workspace } from "./service.js";
+declare const EnsureAgentsError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "EnsureAgentsError";
+} & Readonly<A>;
+/**
+ * Error when no agents are configured or resolved.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare class EnsureAgentsError extends EnsureAgentsError_base<{
+    readonly message: string;
+}> {
+}
+/**
+ * Options for ensureAgentsConfigured.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface EnsureAgentsOptions {
+    /** Agent IDs from --agent CLI flag */
+    readonly agentFlags: readonly string[];
+    /** Skip confirmation prompts */
+    readonly yes: boolean;
+    /** Disable all prompts */
+    readonly nonInteractive: boolean;
+}
+/**
+ * Resolve agents from CLI flags or settings.
+ *
+ * When `--agent` flags are provided:
+ * 1. Validates each ID against the agent registry, warns about unknown IDs
+ * 2. Checks which valid agents are not yet in settings
+ * 3. Prompts to add unconfigured agents (or auto-adds with --yes/--non-interactive)
+ * 4. Returns resolved AgentDescriptor[]
+ *
+ * When no flags are provided:
+ * 1. Reads agents from settings
+ * 2. Resolves to AgentDescriptor[]
+ *
+ * Fails with EnsureAgentsError if no agents result.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const ensureAgentsConfigured: (opts: EnsureAgentsOptions) => Effect.Effect<AgentDescriptor[], import("../settings/settings.js").SettingsError | EnsureAgentsError, Confirm | Log | Workspace>;
+export {};
+//# sourceMappingURL=ensure-agents.d.ts.map

package/dist/src/workspace/ensure-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-agents.d.ts","sourceRoot":"","sources":["../../../src/workspace/ensure-agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,KAAK,eAAe,EAAgB,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;;;;AAOzC;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,uBAAsC;IAC3E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;CAAG;AAML;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,gCAAgC;IAChC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,0BAA0B;IAC1B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,sBAAsB,GAAI,MAAM,mBAAmB,qIAkE5D,CAAC"}