@arcforge/err 2.0.141 → 2.0.142

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@arcforge/err",
-    "version": "2.0.141",
+    "version": "2.0.142",
     "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.141"
+        "@arcforge/types": "2.0.142"
     },
     "devDependencies": {
         "@types/bun": "latest",

package/src/map.ts

@@ -864,6 +864,29 @@ export const errorMap = {
         source: "kernel",
         severity: "fatal",
     },
+    KNOWLEDGE_NOT_FOUND: {
+        code: "AX-KERNEL-011",
+        title: "Knowledge Entry Not Found",
+        description: "A cognet read a knowledge entry that does not exist. The knowledge store is not a cache — a brain reading something the catalogue advertised has hit a real inconsistency, so this is loud rather than an empty result.",
+        source: "kernel",
+        severity: "fatal",
+        expected: true,
+    },
+    KNOWLEDGE_READONLY: {
+        code: "AX-KERNEL-013",
+        title: "Knowledge Entry Is Read-Only",
+        description: "A cognet tried to write or remove knowledge contributed by a module. Module material lives inside its own package and the next install would destroy any change — so this fails loudly rather than succeeding and vanishing later. An agent's own data/knowledge/ is writable.",
+        source: "kernel",
+        severity: "fatal",
+        expected: true,
+    },
+    KNOWLEDGE_ESCAPE: {
+        code: "AX-KERNEL-012",
+        title: "Knowledge Path Escapes Store",
+        description: "A knowledge name resolved outside the store root. Names are identifiers, not paths — traversal is refused at the boundary rather than trusted not to happen.",
+        source: "kernel",
+        severity: "fatal",
+    },
     SCHEDULER_MODE_MISMATCH: {
         code: "AX-KERNEL-010",
         title: "Scheduler Mode Mismatch",
@@ -1882,6 +1905,14 @@ export const errorMap = {
         severity: "fatal",
         expected: true,
     },
+    COMMAND_INVALID: {
+        code: "AX-EXT-029",
+        title: "Command Is Not Registerable",
+        description: "A command was registered with no path, or with no `run` to call. Both are caught here rather than when someone presses Enter on it — a command that registers cleanly and then does nothing reads as a broken terminal instead of a config mistake, and gives no clue which file to open. Use `commands.register(path, fn)` or `commands.register(path, { run })`.",
+        source: "tui",
+        severity: "degraded",
+        expected: true,
+    },
     COMMAND_PATH_TAKEN: {
         code: "AX-EXT-020",
         title: "Command Already Registered",