@tidegap/cli 0.0.0-stage → 0.18.0

package/dist/commands/tick.js.map

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

package/dist/commands/ui.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `tidegap ui` — serve the local task page (timeline, inbox, task detail) on
+ * 127.0.0.1 with a per-run bearer token. The page can cancel, reschedule,
+ * run now and reply (ui v2): each action writes the ledger through a
+ * Scheduler with no adapters. It never dispatches; `tidegap tick` (or the
+ * OpenClaw loop) does, and the page can start `tidegap tick --daemon` when no
+ * dispatcher is running.
+ */
+import { type UiServer } from "../ui/server.js";
+export interface UiCommandOptions {
+    db?: string;
+    port?: number;
+    /** `false` (`--no-open`) only prints the URL. */
+    open?: boolean;
+    region?: string;
+}
+/** Open a URL in the default browser; failure is silent (the URL is printed). */
+export declare function openBrowser(url: string, platform?: NodeJS.Platform): void;
+export declare function newToken(): string;
+export declare function startUi(opts?: UiCommandOptions): Promise<{
+    server: UiServer;
+    link: string;
+}>;
+export declare function runUi(opts?: UiCommandOptions): Promise<number>;
+//# sourceMappingURL=ui.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/commands/ui.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAaH,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAM/D,MAAM,WAAW,gBAAgB;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAAG,IAAI,CAc3F;AAED,wBAAgB,QAAQ,IAAI,MAAM,CAEjC;AAED,wBAAsB,OAAO,CAAC,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CA4BtG;AAED,wBAAsB,KAAK,CAAC,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBxE"}

package/dist/commands/ui.js

@@ -0,0 +1,83 @@
+/**
+ * `tidegap ui` — serve the local task page (timeline, inbox, task detail) on
+ * 127.0.0.1 with a per-run bearer token. The page can cancel, reschedule,
+ * run now and reply (ui v2): each action writes the ledger through a
+ * Scheduler with no adapters. It never dispatches; `tidegap tick` (or the
+ * OpenClaw loop) does, and the page can start `tidegap tick --daemon` when no
+ * dispatcher is running.
+ */
+import { spawn } from "node:child_process";
+import { randomBytes } from "node:crypto";
+import { buildDefaultGridFeed, loadQuotaResetConfig, resolveRegion, } from "@tidegap/core";
+import { readEnvCredentials } from "../env.js";
+import { daemonStatus } from "../platform/index.js";
+import { startUiServer } from "../ui/server.js";
+import { loadEnvFileIntoProcess } from "./env-file.js";
+import { resolveLauncher } from "./install.js";
+import { actionScheduler } from "./queue.js";
+import { defaultDbPath } from "./tick.js";
+/** Open a URL in the default browser; failure is silent (the URL is printed). */
+export function openBrowser(url, platform = process.platform) {
+    const [cmd, args] = platform === "darwin"
+        ? ["open", [url]]
+        : platform === "win32"
+            ? ["cmd", ["/c", "start", "", url]]
+            : ["xdg-open", [url]];
+    try {
+        const child = spawn(cmd, args, { stdio: "ignore", detached: true });
+        child.on("error", () => { });
+        child.unref();
+    }
+    catch {
+        // ignore: the URL is on the terminal
+    }
+}
+export function newToken() {
+    return randomBytes(32).toString("base64url");
+}
+export async function startUi(opts = {}) {
+    // Grid-feed credentials live in the same secrets file the tick reads.
+    loadEnvFileIntoProcess();
+    const env = readEnvCredentials();
+    const token = newToken();
+    const dbPath = opts.db ?? defaultDbPath();
+    const feed = buildDefaultGridFeed(env.grid);
+    const defaultRegion = resolveRegion(undefined, opts.region).region;
+    const scheduler = actionScheduler({ dbPath, feed, region: defaultRegion });
+    const server = await startUiServer({
+        token,
+        port: opts.port ?? 0,
+        dbPath,
+        feed,
+        defaultRegion,
+        quota: () => loadQuotaResetConfig(),
+        daemonStatus: () => daemonStatus(),
+        // Writes only: this scheduler has no adapters and never dispatches.
+        scheduler,
+        // Start dispatcher spawns this same binary: `<launcher> tick --daemon`.
+        launcher: resolveLauncher(undefined, []),
+    });
+    const close = server.close.bind(server);
+    server.close = async () => {
+        await close();
+        scheduler.shutdown();
+    };
+    return { server, link: `${server.url}#token=${token}` };
+}
+export async function runUi(opts = {}) {
+    const { server, link } = await startUi(opts);
+    // eslint-disable-next-line no-console
+    console.log(`tidegap ui: ${link}\n` +
+        `Serving on 127.0.0.1 only. The link carries a one-run access token; ` +
+        `do not share it. Press Ctrl-C to stop.`);
+    if (opts.open !== false)
+        openBrowser(link);
+    await new Promise((resolve) => {
+        const stop = () => resolve();
+        process.once("SIGINT", stop);
+        process.once("SIGTERM", stop);
+    });
+    await server.close();
+    return 0;
+}
+//# sourceMappingURL=ui.js.map

package/dist/commands/ui.js.map

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

package/dist/commands/verify.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `tidegap verify <task-id | --file path>` — verify the Ed25519 signature
+ * on a carbon receipt.
+ *
+ *   - From the local ledger:   `tidegap verify <task_id>` (looks up
+ *     `~/.tidegap/queue.db`, or `--db` if set).
+ *   - From a JSON receipt:     `tidegap verify --file ./receipt.json`.
+ *
+ * Exit code reflects the outcome so CI / batch jobs can branch:
+ *   0 = valid; 1 = tampered; 2 = legacy-unsigned; 3 = key-mismatch;
+ *   4 = not-found / parse error.
+ */
+export interface VerifyOptions {
+    taskId?: string;
+    file?: string;
+    db?: string;
+    trustedPublicKey?: string;
+    json?: boolean;
+}
+export interface VerifyResult {
+    exitCode: number;
+    rendered: string;
+    /** Structured payload returned when `--json` is set. */
+    payload: {
+        taskId?: string;
+        outcome: string;
+        signerPublicKey?: string;
+        reason: string;
+    };
+}
+export declare function runVerify(opts: VerifyOptions): Promise<VerifyResult>;
+//# sourceMappingURL=verify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/commands/verify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,OAAO,EAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CA2C1E"}

package/dist/commands/verify.js

@@ -0,0 +1,135 @@
+/**
+ * `tidegap verify <task-id | --file path>` — verify the Ed25519 signature
+ * on a carbon receipt.
+ *
+ *   - From the local ledger:   `tidegap verify <task_id>` (looks up
+ *     `~/.tidegap/queue.db`, or `--db` if set).
+ *   - From a JSON receipt:     `tidegap verify --file ./receipt.json`.
+ *
+ * Exit code reflects the outcome so CI / batch jobs can branch:
+ *   0 = valid; 1 = tampered; 2 = legacy-unsigned; 3 = key-mismatch;
+ *   4 = not-found / parse error.
+ */
+import { readFileSync } from "node:fs";
+import { TaskStore, verifyReceipt } from "@tidegap/core";
+import { defaultDbPath } from "./tick.js";
+export async function runVerify(opts) {
+    const receipt = loadReceipt(opts);
+    if (!receipt) {
+        const reason = opts.file
+            ? `verify: file ${opts.file} did not contain a valid CarbonReceipt JSON object`
+            : `verify: no receipt found for task ${opts.taskId ?? "<missing>"} in ${opts.db ?? defaultDbPath()}`;
+        return {
+            exitCode: 4,
+            rendered: reason,
+            payload: { taskId: opts.taskId, outcome: "not-found", reason },
+        };
+    }
+    const res = verifyReceipt(receipt, {
+        trustedPublicKey: opts.trustedPublicKey,
+    });
+    const exitCode = res.outcome === "valid"
+        ? 0
+        : res.outcome === "tampered"
+            ? 1
+            : res.outcome === "legacy-unsigned"
+                ? 2
+                : /* key-mismatch */ 3;
+    const payload = {
+        taskId: receipt.taskId,
+        outcome: res.outcome,
+        signerPublicKey: res.signerPublicKey,
+        reason: res.reason,
+    };
+    if (opts.json) {
+        return {
+            exitCode,
+            rendered: JSON.stringify(payload, null, 2),
+            payload,
+        };
+    }
+    const rendered = renderHuman(receipt, res);
+    return { exitCode, rendered, payload };
+}
+function loadReceipt(opts) {
+    if (opts.file) {
+        try {
+            const raw = readFileSync(opts.file, "utf8");
+            const parsed = JSON.parse(raw);
+            // Accept either a bare receipt or a wrapper {receipt: ...} shape
+            // (matches what `writeOutputFile` emits in the scheduler).
+            const receipt = parsed && typeof parsed === "object" && "receipt" in parsed
+                ? parsed.receipt
+                : parsed;
+            if (!receipt || typeof receipt.taskId !== "string")
+                return undefined;
+            return receipt;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    if (!opts.taskId)
+        return undefined;
+    const store = new TaskStore({ dbPath: opts.db ?? defaultDbPath() });
+    try {
+        const record = store.get(opts.taskId);
+        return record?.receipt;
+    }
+    finally {
+        store.close();
+    }
+}
+function renderHuman(receipt, res) {
+    const status = res.outcome === "valid"
+        ? "✓ VALID"
+        : res.outcome === "tampered"
+            ? "✗ TAMPERED"
+            : res.outcome === "key-mismatch"
+                ? "✗ KEY MISMATCH"
+                : "○ LEGACY UNSIGNED";
+    const lines = [
+        status,
+    ];
+    if (receipt.gridSource === "mock") {
+        lines.push("!! MOCK DATA — grid intensity is synthetic, not from a real feed");
+    }
+    lines.push("", `task_id           ${receipt.taskId}`, `region            ${receipt.region}`, `ran_at            ${receipt.ranAt}`);
+    if (receipt.actualCarbonGCo2 !== undefined) {
+        lines.push(`actual_g_co2      ${receipt.actualCarbonGCo2}`);
+    }
+    if (receipt.estimatedCarbonGCo2 !== undefined) {
+        lines.push(`estimated_g_co2   ${receipt.estimatedCarbonGCo2}`);
+    }
+    if (receipt.deltaPct !== undefined) {
+        lines.push(`delta_pct         ${receipt.deltaPct >= 0 ? "+" : ""}${receipt.deltaPct}`);
+    }
+    if (receipt.intensityGCo2PerKwh !== undefined) {
+        lines.push(`intensity_g_kwh   ${receipt.intensityGCo2PerKwh}`);
+    }
+    if (receipt.gridSource !== undefined) {
+        const mock = receipt.gridSource === "mock";
+        const marginal = receipt.signalType === "marginal"
+            ? "   (marginal-emissions signal — not an average-grid figure)"
+            : "";
+        lines.push(`grid_source       ${receipt.gridSource}${mock ? "   !! MOCK DATA (synthetic — carbon is illustrative, not measured)" : ""}${marginal}`);
+    }
+    if (receipt.energySource !== undefined) {
+        lines.push(`energy_source     ${receipt.energySource}`);
+    }
+    if (receipt.energyResolution !== undefined) {
+        lines.push(`energy_resolution ${receipt.energyResolution}`);
+    }
+    if (receipt.model)
+        lines.push(`model             ${receipt.model}`);
+    if (receipt.provider)
+        lines.push(`provider          ${receipt.provider}`);
+    if (res.signerPublicKey) {
+        lines.push("", `signer_public_key ${res.signerPublicKey}`);
+    }
+    if (receipt.signedAt)
+        lines.push(`signed_at         ${receipt.signedAt}`);
+    lines.push("", res.reason);
+    return lines.join("\n");
+}
+//# sourceMappingURL=verify.js.map

package/dist/commands/verify.js.map

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

package/dist/env.d.ts

@@ -0,0 +1,55 @@
+/**
+ * The `tidegap` CLI's environment boundary.
+ *
+ * `@tidegap/core` is an environment-pure library: it reads no environment
+ * variables and takes every credential as an explicit argument. The CLI is a
+ * HOST, so reading the environment is its job — and this module is the single
+ * place it happens. Every variable is read BY NAME into a closed shape; the
+ * whole `process` environment object is never bound to a local or handed to
+ * core.
+ *
+ * Behaviour is unchanged from before core became environment-pure: the same
+ * variables, the same precedence (GEMINI_API_KEY before GOOGLE_API_KEY).
+ *
+ * Since 0.18 the Tidegap variables are named `TIDEGAP_*`. Each 0.17 `EBB_*`
+ * twin is still read when the `TIDEGAP_*` one is unset, and the process
+ * prints one deprecation line to stderr naming the variables it fell back on.
+ * The fallback is removed in 0.19.
+ *
+ * See also: `packages/mcp-server/src/env.ts` (the MCP server's copy of this
+ * boundary) and `packages/openclaw-plugin` — which has NO environment
+ * boundary at all, taking everything from OpenClaw plugin config so its
+ * published bundle contains zero environment reads.
+ */
+import type { CarbonBudgetEnv, GridFeedCredentials } from "@tidegap/core";
+/** Provider credentials the CLI forwards to `@tidegap/core`'s adapters. */
+export interface ProviderCredentials {
+    /** `ANTHROPIC_API_KEY` */
+    anthropicApiKey?: string;
+    /** `OPENAI_API_KEY` */
+    openaiApiKey?: string;
+    /** `GEMINI_API_KEY`, else `GOOGLE_API_KEY` */
+    geminiApiKey?: string;
+    /** `OLLAMA_HOST` (opt-in: unset means "do not register the Ollama adapter") */
+    ollamaHost?: string;
+}
+export interface EnvCredentials extends ProviderCredentials {
+    /** Grid-feed credentials for `buildDefaultGridFeed`. */
+    grid: GridFeedCredentials;
+    /** Aggregate carbon-budget overrides for `loadCarbonBudgetConfig`. */
+    carbonBudget: CarbonBudgetEnv;
+    /** `TIDEGAP_BINARY`: launcher override for `tidegap install`. */
+    binary?: string;
+    /** `TIDEGAP_NO_NOTIFY=1` (or true/yes/on): `tidegap tick` posts no OS notification. */
+    noNotify: boolean;
+}
+/** Receives the one deprecation line about `EBB_*` fallbacks. */
+export type DeprecationWriter = (line: string) => void;
+/**
+ * Snapshot every environment variable the CLI recognizes, by name.
+ * Call this at an entry point and pass the result down — never re-read the
+ * environment deeper in the call tree. A fallback to an `EBB_*` name goes to
+ * `write` (default: one stderr line per process).
+ */
+export declare function readEnvCredentials(write?: DeprecationWriter): EnvCredentials;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAE1E,2EAA2E;AAC3E,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uBAAuB;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAe,SAAQ,mBAAmB;IACzD,wDAAwD;IACxD,IAAI,EAAE,mBAAmB,CAAC;IAC1B,sEAAsE;IACtE,YAAY,EAAE,eAAe,CAAC;IAC9B,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uFAAuF;IACvF,QAAQ,EAAE,OAAO,CAAC;CACnB;AAQD,iEAAiE;AACjE,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAiCvD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,GAAE,iBAA6B,GAAG,cAAc,CAiCvF"}

package/dist/env.js

@@ -0,0 +1,90 @@
+/**
+ * The `tidegap` CLI's environment boundary.
+ *
+ * `@tidegap/core` is an environment-pure library: it reads no environment
+ * variables and takes every credential as an explicit argument. The CLI is a
+ * HOST, so reading the environment is its job — and this module is the single
+ * place it happens. Every variable is read BY NAME into a closed shape; the
+ * whole `process` environment object is never bound to a local or handed to
+ * core.
+ *
+ * Behaviour is unchanged from before core became environment-pure: the same
+ * variables, the same precedence (GEMINI_API_KEY before GOOGLE_API_KEY).
+ *
+ * Since 0.18 the Tidegap variables are named `TIDEGAP_*`. Each 0.17 `EBB_*`
+ * twin is still read when the `TIDEGAP_*` one is unset, and the process
+ * prints one deprecation line to stderr naming the variables it fell back on.
+ * The fallback is removed in 0.19.
+ *
+ * See also: `packages/mcp-server/src/env.ts` (the MCP server's copy of this
+ * boundary) and `packages/openclaw-plugin` — which has NO environment
+ * boundary at all, taking everything from OpenClaw plugin config so its
+ * published bundle contains zero environment reads.
+ */
+/** Trim and collapse an empty string to `undefined`. */
+function val(raw) {
+    const v = raw?.trim();
+    return v ? v : undefined;
+}
+let fallbackReported = false;
+/** Default writer: stderr, once per process. */
+const writeOnce = (line) => {
+    if (fallbackReported)
+        return;
+    fallbackReported = true;
+    process.stderr.write(`${line}\n`);
+};
+/**
+ * Collects the 0.17 names a read fell back on. `pick(current, legacy, name)`
+ * returns the `TIDEGAP_<name>` value, else the `EBB_<name>` value (recording
+ * `EBB_<name>`), else `undefined`.
+ */
+class Fallbacks {
+    used = [];
+    pick(current, legacy, name) {
+        if (current !== undefined && current.trim() !== "")
+            return current;
+        if (legacy !== undefined && legacy.trim() !== "") {
+            this.used.push(`EBB_${name}`);
+            return legacy;
+        }
+        return current;
+    }
+    report(write) {
+        if (this.used.length === 0)
+            return;
+        const renamed = this.used.map((n) => `${n} -> TIDEGAP_${n.slice(4)}`).join(", ");
+        write(`tidegap: rename ${renamed}; the EBB_* names stop working in 0.19.`);
+    }
+}
+/**
+ * Snapshot every environment variable the CLI recognizes, by name.
+ * Call this at an entry point and pass the result down — never re-read the
+ * environment deeper in the call tree. A fallback to an `EBB_*` name goes to
+ * `write` (default: one stderr line per process).
+ */
+export function readEnvCredentials(write = writeOnce) {
+    const f = new Fallbacks();
+    const out = {
+        anthropicApiKey: val(process.env.ANTHROPIC_API_KEY),
+        openaiApiKey: val(process.env.OPENAI_API_KEY),
+        geminiApiKey: val(process.env.GEMINI_API_KEY) ?? val(process.env.GOOGLE_API_KEY),
+        ollamaHost: val(process.env.OLLAMA_HOST),
+        grid: {
+            electricityMapsApiKey: val(f.pick(process.env.TIDEGAP_ELECTRICITY_MAPS_API_KEY, process.env.EBB_ELECTRICITY_MAPS_API_KEY, "ELECTRICITY_MAPS_API_KEY")),
+            eiaApiKey: val(f.pick(process.env.TIDEGAP_EIA_API_KEY, process.env.EBB_EIA_API_KEY, "EIA_API_KEY")),
+            entsoeSecurityToken: val(f.pick(process.env.TIDEGAP_ENTSOE_SECURITY_TOKEN, process.env.EBB_ENTSOE_SECURITY_TOKEN, "ENTSOE_SECURITY_TOKEN")),
+            wattTimeUsername: val(process.env.WATTTIME_USERNAME),
+            wattTimePassword: val(process.env.WATTTIME_PASSWORD),
+        },
+        carbonBudget: {
+            TIDEGAP_CARBON_BUDGET_G: f.pick(process.env.TIDEGAP_CARBON_BUDGET_G, process.env.EBB_CARBON_BUDGET_G, "CARBON_BUDGET_G"),
+            TIDEGAP_CARBON_BUDGET_WINDOW: f.pick(process.env.TIDEGAP_CARBON_BUDGET_WINDOW, process.env.EBB_CARBON_BUDGET_WINDOW, "CARBON_BUDGET_WINDOW"),
+        },
+        binary: val(f.pick(process.env.TIDEGAP_BINARY, process.env.EBB_BINARY, "BINARY")),
+        noNotify: /^(1|true|yes|on)$/i.test(val(f.pick(process.env.TIDEGAP_NO_NOTIFY, process.env.EBB_NO_NOTIFY, "NO_NOTIFY")) ?? ""),
+    };
+    f.report(write);
+    return out;
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+#!/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 { Command } from "commander";
+/**
+ * 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 declare function readCliVersion(): string;
+export declare function buildProgram(): Command;
+/**
+ * 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 declare function binAliasDeprecation(argv1: string | undefined): string | undefined;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG;AAKH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBpC;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAQvC;AAID,wBAAgB,YAAY,IAAI,OAAO,CAoStC;AAYD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAKjF"}