@opvs-ai/cli 0.5.5 → 0.6.0

package/dist/commands/install.d.ts

@@ -0,0 +1,19 @@
+/**
+ * ``opvs mail install-*`` and ``opvs mail daemon`` subcommands.
+ *
+ * Phase E + F of the OPVS Mail rollout — turns the CLI into a one-command
+ * onramp for Claude Code, Codex, Antigravity, and headless boxes:
+ *
+ *   opvs mail install-slash-commands             → drops slash commands at
+ *                                                   ~/.claude/commands/
+ *   opvs mail install-hooks claude-code          → writes Stop hook to
+ *                                                   ~/.claude/settings.json
+ *   opvs mail install-hooks codex|antigravity    → writes MCP server entry
+ *                                                   to ~/.codex/config.json
+ *                                                   or ~/.antigravity/...
+ *   opvs mail daemon install/start/stop/status   → systemd-user (Linux) or
+ *                                                   launchd (macOS) wrapper
+ *                                                   around ``mail watch``
+ */
+import { Command } from "commander";
+export declare function registerInstallCommands(mail: Command): void;

package/dist/commands/install.js

@@ -0,0 +1,253 @@
+/**
+ * ``opvs mail install-*`` and ``opvs mail daemon`` subcommands.
+ *
+ * Phase E + F of the OPVS Mail rollout — turns the CLI into a one-command
+ * onramp for Claude Code, Codex, Antigravity, and headless boxes:
+ *
+ *   opvs mail install-slash-commands             → drops slash commands at
+ *                                                   ~/.claude/commands/
+ *   opvs mail install-hooks claude-code          → writes Stop hook to
+ *                                                   ~/.claude/settings.json
+ *   opvs mail install-hooks codex|antigravity    → writes MCP server entry
+ *                                                   to ~/.codex/config.json
+ *                                                   or ~/.antigravity/...
+ *   opvs mail daemon install/start/stop/status   → systemd-user (Linux) or
+ *                                                   launchd (macOS) wrapper
+ *                                                   around ``mail watch``
+ */
+import { copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync, } from "node:fs";
+import { homedir, platform } from "node:os";
+import { join, dirname } from "node:path";
+import { spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+// templates/ ships at ../../templates relative to compiled commands/ dir.
+function getTemplatesRoot() {
+    // Resolve relative to this module; works for both src/ (dev) and dist/ (prod).
+    const here = dirname(fileURLToPath(import.meta.url));
+    // Compiled: dist/commands/install.js → ../../templates
+    // Dev:      src/commands/install.ts → ../../templates
+    return join(here, "..", "..", "templates");
+}
+function readTemplate(rel) {
+    const p = join(getTemplatesRoot(), rel);
+    return readFileSync(p, "utf-8");
+}
+// ── slash commands ───────────────────────────────────────────────────────
+const SLASH_COMMANDS = ["mail.md", "inbox.md", "thread.md", "reply.md", "awaiting.md", "ack.md"];
+function installSlashCommands(target) {
+    const written = [];
+    const skipped = [];
+    if (!existsSync(target))
+        mkdirSync(target, { recursive: true });
+    const src = join(getTemplatesRoot(), "slash-commands");
+    for (const name of SLASH_COMMANDS) {
+        const from = join(src, name);
+        const to = join(target, name);
+        if (!existsSync(from))
+            continue;
+        if (existsSync(to)) {
+            skipped.push(to);
+            continue;
+        }
+        copyFileSync(from, to);
+        written.push(to);
+    }
+    return { written, skipped };
+}
+function installClaudeCodeHooks(target) {
+    const tmpl = JSON.parse(readTemplate("hooks/claude-code-stop.json"));
+    const wantedStop = tmpl.hooks?.Stop ?? [];
+    let existing = {};
+    const settingsExisted = existsSync(target);
+    if (settingsExisted) {
+        try {
+            existing = JSON.parse(readFileSync(target, "utf-8"));
+        }
+        catch {
+            existing = {};
+        }
+    }
+    existing.hooks = existing.hooks ?? {};
+    existing.hooks.Stop = existing.hooks.Stop ?? [];
+    // Merge — append our entries, dedupe by command string.
+    const haveCommands = new Set(existing.hooks.Stop.flatMap((entry) => entry.hooks.map((h) => h.command)));
+    let merged = false;
+    for (const entry of wantedStop) {
+        const fresh = entry.hooks.filter((h) => !haveCommands.has(h.command));
+        if (fresh.length === 0)
+            continue;
+        existing.hooks.Stop.push({ matcher: entry.matcher, hooks: fresh });
+        merged = true;
+    }
+    if (merged || !settingsExisted) {
+        if (!existsSync(dirname(target)))
+            mkdirSync(dirname(target), { recursive: true });
+        writeFileSync(target, JSON.stringify(existing, null, 2) + "\n");
+    }
+    return { merged, existing: settingsExisted };
+}
+function installMCPEntry(target, key = "opvs") {
+    let cfg = {};
+    const targetExisted = existsSync(target);
+    if (targetExisted) {
+        try {
+            cfg = JSON.parse(readFileSync(target, "utf-8"));
+        }
+        catch {
+            cfg = {};
+        }
+    }
+    cfg.mcpServers = cfg.mcpServers ?? {};
+    if (cfg.mcpServers[key])
+        return { merged: false };
+    cfg.mcpServers[key] = {
+        command: "npx",
+        args: ["-y", "@opvs-ai/mcp"],
+    };
+    if (!existsSync(dirname(target)))
+        mkdirSync(dirname(target), { recursive: true });
+    writeFileSync(target, JSON.stringify(cfg, null, 2) + "\n");
+    return { merged: true };
+}
+// ── daemon ──────────────────────────────────────────────────────────────
+function getOpvsBin() {
+    // Resolve the real ``opvs`` binary path so the unit/plist is portable
+    // across user installs.
+    const which = spawnSync("which", ["opvs"], { encoding: "utf-8" });
+    if (which.status === 0 && which.stdout.trim())
+        return which.stdout.trim();
+    return "/usr/local/bin/opvs";
+}
+function renderTemplate(rel, vars) {
+    let out = readTemplate(rel);
+    for (const [k, v] of Object.entries(vars)) {
+        out = out.split(`__${k}__`).join(v);
+    }
+    return out;
+}
+function daemonInstall() {
+    const home = homedir();
+    const opvs = getOpvsBin();
+    if (platform() === "linux") {
+        const dir = join(home, ".config", "systemd", "user");
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        const target = join(dir, "opvs-mail.service");
+        writeFileSync(target, renderTemplate("systemd/opvs-mail.service", { OPVS_BIN: opvs, HOME: home }));
+        return target;
+    }
+    if (platform() === "darwin") {
+        const dir = join(home, "Library", "LaunchAgents");
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        const target = join(dir, "com.opvs.mail.plist");
+        writeFileSync(target, renderTemplate("launchd/com.opvs.mail.plist", { OPVS_BIN: opvs, HOME: home }));
+        return target;
+    }
+    throw new Error(`Unsupported platform: ${platform()} (only linux + darwin supported)`);
+}
+function daemonControl(verb) {
+    if (platform() === "linux") {
+        const cmd = verb === "uninstall"
+            ? ["disable", "--now", "opvs-mail.service"]
+            : verb === "status"
+                ? ["status", "--no-pager", "opvs-mail.service"]
+                : [verb, "opvs-mail.service"];
+        const r = spawnSync("systemctl", ["--user", ...cmd], { encoding: "utf-8" });
+        return { ok: r.status === 0, output: (r.stdout ?? "") + (r.stderr ?? "") };
+    }
+    if (platform() === "darwin") {
+        const target = join(homedir(), "Library", "LaunchAgents", "com.opvs.mail.plist");
+        if (verb === "start") {
+            const r = spawnSync("launchctl", ["load", target], { encoding: "utf-8" });
+            return { ok: r.status === 0, output: r.stderr ?? "" };
+        }
+        if (verb === "stop" || verb === "uninstall") {
+            const r = spawnSync("launchctl", ["unload", target], { encoding: "utf-8" });
+            return { ok: r.status === 0, output: r.stderr ?? "" };
+        }
+        if (verb === "status") {
+            const r = spawnSync("launchctl", ["list", "com.opvs.mail"], { encoding: "utf-8" });
+            return { ok: r.status === 0, output: (r.stdout ?? "") + (r.stderr ?? "") };
+        }
+    }
+    return { ok: false, output: `Unsupported platform: ${platform()}` };
+}
+// ── register ────────────────────────────────────────────────────────────
+export function registerInstallCommands(mail) {
+    // ``opvs mail install-slash-commands [--target <dir>]``
+    mail
+        .command("install-slash-commands")
+        .description("Drop slash commands (mail / inbox / thread / reply / awaiting / ack) into a target dir")
+        .option("--target <dir>", "Where to write the .md files", join(homedir(), ".claude", "commands"))
+        .action((opts) => {
+        const result = installSlashCommands(opts.target);
+        console.log(JSON.stringify({
+            target: opts.target,
+            written: result.written,
+            skipped_existing: result.skipped,
+        }, null, 2));
+    });
+    // ``opvs mail install-hooks claude-code|codex|antigravity``
+    mail
+        .command("install-hooks <client>")
+        .description("Auto-config hooks (claude-code) or MCP entry (codex, antigravity)")
+        .option("--target <path>", "Override default settings file path")
+        .action((client, opts) => {
+        const home = homedir();
+        let target;
+        let result;
+        switch (client) {
+            case "claude-code": {
+                target = opts.target ?? join(home, ".claude", "settings.json");
+                const { merged, existing } = installClaudeCodeHooks(target);
+                result = { client, target, merged, settings_existed: existing };
+                break;
+            }
+            case "codex": {
+                target = opts.target ?? join(home, ".codex", "config.json");
+                const { merged } = installMCPEntry(target);
+                result = { client, target, merged };
+                break;
+            }
+            case "antigravity": {
+                target = opts.target ?? join(home, ".antigravity", "mcp.json");
+                const { merged } = installMCPEntry(target);
+                result = { client, target, merged };
+                break;
+            }
+            default:
+                console.error(`Unsupported client: ${client}. Supported: claude-code, codex, antigravity`);
+                process.exit(1);
+                return;
+        }
+        console.log(JSON.stringify(result, null, 2));
+    });
+    // ``opvs mail daemon <verb>``
+    const daemon = mail.command("daemon").description("systemd-user (Linux) / launchd (macOS) wrapper around ``mail watch``");
+    daemon
+        .command("install")
+        .description("Write the unit/plist file to the user's autostart directory")
+        .action(() => {
+        try {
+            const target = daemonInstall();
+            console.log(JSON.stringify({ installed: target }, null, 2));
+        }
+        catch (e) {
+            console.error(`Error: ${e.message}`);
+            process.exit(1);
+        }
+    });
+    for (const verb of ["start", "stop", "status", "uninstall"]) {
+        daemon
+            .command(verb)
+            .description(`${verb[0].toUpperCase() + verb.slice(1)} the OPVS mail daemon`)
+            .action(() => {
+            const result = daemonControl(verb);
+            console.log(result.output || (result.ok ? "ok" : "failed"));
+            if (!result.ok && verb !== "status")
+                process.exit(1);
+        });
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/commands/install.js.map

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

package/dist/commands/mail.d.ts

@@ -0,0 +1,18 @@
+/**
+ * opvs mail — OPVS Protocol messaging commands.
+ *
+ * Two layers:
+ *   1. Server-facing commands (send, reply, resolve, claim, pair, …) —
+ *      hit the gateway and mirror the result to the local store.
+ *   2. Local-mirror commands (sync, watch, thread, list, search, unread,
+ *      status, ack, working, decline, flag, draft, awaiting, tickle,
+ *      sub, compact, log) — read/write the IMAP-style store at
+ *      ``~/.opvs/mail/`` shipped by ``@opvs-ai/core``'s mailstore.
+ *
+ * Per the IMAP-mail plan (`/root/.claude/plans/read-root-opvs-...`):
+ *   - No auto-seen — recipient must explicitly ``mail ack``.
+ *   - SLA fields are advisory, never server-enforced.
+ *   - Plus-addressing (``+suffix``) is first-class.
+ */
+import { Command } from "commander";
+export declare function registerMailCommands(program: Command): void;