opendevbrowser 0.0.21 → 0.0.23

package/dist/cli/index.js

@@ -31,11 +31,26 @@ import {
   resolveExitCode,
   startDaemon,
   toCliError
-} from "../chunk-4KVXCXV3.js";
+} from "../chunk-2MG7BRPF.js";
+import "../chunk-STGGGVYT.js";
 import {
-  getBundledSkillsDir,
-  listBundledSkillDirectories
-} from "../chunk-3VA6XR25.js";
+  createNoOpSkillRemovalResult,
+  ensureDir,
+  getBundledSkillLifecycleTargets,
+  getBundledSkillTargets,
+  getGlobalConfigPath,
+  getLocalConfigPath,
+  hasBundledSkillArtifacts,
+  hasManagedBundledSkillInstall,
+  hasPlugin,
+  readConfig,
+  removeBundledSkillsForTargets,
+  removePluginFromContent,
+  syncBundledSkills,
+  syncBundledSkillsForTargets,
+  updateConfigContent
+} from "../chunk-QVWOPIZJ.js";
+import "../chunk-3ILXPKSJ.js";
 import {
   writeFileAtomic
 } from "../chunk-TBUCZX4A.js";
@@ -48,7 +63,7 @@ import {
   setDefaultLogSink,
   stderrSink,
   summarizePrimaryProviderIssue
-} from "../chunk-ZE2E7ZGH.js";
+} from "../chunk-K2TEHJCV.js";
 import "../chunk-FUSXMW3G.js";
 
 // src/cli/args.ts
@@ -565,6 +580,9 @@ function assertCommandCoverage() {
       if (!detail || !detail.description.trim() || !detail.usage.trim()) {
         throw new Error(`Missing command help metadata: ${command}`);
       }
+      if (detail.examples.length === 0) {
+        throw new Error(`Missing command example metadata: ${command}`);
+      }
       for (const flag of detail.flags) {
         if (!FLAG_SET.has(flag)) {
           throw new Error(`Command help metadata references unknown flag ${flag} for ${command}`);
@@ -605,6 +623,9 @@ function assertToolCoverage() {
     if (!entry.description.trim()) {
       throw new Error(`Help tool is missing a description: ${entry.name}`);
     }
+    if (!entry.example?.trim()) {
+      throw new Error(`Help tool is missing an example: ${entry.name}`);
+    }
     if (seen.has(entry.name)) {
       throw new Error(`Help tool appears multiple times: ${entry.name}`);
     }
@@ -626,7 +647,9 @@ function formatCommandGroups() {
         description: detail.description,
         details: [
           { label: "usage:", value: detail.usage },
-          { label: "flags:", value: formatFlags(detail.flags) }
+          { label: "flags:", value: formatFlags(detail.flags) },
+          ...detail.examples.map((example) => ({ label: "example:", value: example })),
+          ...detail.notes.map((note) => ({ label: "note:", value: note }))
         ]
       };
     });
@@ -649,7 +672,11 @@ function formatToolEntries() {
   return formatRows(HELP_TOOL_ENTRIES.map((entry) => ({
     label: entry.name,
     description: entry.description,
-    details: entry.cliEquivalent ? [{ label: "cli:", value: entry.cliEquivalent }] : [{ label: "scope:", value: "tool-only" }]
+    details: [
+      ...entry.cliEquivalent ? [{ label: "cli:", value: entry.cliEquivalent }] : [{ label: "scope:", value: "tool-only" }],
+      ...entry.example ? [{ label: "example:", value: entry.example }] : [],
+      ...(entry.notes ?? []).map((note) => ({ label: "note:", value: note }))
+    ]
   })));
 }
 function formatOnboardingEntries() {
@@ -706,86 +733,12 @@ function getCommand(name) {
 }
 
 // src/cli/installers/global.ts
-import * as fs3 from "fs";
+import * as fs2 from "fs";
 
-// src/cli/utils/config.ts
+// src/cli/templates/config.ts
 import * as fs from "fs";
 import * as path from "path";
 import * as os from "os";
-import { parse as parseJsonc, modify, applyEdits } from "jsonc-parser";
-var PLUGIN_NAME = "opendevbrowser";
-var SCHEMA_URL = "https://opencode.ai/config.json";
-function getGlobalConfigPath() {
-  const configDir = process.env.OPENCODE_CONFIG_DIR || path.join(os.homedir(), ".config", "opencode");
-  return path.join(configDir, "opencode.json");
-}
-function getLocalConfigPath() {
-  return path.join(process.cwd(), "opencode.json");
-}
-function ensureDir(dirPath) {
-  if (!fs.existsSync(dirPath)) {
-    fs.mkdirSync(dirPath, { recursive: true });
-  }
-}
-function readConfig(configPath) {
-  if (!fs.existsSync(configPath)) {
-    return { content: "", config: {} };
-  }
-  const content = fs.readFileSync(configPath, "utf-8");
-  const errors = [];
-  const parsed = parseJsonc(content, errors, { allowTrailingComma: true });
-  if (errors.length > 0) {
-    const firstError = errors[0];
-    throw new Error(`Invalid JSONC at ${configPath}: parse error at offset ${firstError?.offset ?? 0}`);
-  }
-  return { content, config: parsed ?? {} };
-}
-function hasPlugin(config, pluginName = PLUGIN_NAME) {
-  return config.plugin?.includes(pluginName) ?? false;
-}
-function createConfigWithPlugin(pluginName = PLUGIN_NAME) {
-  return {
-    $schema: SCHEMA_URL,
-    plugin: [pluginName]
-  };
-}
-function updateConfigContent(content, pluginName = PLUGIN_NAME) {
-  if (!content.trim()) {
-    return JSON.stringify(createConfigWithPlugin(pluginName), null, 2) + "\n";
-  }
-  const parsed = parseJsonc(content, [], { allowTrailingComma: true }) ?? {};
-  if (parsed.plugin?.includes(pluginName)) {
-    return content;
-  }
-  let result = content;
-  if (!parsed.$schema) {
-    const edits2 = modify(result, ["$schema"], SCHEMA_URL, { formattingOptions: { tabSize: 2, insertSpaces: true } });
-    result = applyEdits(result, edits2);
-  }
-  const newPlugins = parsed.plugin ? [...parsed.plugin, pluginName] : [pluginName];
-  const edits = modify(result, ["plugin"], newPlugins, { formattingOptions: { tabSize: 2, insertSpaces: true } });
-  result = applyEdits(result, edits);
-  return result;
-}
-function removePluginFromContent(content, pluginName = PLUGIN_NAME) {
-  if (!content.trim()) {
-    return content;
-  }
-  const parsed = parseJsonc(content, [], { allowTrailingComma: true }) ?? {};
-  if (!parsed.plugin?.includes(pluginName)) {
-    return content;
-  }
-  const newPlugins = parsed.plugin.filter((p) => p !== pluginName);
-  const edits = modify(content, ["plugin"], newPlugins.length > 0 ? newPlugins : void 0, {
-    formattingOptions: { tabSize: 2, insertSpaces: true }
-  });
-  return applyEdits(content, edits);
-}
-
-// src/cli/templates/config.ts
-import * as fs2 from "fs";
-import * as path2 from "path";
-import * as os2 from "os";
 function buildConfigTemplate(relayToken, daemonToken) {
   return `{
   // OpenDevBrowser Plugin Configuration
@@ -862,19 +815,19 @@ function buildConfigTemplate(relayToken, daemonToken) {
 }
 function getPluginConfigPath(mode) {
   if (mode === "global") {
-    const configDir = process.env.OPENCODE_CONFIG_DIR || path2.join(os2.homedir(), ".config", "opencode");
-    return path2.join(configDir, "opendevbrowser.jsonc");
+    const configDir = process.env.OPENCODE_CONFIG_DIR || path.join(os.homedir(), ".config", "opencode");
+    return path.join(configDir, "opendevbrowser.jsonc");
   }
-  return path2.join(process.cwd(), "opendevbrowser.jsonc");
+  return path.join(process.cwd(), "opendevbrowser.jsonc");
 }
 function createPluginConfig(mode) {
   const configPath = getPluginConfigPath(mode);
-  if (fs2.existsSync(configPath)) {
+  if (fs.existsSync(configPath)) {
     return { created: false, path: configPath };
   }
-  const dir = path2.dirname(configPath);
-  if (!fs2.existsSync(dir)) {
-    fs2.mkdirSync(dir, { recursive: true });
+  const dir = path.dirname(configPath);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
   }
   const relayToken = generateSecureToken();
   const daemonToken = generateSecureToken();
@@ -898,7 +851,7 @@ function installGlobal(withConfig = false) {
     }
     const newContent = updateConfigContent(content, "opendevbrowser");
     ensureDir(configPath.replace(/[/\\][^/\\]+$/, ""));
-    fs3.writeFileSync(configPath, newContent, "utf-8");
+    fs2.writeFileSync(configPath, newContent, "utf-8");
     if (withConfig) {
       createPluginConfig("global");
     }
@@ -922,7 +875,7 @@ function installGlobal(withConfig = false) {
 }
 
 // src/cli/installers/local.ts
-import * as fs4 from "fs";
+import * as fs3 from "fs";
 function installLocal(withConfig = false) {
   const configPath = getLocalConfigPath();
   try {
@@ -937,7 +890,7 @@ function installLocal(withConfig = false) {
       };
     }
     const newContent = updateConfigContent(content, "opendevbrowser");
-    fs4.writeFileSync(configPath, newContent, "utf-8");
+    fs3.writeFileSync(configPath, newContent, "utf-8");
     if (withConfig) {
       createPluginConfig("local");
     }
@@ -960,407 +913,32 @@ function installLocal(withConfig = false) {
   }
 }
 
-// src/cli/installers/skills.ts
-import * as crypto from "crypto";
-import * as fs5 from "fs";
-import * as path4 from "path";
-
-// src/cli/utils/skills.ts
-import * as path3 from "path";
-import * as os3 from "os";
-var SKILL_DIR_NAME = "skill";
-var SKILLS_DIR_NAME = "skills";
-function getGlobalSkillDir() {
-  const configDir = process.env.OPENCODE_CONFIG_DIR || path3.join(os3.homedir(), ".config", "opencode");
-  return path3.join(configDir, SKILL_DIR_NAME);
-}
-function getLocalSkillDir() {
-  return path3.join(process.cwd(), ".opencode", SKILL_DIR_NAME);
-}
-function getCodexHomeDir() {
-  return process.env.CODEX_HOME || path3.join(os3.homedir(), ".codex");
-}
-function getClaudeCodeHomeDir() {
-  return process.env.CLAUDECODE_HOME || path3.join(os3.homedir(), ".claude");
-}
-function getAmpHomeDir() {
-  return process.env.AMP_CLI_HOME || path3.join(os3.homedir(), ".amp");
-}
-function dedupeTargets(targets) {
-  const deduped = /* @__PURE__ */ new Map();
-  for (const target of targets) {
-    const key = path3.resolve(target.dir);
-    const existing = deduped.get(key);
-    if (existing) {
-      if (!existing.agents.includes(target.agent)) {
-        existing.agents.push(target.agent);
-      }
-      continue;
-    }
-    deduped.set(key, { agents: [target.agent], dir: target.dir });
-  }
-  return Array.from(deduped.values());
-}
-function getGlobalSkillTargets() {
-  const claudeSkillsDir = path3.join(getClaudeCodeHomeDir(), SKILLS_DIR_NAME);
-  const ampSkillsDir = path3.join(getAmpHomeDir(), SKILLS_DIR_NAME);
-  return dedupeTargets([
-    { agent: "opencode", dir: getGlobalSkillDir() },
-    { agent: "codex", dir: path3.join(getCodexHomeDir(), SKILLS_DIR_NAME) },
-    { agent: "claudecode", dir: claudeSkillsDir },
-    { agent: "ampcli", dir: ampSkillsDir }
-  ]);
-}
-function getLocalSkillTargets() {
-  const localClaudeSkillsDir = path3.join(process.cwd(), ".claude", SKILLS_DIR_NAME);
-  const localAmpSkillsDir = path3.join(process.cwd(), ".amp", SKILLS_DIR_NAME);
-  return dedupeTargets([
-    { agent: "opencode", dir: getLocalSkillDir() },
-    { agent: "codex", dir: path3.join(process.cwd(), ".codex", SKILLS_DIR_NAME) },
-    { agent: "claudecode", dir: localClaudeSkillsDir },
-    { agent: "ampcli", dir: localAmpSkillsDir }
-  ]);
-}
-
-// src/cli/installers/skills.ts
-var LEGACY_ALIAS_DIRS = [
-  { name: "research", canonical: "opendevbrowser-research" },
-  { name: "shopping", canonical: "opendevbrowser-shopping" }
-];
-function getTargets(mode) {
-  return mode === "global" ? getGlobalSkillTargets() : getLocalSkillTargets();
-}
-function getCanonicalBundledSkillNames() {
-  return listBundledSkillDirectories().map((entry) => entry.name);
-}
-function hasCanonicalBundledSkillInTarget(targetDir, packNames) {
-  return packNames.some((packName) => fs5.existsSync(path4.join(targetDir, packName)));
-}
-function formatSummary(parts, totalTargets, failures) {
-  const summary = parts.length > 0 ? parts.join(", ") : "no lifecycle changes";
-  const failureSummary = failures > 0 ? `, ${failures} failed` : "";
-  return `${summary} across ${totalTargets} targets${failureSummary}`;
-}
-function hashDirectoryTree(dirPath) {
-  const hash = crypto.createHash("sha256");
-  const visit = (currentPath, relativePath) => {
-    const entries = fs5.readdirSync(currentPath, { withFileTypes: true }).sort((left, right) => left.name.localeCompare(right.name));
-    for (const entry of entries) {
-      const absolutePath = path4.join(currentPath, entry.name);
-      const entryRelativePath = relativePath ? path4.posix.join(relativePath, entry.name) : entry.name;
-      if (entry.isDirectory()) {
-        hash.update(`D:${entryRelativePath}\0`);
-        visit(absolutePath, entryRelativePath);
-        continue;
-      }
-      if (entry.isFile()) {
-        hash.update(`F:${entryRelativePath}\0`);
-        hash.update(fs5.readFileSync(absolutePath));
-        hash.update("\0");
-        continue;
-      }
-      if (entry.isSymbolicLink()) {
-        hash.update(`L:${entryRelativePath}\0${fs5.readlinkSync(absolutePath)}\0`);
-      }
-    }
-  };
-  visit(dirPath, "");
-  return hash.digest("hex");
-}
-function syncSkillDirectory(sourcePath, targetPath, sourceFingerprint) {
-  if (!fs5.existsSync(targetPath)) {
-    fs5.cpSync(sourcePath, targetPath, { recursive: true });
-    return "installed";
-  }
-  const targetFingerprint = hashDirectoryTree(targetPath);
-  if (targetFingerprint === sourceFingerprint) {
-    return "unchanged";
-  }
-  const parentDir = path4.dirname(targetPath);
-  const targetName = path4.basename(targetPath);
-  const stagingRoot = fs5.mkdtempSync(path4.join(parentDir, `.${targetName}-sync-`));
-  const stagedPath = path4.join(stagingRoot, targetName);
-  const backupPath = path4.join(stagingRoot, `${targetName}-backup`);
-  try {
-    fs5.cpSync(sourcePath, stagedPath, { recursive: true });
-    fs5.renameSync(targetPath, backupPath);
-    try {
-      fs5.renameSync(stagedPath, targetPath);
-    } catch (error) {
-      if (fs5.existsSync(backupPath) && !fs5.existsSync(targetPath)) {
-        fs5.renameSync(backupPath, targetPath);
-      }
-      throw error;
-    }
-    fs5.rmSync(backupPath, { recursive: true, force: true });
-    return "refreshed";
-  } finally {
-    if (fs5.existsSync(stagedPath)) {
-      fs5.rmSync(stagedPath, { recursive: true, force: true });
-    }
-    if (fs5.existsSync(backupPath)) {
-      fs5.rmSync(backupPath, { recursive: true, force: true });
-    }
-    fs5.rmSync(stagingRoot, { recursive: true, force: true });
-  }
-}
-function cleanupLegacyAlias(targetDir, aliasName) {
-  const aliasPath = path4.join(targetDir, aliasName);
-  if (!fs5.existsSync(aliasPath)) {
-    return { removed: [], preserved: [] };
-  }
-  let stats;
-  try {
-    stats = fs5.statSync(aliasPath);
-  } catch {
-    return {
-      removed: [],
-      preserved: [{ targetDir, name: aliasName, reason: "unknown_layout" }]
-    };
-  }
-  if (!stats.isDirectory()) {
-    return {
-      removed: [],
-      preserved: [{ targetDir, name: aliasName, reason: "unknown_layout" }]
-    };
-  }
-  if (fs5.existsSync(path4.join(aliasPath, "SKILL.md"))) {
-    return {
-      removed: [],
-      preserved: [{ targetDir, name: aliasName, reason: "contains_skill_md" }]
-    };
-  }
-  const entries = fs5.readdirSync(aliasPath);
-  if (entries.length === 0) {
-    fs5.rmSync(aliasPath, { recursive: true, force: true });
-    return { removed: [aliasName], preserved: [] };
-  }
-  return {
-    removed: [],
-    preserved: [{ targetDir, name: aliasName, reason: "non_empty" }]
-  };
-}
-function cleanupLegacyAliases(targetDir) {
-  const removed = [];
-  const preserved = [];
-  for (const alias of LEGACY_ALIAS_DIRS) {
-    const result = cleanupLegacyAlias(targetDir, alias.name);
-    removed.push(...result.removed);
-    preserved.push(...result.preserved);
-  }
-  return { removed, preserved };
-}
-function buildSyncMessage(mode, result) {
-  return `Skills ${mode} sync: ${formatSummary(
-    [
-      result.installed.length > 0 ? `${result.installed.length} installed` : "",
-      result.refreshed.length > 0 ? `${result.refreshed.length} refreshed` : "",
-      result.unchanged.length > 0 ? `${result.unchanged.length} unchanged` : "",
-      result.removedLegacyAliases.length > 0 ? `${result.removedLegacyAliases.length} legacy aliases removed` : "",
-      result.preservedLegacyAliases.length > 0 ? `${result.preservedLegacyAliases.length} legacy aliases preserved` : ""
-    ].filter(Boolean),
-    result.targets.length,
-    result.targets.filter((entry) => !entry.success).length
-  )}`;
-}
-function buildRemovalMessage(mode, result) {
-  return `Skills ${mode} removal: ${formatSummary(
-    [
-      result.removed.length > 0 ? `${result.removed.length} removed` : "",
-      result.missing.length > 0 ? `${result.missing.length} already absent` : "",
-      result.removedLegacyAliases.length > 0 ? `${result.removedLegacyAliases.length} legacy aliases removed` : "",
-      result.preservedLegacyAliases.length > 0 ? `${result.preservedLegacyAliases.length} legacy aliases preserved` : ""
-    ].filter(Boolean),
-    result.targets.length,
-    result.targets.filter((entry) => !entry.success).length
-  )}`;
-}
-function syncBundledSkills(mode) {
-  const targets = getTargets(mode);
-  const targetResults = [];
-  try {
-    const sourceDir = getBundledSkillsDir();
-    const packNames = getCanonicalBundledSkillNames();
-    const bundledFingerprints = /* @__PURE__ */ new Map();
-    for (const packName of packNames) {
-      const sourcePath = path4.join(sourceDir, packName);
-      if (!fs5.existsSync(sourcePath)) {
-        throw new Error(`Bundled skill directory missing: ${packName}`);
-      }
-      bundledFingerprints.set(packName, hashDirectoryTree(sourcePath));
-    }
-    for (const target of targets) {
-      const installed = [];
-      const refreshed = [];
-      const unchanged = [];
-      const removedLegacyAliases = [];
-      const preservedLegacyAliases = [];
-      try {
-        ensureDir(target.dir);
-        for (const packName of packNames) {
-          const sourcePath = path4.join(sourceDir, packName);
-          const targetPath = path4.join(target.dir, packName);
-          const sourceFingerprint = bundledFingerprints.get(packName);
-          if (!sourceFingerprint) {
-            throw new Error(`Bundled fingerprint missing: ${packName}`);
-          }
-          const outcome = syncSkillDirectory(sourcePath, targetPath, sourceFingerprint);
-          if (outcome === "installed") {
-            installed.push(packName);
-          } else if (outcome === "refreshed") {
-            refreshed.push(packName);
-          } else {
-            unchanged.push(packName);
-          }
-        }
-        const legacyCleanup = cleanupLegacyAliases(target.dir);
-        removedLegacyAliases.push(...legacyCleanup.removed);
-        preservedLegacyAliases.push(...legacyCleanup.preserved);
-        targetResults.push({
-          agents: target.agents,
-          targetDir: target.dir,
-          installed,
-          refreshed,
-          unchanged,
-          removedLegacyAliases,
-          preservedLegacyAliases,
-          success: true
-        });
-      } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        targetResults.push({
-          agents: target.agents,
-          targetDir: target.dir,
-          installed,
-          refreshed,
-          unchanged,
-          removedLegacyAliases,
-          preservedLegacyAliases,
-          success: false,
-          error: message
-        });
-      }
-    }
-    const result = {
-      success: targetResults.every((entry) => entry.success),
-      message: "",
-      mode,
-      targets: targetResults,
-      installed: targetResults.flatMap((entry) => entry.installed),
-      refreshed: targetResults.flatMap((entry) => entry.refreshed),
-      unchanged: targetResults.flatMap((entry) => entry.unchanged),
-      removedLegacyAliases: targetResults.flatMap((entry) => entry.removedLegacyAliases),
-      preservedLegacyAliases: targetResults.flatMap((entry) => entry.preservedLegacyAliases)
-    };
-    result.message = buildSyncMessage(mode, result);
-    return result;
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    const result = {
-      success: false,
-      message: "",
-      mode,
-      targets: targetResults,
-      installed: targetResults.flatMap((entry) => entry.installed),
-      refreshed: targetResults.flatMap((entry) => entry.refreshed),
-      unchanged: targetResults.flatMap((entry) => entry.unchanged),
-      removedLegacyAliases: targetResults.flatMap((entry) => entry.removedLegacyAliases),
-      preservedLegacyAliases: targetResults.flatMap((entry) => entry.preservedLegacyAliases)
-    };
-    result.message = `Failed to sync skills (${mode}): ${message}`;
-    return result;
-  }
-}
-function removeBundledSkills(mode) {
-  const targets = getTargets(mode);
-  const packNames = getCanonicalBundledSkillNames();
-  const targetResults = [];
-  for (const target of targets) {
-    const removed = [];
-    const missing = [];
-    const removedLegacyAliases = [];
-    const preservedLegacyAliases = [];
-    try {
-      for (const packName of packNames) {
-        const targetPath = path4.join(target.dir, packName);
-        if (fs5.existsSync(targetPath)) {
-          fs5.rmSync(targetPath, { recursive: true, force: true });
-          removed.push(packName);
-        } else {
-          missing.push(packName);
-        }
-      }
-      const legacyCleanup = cleanupLegacyAliases(target.dir);
-      removedLegacyAliases.push(...legacyCleanup.removed);
-      preservedLegacyAliases.push(...legacyCleanup.preserved);
-      targetResults.push({
-        agents: target.agents,
-        targetDir: target.dir,
-        removed,
-        missing,
-        removedLegacyAliases,
-        preservedLegacyAliases,
-        success: true
-      });
-    } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      targetResults.push({
-        agents: target.agents,
-        targetDir: target.dir,
-        removed,
-        missing,
-        removedLegacyAliases,
-        preservedLegacyAliases,
-        success: false,
-        error: message
-      });
-    }
-  }
-  const result = {
-    success: targetResults.every((entry) => entry.success),
-    message: "",
-    mode,
-    targets: targetResults,
-    removed: targetResults.flatMap((entry) => entry.removed),
-    missing: targetResults.flatMap((entry) => entry.missing),
-    removedLegacyAliases: targetResults.flatMap((entry) => entry.removedLegacyAliases),
-    preservedLegacyAliases: targetResults.flatMap((entry) => entry.preservedLegacyAliases)
-  };
-  result.message = buildRemovalMessage(mode, result);
-  return result;
-}
-function hasBundledSkillArtifacts(mode) {
-  const packNames = getCanonicalBundledSkillNames();
-  const targets = getTargets(mode);
-  return targets.some((target) => hasCanonicalBundledSkillInTarget(target.dir, packNames));
-}
-
 // src/cli/commands/update.ts
-import * as fs6 from "fs";
-import * as path5 from "path";
-import * as os4 from "os";
-var PLUGIN_NAME2 = "opendevbrowser";
+import * as fs4 from "fs";
+import * as path2 from "path";
+import * as os2 from "os";
+var PLUGIN_NAME = "opendevbrowser";
 function getCacheDir() {
-  return process.env.OPENCODE_CACHE_DIR || path5.join(os4.homedir(), ".cache", "opencode");
+  return process.env.OPENCODE_CACHE_DIR || path2.join(os2.homedir(), ".cache", "opencode");
 }
 function rmdir(dirPath) {
   const cacheDir = getCacheDir();
-  const resolvedCache = path5.resolve(cacheDir);
-  const resolvedPath = path5.resolve(dirPath);
-  if (!resolvedPath.startsWith(resolvedCache + path5.sep) || resolvedPath === resolvedCache) {
+  const resolvedCache = path2.resolve(cacheDir);
+  const resolvedPath = path2.resolve(dirPath);
+  if (!resolvedPath.startsWith(resolvedCache + path2.sep) || resolvedPath === resolvedCache) {
     throw new Error(`Security: refusing to delete path outside cache directory: ${dirPath}`);
   }
-  if (fs6.existsSync(dirPath)) {
-    fs6.rmSync(dirPath, { recursive: true, force: true });
+  if (fs4.existsSync(dirPath)) {
+    fs4.rmSync(dirPath, { recursive: true, force: true });
   }
 }
 function runUpdate() {
   const cacheDir = getCacheDir();
-  const nodeModulesDir = path5.join(cacheDir, "node_modules");
-  const pluginCacheDir = path5.join(nodeModulesDir, PLUGIN_NAME2);
+  const nodeModulesDir = path2.join(cacheDir, "node_modules");
+  const pluginCacheDir = path2.join(nodeModulesDir, PLUGIN_NAME);
   try {
-    if (!fs6.existsSync(pluginCacheDir)) {
-      if (fs6.existsSync(nodeModulesDir)) {
+    if (!fs4.existsSync(pluginCacheDir)) {
+      if (fs4.existsSync(nodeModulesDir)) {
         rmdir(nodeModulesDir);
         return {
           success: true,
@@ -1391,20 +969,29 @@ function runUpdate() {
 }
 
 // src/cli/commands/uninstall.ts
-import * as fs7 from "fs";
-import * as path6 from "path";
-import * as os5 from "os";
+import * as fs5 from "fs";
+import * as path3 from "path";
+import * as os3 from "os";
+function hasInstalledConfig(mode) {
+  const configPath = mode === "global" ? getGlobalConfigPath() : getLocalConfigPath();
+  try {
+    const { config } = readConfig(configPath);
+    return hasPlugin(config);
+  } catch {
+    return false;
+  }
+}
 function getPluginConfigPath2(mode) {
   if (mode === "global") {
-    const configDir = process.env.OPENCODE_CONFIG_DIR || path6.join(os5.homedir(), ".config", "opencode");
-    return path6.join(configDir, "opendevbrowser.jsonc");
+    const configDir = process.env.OPENCODE_CONFIG_DIR || path3.join(os3.homedir(), ".config", "opencode");
+    return path3.join(configDir, "opendevbrowser.jsonc");
   }
-  return path6.join(process.cwd(), "opendevbrowser.jsonc");
+  return path3.join(process.cwd(), "opendevbrowser.jsonc");
 }
 function removePluginConfigFile(mode) {
   const configPath = getPluginConfigPath2(mode);
-  if (fs7.existsSync(configPath)) {
-    fs7.unlinkSync(configPath);
+  if (fs5.existsSync(configPath)) {
+    fs5.unlinkSync(configPath);
     return true;
   }
   return false;
@@ -1416,14 +1003,14 @@ function runUninstall(mode, deleteConfigFile = false) {
     if (!hasPlugin(config)) {
       return {
         success: true,
-        message: `opendevbrowser is not installed in ${configPath}`,
+        message: `No plugin config found in ${configPath}`,
         configPath,
         removed: false,
         configFileDeleted: false
       };
     }
     const newContent = removePluginFromContent(content, "opendevbrowser");
-    fs7.writeFileSync(configPath, newContent, "utf-8");
+    fs5.writeFileSync(configPath, newContent, "utf-8");
     let configFileDeleted = false;
     if (deleteConfigFile) {
       configFileDeleted = removePluginConfigFile(mode);
@@ -1447,19 +1034,10 @@ function runUninstall(mode, deleteConfigFile = false) {
   }
 }
 function findInstalledConfigs() {
-  let global = false;
-  let local = false;
-  try {
-    const { config: globalConfig } = readConfig(getGlobalConfigPath());
-    global = hasPlugin(globalConfig);
-  } catch {
-  }
-  try {
-    const { config: localConfig } = readConfig(getLocalConfigPath());
-    local = hasPlugin(localConfig);
-  } catch {
-  }
-  return { global, local };
+  return {
+    global: hasInstalledConfig("global") || hasManagedBundledSkillInstall("global") || hasBundledSkillArtifacts("global"),
+    local: hasInstalledConfig("local") || hasManagedBundledSkillInstall("local") || hasBundledSkillArtifacts("local")
+  };
 }
 
 // src/cli/commands/serve.ts
@@ -1549,8 +1127,8 @@ function parseRepeatedStringFlag(rawArgs, flag) {
 }
 
 // src/cli/commands/native.ts
-import * as fs8 from "fs";
-import * as path7 from "path";
+import * as fs6 from "fs";
+import * as path4 from "path";
 import { execFileSync } from "child_process";
 import { fileURLToPath } from "url";
 var EXTENSION_ID_RE = /^[a-p]{32}$/;
@@ -1585,33 +1163,33 @@ var parseNativeArgs = (rawArgs) => {
 };
 var getManifestDir = () => {
   if (process.platform === "darwin") {
-    return path7.join(process.env.HOME || "", "Library", "Application Support", "Google", "Chrome", "NativeMessagingHosts");
+    return path4.join(process.env.HOME || "", "Library", "Application Support", "Google", "Chrome", "NativeMessagingHosts");
   }
   if (process.platform === "linux") {
-    return path7.join(process.env.HOME || "", ".config", "google-chrome", "NativeMessagingHosts");
+    return path4.join(process.env.HOME || "", ".config", "google-chrome", "NativeMessagingHosts");
   }
   if (process.platform === "win32") {
-    const base = process.env.LOCALAPPDATA || (process.env.USERPROFILE ? path7.join(process.env.USERPROFILE, "AppData", "Local") : "");
+    const base = process.env.LOCALAPPDATA || (process.env.USERPROFILE ? path4.join(process.env.USERPROFILE, "AppData", "Local") : "");
     if (!base) {
       throw createUsageError("LOCALAPPDATA is not set. Unable to locate NativeMessagingHosts directory.");
     }
-    return path7.join(base, "Google", "Chrome", "User Data", "NativeMessagingHosts");
+    return path4.join(base, "Google", "Chrome", "User Data", "NativeMessagingHosts");
   }
   throw createUsageError(`Native messaging is not supported on ${process.platform}.`);
 };
 var getScriptsDir = () => {
   const __filename = fileURLToPath(import.meta.url);
-  const startDir = path7.dirname(__filename);
+  const startDir = path4.dirname(__filename);
   const rootsToScan = [startDir, process.cwd()];
   for (const root of rootsToScan) {
-    let current = path7.resolve(root);
+    let current = path4.resolve(root);
     while (true) {
-      const scriptsDir = path7.join(current, "scripts", "native");
-      const packageJsonPath = path7.join(current, "package.json");
-      if (fs8.existsSync(scriptsDir) && fs8.existsSync(packageJsonPath)) {
+      const scriptsDir = path4.join(current, "scripts", "native");
+      const packageJsonPath = path4.join(current, "package.json");
+      if (fs6.existsSync(scriptsDir) && fs6.existsSync(packageJsonPath)) {
         return scriptsDir;
       }
-      const parent = path7.dirname(current);
+      const parent = path4.dirname(current);
       if (parent === current) {
         break;
       }
@@ -1621,18 +1199,18 @@ var getScriptsDir = () => {
   throw createUsageError("Unable to locate scripts/native directory.");
 };
 var getHostScriptPath = () => {
-  return path7.join(getScriptsDir(), "host.cjs");
+  return path4.join(getScriptsDir(), "host.cjs");
 };
 var getManifestPath = () => {
-  return path7.join(getManifestDir(), "com.opendevbrowser.native.json");
+  return path4.join(getManifestDir(), "com.opendevbrowser.native.json");
 };
 var getWrapperPath = () => {
   const wrapperName = process.platform === "win32" ? "com.opendevbrowser.native.cmd" : "com.opendevbrowser.native.sh";
-  return path7.join(getManifestDir(), wrapperName);
+  return path4.join(getManifestDir(), wrapperName);
 };
 var readManifest = (manifestPath) => {
   try {
-    const raw = fs8.readFileSync(manifestPath, "utf8");
+    const raw = fs6.readFileSync(manifestPath, "utf8");
     const data = JSON.parse(raw);
     const origins = Array.isArray(data.allowed_origins) ? data.allowed_origins : [];
     const match = origins.find((origin) => origin.startsWith("chrome-extension://"));
@@ -1669,9 +1247,9 @@ var readRegistryPath = () => {
 };
 var normalizePath = (value) => {
   try {
-    return fs8.realpathSync(value);
+    return fs6.realpathSync(value);
   } catch {
-    return path7.resolve(value);
+    return path4.resolve(value);
   }
 };
 var findExtensionIdInCommands = (preferences) => {
@@ -1732,8 +1310,8 @@ var getExtensionPathCandidates = () => {
   if (primary) {
     candidates.add(normalizePath(primary));
   }
-  const cwdExtension = path7.join(process.cwd(), "extension");
-  if (fs8.existsSync(path7.join(cwdExtension, "manifest.json"))) {
+  const cwdExtension = path4.join(process.cwd(), "extension");
+  if (fs6.existsSync(path4.join(cwdExtension, "manifest.json"))) {
     candidates.add(normalizePath(cwdExtension));
   }
   if (candidates.size === 0) {
@@ -1818,13 +1396,13 @@ var getNativeStatusSnapshot = () => {
   let manifestExists = false;
   let wrapperExists = false;
   let extensionIdValue = null;
-  if (fs8.existsSync(manifestPath)) {
+  if (fs6.existsSync(manifestPath)) {
     manifestExists = true;
     installed = true;
     const manifest = readManifest(manifestPath);
     extensionIdValue = manifest.extensionId;
   }
-  if (fs8.existsSync(wrapperPath)) {
+  if (fs6.existsSync(wrapperPath)) {
     wrapperExists = true;
   }
   if (!manifestExists || !wrapperExists) {
@@ -1884,7 +1462,7 @@ function installNativeHost(extensionId) {
     };
   }
   const hostScript = getHostScriptPath();
-  if (!fs8.existsSync(hostScript)) {
+  if (!fs6.existsSync(hostScript)) {
     return {
       success: false,
       message: `Native host not found at ${hostScript}.`,
@@ -1893,7 +1471,7 @@ function installNativeHost(extensionId) {
   }
   const scriptsDir = getScriptsDir();
   const manifestPath = getManifestPath();
-  const installScript = process.platform === "win32" ? path7.join(scriptsDir, "install.ps1") : path7.join(scriptsDir, "install.sh");
+  const installScript = process.platform === "win32" ? path4.join(scriptsDir, "install.ps1") : path4.join(scriptsDir, "install.sh");
   try {
     runScript(installScript, [normalized]);
     return {
@@ -1913,7 +1491,7 @@ function installNativeHost(extensionId) {
 async function runNativeCommand(args) {
   const { subcommand, extensionId } = parseNativeArgs(args.rawArgs);
   const scriptsDir = getScriptsDir();
-  const uninstallScript = process.platform === "win32" ? path7.join(scriptsDir, "uninstall.ps1") : path7.join(scriptsDir, "uninstall.sh");
+  const uninstallScript = process.platform === "win32" ? path4.join(scriptsDir, "uninstall.ps1") : path4.join(scriptsDir, "uninstall.sh");
   if (subcommand === "install") {
     return installNativeHost(extensionId);
   }
@@ -2289,9 +1867,9 @@ ${nativeMessage}${fingerprintNote}${staleNote}` : `${baseMessage}${fingerprintNo
 
 // src/cli/daemon-autostart.ts
 import { execFileSync as execFileSync2 } from "child_process";
-import { existsSync as existsSync7, mkdirSync as mkdirSync3, unlinkSync as unlinkSync2, writeFileSync as writeFileSync4 } from "fs";
-import { homedir as homedir6, tmpdir } from "os";
-import { dirname as dirname5, isAbsolute, join as join8, relative, resolve as resolve4 } from "path";
+import { existsSync as existsSync5, mkdirSync as mkdirSync2, unlinkSync as unlinkSync2, writeFileSync as writeFileSync4 } from "fs";
+import { homedir as homedir4, tmpdir } from "os";
+import { dirname as dirname3, isAbsolute, join as join5, relative, resolve as resolve3 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 var MAC_LABEL = "com.opendevbrowser.daemon";
 var WIN_TASK_NAME = "OpenDevBrowser Daemon";
@@ -2301,9 +1879,9 @@ var defaultDeps = () => ({
   argv1: process.argv[1] ?? "",
   moduleUrl: import.meta.url,
   uid: typeof process.getuid === "function" ? process.getuid() : 0,
-  homedir: homedir6,
-  existsSync: existsSync7,
-  mkdirSync: mkdirSync3,
+  homedir: homedir4,
+  existsSync: existsSync5,
+  mkdirSync: mkdirSync2,
   writeFileSync: writeFileSync4,
   unlinkSync: unlinkSync2,
   execFileSync: execFileSync2,
@@ -2315,14 +1893,14 @@ var formatCommand = (programArguments) => {
 };
 var resolveCliPathFromModule = (moduleUrl, exists) => {
   const modulePath = fileURLToPath2(moduleUrl);
-  const candidate = resolve4(dirname5(modulePath), "..", "index.js");
+  const candidate = resolve3(dirname3(modulePath), "..", "index.js");
   if (!exists(candidate)) {
     throw new Error(`CLI entrypoint not found at ${candidate}`);
   }
   return candidate;
 };
 var normalizeComparisonPath = (value, platform) => {
-  const resolvedPath = resolve4(value);
+  const resolvedPath = resolve3(value);
   return platform === "win32" ? resolvedPath.toLowerCase() : resolvedPath;
 };
 var isPathInsideRoot = (candidate, root, platform) => {
@@ -2357,7 +1935,7 @@ var resolveCliEntrypoint = (deps = {}) => {
   let cliPath = null;
   let source = "module";
   if (resolved.argv1) {
-    const candidate = resolve4(resolved.argv1);
+    const candidate = resolve3(resolved.argv1);
     if (exists(candidate)) {
       cliPath = candidate;
       source = "argv1";
@@ -2372,13 +1950,13 @@ var resolveCliEntrypoint = (deps = {}) => {
   const isTransient = isTransientCliPath(cliPath, resolved);
   return { nodePath, cliPath, args, command, source, isTransient };
 };
-var getLaunchAgentPath = (home = homedir6()) => {
-  return join8(home, "Library", "LaunchAgents", `${MAC_LABEL}.plist`);
+var getLaunchAgentPath = (home = homedir4()) => {
+  return join5(home, "Library", "LaunchAgents", `${MAC_LABEL}.plist`);
 };
 var buildLaunchAgentPlist = (entrypoint, options = {}) => {
   const label = options.label ?? MAC_LABEL;
-  const stdoutPath = options.stdoutPath ?? join8(homedir6(), "Library", "Logs", "opendevbrowser-daemon.log");
-  const stderrPath = options.stderrPath ?? join8(homedir6(), "Library", "Logs", "opendevbrowser-daemon.err.log");
+  const stdoutPath = options.stdoutPath ?? join5(homedir4(), "Library", "Logs", "opendevbrowser-daemon.log");
+  const stderrPath = options.stderrPath ?? join5(homedir4(), "Library", "Logs", "opendevbrowser-daemon.err.log");
   const programArgs = [entrypoint.nodePath, ...entrypoint.args].map((value) => `      <string>${value}</string>`).join("\n");
   return [
     '<?xml version="1.0" encoding="UTF-8"?>',
@@ -2583,10 +2161,10 @@ var installMacAutostart = (deps = {}) => {
   assertPersistentEntrypoint(entrypoint);
   const home = resolved.homedir();
   const plistPath = getLaunchAgentPath(home);
-  const stdoutPath = join8(home, "Library", "Logs", "opendevbrowser-daemon.log");
-  const stderrPath = join8(home, "Library", "Logs", "opendevbrowser-daemon.err.log");
-  const logsDir = dirname5(stdoutPath);
-  resolved.mkdirSync(dirname5(plistPath), { recursive: true });
+  const stdoutPath = join5(home, "Library", "Logs", "opendevbrowser-daemon.log");
+  const stderrPath = join5(home, "Library", "Logs", "opendevbrowser-daemon.err.log");
+  const logsDir = dirname3(stdoutPath);
+  resolved.mkdirSync(dirname3(plistPath), { recursive: true });
   resolved.mkdirSync(logsDir, { recursive: true });
   resolved.writeFileSync(
     plistPath,
@@ -2963,7 +2541,7 @@ async function runDaemonCommand(args) {
 }
 
 // src/cli/commands/artifacts.ts
-import { join as join9, resolve as resolve5 } from "path";
+import { join as join6, resolve as resolve4 } from "path";
 import { tmpdir as tmpdir2 } from "os";
 var PASSTHROUGH_BOOLEAN_FLAGS = /* @__PURE__ */ new Set([
   "--with-config",
@@ -3052,7 +2630,7 @@ var parseArtifactsArgs = (rawArgs) => {
 };
 async function runArtifactsCommand(args) {
   const parsed = parseArtifactsArgs(args.rawArgs);
-  const rootDir = parsed.outputDir ? resolve5(parsed.outputDir) : join9(tmpdir2(), "opendevbrowser");
+  const rootDir = parsed.outputDir ? resolve4(parsed.outputDir) : join6(tmpdir2(), "opendevbrowser");
   const cleaned = await cleanupExpiredArtifacts(rootDir);
   return {
     success: true,
@@ -3163,34 +2741,34 @@ function formatAutostartReconciliationMessage(result) {
 }
 
 // src/cli/commands/run.ts
-import { readFileSync as readFileSync4 } from "fs";
+import { readFileSync as readFileSync2 } from "fs";
 
 // src/cli/output.ts
 var normalizeExitCode = (code) => {
   return Number.isInteger(code) ? Number(code) : 0;
 };
 var flushStream = (stream) => {
-  return new Promise((resolve6) => {
+  return new Promise((resolve5) => {
     if (!stream || typeof stream.write !== "function") {
-      resolve6();
+      resolve5();
       return;
     }
     try {
-      stream.write("", () => resolve6());
+      stream.write("", () => resolve5());
     } catch {
-      resolve6();
+      resolve5();
     }
   });
 };
 async function flushOutputAndExit(code, proc = process, timeoutMs = 250) {
   const finalCode = normalizeExitCode(code);
   proc.exitCode = finalCode;
-  await new Promise((resolve6) => {
+  await new Promise((resolve5) => {
     let settled = false;
     const finish = () => {
       if (settled) return;
       settled = true;
-      resolve6();
+      resolve5();
     };
     const timer = setTimeout(finish, Math.max(0, timeoutMs));
     timer.unref?.();
@@ -3312,13 +2890,13 @@ function parseRunArgs(rawArgs) {
   return parsed;
 }
 function readScriptFromStdin() {
-  return new Promise((resolve6, reject) => {
+  return new Promise((resolve5, reject) => {
     let data = "";
     process.stdin.setEncoding("utf8");
     process.stdin.on("data", (chunk) => {
       data += chunk;
     });
-    process.stdin.on("end", () => resolve6(data));
+    process.stdin.on("end", () => resolve5(data));
     process.stdin.on("error", reject);
   });
 }
@@ -3327,7 +2905,7 @@ async function runScriptCommand(args) {
   const outputOptions = { format: args.outputFormat, quiet: args.quiet };
   let scriptRaw = "";
   if (runArgs.scriptPath) {
-    scriptRaw = readFileSync4(runArgs.scriptPath, "utf-8");
+    scriptRaw = readFileSync2(runArgs.scriptPath, "utf-8");
   } else if (!process.stdin.isTTY) {
     scriptRaw = await readScriptFromStdin();
   } else {
@@ -3552,16 +3130,16 @@ function promptYesNo(question, defaultYes) {
     return Promise.resolve(false);
   }
   const suffix = defaultYes ? " [Y/n] " : " [y/N] ";
-  return new Promise((resolve6) => {
+  return new Promise((resolve5) => {
     process.stdout.write(`${question}${suffix}`);
     process.stdin.setEncoding("utf8");
     process.stdin.once("data", (data) => {
       const input = data.toString().trim().toLowerCase();
       if (!input) {
-        resolve6(defaultYes);
+        resolve5(defaultYes);
         return;
       }
-      resolve6(input === "y" || input === "yes");
+      resolve5(input === "y" || input === "yes");
     });
   });
 }
@@ -3681,6 +3259,12 @@ async function runSessionDisconnect(args) {
 // src/cli/utils/workflow-message.ts
 var asRecord = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : null;
 var readNonEmptyString = (value) => typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+var UNRESOLVED_COMMAND_PLACEHOLDER_RE = /<[^>\n]+>/;
+var readRunnableStepCommand = (step) => {
+  const command = readNonEmptyString(step.command);
+  if (!command) return null;
+  return UNRESOLVED_COMMAND_PLACEHOLDER_RE.test(command) ? null : command;
+};
 var readMeta = (data) => {
   return asRecord(asRecord(data)?.meta);
 };
@@ -3728,6 +3312,17 @@ var readSuggestedNextAction = (data) => {
   if (!record) return null;
   return readNonEmptyString(record.suggestedNextAction) ?? readNonEmptyString(asRecord(record.sessionInspector)?.suggestedNextAction);
 };
+var readSuggestedStepCommand = (data) => {
+  let current = asRecord(data);
+  while (current) {
+    const command = readSuggestedSteps(current).map(readRunnableStepCommand).find((step) => Boolean(step));
+    if (command) {
+      return command;
+    }
+    current = asRecord(current.challengePlan);
+  }
+  return null;
+};
 var readSuggestedStepReason = (data) => {
   let current = asRecord(data);
   while (current) {
@@ -3758,7 +3353,7 @@ var buildWorkflowCompletionMessage = (workflowLabel, data) => {
   if (followthroughSummary) {
     return buildNextStepMessage(
       `${workflowLabel} completed. ${followthroughSummary}`,
-      readSuggestedNextAction(data) ?? readSuggestedStepReason(data)
+      readSuggestedNextAction(data) ?? readSuggestedStepCommand(data) ?? readSuggestedStepReason(data)
     );
   }
   return `${workflowLabel} completed.`;
@@ -4519,7 +4114,7 @@ async function runAnnotate(args) {
 }
 
 // src/cli/commands/canvas.ts
-import { readFileSync as readFileSync5 } from "fs";
+import { readFileSync as readFileSync3 } from "fs";
 var DEFAULT_FEEDBACK_STREAM_TIMEOUT_MS = 3e4;
 var isRecord = (value) => {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -4720,7 +4315,7 @@ var resolveCanvasParams = (canvasArgs) => {
   if (hasParamsFile) {
     let raw = "";
     try {
-      raw = readFileSync5(canvasArgs.paramsFile ?? "", "utf8");
+      raw = readFileSync3(canvasArgs.paramsFile ?? "", "utf8");
     } catch (error) {
       const message = error instanceof Error ? error.message : "Unable to read file";
       throw createUsageError(`Invalid --params-file: ${message}`);
@@ -4789,7 +4384,7 @@ async function runCanvas(args) {
 }
 
 // src/cli/commands/rpc.ts
-import { readFileSync as readFileSync6 } from "fs";
+import { readFileSync as readFileSync4 } from "fs";
 var requireValue4 = (value, flag) => {
   if (!value) throw createUsageError(`Missing value for ${flag}`);
   return value;
@@ -4869,7 +4464,7 @@ var resolveRpcParams = (rpcArgs) => {
   if (hasParamsFile) {
     let raw = "";
     try {
-      raw = readFileSync6(rpcArgs.paramsFile ?? "", "utf8");
+      raw = readFileSync4(rpcArgs.paramsFile ?? "", "utf8");
     } catch (error) {
       const message = error instanceof Error ? error.message : "Unable to read file";
       throw createUsageError(`Invalid --params-file: ${message}`);
@@ -6249,11 +5844,11 @@ function parseScreenshotArgs(rawArgs) {
   return parsed;
 }
 async function runScreenshot(args) {
-  const { sessionId, targetId, path: path8, ref, fullPage, timeoutMs } = parseScreenshotArgs(args.rawArgs);
+  const { sessionId, targetId, path: path5, ref, fullPage, timeoutMs } = parseScreenshotArgs(args.rawArgs);
   if (!sessionId) throw createUsageError("Missing --session-id");
   const params = {
     sessionId,
-    ...typeof path8 === "string" ? { path: path8 } : {},
+    ...typeof path5 === "string" ? { path: path5 } : {},
     ...typeof targetId === "string" ? { targetId } : {},
     ...typeof ref === "string" ? { ref } : {},
     ...fullPage === true ? { fullPage: true } : {}
@@ -6652,7 +6247,7 @@ async function runDesktopAccessibilitySnapshot(args) {
 }
 
 // src/cli/commands/session/cookie-import.ts
-import { readFileSync as readFileSync7 } from "fs";
+import { readFileSync as readFileSync5 } from "fs";
 var requireValue5 = (value, flag) => {
   if (!value) {
     throw createUsageError(`Missing value for ${flag}`);
@@ -6767,7 +6362,7 @@ var resolveCookies = (parsed) => {
   }
   let raw = "";
   try {
-    raw = readFileSync7(parsed.cookiesFile ?? "", "utf8");
+    raw = readFileSync5(parsed.cookiesFile ?? "", "utf8");
   } catch (error) {
     const message = error instanceof Error ? error.message : "Unable to read file";
     throw createUsageError(`Invalid --cookies-file: ${message}`);
@@ -6904,12 +6499,28 @@ var asRecord2 = (value) => {
   }
   return value;
 };
+var readNonEmptyString2 = (value) => typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
 var hasExecutionBlocker = (result) => {
   const execution = asRecord2(asRecord2(result)?.execution);
   const meta = asRecord2(execution?.meta);
   return asRecord2(meta?.blocker) !== null;
 };
+var readMacroResolveSummary = (result) => readNonEmptyString2(asRecord2(result)?.followthroughSummary);
+var readMacroResolveNextStep = (result) => {
+  const record = asRecord2(result);
+  const explicit = readNonEmptyString2(record?.suggestedNextAction);
+  if (explicit) {
+    return explicit;
+  }
+  const [firstStep] = Array.isArray(record?.suggestedSteps) ? record.suggestedSteps.filter((step) => Boolean(step) && typeof step === "object") : [];
+  return readNonEmptyString2(firstStep?.command) ?? readNonEmptyString2(firstStep?.reason);
+};
 var buildMacroResolveMessage = (execute, result) => {
+  const summary = readMacroResolveSummary(result);
+  const nextStep = readMacroResolveNextStep(result);
+  if (summary) {
+    return nextStep ? `${summary} Next step: ${nextStep}` : summary;
+  }
   if (!execute) {
     return "Macro resolved.";
   }
@@ -7803,7 +7414,7 @@ async function runInspiredesignCommand(args) {
 // package.json
 var package_default = {
   name: "opendevbrowser",
-  version: "0.0.21",
+  version: "0.0.23",
   description: "Browser automation runtime with snapshot-refs-actions, browser replay screencasts, public read-only desktop observation, and browser-scoped computer-use orchestration",
   type: "module",
   main: "dist/index.js",
@@ -7814,6 +7425,7 @@ var package_default = {
   files: [
     "dist",
     "skills",
+    "scripts/postinstall-sync-skills.mjs",
     "scripts/native",
     "extension/canvas.html",
     "extension/manifest.json",
@@ -7848,8 +7460,8 @@ var package_default = {
     node: ">=18"
   },
   scripts: {
-    build: "node scripts/run-package-tool.mjs tsup src/index.ts src/cli/index.ts src/skills/skill-loader.ts --format esm --clean --sourcemap && node scripts/run-package-tool.mjs tsc --emitDeclarationOnly --declaration --declarationMap -p tsconfig.json && node scripts/postbuild-dist.mjs",
-    dev: "tsup src/index.ts src/cli/index.ts src/skills/skill-loader.ts --format esm --dts --watch",
+    build: "node scripts/run-package-tool.mjs tsup src/index.ts src/cli/index.ts src/cli/installers/postinstall-skill-sync.ts src/skills/skill-loader.ts --format esm --clean --sourcemap && node scripts/run-package-tool.mjs tsc --emitDeclarationOnly --declaration --declarationMap -p tsconfig.json && node scripts/postbuild-dist.mjs",
+    dev: "tsup src/index.ts src/cli/index.ts src/cli/installers/postinstall-skill-sync.ts src/skills/skill-loader.ts --format esm --dts --watch",
     lint: 'node scripts/run-package-tool.mjs eslint "src/**/*.ts" "tests/**/*.ts"',
     typecheck: "node scripts/run-package-tool.mjs tsc --noEmit -p tsconfig.json",
     test: "node scripts/run-vitest-coverage.mjs",
@@ -7864,7 +7476,8 @@ var package_default = {
     "extension:pack": "cd extension && zip -r ../opendevbrowser-extension.zip manifest.json popup.html canvas.html dist/ icons/",
     "extension:store": "node scripts/chrome-store-publish.mjs",
     "version:check": "node scripts/verify-versions.mjs",
-    prepack: "npm run version:check && npm run build && npm run extension:build"
+    prepack: "npm run version:check && npm run build && npm run extension:build",
+    postinstall: "node scripts/postinstall-sync-skills.mjs"
   },
   dependencies: {
     "@opencode-ai/plugin": "^1.2.25",
@@ -7892,8 +7505,10 @@ var package_default = {
   }
 };
 
-// src/cli/index.ts
-var VERSION = typeof package_default.version === "string" ? package_default.version : "0.0.0";
+// src/cli/update-skill-modes.ts
+function shouldRefreshManagedSkills(mode) {
+  return hasManagedBundledSkillInstall(mode) || hasBundledSkillArtifacts(mode);
+}
 function resolveUpdateSkillModes(args) {
   if (args.rawArgs.includes("--no-skills")) {
     return [];
@@ -7907,22 +7522,102 @@ function resolveUpdateSkillModes(args) {
   if (args.mode) {
     return [args.mode];
   }
-  const installed = findInstalledConfigs();
   const modes = [];
-  if (installed.global || hasBundledSkillArtifacts("global")) {
+  if (shouldRefreshManagedSkills("global")) {
     modes.push("global");
   }
-  if (installed.local || hasBundledSkillArtifacts("local")) {
+  if (shouldRefreshManagedSkills("local")) {
     modes.push("local");
   }
   return modes;
 }
+
+// src/cli/skill-lifecycle.ts
+function shouldSkipSkills(args) {
+  return args.rawArgs.includes("--no-skills");
+}
+function getUpdateTargets(args, mode, deps) {
+  if (deps.hasInstalledConfig(mode)) {
+    return deps.getBundledSkillTargets(mode);
+  }
+  return deps.getBundledSkillLifecycleTargets(mode, {
+    includeLegacyArtifacts: deps.hasBundledSkillArtifacts(mode)
+  });
+}
+function collectUpdateSkillResults(args, deps, modes) {
+  return modes.flatMap((mode) => {
+    const targets = getUpdateTargets(args, mode, deps);
+    return targets.length > 0 ? [deps.syncBundledSkillsForTargets(mode, targets)] : [];
+  });
+}
+function getResolvedUpdateSkillModes(args, result, deps) {
+  return result.success ? deps.resolveUpdateSkillModes(args) : [];
+}
+function buildUpdateSkillMessage(args, result, skillResults) {
+  if (!result.success) {
+    return "";
+  }
+  if (shouldSkipSkills(args)) {
+    return "Managed skill refresh skipped (--no-skills).";
+  }
+  if (skillResults.length === 0) {
+    return "No managed skill packs required refresh.";
+  }
+  return skillResults.map((entry) => entry.message).join("\n");
+}
+function buildUpdateCommandResult(args, result, deps) {
+  const skillModes = getResolvedUpdateSkillModes(args, result, deps);
+  const skillResults = result.success && !shouldSkipSkills(args) ? collectUpdateSkillResults(args, deps, skillModes) : [];
+  const message = [result.message, buildUpdateSkillMessage(args, result, skillResults)].filter(Boolean).join("\n");
+  return {
+    success: result.success && skillResults.every((entry) => entry.success),
+    message,
+    data: {
+      cacheCleared: result.cleared,
+      skillModes,
+      skills: skillResults
+    }
+  };
+}
+function buildUninstallSkillMessage(args, result, skillsResult) {
+  if (!result.success) {
+    return "";
+  }
+  if (shouldSkipSkills(args)) {
+    return "Managed skill cleanup skipped (--no-skills).";
+  }
+  return skillsResult?.message ?? "No managed skill packs required cleanup.";
+}
+function getUninstallTargets(args, mode, result, deps) {
+  if (!result.success || shouldSkipSkills(args)) {
+    return [];
+  }
+  return deps.getBundledSkillLifecycleTargets(mode, {
+    includeLegacyArtifacts: result.removed || deps.hasBundledSkillArtifacts(mode)
+  });
+}
+function buildUninstallCommandResult(args, mode, result, deps) {
+  const targets = getUninstallTargets(args, mode, result, deps);
+  const skillsResult = result.success && !shouldSkipSkills(args) ? targets.length > 0 ? deps.removeBundledSkillsForTargets(mode, targets) : createNoOpSkillRemovalResult(mode) : void 0;
+  const skillMessage = buildUninstallSkillMessage(args, result, skillsResult);
+  return {
+    success: result.success && (skillsResult?.success ?? true),
+    message: [result.message, skillMessage].filter(Boolean).join("\n"),
+    data: {
+      config: result,
+      skills: skillsResult
+    }
+  };
+}
+
+// src/cli/index.ts
+var VERSION = typeof package_default.version === "string" ? package_default.version : "0.0.0";
 async function promptInstallMode() {
   if (!process.stdin.isTTY) {
     console.log("Non-interactive mode detected. Using global install.");
     return "global";
   }
-  return new Promise((resolve6) => {
+  return new Promise((resolve5) => {
     console.log("\nWhere would you like to install opendevbrowser?\n");
     console.log("  1. Global (~/.config/opencode/opencode.json)");
     console.log("  2. Local (./opencode.json in this project)\n");
@@ -7942,23 +7637,23 @@ async function promptInstallMode() {
       resolved = true;
       const input = data.toString().trim();
       if (input === "2") {
-        resolve6("local");
+        resolve5("local");
       } else {
-        resolve6("global");
+        resolve5("global");
       }
     });
     process.stdin.once("close", () => {
       cleanup();
       if (resolved) return;
       resolved = true;
-      resolve6("global");
+      resolve5("global");
     });
     timeoutId = setTimeout(() => {
       timeoutId = null;
       if (resolved) return;
       resolved = true;
       console.log("\nTimeout - using global install.");
-      resolve6("global");
+      resolve5("global");
     }, 3e4);
   });
 }
@@ -7978,7 +7673,7 @@ async function promptUninstallMode() {
     console.log("Plugin found in both global and local configs. Use --global or --local flag.");
     return null;
   }
-  return new Promise((resolve6) => {
+  return new Promise((resolve5) => {
     console.log("\nopendevbrowser is installed in multiple locations:\n");
     console.log("  1. Global (~/.config/opencode/opencode.json)");
     console.log("  2. Local (./opencode.json)");
@@ -7988,15 +7683,15 @@ async function promptUninstallMode() {
     process.stdin.once("data", (data) => {
       const input = data.toString().trim();
       if (input === "1") {
-        resolve6("global");
+        resolve5("global");
       } else if (input === "2") {
-        resolve6("local");
+        resolve5("local");
       } else {
-        resolve6(null);
+        resolve5(null);
       }
     });
     process.stdin.once("close", () => {
-      resolve6(null);
+      resolve5(null);
     });
   });
 }
@@ -8054,22 +7749,14 @@ async function main() {
     registerCommand({
       name: "update",
       description: "Clear cached plugin and refresh managed skill packs",
-      run: () => {
-        const result2 = runUpdate();
-        const skillModes = result2.success ? resolveUpdateSkillModes(args) : [];
-        const skillResults = result2.success ? skillModes.map((mode) => syncBundledSkills(mode)) : [];
-        const skillMessage = args.rawArgs.includes("--no-skills") ? "Managed skill refresh skipped (--no-skills)." : skillResults.length > 0 ? skillResults.map((entry) => entry.message).join("\n") : result2.success ? "No managed skill packs required refresh." : "";
-        const message = [result2.message, skillMessage].filter(Boolean).join("\n");
-        return {
-          success: result2.success && skillResults.every((entry) => entry.success),
-          message,
-          data: {
-            cacheCleared: result2.cleared,
-            skillModes,
-            skills: skillResults
-          }
-        };
-      }
+      run: () => buildUpdateCommandResult(args, runUpdate(), {
+        resolveUpdateSkillModes,
+        hasInstalledConfig,
+        hasBundledSkillArtifacts,
+        getBundledSkillTargets,
+        getBundledSkillLifecycleTargets,
+        syncBundledSkillsForTargets
+      })
     });
     registerCommand({
       name: "uninstall",
@@ -8085,18 +7772,11 @@ async function main() {
         if (!mode) {
           return { success: false, message: "Error: Please specify --global or --local for uninstall.", exitCode: EXIT_USAGE };
         }
-        const result2 = runUninstall(mode);
-        const skipSkills = args.rawArgs.includes("--no-skills");
-        const skillsResult = result2.success && !skipSkills ? removeBundledSkills(mode) : void 0;
-        const skillMessage = skipSkills ? "Managed skill cleanup skipped (--no-skills)." : skillsResult?.message ?? "";
-        return {
-          success: result2.success && (skillsResult?.success ?? true),
-          message: [result2.message, skillMessage].filter(Boolean).join("\n"),
-          data: {
-            config: result2,
-            skills: skillsResult
-          }
-        };
+        return buildUninstallCommandResult(args, mode, runUninstall(mode), {
+          hasBundledSkillArtifacts,
+          getBundledSkillLifecycleTargets,
+          removeBundledSkillsForTargets
+        });
       }
     });
     registerCommand({