@fml-inc/fml 0.8.0-rc.1 → 0.8.0-rc.2

package/dist/cli.js

@@ -2,7 +2,7 @@
 import {
   createFmlClient,
   getAuthenticatedClient
-} from "./chunk-P3QLARXE.js";
+} from "./chunk-R45CWWZO.js";
 import {
   OBSERVER_HEARTBEAT_STALE_MS,
   getProcessIdentity,
@@ -10,13 +10,13 @@ import {
   isPidAlive,
   readObserverStateStatus,
   removeObserverStateIfOwned
-} from "./chunk-HUR2HCUG.js";
+} from "./chunk-WZLLO563.js";
 import {
   readJsonFile,
   setHookCaptureDisabled,
   writeJsonFile,
   writeTextFileAtomic
-} from "./chunk-I4GZPTBM.js";
+} from "./chunk-ENW2GJNO.js";
 import {
   CODEX_HOOK_EVENTS,
   GEMINI_HOOK_EVENTS,
@@ -24,8 +24,8 @@ import {
   isObserverHealth,
   readHookInboxStatus,
   readObserverAuthToken
-} from "./chunk-DEMVOVVY.js";
-import "./chunk-T5YVLSUC.js";
+} from "./chunk-56TPYMNK.js";
+import "./chunk-7V7G7NVF.js";
 import {
   claudeConfigDirectory,
   createCliRawSync,
@@ -34,7 +34,7 @@ import {
   initializeSyncSettings,
   resolvePackageRoot,
   runRawSyncOnce
-} from "./chunk-JXSSPQ5B.js";
+} from "./chunk-YSU5CS2V.js";
 import {
   DEFAULT_PROD_URL,
   DEFAULT_TARGET_NAME,
@@ -76,7 +76,7 @@ import {
   storeServiceRefreshToken,
   writeEnvConfig,
   writeTokens
-} from "./chunk-7DR5X7XI.js";
+} from "./chunk-A6HAEVJX.js";
 import "./chunk-MLKGABMK.js";
 
 // src/cli.ts
@@ -124,7 +124,7 @@ var POLL_INTERVAL_MS = 50;
 var LOG_ROTATE_BYTES = 10 * 1024 * 1024;
 var LOG_ROTATE_FILES = 3;
 function expectedObserverVersion() {
-  return true ? "0.8.0-rc.1+60c9b7e1" : "dev";
+  return true ? "0.8.0-rc.2+bed6eaed" : "dev";
 }
 function delay(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
@@ -776,20 +776,58 @@ function probeLocalStorage() {
     });
   }
 }
+function humanCheckResult(result) {
+  switch (result.label) {
+    case "Auth":
+      return { label: "Account", detail: result.detail };
+    case "Environment": {
+      const environmentName = result.detail.replace(
+        / has no backend URL$/u,
+        ""
+      );
+      return {
+        label: "Environment",
+        detail: result.status === "ok" ? result.detail.split(" \u2192 ")[0] ?? result.detail : `No service URL is configured for ${environmentName}. Run \`fml env <name-or-url>\`.`
+      };
+    }
+    case "Organization":
+      return { label: "Organization", detail: result.detail };
+    case "Local data":
+      return { label: "Local storage", detail: result.detail };
+    case "Database lease":
+      return {
+        label: "Runtime state",
+        detail: result.detail.replace("observer", "FML service")
+      };
+    case "Raw sync":
+      return {
+        label: "Agent activity sync",
+        detail: result.detail.replace("observer state", "FML service state").replace("raw sync", "agent activity sync")
+      };
+    case "API":
+      return { label: "FML API", detail: result.detail };
+    case "Observer":
+      return {
+        label: "FML service",
+        detail: result.detail.replace("observer", "FML service").replace("continuous sync", "agent activity sync").replace("raw sync", "agent activity sync")
+      };
+  }
+  return null;
+}
 function reportResult(result, spinner) {
-  const text = `${result.label} \u2014 ${result.detail}`;
   if (spinner) {
-    if (result.status === "ok") spinner.succeed(text);
-    if (result.status === "warn") spinner.warn(text);
-    if (result.status === "fail") spinner.fail(text);
-    return;
+    spinner.indent = 0;
+    spinner.stop();
   }
+  const humanResult = humanCheckResult(result);
+  if (!humanResult) return;
   const icon = result.status === "ok" ? pc.green("\u2713") : result.status === "warn" ? pc.yellow("!") : pc.red("\u2717");
-  console.log(`  ${icon}  ${text}`);
+  console.log(`  ${icon}  ${humanResult.label} \u2014 ${humanResult.detail}`);
 }
 async function handleDoctor(opts) {
   const environment = getActiveEnv();
   const isTTY = !opts.json && process.stdout.isTTY === true;
+  if (!opts.json) console.log("FML doctor\n");
   const checks = [];
   const startSpinner = (label) => isTTY ? ora({ text: `Checking ${label}...`, indent: 2 }).start() : null;
   const record = (result, spinner) => {
@@ -909,7 +947,7 @@ async function handleDoctor(opts) {
     }
   }
   {
-    const spinner = startSpinner("raw sync");
+    const spinner = startSpinner("agent activity sync");
     try {
       try {
         probeDurableDirectory(FML_OBSERVER_DIR, {
@@ -977,7 +1015,7 @@ async function handleDoctor(opts) {
     }
   }
   {
-    const spinner = startSpinner("local observer");
+    const spinner = startSpinner("FML service");
     const rawSync2 = createRawArtifactSync({ stateDir: FML_OBSERVER_DIR });
     const syncEnabled = rawSync2.getSettings().enabled;
     const observer = await readObserverRuntimeStatus();
@@ -1018,6 +1056,9 @@ async function handleDoctor(opts) {
   console.log(`
   ${parts.join(", ")}
 `);
+  if (failed > 0) {
+    console.log("Fix the failed checks above, then run `fml doctor` again.");
+  }
 }
 
 // src/commands/install.ts
@@ -1264,24 +1305,6 @@ var CLAUDE_PLUGIN_INSTALLER = Object.freeze({
   })
 });
 
-// src/banner.ts
-import pc2 from "picocolors";
-var LOGO_LINES = [
-  " \u2584\u2588\u2588\u2580   \u2588\u2588\u2584\u2588\u2588\u2584\u2588\u2588  \u2588\u2588",
-  " \u2588\u2588     \u2588\u2588 \u2588\u2588 \u2588\u2588  \u2588\u2588",
-  "\u2588\u2588\u2588\u2588\u2588   \u2588\u2588    \u2588\u2588  \u2588\u2588",
-  " \u2588\u2588     \u2588\u2588    \u2588\u2588  \u2588\u2588\u2588\u2588",
-  " \u2580\u2580     \u2580\u2580    \u2580\u2580  \u2580\u2580\u2580\u2580"
-];
-function printBanner() {
-  console.log("");
-  for (let i = 0; i < LOGO_LINES.length; i++) {
-    const color = i < 3 ? pc2.blue : pc2.cyan;
-    console.log("  " + color(LOGO_LINES[i]));
-  }
-  console.log("");
-}
-
 // src/bin-utils.ts
 import fs3 from "fs";
 import path4 from "path";
@@ -4132,7 +4155,7 @@ function rollbackMutation2(mutation) {
 }
 function warnSkippedPlan(plan, error, warn) {
   warn(
-    `warn: skipped ${plan.displayName} MCP config at ${plan.configPath}: ${error}`
+    `Warning: skipped ${plan.displayName} MCP config at ${plan.configPath}: ${error}`
   );
 }
 function applyPlan2(plan, warn) {
@@ -4176,14 +4199,17 @@ function reportPlan(plan, warn, log) {
   for (const note of plan.notes) log(note);
 }
 function configureFmlDirectMcp(pluginRoot, options = {}) {
-  const warn = options.warn ?? console.warn;
+  const emitWarning = (message) => {
+    (options.warn ?? console.warn)(message);
+    options.onFailure?.(message);
+  };
   const log = options.log ?? console.log;
   const context = plannerContext2(pluginRoot, options);
   const changes = [];
   for (const capability of DIRECT_MCP_CAPABILITIES) {
     const plan = capability.planInstall(context);
-    reportPlan(plan, warn, log);
-    if (!applyPlan2(plan, warn)) continue;
+    reportPlan(plan, emitWarning, log);
+    if (!applyPlan2(plan, emitWarning)) continue;
     changes.push({
       targetId: plan.targetId,
       displayName: plan.displayName,
@@ -4867,14 +4893,13 @@ async function handleInstall(opts = {}) {
     homeDir: os5.homedir(),
     packageRoot: pluginRoot
   });
-  console.log("Installing fml...\n");
-  console.log("[1/5] Creating FML directories...");
+  console.log("Configuring FML integrations...");
   for (const root of configuredManagedRoots()) {
     const preparation = prepareManagedDirectory(root);
     if (!preparation.managed) {
       const recovery = process.platform === "win32" ? "use a dedicated FML directory in a native location; custom Windows roots require manual cleanup" : "use a dedicated FML directory or follow the inspected custom-root adoption steps in https://github.com/fml-inc/fml/blob/main/docs/plugin-cleanup.md#adopt-an-existing-custom-root";
       console.warn(
-        `      warn: ${root.directory} could not be safely marked as FML-owned because it is non-empty, symlinked, or not owned by the current user; ${recovery} before using \`fml uninstall --purge\``
+        `Warning: ${root.directory} could not be safely marked as FML-owned because it is non-empty, symlinked, or not owned by the current user; ${recovery} before using \`fml uninstall --purge\`.`
       );
     }
   }
@@ -4885,11 +4910,8 @@ async function handleInstall(opts = {}) {
     FML_OBSERVER_DIR
   ])) {
     fs9.mkdirSync(directory, { recursive: true, mode: 448 });
-    console.log(`      ${directory}`);
   }
   initializeSyncSettings(path21.join(FML_OBSERVER_DIR, "sync.json"));
-  console.log();
-  console.log("[2/5] Installing agent-native /fml skills...");
   let skillReady = false;
   try {
     const skillResults = installManagedAgentSkills(pluginRoot);
@@ -4897,23 +4919,17 @@ async function handleInstall(opts = {}) {
     for (const result of skillResults) {
       const targets = result.displayNames.join(", ");
       if (result.status === "preserved") {
-        console.log(
-          `      warn: preserved ${result.destinationPath} for ${targets}: ${result.reason}`
-        );
-      } else {
-        console.log(
-          `      ${targets}: ${result.destinationPath} (${result.status})`
+        console.warn(
+          `Warning: preserved ${result.destinationPath} for ${targets}: ${result.reason}`
         );
       }
     }
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
-    console.log(
-      `      warn: agent-native skill setup could not be completed: ${message}`
+    console.warn(
+      `Warning: agent-native skill setup could not be completed: ${message}`
     );
   }
-  console.log();
-  console.log("[3/5] Writing plugin manifest...");
   const packageJson = readJsonFile(path21.join(pluginRoot, "package.json"));
   const generatedManifest = readJsonFile(paths.pluginManifestPath);
   const version = typeof generatedManifest?.version === "string" ? generatedManifest.version : typeof packageJson?.version === "string" ? packageJson.version : "0.0.0-dev";
@@ -4921,17 +4937,14 @@ async function handleInstall(opts = {}) {
     paths.pluginManifestPath,
     CLAUDE_PLUGIN_INSTALLER.pluginManifest(version)
   );
-  console.log(`      Version: ${version}
-`);
-  console.log("[4/5] Registering the FML plugin...");
   const claudeBin = resolveBin("claude");
   const marketplaceResult = readJsonFileForUpdate(
     paths.marketplaceManifestPath
   );
   let marketplaceReady = false;
   if (!marketplaceResult.ok) {
-    console.log(
-      `      warn: preserved unreadable marketplace config ${paths.marketplaceManifestPath}: ${marketplaceResult.error}`
+    console.warn(
+      `Warning: preserved unreadable marketplace config ${paths.marketplaceManifestPath}: ${marketplaceResult.error}`
     );
   } else {
     fs9.mkdirSync(paths.marketplaceDir, { recursive: true, mode: 448 });
@@ -4941,8 +4954,8 @@ async function handleInstall(opts = {}) {
       marketplaceSymlinkType()
     );
     if (linkUpdate === "preserved") {
-      console.log(
-        `      warn: preserved non-symlink marketplace path ${paths.marketplaceLinkPath}; remove it manually to enable the FML Claude plugin`
+      console.warn(
+        `Warning: preserved non-symlink marketplace path ${paths.marketplaceLinkPath}; remove it manually to enable the FML Claude plugin`
       );
     } else {
       const marketplace = CLAUDE_PLUGIN_INSTALLER.addMarketplaceEntry(
@@ -4955,8 +4968,8 @@ async function handleInstall(opts = {}) {
   const settingsResult = readJsonFileForUpdate(paths.settingsPath);
   let settingsReady = false;
   if (!settingsResult.ok) {
-    console.log(
-      `      warn: preserved unreadable Claude settings ${paths.settingsPath}: ${settingsResult.error}`
+    console.warn(
+      `Warning: preserved unreadable Claude settings ${paths.settingsPath}: ${settingsResult.error}`
     );
   } else if (marketplaceReady) {
     const settings = CLAUDE_PLUGIN_INSTALLER.enableInSettings(
@@ -4966,21 +4979,23 @@ async function handleInstall(opts = {}) {
     writeJsonFile(paths.settingsPath, settings);
     settingsReady = true;
   }
-  for (const target2 of configureFmlDirectMcp(pluginRoot)) {
-    console.log(`      MCP: ${target2.displayName} -> fml`);
-  }
+  let mcpReady = true;
+  let claudePluginReady = true;
+  configureFmlDirectMcp(pluginRoot, {
+    warn: (message) => console.warn(message.replace(/^warn:/u, "Warning:")),
+    onFailure: () => {
+      mcpReady = false;
+    }
+  });
   let hooksReady = true;
-  const hookTargets = configureFmlHooks(pluginRoot, {
+  configureFmlHooks(pluginRoot, {
     onFailure: () => {
       hooksReady = false;
     }
   });
-  for (const target2 of hookTargets) {
-    console.log(`      Hooks: ${target2.displayName} -> fml`);
-  }
   if (!marketplaceReady || !settingsReady) {
-    console.log(
-      "      warn: skipped Claude plugin registration until its existing config is repaired"
+    console.warn(
+      "Warning: skipped Claude plugin registration until its existing config is repaired"
     );
   } else if (claudeBin) {
     try {
@@ -4995,16 +5010,14 @@ async function handleInstall(opts = {}) {
           timeout: command.timeoutMs
         });
       }
-      console.log("      Plugin registered via Claude Code CLI");
     } catch (error) {
+      claudePluginReady = false;
       const message = error instanceof Error ? error.message : String(error);
-      console.log(`      warn: Claude plugin registration failed: ${message}`);
+      console.warn(`Warning: Claude plugin registration failed: ${message}`);
     }
   } else {
-    console.log("      warn: claude CLI not found; plugin files are ready");
+    console.warn("Warning: claude CLI not found; plugin files are ready");
   }
-  console.log();
-  console.log("[5/5] Initializing the FML environment...");
   if (!envConfigExists()) {
     writeEnvConfig({
       schemaVersion: 1,
@@ -5013,9 +5026,6 @@ async function handleInstall(opts = {}) {
         [DEFAULT_TARGET_NAME]: { convexUrl: DEFAULT_PROD_URL }
       }
     });
-    console.log(`      ${DEFAULT_TARGET_NAME}: ${DEFAULT_PROD_URL}`);
-  } else {
-    console.log("      Preserved existing environment selection");
   }
   if (!skillReady || !marketplaceReady || !settingsReady || !hooksReady) {
     throw new Error(
@@ -5030,21 +5040,20 @@ async function handleInstall(opts = {}) {
       `FML install is incomplete: hook capture remains paused because its state could not be cleared: ${message}`
     );
   }
-  console.log("");
-  printBanner();
-  console.log("Done! Start a new coding session to activate.\n");
-  console.log("Next steps:");
-  console.log("  fml login          Sign in to your FML account");
-  console.log("  fml org            Select organization");
-  console.log("  fml start          Start hook capture and raw artifact sync");
-  console.log("  fml doctor         Verify setup");
+  console.log("\u2713  Agent skills configured");
+  if (mcpReady && claudePluginReady) {
+    console.log("\u2713  Coding-agent integrations configured");
+    console.log("FML integrations configured.");
+  } else {
+    console.warn(
+      "Warning: Coding-agent integrations were not fully configured. See warnings above."
+    );
+    console.log("FML integration configuration finished with warnings.");
+  }
 }
 
-// src/commands/uninstall.ts
-import fs12 from "fs";
-import os7 from "os";
-import path27 from "path";
-import readline from "readline/promises";
+// src/commands/sync.ts
+import { statSync } from "fs";
 
 // src/commands/otel-config.ts
 import fs11 from "fs";
@@ -6040,7 +6049,7 @@ function applyPlan3(plan, warn, commitOwnership) {
       } catch (error) {
         const detail = error instanceof Error ? error.message : String(error);
         warn(
-          `warn: skipped ${plan.displayName} OpenTelemetry at ${plan.configPath}: ${detail}`
+          `Warning: skipped ${plan.displayName} OpenTelemetry at ${plan.configPath}: ${detail}`
         );
         return null;
       }
@@ -6049,7 +6058,7 @@ function applyPlan3(plan, warn, commitOwnership) {
       } catch (error) {
         const detail = error instanceof Error ? error.message : String(error);
         warn(
-          `warn: could not record ${plan.displayName} OpenTelemetry ownership at ${plan.configPath}: ${detail}`
+          `Warning: could not record ${plan.displayName} OpenTelemetry ownership at ${plan.configPath}: ${detail}`
         );
       }
     }
@@ -6058,7 +6067,7 @@ function applyPlan3(plan, warn, commitOwnership) {
   const uniquePaths2 = new Set(plan.mutations.map((mutation) => mutation.path));
   if (uniquePaths2.size !== plan.mutations.length) {
     warn(
-      `warn: skipped ${plan.displayName} OpenTelemetry at ${plan.configPath}: plan contains duplicate paths`
+      `Warning: skipped ${plan.displayName} OpenTelemetry at ${plan.configPath}: plan contains duplicate paths`
     );
     return null;
   }
@@ -6089,7 +6098,7 @@ function applyPlan3(plan, warn, commitOwnership) {
     const detail = error instanceof Error ? error.message : String(error);
     const rollbackDetail = rollbackErrors.length === 0 ? "" : `; rollback failed: ${rollbackErrors.join("; ")}`;
     warn(
-      `warn: skipped ${plan.displayName} OpenTelemetry at ${plan.configPath}: ${detail}${rollbackDetail}`
+      `Warning: skipped ${plan.displayName} OpenTelemetry at ${plan.configPath}: ${detail}${rollbackDetail}`
     );
     return null;
   }
@@ -6124,7 +6133,7 @@ function loadOtelConfigState(options, warn) {
       )
     };
   } catch (error) {
-    warn(`warn: ${error instanceof Error ? error.message : String(error)}`);
+    warn(`Warning: ${error instanceof Error ? error.message : String(error)}`);
     return null;
   }
 }
@@ -6171,7 +6180,7 @@ function planSafely(capability, operation, context, warn) {
     return operation === "install" ? capability.planInstall(context) : capability.planUninstall(context);
   } catch (error) {
     warn(
-      `warn: skipped ${capability.displayName} OpenTelemetry: ${error instanceof Error ? error.message : String(error)}`
+      `Warning: skipped ${capability.displayName} OpenTelemetry: ${error instanceof Error ? error.message : String(error)}`
     );
     return null;
   }
@@ -6181,7 +6190,7 @@ function pruneMissingRecordedEntry(state, key, entry, warn) {
     commitStateEntry(state, key, null);
   } catch (error) {
     warn(
-      `warn: could not prune missing ${entry.targetId} OpenTelemetry ownership at ${entry.path}: ${error instanceof Error ? error.message : String(error)}`
+      `Warning: could not prune missing ${entry.targetId} OpenTelemetry ownership at ${entry.path}: ${error instanceof Error ? error.message : String(error)}`
     );
   }
 }
@@ -6283,13 +6292,13 @@ function removeFmlOtel(observer, options = {}) {
     }
     if (candidate.recorded && candidate.plan.mutations.length === 0 && candidate.plan.warnings.length === 0 && state) {
       warn(
-        `warn: preserved ${candidate.plan.displayName} OpenTelemetry at ${candidate.plan.configPath}: managed fields were modified or removed after installation`
+        `Warning: preserved ${candidate.plan.displayName} OpenTelemetry at ${candidate.plan.configPath}: managed fields were modified or removed after installation`
       );
       try {
         commitStateEntry(state, key, null);
       } catch (error) {
         warn(
-          `warn: could not relinquish ${candidate.plan.displayName} OpenTelemetry ownership at ${candidate.plan.configPath}: ${error instanceof Error ? error.message : String(error)}`
+          `Warning: could not relinquish ${candidate.plan.displayName} OpenTelemetry ownership at ${candidate.plan.configPath}: ${error instanceof Error ? error.message : String(error)}`
         );
       }
     }
@@ -6297,420 +6306,390 @@ function removeFmlOtel(observer, options = {}) {
   return changes;
 }
 
-// src/commands/uninstall.ts
-var PURGE_WARNING = "This deletes FML credentials for ALL environments, logs, sync state, and every pending best-effort OTLP envelope.";
-function tryDisableHookCapture() {
-  try {
-    setHookCaptureDisabled(true);
-    return true;
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    console.warn(
-      `Could not persist the hook-capture pause at ${FML_HOOK_CAPTURE_DISABLED_FILE}: ${message}`
-    );
-    return false;
-  }
+// src/commands/sync.ts
+function rawSync() {
+  return createCliRawSync();
 }
-function resolvePreservedPaths(preservedFile) {
-  const logicalPath = path27.resolve(preservedFile);
-  try {
-    const canonicalPath = fs12.realpathSync(preservedFile);
-    return pathsAreSame(canonicalPath, logicalPath) ? [logicalPath] : [logicalPath, canonicalPath];
-  } catch {
-    return [logicalPath];
+function formatBytes(bytes) {
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KiB`;
+  if (bytes < 1024 * 1024 * 1024) {
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MiB`;
   }
+  return `${(bytes / (1024 * 1024 * 1024)).toFixed(2)} GiB`;
 }
-function purgeDirectoryPreservingPaths(directory, preservedPaths, configuredRoot = false) {
-  const resolvedDirectory = path27.resolve(directory);
-  let directoryStats;
-  try {
-    directoryStats = fs12.lstatSync(directory);
-  } catch (error) {
-    if (error.code === "ENOENT") return true;
-    throw error;
-  }
-  if (directoryStats.isSymbolicLink()) {
-    if (configuredRoot) return false;
-    const containsLogicalMarker = preservedPaths.some(
-      (preservedPath) => pathContains(resolvedDirectory, preservedPath)
-    );
-    if (!containsLogicalMarker) {
-      fs12.rmSync(directory, { force: true });
-      return true;
-    }
-    return false;
-  }
-  const directoryPaths = [resolvedDirectory];
-  try {
-    const canonicalDirectory = fs12.realpathSync(directory);
-    if (!pathsAreSame(canonicalDirectory, resolvedDirectory)) {
-      directoryPaths.push(canonicalDirectory);
-    }
-  } catch {
-  }
-  const containsPreservedPath = directoryPaths.some(
-    (directoryPath) => preservedPaths.some(
-      (preservedPath) => pathContains(directoryPath, preservedPath)
-    )
+function formatDuration(durationMs) {
+  if (durationMs < 1e3) return `${Math.round(durationMs)} ms`;
+  return `${(durationMs / 1e3).toFixed(2)} s`;
+}
+function printRepositoryResolution(metrics) {
+  if (metrics.attempted === 0 && metrics.budgetSkipped === 0) return;
+  console.log(
+    `  Repo checks:      ${metrics.attempted} (${metrics.resolved} resolved, ${metrics.unresolved} unresolved, ${metrics.cacheHits} cached, ${metrics.budgetSkipped} skipped by budget)`
   );
-  if (!containsPreservedPath) {
-    fs12.rmSync(directory, { recursive: true, force: true });
-    return true;
-  }
-  const isPreservedPath = directoryPaths.some(
-    (directoryPath) => preservedPaths.some(
-      (preservedPath) => pathsAreSame(directoryPath, path27.resolve(preservedPath))
-    )
+  console.log(
+    `  Repo check time:  ${formatDuration(metrics.elapsedMs)} total, ${formatDuration(metrics.slowestMs)} slowest`
   );
-  if (isPreservedPath) return true;
-  if (!directoryStats.isDirectory()) return false;
-  let entries;
-  try {
-    entries = fs12.readdirSync(directory);
-  } catch (error) {
-    if (error.code === "ENOENT") return true;
-    throw error;
-  }
-  let complete = true;
-  for (const entry of entries) {
-    const entryPath = path27.join(directory, entry);
-    if (!purgeDirectoryPreservingPaths(entryPath, preservedPaths, false)) {
-      complete = false;
-    }
-  }
-  return complete;
 }
-function purgeDirectoryPreservingFiles(directory, preservedFiles) {
-  if (hasSymlinkedParentBelowTrustedAnchor(directory)) return false;
-  return purgeDirectoryPreservingPaths(
-    directory,
-    preservedFiles.flatMap(
-      (preservedFile) => resolvePreservedPaths(preservedFile)
-    ),
-    true
-  );
+function writeJson(value) {
+  console.log(JSON.stringify(value, null, 2));
 }
-function finishCustomRootPurge(directory) {
-  const marker = managedDirectoryMarker(directory);
-  fs12.rmSync(marker, { force: true });
-  try {
-    fs12.rmdirSync(directory);
-  } catch (error) {
-    if (error.code === "ENOENT") return;
-    try {
-      fs12.writeFileSync(marker, FML_MANAGED_DIRECTORY_MARKER_CONTENT, {
-        encoding: "utf8",
-        flag: "wx",
-        mode: 384
-      });
-    } catch (markerError) {
-      if (markerError.code === "EEXIST" && hasManagedDirectoryMarker(directory)) {
-        throw error;
-      }
-      const removalMessage = error instanceof Error ? error.message : String(error);
-      const markerMessage = markerError instanceof Error ? markerError.message : String(markerError);
-      throw new Error(
-        `could not remove ${directory} (${removalMessage}) or restore its FML ownership marker (${markerMessage})`
-      );
-    }
-    throw error;
+function warnRetainedLegacyDatabase(retained) {
+  if (retained.pendingEvents !== null && retained.pendingHookEvents !== null && retained.pendingOtlpEnvelopes !== null) {
+    console.warn(
+      `Warning: Retained legacy observer database at ${retained.databaseFile} with ${retained.pendingEvents} pending rows (${retained.pendingHookEvents} hook, ${retained.pendingOtlpEnvelopes} OTLP); FML will not sync those rows automatically.`
+    );
+    return;
   }
+  console.warn(
+    `Warning: Retained legacy observer database at ${retained.databaseFile}; pending row count unavailable. FML will not sync that database automatically.`
+  );
 }
-function cleanInstalledPluginScopes(paths) {
-  const installedPlugins = readJsonFile(paths.installedPluginsPath);
-  if (!installedPlugins) return;
-  const update = CLAUDE_PLUGIN_INSTALLER.removeInstalledPlugin(
-    installedPlugins,
-    CLAUDE_PLUGIN_INSTALLER.pluginId
+function printStatus(status) {
+  const { queue } = status;
+  console.log(
+    `Raw artifact sync: ${status.settings.enabled ? "enabled" : "disabled"}`
   );
-  if (!update.changed) return;
-  for (const settingsPath2 of CLAUDE_PLUGIN_INSTALLER.projectSettingsPaths(
-    installedPlugins,
-    CLAUDE_PLUGIN_INSTALLER.pluginId
-  )) {
-    if (removeEnabledPluginFromSettings(
-      settingsPath2,
-      CLAUDE_PLUGIN_INSTALLER.pluginId
-    )) {
-      console.log(`      Cleaned ${settingsPath2}`);
-    }
-  }
-  writeJsonFile(paths.installedPluginsPath, update.installedPlugins);
-  console.log("      Cleaned installed_plugins.json");
+  console.log(`  State:     ${FML_OBSERVER_DIR}`);
+  console.log(`  Tracked:   ${queue.tracked}`);
+  console.log(`  Pending:   ${queue.pending}`);
+  console.log(`  Raw work:  ${queue.rawPending}`);
+  console.log(`  Metadata:  ${queue.metadataPending}`);
+  console.log(`  Uploaded:  ${queue.uploaded}`);
+  console.log(`  Failed:    ${queue.failed}`);
+  console.log(
+    `  Watermark: ${formatBytes(queue.uploadedBytes)} / ${formatBytes(queue.totalBytes)}`
+  );
+  console.log(`  Remaining: ${formatBytes(queue.remainingBytes)}`);
 }
-function purgeWarning(roots) {
-  return `${PURGE_WARNING}
-Purge roots:
-${roots.map((root) => `  - ${root.directory}`).join("\n")}`;
+function syncExitCode(result) {
+  if (result.outcome === "failed" || result.outcome === "exhausted") return 1;
+  if (result.outcome === "busy") return 1;
+  return 0;
 }
-async function confirmPurge(opts, roots) {
-  const warning = purgeWarning(roots);
-  if (opts.assumeYes) {
-    console.log(warning);
-    return true;
-  }
-  const input = opts.input ?? process.stdin;
-  if (input.isTTY !== true) {
-    console.error(
-      `${warning}
-Re-run with --yes to confirm in a non-interactive session.`
-    );
-    return false;
-  }
-  const rl = readline.createInterface({
-    input,
-    output: opts.output ?? process.stdout
-  });
-  try {
-    const closed = new Promise((resolve) => {
-      rl.once("close", () => resolve(null));
-    });
-    const answer = await Promise.race([
-      rl.question(`${warning}
-Type y to continue: `).catch(() => null),
-      closed
-    ]);
-    if (answer !== null && answer.trim().toLowerCase() === "y") return true;
-  } finally {
-    rl.close();
-  }
-  console.error("Uninstall canceled; nothing was removed.");
-  return false;
-}
-function refuseUnsafePurge(roots) {
-  const unsafeRoots = unsafePurgeRoots(roots);
-  if (unsafeRoots.length === 0) return false;
-  console.error("Refusing to purge unsafe FML directories:");
-  for (const root of unsafeRoots) {
-    console.error(`  - ${root.directory}: ${root.reason}`);
+async function handleSyncRun(opts = {}) {
+  const sync2 = rawSync();
+  if (!sync2.getSettings().enabled) {
+    const result2 = {
+      ok: true,
+      outcome: "disabled",
+      status: sync2.status()
+    };
+    if (opts.json) writeJson(result2);
+    else printStatus(result2.status);
+    return;
   }
-  console.error(
-    "Inspect and remove those roots manually, or reconfigure FML to fresh dedicated empty data, state, log, and observer directories and run `fml install` before retrying."
-  );
-  process.exitCode = 1;
-  return true;
-}
-async function handleUninstall(opts) {
-  const purgeRoots = opts.purge ? configuredManagedRoots() : [];
-  if (opts.purge) {
-    if (refuseUnsafePurge(purgeRoots)) return;
-    if (!await confirmPurge(opts, purgeRoots)) {
-      process.exitCode = 1;
-      return;
+  if (opts.dryRun) {
+    const discovery = sync2.discover();
+    const bySource = {};
+    let totalBytes = 0;
+    for (const candidate of discovery.candidates) {
+      bySource[candidate.source] = (bySource[candidate.source] ?? 0) + 1;
+      try {
+        totalBytes += statSync(candidate.sourcePath).size;
+      } catch {
+      }
     }
-    for (const root of purgeRoots) {
-      if (!fs12.existsSync(root.directory) && pathContains(root.directory, FML_OBSERVER_DIR)) {
-        prepareManagedDirectory(root);
+    const result2 = {
+      ok: true,
+      dryRun: true,
+      targetUrl: getSiteUrl(),
+      discovered: {
+        count: discovery.candidates.length,
+        totalBytes,
+        bySource
+      },
+      repositoryResolution: discovery.repositoryResolution,
+      oversized: discovery.oversized,
+      status: sync2.status()
+    };
+    if (opts.json) writeJson(result2);
+    else {
+      console.log("FML raw artifact sync dry-run");
+      console.log(`  Target:     ${result2.targetUrl}`);
+      console.log(`  Discovered: ${result2.discovered.count}`);
+      console.log(`  Bytes:      ${formatBytes(result2.discovered.totalBytes)}`);
+      for (const [source, count] of Object.entries(bySource).sort()) {
+        console.log(`    ${source}: ${count}`);
+      }
+      printRepositoryResolution(discovery.repositoryResolution);
+      console.log(`  Oversized:  ${discovery.oversized.length}`);
+      if (discovery.compressedArtifactsUnsupportedReason) {
+        console.log(
+          `  Compressed: skipped \u2014 ${discovery.compressedArtifactsUnsupportedReason}`
+        );
       }
     }
-    if (refuseUnsafePurge(purgeRoots)) return;
-  }
-  console.log("Uninstalling fml...\n");
-  const otelDestination = readLocalObserverOtelDestination({
-    endpointFile: FML_OBSERVER_ENDPOINT_FILE,
-    authTokenFile: FML_OBSERVER_AUTH_TOKEN_FILE
-  });
-  let observer;
-  try {
-    observer = await stopObserver();
-  } catch (error) {
-    console.error(error instanceof Error ? error.message : String(error));
-    console.error(
-      "Could not safely stop the FML observer; uninstall was aborted. Repair the reported files and rerun `fml uninstall`."
-    );
-    process.exitCode = 1;
     return;
   }
-  if (observer.status === "permission_denied" || observer.status === "foreign_listener" || observer.status === "ambiguous_live_process" || observer.status === "unresponsive" || observer.status === "signal_sent") {
-    console.error(
-      `Could not safely stop FML observer PID ${observer.pid}; uninstall was aborted.`
-    );
+  const attempt = await runRawSyncOnce();
+  if (attempt.kind === "unauthenticated") {
+    console.error("Raw artifact sync requires an FML login.");
+    console.error("Run `fml login` or set FML_TOKEN.");
     process.exitCode = 1;
     return;
   }
-  let hookCapturePaused = tryDisableHookCapture();
-  createRawArtifactSync({ stateDir: FML_OBSERVER_DIR }).setEnabled(false);
-  const paths = CLAUDE_PLUGIN_INSTALLER.resolvePaths({
-    env: process.env,
-    homeDir: os7.homedir()
-  });
-  console.log("[1/7] Unregistering the Claude Code plugin...");
-  const claudeBin = resolveBin("claude");
-  if (claudeBin) {
-    try {
-      const command = CLAUDE_PLUGIN_INSTALLER.uninstallCommand;
-      execBinSync(claudeBin, [...command.args], {
-        timeout: command.timeoutMs
-      });
-    } catch {
+  if (attempt.kind === "disabled") {
+    if (opts.json) {
+      writeJson({ ok: true, outcome: "disabled", status: attempt.status });
+    } else {
+      printStatus(attempt.status);
     }
+    return;
   }
-  cleanInstalledPluginScopes(paths);
-  const settings = readJsonFile(paths.settingsPath);
-  if (settings) {
-    const marketplace2 = readJsonFile(paths.marketplaceManifestPath);
-    const keepLocalMarketplace = CLAUDE_PLUGIN_INSTALLER.hasOtherLocalMarketplacePlugins(
-      settings,
-      marketplace2
-    );
-    writeJsonFile(
-      paths.settingsPath,
-      CLAUDE_PLUGIN_INSTALLER.disableInSettings(settings, keepLocalMarketplace)
+  const { result, targetUrl } = attempt;
+  if (opts.json) {
+    writeJson({ ok: syncExitCode(result) === 0, targetUrl, result });
+  } else {
+    console.log("FML raw artifact sync");
+    console.log(`  Target:          ${targetUrl}`);
+    console.log(`  Outcome:         ${result.outcome}`);
+    console.log(`  Sync passes:     ${result.syncPasses}`);
+    console.log(`  Discovered:      ${result.discovery.candidates.length}`);
+    if (result.discovery.compressedArtifactsUnsupportedReason) {
+      console.log(
+        `  Compressed:      skipped \u2014 ${result.discovery.compressedArtifactsUnsupportedReason}`
+      );
+    }
+    printRepositoryResolution(result.discovery.repositoryResolution);
+    console.log(`  Uploaded files:  ${result.upload.uploaded}`);
+    console.log(`  Uploaded chunks: ${result.upload.uploadedChunks}`);
+    console.log(
+      `  Uploaded bytes:  ${formatBytes(result.upload.uploadedBytes)}`
     );
+    console.log(`  Failed:          ${result.upload.failed}`);
+    console.log(`  Exhausted:       ${result.upload.exhausted}`);
+    if (result.upload.retryAtMs !== void 0) {
+      console.log(
+        `  Retry at:        ${new Date(result.upload.retryAtMs).toISOString()}`
+      );
+    }
+    console.log(`  Drained:         ${result.drained ? "yes" : "no"}`);
+    if (result.outcome === "pending") {
+      console.log(
+        "  Next:            More data remains; run `fml sync` again or `fml start` for continuous syncing."
+      );
+    } else if (result.outcome === "backing_off") {
+      const nextRetryAtMs = result.upload.nextRetryAtMs;
+      console.log(
+        `  Next:            Remaining items are backing off after upload errors${nextRetryAtMs !== void 0 ? `; next retry due ${new Date(nextRetryAtMs).toISOString()}` : ""}. \`fml start\` retries automatically.`
+      );
+    }
+    console.log("");
+    printStatus(result.status);
   }
-  console.log("      Plugin settings removed");
-  console.log("[2/7] Removing agent-native /fml skills...");
+  process.exitCode = syncExitCode(result);
+}
+function setRawSyncEnabled(enabled) {
+  return rawSync().setEnabled(enabled);
+}
+async function handleSyncEnable(opts = {}) {
+  const sync2 = rawSync();
+  const settings = sync2.setEnabled(true);
+  const isolationWarning = observerOnlyOverrideWarning();
+  if (isolationWarning) console.warn(isolationWarning);
+  let retainedLegacyDatabase;
   try {
-    for (const result of removeManagedAgentSkills(resolvePackageRoot())) {
-      const targets = result.displayNames.join(", ");
-      if (result.status === "preserved") {
-        console.warn(
-          `      Preserved ${result.destinationPath} for ${targets}: ${result.reason}`
-        );
-      } else if (result.reason) {
-        console.warn(
-          `      ${targets}: ${result.destinationPath} (${result.status}); ${result.reason}`
+    const observer = await startObserver({
+      onLegacyDatabaseRetained: (retained) => {
+        retainedLegacyDatabase = retained;
+        if (!opts.json) warnRetainedLegacyDatabase(retained);
+      }
+    });
+    setHookCaptureDisabled(false);
+    if (observer.status === "already_running") {
+      await wakeObserverSync();
+    }
+    const port = observer.runtime.health?.port;
+    const authToken = port ? readObserverAuthToken(FML_OBSERVER_AUTH_TOKEN_FILE) : null;
+    if (port && authToken) {
+      configureFmlOtel({
+        baseUrl: `http://127.0.0.1:${port}`,
+        authToken
+      });
+    } else if (!opts.json) {
+      console.warn(
+        "Warning: Could not configure native OpenTelemetry: the healthy observer endpoint or local token is unavailable."
+      );
+    }
+    if (opts.json) {
+      writeJson({
+        ok: true,
+        sync: settings,
+        observer,
+        ...observer.retainedLegacyDatabase ? { retainedLegacyDatabase: observer.retainedLegacyDatabase } : {}
+      });
+    } else {
+      const pid = observer.runtime.health?.pid;
+      if (observer.status === "started") {
+        console.log(
+          pid ? `FML observer started (PID ${pid}).` : "FML observer started."
         );
+        console.log("Agent activity will sync automatically.");
       } else {
         console.log(
-          `      ${targets}: ${result.destinationPath} (${result.status})`
+          pid ? `FML observer is already running (PID ${pid}).` : "FML observer is already running."
         );
+        console.log("Agent activity sync is on.");
       }
     }
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
-    console.warn(
-      `      Agent-native skill cleanup could not be completed: ${message}`
-    );
-  }
-  console.log("[3/7] Removing the local marketplace entry...");
-  if (removeMarketplaceLink(paths.marketplaceLinkPath) === "preserved") {
-    console.warn(
-      `      Preserved non-symlink marketplace path ${paths.marketplaceLinkPath}`
-    );
+    if (opts.json) {
+      writeJson({
+        ok: false,
+        sync: settings,
+        error: message,
+        ...retainedLegacyDatabase ? { retainedLegacyDatabase } : {}
+      });
+    } else console.error(message);
+    process.exitCode = 1;
   }
-  const marketplace = readJsonFile(paths.marketplaceManifestPath);
-  if (marketplace && Array.isArray(marketplace.plugins)) {
-    writeJsonFile(
-      paths.marketplaceManifestPath,
-      CLAUDE_PLUGIN_INSTALLER.removeMarketplaceEntry(
-        marketplace,
-        CLAUDE_PLUGIN_INSTALLER.pluginName
-      )
-    );
-  }
-  fs12.rmSync(paths.pluginCacheDir, { recursive: true, force: true });
-  console.log("      Marketplace and plugin cache removed");
-  console.log("[4/7] Removing FML hook registrations...");
-  let hookRemovalComplete = true;
-  for (const target2 of removeFmlHooks({
-    onFailure: () => {
-      hookRemovalComplete = false;
+}
+async function handleSyncDisable(opts = {}) {
+  const sync2 = rawSync();
+  const settings = sync2.setEnabled(false);
+  const observerWoken = await wakeObserverSync();
+  if (opts.json) {
+    writeJson({ ok: true, sync: settings, observerWoken });
+  } else {
+    console.log("Agent activity sync is paused.");
+    const observer = await readObserverRuntimeStatus();
+    if (observer.running) {
+      console.log("FML observer remains available for local integrations");
     }
-  })) {
-    console.log(`      Removed FML hooks from ${target2.displayName}`);
-  }
-  if (!hookRemovalComplete) {
-    process.exitCode = 1;
-    console.warn(
-      "      Some FML hook registrations were preserved; repair the paths reported above and rerun `fml uninstall`."
-    );
-  }
-  console.log("[5/7] Removing native OpenTelemetry configuration...");
-  for (const target2 of removeFmlOtel(otelDestination)) {
-    console.log(`      Removed FML OpenTelemetry from ${target2.displayName}`);
   }
-  if (!otelDestination) {
-    console.warn(
-      "      The local observer endpoint or token is unavailable; only recorded OpenTelemetry profiles could be cleaned"
+}
+async function handleSyncStatus(opts = {}) {
+  const status = rawSync().status();
+  const observer = await readObserverRuntimeStatus();
+  if (opts.json) writeJson({ ok: true, status, observer });
+  else {
+    printStatus(status);
+    const state = observer.stateStatus.state;
+    console.log(
+      `  Observer:  ${observer.healthy ? "running" : observer.running ? "unhealthy" : "stopped"}`
     );
-  }
-  console.log("[6/7] Removing direct MCP registrations...");
-  for (const target2 of removeFmlDirectMcp("all")) {
-    console.log(`      Removed FML MCP from ${target2.displayName}`);
-  }
-  console.log("[7/7] Handling local data...");
-  let purgeComplete = true;
-  if (opts.purge) {
-    if (refuseUnsafePurge(purgeRoots)) {
-      purgeComplete = false;
-    } else {
-      for (const root of purgeRoots) {
-        if (refuseUnsafePurge([root])) {
-          purgeComplete = false;
-          continue;
-        }
-        const containsObserverDirectory = pathContains(
-          root.directory,
-          FML_OBSERVER_DIR
+    if (state) {
+      console.log(`  PID:       ${state.pid}`);
+      console.log(`  Phase:     ${state.phase}`);
+      if (state.lastOutcome) {
+        console.log(`  Last run:  ${state.lastOutcome}`);
+      }
+      if (state.nextAttemptAtMs) {
+        console.log(
+          `  Next run:  ${new Date(state.nextAttemptAtMs).toISOString()}`
         );
-        const customManagedRoot = !root.nativeDefault;
-        try {
-          const purged = purgeDirectoryPreservingFiles(root.directory, [
-            ...customManagedRoot ? [managedDirectoryMarker(root.directory)] : [],
-            ...containsObserverDirectory && hookCapturePaused ? [FML_HOOK_CAPTURE_DISABLED_FILE] : []
-          ]);
-          if (!purged) {
-            purgeComplete = false;
-            console.warn(
-              `      Preserved ${root.directory}: a symbolic link prevents a complete safe purge`
-            );
-            continue;
-          }
-          if (customManagedRoot && !containsObserverDirectory) {
-            finishCustomRootPurge(root.directory);
-          }
-          console.log(`      Purged ${root.directory}`);
-        } catch (error) {
-          purgeComplete = false;
-          const message = error instanceof Error ? error.message : String(error);
-          console.warn(
-            `      Preserved ${root.directory}: the safe purge was incomplete: ${message}`
-          );
-        }
       }
     }
-    if (!hookCapturePaused) hookCapturePaused = tryDisableHookCapture();
+    console.log(`  Log:       ${observer.logFile}`);
+  }
+}
+async function handleSyncReset(opts = {}) {
+  const result = rawSync().reset();
+  if (opts.json) writeJson({ ok: !result.skipped, reset: result });
+  else if (result.skipped) {
+    console.error(
+      "Raw artifact reset skipped: another sync owns the queue lock"
+    );
   } else {
     console.log(
-      "      Preserved auth, logs, raw-sync watermarks, and the bounded OTLP spool"
+      `Reset raw upload watermarks for ${result.reset} artifact${result.reset === 1 ? "" : "s"}.`
     );
-  }
-  if (!hookCapturePaused) {
-    process.exitCode = 1;
-    console.warn(
-      "FML integrations were removed, but cached agent processes may keep invoking hooks until they exit."
+    if (result.removed > 0) {
+      console.log(`Removed ${result.removed} missing artifact entries.`);
+    }
+    console.log(
+      "The next enabled sync will replay each artifact from byte zero."
     );
   }
-  if (opts.purge && !purgeComplete) {
+  if (result.skipped) {
     process.exitCode = 1;
-    console.warn(
-      "FML integrations were removed, but local data remains because a purge target could not be removed safely. Repair the reported path and rerun `fml uninstall --purge`."
-    );
+  } else {
+    await wakeObserverSync();
   }
-  console.log("\nDone! FML has been uninstalled.");
 }
 
-// src/commands/update.ts
-async function handleUpdate() {
-  const currentVersion = true ? "0.8.0-rc.1+60c9b7e1" : "unknown";
-  console.log(`Current: ${currentVersion}`);
-  console.log("Updating via pnpm...\n");
-  try {
-    const pnpm = resolveBin("pnpm");
-    if (!pnpm) throw new Error("pnpm was not found on PATH");
-    const env = { ...process.env };
-    delete env.npm_config_registry;
-    execBinSync(pnpm, ["add", "--global", "@fml-inc/fml@latest"], {
-      timeout: 12e4,
-      env
-    });
-    console.log("\nUpdated. Run `fml install` to reconfigure.");
-  } catch (err) {
-    Sentry.captureException(err);
-    const msg = err instanceof Error ? err.stderr?.toString() ?? err.message : String(err);
-    console.error("Update failed:", msg);
-    process.exit(1);
+// src/commands/daemon.ts
+async function handleFmlStart() {
+  await handleSyncEnable();
+}
+async function stopFml(opts = {}) {
+  setRawSyncEnabled(false);
+  const result = await stopObserver({ force: opts.force });
+  let stopped = result.status === "stopped" || result.status === "killed" || result.status === "not_running" || result.status === "stale_state";
+  if (stopped) {
+    try {
+      setHookCaptureDisabled(true);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      console.error(
+        `FML observer stopped, but the hook-capture pause could not be persisted: ${message}`
+      );
+      process.exitCode = 1;
+      stopped = false;
+    }
+  }
+  switch (result.status) {
+    case "stopped":
+      console.log(`FML observer stopped (PID ${result.pid}).`);
+      console.log("Agent activity sync is paused.");
+      break;
+    case "killed":
+      console.log(`FML observer stopped (PID ${result.pid}).`);
+      console.log("Agent activity sync is paused.");
+      break;
+    case "not_running":
+      console.log("FML observer is already stopped.");
+      console.log("Agent activity sync is paused.");
+      break;
+    case "stale_state":
+      console.log(
+        "FML observer is stopped. Old process state will be cleaned on the next start."
+      );
+      console.log("Agent activity sync is paused.");
+      break;
+    case "permission_denied":
+      console.error(
+        `Could not stop FML observer PID ${result.pid}: permission denied`
+      );
+      process.exitCode = 1;
+      break;
+    case "foreign_listener":
+      console.error("Refused to stop a different local observer instance");
+      process.exitCode = 1;
+      break;
+    case "ambiguous_live_process":
+      console.error(
+        `Refused to treat unverifiable live PID ${result.pid} as a stopped FML observer`
+      );
+      process.exitCode = 1;
+      break;
+    case "unresponsive":
+      console.error(
+        `Refused to signal unverifiable FML observer PID ${result.pid}; retry with \`fml stop --force\` to escalate`
+      );
+      process.exitCode = 1;
+      break;
+    case "signal_sent":
+      console.error(`FML observer PID ${result.pid} did not stop`);
+      process.exitCode = 1;
+      break;
+    case "force_stop_unverified":
+      console.error(
+        `Could not corroborate that PID ${result.pid} is the FML observer; refusing to signal it. If the observer is not running, remove ${result.stateFile}, ${result.lockFile}, ${result.databaseStateFile}, and ${result.databaseLockFile} manually.`
+      );
+      process.exitCode = 1;
+      break;
+  }
+  return stopped;
+}
+async function handleFmlStop(opts = {}) {
+  await stopFml(opts);
+}
+async function handleFmlRestart() {
+  if (await stopFml()) {
+    await handleFmlStart();
   }
 }
 
@@ -7194,8 +7173,9 @@ async function runServiceTokenLogin(refreshToken) {
   }
   await selectOrg(environment);
   console.log("Logged in with FML service token.");
-  console.log("Queries and sync will use the stored service token.");
-  console.log("You're all set! Restart Claude Code to use FML tools.");
+  console.log(
+    "Queries and agent activity sync will use the stored service token."
+  );
 }
 async function handleServiceTokenLogin(refreshToken) {
   try {
@@ -7212,16 +7192,12 @@ async function handleServiceTokenLogin(refreshToken) {
     process.exit(1);
   }
 }
-async function handleLogin(opts) {
-  if (opts?.serviceToken) {
-    await handleServiceTokenLogin();
-    return;
-  }
+async function runInteractiveLogin(opts = {}) {
   const environment = captureLoginEnvironment();
   const envName = environment.envName;
   const existingToken = await getValidToken({ env: envName });
   if (existingToken) {
-    const { readTokens: readTokens2 } = await import("./token-store-R7WXEPLI.js");
+    const { readTokens: readTokens2 } = await import("./token-store-BT5THIAJ.js");
     const stored = readTokens2(envName);
     if (stored?.tokenType === "service") {
       const label = stored.user.id === SERVICE_TOKEN_LOGIN_USER_ID ? "a service token" : `${stored.user.name} (${stored.user.email})`;
@@ -7233,23 +7209,27 @@ async function handleLogin(opts) {
     }
     await linkGitHubIdentity(environment);
     await selectOrg(environment);
-    console.log("You're all set! Restart Claude Code to use FML tools.");
-    process.exit(0);
+    return;
   }
   console.log(`Signing in to FML (${envName})...`);
+  const useDeviceFlow = opts.device || !await canOpenBrowser();
+  let result;
+  if (useDeviceFlow) {
+    result = await deviceLogin(environment);
+  } else {
+    result = await login(environment);
+  }
+  console.log(`Logged in as ${result.name} (${result.email})`);
+  await linkGitHubIdentity(environment);
+  await selectOrg(environment);
+}
+async function handleLogin(opts) {
+  if (opts?.serviceToken) {
+    await handleServiceTokenLogin();
+    return;
+  }
   try {
-    const useDeviceFlow = opts?.device || !await canOpenBrowser();
-    let result;
-    if (useDeviceFlow) {
-      result = await deviceLogin(environment);
-    } else {
-      result = await login(environment);
-    }
-    console.log(`
-Logged in as ${result.name} (${result.email})`);
-    await linkGitHubIdentity(environment);
-    await selectOrg(environment);
-    console.log("You're all set! Restart Claude Code to use FML tools.");
+    await runInteractiveLogin({ device: opts?.device });
     process.exit(0);
   } catch (err) {
     Sentry.captureException(err);
@@ -7259,742 +7239,891 @@ Logged in as ${result.name} (${result.email})`);
   }
 }
 
-// src/commands/logout.ts
-async function handleLogout() {
-  const { name } = getActiveEnv();
-  await clearStoredCredentials(name);
-  console.log(`Logged out of "${name}". Stored credentials cleared.`);
+// src/commands/setup.ts
+var defaultDependencies = {
+  install: () => handleInstall(),
+  getActiveToken: () => getValidToken({ env: getActiveEnv().name }),
+  login: () => runInteractiveLogin(),
+  stop: () => handleFmlStop(),
+  start: () => handleFmlStart()
+};
+async function runStep(name, operation) {
+  const priorExitCode = process.exitCode;
+  await operation();
+  if (process.exitCode && process.exitCode !== priorExitCode) {
+    throw new Error(`FML setup could not complete ${name}.`);
+  }
+}
+async function handleSetup(dependencies = defaultDependencies) {
+  if (process.exitCode) {
+    throw new Error("FML setup cannot run after an earlier command failure.");
+  }
+  console.log("Setting up FML...");
+  await runStep("integration installation", dependencies.install);
+  const token = await dependencies.getActiveToken();
+  if (token) {
+    console.log("Already signed in.");
+  } else {
+    await runStep("login", dependencies.login);
+  }
+  await runStep("observer stop", dependencies.stop);
+  await runStep("observer start", dependencies.start);
+  console.log("FML is ready.");
+  console.log("Start a new agent session to load FML tools.");
+  console.log("Run `fml doctor` to verify setup.");
 }
 
-// src/commands/org.ts
-async function handleOrg(slug) {
-  const environment = getActiveEnv();
-  const token = await getValidToken({ env: environment.name });
-  if (!token) {
-    console.error("Not logged in. Run `fml login` first.");
-    process.exit(1);
+// src/commands/uninstall.ts
+import fs12 from "fs";
+import os7 from "os";
+import path27 from "path";
+import readline from "readline/promises";
+var PURGE_WARNING = "This deletes FML credentials for ALL environments, logs, sync state, and every pending best-effort OTLP envelope.";
+function tryDisableHookCapture() {
+  try {
+    setHookCaptureDisabled(true);
+    return true;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.warn(
+      `Warning: Could not persist the hook-capture pause at ${FML_HOOK_CAPTURE_DISABLED_FILE}: ${message}`
+    );
+    return false;
   }
-  const api = createFmlClient(token, {
-    envName: environment.name,
-    siteUrl: getSiteUrlForConvexUrl(environment.convexUrl)
-  });
-  const orgs = await api.queryOrgs();
-  if (orgs.length === 0) {
-    console.error("No organizations found.");
-    process.exit(1);
+}
+function resolvePreservedPaths(preservedFile) {
+  const logicalPath = path27.resolve(preservedFile);
+  try {
+    const canonicalPath = fs12.realpathSync(preservedFile);
+    return pathsAreSame(canonicalPath, logicalPath) ? [logicalPath] : [logicalPath, canonicalPath];
+  } catch {
+    return [logicalPath];
   }
-  const current = getSelectedOrg(environment.name);
-  const currentId = getSelectedOrgId(environment.name);
-  if (!slug) {
-    console.log("Organizations:\n");
-    for (const org of orgs) {
-      const orgSlug = org.slug ?? org.name;
-      const marker = org._id === currentId || !currentId && orgSlug === current ? " (selected)" : "";
-      console.log(`  ${orgSlug}${marker}`);
-    }
-    if (!currentId && !current) {
-      console.log("\nNo org selected. Run `fml org <slug>` to select one.");
-    }
-    return;
+}
+function purgeDirectoryPreservingPaths(directory, preservedPaths, configuredRoot = false) {
+  const resolvedDirectory = path27.resolve(directory);
+  let directoryStats;
+  try {
+    directoryStats = fs12.lstatSync(directory);
+  } catch (error) {
+    if (error.code === "ENOENT") return true;
+    throw error;
   }
-  const match = orgs.find(
-    (o) => (o.slug ?? o.name) === slug || o.name === slug
-  );
-  if (!match) {
-    console.error(
-      `Organization "${slug}" not found. Available: ${orgs.map((o) => o.slug ?? o.name).join(", ")}`
+  if (directoryStats.isSymbolicLink()) {
+    if (configuredRoot) return false;
+    const containsLogicalMarker = preservedPaths.some(
+      (preservedPath) => pathContains(resolvedDirectory, preservedPath)
     );
-    process.exit(1);
-  }
-  const matchSlug = match.slug ?? match.name;
-  await setSelectedOrg(matchSlug, match._id, environment.name);
-  console.log(`Selected org: ${match.name} (${matchSlug})`);
-}
-
-// src/commands/open.ts
-var DEFAULT_APP_BASE_URL = "https://app.fml.app";
-function appBaseUrl() {
-  const configured = process.env.FML_APP_URL?.trim();
-  return (configured || DEFAULT_APP_BASE_URL).replace(/\/+$/, "");
-}
-async function handleOpen(opts) {
-  const environment = getActiveEnv();
-  const api = await getAuthenticatedClient(environment);
-  if (!api) {
-    console.error("Not authenticated. Run `fml login` first.");
-    process.exit(1);
+    if (!containsLogicalMarker) {
+      fs12.rmSync(directory, { force: true });
+      return true;
+    }
+    return false;
   }
-  let slug;
+  const directoryPaths = [resolvedDirectory];
   try {
-    const orgs = await api.queryOrgs();
-    if (orgs.length === 0) {
-      console.error("No organizations found.");
-      process.exit(1);
+    const canonicalDirectory = fs12.realpathSync(directory);
+    if (!pathsAreSame(canonicalDirectory, resolvedDirectory)) {
+      directoryPaths.push(canonicalDirectory);
     }
-    const selected = getSelectedOrg(environment.name);
-    const org = selected && orgs.find((candidate) => {
-      const candidateSlug = candidate.slug ?? candidate.name;
-      return candidateSlug === selected || candidate.name === selected;
-    }) || orgs[0];
-    slug = org.slug ?? org.name;
   } catch {
-    console.error("Could not fetch organizations. Opening base URL.");
-    slug = "";
   }
-  const baseUrl = appBaseUrl();
-  const url = slug ? `${baseUrl}/${slug}` : baseUrl;
-  if (opts.json) {
-    console.log(JSON.stringify({ url }));
-  } else {
-    const openBrowser = (await import("open")).default;
-    await openBrowser(url);
+  const containsPreservedPath = directoryPaths.some(
+    (directoryPath) => preservedPaths.some(
+      (preservedPath) => pathContains(directoryPath, preservedPath)
+    )
+  );
+  if (!containsPreservedPath) {
+    fs12.rmSync(directory, { recursive: true, force: true });
+    return true;
   }
-}
-
-// src/commands/status.ts
-function formatBytes(bytes) {
-  if (bytes < 1024) return `${bytes} B`;
-  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KiB`;
-  if (bytes < 1024 * 1024 * 1024) {
-    return `${(bytes / (1024 * 1024)).toFixed(1)} MiB`;
+  const isPreservedPath = directoryPaths.some(
+    (directoryPath) => preservedPaths.some(
+      (preservedPath) => pathsAreSame(directoryPath, path27.resolve(preservedPath))
+    )
+  );
+  if (isPreservedPath) return true;
+  if (!directoryStats.isDirectory()) return false;
+  let entries;
+  try {
+    entries = fs12.readdirSync(directory);
+  } catch (error) {
+    if (error.code === "ENOENT") return true;
+    throw error;
   }
-  return `${(bytes / (1024 * 1024 * 1024)).toFixed(2)} GiB`;
-}
-function hookSpoolStatus(value) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) {
-    return void 0;
+  let complete = true;
+  for (const entry of entries) {
+    const entryPath = path27.join(directory, entry);
+    if (!purgeDirectoryPreservingPaths(entryPath, preservedPaths, false)) {
+      complete = false;
+    }
   }
-  const record = value;
-  const nonNegativeInteger = (field) => {
-    const candidate = record[field];
-    return typeof candidate === "number" && Number.isSafeInteger(candidate) && candidate >= 0 ? candidate : void 0;
-  };
-  const logicalBytes = nonNegativeInteger("logicalBytes");
-  const evictedRecords = nonNegativeInteger("evictedRecords");
-  const evictedBytes = nonNegativeInteger("evictedBytes");
-  const evictedPendingRecords = nonNegativeInteger("evictedPendingRecords");
-  const evictedQuarantinedRecords = nonNegativeInteger(
-    "evictedQuarantinedRecords"
+  return complete;
+}
+function purgeDirectoryPreservingFiles(directory, preservedFiles) {
+  if (hasSymlinkedParentBelowTrustedAnchor(directory)) return false;
+  return purgeDirectoryPreservingPaths(
+    directory,
+    preservedFiles.flatMap(
+      (preservedFile) => resolvePreservedPaths(preservedFile)
+    ),
+    true
   );
-  const maxBytes = record.maxBytes;
-  const quarantineMaxAgeMs = record.quarantineMaxAgeMs;
-  if (record.unit !== "logical_bytes" || logicalBytes === void 0 || evictedRecords === void 0 || evictedBytes === void 0 || evictedPendingRecords === void 0 || evictedQuarantinedRecords === void 0 || maxBytes !== null && (typeof maxBytes !== "number" || !Number.isSafeInteger(maxBytes) || maxBytes < 1)) {
-    return void 0;
-  }
-  const lastEvictedAtMsValue = nonNegativeInteger("lastEvictedAtMs");
-  const lastEvictedAtMs = lastEvictedAtMsValue !== void 0 && lastEvictedAtMsValue <= 864e13 ? lastEvictedAtMsValue : void 0;
-  return {
-    logicalBytes,
-    maxBytes,
-    ...quarantineMaxAgeMs === null ? { quarantineMaxAgeMs: null } : typeof quarantineMaxAgeMs === "number" && Number.isSafeInteger(quarantineMaxAgeMs) && quarantineMaxAgeMs > 0 ? { quarantineMaxAgeMs } : {},
-    evictedRecords,
-    evictedBytes,
-    evictedPendingRecords,
-    evictedQuarantinedRecords,
-    ...lastEvictedAtMs === void 0 ? {} : { lastEvictedAtMs }
-  };
 }
-function otlpSpoolStatus(value) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) {
-    return void 0;
-  }
-  const record = value;
-  const nonNegativeInteger = (field) => {
-    const candidate = record[field];
-    return typeof candidate === "number" && Number.isSafeInteger(candidate) && candidate >= 0 ? candidate : void 0;
-  };
-  const logicalBytes = nonNegativeInteger("logicalBytes");
-  const bodyBytes = nonNegativeInteger("bodyBytes");
-  const maxBytes = nonNegativeInteger("maxBytes");
-  const droppedRecords = nonNegativeInteger("droppedRecords");
-  const droppedLogicalBytes = nonNegativeInteger("droppedLogicalBytes");
-  const droppedBodyBytes = nonNegativeInteger("droppedBodyBytes");
-  if (record.unit !== "logical_bytes" || logicalBytes === void 0 || bodyBytes === void 0 || maxBytes === void 0 || maxBytes < 1 || droppedRecords === void 0 || droppedLogicalBytes === void 0 || droppedBodyBytes === void 0 || bodyBytes > logicalBytes || droppedBodyBytes > droppedLogicalBytes) {
-    return void 0;
+function finishCustomRootPurge(directory) {
+  const marker = managedDirectoryMarker(directory);
+  fs12.rmSync(marker, { force: true });
+  try {
+    fs12.rmdirSync(directory);
+  } catch (error) {
+    if (error.code === "ENOENT") return;
+    try {
+      fs12.writeFileSync(marker, FML_MANAGED_DIRECTORY_MARKER_CONTENT, {
+        encoding: "utf8",
+        flag: "wx",
+        mode: 384
+      });
+    } catch (markerError) {
+      if (markerError.code === "EEXIST" && hasManagedDirectoryMarker(directory)) {
+        throw error;
+      }
+      const removalMessage = error instanceof Error ? error.message : String(error);
+      const markerMessage = markerError instanceof Error ? markerError.message : String(markerError);
+      throw new Error(
+        `could not remove ${directory} (${removalMessage}) or restore its FML ownership marker (${markerMessage})`
+      );
+    }
+    throw error;
   }
-  return {
-    logicalBytes,
-    bodyBytes,
-    maxBytes,
-    droppedRecords,
-    droppedLogicalBytes,
-    droppedBodyBytes,
-    ...typeof record.lastDroppedAtMs === "number" && Number.isSafeInteger(record.lastDroppedAtMs) && record.lastDroppedAtMs >= 0 && Number.isFinite(new Date(record.lastDroppedAtMs).getTime()) ? { lastDroppedAtMs: record.lastDroppedAtMs } : {},
-    ...typeof record.lastDropReason === "string" ? { lastDropReason: record.lastDropReason } : {}
-  };
 }
-function observerQueueStatus(value, key) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
-  const queue = value[key];
-  if (!queue || typeof queue !== "object" || Array.isArray(queue)) return null;
-  const record = queue;
-  if (typeof record.phase !== "string" || typeof record.pending !== "number" || !Number.isSafeInteger(record.pending) || record.pending < 0) {
-    return null;
+function cleanInstalledPluginScopes(paths) {
+  const installedPlugins = readJsonFile(paths.installedPluginsPath);
+  if (!installedPlugins) return;
+  const update = CLAUDE_PLUGIN_INSTALLER.removeInstalledPlugin(
+    installedPlugins,
+    CLAUDE_PLUGIN_INSTALLER.pluginId
+  );
+  if (!update.changed) return;
+  for (const settingsPath2 of CLAUDE_PLUGIN_INSTALLER.projectSettingsPaths(
+    installedPlugins,
+    CLAUDE_PLUGIN_INSTALLER.pluginId
+  )) {
+    removeEnabledPluginFromSettings(
+      settingsPath2,
+      CLAUDE_PLUGIN_INSTALLER.pluginId
+    );
   }
-  return {
-    phase: record.phase,
-    pending: record.pending,
-    ...typeof record.quarantined === "number" && Number.isSafeInteger(record.quarantined) && record.quarantined >= 0 ? { quarantined: record.quarantined } : {},
-    ...typeof record.lastError === "string" ? { lastError: record.lastError } : {},
-    ...typeof record.lastWarning === "string" ? { lastWarning: record.lastWarning } : {},
-    ...typeof record.nextAttemptAtMs === "number" && Number.isSafeInteger(record.nextAttemptAtMs) && record.nextAttemptAtMs >= 0 && Number.isFinite(new Date(record.nextAttemptAtMs).getTime()) ? { nextAttemptAtMs: record.nextAttemptAtMs } : {}
-  };
+  writeJsonFile(paths.installedPluginsPath, update.installedPlugins);
 }
-function hookStatus(value) {
-  const status = observerQueueStatus(value, "hooks");
-  if (!status || !value || typeof value !== "object" || Array.isArray(value)) {
-    return null;
-  }
-  const hooks = value.hooks;
-  if (!hooks || typeof hooks !== "object" || Array.isArray(hooks)) return null;
-  const record = hooks;
-  const spool = hookSpoolStatus(record.spool);
-  return {
-    ...status,
-    ...typeof record.rejected === "number" && Number.isSafeInteger(record.rejected) && record.rejected >= 0 ? { rejected: record.rejected } : {},
-    ...typeof record.lastRejectedReason === "string" ? { lastRejectedReason: record.lastRejectedReason } : {},
-    ...typeof record.lastRejectedTarget === "string" ? { lastRejectedTarget: record.lastRejectedTarget } : {},
-    ...spool === void 0 ? {} : { spool }
-  };
+function purgeWarning(roots) {
+  return `${PURGE_WARNING}
+Purge roots:
+${roots.map((root) => `  - ${root.directory}`).join("\n")}`;
 }
-function otlpStatus(value) {
-  const status = observerQueueStatus(value, "otlp");
-  if (!status || !value || typeof value !== "object" || Array.isArray(value)) {
-    return null;
+async function confirmPurge(opts, roots) {
+  const warning = purgeWarning(roots);
+  if (opts.assumeYes) {
+    console.log(warning);
+    return true;
   }
-  const otlp = value.otlp;
-  if (!otlp || typeof otlp !== "object" || Array.isArray(otlp)) return null;
-  const spool = otlpSpoolStatus(otlp.spool);
-  return {
-    ...status,
-    ...spool === void 0 ? {} : { spool }
-  };
-}
-async function handleStatus() {
-  const { name, convexUrl } = getActiveEnv();
-  console.log(`Environment: ${name}`);
-  console.log(`  Convex: ${convexUrl ?? "not configured"}
-`);
-  const tokens = readTokens(name);
-  if (!tokens) {
-    console.log("Authentication:");
-    console.log("  Not authenticated. Run `fml login` to sign in.");
-  } else {
-    const tokenValid = await getValidToken({ env: name });
-    console.log("Authentication:");
-    if (tokens.tokenType === "service" && tokens.user.id === SERVICE_TOKEN_LOGIN_USER_ID) {
-      console.log("  Auth:  service token");
-    } else {
-      console.log(`  User:  ${tokens.user.name} (${tokens.user.email})`);
-    }
-    console.log(
-      `  Token: ${tokenValid ? "valid" : "expired (needs refresh/re-login)"}`
-    );
-    console.log(
-      `  Org:   ${tokens.orgSlug ?? "(none \u2014 run `fml org <slug>`)"}`
+  const input = opts.input ?? process.stdin;
+  if (input.isTTY !== true) {
+    console.error(
+      `${warning}
+Re-run with --yes to confirm in a non-interactive session.`
     );
+    return false;
   }
-  const syncStatus = createRawArtifactSync({
-    stateDir: FML_OBSERVER_DIR
-  }).status();
-  console.log("\nRaw artifact sync:");
-  console.log(`  Enabled:   ${syncStatus.settings.enabled ? "yes" : "no"}`);
-  console.log(`  Tracked:   ${syncStatus.queue.tracked}`);
-  console.log(`  Pending:   ${syncStatus.queue.pending}`);
-  console.log(`  Raw work:  ${syncStatus.queue.rawPending}`);
-  console.log(`  Metadata:  ${syncStatus.queue.metadataPending}`);
-  console.log(`  Uploaded:  ${syncStatus.queue.uploaded}`);
-  console.log(`  Failed:    ${syncStatus.queue.failed}`);
-  console.log(
-    `  Watermark: ${formatBytes(syncStatus.queue.uploadedBytes)} / ${formatBytes(syncStatus.queue.totalBytes)}`
-  );
-  console.log(`  Remaining: ${formatBytes(syncStatus.queue.remainingBytes)}`);
-  const observer = await readObserverRuntimeStatus();
-  const protectedStatus = observer.healthy ? await readObserverProtectedStatus() : null;
-  const observerState = observer.stateStatus.state;
-  console.log("\nLocal observer:");
-  console.log(
-    `  Status: ${observer.healthy ? "running" : observer.running ? "unhealthy" : "stopped"}`
-  );
-  if (observerState) {
-    console.log(`  PID:    ${observerState.pid}`);
-    console.log(`  Phase:  ${observerState.phase}`);
-    if (observerState.lastOutcome) {
-      console.log(`  Last:   ${observerState.lastOutcome}`);
-    }
+  const rl = readline.createInterface({
+    input,
+    output: opts.output ?? process.stdout
+  });
+  try {
+    const closed = new Promise((resolve) => {
+      rl.once("close", () => resolve(null));
+    });
+    const answer = await Promise.race([
+      rl.question(`${warning}
+Type y to continue: `).catch(() => null),
+      closed
+    ]);
+    if (answer !== null && answer.trim().toLowerCase() === "y") return true;
+  } finally {
+    rl.close();
   }
-  console.log(`  Log:    ${observer.logFile}`);
-  const hooks = hookStatus(protectedStatus);
-  const hookInbox = readHookInboxStatus();
-  console.log("\nHook capture:");
-  if (!hooks) {
-    console.log(`  Status:  ${observer.healthy ? "unavailable" : "stopped"}`);
-  } else {
-    console.log(`  Status:  ${hooks.phase}`);
-    console.log(`  Pending: ${hooks.pending}`);
-    if (hooks.quarantined && hooks.quarantined > 0) {
-      console.log(`  Quarantined: ${hooks.quarantined}`);
-    }
-    if (hooks.rejected && hooks.rejected > 0) {
-      console.log(`  Rejected: ${hooks.rejected}`);
-      if (hooks.lastRejectedReason) {
-        console.log(
-          `  Last rejection: ${hooks.lastRejectedReason}${hooks.lastRejectedTarget ? ` (${hooks.lastRejectedTarget})` : ""}`
-        );
-      }
+  console.error("Uninstall canceled; nothing was removed.");
+  return false;
+}
+function refuseUnsafePurge(roots) {
+  const unsafeRoots = unsafePurgeRoots(roots);
+  if (unsafeRoots.length === 0) return false;
+  console.error("Refusing to purge unsafe FML directories:");
+  for (const root of unsafeRoots) {
+    console.error(`  - ${root.directory}: ${root.reason}`);
+  }
+  console.error(
+    "Inspect and remove those roots manually, or reconfigure FML to fresh dedicated empty data, state, log, and observer directories and run `fml install` before retrying."
+  );
+  process.exitCode = 1;
+  return true;
+}
+async function handleUninstall(opts) {
+  const purgeRoots = opts.purge ? configuredManagedRoots() : [];
+  if (opts.purge) {
+    if (refuseUnsafePurge(purgeRoots)) return;
+    if (!await confirmPurge(opts, purgeRoots)) {
+      process.exitCode = 1;
+      return;
     }
-    if (hooks.spool) {
-      console.log(
-        `  Spool:   ${formatBytes(hooks.spool.logicalBytes)} / ${hooks.spool.maxBytes === null ? "unbounded" : formatBytes(hooks.spool.maxBytes)} (logical content)`
-      );
-      if (hooks.spool.quarantineMaxAgeMs !== void 0) {
-        console.log(
-          `  Quarantine retention: ${hooks.spool.quarantineMaxAgeMs === null ? "unbounded" : `${Math.round(hooks.spool.quarantineMaxAgeMs / 864e5)} day(s)`}`
-        );
-      }
-      if (hooks.spool.evictedRecords > 0) {
-        console.log(
-          `  Evicted: ${hooks.spool.evictedRecords} record(s), ${formatBytes(hooks.spool.evictedBytes)} (${hooks.spool.evictedQuarantinedRecords} quarantined, ${hooks.spool.evictedPendingRecords} pending)`
-        );
-        if (hooks.spool.lastEvictedAtMs !== void 0) {
-          console.log(
-            `  Last eviction: ${new Date(hooks.spool.lastEvictedAtMs).toISOString()}`
-          );
-        }
+    for (const root of purgeRoots) {
+      if (!fs12.existsSync(root.directory) && pathContains(root.directory, FML_OBSERVER_DIR)) {
+        prepareManagedDirectory(root);
       }
     }
-    if (hooks.lastError) console.log(`  Error:   ${hooks.lastError}`);
+    if (refuseUnsafePurge(purgeRoots)) return;
   }
-  if (hookInbox.unreadable) {
-    console.log("  Inbox:   unavailable");
-  } else {
-    console.log(
-      `  Inbox:   ${hookInbox.pendingEntries} pending (${formatBytes(hookInbox.pendingBytes)})`
+  console.log("Removing FML integrations...\n");
+  const otelDestination = readLocalObserverOtelDestination({
+    endpointFile: FML_OBSERVER_ENDPOINT_FILE,
+    authTokenFile: FML_OBSERVER_AUTH_TOKEN_FILE
+  });
+  let observer;
+  try {
+    observer = await stopObserver();
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    console.error(
+      "Could not safely stop the FML observer; uninstall was aborted. Repair the reported files and rerun `fml uninstall`."
     );
-    console.log(
-      `  Inbox limits: ${hookInbox.maxBytes === null ? "unbounded bytes" : formatBytes(hookInbox.maxBytes)}, ${hookInbox.maxEntries === null ? "unbounded entries" : `${hookInbox.maxEntries} entries`}`
+    process.exitCode = 1;
+    return;
+  }
+  if (observer.status === "permission_denied" || observer.status === "foreign_listener" || observer.status === "ambiguous_live_process" || observer.status === "unresponsive" || observer.status === "signal_sent") {
+    console.error(
+      `Could not safely stop FML observer PID ${observer.pid}; uninstall was aborted.`
     );
-    if (hookInbox.capacityRejectedEntries > 0) {
-      console.log(
-        `  Inbox capacity refusals: ${hookInbox.capacityRejectedEntries} record(s), ${formatBytes(hookInbox.capacityRejectedBytes)}`
-      );
-      if (hookInbox.lastCapacityRejectedAtMs !== void 0) {
-        console.log(
-          `  Last inbox refusal: ${new Date(hookInbox.lastCapacityRejectedAtMs).toISOString()}${hookInbox.lastCapacityRejectionReason ? ` (${hookInbox.lastCapacityRejectionReason})` : ""}`
-        );
-      }
+    process.exitCode = 1;
+    return;
+  }
+  let hookCapturePaused = tryDisableHookCapture();
+  createRawArtifactSync({ stateDir: FML_OBSERVER_DIR }).setEnabled(false);
+  const paths = CLAUDE_PLUGIN_INSTALLER.resolvePaths({
+    env: process.env,
+    homeDir: os7.homedir()
+  });
+  const claudeBin = resolveBin("claude");
+  if (claudeBin) {
+    try {
+      const command = CLAUDE_PLUGIN_INSTALLER.uninstallCommand;
+      execBinSync(claudeBin, [...command.args], {
+        timeout: command.timeoutMs
+      });
+    } catch {
     }
-    if (hookInbox.retiredEntries > 0) {
-      console.log(
-        `  Inbox retired: ${hookInbox.retiredEntries} record(s), ${formatBytes(hookInbox.retiredBytes)}`
+  }
+  cleanInstalledPluginScopes(paths);
+  const settings = readJsonFile(paths.settingsPath);
+  if (settings) {
+    const marketplace2 = readJsonFile(paths.marketplaceManifestPath);
+    const keepLocalMarketplace = CLAUDE_PLUGIN_INSTALLER.hasOtherLocalMarketplacePlugins(
+      settings,
+      marketplace2
+    );
+    writeJsonFile(
+      paths.settingsPath,
+      CLAUDE_PLUGIN_INSTALLER.disableInSettings(settings, keepLocalMarketplace)
+    );
+  }
+  let skillsRemoved = true;
+  try {
+    for (const result of removeManagedAgentSkills(resolvePackageRoot())) {
+      if (result.status !== "preserved" && !result.reason) continue;
+      skillsRemoved = false;
+      const targets = result.displayNames.join(", ");
+      console.warn(
+        `Warning: Preserved ${result.destinationPath} for ${targets}: ${result.reason ?? "cleanup could not be verified"}`
       );
     }
+  } catch (error) {
+    skillsRemoved = false;
+    const message = error instanceof Error ? error.message : String(error);
+    console.warn(
+      `Warning: Agent skill cleanup could not be completed: ${message}`
+    );
   }
-  const otlp = otlpStatus(protectedStatus);
-  console.log("\nNative OpenTelemetry:");
-  if (!otlp) {
-    console.log(`  Status:  ${observer.healthy ? "unavailable" : "stopped"}`);
-  } else {
-    console.log(`  Status:  ${otlp.phase}`);
-    console.log(`  Pending: ${otlp.pending}`);
-    if (otlp.spool) {
-      const usedPercent = otlp.spool.logicalBytes / otlp.spool.maxBytes * 100;
-      console.log(
-        `  Spool:   ${formatBytes(otlp.spool.logicalBytes)} / ${formatBytes(otlp.spool.maxBytes)} (${usedPercent.toFixed(1)}%; ${formatBytes(otlp.spool.bodyBytes)} encoded bodies)`
+  let integrationsRemoved = true;
+  if (removeMarketplaceLink(paths.marketplaceLinkPath) === "preserved") {
+    integrationsRemoved = false;
+    console.warn(
+      `Warning: Preserved non-symlink marketplace path ${paths.marketplaceLinkPath}`
+    );
+  }
+  const marketplace = readJsonFile(paths.marketplaceManifestPath);
+  if (marketplace && Array.isArray(marketplace.plugins)) {
+    writeJsonFile(
+      paths.marketplaceManifestPath,
+      CLAUDE_PLUGIN_INSTALLER.removeMarketplaceEntry(
+        marketplace,
+        CLAUDE_PLUGIN_INSTALLER.pluginName
+      )
+    );
+  }
+  fs12.rmSync(paths.pluginCacheDir, { recursive: true, force: true });
+  const reportIntegrationWarning = (message) => {
+    integrationsRemoved = false;
+    console.warn(message.replace(/^warn:/u, "Warning:"));
+  };
+  let hookRemovalComplete = true;
+  removeFmlHooks({
+    onFailure: (target2) => {
+      hookRemovalComplete = false;
+      reportIntegrationWarning(
+        `Warning: Preserved FML hook registration at ${target2.configPath}: ${target2.reason}`
       );
-      if (usedPercent >= 80) {
-        console.log(
-          `  Attention: the oldest pending telemetry is dropped when the spool reaches ${formatBytes(otlp.spool.maxBytes)}`
-        );
-      }
-      if (otlp.spool.droppedRecords > 0) {
-        console.log(
-          `  Dropped: ${otlp.spool.droppedRecords} envelope(s), ${formatBytes(otlp.spool.droppedLogicalBytes)} logical; ${formatBytes(otlp.spool.droppedBodyBytes)} encoded bodies`
-        );
-        if (otlp.spool.lastDropReason) {
-          console.log(
-            `  Last drop: ${otlp.spool.lastDropReason}${otlp.spool.lastDroppedAtMs === void 0 ? "" : ` at ${new Date(otlp.spool.lastDroppedAtMs).toISOString()}`}`
-          );
-        }
-      }
     }
-    if (otlp.lastError) console.log(`  Error:   ${otlp.lastError}`);
-    if (otlp.lastWarning) console.log(`  Warning: ${otlp.lastWarning}`);
-    if (otlp.nextAttemptAtMs !== void 0) {
-      console.log(
-        `  Next attempt: ${new Date(otlp.nextAttemptAtMs).toISOString()}`
-      );
+  });
+  if (!hookRemovalComplete) {
+    integrationsRemoved = false;
+    process.exitCode = 1;
+    console.warn(
+      "Warning: Some FML hook registrations were preserved; repair the paths reported above and rerun `fml uninstall`."
+    );
+  }
+  removeFmlOtel(otelDestination, { warn: reportIntegrationWarning });
+  if (!otelDestination) {
+    integrationsRemoved = false;
+    console.warn(
+      "Warning: The local observer endpoint or token is unavailable; only recorded OpenTelemetry profiles could be cleaned"
+    );
+  }
+  removeFmlDirectMcp("all", {
+    log: () => void 0,
+    warn: reportIntegrationWarning
+  });
+  let purgeComplete = true;
+  if (opts.purge) {
+    if (refuseUnsafePurge(purgeRoots)) {
+      purgeComplete = false;
+    } else {
+      for (const root of purgeRoots) {
+        if (refuseUnsafePurge([root])) {
+          purgeComplete = false;
+          continue;
+        }
+        const containsObserverDirectory = pathContains(
+          root.directory,
+          FML_OBSERVER_DIR
+        );
+        const customManagedRoot = !root.nativeDefault;
+        try {
+          const purged = purgeDirectoryPreservingFiles(root.directory, [
+            ...customManagedRoot ? [managedDirectoryMarker(root.directory)] : [],
+            ...containsObserverDirectory && hookCapturePaused ? [FML_HOOK_CAPTURE_DISABLED_FILE] : []
+          ]);
+          if (!purged) {
+            purgeComplete = false;
+            console.warn(
+              `Warning: Preserved ${root.directory}: a symbolic link prevents a complete safe purge`
+            );
+            continue;
+          }
+          if (customManagedRoot && !containsObserverDirectory) {
+            finishCustomRootPurge(root.directory);
+          }
+        } catch (error) {
+          purgeComplete = false;
+          const message = error instanceof Error ? error.message : String(error);
+          console.warn(
+            `Warning: Preserved ${root.directory}: the safe purge was incomplete: ${message}`
+          );
+        }
+      }
     }
+    if (!hookCapturePaused) hookCapturePaused = tryDisableHookCapture();
+  }
+  if (!hookCapturePaused) {
+    process.exitCode = 1;
+    integrationsRemoved = false;
+    console.warn(
+      "Warning: FML cleanup is incomplete; cached agent processes may keep invoking hooks until they exit."
+    );
+  }
+  if (opts.purge && !purgeComplete) {
+    process.exitCode = 1;
+    console.warn(
+      "Warning: Some local data remains because a purge target could not be removed safely. Repair the reported path and rerun `fml uninstall --purge`."
+    );
+  }
+  if (skillsRemoved) {
+    console.log("\u2713  Agent skills removed");
+  } else {
+    console.warn(
+      "Warning: Agent skills were not fully removed. See warnings above."
+    );
+  }
+  if (integrationsRemoved) {
+    console.log("\u2713  Coding-agent integrations removed");
+  } else {
+    console.warn(
+      "Warning: Coding-agent integrations were not fully removed. See warnings above."
+    );
+  }
+  if (!opts.purge) {
+    console.log("\u2713  Local data preserved");
+  } else if (purgeComplete && hookCapturePaused) {
+    console.log("\u2713  Local data deleted");
+  } else {
+    console.warn(
+      "Warning: Local data was not fully deleted. See warnings above."
+    );
+  }
+  const removalComplete = skillsRemoved && integrationsRemoved && (!opts.purge || purgeComplete && hookCapturePaused);
+  if (removalComplete) {
+    console.log("\nFML integrations removed.");
+  } else {
+    console.warn(
+      "FML integration removal is incomplete; review the warnings above."
+    );
   }
 }
 
-// src/commands/sync.ts
-import { statSync } from "fs";
-function rawSync() {
-  return createCliRawSync();
-}
-function formatBytes2(bytes) {
-  if (bytes < 1024) return `${bytes} B`;
-  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KiB`;
-  if (bytes < 1024 * 1024 * 1024) {
-    return `${(bytes / (1024 * 1024)).toFixed(1)} MiB`;
+// src/commands/update.ts
+var SEMVER_PATTERN = /^(?:0|[1-9][0-9]*)\.(?:0|[1-9][0-9]*)\.(?:0|[1-9][0-9]*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
+function getCurrentVersion() {
+  return true ? "0.8.0-rc.2+bed6eaed" : "unknown";
+}
+function resolveUpdateChannel(version) {
+  const match = SEMVER_PATTERN.exec(version);
+  if (!match) return "latest";
+  const prerelease = match[1];
+  if (!prerelease) return "latest";
+  return prerelease.split(".").every((identifier) => {
+    return !(identifier.length > 1 && identifier.startsWith("0") && /^[0-9]+$/u.test(identifier));
+  }) ? "next" : "latest";
+}
+function resolveUpdateTarget(version) {
+  return `@fml-inc/fml@${resolveUpdateChannel(version)}`;
+}
+function createUpdateEnvironment(env) {
+  const updateEnv = { ...env };
+  for (const key of Object.keys(updateEnv)) {
+    if (key.toLowerCase() === "npm_config_registry") {
+      delete updateEnv[key];
+    }
+  }
+  return updateEnv;
+}
+function formatUpdateError(err) {
+  if (!(err instanceof Error)) return String(err);
+  const stderr = err.stderr;
+  if (typeof stderr === "string") return stderr;
+  if (Buffer.isBuffer(stderr)) return stderr.toString();
+  return err.message;
+}
+async function handleUpdate(overrides = {}) {
+  const dependencies = {
+    currentVersion: getCurrentVersion(),
+    env: process.env,
+    resolveBin,
+    execBinSync,
+    captureException: Sentry.captureException,
+    log: console.log,
+    error: console.error,
+    exit: process.exit,
+    ...overrides
+  };
+  const channel = resolveUpdateChannel(dependencies.currentVersion);
+  const target2 = resolveUpdateTarget(dependencies.currentVersion);
+  dependencies.log(`Current version: ${dependencies.currentVersion}`);
+  dependencies.log(`Updating FML from the ${channel} channel...
+`);
+  try {
+    const npm = dependencies.resolveBin("npm");
+    if (!npm) throw new Error("npm was not found on PATH");
+    dependencies.execBinSync(npm, ["install", "--global", target2], {
+      timeout: 12e4,
+      env: createUpdateEnvironment(dependencies.env)
+    });
+    dependencies.log(`
+FML update complete (${channel} channel).`);
+    dependencies.log("Run `fml setup` to refresh integrations.");
+  } catch (err) {
+    dependencies.captureException(err);
+    dependencies.error("Update failed:", formatUpdateError(err));
+    dependencies.exit(1);
   }
-  return `${(bytes / (1024 * 1024 * 1024)).toFixed(2)} GiB`;
 }
-function formatDuration(durationMs) {
-  if (durationMs < 1e3) return `${Math.round(durationMs)} ms`;
-  return `${(durationMs / 1e3).toFixed(2)} s`;
-}
-function printRepositoryResolution(metrics) {
-  if (metrics.attempted === 0 && metrics.budgetSkipped === 0) return;
+
+// src/commands/logout.ts
+async function handleLogout() {
+  const { name } = getActiveEnv();
+  await clearStoredCredentials(name);
   console.log(
-    `  Repo checks:      ${metrics.attempted} (${metrics.resolved} resolved, ${metrics.unresolved} unresolved, ${metrics.cacheHits} cached, ${metrics.budgetSkipped} skipped by budget)`
+    `Logged out. Stored credentials for the ${name} environment were cleared.`
   );
-  console.log(
-    `  Repo check time:  ${formatDuration(metrics.elapsedMs)} total, ${formatDuration(metrics.slowestMs)} slowest`
+}
+
+// src/commands/org.ts
+async function handleOrg(slug) {
+  const environment = getActiveEnv();
+  const token = await getValidToken({ env: environment.name });
+  if (!token) {
+    console.error("Not logged in. Run `fml login` first.");
+    process.exit(1);
+  }
+  const api = createFmlClient(token, {
+    envName: environment.name,
+    siteUrl: getSiteUrlForConvexUrl(environment.convexUrl)
+  });
+  const orgs = await api.queryOrgs();
+  if (orgs.length === 0) {
+    console.error("No organizations found.");
+    process.exit(1);
+  }
+  const current = getSelectedOrg(environment.name);
+  const currentId = getSelectedOrgId(environment.name);
+  if (!slug) {
+    console.log("Organizations:\n");
+    for (const org of orgs) {
+      const orgSlug = org.slug ?? org.name;
+      const marker = org._id === currentId || !currentId && orgSlug === current ? " (selected)" : "";
+      console.log(`  ${orgSlug}${marker}`);
+    }
+    if (!currentId && !current) {
+      console.log("\nNo org selected. Run `fml org <slug>` to select one.");
+    }
+    return;
+  }
+  const match = orgs.find(
+    (o) => (o.slug ?? o.name) === slug || o.name === slug
   );
+  if (!match) {
+    console.error(
+      `Organization "${slug}" not found. Available: ${orgs.map((o) => o.slug ?? o.name).join(", ")}`
+    );
+    process.exit(1);
+  }
+  const matchSlug = match.slug ?? match.name;
+  await setSelectedOrg(matchSlug, match._id, environment.name);
+  console.log(`Selected org: ${match.name} (${matchSlug})`);
 }
-function writeJson(value) {
-  console.log(JSON.stringify(value, null, 2));
+
+// src/commands/open.ts
+var DEFAULT_APP_BASE_URL = "https://app.fml.inc";
+function appBaseUrl() {
+  const configured = process.env.FML_APP_URL?.trim();
+  return (configured || DEFAULT_APP_BASE_URL).replace(/\/+$/, "");
 }
-function warnRetainedLegacyDatabase(retained) {
-  if (retained.pendingEvents !== null && retained.pendingHookEvents !== null && retained.pendingOtlpEnvelopes !== null) {
-    console.warn(
-      `Retained legacy observer database at ${retained.databaseFile} with ${retained.pendingEvents} pending rows (${retained.pendingHookEvents} hook, ${retained.pendingOtlpEnvelopes} OTLP); FML will not sync those rows automatically.`
+async function handleOpen(opts) {
+  const environment = getActiveEnv();
+  const api = await getAuthenticatedClient(environment);
+  if (!api) {
+    console.error("Not signed in. Run `fml login` first.");
+    process.exit(1);
+  }
+  let slug;
+  try {
+    const orgs = await api.queryOrgs();
+    if (orgs.length === 0) {
+      console.error("No organizations are available for this account.");
+      process.exit(1);
+    }
+    const selected = getSelectedOrg(environment.name);
+    const org = selected && orgs.find((candidate) => {
+      const candidateSlug = candidate.slug ?? candidate.name;
+      return candidateSlug === selected || candidate.name === selected;
+    }) || orgs[0];
+    slug = org.slug ?? org.name;
+  } catch {
+    console.error(
+      "Could not load your organizations. Opening the FML dashboard."
     );
-    return;
+    slug = "";
+  }
+  const baseUrl = appBaseUrl();
+  const url = slug ? `${baseUrl}/${slug}` : baseUrl;
+  if (opts.json) {
+    console.log(JSON.stringify({ url }));
+  } else {
+    const openBrowser = (await import("open")).default;
+    await openBrowser(url);
   }
-  console.warn(
-    `Retained legacy observer database at ${retained.databaseFile}; pending row count unavailable. FML will not sync that database automatically.`
-  );
 }
-function printStatus(status) {
-  const { queue } = status;
-  console.log(
-    `Raw artifact sync: ${status.settings.enabled ? "enabled" : "disabled"}`
-  );
-  console.log(`  State:     ${FML_OBSERVER_DIR}`);
-  console.log(`  Tracked:   ${queue.tracked}`);
-  console.log(`  Pending:   ${queue.pending}`);
-  console.log(`  Raw work:  ${queue.rawPending}`);
-  console.log(`  Metadata:  ${queue.metadataPending}`);
-  console.log(`  Uploaded:  ${queue.uploaded}`);
-  console.log(`  Failed:    ${queue.failed}`);
-  console.log(
-    `  Watermark: ${formatBytes2(queue.uploadedBytes)} / ${formatBytes2(queue.totalBytes)}`
-  );
-  console.log(`  Remaining: ${formatBytes2(queue.remainingBytes)}`);
+
+// src/commands/status.ts
+function formatBytes2(bytes) {
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KiB`;
+  if (bytes < 1024 * 1024 * 1024) {
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MiB`;
+  }
+  return `${(bytes / (1024 * 1024 * 1024)).toFixed(2)} GiB`;
 }
-function syncExitCode(result) {
-  if (result.outcome === "failed" || result.outcome === "exhausted") return 1;
-  if (result.outcome === "busy") return 1;
-  return 0;
+function hookSpoolStatus(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return void 0;
+  }
+  const record = value;
+  const nonNegativeInteger = (field) => {
+    const candidate = record[field];
+    return typeof candidate === "number" && Number.isSafeInteger(candidate) && candidate >= 0 ? candidate : void 0;
+  };
+  const logicalBytes = nonNegativeInteger("logicalBytes");
+  const evictedRecords = nonNegativeInteger("evictedRecords");
+  const evictedBytes = nonNegativeInteger("evictedBytes");
+  const evictedPendingRecords = nonNegativeInteger("evictedPendingRecords");
+  const evictedQuarantinedRecords = nonNegativeInteger(
+    "evictedQuarantinedRecords"
+  );
+  const maxBytes = record.maxBytes;
+  const quarantineMaxAgeMs = record.quarantineMaxAgeMs;
+  if (record.unit !== "logical_bytes" || logicalBytes === void 0 || evictedRecords === void 0 || evictedBytes === void 0 || evictedPendingRecords === void 0 || evictedQuarantinedRecords === void 0 || maxBytes !== null && (typeof maxBytes !== "number" || !Number.isSafeInteger(maxBytes) || maxBytes < 1)) {
+    return void 0;
+  }
+  const lastEvictedAtMsValue = nonNegativeInteger("lastEvictedAtMs");
+  const lastEvictedAtMs = lastEvictedAtMsValue !== void 0 && lastEvictedAtMsValue <= 864e13 ? lastEvictedAtMsValue : void 0;
+  return {
+    logicalBytes,
+    maxBytes,
+    ...quarantineMaxAgeMs === null ? { quarantineMaxAgeMs: null } : typeof quarantineMaxAgeMs === "number" && Number.isSafeInteger(quarantineMaxAgeMs) && quarantineMaxAgeMs > 0 ? { quarantineMaxAgeMs } : {},
+    evictedRecords,
+    evictedBytes,
+    evictedPendingRecords,
+    evictedQuarantinedRecords,
+    ...lastEvictedAtMs === void 0 ? {} : { lastEvictedAtMs }
+  };
 }
-async function handleSyncRun(opts = {}) {
-  const sync2 = rawSync();
-  if (!sync2.getSettings().enabled) {
-    const result2 = {
-      ok: true,
-      outcome: "disabled",
-      status: sync2.status()
-    };
-    if (opts.json) writeJson(result2);
-    else printStatus(result2.status);
-    return;
+function otlpSpoolStatus(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return void 0;
   }
-  if (opts.dryRun) {
-    const discovery = sync2.discover();
-    const bySource = {};
-    let totalBytes = 0;
-    for (const candidate of discovery.candidates) {
-      bySource[candidate.source] = (bySource[candidate.source] ?? 0) + 1;
-      try {
-        totalBytes += statSync(candidate.sourcePath).size;
-      } catch {
-      }
-    }
-    const result2 = {
-      ok: true,
-      dryRun: true,
-      targetUrl: getSiteUrl(),
-      discovered: {
-        count: discovery.candidates.length,
-        totalBytes,
-        bySource
-      },
-      repositoryResolution: discovery.repositoryResolution,
-      oversized: discovery.oversized,
-      status: sync2.status()
-    };
-    if (opts.json) writeJson(result2);
-    else {
-      console.log("FML raw artifact sync dry-run");
-      console.log(`  Target:     ${result2.targetUrl}`);
-      console.log(`  Discovered: ${result2.discovered.count}`);
-      console.log(`  Bytes:      ${formatBytes2(result2.discovered.totalBytes)}`);
-      for (const [source, count] of Object.entries(bySource).sort()) {
-        console.log(`    ${source}: ${count}`);
-      }
-      printRepositoryResolution(discovery.repositoryResolution);
-      console.log(`  Oversized:  ${discovery.oversized.length}`);
-      if (discovery.compressedArtifactsUnsupportedReason) {
-        console.log(
-          `  Compressed: skipped \u2014 ${discovery.compressedArtifactsUnsupportedReason}`
-        );
-      }
-    }
-    return;
+  const record = value;
+  const nonNegativeInteger = (field) => {
+    const candidate = record[field];
+    return typeof candidate === "number" && Number.isSafeInteger(candidate) && candidate >= 0 ? candidate : void 0;
+  };
+  const logicalBytes = nonNegativeInteger("logicalBytes");
+  const bodyBytes = nonNegativeInteger("bodyBytes");
+  const maxBytes = nonNegativeInteger("maxBytes");
+  const droppedRecords = nonNegativeInteger("droppedRecords");
+  const droppedLogicalBytes = nonNegativeInteger("droppedLogicalBytes");
+  const droppedBodyBytes = nonNegativeInteger("droppedBodyBytes");
+  if (record.unit !== "logical_bytes" || logicalBytes === void 0 || bodyBytes === void 0 || maxBytes === void 0 || maxBytes < 1 || droppedRecords === void 0 || droppedLogicalBytes === void 0 || droppedBodyBytes === void 0 || bodyBytes > logicalBytes || droppedBodyBytes > droppedLogicalBytes) {
+    return void 0;
   }
-  const attempt = await runRawSyncOnce();
-  if (attempt.kind === "unauthenticated") {
-    console.error("Raw artifact sync requires an FML login.");
-    console.error("Run `fml login` or set FML_TOKEN.");
-    process.exitCode = 1;
-    return;
+  return {
+    logicalBytes,
+    bodyBytes,
+    maxBytes,
+    droppedRecords,
+    droppedLogicalBytes,
+    droppedBodyBytes,
+    ...typeof record.lastDroppedAtMs === "number" && Number.isSafeInteger(record.lastDroppedAtMs) && record.lastDroppedAtMs >= 0 && Number.isFinite(new Date(record.lastDroppedAtMs).getTime()) ? { lastDroppedAtMs: record.lastDroppedAtMs } : {},
+    ...typeof record.lastDropReason === "string" ? { lastDropReason: record.lastDropReason } : {}
+  };
+}
+function observerQueueStatus(value, key) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  const queue = value[key];
+  if (!queue || typeof queue !== "object" || Array.isArray(queue)) return null;
+  const record = queue;
+  if (typeof record.phase !== "string" || typeof record.pending !== "number" || !Number.isSafeInteger(record.pending) || record.pending < 0) {
+    return null;
   }
-  if (attempt.kind === "disabled") {
-    if (opts.json) {
-      writeJson({ ok: true, outcome: "disabled", status: attempt.status });
-    } else {
-      printStatus(attempt.status);
-    }
-    return;
+  return {
+    phase: record.phase,
+    pending: record.pending,
+    ...typeof record.quarantined === "number" && Number.isSafeInteger(record.quarantined) && record.quarantined >= 0 ? { quarantined: record.quarantined } : {},
+    ...typeof record.lastError === "string" ? { lastError: record.lastError } : {},
+    ...typeof record.lastWarning === "string" ? { lastWarning: record.lastWarning } : {},
+    ...typeof record.nextAttemptAtMs === "number" && Number.isSafeInteger(record.nextAttemptAtMs) && record.nextAttemptAtMs >= 0 && Number.isFinite(new Date(record.nextAttemptAtMs).getTime()) ? { nextAttemptAtMs: record.nextAttemptAtMs } : {}
+  };
+}
+function hookStatus(value) {
+  const status = observerQueueStatus(value, "hooks");
+  if (!status || !value || typeof value !== "object" || Array.isArray(value)) {
+    return null;
   }
-  const { result, targetUrl } = attempt;
-  if (opts.json) {
-    writeJson({ ok: syncExitCode(result) === 0, targetUrl, result });
+  const hooks = value.hooks;
+  if (!hooks || typeof hooks !== "object" || Array.isArray(hooks)) return null;
+  const record = hooks;
+  const spool = hookSpoolStatus(record.spool);
+  return {
+    ...status,
+    ...typeof record.rejected === "number" && Number.isSafeInteger(record.rejected) && record.rejected >= 0 ? { rejected: record.rejected } : {},
+    ...typeof record.lastRejectedReason === "string" ? { lastRejectedReason: record.lastRejectedReason } : {},
+    ...typeof record.lastRejectedTarget === "string" ? { lastRejectedTarget: record.lastRejectedTarget } : {},
+    ...spool === void 0 ? {} : { spool }
+  };
+}
+function otlpStatus(value) {
+  const status = observerQueueStatus(value, "otlp");
+  if (!status || !value || typeof value !== "object" || Array.isArray(value)) {
+    return null;
+  }
+  const otlp = value.otlp;
+  if (!otlp || typeof otlp !== "object" || Array.isArray(otlp)) return null;
+  const spool = otlpSpoolStatus(otlp.spool);
+  return {
+    ...status,
+    ...spool === void 0 ? {} : { spool }
+  };
+}
+async function handleStatus() {
+  const { name, convexUrl } = getActiveEnv();
+  console.log(`Environment: ${name}`);
+  console.log(`  Convex: ${convexUrl ?? "not configured"}
+`);
+  const tokens = readTokens(name);
+  if (!tokens) {
+    console.log("Authentication:");
+    console.log("  Not authenticated. Run `fml login` to sign in.");
   } else {
-    console.log("FML raw artifact sync");
-    console.log(`  Target:          ${targetUrl}`);
-    console.log(`  Outcome:         ${result.outcome}`);
-    console.log(`  Sync passes:     ${result.syncPasses}`);
-    console.log(`  Discovered:      ${result.discovery.candidates.length}`);
-    if (result.discovery.compressedArtifactsUnsupportedReason) {
-      console.log(
-        `  Compressed:      skipped \u2014 ${result.discovery.compressedArtifactsUnsupportedReason}`
-      );
+    const tokenValid = await getValidToken({ env: name });
+    console.log("Authentication:");
+    if (tokens.tokenType === "service" && tokens.user.id === SERVICE_TOKEN_LOGIN_USER_ID) {
+      console.log("  Auth:  service token");
+    } else {
+      console.log(`  User:  ${tokens.user.name} (${tokens.user.email})`);
     }
-    printRepositoryResolution(result.discovery.repositoryResolution);
-    console.log(`  Uploaded files:  ${result.upload.uploaded}`);
-    console.log(`  Uploaded chunks: ${result.upload.uploadedChunks}`);
     console.log(
-      `  Uploaded bytes:  ${formatBytes2(result.upload.uploadedBytes)}`
+      `  Token: ${tokenValid ? "valid" : "expired (needs refresh/re-login)"}`
     );
-    console.log(`  Failed:          ${result.upload.failed}`);
-    console.log(`  Exhausted:       ${result.upload.exhausted}`);
-    if (result.upload.retryAtMs !== void 0) {
-      console.log(
-        `  Retry at:        ${new Date(result.upload.retryAtMs).toISOString()}`
-      );
-    }
-    console.log(`  Drained:         ${result.drained ? "yes" : "no"}`);
-    if (result.outcome === "pending") {
-      console.log(
-        "  Next:            More data remains; run `fml sync` again or `fml start` for continuous syncing."
-      );
-    } else if (result.outcome === "backing_off") {
-      const nextRetryAtMs = result.upload.nextRetryAtMs;
-      console.log(
-        `  Next:            Remaining items are backing off after upload errors${nextRetryAtMs !== void 0 ? `; next retry due ${new Date(nextRetryAtMs).toISOString()}` : ""}. \`fml start\` retries automatically.`
-      );
+    console.log(
+      `  Org:   ${tokens.orgSlug ?? "(none \u2014 run `fml org <slug>`)"}`
+    );
+  }
+  const syncStatus = createRawArtifactSync({
+    stateDir: FML_OBSERVER_DIR
+  }).status();
+  console.log("\nRaw artifact sync:");
+  console.log(`  Enabled:   ${syncStatus.settings.enabled ? "yes" : "no"}`);
+  console.log(`  Tracked:   ${syncStatus.queue.tracked}`);
+  console.log(`  Pending:   ${syncStatus.queue.pending}`);
+  console.log(`  Raw work:  ${syncStatus.queue.rawPending}`);
+  console.log(`  Metadata:  ${syncStatus.queue.metadataPending}`);
+  console.log(`  Uploaded:  ${syncStatus.queue.uploaded}`);
+  console.log(`  Failed:    ${syncStatus.queue.failed}`);
+  console.log(
+    `  Watermark: ${formatBytes2(syncStatus.queue.uploadedBytes)} / ${formatBytes2(syncStatus.queue.totalBytes)}`
+  );
+  console.log(`  Remaining: ${formatBytes2(syncStatus.queue.remainingBytes)}`);
+  const observer = await readObserverRuntimeStatus();
+  const protectedStatus = observer.healthy ? await readObserverProtectedStatus() : null;
+  const observerState = observer.stateStatus.state;
+  console.log("\nLocal observer:");
+  console.log(
+    `  Status: ${observer.healthy ? "running" : observer.running ? "unhealthy" : "stopped"}`
+  );
+  if (observerState) {
+    console.log(`  PID:    ${observerState.pid}`);
+    console.log(`  Phase:  ${observerState.phase}`);
+    if (observerState.lastOutcome) {
+      console.log(`  Last:   ${observerState.lastOutcome}`);
     }
-    console.log("");
-    printStatus(result.status);
   }
-  process.exitCode = syncExitCode(result);
-}
-function setRawSyncEnabled(enabled) {
-  return rawSync().setEnabled(enabled);
-}
-async function handleSyncEnable(opts = {}) {
-  const sync2 = rawSync();
-  const settings = sync2.setEnabled(true);
-  const isolationWarning = observerOnlyOverrideWarning();
-  if (isolationWarning) console.warn(isolationWarning);
-  let retainedLegacyDatabase;
-  try {
-    const observer = await startObserver({
-      onLegacyDatabaseRetained: (retained) => {
-        retainedLegacyDatabase = retained;
-        if (!opts.json) warnRetainedLegacyDatabase(retained);
-      }
-    });
-    setHookCaptureDisabled(false);
-    if (observer.status === "already_running") {
-      await wakeObserverSync();
+  console.log(`  Log:    ${observer.logFile}`);
+  const hooks = hookStatus(protectedStatus);
+  const hookInbox = readHookInboxStatus();
+  console.log("\nHook capture:");
+  if (!hooks) {
+    console.log(`  Status:  ${observer.healthy ? "unavailable" : "stopped"}`);
+  } else {
+    console.log(`  Status:  ${hooks.phase}`);
+    console.log(`  Pending: ${hooks.pending}`);
+    if (hooks.quarantined && hooks.quarantined > 0) {
+      console.log(`  Quarantined: ${hooks.quarantined}`);
     }
-    const port = observer.runtime.health?.port;
-    const authToken = port ? readObserverAuthToken(FML_OBSERVER_AUTH_TOKEN_FILE) : null;
-    if (port && authToken) {
-      for (const target2 of configureFmlOtel({
-        baseUrl: `http://127.0.0.1:${port}`,
-        authToken
-      })) {
-        if (!opts.json) {
-          console.log(`OpenTelemetry: ${target2.displayName} -> FML observer`);
-        }
+    if (hooks.rejected && hooks.rejected > 0) {
+      console.log(`  Rejected: ${hooks.rejected}`);
+      if (hooks.lastRejectedReason) {
+        console.log(
+          `  Last rejection: ${hooks.lastRejectedReason}${hooks.lastRejectedTarget ? ` (${hooks.lastRejectedTarget})` : ""}`
+        );
       }
-    } else if (!opts.json) {
-      console.warn(
-        "Could not configure native OpenTelemetry: the healthy observer endpoint or local token is unavailable."
-      );
     }
-    if (opts.json) {
-      writeJson({
-        ok: true,
-        sync: settings,
-        observer,
-        ...observer.retainedLegacyDatabase ? { retainedLegacyDatabase: observer.retainedLegacyDatabase } : {}
-      });
-    } else {
-      console.log("FML raw artifact sync is enabled");
-      const pid = observer.runtime.health?.pid;
+    if (hooks.spool) {
       console.log(
-        observer.status === "started" ? `FML observer started${pid ? ` (PID ${pid})` : ""}` : `FML observer is already running${pid ? ` (PID ${pid})` : ""}`
+        `  Spool:   ${formatBytes2(hooks.spool.logicalBytes)} / ${hooks.spool.maxBytes === null ? "unbounded" : formatBytes2(hooks.spool.maxBytes)} (logical content)`
       );
-    }
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    if (opts.json) {
-      writeJson({
-        ok: false,
-        sync: settings,
-        error: message,
-        ...retainedLegacyDatabase ? { retainedLegacyDatabase } : {}
-      });
-    } else console.error(message);
-    process.exitCode = 1;
-  }
-}
-async function handleSyncDisable(opts = {}) {
-  const sync2 = rawSync();
-  const settings = sync2.setEnabled(false);
-  const observerWoken = await wakeObserverSync();
-  if (opts.json) {
-    writeJson({ ok: true, sync: settings, observerWoken });
-  } else {
-    console.log("FML raw artifact sync is disabled");
-    const observer = await readObserverRuntimeStatus();
-    if (observer.running) {
-      console.log("FML observer remains available for local integrations");
-    }
-  }
-}
-async function handleSyncStatus(opts = {}) {
-  const status = rawSync().status();
-  const observer = await readObserverRuntimeStatus();
-  if (opts.json) writeJson({ ok: true, status, observer });
-  else {
-    printStatus(status);
-    const state = observer.stateStatus.state;
-    console.log(
-      `  Observer:  ${observer.healthy ? "running" : observer.running ? "unhealthy" : "stopped"}`
-    );
-    if (state) {
-      console.log(`  PID:       ${state.pid}`);
-      console.log(`  Phase:     ${state.phase}`);
-      if (state.lastOutcome) {
-        console.log(`  Last run:  ${state.lastOutcome}`);
+      if (hooks.spool.quarantineMaxAgeMs !== void 0) {
+        console.log(
+          `  Quarantine retention: ${hooks.spool.quarantineMaxAgeMs === null ? "unbounded" : `${Math.round(hooks.spool.quarantineMaxAgeMs / 864e5)} day(s)`}`
+        );
       }
-      if (state.nextAttemptAtMs) {
+      if (hooks.spool.evictedRecords > 0) {
         console.log(
-          `  Next run:  ${new Date(state.nextAttemptAtMs).toISOString()}`
+          `  Evicted: ${hooks.spool.evictedRecords} record(s), ${formatBytes2(hooks.spool.evictedBytes)} (${hooks.spool.evictedQuarantinedRecords} quarantined, ${hooks.spool.evictedPendingRecords} pending)`
         );
+        if (hooks.spool.lastEvictedAtMs !== void 0) {
+          console.log(
+            `  Last eviction: ${new Date(hooks.spool.lastEvictedAtMs).toISOString()}`
+          );
+        }
       }
     }
-    console.log(`  Log:       ${observer.logFile}`);
+    if (hooks.lastError) console.log(`  Error:   ${hooks.lastError}`);
   }
-}
-async function handleSyncReset(opts = {}) {
-  const result = rawSync().reset();
-  if (opts.json) writeJson({ ok: !result.skipped, reset: result });
-  else if (result.skipped) {
-    console.error(
-      "Raw artifact reset skipped: another sync owns the queue lock"
-    );
+  if (hookInbox.unreadable) {
+    console.log("  Inbox:   unavailable");
   } else {
     console.log(
-      `Reset raw upload watermarks for ${result.reset} artifact${result.reset === 1 ? "" : "s"}.`
+      `  Inbox:   ${hookInbox.pendingEntries} pending (${formatBytes2(hookInbox.pendingBytes)})`
     );
-    if (result.removed > 0) {
-      console.log(`Removed ${result.removed} missing artifact entries.`);
-    }
     console.log(
-      "The next enabled sync will replay each artifact from byte zero."
+      `  Inbox limits: ${hookInbox.maxBytes === null ? "unbounded bytes" : formatBytes2(hookInbox.maxBytes)}, ${hookInbox.maxEntries === null ? "unbounded entries" : `${hookInbox.maxEntries} entries`}`
     );
-  }
-  if (result.skipped) {
-    process.exitCode = 1;
-  } else {
-    await wakeObserverSync();
-  }
-}
-
-// src/commands/daemon.ts
-async function handleFmlStart() {
-  await handleSyncEnable();
-}
-async function handleFmlStop(opts = {}) {
-  setRawSyncEnabled(false);
-  const result = await stopObserver({ force: opts.force });
-  if (result.status === "stopped" || result.status === "killed" || result.status === "not_running" || result.status === "stale_state") {
-    try {
-      setHookCaptureDisabled(true);
-    } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      console.error(
-        `FML observer stopped, but the hook-capture pause could not be persisted: ${message}`
+    if (hookInbox.capacityRejectedEntries > 0) {
+      console.log(
+        `  Inbox capacity refusals: ${hookInbox.capacityRejectedEntries} record(s), ${formatBytes2(hookInbox.capacityRejectedBytes)}`
       );
-      process.exitCode = 1;
+      if (hookInbox.lastCapacityRejectedAtMs !== void 0) {
+        console.log(
+          `  Last inbox refusal: ${new Date(hookInbox.lastCapacityRejectedAtMs).toISOString()}${hookInbox.lastCapacityRejectionReason ? ` (${hookInbox.lastCapacityRejectionReason})` : ""}`
+        );
+      }
     }
-  }
-  switch (result.status) {
-    case "stopped":
-      console.log(`FML observer stopped (PID ${result.pid})`);
-      break;
-    case "killed":
-      console.log(`FML observer force stopped (PID ${result.pid})`);
-      break;
-    case "not_running":
-      console.log("FML observer was not running");
-      break;
-    case "stale_state":
+    if (hookInbox.retiredEntries > 0) {
       console.log(
-        "FML observer is not running; stale state will be reclaimed on the next start"
-      );
-      break;
-    case "permission_denied":
-      console.error(
-        `Could not stop FML observer PID ${result.pid}: permission denied`
-      );
-      process.exitCode = 1;
-      break;
-    case "foreign_listener":
-      console.error("Refused to stop a different local observer instance");
-      process.exitCode = 1;
-      break;
-    case "ambiguous_live_process":
-      console.error(
-        `Refused to treat unverifiable live PID ${result.pid} as a stopped FML observer`
+        `  Inbox retired: ${hookInbox.retiredEntries} record(s), ${formatBytes2(hookInbox.retiredBytes)}`
       );
-      process.exitCode = 1;
-      break;
-    case "unresponsive":
-      console.error(
-        `Refused to signal unverifiable FML observer PID ${result.pid}; retry with \`fml stop --force\` to escalate`
+    }
+  }
+  const otlp = otlpStatus(protectedStatus);
+  console.log("\nNative OpenTelemetry:");
+  if (!otlp) {
+    console.log(`  Status:  ${observer.healthy ? "unavailable" : "stopped"}`);
+  } else {
+    console.log(`  Status:  ${otlp.phase}`);
+    console.log(`  Pending: ${otlp.pending}`);
+    if (otlp.spool) {
+      const usedPercent = otlp.spool.logicalBytes / otlp.spool.maxBytes * 100;
+      console.log(
+        `  Spool:   ${formatBytes2(otlp.spool.logicalBytes)} / ${formatBytes2(otlp.spool.maxBytes)} (${usedPercent.toFixed(1)}%; ${formatBytes2(otlp.spool.bodyBytes)} encoded bodies)`
       );
-      process.exitCode = 1;
-      break;
-    case "signal_sent":
-      console.error(`FML observer PID ${result.pid} did not stop`);
-      process.exitCode = 1;
-      break;
-    case "force_stop_unverified":
-      console.error(
-        `Could not corroborate that PID ${result.pid} is the FML observer; refusing to signal it. If the observer is not running, remove ${result.stateFile}, ${result.lockFile}, ${result.databaseStateFile}, and ${result.databaseLockFile} manually.`
+      if (usedPercent >= 80) {
+        console.log(
+          `  Attention: the oldest pending telemetry is dropped when the spool reaches ${formatBytes2(otlp.spool.maxBytes)}`
+        );
+      }
+      if (otlp.spool.droppedRecords > 0) {
+        console.log(
+          `  Dropped: ${otlp.spool.droppedRecords} envelope(s), ${formatBytes2(otlp.spool.droppedLogicalBytes)} logical; ${formatBytes2(otlp.spool.droppedBodyBytes)} encoded bodies`
+        );
+        if (otlp.spool.lastDropReason) {
+          console.log(
+            `  Last drop: ${otlp.spool.lastDropReason}${otlp.spool.lastDroppedAtMs === void 0 ? "" : ` at ${new Date(otlp.spool.lastDroppedAtMs).toISOString()}`}`
+          );
+        }
+      }
+    }
+    if (otlp.lastError) console.log(`  Error:   ${otlp.lastError}`);
+    if (otlp.lastWarning) console.log(`  Warning: ${otlp.lastWarning}`);
+    if (otlp.nextAttemptAtMs !== void 0) {
+      console.log(
+        `  Next attempt: ${new Date(otlp.nextAttemptAtMs).toISOString()}`
       );
-      process.exitCode = 1;
-      break;
+    }
   }
 }
 
@@ -8002,7 +8131,7 @@ async function handleFmlStop(opts = {}) {
 function handleEnvShow() {
   const { name, convexUrl } = getActiveEnv();
   console.log(`Environment: ${name}`);
-  console.log(`  Convex URL: ${convexUrl ?? "not configured"}`);
+  console.log(`  Service URL: ${convexUrl ?? "not configured"}`);
 }
 function handleEnvSwitch(target2) {
   let name = target2;
@@ -8025,17 +8154,20 @@ function handleEnvSwitch(target2) {
     return;
   }
   if (!convexUrl) {
-    console.error(`FML environment "${name}" has no configured backend URL.`);
+    console.error(`Environment ${name} has no configured service URL.`);
     console.error(
-      `Run FML_CONVEX_URL=https://<deployment>.convex.cloud fml env ${name}`
+      `Set FML_CONVEX_URL=https://<deployment>.convex.cloud and run \`fml env ${name}\` again.`
     );
     process.exitCode = 1;
     return;
   }
   setActiveEnvironment(name, convexUrl);
-  console.log(`Switched to ${name}: ${convexUrl}`);
-  console.log("New CLI and sync operations will use this environment.");
-  console.log("Restart running MCP clients to switch their backend and auth.");
+  console.log(`Environment switched to ${name}.`);
+  console.log(`Service URL: ${convexUrl}`);
+  console.log("CLI commands and agent activity sync now use this environment.");
+  console.log(
+    "Start a new agent session to use the new environment and credentials."
+  );
 }
 
 // src/commands/data.ts
@@ -8592,7 +8724,7 @@ async function handleConfigDetail(opts) {
 // src/commands/tools.ts
 import { readFileSync } from "fs";
 import path28 from "path";
-var pluginVersion = true ? "0.8.0-rc.1+60c9b7e1" : void 0;
+var pluginVersion = true ? "0.8.0-rc.2+bed6eaed" : void 0;
 async function getApi() {
   const api = await getAuthenticatedClient();
   if (!api) {
@@ -8725,13 +8857,31 @@ async function handleToolsCall(name, opts) {
   console.log(JSON.stringify(result.result, null, 2));
 }
 
+// src/banner.ts
+import pc2 from "picocolors";
+var LOGO_LINES = [
+  " \u2584\u2588\u2588\u2580   \u2588\u2588\u2584\u2588\u2588\u2584\u2588\u2588  \u2588\u2588",
+  " \u2588\u2588     \u2588\u2588 \u2588\u2588 \u2588\u2588  \u2588\u2588",
+  "\u2588\u2588\u2588\u2588\u2588   \u2588\u2588    \u2588\u2588  \u2588\u2588",
+  " \u2588\u2588     \u2588\u2588    \u2588\u2588  \u2588\u2588\u2588\u2588",
+  " \u2580\u2580     \u2580\u2580    \u2580\u2580  \u2580\u2580\u2580\u2580"
+];
+function printBanner() {
+  console.log("");
+  for (let i = 0; i < LOGO_LINES.length; i++) {
+    const color = i < 3 ? pc2.blue : pc2.cyan;
+    console.log("  " + color(LOGO_LINES[i]));
+  }
+  console.log("");
+}
+
 // src/cli.ts
 await initSentry();
 if (process.argv.length <= 2 || process.argv.includes("--help") || process.argv.includes("-h")) {
   printBanner();
 }
 var program = new Command().name("fml").description("FML CLI and agent tools").version(
-  true ? "0.8.0-rc.1+60c9b7e1" : "dev"
+  true ? "0.8.0-rc.2+bed6eaed" : "dev"
 );
 function formatCommandInventory(cmd, prefix = "") {
   const name = prefix ? `${prefix} ${cmd.name()}` : cmd.name();
@@ -8760,11 +8910,12 @@ tools.command("call").description("Invoke a backend tool by name with JSON args"
 program.command("mcp-server", { hidden: true }).description("Run the FML MCP server on stdio").action(async () => {
   await import("./mcp/server.js");
 });
-program.command("install").description("Set up FML for local agent use").action(() => handleInstall());
+program.command("setup").description("Install integrations, sign in if needed, and start FML").action(() => handleSetup());
+program.command("install").description("Register FML agent integrations and the MCP server").action(() => handleInstall());
 program.command("uninstall").description("Remove FML agent integrations and optionally local data").option("--purge", "Also remove all data, logs, and auth tokens").option("-y, --yes", "Skip the purge confirmation prompt").action(
   (opts) => handleUninstall({ purge: opts.purge, assumeYes: opts.yes })
 );
-program.command("update").description("Update fml to the latest version").action(() => handleUpdate());
+program.command("update").description("Update fml from its release channel").action(() => handleUpdate());
 program.command("login").description("Sign in to your FML account").option("--device", "Use device authorization flow (no browser needed)").option(
   "--service-token",
   "Sign in with an org service refresh token (prompts for fml_srt_*)"
@@ -8774,28 +8925,29 @@ program.command("login").description("Sign in to your FML account").option("--de
 program.command("logout").description("Sign out and clear stored credentials").action(() => handleLogout());
 program.command("org").description("Show or select organization").argument("[slug]", "Org slug to select").action((slug) => handleOrg(slug));
 program.command("status").description("Show auth, environment, and raw sync watermarks").action(() => handleStatus());
-program.command("doctor").description("Check FML configuration, raw sync, and connectivity").option("--json", "Output as JSON").action((opts) => handleDoctor(opts));
+program.command("doctor").description("Check FML configuration, agent activity sync, and connectivity").option("--json", "Output as JSON").action((opts) => handleDoctor(opts));
 program.command("open").description("Open FML dashboard in browser").option("--json", "Output URL as JSON instead of opening browser").action((opts) => handleOpen(opts));
 program.command("env").description("Show or switch FML backend environment").argument("[target]", "Environment name or backend URL").action((target2) => {
   if (target2) handleEnvSwitch(target2);
   else handleEnvShow();
 });
-program.command("start").description("Start the local observer and continuous raw artifact sync").action(() => handleFmlStart());
-program.command("stop").description("Stop the local observer and disable raw artifact sync").option("--force", "Escalate to SIGTERM/SIGKILL if the observer is hung").action((opts) => handleFmlStop({ force: opts.force }));
-var sync = program.command("sync").description("Sync raw local artifacts to FML").option("--dry-run", "Discover artifacts without changing queue state").option("--json", "Output as JSON").action((opts) => handleSyncRun(opts));
-sync.command("enable").description("Enable raw artifact sync").option("--json", "Output as JSON").action(
+program.command("start").description("Start the local observer and continuous agent activity sync").action(() => handleFmlStart());
+program.command("restart").description("Restart the local observer and continuous agent activity sync").action(() => handleFmlRestart());
+program.command("stop").description("Stop the local observer and pause agent activity sync").option("--force", "Escalate to SIGTERM/SIGKILL if the observer is hung").action((opts) => handleFmlStop({ force: opts.force }));
+var sync = program.command("sync").description("Sync Agent activity to FML").option("--dry-run", "Discover artifacts without changing queue state").option("--json", "Output as JSON").action((opts) => handleSyncRun(opts));
+sync.command("enable").description("Enable Agent activity sync").option("--json", "Output as JSON").action(
   (_opts, command) => handleSyncEnable(command.optsWithGlobals())
 );
-sync.command("disable").description("Disable raw artifact sync").option("--json", "Output as JSON").action(
+sync.command("disable").description("Pause Agent activity sync").option("--json", "Output as JSON").action(
   (_opts, command) => handleSyncDisable(command.optsWithGlobals())
 );
-sync.command("status").description("Show raw artifact queue watermarks").option("--json", "Output as JSON").action(
+sync.command("status").description("Show Agent activity queue watermarks").option("--json", "Output as JSON").action(
   (_opts, command) => handleSyncStatus(command.optsWithGlobals())
 );
-sync.command("reset").description("Replay all raw artifacts from byte zero").option("--json", "Output as JSON").action(
+sync.command("reset").description("Replay Agent activity uploads from byte zero").option("--json", "Output as JSON").action(
   (_opts, command) => handleSyncReset(command.optsWithGlobals())
 );
-var artifacts = program.command("artifacts", { hidden: true }).description("Compatibility alias for raw artifact sync");
+var artifacts = program.command("artifacts", { hidden: true }).description("Compatibility alias for Agent activity sync");
 artifacts.command("sync").option("--dry-run", "Discover artifacts without changing queue state").option("--json", "Output as JSON").action((opts) => handleSyncRun(opts));
 program.command("activity").description("Activity summary \u2014 sessions, prompts, tools, costs").option("--since <duration>", 'Time window, e.g. "24h", "7d"').action((opts) => handleActivity(opts));
 program.command("sessions").description("List recent sessions").option("--since <duration>", 'Time filter, e.g. "24h", "7d"').option("--limit <n>", "Max sessions to return").action((opts) => handleSessions(opts));