@jungjaehoon/mama-os 0.77.0 → 0.79.0

package/dist/cli/runtime/default-roots.d.ts

@@ -0,0 +1,27 @@
+export interface DefaultRoots {
+    memberRoot: string;
+    toolsRoot: string;
+}
+/**
+ * Where a new install keeps its member folders and its document tools: outside HOME, one place
+ * per person on the machine (plan decision 3). On macOS a folder of this user's sits directly in
+ * the sticky Shared folder beside the home folders, so no account uses a parent another set up;
+ * on Linux it is /var/lib/mama/<user>, which the installer creates once with sudo.
+ */
+export declare function defaultRoots(options?: {
+    platform?: NodeJS.Platform;
+    home?: string;
+    user?: string;
+}): DefaultRoots | undefined;
+/**
+ * Make a root that this user alone owns and writes, or refuse one that is not: the agent runs
+ * what tools_root holds and reads what member_root holds, and the Shared folder lets any account
+ * create a folder first. `ownParent` also checks the per-user folder a default sits in. A root
+ * this account cannot create (Linux's /var/lib/mama) names the one sudo step that makes its
+ * per-user folder; the subfolders are made here.
+ */
+export declare function prepareRoot(path: string, options?: {
+    uid?: number;
+    ownParent?: boolean;
+}): void;
+//# sourceMappingURL=default-roots.d.ts.map

package/dist/cli/runtime/default-roots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-roots.d.ts","sourceRoot":"","sources":["../../../src/cli/runtime/default-roots.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GACzE,YAAY,GAAG,SAAS,CAa1B;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GAClD,IAAI,CAwBN"}

package/dist/cli/runtime/default-roots.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultRoots = defaultRoots;
+exports.prepareRoot = prepareRoot;
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const prompt_js_1 = require("../prompt.js");
+/**
+ * Where a new install keeps its member folders and its document tools: outside HOME, one place
+ * per person on the machine (plan decision 3). On macOS a folder of this user's sits directly in
+ * the sticky Shared folder beside the home folders, so no account uses a parent another set up;
+ * on Linux it is /var/lib/mama/<user>, which the installer creates once with sudo.
+ */
+function defaultRoots(options = {}) {
+    const platform = options.platform ?? process.platform;
+    const user = options.user ?? (0, node_os_1.userInfo)().username;
+    if (!/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(user))
+        return undefined;
+    const base = platform === 'darwin'
+        ? (0, node_path_1.join)((0, node_path_1.dirname)(options.home ?? (0, node_os_1.homedir)()), 'Shared', `mama-${user}`)
+        : platform === 'linux'
+            ? (0, node_path_1.join)('/var/lib/mama', user)
+            : undefined;
+    return base === undefined
+        ? undefined
+        : { memberRoot: (0, node_path_1.join)(base, 'members'), toolsRoot: (0, node_path_1.join)(base, 'tools') };
+}
+/**
+ * Make a root that this user alone owns and writes, or refuse one that is not: the agent runs
+ * what tools_root holds and reads what member_root holds, and the Shared folder lets any account
+ * create a folder first. `ownParent` also checks the per-user folder a default sits in. A root
+ * this account cannot create (Linux's /var/lib/mama) names the one sudo step that makes its
+ * per-user folder; the subfolders are made here.
+ */
+function prepareRoot(path, options = {}) {
+    const uid = options.uid ?? process.getuid?.();
+    if (!(0, node_fs_1.existsSync)(path)) {
+        try {
+            (0, node_fs_1.mkdirSync)(path, { recursive: true, mode: 0o700 });
+        }
+        catch (error) {
+            const code = error.code;
+            if (code !== 'EACCES' && code !== 'EPERM' && code !== 'EROFS')
+                throw error;
+            const folder = options.ownParent ? (0, node_path_1.dirname)(path) : path;
+            throw new prompt_js_1.CliInputError(`${path} cannot be created. Create ${folder} for this account once: sudo install -d -o "$USER" -m 0700 ${folder}`);
+        }
+    }
+    for (const folder of options.ownParent ? [(0, node_path_1.dirname)(path), path] : [path]) {
+        const stat = (0, node_fs_1.lstatSync)(folder);
+        if (stat.isSymbolicLink() || !stat.isDirectory())
+            throw new prompt_js_1.CliInputError(`${folder} must be a folder, not a link or a file`);
+        if (uid !== undefined && stat.uid !== uid)
+            throw new prompt_js_1.CliInputError(`${folder} belongs to another account; choose another folder`);
+        if ((stat.mode & 0o022) !== 0)
+            throw new prompt_js_1.CliInputError(`${folder} can be written by other accounts; run chmod 700 on it`);
+    }
+    (0, node_fs_1.accessSync)(path, node_fs_1.constants.W_OK);
+}
+//# sourceMappingURL=default-roots.js.map

package/dist/cli/runtime/default-roots.js.map

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

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

@@ -0,0 +1,68 @@
+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;
+    /**
+     * A stable name for this finding where its detail carries values that an update or a backend
+     * self-update changes (versions, schema numbers). A check without one is the same finding
+     * while its name and detail are; `mama update` compares failures before and after by these.
+     */
+    readonly code?: 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;
+    /** Where this shell finds a command; tests replace it. */
+    findExecutable?: (name: 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>;
+}
+/** auth.env's assignments, unquoted as sh reads them; values are never printed. */
+export declare function readAuthEnv(root: string): Record<string, string>;
+export declare function defaultTelegramCall(token: string, method: string, params?: Record<string, string>, timeoutMs?: number): Promise<Record<string, unknown>>;
+/** True when something listens; a refusal means free; any other error (a host that cannot be
+ * reached or bound) rejects, since the viewer would fail on it too. */
+export declare function portAnswers(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[]>;
+/**
+ * start.sh's Node: still there, outside one version's folder, and able to load MAMA's SQLite. On
+ * an install the install command made (its Node in `<root>/node`), also the Node the installed
+ * release pins in its install/node.json: running the install command again moves to that one.
+ */
+export declare function nodeCheck(node: string, cli: string, run: ProbeRun, root: string): Check;
+export declare function telegramCheck(token: string | undefined, commonChat: string | number | undefined, call: NonNullable<DiagnosticsOptions['telegramCall']>): Promise<Check>;
+/** The environment start.sh gives the daemon: auth.env, then its own exports, then its PATH. */
+export declare function serviceEnvironment(home: string, auth: Record<string, string>, exports: Record<string, string>, path: readonly string[]): NodeJS.ProcessEnv;
+/** Run with process.env as the daemon's process has it, then put this shell's back. */
+export declare function withEnvironment<T>(env: NodeJS.ProcessEnv, run: () => Promise<T>): Promise<T>;
+//# 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":"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"}