@agentxm/extension-lifecycle 0.29.2 → 0.30.1

package/dist/src/subagents/operations/enable.js

@@ -64,9 +64,7 @@ export const enableSubagent = (op) => Effect.gen(function* () {
         });
     }
     const baseDir = ws.baseDir;
-    const subagentSrcPath = canonical.value.ref.refType === "registry" || canonical.value.ref.refType === "workspace"
-        ? path.join(canonical.value.observation.path, "src")
-        : canonical.value.observation.path;
+    const subagentSrcPath = path.join(canonical.value.observation.path, "src");
     // Read and parse the subagent content file
     const expectedFilename = subagentContentFilename(op.args.subagentName);
     const contentPath = subagentContentPath(path.join, subagentSrcPath, op.args.subagentName);

package/dist/src/subagents/uninstall/plan.js

@@ -9,13 +9,14 @@
  */
 import * as Effect from "effect/Effect";
 import * as Option from "effect/Option";
-import { NO_MATERIALIZATION_OBSERVATION, SubagentManager, buildUninstallOperation, } from "@agentxm/extension-materialization";
+import { NO_MATERIALIZATION_OBSERVATION, SubagentManager, } from "@agentxm/extension-materialization";
+import { buildUninstallOperation } from "@agentxm/workspace-reconciliation";
 import { parseExtensionFqnParts } from "@agentxm/extension-model/unstable/extensions";
 import { WorkspaceMutations, acquiredExtensionDisplayPathFromLockEntry, } from "@agentxm/workspace-state";
 import { expandGlob } from "../../glob.js";
 import { lifecycleStepFailure } from "../../step-failure.js";
 import { installRefused } from "../../install/vocabulary.js";
-import { makeWorkspaceRetentionPolicy } from "../../uninstall/retention-policy.js";
+import { makeWorkspaceRetentionPolicy } from "@agentxm/workspace-reconciliation";
 import { workspaceCanonicalPath, workspaceCanonicalRoot, workspaceLockfilePath, workspaceSettingsPath, } from "../../workspace-paths.js";
 const resolvedVersion = (entry) => entry !== undefined && entry.type === "registry" ? entry.resolvedVersion : undefined;
 const subagentSourceTarget = (args) => args.lockEntry === undefined
@@ -77,7 +78,7 @@ export const parseSubagentUninstallRequest = Effect.fn("UninstallExtensions.pars
 export const planSubagentUninstall = Effect.fn("UninstallExtensions.planSubagents")(function* (intent) {
     const ws = yield* WorkspaceMutations;
     const subagentManager = yield* SubagentManager;
-    const retentionPolicy = makeWorkspaceRetentionPolicy(ws);
+    const retentionPolicy = makeWorkspaceRetentionPolicy(ws, lifecycleStepFailure);
     // The accepted resolution names the package the removal retires, and the
     // removal deletes it, so it is read before the step runs.
     const steps = yield* Effect.forEach(intent.targets, (target) => Effect.gen(function* () {

package/dist/src/testing.d.ts

@@ -99,7 +99,7 @@ export declare const makeLifecycleFixture: (options?: LifecycleFixtureOptions) =
         readonly type: "skill" | "subagent";
         readonly offered: ReadonlyArray<string>;
     }>;
-    provide: <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E | import("@agentxm/workspace-state").WorkspaceMutationsError, import("effect/FileSystem").FileSystem | import("effect/Path").Path | Exclude<R, StepFailureConversion | import("@agentxm/workspace-state").WorkspaceMutations | import("@agentxm/workspace-transactions").WorkspaceTransactionScope | import("@agentxm/workspace-projection").CodingAgentRepository | import("@agentxm/agent-integration").NativeWriteAuthority | import("@agentxm/workspace-state").ConfiguredAgentOutcomesProvider | import("@agentxm/extension-materialization").ExtensionManagers | import("@agentxm/workspace-transactions").FootprintRecorder | HttpClient.HttpClient | import("@agentxm/workspace-operations").OperationJournal | import("@agentxm/extension-materialization").McpSecretStore | ReleaseAgePosture | import("@agentxm/workspace-operations").ResolvePlanInteraction | SourceHostProviders | import("@agentxm/extension-materialization").SubagentManager | import("@agentxm/extension-sources").WorkspaceCatalog | import("@agentxm/extension-materialization").HookManager | import("@agentxm/extension-materialization").KnowledgeManager | import("@agentxm/extension-materialization").RuleManager | import("@agentxm/extension-materialization").SkillManager | import("@agentxm/extension-materialization").McpServerManager | import("@agentxm/extension-materialization").PackManager | ExtensionSelectionInteraction | BundledAxmSkillAsset | AgentExecutableResolver | import("@agentxm/workspace-state/live").WorkspaceStateServices | import("@agentxm/workspace-projection").ProjectionParticipants | import("@agentxm/workspace-projection").WorkspaceInvariantFacts>>;
+    provide: <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E | import("@agentxm/workspace-state").WorkspaceMutationsError, import("effect/FileSystem").FileSystem | import("effect/Path").Path | Exclude<R, StepFailureConversion | import("@agentxm/workspace-state").WorkspaceMutations | import("@agentxm/workspace-transactions").WorkspaceTransactionScope | import("@agentxm/workspace-projection").CodingAgentRepository | import("@agentxm/agent-integration").NativeWriteAuthority | HttpClient.HttpClient | import("@agentxm/workspace-state").ConfiguredAgentOutcomesProvider | import("@agentxm/extension-materialization").ExtensionManagers | import("@agentxm/extension-materialization").HookManager | import("@agentxm/extension-materialization").SkillManager | import("@agentxm/extension-materialization").RuleManager | import("@agentxm/extension-materialization").KnowledgeManager | import("@agentxm/extension-materialization").PackManager | import("@agentxm/extension-materialization").McpServerManager | import("@agentxm/workspace-transactions").FootprintRecorder | import("@agentxm/workspace-operations").OperationJournal | import("@agentxm/extension-materialization").McpSecretStore | ReleaseAgePosture | import("@agentxm/workspace-operations").ResolvePlanInteraction | SourceHostProviders | import("@agentxm/extension-materialization").SubagentManager | import("@agentxm/extension-sources").WorkspaceCatalog | import("@agentxm/workspace-projection").WorkspaceInvariantFacts | ExtensionSelectionInteraction | BundledAxmSkillAsset | AgentExecutableResolver | import("@agentxm/workspace-state/live").WorkspaceStateServices | import("@agentxm/workspace-projection").ProjectionParticipants>>;
     cleanup: () => void;
 };
 export type LifecycleFixture = ReturnType<typeof makeLifecycleFixture>;

package/dist/src/testing.js

@@ -21,7 +21,8 @@ import * as HttpClient from "effect/unstable/http/HttpClient";
 import { AgentExecutableResolver } from "@agentxm/agent-integration";
 import { decodeAbsolutePathSync } from "@agentxm/extension-model/unstable/path-types";
 import { ExtensionManagersLive, HookManagerLive, KnowledgeManagerLive, McpSecretStoreLive, McpServerManagerLive, PackManagerLive, ProjectionParticipantsLive, RuleManagerLive, SkillManagerLive, SubagentManagerLive, } from "@agentxm/extension-materialization/live";
-import { ReleaseAgePosture, decideNamedRegistryVersion, makeAxmSkillCompatibilityPolicyLayer, namedRegistryCandidates, resolveVersionEntryWithReleaseAge, } from "@agentxm/extension-resolution";
+import { ReleaseAgePosture, decideNamedRegistryVersion, namedRegistryCandidates, resolveVersionEntryWithReleaseAge, } from "@agentxm/extension-resolution";
+import { makeAxmSkillCompatibilityPolicyLayer } from "@agentxm/cli-maintenance/official-skill/composition";
 import { AxmSkillCandidateGateLive } from "@agentxm/extension-resolution/live";
 import { RegistryResolutionPolicy, SourceHostProviders } from "@agentxm/extension-sources";
 import { SourceHostProvidersLive } from "@agentxm/extension-sources/live";

package/dist/src/uninstall/root-intent.d.ts

@@ -1,7 +1,7 @@
 import * as Effect from "effect/Effect";
 import type { ExtensionLifecycleFailed } from "../errors.js";
 import { type InstallableExtensionType } from "@agentxm/extension-model/unstable/extensions/installable-types";
-export declare const rootUninstallableTypeSegments: readonly ("knowledge" | "rules" | "hooks" | "mcps" | "skills" | "subagents" | "packs")[];
+export declare const rootUninstallableTypeSegments: readonly ("knowledge" | "rules" | "hooks" | "skills" | "subagents" | "packs" | "mcps")[];
 export type RootUninstallableType = InstallableExtensionType;
 export interface RootUninstallIntent {
     readonly source: string;

package/dist/src/uninstall/uninstall-extensions.d.ts

@@ -13,7 +13,7 @@ import * as Effect from "effect/Effect";
 import * as Option from "effect/Option";
 import type { InstallableExtensionType } from "@agentxm/extension-model/unstable/extensions/installable-types";
 import { type ExecutionCandidate, type OperationResolution, type PlanExecution } from "@agentxm/workspace-operations";
-import type { ExtensionLifecycleFailed } from "../errors.js";
+import { ExtensionLifecycleFailed } from "../errors.js";
 import { type PackUninstallRequirements } from "../packs/uninstall/plan.js";
 import type { InstallExecutionFailure, PrepareInstallRequirements } from "../install/vocabulary.js";
 /** One uninstall request, whatever command spelling produced it. */

package/dist/src/uninstall/uninstall-extensions.js

@@ -11,7 +11,10 @@
  */
 import * as Effect from "effect/Effect";
 import * as Option from "effect/Option";
+import { proposeDesiredState, prepareUninstallArtifact, collectCleanupStep, buildReconciliationClosure, } from "@agentxm/workspace-reconciliation";
+import { lifecycleStepFailure } from "../step-failure.js";
 import { operationPresentation, prepareExecutionCandidate, resolveExecutionCandidate, } from "@agentxm/workspace-operations";
+import { ExtensionLifecycleFailed } from "../errors.js";
 import { parseHookUninstallRequest, planHookUninstall } from "../hooks/uninstall/plan.js";
 import { parseKnowledgeUninstallRequest, planKnowledgeUninstall, } from "../knowledge/uninstall/plan.js";
 import { parseMcpServerUninstallRequest, planMcpServerUninstall } from "../mcps/uninstall/plan.js";
@@ -91,19 +94,92 @@ export const prepareUninstallExtensions = Effect.fn("UninstallExtensions.prepare
         onNone: () => resolveRootUninstallIntent(request.selector).pipe(Effect.map((intent) => ({ type: intent.type, selector: intent.name }))),
     });
     const planned = yield* planForType(resolved.type, resolved.selector);
+    const proposal = yield* proposeDesiredState(planned.names.map((name) => ({ kind: "remove", type: resolved.type, name }))).pipe(Effect.mapError((cause) => new ExtensionLifecycleFailed({
+        category: "conflict",
+        detail: "Cannot derive desired state after uninstall",
+        cause,
+    })));
     // The plan's own name stands whichever spelling produced it: the removal a
     // person asked for is type-specific, and the plan name is what they read.
     // Only the presented subject varies — the root form routes across every
     // type, so it presents the default subject rather than the one this
     // request happened to settle on.
+    const leafType = resolved.type === "pack" ? undefined : resolved.type;
+    const artifacts = leafType === undefined
+        ? []
+        : yield* Effect.forEach(planned.names, (name) => prepareUninstallArtifact({ type: leafType, name }, proposal)).pipe(Effect.mapError((cause) => new ExtensionLifecycleFailed({
+            category: "conflict",
+            detail: "Cannot establish uninstall effects",
+            cause,
+        })));
+    const artifactByName = new Map(planned.names.flatMap((name, index) => artifacts[index] === undefined ? [] : [[name, artifacts[index]]]));
+    const cleanupAdapter = {
+        toStepFailure: (cause) => lifecycleStepFailure(new ExtensionLifecycleFailed({
+            category: "conflict",
+            detail: "detail" in cause ? cause.detail : cause._tag,
+            cause,
+        })),
+    };
+    const activeNames = (type) => new Set(proposal.after.nodes
+        .filter((node) => node.type === type && node.enabled)
+        .map((node) => node.name));
+    const jobs = yield* Effect.forEach(planned.plan.jobs, (job) => Effect.gen(function* () {
+        const steps = yield* Effect.forEach(job.steps, (step) => Effect.gen(function* () {
+            const artifact = artifactByName.get(step.label ?? "");
+            if (artifact === undefined ||
+                step.readiness === "error" ||
+                leafType === undefined ||
+                ((artifact.targets?.length ?? 0) === 0 && (artifact.references?.length ?? 0) === 0))
+                return step;
+            const cleanup = yield* collectCleanupStep({
+                expectedSkillNames: activeNames("skill"),
+                expectedSubagentNames: activeNames("subagent"),
+                expectedMcpServerNames: activeNames("mcp-server"),
+                expectedHookNames: activeNames("hook"),
+                subjects: [{ type: leafType, name: step.label }],
+                adapter: cleanupAdapter,
+            }).pipe(Effect.mapError((cause) => new ExtensionLifecycleFailed({
+                category: "conflict",
+                detail: "Cannot establish owned uninstall outputs",
+                cause,
+            })));
+            const removal = {
+                ...step,
+                artifact,
+                run: step.run.pipe(Effect.map((result) => result.result === "success" ? { ...result, artifact } : result)),
+            };
+            if (Option.isNone(cleanup))
+                return removal;
+            return yield* buildReconciliationClosure({
+                label: step.label,
+                message: `Uninstalled ${step.label}`,
+                artifact,
+                children: [
+                    { step: cleanup.value, coverage: "ineligible" },
+                    { step: removal, coverage: "eligible" },
+                ],
+                toStepFailure: (failure) => failure._tag === "StepFailure" ? failure : cleanupAdapter.toStepFailure(failure),
+                validate: Effect.void,
+            });
+        }));
+        return { ...job, steps };
+    }));
     const plan = {
         ...planned.plan,
+        jobs,
         presentation: operationPresentation({ imperative: "uninstall", past: "Uninstalled", gerund: "Uninstalling" }, Option.getOrUndefined(request.type)),
     };
     // Every removal withdraws the extension's per-agent projection, so the
     // candidate carries the configured-agent operation the resolution projects
     // before the removal and verifies after it.
-    const configuredAgentOperations = planned.names.map((name) => ({ extensionType: resolved.type, name, plannedState: "absent" }));
+    const configuredAgentOperations = planned.names.map((name) => {
+        const retained = proposal.after.nodes.find((node) => node.type === resolved.type && node.name === name);
+        return {
+            extensionType: resolved.type,
+            name,
+            plannedState: retained === undefined ? "absent" : retained.enabled ? "enabled" : "disabled",
+        };
+    });
     const execution = yield* prepareExecutionCandidate(plan, { configuredAgentOperations });
     return {
         type: resolved.type,

package/dist/src/update/root-request.d.ts

@@ -18,8 +18,8 @@ import { ExtensionLifecycleFailed } from "../errors.js";
 import { type InstallableExtensionType } from "@agentxm/extension-model/unstable/extensions/installable-types";
 import { type ExtensionName, type Handle } from "@agentxm/extension-model/unstable/extensions";
 import type { VersionRange } from "@agentxm/extension-model/unstable/version-constraints";
-export declare const rootUpdatableTypeSegments: readonly ("knowledge" | "rules" | "hooks" | "mcps" | "skills" | "subagents" | "packs")[];
-export declare const RootUpdatableTypeSegmentSchema: Schema.Literals<readonly ("knowledge" | "rules" | "hooks" | "mcps" | "skills" | "subagents" | "packs")[]>;
+export declare const rootUpdatableTypeSegments: readonly ("knowledge" | "rules" | "hooks" | "skills" | "subagents" | "packs" | "mcps")[];
+export declare const RootUpdatableTypeSegmentSchema: Schema.Literals<readonly ("knowledge" | "rules" | "hooks" | "skills" | "subagents" | "packs" | "mcps")[]>;
 export type RootUpdatableTypeSegment = typeof RootUpdatableTypeSegmentSchema.Type;
 export type RootUpdatableType = InstallableExtensionType;
 /** One Registry identity a root update names, with the range it requested. */

package/dist/src/update/selective/skills.d.ts

@@ -51,5 +51,5 @@ export declare const prepareSelectiveSkillUpdate: (request: SelectiveSkillUpdate
     reason?: never;
     message?: never;
     planDescription?: never;
-}, ExtensionLifecycleFailed | import("@agentxm/extension-sources").SourceSyntaxInvalid | import("@agentxm/extension-sources").SourceHostNotConfigured | import("@agentxm/extension-sources").SourceNotResolvable | import("@agentxm/extension-sources").SourceNetworkFailure | import("@agentxm/extension-sources").GitOperationFailed | import("@agentxm/extension-sources").WorkspaceCatalogUnavailable | import("@agentxm/extension-sources").AxmSkillGateUnavailable | import("@agentxm/registry-client").RegistryProblem | import("@agentxm/registry-client").RegistryRequestFailed | import("@agentxm/registry-client").RegistryOperationFailed | import("@agentxm/workspace-state").SettingsIoError | import("@agentxm/workspace-state").SettingsParseError | import("@agentxm/workspace-state").SettingsDecodeError | import("@agentxm/workspace-state").LockfileIoError | import("@agentxm/workspace-state").LockfileParseError | import("@agentxm/workspace-state").LockfileDecodeError | import("@agentxm/workspace-state").LockfileVersionUnsupported | import("@agentxm/workspace-state").WorkspaceRootEscape | import("@agentxm/workspace-state").LockfileValidationError | import("@agentxm/extension-resolution").ExtensionResolutionFailed | import("@agentxm/workspace-operations").CandidateFingerprintFailed, import("effect/FileSystem").FileSystem | import("effect/Path").Path | WorkspaceMutations | import("@agentxm/workspace-state").ConfiguredAgentOutcomesProvider | import("effect/unstable/http/HttpClient").HttpClient | import("@agentxm/extension-resolution").ReleaseAgePosture | import("effect/Scope").Scope | SourceHostProviders | import("@agentxm/extension-sources").WorkspaceCatalog>;
+}, ExtensionLifecycleFailed | import("@agentxm/extension-sources").SourceSyntaxInvalid | import("@agentxm/extension-sources").SourceHostNotConfigured | import("@agentxm/extension-sources").SourceNotResolvable | import("@agentxm/extension-sources").SourceNetworkFailure | import("@agentxm/extension-sources").GitOperationFailed | import("@agentxm/extension-sources").WorkspaceCatalogUnavailable | import("@agentxm/extension-sources").AxmSkillGateUnavailable | import("@agentxm/registry-client").RegistryProblem | import("@agentxm/registry-client").RegistryRequestFailed | import("@agentxm/registry-client").RegistryOperationFailed | import("@agentxm/workspace-state").SettingsIoError | import("@agentxm/workspace-state").SettingsParseError | import("@agentxm/workspace-state").SettingsDecodeError | import("@agentxm/workspace-state").LockfileIoError | import("@agentxm/workspace-state").LockfileParseError | import("@agentxm/workspace-state").LockfileDecodeError | import("@agentxm/workspace-state").LockfileVersionUnsupported | import("@agentxm/workspace-state").WorkspaceRootEscape | import("@agentxm/workspace-state").LockfileValidationError | import("@agentxm/extension-resolution").ExtensionResolutionFailed | import("@agentxm/workspace-operations").CandidateFingerprintFailed, import("effect/FileSystem").FileSystem | import("effect/Path").Path | WorkspaceMutations | import("effect/unstable/http/HttpClient").HttpClient | import("@agentxm/workspace-state").ConfiguredAgentOutcomesProvider | import("@agentxm/extension-resolution").ReleaseAgePosture | import("effect/Scope").Scope | SourceHostProviders | import("@agentxm/extension-sources").WorkspaceCatalog>;
 //# sourceMappingURL=skills.d.ts.map

package/dist/src/update/selective/skills.js

@@ -532,7 +532,6 @@ export const prepareSelectiveSkillUpdate = Effect.fn("SelectiveSkillUpdate.prepa
                 ref: item.ref,
                 force: request.ignoreVersionConstraints || item.ref.refType !== "registry",
                 versionRange: item.versionRange,
-                skipSettings: Option.none(),
                 strictUnknownAgents: Option.none(),
                 sourceName: Option.none(),
             },

package/dist/src/update/selective/subagents.d.ts

@@ -48,5 +48,5 @@ export declare const prepareSelectiveSubagentUpdate: (request: SelectiveSubagent
     reason?: never;
     message?: never;
     planDescription?: never;
-}, ExtensionLifecycleFailed | import("@agentxm/extension-sources").SourceSyntaxInvalid | import("@agentxm/extension-sources").SourceHostNotConfigured | import("@agentxm/extension-sources").SourceNotResolvable | import("@agentxm/extension-sources").SourceNetworkFailure | import("@agentxm/extension-sources").GitOperationFailed | import("@agentxm/extension-sources").WorkspaceCatalogUnavailable | import("@agentxm/extension-sources").AxmSkillGateUnavailable | import("@agentxm/registry-client").RegistryProblem | import("@agentxm/registry-client").RegistryRequestFailed | import("@agentxm/registry-client").RegistryOperationFailed | import("@agentxm/workspace-state").SettingsIoError | import("@agentxm/workspace-state").SettingsParseError | import("@agentxm/workspace-state").SettingsDecodeError | import("@agentxm/workspace-state").LockfileIoError | import("@agentxm/workspace-state").LockfileParseError | import("@agentxm/workspace-state").LockfileDecodeError | import("@agentxm/workspace-state").LockfileVersionUnsupported | import("@agentxm/workspace-state").WorkspaceRootEscape | import("@agentxm/workspace-state").LockfileValidationError | import("@agentxm/extension-resolution").ExtensionResolutionFailed | import("@agentxm/workspace-operations").CandidateFingerprintFailed, StepFailureConversion | import("effect/FileSystem").FileSystem | import("effect/Path").Path | WorkspaceMutations | import("@agentxm/workspace-state").ConfiguredAgentOutcomesProvider | import("effect/unstable/http/HttpClient").HttpClient | import("@agentxm/extension-resolution").ReleaseAgePosture | import("effect/Scope").Scope | SourceHostProviders | SubagentManager | import("@agentxm/extension-sources").WorkspaceCatalog>;
+}, ExtensionLifecycleFailed | import("@agentxm/extension-sources").SourceSyntaxInvalid | import("@agentxm/extension-sources").SourceHostNotConfigured | import("@agentxm/extension-sources").SourceNotResolvable | import("@agentxm/extension-sources").SourceNetworkFailure | import("@agentxm/extension-sources").GitOperationFailed | import("@agentxm/extension-sources").WorkspaceCatalogUnavailable | import("@agentxm/extension-sources").AxmSkillGateUnavailable | import("@agentxm/registry-client").RegistryProblem | import("@agentxm/registry-client").RegistryRequestFailed | import("@agentxm/registry-client").RegistryOperationFailed | import("@agentxm/workspace-state").SettingsIoError | import("@agentxm/workspace-state").SettingsParseError | import("@agentxm/workspace-state").SettingsDecodeError | import("@agentxm/workspace-state").LockfileIoError | import("@agentxm/workspace-state").LockfileParseError | import("@agentxm/workspace-state").LockfileDecodeError | import("@agentxm/workspace-state").LockfileVersionUnsupported | import("@agentxm/workspace-state").WorkspaceRootEscape | import("@agentxm/workspace-state").LockfileValidationError | import("@agentxm/extension-resolution").ExtensionResolutionFailed | import("@agentxm/workspace-operations").CandidateFingerprintFailed, StepFailureConversion | import("effect/FileSystem").FileSystem | import("effect/Path").Path | WorkspaceMutations | import("effect/unstable/http/HttpClient").HttpClient | import("@agentxm/workspace-state").ConfiguredAgentOutcomesProvider | import("@agentxm/extension-resolution").ReleaseAgePosture | import("effect/Scope").Scope | SourceHostProviders | SubagentManager | import("@agentxm/extension-sources").WorkspaceCatalog>;
 //# sourceMappingURL=subagents.d.ts.map

package/dist/src/update/selective/subagents.js

@@ -15,7 +15,8 @@ import * as Effect from "effect/Effect";
 import * as Option from "effect/Option";
 import { decodeExtensionNameSync, parseSourceQualifiedRegistrySourcePatternParts, } from "@agentxm/extension-model/unstable/extensions";
 import { isWorkspaceSourceLocator } from "@agentxm/extension-model/unstable/sources/workspace";
-import { buildInstallOperation, SubagentManager } from "@agentxm/extension-materialization";
+import { SubagentManager } from "@agentxm/extension-materialization";
+import { buildInstallOperation } from "@agentxm/workspace-reconciliation";
 import { classifyPublisherBindingTransition, makeConfiguredReleaseAgeEvaluation, normalizeReleaseAgeRecords, publisherTransitionWarning, registryBindingProposal, } from "@agentxm/extension-resolution";
 import { resolveSource, SourceHostProviders } from "@agentxm/extension-sources";
 import { operationPresentation, prepareExecutionCandidate, StepFailure, } from "@agentxm/workspace-operations";
@@ -271,7 +272,7 @@ export const prepareSelectiveSubagentUpdate = Effect.fn("SelectiveSubagentUpdate
         const step = buildInstallOperation(subagentManager, {
             toStepFailure: failureConversion.toStepFailure,
             ref,
-            versionRange: Option.none(),
+            declaration: { name: ref.subagent.name, versionRange: Option.none() },
         });
         if (step.readiness === "error") {
             return Effect.fail(new StepFailure({ category: "conflict", detail: step.errorMessage }));

package/dist/src/update/selective/use-case.d.ts

@@ -64,7 +64,7 @@ export declare const prepareSelectiveUpdate: (request: SelectiveUpdateRequest) =
     reason?: never;
     message?: never;
     planDescription?: never;
-}, import("../../errors.ts").ExtensionLifecycleFailed | import("@agentxm/extension-sources").SourceSyntaxInvalid | import("@agentxm/extension-sources").SourceHostNotConfigured | import("@agentxm/extension-sources").SourceNotResolvable | import("@agentxm/extension-sources").SourceNetworkFailure | import("@agentxm/extension-sources").GitOperationFailed | import("@agentxm/extension-sources").WorkspaceCatalogUnavailable | import("@agentxm/extension-sources").AxmSkillGateUnavailable | import("@agentxm/registry-client").RegistryProblem | import("@agentxm/registry-client").RegistryRequestFailed | import("@agentxm/registry-client").RegistryOperationFailed | import("@agentxm/workspace-state").SettingsIoError | import("@agentxm/workspace-state").SettingsParseError | import("@agentxm/workspace-state").SettingsDecodeError | import("@agentxm/workspace-state").LockfileIoError | import("@agentxm/workspace-state").LockfileParseError | import("@agentxm/workspace-state").LockfileDecodeError | import("@agentxm/workspace-state").LockfileVersionUnsupported | import("@agentxm/workspace-state").WorkspaceRootEscape | import("@agentxm/workspace-state").LockfileValidationError | import("@agentxm/extension-resolution").ExtensionResolutionFailed | import("@agentxm/workspace-operations").CandidateFingerprintFailed, import("../../step-failure-conversion.ts").StepFailureConversion | import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("@agentxm/workspace-state").WorkspaceMutations | import("@agentxm/workspace-state").ConfiguredAgentOutcomesProvider | import("effect/unstable/http/HttpClient").HttpClient | import("@agentxm/extension-resolution").ReleaseAgePosture | import("effect/Scope").Scope | import("@agentxm/extension-sources").SourceHostProviders | import("@agentxm/extension-materialization").SubagentManager | import("@agentxm/extension-sources").WorkspaceCatalog>;
+}, import("../../errors.ts").ExtensionLifecycleFailed | import("@agentxm/extension-sources").SourceSyntaxInvalid | import("@agentxm/extension-sources").SourceHostNotConfigured | import("@agentxm/extension-sources").SourceNotResolvable | import("@agentxm/extension-sources").SourceNetworkFailure | import("@agentxm/extension-sources").GitOperationFailed | import("@agentxm/extension-sources").WorkspaceCatalogUnavailable | import("@agentxm/extension-sources").AxmSkillGateUnavailable | import("@agentxm/registry-client").RegistryProblem | import("@agentxm/registry-client").RegistryRequestFailed | import("@agentxm/registry-client").RegistryOperationFailed | import("@agentxm/workspace-state").SettingsIoError | import("@agentxm/workspace-state").SettingsParseError | import("@agentxm/workspace-state").SettingsDecodeError | import("@agentxm/workspace-state").LockfileIoError | import("@agentxm/workspace-state").LockfileParseError | import("@agentxm/workspace-state").LockfileDecodeError | import("@agentxm/workspace-state").LockfileVersionUnsupported | import("@agentxm/workspace-state").WorkspaceRootEscape | import("@agentxm/workspace-state").LockfileValidationError | import("@agentxm/extension-resolution").ExtensionResolutionFailed | import("@agentxm/workspace-operations").CandidateFingerprintFailed, import("../../step-failure-conversion.ts").StepFailureConversion | import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("@agentxm/workspace-state").WorkspaceMutations | import("effect/unstable/http/HttpClient").HttpClient | import("@agentxm/workspace-state").ConfiguredAgentOutcomesProvider | import("@agentxm/extension-resolution").ReleaseAgePosture | import("effect/Scope").Scope | import("@agentxm/extension-sources").SourceHostProviders | import("@agentxm/extension-materialization").SubagentManager | import("@agentxm/extension-sources").WorkspaceCatalog>;
 /** Settle a selective update, then preview or apply it. */
 export declare const SelectiveUpdate: {
     readonly prepare: (request: SelectiveUpdateRequest) => Effect.Effect<{
@@ -115,7 +115,7 @@ export declare const SelectiveUpdate: {
         reason?: never;
         message?: never;
         planDescription?: never;
-    }, import("../../errors.ts").ExtensionLifecycleFailed | import("@agentxm/extension-sources").SourceSyntaxInvalid | import("@agentxm/extension-sources").SourceHostNotConfigured | import("@agentxm/extension-sources").SourceNotResolvable | import("@agentxm/extension-sources").SourceNetworkFailure | import("@agentxm/extension-sources").GitOperationFailed | import("@agentxm/extension-sources").WorkspaceCatalogUnavailable | import("@agentxm/extension-sources").AxmSkillGateUnavailable | import("@agentxm/registry-client").RegistryProblem | import("@agentxm/registry-client").RegistryRequestFailed | import("@agentxm/registry-client").RegistryOperationFailed | import("@agentxm/workspace-state").SettingsIoError | import("@agentxm/workspace-state").SettingsParseError | import("@agentxm/workspace-state").SettingsDecodeError | import("@agentxm/workspace-state").LockfileIoError | import("@agentxm/workspace-state").LockfileParseError | import("@agentxm/workspace-state").LockfileDecodeError | import("@agentxm/workspace-state").LockfileVersionUnsupported | import("@agentxm/workspace-state").WorkspaceRootEscape | import("@agentxm/workspace-state").LockfileValidationError | import("@agentxm/extension-resolution").ExtensionResolutionFailed | import("@agentxm/workspace-operations").CandidateFingerprintFailed, import("../../step-failure-conversion.ts").StepFailureConversion | import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("@agentxm/workspace-state").WorkspaceMutations | import("@agentxm/workspace-state").ConfiguredAgentOutcomesProvider | import("effect/unstable/http/HttpClient").HttpClient | import("@agentxm/extension-resolution").ReleaseAgePosture | import("effect/Scope").Scope | import("@agentxm/extension-sources").SourceHostProviders | import("@agentxm/extension-materialization").SubagentManager | import("@agentxm/extension-sources").WorkspaceCatalog>;
+    }, import("../../errors.ts").ExtensionLifecycleFailed | import("@agentxm/extension-sources").SourceSyntaxInvalid | import("@agentxm/extension-sources").SourceHostNotConfigured | import("@agentxm/extension-sources").SourceNotResolvable | import("@agentxm/extension-sources").SourceNetworkFailure | import("@agentxm/extension-sources").GitOperationFailed | import("@agentxm/extension-sources").WorkspaceCatalogUnavailable | import("@agentxm/extension-sources").AxmSkillGateUnavailable | import("@agentxm/registry-client").RegistryProblem | import("@agentxm/registry-client").RegistryRequestFailed | import("@agentxm/registry-client").RegistryOperationFailed | import("@agentxm/workspace-state").SettingsIoError | import("@agentxm/workspace-state").SettingsParseError | import("@agentxm/workspace-state").SettingsDecodeError | import("@agentxm/workspace-state").LockfileIoError | import("@agentxm/workspace-state").LockfileParseError | import("@agentxm/workspace-state").LockfileDecodeError | import("@agentxm/workspace-state").LockfileVersionUnsupported | import("@agentxm/workspace-state").WorkspaceRootEscape | import("@agentxm/workspace-state").LockfileValidationError | import("@agentxm/extension-resolution").ExtensionResolutionFailed | import("@agentxm/workspace-operations").CandidateFingerprintFailed, import("../../step-failure-conversion.ts").StepFailureConversion | import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("@agentxm/workspace-state").WorkspaceMutations | import("effect/unstable/http/HttpClient").HttpClient | import("@agentxm/workspace-state").ConfiguredAgentOutcomesProvider | import("@agentxm/extension-resolution").ReleaseAgePosture | import("effect/Scope").Scope | import("@agentxm/extension-sources").SourceHostProviders | import("@agentxm/extension-materialization").SubagentManager | import("@agentxm/extension-sources").WorkspaceCatalog>;
     readonly previewOrApply: (candidate: import("./vocabulary.js").PlannedSelectiveUpdateCandidate, execution: import("@agentxm/workspace-operations").PlanExecution) => Effect.Effect<import("@agentxm/workspace-operations").OperationResolution<never>, import("@agentxm/workspace-state").WorkspaceSettingsReadFailure | import("@agentxm/workspace-operations").ApprovalRecoveryMissing | import("@agentxm/workspace-operations").PlanInteractionFailed | import("@agentxm/workspace-transactions").WorkspaceTransitionAcquireFailure, import("@agentxm/workspace-state").ConfiguredAgentOutcomesProvider | import("@agentxm/workspace-transactions").FootprintRecorder | import("@agentxm/workspace-operations").OperationJournal | import("@agentxm/workspace-operations").ResolvePlanInteraction | import("./requirements.ts").SelectiveUpdateStepRequirements>;
 };
 //# sourceMappingURL=use-case.d.ts.map

package/dist/src/update/targeted-plan.js

@@ -1,3 +1,5 @@
+import { lifecycleStepFailure } from "../step-failure.js";
+import { buildReconciliationClosure, } from "@agentxm/workspace-reconciliation";
 /**
  * Wrapping a targeted update in one atomic ownership transition.
  *
@@ -18,7 +20,6 @@ import { operationPresentation, } from "@agentxm/workspace-operations";
 import { WorkspaceMutations } from "@agentxm/workspace-state";
 import { resolveTargetedUpdateContext, } from "@agentxm/extension-resolution";
 import { ExtensionLifecycleFailed } from "../errors.js";
-import { buildAtomicPackGraphStep } from "../packs/graph-transition.js";
 export const TARGETED_UPDATE_STALE_DETAIL = "The targeted update ownership context became stale before apply.";
 const same = (left, right) => JSON.stringify(left) === JSON.stringify(right);
 const validatePostcondition = (args) => {
@@ -63,7 +64,8 @@ export const wrapTargetedUpdatePlan = (args) => Effect.gen(function* () {
         scope: workspace.scope,
         change: "updated",
     };
-    const builtStep = yield* buildAtomicPackGraphStep({
+    const builtStep = yield* buildReconciliationClosure({
+        toStepFailure: lifecycleStepFailure,
         label: args.context.public.target.fqn,
         message: `Updated ${args.context.public.target.fqn}`,
         artifact,

package/dist/src/workspace-paths.d.ts

@@ -20,12 +20,6 @@ export declare const workspaceLockfilePath: (scope: WorkspaceScope) => string;
 export declare const workspaceCanonicalRoot: (scope: WorkspaceScope) => string;
 /** One acquired package's path, relative to the workspace root. */
 export declare const workspaceCanonicalPath: (scope: WorkspaceScope, relativePath: string) => string;
-/** Where one desired-graph node's package sits, authored or acquired. */
-export declare const workspaceCanonicalNodePath: (path: Path.Path, ws: WorkspaceMutationsService, node: {
-    readonly type: ExtensionType;
-    readonly name: string;
-    readonly identity: string;
-}) => string;
 /** Where a workspace-authored package of this type and name sits. */
 export declare const workspaceAuthoredPath: (path: Path.Path, ws: WorkspaceMutationsService, type: ExtensionType, name: string) => string;
 //# sourceMappingURL=workspace-paths.d.ts.map

package/dist/src/workspace-paths.js

@@ -25,16 +25,6 @@ const extensionDirectory = {
     knowledge: "knowledge",
     pack: "packs",
 };
-/** Where one desired-graph node's package sits, authored or acquired. */
-export const workspaceCanonicalNodePath = (path, ws, node) => {
-    if (node.identity.startsWith("workspace:") && ws.layout.scope === "project") {
-        return path.join(path.relative(ws.baseDir, ws.layout.authoredRoot(node.type)), node.name);
-    }
-    const identity = node.identity.startsWith("workspace:")
-        ? node.identity.slice("workspace:".length)
-        : node.identity;
-    return workspaceCanonicalPath(ws.scope, identity);
-};
 /** Where a workspace-authored package of this type and name sits. */
 export const workspaceAuthoredPath = (path, ws, type, name) => {
     if (ws.layout.scope === "project") {

package/package.json

@@ -4,20 +4,21 @@
     "url": "https://github.com/agentxm/axm/issues"
   },
   "dependencies": {
-    "@agentxm/agent-integration": "^0.29.2",
-    "@agentxm/extension-content": "^0.29.2",
-    "@agentxm/extension-materialization": "^0.29.2",
-    "@agentxm/extension-model": "^0.29.2",
-    "@agentxm/extension-resolution": "^0.29.2",
-    "@agentxm/extension-sources": "^0.29.2",
-    "@agentxm/registry-auth": "^0.29.2",
-    "@agentxm/registry-client": "^0.29.2",
-    "@agentxm/registry-protocol": "^0.29.2",
-    "@agentxm/workspace-operations": "^0.29.2",
-    "@agentxm/workspace-projection": "^0.29.2",
-    "@agentxm/workspace-state": "^0.29.2",
-    "@agentxm/workspace-transactions": "^0.29.2",
-    "@napi-rs/keyring": "^1.3.0",
+    "@agentxm/agent-integration": "^0.30.1",
+    "@agentxm/cli-maintenance": "^0.30.1",
+    "@agentxm/extension-content": "^0.30.1",
+    "@agentxm/extension-materialization": "^0.30.1",
+    "@agentxm/extension-model": "^0.30.1",
+    "@agentxm/extension-resolution": "^0.30.1",
+    "@agentxm/extension-sources": "^0.30.1",
+    "@agentxm/registry-auth": "^0.30.1",
+    "@agentxm/registry-client": "^0.30.1",
+    "@agentxm/registry-protocol": "^0.30.1",
+    "@agentxm/workspace-operations": "^0.30.1",
+    "@agentxm/workspace-projection": "^0.30.1",
+    "@agentxm/workspace-reconciliation": "^0.30.1",
+    "@agentxm/workspace-state": "^0.30.1",
+    "@agentxm/workspace-transactions": "^0.30.1",
     "effect": "4.0.0-rc.115",
     "fflate": "^0.8.3"
   },
@@ -37,19 +38,16 @@
   },
   "exports": {
     ".": {
-      "axm-source": "./src/index.ts",
-      "default": "./dist/src/index.js",
-      "types": "./dist/src/index.d.ts"
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
     },
     "./live": {
-      "axm-source": "./src/live.ts",
-      "default": "./dist/src/live.js",
-      "types": "./dist/src/live.d.ts"
+      "types": "./dist/src/live.d.ts",
+      "default": "./dist/src/live.js"
     },
     "./testing": {
-      "axm-source": "./src/testing.ts",
-      "default": "./dist/src/testing.js",
-      "types": "./dist/src/testing.d.ts"
+      "types": "./dist/src/testing.d.ts",
+      "default": "./dist/src/testing.js"
     }
   },
   "files": [
@@ -72,5 +70,5 @@
   },
   "sideEffects": false,
   "type": "module",
-  "version": "0.29.2"
+  "version": "0.30.1"
 }

package/dist/src/uninstall/retention-policy.d.ts

@@ -1,21 +0,0 @@
-/**
- * Whether a removal may delete the package it withdraws.
- *
- * An extension declared directly and also required by an installed pack keeps
- * its package when the direct declaration goes: the pack still depends on it.
- * The membership fact is workspace state's; deciding that it means "retain"
- * is this feature's.
- *
- * @experimental This API is unstable and may change without notice.
- */
-import type { UninstallRetentionPolicy } from "@agentxm/extension-materialization";
-import type { WorkspaceMutationsService } from "@agentxm/workspace-state";
-import type { ExtensionLifecycleFailed } from "../errors.js";
-/** Retain a package an installed pack still requires. */
-export declare const makeWorkspaceRetentionPolicy: (ws: WorkspaceMutationsService) => UninstallRetentionPolicy<ExtensionLifecycleFailed>;
-/**
- * A pack's own exclusive members carry no separate retention question: the
- * pack that required them is being removed in the same transition.
- */
-export declare const exclusiveMemberRetentionPolicy: UninstallRetentionPolicy<ExtensionLifecycleFailed>;
-//# sourceMappingURL=retention-policy.d.ts.map

package/dist/src/uninstall/retention-policy.js

@@ -1,28 +0,0 @@
-/**
- * Whether a removal may delete the package it withdraws.
- *
- * An extension declared directly and also required by an installed pack keeps
- * its package when the direct declaration goes: the pack still depends on it.
- * The membership fact is workspace state's; deciding that it means "retain"
- * is this feature's.
- *
- * @experimental This API is unstable and may change without notice.
- */
-import * as Effect from "effect/Effect";
-import { installRefused } from "../install/vocabulary.js";
-/** Retain a package an installed pack still requires. */
-export const makeWorkspaceRetentionPolicy = (ws) => ({
-    isRequiredByInstalledPack: (args) => ws.isExtensionRequiredByInstalledPack(args.target).pipe(Effect.mapError((cause) => installRefused({
-        category: "internal",
-        detail: `Pack membership for ${args.target.type} "${args.target.name}" could not be read`,
-        cause,
-    }))),
-});
-/**
- * A pack's own exclusive members carry no separate retention question: the
- * pack that required them is being removed in the same transition.
- */
-export const exclusiveMemberRetentionPolicy = {
-    isRequiredByInstalledPack: () => Effect.succeed(false),
-};
-//# sourceMappingURL=retention-policy.js.map