@shardworks/nexus 0.1.152 → 0.1.154

package/dist/commands/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAOlE,qFAAqF;AACrF,eAAO,MAAM,iBAAiB,EASzB,cAAc,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AASlE,qFAAqF;AACrF,eAAO,MAAM,iBAAiB,EAWzB,cAAc,EAAE,CAAC"}

package/dist/commands/index.js

@@ -12,6 +12,8 @@ import init from "./init.js";
 import version from "./version.js";
 import status from "./status.js";
 import upgrade from "./upgrade.js";
+import start from "./start.js";
+import stop from "./stop.js";
 import { pluginList, pluginInstall, pluginRemove, pluginUpgrade } from "./plugin.js";
 /** All framework commands, typed as the base ToolDefinition for uniform handling. */
 export const frameworkCommands = [
@@ -19,6 +21,8 @@ export const frameworkCommands = [
     version,
     status,
     upgrade,
+    start,
+    stop,
     pluginList,
     pluginInstall,
     pluginRemove,

package/dist/commands/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAErF,qFAAqF;AACrF,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI;IACJ,OAAO;IACP,MAAM;IACN,OAAO;IACP,UAAU;IACV,aAAa;IACb,YAAY;IACZ,aAAa;CACM,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAErF,qFAAqF;AACrF,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI;IACJ,OAAO;IACP,MAAM;IACN,OAAO;IACP,KAAK;IACL,IAAI;IACJ,UAAU;IACV,aAAa;IACb,YAAY;IACZ,aAAa;CACM,CAAC"}

package/dist/commands/start.d.ts

@@ -0,0 +1,27 @@
+/**
+ * nsg start — guild daemon mode.
+ *
+ * Two modes selected by --foreground / -f:
+ *
+ * - **Detached (default):** spawns the same `nsg` binary with `--foreground`
+ *   added, fully detached from this terminal, with stdio piped to
+ *   `.nexus/logs/daemon.{out,err}`. Returns once startup-sync confirms the
+ *   tool HTTP server is reachable.
+ *
+ * - **Foreground (`--foreground` / `-f`):** the inline daemon loop. Boots the
+ *   guild, starts the Tool HTTP Server (with a Stacks-backed authorize
+ *   closure), starts the Oculus, runs the Spider continual crawl loop, writes
+ *   the pidfile, installs SIGTERM/SIGINT handlers, and blocks forever.
+ *
+ * The foreground mode IS the daemon — there is no separate daemon entry
+ * point. `nsg start` (detached) just re-execs itself with --foreground.
+ *
+ * The pidfile lives at `.nexus/daemon.pid` relative to the guild home.
+ * See: docs/architecture/detached-sessions.md, .scratch/nsg-daemon-mode-brief.md
+ */
+import { z } from 'zod';
+declare const _default: import("@shardworks/tools-apparatus").ToolDefinition<{
+    foreground: z.ZodOptional<z.ZodBoolean>;
+}>;
+export default _default;
+//# sourceMappingURL=start.d.ts.map

package/dist/commands/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/commands/start.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;AAgUxB,wBA4BG"}

package/dist/commands/start.js

@@ -0,0 +1,305 @@
+/**
+ * nsg start — guild daemon mode.
+ *
+ * Two modes selected by --foreground / -f:
+ *
+ * - **Detached (default):** spawns the same `nsg` binary with `--foreground`
+ *   added, fully detached from this terminal, with stdio piped to
+ *   `.nexus/logs/daemon.{out,err}`. Returns once startup-sync confirms the
+ *   tool HTTP server is reachable.
+ *
+ * - **Foreground (`--foreground` / `-f`):** the inline daemon loop. Boots the
+ *   guild, starts the Tool HTTP Server (with a Stacks-backed authorize
+ *   closure), starts the Oculus, runs the Spider continual crawl loop, writes
+ *   the pidfile, installs SIGTERM/SIGINT handlers, and blocks forever.
+ *
+ * The foreground mode IS the daemon — there is no separate daemon entry
+ * point. `nsg start` (detached) just re-execs itself with --foreground.
+ *
+ * The pidfile lives at `.nexus/daemon.pid` relative to the guild home.
+ * See: docs/architecture/detached-sessions.md, .scratch/nsg-daemon-mode-brief.md
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { spawn } from 'node:child_process';
+import { z } from 'zod';
+import { tool } from '@shardworks/tools-apparatus';
+import { guild } from '@shardworks/nexus-core';
+// ── Filesystem layout helpers ────────────────────────────────────────
+function paths(home) {
+    const nexusDir = path.join(home, '.nexus');
+    return {
+        nexusDir,
+        pidFile: path.join(nexusDir, 'daemon.pid'),
+        logsDir: path.join(nexusDir, 'logs'),
+        outLog: path.join(nexusDir, 'logs', 'daemon.out'),
+        errLog: path.join(nexusDir, 'logs', 'daemon.err'),
+    };
+}
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === 'ESRCH')
+            return false;
+        // EPERM → exists but we can't signal it. Treat as alive.
+        return true;
+    }
+}
+function readPidFile(pidFile) {
+    try {
+        const raw = fs.readFileSync(pidFile, 'utf-8').trim();
+        const pid = Number(raw);
+        return Number.isFinite(pid) && pid > 0 ? pid : null;
+    }
+    catch {
+        return null;
+    }
+}
+function tryUnlink(file) {
+    try {
+        fs.unlinkSync(file);
+    }
+    catch {
+        // ignore
+    }
+}
+function tailFile(file, lines) {
+    try {
+        const content = fs.readFileSync(file, 'utf-8');
+        const all = content.split('\n');
+        return all.slice(-lines).join('\n');
+    }
+    catch {
+        return '';
+    }
+}
+// ── Detached mode — spawn self with --foreground ─────────────────────
+async function startDetached(home) {
+    const p = paths(home);
+    // Idempotency: already-running check.
+    const existing = readPidFile(p.pidFile);
+    if (existing && isProcessAlive(existing)) {
+        return `Guild daemon already running (pid: ${existing})`;
+    }
+    if (existing && !isProcessAlive(existing)) {
+        tryUnlink(p.pidFile);
+    }
+    fs.mkdirSync(p.logsDir, { recursive: true });
+    const outFd = fs.openSync(p.outLog, 'a');
+    const errFd = fs.openSync(p.errLog, 'a');
+    // Re-exec the same nsg entry point with --foreground appended.
+    // process.execPath is node, process.argv[1] is the cli.ts (or compiled
+    // cli.js) entry — same one Commander dispatched us from.
+    const nodeArgs = process.execArgv.slice();
+    const cliEntry = process.argv[1];
+    const child = spawn(process.execPath, [...nodeArgs, cliEntry, 'start', '--foreground', '--guild-root', home], {
+        detached: true,
+        stdio: ['ignore', outFd, errFd],
+        cwd: home,
+        env: process.env,
+    });
+    child.unref();
+    // Startup sync: poll for pidfile existence + tool server reachability.
+    const deadline = Date.now() + 10_000;
+    let lastError = '';
+    while (Date.now() < deadline) {
+        const pid = readPidFile(p.pidFile);
+        if (pid && isProcessAlive(pid)) {
+            const reached = await pingToolServer(home);
+            if (reached.ok) {
+                const oculusUrl = await guessOculusUrl(home);
+                return [
+                    `Guild daemon started (pid: ${pid})`,
+                    `  Tool HTTP Server:  ${reached.url}`,
+                    `  Oculus:            ${oculusUrl ?? '(starting)'}`,
+                    `  Spider:            crawling (continual mode)`,
+                    `  Logs:              ${path.relative(home, p.outLog)}, ${path.relative(home, p.errLog)}`,
+                ].join('\n');
+            }
+            lastError = reached.error;
+        }
+        await new Promise((r) => setTimeout(r, 250));
+    }
+    // Startup failed. Tail the err log to help debugging.
+    const tail = tailFile(p.errLog, 20);
+    const msg = [
+        'Guild daemon failed to start within 10s.',
+        lastError ? `Last error: ${lastError}` : '',
+        tail ? `\n--- last 20 lines of ${path.relative(home, p.errLog)} ---\n${tail}` : '',
+    ].filter(Boolean).join('\n');
+    throw new Error(msg);
+}
+async function pingToolServer(home) {
+    // Best-effort port discovery — read guild.json tools.serverPort if present.
+    const port = readToolServerPort(home);
+    const url = `http://127.0.0.1:${port}`;
+    try {
+        const res = await fetch(`${url}/api/tools/list`);
+        if (res.ok)
+            return { ok: true, url };
+        return { ok: false, error: `HTTP ${res.status}` };
+    }
+    catch (err) {
+        return { ok: false, error: err instanceof Error ? err.message : String(err) };
+    }
+}
+function readToolServerPort(home) {
+    try {
+        const raw = fs.readFileSync(path.join(home, 'guild.json'), 'utf-8');
+        const cfg = JSON.parse(raw);
+        return cfg.tools?.serverPort ?? 7471;
+    }
+    catch {
+        return 7471;
+    }
+}
+async function guessOculusUrl(home) {
+    try {
+        const raw = fs.readFileSync(path.join(home, 'guild.json'), 'utf-8');
+        const cfg = JSON.parse(raw);
+        const port = cfg.oculus?.port ?? 7470;
+        return `http://127.0.0.1:${port}`;
+    }
+    catch {
+        return null;
+    }
+}
+// ── Foreground mode — the inline daemon loop ────────────────────────
+async function startForeground(home) {
+    const p = paths(home);
+    // Idempotency: refuse to double-start.
+    const existing = readPidFile(p.pidFile);
+    if (existing && isProcessAlive(existing)) {
+        throw new Error(`Guild daemon already running (pid: ${existing})`);
+    }
+    if (existing)
+        tryUnlink(p.pidFile);
+    fs.mkdirSync(p.nexusDir, { recursive: true });
+    // The guild is already booted by program.ts before any tool handler runs.
+    const g = guild();
+    // Build the Stacks-backed authorize closure for the tool server.
+    // Looks up the session by id and checks its authorizedTools list.
+    const stacks = g.apparatus('stacks');
+    const sessionsBook = stacks.book('animator', 'sessions');
+    const authorize = async (sessionId, toolName) => {
+        const doc = await sessionsBook.get(sessionId);
+        if (!doc)
+            return false;
+        if (doc.status !== 'pending' && doc.status !== 'running')
+            return false;
+        return doc.authorizedTools?.includes(toolName) ?? false;
+    };
+    // Start the Tool HTTP Server.
+    const tools = g.apparatus('tools');
+    const toolServer = await tools.startToolServer({ authorize });
+    console.log(`[daemon] Tool HTTP Server listening at ${toolServer.url}`);
+    // Start the Oculus HTTP server (best-effort — only if installed).
+    let oculusUrl = null;
+    try {
+        const oculus = g.apparatus('oculus');
+        await oculus.startServer();
+        oculusUrl = `http://127.0.0.1:${oculus.port()}`;
+        console.log(`[daemon] Oculus listening at ${oculusUrl}`);
+    }
+    catch {
+        console.warn('[daemon] Oculus not installed — skipping');
+    }
+    // Write the pidfile now that the servers are up.
+    fs.writeFileSync(p.pidFile, String(process.pid), 'utf-8');
+    // ── Shutdown wiring ────────────────────────────────────────────────
+    let shuttingDown = false;
+    let spiderStop = false;
+    const shutdown = async (signal) => {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        console.log(`[daemon] ${signal} received — shutting down...`);
+        spiderStop = true;
+        try {
+            await toolServer.close();
+        }
+        catch (err) {
+            console.warn(`[daemon] tool server close failed: ${err instanceof Error ? err.message : err}`);
+        }
+        // Oculus has no documented stop hook today — best effort: leave the
+        // process exit to tear it down. (TODO: when oculus exposes stop(), call it.)
+        tryUnlink(p.pidFile);
+        console.log('[daemon] stopped');
+        process.exit(0);
+    };
+    process.on('SIGTERM', () => { void shutdown('SIGTERM'); });
+    process.on('SIGINT', () => { void shutdown('SIGINT'); });
+    console.log('[daemon] Guild daemon ready');
+    console.log(`  Tool HTTP Server:  ${toolServer.url}`);
+    if (oculusUrl)
+        console.log(`  Oculus:            ${oculusUrl}`);
+    console.log(`  Spider:            crawling (continual mode)`);
+    console.log(`  Pidfile:           ${path.relative(home, p.pidFile)}`);
+    // ── Spider continual crawl loop ────────────────────────────────────
+    //
+    // This is what keeps the daemon alive. If the Spider isn't installed,
+    // we still run a sleep loop so the tool/oculus servers stay up.
+    let spider = null;
+    let intervalMs = 5000;
+    try {
+        spider = g.apparatus('spider');
+        const spiderCfg = g.guildConfig().spider ?? {};
+        intervalMs = spiderCfg.pollIntervalMs ?? 5000;
+    }
+    catch {
+        console.warn('[daemon] Spider not installed — running idle (servers only)');
+    }
+    while (!spiderStop) {
+        if (spider) {
+            try {
+                const result = await spider.crawl();
+                if (result === null) {
+                    await new Promise((r) => setTimeout(r, intervalMs));
+                }
+            }
+            catch (err) {
+                console.error(`[daemon] crawl() error: ${err instanceof Error ? err.message : err}`);
+                await new Promise((r) => setTimeout(r, intervalMs));
+            }
+        }
+        else {
+            await new Promise((r) => setTimeout(r, intervalMs));
+        }
+    }
+    // Unreachable — shutdown() exits the process.
+    return new Promise(() => { });
+}
+// ── Tool definition ──────────────────────────────────────────────────
+export default tool({
+    name: 'start',
+    description: 'Start the guild daemon (tool server + oculus + spider crawl loop)',
+    callableBy: ['patron'],
+    params: {
+        foreground: z
+            .boolean()
+            .optional()
+            .describe('Run in foreground (the inline daemon loop). Default: detached.'),
+    },
+    handler: async (params) => {
+        // The guild is booted by program.ts before this handler runs, so the
+        // singleton already knows the home directory.
+        let home;
+        try {
+            home = guild().home;
+        }
+        catch {
+            throw new Error('Not inside a guild. Run `nsg init` to create one first.');
+        }
+        if (params.foreground) {
+            await startForeground(home);
+            // startForeground never returns under normal operation.
+            return '';
+        }
+        return startDetached(home);
+    },
+});
+//# sourceMappingURL=start.js.map

package/dist/commands/start.js.map

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

package/dist/commands/stop.d.ts

@@ -0,0 +1,17 @@
+/**
+ * nsg stop — terminate the guild daemon.
+ *
+ * Reads `.nexus/daemon.pid`, sends SIGTERM, polls for exit, and escalates
+ * to SIGKILL if the process is still alive after 10s. Removes the pidfile
+ * after the process is gone.
+ *
+ * In-flight detached anima sessions (babysitter processes) are unaffected:
+ * they were spawned with `detached: true` and have their own lifecycle. Only
+ * the daemon process itself (tool server, oculus, spider crawl loop) stops.
+ */
+import { z } from 'zod';
+declare const _default: import("@shardworks/tools-apparatus").ToolDefinition<{
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}>;
+export default _default;
+//# sourceMappingURL=stop.d.ts.map

package/dist/commands/stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.d.ts","sourceRoot":"","sources":["../../src/commands/stop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;AA0CxB,wBA0DG"}

package/dist/commands/stop.js

@@ -0,0 +1,111 @@
+/**
+ * nsg stop — terminate the guild daemon.
+ *
+ * Reads `.nexus/daemon.pid`, sends SIGTERM, polls for exit, and escalates
+ * to SIGKILL if the process is still alive after 10s. Removes the pidfile
+ * after the process is gone.
+ *
+ * In-flight detached anima sessions (babysitter processes) are unaffected:
+ * they were spawned with `detached: true` and have their own lifecycle. Only
+ * the daemon process itself (tool server, oculus, spider crawl loop) stops.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { z } from 'zod';
+import { tool } from '@shardworks/tools-apparatus';
+import { guild } from '@shardworks/nexus-core';
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === 'ESRCH')
+            return false;
+        return true;
+    }
+}
+function readPidFile(pidFile) {
+    try {
+        const raw = fs.readFileSync(pidFile, 'utf-8').trim();
+        const pid = Number(raw);
+        return Number.isFinite(pid) && pid > 0 ? pid : null;
+    }
+    catch {
+        return null;
+    }
+}
+function tryUnlink(file) {
+    try {
+        fs.unlinkSync(file);
+    }
+    catch {
+        // ignore
+    }
+}
+async function waitForExit(pid, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (!isProcessAlive(pid))
+            return true;
+        await new Promise((r) => setTimeout(r, 200));
+    }
+    return false;
+}
+export default tool({
+    name: 'stop',
+    description: 'Stop the guild daemon (graceful SIGTERM with SIGKILL escalation)',
+    callableBy: ['patron'],
+    params: {
+        timeoutMs: z
+            .number()
+            .optional()
+            .describe('How long to wait for graceful shutdown before SIGKILL (default: 10000)'),
+    },
+    handler: async (params) => {
+        let home;
+        try {
+            home = guild().home;
+        }
+        catch {
+            throw new Error('Not inside a guild.');
+        }
+        const pidFile = path.join(home, '.nexus', 'daemon.pid');
+        const pid = readPidFile(pidFile);
+        if (pid === null) {
+            return 'No guild daemon running (no pidfile).';
+        }
+        if (!isProcessAlive(pid)) {
+            tryUnlink(pidFile);
+            return `Stale pidfile removed (pid ${pid} was not alive).`;
+        }
+        // Send SIGTERM and poll.
+        try {
+            process.kill(pid, 'SIGTERM');
+        }
+        catch (err) {
+            throw new Error(`Failed to signal pid ${pid}: ${err instanceof Error ? err.message : err}`);
+        }
+        const timeoutMs = params.timeoutMs ?? 10_000;
+        const exited = await waitForExit(pid, timeoutMs);
+        if (!exited) {
+            // Escalate.
+            try {
+                process.kill(pid, 'SIGKILL');
+            }
+            catch {
+                // already dead
+            }
+            const killed = await waitForExit(pid, 2000);
+            tryUnlink(pidFile);
+            if (!killed) {
+                throw new Error(`Daemon (pid ${pid}) did not exit even after SIGKILL.`);
+            }
+            return `Guild daemon stopped (pid: ${pid}, escalated to SIGKILL after ${timeoutMs}ms).`;
+        }
+        tryUnlink(pidFile);
+        return `Guild daemon stopped (pid: ${pid}).`;
+    },
+});
+//# sourceMappingURL=stop.js.map

package/dist/commands/stop.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shardworks/nexus",
-  "version": "0.1.152",
+  "version": "0.1.154",
   "license": "ISC",
   "repository": {
     "type": "git",
@@ -21,9 +21,9 @@
   "dependencies": {
     "commander": "14.0.3",
     "zod": "4.3.6",
-    "@shardworks/nexus-core": "0.1.152",
-    "@shardworks/nexus-arbor": "0.1.152",
-    "@shardworks/tools-apparatus": "0.1.152"
+    "@shardworks/nexus-core": "0.1.154",
+    "@shardworks/nexus-arbor": "0.1.154",
+    "@shardworks/tools-apparatus": "0.1.154"
   },
   "devDependencies": {
     "@types/node": "25.5.0"