@fargowealth/fargo-ai-cli 0.1.0 → 0.2.1

package/README.md

@@ -4,6 +4,7 @@
 
 ```sh
 npm install --global @fargowealth/fargo-ai-cli
+fargo workbuddy install --open-browser=always --output=jsonl
 fargo auth device --open-browser=always --output=jsonl
 fargo auth status --output=json
 fargo mcp serve

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fargowealth/fargo-ai-cli",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Fargo AI authentication and stdio MCP bridge for WorkBuddy",
   "type": "module",
   "bin": {

package/src/cli.mjs

@@ -2,6 +2,7 @@ import { createCredentialStore } from "./credential-store.mjs";
 import { currentCredential, openBrowser, pollDeviceAuthorization, startDeviceAuthorization } from "./auth.mjs";
 import { CLI_VERSION } from "./constants.mjs";
 import { runMcpProxy } from "./mcp-proxy.mjs";
+import { installWorkBuddyMcp } from "./workbuddy-install.mjs";
 
 export async function runCli(args, options = {}) {
   const stdout = options.stdout ?? process.stdout;
@@ -13,19 +14,7 @@ export async function runCli(args, options = {}) {
       return;
     }
     if (args[0] === "auth" && args[1] === "device") {
-      const device = await startDeviceAuthorization(options);
-      stdout.write(`${JSON.stringify({
-        type: "device_authorization",
-        user_code: device.user_code,
-        verification_uri: device.verification_uri,
-        verification_uri_complete: device.verification_uri_complete,
-        expires_in: device.expires_in,
-        interval: device.interval
-      })}\n`);
-      const browserMode = optionValue(args, "--open-browser") ?? "auto";
-      if (browserMode !== "never" && options.openBrowser !== false) (options.browserOpener ?? openBrowser)(device.verification_uri_complete || device.verification_uri);
-      await pollDeviceAuthorization(device, store, options);
-      stdout.write(`${JSON.stringify({ type: "authorization_complete", logged_in: true, method: "oauth" })}\n`);
+      await authorizeDevice(args, stdout, store, options);
       return;
     }
     if (args[0] === "auth" && args[1] === "status") {
@@ -43,7 +32,21 @@ export async function runCli(args, options = {}) {
       await runMcpProxy(store, options);
       return;
     }
-    throw new Error("Usage: fargo auth device|status|logout | fargo mcp serve | fargo version");
+    if (args[0] === "workbuddy" && args[1] === "install") {
+      let credential = await store.load();
+      if (credential) {
+        try {
+          credential = await currentCredential(store, options);
+        } catch {
+          await store.clear();
+          credential = undefined;
+        }
+      }
+      if (!credential?.refresh_token) await authorizeDevice(args, stdout, store, options);
+      stdout.write(`${JSON.stringify(await installWorkBuddyMcp(options))}\n`);
+      return;
+    }
+    throw new Error("Usage: fargo auth device|status|logout | fargo workbuddy install | fargo mcp serve | fargo version");
   } catch (error) {
     stderr.write(`fargo: ${error instanceof Error ? error.message : "unknown error"}\n`);
     if (options.throwOnError) throw error;
@@ -51,6 +54,22 @@ export async function runCli(args, options = {}) {
   }
 }
 
+async function authorizeDevice(args, stdout, store, options) {
+  const device = await startDeviceAuthorization(options);
+  stdout.write(`${JSON.stringify({
+    type: "device_authorization",
+    user_code: device.user_code,
+    verification_uri: device.verification_uri,
+    verification_uri_complete: device.verification_uri_complete,
+    expires_in: device.expires_in,
+    interval: device.interval
+  })}\n`);
+  const browserMode = optionValue(args, "--open-browser") ?? "auto";
+  if (browserMode !== "never" && options.openBrowser !== false) (options.browserOpener ?? openBrowser)(device.verification_uri_complete || device.verification_uri);
+  await pollDeviceAuthorization(device, store, options);
+  stdout.write(`${JSON.stringify({ type: "authorization_complete", logged_in: true, method: "oauth" })}\n`);
+}
+
 function optionValue(args, name) {
   const inline = args.find((value) => value.startsWith(`${name}=`));
   if (inline) return inline.slice(name.length + 1);

package/src/constants.mjs

@@ -1,4 +1,4 @@
-export const CLI_VERSION = "0.1.0";
+export const CLI_VERSION = "0.2.1";
 export const DEVICE_CODE_GRANT_TYPE = "urn:ietf:params:oauth:grant-type:device_code";
 export const DEFAULT_AUTH_URL = "https://auth.fargowealth.app";
 export const DEFAULT_MCP_URL = "https://mcp.fargowealth.app/mcp";

package/src/workbuddy-install.mjs

@@ -0,0 +1,73 @@
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { CLI_VERSION } from "./constants.mjs";
+
+const PACKAGE_NAME = "@fargowealth/fargo-ai-cli";
+
+export async function installWorkBuddyMcp(options = {}) {
+  const configPath = options.configPath
+    ?? process.env.FARGO_WORKBUDDY_MCP_CONFIG
+    ?? defaultWorkBuddyConfigPath();
+  const packageSpec = `${PACKAGE_NAME}@${options.packageVersion ?? CLI_VERSION}`;
+  const config = await readConfig(configPath);
+  const nextServer = {
+    type: "stdio",
+    command: "npx",
+    args: ["-y", packageSpec, "mcp", "serve"],
+    timeout: 60000
+  };
+  const previousServer = config.mcpServers?.["fargo-ai"];
+  const changed = JSON.stringify(previousServer) !== JSON.stringify(nextServer);
+
+  if (changed) {
+    config.mcpServers = { ...(config.mcpServers ?? {}), "fargo-ai": nextServer };
+    await writeConfig(configPath, config);
+  }
+
+  return {
+    type: "workbuddy_installation_complete",
+    installed: true,
+    changed,
+    config_path: configPath,
+    server_name: "fargo-ai",
+    package: packageSpec,
+    trust_required: true,
+    next_action: "Open WorkBuddy MCP management, trust and enable fargo-ai, then reload MCP or start a new task."
+  };
+}
+
+export function defaultWorkBuddyConfigPath(homeDirectory = homedir()) {
+  return join(homeDirectory, ".workbuddy-ai", "mcp.json");
+}
+
+async function readConfig(configPath) {
+  let text;
+  try {
+    text = await readFile(configPath, "utf8");
+  } catch (error) {
+    if (error?.code === "ENOENT") return {};
+    throw error;
+  }
+  if (!text.trim()) return {};
+  let parsed;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    throw new Error(`WorkBuddy MCP config is not valid JSON: ${configPath}`);
+  }
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error(`WorkBuddy MCP config must contain a JSON object: ${configPath}`);
+  }
+  if (parsed.mcpServers !== undefined && (!parsed.mcpServers || typeof parsed.mcpServers !== "object" || Array.isArray(parsed.mcpServers))) {
+    throw new Error(`WorkBuddy mcpServers must be a JSON object: ${configPath}`);
+  }
+  return parsed;
+}
+
+async function writeConfig(configPath, config) {
+  await mkdir(dirname(configPath), { recursive: true });
+  const temporaryPath = `${configPath}.${process.pid}.${Date.now()}.tmp`;
+  await writeFile(temporaryPath, `${JSON.stringify(config, null, 2)}\n`, { encoding: "utf8", mode: 0o600, flag: "wx" });
+  await rename(temporaryPath, configPath);
+}