runwork 0.16.0 → 0.17.0

package/dist/index.js

@@ -7381,7 +7381,7 @@ function createKeyboardListener() {
 }
 
 // src/generated/version.ts
-var VERSION = "0.16.0";
+var VERSION = "0.17.0";
 
 // src/commands/dev.ts
 var exports_dev = {};
@@ -10989,6 +10989,92 @@ function extractCodexRolloutSession(raw, agentSlug) {
     digest.project = "codex";
   return digest;
 }
+function extractCursorSessions(composerRows, bubbleRows, sinceISO) {
+  const composerCreatedAt = new Map;
+  for (const line of composerRows.split(`
+`)) {
+    if (!line.trim())
+      continue;
+    try {
+      const o = JSON.parse(line);
+      if (o.id)
+        composerCreatedAt.set(o.id, typeof o.createdAt === "number" ? o.createdAt : 0);
+    } catch {}
+  }
+  const byComposer = new Map;
+  for (const line of bubbleRows.split(`
+`)) {
+    if (!line.trim())
+      continue;
+    let o;
+    try {
+      o = JSON.parse(line);
+    } catch {
+      continue;
+    }
+    const parts = (o.k ?? "").split(":");
+    if (parts.length < 3)
+      continue;
+    const cid = parts[1];
+    const list = byComposer.get(cid) ?? [];
+    list.push({ type: o.type ?? null, text: o.text ?? null, ts: o.ts ?? null, tool: o.tool ?? null, status: o.status ?? null });
+    byComposer.set(cid, list);
+  }
+  const digests = [];
+  for (const [cid, bubbles] of byComposer) {
+    bubbles.sort((a, b) => (a.ts ?? "").localeCompare(b.ts ?? ""));
+    const digest = {
+      agentSlug: "cursor",
+      project: "cursor",
+      start: null,
+      end: null,
+      userMessages: [],
+      droppedUserMessages: 0,
+      toolCounts: {},
+      skillInvocations: [],
+      errorCount: 0,
+      assistantTurns: 0
+    };
+    for (const b of bubbles) {
+      if (b.ts) {
+        if (!digest.start)
+          digest.start = b.ts;
+        digest.end = b.ts;
+      }
+      if (b.tool) {
+        digest.toolCounts[b.tool] = (digest.toolCounts[b.tool] ?? 0) + 1;
+        if (b.status === "error")
+          digest.errorCount++;
+      } else if (b.type === 2) {
+        digest.assistantTurns++;
+      }
+      if (b.type === 1 && typeof b.text === "string") {
+        const trimmed = b.text.trim();
+        if (!trimmed || SKIP_PREFIXES.some((p) => trimmed.startsWith(p)))
+          continue;
+        if (digest.userMessages.length >= MAX_MSGS_PER_SESSION) {
+          digest.droppedUserMessages++;
+          continue;
+        }
+        digest.userMessages.push(trimmed.length > MAX_MSG_CHARS ? trimmed.slice(0, MAX_MSG_CHARS) + " [...]" : trimmed);
+      }
+    }
+    if (!digest.start) {
+      const ms = composerCreatedAt.get(cid);
+      if (ms) {
+        const iso = new Date(ms).toISOString();
+        digest.start = iso;
+        digest.end = iso;
+      }
+    }
+    if (digest.userMessages.length === 0)
+      continue;
+    if (sinceISO && digest.end && digest.end < sinceISO)
+      continue;
+    digests.push(digest);
+  }
+  return digests;
+}
 function formatCombinedDigest(sessions, opts = { days: 7 }) {
   const sorted = [...sessions].sort((a, b) => (a.start ?? "").localeCompare(b.start ?? ""));
   const lines = [];
@@ -11032,6 +11118,33 @@ function formatCombinedDigest(sessions, opts = { days: 7 }) {
 // src/agents/utils/json-config.ts
 import { readFileSync as readFileSync22, writeFileSync as writeFileSync14, mkdirSync as mkdirSync13, existsSync as existsSync25 } from "fs";
 import { dirname as dirname5 } from "path";
+
+// src/sync/hash.ts
+import { createHash as createHash2 } from "crypto";
+function contentHash(content) {
+  return "sha256:" + createHash2("sha256").update(content).digest("hex");
+}
+function stableStringify(value) {
+  return JSON.stringify(sortValue(value));
+}
+function sortValue(value) {
+  if (Array.isArray(value))
+    return value.map(sortValue);
+  if (value !== null && typeof value === "object") {
+    const obj = value;
+    const sorted = {};
+    for (const key of Object.keys(obj).sort()) {
+      sorted[key] = sortValue(obj[key]);
+    }
+    return sorted;
+  }
+  return value;
+}
+function configHash(value) {
+  return contentHash(stableStringify(value));
+}
+
+// src/agents/utils/json-config.ts
 function isRunworkManagedKey(key) {
   return key === RUNWORK_WORKSPACE_MCP_NAME || key.startsWith(RUNWORK_MCP_PREFIX) || key.startsWith(RUNWORK_MCP_PREFIX_LEGACY);
 }
@@ -11070,6 +11183,14 @@ function removeRunworkMcpServers(filePath, topKey) {
 function mergeJsonMcpServers(filePath, servers, topKey) {
   const config = readJsonConfig(filePath);
   const existing = config[topKey] || {};
+  const managedBefore = {};
+  for (const key of Object.keys(existing)) {
+    if (isRunworkManagedKey(key))
+      managedBefore[key] = existing[key];
+  }
+  const changed = configHash(managedBefore) !== configHash(servers);
+  if (!changed)
+    return false;
   for (const key of Object.keys(existing)) {
     if (isRunworkManagedKey(key)) {
       delete existing[key];
@@ -11078,6 +11199,7 @@ function mergeJsonMcpServers(filePath, servers, topKey) {
   Object.assign(existing, servers);
   config[topKey] = existing;
   writeJsonConfig(filePath, config);
+  return true;
 }
 
 // src/agents/utils/instruction-hint.ts
@@ -11401,6 +11523,19 @@ function resolveAgentDefaults(input) {
   };
 }
 
+// src/ui/verbosity.ts
+var verbose = false;
+function setVerbose(value) {
+  verbose = value;
+}
+function isVerbose() {
+  return verbose;
+}
+function vlog(...args) {
+  if (verbose)
+    console.log(...args);
+}
+
 // src/agents/claude-code.ts
 var PLUGIN_NAME = "runwork";
 var PLUGIN_VERSION = "1.0.0";
@@ -11503,7 +11638,7 @@ class ClaudeCodeAdapter {
       ]
     };
     writeFileSync16(join21(hooksDir, "hooks.json"), JSON.stringify(hooksManifest, null, 2));
-    console.log(`  [Claude Code] Installed SessionStart hook (${label}) -> ${scriptPath}`);
+    vlog(`  [Claude Code] Installed SessionStart hook (${label}) -> ${scriptPath}`);
   }
   async writeSkills(skills, scope) {
     const baseDir = scope === "project" ? join21(process.cwd(), ".claude", "skills") : join21(homedir5(), ".claude", "skills");
@@ -11536,6 +11671,7 @@ class ClaudeCodeAdapter {
       }
       this.registerPlugin(pluginDir);
     }
+    return skills.length;
   }
   async writeBuiltInHooks(scope) {
     if (scope !== "user")
@@ -12030,7 +12166,7 @@ ${instructions}`;
       lastUpdated: new Date().toISOString()
     };
     writeJsonConfig(marketplacesPath, marketplaces);
-    console.log(`  [Claude Code] ${wasRegistered ? "Refreshed" : "Registered"} plugin ` + `${pluginKey} v${PLUGIN_VERSION} -> ${installedPath}`);
+    vlog(`  [Claude Code] ${wasRegistered ? "Refreshed" : "Registered"} plugin ` + `${pluginKey} v${PLUGIN_VERSION} -> ${installedPath}`);
     const settingsPath = join21(homedir5(), ".claude", "settings.json");
     const settings = readJsonConfig(settingsPath);
     if (!settings["enabledPlugins"]) {
@@ -12330,12 +12466,12 @@ class ClaudeDesktopAdapter {
     if (rpm) {
       writePluginMetadata(rpm.pluginPath, getPluginMetadata());
       writePluginSkills(rpm.pluginPath, skills);
-      return;
+      return skills.length;
     }
     const pluginsDir = findCoworkPluginsDir();
     if (!pluginsDir) {
       console.warn("  [Claude Desktop] Cowork plugins directory not found. Open Claude Desktop at least once first.");
-      return;
+      return 0;
     }
     const cacheDir = join23(pluginsDir, "cache", "runwork", PLUGIN_NAME2, PLUGIN_VERSION2);
     const marketRoot = join23(pluginsDir, "marketplaces", "runwork");
@@ -12370,6 +12506,7 @@ class ClaudeDesktopAdapter {
     };
     writeJsonConfig(marketplacesPath, marketplaces);
     setCoworkPluginEnabled(pluginsDir, true);
+    return skills.length;
   }
   async writeInstructionHint(hint, _scope) {
     for (const path2 of getCoworkMemoryClaudeMdPaths()) {
@@ -12780,6 +12917,9 @@ async function loadAdapter() {
   return null;
 }
 adapter = await loadAdapter();
+function sqliteAvailable() {
+  return adapter !== null;
+}
 var BUSY_TIMEOUT_MS = 5000;
 function setBusyTimeout(db) {
   try {
@@ -12857,7 +12997,7 @@ class CursorAdapter {
   }
   async writeSkills(skills, scope) {
     if (scope === "user")
-      return;
+      return 0;
     const rulesDir = join24(process.cwd(), ".cursor", "rules");
     mkdirSync18(rulesDir, { recursive: true });
     for (const skill of skills) {
@@ -12869,6 +13009,7 @@ alwaysApply: false
 ${skill.content}`;
       writeFileSync19(join24(rulesDir, `${skill.filename}.mdc`), mdcContent);
     }
+    return skills.length;
   }
   async writeInstructionHint(hint, scope) {
     const filePath = scope === "project" ? join24(process.cwd(), ".cursor", "rules", "runwork.mdc") : join24(homedir7(), ".cursor", "rules", "runwork.mdc");
@@ -12898,15 +13039,7 @@ ${instructions}`;
     if (config.networkAllowlist?.length) {
       this.mergeSandboxAllowlist(config.networkAllowlist);
     }
-    const os2 = platform4();
-    let globalDbPath;
-    if (os2 === "darwin") {
-      globalDbPath = join24(homedir7(), "Library", "Application Support", "Cursor", "User", "globalStorage", "state.vscdb");
-    } else if (os2 === "win32") {
-      globalDbPath = join24(process.env.APPDATA || join24(homedir7(), "AppData", "Roaming"), "Cursor", "User", "globalStorage", "state.vscdb");
-    } else {
-      globalDbPath = join24(homedir7(), ".config", "Cursor", "User", "globalStorage", "state.vscdb");
-    }
+    const globalDbPath = this.globalStorageDbPath();
     if (!existsSync30(globalDbPath))
       return;
     const db = openWritableSqlite(globalDbPath);
@@ -12986,15 +13119,7 @@ ${instructions}`;
   async readUsageStats(lastSyncAt) {
     try {
       const sinceMs = lastSyncAt ? new Date(lastSyncAt).getTime() : 0;
-      const os2 = platform4();
-      let globalDbPath;
-      if (os2 === "darwin") {
-        globalDbPath = join24(homedir7(), "Library", "Application Support", "Cursor", "User", "globalStorage", "state.vscdb");
-      } else if (os2 === "win32") {
-        globalDbPath = join24(process.env.APPDATA || join24(homedir7(), "AppData", "Roaming"), "Cursor", "User", "globalStorage", "state.vscdb");
-      } else {
-        globalDbPath = join24(homedir7(), ".config", "Cursor", "User", "globalStorage", "state.vscdb");
-      }
+      const globalDbPath = this.globalStorageDbPath();
       let sessionCount = 0;
       let totalLinesAdded = 0;
       let totalLinesRemoved = 0;
@@ -13069,6 +13194,30 @@ ${instructions}`;
       return null;
     }
   }
+  globalStorageDbPath() {
+    const os2 = platform4();
+    if (os2 === "darwin") {
+      return join24(homedir7(), "Library", "Application Support", "Cursor", "User", "globalStorage", "state.vscdb");
+    }
+    if (os2 === "win32") {
+      return join24(process.env.APPDATA || join24(homedir7(), "AppData", "Roaming"), "Cursor", "User", "globalStorage", "state.vscdb");
+    }
+    return join24(homedir7(), ".config", "Cursor", "User", "globalStorage", "state.vscdb");
+  }
+  async readSessionDigests(sinceISO) {
+    try {
+      const dbPath = this.globalStorageDbPath();
+      if (!existsSync30(dbPath) || !sqliteAvailable())
+        return null;
+      const composerRows = queryReadonlySqlite(dbPath, `SELECT json_object('id', json_extract(value,'$.composerId'), 'createdAt', json_extract(value,'$.createdAt')) FROM cursorDiskKV WHERE key LIKE 'composerData:%'`);
+      const bubbleRows = queryReadonlySqlite(dbPath, `SELECT json_object('k', key, 'type', json_extract(value,'$.type'), 'text', substr(json_extract(value,'$.text'),1,2000), 'ts', json_extract(value,'$.createdAt'), 'tool', json_extract(value,'$.toolFormerData.name'), 'status', json_extract(value,'$.toolFormerData.status')) FROM cursorDiskKV WHERE key LIKE 'bubbleId:%'`);
+      if (!bubbleRows.trim())
+        return [];
+      return extractCursorSessions(composerRows, bubbleRows, sinceISO);
+    } catch {
+      return null;
+    }
+  }
 }
 
 // src/agents/windsurf.ts
@@ -13113,7 +13262,7 @@ class WindsurfAdapter {
   }
   async writeSkills(skills, scope) {
     if (scope === "user")
-      return;
+      return 0;
     const rulesDir = join25(process.cwd(), ".windsurf", "rules");
     mkdirSync19(rulesDir, { recursive: true });
     for (const skill of skills) {
@@ -13124,6 +13273,7 @@ trigger: manual
 ${skill.content}`;
       writeFileSync20(join25(rulesDir, `${skill.filename}.md`), content);
     }
+    return skills.length;
   }
   async writeTeamInstructions(instructions, scope) {
     const filePath = scope === "project" ? join25(process.cwd(), ".windsurf", "rules", "runwork-team.md") : join25(getWindsurfDataDir(), "rules", "runwork-team.md");
@@ -13371,7 +13521,7 @@ var AGENT_REGISTRY = [
       ]
     },
     launch: { app: { macos: "Codex", windows: "Codex" } },
-    logo: "openai",
+    logo: "codex",
     downloadUrl: "https://openai.com/codex/",
     skillsPaths: { global: ".codex/skills", project: ".agents/skills" },
     instructionFile: { global: ".codex/instructions.md", project: "AGENTS.md" },
@@ -13396,7 +13546,7 @@ var AGENT_REGISTRY = [
     category: "cli",
     detection: { method: "binary", target: "codex" },
     launch: { cli: "codex", cliAcceptsPrompt: true },
-    logo: "openai",
+    logo: "codex",
     downloadUrl: "https://github.com/openai/codex",
     skillsPaths: { global: ".codex/skills", project: ".agents/skills" },
     instructionFile: { global: ".codex/instructions.md", project: "AGENTS.md" },
@@ -13919,6 +14069,7 @@ class CodexAdapter {
       mkdirSync20(skillDir, { recursive: true });
       writeFileSync21(join28(skillDir, "SKILL.md"), buildSkillMd2(skill));
     }
+    return skills.length;
   }
   async writeInstructionHint(hint, scope) {
     const filePath = scope === "project" ? join28(process.cwd(), "AGENTS.md") : join28(homedir11(), ".codex", "AGENTS.md");
@@ -14280,12 +14431,13 @@ class ClineAdapter {
   }
   async writeSkills(skills, scope) {
     if (scope === "user")
-      return;
+      return 0;
     const rulesDir = join29(process.cwd(), ".clinerules");
     mkdirSync21(rulesDir, { recursive: true });
     for (const skill of skills) {
       writeFileSync22(join29(rulesDir, `${skill.filename}.md`), buildSkillMd2(skill));
     }
+    return skills.length;
   }
   async writeInstructionHint(hint, scope) {
     if (scope === "user")
@@ -14410,6 +14562,7 @@ class GeminiAdapter {
       mkdirSync22(skillDir, { recursive: true });
       writeFileSync23(join30(skillDir, "SKILL.md"), buildSkillMd2(skill));
     }
+    return skills.length;
   }
   async writeInstructionHint(hint, scope) {
     const filePath = scope === "project" ? join30(process.cwd(), "GEMINI.md") : join30(homedir13(), ".gemini", "GEMINI.md");
@@ -14509,13 +14662,13 @@ class GenericAgentAdapter {
   }
   async writeSkills(skills, scope) {
     if (!this.def.skillsPaths)
-      return;
+      return 0;
     const pathTemplate = scope === "project" ? this.def.skillsPaths.project : this.def.skillsPaths.global;
     if (!pathTemplate)
-      return;
+      return 0;
     const baseDir = resolveToAbsolute(pathTemplate, scope === "project" ? "project" : "global");
     if (!baseDir)
-      return;
+      return 0;
     for (const skill of skills) {
       if (skill.name !== skill.filename) {
         const oldDir = join31(baseDir, skill.name);
@@ -14529,6 +14682,7 @@ class GenericAgentAdapter {
       mkdirSync23(skillDir, { recursive: true });
       writeFileSync24(join31(skillDir, "SKILL.md"), buildSkillMd2(skill));
     }
+    return skills.length;
   }
   async writeInstructionHint(hint, scope) {
     if (!this.def.instructionFile)
@@ -14643,9 +14797,9 @@ function printNoAgentsMessage() {
 }
 
 // src/utils/insight-id.ts
-import { createHash as createHash2 } from "node:crypto";
+import { createHash as createHash3 } from "node:crypto";
 function computeInsightId(userSeed, localKey) {
-  return createHash2("sha256").update(`${userSeed}:${localKey}`).digest("hex").slice(0, 22);
+  return createHash3("sha256").update(`${userSeed}:${localKey}`).digest("hex").slice(0, 22);
 }
 function insightLocalKey(teaches, slug) {
   return `${teaches}:${slug}`.toLowerCase().replace(/[^a-z0-9:_-]+/g, "-").replace(/-+/g, "-");
@@ -16567,19 +16721,6 @@ async function collectTelemetryEvents(params) {
   const now = params.now ?? new Date().toISOString();
   const events = [];
   const adapterResults = [];
-  const previouslyReported = new Set(params.state.reportedAgentSlugs ?? []);
-  const newlyReportedAgents = [];
-  for (const slug of params.state.configuredAgents) {
-    if (!previouslyReported.has(slug)) {
-      events.push({
-        eventType: "local_agent.detected",
-        agentSlug: slug,
-        metadata: { installed: true },
-        timestamp: now
-      });
-      newlyReportedAgents.push(slug);
-    }
-  }
   for (const adapter2 of params.adapters) {
     let stats = "unsupported";
     let skills = "unsupported";
@@ -16671,11 +16812,12 @@ async function collectTelemetryEvents(params) {
       syncedMcpServers: params.syncedMcpServersCount,
       teamInstructionsApplied: params.teamInstructionsApplied,
       agentConfigsApplied: params.agentConfigsApplied,
+      agents: [...params.state.configuredAgents],
       ...params.state.persona?.label ? { persona: params.state.persona.label } : {}
     },
     timestamp: now
   });
-  return { events, adapterResults, newlyReportedAgents, healthReported };
+  return { events, adapterResults, healthReported };
 }
 function formatStatsLine(stats) {
   const parts = [];
@@ -16721,10 +16863,6 @@ function printTelemetryVerbose(result) {
     const errSuffix = r.error ? ` (error: ${r.error})` : "";
     console.log(`    [${r.name}] stats: ${statsLabel}; skills: ${skillsLabel}${errSuffix}`);
   }
-  if (result.newlyReportedAgents.length > 0) {
-    console.log(`
-  First-time detections: ${result.newlyReportedAgents.join(", ")}`);
-  }
   if (result.healthReported) {
     console.log("  Health report: due (daily)");
   }
@@ -17354,12 +17492,6 @@ function buildSaveConversationSkill() {
   };
 }
 
-// src/sync/hash.ts
-import { createHash as createHash3 } from "crypto";
-function contentHash(content) {
-  return "sha256:" + createHash3("sha256").update(content).digest("hex");
-}
-
 // src/sync/change-detect.ts
 function computeSyncPlan(input) {
   const { storedHashes, localSkills, remoteSkills } = input;
@@ -17391,6 +17523,16 @@ function computeSyncPlan(input) {
     const localChanged = localHash !== null && localHash !== stored.localHash;
     const remoteChanged = remoteHash !== stored.remoteHash;
     if (!local) {
+      if (remote.source === "app" && !remoteChanged) {
+        plan.skips.push({
+          name: remote.name,
+          action: "skip",
+          source: remote.source,
+          remoteId: remote.remoteId,
+          appId: remote.appId
+        });
+        continue;
+      }
       plan.pulls.push({
         name: remote.name,
         action: "pull",
@@ -17570,6 +17712,47 @@ function resolveConflictNonInteractive(prefer) {
   return prefer;
 }
 
+// src/sync/summary-format.ts
+function summarizeSkillPlan(plan) {
+  return {
+    added: plan.pulls.filter((p) => p.action === "new-remote").map((p) => p.name),
+    updated: plan.pulls.filter((p) => p.action === "pull").map((p) => p.name),
+    removed: plan.deletions.map((p) => p.name),
+    pushed: plan.pushes.map((p) => p.name),
+    unchanged: plan.skips.length,
+    conflicts: plan.conflicts.length
+  };
+}
+function formatNameList(names, cap2 = 6) {
+  if (names.length <= cap2)
+    return names.join(", ");
+  return `${names.slice(0, cap2).join(", ")}, +${names.length - cap2} more`;
+}
+function formatSkillSummaryLine(c) {
+  const parts = [];
+  if (c.added.length)
+    parts.push(`${c.added.length} added (${formatNameList(c.added)})`);
+  if (c.updated.length)
+    parts.push(`${c.updated.length} updated (${formatNameList(c.updated)})`);
+  if (c.removed.length)
+    parts.push(`${c.removed.length} removed (${formatNameList(c.removed)})`);
+  if (c.pushed.length)
+    parts.push(`${c.pushed.length} pushed (${formatNameList(c.pushed)})`);
+  if (c.conflicts)
+    parts.push(`${c.conflicts} conflict${c.conflicts === 1 ? "" : "s"}`);
+  parts.push(`${c.unchanged} up to date`);
+  return parts.join(", ");
+}
+var REASON_LABEL = {
+  mcp: "MCP",
+  settings: "settings"
+};
+function formatRestartChanges(changes) {
+  if (changes.length === 0)
+    return "none";
+  return changes.map((c) => `${c.name} (${c.reasons.map((r) => REASON_LABEL[r]).join(", ")})`).join("; ");
+}
+
 // src/sync/executor.ts
 async function executeSyncPlan(plan, resolvedConflicts, ctx) {
   const newHashes = {};
@@ -17585,7 +17768,7 @@ async function executeSyncPlan(plan, resolvedConflicts, ctx) {
       remoteId: action.remoteId,
       appId: action.appId
     };
-    console.log(`  Pulled: ${action.name}`);
+    vlog(`  Pulled: ${action.name}`);
   }
   for (const action of plan.pushes) {
     if (!action.localContent || !action.remoteId)
@@ -17602,7 +17785,7 @@ async function executeSyncPlan(plan, resolvedConflicts, ctx) {
       source: "external",
       remoteId: action.remoteId
     };
-    console.log(`  Pushed: ${action.name}`);
+    vlog(`  Pushed: ${action.name}`);
   }
   for (const action of plan.conflicts) {
     const resolution = resolvedConflicts.get(action.name);
@@ -17616,7 +17799,7 @@ async function executeSyncPlan(plan, resolvedConflicts, ctx) {
       });
       const hash = contentHash(action.localContent);
       newHashes[action.name] = { localHash: hash, remoteHash: hash, source: "external", remoteId: action.remoteId };
-      console.log(`  Pushed (conflict resolved): ${action.name}`);
+      vlog(`  Pushed (conflict resolved): ${action.name}`);
     } else if (resolution === "remote" && action.remoteContent) {
       const skillFile = makeSkillFile(action.name, action.remoteContent);
       await writeSkillToAgents(skillFile, action.source, ctx);
@@ -17626,12 +17809,12 @@ async function executeSyncPlan(plan, resolvedConflicts, ctx) {
         source: "external",
         remoteId: action.remoteId
       };
-      console.log(`  Pulled (conflict resolved): ${action.name}`);
+      vlog(`  Pulled (conflict resolved): ${action.name}`);
     }
   }
   for (const _action of plan.skips) {}
   for (const action of plan.deletions) {
-    console.log(`  Deleted locally: ${action.name}`);
+    vlog(`  Deleted locally: ${action.name}`);
   }
   return newHashes;
 }
@@ -17661,6 +17844,53 @@ function extractDescription(content) {
   return match ? match[1].trim() : "";
 }
 
+// src/sync/restart-stamp.ts
+function computeRestartReasons(input) {
+  const settingsSet = new Set(input.settingsChangedSlugs);
+  const out = {};
+  for (const agent of input.agents) {
+    if (agent.connectOnly)
+      continue;
+    const reasons = [];
+    if ((input.mcpChanged || agent.isNew) && agent.receivesMcp)
+      reasons.push("mcp");
+    if (settingsSet.has(agent.slug))
+      reasons.push("settings");
+    if (reasons.length > 0)
+      out[agent.slug] = reasons;
+  }
+  return out;
+}
+function summarizeRealSkillChanges(newLocalHashes, priorLocalHashes, materializedDeletions) {
+  const added = [];
+  const updated = [];
+  for (const [name, hash] of Object.entries(newLocalHashes)) {
+    if (!(name in priorLocalHashes))
+      added.push(name);
+    else if (priorLocalHashes[name] !== hash)
+      updated.push(name);
+  }
+  return {
+    added: added.sort(),
+    updated: updated.sort(),
+    removed: [...materializedDeletions].sort()
+  };
+}
+function hasRealSkillChange(c) {
+  return c.added.length > 0 || c.updated.length > 0 || c.removed.length > 0;
+}
+function sameStringSet(a, b) {
+  const setA = new Set(a ?? []);
+  const setB = new Set(b ?? []);
+  if (setA.size !== setB.size)
+    return false;
+  for (const item of setA) {
+    if (!setB.has(item))
+      return false;
+  }
+  return true;
+}
+
 // src/commands/sync.ts
 async function printAdoptionHint(credentials, workspaceId) {
   if (!workspaceId)
@@ -17745,6 +17975,7 @@ async function refreshConfiguredAgents(state) {
 }
 async function syncFromState(state, statePath2, credentials, opts) {
   const client = new ApiClient(credentials);
+  setVerbose(!!opts.verbose);
   if (!state.workspaceName || state.workspaceName === state.workspaceId || !state.workspaceSlug) {
     try {
       const workspaces = await client.listWorkspaces();
@@ -17756,11 +17987,12 @@ async function syncFromState(state, statePath2, credentials, opts) {
     } catch {}
   }
   console.log(`Syncing workspace: ${state.workspaceName || state.workspaceId}`);
+  let addedThisSync = [];
   if (shouldRedetect(state, opts)) {
     console.log("  Detecting installed agents...");
-    const added = await refreshConfiguredAgents(state);
-    if (added.length > 0) {
-      console.log(`  Detected new agent${added.length > 1 ? "s" : ""}: ${added.join(", ")}`);
+    addedThisSync = await refreshConfiguredAgents(state);
+    if (addedThisSync.length > 0) {
+      console.log(`  Detected new agent${addedThisSync.length > 1 ? "s" : ""}: ${addedThisSync.join(", ")}`);
     }
   }
   console.log("  Fetching workspace data...");
@@ -17802,6 +18034,8 @@ async function syncFromState(state, statePath2, credentials, opts) {
     headers: { Authorization: `Bearer ${credentials.apiKey}` },
     description: "Runwork workspace tools: query entities, trigger workflows, manage integrations, run agents, and access shared data across your team's apps."
   });
+  const mcpEntriesHash = configHash([...mcpEntries].sort((a, b) => a.name.localeCompare(b.name)));
+  const mcpChanged = state.lastMcpEntriesHash !== undefined && state.lastMcpEntriesHash !== mcpEntriesHash;
   const remoteSkills = [];
   for (const s of externalSkills) {
     remoteSkills.push({ name: s.name, content: s.content, source: "external", remoteId: s.id });
@@ -17831,12 +18065,9 @@ async function syncFromState(state, statePath2, credentials, opts) {
     plan.skips.push(...plan.conflicts.map((c) => ({ ...c, action: "skip" })));
     plan.conflicts = [];
   }
-  const hasChanges = plan.pulls.length > 0 || plan.pushes.length > 0 || plan.conflicts.length > 0 || plan.deletions.length > 0;
-  if (hasChanges) {
+  console.log(`  Skills: ${formatSkillSummaryLine(summarizeSkillPlan(plan))}`);
+  if (isVerbose())
     printSyncSummary(plan);
-  } else {
-    console.log("  All skills up to date.");
-  }
   const adapters = [];
   for (const slug of state.configuredAgents) {
     const adapter2 = getAdapterBySlug(slug);
@@ -17876,6 +18107,7 @@ async function syncFromState(state, statePath2, credentials, opts) {
       }
     }
   }
+  const settingsChangedSlugs = [];
   const scopes = state.scope === "both" ? ["project", "user"] : [state.scope];
   if (adapters.length > 0) {
     console.log(`  Syncing to: ${adapters.map((a) => a.name).join(", ")}`);
@@ -17924,6 +18156,8 @@ async function syncFromState(state, statePath2, credentials, opts) {
     buildSaveConversationSkill()
   ];
   const builtInNames = builtInSkills.map((s) => s.name);
+  const builtInSkillsHash = configHash(builtInSkills.map((s) => s.content));
+  const builtInSkillsChanged = state.builtInSkillsHash !== undefined && state.builtInSkillsHash !== builtInSkillsHash;
   const summary = {
     adaptersProcessed: 0,
     adaptersFailed: 0,
@@ -17933,16 +18167,18 @@ async function syncFromState(state, statePath2, credentials, opts) {
     instructionHintWrites: 0,
     hookInstallCalls: 0
   };
+  const mcpFailedAdapters = new Set;
+  const skillFailedAdapters = new Set;
   for (const adapter2 of adapters) {
     if (isConnectOnlyAgent(getRegistryAgent(adapter2.slug))) {
-      console.log(`  [${adapter2.name}] Connect-only agent: no local files to sync`);
+      vlog(`  [${adapter2.name}] Connect-only agent: no local files to sync`);
       summary.adaptersProcessed++;
       continue;
     }
     let adapterFailedAnyScope = false;
     for (const scope of scopes) {
-      try {
-        if (adapter2.supportsSkills()) {
+      if (adapter2.supportsSkills()) {
+        try {
           const skipAppSkills = adapter2.mcpProvidesSkills && mcpEntries.length > 0;
           const scopeSkills = remoteSkills.filter((s) => {
             if (builtInNameSet.has(s.name))
@@ -17962,25 +18198,41 @@ async function syncFromState(state, statePath2, credentials, opts) {
             description: s.source === "app" ? buildAppSkillDescription(s.name, registries) || `${s.name} - Runwork workspace application` : `${s.name} - Runwork workspace skill`
           }));
           const allSkillFiles = [...builtInSkills, ...workspaceSkillFiles];
-          await adapter2.writeSkills(allSkillFiles, scope);
-          summary.skillWrites++;
-          summary.skillFilesWritten += allSkillFiles.length;
-          console.log(`  [${adapter2.name}] Wrote ${allSkillFiles.length} skills (${scope}): ` + `${builtInSkills.length} built-in [${builtInNames.join(", ")}], ` + `${workspaceSkillFiles.length} workspace`);
-        } else {
-          console.log(`  [${adapter2.name}] Skipped skills (${scope}): adapter does not support skills`);
+          const written = await adapter2.writeSkills(allSkillFiles, scope);
+          if (written > 0) {
+            summary.skillWrites++;
+            summary.skillFilesWritten += written;
+            vlog(`  [${adapter2.name}] Wrote ${written} skills (${scope}): ` + `${builtInSkills.length} built-in [${builtInNames.join(", ")}], ` + `${workspaceSkillFiles.length} workspace`);
+          } else {
+            vlog(`  [${adapter2.name}] Skipped skills (${scope}): adapter writes none at this scope`);
+          }
+        } catch (err) {
+          adapterFailedAnyScope = true;
+          skillFailedAdapters.add(adapter2.slug);
+          console.warn(`  [${adapter2.name}] Failed skills (${scope}): ${err instanceof Error ? err.message : err}`);
         }
-        if (adapter2.supportsMcpScope(scope) && mcpEntries.length > 0) {
+      } else {
+        vlog(`  [${adapter2.name}] Skipped skills (${scope}): adapter does not support skills`);
+      }
+      if (adapter2.supportsMcpScope(scope) && mcpEntries.length > 0) {
+        try {
           await adapter2.writeMcpServers(mcpEntries, scope);
           summary.mcpServerWrites++;
-          console.log(`  [${adapter2.name}] Updated ${mcpEntries.length} MCP server${mcpEntries.length > 1 ? "s" : ""} (${scope})`);
-        } else if (mcpEntries.length === 0) {
-          console.log(`  [${adapter2.name}] Skipped MCP servers (${scope}): no workspace MCP servers configured`);
-        } else if (!adapter2.supportsMcpScope(scope)) {
-          console.log(`  [${adapter2.name}] Skipped MCP servers (${scope}): adapter does not support MCP at this scope`);
+          vlog(`  [${adapter2.name}] Updated ${mcpEntries.length} MCP server${mcpEntries.length > 1 ? "s" : ""} (${scope})`);
+        } catch (err) {
+          adapterFailedAnyScope = true;
+          mcpFailedAdapters.add(adapter2.slug);
+          console.warn(`  [${adapter2.name}] Failed MCP servers (${scope}): ${err instanceof Error ? err.message : err}`);
         }
+      } else if (mcpEntries.length === 0) {
+        vlog(`  [${adapter2.name}] Skipped MCP servers (${scope}): no workspace MCP servers configured`);
+      } else if (!adapter2.supportsMcpScope(scope)) {
+        vlog(`  [${adapter2.name}] Skipped MCP servers (${scope}): adapter does not support MCP at this scope`);
+      }
+      try {
         await adapter2.writeInstructionHint(instructionHint, scope);
         summary.instructionHintWrites++;
-        console.log(`  [${adapter2.name}] Updated instruction hints (${scope})`);
+        vlog(`  [${adapter2.name}] Updated instruction hints (${scope})`);
         if (adapter2.writeBuiltInHooks) {
           await adapter2.writeBuiltInHooks(scope);
           summary.hookInstallCalls++;
@@ -18019,7 +18271,7 @@ async function syncFromState(state, statePath2, credentials, opts) {
       try {
         await adapter2.writeTeamInstructions(fullInstructions, scope);
         teamInstructionsApplied = true;
-        console.log(`  [${adapter2.name}] Updated team instructions (${scope})`);
+        vlog(`  [${adapter2.name}] Updated team instructions (${scope})`);
       } catch {}
     }
   }
@@ -18040,7 +18292,7 @@ async function syncFromState(state, statePath2, credentials, opts) {
           await adapter2.writeAgentConfig(configWithoutInstructions, scope);
           agentConfigsApplied++;
           const configKeys = Object.keys(configWithoutInstructions).join(", ");
-          console.log(`  [${adapter2.name}] Updated agent config: ${configKeys} (${scope})`);
+          vlog(`  [${adapter2.name}] Updated agent config: ${configKeys} (${scope})`);
         } catch {}
       }
     }
@@ -18095,6 +18347,12 @@ async function syncFromState(state, statePath2, credentials, opts) {
       try {
         const baseline = agentState?.lastInjected;
         await adapter2.writeAgentConfig(mergedConfig, "user", baseline);
+        if (baked && !resolved.bootstrapped) {
+          const prev = agentState?.lastInjected;
+          if (!sameStringSet(prev?.allow, resolved.applicableAllow) || !sameStringSet(prev?.deny, resolved.applicableDeny)) {
+            settingsChangedSlugs.push(slug);
+          }
+        }
         if (baked) {
           const nextState = {
             lastInjected: {
@@ -18108,11 +18366,11 @@ async function syncFromState(state, statePath2, credentials, opts) {
           };
           state.agentDefaults[slug] = nextState;
           if (resolved.bootstrapped) {
-            console.log(`  [${adapter2.name}] Bootstrapped default-rule tracking (defaults apply on next sync)`);
+            vlog(`  [${adapter2.name}] Bootstrapped default-rule tracking (defaults apply on next sync)`);
           } else if (resolved.applicableAllow.length || resolved.applicableDeny.length || resolved.removalsThisSync.allow || resolved.removalsThisSync.deny) {
             const totalRemovals = resolved.removalsThisSync.allow + resolved.removalsThisSync.deny;
             const removalNote = totalRemovals > 0 ? ` (${totalRemovals} new opt-out${totalRemovals > 1 ? "s" : ""} honored)` : "";
-            console.log(`  [${adapter2.name}] Applied defaults: ${resolved.applicableAllow.length} allow, ${resolved.applicableDeny.length} deny${removalNote}`);
+            vlog(`  [${adapter2.name}] Applied defaults: ${resolved.applicableAllow.length} allow, ${resolved.applicableDeny.length} deny${removalNote}`);
           }
         }
         if (team)
@@ -18126,11 +18384,12 @@ async function syncFromState(state, statePath2, credentials, opts) {
       const runworkDir = join35(homedir17(), ".runwork");
       const result = adapter2.registerDesktopWorkspace(runworkDir, "Runwork");
       if (result === "written") {
-        console.log(`  [${adapter2.name}] Registered workspace in Codex desktop app`);
+        vlog(`  [${adapter2.name}] Registered workspace in Codex desktop app`);
       }
       break;
     }
   }
+  const prevMcpNames = state.mcpServers ?? [];
   state.lastSyncAt = new Date().toISOString();
   state.mcpServers = mcpEntries.map((e) => e.name);
   state.skills = remoteSkills.map((s) => s.name);
@@ -18138,6 +18397,57 @@ async function syncFromState(state, statePath2, credentials, opts) {
     "runwork",
     ...remoteSkills.map((s) => s.name.toLowerCase().replace(/[^a-z0-9]+/g, "-"))
   ];
+  const priorSkillHashes = state.skillHashes || {};
+  const newLocalHashes = {};
+  for (const [name, h] of Object.entries(newHashes))
+    newLocalHashes[name] = h.localHash;
+  const priorLocalHashes = {};
+  for (const [name, h] of Object.entries(priorSkillHashes))
+    priorLocalHashes[name] = h.localHash;
+  const materializedDeletions = plan.deletions.filter((d) => d.localContent !== undefined).map((d) => d.name);
+  const skillChanges = summarizeRealSkillChanges(newLocalHashes, priorLocalHashes, materializedDeletions);
+  const newMcpNames = mcpEntries.map((e) => e.name);
+  const prevMcpSet = new Set(prevMcpNames);
+  const newMcpSet = new Set(newMcpNames);
+  const mcpAdded = mcpChanged ? newMcpNames.filter((n) => !prevMcpSet.has(n)) : [];
+  const mcpRemoved = mcpChanged ? prevMcpNames.filter((n) => !newMcpSet.has(n)) : [];
+  const addedSet = new Set(addedThisSync);
+  const restartReasons = computeRestartReasons({
+    agents: adapters.map((a) => ({
+      slug: a.slug,
+      receivesMcp: mcpEntries.length > 0 && scopes.some((sc) => a.supportsMcpScope(sc)) && !mcpFailedAdapters.has(a.slug),
+      connectOnly: isConnectOnlyAgent(getRegistryAgent(a.slug)),
+      isNew: !!opts.initialSetup || addedSet.has(a.slug)
+    })),
+    mcpChanged,
+    settingsChangedSlugs
+  });
+  if (Object.keys(restartReasons).length > 0) {
+    if (!state.agentConfigChangedAt)
+      state.agentConfigChangedAt = {};
+    for (const [slug, reasons] of Object.entries(restartReasons)) {
+      state.agentConfigChangedAt[slug] = { changedAt: state.lastSyncAt, reasons };
+    }
+  }
+  if (hasRealSkillChange(skillChanges) || builtInSkillsChanged || mcpChanged || settingsChangedSlugs.length > 0) {
+    state.lastSyncChange = {
+      at: state.lastSyncAt,
+      skills: skillChanges,
+      builtInSkillsChanged,
+      mcp: { changed: mcpChanged, added: mcpAdded, removed: mcpRemoved },
+      settingsSlugs: settingsChangedSlugs
+    };
+  }
+  if (mcpFailedAdapters.size === 0)
+    state.lastMcpEntriesHash = mcpEntriesHash;
+  if (skillFailedAdapters.size === 0)
+    state.builtInSkillsHash = builtInSkillsHash;
+  const nameBySlug = new Map(adapters.map((a) => [a.slug, a.name]));
+  const restartChanges = Object.entries(restartReasons).map(([slug, reasons]) => ({
+    name: nameBySlug.get(slug) ?? slug,
+    reasons
+  }));
+  console.log(`  Restart-worthy changes: ${formatRestartChanges(restartChanges)}`);
   const mergedHashes = { ...state.skillHashes || {} };
   for (const [name, hash] of Object.entries(newHashes)) {
     mergedHashes[name] = hash;
@@ -18159,25 +18469,29 @@ async function syncFromState(state, statePath2, credentials, opts) {
     if (opts.verbose)
       printTelemetryVerbose(telemetry);
     await client.reportTelemetry(state.workspaceId, telemetry.events);
-    if (telemetry.healthReported)
+    if (telemetry.healthReported) {
       state.lastHealthReportAt = new Date().toISOString();
-    state.reportedAgentSlugs = [
-      ...new Set([...state.reportedAgentSlugs ?? [], ...telemetry.newlyReportedAgents])
-    ];
-    writeFileSync29(statePath2, JSON.stringify(state, null, 2));
+      writeFileSync29(statePath2, JSON.stringify(state, null, 2));
+    }
   } catch {}
-  const summaryParts = [];
-  summaryParts.push(`${summary.adaptersProcessed} adapter${summary.adaptersProcessed === 1 ? "" : "s"}`);
-  if (summary.adaptersFailed > 0)
-    summaryParts.push(`${summary.adaptersFailed} failed`);
-  summaryParts.push(`${summary.skillWrites} skill write${summary.skillWrites === 1 ? "" : "s"} (${summary.skillFilesWritten} files)`);
-  if (summary.mcpServerWrites > 0)
-    summaryParts.push(`${summary.mcpServerWrites} MCP config write${summary.mcpServerWrites === 1 ? "" : "s"}`);
-  if (summary.hookInstallCalls > 0)
-    summaryParts.push(`${summary.hookInstallCalls} hook install${summary.hookInstallCalls === 1 ? "" : "s"}`);
-  summaryParts.push(`${summary.instructionHintWrites} instruction hint write${summary.instructionHintWrites === 1 ? "" : "s"}`);
-  console.log(`
+  const failedNote = summary.adaptersFailed > 0 ? ` (${summary.adaptersFailed} failed)` : "";
+  if (isVerbose()) {
+    const summaryParts = [];
+    summaryParts.push(`${summary.adaptersProcessed} adapter${summary.adaptersProcessed === 1 ? "" : "s"}`);
+    if (summary.adaptersFailed > 0)
+      summaryParts.push(`${summary.adaptersFailed} failed`);
+    summaryParts.push(`${summary.skillWrites} skill write${summary.skillWrites === 1 ? "" : "s"} (${summary.skillFilesWritten} files)`);
+    if (summary.mcpServerWrites > 0)
+      summaryParts.push(`${summary.mcpServerWrites} MCP config write${summary.mcpServerWrites === 1 ? "" : "s"}`);
+    if (summary.hookInstallCalls > 0)
+      summaryParts.push(`${summary.hookInstallCalls} hook install${summary.hookInstallCalls === 1 ? "" : "s"}`);
+    summaryParts.push(`${summary.instructionHintWrites} instruction hint write${summary.instructionHintWrites === 1 ? "" : "s"}`);
+    console.log(`
   Summary: ${summaryParts.join(", ")}.`);
+  } else {
+    console.log(`
+  ${summary.adaptersProcessed} agent${summary.adaptersProcessed === 1 ? "" : "s"} synced${failedNote}.`);
+  }
   try {
     const cadence = loadCadenceState();
     const lastMs = cadence.lastReflectedAt ? new Date(cadence.lastReflectedAt).getTime() : 0;
@@ -18370,7 +18684,8 @@ Syncing workspace data...
       dryRun: false,
       pullOnly: true,
       yes: true,
-      prefer: "remote"
+      prefer: "remote",
+      initialSetup: true
     });
   }
   console.log("\nSetup complete. Run `runwork sync` anytime to refresh.");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runwork",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "CLI for Runwork: develop, preview, and deploy Runwork apps from your local machine.",
   "license": "UNLICENSED",
   "author": "Runwork <info@runwork.ai> (https://www.runwork.ai)",