onadit 0.0.1 → 1.0.0

package/dist/src/cli/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../src/cli/output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAE7C;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE5C;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEhD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAc1E;AAED,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAE3E"}

package/dist/src/cli/output.js

@@ -0,0 +1,34 @@
+export function printJson(data) {
+    process.stdout.write(JSON.stringify(data, null, 2) + "\n");
+}
+export function printText(text) {
+    process.stdout.write(text + "\n");
+}
+export function printError(message) {
+    process.stderr.write(`Error: ${message}\n`);
+}
+export function printJobResult(job, timedOut) {
+    if (timedOut) {
+        process.stderr.write(`Job ${job.id} still ${job.status} after timeout.\n`);
+    }
+    else if (job.status === "completed") {
+        process.stdout.write(`Job ${job.id} completed.\n`);
+    }
+    else if (job.status === "failed") {
+        process.stderr.write(`Job ${job.id} failed${job.error ? `: ${job.error}` : "."}\n`);
+    }
+    else if (job.status === "cancelled") {
+        process.stderr.write(`Job ${job.id} was cancelled.\n`);
+    }
+    else if (job.status === "interrupted") {
+        process.stderr.write(`Job ${job.id} was interrupted (daemon restarted). Check job lineage.\n`);
+    }
+    else {
+        process.stdout.write(`Job ${job.id}: ${job.status}\n`);
+    }
+}
+/** True if the job ended in a non-success state. */
+export function isJobFailure(job, timedOut) {
+    return timedOut || job.status === "failed" || job.status === "cancelled" || job.status === "interrupted";
+}
+//# sourceMappingURL=output.js.map

package/dist/src/cli/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../../src/cli/output.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAkB,EAAE,QAAiB;IAClE,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,EAAE,UAAU,GAAG,CAAC,MAAM,mBAAmB,CAAC,CAAC;IAC7E,CAAC;SAAM,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,EAAE,eAAe,CAAC,CAAC;IACrD,CAAC;SAAM,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,EAAE,UAAU,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACtF,CAAC;SAAM,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,EAAE,mBAAmB,CAAC,CAAC;IACzD,CAAC;SAAM,IAAI,GAAG,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;QACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,EAAE,2DAA2D,CAAC,CAAC;IACjG,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;IACzD,CAAC;AACH,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,YAAY,CAAC,GAAkB,EAAE,QAAiB;IAChE,OAAO,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW,IAAI,GAAG,CAAC,MAAM,KAAK,aAAa,CAAC;AAC3G,CAAC"}

package/dist/src/cli/postinstall-menubar.d.ts

@@ -0,0 +1,38 @@
+import { runMcpRefresh } from "./commands/mcp-install.js";
+import { installMenuBar } from "./commands/menubar.js";
+type PostinstallMenuBarInstaller = () => ReturnType<typeof installMenuBar>;
+type PostinstallOutput = {
+    write(chunk: string): unknown;
+};
+/**
+ * The install prefix as npm exposes it during a lifecycle script — the env NAME
+ * varies and a temp global install may expose only some of them. Empirically
+ * (local lifecycle probe) a temp install set `NPM_CONFIG_PREFIX` (a passed-through
+ * env override) and `npm_config_global_prefix` (npm's resolved global prefix) but
+ * NOT `npm_config_prefix` — so keying off `npm_config_prefix` alone lets the
+ * temp-prefix guard silently fail. Return the first non-empty of the three.
+ */
+export declare function resolveInstallPrefix(env: NodeJS.ProcessEnv): string | undefined;
+/**
+ * Is this global install going into a TEMP/throwaway prefix (tarball verify,
+ * packed-install test, CI sandbox) rather than a real user prefix? Such an
+ * install must NOT run the menu hook: `installMenuBar` targets the user's REAL
+ * `~/Library/.../SwiftBar/Plugins` regardless of the install prefix, so a
+ * throwaway install would reach out and mutate the real menu surface (the leak
+ * PR #60 band-aided with RIFT_SKIP_POSTINSTALL_MENUBAR). We key off the resolved
+ * install prefix (see `resolveInstallPrefix`) resolving under a known temp root —
+ * durable and explicit, so a test no longer has to remember the skip env.
+ */
+export declare function isTempInstallPrefix(prefix: string | undefined, tmpDir?: string): boolean;
+export declare function shouldRunPostinstallMenuBar(env?: NodeJS.ProcessEnv): boolean;
+export declare function runPostinstallMenuBar(install?: PostinstallMenuBarInstaller, output?: PostinstallOutput): void;
+/**
+ * The same bridge for agent connections: an update started by the previous
+ * version's `update` command never calls this version's refresh, and the
+ * connections it leaves behind still carry the earlier server and tool names.
+ * `runMcpRefresh` rewrites the ones that exist, creates none, and does nothing
+ * when npm runs as root.
+ */
+export declare function runPostinstallRefresh(refresh?: typeof runMcpRefresh, output?: PostinstallOutput): void;
+export {};
+//# sourceMappingURL=postinstall-menubar.d.ts.map

package/dist/src/cli/postinstall-menubar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postinstall-menubar.d.ts","sourceRoot":"","sources":["../../../src/cli/postinstall-menubar.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,KAAK,2BAA2B,GAAG,MAAM,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC3E,KAAK,iBAAiB,GAAG;IAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAE3D;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,MAAM,GAAG,SAAS,CAUpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,GAAE,MAAoB,GAC3B,OAAO,CAeT;AAED,wBAAgB,2BAA2B,CACzC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAWT;AAED,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,2BAA4C,EACrD,MAAM,GAAE,iBAAkC,GACzC,IAAI,CA4BN;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,OAAO,aAA6B,EAC7C,MAAM,GAAE,iBAAkC,GACzC,IAAI,CAaN"}

package/dist/src/cli/postinstall-menubar.js

@@ -0,0 +1,139 @@
+/**
+ * Best-effort global-install hook for the SwiftBar menu plugin.
+ *
+ * Why this exists in addition to `scripts/install.sh` and `onadit update`:
+ * friends already on beta.13 will run the beta.13 `onadit update` command.
+ * That old command can install the beta.14 tarball, but it cannot call the
+ * new beta.14 menu-refresh code after npm finishes. npm's postinstall hook
+ * runs from the newly-installed package, so it bridges that first update.
+ *
+ * Local developer installs skip this by default; only global npm installs
+ * run it. Failures are non-fatal because the CLI/daemon install is more
+ * important than the ambient menu surface.
+ */
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { defaultConfigPath } from "./default-config-path.js";
+import { runMcpRefresh } from "./commands/mcp-install.js";
+import { MCP_ENTRY_FILE } from "../mcp/names.js";
+import { installMenuBar } from "./commands/menubar.js";
+/**
+ * The install prefix as npm exposes it during a lifecycle script — the env NAME
+ * varies and a temp global install may expose only some of them. Empirically
+ * (local lifecycle probe) a temp install set `NPM_CONFIG_PREFIX` (a passed-through
+ * env override) and `npm_config_global_prefix` (npm's resolved global prefix) but
+ * NOT `npm_config_prefix` — so keying off `npm_config_prefix` alone lets the
+ * temp-prefix guard silently fail. Return the first non-empty of the three.
+ */
+export function resolveInstallPrefix(env) {
+    for (const key of [
+        "npm_config_prefix",
+        "NPM_CONFIG_PREFIX",
+        "npm_config_global_prefix",
+    ]) {
+        const value = env[key];
+        if (value && value.trim())
+            return value;
+    }
+    return undefined;
+}
+/**
+ * Is this global install going into a TEMP/throwaway prefix (tarball verify,
+ * packed-install test, CI sandbox) rather than a real user prefix? Such an
+ * install must NOT run the menu hook: `installMenuBar` targets the user's REAL
+ * `~/Library/.../SwiftBar/Plugins` regardless of the install prefix, so a
+ * throwaway install would reach out and mutate the real menu surface (the leak
+ * PR #60 band-aided with RIFT_SKIP_POSTINSTALL_MENUBAR). We key off the resolved
+ * install prefix (see `resolveInstallPrefix`) resolving under a known temp root —
+ * durable and explicit, so a test no longer has to remember the skip env.
+ */
+export function isTempInstallPrefix(prefix, tmpDir = os.tmpdir()) {
+    if (!prefix)
+        return false;
+    const resolved = path.resolve(prefix);
+    // macOS symlinks /tmp and /var → /private/*; cover both spellings so a
+    // `mktemp -d` under either form is recognized.
+    const tempRoots = [
+        tmpDir,
+        "/tmp",
+        "/private/tmp",
+        "/var/folders",
+        "/private/var/folders",
+    ].map((root) => path.resolve(root));
+    return tempRoots.some((root) => resolved === root || resolved.startsWith(`${root}${path.sep}`));
+}
+export function shouldRunPostinstallMenuBar(env = process.env) {
+    if (env.RIFT_SKIP_POSTINSTALL_MENUBAR === "1")
+        return false;
+    if (env.RIFT_POSTINSTALL_MENUBAR === "1")
+        return true;
+    const global = env.npm_config_global === "true" || env.npm_config_location === "global";
+    if (!global)
+        return false;
+    // A global install into a temp prefix must not touch the real SwiftBar dir.
+    // Resolve the prefix across the env names npm actually exposes, not just
+    // the lowercase `npm_config_prefix` (which a temp install may not set).
+    if (isTempInstallPrefix(resolveInstallPrefix(env)))
+        return false;
+    return true;
+}
+export function runPostinstallMenuBar(install = installMenuBar, output = process.stdout) {
+    try {
+        const result = install();
+        if (result.skipped) {
+            output.write(`Onadit menu bar skipped: ${result.reason ?? "not available"}\n`);
+            return;
+        }
+        if (result.menuVisible) {
+            output.write("Onadit menu bar installed — the Onadit icon is in your menu bar.\n");
+        }
+        else if (result.recovery) {
+            // The plugin is installed but the icon is not showing yet — SwiftBar is
+            // missing, or present-but-unlaunchable, or we could not point it at the
+            // plugin folder. Make that visible (never a silent "installed") and lead
+            // with the case-accurate headline, then the one next step.
+            output.write(result.swiftBarDetected
+                ? "Onadit menu bar installed, but the icon isn't showing yet.\n"
+                : "Onadit menu bar installed, but SwiftBar is not present to show it.\n");
+            output.write(`  ${result.recovery}\n`);
+        }
+        else {
+            output.write("Onadit menu bar installed.\n");
+        }
+    }
+    catch (err) {
+        output.write(`Onadit menu bar install skipped: ${err instanceof Error ? err.message : String(err)}\n`);
+    }
+}
+/**
+ * The same bridge for agent connections: an update started by the previous
+ * version's `update` command never calls this version's refresh, and the
+ * connections it leaves behind still carry the earlier server and tool names.
+ * `runMcpRefresh` rewrites the ones that exist, creates none, and does nothing
+ * when npm runs as root.
+ */
+export function runPostinstallRefresh(refresh = runMcpRefresh, output = process.stdout) {
+    try {
+        // .../dist/src/cli/postinstall-menubar.js → .../dist/src/mcp/<entry file>
+        const mcpServerPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "mcp", MCP_ENTRY_FILE);
+        refresh({
+            configPath: defaultConfigPath(),
+            mcpServerPath,
+            nodePath: process.execPath,
+            emit: (line) => output.write(`${line}\n`),
+        });
+    }
+    catch (err) {
+        output.write(`Onadit connection refresh skipped: ${err instanceof Error ? err.message : String(err)}\n`);
+    }
+}
+if (shouldRunPostinstallMenuBar()) {
+    runPostinstallMenuBar();
+    // The installer sets this and refreshes after the new service has answered:
+    // if it has to put the earlier package back, the connections must still
+    // point at it.
+    if (process.env.RIFT_SKIP_POSTINSTALL_REFRESH !== "1")
+        runPostinstallRefresh();
+}
+//# sourceMappingURL=postinstall-menubar.js.map

package/dist/src/cli/postinstall-menubar.js.map

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

package/dist/src/cli/status/friend-header.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Pure renderer for the `onadit status` friend-readable header.
+ *
+ * Inputs are everything the friend's machine can answer locally
+ * (Voyage key last 4 read from `~/.rift.env`, MCP-client config presence
+ * detected by checking each known path) plus the `/status/friend`
+ * payload from the daemon. Output is plain text, one line per row,
+ * matching the shape in LAUNCH §12 / friend-beta plan §Slice 6.
+ *
+ * No `~/`, no absolute paths, no key bytes (last 4 only). Sensitive
+ * substrings stay in the renderer's input contract — the caller is
+ * responsible for never passing a full Voyage key into `voyageLast4`.
+ */
+import type { FriendStatusOnboarding, FriendStatusPayload } from "../../server/routes/friend-status.js";
+export interface McpClientStatus {
+    /** Display label (e.g., "claude-desktop"). */
+    client: string;
+    /** True when the client config has a `rift` server entry. */
+    installed: boolean;
+}
+export interface RenderHeaderInput {
+    status: FriendStatusPayload | null;
+    /** Last 4 chars of the Voyage key (read from `~/.rift.env`), or null. */
+    voyageLast4: string | null;
+    /** MCP-client install presence, in display order. */
+    mcpClients: McpClientStatus[];
+    /**
+     * SwiftBar presence + menu-plugin health — null when the question does not
+     * apply (non-macOS) or was not probed. Renders a line when SwiftBar is absent
+     * OR when it is present but the plugin is dangling; a healthy/unprobed install
+     * stays quiet, matching `onadit doctor`. `pluginDangling` is optional so older
+     * callers that only know presence still type-check.
+     */
+    swiftBar?: {
+        installed: boolean;
+        pluginDangling?: boolean;
+    } | null;
+    /**
+     * Local AI desktop apps detected on the friend's Mac (CLI-side, like
+     * `mcpClients`/`swiftBar`). Drives an honest "those app chats aren't
+     * auto-captured" line. Optional/absent → no line (older callers, non-macOS, or
+     * none installed), so users without these apps get no extra noise.
+     */
+    localAiApps?: {
+        claudeDesktop: boolean;
+        chatgptApp: boolean;
+    } | null;
+    /** Clock injection for tests; defaults to Date.now(). */
+    now?: () => number;
+}
+export declare function renderFriendHeader(input: RenderHeaderInput): string[];
+export declare function formatAge(iso: string, now: number): string;
+/**
+ * Render the `time_to_first_useful_recall` line. Returns null when the
+ * state is `hidden` so the caller can drop the line entirely — a fresh
+ * post-onboard install should not advertise a metric it has not yet
+ * earned the right to display.
+ */
+export declare function renderOnboardingLine(onboarding: FriendStatusOnboarding | undefined, now: number): string | null;
+export declare function formatDuration(seconds: number): string;
+//# sourceMappingURL=friend-header.d.ts.map

package/dist/src/cli/status/friend-header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"friend-header.d.ts","sourceRoot":"","sources":["../../../../src/cli/status/friend-header.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EACV,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,sCAAsC,CAAC;AAK9C,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACnC,yEAAyE;IACzE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,qDAAqD;IACrD,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACnE;;;;;OAKG;IACH,WAAW,CAAC,EAAE;QAAE,aAAa,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACrE,yDAAyD;IACzD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,EAAE,CA+GrE;AAgoBD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAI1D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,sBAAsB,GAAG,SAAS,EAC9C,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,IAAI,CAsBf;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAUtD"}