kandev 0.65.0 → 0.69.0

package/dist/service/args.js

@@ -1,131 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseServiceArgs = parseServiceArgs;
-const args_1 = require("../args");
-const VALID_ACTIONS = new Set([
-    "install",
-    "uninstall",
-    "start",
-    "stop",
-    "restart",
-    "status",
-    "logs",
-    "config",
-    "self-update",
-]);
-function parseServiceArgs(argv) {
-    if (argv.length === 0 || argv[0] === "--help" || argv[0] === "-h") {
-        return { action: "install", showHelp: true };
-    }
-    const head = argv[0];
-    if (!VALID_ACTIONS.has(head)) {
-        throw new args_1.ParseError(`unknown service action "${head}". expected one of: ${[...VALID_ACTIONS].join(", ")}`);
-    }
-    const out = { action: head };
-    for (let i = 1; i < argv.length; i += 1) {
-        const arg = argv[i];
-        if (arg === "--help" || arg === "-h") {
-            out.showHelp = true;
-            continue;
-        }
-        if (arg === "--system") {
-            out.system = true;
-            continue;
-        }
-        if (arg === "--no-boot-start") {
-            out.noBootStart = true;
-            continue;
-        }
-        if (arg === "-f" || arg === "--follow") {
-            out.follow = true;
-            continue;
-        }
-        if (arg === "--dry-run") {
-            out.dryRun = true;
-            continue;
-        }
-        if (arg === "--intent") {
-            out.intent = takeValue(argv, i, "--intent");
-            i += 1;
-            continue;
-        }
-        if (arg.startsWith("--intent=")) {
-            const value = arg.slice("--intent=".length);
-            if (value.length === 0)
-                throw new args_1.ParseError("--intent requires a value");
-            out.intent = value;
-            continue;
-        }
-        if (arg === "--port") {
-            out.port = parsePort(takeValue(argv, i, "--port"), "--port");
-            i += 1;
-            continue;
-        }
-        if (arg.startsWith("--port=")) {
-            out.port = parsePort(arg.slice("--port=".length), "--port");
-            continue;
-        }
-        if (arg === "--home-dir") {
-            out.homeDir = takeValue(argv, i, "--home-dir");
-            i += 1;
-            continue;
-        }
-        if (arg.startsWith("--home-dir=")) {
-            const value = arg.slice("--home-dir=".length);
-            if (value.length === 0)
-                throw new args_1.ParseError("--home-dir requires a value");
-            out.homeDir = value;
-            continue;
-        }
-        throw new args_1.ParseError(`unknown flag "${arg}" for kandev service ${head}`);
-    }
-    validateActionFlags(out);
-    return out;
-}
-/**
- * Reject flag combinations that silently no-op so the user gets immediate
- * feedback instead of a successful command that ignored their input. The
- * matrix is small enough that explicit checks beat a generic flag-applicability
- * table.
- */
-function validateActionFlags(args) {
-    if (args.follow && args.action !== "logs") {
-        throw new args_1.ParseError(`--follow only applies to 'kandev service logs', not '${args.action}'`);
-    }
-    if (args.dryRun && args.action !== "self-update") {
-        throw new args_1.ParseError(`--dry-run only applies to 'kandev service self-update', not '${args.action}'`);
-    }
-    if (args.intent && args.action !== "self-update") {
-        throw new args_1.ParseError(`--intent only applies to 'kandev service self-update', not '${args.action}'`);
-    }
-    if (args.action === "self-update" && !args.showHelp && !args.intent) {
-        throw new args_1.ParseError("kandev service self-update requires --intent <path>");
-    }
-    const installOnly = ["port", "homeDir", "noBootStart"];
-    if (args.action !== "install") {
-        for (const flag of installOnly) {
-            if (args[flag] !== undefined) {
-                const display = flag === "homeDir"
-                    ? "--home-dir"
-                    : flag === "noBootStart"
-                        ? "--no-boot-start"
-                        : `--${flag}`;
-                throw new args_1.ParseError(`${display} only applies to 'kandev service install', not '${args.action}'`);
-            }
-        }
-    }
-}
-function takeValue(argv, i, flag) {
-    const v = argv[i + 1];
-    if (v === undefined || v.startsWith("-")) {
-        throw new args_1.ParseError(`${flag} requires a value`);
-    }
-    return v;
-}
-function parsePort(raw, flag) {
-    const n = Number(raw);
-    if (raw === "" || !Number.isInteger(n) || n < 1 || n > 65535) {
-        throw new args_1.ParseError(`${flag} value must be an integer between 1 and 65535, got "${raw}"`);
-    }
-    return n;
-}

package/dist/service/config.js

@@ -1,111 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.printServiceConfig = printServiceConfig;
-const node_child_process_1 = require("node:child_process");
-const node_fs_1 = __importDefault(require("node:fs"));
-const node_os_1 = __importDefault(require("node:os"));
-const constants_1 = require("../constants");
-const paths_1 = require("./paths");
-const templates_1 = require("./templates");
-/**
- * Print a human-readable summary of what kandev knows about the local
- * service install: paths, env vars, whether a unit exists, whether it's
- * active. Used for "why isn't it running?" diagnosis without needing to
- * remember the right systemctl / launchctl invocation.
- */
-function printServiceConfig(args) {
-    const isSystem = !!args.system;
-    const launcher = (0, paths_1.captureLauncher)();
-    const homeDir = (0, paths_1.resolveHomeDir)(args.homeDir, isSystem);
-    const logDir = (0, paths_1.resolveLogDir)(homeDir);
-    console.log("=== kandev service config ===");
-    console.log(`platform:        ${process.platform}`);
-    console.log(`mode:            ${isSystem ? "system" : "user"}`);
-    console.log(`launcher kind:   ${launcher.kind}`);
-    console.log(`node path:       ${launcher.nodePath}`);
-    console.log(`cli entry:       ${launcher.cliEntry}`);
-    if (launcher.bundleDir)
-        console.log(`bundle dir:      ${launcher.bundleDir}`);
-    if (launcher.version)
-        console.log(`version:         ${launcher.version}`);
-    console.log("");
-    console.log(`KANDEV_HOME_DIR: ${homeDir}`);
-    console.log(`log dir:         ${logDir}`);
-    console.log(`port:            ${args.port ?? `(default ${constants_1.DEFAULT_BACKEND_PORT})`}`);
-    if (isSystem) {
-        console.log(`run as user:     ${(0, paths_1.resolveServiceUser)(true)}`);
-    }
-    console.log("");
-    if (process.platform === "linux") {
-        printLinuxUnit(isSystem);
-    }
-    else if (process.platform === "darwin") {
-        printMacosUnit(isSystem);
-    }
-    else {
-        console.log(`unit:            (unsupported on ${process.platform})`);
-    }
-}
-function printLinuxUnit(isSystem) {
-    const unitPath = isSystem ? (0, paths_1.linuxSystemUnitPath)() : (0, paths_1.linuxUserUnitPath)();
-    console.log(`unit path:       ${unitPath}`);
-    const present = node_fs_1.default.existsSync(unitPath);
-    console.log(`installed:       ${present ? "yes" : "no"}`);
-    if (present) {
-        const content = safeRead(unitPath);
-        console.log(`managed by us:   ${content && (0, templates_1.looksLikeManagedUnit)(content) ? "yes" : "no"}`);
-    }
-    const active = systemctlIsActive(isSystem);
-    if (active !== null)
-        console.log(`active state:    ${active}`);
-}
-function printMacosUnit(isSystem) {
-    const plistPath = isSystem ? (0, paths_1.macosSystemPlistPath)() : (0, paths_1.macosUserPlistPath)();
-    console.log(`plist path:      ${plistPath}`);
-    const present = node_fs_1.default.existsSync(plistPath);
-    console.log(`installed:       ${present ? "yes" : "no"}`);
-    if (present) {
-        const content = safeRead(plistPath);
-        console.log(`managed by us:   ${content && (0, templates_1.looksLikeManagedUnit)(content) ? "yes" : "no"}`);
-    }
-    console.log(`loaded:          ${launchctlIsLoaded(isSystem) ? "yes" : "no"}`);
-}
-function safeRead(p) {
-    try {
-        return node_fs_1.default.readFileSync(p, "utf8");
-    }
-    catch {
-        return null;
-    }
-}
-function systemctlIsActive(isSystem) {
-    try {
-        const args = isSystem ? ["is-active", paths_1.SERVICE_NAME] : ["--user", "is-active", paths_1.SERVICE_NAME];
-        const out = (0, node_child_process_1.execFileSync)("systemctl", args, { encoding: "utf8" });
-        return out.trim();
-    }
-    catch (err) {
-        // is-active returns nonzero for inactive/failed/unknown — read the output anyway.
-        // execFileSync attaches stdout to the thrown error; guard with a type check
-        // instead of an unsafe cast so this keeps working if the error shape changes.
-        if (err !== null && typeof err === "object" && "stdout" in err) {
-            const { stdout } = err;
-            if (stdout)
-                return String(stdout).trim();
-        }
-        return null;
-    }
-}
-function launchctlIsLoaded(isSystem) {
-    try {
-        const domain = isSystem ? "system" : `gui/${node_os_1.default.userInfo().uid}`;
-        (0, node_child_process_1.execFileSync)("launchctl", ["print", `${domain}/${paths_1.LAUNCHD_LABEL}`], { stdio: "ignore" });
-        return true;
-    }
-    catch {
-        return false;
-    }
-}

package/dist/service/health_check.js

@@ -1,84 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.waitForServiceHealth = waitForServiceHealth;
-exports.dumpJournalctlLogs = dumpJournalctlLogs;
-exports.dumpLaunchdLogs = dumpLaunchdLogs;
-const node_child_process_1 = require("node:child_process");
-const node_fs_1 = __importDefault(require("node:fs"));
-const node_path_1 = __importDefault(require("node:path"));
-const constants_1 = require("../constants");
-const health_1 = require("../health");
-const DEFAULT_TIMEOUT_MS = 30000;
-const POLL_INTERVAL_MS = 500;
-// Per-request timeout. Without this, undici's default headersTimeout (5min)
-// can stall a single fetch — e.g. TCP accepted but the backend hangs before
-// writing response headers — and silently overrun the outer deadline.
-const REQUEST_TIMEOUT_MS = 2000;
-/**
- * Poll the kandev /health endpoint to confirm the freshly-installed service
- * actually came up. On success, the user gets immediate confirmation; on
- * failure, we dump the tail of the service logs so the diagnosis isn't a
- * scavenger hunt across `journalctl` / `tail`.
- *
- * Timeout is fixed at 30s — long enough to absorb a slow first launch
- * (binary unpacking, sqlite migration), short enough to fail fast when the
- * unit is genuinely broken.
- */
-async function waitForServiceHealth(port, dumpLogs) {
-    const url = `http://localhost:${port ?? constants_1.DEFAULT_BACKEND_PORT}/health`;
-    const timeoutMs = (0, health_1.resolveHealthTimeoutMs)(DEFAULT_TIMEOUT_MS);
-    const deadline = Date.now() + timeoutMs;
-    process.stderr.write(`[kandev] waiting for service to be healthy at ${url}\n`);
-    while (Date.now() < deadline) {
-        try {
-            const res = await fetch(url, { signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS) });
-            if (res.ok) {
-                process.stderr.write(`[kandev] service is healthy\n`);
-                return;
-            }
-        }
-        catch {
-            // not up yet (or per-request timeout fired); keep polling
-        }
-        await (0, health_1.delay)(POLL_INTERVAL_MS);
-    }
-    process.stderr.write(`[kandev] service did not become healthy within ${timeoutMs}ms\n`);
-    process.stderr.write(`[kandev] dumping recent service logs:\n`);
-    dumpLogs();
-    throw new Error("kandev service was installed but the /health endpoint never responded. " +
-        "Inspect the logs above and re-run 'kandev service install' once fixed. " +
-        "If the service needs more time to come up, set KANDEV_HEALTH_TIMEOUT_MS=120000.");
-}
-/** Dump the last N lines of a systemd unit's logs via journalctl. */
-function dumpJournalctlLogs(opts) {
-    const args = opts.isSystem
-        ? ["-u", opts.unit, "-n", String(opts.lines), "--no-pager"]
-        : ["--user-unit", opts.unit, "-n", String(opts.lines), "--no-pager"];
-    try {
-        (0, node_child_process_1.spawnSync)("journalctl", args, { stdio: "inherit" });
-    }
-    catch (err) {
-        // journalctl may be unavailable in containerized or stripped-down setups.
-        // We're already in a failure path; don't compound it with a thrown error.
-        process.stderr.write(`[kandev]   (could not run journalctl: ${err instanceof Error ? err.message : String(err)})\n`);
-    }
-}
-/** Dump the last N lines of launchd-managed log files via `tail`. */
-function dumpLaunchdLogs(opts) {
-    const candidates = ["service.err", "service.out"]
-        .map((name) => node_path_1.default.join(opts.logDir, name))
-        .filter((p) => node_fs_1.default.existsSync(p));
-    if (candidates.length === 0) {
-        process.stderr.write(`[kandev]   (no logs found in ${opts.logDir})\n`);
-        return;
-    }
-    try {
-        (0, node_child_process_1.spawnSync)("tail", ["-n", String(opts.lines), ...candidates], { stdio: "inherit" });
-    }
-    catch (err) {
-        process.stderr.write(`[kandev]   (could not run tail: ${err instanceof Error ? err.message : String(err)})\n`);
-    }
-}

package/dist/service/index.js

@@ -1,70 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.printServiceHelp = printServiceHelp;
-exports.runServiceCommand = runServiceCommand;
-const args_1 = require("./args");
-const config_1 = require("./config");
-const linux_1 = require("./linux");
-const macos_1 = require("./macos");
-const self_update_1 = require("./self_update");
-function printServiceHelp() {
-    console.log(`kandev service — install kandev as an OS-managed service
-
-Usage:
-  kandev service install [--system] [--port <port>] [--home-dir <path>] [--no-boot-start]
-  kandev service uninstall [--system]
-  kandev service start|stop|restart|status [--system]
-  kandev service logs [-f] [--system]
-  kandev service config [--system]
-
-Modes:
-  default          User-level service.
-                     Linux:  ~/.config/systemd/user/kandev.service
-                     macOS:  ~/Library/LaunchAgents/com.kdlbs.kandev.plist
-                   Runs as the current user. On Linux, only starts at boot
-                   if 'loginctl enable-linger <user>' has been run.
-  --system         System-level service. Requires sudo.
-                     Linux:  /etc/systemd/system/kandev.service
-                     macOS:  /Library/LaunchDaemons/com.kdlbs.kandev.plist
-                   Starts at boot regardless of login state.
-
-Flags:
-  --port <port>        Backend port baked into the unit (KANDEV_SERVER_PORT).
-  --home-dir <path>    KANDEV_HOME_DIR baked into the unit.
-                       Defaults: ~/.kandev (user), /var/lib/kandev (system).
-  --no-boot-start      (Linux user mode) Skip the enable-linger hint.
-  -f, --follow         (logs) Stream logs instead of dumping the tail.
-
-Updates:
-  After 'npm update -g kandev' or 'brew upgrade kandev', re-run
-  'kandev service install' to refresh paths in the unit file.
-`);
-}
-async function runServiceCommand(argv) {
-    const args = (0, args_1.parseServiceArgs)(argv);
-    if (args.showHelp) {
-        printServiceHelp();
-        return;
-    }
-    // 'config' is read-only and identical across platforms — handle here so we
-    // don't need to duplicate it in both linux.ts and macos.ts.
-    if (args.action === "config") {
-        (0, config_1.printServiceConfig)(args);
-        return;
-    }
-    // Hidden helper entrypoint used by the backend self-update endpoint. It is
-    // intentionally absent from help output.
-    if (args.action === "self-update") {
-        (0, self_update_1.runSelfUpdateCommand)(args);
-        return;
-    }
-    switch (process.platform) {
-        case "linux":
-            return (0, linux_1.runLinuxService)(args);
-        case "darwin":
-            return (0, macos_1.runMacosService)(args);
-        default:
-            throw new Error(`kandev service is not yet supported on ${process.platform}. ` +
-                `Currently supported: linux (systemd), darwin (launchd).`);
-    }
-}

package/dist/service/install_helpers.js

@@ -1,51 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.commandExists = commandExists;
-exports.writeUnitFile = writeUnitFile;
-const node_child_process_1 = require("node:child_process");
-const node_fs_1 = __importDefault(require("node:fs"));
-const templates_1 = require("./templates");
-/** Cheap PATH lookup; returns true if `cmd` resolves via `which`. */
-function commandExists(cmd) {
-    const res = (0, node_child_process_1.spawnSync)("which", [cmd], { stdio: "ignore" });
-    return res.status === 0;
-}
-/**
- * Write `content` to `targetPath` with idempotent + foreign-file handling.
- *
- * - Missing file → created (no warning)
- * - Existing managed file, same content → unchanged (no write, no warning)
- * - Existing managed file, different content → updated (overwrite, brief log)
- * - Existing file that doesn't look managed → replaced-foreign (overwrite,
- *   loud warning so the user notices we clobbered something)
- *
- * The "managed" check looks for kandev's marker substring; users who hand-edit
- * past the marker lose the no-op shortcut but still get an "updated" log line,
- * which is the expected workflow.
- */
-function writeUnitFile(targetPath, content) {
-    if (!node_fs_1.default.existsSync(targetPath)) {
-        node_fs_1.default.writeFileSync(targetPath, content, { mode: 0o644 });
-        console.log(`[kandev] wrote ${targetPath}`);
-        return "created";
-    }
-    const existing = node_fs_1.default.readFileSync(targetPath, "utf8");
-    if (existing === content) {
-        console.log(`[kandev] ${targetPath} is already up to date`);
-        return "unchanged";
-    }
-    if (!(0, templates_1.looksLikeManagedUnit)(existing)) {
-        console.log(`[kandev] WARNING: ${targetPath} exists but doesn't look like a kandev-managed file.`);
-        console.log(`[kandev]   The existing file will be replaced. A backup is saved alongside.`);
-        node_fs_1.default.copyFileSync(targetPath, `${targetPath}.bak`);
-        node_fs_1.default.writeFileSync(targetPath, content, { mode: 0o644 });
-        console.log(`[kandev] replaced ${targetPath} (backup: ${targetPath}.bak)`);
-        return "replaced-foreign";
-    }
-    node_fs_1.default.writeFileSync(targetPath, content, { mode: 0o644 });
-    console.log(`[kandev] updated ${targetPath}`);
-    return "updated";
-}

package/dist/service/launchctl.js

@@ -1,73 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.spawnLaunchctl = spawnLaunchctl;
-exports.sleepSync = sleepSync;
-exports.bootoutAndWait = bootoutAndWait;
-exports.bootstrapWithRetry = bootstrapWithRetry;
-exports.reloadService = reloadService;
-const node_child_process_1 = require("node:child_process");
-const BOOTOUT_POLL_INTERVAL_MS = 100;
-const BOOTOUT_POLL_ATTEMPTS = 50; // ~5s ceiling waiting for teardown
-const BOOTSTRAP_MAX_ATTEMPTS = 5;
-const BOOTSTRAP_RETRY_BASE_MS = 300;
-function spawnLaunchctl(args, stdio) {
-    const res = (0, node_child_process_1.spawnSync)("launchctl", args, { stdio });
-    return { status: res.status };
-}
-// Block the current thread for `ms`. The launchctl orchestration runs in the
-// synchronous `service install`/`start`/`restart` paths, so we can't await a
-// timer — Atomics.wait gives a dependency-free blocking sleep.
-function sleepSync(ms) {
-    if (ms <= 0)
-        return;
-    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
-}
-function isLoaded(target, run) {
-    // `launchctl print <target>` exits non-zero once the label is gone.
-    return run(["print", target], "ignore").status === 0;
-}
-/**
- * Boot out a launchd job and wait until launchd has fully removed it. A no-op
- * (returns promptly) when the label isn't loaded, so fresh installs aren't
- * slowed down.
- */
-function bootoutAndWait(target, deps = {}) {
-    const run = deps.run ?? spawnLaunchctl;
-    const sleep = deps.sleep ?? sleepSync;
-    run(["bootout", target], "ignore");
-    for (let attempt = 0; attempt < BOOTOUT_POLL_ATTEMPTS; attempt += 1) {
-        if (!isLoaded(target, run)) {
-            return;
-        }
-        sleep(BOOTOUT_POLL_INTERVAL_MS);
-    }
-}
-/**
- * Bootstrap a launchd job, retrying through the transient EIO that launchd
- * returns while a previous instance of the same label finishes tearing down.
- * Throws with the last exit code if every attempt fails.
- */
-function bootstrapWithRetry(domain, plistPath, deps = {}) {
-    const run = deps.run ?? spawnLaunchctl;
-    const sleep = deps.sleep ?? sleepSync;
-    let lastStatus = null;
-    for (let attempt = 1; attempt <= BOOTSTRAP_MAX_ATTEMPTS; attempt += 1) {
-        lastStatus = run(["bootstrap", domain, plistPath], "inherit").status;
-        if (lastStatus === 0) {
-            return;
-        }
-        if (attempt < BOOTSTRAP_MAX_ATTEMPTS) {
-            sleep(BOOTSTRAP_RETRY_BASE_MS * attempt);
-        }
-    }
-    throw new Error(`launchctl bootstrap ${domain} ${plistPath} failed with code ${lastStatus}`);
-}
-/**
- * Reload a launchd job: fully unload (waiting for teardown) then bootstrap with
- * retry. This is the safe sequence whenever the target might currently be
- * running — installs that refresh a live service, and `start`.
- */
-function reloadService(target, domain, plistPath, deps = {}) {
-    bootoutAndWait(target, deps);
-    bootstrapWithRetry(domain, plistPath, deps);
-}