@agentxm/client-core 0.1.6

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

@@ -0,0 +1,98 @@
+/**
+ * Plan types for workspace operations.
+ *
+ * Uses a readiness-based model where each step carries its own `run` closure
+ * (for ready/warn steps) or an error message (for error steps). Plans and jobs
+ * are non-generic; operation-specific details are captured in step closures.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type * as Effect from "effect/Effect";
+import type * as Option from "effect/Option";
+import type { AppError } from "../app-error/index.js";
+/**
+ * Generic operation type used by all extension operation handlers.
+ * Each operation is identified by a string name and carries typed args.
+ */
+export interface Operation<TName extends string, TArgs> {
+    readonly name: TName;
+    readonly args: TArgs;
+}
+export type JobStepResult = {
+    readonly result: "success";
+    readonly message: string;
+} | {
+    readonly result: "error";
+    readonly message: string;
+    readonly error: AppError;
+};
+export interface ReadyJobStep {
+    readonly key?: string;
+    readonly readiness: "ready";
+    readonly label: string;
+    readonly run: Effect.Effect<JobStepResult, AppError, never>;
+}
+export interface WarnJobStep {
+    readonly key?: string;
+    readonly readiness: "warn";
+    readonly warnMessage: string;
+    readonly label: string;
+    readonly run: Effect.Effect<JobStepResult, AppError, never>;
+}
+export interface ErrorJobStep {
+    readonly key?: string;
+    readonly readiness: "error";
+    readonly errorMessage: string;
+    readonly label: string;
+}
+export type PlannedJobStep = ReadyJobStep | WarnJobStep | ErrorJobStep;
+export interface CompletedJobStep {
+    readonly label: string;
+    readonly result: JobStepResult;
+}
+export interface Job {
+    readonly steps: ReadonlyArray<PlannedJobStep>;
+    readonly concurrency: "unbounded" | 1;
+}
+/**
+ * An additional labeled section to display alongside a plan.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface PlanSection {
+    readonly title: string;
+    readonly items: ReadonlyArray<string>;
+}
+export interface Plan {
+    readonly _tag: "Plan";
+    readonly name: string;
+    readonly description: Option.Option<string>;
+    readonly jobs: ReadonlyArray<Job>;
+    /** Optional extra sections rendered after the plan steps. */
+    readonly sections?: ReadonlyArray<PlanSection>;
+}
+export interface ExecutedJob {
+    readonly steps: ReadonlyArray<CompletedJobStep>;
+    readonly concurrency: "unbounded" | 1;
+}
+export interface ExecutedPlan {
+    readonly _tag: "ExecutedPlan";
+    readonly name: string;
+    readonly description: Option.Option<string>;
+    readonly jobs: ReadonlyArray<ExecutedJob>;
+}
+export interface PreviewedPlan {
+    readonly _tag: "PreviewedPlan";
+    readonly name: string;
+    readonly description: Option.Option<string>;
+    readonly jobs: ReadonlyArray<Job>;
+}
+export interface CancelledPlan {
+    readonly _tag: "CancelledPlan";
+    readonly name: string;
+    readonly description: Option.Option<string>;
+    readonly jobs: ReadonlyArray<Job>;
+}
+export type PlanResolution = ExecutedPlan | PreviewedPlan | CancelledPlan;
+//# sourceMappingURL=plan.d.ts.map

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * Plan types for workspace operations.
+ *
+ * Uses a readiness-based model where each step carries its own `run` closure
+ * (for ready/warn steps) or an error message (for error steps). Plans and jobs
+ * are non-generic; operation-specific details are captured in step closures.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export {};
+//# sourceMappingURL=plan.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../../../src/unstable/workspace/plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/src/unstable/workspace/reconciliation-types.d.ts

@@ -0,0 +1,75 @@
+import type * as FileSystem from "effect/FileSystem";
+import type * as Path from "effect/Path";
+import type { AppError } from "../app-error/index.js";
+import type { ExtensionName, ExtensionTypePlural } from "../extensions/index.js";
+import type { Handle } from "../extensions/handle.js";
+import type { CommandLockEntry, McpServerLockEntry, ExtensionPackLockEntry, SkillLockEntry, SubagentLockEntry } from "../lockfile/index.js";
+import type { Settings } from "../settings/index.js";
+export type ReconcileExtensionType = Extract<ExtensionTypePlural, "skills" | "commands" | "mcp-servers" | "subagents" | "packs">;
+export type UnresolvedReason = "missing" | "invalid" | "declaration-mismatch";
+export interface ReconciliationDeclaration {
+    readonly type: ReconcileExtensionType;
+    readonly owner: Handle;
+    readonly name: ExtensionName;
+    readonly declarationSourceOrConstraint: string;
+    readonly source: string;
+    readonly order: number;
+    readonly origin: "settings" | "pack";
+}
+export interface ReconciliationContext {
+    readonly baseDir: string;
+    readonly now: Date;
+    readonly defaultProfile: Handle;
+    readonly agents: ReadonlyArray<string>;
+    readonly settings: Settings;
+}
+/**
+ * Adapter-facing runtime dependencies.
+ *
+ * The reconciliation flow resolves shared Effect services at the orchestration
+ * boundary and passes them into adapters explicitly so the adapter contract
+ * does not need to expose FileSystem/Path in its own `R` type.
+ */
+export interface AdapterEnvironment {
+    readonly fs: FileSystem.FileSystem;
+    readonly path: Path.Path;
+}
+export type ReconstructedLockEntry = {
+    readonly type: "skills";
+    readonly name: ExtensionName;
+    readonly entry: SkillLockEntry;
+} | {
+    readonly type: "commands";
+    readonly name: ExtensionName;
+    readonly entry: CommandLockEntry;
+} | {
+    readonly type: "mcp-servers";
+    readonly name: ExtensionName;
+    readonly entry: McpServerLockEntry;
+} | {
+    readonly type: "subagents";
+    readonly name: ExtensionName;
+    readonly entry: SubagentLockEntry;
+} | {
+    readonly type: "packs";
+    readonly name: ExtensionName;
+    readonly entry: ExtensionPackLockEntry;
+};
+export type DeclarationResolution = {
+    readonly _tag: "Compatible";
+    readonly reconstructed: ReconstructedLockEntry;
+} | {
+    readonly _tag: "Unresolved";
+    readonly declaration: ReconciliationDeclaration;
+    readonly reason: UnresolvedReason;
+};
+export interface DeclarationScanResult {
+    readonly declarations: ReadonlyArray<ReconciliationDeclaration>;
+    readonly warnings: ReadonlyArray<string>;
+}
+export interface ReconciliationAdapter {
+    readonly type: ReconcileExtensionType;
+    readonly scanDeclarations: (context: ReconciliationContext, env: AdapterEnvironment) => import("effect/Effect").Effect<DeclarationScanResult, AppError>;
+    readonly checkDiskCompatibility: (declaration: ReconciliationDeclaration, context: ReconciliationContext, env: AdapterEnvironment) => import("effect/Effect").Effect<DeclarationResolution, AppError>;
+}
+//# sourceMappingURL=reconciliation-types.d.ts.map

package/dist/src/unstable/workspace/reconciliation-types.d.ts.map

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

package/dist/src/unstable/workspace/reconciliation-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=reconciliation-types.js.map

package/dist/src/unstable/workspace/reconciliation-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciliation-types.js","sourceRoot":"","sources":["../../../../src/unstable/workspace/reconciliation-types.ts"],"names":[],"mappings":""}

package/dist/src/unstable/workspace/reconciliation.d.ts

@@ -0,0 +1,34 @@
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Effect from "effect/Effect";
+import { type AppError } from "../app-error/index.js";
+import type { Lockfile } from "../lockfile/index.js";
+import type { DegradedLockfileState } from "./augment-plan.js";
+import type { ReconciliationAdapter, ReconciliationContext, ReconciliationDeclaration, UnresolvedReason } from "./reconciliation-types.js";
+import type { JobStepResult } from "./plan.js";
+/**
+ * Register reconciliation adapters. Called once at CLI startup.
+ */
+export declare const setReconciliationAdapters: (adapters: ReadonlyArray<ReconciliationAdapter>) => void;
+/**
+ * Get the currently registered reconciliation adapters.
+ */
+export declare const getReconciliationAdapters: () => ReadonlyArray<ReconciliationAdapter>;
+export interface ReconciliationSnapshot {
+    readonly lockfile: Lockfile;
+    readonly unresolved: ReadonlyArray<{
+        readonly declaration: ReconciliationDeclaration;
+        readonly reason: UnresolvedReason;
+    }>;
+    readonly warnings: ReadonlyArray<string>;
+}
+export declare const dedupeDeclarations: (declarations: ReadonlyArray<ReconciliationDeclaration>) => {
+    readonly declarations: ReadonlyArray<ReconciliationDeclaration>;
+    readonly warnings: ReadonlyArray<string>;
+};
+export declare const buildReconciliationSnapshot: (context: ReconciliationContext) => Effect.Effect<ReconciliationSnapshot, AppError, FileSystem.FileSystem | Path.Path>;
+export declare const runReadRecoverOperation: (context: ReconciliationContext) => Effect.Effect<JobStepResult, AppError, FileSystem.FileSystem | Path.Path>;
+export declare const runReconcileMaterializeOperation: (context: ReconciliationContext, lockfileDir: string, lockfileState: DegradedLockfileState, options?: {
+    readonly allowMissingDeclarations?: boolean;
+}) => Effect.Effect<JobStepResult, AppError, FileSystem.FileSystem | Path.Path>;
+//# sourceMappingURL=reconciliation.d.ts.map

package/dist/src/unstable/workspace/reconciliation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciliation.d.ts","sourceRoot":"","sources":["../../../../src/unstable/workspace/reconciliation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAEpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,KAAK,EAEV,QAAQ,EAKT,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,KAAK,EAEV,qBAAqB,EACrB,qBAAqB,EACrB,yBAAyB,EAEzB,gBAAgB,EACjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAU/C;;GAEG;AACH,eAAO,MAAM,yBAAyB,GAAI,UAAU,aAAa,CAAC,qBAAqB,CAAC,KAAG,IAE1F,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,QAAO,aAAa,CAAC,qBAAqB,CAAc,CAAC;AAgB/F,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;QACjC,QAAQ,CAAC,WAAW,EAAE,yBAAyB,CAAC;QAChD,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;KACnC,CAAC,CAAC;IACH,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC1C;AA6CD,eAAO,MAAM,kBAAkB,GAC7B,cAAc,aAAa,CAAC,yBAAyB,CAAC,KACrD;IACD,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,yBAAyB,CAAC,CAAC;IAChE,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CA4C1C,CAAC;AAEF,eAAO,MAAM,2BAA2B,GACtC,SAAS,qBAAqB,KAC7B,MAAM,CAAC,MAAM,CAAC,sBAAsB,EAAE,QAAQ,EAAE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CA8ChF,CAAC;AAQL,eAAO,MAAM,uBAAuB,GAClC,SAAS,qBAAqB,KAC7B,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,QAAQ,EAAE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAWvE,CAAC;AAyBL,eAAO,MAAM,gCAAgC,GAC3C,SAAS,qBAAqB,EAC9B,aAAa,MAAM,EACnB,eAAe,qBAAqB,EACpC,UAAU;IACR,QAAQ,CAAC,wBAAwB,CAAC,EAAE,OAAO,CAAC;CAC7C,KACA,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,QAAQ,EAAE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAmDvE,CAAC"}

package/dist/src/unstable/workspace/reconciliation.js

@@ -0,0 +1,201 @@
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Array from "effect/Array";
+import * as Effect from "effect/Effect";
+import { makeAppError } from "../app-error/index.js";
+import { countLockfileEntries, LOCKFILE_NAME, writeLockfile } from "../lockfile/index.js";
+/**
+ * Mutable module-level adapters registry.
+ *
+ * Adapters are registered at startup by CLI code via `setReconciliationAdapters`.
+ * Core code uses `getReconciliationAdapters` to retrieve them.
+ */
+let _adapters = [];
+/**
+ * Register reconciliation adapters. Called once at CLI startup.
+ */
+export const setReconciliationAdapters = (adapters) => {
+    _adapters = adapters;
+};
+/**
+ * Get the currently registered reconciliation adapters.
+ */
+export const getReconciliationAdapters = () => _adapters;
+const reconcileTypeOrder = {
+    skills: 0,
+    commands: 1,
+    subagents: 2,
+    packs: 3,
+    "mcp-servers": 4,
+};
+const dedupeDeclarationKey = (declaration) => `${declaration.type}:${declaration.owner}:${declaration.name}:${declaration.declarationSourceOrConstraint}`;
+const dedupeConflictKey = (declaration) => `${declaration.type}:${declaration.owner}:${declaration.name}`;
+const mergeReconstructed = (results) => {
+    const skills = {};
+    const commands = {};
+    const subagents = {};
+    const mcpServers = {};
+    const packs = {};
+    for (const result of results) {
+        if (result._tag !== "Compatible") {
+            continue;
+        }
+        const reconstructed = result.reconstructed;
+        switch (reconstructed.type) {
+            case "skills":
+                skills[reconstructed.name] = reconstructed.entry;
+                break;
+            case "commands":
+                commands[reconstructed.name] = reconstructed.entry;
+                break;
+            case "subagents":
+                subagents[reconstructed.name] = reconstructed.entry;
+                break;
+            case "mcp-servers":
+                mcpServers[reconstructed.name] = reconstructed.entry;
+                break;
+            case "packs":
+                packs[reconstructed.name] = reconstructed.entry;
+                break;
+        }
+    }
+    return {
+        lockfileVersion: 1,
+        skills,
+        commands,
+        subagents,
+        mcpServers,
+        packs,
+    };
+};
+export const dedupeDeclarations = (declarations) => {
+    const byExactKey = new Map();
+    const byConflictKey = new Map();
+    const warnings = [];
+    const ordered = [...declarations].sort((a, b) => {
+        const byType = reconcileTypeOrder[a.type] - reconcileTypeOrder[b.type];
+        if (byType !== 0) {
+            return byType;
+        }
+        const byName = a.name.localeCompare(b.name);
+        if (byName !== 0) {
+            return byName;
+        }
+        if (a.order !== b.order) {
+            return a.order - b.order;
+        }
+        return a.declarationSourceOrConstraint.localeCompare(b.declarationSourceOrConstraint);
+    });
+    for (const declaration of ordered) {
+        const key = dedupeDeclarationKey(declaration);
+        if (byExactKey.has(key)) {
+            continue;
+        }
+        const conflictKey = dedupeConflictKey(declaration);
+        const existingConflict = byConflictKey.get(conflictKey);
+        if (existingConflict !== undefined) {
+            warnings.push(`LOCKFILE_RECONCILE_CONFLICT: ${conflictKey} (${existingConflict.declarationSourceOrConstraint} wins over ${declaration.declarationSourceOrConstraint})`);
+            continue;
+        }
+        byExactKey.set(key, declaration);
+        byConflictKey.set(conflictKey, declaration);
+    }
+    return {
+        declarations: [...byExactKey.values()],
+        warnings,
+    };
+};
+export const buildReconciliationSnapshot = (context) => Effect.gen(function* () {
+    const adapters = getReconciliationAdapters();
+    // Resolve shared services once, then pass them into each adapter as an
+    // explicit environment to keep the adapter interface narrow.
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const scanResults = yield* Effect.forEach(adapters, (adapter) => adapter.scanDeclarations(context, { fs, path }), { concurrency: "unbounded" });
+    const scannedDeclarations = Array.flatten(scanResults.map((scan) => [...scan.declarations]));
+    const scanWarnings = Array.flatten(scanResults.map((scan) => [...scan.warnings]));
+    const deduped = dedupeDeclarations(scannedDeclarations);
+    const checked = yield* Effect.forEach(deduped.declarations, (declaration) => {
+        const adapter = adapters.find((candidate) => candidate.type === declaration.type);
+        if (adapter === undefined) {
+            return Effect.fail(makeAppError({
+                code: "LOCKFILE_RECONCILE_ADAPTER_MISSING",
+                what: `No reconciliation adapter for ${declaration.type}`,
+            }));
+        }
+        return adapter.checkDiskCompatibility(declaration, context, { fs, path });
+    }, { concurrency: "unbounded" });
+    return {
+        lockfile: mergeReconstructed(checked),
+        unresolved: checked
+            .filter((result) => result._tag === "Unresolved")
+            .map((result) => ({ declaration: result.declaration, reason: result.reason })),
+        warnings: [...scanWarnings, ...deduped.warnings],
+    };
+});
+const formatUnresolved = (snapshot) => snapshot.unresolved.map(({ declaration, reason }) => `${declaration.type}:${declaration.owner}/${declaration.name} (${reason})`);
+export const runReadRecoverOperation = (context) => Effect.gen(function* () {
+    const snapshot = yield* buildReconciliationSnapshot(context);
+    const unresolvedCount = snapshot.unresolved.length;
+    const reconstructedCount = countLockfileEntries(snapshot.lockfile);
+    const suffix = unresolvedCount > 0 ? `, ${unresolvedCount} unresolved` : "";
+    return {
+        result: "success",
+        message: `Recovered ${reconstructedCount} declaration(s)${suffix}`,
+    };
+});
+const backupInvalidLockfile = (lockfilePath) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const timestamp = new Date();
+    const pad = (n) => String(n).padStart(2, "0");
+    const stamp = `${timestamp.getFullYear()}${pad(timestamp.getMonth() + 1)}${pad(timestamp.getDate())}${pad(timestamp.getHours())}${pad(timestamp.getMinutes())}${pad(timestamp.getSeconds())}`;
+    const backupPath = path.join(path.dirname(lockfilePath), `${LOCKFILE_NAME}.bak.${stamp}`);
+    yield* fs.rename(lockfilePath, backupPath).pipe(Effect.mapError((error) => makeAppError({
+        code: "LOCKFILE_BACKUP_FAILED",
+        what: `Failed to back up invalid lockfile to ${backupPath}`,
+        cause: error,
+    })));
+});
+export const runReconcileMaterializeOperation = (context, lockfileDir, lockfileState, options) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const snapshot = yield* buildReconciliationSnapshot(context);
+    const allowMissingDeclarations = options?.allowMissingDeclarations ?? false;
+    const hasUnresolved = snapshot.unresolved.length > 0;
+    const hasNonMissingUnresolved = snapshot.unresolved.some((entry) => entry.reason !== "missing");
+    if (hasUnresolved && (!allowMissingDeclarations || hasNonMissingUnresolved)) {
+        return {
+            result: "error",
+            message: "Reconciliation requires unresolved source resolution",
+            error: makeAppError({
+                code: "LOCKFILE_RECONCILE_SOURCE_UNREACHABLE",
+                what: "Required declaration sources are unreachable during reconciliation",
+                details: formatUnresolved(snapshot),
+            }),
+        };
+    }
+    const lockfilePath = path.join(lockfileDir, LOCKFILE_NAME);
+    if (lockfileState === "invalid") {
+        const exists = yield* fs.exists(lockfilePath).pipe(Effect.mapError((error) => makeAppError({
+            code: "LOCKFILE_BACKUP_FAILED",
+            what: `Failed to check invalid lockfile at ${lockfilePath}`,
+            cause: error,
+        })));
+        if (exists) {
+            yield* backupInvalidLockfile(lockfilePath);
+        }
+    }
+    yield* writeLockfile(lockfileDir, snapshot.lockfile);
+    if (hasUnresolved) {
+        return {
+            result: "success",
+            message: `Reconciled lockfile with ${snapshot.unresolved.length} missing declaration(s) deferred to install`,
+        };
+    }
+    return {
+        result: "success",
+        message: "Reconciled and materialized lockfile",
+    };
+});
+//# sourceMappingURL=reconciliation.js.map

package/dist/src/unstable/workspace/reconciliation.js.map

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

package/dist/src/unstable/workspace/resolve-plan-interaction.d.ts

@@ -0,0 +1,26 @@
+import * as FileSystem from "effect/FileSystem";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Path from "effect/Path";
+import * as ServiceMap from "effect/ServiceMap";
+import * as Terminal from "effect/Terminal";
+import type { AppError } from "../app-error/index.js";
+import type { PromptCancelled } from "../cli-prompt/prompt-cancelled.js";
+export interface ResolvePlanInteractionService {
+    readonly confirmApplyChanges: () => Effect.Effect<boolean, PromptCancelled | AppError>;
+}
+declare const ResolvePlanInteraction_base: ServiceMap.ServiceClass<ResolvePlanInteraction, "@agentxm/workspace/ResolvePlanInteraction", ResolvePlanInteractionService>;
+export declare class ResolvePlanInteraction extends ResolvePlanInteraction_base {
+}
+export declare const ResolvePlanInteractionLive: Layer.Layer<ResolvePlanInteraction, never, FileSystem.FileSystem | Path.Path | Terminal.Terminal>;
+export interface ResolvePlanInteractionTestState {
+    readonly confirmApplyChangesCalls: Array<null>;
+}
+export declare const ResolvePlanInteractionTest: (overrides?: {
+    readonly confirmApplyChanges?: () => Effect.Effect<boolean, PromptCancelled | AppError>;
+}) => {
+    layer: Layer.Layer<ResolvePlanInteraction, never, never>;
+    state: ResolvePlanInteractionTestState;
+};
+export {};
+//# sourceMappingURL=resolve-plan-interaction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-plan-interaction.d.ts","sourceRoot":"","sources":["../../../../src/unstable/workspace/resolve-plan-interaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAIzE,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,mBAAmB,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CAAC,CAAC;CACxF;;AAED,qBAAa,sBAAuB,SAAQ,2BAGI;CAAG;AAEnD,eAAO,MAAM,0BAA0B,mGAmBtC,CAAC;AAEF,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,wBAAwB,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;CAChD;AAED,eAAO,MAAM,0BAA0B,GAAI,YAAY;IACrD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CAAC,CAAC;CACzF;;;CAcA,CAAC"}

package/dist/src/unstable/workspace/resolve-plan-interaction.js

@@ -0,0 +1,35 @@
+import * as FileSystem from "effect/FileSystem";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Path from "effect/Path";
+import * as ServiceMap from "effect/ServiceMap";
+import * as Terminal from "effect/Terminal";
+import { Prompt } from "effect/unstable/cli";
+import { requireInteractive } from "../cli/prompt/index.js";
+const confirmApplyChangesMessage = "Apply changes?";
+export class ResolvePlanInteraction extends ServiceMap.Service()("@agentxm/workspace/ResolvePlanInteraction") {
+}
+export const ResolvePlanInteractionLive = Layer.effect(ResolvePlanInteraction, Effect.gen(function* () {
+    const fileSystem = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const terminal = yield* Terminal.Terminal;
+    const promptEnvironment = Layer.mergeAll(Layer.succeed(FileSystem.FileSystem, fileSystem), Layer.succeed(Path.Path, path), Layer.succeed(Terminal.Terminal, terminal));
+    return {
+        confirmApplyChanges: () => requireInteractive(Prompt.confirm({ message: confirmApplyChangesMessage }), {
+            message: confirmApplyChangesMessage,
+        }).pipe(Effect.provide(promptEnvironment)),
+    };
+}));
+export const ResolvePlanInteractionTest = (overrides) => {
+    const state = {
+        confirmApplyChangesCalls: [],
+    };
+    const layer = Layer.succeed(ResolvePlanInteraction, {
+        confirmApplyChanges: () => Effect.gen(function* () {
+            state.confirmApplyChangesCalls.push(null);
+            return yield* overrides?.confirmApplyChanges?.() ?? Effect.succeed(true);
+        }),
+    });
+    return { layer, state };
+};
+//# sourceMappingURL=resolve-plan-interaction.js.map

package/dist/src/unstable/workspace/resolve-plan-interaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-plan-interaction.js","sourceRoot":"","sources":["../../../../src/unstable/workspace/resolve-plan-interaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAG5D,MAAM,0BAA0B,GAAG,gBAAgB,CAAC;AAMpD,MAAM,OAAO,sBAAuB,SAAQ,UAAU,CAAC,OAAO,EAG3D,CAAC,2CAA2C,CAAC;CAAG;AAEnD,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,CAAC,MAAM,CACpD,sBAAsB,EACtB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IAChD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAC9B,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC1C,MAAM,iBAAiB,GAAG,KAAK,CAAC,QAAQ,CACtC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,EAChD,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAC9B,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAC3C,CAAC;IAEF,OAAO;QACL,mBAAmB,EAAE,GAAG,EAAE,CACxB,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,0BAA0B,EAAE,CAAC,EAAE;YAC1E,OAAO,EAAE,0BAA0B;SACpC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;KACL,CAAC;AAC5C,CAAC,CAAC,CACH,CAAC;AAMF,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,SAE1C,EAAE,EAAE;IACH,MAAM,KAAK,GAAoC;QAC7C,wBAAwB,EAAE,EAAE;KAC7B,CAAC;IAEF,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,sBAAsB,EAAE;QAClD,mBAAmB,EAAE,GAAG,EAAE,CACxB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClB,KAAK,CAAC,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1C,OAAO,KAAK,CAAC,CAAC,SAAS,EAAE,mBAAmB,EAAE,EAAE,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3E,CAAC,CAAC;KACmC,CAAC,CAAC;IAE3C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC,CAAC"}

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

@@ -0,0 +1,45 @@
+/**
+ * Plan preview/apply function.
+ *
+ * Orchestrates `augmentPlanWithReconciliation`, `scanPlanReadiness`,
+ * and `applyPlan` with `displayPlan` and interactive prompts.
+ *
+ * This is a free function, not a method on the WorkspaceContextService.
+ *
+ * @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 Option from "effect/Option";
+import { CliRenderer } from "../cli-renderer/index.js";
+import type { AppError } from "../app-error/index.js";
+import type { ExecutedPlan, Plan } from "./plan.js";
+import { Workspace } from "./service-interface.js";
+/**
+ * Preview or apply (display, confirm, and execute) a plan using the workspace context.
+ *
+ * Steps:
+ * 1. Augment plan with lockfile reconciliation if needed
+ * 2. Scan for errors/warnings
+ * 3. Handle errors (block unless --force) and warnings (display)
+ * 4. Preview if requested (with confirmation unless --yes)
+ * 5. Apply and display results
+ */
+export declare const previewOrApplyPlan: (plan: Plan, flags: {
+    yes: boolean;
+    force: boolean;
+    preview: boolean;
+    blockedByErrorsHowToFix?: string;
+}) => Effect.Effect<ExecutedPlan | {
+    _tag: "PreviewedPlan";
+    name: string;
+    description: Option.Option<string>;
+    jobs: readonly import("./plan.js").Job[];
+} | {
+    _tag: "CancelledPlan";
+    name: string;
+    description: Option.Option<string>;
+    jobs: readonly import("./plan.js").Job[];
+}, AppError | import("../cli-prompt/prompt-cancelled.ts").PromptCancelled, FileSystem.FileSystem | Path.Path | Workspace | "effect/unstable/cli/GlobalFlag/axm-non-interactive" | import("../cli-flags/verbosity.ts").Verbosity | CliRenderer>;
+//# sourceMappingURL=resolve-plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-plan.d.ts","sourceRoot":"","sources":["../../../../src/unstable/workspace/resolve-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAMtD,OAAO,KAAK,EAAiB,YAAY,EAAE,IAAI,EAAiB,MAAM,WAAW,CAAC;AAClF,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAwBnD;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB;SAGtB,OAAO;WACL,OAAO;aACL,OAAO;8BACU,MAAM;;;;;;;;;;;8OAuGlC,CAAC"}