@event4u/agent-config 16.4.0 → 17.0.0

package/dist/cli-delegate/cmd_session_recycle.js

@@ -5,23 +5,32 @@ import {
   env_session_id,
   recycle_envelope_rel,
   resolvePredecessor
-} from "./chunk-MSUL5NYP.js";
+} from "./chunk-BYV46VRM.js";
+import "./chunk-XCY5KKUC.js";
+import "./chunk-6E2LDY4F.js";
+import "./chunk-7NXCZSDL.js";
+import "./chunk-2CX7NWRB.js";
 import {
   CAPSULE_SCHEMA_VERSION,
   validateRecycleEnvelope
-} from "./chunk-AED2VQGM.js";
+} from "./chunk-FKYZOWVD.js";
 import "./chunk-IAYTIIQW.js";
+import "./chunk-PV7S5DPJ.js";
 import "./chunk-LQOCRFWT.js";
 import {
   atomic_write_json
 } from "./chunk-7HKRE54K.js";
-import "./chunk-KB5FZ655.js";
-import "./chunk-MWRD5YOH.js";
-import "./chunk-F7DQWYR5.js";
 import {
   ORIGIN_CWD_FALLBACK,
   resolve_project_root
-} from "./chunk-H76PHZBI.js";
+} from "./chunk-XLY5G3CM.js";
+import "./chunk-M6CRG5O6.js";
+import "./chunk-MWRD5YOH.js";
+import "./chunk-BMGUGSY6.js";
+import "./chunk-RAXQOETZ.js";
+import "./chunk-IDAOTDPE.js";
+import "./chunk-I3EIN2YG.js";
+import "./chunk-OY53J6II.js";
 import "./chunk-T6BP34WI.js";
 import "./chunk-MCJYCQPF.js";
 import "./chunk-J55WI3RR.js";

package/dist/cli-delegate/cmd_settings_check.js

@@ -3,8 +3,8 @@ import {
   GIT_CONVENTION_KEYS,
   fileSource,
   readGitConventionKey
-} from "./chunk-6V5FMA3P.js";
-import "./chunk-H76PHZBI.js";
+} from "./chunk-7CEI2YPS.js";
+import "./chunk-XLY5G3CM.js";
 import "./chunk-T6BP34WI.js";
 import "./chunk-MCJYCQPF.js";
 import "./chunk-J55WI3RR.js";

package/dist/cli-delegate/cmd_settings_get.js

@@ -19,7 +19,7 @@ import {
   load_agent_settings,
   settings_layer_states,
   user_global_settings_paths
-} from "./chunk-H76PHZBI.js";
+} from "./chunk-XLY5G3CM.js";
 import {
   resolve_with_fallback,
   write_target

package/dist/cli-delegate/cmd_settings_migrate.js

@@ -3,23 +3,26 @@ import {
   GLOBAL_AGENT_SETTINGS_PATH,
   GLOBAL_USER_SETTINGS_PATH,
   SETTINGS_FILE
-} from "./chunk-T7XSJSUQ.js";
-import "./chunk-6SRJTYJS.js";
-import "./chunk-WOKWX5PL.js";
-import "./chunk-523HCFYO.js";
-import "./chunk-G5VVIZRC.js";
-import "./chunk-6YQC2HLF.js";
+} from "./chunk-SIOMDAKL.js";
+import "./chunk-4SHNERBL.js";
+import "./chunk-BKALSTBZ.js";
+import "./chunk-NTM7G2V4.js";
+import "./chunk-IROAQ77A.js";
+import "./chunk-F7HLSW6P.js";
+import "./chunk-JHMMWNJ2.js";
+import "./chunk-LF2KKJ4Q.js";
 import "./chunk-A4QJ6ENT.js";
-import "./chunk-MDPPKQCQ.js";
-import "./chunk-DMSZHXZS.js";
+import "./chunk-GOMILC3O.js";
+import "./chunk-7DRWULEQ.js";
 import "./chunk-ULQRUR23.js";
+import "./chunk-PV7S5DPJ.js";
 import "./chunk-LQOCRFWT.js";
+import "./chunk-XLY5G3CM.js";
 import "./chunk-DEIV7XP7.js";
-import "./chunk-OKJUIAPS.js";
+import "./chunk-J2SJZICO.js";
+import "./chunk-4E2W63DA.js";
 import "./chunk-MWRD5YOH.js";
 import "./chunk-OY53J6II.js";
-import "./chunk-LF2KKJ4Q.js";
-import "./chunk-H76PHZBI.js";
 import "./chunk-T6BP34WI.js";
 import "./chunk-MCJYCQPF.js";
 import "./chunk-J55WI3RR.js";

package/dist/cli-delegate/cmd_settings_set.js

@@ -7,7 +7,7 @@ import {
 import {
   external_exports,
   settingsSchema
-} from "./chunk-6SRJTYJS.js";
+} from "./chunk-4SHNERBL.js";
 import {
   dump,
   load

package/dist/cli-delegate/cmd_sync.js

@@ -1,28 +1,31 @@
 import { createRequire as __acCreateRequire } from 'node:module'; const require = globalThis.require ?? __acCreateRequire(import.meta.url);
 import {
   main
-} from "./chunk-T7XSJSUQ.js";
-import "./chunk-6SRJTYJS.js";
-import "./chunk-WOKWX5PL.js";
-import "./chunk-523HCFYO.js";
-import "./chunk-G5VVIZRC.js";
-import "./chunk-6YQC2HLF.js";
+} from "./chunk-SIOMDAKL.js";
+import "./chunk-4SHNERBL.js";
+import "./chunk-BKALSTBZ.js";
+import "./chunk-NTM7G2V4.js";
+import "./chunk-IROAQ77A.js";
+import "./chunk-F7HLSW6P.js";
+import "./chunk-JHMMWNJ2.js";
+import "./chunk-LF2KKJ4Q.js";
 import "./chunk-A4QJ6ENT.js";
-import "./chunk-MDPPKQCQ.js";
-import "./chunk-DMSZHXZS.js";
+import "./chunk-GOMILC3O.js";
+import "./chunk-7DRWULEQ.js";
 import "./chunk-ULQRUR23.js";
+import "./chunk-PV7S5DPJ.js";
 import "./chunk-LQOCRFWT.js";
+import {
+  resolve_project_root
+} from "./chunk-XLY5G3CM.js";
 import "./chunk-DEIV7XP7.js";
+import "./chunk-J2SJZICO.js";
 import {
   manifest_path,
   read_manifest
-} from "./chunk-OKJUIAPS.js";
+} from "./chunk-4E2W63DA.js";
 import "./chunk-MWRD5YOH.js";
 import "./chunk-OY53J6II.js";
-import "./chunk-LF2KKJ4Q.js";
-import {
-  resolve_project_root
-} from "./chunk-H76PHZBI.js";
 import "./chunk-T6BP34WI.js";
 import "./chunk-MCJYCQPF.js";
 import "./chunk-J55WI3RR.js";

package/dist/cli-delegate/cmd_uninstall.js

@@ -2,39 +2,50 @@ import { createRequire as __acCreateRequire } from 'node:module'; const require
 import {
   PROJECT_BRIDGE_MARKERS,
   USER_SCOPE_PATHS,
+  codexSkillRoots,
+  recordPath,
+  recordPath2,
+  removeCodexResidentSet,
+  removeListingOverrides,
   subtract_pointers
-} from "./chunk-T7XSJSUQ.js";
-import "./chunk-6SRJTYJS.js";
-import "./chunk-WOKWX5PL.js";
-import "./chunk-523HCFYO.js";
-import "./chunk-G5VVIZRC.js";
-import "./chunk-6YQC2HLF.js";
+} from "./chunk-SIOMDAKL.js";
+import "./chunk-4SHNERBL.js";
+import "./chunk-BKALSTBZ.js";
+import "./chunk-NTM7G2V4.js";
+import "./chunk-IROAQ77A.js";
+import "./chunk-F7HLSW6P.js";
+import "./chunk-JHMMWNJ2.js";
+import "./chunk-LF2KKJ4Q.js";
 import "./chunk-A4QJ6ENT.js";
 import {
+  removeStagedRuntime,
   remove_managed_hooks
-} from "./chunk-MDPPKQCQ.js";
-import "./chunk-DMSZHXZS.js";
+} from "./chunk-GOMILC3O.js";
+import "./chunk-7DRWULEQ.js";
 import "./chunk-ULQRUR23.js";
+import "./chunk-PV7S5DPJ.js";
 import {
   lockfile_path,
   lockfile_write_path,
   read_lockfile,
   write_lockfile
 } from "./chunk-LQOCRFWT.js";
+import {
+  resolve_project_root
+} from "./chunk-XLY5G3CM.js";
 import "./chunk-DEIV7XP7.js";
+import {
+  recorded_rel_files
+} from "./chunk-J2SJZICO.js";
 import {
   manifest_path,
   read_manifest,
   write_manifest
-} from "./chunk-OKJUIAPS.js";
+} from "./chunk-4E2W63DA.js";
 import {
   write_atomic
 } from "./chunk-MWRD5YOH.js";
 import "./chunk-OY53J6II.js";
-import "./chunk-LF2KKJ4Q.js";
-import {
-  resolve_project_root
-} from "./chunk-H76PHZBI.js";
 import "./chunk-T6BP34WI.js";
 import "./chunk-MCJYCQPF.js";
 import "./chunk-J55WI3RR.js";
@@ -204,21 +215,79 @@ function _remove_global_content(tool, opts) {
     return [`${tool}: ${anchor} already absent`, false];
   }
   if (!opts.purge) {
-    return [`${tool}: ${anchor} preserved (pass --purge to delete)`, false];
+    return [
+      `${tool}: ${anchor} preserved (--purge removes the files this package recorded writing there)`,
+      false
+    ];
+  }
+  let recorded;
+  try {
+    recorded = recorded_rel_files(tool, target);
+  } catch (exc) {
+    return [
+      `${tool}: \u274C refusing to purge ${anchor} \u2014 deploy inventory unreadable (${_osErr(exc)})`,
+      false,
+      true
+    ];
+  }
+  if (recorded.size === 0) {
+    return [
+      `${tool}: \u274C refusing to purge ${anchor} \u2014 no recorded inventory for this anchor; nothing was deleted`,
+      false,
+      true
+    ];
   }
   if (opts.dry_run) {
-    return [`${tool}: would purge ${anchor}`, true];
+    return [`${tool}: would purge ${recorded.size} recorded file(s) under ${anchor}`, true];
   }
+  const resolved_anchor = path.resolve(target);
+  let real_anchor;
   try {
-    if (_isDir(target)) {
-      fs.rmSync(target, { recursive: true, force: false });
-    } else {
-      fs.unlinkSync(target);
-    }
-    return [`${tool}: purged ${anchor}`, true];
+    real_anchor = fs.realpathSync(resolved_anchor);
   } catch (exc) {
-    return [`${tool}: \u274C failed to purge ${anchor} (${_osErr(exc)})`, false];
+    return [`${tool}: \u274C refusing to purge ${anchor} \u2014 anchor unresolvable (${_osErr(exc)})`, false, true];
+  }
+  const really_inside = (p) => {
+    try {
+      const real = fs.realpathSync(p);
+      return real === real_anchor || real.startsWith(real_anchor + path.sep);
+    } catch {
+      return false;
+    }
+  };
+  let deleted = 0;
+  const touched_dirs = /* @__PURE__ */ new Set();
+  for (const rel of recorded) {
+    const abs = path.resolve(resolved_anchor, rel);
+    if (abs !== resolved_anchor && !abs.startsWith(resolved_anchor + path.sep)) {
+      continue;
+    }
+    if (!really_inside(path.dirname(abs))) {
+      continue;
+    }
+    try {
+      const st = fs.lstatSync(abs);
+      if (st.isDirectory()) continue;
+      fs.unlinkSync(abs);
+      deleted += 1;
+      touched_dirs.add(path.dirname(abs));
+    } catch {
+    }
+  }
+  for (const dir of [...touched_dirs].sort((a, b) => b.length - a.length)) {
+    let cur = dir;
+    while (cur.startsWith(resolved_anchor + path.sep)) {
+      try {
+        if (!really_inside(cur) || fs.realpathSync(cur) === real_anchor) break;
+        if (fs.readdirSync(cur).length > 0) break;
+        fs.rmdirSync(cur);
+      } catch {
+        break;
+      }
+      cur = path.dirname(cur);
+    }
   }
+  return [`${tool}: purged ${deleted} recorded file(s) under ${anchor}`, deleted > 0];
 }
 function _osErr(exc) {
   const e = exc;
@@ -493,6 +562,12 @@ function _uninstall_project(opts) {
       }
       continue;
     }
+    if (entry["scope"] === "global") {
+      const verb = opts.dry_run ? "would remove" : "removed";
+      _print(_stdout, `  \xB7 ${tool}: ${verb} global-scope entry, no file touched (content: \`uninstall --global\`)`);
+      if (!opts.dry_run) removed_names.push(tool);
+      continue;
+    }
     if (!_is_v2_entry(entry)) {
       const [line, removed] = _remove_project_marker(project_root, tool, {
         dry_run: opts.dry_run
@@ -549,6 +624,33 @@ function _uninstall_project(opts) {
   }
   return 0;
 }
+function _tools_with_recorded_content_left(tools) {
+  const left = [];
+  for (const tool of tools) {
+    const anchor = USER_SCOPE_PATHS[tool];
+    if (!anchor) {
+      continue;
+    }
+    const target = expanduser(anchor);
+    if (!_exists(target)) {
+      continue;
+    }
+    let recorded;
+    try {
+      recorded = recorded_rel_files(tool, target);
+    } catch {
+      left.push(tool);
+      continue;
+    }
+    for (const rel of recorded) {
+      if (_exists(path.join(target, rel))) {
+        left.push(tool);
+        break;
+      }
+    }
+  }
+  return left;
+}
 function _uninstall_global(opts) {
   const lock_path = lockfile_path();
   const write_path = lockfile_write_path();
@@ -571,20 +673,52 @@ function _uninstall_global(opts) {
     `${opts.dry_run ? "[dry-run] " : ""}uninstalling ${tools.length} tool(s) from global scope:`
   );
   const removed_names = [];
+  let refused = false;
+  if (tools.includes("codex") && !opts.dry_run) {
+    try {
+      let removed = 0;
+      let kept = 0;
+      let finder = 0;
+      for (const anchor of codexSkillRoots(os.homedir())) {
+        const res = removeCodexResidentSet(anchor, recordPath(anchor));
+        removed += res.removed.length;
+        kept += res.kept_user.length;
+        if (res.finder === "removed") finder += 1;
+      }
+      if (removed > 0 || kept > 0 || finder > 0) {
+        _print(
+          _stdout,
+          `  \xB7 codex: removed ${removed} resident-set policy file(s) and ${finder} finder entr(ies), kept ${kept} the user changed`
+        );
+      }
+    } catch (e) {
+      _print(_stderr, `\u26A0\uFE0F  codex: resident-set removal skipped \u2014 ${String(e)}`);
+    }
+  }
   for (const tool of tools) {
-    const [line, removed] = _remove_global_content(tool, {
+    const [line, removed, refusedHere] = _remove_global_content(tool, {
       dry_run: opts.dry_run,
       purge: opts.purge
     });
     _print(_stdout, `  \xB7 ${line}`);
+    if (refusedHere === true) {
+      refused = true;
+    }
     if (removed && !opts.dry_run) {
       removed_names.push(tool);
     }
   }
+  if (tools.includes("claude-code") && opts.purge && !refused && !opts.dry_run) {
+    const staged = removeStagedRuntime();
+    if (staged !== null) _print(_stdout, `  \xB7 claude-code: removed the staged hook runtime (${staged})`);
+  }
   if (tools.includes("claude-code")) {
     const settings_path = path.join(os.homedir(), ".claude", "settings.json");
     if (opts.dry_run) {
-      _print(_stdout, `  \xB7 claude-code: would remove managed hooks from ${settings_path}`);
+      _print(
+        _stdout,
+        `  \xB7 claude-code: would remove managed hooks and recorded listing overrides from ${settings_path}`
+      );
     } else {
       try {
         const res = remove_managed_hooks(settings_path);
@@ -597,6 +731,17 @@ function _uninstall_global(opts) {
       } catch (e) {
         _print(_stderr, `\u26A0\uFE0F  claude-code: managed-hook removal skipped \u2014 ${String(e)}`);
       }
+      try {
+        const res = removeListingOverrides(settings_path, recordPath2());
+        if (res.changed || res.kept_user.length > 0) {
+          _print(
+            _stdout,
+            `  \xB7 claude-code: removed ${res.removed.length} listing override(s), kept ${res.kept_user.length} the user changed`
+          );
+        }
+      } catch (e) {
+        _print(_stderr, `\u26A0\uFE0F  claude-code: listing-override removal skipped \u2014 ${String(e)}`);
+      }
     }
   }
   if (lock !== null && !opts.dry_run) {
@@ -615,17 +760,25 @@ function _uninstall_global(opts) {
         `\u2705  lockfile updated (${tools.length} entries removed, ${remaining.length} kept)`
       );
     } else {
-      const targets = lock_path === write_path ? [write_path] : [lock_path, write_path];
-      for (const target of targets) {
-        try {
-          fs.unlinkSync(target);
-        } catch {
+      const stranded = refused ? tools : _tools_with_recorded_content_left(tools);
+      if (stranded.length) {
+        _print(
+          _stdout,
+          `\u2139\uFE0F   lockfile kept (${write_path}) \u2014 ${stranded.join(", ")} still holds files this package recorded writing; \`--purge\` removes them, and without this record nothing can`
+        );
+      } else {
+        const targets = lock_path === write_path ? [write_path] : [lock_path, write_path];
+        for (const target of targets) {
+          try {
+            fs.unlinkSync(target);
+          } catch {
+          }
         }
+        _print(_stdout, `\u2705  lockfile deleted (${write_path})`);
       }
-      _print(_stdout, `\u2705  lockfile deleted (${write_path})`);
     }
   }
-  return 0;
+  return refused ? 1 : 0;
 }
 function main(argv = null) {
   const opts = _parse(argv !== null ? [...argv] : process.argv.slice(2));
@@ -663,5 +816,6 @@ if (_isCliEntry() || process.argv[1] === _HERE) {
   }
 }
 export {
+  _remove_global_content,
   main
 };

package/dist/cli-delegate/cmd_update.js

@@ -1,9 +1,14 @@
 import { createRequire as __acCreateRequire } from 'node:module'; const require = globalThis.require ?? __acCreateRequire(import.meta.url);
+import {
+  CONSUMER_IMPACT_VALUES
+} from "./chunk-UUYEKXKR.js";
 import {
   DEFAULT_STATE_PATH,
   _is_newer,
-  fetch_latest_from_npm
-} from "./chunk-AL3RZ22D.js";
+  compare_versions,
+  fetch_latest_from_npm,
+  parse_version
+} from "./chunk-5VO3RTMV.js";
 import {
   lockfile_path,
   lockfile_write_path,
@@ -16,7 +21,7 @@ import {
   LOCAL_PROJECT_SUBDIR,
   find_project_root,
   resolve_project_root
-} from "./chunk-H76PHZBI.js";
+} from "./chunk-XLY5G3CM.js";
 import "./chunk-T6BP34WI.js";
 import {
   resolvePackageRoot
@@ -30,6 +35,40 @@ import * as fs from "node:fs";
 import * as path from "node:path";
 import process from "node:process";
 import { fileURLToPath, pathToFileURL } from "node:url";
+
+// src/scripts/_lib/pin_advice.ts
+function pin_advice_lines(pin, latest, impactMap, label = "latest") {
+  const order = compare_versions(latest, pin);
+  if (order === null) return [`Pinned at ${pin}; ${label} ${latest} \u2014 one of the two is not a version this check can read.`];
+  if (order !== 1) return [];
+  const head = `Pinned at ${pin}; ${label} is ${latest}.`;
+  const tail = "Moving the pin is a team decision: `agent-config update` rewrites it, this check never does.";
+  if (impactMap === void 0) {
+    return [head, `  The releases in between cannot be read: the impact map of ${latest} could not be fetched.`, tail];
+  }
+  if (impactMap === null || typeof impactMap !== "object" || Array.isArray(impactMap)) {
+    return [head, `  The releases in between cannot be read: ${latest} carries no impact map.`, tail];
+  }
+  const rows = [];
+  for (const [version, entry] of Object.entries(impactMap)) {
+    if (parse_version(version) === null) return [head, `  The impact map is not trustworthy: key '${version}' is not a version.`, tail];
+    if (compare_versions(version, pin) !== 1 || compare_versions(version, latest) === 1) continue;
+    const impact = entry?.["impact"];
+    if (!CONSUMER_IMPACT_VALUES.includes(impact)) {
+      return [head, `  The impact map is not trustworthy: ${version} has impact '${String(impact)}'.`, tail];
+    }
+    const security = entry["security"] === true ? ", security fix" : "";
+    rows.push([version, `${String(impact)}${security}`]);
+  }
+  rows.sort((a, b) => compare_versions(a[0], b[0]) ?? 0);
+  const body = rows.length === 0 ? ["  No release in between records a consumer impact."] : rows.map(([v, what]) => `  ${v}  ${what}`);
+  const keys = Object.keys(impactMap).sort((a, b) => compare_versions(a, b) ?? 0);
+  const first = keys[0];
+  const uncovered = first === void 0 ? ["  The impact map is empty; the releases in between are not described."] : compare_versions(pin, first) === -1 ? [`  The impact map's first entry is ${first}; releases between ${pin} and it may predate the map.`] : [];
+  return [head, ...body, ...uncovered, tail];
+}
+
+// src/scripts/_cli/cmd_update.ts
 var PACKAGE_NAME = "@event4u/agent-config";
 var PIN_KEY = "agent_config_version";
 var REGISTRY_VERSION_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/{version}`;
@@ -189,6 +228,26 @@ function _read_pin_line(p) {
   }
   return null;
 }
+function _read_pin_value(p) {
+  const idx = _read_pin_line(p);
+  if (idx === null) return null;
+  const line = _splitlinesKeepends(fs.readFileSync(p, { encoding: "utf-8" }))[idx];
+  const raw = (PIN_LINE_RE.exec(line)?.[2] ?? "").replace(/\s+#.*$/, "").trim().replace(/^["']|["']$/g, "");
+  return raw === "" ? null : _normalize(raw);
+}
+async function _fetch_impact_map(version, timeout = 1) {
+  try {
+    const resp = await fetch(REGISTRY_VERSION_URL.replace("{version}", _normalize(version)), {
+      headers: { Accept: "application/json" },
+      signal: AbortSignal.timeout(timeout * 1e3)
+    });
+    if (resp.status !== 200) return void 0;
+    const doc = await resp.json();
+    return doc?.agentConfig?.impact ?? null;
+  } catch {
+    return void 0;
+  }
+}
 function _write_pin(p, new_version) {
   const target = `agent_config_version: "${_normalize(new_version)}"
 `;
@@ -340,6 +399,11 @@ async function main(argv = null, options = {}) {
     } else {
       _print(out, `agent-config is up to date (${installed_version}).`);
     }
+    const pin = _read_pin_value(_find_pin_file(cwd));
+    if (pin !== null && !offline) {
+      const fetch_impact = options.impact_fetcher ?? _fetch_impact_map;
+      for (const line of pin_advice_lines(pin, latest, await fetch_impact(latest), args.to ? "target" : "latest")) _print(out, line);
+    }
     return 0;
   }
   const pin_file = _find_pin_file(cwd);

package/dist/cli-delegate/cmd_upgrade.js

@@ -1,14 +1,15 @@
 #!/usr/bin/env tsx
 import { createRequire as __acCreateRequire } from 'node:module'; const require = globalThis.require ?? __acCreateRequire(import.meta.url);
-import {
-  _is_newer,
-  fetch_latest_from_npm
-} from "./chunk-AL3RZ22D.js";
 import {
   CLAUDE_MARKETPLACE_NAME,
   CLAUDE_PLUGIN_ID,
   claude_plugin_installed
 } from "./chunk-FTAISGDQ.js";
+import {
+  _is_newer,
+  fetch_latest_from_npm,
+  parse_version
+} from "./chunk-5VO3RTMV.js";
 import {
   _is_source_repo,
   install_cli_wrapper,
@@ -20,7 +21,7 @@ import {
 } from "./chunk-LQOCRFWT.js";
 import {
   project_settings_path
-} from "./chunk-H76PHZBI.js";
+} from "./chunk-XLY5G3CM.js";
 import {
   event4u_root,
   write_target
@@ -235,7 +236,7 @@ function _refresh_claude_plugin(steps, runner, out, err) {
   }
 }
 var PROG = "agent-config upgrade";
-var USAGE = `usage: ${PROG} [-h] [--check] [--dry-run] [--converge]
+var USAGE = `usage: ${PROG} [-h] [--check] [--dry-run] [--converge] [--unattended] [--skip VERSION]
 `;
 function _argError(msg) {
   _stderr.write(USAGE);
@@ -244,7 +245,7 @@ function _argError(msg) {
   throw new ArgparseExit(2);
 }
 function _parse(argv) {
-  const args = { check: false, dry_run: false, converge: false };
+  const args = { check: false, dry_run: false, converge: false, unattended: false, skip: null };
   const positionals = [];
   let i = 0;
   while (i < argv.length) {
@@ -280,6 +281,23 @@ function _parse(argv) {
       i += 1;
       continue;
     }
+    if (flag === "--unattended") {
+      if (inlineVal !== null) {
+        _argError(`argument --unattended: ignored explicit argument '${inlineVal}'`);
+      }
+      args.unattended = true;
+      i += 1;
+      continue;
+    }
+    if (flag === "--skip") {
+      const value = inlineVal ?? argv[i + 1];
+      if (value === void 0 || value === "" || inlineVal === null && value.startsWith("-")) {
+        _argError("argument --skip: expected one argument");
+      }
+      args.skip = lstripV(value.trim());
+      i += inlineVal === null ? 2 : 1;
+      continue;
+    }
     if (a.startsWith("-") && a !== "-") {
       _argError(`unrecognized arguments: ${a}`);
     }
@@ -289,6 +307,15 @@ function _parse(argv) {
   if (positionals.length > 0) {
     _argError(`unrecognized arguments: ${positionals.join(" ")}`);
   }
+  if (args.unattended && (args.check || args.converge || args.skip !== null)) {
+    _argError("argument --unattended: not allowed with --check, --converge or --skip");
+  }
+  if (args.skip !== null && (args.check || args.dry_run || args.converge)) {
+    _argError("argument --skip: not allowed with --check, --dry-run or --converge");
+  }
+  if (args.skip !== null && parse_version(args.skip) === null) {
+    _argError(`argument --skip: '${args.skip}' is not a version`);
+  }
   return args;
 }
 async function main(argv = null, options = {}) {
@@ -297,6 +324,10 @@ async function main(argv = null, options = {}) {
   const out = options.out ?? _stdout;
   const err = options.err ?? _stderr;
   const args = _parse(argv ?? process.argv.slice(2));
+  if (args.skip !== null || args.unattended) {
+    const unattended = await import("./upgrade_unattended-VVL6JLSX.js");
+    return args.skip !== null ? unattended.skip_version(args.skip, out) : unattended.run_unattended_default({ dryRun: args.dry_run, out, err, agentConfigBin: _agent_config_bin() });
+  }
   const installed = options.installed !== void 0 && options.installed !== null ? options.installed : _installed_version();
   const latest = await fetcher() || "";
   if (args.check) {