@agent-deck/cli 1.10.0 → 1.10.2

package/dist/menubar.d.ts

@@ -5,6 +5,19 @@ export declare function formatAge(lastActivityAt: string, now: Date): string;
 export declare function resolveDashboardBaseUrl(): string;
 export declare function buildApprovalHref(challenge: PendingAdminChallenge, _dashboardBaseUrl: string): string;
 export declare function buildOpenDashboardMenubarLine(): string;
+/** How the menu bar names itself when it stops the deck. */
+export declare const MENUBAR_STOP_SOURCE = "menubar";
+/**
+ * The menu bar's own stop, routed through `agent-deck stop --source` so the
+ * SIGTERM it causes is distinguishable in supervisor.log from a bare
+ * `kill -TERM` and from an operator's own `agent-deck stop` (NOT-135).
+ *
+ * The argv is deliberately space-free: SwiftBar splits `paramN=` values on
+ * whitespace, so a quoted `--detail "Quit Agent Deck"` would arrive as two
+ * arguments and lose the attribution this line exists to carry.
+ */
+export declare function buildStopDeckMenubarArgs(): string[];
+export declare function buildStopDeckMenubarLine(): string;
 /** SwiftBar/xbar output. `null` bindings = backend offline (accuracy first: dim, never guess). */
 export declare function renderMenubar(bindings: LiveBinding[] | null, now: Date, pendingApprovals?: PendingAdminChallenge[], dashboardBaseUrl?: string): string;
 export declare function runMenubar(): Promise<number>;

package/dist/menubar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"menubar.d.ts","sourceRoot":"","sources":["../src/menubar.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAM7E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAW,GAAG,MAAM,CAEjE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM,CAe9D;AAED,wBAAgB,SAAS,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM,CAkBnE;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAMhD;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,GAAG,MAAM,CAOrG;AAED,wBAAgB,6BAA6B,IAAI,MAAM,CAEtD;AAED,kGAAkG;AAClG,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,EAC9B,GAAG,EAAE,IAAI,EACT,gBAAgB,GAAE,qBAAqB,EAAO,EAC9C,gBAAgB,SAA4B,GAC3C,MAAM,CA+DR;AAyBD,wBAAsB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAwBlD"}
+{"version":3,"file":"menubar.d.ts","sourceRoot":"","sources":["../src/menubar.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAM7E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAW,GAAG,MAAM,CAEjE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM,CAe9D;AAED,wBAAgB,SAAS,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM,CAkBnE;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAMhD;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,GAAG,MAAM,CAOrG;AAED,wBAAgB,6BAA6B,IAAI,MAAM,CAEtD;AAED,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAE7C;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,EAAE,CAEnD;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CAKjD;AAED,kGAAkG;AAClG,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,EAC9B,GAAG,EAAE,IAAI,EACT,gBAAgB,GAAE,qBAAqB,EAAO,EAC9C,gBAAgB,SAA4B,GAC3C,MAAM,CAuER;AAyBD,wBAAsB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAwBlD"}

package/dist/menubar.js

@@ -3,12 +3,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.MENUBAR_STOP_SOURCE = void 0;
 exports.truncateName = truncateName;
 exports.formatTimeUntil = formatTimeUntil;
 exports.formatAge = formatAge;
 exports.resolveDashboardBaseUrl = resolveDashboardBaseUrl;
 exports.buildApprovalHref = buildApprovalHref;
 exports.buildOpenDashboardMenubarLine = buildOpenDashboardMenubarLine;
+exports.buildStopDeckMenubarArgs = buildStopDeckMenubarArgs;
+exports.buildStopDeckMenubarLine = buildStopDeckMenubarLine;
 exports.renderMenubar = renderMenubar;
 exports.runMenubar = runMenubar;
 const node_path_1 = __importDefault(require("node:path"));
@@ -71,6 +74,26 @@ function buildApprovalHref(challenge, _dashboardBaseUrl) {
 function buildOpenDashboardMenubarLine() {
     return 'Open dashboard | bash=agent-deck param1=open terminal=false';
 }
+/** How the menu bar names itself when it stops the deck. */
+exports.MENUBAR_STOP_SOURCE = 'menubar';
+/**
+ * The menu bar's own stop, routed through `agent-deck stop --source` so the
+ * SIGTERM it causes is distinguishable in supervisor.log from a bare
+ * `kill -TERM` and from an operator's own `agent-deck stop` (NOT-135).
+ *
+ * The argv is deliberately space-free: SwiftBar splits `paramN=` values on
+ * whitespace, so a quoted `--detail "Quit Agent Deck"` would arrive as two
+ * arguments and lose the attribution this line exists to carry.
+ */
+function buildStopDeckMenubarArgs() {
+    return ['stop', '--source', exports.MENUBAR_STOP_SOURCE, '--detail', 'menu-bar-stop-item'];
+}
+function buildStopDeckMenubarLine() {
+    const params = buildStopDeckMenubarArgs()
+        .map((arg, i) => `param${i + 1}=${arg}`)
+        .join(' ');
+    return `Stop Agent Deck | bash=agent-deck ${params} terminal=false refresh=true`;
+}
 /** SwiftBar/xbar output. `null` bindings = backend offline (accuracy first: dim, never guess). */
 function renderMenubar(bindings, now, pendingApprovals = [], dashboardBaseUrl = resolveDashboardBaseUrl()) {
     if (bindings === null) {
@@ -84,7 +107,15 @@ function renderMenubar(bindings, now, pendingApprovals = [], dashboardBaseUrl =
             : bindings.length === 0
                 ? '◆ —'
                 : `◆ ${bindings.length}`;
-    const lines = [title, '---', buildOpenDashboardMenubarLine(), '---'];
+    // The deck is up (bindings answered), so stopping it is an offer worth making
+    // — and it is the one stop path that has to name itself, since SIGTERM won't.
+    const lines = [
+        title,
+        '---',
+        buildOpenDashboardMenubarLine(),
+        buildStopDeckMenubarLine(),
+        '---',
+    ];
     if (pendingCount > 0) {
         lines.push('Admin approval pending | size=11 color=orange');
         for (const challenge of pendingApprovals) {

package/dist/menubar.js.map

@@ -1 +1 @@
-{"version":3,"file":"menubar.js","sourceRoot":"","sources":["../src/menubar.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"menubar.js","sourceRoot":"","sources":["../src/menubar.ts"],"names":[],"mappings":"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"}

package/dist/node-runtime.d.ts

@@ -1,12 +1,24 @@
 export declare function getNodeMajor(): number;
 export declare function formatNodeVersionError(): string;
-export declare function assertSupportedNodeVersion(): number | null;
+export declare function isSupportedNodeMajor(major?: number): boolean;
 /** Load better-sqlite3 from the CLI's backend dependency tree (catches ABI / cache mismatches). */
 export declare function verifySqliteNative(): {
     ok: true;
 } | {
     ok: false;
+    reason: string;
     message: string;
 };
-export declare function assertSqliteNative(): number | null;
+export interface PreflightFailure {
+    /** One line, for supervisor.log and `agent-deck status`. */
+    reason: string;
+    /** The full operator-facing explanation, already formatted for a terminal. */
+    message: string;
+}
+/**
+ * Runtime checks that must pass before anything is spawned. Returns the failure
+ * rather than printing it: a start that dies here has to end up in supervisor.log
+ * and `agent-deck status` too, not only on the terminal that invoked it.
+ */
+export declare function checkStartPreflight(): PreflightFailure | null;
 //# sourceMappingURL=node-runtime.d.ts.map

package/dist/node-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-runtime.d.ts","sourceRoot":"","sources":["../src/node-runtime.ts"],"names":[],"mappings":"AAMA,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAc/C;AAED,wBAAgB,0BAA0B,IAAI,MAAM,GAAG,IAAI,CAO1D;AAED,mGAAmG;AACnG,wBAAgB,kBAAkB,IAAI;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA0BlF;AAED,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAOlD"}
+{"version":3,"file":"node-runtime.d.ts","sourceRoot":"","sources":["../src/node-runtime.ts"],"names":[],"mappings":"AAMA,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAc/C;AAED,wBAAgB,oBAAoB,CAAC,KAAK,SAAiB,GAAG,OAAO,CAEpE;AAED,mGAAmG;AACnG,wBAAgB,kBAAkB,IAAI;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAqClG;AAMD,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,GAAG,IAAI,CAe7D"}

package/dist/node-runtime.js

@@ -2,9 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getNodeMajor = getNodeMajor;
 exports.formatNodeVersionError = formatNodeVersionError;
-exports.assertSupportedNodeVersion = assertSupportedNodeVersion;
+exports.isSupportedNodeMajor = isSupportedNodeMajor;
 exports.verifySqliteNative = verifySqliteNative;
-exports.assertSqliteNative = assertSqliteNative;
+exports.checkStartPreflight = checkStartPreflight;
 const paths_1 = require("./paths");
 /** Node majors we test against. 24 is the default target; 20+ remains supported. */
 const SUPPORTED_NODE_MAJORS = [20, 22, 23, 24, 25, 26];
@@ -27,13 +27,8 @@ function formatNodeVersionError() {
         `Unsupported major: ${major}. Native SQLite bindings (better-sqlite3) must match your Node version.`,
     ].join('\n');
 }
-function assertSupportedNodeVersion() {
-    const major = getNodeMajor();
-    if (SUPPORTED_NODE_MAJORS.includes(major)) {
-        return null;
-    }
-    console.error(formatNodeVersionError());
-    return 1;
+function isSupportedNodeMajor(major = getNodeMajor()) {
+    return SUPPORTED_NODE_MAJORS.includes(major);
 }
 /** Load better-sqlite3 from the CLI's backend dependency tree (catches ABI / cache mismatches). */
 function verifySqliteNative() {
@@ -42,14 +37,24 @@ function verifySqliteNative() {
             paths: [(0, paths_1.resolveBackendRoot)(), (0, paths_1.getCliPackageRoot)()],
         });
         // eslint-disable-next-line @typescript-eslint/no-require-imports
-        require(sqlitePath);
+        const Database = require(sqlitePath);
+        // `require` alone proves nothing: better-sqlite3 dlopens its .node binding
+        // lazily, on first Database construction. Without this probe an ABI
+        // mismatch passes preflight and only surfaces as the backend exiting 1.
+        const probe = new Database(':memory:');
+        probe.close();
         return { ok: true };
     }
     catch (error) {
         const detail = error instanceof Error ? error.message : String(error);
-        if (detail.includes('NODE_MODULE_VERSION')) {
+        // Node reports a failed dlopen as `code`, not in the message, and an
+        // arch mismatch ("incompatible architecture") never says NODE_MODULE_VERSION.
+        const code = error?.code ?? '';
+        if (detail.includes('NODE_MODULE_VERSION') || code === 'ERR_DLOPEN_FAILED') {
             return {
                 ok: false,
+                reason: `better-sqlite3 native module does not match node ${process.version} ` +
+                    `(NODE_MODULE_VERSION ${process.versions.modules}): ${firstLine(detail)}`,
                 message: [
                     'better-sqlite3 native module does not match this Node.js version.',
                     '',
@@ -61,15 +66,29 @@ function verifySqliteNative() {
                 ].join('\n'),
             };
         }
-        return { ok: false, message: detail };
+        return { ok: false, reason: `better-sqlite3 could not be loaded: ${firstLine(detail)}`, message: detail };
     }
 }
-function assertSqliteNative() {
-    const result = verifySqliteNative();
-    if (result.ok) {
-        return null;
+function firstLine(text) {
+    return text.split('\n')[0].trim();
+}
+/**
+ * Runtime checks that must pass before anything is spawned. Returns the failure
+ * rather than printing it: a start that dies here has to end up in supervisor.log
+ * and `agent-deck status` too, not only on the terminal that invoked it.
+ */
+function checkStartPreflight() {
+    const major = getNodeMajor();
+    if (!isSupportedNodeMajor(major)) {
+        return {
+            reason: `unsupported Node.js major ${major} (${process.version})`,
+            message: formatNodeVersionError(),
+        };
+    }
+    const sqlite = verifySqliteNative();
+    if (!sqlite.ok) {
+        return { reason: sqlite.reason, message: sqlite.message };
     }
-    console.error(result.message);
-    return 1;
+    return null;
 }
 //# sourceMappingURL=node-runtime.js.map

package/dist/node-runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"node-runtime.js","sourceRoot":"","sources":["../src/node-runtime.ts"],"names":[],"mappings":";;AAMA,oCAEC;AAED,wDAcC;AAED,gEAOC;AAGD,gDA0BC;AAED,gDAOC;AAvED,mCAAgE;AAEhE,oFAAoF;AACpF,MAAM,qBAAqB,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAU,CAAC;AAChE,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEhC,SAAgB,YAAY;IAC1B,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,SAAgB,sBAAsB;IACpC,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;IAC7B,OAAO;QACL,+CAA+C,OAAO,CAAC,OAAO,IAAI;QAClE,+BAA+B,oBAAoB,yBAAyB;QAC5E,EAAE;QACF,WAAW;QACX,iBAAiB,oBAAoB,eAAe,oBAAoB,eAAe;QACvF,wEAAwE;QACxE,qCAAqC;QACrC,oCAAoC;QACpC,EAAE;QACF,sBAAsB,KAAK,yEAAyE;KACrG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAgB,0BAA0B;IACxC,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;IAC7B,IAAK,qBAA2C,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACjE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,CAAC;AACX,CAAC;AAED,mGAAmG;AACnG,SAAgB,kBAAkB;IAChC,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE;YACnD,KAAK,EAAE,CAAC,IAAA,0BAAkB,GAAE,EAAE,IAAA,yBAAiB,GAAE,CAAC;SACnD,CAAC,CAAC;QACH,iEAAiE;QACjE,OAAO,CAAC,UAAU,CAAC,CAAC;QACpB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,IAAI,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAAC;YAC3C,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE;oBACP,mEAAmE;oBACnE,EAAE;oBACF,qDAAqD;oBACrD,sBAAsB;oBACtB,qCAAqC;oBACrC,EAAE;oBACF,MAAM;iBACP,CAAC,IAAI,CAAC,IAAI,CAAC;aACb,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IACxC,CAAC;AACH,CAAC;AAED,SAAgB,kBAAkB;IAChC,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;IACpC,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9B,OAAO,CAAC,CAAC;AACX,CAAC"}
+{"version":3,"file":"node-runtime.js","sourceRoot":"","sources":["../src/node-runtime.ts"],"names":[],"mappings":"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"}

package/dist/shutdown-reason.d.ts

@@ -0,0 +1,105 @@
+/**
+ * A SIGTERM carries no sender, so `agent-deck stop`, the menubar, an API call
+ * and `kill -TERM` all land in the same supervisor handler. The requester drops
+ * a short-lived note here first; the supervisor consumes it while shutting down
+ * so the log line can name the origin instead of only the exit code.
+ */
+export interface StopRequest {
+    /** Who asked for the stop — `agent-deck stop`, `menubar`, `api`, ... */
+    source: string;
+    /** Free-form context: `--force restart`, dashboard user, calling script. */
+    detail?: string;
+    requestedAt: string;
+    requesterPid: number;
+    /** Supervisor pid this request targets; 0 means "whichever instance is up". */
+    targetPid: number;
+}
+export interface LastStopRecord {
+    at: string;
+    exitCode: number;
+    reason: string;
+    supervisorPid: number;
+}
+/**
+ * A start that never reached the supervisor loop answers a different question
+ * ("why won't it start?") and lives in its own file, so it cannot overwrite the
+ * answer to "why did the deck stop?".
+ */
+export interface LastStartFailureRecord {
+    at: string;
+    exitCode: number;
+    reason: string;
+    pid: number;
+}
+/** A stop note older than this is stale — a previous run left it behind. */
+export declare const STOP_REQUEST_MAX_AGE_MS = 60000;
+export declare function stopRequestPath(): string;
+export declare function lastStopPath(): string;
+export declare function lastStartFailurePath(): string;
+export declare function recordStopRequest(input: {
+    source: string;
+    detail?: string;
+    targetPid?: number;
+    now?: Date;
+    requesterPid?: number;
+}): StopRequest;
+export declare function readStopRequest(): StopRequest | null;
+export declare function clearStopRequest(): void;
+/**
+ * Take the pending stop note if it is fresh and aimed at this supervisor.
+ * Always removes the file so a stale note cannot mislabel a later shutdown.
+ */
+export declare function consumeStopRequest(options: {
+    supervisorPid: number;
+    now?: Date;
+    maxAgeMs?: number;
+}): StopRequest | null;
+export declare function describeStopRequest(request: StopRequest): string;
+/**
+ * Combine what the supervisor observed (a signal, a child exit, a failed
+ * start) with the requester note, when there is one.
+ */
+export declare function composeShutdownReason(origin: string, request: StopRequest | null): string;
+/**
+ * A supervisor that throws is a stop too, and the least explained one: Node's
+ * default handler prints a trace and exits without any of our bookkeeping. Split
+ * into a one-line reason (the log line, `status`) and the frames (the log body).
+ */
+export declare function describeCrash(error: unknown): {
+    reason: string;
+    detail: string[];
+};
+/** Origin string for a signal with no matching stop note. */
+export declare function describeSignalOrigin(signal: 'SIGINT' | 'SIGTERM' | 'SIGHUP'): string;
+export declare function formatSupervisorShutdownLine(exitCode: number, reason: string): string;
+/**
+ * A `start` that never supervised anything — it found a deck already running,
+ * or died before spawning one — is not the deck stopping, and must not claim a
+ * `supervisor shutting down` line that an operator reads as exactly that.
+ */
+export declare function formatCommandExitLine(exitCode: number, reason: string): string;
+export declare function formatStartFailureLine(reason: string): string;
+/**
+ * A start that dies before the supervisor loop still has to leave a trail. The
+ * operator's next move is supervisor.log or `agent-deck status`, and neither can
+ * show a message that only ever reached the invoking terminal.
+ */
+export declare function recordStartFailure(input: {
+    reason: string;
+    /** Extra operator-facing lines, copied into supervisor.log under the reason. */
+    detail?: string[];
+    exitCode?: number;
+    /** Something closer to the failure already wrote a record — do not clobber it. */
+    keepExistingRecord?: boolean;
+    pid?: number;
+    now?: Date;
+}): number;
+export declare function writeLastStop(record: LastStopRecord): void;
+export declare function readLastStop(): LastStopRecord | null;
+export declare function readLastStartFailure(): LastStartFailureRecord | null;
+/** A start that got the deck running answers the previous failure — drop it. */
+export declare function clearLastStartFailure(): void;
+export declare function formatLastStopLines(record: LastStopRecord | null): string[];
+/** Printed under the last stop, so "won't start" and "stopped" stay distinct. */
+export declare function formatLastStartFailureLines(record: LastStartFailureRecord | null): string[];
+//# sourceMappingURL=shutdown-reason.d.ts.map

package/dist/shutdown-reason.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown-reason.d.ts","sourceRoot":"","sources":["../src/shutdown-reason.ts"],"names":[],"mappings":"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"}

package/dist/shutdown-reason.js

@@ -0,0 +1,247 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STOP_REQUEST_MAX_AGE_MS = void 0;
+exports.stopRequestPath = stopRequestPath;
+exports.lastStopPath = lastStopPath;
+exports.lastStartFailurePath = lastStartFailurePath;
+exports.recordStopRequest = recordStopRequest;
+exports.readStopRequest = readStopRequest;
+exports.clearStopRequest = clearStopRequest;
+exports.consumeStopRequest = consumeStopRequest;
+exports.describeStopRequest = describeStopRequest;
+exports.composeShutdownReason = composeShutdownReason;
+exports.describeCrash = describeCrash;
+exports.describeSignalOrigin = describeSignalOrigin;
+exports.formatSupervisorShutdownLine = formatSupervisorShutdownLine;
+exports.formatCommandExitLine = formatCommandExitLine;
+exports.formatStartFailureLine = formatStartFailureLine;
+exports.recordStartFailure = recordStartFailure;
+exports.writeLastStop = writeLastStop;
+exports.readLastStop = readLastStop;
+exports.readLastStartFailure = readLastStartFailure;
+exports.clearLastStartFailure = clearLastStartFailure;
+exports.formatLastStopLines = formatLastStopLines;
+exports.formatLastStartFailureLines = formatLastStartFailureLines;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_util_1 = require("node:util");
+const shared_1 = require("@agent-deck/shared");
+const daemon_logs_1 = require("./daemon-logs");
+/** A stop note older than this is stale — a previous run left it behind. */
+exports.STOP_REQUEST_MAX_AGE_MS = 60_000;
+function stopRequestPath() {
+    return node_path_1.default.join((0, shared_1.resolveAgentDeckHome)(), 'stop-request.json');
+}
+function lastStopPath() {
+    return node_path_1.default.join((0, shared_1.resolveAgentDeckHome)(), 'last-stop.json');
+}
+function lastStartFailurePath() {
+    return node_path_1.default.join((0, shared_1.resolveAgentDeckHome)(), 'last-start-failure.json');
+}
+function recordStopRequest(input) {
+    const request = {
+        source: input.source,
+        ...(input.detail ? { detail: input.detail } : {}),
+        requestedAt: (input.now ?? new Date()).toISOString(),
+        requesterPid: input.requesterPid ?? process.pid,
+        targetPid: input.targetPid ?? 0,
+    };
+    const target = stopRequestPath();
+    node_fs_1.default.mkdirSync(node_path_1.default.dirname(target), { recursive: true });
+    node_fs_1.default.writeFileSync(target, `${JSON.stringify(request, null, 2)}\n`, 'utf8');
+    return request;
+}
+function readStopRequest() {
+    try {
+        const parsed = JSON.parse(node_fs_1.default.readFileSync(stopRequestPath(), 'utf8'));
+        if (typeof parsed?.source !== 'string' || typeof parsed?.requestedAt !== 'string') {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+function clearStopRequest() {
+    try {
+        node_fs_1.default.unlinkSync(stopRequestPath());
+    }
+    catch {
+        // ignore
+    }
+}
+/**
+ * Take the pending stop note if it is fresh and aimed at this supervisor.
+ * Always removes the file so a stale note cannot mislabel a later shutdown.
+ */
+function consumeStopRequest(options) {
+    const request = readStopRequest();
+    if (!request) {
+        clearStopRequest();
+        return null;
+    }
+    const requestedAt = new Date(request.requestedAt).getTime();
+    const age = (options.now ?? new Date()).getTime() - requestedAt;
+    const stale = Number.isNaN(requestedAt) || age < 0 || age > (options.maxAgeMs ?? exports.STOP_REQUEST_MAX_AGE_MS);
+    const forThisSupervisor = request.targetPid === 0 || request.targetPid === options.supervisorPid;
+    // Someone else's note is left where its target can still find it: eating it
+    // would cost that supervisor its attribution *and* convince `agent-deck stop`
+    // that the origin was recorded when nobody recorded it.
+    if (forThisSupervisor || stale) {
+        clearStopRequest();
+    }
+    return forThisSupervisor && !stale ? request : null;
+}
+function describeStopRequest(request) {
+    const parts = [request.source];
+    if (request.detail) {
+        parts.push(request.detail);
+    }
+    return `${parts.join(' — ')} (pid ${request.requesterPid})`;
+}
+/**
+ * Combine what the supervisor observed (a signal, a child exit, a failed
+ * start) with the requester note, when there is one.
+ */
+function composeShutdownReason(origin, request) {
+    return request ? `${origin}; requested by ${describeStopRequest(request)}` : origin;
+}
+/**
+ * A supervisor that throws is a stop too, and the least explained one: Node's
+ * default handler prints a trace and exits without any of our bookkeeping. Split
+ * into a one-line reason (the log line, `status`) and the frames (the log body).
+ */
+function describeCrash(error) {
+    if (error instanceof Error) {
+        const code = error.code;
+        return {
+            reason: code ? `${error.name} [${code}]: ${error.message}` : `${error.name}: ${error.message}`,
+            // error.stack repeats the message on its first line; keep only the frames.
+            detail: (error.stack?.split('\n').slice(1) ?? []).map((line) => line.trim()).filter(Boolean),
+        };
+    }
+    // `String({})` is "[object Object]" — a rejected plain object is exactly the
+    // throw an operator has no other way to identify.
+    return { reason: typeof error === 'string' ? error : (0, node_util_1.inspect)(error, { depth: 2 }), detail: [] };
+}
+/** Origin string for a signal with no matching stop note. */
+function describeSignalOrigin(signal) {
+    switch (signal) {
+        case 'SIGINT':
+            return 'signal SIGINT (Ctrl-C or terminal interrupt)';
+        case 'SIGHUP':
+            return 'signal SIGHUP (terminal closed)';
+        default:
+            return 'signal SIGTERM';
+    }
+}
+function formatSupervisorShutdownLine(exitCode, reason) {
+    return `[agent-deck] supervisor shutting down (exit ${exitCode}, reason: ${reason})`;
+}
+/**
+ * A `start` that never supervised anything — it found a deck already running,
+ * or died before spawning one — is not the deck stopping, and must not claim a
+ * `supervisor shutting down` line that an operator reads as exactly that.
+ */
+function formatCommandExitLine(exitCode, reason) {
+    return `[agent-deck] agent-deck start exiting (exit ${exitCode}, reason: ${reason})`;
+}
+function formatStartFailureLine(reason) {
+    return `[agent-deck] start failed: ${reason}`;
+}
+/**
+ * A start that dies before the supervisor loop still has to leave a trail. The
+ * operator's next move is supervisor.log or `agent-deck status`, and neither can
+ * show a message that only ever reached the invoking terminal.
+ */
+function recordStartFailure(input) {
+    const exitCode = input.exitCode ?? 1;
+    const at = (input.now ?? new Date()).toISOString();
+    try {
+        (0, daemon_logs_1.appendDaemonLogLine)('supervisor', `${at} ${formatStartFailureLine(input.reason)}`);
+        for (const line of input.detail ?? []) {
+            (0, daemon_logs_1.appendDaemonLogLine)('supervisor', `${at} [agent-deck] start failed| ${line}`);
+        }
+    }
+    catch {
+        // A start already failing must not fail again on its own diagnostic.
+    }
+    if (!input.keepExistingRecord) {
+        writeJsonRecord(lastStartFailurePath(), {
+            at,
+            exitCode,
+            reason: input.reason,
+            pid: input.pid ?? process.pid,
+        });
+    }
+    return exitCode;
+}
+function writeJsonRecord(target, record) {
+    try {
+        node_fs_1.default.mkdirSync(node_path_1.default.dirname(target), { recursive: true });
+        node_fs_1.default.writeFileSync(target, `${JSON.stringify(record, null, 2)}\n`, 'utf8');
+    }
+    catch {
+        // Never block a shutdown (or a failing start) on a bookkeeping write.
+    }
+}
+function readJsonRecord(source) {
+    try {
+        const parsed = JSON.parse(node_fs_1.default.readFileSync(source, 'utf8'));
+        if (typeof parsed?.at !== 'string' || typeof parsed?.reason !== 'string') {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+function writeLastStop(record) {
+    writeJsonRecord(lastStopPath(), record);
+}
+function readLastStop() {
+    return readJsonRecord(lastStopPath());
+}
+function readLastStartFailure() {
+    return readJsonRecord(lastStartFailurePath());
+}
+/** A start that got the deck running answers the previous failure — drop it. */
+function clearLastStartFailure() {
+    try {
+        node_fs_1.default.unlinkSync(lastStartFailurePath());
+    }
+    catch {
+        // Nothing to clear.
+    }
+}
+function formatLastStopLines(record) {
+    if (!record) {
+        return [
+            'Last stop: (no record — an instance stopped before this build, or was killed with SIGKILL)',
+        ];
+    }
+    return [
+        'Last stop:',
+        `  at      ${record.at}`,
+        `  exit    ${record.exitCode}`,
+        `  reason  ${record.reason}`,
+    ];
+}
+/** Printed under the last stop, so "won't start" and "stopped" stay distinct. */
+function formatLastStartFailureLines(record) {
+    if (!record) {
+        return [];
+    }
+    return [
+        'Last failed start:',
+        `  at      ${record.at}`,
+        `  exit    ${record.exitCode}`,
+        `  reason  ${record.reason}`,
+    ];
+}
+//# sourceMappingURL=shutdown-reason.js.map

package/dist/shutdown-reason.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown-reason.js","sourceRoot":"","sources":["../src/shutdown-reason.ts"],"names":[],"mappings":"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"}

package/dist/start.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"AA8BA,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gEAAgE;IAChE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,4FAA4F;IAC5F,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,sBAAsB,CAAC,OAAO,SAAwB,GAAG,MAAM,CAE9E;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/E;AAyND,wBAAsB,QAAQ,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkN1E;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CA0EjD"}
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"AAgDA,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gEAAgE;IAChE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,4FAA4F;IAC5F,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,sBAAsB,CAAC,OAAO,SAAwB,GAAG,MAAM,CAE9E;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/E;AAqfD,wBAAsB,QAAQ,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmQ1E;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAyFjD"}