hearth-dash 1.0.1 → 1.1.1

package/cli/commands/deploy.js

@@ -1,216 +1,262 @@
-import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
-import { join } from "node:path";
-import { homedir } from "node:os";
-import { randomBytes } from "node:crypto";
-import { getPackageRoot, getNodeMajor } from "../lib/platform.js";
-import { ask, confirm, password } from "../lib/prompts.js";
-import {
-  execWrangler, parseD1CreateOutput, parseDeployOutput,
-  checkWranglerAuth, wranglerLogin, setSecret, executeSchema, listD1Databases,
-} from "../lib/wrangler.js";
-import { banner, step, bold, dim, cyan, green, yellow, red, success, fail, warn, info, spinner } from "../lib/ui.js";
-
-const TOTAL_STEPS = 6;
-const CONFIG_DIR = join(homedir(), ".hearth-dash");
-const CONFIG_PATH = join(CONFIG_DIR, "config.json");
-
-function saveConfig(data) {
-  mkdirSync(CONFIG_DIR, { recursive: true });
-  let existing = {};
-  if (existsSync(CONFIG_PATH)) {
-    try { existing = JSON.parse(readFileSync(CONFIG_PATH, "utf-8")); } catch {}
-  }
-  const merged = { ...existing, ...data };
-  writeFileSync(CONFIG_PATH, JSON.stringify(merged, null, 2) + "\n", "utf-8");
-  return merged;
-}
-
-function genSecret() {
-  return randomBytes(16).toString("base64url");
-}
-
-async function createD1OrReuse(dbName, cwd) {
-  const result = await execWrangler(["d1", "create", dbName], cwd);
-  if (result.code === 0) return parseD1CreateOutput(result);
-  const combined = result.stdout + result.stderr;
-  if (combined.includes("already exists") || combined.includes("already a database")) {
-    warn(`Database "${dbName}" already exists. Looking up ID...`);
-    const databases = await listD1Databases(cwd);
-    const db = databases.find((d) => d.name === dbName);
-    if (db) { info(`Found: ${db.uuid}`); return db.uuid; }
-    fail("Could not find existing database ID.");
-    return null;
-  }
-  fail(`Failed to create database: ${combined}`);
-  return null;
-}
-
-export default async function deployCommand(args) {
-  banner();
-  console.log(bold("  Full Cloudflare Deployment\n"));
-
-  // ── Step 1: Preflight ────────────────────────────────────
-
-  step(1, TOTAL_STEPS, "Preflight checks");
-
-  const nodeMajor = getNodeMajor();
-  if (nodeMajor < 18) { fail(`Node.js ${nodeMajor} detected. Need >= 18.`); process.exit(1); }
-  success(`Node.js ${process.version}`);
-
-  const wranglerCheck = await execWrangler(["--version"], ".");
-  if (wranglerCheck.code !== 0) {
-    fail("Wrangler not found. Install: npm install -g wrangler");
-    process.exit(1);
-  }
-  success(`Wrangler installed`);
-
-  const authed = await checkWranglerAuth(".");
-  if (!authed) {
-    warn("Not logged into Cloudflare. Opening browser...");
-    const loginOk = await wranglerLogin(".");
-    if (!loginOk) { fail("Cloudflare login failed."); process.exit(1); }
-  }
-  success("Cloudflare authenticated");
-
-  // ── Step 2: Configuration ────────────────────────────────
-
-  step(2, TOTAL_STEPS, "Configuration");
-
-  const partner1 = await ask("  Partner 1 name", "Partner 1");
-  const partner2 = await ask("  Partner 2 name (or AI name)", "AI");
-  const dashPassword = await password("  Dashboard password");
-  if (!dashPassword) { fail("Password is required."); process.exit(1); }
-  const mcpSecret = genSecret();
-  success("MCP secret generated");
-
-  console.log();
-  info("Weather requires a free OpenWeatherMap API key.");
-  info("Get one at: https://openweathermap.org/api");
-  const weatherKey = await ask("  OpenWeatherMap API key (or skip)");
-  let weatherLat = "", weatherLon = "";
-  if (weatherKey) {
-    info("Find your coordinates at: https://www.latlong.net");
-    weatherLat = await ask("  Latitude (e.g. 51.5074)", "51.5074");
-    weatherLon = await ask("  Longitude (e.g. -0.1278)", "-0.1278");
-  }
-
-  // ── Step 3: Create D1 database ───────────────────────────
-
-  step(3, TOTAL_STEPS, "Creating D1 database");
-
-  const pkgRoot = getPackageRoot();
-  const deployDir = join(CONFIG_DIR, "deploy");
-  mkdirSync(deployDir, { recursive: true });
-
-  // Copy worker files to deploy dir
-  const s1 = spinner("Copying source files");
-  for (const file of ["worker.js", "schema.sql", "wrangler.toml"]) {
-    const src = join(pkgRoot, file);
-    if (!existsSync(src)) { s1.fail(`Missing: ${file}`); process.exit(1); }
-    writeFileSync(join(deployDir, file), readFileSync(src, "utf-8"), "utf-8");
-  }
-  s1.stop("Source files copied");
-
-  const s2 = spinner("Creating D1 database");
-  const dbId = await createD1OrReuse("hearth-dash-db", deployDir);
-  if (!dbId) { s2.fail("D1 creation failed"); process.exit(1); }
-  s2.stop(`D1 database ready: ${dbId.substring(0, 8)}...`);
-
-  // ── Step 4: Create R2 bucket ─────────────────────────────
-
-  step(4, TOTAL_STEPS, "Creating R2 bucket");
-
-  const s3 = spinner("Creating R2 bucket");
-  const r2Result = await execWrangler(["r2", "bucket", "create", "hearth-dash-photos"], deployDir);
-  if (r2Result.code !== 0) {
-    const combined = r2Result.stdout + r2Result.stderr;
-    if (combined.includes("already exists")) {
-      s3.stop("R2 bucket already exists");
-    } else {
-      s3.fail(`R2 creation failed: ${combined}`);
-      process.exit(1);
-    }
-  } else {
-    s3.stop("R2 bucket created");
-  }
-
-  // Patch wrangler.toml with real values
-  let toml = readFileSync(join(deployDir, "wrangler.toml"), "utf-8");
-  toml = toml.replace("YOUR_D1_DATABASE_ID", dbId);
-  toml = toml.replace('PARTNER_1 = "Partner 1"', `PARTNER_1 = "${partner1}"`);
-  toml = toml.replace('PARTNER_2 = "Partner 2"', `PARTNER_2 = "${partner2}"`);
-  if (weatherLat) {
-    toml = toml.replace('# WEATHER_LAT = "52.5726"', `WEATHER_LAT = "${weatherLat}"`);
-    toml = toml.replace('# WEATHER_LON = "-0.2405"', `WEATHER_LON = "${weatherLon}"`);
-  }
-  writeFileSync(join(deployDir, "wrangler.toml"), toml, "utf-8");
-
-  // ── Step 5: Deploy worker + set secrets ──────────────────
-
-  step(5, TOTAL_STEPS, "Deploying worker");
-
-  const s4 = spinner("Setting secrets");
-  await setSecret("DASHBOARD_PASSWORD", dashPassword, deployDir);
-  await setSecret("MCP_SECRET", mcpSecret, deployDir);
-  if (weatherKey) await setSecret("WEATHER_API_KEY", weatherKey, deployDir);
-  s4.stop("Secrets configured");
-
-  const s5 = spinner("Deploying to Cloudflare Workers");
-  const deployResult = await execWrangler(["deploy"], deployDir);
-  if (deployResult.code !== 0) {
-    s5.fail("Deploy failed");
-    console.error(deployResult.stderr || deployResult.stdout);
-    process.exit(1);
-  }
-  const workerUrl = parseDeployOutput(deployResult);
-  s5.stop(`Deployed: ${workerUrl}`);
-
-  // Init schema
-  const s6 = spinner("Initializing database schema");
-  const schemaResult = await executeSchema("hearth-dash-db", join(deployDir, "schema.sql"), deployDir);
-  if (!schemaResult.ok) {
-    s6.fail("Schema init failed: " + (schemaResult.error || "unknown error"));
-    warn("You can retry manually: npx wrangler d1 execute hearth-dash-db --remote --file schema.sql");
-  } else {
-    s6.stop("Database schema initialized");
-  }
-
-  // ── Step 6: Save config + print results ──────────────────
-
-  step(6, TOTAL_STEPS, "Finishing up");
-
-  const config = saveConfig({
-    workerUrl,
-    mcpSecret,
-    partner1,
-    partner2,
-    dbId,
-    deployedAt: new Date().toISOString(),
-  });
-
-  const mcpUrl = workerUrl + "/mcp/" + mcpSecret;
-
-  console.log(`
-${green(bold("  Done!"))} Your dashboard is live.
-
-  ${bold("Dashboard:")}  ${cyan(workerUrl)}
-  ${bold("Password:")}   ${dim("(the one you just set)")}
-
-  ${bold("MCP Endpoint:")}
-  ${dim(mcpUrl)}
-
-  ${bold("MCP Config")} (add to Claude Code ${dim("~/.claude.json")} or Claude Desktop):
-${dim("  {")}
-${dim('    "mcpServers": {')}
-${dim('      "hearth-dash": {')}
-${dim('        "url": "' + mcpUrl + '"')}
-${dim("      }")}
-${dim("    }")}
-${dim("  }")}
-
-  ${bold("Connector URL")} (for Claude.ai mobile):
-  ${cyan(mcpUrl)}
-
-  ${dim("Config saved to: " + CONFIG_PATH)}
-`);
-}
+import { readFileSync, writeFileSync, mkdirSync, existsSync, chmodSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { getPackageRoot, getNodeMajor } from "../lib/platform.js";
+import { ask, confirm, password } from "../lib/prompts.js";
+import {
+  execWrangler, execCommand, parseD1CreateOutput, parseDeployOutput, parseKvCreateOutput,
+  checkWranglerAuth, wranglerLogin, setSecret, executeSchema, listD1Databases, listKvNamespaces,
+} from "../lib/wrangler.js";
+import { banner, step, bold, dim, cyan, green, yellow, red, success, fail, warn, info, spinner } from "../lib/ui.js";
+
+const TOTAL_STEPS = 6;
+const CONFIG_DIR = join(homedir(), ".hearth-dash");
+const CONFIG_PATH = join(CONFIG_DIR, "config.json");
+
+function saveConfig(data) {
+  mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
+  let existing = {};
+  if (existsSync(CONFIG_PATH)) {
+    try { existing = JSON.parse(readFileSync(CONFIG_PATH, "utf-8")); } catch {}
+  }
+  const merged = { ...existing, ...data };
+  delete merged.mcpSecret;
+  writeFileSync(CONFIG_PATH, JSON.stringify(merged, null, 2) + "\n", { encoding: "utf-8", mode: 0o600 });
+  try { chmodSync(CONFIG_PATH, 0o600); } catch {}
+  return merged;
+}
+
+async function createD1OrReuse(dbName, cwd) {
+  const result = await execWrangler(["d1", "create", dbName], cwd);
+  if (result.code === 0) return parseD1CreateOutput(result);
+  const combined = result.stdout + result.stderr;
+  if (combined.includes("already exists") || combined.includes("already a database")) {
+    warn(`Database "${dbName}" already exists. Looking up ID...`);
+    const databases = await listD1Databases(cwd);
+    const db = databases.find((d) => d.name === dbName);
+    if (db) { info(`Found: ${db.uuid}`); return db.uuid; }
+    fail("Could not find existing database ID.");
+    return null;
+  }
+  fail(`Failed to create database: ${combined}`);
+  return null;
+}
+
+async function createKvOrReuse(title, cwd) {
+  const existing = await listKvNamespaces(cwd);
+  const match = existing.find(namespace => namespace.title === title);
+  if (match) { info(`Found OAuth namespace: ${match.id}`); return match.id; }
+  const result = await execWrangler(["kv", "namespace", "create", title], cwd);
+  if (result.code === 0) return parseKvCreateOutput(result);
+  fail(`Failed to create OAuth KV namespace: ${result.stderr || result.stdout}`);
+  return null;
+}
+
+export default async function deployCommand(args) {
+  banner();
+  console.log(bold("  Full Cloudflare Deployment\n"));
+
+  // ── Step 1: Preflight ────────────────────────────────────
+
+  step(1, TOTAL_STEPS, "Preflight checks");
+
+  const nodeMajor = getNodeMajor();
+  if (nodeMajor < 22) { fail(`Node.js ${nodeMajor} detected. Need >= 22.`); process.exit(1); }
+  success(`Node.js ${process.version}`);
+
+  const wranglerCheck = await execWrangler(["--version"], ".");
+  if (wranglerCheck.code !== 0) {
+    fail("Wrangler not found. Install: npm install -g wrangler");
+    process.exit(1);
+  }
+  success(`Wrangler installed`);
+
+  const authed = await checkWranglerAuth(".");
+  if (!authed) {
+    warn("Not logged into Cloudflare. Opening browser...");
+    const loginOk = await wranglerLogin(".");
+    if (!loginOk) { fail("Cloudflare login failed."); process.exit(1); }
+  }
+  success("Cloudflare authenticated");
+
+  // ── Step 2: Configuration ────────────────────────────────
+
+  step(2, TOTAL_STEPS, "Configuration");
+
+  const partner1 = await ask("  Partner 1 name", "Partner 1");
+  const partner2 = await ask("  Partner 2 name (or AI name)", "AI");
+  if (partner1.length > 80 || partner2.length > 80) { fail("Partner names must be 80 characters or fewer."); process.exit(1); }
+  const dashPassword = await password("  Dashboard password");
+  if (!dashPassword || dashPassword.length < 12) { fail("Password must be at least 12 characters."); process.exit(1); }
+  const { randomBytes } = await import('node:crypto');
+  const sessionSecret = randomBytes(32).toString('base64url');
+  success("Secure session key generated");
+
+  console.log();
+  info("Weather requires a free OpenWeatherMap API key.");
+  info("Get one at: https://openweathermap.org/api");
+  const weatherKey = await ask("  OpenWeatherMap API key (or skip)");
+  let weatherLat = "", weatherLon = "";
+  if (weatherKey) {
+    info("Find your coordinates at: https://www.latlong.net");
+    weatherLat = await ask("  Latitude (e.g. 51.5074)", "51.5074");
+    weatherLon = await ask("  Longitude (e.g. -0.1278)", "-0.1278");
+    const lat = Number(weatherLat), lon = Number(weatherLon);
+    if (!Number.isFinite(lat) || lat < -90 || lat > 90 || !Number.isFinite(lon) || lon < -180 || lon > 180) {
+      fail("Latitude must be -90 to 90 and longitude must be -180 to 180.");
+      process.exit(1);
+    }
+  }
+
+  // ── Step 3: Create D1 database ───────────────────────────
+
+  step(3, TOTAL_STEPS, "Creating D1 database");
+
+  const pkgRoot = getPackageRoot();
+  const deployDir = join(CONFIG_DIR, "deploy");
+  mkdirSync(deployDir, { recursive: true });
+
+  // Copy worker files to deploy dir
+  const s1 = spinner("Copying source files");
+  for (const file of ["worker.js", "oauth-entry.js", "schema.sql", "wrangler.toml", "package.json"]) {
+    const src = join(pkgRoot, file);
+    if (!existsSync(src)) { s1.fail(`Missing: ${file}`); process.exit(1); }
+    writeFileSync(join(deployDir, file), readFileSync(src, "utf-8"), "utf-8");
+  }
+  s1.stop("Source files copied");
+
+  const install = await execCommand('npm', ['install', '--omit=dev', '--ignore-scripts'], deployDir);
+  if (install.code !== 0) { fail(`Dependency install failed: ${install.stderr || install.stdout}`); process.exit(1); }
+
+  const s2 = spinner("Creating D1 database");
+  const dbId = await createD1OrReuse("hearth-dash-db", deployDir);
+  if (!dbId) { s2.fail("D1 creation failed"); process.exit(1); }
+  s2.stop(`D1 database ready: ${dbId.substring(0, 8)}...`);
+
+  const oauthKvId = await createKvOrReuse('hearth-dash-oauth', deployDir);
+  if (!oauthKvId) { fail('OAuth storage creation failed'); process.exit(1); }
+
+  // ── Step 4: Create R2 bucket ─────────────────────────────
+
+  step(4, TOTAL_STEPS, "Creating R2 bucket");
+
+  const s3 = spinner("Creating R2 bucket");
+  const r2Result = await execWrangler(["r2", "bucket", "create", "hearth-dash-photos"], deployDir);
+  if (r2Result.code !== 0) {
+    const combined = r2Result.stdout + r2Result.stderr;
+    if (combined.includes("already exists")) {
+      s3.stop("R2 bucket already exists");
+    } else {
+      s3.fail(`R2 creation failed: ${combined}`);
+      process.exit(1);
+    }
+  } else {
+    s3.stop("R2 bucket created");
+  }
+
+  // Patch wrangler.toml with real values
+  let toml = readFileSync(join(deployDir, "wrangler.toml"), "utf-8");
+  toml = toml.replace("YOUR_D1_DATABASE_ID", dbId);
+  toml = toml.replace("YOUR_OAUTH_KV_ID", oauthKvId);
+  toml = toml.replace('PARTNER_1 = "Partner 1"', `PARTNER_1 = ${JSON.stringify(partner1)}`);
+  toml = toml.replace('PARTNER_2 = "Partner 2"', `PARTNER_2 = ${JSON.stringify(partner2)}`);
+  if (weatherLat) {
+    toml = toml.replace('# WEATHER_LAT = "52.5726"', `WEATHER_LAT = "${weatherLat}"`);
+    toml = toml.replace('# WEATHER_LON = "-0.2405"', `WEATHER_LON = "${weatherLon}"`);
+  }
+  writeFileSync(join(deployDir, "wrangler.toml"), toml, "utf-8");
+
+  // ── Step 5: Deploy worker + set secrets ──────────────────
+
+  step(5, TOTAL_STEPS, "Deploying worker");
+
+  // A Worker must exist before Wrangler can set secrets non-interactively.
+  // This first deployment is inert: application and consent routes return 503
+  // until the required secrets are present.
+  const provision = spinner("Provisioning Cloudflare Worker");
+  const provisionResult = await execWrangler(["deploy"], deployDir);
+  if (provisionResult.code !== 0) {
+    provision.fail("Worker provisioning failed");
+    console.error(provisionResult.stderr || provisionResult.stdout);
+    process.exit(1);
+  }
+  const workerUrl = parseDeployOutput(provisionResult);
+  if (!workerUrl) {
+    provision.fail("Provisioned Worker, but could not determine its workers.dev URL.");
+    console.error(provisionResult.stdout || provisionResult.stderr);
+    process.exit(1);
+  }
+  provision.stop(`Worker provisioned: ${workerUrl}`);
+
+  const s6 = spinner("Initializing database schema");
+  const schemaResult = await executeSchema("hearth-dash-db", join(deployDir, "schema.sql"), deployDir);
+  if (!schemaResult.ok) {
+    s6.fail("Schema init failed: " + (schemaResult.error || "unknown error"));
+    console.error("Deployment is incomplete; no success configuration was saved.");
+    process.exit(1);
+  }
+  s6.stop("Database schema initialized");
+
+  const s4 = spinner("Setting secrets");
+  const secrets = [
+    ["DASHBOARD_PASSWORD", dashPassword],
+    ["SESSION_SECRET", sessionSecret],
+  ];
+  if (weatherKey) secrets.push(["WEATHER_API_KEY", weatherKey]);
+  for (const [name, value] of secrets) {
+    const result = await setSecret(name, value, deployDir);
+    if (result.code !== 0) {
+      s4.fail(`Could not set ${name}`);
+      console.error(result.stderr || result.stdout);
+      process.exit(1);
+    }
+  }
+  s4.stop("Secrets configured");
+
+  const s5 = spinner("Activating configured Worker");
+  const deployResult = await execWrangler(["deploy"], deployDir);
+  if (deployResult.code !== 0) {
+    s5.fail("Deploy failed");
+    console.error(deployResult.stderr || deployResult.stdout);
+    process.exit(1);
+  }
+  s5.stop(`Deployed: ${workerUrl}`);
+
+  // ── Step 6: Save config + print results ──────────────────
+
+  step(6, TOTAL_STEPS, "Finishing up");
+
+  const config = saveConfig({
+    workerUrl,
+    partner1,
+    partner2,
+    dbId,
+    deployedAt: new Date().toISOString(),
+  });
+
+  const mcpUrl = workerUrl + "/mcp";
+
+  console.log(`
+${green(bold("  Done!"))} Your dashboard is live.
+
+  ${bold("Dashboard:")}  ${cyan(workerUrl)}
+  ${bold("Password:")}   ${dim("(the one you just set)")}
+
+  ${bold("OAuth MCP Endpoint:")}
+  ${dim(mcpUrl)}
+
+  ${bold("MCP Config")} (add to Claude Code ${dim("~/.claude.json")} or Claude Desktop):
+${dim("  {")}
+${dim('    "mcpServers": {')}
+${dim('      "hearth-dash": {')}
+${dim('        "url": "' + mcpUrl + '"')}
+${dim("      }")}
+${dim("    }")}
+${dim("  }")}
+
+  ${bold("Connector URL")} (Claude will open a dashboard-password consent screen):
+  ${cyan(mcpUrl)}
+
+  ${dim("Config saved to: " + CONFIG_PATH)}
+`);
+}

package/cli/commands/mcp.js

@@ -1,69 +1,73 @@
-import { readFileSync, existsSync } from "node:fs";
-import { join } from "node:path";
-import { homedir } from "node:os";
-import { banner, bold, dim, cyan, warn, info } from "../lib/ui.js";
-
-const CONFIG_PATH = join(homedir(), ".hearth-dash", "config.json");
-
-export default async function mcpCommand(args) {
-  banner();
-
-  if (!existsSync(CONFIG_PATH)) {
-    warn("No config found. Run 'hearth-dash deploy' first.");
-    process.exit(1);
-  }
-
-  const config = JSON.parse(readFileSync(CONFIG_PATH, "utf-8"));
-  const mcpUrl = config.workerUrl + "/mcp/" + config.mcpSecret;
-
-  console.log(bold("  MCP Configuration\n"));
-
-  console.log(`  ${bold("Endpoint:")} ${cyan(mcpUrl)}\n`);
-
-  console.log(`  ${bold("For Claude Code")} (add to ${dim("~/.claude.json")}):\n`);
-  console.log(`  {`);
-  console.log(`    "mcpServers": {`);
-  console.log(`      "hearth-dash": {`);
-  console.log(`        "url": "${mcpUrl}"`);
-  console.log(`      }`);
-  console.log(`    }`);
-  console.log(`  }\n`);
-
-  console.log(`  ${bold("For Claude Desktop")} (Settings > Developer > MCP):\n`);
-  console.log(`  Name:     hearth-dash`);
-  console.log(`  URL:      ${mcpUrl}\n`);
-
-  console.log(`  ${bold("Connector URL")} (for Claude.ai mobile):`);
-  console.log(`  ${cyan(mcpUrl)}\n`);
-
-  console.log(`  ${bold("Available MCP tools:")}`);
-  const tools = [
-    "hearth_status       — Dashboard overview",
-    "hearth_mood         — Get/set moods",
-    "hearth_note         — Get/leave fridge notes",
-    "hearth_moment       — List/add moments",
-    "hearth_date         — Upcoming/add dates",
-    "hearth_shopping_list — Get shopping list",
-    "hearth_shopping_add — Add shopping item",
-    "hearth_pressure     — Barometric pressure data",
-    "hearth_food_diary_today    — Today's meals + water",
-    "hearth_food_diary_history  — Historical food data",
-    "hearth_food_review  — Post food review",
-    "hearth_water_status — Water intake status",
-  ];
-  tools.forEach(t => console.log(`    ${dim(t)}`));
-  console.log();
-
-  if (args.includes("--install")) {
-    const { writeFileSync } = await import("node:fs");
-    const claudeConfigPath = join(homedir(), ".claude.json");
-    let claudeConfig = {};
-    if (existsSync(claudeConfigPath)) {
-      try { claudeConfig = JSON.parse(readFileSync(claudeConfigPath, "utf-8")); } catch {}
-    }
-    if (!claudeConfig.mcpServers) claudeConfig.mcpServers = {};
-    claudeConfig.mcpServers["hearth-dash"] = { url: mcpUrl };
-    writeFileSync(claudeConfigPath, JSON.stringify(claudeConfig, null, 2) + "\n", "utf-8");
-    info("MCP config written to " + claudeConfigPath);
-  }
-}
+import { readFileSync, existsSync, chmodSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { banner, bold, dim, cyan, warn, info } from "../lib/ui.js";
+
+const CONFIG_PATH = join(homedir(), ".hearth-dash", "config.json");
+
+export default async function mcpCommand(args) {
+  banner();
+
+  if (!existsSync(CONFIG_PATH)) {
+    warn("No config found. Run 'hearth-dash deploy' first.");
+    process.exit(1);
+  }
+
+  const config = JSON.parse(readFileSync(CONFIG_PATH, "utf-8"));
+  const mcpUrl = config.workerUrl + "/mcp";
+
+  console.log(bold("  MCP Configuration\n"));
+
+  console.log(`  ${bold("Endpoint:")} ${cyan(mcpUrl)}\n`);
+  info("Hearth uses OAuth 2.1. Your dashboard password stays out of the connector URL and Claude stores only revocable tokens.");
+  console.log();
+
+  console.log(`  ${bold("For Claude Code")} (add to ${dim("~/.claude.json")}):\n`);
+  console.log(`  {`);
+  console.log(`    "mcpServers": {`);
+  console.log(`      "hearth-dash": {`);
+  console.log(`        "url": "${mcpUrl}"`);
+  console.log(`      }`);
+  console.log(`    }`);
+  console.log(`  }\n`);
+
+  console.log(`  ${bold("For Claude Desktop")} (Settings > Developer > MCP):\n`);
+  console.log(`  Name:     hearth-dash`);
+  console.log(`  URL:      ${mcpUrl}\n`);
+  console.log(`  ${dim("When prompted, sign in with the Hearth dashboard password and approve access.")}\n`);
+
+  console.log(`  ${bold("Connector URL")} (for Claude.ai mobile):`);
+  console.log(`  ${cyan(mcpUrl)}\n`);
+
+  console.log(`  ${bold("Available MCP tools:")}`);
+  const tools = [
+    "hearth_status       — Dashboard overview",
+    "hearth_mood         — Get/set moods",
+    "hearth_note         — Get/leave fridge notes",
+    "hearth_moment       — List/add moments",
+    "hearth_date         — Upcoming/add dates",
+    "hearth_shopping_list — Get shopping list",
+    "hearth_shopping_add — Add shopping item",
+    "hearth_pressure     — Barometric pressure data",
+    "hearth_food_diary_today    — Today's meals + water",
+    "hearth_food_diary_history  — Historical food data",
+    "hearth_food_review  — Post food review",
+    "hearth_water_status — Water intake status",
+  ];
+  tools.forEach(t => console.log(`    ${dim(t)}`));
+  console.log();
+
+  if (args.includes("--install")) {
+    const { writeFileSync } = await import("node:fs");
+    const claudeConfigPath = join(homedir(), ".claude.json");
+    let claudeConfig = {};
+    if (existsSync(claudeConfigPath)) {
+      try { claudeConfig = JSON.parse(readFileSync(claudeConfigPath, "utf-8")); } catch {}
+    }
+    if (!claudeConfig.mcpServers) claudeConfig.mcpServers = {};
+    claudeConfig.mcpServers["hearth-dash"] = { url: mcpUrl };
+    writeFileSync(claudeConfigPath, JSON.stringify(claudeConfig, null, 2) + "\n", "utf-8");
+    try { chmodSync(claudeConfigPath, 0o600); } catch {}
+    info("MCP config written to " + claudeConfigPath);
+  }
+}