@arcforge/err 2.0.111 → 2.0.113

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@arcforge/err",
-    "version": "2.0.111",
+    "version": "2.0.113",
     "description": "Structured Axon errors — the code map every user-facing failure is rendered from.",
     "type": "module",
     "private": false,
@@ -15,7 +15,7 @@
         "deploy": "echo \"This package is published ONLY by apps/tui/scripts/release.ts, which pins workspace:* deps to concrete versions first. Publishing it directly ships an unresolvable dependency.\" && exit 1"
     },
     "dependencies": {
-        "@arcforge/types": "2.0.111"
+        "@arcforge/types": "2.0.113"
     },
     "devDependencies": {
         "@types/bun": "latest",

package/src/map.ts

@@ -49,7 +49,7 @@ export const errorMap = {
     PROMPT_NOT_FOUND: {
         code: "AX-PROMPT-001",
         title: "Prompt Not Found",
-        description: "The requested prompt was not found in the agent's blueprint. It may not be declared, or the agent needs to be re-prepared.",
+        description: "The requested prompt could not be resolved — it is not declared by the agent, or the published package it names ships no prompt by that name.",
         source: "runtime",
         severity: "fatal",
     },
@@ -202,6 +202,13 @@ export const errorMap = {
         source: "cognet",
         severity: "fatal",
     },
+    COGNET_RUNTIME_UNAVAILABLE: {
+        code: "AX-COGNET-014",
+        title: "Cognet Runtime Temporarily Unavailable",
+        description: "The cognet runtime is declared but not present on disk — the dependency tree is mid-rewrite. Transient: the reload keeps the previous blueprint and picks the change up on the next watch event.",
+        source: "cognet",
+        severity: "recovered",
+    },
     COGNET_NOT_FOUND: {
         code: "AX-COGNET-013",
         title: "Cognet Not Found",
@@ -225,6 +232,13 @@ export const errorMap = {
         source: "manifest",
         severity: "fatal",
     },
+    CONFIG_ENGINE_UNPARSEABLE: {
+        code: "AX-PROJECT-033",
+        title: "Could Not Edit The Engine In axon.config.ts",
+        description: "The agent's `engine: X({ ... })` declaration could not be located or rewritten automatically — set the model by hand.",
+        source: "manifest",
+        severity: "fatal",
+    },
     MODULE_DEPENDENCY_INSTALL_FAILED: {
         code: "AX-PROJECT-004",
         title: "Module Dependencies Failed To Install",
@@ -327,6 +341,34 @@ export const errorMap = {
         source: "manifest",
         severity: "fatal",
     },
+    MODEL_SPECIFIER_INVALID: {
+        code: "AX-MODEL-001",
+        title: "Malformed Model Specifier",
+        description: "A `models:` entry in cognet.config.ts could not be parsed. The short form is `hf:owner/repo/path/to/file` — a repo alone is ambiguous, since one repo holds many weights.",
+        source: "manifest",
+        severity: "fatal",
+    },
+    MODEL_FETCH_FAILED: {
+        code: "AX-MODEL-002",
+        title: "Model Weights Could Not Be Fetched",
+        description: "A declared model could not be downloaded. Check the repo, file path and revision, and that the machine can reach the registry. A brain without its weights is broken rather than degraded, so this fails at prepare instead of at first inference.",
+        source: "manifest",
+        severity: "fatal",
+    },
+    MODEL_HASH_MISMATCH: {
+        code: "AX-MODEL-003",
+        title: "Model Weights Failed Verification",
+        description: "Downloaded bytes did not hash to the expected value — the upstream file changed, or the download was corrupted. Nothing is cached: storing unverified weights would make every later run trust them.",
+        source: "manifest",
+        severity: "fatal",
+    },
+    MODEL_NOT_CACHED: {
+        code: "AX-MODEL-004",
+        title: "Declared Model Is Not Cached",
+        description: "`--frozen` asserts the machine is already provisioned, so it will not fetch. Run `axon prepare` without --frozen to populate the model cache.",
+        source: "manifest",
+        severity: "fatal",
+    },
     PREPARE_FROZEN_DRIFT: {
         code: "AX-PROJECT-014",
         title: "Dependencies Drifted From The Lockfile",
@@ -1062,6 +1104,13 @@ export const errorMap = {
         source: "tui",
         severity: "fatal",
     },
+    MODEL_IMMUTABLE_DEPLOYED: {
+        code: "AX-TUI-006",
+        title: "Cannot Change A Deployment's Model",
+        description: "A deployed agent's config lives in the cloud, not on this machine — its model is fixed at deploy time. Change it in the local project and deploy again.",
+        source: "tui",
+        severity: "fatal",
+    },
     MODULE_INSTALL_FAILED: {
         code: "AX-TUI-018",
         title: "Module Install Failed",
@@ -1076,20 +1125,6 @@ export const errorMap = {
         source: "tui",
         severity: "fatal",
     },
-    BASE_UNMANAGED: {
-        code: "AX-TUI-006",
-        title: "Base Config Not Platform-Managed",
-        description: "The managed base workspace's config exists on disk but carries no platform manifest — it wasn't created by the platform and won't be overwritten automatically.",
-        source: "tui",
-        severity: "fatal",
-    },
-    BASE_CONFIG_MODIFIED: {
-        code: "AX-TUI-007",
-        title: "Base Config Edited By Hand",
-        description: "The managed base workspace's config no longer matches the hash the platform recorded — someone edited it directly, so the platform refuses to overwrite it.",
-        source: "tui",
-        severity: "fatal",
-    },
     DEPLOYMENT_NOT_CONNECTABLE: {
         code: "AX-TUI-028",
         title: "Deployment Not Connectable",