@unerr-ai/unerr 0.2.1 → 0.2.3

package/dist/daemon/client.js

@@ -1,164 +0,0 @@
-/**
- * unerrd client — communicates with the daemon supervisor over UDS.
- *
- * Used by `unerr --mcp` (bridge) and CLI commands to interact with `unerrd`.
- * All methods are fire-and-forget except `ensureRepo` which waits for the
- * repo process to become ready (returns the per-repo UDS sock path).
- *
- * Protocol: newline-delimited JSON over `~/.unerr/unerrd.sock`.
- * Each request is a single connection (connect → send → read → close).
- */
-import { createConnection } from "node:net";
-import { join } from "node:path";
-import { globalDir } from "./registry.js";
-/** Default path to the daemon's UDS control socket. */
-export function daemonSockPath() {
-    return join(globalDir(), "unerrd.sock");
-}
-/**
- * Send a single request to unerrd and return the parsed response.
- * Opens a fresh connection per request (control-plane traffic is low-frequency).
- */
-export function sendRequest(sockPath, request, timeoutMs = 30_000) {
-    return new Promise((resolve, reject) => {
-        let buffer = "";
-        let settled = false;
-        const timer = setTimeout(() => {
-            if (settled)
-                return;
-            settled = true;
-            socket.destroy();
-            reject(new Error(`unerrd request timed out after ${timeoutMs}ms`));
-        }, timeoutMs);
-        timer.unref();
-        const socket = createConnection(sockPath);
-        socket.on("connect", () => {
-            socket.write(`${JSON.stringify(request)}\n`);
-        });
-        socket.on("data", (chunk) => {
-            buffer += chunk.toString();
-            const newlineIdx = buffer.indexOf("\n");
-            if (newlineIdx === -1)
-                return;
-            const line = buffer.slice(0, newlineIdx).trim();
-            if (!line)
-                return;
-            if (settled)
-                return;
-            settled = true;
-            clearTimeout(timer);
-            socket.destroy();
-            try {
-                resolve(JSON.parse(line));
-            }
-            catch {
-                reject(new Error(`Invalid JSON from unerrd: ${line.slice(0, 200)}`));
-            }
-        });
-        socket.on("error", (err) => {
-            if (settled)
-                return;
-            settled = true;
-            clearTimeout(timer);
-            reject(err);
-        });
-        socket.on("close", () => {
-            if (settled)
-                return;
-            settled = true;
-            clearTimeout(timer);
-            reject(new Error("unerrd connection closed before response"));
-        });
-    });
-}
-/**
- * Send a fire-and-forget request (no response needed).
- * Used for `activity` which the daemon acknowledges with no response (null).
- */
-export function sendFireAndForget(sockPath, request) {
-    try {
-        const socket = createConnection(sockPath);
-        socket.on("connect", () => {
-            socket.write(`${JSON.stringify(request)}\n`);
-            // Give the socket a moment to flush, then destroy
-            setTimeout(() => socket.destroy(), 50);
-        });
-        socket.on("error", () => {
-            // Best-effort — daemon might be shutting down
-        });
-    }
-    catch {
-        // Best-effort
-    }
-}
-// ── High-level client methods ─────────────────────────────────────
-/**
- * Ensure a repo process is running. Returns the per-repo UDS sock path.
- * If the repo is already running, returns immediately.
- * If not, the supervisor spawns it and waits for ready.
- */
-export async function ensureRepo(sockPath, repoPath) {
-    const resp = await sendRequest(sockPath, { cmd: "ensure", repo: repoPath });
-    if (!resp.ok) {
-        throw new Error(`ensureRepo failed: ${resp.error}`);
-    }
-    return resp.sock;
-}
-/**
- * Register a bridge connection to a repo.
- * Increments the repo's connection count (prevents idle sweep).
- */
-export async function connectRepo(sockPath, repoPath) {
-    const resp = await sendRequest(sockPath, { cmd: "connect", repo: repoPath });
-    if (!resp.ok) {
-        throw new Error(`connectRepo failed: ${resp.error}`);
-    }
-}
-/**
- * Unregister a bridge connection from a repo.
- * Decrements the repo's connection count.
- */
-export async function disconnectRepo(sockPath, repoPath) {
-    const resp = await sendRequest(sockPath, {
-        cmd: "disconnect",
-        repo: repoPath,
-    });
-    if (!resp.ok) {
-        throw new Error(`disconnectRepo failed: ${resp.error}`);
-    }
-}
-/** Fire-and-forget activity ping. Does not wait for response. */
-export function sendActivity(sockPath, repoPath) {
-    sendFireAndForget(sockPath, { cmd: "activity", repo: repoPath });
-}
-/** Get status of all managed repos. */
-export async function getStatus(sockPath) {
-    const resp = await sendRequest(sockPath, { cmd: "status" });
-    if (!resp.ok) {
-        throw new Error(`getStatus failed: ${resp.error}`);
-    }
-    return resp;
-}
-/**
- * Check if the daemon socket is reachable (probe connection).
- * Returns true if connection succeeds, false otherwise.
- */
-export function probeDaemon(sockPath) {
-    return new Promise((resolve) => {
-        const socket = createConnection(sockPath);
-        const timer = setTimeout(() => {
-            socket.destroy();
-            resolve(false);
-        }, 1000);
-        timer.unref();
-        socket.on("connect", () => {
-            clearTimeout(timer);
-            socket.destroy();
-            resolve(true);
-        });
-        socket.on("error", () => {
-            clearTimeout(timer);
-            resolve(false);
-        });
-    });
-}

package/dist/daemon/detect-ci.js

@@ -1,81 +0,0 @@
-/**
- * CI / container detection — prevents daemon side-effects in ephemeral environments.
- *
- * Used by:
- *   - Auto-install gating (skip platform service installation)
- *   - Bridge auto-spawn (skip unerrd launch in CI)
- *   - Warm-start scheduler (skip boot-time warm-up)
- *
- * Detection covers all major CI providers + container runtimes.
- */
-import { existsSync, readFileSync } from "node:fs";
-let cachedResult = null;
-/**
- * Returns true if running in a CI environment or container.
- * Result is cached for the process lifetime.
- */
-export function isCI() {
-    if (cachedResult !== null)
-        return cachedResult;
-    cachedResult = detect();
-    return cachedResult;
-}
-/** Reset cache (for testing). */
-export function resetCICache() {
-    cachedResult = null;
-}
-function detect() {
-    // Generic CI env (set by most providers)
-    if (env("CI"))
-        return true;
-    if (env("CONTINUOUS_INTEGRATION"))
-        return true;
-    if (env("BUILD_NUMBER"))
-        return true;
-    // Major CI providers
-    if (env("GITHUB_ACTIONS"))
-        return true;
-    if (env("GITLAB_CI"))
-        return true;
-    if (env("CIRCLECI"))
-        return true;
-    if (env("BUILDKITE"))
-        return true;
-    if (env("JENKINS_URL"))
-        return true;
-    if (env("TRAVIS"))
-        return true;
-    if (env("CODEBUILD_BUILD_ID"))
-        return true;
-    if (env("TF_BUILD"))
-        return true;
-    if (env("BITBUCKET_PIPELINE_UUID"))
-        return true;
-    if (env("DRONE"))
-        return true;
-    if (env("WOODPECKER_CI"))
-        return true;
-    if (env("TEAMCITY_VERSION"))
-        return true;
-    if (env("HEROKU_TEST_RUN_ID"))
-        return true;
-    // Container detection
-    if (existsSync("/.dockerenv"))
-        return true;
-    try {
-        const cgroup = readFileSync("/proc/1/cgroup", "utf-8");
-        if (cgroup.includes("docker") ||
-            cgroup.includes("kubepods") ||
-            cgroup.includes("containerd")) {
-            return true;
-        }
-    }
-    catch {
-        // Not on Linux or no permission — fine
-    }
-    return false;
-}
-function env(name) {
-    const v = process.env[name];
-    return v !== undefined && v !== "" && v !== "0" && v !== "false";
-}

package/dist/daemon/platform-linux.js

@@ -1,146 +0,0 @@
-/**
- * Linux auto-start — systemd user unit for unerrd.
- *
- * Generates ~/.config/systemd/user/unerrd.service.
- * Enables with `systemctl --user enable --now`.
- * Runs `loginctl enable-linger` for headless/server boxes.
- * Skips WSL (no boot phase).
- */
-import { execSync } from "node:child_process";
-import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync, } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
-const UNIT_NAME = "unerrd.service";
-function unitDir() {
-    return join(homedir(), ".config", "systemd", "user");
-}
-function unitPath() {
-    return join(unitDir(), UNIT_NAME);
-}
-function resolveUnerrBin() {
-    try {
-        return execSync("which unerr", { encoding: "utf-8" }).trim();
-    }
-    catch {
-        return join(process.argv[1] || "unerr");
-    }
-}
-function isWSL() {
-    try {
-        const version = readFileSync("/proc/version", "utf-8");
-        return version.toLowerCase().includes("microsoft");
-    }
-    catch {
-        return false;
-    }
-}
-function generateUnit(bin) {
-    return `[Unit]
-Description=unerr daemon supervisor
-After=network.target
-
-[Service]
-Type=simple
-ExecStart=${bin} daemon start --foreground
-Restart=on-failure
-RestartSec=5
-Environment=HOME=${homedir()}
-Environment=PATH=${process.env.PATH || "/usr/local/bin:/usr/bin:/bin"}
-
-[Install]
-WantedBy=default.target
-`;
-}
-export function installSystemd() {
-    const path = unitPath();
-    if (isWSL()) {
-        return {
-            installed: false,
-            path,
-            error: "WSL detected — systemd user units have no boot phase. Use Windows auto-start instead.",
-        };
-    }
-    try {
-        const bin = resolveUnerrBin();
-        const dir = unitDir();
-        mkdirSync(dir, { recursive: true });
-        writeFileSync(path, generateUnit(bin), "utf-8");
-        execSync("systemctl --user daemon-reload", { stdio: "ignore" });
-        execSync("systemctl --user enable --now unerrd.service", {
-            stdio: "ignore",
-        });
-        // Enable lingering so the unit starts at boot, not just at first login
-        try {
-            execSync("loginctl enable-linger $USER", { stdio: "ignore" });
-        }
-        catch {
-            // loginctl may not be available (containers, minimal installs)
-        }
-        return { installed: true, path };
-    }
-    catch (err) {
-        return {
-            installed: false,
-            path,
-            error: err instanceof Error ? err.message : String(err),
-        };
-    }
-}
-export function uninstallSystemd() {
-    const path = unitPath();
-    try {
-        try {
-            execSync("systemctl --user disable --now unerrd.service", {
-                stdio: "ignore",
-            });
-        }
-        catch {
-            // Not enabled
-        }
-        if (existsSync(path))
-            unlinkSync(path);
-        try {
-            execSync("systemctl --user daemon-reload", { stdio: "ignore" });
-        }
-        catch {
-            // Best-effort
-        }
-        return { installed: false, path };
-    }
-    catch (err) {
-        return {
-            installed: false,
-            path,
-            error: err instanceof Error ? err.message : String(err),
-        };
-    }
-}
-export function isSystemdInstalled() {
-    return existsSync(unitPath());
-}
-export function getSystemdStatus() {
-    const unitExists = existsSync(unitPath());
-    let active = false;
-    let enabled = false;
-    if (unitExists) {
-        try {
-            const out = execSync("systemctl --user is-active unerrd.service", {
-                encoding: "utf-8",
-            }).trim();
-            active = out === "active";
-        }
-        catch {
-            // inactive or failed
-        }
-        try {
-            const out = execSync("systemctl --user is-enabled unerrd.service", {
-                encoding: "utf-8",
-            }).trim();
-            enabled = out === "enabled";
-        }
-        catch {
-            // not enabled
-        }
-    }
-    return { unitExists, active, enabled };
-}

package/dist/daemon/platform-macos.js

@@ -1,134 +0,0 @@
-/**
- * macOS auto-start — launchd plist for unerrd.
- *
- * Generates and installs ~/Library/LaunchAgents/com.unerr.daemon.plist.
- * KeepAlive on crash, RunAtLoad=true, user-scoped (no sudo).
- * Loaded via `launchctl bootstrap gui/<uid>`.
- */
-import { execSync } from "node:child_process";
-import { existsSync, mkdirSync, unlinkSync, writeFileSync, } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
-const PLIST_NAME = "com.unerr.daemon.plist";
-function plistDir() {
-    return join(homedir(), "Library", "LaunchAgents");
-}
-function plistPath() {
-    return join(plistDir(), PLIST_NAME);
-}
-function logPath() {
-    return join(homedir(), ".unerr", "logs", "unerrd.boot.log");
-}
-function resolveUnerrBin() {
-    try {
-        return execSync("which unerr", { encoding: "utf-8" }).trim();
-    }
-    catch {
-        return join(process.argv[1] || "unerr");
-    }
-}
-function generatePlist(bin) {
-    const log = logPath();
-    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>com.unerr.daemon</string>
-  <key>ProgramArguments</key>
-  <array>
-    <string>${bin}</string>
-    <string>daemon</string>
-    <string>start</string>
-    <string>--foreground</string>
-  </array>
-  <key>RunAtLoad</key>
-  <true/>
-  <key>KeepAlive</key>
-  <dict>
-    <key>SuccessfulExit</key>
-    <false/>
-  </dict>
-  <key>StandardOutPath</key>
-  <string>${log}</string>
-  <key>StandardErrorPath</key>
-  <string>${log}</string>
-  <key>ProcessType</key>
-  <string>Background</string>
-  <key>LowPriorityBackgroundIO</key>
-  <true/>
-</dict>
-</plist>`;
-}
-export function installLaunchd() {
-    const dir = plistDir();
-    const path = plistPath();
-    const bin = resolveUnerrBin();
-    try {
-        mkdirSync(dir, { recursive: true });
-        const logDir = join(homedir(), ".unerr", "logs");
-        mkdirSync(logDir, { recursive: true });
-        const plist = generatePlist(bin);
-        writeFileSync(path, plist, "utf-8");
-        const uid = process.getuid?.() ?? execSync("id -u", { encoding: "utf-8" }).trim();
-        // Unload first if previously loaded (idempotent)
-        try {
-            execSync(`launchctl bootout gui/${uid}/${PLIST_NAME.replace(".plist", "")}`, {
-                stdio: "ignore",
-            });
-        }
-        catch {
-            // Not loaded — fine
-        }
-        execSync(`launchctl bootstrap gui/${uid} "${path}"`, { stdio: "ignore" });
-        return { installed: true, path };
-    }
-    catch (err) {
-        return {
-            installed: false,
-            path,
-            error: err instanceof Error ? err.message : String(err),
-        };
-    }
-}
-export function uninstallLaunchd() {
-    const path = plistPath();
-    try {
-        const uid = process.getuid?.() ?? execSync("id -u", { encoding: "utf-8" }).trim();
-        try {
-            execSync(`launchctl bootout gui/${uid}/${PLIST_NAME.replace(".plist", "")}`, {
-                stdio: "ignore",
-            });
-        }
-        catch {
-            // Not loaded
-        }
-        if (existsSync(path))
-            unlinkSync(path);
-        return { installed: false, path };
-    }
-    catch (err) {
-        return {
-            installed: false,
-            path,
-            error: err instanceof Error ? err.message : String(err),
-        };
-    }
-}
-export function isLaunchdInstalled() {
-    return existsSync(plistPath());
-}
-export function getLaunchdStatus() {
-    const plistExists = existsSync(plistPath());
-    let loaded = false;
-    if (plistExists) {
-        try {
-            const out = execSync("launchctl list", { encoding: "utf-8" });
-            loaded = out.includes("com.unerr.daemon");
-        }
-        catch {
-            // launchctl failed
-        }
-    }
-    return { loaded, plistExists };
-}

package/dist/daemon/platform-windows.js

@@ -1,116 +0,0 @@
-/**
- * Windows auto-start — two-path approach.
- *
- * (a) Preferred: Scheduled Task `Unerr Daemon` via schtasks.
- * (b) Fallback: .cmd shim in %APPDATA%\...\Startup.
- *
- * Both run as current user (no admin).
- */
-import { execSync } from "node:child_process";
-import { existsSync, mkdirSync, unlinkSync, writeFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
-const TASK_NAME = "Unerr Daemon";
-const STARTUP_CMD_NAME = "unerrd.cmd";
-function startupDir() {
-    return join(process.env.APPDATA || join(homedir(), "AppData", "Roaming"), "Microsoft", "Windows", "Start Menu", "Programs", "Startup");
-}
-function startupCmdPath() {
-    return join(startupDir(), STARTUP_CMD_NAME);
-}
-function resolveUnerrBin() {
-    try {
-        return (execSync("where unerr", { encoding: "utf-8" })
-            .trim()
-            .split("\n")[0]
-            ?.trim() ?? "unerr");
-    }
-    catch {
-        return process.argv[1] || "unerr";
-    }
-}
-export function installWindows() {
-    const bin = resolveUnerrBin();
-    // Attempt scheduled task first
-    const taskResult = installScheduledTask(bin);
-    if (taskResult.installed)
-        return taskResult;
-    // Fallback to startup folder
-    return installStartupCmd(bin);
-}
-function installScheduledTask(bin) {
-    const cmd = `"${bin}" daemon start --foreground`;
-    try {
-        // Delete existing task first (idempotent)
-        try {
-            execSync(`schtasks /Delete /TN "${TASK_NAME}" /F`, { stdio: "ignore" });
-        }
-        catch {
-            // Didn't exist
-        }
-        execSync(`schtasks /Create /SC ONLOGON /TN "${TASK_NAME}" /TR ${cmd} /RI 5 /DU 0000:00 /F`, { stdio: "ignore" });
-        return { installed: true, path: `Scheduled Task: ${TASK_NAME}` };
-    }
-    catch {
-        return {
-            installed: false,
-            path: `Scheduled Task: ${TASK_NAME}`,
-            error: "schtasks unavailable — falling back to Startup folder",
-        };
-    }
-}
-function installStartupCmd(bin) {
-    const path = startupCmdPath();
-    try {
-        const dir = startupDir();
-        mkdirSync(dir, { recursive: true });
-        const script = `@echo off\r\n"${bin}" daemon start --foreground\r\n`;
-        writeFileSync(path, script, "utf-8");
-        return { installed: true, path };
-    }
-    catch (err) {
-        return {
-            installed: false,
-            path,
-            error: err instanceof Error ? err.message : String(err),
-        };
-    }
-}
-export function uninstallWindows() {
-    const errors = [];
-    // Remove scheduled task
-    try {
-        execSync(`schtasks /Delete /TN "${TASK_NAME}" /F`, { stdio: "ignore" });
-    }
-    catch {
-        // Didn't exist
-    }
-    // Remove startup cmd
-    const cmdPath = startupCmdPath();
-    try {
-        if (existsSync(cmdPath))
-            unlinkSync(cmdPath);
-    }
-    catch (err) {
-        errors.push(err instanceof Error ? err.message : String(err));
-    }
-    return {
-        installed: false,
-        path: cmdPath,
-        error: errors.length > 0 ? errors.join("; ") : undefined,
-    };
-}
-export function isWindowsInstalled() {
-    // Check scheduled task
-    try {
-        execSync(`schtasks /Query /TN "${TASK_NAME}" /FO CSV /NH`, {
-            stdio: "pipe",
-        });
-        return true;
-    }
-    catch {
-        // Not a scheduled task
-    }
-    // Check startup cmd
-    return existsSync(startupCmdPath());
-}