@rynx-ai/daemon 0.1.0

package/dist/update.js

@@ -0,0 +1,160 @@
+/**
+ * `rynx update` — upgrade the globally-installed daemon npm package and restart.
+ *
+ * The daemon ships as a global npm package (`@rynx-ai/daemon`, bin `rynx`), so
+ * updating = `npm install -g <pkg>@latest` + restart.
+ *
+ *   rynx update [version]                 upgrade (to a version, or latest) + restart
+ *   rynx update --check                   report status only (human one-liner)
+ *   rynx update --check --json            report status only (typed UpdateCheck JSON)
+ *   rynx update --result-file <path>      after finishing, write the outcome JSON to
+ *                                         <path> (channel-agnostic UpdateOutcome; a
+ *                                         plugin reads it post-restart to notify a chat)
+ */
+import { spawnSync } from "node:child_process";
+import { mkdirSync, writeFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, sep } from "node:path";
+import { loadConfig } from "@rynx-ai/core";
+import { formatControlUrl, startDaemon } from "./pm2.js";
+/** This daemon package's name + installed version (read from its own package.json). */
+function selfPackage() {
+    const require = createRequire(import.meta.url);
+    const pkg = require("../package.json");
+    return { name: pkg.name ?? "@rynx-ai/daemon", version: pkg.version ?? "0.0.0" };
+}
+/** This package's root directory (the dir holding its package.json). */
+function packageRoot() {
+    const require = createRequire(import.meta.url);
+    return dirname(require.resolve("../package.json"));
+}
+/**
+ * True when running from a working checkout / linked dev build rather than an
+ * npm install. We refuse to `npm install -g` over it — that would clobber the
+ * dev build. An installed package always lives under a `node_modules` directory;
+ * a checkout (e.g. `packages/daemon`) does not.
+ */
+function isLocalDevInstall() {
+    return !packageRoot().split(sep).includes("node_modules");
+}
+/** Latest published version from the configured npm registry, or null on failure. */
+function latestVersion(name) {
+    const result = spawnSync("npm", ["view", name, "version"], { encoding: "utf8", timeout: 60_000 });
+    if (result.error || result.status !== 0)
+        return null;
+    return result.stdout.trim() || null;
+}
+/** Is `latest` a newer release than `current`? Numeric major.minor.patch (prerelease ignored). */
+export function isNewer(latest, current) {
+    const parse = (v) => v.split("-")[0].split(".").map((n) => Number(n) || 0);
+    const a = parse(latest);
+    const b = parse(current);
+    for (let i = 0; i < 3; i++) {
+        const x = a[i] ?? 0;
+        const y = b[i] ?? 0;
+        if (x !== y)
+            return x > y;
+    }
+    return false;
+}
+/** Typed `--check` result a channel consumes via `--check --json`. */
+export function buildUpdateCheck(current, latest) {
+    if (!latest)
+        return { status: "error", detail: "could not resolve latest version" };
+    return isNewer(latest, current)
+        ? { status: "behind", current, latest }
+        : { status: "up_to_date", current };
+}
+/** Format the one-line, human-readable status emitted by a bare `--check`. */
+export function checkStatusLine(current, latest) {
+    const check = buildUpdateCheck(current, latest);
+    switch (check.status) {
+        case "behind":
+            return `behind ${check.current} ${check.latest}`;
+        case "up_to_date":
+            return `up_to_date ${check.current}`;
+        case "error":
+            return `error ${check.detail}`;
+    }
+}
+function npmInstallGlobal(name, version) {
+    const result = spawnSync("npm", ["install", "-g", `${name}@${version}`, "--no-audit", "--no-fund"], { stdio: "inherit", timeout: 600_000 });
+    return !result.error && result.status === 0;
+}
+/** Poll `/health` until the restarted daemon answers (or give up). */
+async function verifyHealthy() {
+    const config = loadConfig();
+    const url = `${formatControlUrl(config.HOST, config.PORT)}health`;
+    for (let attempt = 0; attempt < 10; attempt++) {
+        await new Promise((r) => setTimeout(r, 1000));
+        try {
+            const res = await fetch(url);
+            if (res.ok)
+                return true;
+        }
+        catch {
+            /* not back up yet */
+        }
+    }
+    return false;
+}
+/** Write the post-restart outcome to `--result-file` (best-effort; stamps `at`). */
+function writeOutcome(file, outcome) {
+    if (!file)
+        return;
+    try {
+        mkdirSync(dirname(file), { recursive: true });
+        const full = { ...outcome, at: new Date().toISOString() };
+        writeFileSync(file, `${JSON.stringify(full, null, 2)}\n`);
+    }
+    catch {
+        /* best-effort */
+    }
+}
+/** Run `rynx update`. Returns a process exit code. */
+export async function runUpdate(opts) {
+    const { name, version: current } = selfPackage();
+    const latest = latestVersion(name);
+    if (opts.check) {
+        console.log(opts.json ? JSON.stringify(buildUpdateCheck(current, latest)) : checkStatusLine(current, latest));
+        return 0;
+    }
+    // Never `npm install -g` over a working checkout / linked dev build.
+    if (isLocalDevInstall()) {
+        console.error(`update: ${name} is a local dev install — update your checkout (e.g. pnpm build), not npm`);
+        writeOutcome(opts.resultFile, { status: "fail", from: current, to: current, error: "local dev install" });
+        return 1;
+    }
+    const target = opts.version ?? latest;
+    if (!target) {
+        console.error(`update: could not resolve a target version for ${name} (registry unreachable?)`);
+        writeOutcome(opts.resultFile, { status: "fail", from: current, to: current, error: "could not resolve target version" });
+        return 1;
+    }
+    if (!opts.version && latest && !isNewer(latest, current)) {
+        console.log(`Already on the latest ${name}@${current}.`);
+        return 0;
+    }
+    console.log(`Updating ${name}: ${current} → ${target} …`);
+    if (!npmInstallGlobal(name, target)) {
+        console.error("update: npm install failed");
+        writeOutcome(opts.resultFile, { status: "fail", from: current, to: target, error: "npm install failed" });
+        // The install failed before any restart, so the channel that spawned us never
+        // reboots to drain the outcome. Bounce the daemon (still on the old, healthy
+        // version) so its boot-time drain delivers the failure to chat.
+        if (opts.resultFile)
+            startDaemon({ force: true });
+        return 1;
+    }
+    startDaemon({ force: true });
+    if (!(await verifyHealthy())) {
+        console.error(`update: ${name}@${target} did not come back up — rolling back to ${current}`);
+        npmInstallGlobal(name, current);
+        startDaemon({ force: true });
+        writeOutcome(opts.resultFile, { status: "fail", from: current, to: target, error: "did not come up; rolled back" });
+        return 1;
+    }
+    console.log(`Updated ${name} → ${target} and restarted.`);
+    writeOutcome(opts.resultFile, { status: "ok", from: current, to: target });
+    return 0;
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@rynx-ai/daemon",
+  "version": "0.1.0",
+  "description": "rynx daemon CLI: supervises the resident @rynx-ai/server via pm2 and loads channel plugins recorded in ~/.rynx/rynx.db.",
+  "type": "module",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "rynx": "./dist/cli.js"
+  },
+  "main": "./dist/index-daemon.js",
+  "exports": {
+    "./server": {
+      "types": "./dist/daemon-server.d.ts",
+      "default": "./dist/daemon-server.js"
+    }
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.6.0",
+    "better-sqlite3": "^12.11.1",
+    "pm2": "^6.0.0",
+    "zod": "^4.3.6",
+    "@rynx-ai/core": "0.1.0",
+    "@rynx-ai/protocol": "0.1.0",
+    "@rynx-ai/server": "0.1.0",
+    "@rynx-ai/emulator": "0.1.7"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.json && chmod +x dist/cli.js dist/index-daemon.js",
+    "dev": "tsx watch --tsconfig ../../tsconfig.json src/index-daemon.ts"
+  }
+}