agentic-workflow-manager 3.1.0 → 3.2.0

package/dist/src/core/skill-integrity.js

@@ -88,10 +88,11 @@ function repairGlobalSkills(skillsDir, registryContentDirs) {
  *  único agente target. Cada provider en su propio path; un dir ausente se omite. */
 function reconcileAllSkillLinks(registryContentDirs) {
     const out = [];
-    for (const agent of Object.keys(providers_1.PROVIDERS)) {
-        if (!fs_1.default.existsSync(providers_1.PROVIDERS[agent].skill.global))
+    for (const agent of providers_1.AGENT_TARGETS) {
+        const skillsDir = (0, providers_1.providerFor)(agent).skill.global;
+        if (!fs_1.default.existsSync(skillsDir))
             continue;
-        out.push({ agent, result: repairGlobalSkills(providers_1.PROVIDERS[agent].skill.global, registryContentDirs) });
+        out.push({ agent, result: repairGlobalSkills(skillsDir, registryContentDirs) });
     }
     return out;
 }

package/dist/src/index.js

@@ -13,31 +13,33 @@ const tty_1 = require("./ui/tty");
 const picker_1 = require("./ui/picker");
 const providers_1 = require("./providers");
 const executor_1 = require("./core/executor");
-const regenerate_1 = require("./core/context/regenerate");
+const provider_artifacts_1 = require("./core/provider-artifacts");
+const provider_preflight_1 = require("./ui/provider-preflight");
 const discovery_1 = require("./core/discovery");
 const bundles_1 = require("./core/bundles");
-const skill_integrity_1 = require("./core/skill-integrity");
 const registries_1 = require("./core/registries");
-const cli_version_1 = require("./core/cli-version");
-const bundle_install_1 = require("./core/bundle-install");
-const profile_1 = require("./core/profile");
 const path_1 = __importDefault(require("path"));
 const picocolors_1 = __importDefault(require("picocolors"));
 const fs_1 = __importDefault(require("fs"));
 const story_map_parser_1 = require("./core/story-map-parser");
 const miro_1 = require("./core/miro");
 const hooks_1 = require("./commands/hooks");
-const resync_1 = require("./commands/hooks/resync");
 const sensors_1 = require("./commands/sensors");
 const ledger_1 = require("./commands/ledger");
 const doctor_1 = require("./commands/doctor");
+const backup_1 = require("./commands/backup");
 const init_1 = require("./commands/init");
 const registry_1 = require("./commands/registry");
 const pin_1 = require("./commands/pin");
 const export_1 = require("./commands/export");
-const profile_pins_1 = require("./core/profile-pins");
+const agent_1 = require("./commands/agent");
+const add_1 = require("./commands/add");
+const sync_1 = require("./commands/sync");
+const update_1 = require("./commands/update");
+const agent_targets_1 = require("./core/agent-targets");
 const update_check_1 = require("./core/update-check");
 const paths_1 = require("./core/paths");
+const cli_version_1 = require("./core/cli-version");
 const program = new commander_1.Command();
 program.name('awm').description('Agentic Workflow Manager').version((0, cli_version_1.cliVersion)());
 program.hook('postAction', () => {
@@ -46,6 +48,17 @@ program.hook('postAction', () => {
     }
     catch { /* el aviso nunca rompe un comando */ }
 });
+/** Shared resolve-or-exit for the 3 index.ts call sites that need `--agent` targeting
+ *  outside an already-testable `run*Core` function (which returns `{ code: 1, ... }`
+ *  instead — see `core/agent-targets.ts`'s `resolveAgentTargetsOrError`). */
+function resolveTargetsOrExit(prefs, explicit) {
+    const resolved = (0, agent_targets_1.resolveAgentTargetsOrError)({ prefs, explicit });
+    if (!resolved.ok) {
+        console.error(picocolors_1.default.red(resolved.error));
+        process.exit(1);
+    }
+    return resolved.targets;
+}
 function handleCancel(value) {
     if ((0, prompts_1.isCancel)(value)) {
         (0, prompts_1.outro)('Operation cancelled.');
@@ -72,7 +85,7 @@ function resolveSelectedArtifacts(selections) {
 program.command('add [name]')
     .description('Add a skill, workflow, or process interactively (or non-interactively with flags)')
     .option('-t, --type <type>', 'Artifact type: skill, workflow, or process')
-    .option('-a, --agent <agent>', `Target agent: ${Object.keys(providers_1.PROVIDERS).join(', ')}`)
+    .option('-a, --agent <agent>', `Target agent: ${providers_1.AGENT_TARGETS.join(', ')}`)
     .option('-s, --scope <scope>', 'Scope: local or global')
     .option('-m, --method <method>', 'Install method: symlink or copy')
     .option('-y, --yes', 'Skip confirmation prompts')
@@ -91,65 +104,12 @@ program.command('add [name]')
     // 1b. If `name` matches a bundle, run the bundle-activation flow and exit.
     if (name) {
         const allBundles = (0, bundles_1.discoverAllBundles)();
-        const matchedBundle = allBundles.find((b) => b.name === name);
-        if (matchedBundle) {
-            const prefs = (0, config_1.getPreferences)();
-            let bundleAgents;
-            if (options.agent) {
-                const valid = Object.keys(providers_1.PROVIDERS);
-                const parsed = options.agent.split(',').map((a) => a.trim());
-                for (const a of parsed) {
-                    if (!valid.includes(a)) {
-                        console.error(picocolors_1.default.red(`Invalid agent "${a}". Use: ${valid.join(', ')}.`));
-                        process.exit(1);
-                    }
-                }
-                bundleAgents = parsed;
-            }
-            else {
-                bundleAgents = [prefs.defaultAgent];
-            }
-            let scopeOverride;
-            if (options.scope) {
-                if (!['local', 'global'].includes(options.scope)) {
-                    console.error(picocolors_1.default.red(`Invalid scope "${options.scope}". Use: local or global.`));
-                    process.exit(1);
-                }
-                scopeOverride = options.scope;
-            }
-            const effective = scopeOverride ?? (0, bundles_1.defaultScopeForBundle)(matchedBundle.scope);
-            const projectRoot = (0, profile_1.findProjectRoot)(process.cwd());
-            if (effective === 'local' && !projectRoot) {
-                console.error(picocolors_1.default.red('No project root found (need a .git/, package.json, or .awm/profile.json here). Run inside a project, or pass --global.'));
-                process.exit(1);
-            }
-            const result = (0, bundle_install_1.addBundle)({
-                bundleName: matchedBundle.name,
-                bundles: allBundles,
-                agents: bundleAgents,
-                method: 'symlink',
-                projectRoot: projectRoot ?? process.cwd(),
-                scopeOverride,
-            });
-            if (result.skipped.length > 0) {
-                for (const s of result.skipped)
-                    console.log(picocolors_1.default.yellow(`  ⚠  Skipped: ${s}`));
-            }
-            if (result.installed.length === 0) {
-                (0, prompts_1.outro)(picocolors_1.default.yellow(`Nothing installed for bundle "${matchedBundle.name}".`));
-                return;
-            }
-            const lines = result.installed.map((n) => picocolors_1.default.green(n)).join('\n  ');
-            const recordNote = result.recordedExtension
-                ? `\n\n${picocolors_1.default.dim('Recorded as a project extension in .awm/profile.json (commit it; symlinks are gitignored).')}`
-                : '';
-            (0, prompts_1.outro)(`✅ Installed bundle ${picocolors_1.default.cyan(matchedBundle.name)}:\n  ${lines}${recordNote}`);
-            return;
-        }
-        // name given but no matching bundle found — report clearly regardless of TTY
-        console.error(picocolors_1.default.red(`Bundle "${name}" not found in registry.`));
-        console.error(picocolors_1.default.dim('Run `awm list` to see available packages.'));
-        process.exit(1);
+        const prefs = (0, config_1.getPreferences)();
+        const outcome = (0, add_1.runAddBundleCore)({ name, agent: options.agent, scope: options.scope }, prefs, allBundles);
+        if (outcome.code !== 0)
+            process.exit(outcome.code);
+        (0, prompts_1.outro)('Done.');
+        return;
     }
     // 2. Discover artifacts
     const skills = (0, discovery_1.discoverSkills)();
@@ -162,21 +122,7 @@ program.command('add [name]')
     const prefs = (0, config_1.getPreferences)();
     // --all: install everything from every package headlessly
     if (options.all) {
-        let targetAgents;
-        if (options.agent) {
-            const validAgents = Object.keys(providers_1.PROVIDERS);
-            const parsed = options.agent.split(',').map((a) => a.trim());
-            for (const a of parsed) {
-                if (!validAgents.includes(a)) {
-                    console.error(picocolors_1.default.red(`Invalid agent "${a}". Use: ${validAgents.join(', ')}.`));
-                    process.exit(1);
-                }
-            }
-            targetAgents = parsed;
-        }
-        else {
-            targetAgents = [prefs.defaultAgent];
-        }
+        const targetAgents = resolveTargetsOrExit(prefs, options.agent);
         let scopeVal;
         if (options.scope) {
             if (!['local', 'global'].includes(options.scope)) {
@@ -199,8 +145,8 @@ program.command('add [name]')
         else {
             methodVal = scopeVal === 'local' ? 'copy' : 'symlink';
         }
-        const includeWorkflows = targetAgents.some((a) => providers_1.PROVIDERS[a].workflow !== null);
-        const includeAgents = targetAgents.some((a) => providers_1.PROVIDERS[a].agent !== null);
+        const includeWorkflows = targetAgents.some((a) => (0, providers_1.providerFor)(a).workflow !== null);
+        const includeAgents = targetAgents.some((a) => (0, providers_1.providerFor)(a).agent !== null);
         const allView = (0, registry_view_1.buildPackageView)(skills, includeWorkflows ? workflows : [], includeAgents ? agents : [], (0, bundles_1.discoverAllBundles)());
         const allDedup = new Map();
         for (const pkg of allView) {
@@ -217,6 +163,9 @@ program.command('add [name]')
             (0, prompts_1.outro)(picocolors_1.default.yellow('No artifacts available.'));
             return;
         }
+        const preflightOk = (0, provider_preflight_1.preflightLinkArtifactsForCli)(targetAgents.flatMap((agent) => artifactsToInstall.map((artifact) => ({ agent, artifact }))));
+        if (!preflightOk)
+            return;
         const installSpinner = (0, prompts_1.spinner)();
         installSpinner.start('Installing artifacts...');
         try {
@@ -224,17 +173,24 @@ program.command('add [name]')
             const skipped = [];
             for (const currentAgent of targetAgents) {
                 for (const artifact of artifactsToInstall) {
-                    if (providers_1.PROVIDERS[currentAgent][artifact.type] === null) {
+                    const config = (0, providers_1.assertLinkRenderer)(artifact.type, currentAgent);
+                    if (config === null) {
                         skipped.push(`${artifact.name} (${currentAgent})`);
                         continue;
                     }
-                    const targetDir = (0, providers_1.getTargetPath)(artifact.type, currentAgent, scopeVal);
+                    const targetDir = config[scopeVal];
                     const finalDest = path_1.default.join(targetDir, artifact.name);
                     (0, executor_1.installArtifact)(artifact.sourcePath, finalDest, methodVal);
                     installed.push(`${artifact.name} → ${currentAgent} (${scopeVal})`);
                 }
             }
-            (0, config_1.savePreferences)({ defaultAgent: targetAgents[0], defaultScope: scopeVal, installMethod: methodVal });
+            const updatedPrefs = targetAgents.reduce((current, agent) => (0, config_1.enableAgent)(current, agent), prefs);
+            (0, config_1.savePreferences)({
+                ...updatedPrefs,
+                defaultAgent: targetAgents[0],
+                defaultScope: scopeVal,
+                installMethod: methodVal,
+            });
             installSpinner.stop('Installation complete!');
             if (skipped.length > 0) {
                 for (const sk of skipped) {
@@ -260,24 +216,16 @@ program.command('add [name]')
     // 3. Agent & Scope Prompts (Moved up)
     let targetAgents;
     if (options.agent) {
-        const validAgents = Object.keys(providers_1.PROVIDERS);
-        const parsed = options.agent.split(',').map(a => a.trim());
-        for (const a of parsed) {
-            if (!validAgents.includes(a)) {
-                console.error(picocolors_1.default.red(`Invalid agent "${a}". Use: ${validAgents.join(', ')}.`));
-                process.exit(1);
-            }
-        }
-        targetAgents = parsed;
+        targetAgents = resolveTargetsOrExit(prefs, options.agent);
     }
     else {
         const agentChoice = await (0, prompts_1.multiselect)({
             message: 'Which agent(s) do you want to install to?',
-            options: Object.entries(providers_1.PROVIDERS).map(([key, config]) => ({
+            options: providers_1.AGENT_TARGETS.map((key) => ({
                 value: key,
-                label: config.label
+                label: (0, providers_1.providerFor)(key).label
             })),
-            initialValues: [prefs.defaultAgent],
+            initialValues: [...prefs.enabledAgents],
             required: true
         });
         handleCancel(agentChoice);
@@ -304,8 +252,8 @@ program.command('add [name]')
         scopeVal = scopeChoice;
     }
     // 4. Build the package view, filtered to artifact types the target agent(s) support
-    const includeWorkflows = targetAgents.some(a => providers_1.PROVIDERS[a].workflow !== null);
-    const includeAgents = targetAgents.some(a => providers_1.PROVIDERS[a].agent !== null);
+    const includeWorkflows = targetAgents.some(a => (0, providers_1.providerFor)(a).workflow !== null);
+    const includeAgents = targetAgents.some(a => (0, providers_1.providerFor)(a).agent !== null);
     const view = (0, registry_view_1.buildPackageView)(skills, includeWorkflows ? workflows : [], includeAgents ? agents : [], (0, bundles_1.discoverAllBundles)());
     if (view.length === 0) {
         (0, prompts_1.outro)(picocolors_1.default.yellow('No artifacts available for the selected agent(s).'));
@@ -349,6 +297,9 @@ program.command('add [name]')
         (0, prompts_1.outro)(picocolors_1.default.yellow('No artifacts selected.'));
         return;
     }
+    const preflightOk = (0, provider_preflight_1.preflightLinkArtifactsForCli)(targetAgents.flatMap((agent) => artifactsToInstall.map((artifact) => ({ agent, artifact }))));
+    if (!preflightOk)
+        return;
     // 6. Installation Method
     let methodVal;
     if (options.method) {
@@ -389,17 +340,24 @@ program.command('add [name]')
         for (const currentAgent of targetAgents) {
             for (const artifact of artifactsToInstall) {
                 // Skip artifacts not supported by this agent
-                if (providers_1.PROVIDERS[currentAgent][artifact.type] === null) {
+                const config = (0, providers_1.assertLinkRenderer)(artifact.type, currentAgent);
+                if (config === null) {
                     skipped.push(`${artifact.name} (${currentAgent})`);
                     continue;
                 }
-                const targetDir = (0, providers_1.getTargetPath)(artifact.type, currentAgent, scopeVal);
+                const targetDir = config[scopeVal];
                 const finalDest = path_1.default.join(targetDir, artifact.name);
                 (0, executor_1.installArtifact)(artifact.sourcePath, finalDest, methodVal);
                 installed.push(`${artifact.name} → ${currentAgent} (${scopeVal})`);
             }
         }
-        (0, config_1.savePreferences)({ defaultAgent: targetAgents[0], defaultScope: scopeVal, installMethod: methodVal });
+        const updatedPrefs = targetAgents.reduce((current, agent) => (0, config_1.enableAgent)(current, agent), prefs);
+        (0, config_1.savePreferences)({
+            ...updatedPrefs,
+            defaultAgent: targetAgents[0],
+            defaultScope: scopeVal,
+            installMethod: methodVal,
+        });
         installSpinner.stop('Installation complete!');
         if (skipped.length > 0) {
             for (const s of skipped) {
@@ -416,149 +374,25 @@ program.command('add [name]')
     }
 });
 program.command('update')
-    .description('Sync all configured registries with their remotes')
-    .action(async () => {
+    .description('Sync all configured registries, reconcile artifacts and re-sync hooks')
+    .option('-a, --agent <agent>', `Target agent(s), comma-separated: ${providers_1.AGENT_TARGETS.join(', ')} (defaults to every enabled agent)`)
+    .action(async (options) => {
     (0, prompts_1.intro)(picocolors_1.default.bgCyan(picocolors_1.default.black(' AWM - Update Registries ')));
-    const s = (0, prompts_1.spinner)();
-    s.start('Syncing registries...');
-    const results = await (0, registries_1.syncRegistries)();
-    s.stop('Registries synced.');
-    if (results.length === 0) {
-        console.log(picocolors_1.default.yellow('  No registries configured — run `awm init` (seeds baseline) or `awm registry add <remote>`.'));
-    }
-    for (const r of results) {
-        if (r.action === 'error') {
-            console.warn(picocolors_1.default.yellow(`  ⚠  registry ${r.name}: ${r.error}`));
-        }
-        else {
-            console.log(picocolors_1.default.green(`  ✓ Registry ${r.name} ${r.action === 'pulled' ? 'updated' : 're-cloned'} @ ${r.version}`));
-        }
-    }
-    for (const f of (0, registries_1.verifyMinCliVersions)()) {
-        console.warn(picocolors_1.default.yellow(`  ⚠  Registry ${f.name} requires CLI ≥ ${f.min} (you have ${(0, cli_version_1.cliVersion)()}) — run: npm i -g agentic-workflow-manager`));
-    }
-    try {
-        const regen = (0, regenerate_1.regenerateGlobalContext)();
-        const refreshed = regen.filter((r) => r.action === 'refreshed').map((r) => r.agent);
-        if (refreshed.length > 0)
-            console.log(picocolors_1.default.green(`  ✓ Regenerated AWM context for: ${refreshed.join(', ')}`));
-    }
-    catch { /* no aborta */ }
-    try {
-        for (const { agent, result } of (0, skill_integrity_1.reconcileAllSkillLinks)((0, registries_1.contentRoots)())) {
-            const touched = result.relinked.length + result.pruned.length;
-            if (touched > 0)
-                console.log(picocolors_1.default.green(`  ✓ Reconciled ${agent} skill links: re-linked ${result.relinked.length}, pruned ${result.pruned.length}`));
-        }
-    }
-    catch { /* no aborta */ }
-    try {
-        const hooksRoot = (0, registries_1.capabilityRoot)('hooks');
-        if (hooksRoot) {
-            for (const r of (0, resync_1.resyncInstalledHooks)(hooksRoot)) {
-                if (r.action === 'resynced')
-                    console.log(picocolors_1.default.green(`  ✓ Re-synced ${r.agent} hook scripts`));
-                else if (r.action === 'registry-missing')
-                    console.warn(picocolors_1.default.yellow(`  ⚠  ${r.agent} hook installed but registry hooks missing — run 'awm hooks install'`));
-            }
-        }
-    }
-    catch { /* no aborta */ }
-    await (0, update_check_1.offerSelfUpdate)(); // capa 2 — Task 13
-    (0, prompts_1.outro)('✅ Registries, skills and hooks updated.');
+    (0, paths_1.warnIfUnsupportedPlatform)((m) => console.warn(picocolors_1.default.yellow(`⚠ ${m}`)));
+    const result = await (0, update_1.runUpdateCore)(options);
+    (0, prompts_1.outro)(result.code === 0 ? '✅ Registries, skills and hooks updated.' : picocolors_1.default.red('Update failed — see errors above.'));
+    process.exitCode = result.code;
 });
 program.command('sync')
     .description('Rebuild local skill symlinks from .awm/profile.json (e.g. after cloning on a new machine)')
-    .option('-a, --agent <agent>', `Target agent: ${Object.keys(providers_1.PROVIDERS).join(', ')}`)
+    .option('-a, --agent <agent>', `Target agent(s), comma-separated: ${providers_1.AGENT_TARGETS.join(', ')} (defaults to every enabled agent)`)
     .option('-m, --method <method>', 'Install method: symlink or copy', 'symlink')
     .action(async (options) => {
     (0, prompts_1.intro)(picocolors_1.default.bgCyan(picocolors_1.default.black(' AWM - Sync Project Profile ')));
     (0, paths_1.warnIfUnsupportedPlatform)((m) => console.warn(picocolors_1.default.yellow(`⚠ ${m}`)));
-    const projectRoot = (0, profile_1.findProjectRoot)(process.cwd());
-    if (!projectRoot) {
-        console.error(picocolors_1.default.red('No project root found (need a .git/, package.json, or .awm/profile.json here).'));
-        process.exit(1);
-    }
-    let profile;
-    try {
-        profile = (0, profile_1.readProfile)(projectRoot);
-    }
-    catch (e) {
-        console.error(picocolors_1.default.red(e.message));
-        process.exit(1);
-    }
-    const s = (0, prompts_1.spinner)();
-    s.start('Syncing registries...');
-    const syncResults = await (0, registries_1.syncRegistries)();
-    s.stop('Registries synced.');
-    for (const r of syncResults) {
-        if (r.action === 'error')
-            console.warn(picocolors_1.default.yellow(`  ⚠  registry ${r.name}: ${r.error}`));
-    }
-    // Gate minCliVersion (WS-4): un registry puede exigir una versión mínima del CLI.
-    // Corre ANTES del gate de pins — gates de contrato primero (CONSTITUTION).
-    const cliFailures = (0, registries_1.verifyMinCliVersions)();
-    if (cliFailures.length > 0) {
-        for (const f of cliFailures) {
-            console.error(picocolors_1.default.red(`Registry ${f.name} requires CLI ≥ ${f.min} (you have ${(0, cli_version_1.cliVersion)()}).`));
-            console.error(picocolors_1.default.red('  Run: npm i -g agentic-workflow-manager'));
-        }
-        process.exit(1);
-    }
-    // Gate de versión (WS-3): el pin del profile es el lock del proyecto.
-    // Runs before the empty-extensions early-exit so pinned projects always fail fast.
-    const pins = profile.registries ?? {};
-    if (Object.keys(pins).length > 0) {
-        const failures = await (0, profile_pins_1.verifyProjectPins)(pins);
-        if (failures.length > 0) {
-            for (const f of failures) {
-                if (f.reason === 'missing-registry') {
-                    const registriesConfig = (0, registries_1.readRegistriesConfig)();
-                    const isConfigured = registriesConfig.some((r) => r.name === f.name);
-                    if (isConfigured) {
-                        console.error(picocolors_1.default.red(`The registry "${f.name}" is configured but not yet synced on this machine. Run: awm update`));
-                    }
-                    else {
-                        console.error(picocolors_1.default.red(`The registry "${f.name}" is not configured on this machine. Run: awm registry add <remote>`));
-                    }
-                }
-                else {
-                    console.error(picocolors_1.default.red(`This machine has ${f.name} @ ${f.actual ? `v${f.actual}` : 'HEAD (no tag)'} but the project requires v${f.required}.`));
-                    console.error(picocolors_1.default.red(`  Run: awm pin ${f.name} ${f.required} && awm update`));
-                }
-            }
-            process.exit(1);
-        }
-    }
-    if (profile.extensions.length === 0) {
-        (0, prompts_1.outro)(picocolors_1.default.yellow('No extensions in .awm/profile.json — nothing to sync. Use `awm add <bundle>` first.'));
-        return;
-    }
-    const prefs = (0, config_1.getPreferences)();
-    let agents;
-    if (options.agent) {
-        const valid = Object.keys(providers_1.PROVIDERS);
-        const parsed = options.agent.split(',').map((a) => a.trim());
-        for (const a of parsed) {
-            if (!valid.includes(a)) {
-                console.error(picocolors_1.default.red(`Invalid agent "${a}". Use: ${valid.join(', ')}.`));
-                process.exit(1);
-            }
-        }
-        agents = parsed;
-    }
-    else {
-        agents = [prefs.defaultAgent];
-    }
-    const method = options.method === 'copy' ? 'copy' : 'symlink';
-    const result = (0, bundle_install_1.syncProfile)({ projectRoot, bundles: (0, bundles_1.discoverAllBundles)(), agents, method });
-    if (result.skipped.length > 0) {
-        for (const sk of result.skipped)
-            console.log(picocolors_1.default.yellow(`  ⚠  Skipped: ${sk}`));
-    }
-    const lines = result.installed.map((n) => picocolors_1.default.green(n)).join('\n  ');
-    const installedNote = lines ? `\n  ${lines}` : picocolors_1.default.dim(' (all up to date)');
-    (0, prompts_1.outro)(`✅ Synced extensions [${result.extensions.join(', ')}]:${installedNote}`);
+    const { code } = await (0, sync_1.runSyncCore)(options);
+    (0, prompts_1.outro)(code === 0 ? 'Done.' : picocolors_1.default.red('Sync failed — see errors above.'));
+    process.exitCode = code;
 });
 program.command('list [package]')
     .description('List available artifacts. With no argument shows a package summary; pass a package name or --all for detail.')
@@ -621,21 +455,29 @@ program.command('list [package]')
 });
 program.command('remove')
     .description('Remove an installed skill or workflow')
-    .action(async () => {
+    .option('-a, --agent <agent>', `Target agent(s), comma-separated: ${providers_1.AGENT_TARGETS.join(', ')} (defaults to every enabled agent)`)
+    .action(async (options) => {
     (0, prompts_1.intro)(picocolors_1.default.bgCyan(picocolors_1.default.black(' AWM - Remove Artifact ')));
     const prefs = (0, config_1.getPreferences)();
-    // Multi-agent selection (matching the add command flow)
-    const agentChoice = await (0, prompts_1.multiselect)({
-        message: 'From which agent(s)?',
-        options: Object.entries(providers_1.PROVIDERS).map(([key, config]) => ({
-            value: key,
-            label: config.label
-        })),
-        initialValues: [prefs.defaultAgent],
-        required: true
-    });
-    handleCancel(agentChoice);
-    const targetAgents = agentChoice;
+    // Multi-agent selection (matching the add command flow). --agent skips
+    // the interactive prompt and resolves the same way as add/sync/update/doctor (R12/R13).
+    let targetAgents;
+    if (options.agent) {
+        targetAgents = resolveTargetsOrExit(prefs, options.agent);
+    }
+    else {
+        const agentChoice = await (0, prompts_1.multiselect)({
+            message: 'From which agent(s)?',
+            options: providers_1.AGENT_TARGETS.map((key) => ({
+                value: key,
+                label: (0, providers_1.providerFor)(key).label
+            })),
+            initialValues: [...prefs.enabledAgents],
+            required: true
+        });
+        handleCancel(agentChoice);
+        targetAgents = agentChoice;
+    }
     const scopeChoice = await (0, prompts_1.select)({
         message: 'Scope?',
         options: [
@@ -646,43 +488,7 @@ program.command('remove')
     });
     handleCancel(scopeChoice);
     const scopeVal = scopeChoice;
-    // Scan installed artifacts across all selected agents, aggregating by name
-    const artifactMap = new Map();
-    const scanDir = (dir, type, agent) => {
-        if (!fs_1.default.existsSync(dir))
-            return;
-        const entries = fs_1.default.readdirSync(dir, { withFileTypes: true });
-        for (const entry of entries) {
-            const existing = artifactMap.get(entry.name);
-            if (existing) {
-                existing.installedIn.push(agent);
-                existing.fullPaths.push(path_1.default.join(dir, entry.name));
-            }
-            else {
-                artifactMap.set(entry.name, {
-                    name: entry.name,
-                    type,
-                    installedIn: [agent],
-                    fullPaths: [path_1.default.join(dir, entry.name)]
-                });
-            }
-        }
-    };
-    for (const targetAgent of targetAgents) {
-        try {
-            scanDir((0, providers_1.getTargetPath)('skill', targetAgent, scopeVal), 'skill', targetAgent);
-        }
-        catch { /* ok */ }
-        try {
-            scanDir((0, providers_1.getTargetPath)('workflow', targetAgent, scopeVal), 'workflow', targetAgent);
-        }
-        catch { /* ok */ }
-        try {
-            scanDir((0, providers_1.getTargetPath)('agent', targetAgent, scopeVal), 'agent', targetAgent);
-        }
-        catch { /* ok */ }
-    }
-    const installed = Array.from(artifactMap.values());
+    const installed = (0, provider_artifacts_1.scanLegacyArtifacts)(targetAgents, scopeVal);
     if (installed.length === 0) {
         (0, prompts_1.outro)(picocolors_1.default.yellow('No installed artifacts found for the selected agents/scope.'));
         process.exit(0);
@@ -799,8 +605,10 @@ miroCmd.command('sync <storyMapPath>')
 (0, sensors_1.registerSensorsCommand)(program);
 (0, ledger_1.registerLedgerCommand)(program);
 (0, doctor_1.registerDoctorCommand)(program);
+(0, backup_1.registerBackupCommand)(program);
 (0, init_1.registerInitCommand)(program);
 (0, registry_1.registerRegistryCommand)(program);
 (0, pin_1.registerPinCommands)(program);
 (0, export_1.registerExportCommand)(program);
+(0, agent_1.registerAgentCommand)(program);
 program.parse();