onadit 0.0.1 → 1.0.0

package/dist/src/observability/version-check.js

@@ -0,0 +1,198 @@
+/**
+ * Version-check lane — single-file snapshot, not append-only.
+ *
+ * Hourly, the daemon hits the npm registry for `onadit` and writes
+ * the `latest` dist-tag (the current release) alongside the currently-installed version
+ * into `data/observability/version-check.json`. The CLI's `onadit status`
+ * header reads this file (auth-gated via /status/friend) and surfaces an
+ * update-available hint when `installed` lags `latest_beta`.
+ *
+ * Privacy: the probe is metadata-only — a plain `fetch` of
+ * `https://registry.npmjs.org/onadit`. No content, no telemetry,
+ * no friend-identifying info leaves the machine. See
+ * docs/feedback/PRIVACY.md.
+ *
+ * Failure mode: probe errors are non-fatal — they are recorded in the
+ * `error` field so the renderer can stay silent. A previous successful
+ * snapshot is preserved across failures so a transient outage does not
+ * blank the update line.
+ */
+import fs from "node:fs";
+import path from "node:path";
+export function versionCheckPath(dataDir) {
+    return path.join(dataDir, "observability", "version-check.json");
+}
+/**
+ * Write the snapshot atomically. Best-effort: a write failure logs to
+ * stderr but never throws — the update-check feature must not be able
+ * to break the daemon.
+ */
+export function writeVersionCheck(dataDir, snapshot) {
+    const filePath = versionCheckPath(dataDir);
+    try {
+        fs.mkdirSync(path.dirname(filePath), { recursive: true });
+        const tmp = `${filePath}.tmp`;
+        fs.writeFileSync(tmp, JSON.stringify(snapshot, null, 2) + "\n");
+        fs.renameSync(tmp, filePath);
+    }
+    catch (err) {
+        process.stderr.write(`[version-check] write failed: ${err instanceof Error ? err.message : String(err)}\n`);
+    }
+}
+/**
+ * Read the snapshot. Returns null when the file is missing or unparseable
+ * (a missing file is the steady-state on a fresh install before the first
+ * probe runs).
+ */
+export function readVersionCheck(dataDir) {
+    let raw;
+    try {
+        raw = fs.readFileSync(versionCheckPath(dataDir), "utf-8");
+    }
+    catch {
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (!isVersionCheckSnapshot(parsed))
+        return null;
+    return parsed;
+}
+function isVersionCheckSnapshot(value) {
+    if (value === null || typeof value !== "object")
+        return false;
+    const v = value;
+    return (typeof v["installed"] === "string" &&
+        (v["latest_beta"] === null || typeof v["latest_beta"] === "string") &&
+        typeof v["checked_at"] === "string" &&
+        (v["error"] === null || typeof v["error"] === "string"));
+}
+/**
+ * Compare two `x.y.z-beta.N` versions. Returns:
+ *   negative if a < b
+ *   zero    if a === b
+ *   positive if a > b
+ *
+ * Anything we cannot parse is treated as equal — the status renderer
+ * uses this only to decide whether to *show* an update hint, so the
+ * conservative behavior on bad input is "don't nag."
+ *
+ * This is intentionally tiny and beta-aware rather than a full semver
+ * implementation. Releases are `x.y.z`; betas before 1.0.0 were `x.y.z-beta.N`.
+ */
+export function compareBetaVersions(a, b) {
+    if (a === b)
+        return 0;
+    const pa = parseBetaVersion(a);
+    const pb = parseBetaVersion(b);
+    if (!pa || !pb)
+        return 0;
+    if (pa.major !== pb.major)
+        return pa.major - pb.major;
+    if (pa.minor !== pb.minor)
+        return pa.minor - pb.minor;
+    if (pa.patch !== pb.patch)
+        return pa.patch - pb.patch;
+    // Stable (`x.y.z`) sorts above any prerelease of the same x.y.z.
+    if (pa.beta === null && pb.beta === null)
+        return 0;
+    if (pa.beta === null)
+        return 1;
+    if (pb.beta === null)
+        return -1;
+    return pa.beta - pb.beta;
+}
+function parseBetaVersion(v) {
+    const m = v.match(/^(\d+)\.(\d+)\.(\d+)(?:-beta\.(\d+))?$/);
+    if (!m)
+        return null;
+    const major = Number(m[1]);
+    const minor = Number(m[2]);
+    const patch = Number(m[3]);
+    const beta = m[4] !== undefined ? Number(m[4]) : null;
+    if (!Number.isFinite(major) ||
+        !Number.isFinite(minor) ||
+        !Number.isFinite(patch) ||
+        (beta !== null && !Number.isFinite(beta))) {
+        return null;
+    }
+    return { major, minor, patch, beta };
+}
+export const NPM_REGISTRY_URL = "https://registry.npmjs.org/onadit";
+export const VERSION_CHECK_INTERVAL_MS = 60 * 60 * 1000;
+/**
+ * Hit the npm registry for the `latest` dist-tag. Metadata-only fetch —
+ * no auth, no headers beyond the default. Returns the resolved version
+ * or null on any failure (the caller writes the failure into the
+ * snapshot's `error` field).
+ *
+ * Test hook: `fetchFn` lets us mock the network without touching the
+ * global fetch.
+ */
+export async function probeLatestBeta(opts = {}) {
+    const f = opts.fetchFn ?? fetch;
+    const timeoutMs = opts.timeoutMs ?? 10_000;
+    try {
+        const res = await f(NPM_REGISTRY_URL, {
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+        if (!res.ok) {
+            return { ok: false, error: `registry_${res.status}` };
+        }
+        const json = (await res.json());
+        const tag = json["dist-tags"]?.["latest"];
+        if (typeof tag !== "string" || tag.length === 0) {
+            return { ok: false, error: "missing_latest_tag" };
+        }
+        return { ok: true, latest_beta: tag };
+    }
+    catch (err) {
+        if (err instanceof DOMException && err.name === "TimeoutError") {
+            return { ok: false, error: "timeout" };
+        }
+        return {
+            ok: false,
+            error: err instanceof TypeError
+                ? "network"
+                : `unknown:${err instanceof Error ? err.message.slice(0, 64) : String(err).slice(0, 64)}`,
+        };
+    }
+}
+/**
+ * Run one probe and persist the result. Pure orchestration: probe →
+ * write snapshot. On error, still writes a snapshot so the daemon's
+ * last attempt is observable.
+ */
+export async function runVersionCheck(opts) {
+    const now = opts.now ? opts.now() : new Date();
+    const probeOpts = {};
+    if (opts.fetchFn)
+        probeOpts.fetchFn = opts.fetchFn;
+    if (opts.timeoutMs !== undefined)
+        probeOpts.timeoutMs = opts.timeoutMs;
+    const probe = await probeLatestBeta(probeOpts);
+    const snapshot = probe.ok
+        ? {
+            installed: opts.installed,
+            latest_beta: probe.latest_beta,
+            checked_at: now.toISOString(),
+            error: null,
+        }
+        : {
+            installed: opts.installed,
+            // Preserve the last successful probe's latest_beta across failures
+            // so a transient outage cannot blank out an already-known update.
+            // Only ever null when no probe has ever succeeded.
+            latest_beta: readVersionCheck(opts.dataDir)?.latest_beta ?? null,
+            checked_at: now.toISOString(),
+            error: probe.error,
+        };
+    writeVersionCheck(opts.dataDir, snapshot);
+    return snapshot;
+}
+//# sourceMappingURL=version-check.js.map

package/dist/src/observability/version-check.js.map

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

package/dist/src/onboarding/capture-switch.d.ts

@@ -0,0 +1,20 @@
+export type SetCaptureResult = {
+    status: "on" | "off";
+} | {
+    status: "failed";
+    reason: "no_search_key" | "write_failed";
+    message: string;
+};
+/** Rewrite `capture.enabled` in config.json, after a backup of the file. */
+export declare function writeCaptureEnabled(configPath: string, enabled: boolean): void;
+/**
+ * What the app's switch runs. Turning capture on needs the search key the
+ * engine loaded: each saved session is indexed with it, and without one the
+ * engine holds the whole capture loop (see src/main.ts).
+ */
+export declare function setCapture(opts: {
+    configPath: string;
+    enabled: boolean;
+    keyPresent: boolean;
+}): SetCaptureResult;
+//# sourceMappingURL=capture-switch.d.ts.map

package/dist/src/onboarding/capture-switch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-switch.d.ts","sourceRoot":"","sources":["../../../src/onboarding/capture-switch.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,gBAAgB,GACxB;IAAE,MAAM,EAAE,IAAI,GAAG,KAAK,CAAA;CAAE,GACxB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,eAAe,GAAG,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpF,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAc9E;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,GAAG,gBAAgB,CAkBhH"}

package/dist/src/onboarding/capture-switch.js

@@ -0,0 +1,52 @@
+/**
+ * Capture on and off, as Onadit.app's Capture screen and `onadit onboard
+ * --enable-capture` set it. Only `capture.enabled` changes: the chosen
+ * sources, the worker and everything already saved stay as they are.
+ *
+ * The engine builds its capture loop once at boot (src/main.ts), so a change
+ * takes effect at the next start. The caller restarts the engine.
+ */
+import fs from "node:fs";
+import path from "node:path";
+/** Rewrite `capture.enabled` in config.json, after a backup of the file. */
+export function writeCaptureEnabled(configPath, enabled) {
+    const absolute = path.resolve(configPath);
+    const raw = fs.readFileSync(absolute, "utf8");
+    const parsed = JSON.parse(raw);
+    const capture = parsed["capture"] ?? {};
+    if (capture["enabled"] === enabled)
+        return;
+    const stamp = new Date().toISOString().replace(/[:.]/g, "-");
+    fs.writeFileSync(`${absolute}.bak.${stamp}`, raw, { encoding: "utf8", mode: 0o600 });
+    capture["enabled"] = enabled;
+    parsed["capture"] = capture;
+    const tmp = `${absolute}.tmp.${process.pid}`;
+    fs.writeFileSync(tmp, JSON.stringify(parsed, null, 2) + "\n", { encoding: "utf8", mode: 0o644 });
+    fs.renameSync(tmp, absolute);
+}
+/**
+ * What the app's switch runs. Turning capture on needs the search key the
+ * engine loaded: each saved session is indexed with it, and without one the
+ * engine holds the whole capture loop (see src/main.ts).
+ */
+export function setCapture(opts) {
+    if (opts.enabled && !opts.keyPresent) {
+        return {
+            status: "failed",
+            reason: "no_search_key",
+            message: "Capture needs search by meaning. Turn that on in Privacy first.",
+        };
+    }
+    try {
+        writeCaptureEnabled(opts.configPath, opts.enabled);
+    }
+    catch {
+        return {
+            status: "failed",
+            reason: "write_failed",
+            message: "Onadit couldn’t save this setting. Check its settings file and try again.",
+        };
+    }
+    return { status: opts.enabled ? "on" : "off" };
+}
+//# sourceMappingURL=capture-switch.js.map

package/dist/src/onboarding/capture-switch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-switch.js","sourceRoot":"","sources":["../../../src/onboarding/capture-switch.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAM7B,4EAA4E;AAC5E,MAAM,UAAU,mBAAmB,CAAC,UAAkB,EAAE,OAAgB;IACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;IAC1D,MAAM,OAAO,GAAI,MAAM,CAAC,SAAS,CAAyC,IAAI,EAAE,CAAC;IACjF,IAAI,OAAO,CAAC,SAAS,CAAC,KAAK,OAAO;QAAE,OAAO;IAE3C,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC7D,EAAE,CAAC,aAAa,CAAC,GAAG,QAAQ,QAAQ,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACrF,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;IAC7B,MAAM,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;IAC5B,MAAM,GAAG,GAAG,GAAG,QAAQ,QAAQ,OAAO,CAAC,GAAG,EAAE,CAAC;IAC7C,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACjG,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,IAAmE;IAC5F,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACrC,OAAO;YACL,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,eAAe;YACvB,OAAO,EAAE,iEAAiE;SAC3E,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,mBAAmB,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,cAAc;YACtB,OAAO,EAAE,2EAA2E;SACrF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;AACjD,CAAC"}

package/dist/src/onboarding/daemon-control.d.ts

@@ -0,0 +1,33 @@
+export declare const RIFT_LAUNCHD_LABEL = "com.getrift.daemon";
+export interface KickstartResult {
+    status: "ok" | "agent_not_loaded" | "failed";
+    /** Human-readable hint for the caller to print or include in errors. */
+    hint?: string;
+    /** Raw stderr from launchctl, when relevant. */
+    stderr?: string;
+}
+export interface KickstartOptions {
+    label?: string;
+    uid?: number;
+    /** Test-injectable spawn replacement returning {code, stderr}. */
+    runner?: (cmd: string, args: string[]) => Promise<{
+        code: number;
+        stderr: string;
+    }>;
+}
+export declare function kickstartDaemon(opts?: KickstartOptions): Promise<KickstartResult>;
+export interface WaitForHealthOptions {
+    baseUrl: string;
+    timeoutMs?: number;
+    intervalMs?: number;
+    fetchFn?: typeof fetch;
+}
+export declare function waitForHealth(opts: WaitForHealthOptions): Promise<{
+    ok: true;
+    uptimeSeconds: number;
+    voyageKeyPresent: boolean;
+} | {
+    ok: false;
+    reason: string;
+}>;
+//# sourceMappingURL=daemon-control.d.ts.map

package/dist/src/onboarding/daemon-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-control.d.ts","sourceRoot":"","sources":["../../../src/onboarding/daemon-control.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,IAAI,GAAG,kBAAkB,GAAG,QAAQ,CAAC;IAC7C,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC;QAChD,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AAED,wBAAsB,eAAe,CACnC,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,eAAe,CAAC,CA8B1B;AAmBD,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,oBAAoB,GACzB,OAAO,CACN;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,OAAO,CAAA;CAAE,GAC9D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAChC,CAiCA"}

package/dist/src/onboarding/daemon-control.js

@@ -0,0 +1,92 @@
+/**
+ * Daemon-control helpers used by `onadit onboard` (and reconfigure flows).
+ *
+ *   - `kickstartDaemon` — launchctl kickstart -k for the canonical label.
+ *     Returns ok/skipped/failed plus a hint string a caller can surface.
+ *     Best-effort: if launchd doesn't know the label yet, we surface
+ *     a hint pointing at install.sh rather than aborting onboarding.
+ *
+ *   - `waitForHealth` — polls GET /health until 200 or timeout.
+ *
+ *   - `voyageSmoke` — round-trips a tiny `/save` to confirm the daemon
+ *     can actually embed via Voyage now that the env file has been
+ *     refreshed. Onboarding only declares "cloud embedding live" after
+ *     this passes.
+ */
+import { spawn } from "node:child_process";
+export const RIFT_LAUNCHD_LABEL = "com.getrift.daemon";
+export async function kickstartDaemon(opts = {}) {
+    const label = opts.label ?? RIFT_LAUNCHD_LABEL;
+    const uid = opts.uid ?? process.getuid?.() ?? 0;
+    const target = `gui/${uid}/${label}`;
+    const runner = opts.runner ?? defaultRunner;
+    const { code, stderr } = await runner("launchctl", ["kickstart", "-k", target]);
+    if (code === 0) {
+        return { status: "ok" };
+    }
+    // launchctl prints "Could not find specified service" / exit 113
+    // when the agent isn't loaded.
+    if (/could not find/i.test(stderr) ||
+        /no such process/i.test(stderr) ||
+        code === 113) {
+        return {
+            status: "agent_not_loaded",
+            hint: "The Onadit daemon is not registered with launchd yet. Bootstrap it first " +
+                "(install.sh handles this in one step), then re-run onadit onboard.",
+            stderr,
+        };
+    }
+    return {
+        status: "failed",
+        hint: `launchctl kickstart exited ${code}.`,
+        stderr,
+    };
+}
+function defaultRunner(cmd, args) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(cmd, args, { stdio: ["ignore", "ignore", "pipe"] });
+        let stderr = "";
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk.toString("utf8");
+        });
+        child.on("error", reject);
+        child.on("close", (code) => {
+            resolve({ code: code ?? 1, stderr });
+        });
+    });
+}
+export async function waitForHealth(opts) {
+    const timeoutMs = opts.timeoutMs ?? 30_000;
+    const intervalMs = opts.intervalMs ?? 500;
+    const f = opts.fetchFn ?? fetch;
+    const deadline = Date.now() + timeoutMs;
+    let lastErr = "";
+    while (Date.now() < deadline) {
+        try {
+            const res = await f(`${opts.baseUrl}/health`, {
+                signal: AbortSignal.timeout(2_000),
+            });
+            if (res.ok) {
+                const body = (await res.json());
+                return {
+                    ok: true,
+                    uptimeSeconds: body.uptime_seconds ?? 0,
+                    voyageKeyPresent: body.voyage_key_present === true,
+                };
+            }
+            lastErr = `HTTP ${res.status}`;
+        }
+        catch (err) {
+            lastErr = err instanceof Error ? err.message : String(err);
+        }
+        await sleep(intervalMs);
+    }
+    return {
+        ok: false,
+        reason: `Daemon /health did not return 200 within ${timeoutMs}ms (last error: ${lastErr || "none"}).`,
+    };
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+//# sourceMappingURL=daemon-control.js.map

package/dist/src/onboarding/daemon-control.js.map

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

package/dist/src/onboarding/env-file.d.ts

@@ -0,0 +1,18 @@
+export interface WriteEnvFileOptions {
+    /** Absolute path to the env file (e.g., `~/.rift.env`). */
+    filePath: string;
+    /** Key to set or update (e.g., `VOYAGE_API_KEY`). */
+    key: string;
+    /** Value (raw, unquoted). */
+    value: string;
+    /** Override the timestamp source (test-injectable). */
+    now?: () => Date;
+}
+export interface WriteEnvFileResult {
+    /** True when the destination existed and we backed it up. */
+    backedUp: boolean;
+    /** Path to the backup copy when `backedUp` is true. */
+    backupPath?: string;
+}
+export declare function writeEnvFile(opts: WriteEnvFileOptions): WriteEnvFileResult;
+//# sourceMappingURL=env-file.d.ts.map

package/dist/src/onboarding/env-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-file.d.ts","sourceRoot":"","sources":["../../../src/onboarding/env-file.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,mBAAmB;IAClC,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,6DAA6D;IAC7D,QAAQ,EAAE,OAAO,CAAC;IAClB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,wBAAgB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,kBAAkB,CAkC1E"}

package/dist/src/onboarding/env-file.js

@@ -0,0 +1,89 @@
+/**
+ * Atomic env-file write with timestamped backup of any pre-existing file.
+ *
+ * Used by `onadit onboard` (initial Voyage key write) and the
+ * `--reconfigure-voyage` flow (Slice 6). Properties:
+ *
+ *   - Writes mode 0600. Re-chmods after write to defeat umask masking.
+ *   - tmp + rename within the same dir, so a partial write never lands
+ *     under the canonical path.
+ *   - When the destination already exists, a `.bak.<iso>` copy is taken
+ *     first; the path is returned so a caller can roll back on failure.
+ *   - Preserves any other key=value lines already in the file. Onboarding
+ *     should only mutate `VOYAGE_API_KEY`; other secrets the operator
+ *     hand-edited (e.g. `ANTHROPIC_API_KEY`) are kept verbatim.
+ */
+import fs from "node:fs";
+import path from "node:path";
+const KEY_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
+export function writeEnvFile(opts) {
+    if (!KEY_PATTERN.test(opts.key)) {
+        throw new Error(`Invalid env key: ${opts.key}`);
+    }
+    const dir = path.dirname(opts.filePath);
+    fs.mkdirSync(dir, { recursive: true });
+    let existingContent = "";
+    let existed = false;
+    try {
+        existingContent = fs.readFileSync(opts.filePath, "utf8");
+        existed = true;
+    }
+    catch {
+        // not present — fine
+    }
+    let backupPath;
+    if (existed) {
+        const ts = (opts.now?.() ?? new Date()).toISOString().replace(/[:.]/g, "-");
+        backupPath = `${opts.filePath}.bak.${ts}`;
+        fs.copyFileSync(opts.filePath, backupPath);
+        fs.chmodSync(backupPath, 0o600);
+    }
+    const next = upsertKey(existingContent, opts.key, opts.value);
+    const tmp = `${opts.filePath}.tmp.${process.pid}`;
+    fs.writeFileSync(tmp, next, { encoding: "utf8", mode: 0o600 });
+    fs.chmodSync(tmp, 0o600);
+    fs.renameSync(tmp, opts.filePath);
+    return existed
+        ? { backedUp: true, backupPath: backupPath }
+        : { backedUp: false };
+}
+function upsertKey(content, key, value) {
+    const lines = content.split(/\r?\n/);
+    // Drop the trailing empty element from a content ending with \n so we
+    // don't introduce a duplicate blank line on round-trip.
+    const trailing = lines.length > 0 && lines[lines.length - 1] === ""
+        ? lines.pop()
+        : undefined;
+    let replaced = false;
+    const out = lines.map((line) => {
+        const parsed = parseLine(line);
+        if (parsed && parsed.key === key) {
+            replaced = true;
+            return `${key}=${value}`;
+        }
+        return line;
+    });
+    if (!replaced) {
+        out.push(`${key}=${value}`);
+    }
+    if (trailing !== undefined)
+        out.push("");
+    // Always end with a newline.
+    return out.join("\n").replace(/\n*$/, "\n");
+}
+function parseLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#"))
+        return null;
+    const withoutExport = trimmed.startsWith("export ")
+        ? trimmed.slice("export ".length).trim()
+        : trimmed;
+    const eq = withoutExport.indexOf("=");
+    if (eq <= 0)
+        return null;
+    const key = withoutExport.slice(0, eq).trim();
+    if (!KEY_PATTERN.test(key))
+        return null;
+    return { key };
+}
+//# sourceMappingURL=env-file.js.map

package/dist/src/onboarding/env-file.js.map

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

package/dist/src/onboarding/search-by-meaning.d.ts

@@ -0,0 +1,35 @@
+import { validateVoyageKey } from "./voyage-validate.js";
+export declare const DEFAULT_KEY_RELAY_URL = "https://rift-relay.clem-rog.workers.dev";
+export type EnableSearchResult = {
+    status: "already_on";
+} | {
+    status: "on";
+} | {
+    status: "failed";
+    reason: "capacity" | "unavailable" | "network" | "key_rejected";
+    message: string;
+};
+export interface EnableSearchDeps {
+    /** Absolute path to config.json; the state file sits beside it. */
+    configPath: string;
+    /** Whether the running engine already has a key. */
+    keyPresent: boolean;
+    envPath?: string;
+    relayUrl?: string;
+    fetchFn?: typeof fetch;
+    validate?: typeof validateVoyageKey;
+    now?: () => Date;
+}
+export declare function enableSearchByMeaning(deps: EnableSearchDeps): Promise<EnableSearchResult>;
+/** Whether the archive still waits for its first real embeddings. */
+export declare function backfillPending(configPath: string): boolean;
+/** Call once the re-embed job is queued, so the next boot doesn't repeat it. */
+export declare function clearBackfillPending(configPath: string): void;
+/**
+ * A key the user pasted was checked against Voyage's own API, so drop a
+ * Onadit-provided endpoint (Atlas) from config.json. Model and output size
+ * stay: Voyage serves the same models, so stored vectors still match.
+ * Returns whether anything changed.
+ */
+export declare function useVoyageOwnEndpoint(configPath: string, now?: Date): boolean;
+//# sourceMappingURL=search-by-meaning.d.ts.map

package/dist/src/onboarding/search-by-meaning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-by-meaning.d.ts","sourceRoot":"","sources":["../../../src/onboarding/search-by-meaning.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,eAAO,MAAM,qBAAqB,4CAA4C,CAAC;AAI/E,MAAM,MAAM,kBAAkB,GAC1B;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,GACxB;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,GAChB;IACE,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,EAAE,UAAU,GAAG,aAAa,GAAG,SAAS,GAAG,cAAc,CAAC;IAChE,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,iBAAiB,CAAC;IACpC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAiFD,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA6D/F;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAG7D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,OAAO,CAYxF"}