@urateam/cli 0.1.40 → 0.1.41

package/dist/__tests__/service-unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=service-unit.test.d.ts.map

package/dist/__tests__/service-unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/service-unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/service-unit.test.js

@@ -0,0 +1,65 @@
+import { describe, it, expect } from "vitest";
+import { renderLaunchdPlist, renderSystemdUserUnit, } from "../lib/service-unit.js";
+const FIXTURE = {
+    binaryPath: "/usr/local/bin/ura",
+    urateamHome: "/Users/x/.urateam",
+    envFilePath: "/Users/x/.urateam/.env",
+    stdoutPath: "/Users/x/.urateam/data/daemon.log",
+    stderrPath: "/Users/x/.urateam/data/daemon.err.log",
+};
+describe("renderLaunchdPlist", () => {
+    it("includes the binary path under ProgramArguments", () => {
+        const out = renderLaunchdPlist(FIXTURE);
+        expect(out).toContain("<string>/usr/local/bin/ura</string>");
+        expect(out).toContain("<string>start</string>");
+    });
+    it("propagates URATEAM_HOME via EnvironmentVariables", () => {
+        const out = renderLaunchdPlist(FIXTURE);
+        expect(out).toContain("<key>URATEAM_HOME</key>");
+        expect(out).toContain("<string>/Users/x/.urateam</string>");
+    });
+    it("sets RunAtLoad and KeepAlive", () => {
+        const out = renderLaunchdPlist(FIXTURE);
+        expect(out).toMatch(/<key>RunAtLoad<\/key>\s*<true\/>/);
+        expect(out).toMatch(/<key>KeepAlive<\/key>\s*<true\/>/);
+    });
+    it("emits stdout and stderr log paths", () => {
+        const out = renderLaunchdPlist(FIXTURE);
+        expect(out).toContain("/Users/x/.urateam/data/daemon.log");
+        expect(out).toContain("/Users/x/.urateam/data/daemon.err.log");
+    });
+    it("starts with the XML declaration", () => {
+        expect(renderLaunchdPlist(FIXTURE).startsWith('<?xml version="1.0"')).toBe(true);
+    });
+    it("is deterministic — same input produces byte-for-byte same output", () => {
+        expect(renderLaunchdPlist(FIXTURE)).toBe(renderLaunchdPlist(FIXTURE));
+    });
+    it("matches the canonical snapshot", () => {
+        expect(renderLaunchdPlist(FIXTURE)).toMatchSnapshot();
+    });
+});
+describe("renderSystemdUserUnit", () => {
+    it("uses simple service type", () => {
+        expect(renderSystemdUserUnit(FIXTURE)).toContain("Type=simple");
+    });
+    it("sets ExecStart to the binary + 'start'", () => {
+        expect(renderSystemdUserUnit(FIXTURE)).toContain("ExecStart=/usr/local/bin/ura start");
+    });
+    it("propagates URATEAM_HOME via Environment", () => {
+        const out = renderSystemdUserUnit(FIXTURE);
+        expect(out).toContain("Environment=URATEAM_HOME=/Users/x/.urateam");
+    });
+    it("sets EnvironmentFile to the resolved .env path", () => {
+        expect(renderSystemdUserUnit(FIXTURE)).toContain("EnvironmentFile=/Users/x/.urateam/.env");
+    });
+    it("uses WantedBy=default.target so user-mode systemd picks it up", () => {
+        expect(renderSystemdUserUnit(FIXTURE)).toContain("WantedBy=default.target");
+    });
+    it("sets Restart=always", () => {
+        expect(renderSystemdUserUnit(FIXTURE)).toContain("Restart=always");
+    });
+    it("matches the canonical snapshot", () => {
+        expect(renderSystemdUserUnit(FIXTURE)).toMatchSnapshot();
+    });
+});
+//# sourceMappingURL=service-unit.test.js.map

package/dist/__tests__/service-unit.test.js.map

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

package/dist/__tests__/service.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=service.test.d.ts.map

package/dist/__tests__/service.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/service.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/service.test.js

@@ -0,0 +1,193 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+import { mkdtempSync, rmSync, existsSync, readFileSync, writeFileSync, mkdirSync, } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+const execFileMock = vi.fn(async (_cmd, _args) => ({
+    stdout: "",
+    stderr: "",
+}));
+vi.mock("node:child_process", async () => {
+    const actual = await vi.importActual("node:child_process");
+    return {
+        ...actual,
+        execFile: (cmd, args, cb) => {
+            execFileMock(cmd, args)
+                .then((r) => cb(null, r.stdout, r.stderr))
+                .catch((e) => cb(e));
+        },
+    };
+});
+let fakeHome;
+vi.mock("node:os", async () => {
+    const actual = await vi.importActual("node:os");
+    return {
+        ...actual,
+        homedir: () => fakeHome,
+        userInfo: () => ({ username: "tester" }),
+    };
+});
+const { serviceCommand } = await import("../commands/service.js");
+describe("ura service install (darwin)", () => {
+    let tmp;
+    let originalPlatform;
+    beforeEach(() => {
+        tmp = mkdtempSync(join(tmpdir(), "ura-service-"));
+        fakeHome = tmp;
+        mkdirSync(join(tmp, "Library", "LaunchAgents"), { recursive: true });
+        mkdirSync(join(tmp, ".urateam", "data"), { recursive: true });
+        process.env.URATEAM_HOME = join(tmp, ".urateam");
+        originalPlatform = Object.getOwnPropertyDescriptor(process, "platform");
+        Object.defineProperty(process, "platform", { value: "darwin" });
+        execFileMock.mockClear();
+    });
+    afterEach(() => {
+        delete process.env.URATEAM_HOME;
+        Object.defineProperty(process, "platform", originalPlatform);
+        rmSync(tmp, { recursive: true, force: true });
+    });
+    it("writes the plist and loads it via launchctl", async () => {
+        await serviceCommand.parseAsync(["install"], { from: "user" });
+        const plist = join(tmp, "Library", "LaunchAgents", "com.urateam.daemon.plist");
+        expect(existsSync(plist)).toBe(true);
+        const content = readFileSync(plist, "utf8");
+        expect(content).toContain("<key>Label</key>");
+        expect(content).toContain("com.urateam.daemon");
+        const launchctlCalls = execFileMock.mock.calls.filter(([cmd]) => cmd === "launchctl");
+        expect(launchctlCalls.length).toBeGreaterThanOrEqual(1);
+        expect(launchctlCalls.some(([, args]) => args.includes("load"))).toBe(true);
+    });
+    it("--dry-run prints the plist and writes nothing", async () => {
+        const spy = vi.spyOn(console, "log").mockImplementation(() => { });
+        await serviceCommand.parseAsync(["install", "--dry-run"], { from: "user" });
+        const plist = join(tmp, "Library", "LaunchAgents", "com.urateam.daemon.plist");
+        expect(existsSync(plist)).toBe(false);
+        const out = spy.mock.calls.flat().join("\n");
+        expect(out).toContain("<?xml");
+        expect(out).toContain("com.urateam.daemon");
+        expect(execFileMock).not.toHaveBeenCalled();
+        spy.mockRestore();
+    });
+    it("is idempotent: skips when the plist already exists", async () => {
+        const plist = join(tmp, "Library", "LaunchAgents", "com.urateam.daemon.plist");
+        writeFileSync(plist, "<!-- existing -->");
+        const spy = vi.spyOn(console, "log").mockImplementation(() => { });
+        await serviceCommand.parseAsync(["install"], { from: "user" });
+        expect(readFileSync(plist, "utf8")).toBe("<!-- existing -->");
+        expect(spy.mock.calls.flat().join("\n")).toMatch(/already exists/i);
+        expect(execFileMock).not.toHaveBeenCalled();
+        spy.mockRestore();
+    });
+});
+describe("ura service install (linux)", () => {
+    let tmp;
+    let originalPlatform;
+    beforeEach(() => {
+        tmp = mkdtempSync(join(tmpdir(), "ura-service-"));
+        fakeHome = tmp;
+        mkdirSync(join(tmp, ".config", "systemd", "user"), { recursive: true });
+        mkdirSync(join(tmp, ".urateam", "data"), { recursive: true });
+        process.env.URATEAM_HOME = join(tmp, ".urateam");
+        originalPlatform = Object.getOwnPropertyDescriptor(process, "platform");
+        Object.defineProperty(process, "platform", { value: "linux" });
+        execFileMock.mockClear();
+    });
+    afterEach(() => {
+        delete process.env.URATEAM_HOME;
+        Object.defineProperty(process, "platform", originalPlatform);
+        rmSync(tmp, { recursive: true, force: true });
+    });
+    it("writes the systemd unit and runs daemon-reload + enable --now", async () => {
+        await serviceCommand.parseAsync(["install"], { from: "user" });
+        const unit = join(tmp, ".config", "systemd", "user", "urateam.service");
+        expect(existsSync(unit)).toBe(true);
+        expect(readFileSync(unit, "utf8")).toContain("ExecStart=");
+        const systemctlCalls = execFileMock.mock.calls.filter(([cmd]) => cmd === "systemctl");
+        expect(systemctlCalls.some(([, args]) => args.includes("daemon-reload"))).toBe(true);
+        expect(systemctlCalls.some(([, args]) => args.includes("enable") && args.includes("urateam.service"))).toBe(true);
+    });
+});
+describe("ura service install (unsupported platform)", () => {
+    let originalPlatform;
+    beforeEach(() => {
+        originalPlatform = Object.getOwnPropertyDescriptor(process, "platform");
+        Object.defineProperty(process, "platform", { value: "win32" });
+    });
+    afterEach(() => {
+        Object.defineProperty(process, "platform", originalPlatform);
+    });
+    it("fails with a clear message", async () => {
+        await expect(serviceCommand.parseAsync(["install"], { from: "user" })).rejects.toThrow(/unsupported platform/i);
+    });
+});
+describe("ura service uninstall (linux)", () => {
+    let tmp;
+    let originalPlatform;
+    beforeEach(() => {
+        tmp = mkdtempSync(join(tmpdir(), "ura-service-"));
+        fakeHome = tmp;
+        mkdirSync(join(tmp, ".config", "systemd", "user"), { recursive: true });
+        originalPlatform = Object.getOwnPropertyDescriptor(process, "platform");
+        Object.defineProperty(process, "platform", { value: "linux" });
+        execFileMock.mockClear();
+    });
+    afterEach(() => {
+        Object.defineProperty(process, "platform", originalPlatform);
+        rmSync(tmp, { recursive: true, force: true });
+    });
+    it("disables and deletes the unit when present", async () => {
+        const unit = join(tmp, ".config", "systemd", "user", "urateam.service");
+        writeFileSync(unit, "[Unit]\n");
+        await serviceCommand.parseAsync(["uninstall"], { from: "user" });
+        expect(existsSync(unit)).toBe(false);
+        expect(execFileMock.mock.calls.some(([cmd, args]) => cmd === "systemctl" &&
+            args.includes("disable") &&
+            args.includes("urateam.service"))).toBe(true);
+    });
+    it("is a no-op when the unit is already absent", async () => {
+        const spy = vi.spyOn(console, "log").mockImplementation(() => { });
+        await serviceCommand.parseAsync(["uninstall"], { from: "user" });
+        expect(spy.mock.calls.flat().join("\n")).toMatch(/not installed/i);
+        expect(execFileMock).not.toHaveBeenCalled();
+        spy.mockRestore();
+    });
+    it("still deletes the unit when systemctl disable fails (best-effort stop)", async () => {
+        const unit = join(tmp, ".config", "systemd", "user", "urateam.service");
+        writeFileSync(unit, "[Unit]\n");
+        execFileMock.mockImplementationOnce(async () => {
+            throw new Error("Failed to disable urateam.service: not loaded");
+        });
+        await serviceCommand.parseAsync(["uninstall"], { from: "user" });
+        expect(existsSync(unit)).toBe(false);
+    });
+});
+describe("ura service uninstall (darwin)", () => {
+    let tmp;
+    let originalPlatform;
+    beforeEach(() => {
+        tmp = mkdtempSync(join(tmpdir(), "ura-service-"));
+        fakeHome = tmp;
+        mkdirSync(join(tmp, "Library", "LaunchAgents"), { recursive: true });
+        originalPlatform = Object.getOwnPropertyDescriptor(process, "platform");
+        Object.defineProperty(process, "platform", { value: "darwin" });
+        execFileMock.mockClear();
+    });
+    afterEach(() => {
+        Object.defineProperty(process, "platform", originalPlatform);
+        rmSync(tmp, { recursive: true, force: true });
+    });
+    it("unloads and deletes the plist when present", async () => {
+        const plist = join(tmp, "Library", "LaunchAgents", "com.urateam.daemon.plist");
+        writeFileSync(plist, "<!-- existing -->");
+        await serviceCommand.parseAsync(["uninstall"], { from: "user" });
+        expect(existsSync(plist)).toBe(false);
+        expect(execFileMock.mock.calls.some(([cmd, args]) => cmd === "launchctl" && args.includes("unload"))).toBe(true);
+    });
+    it("is a no-op when the plist is already absent", async () => {
+        const spy = vi.spyOn(console, "log").mockImplementation(() => { });
+        await serviceCommand.parseAsync(["uninstall"], { from: "user" });
+        expect(spy.mock.calls.flat().join("\n")).toMatch(/not installed/i);
+        expect(execFileMock).not.toHaveBeenCalled();
+        spy.mockRestore();
+    });
+});
+//# sourceMappingURL=service.test.js.map

package/dist/__tests__/service.test.js.map

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

package/dist/commands/service.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `ura service install` / `ura service uninstall`
+ *
+ * Generates a platform-appropriate service unit (launchd plist on macOS,
+ * systemd-user unit on Linux) so the user-level daemon auto-starts on login.
+ * Mirrors what `deploy/USER_LEVEL_INSTALL.md` previously documented as
+ * copy-paste blocks. Idempotent: refuses to overwrite an existing unit
+ * (operator must uninstall first). `--dry-run` prints the unit content
+ * without touching the filesystem.
+ */
+import { Command } from "commander";
+export declare const serviceCommand: Command;
+//# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/commands/service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwGpC,eAAO,MAAM,cAAc,SAE1B,CAAC"}

package/dist/commands/service.js

@@ -0,0 +1,164 @@
+/**
+ * `ura service install` / `ura service uninstall`
+ *
+ * Generates a platform-appropriate service unit (launchd plist on macOS,
+ * systemd-user unit on Linux) so the user-level daemon auto-starts on login.
+ * Mirrors what `deploy/USER_LEVEL_INSTALL.md` previously documented as
+ * copy-paste blocks. Idempotent: refuses to overwrite an existing unit
+ * (operator must uninstall first). `--dry-run` prints the unit content
+ * without touching the filesystem.
+ */
+import { Command } from "commander";
+import { execFile } from "node:child_process";
+import { existsSync, mkdirSync, rmSync, writeFileSync, } from "node:fs";
+import { homedir, userInfo } from "node:os";
+import { dirname, join } from "node:path";
+import { promisify } from "node:util";
+import { renderLaunchdPlist, renderSystemdUserUnit, SERVICE_LABEL, SYSTEMD_UNIT_BASENAME, } from "../lib/service-unit.js";
+import { createDb, logAuditEvent, serviceInstalledEvent, serviceUninstalledEvent, } from "@urateam/core";
+import { resolveUserLevelHome, userLevelDataDir, } from "../lib/user-level-config.js";
+const execFileP = promisify(execFile);
+function detectPlatform() {
+    if (process.platform === "darwin")
+        return "darwin";
+    if (process.platform === "linux")
+        return "linux";
+    throw new Error(`ura service: unsupported platform '${process.platform}'. ` +
+        `Only macOS (launchd) and Linux (systemd-user) are supported. ` +
+        `For other platforms, see the manual service-setup snippets in ` +
+        `deploy/USER_LEVEL_INSTALL.md.`);
+}
+function unitPath(platform) {
+    if (platform === "darwin") {
+        return join(homedir(), "Library", "LaunchAgents", `${SERVICE_LABEL}.plist`);
+    }
+    return join(homedir(), ".config", "systemd", "user", SYSTEMD_UNIT_BASENAME);
+}
+function buildInput() {
+    // Resolve the binary the operator invoked us as — that's what the service
+    // unit should re-launch. `process.argv[1]` is the `ura` script (commander's
+    // entry point); it's already absolute when invoked via the npm-installed
+    // shim. Fall back to the common npm-global location if anything looks off.
+    let binaryPath = process.argv[1] ?? "/usr/local/bin/ura";
+    if (!binaryPath.startsWith("/"))
+        binaryPath = "/usr/local/bin/ura";
+    const home = resolveUserLevelHome();
+    return {
+        binaryPath,
+        urateamHome: home,
+        envFilePath: join(home, ".env"),
+        stdoutPath: join(userLevelDataDir(), "daemon.log"),
+        stderrPath: join(userLevelDataDir(), "daemon.err.log"),
+    };
+}
+async function tryEmitAuditEvent(args) {
+    // Opportunistic: only writes when the daemon DB already exists. CLI commands
+    // can run before the daemon has ever started, so the DB may not be there
+    // yet. Never throws — audit failure must not break the install.
+    try {
+        const dbPath = join(userLevelDataDir(), "urateam.db");
+        if (!existsSync(dbPath))
+            return;
+        const db = await createDb({ connectionString: dbPath });
+        const actor = `cli:${userInfo().username ?? "unknown"}`;
+        const builder = args.eventType === "installed"
+            ? serviceInstalledEvent
+            : serviceUninstalledEvent;
+        const evt = builder({
+            platform: args.platform,
+            unitPath: args.unitPath,
+            actor,
+        });
+        // License-gated path — `logAuditEvent` is a no-op when `audit-log` is
+        // unlicensed. Service-install events are an Enterprise-tier operational
+        // signal; OSS / Pro deployments simply drop them.
+        await logAuditEvent(db, evt);
+    }
+    catch {
+        // Audit must never crash the install — swallow.
+    }
+}
+export const serviceCommand = new Command("service").description("Manage the urateam launchd/systemd service unit");
+serviceCommand
+    .command("install")
+    .description("Install the platform service unit (launchd on macOS, systemd-user on Linux)")
+    .option("--dry-run", "Print the unit content; do not write or load it")
+    .action(async (opts) => {
+    const platform = detectPlatform();
+    const input = buildInput();
+    const dest = unitPath(platform);
+    const content = platform === "darwin"
+        ? renderLaunchdPlist(input)
+        : renderSystemdUserUnit(input);
+    if (opts.dryRun) {
+        console.log(`# Would write: ${dest}`);
+        console.log(content);
+        return;
+    }
+    if (existsSync(dest)) {
+        console.log(`ura service install: ${dest} already exists. ` +
+            `Run 'ura service uninstall' first if you want to reinstall.`);
+        return;
+    }
+    mkdirSync(dirname(dest), { recursive: true });
+    writeFileSync(dest, content);
+    if (platform === "darwin") {
+        await execFileP("launchctl", ["load", "-w", dest]);
+        await execFileP("launchctl", ["start", SERVICE_LABEL]);
+    }
+    else {
+        await execFileP("systemctl", ["--user", "daemon-reload"]);
+        await execFileP("systemctl", [
+            "--user",
+            "enable",
+            "--now",
+            SYSTEMD_UNIT_BASENAME,
+        ]);
+    }
+    console.log(`ura service install: wrote ${dest} and started the service.`);
+    await tryEmitAuditEvent({
+        eventType: "installed",
+        platform,
+        unitPath: dest,
+    });
+});
+serviceCommand
+    .command("uninstall")
+    .description("Remove the platform service unit and stop the service")
+    .action(async () => {
+    const platform = detectPlatform();
+    const dest = unitPath(platform);
+    if (!existsSync(dest)) {
+        console.log(`ura service uninstall: ${dest} not installed — nothing to remove.`);
+        return;
+    }
+    if (platform === "darwin") {
+        try {
+            await execFileP("launchctl", ["unload", "-w", dest]);
+        }
+        catch {
+            // unit may have been unloaded already — best-effort stop
+        }
+    }
+    else {
+        try {
+            await execFileP("systemctl", [
+                "--user",
+                "disable",
+                "--now",
+                SYSTEMD_UNIT_BASENAME,
+            ]);
+        }
+        catch {
+            // unit may have been disabled already — best-effort stop
+        }
+    }
+    rmSync(dest, { force: true });
+    console.log(`ura service uninstall: removed ${dest}.`);
+    await tryEmitAuditEvent({
+        eventType: "uninstalled",
+        platform,
+        unitPath: dest,
+    });
+});
+//# sourceMappingURL=service.js.map

package/dist/commands/service.js.map

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

package/dist/index.js

@@ -28,6 +28,7 @@ import { stopCommand, haltCommand } from "./commands/control.js";
 import { initCommand } from "./commands/init.js";
 import { repoCommand } from "./commands/repo.js";
 import { uninstallCommand } from "./commands/uninstall.js";
+import { serviceCommand } from "./commands/service.js";
 const program = new Command();
 program
     .name("ura")
@@ -46,5 +47,6 @@ program.addCommand(haltCommand);
 program.addCommand(initCommand);
 program.addCommand(repoCommand);
 program.addCommand(uninstallCommand);
+program.addCommand(serviceCommand);
 program.parse();
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,oCAAoC;AACpC,4EAA4E;AAC5E,2EAA2E;AAC3E,mEAAmE;AACnE,6EAA6E;AAC7E,oEAAoE;AACpE,IAAI,CAAC;IACH,OAAO,CAAC,WAAW,EAAE,CAAC;AACxB,CAAC;AAAC,OAAO,GAAY,EAAE,CAAC;IACtB,MAAM,IAAI,GAAI,GAA6B,EAAE,IAAI,CAAC;IAClD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO,CAAC,IAAI,CACV,qCAAqC,OAAO,CAAC,GAAG,EAAE,KAChD,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CACjD,EAAE,CACH,CAAC;IACJ,CAAC;AACH,CAAC;AAED,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,KAAK,CAAC;KACX,WAAW,CAAC,aAAa,CAAC;KAC1B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;AAEhC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AAC/B,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AAC/B,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AACrD,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;AAErC,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,oCAAoC;AACpC,4EAA4E;AAC5E,2EAA2E;AAC3E,mEAAmE;AACnE,6EAA6E;AAC7E,oEAAoE;AACpE,IAAI,CAAC;IACH,OAAO,CAAC,WAAW,EAAE,CAAC;AACxB,CAAC;AAAC,OAAO,GAAY,EAAE,CAAC;IACtB,MAAM,IAAI,GAAI,GAA6B,EAAE,IAAI,CAAC;IAClD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO,CAAC,IAAI,CACV,qCAAqC,OAAO,CAAC,GAAG,EAAE,KAChD,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CACjD,EAAE,CACH,CAAC;IACJ,CAAC;AACH,CAAC;AAED,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,KAAK,CAAC;KACX,WAAW,CAAC,aAAa,CAAC;KAC1B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;AAEhC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AAC/B,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AAC/B,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AACrD,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;AACrC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AAEnC,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/lib/service-unit.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Pure unit-file generators for `ura service install`.
+ *
+ * Both generators are I/O-free string functions so they can be unit-tested
+ * without touching the filesystem and so `--dry-run` can print the would-be
+ * unit content without mutating anything. The shape mirrors what
+ * `deploy/USER_LEVEL_INSTALL.md` previously documented as copy-paste blocks.
+ */
+export interface ServiceUnitInput {
+    /** Absolute path to the `ura` binary (e.g. `/usr/local/bin/ura`). */
+    binaryPath: string;
+    /** Resolved `$URATEAM_HOME` — propagated into the service environment. */
+    urateamHome: string;
+    /** Path to the `.env` file the daemon should read at startup. */
+    envFilePath: string;
+    /** Stdout log path (launchd `StandardOutPath` / systemd `StandardOutput`). */
+    stdoutPath: string;
+    /** Stderr log path (launchd `StandardErrorPath` / systemd `StandardError`). */
+    stderrPath: string;
+}
+export declare function renderLaunchdPlist(opts: ServiceUnitInput): string;
+export declare function renderSystemdUserUnit(opts: ServiceUnitInput): string;
+export declare const SERVICE_LABEL = "com.urateam.daemon";
+export declare const SYSTEMD_UNIT_BASENAME = "urateam.service";
+//# sourceMappingURL=service-unit.d.ts.map

package/dist/lib/service-unit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-unit.d.ts","sourceRoot":"","sources":["../../src/lib/service-unit.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,WAAW,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAgCjE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAqBpE;AAED,eAAO,MAAM,aAAa,uBAAgB,CAAC;AAC3C,eAAO,MAAM,qBAAqB,oBAAoB,CAAC"}

package/dist/lib/service-unit.js

@@ -0,0 +1,67 @@
+/**
+ * Pure unit-file generators for `ura service install`.
+ *
+ * Both generators are I/O-free string functions so they can be unit-tested
+ * without touching the filesystem and so `--dry-run` can print the would-be
+ * unit content without mutating anything. The shape mirrors what
+ * `deploy/USER_LEVEL_INSTALL.md` previously documented as copy-paste blocks.
+ */
+const LAUNCHD_LABEL = "com.urateam.daemon";
+export function renderLaunchdPlist(opts) {
+    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>${LAUNCHD_LABEL}</string>`,
+        `  <key>ProgramArguments</key>`,
+        `  <array>`,
+        `    <string>${opts.binaryPath}</string>`,
+        `    <string>start</string>`,
+        `  </array>`,
+        `  <key>WorkingDirectory</key>`,
+        `  <string>${opts.urateamHome}</string>`,
+        `  <key>EnvironmentVariables</key>`,
+        `  <dict>`,
+        `    <key>URATEAM_HOME</key>`,
+        `    <string>${opts.urateamHome}</string>`,
+        `  </dict>`,
+        `  <key>RunAtLoad</key>`,
+        `  <true/>`,
+        `  <key>KeepAlive</key>`,
+        `  <true/>`,
+        `  <key>StandardOutPath</key>`,
+        `  <string>${opts.stdoutPath}</string>`,
+        `  <key>StandardErrorPath</key>`,
+        `  <string>${opts.stderrPath}</string>`,
+        `</dict>`,
+        `</plist>`,
+        ``,
+    ].join("\n");
+}
+export function renderSystemdUserUnit(opts) {
+    return [
+        `[Unit]`,
+        `Description=urateam user-level daemon`,
+        `After=network.target`,
+        ``,
+        `[Service]`,
+        `Type=simple`,
+        `WorkingDirectory=${opts.urateamHome}`,
+        `EnvironmentFile=${opts.envFilePath}`,
+        `Environment=URATEAM_HOME=${opts.urateamHome}`,
+        `ExecStart=${opts.binaryPath} start`,
+        `StandardOutput=append:${opts.stdoutPath}`,
+        `StandardError=append:${opts.stderrPath}`,
+        `Restart=always`,
+        `RestartSec=5`,
+        ``,
+        `[Install]`,
+        `WantedBy=default.target`,
+        ``,
+    ].join("\n");
+}
+export const SERVICE_LABEL = LAUNCHD_LABEL;
+export const SYSTEMD_UNIT_BASENAME = "urateam.service";
+//# sourceMappingURL=service-unit.js.map

package/dist/lib/service-unit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-unit.js","sourceRoot":"","sources":["../../src/lib/service-unit.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH,MAAM,aAAa,GAAG,oBAAoB,CAAC;AAE3C,MAAM,UAAU,kBAAkB,CAAC,IAAsB;IACvD,OAAO;QACL,wCAAwC;QACxC,wGAAwG;QACxG,uBAAuB;QACvB,QAAQ;QACR,oBAAoB;QACpB,aAAa,aAAa,WAAW;QACrC,+BAA+B;QAC/B,WAAW;QACX,eAAe,IAAI,CAAC,UAAU,WAAW;QACzC,4BAA4B;QAC5B,YAAY;QACZ,+BAA+B;QAC/B,aAAa,IAAI,CAAC,WAAW,WAAW;QACxC,mCAAmC;QACnC,UAAU;QACV,6BAA6B;QAC7B,eAAe,IAAI,CAAC,WAAW,WAAW;QAC1C,WAAW;QACX,wBAAwB;QACxB,WAAW;QACX,wBAAwB;QACxB,WAAW;QACX,8BAA8B;QAC9B,aAAa,IAAI,CAAC,UAAU,WAAW;QACvC,gCAAgC;QAChC,aAAa,IAAI,CAAC,UAAU,WAAW;QACvC,SAAS;QACT,UAAU;QACV,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAsB;IAC1D,OAAO;QACL,QAAQ;QACR,uCAAuC;QACvC,sBAAsB;QACtB,EAAE;QACF,WAAW;QACX,aAAa;QACb,oBAAoB,IAAI,CAAC,WAAW,EAAE;QACtC,mBAAmB,IAAI,CAAC,WAAW,EAAE;QACrC,4BAA4B,IAAI,CAAC,WAAW,EAAE;QAC9C,aAAa,IAAI,CAAC,UAAU,QAAQ;QACpC,yBAAyB,IAAI,CAAC,UAAU,EAAE;QAC1C,wBAAwB,IAAI,CAAC,UAAU,EAAE;QACzC,gBAAgB;QAChB,cAAc;QACd,EAAE;QACF,WAAW;QACX,yBAAyB;QACzB,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;AAC3C,MAAM,CAAC,MAAM,qBAAqB,GAAG,iBAAiB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@urateam/cli",
-  "version": "0.1.40",
+  "version": "0.1.41",
   "license": "BUSL-1.1",
   "type": "module",
   "main": "dist/index.js",
@@ -23,8 +23,8 @@
     "commander": "^13.1.0",
     "postgres": "^3.4.0",
     "zod": "^4.3.6",
-    "@urateam/core": "0.1.38",
-    "@urateam/dashboard": "0.1.38"
+    "@urateam/core": "0.1.39",
+    "@urateam/dashboard": "0.1.39"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.0",