@agentxm/extension-resolution 0.29.4 → 0.30.1

package/README.md

@@ -20,14 +20,16 @@ extension resolves to, and whether that resolution may be accepted.
 - **Publisher-binding trust** — `classifyPublisherBindingTransition` and the
   proposal vocabulary. Shaping the resulting plan risk condition belongs to
   the feature that owns the plan, not here.
-- **Official AXM skill compatibility** — `evaluateAxmSkillCompatibility`,
-  `evaluateAxmSkillCandidate`, `readAxmSkillWorkspaceCompatibility`.
+- **Official AXM skill inspection** — `evaluateAxmSkillCandidate` and
+  `readAxmSkillWorkspaceCompatibility` currently obtain candidate facts and
+  invoke the compatibility policy owned by `@agentxm/cli-maintenance`.
 
 Exports `.` and `./live`.
 
 Dependency budget: `@agentxm/extension-model`, `@agentxm/registry-protocol`,
 `@agentxm/extension-content`, `@agentxm/extension-sources`, and
-`@agentxm/workspace-state`. Deciding what a configured entry resolves to needs
+`@agentxm/workspace-state`, and the published official-skill APIs of
+`@agentxm/cli-maintenance`. Deciding what a configured entry resolves to needs
 workspace facts and source acquisition, so this package sits **above**
 `@agentxm/workspace-state`: state must never depend on it.
 
@@ -46,10 +48,20 @@ It therefore declares ports whose vocabulary lives in
 - `WorkspaceCatalog` — implemented by `@agentxm/workspace-projection`, which
   owns the agent-selection facts the catalog reports.
 
-Selection semantics that the Registry itself defines (`selectVersion`,
-`resolveVersionEntry`: yanked handling and range maxima) stay in
-`@agentxm/registry-protocol/unstable/registry/version-selection`, which both
-the client integration and this package consume.
+Shared release selection (`selectVersion`, `resolveVersionEntry`: exact
+requests, yank handling, and range maxima) belongs to
+`@agentxm/extension-model/unstable/version-constraints/version-selection`.
+It consumes domain release facts and preserves the selected candidate. Registry
+clients and this package use it without making wire schemas own the algorithm;
+release-age and other client admission policies remain here.
+
+Official-skill compatibility and recovery are owned by
+[`@agentxm/cli-maintenance`](../../supporting/cli-maintenance/README.md), with
+separate domain, application, and composition entry points. They are absent
+from this package's public exports. Registry candidate probing and workspace
+inspection still require a further acquisition/application separation; the
+policy extraction does not make the current provider port design the target
+architecture.
 
 Unstable and unsupported — use the [axm.sh](https://axm.sh) CLI.
 

package/dist/src/axm-skill-candidate.d.ts

@@ -1,8 +1,9 @@
 import * as Effect from "effect/Effect";
 import * as FileSystem from "effect/FileSystem";
 import * as Path from "effect/Path";
-import { AxmSkillCompatibilityUnavailable, AxmSkillIncompatible } from "./errors.js";
-import { type AxmSkillCompatibility } from "./axm-skill-compatibility.js";
+import { AxmSkillCompatibilityUnavailable } from "@agentxm/cli-maintenance/official-skill/application";
+import { AxmSkillIncompatible } from "@agentxm/cli-maintenance/official-skill/domain";
+import { type AxmSkillCompatibility } from "@agentxm/cli-maintenance/official-skill/domain";
 import type { SkillExtensionRef } from "@agentxm/extension-model/unstable/extensions/refs/skill";
 export interface ValidateAxmSkillCandidateArgs {
     readonly ref: SkillExtensionRef;

package/dist/src/axm-skill-candidate.js

@@ -2,8 +2,10 @@ import * as Effect from "effect/Effect";
 import * as FileSystem from "effect/FileSystem";
 import * as Option from "effect/Option";
 import * as Path from "effect/Path";
-import { AxmSkillCompatibilityUnavailable, AxmSkillIncompatible } from "./errors.js";
-import { AXM_SKILL_FQN, AxmSkillCompatibilityPolicy, evaluateAxmSkillCompatibility, } from "./axm-skill-compatibility.js";
+import { AxmSkillCompatibilityUnavailable } from "@agentxm/cli-maintenance/official-skill/application";
+import { AxmSkillIncompatible } from "@agentxm/cli-maintenance/official-skill/domain";
+import { AXM_SKILL_FQN, evaluateAxmSkillCompatibility, } from "@agentxm/cli-maintenance/official-skill/domain";
+import { AxmSkillCompatibilityPolicy } from "@agentxm/cli-maintenance/official-skill/application";
 import { parseSkillMd } from "@agentxm/extension-content";
 const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 const parseManifest = (content) => Option.match(content, {

package/dist/src/axm-skill-workspace-compatibility.d.ts

@@ -4,7 +4,8 @@ import * as Option from "effect/Option";
 import type * as Path from "effect/Path";
 import type { InstalledSkill, WorkspaceReadModel } from "@agentxm/workspace-state";
 import { type LockfileReadError, type SettingsReadError } from "@agentxm/workspace-state";
-import { type AxmSkillCompatibility, type AxmSkillCompatibilityPolicyService } from "./axm-skill-compatibility.js";
+import { type AxmSkillCompatibility } from "@agentxm/cli-maintenance/official-skill/domain";
+import { type AxmSkillCompatibilityPolicyService } from "@agentxm/cli-maintenance/official-skill/application";
 /** Whether desired workspace state directly or transitively declares the official AXM skill. */
 export declare const declaresOfficialAxmSkill: (args: {
     readonly declaredSource: string | null;

package/dist/src/axm-skill-workspace-compatibility.js

@@ -2,7 +2,8 @@ import * as Effect from "effect/Effect";
 import * as Option from "effect/Option";
 import { printSkillLockSourceLocator, } from "@agentxm/workspace-state";
 import { parseSkillMd } from "@agentxm/extension-content";
-import { AXM_SKILL_FQN, } from "./axm-skill-compatibility.js";
+import { AXM_SKILL_FQN, } from "@agentxm/cli-maintenance/official-skill/domain";
+import {} from "@agentxm/cli-maintenance/official-skill/application";
 const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 const manifestVersion = (content) => {
     try {

package/dist/src/errors.d.ts

@@ -5,7 +5,6 @@
  * @experimental This API is unstable and may change without notice.
  */
 import * as Schema from "effect/Schema";
-import type { AxmSkillCompatibility } from "./axm-skill-compatibility.js";
 declare const ExtensionResolutionFailed_base: Schema.Class<ExtensionResolutionFailed, Schema.TaggedStruct<"ExtensionResolutionFailed", {
     readonly category: Schema.Literals<readonly ["conflict", "internal", "network", "not_found", "usage", "validation"]>;
     readonly title: Schema.optional<Schema.String>;
@@ -38,24 +37,6 @@ export declare class SourceAuthorityBlocked extends SourceAuthorityBlocked_base<
     }>;
 }> {
 }
-declare const AxmSkillCompatibilityUnavailable_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
-    readonly _tag: "AxmSkillCompatibilityUnavailable";
-} & Readonly<A>;
-/** The AXM compatibility policy did not evaluate the official AXM skill. */
-export declare class AxmSkillCompatibilityUnavailable extends AxmSkillCompatibilityUnavailable_base {
-}
-declare const AxmSkillIncompatible_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
-    readonly _tag: "AxmSkillIncompatible";
-} & Readonly<A>;
-/**
- * The official AXM skill candidate is incompatible with this CLI. Carries the
- * policy's full compatibility verdict, whose recovery plan the application
- * boundary renders into suggestions.
- */
-export declare class AxmSkillIncompatible extends AxmSkillIncompatible_base<{
-    readonly compatibility: AxmSkillCompatibility;
-}> {
-}
 declare const PackDependencyInvalid_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
     readonly _tag: "PackDependencyInvalid";
 } & Readonly<A>;

package/dist/src/errors.js

@@ -37,16 +37,6 @@ export class ExtensionResolutionFailed extends Schema.TaggedError()("ExtensionRe
 /** Source-authority evaluation refused the requested transition. */
 export class SourceAuthorityBlocked extends Data.TaggedError("SourceAuthorityBlocked") {
 }
-/** The AXM compatibility policy did not evaluate the official AXM skill. */
-export class AxmSkillCompatibilityUnavailable extends Data.TaggedError("AxmSkillCompatibilityUnavailable") {
-}
-/**
- * The official AXM skill candidate is incompatible with this CLI. Carries the
- * policy's full compatibility verdict, whose recovery plan the application
- * boundary renders into suggestions.
- */
-export class AxmSkillIncompatible extends Data.TaggedError("AxmSkillIncompatible") {
-}
 /**
  * A declared pack dependency cannot be resolved as requested. `detail`
  * carries the site's fact sentence verbatim.

package/dist/src/index.d.ts

@@ -4,15 +4,14 @@
  * Extension resolution policy: which source is allowed to supply a
  * configured extension, which visible version that source resolves to under
  * the minimum-release-age policy, which publisher binding a proposed
- * acceptance replaces, how a Pack's declared members resolve, and whether an
- * official AXM skill candidate is compatible with this CLI. Pure over the
+ * acceptance replaces, and how a Pack's declared members resolve. Pure over the
  * Registry index contract and workspace state; the provider that fetches the
  * index applies these through a port.
  *
  * @experimental This API is unstable and may change without notice.
  * @packageDocumentation
  */
-export { AxmSkillCompatibilityUnavailable, AxmSkillIncompatible, ExtensionResolutionFailed, PackConstraintShadowed, PackDependencyConflict, PackDependencyInvalid, PackDependencyMissing, PackDependencyUnsatisfied, SourceAuthorityBlocked, type PackDependencyResolutionFailure, } from "./errors.js";
+export { ExtensionResolutionFailed, PackConstraintShadowed, PackDependencyConflict, PackDependencyInvalid, PackDependencyMissing, PackDependencyUnsatisfied, SourceAuthorityBlocked, type PackDependencyResolutionFailure, } from "./errors.js";
 export { type ReleaseAgeBypassRecord, type ReleaseAgeHoldbackRecord, type ReleaseAgeOperationEvidence, type ReleaseAgeRecord, type ReleaseAgeRecordBase, filterMatureVersions, formatMinimumReleaseAgeSeconds, isVersionEntryEligibleAt, isVersionEntryMature, normalizeReleaseAgeRecords, parseMinimumReleaseAge, releaseAgeEvidence, releaseAgeExemptionForIdentity, releaseAgeHoldbackWarning, } from "./release-age-policy.js";
 export { type ReleaseAgeVersionResolution, resolveVersionEntryForReleaseAge, resolveVersionEntryWithReleaseAge, } from "./version-resolution.js";
 export { decideNamedRegistryVersion, namedRegistryCandidates, } from "./named-registry-resolution.js";
@@ -25,7 +24,6 @@ export { classifyPublisherBindingTransition, describePublisherBindingTransition,
 export { ResolvedPackDependencyMapSchema, ResolvedPackDependencySchema, type ResolvedPackDependency, type ResolvedPackDependencyMap, } from "./resolved-pack-dependency.js";
 export { resolvePackDependencies, resolvePackDependenciesWithReleaseAge, type PackDependencyRefResolver, type ReleaseAgeAwarePackDependencyResolution, type ResolvedPackDependencies, type WorkspacePackDependencyResolution, type WorkspacePackDependencyResolver, } from "./pack-dependency-resolution.js";
 export { acceptedPackDependencyResolver } from "./accepted-pack-dependency-resolver.js";
-export { AXM_SKILL_BUNDLED_APPLY_COMMAND, AXM_SKILL_BUNDLED_PREVIEW_COMMAND, AXM_SKILL_CLI_VERSION_METADATA_KEY, AXM_SKILL_CLI_VERSION_RANGE_METADATA_KEY, AXM_SKILL_FQN, AXM_SKILL_REGISTRY_APPLY_COMMAND, AXM_SKILL_REGISTRY_PREVIEW_COMMAND, AxmSkillCompatibilityPolicy, AxmSkillCompatibilityRecoveryActionSchema, AxmSkillCompatibilityRecoverySchema, AxmSkillCompatibilityRecoveryStepSchema, AxmSkillCompatibilityReasonSchema, AxmSkillCompatibilitySchema, evaluateAxmSkillCompatibility, formatAxmSkillCompatibilityTarget, makeAxmSkillCompatibilityPolicyLayer, validateAxmSkillCliVersionRange, type AxmSkillCliVersionRangeValidation, type AxmSkillCompatibility, type AxmSkillCompatibilityCandidate, type AxmSkillCompatibilityInput, type AxmSkillCompatibilityPolicyInput, type AxmSkillCompatibilityPolicyService, type AxmSkillCompatibilityReason, type AxmSkillCompatibilityRecovery, type AxmSkillCompatibilityRecoveryAction, type AxmSkillCompatibilityRecoveryStep, } from "./axm-skill-compatibility.js";
 export { evaluateAxmSkillCandidate, validateAxmSkillCandidate, type ValidateAxmSkillCandidateArgs, } from "./axm-skill-candidate.js";
 export { declaresOfficialAxmSkill, readAxmSkillWorkspaceCompatibility, type ReadAxmSkillWorkspaceCompatibilityArgs, } from "./axm-skill-workspace-compatibility.js";
 export { classifyTargetedUpdate, resolveTargetedUpdateContext, type ClassifyTargetedUpdateArgs, type TargetedUpdateAuthority, type TargetedUpdateBlocker, type TargetedUpdateContext, type TargetedUpdateContextFailure, type TargetedUpdateEffect, type TargetedUpdateOwnership, type TargetedUpdatePublicContext, type TargetedUpdateTarget, type TargetedUpdateTargetType, } from "./update/targeted-update-context.js";

package/dist/src/index.js

@@ -4,15 +4,14 @@
  * Extension resolution policy: which source is allowed to supply a
  * configured extension, which visible version that source resolves to under
  * the minimum-release-age policy, which publisher binding a proposed
- * acceptance replaces, how a Pack's declared members resolve, and whether an
- * official AXM skill candidate is compatible with this CLI. Pure over the
+ * acceptance replaces, and how a Pack's declared members resolve. Pure over the
  * Registry index contract and workspace state; the provider that fetches the
  * index applies these through a port.
  *
  * @experimental This API is unstable and may change without notice.
  * @packageDocumentation
  */
-export { AxmSkillCompatibilityUnavailable, AxmSkillIncompatible, ExtensionResolutionFailed, PackConstraintShadowed, PackDependencyConflict, PackDependencyInvalid, PackDependencyMissing, PackDependencyUnsatisfied, SourceAuthorityBlocked, } from "./errors.js";
+export { ExtensionResolutionFailed, PackConstraintShadowed, PackDependencyConflict, PackDependencyInvalid, PackDependencyMissing, PackDependencyUnsatisfied, SourceAuthorityBlocked, } from "./errors.js";
 export { filterMatureVersions, formatMinimumReleaseAgeSeconds, isVersionEntryEligibleAt, isVersionEntryMature, normalizeReleaseAgeRecords, parseMinimumReleaseAge, releaseAgeEvidence, releaseAgeExemptionForIdentity, releaseAgeHoldbackWarning, } from "./release-age-policy.js";
 export { resolveVersionEntryForReleaseAge, resolveVersionEntryWithReleaseAge, } from "./version-resolution.js";
 export { decideNamedRegistryVersion, namedRegistryCandidates, } from "./named-registry-resolution.js";
@@ -31,8 +30,7 @@ export { classifyPublisherBindingTransition, describePublisherBindingTransition,
 export { ResolvedPackDependencyMapSchema, ResolvedPackDependencySchema, } from "./resolved-pack-dependency.js";
 export { resolvePackDependencies, resolvePackDependenciesWithReleaseAge, } from "./pack-dependency-resolution.js";
 export { acceptedPackDependencyResolver } from "./accepted-pack-dependency-resolver.js";
-// Official AXM skill compatibility policy.
-export { AXM_SKILL_BUNDLED_APPLY_COMMAND, AXM_SKILL_BUNDLED_PREVIEW_COMMAND, AXM_SKILL_CLI_VERSION_METADATA_KEY, AXM_SKILL_CLI_VERSION_RANGE_METADATA_KEY, AXM_SKILL_FQN, AXM_SKILL_REGISTRY_APPLY_COMMAND, AXM_SKILL_REGISTRY_PREVIEW_COMMAND, AxmSkillCompatibilityPolicy, AxmSkillCompatibilityRecoveryActionSchema, AxmSkillCompatibilityRecoverySchema, AxmSkillCompatibilityRecoveryStepSchema, AxmSkillCompatibilityReasonSchema, AxmSkillCompatibilitySchema, evaluateAxmSkillCompatibility, formatAxmSkillCompatibilityTarget, makeAxmSkillCompatibilityPolicyLayer, validateAxmSkillCliVersionRange, } from "./axm-skill-compatibility.js";
+// Official-skill byte inspection remains a workspace integration.
 export { evaluateAxmSkillCandidate, validateAxmSkillCandidate, } from "./axm-skill-candidate.js";
 export { declaresOfficialAxmSkill, readAxmSkillWorkspaceCompatibility, } from "./axm-skill-workspace-compatibility.js";
 // Targeted update classification: who owns the declaration a named update

package/dist/src/live.d.ts

@@ -1,18 +1,3 @@
-/**
- * Implementation of the source-resolution composition port this package owns
- * the policy for.
- *
- * `@agentxm/extension-sources` declares the official AXM skill candidate gate
- * as a port because a supporting integration may not own AXM trust policy.
- * Resolution owns that policy, so the Live is composed here rather than at
- * the application boundary; the composition root only composes Layers.
- *
- * The catalog port's Live belongs to `@agentxm/workspace-projection`, which
- * owns the agent-selection facts it reads.
- *
- * @experimental This API is unstable and may change without notice.
- * @packageDocumentation
- */
 import * as Layer from "effect/Layer";
 import { AxmSkillCandidateGate } from "@agentxm/extension-sources";
 /**

package/dist/src/live.js

@@ -1,3 +1,4 @@
+import { renderAxmSkillRecovery } from "@agentxm/cli-maintenance/official-skill/adapters/cli";
 /**
  * Implementation of the source-resolution composition port this package owns
  * the policy for.
@@ -17,7 +18,7 @@ import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
 import { AxmSkillCandidateGate, AxmSkillGateUnavailable, } from "@agentxm/extension-sources";
 import { evaluateAxmSkillCandidate } from "./axm-skill-candidate.js";
-import { AXM_SKILL_BUNDLED_PREVIEW_COMMAND, formatAxmSkillCompatibilityTarget, } from "./axm-skill-compatibility.js";
+import { AXM_SKILL_BUNDLED_PREVIEW_COMMAND, formatAxmSkillCompatibilityTarget, } from "@agentxm/cli-maintenance/official-skill/adapters/cli";
 /**
  * The gate renders the recovery command and target exactly as the registry
  * host provider rendered them before the port existed. Its only failure is
@@ -36,7 +37,7 @@ export const AxmSkillCandidateGateLive = Layer.succeed(AxmSkillCandidateGate, {
             detail: result.detail,
             recoveryCommand: result.recovery.action === "update-registry-skill"
                 ? AXM_SKILL_BUNDLED_PREVIEW_COMMAND
-                : result.recovery.nextAction,
+                : renderAxmSkillRecovery(result.recovery).nextAction,
             recoveryTarget: formatAxmSkillCompatibilityTarget(result.recovery),
         }), Effect.mapError((failure) => new AxmSkillGateUnavailable({
         category: "internal",

package/dist/src/testing.d.ts

@@ -1,9 +1,8 @@
 /**
  * @agentxm/extension-resolution deterministic test ports and decoders.
  *
- * The two services a resolution keeps in `R` until its command boundary — the
- * minimum-release-age posture the operator decides, and the official AXM
- * skill compatibility policy — bound to fixed values, plus the branded-value
+ * The minimum-release-age posture the operator decides, bound to a fixed
+ * value, plus the branded-value
  * decoders a fixture needs to state a handle, name, version, or range.
  * Production source never imports this module.
  *
@@ -14,7 +13,6 @@ import * as Layer from "effect/Layer";
 import { type ExtensionName } from "@agentxm/extension-model/unstable/extensions/common";
 import { type Handle } from "@agentxm/extension-model/unstable/extensions/handle";
 import { type Version, type VersionRange } from "@agentxm/extension-model/unstable/version-constraints";
-import { AxmSkillCompatibilityPolicy } from "./axm-skill-compatibility.js";
 import { ReleaseAgePosture, type ReleaseAgePostureValue } from "./release-age-posture.js";
 /**
  * The release-age gate's posture for one run. `"enforce"` withholds a
@@ -23,12 +21,6 @@ import { ReleaseAgePosture, type ReleaseAgePostureValue } from "./release-age-po
  * this run only.
  */
 export declare const ReleaseAgePostureTest: (posture?: ReleaseAgePostureValue) => Layer.Layer<ReleaseAgePosture>;
-/**
- * The real official-skill compatibility policy, evaluated against a stated CLI
- * version rather than the running executable's. `null` models an executable
- * that reports no version, which the policy must still answer for.
- */
-export declare const AxmSkillCompatibilityPolicyTest: (cliVersion: string | null) => Layer.Layer<AxmSkillCompatibilityPolicy>;
 /** The handle a fixture names, decoded into its branded form. */
 export declare const handle: (value: string) => Handle;
 /** The extension name a fixture names, decoded into its branded form. */

package/dist/src/testing.js

@@ -1,9 +1,8 @@
 /**
  * @agentxm/extension-resolution deterministic test ports and decoders.
  *
- * The two services a resolution keeps in `R` until its command boundary — the
- * minimum-release-age posture the operator decides, and the official AXM
- * skill compatibility policy — bound to fixed values, plus the branded-value
+ * The minimum-release-age posture the operator decides, bound to a fixed
+ * value, plus the branded-value
  * decoders a fixture needs to state a handle, name, version, or range.
  * Production source never imports this module.
  *
@@ -14,7 +13,6 @@ import * as Layer from "effect/Layer";
 import { decodeExtensionNameSync, } from "@agentxm/extension-model/unstable/extensions/common";
 import { decodeHandleSync } from "@agentxm/extension-model/unstable/extensions/handle";
 import { decodeVersionRangeSync, decodeVersionSync, } from "@agentxm/extension-model/unstable/version-constraints";
-import { AxmSkillCompatibilityPolicy, makeAxmSkillCompatibilityPolicyLayer, } from "./axm-skill-compatibility.js";
 import { ReleaseAgePosture } from "./release-age-posture.js";
 /**
  * The release-age gate's posture for one run. `"enforce"` withholds a
@@ -23,12 +21,6 @@ import { ReleaseAgePosture } from "./release-age-posture.js";
  * this run only.
  */
 export const ReleaseAgePostureTest = (posture = "enforce") => Layer.succeed(ReleaseAgePosture, posture);
-/**
- * The real official-skill compatibility policy, evaluated against a stated CLI
- * version rather than the running executable's. `null` models an executable
- * that reports no version, which the policy must still answer for.
- */
-export const AxmSkillCompatibilityPolicyTest = (cliVersion) => makeAxmSkillCompatibilityPolicyLayer(cliVersion);
 /** The handle a fixture names, decoded into its branded form. */
 export const handle = (value) => decodeHandleSync(value);
 /** The extension name a fixture names, decoded into its branded form. */

package/dist/src/version-resolution.js

@@ -8,7 +8,7 @@ import * as Duration from "effect/Duration";
 import * as Effect from "effect/Effect";
 import * as Option from "effect/Option";
 import * as semver from "semver";
-import { resolveVersionEntry } from "@agentxm/registry-protocol/unstable/registry/version-selection";
+import { resolveVersionEntry } from "@agentxm/extension-model/unstable/version-constraints/version-selection";
 import { filterMatureVersions, isVersionEntryEligibleAt, releaseAgeEvidence, } from "./release-age-policy.js";
 /**
  * Resolve a version request against the versions that have reached the

package/package.json

@@ -4,20 +4,20 @@
     "url": "https://github.com/agentxm/axm/issues"
   },
   "dependencies": {
-    "@agentxm/extension-content": "^0.29.4",
-    "@agentxm/extension-model": "^0.29.4",
-    "@agentxm/extension-sources": "^0.29.4",
-    "@agentxm/registry-protocol": "^0.29.4",
-    "@agentxm/workspace-state": "^0.29.4",
+    "@agentxm/cli-maintenance": "^0.30.1",
+    "@agentxm/extension-content": "^0.30.1",
+    "@agentxm/extension-model": "^0.30.1",
+    "@agentxm/extension-sources": "^0.30.1",
+    "@agentxm/registry-protocol": "^0.30.1",
+    "@agentxm/workspace-state": "^0.30.1",
     "effect": "4.0.0-rc.115",
     "semver": "^7.8.5"
   },
-  "description": "AXM extension resolution policy: what a configured or requested extension resolves to and whether that resolution may be accepted — release-age policy, version selection, configured-entry and Pack dependency resolution, workspace source authority, publisher-binding trust, and official AXM skill compatibility. Unstable and unsupported — use the axm.sh CLI.",
+  "description": "AXM extension resolution policy: what a configured or requested extension resolves to and whether that resolution may be accepted — release-age policy, version selection, configured-entry and Pack dependency resolution, workspace source authority, publisher-binding trust. Unstable and unsupported — use the axm.sh CLI.",
   "devDependencies": {
-    "@agentxm/specification-metadata": "^0.29.4",
+    "@agentxm/specification-metadata": "^0.30.1",
     "@effect/platform-node": "4.0.0-rc.115",
     "@effect/vitest": "4.0.0-rc.115",
-    "@fast-check/vitest": "^0.5.0",
     "@types/semver": "^7.7.1",
     "@typescript/native": "npm:typescript@^7.0.2",
     "typescript": "npm:@typescript/typescript6@^6.0.2",
@@ -28,19 +28,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": [
@@ -63,5 +60,5 @@
   },
   "sideEffects": false,
   "type": "module",
-  "version": "0.29.4"
+  "version": "0.30.1"
 }

package/dist/src/axm-skill-compatibility.d.ts

@@ -1,87 +0,0 @@
-import * as Layer from "effect/Layer";
-import * as Schema from "effect/Schema";
-import * as ServiceMap from "effect/Context";
-export declare const AXM_SKILL_FQN = "@agentxm/skills/axm";
-export declare const AXM_SKILL_CLI_VERSION_METADATA_KEY = "axm.sh/cli-version";
-export declare const AXM_SKILL_CLI_VERSION_RANGE_METADATA_KEY = "axm.sh/cli-version-range";
-export declare const AXM_SKILL_BUNDLED_PREVIEW_COMMAND = "axm skills install @agentxm/skills/axm --bundled --preview";
-export declare const AXM_SKILL_BUNDLED_APPLY_COMMAND = "axm skills install @agentxm/skills/axm --bundled";
-export declare const AXM_SKILL_REGISTRY_PREVIEW_COMMAND = "axm skills update --name axm --preview";
-export declare const AXM_SKILL_REGISTRY_APPLY_COMMAND = "axm skills update --name axm";
-export declare const AxmSkillCompatibilityReasonSchema: Schema.Literals<readonly ["cli-version-unavailable", "axm-skill-missing", "axm-skill-manifest-invalid", "compatibility-metadata-missing", "compatibility-metadata-malformed", "skill-release-mismatch", "skill-release-range-mismatch", "cli-version-incompatible"]>;
-export type AxmSkillCompatibilityReason = typeof AxmSkillCompatibilityReasonSchema.Type;
-export declare const AxmSkillCompatibilityRecoveryActionSchema: Schema.Literals<readonly ["none", "inspect-cli", "upgrade-cli", "update-registry-skill", "install-bundled-skill", "preserve-authored-skill"]>;
-export type AxmSkillCompatibilityRecoveryAction = typeof AxmSkillCompatibilityRecoveryActionSchema.Type;
-export declare const AxmSkillCompatibilityRecoveryStepSchema: Schema.Struct<{
-    readonly boundary: Schema.Literals<readonly ["executable", "workspace", "verification"]>;
-    readonly command: Schema.String;
-    readonly preview: Schema.Boolean;
-}>;
-export type AxmSkillCompatibilityRecoveryStep = typeof AxmSkillCompatibilityRecoveryStepSchema.Type;
-export declare const AxmSkillCompatibilityRecoverySchema: Schema.Struct<{
-    readonly action: Schema.Literals<readonly ["none", "inspect-cli", "upgrade-cli", "update-registry-skill", "install-bundled-skill", "preserve-authored-skill"]>;
-    readonly targetCliVersion: Schema.NullOr<Schema.String>;
-    readonly targetSkillVersion: Schema.NullOr<Schema.String>;
-    readonly nextAction: Schema.NullOr<Schema.String>;
-    readonly steps: Schema.$Array<Schema.Struct<{
-        readonly boundary: Schema.Literals<readonly ["executable", "workspace", "verification"]>;
-        readonly command: Schema.String;
-        readonly preview: Schema.Boolean;
-    }>>;
-}>;
-export type AxmSkillCompatibilityRecovery = typeof AxmSkillCompatibilityRecoverySchema.Type;
-export declare const formatAxmSkillCompatibilityTarget: (target: {
-    readonly targetCliVersion: string | null;
-    readonly targetSkillVersion: string | null;
-}) => string;
-export declare const AxmSkillCompatibilitySchema: Schema.Struct<{
-    readonly status: Schema.Literals<readonly ["compatible", "incompatible"]>;
-    readonly cliVersion: Schema.NullOr<Schema.String>;
-    readonly skillVersion: Schema.NullOr<Schema.String>;
-    readonly source: Schema.NullOr<Schema.String>;
-    readonly declaredCliVersion: Schema.NullOr<Schema.String>;
-    readonly declaredCliVersionRange: Schema.NullOr<Schema.String>;
-    readonly reasonCode: Schema.NullOr<Schema.Literals<readonly ["cli-version-unavailable", "axm-skill-missing", "axm-skill-manifest-invalid", "compatibility-metadata-missing", "compatibility-metadata-malformed", "skill-release-mismatch", "skill-release-range-mismatch", "cli-version-incompatible"]>>;
-    readonly detail: Schema.NullOr<Schema.String>;
-    readonly recovery: Schema.Struct<{
-        readonly action: Schema.Literals<readonly ["none", "inspect-cli", "upgrade-cli", "update-registry-skill", "install-bundled-skill", "preserve-authored-skill"]>;
-        readonly targetCliVersion: Schema.NullOr<Schema.String>;
-        readonly targetSkillVersion: Schema.NullOr<Schema.String>;
-        readonly nextAction: Schema.NullOr<Schema.String>;
-        readonly steps: Schema.$Array<Schema.Struct<{
-            readonly boundary: Schema.Literals<readonly ["executable", "workspace", "verification"]>;
-            readonly command: Schema.String;
-            readonly preview: Schema.Boolean;
-        }>>;
-    }>;
-}>;
-export type AxmSkillCompatibility = typeof AxmSkillCompatibilitySchema.Type;
-export interface AxmSkillCompatibilityCandidate {
-    readonly manifestVersion: string | null;
-    readonly metadata: Readonly<Record<string, string>> | null;
-    readonly source: string | null;
-}
-export interface AxmSkillCompatibilityInput {
-    readonly cliVersion: string | null;
-    readonly skill: AxmSkillCompatibilityCandidate | null;
-}
-export interface AxmSkillCompatibilityPolicyInput {
-    readonly fqn: string;
-    readonly candidate: AxmSkillCompatibilityCandidate | null;
-}
-export interface AxmSkillCompatibilityPolicyService {
-    readonly evaluate: (input: AxmSkillCompatibilityPolicyInput) => AxmSkillCompatibility | null;
-}
-declare const AxmSkillCompatibilityPolicy_base: ServiceMap.ServiceClass<AxmSkillCompatibilityPolicy, "@agentxm/extension-resolution/axm-skill-compatibility/AxmSkillCompatibilityPolicy", AxmSkillCompatibilityPolicyService>;
-export declare class AxmSkillCompatibilityPolicy extends AxmSkillCompatibilityPolicy_base {
-}
-export type AxmSkillCliVersionRangeValidation = {
-    readonly valid: true;
-} | {
-    readonly valid: false;
-};
-export declare const validateAxmSkillCliVersionRange: (value: string) => AxmSkillCliVersionRangeValidation;
-export declare const evaluateAxmSkillCompatibility: (input: AxmSkillCompatibilityInput) => AxmSkillCompatibility;
-export declare const makeAxmSkillCompatibilityPolicyLayer: (cliVersion: string | null) => Layer.Layer<AxmSkillCompatibilityPolicy>;
-export {};
-//# sourceMappingURL=axm-skill-compatibility.d.ts.map

package/dist/src/axm-skill-compatibility.js

@@ -1,248 +0,0 @@
-import * as Layer from "effect/Layer";
-import * as Schema from "effect/Schema";
-import * as ServiceMap from "effect/Context";
-import * as semver from "semver";
-export const AXM_SKILL_FQN = "@agentxm/skills/axm";
-const AXM_SKILL_AGENTXM_SOURCE = `agentxm:${AXM_SKILL_FQN}`;
-export const AXM_SKILL_CLI_VERSION_METADATA_KEY = "axm.sh/cli-version";
-export const AXM_SKILL_CLI_VERSION_RANGE_METADATA_KEY = "axm.sh/cli-version-range";
-export const AXM_SKILL_BUNDLED_PREVIEW_COMMAND = "axm skills install @agentxm/skills/axm --bundled --preview";
-export const AXM_SKILL_BUNDLED_APPLY_COMMAND = "axm skills install @agentxm/skills/axm --bundled";
-export const AXM_SKILL_REGISTRY_PREVIEW_COMMAND = "axm skills update --name axm --preview";
-export const AXM_SKILL_REGISTRY_APPLY_COMMAND = "axm skills update --name axm";
-export const AxmSkillCompatibilityReasonSchema = Schema.Literals([
-    "cli-version-unavailable",
-    "axm-skill-missing",
-    "axm-skill-manifest-invalid",
-    "compatibility-metadata-missing",
-    "compatibility-metadata-malformed",
-    "skill-release-mismatch",
-    "skill-release-range-mismatch",
-    "cli-version-incompatible",
-]);
-export const AxmSkillCompatibilityRecoveryActionSchema = Schema.Literals([
-    "none",
-    "inspect-cli",
-    "upgrade-cli",
-    "update-registry-skill",
-    "install-bundled-skill",
-    "preserve-authored-skill",
-]);
-export const AxmSkillCompatibilityRecoveryStepSchema = Schema.Struct({
-    boundary: Schema.Literals(["executable", "workspace", "verification"]),
-    command: Schema.String,
-    preview: Schema.Boolean,
-});
-export const AxmSkillCompatibilityRecoverySchema = Schema.Struct({
-    action: AxmSkillCompatibilityRecoveryActionSchema,
-    targetCliVersion: Schema.NullOr(Schema.String),
-    targetSkillVersion: Schema.NullOr(Schema.String),
-    nextAction: Schema.NullOr(Schema.String),
-    steps: Schema.Array(AxmSkillCompatibilityRecoveryStepSchema),
-});
-export const formatAxmSkillCompatibilityTarget = (target) => `AXM CLI ${target.targetCliVersion ?? "unknown"} + official AXM skill ${target.targetSkillVersion ?? "unknown"}`;
-export const AxmSkillCompatibilitySchema = Schema.Struct({
-    status: Schema.Literals(["compatible", "incompatible"]),
-    cliVersion: Schema.NullOr(Schema.String),
-    skillVersion: Schema.NullOr(Schema.String),
-    source: Schema.NullOr(Schema.String),
-    declaredCliVersion: Schema.NullOr(Schema.String),
-    declaredCliVersionRange: Schema.NullOr(Schema.String),
-    reasonCode: Schema.NullOr(AxmSkillCompatibilityReasonSchema),
-    detail: Schema.NullOr(Schema.String),
-    recovery: AxmSkillCompatibilityRecoverySchema,
-});
-export class AxmSkillCompatibilityPolicy extends ServiceMap.Service()("@agentxm/extension-resolution/axm-skill-compatibility/AxmSkillCompatibilityPolicy") {
-}
-const wildcardRangePattern = /(?:^|[.\s])(?:[xX*])(?:$|[.\s])/u;
-const compatibilitySatisfies = (version, range) => semver.satisfies(version, range, { includePrerelease: true });
-const comparatorSetIsBounded = (comparators) => {
-    let hasLowerBound = false;
-    let hasUpperBound = false;
-    for (const comparator of comparators) {
-        if (comparator.value.length === 0)
-            continue;
-        switch (comparator.operator) {
-            case "":
-                hasLowerBound = true;
-                hasUpperBound = true;
-                break;
-            case ">":
-            case ">=":
-                hasLowerBound = true;
-                break;
-            case "<":
-            case "<=":
-                hasUpperBound = true;
-                break;
-        }
-    }
-    return hasLowerBound && hasUpperBound;
-};
-export const validateAxmSkillCliVersionRange = (value) => {
-    if (value.length === 0 || value.trim() !== value || wildcardRangePattern.test(value)) {
-        return { valid: false };
-    }
-    if (semver.validRange(value) === null)
-        return { valid: false };
-    try {
-        const range = new semver.Range(value);
-        return range.set.length > 0 && range.set.every(comparatorSetIsBounded)
-            ? { valid: true }
-            : { valid: false };
-    }
-    catch {
-        return { valid: false };
-    }
-};
-const recoveryStep = (boundary, command, preview) => ({ boundary, command, preview });
-const bundledSkillRecovery = (cliVersion) => ({
-    action: "install-bundled-skill",
-    targetCliVersion: cliVersion,
-    targetSkillVersion: cliVersion,
-    nextAction: AXM_SKILL_BUNDLED_PREVIEW_COMMAND,
-    steps: [
-        recoveryStep("workspace", AXM_SKILL_BUNDLED_PREVIEW_COMMAND, true),
-        recoveryStep("workspace", AXM_SKILL_BUNDLED_APPLY_COMMAND, false),
-        recoveryStep("verification", "axm lint", false),
-    ],
-});
-const isAuthoredSource = (source) => source === "workspace";
-const isRegistrySource = (source) => source === AXM_SKILL_FQN ||
-    source?.startsWith(`${AXM_SKILL_FQN}@`) === true ||
-    source === AXM_SKILL_AGENTXM_SOURCE ||
-    source?.startsWith(`${AXM_SKILL_AGENTXM_SOURCE}@`) === true;
-const registrySkillRecovery = (cliVersion) => ({
-    action: "update-registry-skill",
-    targetCliVersion: cliVersion,
-    targetSkillVersion: cliVersion,
-    nextAction: AXM_SKILL_REGISTRY_PREVIEW_COMMAND,
-    steps: [
-        recoveryStep("workspace", AXM_SKILL_REGISTRY_PREVIEW_COMMAND, true),
-        recoveryStep("workspace", AXM_SKILL_REGISTRY_APPLY_COMMAND, false),
-        recoveryStep("verification", "axm lint", false),
-    ],
-});
-const deriveRecovery = (compatibility) => {
-    if (compatibility.status === "compatible") {
-        return {
-            action: "none",
-            targetCliVersion: compatibility.cliVersion,
-            targetSkillVersion: compatibility.skillVersion,
-            nextAction: null,
-            steps: [],
-        };
-    }
-    if (compatibility.reasonCode === "cli-version-unavailable") {
-        return {
-            action: "inspect-cli",
-            targetCliVersion: null,
-            targetSkillVersion: compatibility.skillVersion,
-            nextAction: "axm --version",
-            steps: [
-                recoveryStep("verification", "axm --version", false),
-                recoveryStep("verification", "axm lint", false),
-            ],
-        };
-    }
-    if (compatibility.reasonCode === "cli-version-incompatible" &&
-        compatibility.cliVersion !== null &&
-        compatibility.declaredCliVersionRange !== null) {
-        const minimum = semver.minVersion(compatibility.declaredCliVersionRange);
-        if (minimum !== null && semver.lt(compatibility.cliVersion, minimum)) {
-            return {
-                action: "upgrade-cli",
-                targetCliVersion: compatibility.declaredCliVersion ?? minimum.version,
-                targetSkillVersion: compatibility.skillVersion,
-                nextAction: "axm upgrade",
-                steps: [
-                    recoveryStep("executable", "axm upgrade", false),
-                    recoveryStep("verification", "axm lint", false),
-                ],
-            };
-        }
-    }
-    if (isAuthoredSource(compatibility.source)) {
-        return {
-            action: "preserve-authored-skill",
-            targetCliVersion: compatibility.cliVersion,
-            targetSkillVersion: compatibility.cliVersion,
-            nextAction: "axm help upgrade",
-            steps: [recoveryStep("verification", "axm help upgrade", false)],
-        };
-    }
-    if (isRegistrySource(compatibility.source) && compatibility.cliVersion !== null) {
-        return registrySkillRecovery(compatibility.cliVersion);
-    }
-    return compatibility.cliVersion === null
-        ? {
-            action: "inspect-cli",
-            targetCliVersion: null,
-            targetSkillVersion: compatibility.skillVersion,
-            nextAction: "axm --version",
-            steps: [recoveryStep("verification", "axm --version", false)],
-        }
-        : bundledSkillRecovery(compatibility.cliVersion);
-};
-const withRecovery = (compatibility) => ({
-    ...compatibility,
-    recovery: deriveRecovery(compatibility),
-});
-const incompatible = (fields, reasonCode, detail) => withRecovery({
-    status: "incompatible",
-    ...fields,
-    reasonCode,
-    detail,
-});
-export const evaluateAxmSkillCompatibility = (input) => {
-    const cliVersion = input.cliVersion === null ? null : semver.valid(input.cliVersion);
-    const skillVersion = input.skill?.manifestVersion ?? null;
-    const source = input.skill?.source ?? null;
-    const declaredCliVersion = input.skill?.metadata?.[AXM_SKILL_CLI_VERSION_METADATA_KEY] ?? null;
-    const declaredCliVersionRange = input.skill?.metadata?.[AXM_SKILL_CLI_VERSION_RANGE_METADATA_KEY] ?? null;
-    const fields = {
-        cliVersion,
-        skillVersion,
-        source,
-        declaredCliVersion,
-        declaredCliVersionRange,
-    };
-    if (cliVersion === null) {
-        return incompatible(fields, "cli-version-unavailable", "The running AXM CLI version is unavailable or invalid.");
-    }
-    if (input.skill === null) {
-        return incompatible(fields, "axm-skill-missing", "The official @agentxm/skills/axm skill is not installed.");
-    }
-    const validSkillVersion = input.skill.manifestVersion === null ? null : semver.valid(input.skill.manifestVersion);
-    if (validSkillVersion === null) {
-        return incompatible(fields, "axm-skill-manifest-invalid", "The official AXM skill manifest has a missing or invalid version.");
-    }
-    if (declaredCliVersion === null || declaredCliVersionRange === null) {
-        return incompatible(fields, "compatibility-metadata-missing", `The official AXM skill must declare ${AXM_SKILL_CLI_VERSION_METADATA_KEY} and ${AXM_SKILL_CLI_VERSION_RANGE_METADATA_KEY}.`);
-    }
-    if (semver.valid(declaredCliVersion) === null ||
-        !validateAxmSkillCliVersionRange(declaredCliVersionRange).valid) {
-        return incompatible(fields, "compatibility-metadata-malformed", "The official AXM skill compatibility metadata must contain an exact release and a bounded, wildcard-free semver range.");
-    }
-    if (validSkillVersion !== declaredCliVersion) {
-        return incompatible(fields, "skill-release-mismatch", `The AXM skill manifest reports ${validSkillVersion}, but ${AXM_SKILL_CLI_VERSION_METADATA_KEY} reports ${declaredCliVersion}.`);
-    }
-    if (!compatibilitySatisfies(declaredCliVersion, declaredCliVersionRange)) {
-        return incompatible(fields, "skill-release-range-mismatch", `The AXM skill release ${declaredCliVersion} is outside its declared CLI range ${declaredCliVersionRange}.`);
-    }
-    if (!compatibilitySatisfies(cliVersion, declaredCliVersionRange)) {
-        return incompatible(fields, "cli-version-incompatible", `AXM CLI ${cliVersion} is outside the official AXM skill range ${declaredCliVersionRange}.`);
-    }
-    return withRecovery({
-        status: "compatible",
-        ...fields,
-        reasonCode: null,
-        detail: null,
-    });
-};
-export const makeAxmSkillCompatibilityPolicyLayer = (cliVersion) => Layer.succeed(AxmSkillCompatibilityPolicy, {
-    evaluate: (input) => input.fqn === AXM_SKILL_FQN
-        ? evaluateAxmSkillCompatibility({ cliVersion, skill: input.candidate })
-        : null,
-});
-//# sourceMappingURL=axm-skill-compatibility.js.map