agentwheel 0.20.14 → 0.20.16

package/README.md

@@ -148,6 +148,8 @@ revalidates the exact contribution under the apply lock. It removes only the sel
 server; sibling servers and user configuration remain. The command previews by default. A later
 runtime approval must use the same command with `--apply` instead of `--dry-run`.
 
+When stable and legacy manifests disagree, `update --recover-legacy-state` explicitly uses recovered stable state while preserving legacy evidence. Preview the same command with `--dry-run` first.
+
 For a surgical dependency update, start with a dry-run:
 
 ```bash

package/dist/index.js

@@ -9254,7 +9254,8 @@ async function syncProfile(options) {
       forceDrift: options.forceDrift,
       forceConflict: options.forceConflict,
       forceForeignState: options.forceForeignState,
-      replaceConflict: options.replaceConflict
+      replaceConflict: options.replaceConflict,
+      recoverLegacyState: options.recoverLegacyState
     });
     try {
       const result = {
@@ -13763,7 +13764,7 @@ program.command("sync", { hidden: true }).argument("[name-or-source]", "configur
   console.error("warning: 'agentwheel sync' is deprecated and will be removed in 0.10. Use 'agentwheel install'.");
   await runInstallCommand(source, options, { apply: !options.dryRun });
 });
-program.command("update").description("re-resolve tracking packages, then apply the result").argument("[name]", "configured package name or source to update").option("--adapter <adapter>", "built-in adapter or comma-separated adapters").option("-i, --installation-type <type>", "installation type (for example local or user)").option("--user", "use the user workspace", false).option("--local", "use the nearest local workspace", false).option("--fleet <id>", "use one registered named fleet").option("-t, --target-root <path>", "workspace root").option("--agent <name>", "named agent from merged config").option("--all", "run for every configured agent", false).option("--profile <name>", "workspace runtime profile").option("--dry-run", "show plans without writing", false).option("--force-drift", "replace drifted managed artifacts", false).option("--force-foreign-state", "plan even when another workspace owns install state at the same paths", false).option("--force-conflict", "adopt unmanaged destinations when their content already matches the desired artifact", false).option("--replace-conflict", "replace unmanaged destinations even when their content differs", false).option("--execute-plugins", "execute semantic plugin installs", false).option("--reload-runtimes", "run configured runtime reload commands after executed semantic plugin changes", false).option("--restart-runtimes", "alias for --reload-runtimes", false).option("--allow-adapter-code", "allow loading local adapter code from configured packages", false).option("--select <type/name>", "temporarily select an artifact by type/name (repeatable or comma-separated)", collectSelectOption, []).option("--artifact <type/name>", "update only one configured artifact while preserving sibling state").option("--skill <name>", "temporarily select a skill by name (repeatable or comma-separated)", collectSkillOption, []).option("--dependency <name-or-source>", "update one tracking dependency while keeping unrelated graph nodes locked (repeatable)", collectDependencyOption, []).option("--with-suggestions", "include suggested companion artifacts for selected roots", false).option("--suggestion <alias>", "include one suggested companion alias (repeatable or comma-separated)", collectSuggestionOption, []).option("--no-deps", "resolve only root sources and ignore requires with a warning").option("--only-source", "exclude unrelated configured workspace packages", false).option("--frozen-lock", "resolve strictly from the existing graph lock and cached sources", false).option("--offline", "resolve strictly from graph locks and local caches", false).option("--refresh", "refresh available package versions even when the version-index TTL is fresh", false).option("--yes", "trust all new transitive sources", false).option("--trust <pattern>", "pre-approve a transitive source glob (repeatable)", collectTrustOption, []).action(async (name, options) => {
+program.command("update").description("re-resolve tracking packages, then apply the result").argument("[name]", "configured package name or source to update").option("--adapter <adapter>", "built-in adapter or comma-separated adapters").option("-i, --installation-type <type>", "installation type (for example local or user)").option("--user", "use the user workspace", false).option("--local", "use the nearest local workspace", false).option("--fleet <id>", "use one registered named fleet").option("-t, --target-root <path>", "workspace root").option("--agent <name>", "named agent from merged config").option("--all", "run for every configured agent", false).option("--profile <name>", "workspace runtime profile").option("--dry-run", "show plans without writing", false).option("--force-drift", "replace drifted managed artifacts", false).option("--force-foreign-state", "plan even when another workspace owns install state at the same paths", false).option("--force-conflict", "adopt unmanaged destinations when their content already matches the desired artifact", false).option("--replace-conflict", "replace unmanaged destinations even when their content differs", false).option("--recover-legacy-state", "build a stable state while preserving invalid legacy candidates", false).option("--execute-plugins", "execute semantic plugin installs", false).option("--reload-runtimes", "run configured runtime reload commands after executed semantic plugin changes", false).option("--restart-runtimes", "alias for --reload-runtimes", false).option("--allow-adapter-code", "allow loading local adapter code from configured packages", false).option("--select <type/name>", "temporarily select an artifact by type/name (repeatable or comma-separated)", collectSelectOption, []).option("--artifact <type/name>", "update only one configured artifact while preserving sibling state").option("--skill <name>", "temporarily select a skill by name (repeatable or comma-separated)", collectSkillOption, []).option("--dependency <name-or-source>", "update one tracking dependency while keeping unrelated graph nodes locked (repeatable)", collectDependencyOption, []).option("--with-suggestions", "include suggested companion artifacts for selected roots", false).option("--suggestion <alias>", "include one suggested companion alias (repeatable or comma-separated)", collectSuggestionOption, []).option("--no-deps", "resolve only root sources and ignore requires with a warning").option("--only-source", "exclude unrelated configured workspace packages", false).option("--frozen-lock", "resolve strictly from the existing graph lock and cached sources", false).option("--offline", "resolve strictly from graph locks and local caches", false).option("--refresh", "refresh available package versions even when the version-index TTL is fresh", false).option("--yes", "trust all new transitive sources", false).option("--trust <pattern>", "pre-approve a transitive source glob (repeatable)", collectTrustOption, []).action(async (name, options) => {
   if (options.onlySource && options.dependency.length > 0) throw new Error("--only-source cannot be combined with --dependency.");
   if (options.onlySource && !name) throw new Error("--only-source requires a configured package argument.");
   if (name && options.dependency.length > 0) throw new Error("A package argument cannot be combined with --dependency.");
@@ -14319,6 +14320,7 @@ async function runInstallCommand(nameOrSource, options, behavior) {
       forceConflict: normalizedOptions.forceConflict,
       forceForeignState: normalizedOptions.forceForeignState,
       replaceConflict: normalizedOptions.replaceConflict,
+      recoverLegacyState: normalizedOptions.recoverLegacyState,
       noDeps: noDepsFromOptions(normalizedOptions),
       includeSuggestions: normalizedOptions.withSuggestions,
       suggestionAliases: suggestionAliasesFromOptions(normalizedOptions),
@@ -14425,6 +14427,7 @@ async function buildPlanReport(nameOrSource, options) {
       forceConflict: normalizedOptions.forceConflict,
       forceForeignState: normalizedOptions.forceForeignState,
       replaceConflict: normalizedOptions.replaceConflict,
+      recoverLegacyState: normalizedOptions.recoverLegacyState,
       noDeps: noDepsFromOptions(normalizedOptions),
       includeSuggestions: normalizedOptions.withSuggestions,
       suggestionAliases: suggestionAliasesFromOptions(normalizedOptions),
@@ -16206,6 +16209,7 @@ function compositeUpdateArguments(profile, packageName, options) {
   args.push("--profile", profile);
   if (options.dryRun) args.push("--dry-run");
   if (options.refresh) args.push("--refresh");
+  if (options.recoverLegacyState) args.push("--recover-legacy-state");
   if (options.forceDrift) args.push("--force-drift");
   if (options.forceForeignState) args.push("--force-foreign-state");
   if (options.forceConflict) args.push("--force-conflict");

package/openpack.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 2,
   "name": "NestDevLab/agentwheel",
-  "version": "0.20.14",
+  "version": "0.20.16",
   "provides": [
     { "type": "skills", "path": "skills" }
   ]

package/package.json

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

package/skills/agentwheel/SKILL.md

@@ -5,7 +5,7 @@ allowed-tools: [Bash]
 license: MIT
 metadata:
   author: NestDevLab
-  version: "0.20.14"
+  version: "0.20.16"
 ---
 
 # agentwheel

package/skills/agentwheel-discovery/SKILL.md

@@ -5,7 +5,7 @@ allowed-tools: [Bash]
 license: MIT
 metadata:
   author: NestDevLab
-  version: "0.20.14"
+  version: "0.20.16"
 ---
 
 # Agentwheel Discovery