@jungjaehoon/mama-os 0.76.0 → 0.78.0

package/dist/cli/runtime/backend-probe.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MINIMUM_BACKEND_VERSIONS = void 0;
+exports.defaultProbeRun = defaultProbeRun;
+exports.compareVersions = compareVersions;
+exports.probeBackend = probeBackend;
+const node_child_process_1 = require("node:child_process");
+/**
+ * The oldest backend CLI versions a MAMA release was verified on. MAMA depends on their sandbox,
+ * hook, settings and permission behaviour, so an older CLI is refused; raise these only after
+ * verifying a newer one.
+ */
+exports.MINIMUM_BACKEND_VERSIONS = {
+    claude: '2.1.299',
+    codex: '0.160.1',
+};
+function defaultProbeRun(command, args, env) {
+    return (0, node_child_process_1.spawnSync)(command, args, { encoding: 'utf8', timeout: 20_000, env: env ?? process.env });
+}
+/** Compare dotted numeric versions; a missing part counts as 0. */
+function compareVersions(left, right) {
+    const a = left.split('.').map((part) => Number.parseInt(part, 10) || 0);
+    const b = right.split('.').map((part) => Number.parseInt(part, 10) || 0);
+    for (let index = 0; index < Math.max(a.length, b.length); index += 1) {
+        const difference = (a[index] ?? 0) - (b[index] ?? 0);
+        if (difference !== 0)
+            return difference;
+    }
+    return 0;
+}
+/**
+ * Read a backend CLI's version and whether it is signed in, without printing anything the CLI
+ * says about the account. `env` is the environment the daemon gives the backend, so a login that
+ * only this shell's variables provide does not count; Codex is asked about the managed home.
+ */
+function probeBackend(backend, executable, options = {}) {
+    const run = options.run ?? defaultProbeRun;
+    const env = options.env ?? process.env;
+    const minimum = exports.MINIMUM_BACKEND_VERSIONS[backend];
+    const versionRun = run(executable, ['--version'], env);
+    const version = versionRun.error
+        ? null
+        : (/(\d+\.\d+\.\d+)/.exec(`${versionRun.stdout ?? ''}`)?.[1] ?? null);
+    if (version === null) {
+        return {
+            version: null,
+            minimum,
+            versionOk: false,
+            loggedIn: false,
+            problem: `${backend} --version printed no version`,
+        };
+    }
+    const versionOk = compareVersions(version, minimum) >= 0;
+    if (backend === 'claude') {
+        const status = run(executable, ['auth', 'status', '--json'], env);
+        let loggedIn = false;
+        try {
+            loggedIn = JSON.parse(`${status.stdout ?? ''}`).loggedIn === true;
+        }
+        catch {
+            return {
+                version,
+                minimum,
+                versionOk,
+                loggedIn: false,
+                problem: 'claude auth status did not answer in JSON',
+            };
+        }
+        return { version, minimum, versionOk, loggedIn, problem: null };
+    }
+    const status = run(executable, ['login', 'status'], {
+        ...env,
+        ...(options.codexHome ? { CODEX_HOME: options.codexHome } : {}),
+    });
+    return {
+        version,
+        minimum,
+        versionOk,
+        loggedIn: !status.error && status.status === 0,
+        problem: null,
+    };
+}
+//# sourceMappingURL=backend-probe.js.map

package/dist/cli/runtime/backend-probe.js.map

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

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

@@ -0,0 +1,114 @@
+import { type Stats } from 'node:fs';
+import type { W1Config } from '../../runtime/config.js';
+/** One path in a backup, named by its place in the archive. */
+export interface BackupEntry {
+    readonly path: string;
+    readonly type: 'file' | 'dir' | 'symlink';
+    /** Permission bits as they were. */
+    readonly mode: number;
+    readonly size?: number;
+    readonly sha256?: string;
+    /** A symlink's target, as stored. */
+    readonly target?: string;
+}
+export interface BackupManifest {
+    readonly format: 'mama-backup';
+    readonly version: 1;
+    readonly createdAt: string;
+    readonly mama: string;
+    readonly platform: string;
+    /** The highest migration applied to the database, or null when it has none. */
+    readonly schemaVersion: number | null;
+    readonly includesSecrets: boolean;
+    readonly includesLogs: boolean;
+    /** Each archive prefix and the physical path it came from. */
+    readonly roots: Record<string, string>;
+    /** Every path the install was configured with, as written and as it really is. */
+    readonly configured: Record<string, ConfiguredPath | null>;
+    /** MAMA's own databases in the archive, each checked with integrity_check. */
+    readonly databases: string[];
+    readonly entries: BackupEntry[];
+}
+/** A tree or file archived under `prefix`, and which of its paths to keep. */
+export interface BackupSource {
+    readonly prefix: string;
+    /** Physical path. */
+    readonly path: string;
+    readonly keep: (relativePath: string, stat: Stats) => boolean;
+}
+export interface BackupPlan {
+    readonly sources: BackupSource[];
+    /** The database file boot opens; the archive holds a copy taken with SQLite's backup. */
+    readonly database: string;
+    readonly configured: Record<string, ConfiguredPath | null>;
+    /** Top-level names in the MAMA root that this version does not read. */
+    readonly leftOut: string[];
+    /** Credentials that exist and were left out because they were not asked for. */
+    readonly secretsLeftOut: string[];
+}
+/** runtime/ files the current code reads back; the rest of runtime/ is per boot or per run. */
+/** Files directly in the MAMA root that a backup keeps; restore accepts no other root files. */
+export declare const ROOT_FILES: readonly ["config.yaml", "connectors.json", "owner-policy.md", "report-slots.json", "start.sh"];
+/** Folders in the MAMA root that a backup keeps (logs only when asked), besides the workspace. */
+export declare const ROOT_DIRS: readonly ["connectors", "downloads", "runtime", "logs"];
+/** Folders in runtime/ that a backup keeps. */
+export declare const RUNTIME_DIRS: readonly ["backfill"];
+export declare const RUNTIME_FILES: Set<string>;
+/** Setting paths whose string value sits under a credential name. Values are never read out. */
+export declare function secretShapedKeys(value: unknown): string[];
+/** A configured path as written and as it really is; restore rewrites both. */
+export interface ConfiguredPath {
+    readonly configured: string;
+    readonly physical: string;
+}
+/**
+ * What a backup holds, from what the current code reads and writes (not from what a root happens
+ * to contain): the MAMA root's state, the database, the workspace, every person's tree under
+ * member_root, the published common skills, the wiki MAMA writes and Jev's vocabulary.
+ * Credentials, and any file that can hold one, come only with `includeSecrets`; logs only with
+ * `includeLogs`.
+ */
+export declare function planBackup(config: W1Config, configPath: string, options: {
+    includeSecrets: boolean;
+    includeLogs: boolean;
+    home: string;
+}): BackupPlan;
+export interface CollectedEntries {
+    readonly entries: BackupEntry[];
+    /** Each entry's physical path, in archive order. */
+    readonly absolutes: string[];
+}
+/**
+ * The entries each source keeps, in the order tar will write them. A path reached twice (through
+ * overlapping sources) is kept once, under the first source that reached it.
+ */
+export declare function collectEntries(sources: readonly BackupSource[]): Promise<CollectedEntries>;
+/** Copy a SQLite database with its backup API and confirm the copy with integrity_check. */
+export declare function copyDatabase(source: string, destination: string): Promise<{
+    schemaVersion: number | null;
+}>;
+/**
+ * integrity_check must answer ok. For MAMA's main database, also read the highest applied
+ * migration; another database's tables are its own.
+ */
+export declare function checkDatabase(path: string, options?: {
+    schema: boolean;
+}): {
+    schemaVersion: number | null;
+};
+/** The raw stores under connectors/: MAMA's own databases besides the main one. */
+export declare function rawStores(root: string): string[];
+/**
+ * Write exactly the collected entries, manifest first, each under its archive name, with modes
+ * and symlinks as they are. The file is created 0600 and flushed to disk before it returns.
+ */
+export declare function writeArchive(file: string, manifestPath: string, collected: CollectedEntries): Promise<void>;
+/** Flush a file or a folder's entries to disk. */
+export declare function syncPath(path: string): void;
+/**
+ * Read the archive back: the manifest comes first, every entry it lists is there once with its
+ * type and link target, nothing else is, and every file hashes to what the manifest recorded.
+ */
+export declare function verifyArchive(file: string, manifest: BackupManifest): Promise<void>;
+export declare function archiveName(now: Date): string;
+//# sourceMappingURL=backup.d.ts.map

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

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