fix(status): lead unresponsive documents with the typed reason

.changeset/status-unreachable-reason.md

@@ -0,0 +1,5 @@
+---
+"cargo-hauler": patch
+---
+
+`hauler status`, `log`, `last`, and the dashboard now lead with why an unresponsive daemon could not be read, such as `socket could not be opened (EACCES)`, instead of claiming the daemon is up but slow.

artifact/bin/cargo-hauler-flight.mjs

@@ -20369,7 +20369,8 @@ const savedComputeSourceSchema = zod__rspack_import_1/* ["enum"] */.k5n([
     'estimate'
 ]);
 /**
- * `unresponsive`: the socket exists and a process holds it, but it did not answer in time.
+ * `unresponsive`: the socket exists but did not answer (timed out, closed, or refused the open);
+ * the summary's first line names which.
  * `skewed`: a live daemon of another release or build answered with a status report this
  * client cannot decode; tickets come from the ledger with their recorded status.
  */ const daemonStatusSchema = zod__rspack_import_1/* ["enum"] */.k5n([
@@ -22799,7 +22800,7 @@ __webpack_require__.d(__webpack_exports__, {
 
 
 
-/** A skewed daemon's rows read as live, so its summary line (what it is, the fix) leads. */ const withDaemonLine = (snapshot, summary)=>snapshot.daemon === 'skewed' ? `${snapshot.summary}\n${summary}` : summary;
+/** A skewed or unresponsive daemon's summary line (what failed, the fix) leads. */ const withDaemonLine = (snapshot, summary)=>snapshot.daemon === 'skewed' || snapshot.daemon === 'unresponsive' ? `${snapshot.summary}\n${summary}` : summary;
 // Through the ticket boundary runner so MCP/CLI cancellation aborts the
 // socket wait and replacement failures become clear transport diagnostics.
 const loadSnapshot = (limit, options)=>(0,_ticket_errors_js__rspack_import_2/* .runTicketEffect */.n)((0,_status_js__rspack_import_1/* .loadHaulerSnapshot */.M3)({
@@ -22912,7 +22913,7 @@ const daemonHeader = (daemon)=>{
         case 'stopped':
             return 'cargo-hauler daemon is not running';
         case 'unresponsive':
-            return 'cargo-hauler daemon is up but did not answer in time (showing ledger data)';
+            return 'cargo-hauler daemon is unresponsive (showing ledger data)';
         case 'skewed':
             return 'cargo-hauler daemon is running but its status report is unreadable (showing ledger data)';
         default:

artifact/bin/cargo-hauler.mjs

@@ -22211,7 +22211,8 @@ const savedComputeSourceSchema = zod__rspack_import_1/* ["enum"] */.k5n([
     'estimate'
 ]);
 /**
- * `unresponsive`: the socket exists and a process holds it, but it did not answer in time.
+ * `unresponsive`: the socket exists but did not answer (timed out, closed, or refused the open);
+ * the summary's first line names which.
  * `skewed`: a live daemon of another release or build answered with a status report this
  * client cannot decode; tickets come from the ledger with their recorded status.
  */ const daemonStatusSchema = zod__rspack_import_1/* ["enum"] */.k5n([
@@ -31964,7 +31965,7 @@ __webpack_require__.d(__webpack_exports__, {
 
 
 
-/** A skewed daemon's rows read as live, so its summary line (what it is, the fix) leads. */ const withDaemonLine = (snapshot, summary)=>snapshot.daemon === 'skewed' ? `${snapshot.summary}\n${summary}` : summary;
+/** A skewed or unresponsive daemon's summary line (what failed, the fix) leads. */ const withDaemonLine = (snapshot, summary)=>snapshot.daemon === 'skewed' || snapshot.daemon === 'unresponsive' ? `${snapshot.summary}\n${summary}` : summary;
 // Through the ticket boundary runner so MCP/CLI cancellation aborts the
 // socket wait and replacement failures become clear transport diagnostics.
 const loadSnapshot = (limit, options)=>(0,_ticket_errors_js__rspack_import_2/* .runTicketEffect */.n)((0,_status_js__rspack_import_1/* .loadHaulerSnapshot */.M3)({
@@ -32077,7 +32078,7 @@ const daemonHeader = (daemon)=>{
         case 'stopped':
             return 'cargo-hauler daemon is not running';
         case 'unresponsive':
-            return 'cargo-hauler daemon is up but did not answer in time (showing ledger data)';
+            return 'cargo-hauler daemon is unresponsive (showing ledger data)';
         case 'skewed':
             return 'cargo-hauler daemon is running but its status report is unreadable (showing ledger data)';
         default:

artifact/hooks/event-route-session-start.claude.mjs

@@ -79622,7 +79622,7 @@ __webpack_require__.a(__webpack_module__, async function (__rspack_load_async_de
 
 
 
-const artifactEpoch = "502ed577e2fc2110182a9a185970474ea06163ed49e1683d179f38e74288c822";
+const artifactEpoch = "f95bb0a6cd75d8eb752f255d57139cfdd021ca0340f405564fc562b21e2ac416";
 const flightArtifactEpoch = "cargo-hauler@0.9.13";
 const canonicalEvent = "session/start";
 const capabilityRevision = "2.1.260";

artifact/hooks/event-route-session-start.codex.mjs

@@ -79622,7 +79622,7 @@ __webpack_require__.a(__webpack_module__, async function (__rspack_load_async_de
 
 
 
-const artifactEpoch = "502ed577e2fc2110182a9a185970474ea06163ed49e1683d179f38e74288c822";
+const artifactEpoch = "f95bb0a6cd75d8eb752f255d57139cfdd021ca0340f405564fc562b21e2ac416";
 const flightArtifactEpoch = "cargo-hauler@0.9.13";
 const canonicalEvent = "session/start";
 const capabilityRevision = "0.147.0";

artifact/hooks/event-route-session-start.cursor.mjs

@@ -79622,7 +79622,7 @@ __webpack_require__.a(__webpack_module__, async function (__rspack_load_async_de
 
 
 
-const artifactEpoch = "502ed577e2fc2110182a9a185970474ea06163ed49e1683d179f38e74288c822";
+const artifactEpoch = "f95bb0a6cd75d8eb752f255d57139cfdd021ca0340f405564fc562b21e2ac416";
 const flightArtifactEpoch = "cargo-hauler@0.9.13";
 const canonicalEvent = "session/start";
 const capabilityRevision = "2026-08-28";

artifact/hooks/event-route-stop.claude.mjs

@@ -79622,7 +79622,7 @@ __webpack_require__.a(__webpack_module__, async function (__rspack_load_async_de
 
 
 
-const artifactEpoch = "502ed577e2fc2110182a9a185970474ea06163ed49e1683d179f38e74288c822";
+const artifactEpoch = "f95bb0a6cd75d8eb752f255d57139cfdd021ca0340f405564fc562b21e2ac416";
 const flightArtifactEpoch = "cargo-hauler@0.9.13";
 const canonicalEvent = "stop";
 const capabilityRevision = "2.1.260";

artifact/hooks/event-route-stop.codex.mjs

@@ -79622,7 +79622,7 @@ __webpack_require__.a(__webpack_module__, async function (__rspack_load_async_de
 
 
 
-const artifactEpoch = "502ed577e2fc2110182a9a185970474ea06163ed49e1683d179f38e74288c822";
+const artifactEpoch = "f95bb0a6cd75d8eb752f255d57139cfdd021ca0340f405564fc562b21e2ac416";
 const flightArtifactEpoch = "cargo-hauler@0.9.13";
 const canonicalEvent = "stop";
 const capabilityRevision = "0.147.0";

artifact/hooks/event-route-stop.cursor.mjs

@@ -79622,7 +79622,7 @@ __webpack_require__.a(__webpack_module__, async function (__rspack_load_async_de
 
 
 
-const artifactEpoch = "502ed577e2fc2110182a9a185970474ea06163ed49e1683d179f38e74288c822";
+const artifactEpoch = "f95bb0a6cd75d8eb752f255d57139cfdd021ca0340f405564fc562b21e2ac416";
 const flightArtifactEpoch = "cargo-hauler@0.9.13";
 const canonicalEvent = "stop";
 const capabilityRevision = "2026-08-28";

artifact/hooks/event-route-tool-after.claude.execute.mjs

@@ -79621,7 +79621,7 @@ __webpack_require__.a(__webpack_module__, async function (__rspack_load_async_de
 
 
 
-const artifactEpoch = "502ed577e2fc2110182a9a185970474ea06163ed49e1683d179f38e74288c822";
+const artifactEpoch = "f95bb0a6cd75d8eb752f255d57139cfdd021ca0340f405564fc562b21e2ac416";
 const flightArtifactEpoch = "cargo-hauler@0.9.13";
 const canonicalEvent = "tool/after";
 const capabilityRevision = "2.1.260";

artifact/hooks/event-route-tool-after.claude.mjs

@@ -28148,7 +28148,7 @@ const prepareRouteInvocation = async (nativeInput, signal, observer, receipt)=>{
     return withEventState(signal, async (bindings)=>{
         const gate = await (0,_agent_bundle_runtime_request__rspack_import_6/* .runAgentRequest */.iC)({
             invocation: {
-                artifactEpoch: "502ed577e2fc2110182a9a185970474ea06163ed49e1683d179f38e74288c822",
+                artifactEpoch: "f95bb0a6cd75d8eb752f255d57139cfdd021ca0340f405564fc562b21e2ac416",
                 hostContractRevision: capabilityRevision,
                 kind: "event",
                 operationId: `event:${canonicalEvent}`,

artifact/hooks/event-route-tool-after.codex.execute.mjs

@@ -79621,7 +79621,7 @@ __webpack_require__.a(__webpack_module__, async function (__rspack_load_async_de
 
 
 
-const artifactEpoch = "502ed577e2fc2110182a9a185970474ea06163ed49e1683d179f38e74288c822";
+const artifactEpoch = "f95bb0a6cd75d8eb752f255d57139cfdd021ca0340f405564fc562b21e2ac416";
 const flightArtifactEpoch = "cargo-hauler@0.9.13";
 const canonicalEvent = "tool/after";
 const capabilityRevision = "0.147.0";

artifact/hooks/event-route-tool-after.codex.mjs

@@ -28148,7 +28148,7 @@ const prepareRouteInvocation = async (nativeInput, signal, observer, receipt)=>{
     return withEventState(signal, async (bindings)=>{
         const gate = await (0,_agent_bundle_runtime_request__rspack_import_6/* .runAgentRequest */.iC)({
             invocation: {
-                artifactEpoch: "502ed577e2fc2110182a9a185970474ea06163ed49e1683d179f38e74288c822",
+                artifactEpoch: "f95bb0a6cd75d8eb752f255d57139cfdd021ca0340f405564fc562b21e2ac416",
                 hostContractRevision: capabilityRevision,
                 kind: "event",
                 operationId: `event:${canonicalEvent}`,

artifact/hooks/event-route-tool-after.cursor.execute.mjs

@@ -79621,7 +79621,7 @@ __webpack_require__.a(__webpack_module__, async function (__rspack_load_async_de
 
 
 
-const artifactEpoch = "502ed577e2fc2110182a9a185970474ea06163ed49e1683d179f38e74288c822";
+const artifactEpoch = "f95bb0a6cd75d8eb752f255d57139cfdd021ca0340f405564fc562b21e2ac416";
 const flightArtifactEpoch = "cargo-hauler@0.9.13";
 const canonicalEvent = "tool/after";
 const capabilityRevision = "2026-08-28";

artifact/hooks/event-route-tool-after.cursor.mjs

@@ -28148,7 +28148,7 @@ const prepareRouteInvocation = async (nativeInput, signal, observer, receipt)=>{
     return withEventState(signal, async (bindings)=>{
         const gate = await (0,_agent_bundle_runtime_request__rspack_import_6/* .runAgentRequest */.iC)({
             invocation: {
-                artifactEpoch: "502ed577e2fc2110182a9a185970474ea06163ed49e1683d179f38e74288c822",
+                artifactEpoch: "f95bb0a6cd75d8eb752f255d57139cfdd021ca0340f405564fc562b21e2ac416",
                 hostContractRevision: capabilityRevision,
                 kind: "event",
                 operationId: `event:${canonicalEvent}`,

artifact/hooks/event-route-tool-before.claude.execute.mjs

@@ -79621,7 +79621,7 @@ __webpack_require__.a(__webpack_module__, async function (__rspack_load_async_de
 
 
 
-const artifactEpoch = "502ed577e2fc2110182a9a185970474ea06163ed49e1683d179f38e74288c822";
+const artifactEpoch = "f95bb0a6cd75d8eb752f255d57139cfdd021ca0340f405564fc562b21e2ac416";
 const flightArtifactEpoch = "cargo-hauler@0.9.13";
 const canonicalEvent = "tool/before";
 const capabilityRevision = "2.1.260";

artifact/hooks/event-route-tool-before.claude.mjs

@@ -25375,7 +25375,7 @@ const prepareRouteInvocation = async (nativeInput, signal, observer, receipt)=>{
     return withEventState(signal, async (bindings)=>{
         const gate = await (0,_agent_bundle_runtime_request__rspack_import_6/* .runAgentRequest */.iC)({
             invocation: {
-                artifactEpoch: "502ed577e2fc2110182a9a185970474ea06163ed49e1683d179f38e74288c822",
+                artifactEpoch: "f95bb0a6cd75d8eb752f255d57139cfdd021ca0340f405564fc562b21e2ac416",
                 hostContractRevision: capabilityRevision,
                 kind: "event",
                 operationId: `event:${canonicalEvent}`,

artifact/hooks/event-route-tool-before.codex.execute.mjs

@@ -79621,7 +79621,7 @@ __webpack_require__.a(__webpack_module__, async function (__rspack_load_async_de
 
 
 
-const artifactEpoch = "502ed577e2fc2110182a9a185970474ea06163ed49e1683d179f38e74288c822";
+const artifactEpoch = "f95bb0a6cd75d8eb752f255d57139cfdd021ca0340f405564fc562b21e2ac416";
 const flightArtifactEpoch = "cargo-hauler@0.9.13";
 const canonicalEvent = "tool/before";
 const capabilityRevision = "0.147.0";

artifact/hooks/event-route-tool-before.codex.mjs

@@ -25375,7 +25375,7 @@ const prepareRouteInvocation = async (nativeInput, signal, observer, receipt)=>{
     return withEventState(signal, async (bindings)=>{
         const gate = await (0,_agent_bundle_runtime_request__rspack_import_6/* .runAgentRequest */.iC)({
             invocation: {
-                artifactEpoch: "502ed577e2fc2110182a9a185970474ea06163ed49e1683d179f38e74288c822",
+                artifactEpoch: "f95bb0a6cd75d8eb752f255d57139cfdd021ca0340f405564fc562b21e2ac416",
                 hostContractRevision: capabilityRevision,
                 kind: "event",
                 operationId: `event:${canonicalEvent}`,

artifact/hooks/event-route-tool-before.cursor.execute.mjs

@@ -79621,7 +79621,7 @@ __webpack_require__.a(__webpack_module__, async function (__rspack_load_async_de
 
 
 
-const artifactEpoch = "502ed577e2fc2110182a9a185970474ea06163ed49e1683d179f38e74288c822";
+const artifactEpoch = "f95bb0a6cd75d8eb752f255d57139cfdd021ca0340f405564fc562b21e2ac416";
 const flightArtifactEpoch = "cargo-hauler@0.9.13";
 const canonicalEvent = "tool/before";
 const capabilityRevision = "2026-08-28";

artifact/hooks/event-route-tool-before.cursor.mjs

@@ -25375,7 +25375,7 @@ const prepareRouteInvocation = async (nativeInput, signal, observer, receipt)=>{
     return withEventState(signal, async (bindings)=>{
         const gate = await (0,_agent_bundle_runtime_request__rspack_import_6/* .runAgentRequest */.iC)({
             invocation: {
-                artifactEpoch: "502ed577e2fc2110182a9a185970474ea06163ed49e1683d179f38e74288c822",
+                artifactEpoch: "f95bb0a6cd75d8eb752f255d57139cfdd021ca0340f405564fc562b21e2ac416",
                 hostContractRevision: capabilityRevision,
                 kind: "event",
                 operationId: `event:${canonicalEvent}`,

artifact/mcp/mcp-hauler-2b8242f9-flight.mjs

@@ -22599,7 +22599,8 @@ const savedComputeSourceSchema = zod__rspack_import_1/* ["enum"] */.k5n([
     'estimate'
 ]);
 /**
- * `unresponsive`: the socket exists and a process holds it, but it did not answer in time.
+ * `unresponsive`: the socket exists but did not answer (timed out, closed, or refused the open);
+ * the summary's first line names which.
  * `skewed`: a live daemon of another release or build answered with a status report this
  * client cannot decode; tickets come from the ledger with their recorded status.
  */ const daemonStatusSchema = zod__rspack_import_1/* ["enum"] */.k5n([
@@ -26898,7 +26899,7 @@ __webpack_require__.d(__webpack_exports__, {
 
 
 
-/** A skewed daemon's rows read as live, so its summary line (what it is, the fix) leads. */ const withDaemonLine = (snapshot, summary)=>snapshot.daemon === 'skewed' ? `${snapshot.summary}\n${summary}` : summary;
+/** A skewed or unresponsive daemon's summary line (what failed, the fix) leads. */ const withDaemonLine = (snapshot, summary)=>snapshot.daemon === 'skewed' || snapshot.daemon === 'unresponsive' ? `${snapshot.summary}\n${summary}` : summary;
 // Through the ticket boundary runner so MCP/CLI cancellation aborts the
 // socket wait and replacement failures become clear transport diagnostics.
 const loadSnapshot = (limit, options)=>(0,_ticket_errors_js__rspack_import_2/* .runTicketEffect */.n)((0,_status_js__rspack_import_1/* .loadHaulerSnapshot */.M3)({
@@ -27011,7 +27012,7 @@ const daemonHeader = (daemon)=>{
         case 'stopped':
             return 'cargo-hauler daemon is not running';
         case 'unresponsive':
-            return 'cargo-hauler daemon is up but did not answer in time (showing ledger data)';
+            return 'cargo-hauler daemon is unresponsive (showing ledger data)';
         case 'skewed':
             return 'cargo-hauler daemon is running but its status report is unreadable (showing ledger data)';
         default:

artifact/scripts/hauler.mjs

@@ -11197,7 +11197,8 @@ const savedComputeSourceSchema = zod__rspack_import_1/* ["enum"] */.k5n([
     'estimate'
 ]);
 /**
- * `unresponsive`: the socket exists and a process holds it, but it did not answer in time.
+ * `unresponsive`: the socket exists but did not answer (timed out, closed, or refused the open);
+ * the summary's first line names which.
  * `skewed`: a live daemon of another release or build answered with a status report this
  * client cannot decode; tickets come from the ledger with their recorded status.
  */ const daemonStatusSchema = zod__rspack_import_1/* ["enum"] */.k5n([

src/internal/contracts/tool-schemas.ts

@@ -36,7 +36,8 @@ const requestStatusSchema = z.enum(requestStatuses);
 const attachModeSchema = z.enum(attachModes);
 const savedComputeSourceSchema = z.enum(['exact', 'estimate']);
 /**
- * `unresponsive`: the socket exists and a process holds it, but it did not answer in time.
+ * `unresponsive`: the socket exists but did not answer (timed out, closed, or refused the open);
+ * the summary's first line names which.
  * `skewed`: a live daemon of another release or build answered with a status report this
  * client cannot decode; tickets come from the ledger with their recorded status.
  */

src/internal/operations/inspection.ts

@@ -27,9 +27,9 @@ export interface InspectOptions {
   readonly signal: AbortSignal;
 }
 
-/** A skewed daemon's rows read as live, so its summary line (what it is, the fix) leads. */
+/** A skewed or unresponsive daemon's summary line (what failed, the fix) leads. */
 const withDaemonLine = (snapshot: HaulerSnapshot, summary: string): string =>
-  snapshot.daemon === 'skewed' ? `${snapshot.summary}\n${summary}` : summary;
+  snapshot.daemon === 'skewed' || snapshot.daemon === 'unresponsive' ? `${snapshot.summary}\n${summary}` : summary;
 
 // Through the ticket boundary runner so MCP/CLI cancellation aborts the
 // socket wait and replacement failures become clear transport diagnostics.

src/internal/operations/status-filter.ts

@@ -36,7 +36,7 @@ const daemonHeader = (daemon: DaemonStatus): string => {
     case 'stopped':
       return 'cargo-hauler daemon is not running';
     case 'unresponsive':
-      return 'cargo-hauler daemon is up but did not answer in time (showing ledger data)';
+      return 'cargo-hauler daemon is unresponsive (showing ledger data)';
     case 'skewed':
       return 'cargo-hauler daemon is running but its status report is unreadable (showing ledger data)';
     default: {

src/mcp/hauler/apps/dashboard.tsx

@@ -1301,13 +1301,8 @@ const DashboardContent = ({ structured }: { readonly structured: DashboardStatus
                   maxConcurrent={maxConcurrent}
                 />
               </div>
-            ) : daemonState === 'skewed' ? (
+            ) : daemonState === 'skewed' || daemonState === 'unresponsive' ? (
               <p className="down-cue">{structured?.summary.split('\n', 1)[0]}</p>
-            ) : daemonState === 'unresponsive' ? (
-              <p className="down-cue">
-                Daemon is up but did not answer in time — the machine is saturated. Rows below
-                come from the ledger and in-flight runs are still live; this refreshes on the next poll.
-              </p>
             ) : (
               <p className="down-cue">
                 Daemon is not running — it starts on demand with any cargo exec, or run{' '}

tests/integration/query.test.ts

@@ -174,8 +174,8 @@ describe('status scoping', () => {
 
   it('distinguishes an unresponsive daemon from a stopped one in the header', () => {
     expect(statusSummary('running', [], [])).toBe('cargo-hauler daemon is running; 0 active, 0 recent');
-    expect(statusSummary('unresponsive', [running], [])).toContain(
-      'daemon is up but did not answer in time',
+    expect(statusSummary('unresponsive', [], [])).toBe(
+      'cargo-hauler daemon is unresponsive (showing ledger data); 0 active, 0 recent',
     );
     expect(statusSummary('stopped', [], [])).toContain('daemon is not running');
   });

tests/packaging/stopped-daemon-ticket-cli.test.ts

@@ -179,14 +179,29 @@ describe.skipIf(!existsSync(haulerEntry))('ticket reads on a stopped daemon', ()
       expect(haulerJson('await', 'cc-1')).toEqual(unreachable());
     });
 
+    it('reports status with the errno the socket refused, not a daemon that is up', () => {
+      const summary = [
+        'cargo-hauler daemon socket could not be opened (EACCES), so status shows ledger data (1 recorded)',
+        'cargo-hauler daemon is unresponsive (showing ledger data); 0 active, 1 recent',
+      ];
+      expect(haulerJson('status')).toMatchObject({
+        code: 0,
+        json: { daemon: 'unresponsive', operation: 'status', summary: summary.join('\n') },
+        stderr: '',
+      });
+      const run = hauler('status');
+      expect(run.code).toBe(0);
+      expect(run.stdout.split('\n', 1)).toEqual(summary.slice(0, 1));
+    });
+
     it('reports last on an unresponsive daemon, not a stopped one', () => {
       expect(haulerJson('last')).toEqual({
         code: 0,
         json: {
           daemon: 'unresponsive',
           operation: 'last',
           request: { ...seededRecord, error: 'daemon did not answer, so ownership is unconfirmed', status: 'orphaned' },
-          summary: 'cc-1 orphaned',
+          summary: 'cargo-hauler daemon socket could not be opened (EACCES), so status shows ledger data (1 recorded)\ncc-1 orphaned',
         },
         stderr: '',
       });