agentwheel 0.4.0 → 0.4.1

package/README.md

@@ -72,6 +72,9 @@ pnpm link --global
 
 `plan`, `sync --dry-run`, and `update --dry-run` show exactly what would change before anything is written. They're the commands to trust.
 
+`uninstall` removes clean managed files by default and keeps drifted files in place with a warning.
+Use `agentwheel uninstall --force` only when you also want to remove drifted managed files.
+
 ## Runtime targeting
 
 Normal use no longer needs `--target-root`. Run agentwheel inside a runtime folder and it detects

package/dist/index.js

@@ -461,16 +461,52 @@ async function applyInstallPlan(plan, sourceLock, options = {}) {
   await writeSourceLock(plan.targetRoot, plan.adapter, sourceLock);
   return manifest;
 }
-async function uninstall(plan, dryRun) {
+async function uninstall(plan, options = {}) {
+  const resolvedOptions = typeof options === "boolean" ? { dryRun: options } : options;
   if (plan.hasBlockingChanges) {
-    const blockers = plan.operations.filter((operation) => operation.action === "drift" || operation.action === "conflict");
-    throw new Error(`Refusing to uninstall with drift: ${blockers.map((item) => item.relativeDestPath).join(", ")}`);
+    const blockers = plan.operations.filter((operation) => operation.action === "conflict");
+    throw new Error(`Refusing to uninstall with blocking changes: ${blockers.map((item) => item.relativeDestPath).join(", ")}`);
   }
-  if (dryRun) return;
+  const removable = plan.operations.filter((operation) => operation.action === "remove" || resolvedOptions.force && operation.action === "keep");
+  const kept = resolvedOptions.force ? [] : plan.operations.filter((operation) => operation.action === "keep");
+  const removedDrifted = resolvedOptions.force ? plan.operations.filter((operation) => operation.action === "keep").length : 0;
+  if (resolvedOptions.dryRun) return { removed: removable.length, kept: kept.length, removedDrifted };
   for (const operation of plan.operations) {
-    await rm2(operation.destPath, { recursive: true, force: true });
+    if (operation.action === "remove" || resolvedOptions.force && operation.action === "keep") {
+      await rm2(operation.destPath, { recursive: true, force: true });
+    }
+  }
+  if (kept.length > 0) {
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    await writeInstallManifest({
+      version: 1,
+      adapter: plan.adapter,
+      targetRoot: plan.targetRoot,
+      generatedAt: now,
+      adapterCode: plan.adapterCode,
+      entries: kept.map((operation) => {
+        if (!operation.manifestHash || !operation.desiredHash) {
+          throw new Error(`Invalid kept operation missing manifest/source hash: ${operation.relativeDestPath}`);
+        }
+        return {
+          path: operation.relativeDestPath,
+          artifactType: operation.artifactType,
+          artifactName: operation.artifactName,
+          kind: operation.kind,
+          hash: operation.manifestHash,
+          sourceHash: operation.desiredHash,
+          updatedAt: now,
+          channel: operation.channel,
+          packageName: operation.packageName,
+          semanticCommand: operation.semanticCommand,
+          mergeStrategy: operation.mergeStrategy
+        };
+      }).sort((a, b) => a.path.localeCompare(b.path))
+    });
+  } else {
+    await removeStateFiles(plan.targetRoot, plan.adapter);
   }
-  await removeStateFiles(plan.targetRoot, plan.adapter);
+  return { removed: removable.length, kept: kept.length, removedDrifted };
 }
 
 // src/install/plan.ts
@@ -658,6 +694,7 @@ function summarizePlan(plan) {
     update: 0,
     skip: 0,
     remove: 0,
+    keep: 0,
     drift: 0,
     conflict: 0,
     plugin: 0,
@@ -679,17 +716,20 @@ async function createUninstallPlan(manifest) {
     const currentHash = await hashPath(destPath);
     if (currentHash !== entry.hash) {
       operations.push({
-        action: "drift",
+        action: "keep",
         artifactType: entry.artifactType,
         artifactName: entry.artifactName,
         kind: entry.kind,
         destPath,
         relativeDestPath: entry.path,
+        desiredHash: entry.sourceHash,
         currentHash,
         manifestHash: entry.hash,
-        reason: "managed destination changed outside agentwheel",
+        reason: "managed destination changed outside agentwheel; keeping by default",
         channel: entry.channel,
-        packageName: entry.packageName
+        packageName: entry.packageName,
+        semanticCommand: entry.semanticCommand,
+        mergeStrategy: entry.mergeStrategy
       });
     } else {
       operations.push({
@@ -712,7 +752,8 @@ async function createUninstallPlan(manifest) {
     adapter: manifest.adapter,
     targetRoot: manifest.targetRoot,
     operations,
-    hasBlockingChanges: operations.some((operation) => operation.action === "drift" || operation.action === "conflict")
+    hasBlockingChanges: operations.some((operation) => operation.action === "conflict"),
+    adapterCode: manifest.adapterCode
   };
 }
 
@@ -722,6 +763,7 @@ var labels = {
   update: "UPDATE",
   skip: "SKIP",
   remove: "REMOVE",
+  keep: "KEEP",
   drift: "DRIFT",
   conflict: "CONFLICT",
   plugin: "PLUGIN",
@@ -743,7 +785,7 @@ function formatPlan(plan) {
   }
   const summary = summarizePlan(plan);
   lines.push(
-    `Summary: create ${summary.create}, update ${summary.update}, skip ${summary.skip}, remove ${summary.remove}, drift ${summary.drift}, conflict ${summary.conflict}, plugin ${summary.plugin}`
+    `Summary: create ${summary.create}, update ${summary.update}, skip ${summary.skip}, remove ${summary.remove}, keep ${summary.keep}, drift ${summary.drift}, conflict ${summary.conflict}, plugin ${summary.plugin}`
   );
   return lines.join("\n");
 }
@@ -2068,7 +2110,7 @@ function dedupeTargets(matches) {
 
 // src/cli/index.ts
 var program = new Command();
-program.name("agentwheel").description("Multi-runtime agent artifact orchestrator").version("0.4.0");
+program.name("agentwheel").description("Multi-runtime agent artifact orchestrator").version("0.4.1");
 program.command("init").argument("[kind]", "workspace or package", "workspace").option("--target-root <path>", "workspace root", process.cwd()).action(async (kind, options) => {
   const root = normalizeTargetRoot(options.targetRoot);
   if (kind === "package") {
@@ -2225,7 +2267,7 @@ program.command("eject").argument("<item>", "package/type/name").option("--targe
   const result = await ejectArtifact(targetRoot, item);
   console.log(`Ejected ${item} to ${result.ejectedPath}.`);
 });
-program.command("uninstall").option("--adapter <adapter>", "adapter", "openclaw").option("--adapter-module <path>", "local programmatic adapter module").option("--allow-adapter-code", "allow loading local adapter code", false).option("--target-root <path>", "runtime/project root").option("--agent <name>", "named agent from merged config").option("--all", "run for every configured agent", false).option("--dry-run", "show removals without writing", false).action(async (options) => {
+program.command("uninstall").option("--adapter <adapter>", "adapter", "openclaw").option("--adapter-module <path>", "local programmatic adapter module").option("--allow-adapter-code", "allow loading local adapter code", false).option("--target-root <path>", "runtime/project root").option("--agent <name>", "named agent from merged config").option("--all", "run for every configured agent", false).option("--dry-run", "show removals without writing", false).option("--force", "remove drifted managed files too", false).action(async (options) => {
   const targets = await resolveCliTargets(options);
   for (const target of targets) {
     const adapter = await resolveAdapterForTarget(target, options);
@@ -2236,10 +2278,10 @@ program.command("uninstall").option("--adapter <adapter>", "adapter", "openclaw"
     }
     const plan = await createUninstallPlan(manifest);
     console.log(formatPlan(plan));
-    await uninstall(plan, options.dryRun);
+    const result = await uninstall(plan, { dryRun: options.dryRun, force: options.force });
     if (!options.dryRun) {
       await adapter.programmatic?.uninstall?.({ targetRoot: target.targetRoot, adapterName: adapter.name });
-      console.log(`Uninstalled ${adapter.name} at ${target.targetRoot}.`);
+      console.log(formatUninstallResult(result));
     }
     if (plan.hasBlockingChanges) process.exitCode = 1;
   }
@@ -2329,6 +2371,16 @@ async function initPackage(root) {
 `, "utf8");
   await writeFile4(join19(root, "instructions", "AGENTS.md"), "# Agent Instructions\n", "utf8");
 }
+function formatUninstallResult(result) {
+  const removedLabel = result.removed === 1 ? "managed file" : "managed files";
+  if (result.removedDrifted > 0) {
+    const driftedLabel = result.removedDrifted === 1 ? "drifted file" : "drifted files";
+    return `Removed ${result.removed} ${removedLabel}, including ${result.removedDrifted} ${driftedLabel}.`;
+  }
+  if (result.kept === 0) return `Removed ${result.removed} ${removedLabel}.`;
+  const keptLabel = result.kept === 1 ? "drifted file" : "drifted files";
+  return `Removed ${result.removed} ${removedLabel}; kept ${result.kept} ${keptLabel} (use --force to remove).`;
+}
 function printRegistryEntries(entries) {
   for (const entry of entries) {
     const tags = entry.tags?.length ? ` [${entry.tags.join(",")}]` : "";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentwheel",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Weave skills, rules, and instructions across every AI agent.",
   "type": "module",
   "license": "MIT",