agentwheel 0.14.8 → 0.14.9

package/dist/index.js

@@ -1270,6 +1270,23 @@ async function removeApplyJournal(targetRoot, adapter, transport = localTranspor
   await transport.rm(applyJournalPath(targetRoot, adapter, scope));
   await transport.rm(applyBackupDir(targetRoot, adapter, scope));
 }
+async function abortApplyJournal(targetRoot, adapter, transport = localTransport, scope = {}) {
+  const lock = await acquireApplyLock(targetRoot, adapter, transport, {}, scope);
+  try {
+    const journalPath = applyJournalPath(targetRoot, adapter, scope);
+    if (!await transport.pathExists(journalPath)) return void 0;
+    const stateKey = stateKeyFor(adapter, scope);
+    const archivePath = join3(metadataDir(targetRoot), "archive", `${stateKey}.apply-journal.failed-${journalTimestamp(/* @__PURE__ */ new Date())}.json`);
+    const content = await transport.readFile(journalPath);
+    await transport.writeFileAtomic(archivePath, content.endsWith("\n") ? content : `${content}
+`);
+    await transport.rm(journalPath);
+    await transport.rm(applyBackupDir(targetRoot, adapter, scope));
+    return { journalPath, archivePath };
+  } finally {
+    await lock.release();
+  }
+}
 async function recordBackup(operation, index, targetRoot, adapter, transport = localTransport, scope = {}) {
   const hadExisting = await transport.pathExists(operation.destPath);
   if (!hadExisting || transport.kind !== "local" || operation.action !== "update" && operation.action !== "remove" && operation.action !== "create") {
@@ -1326,6 +1343,9 @@ async function readLockOwner(ownerPath, transport) {
 function isAlreadyExists(error) {
   return typeof error === "object" && error !== null && "code" in error && error.code === "EEXIST";
 }
+function journalTimestamp(date) {
+  return date.toISOString().replace(/[-:]/g, "").replace(/\.\d{3}Z$/, "Z");
+}
 async function localPathExists(path) {
   try {
     await stat2(path);
@@ -2038,7 +2058,12 @@ async function executePluginInstall(operation, transport) {
 async function executePluginUninstall(operation, transport) {
   const commands = operation.semanticPlugin?.uninstallCommands ?? [];
   if (commands.length === 0) throw new Error(`Invalid semantic plugin operation missing uninstall command: ${operation.relativeDestPath}`);
-  await executeSemanticCommands(operation, commands, transport);
+  try {
+    await executeSemanticCommands(operation, commands, transport);
+  } catch (error) {
+    if (!isPluginAlreadyAbsentError(operation, error)) throw error;
+    console.warn(`WARNING plugin-already-absent ${operation.relativeDestPath}: ${firstErrorLine(error)}`);
+  }
   if (operation.semanticPlugin?.stateRoot) {
     await transport.rm(operation.semanticPlugin.stateRoot);
   }
@@ -2185,6 +2210,35 @@ async function executeSemanticCommands(operation, commands, transport, options =
     await transport.rm(stagingRoot);
   }
 }
+function isPluginAlreadyAbsentError(operation, error) {
+  const output = commandErrorOutput(error).toLowerCase();
+  if (!output || output.includes("command not found") || output.includes("module not found")) return false;
+  const pluginName = (operation.semanticPlugin?.pluginName ?? operation.artifactName).toLowerCase();
+  const escapedName = escapeRegExp(pluginName);
+  const namedAbsent = [
+    new RegExp(`${escapedName}.{0,120}\\b(not installed|not found|does not exist|absent)\\b`, "s"),
+    new RegExp(`\\b(not installed|not found|does not exist|absent)\\b.{0,120}${escapedName}`, "s"),
+    new RegExp(`\\bunknown plugin\\b.{0,120}${escapedName}`, "s"),
+    new RegExp(`${escapedName}.{0,120}\\bunknown plugin\\b`, "s")
+  ].some((pattern) => pattern.test(output));
+  const genericAbsent = /\b(no such|unknown)\s+plugins?\b/.test(output) || /\bplugins?\b.{0,80}\bnot installed\b/s.test(output);
+  return namedAbsent || genericAbsent;
+}
+function commandErrorOutput(error) {
+  if (typeof error === "object" && error !== null) {
+    const stderr = "stderr" in error ? String(error.stderr ?? "") : "";
+    if (stderr.trim()) return stderr;
+    const stdout = "stdout" in error ? String(error.stdout ?? "") : "";
+    if (stdout.trim()) return stdout;
+  }
+  return error instanceof Error ? error.message : String(error);
+}
+function firstErrorLine(error) {
+  return commandErrorOutput(error).split(/\r?\n/).map((line) => line.trim()).find(Boolean) ?? "plugin is already absent";
+}
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
 function semanticInstallCommands(operation) {
   if (operation.semanticPlugin) return operation.semanticPlugin.installCommands;
   return operation.semanticCommand ? [operation.semanticCommand] : [];
@@ -2430,7 +2484,7 @@ function codexAgentName(artifact) {
 }
 function validateCodexAgentToml(content, path) {
   for (const field of requiredCodexAgentFields) {
-    const pattern = new RegExp(`(^|\\n)\\s*${escapeRegExp(field)}\\s*=`, "m");
+    const pattern = new RegExp(`(^|\\n)\\s*${escapeRegExp2(field)}\\s*=`, "m");
     if (!pattern.test(content)) {
       throw new Error(`Codex custom agent TOML ${path} is missing required field '${field}'.`);
     }
@@ -2476,7 +2530,7 @@ function tomlMultilineString(value) {
 ${escaped.endsWith("\n") ? escaped : `${escaped}
 `}"""`;
 }
-function escapeRegExp(value) {
+function escapeRegExp2(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 
@@ -9514,6 +9568,38 @@ program.command("status").description("show configured packages and runtime inst
     await printStatus(target, normalizedOptions);
   }
 });
+var journalCommand = program.command("journal").description("inspect or abort pending apply journals");
+journalCommand.command("list").description("show pending apply journals for resolved runtime targets").option("--adapter <adapter>", "built-in adapter or comma-separated adapters").option("-i, --installation-type <type>", "installation type (for example local or user)").option("--user", "shortcut for --installation-type user and home-scoped state", false).option("--local", "shortcut for --installation-type local", false).option("--adapter-config <path>", "adapter JSON/JSONC file").option("--adapter-module <path>", "local programmatic adapter module").option("--allow-adapter-code", "allow loading local adapter code", false).option("-t, --target-root <path>", "runtime/project root").option("--agent <name>", "named agent from merged config").option("--all", "run for every configured agent", false).option("--profile <name>", "workspace runtime profile").action(async (options) => {
+  const normalizedOptions = normalizeRuntimeScopeOptions(options);
+  const targets = await resolveCliTargets(normalizedOptions, { preferAllProfile: true });
+  let pending = 0;
+  for (const target of targets) {
+    const state = await journalStateForTarget(target, normalizedOptions);
+    const journal = await readApplyJournal(state.installRoot, state.adapter.name, state.transport, state.state);
+    if (!journal) continue;
+    pending += 1;
+    console.log(`PENDING ${state.adapter.name}/${state.installationType} at ${state.installRoot}`);
+    console.log(`  journal: ${join41(state.installRoot, ".agentwheel", `${state.state.stateKey}.apply-journal.json`)}`);
+    console.log(`  stateKey: ${state.state.stateKey}`);
+    console.log(`  createdAt: ${journal.createdAt}`);
+    console.log(`  updatedAt: ${journal.updatedAt}`);
+    console.log(`  operations: ${journal.operations.length}, completed: ${journal.completed.length}`);
+  }
+  if (pending === 0) console.log("No pending apply journals.");
+});
+journalCommand.command("abort").description("archive pending apply journals without touching runtime files").option("--adapter <adapter>", "built-in adapter or comma-separated adapters").option("-i, --installation-type <type>", "installation type (for example local or user)").option("--user", "shortcut for --installation-type user and home-scoped state", false).option("--local", "shortcut for --installation-type local", false).option("--adapter-config <path>", "adapter JSON/JSONC file").option("--adapter-module <path>", "local programmatic adapter module").option("--allow-adapter-code", "allow loading local adapter code", false).option("-t, --target-root <path>", "runtime/project root").option("--agent <name>", "named agent from merged config").option("--all", "run for every configured agent", false).option("--profile <name>", "workspace runtime profile").action(async (options) => {
+  const normalizedOptions = normalizeRuntimeScopeOptions(options);
+  const targets = await resolveCliTargets(normalizedOptions, { preferAllProfile: true });
+  let aborted = 0;
+  for (const target of targets) {
+    const state = await journalStateForTarget(target, normalizedOptions);
+    const result = await abortApplyJournal(state.installRoot, state.adapter.name, state.transport, state.state);
+    if (!result) continue;
+    aborted += 1;
+    console.log(`Archived ${state.adapter.name}/${state.installationType} pending journal: ${result.archivePath}`);
+  }
+  if (aborted === 0) console.log("No pending apply journals.");
+});
 program.command("doctor").description("check agentwheel runtime setup and companion skill guidance").option("--adapter <adapter>", "built-in adapter").option("-i, --installation-type <type>", "installation type (for example local or user)").option("--user", "shortcut for --installation-type user and home-scoped state", false).option("--local", "shortcut for --installation-type local", false).option("-t, --target-root <path>", "runtime/project root").option("--agent <name>", "named agent from merged config").option("--adapter-config <path>", "adapter JSON/JSONC file").option("--adapter-module <path>", "local programmatic adapter module").option("--allow-adapter-code", "allow loading local adapter code", false).option("--skill <name>", "check a specific skill by name (repeatable or comma-separated)", collectSkillOption, []).option("--source <source>", "source to use in suggested install commands").option("--json", "print machine-readable doctor report", false).action(async (options) => {
   const normalizedOptions = normalizeRuntimeScopeOptions(options);
   const target = await resolveRuntimeTarget({
@@ -10206,6 +10292,14 @@ async function printStatus(target, options) {
   }
   await printPendingInstallWork(target, options);
 }
+async function journalStateForTarget(target, options) {
+  const adapterOptions = adapterOptionsForTarget(target, options);
+  const adapter = await resolveAdapterForTarget(target, adapterOptions);
+  const transport = transportForTarget(target);
+  const installationType = options.installationType ?? target.installationType ?? resolveInstallationTypeForAdapter(adapter);
+  const state = installStateForTarget(target, adapter, adapterOptions, installationType);
+  return { adapter, transport, installationType, installRoot: state.installRoot, state };
+}
 async function printPendingInstallWork(target, options) {
   let results = [];
   try {

package/package.json

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