@arcforge/err 2.0.101 → 2.0.102

package/package.json

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

package/src/map.ts

@@ -490,7 +490,7 @@ export const errorMap = {
         source: "bench",
         severity: "fatal",
     },
-    BENCH_FACTOR_UNKNOWN: {
+    BENCH_AXIS_UNKNOWN: {
         code: "AX-BENCH-018",
         title: "Unknown Bench Factor",
         description: "Something referenced a factor id the running bench's coordinate never assigned a value to.",
@@ -511,42 +511,70 @@ export const errorMap = {
         source: "bench",
         severity: "fatal",
     },
-    BENCH_FACTOR_NOT_FOUND: {
+    BENCH_SCHEMA_UNREADABLE: {
+        code: "AX-BENCH-030",
+        title: "Bench Schema Unreadable",
+        description: "bench.config.ts could not be parsed while extracting the measurement schema.",
+        source: "bench",
+        severity: "fatal",
+    },
+    BENCH_SCHEMA_EMPTY: {
+        code: "AX-BENCH-031",
+        title: "Bench Schema Empty",
+        description: "defineBench<Schema> was given a type with no properties — an empty schema and a failed extraction must never look alike.",
+        source: "bench",
+        severity: "fatal",
+    },
+    BENCH_SCHEMA_UNSUPPORTED_TYPE: {
+        code: "AX-BENCH-032",
+        title: "Bench Measurement Type Unsupported",
+        description: "A measurement is not a boolean, number, union of string literals, or string.",
+        source: "bench",
+        severity: "fatal",
+    },
+    BENCH_SCHEMA_EXTRACTION_FAILED: {
+        code: "AX-BENCH-033",
+        title: "Bench Schema Extraction Failed",
+        description: "The schema worker did not return a schema. Prepare fails rather than continuing with an empty one, which would silently make every measurement undeclared.",
+        source: "bench",
+        severity: "fatal",
+    },
+    BENCH_AXIS_NOT_FOUND: {
         code: "AX-BENCH-021",
-        title: "Bench Factor Not Found",
-        description: "The bench config has no factor with this id.",
+        title: "Bench Axis Not Found",
+        description: "The bench config's matrix has no axis with this key.",
         source: "bench",
         severity: "fatal",
     },
-    BENCH_FACTOR_VALUE_NOT_FOUND: {
+    BENCH_AXIS_VALUE_NOT_FOUND: {
         code: "AX-BENCH-022",
-        title: "Bench Factor Value Not Found",
-        description: "The bench config's factor has no declared value with this id.",
+        title: "Bench Axis Value Not Found",
+        description: "The bench config's matrix axis has no declared value with this id.",
         source: "bench",
         severity: "fatal",
     },
-    BENCH_TEMPLATE_ESCAPE: {
+    BENCH_WORKSPACE_ESCAPE: {
         code: "AX-BENCH-023",
-        title: "Bench Template Path Escapes Root",
-        description: "A workspace template entry resolved to a path outside the template directory — refused rather than materialized.",
+        title: "Bench Workspace Path Escapes Root",
+        description: "A workspace source entry resolved to a path outside the workspace directory — refused rather than materialized.",
         source: "bench",
         severity: "fatal",
     },
-    BENCH_TEMPLATE_SYMLINK_UNSUPPORTED: {
+    BENCH_WORKSPACE_SYMLINK_UNSUPPORTED: {
         code: "AX-BENCH-024",
-        title: "Bench Template Symlinks Unsupported",
-        description: "A workspace template contains a symlink — not supported when materializing a bench workspace.",
+        title: "Bench Workspace Symlinks Unsupported",
+        description: "A workspace source contains a symlink — not supported when materializing a bench workspace.",
         source: "bench",
         severity: "fatal",
     },
-    BENCH_TEMPLATE_OUTSIDE_ROOT: {
+    BENCH_WORKSPACE_OUTSIDE_ROOT: {
         code: "AX-BENCH-025",
         title: "Bench Template Outside Root",
         description: "A workspace template's declared source path resolves outside the bench project root.",
         source: "bench",
         severity: "fatal",
     },
-    BENCH_TEMPLATE_NOT_FOUND: {
+    BENCH_WORKSPACE_SOURCE_NOT_FOUND: {
         code: "AX-BENCH-026",
         title: "Bench Template Not Found",
         description: "A workspace template's declared source path isn't a real directory.",
@@ -724,6 +752,13 @@ export const errorMap = {
         source: "runtime",
         severity: "fatal",
     },
+    BUS_HANDLER_FAILED: {
+        code: "AX-RUNTIME-004",
+        title: "Bus Handler Failed",
+        description: "A handler subscribed to a runtime bus event threw. Handler failures are non-fatal by design — the remaining handlers still run — but they are recorded rather than swallowed, since plugins and modules register handlers and a silently-broken one is invisible rot.",
+        source: "runtime",
+        severity: "degraded",
+    },
     TOOL_CALL_FAILED: {
         code: "AX-RUNTIME-003",
         title: "Tool Call Failed",
@@ -824,6 +859,62 @@ export const errorMap = {
         source: "capsule",
         severity: "fatal",
     },
+    CAPSULE_CRASHED: {
+        code: "AX-CAPSULE-015",
+        title: "Capsule Crashed",
+        description: "An unhandled error escaped inside the sandbox subprocess. The capsule reports it on the wire and exits immediately — after an unhandled throw the sandbox's state is unknown, and a capsule that keeps serving is worse than one that dies loudly.",
+        source: "capsule",
+        severity: "fatal",
+    },
+    CAPSULE_DEAD: {
+        code: "AX-CAPSULE-016",
+        title: "Capsule Dead",
+        description: "The capsule subprocess is gone and supervision gave up restarting it. Every subsequent execution request fails until a new capsule is booted.",
+        source: "capsule",
+        severity: "fatal",
+    },
+    CAPSULE_PARSE_ERROR: {
+        code: "AX-CAPSULE-017",
+        title: "Capsule Wire Parse Error",
+        description: "A line arriving from the sandbox was not a valid protocol event. The sandbox is speaking garbage — a protocol mismatch or corrupted output — and the line is dropped rather than acted on, never silently.",
+        source: "capsule",
+        severity: "degraded",
+    },
+    CAPSULE_CMD_FAILED: {
+        code: "AX-CAPSULE-018",
+        title: "Capsule Command Failed",
+        description: "Code executed in the sandbox threw. This is the ordinary failure path for an agent-emitted block or a script-land run() — the error is the sandboxed code's own, surfaced verbatim.",
+        source: "capsule",
+        severity: "degraded",
+    },
+    CAPSULE_FN_FAILED: {
+        code: "AX-CAPSULE-019",
+        title: "Tool Call Threw",
+        description: "A mediated tool function threw inside the sandbox. The failure is the tool's own; it propagates to the calling code unchanged and is recorded as the closing half of the call's span.",
+        source: "capsule",
+        severity: "degraded",
+    },
+    CAPSULE_PROC_DENIED: {
+        code: "AX-CAPSULE-020",
+        title: "Process Spawn Denied",
+        description: "A process the sandbox tried to start was refused — denied by policy, killed before it could spawn, or the spawn itself failed. No process was created.",
+        source: "capsule",
+        severity: "degraded",
+    },
+    CAPSULE_PROC_FAILED: {
+        code: "AX-CAPSULE-022",
+        title: "Managed Process Failed",
+        description: "A spawned child process errored without ever producing an exit code — an exec failure or a broken IPC channel. Distinct from a non-zero exit, which is the process running correctly and reporting a result.",
+        source: "capsule",
+        severity: "degraded",
+    },
+    CAPSULE_PROC_STDIN_FAILED: {
+        code: "AX-CAPSULE-021",
+        title: "Process Stdin Write Failed",
+        description: "Writing to a managed child process's stdin failed — the process is no longer running, or its stdin has already closed.",
+        source: "capsule",
+        severity: "degraded",
+    },
 
     // ── TUI (useAgents.ts / platform/build/agent / platform/store / platform/services/cloud) ──
     NOT_BOOTED: {