@jungjaehoon/mama-os 0.76.0 → 0.78.0

package/dist/cli/runtime/claude-caller-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"claude-caller-config.js","sourceRoot":"","sources":["../../../src/cli/runtime/claude-caller-config.ts"],"names":[],"mappings":";;AAGA,sDAEC;AASD,wDAyCC;AAvDD,qCAAmD;AACnD,yCAA0C;AAE1C,SAAgB,qBAAqB;IACnC,OAAO,IAAA,gBAAI,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,uBAAuB,CAAC,CAAC;AACzE,CAAC;AAQD,gFAAgF;AAChF,SAAgB,sBAAsB,CACpC,YAAoB,EACpB,kBAAqC,EAAE,EACvC,YAAkC,EAClC,MAAM,GAAG,IAAA,gBAAI,EAAC,IAAA,mBAAO,EAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAE5C,YAAY,GAAG,IAAA,mBAAO,EAAC,YAAY,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,IAAA,gBAAI,EAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC;IAC/E,MAAM,OAAO,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,qBAAqB,EAAE,CAAC,EAAE,CAAC;IAC/E,MAAM,QAAQ,GAAG;QACf,KAAK,EAAE;YACL,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;SAClF;QACD,OAAO,EAAE;YACP,OAAO,EAAE,IAAI;YACb,iBAAiB,EAAE,IAAI;YACvB,wBAAwB,EAAE,IAAI;YAC9B,wBAAwB,EAAE,KAAK;YAC/B,gBAAgB,EAAE,EAAE;YACpB,UAAU,EAAE;gBACV,UAAU,EAAE,CAAC,YAAY,CAAC;gBAC1B,QAAQ,EAAE,CAAC,GAAG,eAAe,CAAC;gBAC9B,SAAS,EAAE,CAAC,SAAS,CAAC;aACvB;YACD,uFAAuF;YACvF,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,GAAG,YAAY,EAAE,EAAE,CAAC;SACxE;QACD,GAAG,EAAE;YACH,kBAAkB,EAAE,MAAM;YAC1B,sFAAsF;YACtF,oCAAoC,EAAE,GAAG;SAC1C;KACF,CAAC;IACF,IAAA,mBAAS,EAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,IAAA,mBAAS,EAAC,IAAA,gBAAI,EAAC,YAAY,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACxE,4FAA4F;IAC5F,IAAA,uBAAa,EAAC,IAAA,gBAAI,EAAC,SAAS,EAAE,eAAe,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;QACxF,IAAI,EAAE,KAAK;KACZ,CAAC,CAAC;IACH,IAAA,uBAAa,EAAC,IAAA,gBAAI,EAAC,SAAS,EAAE,qBAAqB,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACjF,CAAC"}
+{"version":3,"file":"claude-caller-config.js","sourceRoot":"","sources":["../../../src/cli/runtime/claude-caller-config.ts"],"names":[],"mappings":";;AAGA,sDAEC;AASD,wDAqDC;AAnED,qCAAmD;AACnD,yCAA0C;AAE1C,SAAgB,qBAAqB;IACnC,OAAO,IAAA,gBAAI,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,uBAAuB,CAAC,CAAC;AACzE,CAAC;AAQD,gFAAgF;AAChF,SAAgB,sBAAsB,CACpC,YAAoB,EACpB,kBAAqC,EAAE,EACvC,YAAkC,EAClC,MAAM,GAAG,IAAA,gBAAI,EAAC,IAAA,mBAAO,EAAC,YAAY,CAAC,EAAE,MAAM,CAAC;AAC5C,iGAAiG;AACjG,gBAAyB;IAEzB,YAAY,GAAG,IAAA,mBAAO,EAAC,YAAY,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,IAAA,gBAAI,EAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC;IAC/E,MAAM,OAAO,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,qBAAqB,EAAE,CAAC,EAAE,CAAC;IAC/E,MAAM,QAAQ,GAAG;QACf,KAAK,EAAE;YACL,UAAU,EAAE;gBACV,EAAE,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;gBACnE,GAAG,CAAC,gBAAgB,KAAK,SAAS;oBAChC,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC;wBACE;4BACE,OAAO,EAAE,UAAU;4BACnB,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,OAAO,IAAI,KAAK,CAAC,gBAAgB,CAAC,EAAE,EAAE,CAAC;yBAC/E;qBACF,CAAC;aACP;SACF;QACD,OAAO,EAAE;YACP,OAAO,EAAE,IAAI;YACb,iBAAiB,EAAE,IAAI;YACvB,wBAAwB,EAAE,IAAI;YAC9B,wBAAwB,EAAE,KAAK;YAC/B,gBAAgB,EAAE,EAAE;YACpB,UAAU,EAAE;gBACV,UAAU,EAAE,CAAC,YAAY,CAAC;gBAC1B,QAAQ,EAAE,CAAC,GAAG,eAAe,CAAC;gBAC9B,SAAS,EAAE,CAAC,SAAS,CAAC;aACvB;YACD,uFAAuF;YACvF,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,GAAG,YAAY,EAAE,EAAE,CAAC;SACxE;QACD,GAAG,EAAE;YACH,kBAAkB,EAAE,MAAM;YAC1B,sFAAsF;YACtF,oCAAoC,EAAE,GAAG;SAC1C;KACF,CAAC;IACF,IAAA,mBAAS,EAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,IAAA,mBAAS,EAAC,IAAA,gBAAI,EAAC,YAAY,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACxE,4FAA4F;IAC5F,IAAA,uBAAa,EAAC,IAAA,gBAAI,EAAC,SAAS,EAAE,eAAe,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;QACxF,IAAI,EAAE,KAAK;KACZ,CAAC,CAAC;IACH,IAAA,uBAAa,EAAC,IAAA,gBAAI,EAAC,SAAS,EAAE,qBAAqB,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACjF,CAAC"}

package/dist/cli/runtime/daemon-control.d.ts

@@ -0,0 +1,84 @@
+import { CliInputError } from '../prompt.js';
+/**
+ * One install runs one process that owns its stores: the daemon, or a replay or backfill booted
+ * the same way, or register-owner. Its claim is an exclusive SQLite lock on `runtime/daemon.lock`,
+ * held for the process's life and released by the operating system when the process ends, so a
+ * crash, a reboot or a reused pid never leaves a claim behind. `runtime/daemon.holder.json` names
+ * the holder for `mama status`. The token for the control socket also lives under `runtime/`,
+ * which the agents' native reads deny, so a session that reaches the socket still cannot use it.
+ * The socket sits beside `runtime.sock` at the root, so it fits the same AF_UNIX path limit
+ * (104 bytes on macOS).
+ */
+export interface DaemonControlPaths {
+    readonly lockPath: string;
+    readonly holderPath: string;
+    readonly socketPath: string;
+    readonly tokenPath: string;
+}
+export declare function daemonControlPaths(mamaRoot: string): DaemonControlPaths;
+/** The journal an interrupted `mama restore` leaves; nothing may run on the install while it is there. */
+export declare function restoreJournalPath(mamaRoot: string): string;
+/** A half-switched install: a refusal, not a failure, so a service does not restart into it. */
+export declare class RestorePendingError extends CliInputError {
+    readonly code = "MAMA_RESTORE_PENDING";
+    constructor();
+}
+/** Refuse to work on an install while a restore journal is open. */
+export declare function refuseWhileRestoring(mamaRoot: string): void;
+export interface LockOwner {
+    readonly pid: number;
+    readonly command: string;
+    readonly startedAt: number;
+    readonly nonce: string;
+}
+/** A CLI input error: the message names the holder and the fix, and carries no secret. */
+export declare class InstallBusyError extends CliInputError {
+    readonly holder: LockOwner | null;
+    readonly code = "MAMA_INSTALL_BUSY";
+    constructor(holder: LockOwner | null, lockPath: string);
+}
+export interface InstallLock {
+    readonly owner: LockOwner;
+    release(): void;
+}
+/**
+ * Take the install's lock: an exclusive transaction on the lock database, kept open for the
+ * process's life. A held lock refuses after `busyTimeoutMs`, which only outlasts the moment a
+ * `mama status` probe reads the file.
+ */
+export declare function acquireInstallLock(paths: DaemonControlPaths, command: string, options?: {
+    busyTimeoutMs?: number;
+}): InstallLock;
+/**
+ * The process that holds the install, or null when none does. Reading the lock database needs a
+ * shared lock, which the holder's exclusive one refuses; when nothing holds it, the read takes the
+ * shared lock for an instant only.
+ */
+export declare function lockHolder(paths: DaemonControlPaths): LockOwner | null;
+export type DaemonControlOp = 'status' | 'stop';
+export interface DaemonControlHandlers {
+    status(): Promise<Record<string, unknown>> | Record<string, unknown>;
+    stop(): void;
+}
+export interface DaemonControlServer {
+    close(): Promise<void>;
+}
+/**
+ * Serve status and stop to the CLI. Only the lock holder calls this, so removing a socket left by
+ * a dead holder never removes a live one. Each boot writes a new token; a request without it is
+ * refused.
+ */
+export declare function startDaemonControl(paths: DaemonControlPaths, handlers: DaemonControlHandlers): Promise<DaemonControlServer>;
+export type DaemonControlReply = {
+    state: 'stopped';
+    holder: LockOwner | null;
+} | {
+    state: 'running';
+    reply: Record<string, unknown>;
+};
+/**
+ * Ask the install's daemon. No token or no listening socket means nothing serves this install;
+ * a lock left behind is reported with its holder so a crashed process is visible.
+ */
+export declare function requestDaemonControl(paths: DaemonControlPaths, op: DaemonControlOp, timeoutMs?: number): Promise<DaemonControlReply>;
+//# sourceMappingURL=daemon-control.d.ts.map

package/dist/cli/runtime/daemon-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-control.d.ts","sourceRoot":"","sources":["../../../src/cli/runtime/daemon-control.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C;;;;;;;;;GASG;AAEH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAQvE;AAED,0GAA0G;AAC1G,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,gGAAgG;AAChG,qBAAa,mBAAoB,SAAQ,aAAa;IACpD,QAAQ,CAAC,IAAI,0BAA0B;;CAKxC;AAED,oEAAoE;AACpE,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE3D;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,0FAA0F;AAC1F,qBAAa,gBAAiB,SAAQ,aAAa;IAG/C,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAFnC,QAAQ,CAAC,IAAI,uBAAuB;gBAEzB,MAAM,EAAE,SAAS,GAAG,IAAI,EACjC,QAAQ,EAAE,MAAM;CASnB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,OAAO,IAAI,IAAI,CAAC;CACjB;AAqBD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GACvC,WAAW,CA+Bb;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,GAAG,IAAI,CActE;AAED,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEhD,MAAM,WAAW,qBAAqB;IACpC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrE,IAAI,IAAI,IAAI,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAID;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,kBAAkB,EACzB,QAAQ,EAAE,qBAAqB,GAC9B,OAAO,CAAC,mBAAmB,CAAC,CAuE9B;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAA;CAAE,GAC9C;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAEzD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,kBAAkB,EACzB,EAAE,EAAE,eAAe,EACnB,SAAS,SAAQ,GAChB,OAAO,CAAC,kBAAkB,CAAC,CAwC7B"}

package/dist/cli/runtime/daemon-control.js

@@ -0,0 +1,266 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstallBusyError = exports.RestorePendingError = void 0;
+exports.daemonControlPaths = daemonControlPaths;
+exports.restoreJournalPath = restoreJournalPath;
+exports.refuseWhileRestoring = refuseWhileRestoring;
+exports.acquireInstallLock = acquireInstallLock;
+exports.lockHolder = lockHolder;
+exports.startDaemonControl = startDaemonControl;
+exports.requestDaemonControl = requestDaemonControl;
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const node_net_1 = require("node:net");
+const node_path_1 = require("node:path");
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const prompt_js_1 = require("../prompt.js");
+function daemonControlPaths(mamaRoot) {
+    const runtimeRoot = (0, node_path_1.join)(mamaRoot, 'runtime');
+    return {
+        lockPath: (0, node_path_1.join)(runtimeRoot, 'daemon.lock'),
+        holderPath: (0, node_path_1.join)(runtimeRoot, 'daemon.holder.json'),
+        socketPath: (0, node_path_1.join)(mamaRoot, 'daemon.sock'),
+        tokenPath: (0, node_path_1.join)(runtimeRoot, 'daemon.token'),
+    };
+}
+/** The journal an interrupted `mama restore` leaves; nothing may run on the install while it is there. */
+function restoreJournalPath(mamaRoot) {
+    return (0, node_path_1.join)(mamaRoot, 'backups', '.restore-journal.json');
+}
+/** A half-switched install: a refusal, not a failure, so a service does not restart into it. */
+class RestorePendingError extends prompt_js_1.CliInputError {
+    code = 'MAMA_RESTORE_PENDING';
+    constructor() {
+        super('An interrupted restore is unfinished; run mama restore --rollback first');
+        this.name = 'RestorePendingError';
+    }
+}
+exports.RestorePendingError = RestorePendingError;
+/** Refuse to work on an install while a restore journal is open. */
+function refuseWhileRestoring(mamaRoot) {
+    if ((0, node_fs_1.existsSync)(restoreJournalPath(mamaRoot)))
+        throw new RestorePendingError();
+}
+/** A CLI input error: the message names the holder and the fix, and carries no secret. */
+class InstallBusyError extends prompt_js_1.CliInputError {
+    holder;
+    code = 'MAMA_INSTALL_BUSY';
+    constructor(holder, lockPath) {
+        super(holder === null
+            ? `MAMA is already running here (${lockPath}); stop it first: mama stop`
+            : `MAMA is already running here (${holder.command}, pid ${holder.pid}; ${lockPath}); stop it first: mama stop`);
+        this.holder = holder;
+        this.name = 'InstallBusyError';
+    }
+}
+exports.InstallBusyError = InstallBusyError;
+function readHolder(path) {
+    try {
+        const value = JSON.parse((0, node_fs_1.readFileSync)(path, 'utf8'));
+        return typeof value.pid === 'number' &&
+            typeof value.command === 'string' &&
+            typeof value.startedAt === 'number' &&
+            typeof value.nonce === 'string'
+            ? value
+            : null;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return null;
+        throw error;
+    }
+}
+function isBusy(error) {
+    return error.code === 'SQLITE_BUSY';
+}
+/**
+ * Take the install's lock: an exclusive transaction on the lock database, kept open for the
+ * process's life. A held lock refuses after `busyTimeoutMs`, which only outlasts the moment a
+ * `mama status` probe reads the file.
+ */
+function acquireInstallLock(paths, command, options = {}) {
+    (0, node_fs_1.mkdirSync)((0, node_path_1.join)(paths.lockPath, '..'), { recursive: true, mode: 0o700 });
+    const db = new better_sqlite3_1.default(paths.lockPath, { timeout: options.busyTimeoutMs ?? 2_000 });
+    try {
+        (0, node_fs_1.chmodSync)(paths.lockPath, 0o600);
+        db.pragma('locking_mode = EXCLUSIVE');
+        db.exec('BEGIN EXCLUSIVE');
+    }
+    catch (error) {
+        db.close();
+        if (isBusy(error))
+            throw new InstallBusyError(readHolder(paths.holderPath), paths.lockPath);
+        throw error;
+    }
+    const owner = {
+        pid: process.pid,
+        command,
+        startedAt: Date.now(),
+        nonce: (0, node_crypto_1.randomUUID)(),
+    };
+    const staged = `${paths.holderPath}.${owner.nonce}`;
+    (0, node_fs_1.writeFileSync)(staged, `${JSON.stringify(owner)}\n`, { mode: 0o600, flag: 'wx' });
+    (0, node_fs_1.renameSync)(staged, paths.holderPath);
+    let released = false;
+    return {
+        owner,
+        release: () => {
+            if (released)
+                return;
+            released = true;
+            if (readHolder(paths.holderPath)?.nonce === owner.nonce)
+                (0, node_fs_1.rmSync)(paths.holderPath);
+            db.close();
+        },
+    };
+}
+/**
+ * The process that holds the install, or null when none does. Reading the lock database needs a
+ * shared lock, which the holder's exclusive one refuses; when nothing holds it, the read takes the
+ * shared lock for an instant only.
+ */
+function lockHolder(paths) {
+    if (!(0, node_fs_1.existsSync)(paths.lockPath))
+        return null;
+    const db = new better_sqlite3_1.default(paths.lockPath, { readonly: true, timeout: 0 });
+    try {
+        db.pragma('schema_version');
+        return null;
+    }
+    catch (error) {
+        if (!isBusy(error))
+            throw error;
+        return (readHolder(paths.holderPath) ?? { pid: 0, command: 'unknown', startedAt: 0, nonce: 'unknown' });
+    }
+    finally {
+        db.close();
+    }
+}
+const MAX_REQUEST_BYTES = 4096;
+/**
+ * Serve status and stop to the CLI. Only the lock holder calls this, so removing a socket left by
+ * a dead holder never removes a live one. Each boot writes a new token; a request without it is
+ * refused.
+ */
+async function startDaemonControl(paths, handlers) {
+    const token = (0, node_crypto_1.randomBytes)(32).toString('hex');
+    (0, node_fs_1.rmSync)(paths.tokenPath, { force: true });
+    (0, node_fs_1.writeFileSync)(paths.tokenPath, `${token}\n`, { mode: 0o600, flag: 'wx' });
+    (0, node_fs_1.rmSync)(paths.socketPath, { force: true });
+    const expected = Buffer.from(token, 'utf8');
+    const server = (0, node_net_1.createServer)((socket) => {
+        let buffer = '';
+        socket.setEncoding('utf8');
+        socket.setTimeout(5_000, () => socket.destroy());
+        socket.on('error', () => socket.destroy());
+        socket.on('data', (chunk) => {
+            buffer += chunk;
+            if (buffer.length > MAX_REQUEST_BYTES) {
+                socket.destroy();
+                return;
+            }
+            const newline = buffer.indexOf('\n');
+            if (newline === -1)
+                return;
+            const line = buffer.slice(0, newline);
+            buffer = '';
+            void answer(line).then((reply) => socket.end(`${JSON.stringify(reply)}\n`), (error) => socket.end(`${JSON.stringify({ ok: false, error: error instanceof Error ? error.message : String(error) })}\n`));
+        });
+    });
+    async function answer(line) {
+        let request;
+        try {
+            request = JSON.parse(line);
+        }
+        catch {
+            return { ok: false, error: 'invalid request' };
+        }
+        const given = Buffer.from(typeof request.token === 'string' ? request.token : '', 'utf8');
+        if (given.length !== expected.length || !(0, node_crypto_1.timingSafeEqual)(given, expected)) {
+            return { ok: false, error: 'unauthorized' };
+        }
+        if (request.op === 'status')
+            return { ok: true, status: await handlers.status() };
+        if (request.op === 'stop') {
+            handlers.stop();
+            return { ok: true };
+        }
+        return { ok: false, error: 'unknown op' };
+    }
+    try {
+        await new Promise((resolve, reject) => {
+            server.once('error', reject);
+            server.listen(paths.socketPath, () => {
+                server.off('error', reject);
+                resolve();
+            });
+        });
+    }
+    catch (error) {
+        (0, node_fs_1.rmSync)(paths.tokenPath, { force: true });
+        throw error;
+    }
+    (0, node_fs_1.chmodSync)(paths.socketPath, 0o600);
+    return {
+        close: () => new Promise((resolve) => {
+            server.close(() => {
+                (0, node_fs_1.rmSync)(paths.socketPath, { force: true });
+                (0, node_fs_1.rmSync)(paths.tokenPath, { force: true });
+                resolve();
+            });
+        }),
+    };
+}
+/**
+ * Ask the install's daemon. No token or no listening socket means nothing serves this install;
+ * a lock left behind is reported with its holder so a crashed process is visible.
+ */
+async function requestDaemonControl(paths, op, timeoutMs = 5_000) {
+    let token;
+    try {
+        token = (0, node_fs_1.readFileSync)(paths.tokenPath, 'utf8').trim();
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT')
+            throw error;
+        return { state: 'stopped', holder: lockHolder(paths) };
+    }
+    return await new Promise((resolve, reject) => {
+        const socket = (0, node_net_1.connect)(paths.socketPath);
+        let data = '';
+        socket.setEncoding('utf8');
+        socket.setTimeout(timeoutMs, () => {
+            socket.destroy();
+            reject(new Error(`The daemon did not answer within ${timeoutMs} ms`));
+        });
+        socket.on('connect', () => socket.write(`${JSON.stringify({ token, op })}\n`));
+        socket.on('data', (chunk) => {
+            data += chunk;
+        });
+        socket.on('end', () => {
+            try {
+                resolve({ state: 'running', reply: JSON.parse(data) });
+            }
+            catch {
+                reject(new Error('The daemon sent an unreadable reply'));
+            }
+        });
+        socket.on('error', (error) => {
+            if (error.code !== 'ENOENT' && error.code !== 'ECONNREFUSED') {
+                reject(error);
+                return;
+            }
+            // Inside an event handler a throw would be uncaught; the caller gets it instead.
+            try {
+                resolve({ state: 'stopped', holder: lockHolder(paths) });
+            }
+            catch (holderError) {
+                reject(holderError);
+            }
+        });
+    });
+}
+//# sourceMappingURL=daemon-control.js.map

package/dist/cli/runtime/daemon-control.js.map

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

package/dist/cli/runtime/diagnostics.d.ts

@@ -0,0 +1,43 @@
+import { loadConnector } from '../../connectors/index.js';
+import { type ProbeRun } from './backend-probe.js';
+import { type DaemonControlReply } from './daemon-control.js';
+import { type ServiceRun } from './systemd-service.js';
+export type CheckStatus = 'ok' | 'warn' | 'fail';
+export interface Check {
+    readonly name: string;
+    readonly status: CheckStatus;
+    /** What doctor found, in its own words; the shareable report carries only this. */
+    readonly detail: string;
+    /** What doctor read from the install (paths, error messages); shown here, never reported. */
+    readonly context?: string;
+    /** What to do about a warn or fail. */
+    readonly fix?: string;
+}
+export interface DiagnosticsOptions {
+    home?: string;
+    configPath?: string;
+    platform?: NodeJS.Platform;
+    run?: ProbeRun;
+    serviceRun?: ServiceRun;
+    /** No network call: Telegram is not asked and sources are not started. */
+    offline?: boolean;
+    /** A Telegram Bot API call; tests replace it. */
+    telegramCall?: (token: string, method: string, params?: Record<string, string>) => Promise<Record<string, unknown>>;
+    findIn?: (name: string, dirs: string[]) => string | undefined;
+    /** Ask the install's daemon for its status; tests replace it. */
+    askStatus?: () => Promise<DaemonControlReply>;
+    /** Builds a source as boot does; tests replace it so no source reaches the network. */
+    loadSource?: typeof loadConnector;
+    /** How long each source may take to start and answer (default 20 s). */
+    sourceTimeoutMs?: number;
+    /** Whether something listens on the viewer's address; tests replace it. */
+    portInUse?: (port: number, host: string) => Promise<boolean>;
+}
+/**
+ * Check an install as its service would run it. Nothing here writes MAMA's files or starts a
+ * service; the database is opened read-only (which can leave its -wal and -shm beside it), and the
+ * backend's own status command may update the backend's config.
+ * Each check names what it found and, when it is not ok, what to do.
+ */
+export declare function runDiagnostics(options?: DiagnosticsOptions): Promise<Check[]>;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/cli/runtime/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../src/cli/runtime/diagnostics.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAyB1D,OAAO,EAAkC,KAAK,QAAQ,EAAmB,MAAM,oBAAoB,CAAC;AACpG,OAAO,EAAsB,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAOlF,OAAO,EAAoB,KAAK,UAAU,EAAqB,MAAM,sBAAsB,CAAC;AAE5F,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;AAEjD,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,mFAAmF;IACnF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6FAA6F;IAC7F,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,uCAAuC;IACvC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iDAAiD;IACjD,YAAY,CAAC,EAAE,CACb,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC5B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,MAAM,GAAG,SAAS,CAAC;IAC9D,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC9C,uFAAuF;IACvF,UAAU,CAAC,EAAE,OAAO,aAAa,CAAC;IAClC,wEAAwE;IACxE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9D;AAiFD;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAmSvF"}