@astragenie/astramemory-local 0.7.2

package/dist/service/launchd.js

@@ -0,0 +1,196 @@
+import { exec } from 'node:child_process';
+import { mkdirSync, writeFileSync, existsSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+const LABEL = 'com.astragenie.astra-memoryd';
+const PLIST_FILENAME = `${LABEL}.plist`;
+const BACKUP_LABEL = 'com.astragenie.astra-memoryd-backup';
+const BACKUP_PLIST_FILENAME = `${BACKUP_LABEL}.plist`;
+function agentsDir() {
+    return join(homedir(), 'Library', 'LaunchAgents');
+}
+function plistPath() {
+    return join(agentsDir(), PLIST_FILENAME);
+}
+function backupPlistPath() {
+    return join(agentsDir(), BACKUP_PLIST_FILENAME);
+}
+function xmlEscape(s) {
+    return s
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}
+function buildBackupPlist(args, keep) {
+    const argItems = args.map(a => `    <string>${xmlEscape(a)}</string>`).join('\n');
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${BACKUP_LABEL}</string>
+
+  <key>ProgramArguments</key>
+  <array>
+${argItems}
+    <string>backup</string>
+    <string>--keep</string>
+    <string>${keep}</string>
+  </array>
+
+  <key>StartCalendarInterval</key>
+  <dict>
+    <key>Hour</key>
+    <integer>3</integer>
+    <key>Minute</key>
+    <integer>0</integer>
+  </dict>
+
+  <key>StandardOutPath</key>
+  <string>${homedir()}/Library/Logs/astra-memoryd-backup.out.log</string>
+  <key>StandardErrorPath</key>
+  <string>${homedir()}/Library/Logs/astra-memoryd-backup.err.log</string>
+</dict>
+</plist>
+`;
+}
+function buildPlist(args, port) {
+    const argItems = args.map(a => `    <string>${xmlEscape(a)}</string>`).join('\n');
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${LABEL}</string>
+
+  <key>ProgramArguments</key>
+  <array>
+${argItems}
+    <string>serve</string>
+    <string>--port</string>
+    <string>${port}</string>
+  </array>
+
+  <key>RunAtLoad</key>
+  <true/>
+
+  <key>KeepAlive</key>
+  <dict>
+    <key>SuccessfulExit</key>
+    <false/>
+  </dict>
+
+  <key>StandardOutPath</key>
+  <string>${homedir()}/Library/Logs/astra-memoryd.out.log</string>
+  <key>StandardErrorPath</key>
+  <string>${homedir()}/Library/Logs/astra-memoryd.err.log</string>
+</dict>
+</plist>
+`;
+}
+function runCmd(cmd) {
+    return new Promise((resolve, reject) => {
+        exec(cmd, { timeout: 10_000 }, (err, stdout, stderr) => {
+            if (err)
+                reject(new Error(`Command failed: ${cmd}\n${stderr || err.message}`));
+            else
+                resolve(stdout.trim());
+        });
+    });
+}
+/** Best-effort launchctl load/bootstrap for current macOS version. */
+async function launchctlLoad(path) {
+    // macOS 10.15+ prefers bootstrap gui/$UID; older supports load
+    const uid = process.getuid?.() ?? '';
+    try {
+        await runCmd(`launchctl bootstrap gui/${uid} "${path}"`);
+    }
+    catch {
+        await runCmd(`launchctl load -w "${path}"`);
+    }
+}
+async function launchctlUnload(path) {
+    const uid = process.getuid?.() ?? '';
+    try {
+        await runCmd(`launchctl bootout gui/${uid} "${path}"`);
+    }
+    catch {
+        await runCmd(`launchctl unload -w "${path}"`);
+    }
+}
+export class LaunchdAdapter {
+    platform = 'darwin';
+    async install(execPath, port) {
+        mkdirSync(agentsDir(), { recursive: true });
+        // execPath formatted by resolveCliExecPath() as: "<nodeBin>" "<indexJs>"
+        // Parse double-quoted tokens so paths with spaces (e.g. /Users/Jane Smith/...)
+        // survive intact. Unquoted execPath falls back to whitespace split.
+        const args = Array.from(execPath.matchAll(/"([^"]+)"|(\S+)/g))
+            .map(m => m[1] ?? m[2] ?? '')
+            .filter(a => a.length > 0);
+        writeFileSync(plistPath(), buildPlist(args, port), 'utf8');
+        await launchctlLoad(plistPath());
+        return { kind: 'task' };
+    }
+    async uninstall() {
+        if (existsSync(plistPath())) {
+            try {
+                await launchctlUnload(plistPath());
+            }
+            catch { /* ignore if not loaded */ }
+            unlinkSync(plistPath());
+        }
+    }
+    async start() {
+        const uid = process.getuid?.() ?? '';
+        try {
+            await runCmd(`launchctl kickstart -k gui/${uid}/${LABEL}`);
+        }
+        catch {
+            await runCmd(`launchctl start ${LABEL}`);
+        }
+    }
+    async stop() {
+        const uid = process.getuid?.() ?? '';
+        try {
+            await runCmd(`launchctl kill TERM gui/${uid}/${LABEL}`);
+        }
+        catch {
+            await runCmd(`launchctl stop ${LABEL}`);
+        }
+    }
+    async status() {
+        const installed = existsSync(plistPath());
+        if (!installed)
+            return { installed: false, running: false };
+        try {
+            const out = await runCmd(`launchctl list ${LABEL}`);
+            const running = out.includes('"PID"') || /\bPID\b.*=\s*[0-9]+/.test(out) || out.includes('running = 1');
+            return { installed, running, detail: out };
+        }
+        catch {
+            return { installed, running: false, detail: 'not loaded' };
+        }
+    }
+    async installBackupTimer(execPath, keep) {
+        mkdirSync(agentsDir(), { recursive: true });
+        const args = Array.from(execPath.matchAll(/"([^"]+)"|(\S+)/g))
+            .map(m => m[1] ?? m[2] ?? '')
+            .filter(a => a.length > 0);
+        writeFileSync(backupPlistPath(), buildBackupPlist(args, keep), 'utf8');
+        await launchctlLoad(backupPlistPath());
+    }
+    async uninstallBackupTimer() {
+        const bp = backupPlistPath();
+        if (existsSync(bp)) {
+            try {
+                await launchctlUnload(bp);
+            }
+            catch { /* ignore if not loaded */ }
+            unlinkSync(bp);
+        }
+    }
+}
+//# sourceMappingURL=launchd.js.map

package/dist/service/launchd.js.map

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

package/dist/service/schtasks.d.ts

@@ -0,0 +1,31 @@
+import type { ServiceAdapter, ServiceStatus, InstallResult } from './types.js';
+declare function startupScriptPath(): string;
+declare function backupStartupScriptPath(): string;
+export declare function runCmd(cmd: string): Promise<string>;
+/**
+ * Best-effort elevation probe. `net session` succeeds only in an elevated
+ * shell; exit code 2 (access denied) means non-elevated. Used for DIAGNOSTICS
+ * only — never as a gate: schtasks is always attempted regardless.
+ */
+export declare function isElevated(): Promise<boolean>;
+/**
+ * Split a possibly-quoted command line into executable + argument string.
+ * `"C:\Program Files\nodejs\node.exe" "C:\x\index.js"` →
+ *   { command: 'C:\Program Files\nodejs\node.exe', args: '"C:\x\index.js"' }
+ */
+export declare function splitCommand(execPath: string): {
+    command: string;
+    args: string;
+};
+export declare class SchtasksAdapter implements ServiceAdapter {
+    readonly platform: "win32";
+    install(execPath: string, port: number): Promise<InstallResult>;
+    uninstall(): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    status(): Promise<ServiceStatus>;
+    installBackupTimer(execPath: string, keep: number): Promise<void>;
+    uninstallBackupTimer(): Promise<void>;
+}
+/** Exported for tests — resolve the startup-shortcut path without constructing an adapter instance. */
+export { startupScriptPath, backupStartupScriptPath };

package/dist/service/schtasks.js

@@ -0,0 +1,274 @@
+import { exec } from 'node:child_process';
+import { writeFileSync, unlinkSync, existsSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { buildTaskXml, buildDailyTaskXml } from './task-xml.js';
+const TASK_NAME = 'AstraMemoryD';
+const BACKUP_TASK_NAME = 'AstraMemoryDBackup';
+/** User-scope Startup folder. Files placed here auto-run at logon — no admin. */
+function startupDir() {
+    const appdata = process.env['APPDATA'] ?? '';
+    return join(appdata, 'Microsoft', 'Windows', 'Start Menu', 'Programs', 'Startup');
+}
+function startupScriptPath() {
+    return join(startupDir(), 'AstraMemoryD.cmd');
+}
+function backupStartupScriptPath() {
+    return join(startupDir(), 'AstraMemoryDBackup.cmd');
+}
+export function runCmd(cmd) {
+    return new Promise((resolve, reject) => {
+        exec(cmd, { timeout: 15_000 }, (err, stdout, stderr) => {
+            if (err)
+                reject(new Error(`Command failed: ${cmd}\n${stderr || err.message}`));
+            else
+                resolve(stdout.trim());
+        });
+    });
+}
+/**
+ * Best-effort elevation probe. `net session` succeeds only in an elevated
+ * shell; exit code 2 (access denied) means non-elevated. Used for DIAGNOSTICS
+ * only — never as a gate: schtasks is always attempted regardless.
+ */
+export async function isElevated() {
+    try {
+        await runCmd('net session');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Properly quote a Windows command for schtasks /tr.
+ * schtasks requires the /tr value to be a single quoted string when it
+ * contains spaces. We wrap in double-quotes and escape internal double-quotes.
+ */
+function quoteForSchtasks(cmd) {
+    // Escape backslashes then double-quotes
+    const escaped = cmd.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+    return `"${escaped}"`;
+}
+/**
+ * Split a possibly-quoted command line into executable + argument string.
+ * `"C:\Program Files\nodejs\node.exe" "C:\x\index.js"` →
+ *   { command: 'C:\Program Files\nodejs\node.exe', args: '"C:\x\index.js"' }
+ */
+export function splitCommand(execPath) {
+    const trimmed = execPath.trim();
+    if (trimmed.startsWith('"')) {
+        const end = trimmed.indexOf('"', 1);
+        if (end > 0)
+            return { command: trimmed.slice(1, end), args: trimmed.slice(end + 1).trim() };
+    }
+    const sp = trimmed.indexOf(' ');
+    if (sp === -1)
+        return { command: trimmed, args: '' };
+    return { command: trimmed.slice(0, sp), args: trimmed.slice(sp + 1).trim() };
+}
+/** Current user's task-principal id: DOMAIN\user from whoami, else USERNAME. */
+async function resolveUserId() {
+    try {
+        const out = await runCmd('whoami');
+        if (out)
+            return out;
+    }
+    catch { /* fall through */ }
+    return process.env['USERNAME'] ?? '';
+}
+/** Return true when the named scheduled task exists (regardless of state). */
+async function taskExists(name) {
+    try {
+        await runCmd(`schtasks /query /tn "${name}" /fo LIST`);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export class SchtasksAdapter {
+    platform = 'win32';
+    async install(execPath, port) {
+        const tr = quoteForSchtasks(`${execPath} serve --port ${port}`);
+        const errors = [];
+        // Tier 0 — XML registration. The ONLY form that can express:
+        //   ExecutionTimeLimit=PT0S  (CLI-created tasks default to 72h — Task
+        //   Scheduler silently kills the daemon after 3 days),
+        //   logon trigger WITH a PT5M repetition (no-admin watchdog: re-run is a
+        //   <100ms no-op while healthy thanks to the instance lock, and a dead
+        //   daemon restarts within 5 minutes),
+        //   MultipleInstancesPolicy=IgnoreNew, StartWhenAvailable.
+        try {
+            const userId = await resolveUserId();
+            const { command, args } = splitCommand(execPath);
+            const xml = buildTaskXml({
+                command,
+                args: [args, `serve --port ${port}`].filter(Boolean).join(' '),
+                userId,
+            });
+            const xmlPath = join(tmpdir(), 'AstraMemoryD.xml');
+            // Task Scheduler XML declares UTF-16 — write utf16le with an explicit
+            // BOM (FF FE) so schtasks parses the file as declared.
+            const bom = Buffer.from([0xff, 0xfe]);
+            writeFileSync(xmlPath, Buffer.concat([bom, Buffer.from(xml, 'utf16le')]));
+            await runCmd(`schtasks /create /tn "${TASK_NAME}" /xml "${xmlPath}" /f`);
+            return { kind: 'task' };
+        }
+        catch (err0) {
+            // Keep the FULL message — the actionable stderr (e.g. "ERROR: Access is
+            // denied.") is on line 2 and truncating it hides the root cause.
+            errors.push(`Tier 0 (XML): ${err0.message}`);
+        }
+        // Tier A — simplest CLI form: no /RU, no /IT. Task runs in the invoker's
+        // security context at logon. NOTE: carries the default 72h
+        // ExecutionTimeLimit — the keepalive that XML provides is absent, so this
+        // is strictly a fallback.
+        const cmdA = `schtasks /create /sc onlogon /tn "${TASK_NAME}" /tr ${tr} /RL LIMITED /f`;
+        try {
+            await runCmd(cmdA);
+            console.log('  · NOTE: task registered via CLI fallback — Task Scheduler applies a default');
+            console.log('    72-hour execution limit and no keepalive. Prefer fixing the XML-tier error above.');
+            return { kind: 'task' };
+        }
+        catch (errA) {
+            errors.push(`Tier A: ${errA.message}`);
+        }
+        // Tier B — retry with /RU <user> /IT (current legacy behaviour). Some
+        // environments refuse Tier A but allow this form.
+        const user = process.env['USERNAME'] ?? '';
+        const ruFlag = user ? `/RU "${user}" /IT` : '';
+        const cmdB = `schtasks /create /sc onlogon /tn "${TASK_NAME}" /tr ${tr} ${ruFlag} /RL LIMITED /f`;
+        try {
+            await runCmd(cmdB);
+            return { kind: 'task' };
+        }
+        catch (errB) {
+            errors.push(`Tier B: ${errB.message}`);
+        }
+        // Tier C — Startup-folder shortcut. No admin required. Runs at next logon.
+        // Neither schtasks form worked — surface all errors so the user can
+        // diagnose WHY, then fall back gracefully.
+        const dir = startupDir();
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        const script = `@echo off\nstart "" /B ${execPath} serve --port ${port}\n`;
+        const scriptPath = startupScriptPath();
+        writeFileSync(scriptPath, script, 'utf8');
+        const elevated = await isElevated();
+        console.log('  · schtasks unavailable — tried two forms, both failed:');
+        for (const msg of errors) {
+            for (const line of msg.split('\n'))
+                console.log(`      ${line}`);
+        }
+        console.log(`  · running elevated: ${elevated ? 'yes' : 'no'}${elevated ? '' : ' — schtasks /create may require an Administrator shell on this system'}`);
+        console.log(`  · installed Startup shortcut at:\n    ${scriptPath}`);
+        return { kind: 'startup', path: scriptPath };
+    }
+    async uninstall() {
+        // Remove scheduled task if present (idempotent).
+        try {
+            await runCmd(`schtasks /delete /tn "${TASK_NAME}" /f`);
+        }
+        catch { /* not present */ }
+        // Remove Startup shortcut if present (idempotent).
+        const p = startupScriptPath();
+        if (existsSync(p)) {
+            try {
+                unlinkSync(p);
+            }
+            catch { /* ignore — parent process lock on Windows */ }
+        }
+    }
+    async start() {
+        if (!(await taskExists(TASK_NAME))) {
+            const startupPath = startupScriptPath();
+            if (existsSync(startupPath)) {
+                throw new Error(`AstraMemoryD scheduled task not found.\n` +
+                    `This install used the Startup-shortcut fallback (schtasks was unavailable at install time).\n` +
+                    `To start now:  astramem-local serve --port <port>\n` +
+                    `To install a proper scheduled task, re-run 'astramem-local service install' from an elevated shell.`);
+            }
+            throw new Error(`AstraMemoryD scheduled task not found.\n` +
+                `Run 'astramem-local service install' first.`);
+        }
+        await runCmd(`schtasks /run /tn "${TASK_NAME}"`);
+    }
+    async stop() {
+        if (!(await taskExists(TASK_NAME))) {
+            const startupPath = startupScriptPath();
+            if (existsSync(startupPath)) {
+                throw new Error(`AstraMemoryD scheduled task not found.\n` +
+                    `This install used the Startup-shortcut fallback (schtasks was unavailable at install time).\n` +
+                    `The daemon process was started outside schtasks — stop it with: astramem-local serve (Ctrl-C)\n` +
+                    `Or kill the node process directly via Task Manager.`);
+            }
+            throw new Error(`AstraMemoryD scheduled task not found.\n` +
+                `Run 'astramem-local service install' first.`);
+        }
+        await runCmd(`schtasks /end /tn "${TASK_NAME}"`);
+    }
+    async status() {
+        const taskFound = await taskExists(TASK_NAME);
+        const startupPath = startupScriptPath();
+        const startupFound = existsSync(startupPath);
+        if (taskFound) {
+            try {
+                const out = await runCmd(`schtasks /query /tn "${TASK_NAME}" /fo LIST`);
+                const running = /Status:\s*Running/i.test(out);
+                return { installed: true, running, detail: out };
+            }
+            catch (err) {
+                return { installed: false, running: false, detail: String(err) };
+            }
+        }
+        if (startupFound) {
+            // Startup-shortcut fallback — no task, but logon autostart is present.
+            return {
+                installed: true,
+                running: false,
+                detail: `Installed via Startup shortcut (no scheduled task): ${startupPath}\n` +
+                    `'service start/stop' will NOT work. To start: astramem-local serve --port <port>`,
+            };
+        }
+        return { installed: false, running: false, detail: 'Neither scheduled task nor Startup shortcut found.' };
+    }
+    async installBackupTimer(execPath, keep) {
+        // XML-first, same reason as the daemon task: the CLI /create form needs
+        // elevation on some boxes; a current-user XML registration does not.
+        try {
+            const userId = await resolveUserId();
+            const { command, args } = splitCommand(execPath);
+            const xml = buildDailyTaskXml({
+                command,
+                args: [args, `backup --keep ${keep}`].filter(Boolean).join(' '),
+                userId,
+                description: 'AstraMemory nightly verified backup. Managed by astramem-local reinstall / service install.',
+            });
+            const xmlPath = join(tmpdir(), 'AstraMemoryDBackup.xml');
+            const bom = Buffer.from([0xff, 0xfe]);
+            writeFileSync(xmlPath, Buffer.concat([bom, Buffer.from(xml, 'utf16le')]));
+            await runCmd(`schtasks /create /tn "${BACKUP_TASK_NAME}" /xml "${xmlPath}" /f`);
+            return;
+        }
+        catch {
+            // fall through to legacy CLI form
+        }
+        const tr = quoteForSchtasks(`${execPath} backup --keep ${keep}`);
+        const user = process.env['USERNAME'] ?? '';
+        const ruFlag = user ? `/RU "${user}" /IT` : '';
+        const cmd = `schtasks /create /sc DAILY /st 03:00 /tn "${BACKUP_TASK_NAME}" /tr ${tr} ${ruFlag} /RL LIMITED /f`;
+        await runCmd(cmd);
+    }
+    async uninstallBackupTimer() {
+        try {
+            await runCmd(`schtasks /delete /tn "${BACKUP_TASK_NAME}" /f`);
+        }
+        catch {
+            // Task may not exist — ignore
+        }
+    }
+}
+/** Exported for tests — resolve the startup-shortcut path without constructing an adapter instance. */
+export { startupScriptPath, backupStartupScriptPath };
+//# sourceMappingURL=schtasks.js.map

package/dist/service/schtasks.js.map

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

package/dist/service/shim.d.ts

@@ -0,0 +1,21 @@
+export interface ShimPointer {
+    nodeBin: string;
+    entryJs: string;
+    port: number;
+    /** When set, the launcher exports ASTRA_LOG_DIR so the daemon rotates its
+     *  JSON logs there (service mode) instead of writing to a discarded stdout. */
+    logDir?: string;
+}
+export interface ShimPaths {
+    binDir: string;
+    cmdPath: string;
+    launcherPath: string;
+    pointerPath: string;
+}
+/** Stable bin dir: <localAppData>\Astramem\bin (same root as the data dir). */
+export declare function shimPaths(localAppData?: string): ShimPaths;
+/**
+ * Write (or overwrite) the stable shim trio. Idempotent — we own the whole
+ * file contents, so a plain overwrite is safe and self-healing.
+ */
+export declare function writeShim(pointer: ShimPointer, paths?: ShimPaths): ShimPaths;

package/dist/service/shim.js

@@ -0,0 +1,80 @@
+/**
+ * shim.ts — stable launcher shim for the Windows service (D1).
+ *
+ * The scheduled task points FOREVER at a stable path:
+ *   %LOCALAPPDATA%\Astramem\bin\astramemd.cmd
+ * which runs
+ *   %LOCALAPPDATA%\Astramem\bin\launch.cjs
+ * which reads
+ *   %LOCALAPPDATA%\Astramem\bin\current.json   { nodeBin, entryJs, port }
+ * and spawns the daemon.
+ *
+ * Upgrades rewrite current.json only — schtasks is never touched again, so
+ * the one failure mode that requires elevation (task registration) can only
+ * occur once, at first install. This also kills the stale-baked-path bug
+ * where the task kept launching whichever build happened to run
+ * `service install`.
+ */
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+/** Stable bin dir: <localAppData>\Astramem\bin (same root as the data dir). */
+export function shimPaths(localAppData) {
+    const base = localAppData ?? process.env['LOCALAPPDATA'] ?? '';
+    const binDir = join(base, 'Astramem', 'bin');
+    return {
+        binDir,
+        cmdPath: join(binDir, 'astramemd.cmd'),
+        launcherPath: join(binDir, 'launch.cjs'),
+        pointerPath: join(binDir, 'current.json'),
+    };
+}
+/**
+ * launch.cjs — plain CommonJS so the shim works with any Node the pointer
+ * names, regardless of the package's ESM setup. Kept dependency-free.
+ *
+ * Uses spawnSync (not detached spawn): the scheduled task's own process
+ * lifetime then matches the daemon's, so Task Scheduler status reflects
+ * reality and `schtasks /end` can actually stop the daemon.
+ */
+const LAUNCHER_SOURCE = `// astramem-local service launcher — generated by 'service install' / 'reinstall'.
+// Reads current.json (written on every install/upgrade) and runs the daemon.
+'use strict';
+const { readFileSync } = require('node:fs');
+const { spawnSync } = require('node:child_process');
+const { join } = require('node:path');
+
+const pointerPath = join(__dirname, 'current.json');
+let ptr;
+try {
+  ptr = JSON.parse(readFileSync(pointerPath, 'utf8'));
+} catch (err) {
+  console.error('[astramemd-shim] cannot read ' + pointerPath + ': ' + err.message);
+  console.error('[astramemd-shim] run: astramem-local reinstall');
+  process.exit(1);
+}
+if (!ptr.nodeBin || !ptr.entryJs) {
+  console.error('[astramemd-shim] current.json missing nodeBin/entryJs — run: astramem-local reinstall');
+  process.exit(1);
+}
+const env = { ...process.env };
+if (ptr.logDir) env.ASTRA_LOG_DIR = ptr.logDir; // service mode: rotated file logs
+const args = [ptr.entryJs, 'serve', '--port', String(ptr.port || 7777)];
+const res = spawnSync(ptr.nodeBin, args, { stdio: 'inherit', env });
+process.exit(res.status === null ? 1 : res.status);
+`;
+/**
+ * Write (or overwrite) the stable shim trio. Idempotent — we own the whole
+ * file contents, so a plain overwrite is safe and self-healing.
+ */
+export function writeShim(pointer, paths = shimPaths()) {
+    mkdirSync(paths.binDir, { recursive: true });
+    // The cmd resolves node from the pointer at run time via launch.cjs; the
+    // cmd itself only needs SOME node on PATH-less systems, so it uses the
+    // pointer's nodeBin directly to run the launcher too.
+    const cmd = `@echo off\r\n"${pointer.nodeBin}" "${paths.launcherPath}"\r\n`;
+    writeFileSync(paths.cmdPath, cmd, 'utf8');
+    writeFileSync(paths.launcherPath, LAUNCHER_SOURCE, 'utf8');
+    writeFileSync(paths.pointerPath, JSON.stringify(pointer, null, 2) + '\n', 'utf8');
+    return paths;
+}
+//# sourceMappingURL=shim.js.map

package/dist/service/shim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shim.js","sourceRoot":"","sources":["../../src/service/shim.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAkBjC,+EAA+E;AAC/E,MAAM,UAAU,SAAS,CAAC,YAAqB;IAC7C,MAAM,IAAI,GAAG,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;IAC/D,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;IAC7C,OAAO;QACL,MAAM;QACN,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC;QACtC,YAAY,EAAE,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC;QACxC,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;CAyBvB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,OAAoB,EAAE,QAAmB,SAAS,EAAE;IAC5E,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,yEAAyE;IACzE,uEAAuE;IACvE,sDAAsD;IACtD,MAAM,GAAG,GAAG,iBAAiB,OAAO,CAAC,OAAO,MAAM,KAAK,CAAC,YAAY,OAAO,CAAC;IAC5E,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAC1C,aAAa,CAAC,KAAK,CAAC,YAAY,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;IAC3D,aAAa,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IAClF,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/service/systemd.d.ts

@@ -0,0 +1,11 @@
+import type { ServiceAdapter, ServiceStatus, InstallResult } from './types.js';
+export declare class SystemdAdapter implements ServiceAdapter {
+    readonly platform: "linux";
+    install(execPath: string, port: number): Promise<InstallResult>;
+    uninstall(): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    status(): Promise<ServiceStatus>;
+    installBackupTimer(execPath: string, keep: number): Promise<void>;
+    uninstallBackupTimer(): Promise<void>;
+}