@tidegap/cli 0.0.0-stage → 0.18.0

package/dist/index.js

@@ -0,0 +1,351 @@
+#!/usr/bin/env node
+/**
+ * `tidegap` — CLI entry point.
+ *
+ *   tidegap tick           drain due tasks (one-shot or --daemon)
+ *   tidegap install        write launchd plist or print systemd/schtasks templates
+ *   tidegap queue list     print queued/scheduled/running/completed tasks
+ *   tidegap queue cancel | reschedule | run-now | reply   change a task (the
+ *                      next tick runs it; these commands never dispatch)
+ *   tidegap receipts list  print carbon receipts for completed tasks
+ *   tidegap stats          local-only personal-impact summary
+ *   tidegap register-wake  schedule a macOS wake event 30s before a task
+ *   tidegap ui             local task page (timeline, inbox, detail, actions) on 127.0.0.1
+ */
+import { createRequire } from "node:module";
+import { basename } from "node:path";
+import { stripControlChars } from "@tidegap/core";
+import { Command } from "commander";
+import { runInstall } from "./commands/install.js";
+import { runQueueCancel, runQueueList, runQueueReply, runQueueReschedule, runQueueRunNow, runQueueShow, runQueueUnread, } from "./commands/queue.js";
+import { runReceiptsList } from "./commands/receipts.js";
+import { runRegisterWake } from "./commands/register-wake.js";
+import { runStats } from "./commands/stats.js";
+import { runTick } from "./commands/tick.js";
+import { runUi } from "./commands/ui.js";
+import { runVerify } from "./commands/verify.js";
+/**
+ * CLI version — read from this package's own `package.json` so there is
+ * a single source of truth and `tidegap --version` never drifts from the
+ * published version. `createRequire` resolves relative to this module,
+ * so it works from both `src` (tests) and `dist` (published bin).
+ */
+export function readCliVersion() {
+    try {
+        const require = createRequire(import.meta.url);
+        const pkg = require("../package.json");
+        return pkg.version ?? "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+const CLI_VERSION = readCliVersion();
+export function buildProgram() {
+    const program = new Command();
+    program
+        .name("tidegap")
+        .description("CLI for Tidegap — carbon-aware scheduler tick + install")
+        .version(CLI_VERSION);
+    program
+        .command("tick")
+        .description("Drain due provider-call tasks")
+        .option("--db <path>", "SQLite queue path", undefined)
+        .option("--once", "Run a single drain pass (default)")
+        .option("--daemon", "Loop forever, draining every --interval seconds")
+        .option("--interval <sec>", "Daemon interval seconds", (v) => parseInt(v, 10), 60)
+        .option("--region <code>", "Default region for hydrated tasks", undefined)
+        .option("--no-notify", "Do not post an OS notification per finished task")
+        .action(async (opts) => {
+        const code = await runTick({
+            notify: opts.notify !== false,
+            db: opts.db,
+            once: opts.once === true,
+            daemon: opts.daemon === true,
+            interval: opts.interval,
+            region: opts.region,
+        });
+        process.exit(code);
+    });
+    const install = program
+        .command("install")
+        .description("Wire up the OS-level cron tick")
+        .option("--laptop", "Laptop mode: launchd plist + pmset wake registration helper")
+        .option("--server", "Server mode: launchd plist only, no wake events")
+        .action(async (opts) => {
+        let mode;
+        if (opts.laptop)
+            mode = "laptop";
+        if (opts.server)
+            mode = "server";
+        if (!mode) {
+            install.help({ error: true });
+            process.exit(2);
+            return;
+        }
+        const result = await runInstall({ mode });
+        // eslint-disable-next-line no-console
+        console.log(result.nextSteps);
+    });
+    const queue = program
+        .command("queue")
+        .description("Inspect and change the queue");
+    queue
+        .command("list")
+        .description("List queued / scheduled / running / completed tasks")
+        .option("--db <path>", "SQLite queue path", undefined)
+        .option("--status <status>", "Filter by status", undefined)
+        .option("--kind <kind>", "Filter by deadline kind: absolute | quota_reset", undefined)
+        .option("--unread", "Only completed or failed tasks nobody has viewed yet")
+        .option("--json", "Emit JSON instead of the table")
+        .option("--hook", "Claude Code SessionStart mode: one unread-count line or nothing; always exits 0")
+        .option("--series <id>", "Only the occurrences of this repeating series, oldest first")
+        .action(async (opts) => {
+        if (opts.hook === true) {
+            const res = await runQueueList({ db: opts.db, hook: true });
+            // eslint-disable-next-line no-console
+            if (res.rendered)
+                console.log(res.rendered);
+            return;
+        }
+        try {
+            const res = await runQueueList({
+                db: opts.db,
+                status: opts.status,
+                kind: opts.kind,
+                unread: opts.unread === true,
+                json: opts.json === true,
+                series: opts.series,
+            });
+            // eslint-disable-next-line no-console
+            console.log(res.rendered);
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.error(err.message);
+            process.exit(1);
+        }
+    });
+    queue
+        .command("show <task-id>")
+        .description("Show one task: prompt, result, receipt; marks a finished task read")
+        .option("--db <path>", "SQLite queue path", undefined)
+        .option("--raw", "Include the raw vendor payload")
+        .option("--json", "Emit JSON (the record plus its message history)")
+        .option("--no-mark-read", "Do not mark the task read (for scripts)")
+        .action(async (taskId, opts) => {
+        try {
+            const res = await runQueueShow(taskId, {
+                db: opts.db,
+                raw: opts.raw === true,
+                json: opts.json === true,
+                markRead: opts.markRead !== false,
+            });
+            // eslint-disable-next-line no-console
+            console.log(res.rendered);
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.error(err.message);
+            process.exit(1);
+        }
+    });
+    queue
+        .command("unread <task-id>")
+        .description("Mark a task unread again, so it shows in the inbox")
+        .option("--db <path>", "SQLite queue path", undefined)
+        .action(async (taskId, opts) => {
+        try {
+            // eslint-disable-next-line no-console
+            console.log(await runQueueUnread(taskId, { db: opts.db }));
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.error(err.message);
+            process.exit(1);
+        }
+    });
+    /** Run one write command: print its result, or the core's refusal and exit 1. */
+    const write = async (fn) => {
+        try {
+            // eslint-disable-next-line no-console
+            console.log(await fn());
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.error(stripControlChars(err.message));
+            process.exit(1);
+        }
+    };
+    queue
+        .command("cancel <task-id>")
+        .description("Cancel a pending task; a repeating task skips this occurrence")
+        .option("--db <path>", "SQLite queue path", undefined)
+        .option("--series", "Also end the task's repeating series")
+        .action((taskId, opts) => write(() => runQueueCancel(taskId, { db: opts.db, series: opts.series === true })));
+    queue
+        .command("reschedule <task-id>")
+        .description("Move a queued or scheduled task: a new deadline, an exact time, or a local day")
+        .option("--db <path>", "SQLite queue path", undefined)
+        .option("--by <when>", "New deadline: a duration (30m, 2h, 3d, 1w) or an ISO-8601 time")
+        .option("--at <when>", "Run at exactly this time (duration or ISO-8601)")
+        .option("--day <yyyy-mm-dd>", "Run on this local day, at its cleanest forecast hour")
+        .action((taskId, opts) => write(() => runQueueReschedule(taskId, opts)));
+    queue
+        .command("run-now <task-id>")
+        .description("Mark a queued or scheduled task due now; the next tick runs it")
+        .option("--db <path>", "SQLite queue path", undefined)
+        .action((taskId, opts) => write(() => runQueueRunNow(taskId, { db: opts.db })));
+    queue
+        .command("reply <task-id> <text>")
+        .description("Continue a completed task: queue a new task with its conversation plus this text")
+        .option("--db <path>", "SQLite queue path", undefined)
+        .option("--by <when>", "Deadline for the reply (default 1h)")
+        .action((taskId, text, opts) => write(() => runQueueReply(taskId, text, { db: opts.db, by: opts.by })));
+    const receipts = program
+        .command("receipts")
+        .description("Inspect carbon receipts");
+    receipts
+        .command("list")
+        .description("List receipts for completed tasks")
+        .option("--db <path>", "SQLite queue path", undefined)
+        .option("--since <iso>", "Only receipts at or after this ISO-8601 time")
+        .action(async (opts) => {
+        try {
+            const res = await runReceiptsList({ db: opts.db, since: opts.since });
+            // eslint-disable-next-line no-console
+            console.log(res.rendered);
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.error(err.message);
+            process.exit(1);
+        }
+    });
+    program
+        .command("stats")
+        .description("Show local-only personal-impact stats from the queue ledger")
+        .option("--db <path>", "SQLite queue path", undefined)
+        .option("--json", "Emit JSON instead of the human-readable table")
+        .action(async (opts) => {
+        try {
+            const res = await runStats({ db: opts.db, json: opts.json === true });
+            // eslint-disable-next-line no-console
+            console.log(res.rendered);
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.error(err.message);
+            process.exit(1);
+        }
+    });
+    program
+        .command("verify [task-id]")
+        .description("Verify the Ed25519 signature on a carbon receipt — from the ledger by task_id, or from a JSON file via --file")
+        .option("--db <path>", "SQLite queue path", undefined)
+        .option("--file <path>", "Path to a receipt JSON file (alternative to task_id)", undefined)
+        .option("--trusted-public-key <b64>", "Pin the expected signer's public key (base64); fail if the receipt was signed by anyone else", undefined)
+        .option("--json", "Emit JSON instead of the human-readable summary")
+        .action(async (taskId, opts) => {
+        try {
+            const res = await runVerify({
+                taskId,
+                db: opts.db,
+                file: opts.file,
+                trustedPublicKey: opts.trustedPublicKey,
+                json: opts.json === true,
+            });
+            // eslint-disable-next-line no-console
+            console.log(res.rendered);
+            process.exit(res.exitCode);
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.error(err.message);
+            process.exit(4);
+        }
+    });
+    program
+        .command("register-wake <task-id>")
+        .description("Schedule a macOS wake event 30s before a task's window")
+        .option("--db <path>", "SQLite queue path", undefined)
+        .option("--dry-run", "Print the pmset command without running it")
+        .action(async (taskId, opts) => {
+        try {
+            const res = await runRegisterWake({
+                taskId,
+                db: opts.db,
+                dryRun: opts.dryRun === true,
+            });
+            // eslint-disable-next-line no-console
+            console.log(res.message);
+            process.exit(res.ok ? 0 : 1);
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.error(err.message);
+            process.exit(1);
+        }
+    });
+    program
+        .command("ui")
+        .description("Open the local task page: timeline, inbox, task detail, actions (127.0.0.1 only; never dispatches)")
+        .option("--db <path>", "SQLite queue path", undefined)
+        .option("--port <port>", "Port on 127.0.0.1 (default: a free port)", (v) => parseInt(v, 10), 0)
+        .option("--region <code>", "Region for the forecast curve", undefined)
+        .option("--no-open", "Print the URL without opening a browser")
+        .action(async (opts) => {
+        try {
+            const code = await runUi({
+                db: opts.db,
+                port: opts.port,
+                region: opts.region,
+                open: opts.open !== false,
+            });
+            process.exit(code);
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.error(err.message);
+            process.exit(1);
+        }
+    });
+    return program;
+}
+const isDirect = (() => {
+    try {
+        const argv1 = process.argv[1];
+        if (!argv1)
+            return false;
+        return import.meta.url.endsWith(argv1) || import.meta.url.includes("/cli/dist/index.js");
+    }
+    catch {
+        return false;
+    }
+})();
+/**
+ * The deprecation line for the 0.18 `ebb` bin alias, or `undefined` when the
+ * program was started under any other name. npm links both bins to this file,
+ * so the name the user typed is the basename of `argv[1]`. The alias goes
+ * away in 0.19.
+ */
+export function binAliasDeprecation(argv1) {
+    if (!argv1)
+        return undefined;
+    const name = basename(argv1).replace(/\.(c|m)?js$/, "");
+    if (name !== "ebb")
+        return undefined;
+    return "tidegap: the `ebb` command is now `tidegap`; the `ebb` alias is removed in 0.19.";
+}
+if (isDirect) {
+    const deprecation = binAliasDeprecation(process.argv[1]);
+    // eslint-disable-next-line no-console
+    if (deprecation)
+        console.error(deprecation);
+    buildProgram().parseAsync(process.argv).catch((err) => {
+        // eslint-disable-next-line no-console
+        console.error(err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/platform/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Platform-aware loader. Returns the right submodule for the current OS.
+ * The submodules expose the same shape (`caffeinateWhilePending`,
+ * `pmsetScheduleWake`, etc.); only macOS is fully wired in v0.4.
+ */
+import * as linux from "./linux.js";
+import * as macos from "./macos.js";
+import * as windows from "./windows.js";
+export type PlatformName = "macos" | "linux" | "windows";
+export declare function currentPlatform(): PlatformName;
+export declare function getPlatform(name?: PlatformName): {
+    name: PlatformName;
+    caffeinateWhilePending: typeof macos.caffeinateWhilePending;
+    pmsetScheduleWake: typeof macos.pmsetScheduleWake;
+};
+export { macos, linux, windows };
+/** Whether a tick daemon (`tidegap install`) is set up on this machine. */
+export type DaemonStatus = "installed" | "not_installed" | "unknown";
+/**
+ * Probe for the unit file `tidegap install` writes: the macOS LaunchAgent plist
+ * or the Linux systemd user timer. Windows reports `unknown`, because there
+ * `tidegap install` only prints a schtasks command and nothing on disk shows
+ * whether the user ran it.
+ */
+export declare function daemonStatus(opts?: {
+    platform?: NodeJS.Platform;
+    home?: string;
+    exists?: (path: string) => boolean;
+}): DaemonStatus;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/platform/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AAExC,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;AAEzD,wBAAgB,eAAe,IAAI,YAAY,CAI9C;AAED,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG;IAChD,IAAI,EAAE,YAAY,CAAC;IACnB,sBAAsB,EAAE,OAAO,KAAK,CAAC,sBAAsB,CAAC;IAC5D,iBAAiB,EAAE,OAAO,KAAK,CAAC,iBAAiB,CAAC;CACnD,CAqBA;AAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAEjC,2EAA2E;AAC3E,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,eAAe,GAAG,SAAS,CAAC;AAErE;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,IAAI,GAAE;IACJ,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CAC/B,GACL,YAAY,CAgBd"}

package/dist/platform/index.js

@@ -0,0 +1,66 @@
+/**
+ * Platform-aware loader. Returns the right submodule for the current OS.
+ * The submodules expose the same shape (`caffeinateWhilePending`,
+ * `pmsetScheduleWake`, etc.); only macOS is fully wired in v0.4.
+ */
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import * as linux from "./linux.js";
+import * as macos from "./macos.js";
+import * as windows from "./windows.js";
+export function currentPlatform() {
+    if (process.platform === "darwin")
+        return "macos";
+    if (process.platform === "win32")
+        return "windows";
+    return "linux";
+}
+export function getPlatform(name) {
+    const resolved = name ?? currentPlatform();
+    if (resolved === "macos") {
+        return {
+            name: "macos",
+            caffeinateWhilePending: macos.caffeinateWhilePending,
+            pmsetScheduleWake: macos.pmsetScheduleWake,
+        };
+    }
+    if (resolved === "windows") {
+        return {
+            name: "windows",
+            caffeinateWhilePending: windows.caffeinateWhilePending,
+            pmsetScheduleWake: windows.pmsetScheduleWake,
+        };
+    }
+    return {
+        name: "linux",
+        caffeinateWhilePending: linux.caffeinateWhilePending,
+        pmsetScheduleWake: linux.pmsetScheduleWake,
+    };
+}
+export { macos, linux, windows };
+/**
+ * Probe for the unit file `tidegap install` writes: the macOS LaunchAgent plist
+ * or the Linux systemd user timer. Windows reports `unknown`, because there
+ * `tidegap install` only prints a schtasks command and nothing on disk shows
+ * whether the user ran it.
+ */
+export function daemonStatus(opts = {}) {
+    const platform = opts.platform ?? process.platform;
+    const home = opts.home ?? homedir();
+    const exists = opts.exists ?? existsSync;
+    // The 0.17 unit counts too: it keeps ticking the same ledger until removed.
+    if (platform === "darwin") {
+        const agents = join(home, "Library", "LaunchAgents");
+        return [macos.LAUNCHD_LABEL, macos.LEGACY_LAUNCHD_LABEL].some((l) => exists(join(agents, `${l}.plist`)))
+            ? "installed"
+            : "not_installed";
+    }
+    if (platform === "win32")
+        return "unknown";
+    const units = join(home, ".config", "systemd", "user");
+    return [linux.SYSTEMD_UNIT, linux.LEGACY_SYSTEMD_UNIT].some((u) => exists(join(units, `${u}.timer`)))
+        ? "installed"
+        : "not_installed";
+}
+//# sourceMappingURL=index.js.map

package/dist/platform/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/platform/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AAIxC,MAAM,UAAU,eAAe;IAC7B,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAClD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC;IACnD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAmB;IAK7C,MAAM,QAAQ,GAAG,IAAI,IAAI,eAAe,EAAE,CAAC;IAC3C,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,OAAO;YACL,IAAI,EAAE,OAAO;YACb,sBAAsB,EAAE,KAAK,CAAC,sBAAsB;YACpD,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;SAC3C,CAAC;IACJ,CAAC;IACD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO;YACL,IAAI,EAAE,SAAS;YACf,sBAAsB,EAAE,OAAO,CAAC,sBAAsB;YACtD,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;SAC7C,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,OAAO;QACb,sBAAsB,EAAE,KAAK,CAAC,sBAAsB;QACpD,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;KAC3C,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAKjC;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,OAII,EAAE;IAEN,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IACnD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC;IACpC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,UAAU,CAAC;IACzC,4EAA4E;IAC5E,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;QACrD,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;YACtG,CAAC,CAAC,WAAW;YACb,CAAC,CAAC,eAAe,CAAC;IACtB,CAAC;IACD,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC;IAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IACvD,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QACnG,CAAC,CAAC,WAAW;QACb,CAAC,CAAC,eAAe,CAAC;AACtB,CAAC"}

package/dist/platform/linux.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Linux platform helpers — `systemd-inhibit`, `rtcwake`, and
+ * user-systemd unit-file generation.
+ *
+ * Like the macOS module, these wrap shell-outs and string-templating.
+ * The only side-effects are spawning subprocesses; nothing here writes
+ * a file. The `install` command places the unit files on disk.
+ */
+/**
+ * Spawn `systemd-inhibit --what=idle` so the system stays awake.
+ * Returns a kill() function. If `systemd-inhibit` is not available,
+ * the returned kill() is a no-op.
+ *
+ * Note: many Linux desktops will honour this; headless servers may
+ * have no idle-sleep policy at all, in which case the inhibit is a
+ * functional no-op.
+ */
+export declare function caffeinateWhilePending(durationSec: number): Promise<() => void>;
+/**
+ * Build the exact `rtcwake -m no -t <epoch-seconds>` command for a
+ * given date. `-m no` tells rtcwake to *only* arm the RTC alarm without
+ * suspending the machine itself.
+ */
+export declare function rtcwakeCommand(at: Date): string;
+/**
+ * Run `rtcwake -m no -t <epoch>`. Needs CAP_SYS_TIME / root. If we are
+ * euid 0 we run it directly; otherwise we try `sudo -n` (non-interactive
+ * — succeeds only if a sudoers rule pre-authorizes it without a password)
+ * and, on failure, hand the caller a non-ok result so it can print the
+ * exact sudoers one-liner.
+ */
+export declare function rtcwakeScheduleWake(at: Date): Promise<{
+    command: string;
+    ok: boolean;
+    stderr: string;
+}>;
+/**
+ * Compatibility alias for the cross-platform `getPlatform` shim so
+ * callers can keep using one name regardless of OS.
+ */
+export declare const pmsetScheduleWake: typeof rtcwakeScheduleWake;
+/** Base name of the systemd user units (`.service` and `.timer`). */
+export declare const SYSTEMD_UNIT = "tidegap-tick";
+/** The 0.17 unit name, detected so `tidegap install` can print its cleanup. */
+export declare const LEGACY_SYSTEMD_UNIT = "ebb-tick";
+export interface SystemdServiceOptions {
+    dbPath: string;
+    /**
+     * The argv[0..n] that invoke `tidegap`, resolved at install time. For a
+     * pinned node install this is `[process.execPath, realpath(argv[1])]`
+     * — the exact interpreter plus the real dist entry — immune to a bare
+     * service PATH and `#!/usr/bin/env node` shebangs. Falls back to
+     * `ebbBinaryPath` (single element) if omitted.
+     */
+    launcher?: string[];
+    /** Legacy single-binary launcher. Prefer `launcher`. */
+    ebbBinaryPath?: string;
+    /** Absolute path to write stdout/stderr logs. Defaults to ~/.tidegap/logs/tick.log. */
+    logPath?: string;
+    /** Optional env vars added as `Environment=KEY=VAL` lines. */
+    env?: Record<string, string>;
+}
+/**
+ * Render the `tidegap-tick.service` unit file. `Type=oneshot` because the
+ * service runs `tidegap tick --once` and exits; the companion timer is
+ * responsible for cadence. `EnvironmentFile=` references a user-owned
+ * env file (belt-and-braces: `tidegap tick` also loads it directly), so
+ * secrets never land in the service unit itself.
+ */
+export declare function systemdService(opts: SystemdServiceOptions): string;
+export interface SystemdTimerOptions {
+    tickIntervalSec: number;
+}
+/**
+ * Render the `tidegap-tick.timer` unit file. Uses `OnUnitActiveSec=<n>s`
+ * so the cadence matches the launchd `StartInterval` — fires every N
+ * seconds regardless of wall-clock alignment. `OnBootSec=30s` covers
+ * the case where the user-session starts before the network does.
+ */
+export declare function systemdTimer(opts: SystemdTimerOptions): string;
+//# sourceMappingURL=linux.d.ts.map

package/dist/platform/linux.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linux.d.ts","sourceRoot":"","sources":["../../src/platform/linux.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,IAAI,CAAC,CA8BrB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,IAAI,GAAG,MAAM,CAG/C;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,IAAI,GACP,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAwB3D;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,4BAAsB,CAAC;AAErD,qEAAqE;AACrE,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAC3C,+EAA+E;AAC/E,eAAO,MAAM,mBAAmB,aAAa,CAAC;AAE9C,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uFAAuF;IACvF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CA6BlE;AAED,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAa9D"}