@agentxm/workspace-operations 0.28.4-bootstrap.0 → 0.28.5

package/dist/src/operations/load-workspace.d.ts

@@ -22,8 +22,8 @@ export declare const makeWorkspaceTransactionCapabilities: MakeWorkspaceTransact
  *
  * Loads an existing workspace from disk.
  *
- * The workspace must already be initialized. Missing or invalid settings fail
- * fast with an `AppError`.
+ * The workspace must already be initialized. Missing or invalid settings and
+ * invalid or unsupported lockfiles fail fast with a typed workspace error.
  *
  * @param options - WorkspaceMutations layer options
  * @returns Effect yielding WorkspaceMutationsService

package/dist/src/operations/load-workspace.js

@@ -56,8 +56,8 @@ export const makeWorkspaceTransactionCapabilities = ({ workspaceDir, settingsPat
  *
  * Loads an existing workspace from disk.
  *
- * The workspace must already be initialized. Missing or invalid settings fail
- * fast with an `AppError`.
+ * The workspace must already be initialized. Missing or invalid settings and
+ * invalid or unsupported lockfiles fail fast with a typed workspace error.
  *
  * @param options - WorkspaceMutations layer options
  * @returns Effect yielding WorkspaceMutationsService

package/dist/src/plan/step-failure-conversions.js

@@ -41,13 +41,60 @@ export const workspaceStateReadFailureToStepFailure = (error) => {
                 cause: error,
             });
         case "LockfileIoError":
+            return new StepFailure({
+                category: "validation",
+                detail: `Workspace lockfile at ${error.path} could not be read`,
+                suggestions: [
+                    {
+                        description: "Repair the lockfile permissions or restore a known-good copy, then re-run.",
+                    },
+                ],
+                cause: error,
+            });
         case "LockfileParseError":
+            return new StepFailure({
+                category: "validation",
+                detail: `Workspace lockfile at ${error.path} is not valid YAML`,
+                suggestions: [
+                    {
+                        description: "Fix the YAML syntax or restore a known-good lockfile, then re-run.",
+                    },
+                ],
+                cause: error,
+            });
         case "LockfileDecodeError":
             return new StepFailure({
                 category: "validation",
-                detail: `Failed to read the workspace lockfile. Fix the file's permissions or restore it from version control, then rerun.`,
+                detail: `Invalid workspace lockfile at ${error.path}: ${error.issues.join("; ")}`,
+                suggestions: [
+                    {
+                        description: "Correct the invalid values or restore a lockfile written in the supported format, then re-run.",
+                    },
+                ],
+                cause: error,
+            });
+        case "LockfileVersionUnsupported": {
+            const older = error.observedVersion < error.supportedVersion;
+            return new StepFailure({
+                category: "validation",
+                detail: older
+                    ? `Workspace lockfile at ${error.path} declares version ${error.observedVersion}, but this AXM supports version ${error.supportedVersion}. Re-accept the workspace intent into the current format before continuing.`
+                    : `Workspace lockfile at ${error.path} declares version ${error.observedVersion}, but this AXM supports version ${error.supportedVersion}. This workspace requires a newer AXM.`,
+                suggestions: older
+                    ? [
+                        {
+                            description: "Preserve the incompatible lockfile outside its authoritative path, review the desired workspace intent, then remove the incompatible file.",
+                        },
+                        {
+                            description: "Preview fresh resolution in the supported lockfile format.",
+                            cmd: "axm sync --preview",
+                        },
+                        { description: "Apply the reviewed resolution.", cmd: "axm sync" },
+                    ]
+                    : [{ description: "Upgrade AXM before accessing this workspace." }],
                 cause: error,
             });
+        }
         case "WorkspaceRootEscape":
             return new StepFailure({
                 category: "internal",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentxm/workspace-operations",
-  "version": "0.28.4-bootstrap.0",
+  "version": "0.28.5",
   "description": "AXM workspace operations kernel: plans, execution candidates, operation resolutions, and workspace transactions for the axm CLI. Unstable and unsupported — use the axm.sh CLI.",
   "type": "module",
   "license": "FSL-1.1-MIT",
@@ -18,14 +18,17 @@
   "exports": {
     ".": {
       "types": "./dist/src/index.d.ts",
+      "axm-source": "./src/index.ts",
       "default": "./dist/src/index.js"
     },
     "./live": {
       "types": "./dist/src/live.d.ts",
+      "axm-source": "./src/live.ts",
       "default": "./dist/src/live.js"
     },
     "./testing": {
       "types": "./dist/src/testing.d.ts",
+      "axm-source": "./src/testing.ts",
       "default": "./dist/src/testing.js"
     }
   },
@@ -45,9 +48,9 @@
   "dependencies": {
     "effect": "4.0.0-rc.112",
     "proper-lockfile": "^4.1.2",
-    "@agentxm/workspace-state": "^0.28.4-bootstrap.0",
-    "@agentxm/registry-protocol": "^0.28.4-bootstrap.0",
-    "@agentxm/extension-model": "^0.28.4-bootstrap.0"
+    "@agentxm/extension-model": "^0.28.5",
+    "@agentxm/registry-protocol": "^0.28.5",
+    "@agentxm/workspace-state": "^0.28.5"
   },
   "devDependencies": {
     "@effect/platform-node": "4.0.0-rc.112",