agentic-workflow-manager 2.0.0

package/dist/src/index.js

@@ -0,0 +1,689 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const prompts_1 = require("@clack/prompts");
+const commander_1 = require("commander");
+const config_1 = require("./utils/config");
+const grouping_1 = require("./utils/grouping");
+const registry_view_1 = require("./utils/registry-view");
+const providers_1 = require("./providers");
+const executor_1 = require("./core/executor");
+const regenerate_1 = require("./core/context/regenerate");
+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 init_1 = require("./commands/init");
+const registry_1 = require("./commands/registry");
+const pin_1 = require("./commands/pin");
+const profile_pins_1 = require("./core/profile-pins");
+const update_check_1 = require("./core/update-check");
+const program = new commander_1.Command();
+program.name('awm').description('Agentic Workflow Manager').version((0, cli_version_1.cliVersion)());
+program.hook('postAction', () => {
+    try {
+        (0, update_check_1.maybeNotifyUpdate)();
+    }
+    catch { /* el aviso nunca rompe un comando */ }
+});
+function handleCancel(value) {
+    if ((0, prompts_1.isCancel)(value)) {
+        (0, prompts_1.outro)('Operation cancelled.');
+        process.exit(0);
+    }
+}
+function resolveSelectedArtifacts(selections) {
+    const result = new Map();
+    for (const sel of selections) {
+        if (sel._group) {
+            for (const c of sel.children) {
+                for (const a of c.artifacts)
+                    result.set(a.name, a);
+            }
+        }
+        else if (sel._child) {
+            for (const a of sel.combined.artifacts) {
+                result.set(a.name, a);
+            }
+        }
+    }
+    return Array.from(result.values());
+}
+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('-s, --scope <scope>', 'Scope: local or global')
+    .option('-m, --method <method>', 'Install method: symlink or copy')
+    .option('-y, --yes', 'Skip confirmation prompts')
+    .action(async (name, options) => {
+    (0, prompts_1.intro)(picocolors_1.default.bgCyan(picocolors_1.default.black(' AWM - Agentic Workflow Manager ')));
+    // 1. Sync the registry
+    const s = (0, prompts_1.spinner)();
+    s.start('Syncing registries...');
+    const results = await (0, registries_1.syncRegistries)();
+    s.stop('Registries synced.');
+    for (const r of results) {
+        if (r.action === 'error')
+            console.warn(picocolors_1.default.yellow(`  ⚠  registry ${r.name}: ${r.error}`));
+    }
+    // 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;
+        }
+    }
+    // 2. Discover artifacts
+    const skills = (0, discovery_1.discoverSkills)();
+    const workflows = (0, discovery_1.discoverWorkflows)();
+    const agents = (0, discovery_1.discoverAgents)();
+    if (skills.length === 0 && workflows.length === 0 && agents.length === 0) {
+        (0, prompts_1.outro)(picocolors_1.default.yellow('No artifacts found in the registry. Please check your registry content.'));
+        process.exit(0);
+    }
+    const prefs = (0, config_1.getPreferences)();
+    // 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;
+    }
+    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]) => ({
+                value: key,
+                label: config.label
+            })),
+            initialValues: [prefs.defaultAgent],
+            required: true
+        });
+        handleCancel(agentChoice);
+        targetAgents = agentChoice;
+    }
+    let scopeVal;
+    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);
+        }
+        scopeVal = options.scope;
+    }
+    else {
+        const scopeChoice = await (0, prompts_1.select)({
+            message: 'Installation scope',
+            options: [
+                { value: 'local', label: 'Project (Local)' },
+                { value: 'global', label: 'Global' }
+            ],
+            initialValue: prefs.defaultScope
+        });
+        handleCancel(scopeChoice);
+        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 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).'));
+        process.exit(0);
+    }
+    // 5. Level 1 — pick package(s)
+    const pkgChoice = await (0, prompts_1.multiselect)({
+        message: 'Select package(s)',
+        options: (0, registry_view_1.buildLevel1Options)(view),
+        required: true
+    });
+    handleCancel(pkgChoice);
+    const selectedPackages = pkgChoice
+        .map(name => view.find(p => p.name === name))
+        .filter(Boolean);
+    // 5b. Level 2 — pick skills within each package, in sequence
+    const dedup = new Map();
+    for (let i = 0; i < selectedPackages.length; i++) {
+        const pkg = selectedPackages[i];
+        const skillChoice = await (0, prompts_1.multiselect)({
+            message: `[${i + 1}/${selectedPackages.length}] ${pkg.name} — select artifacts`,
+            options: (0, registry_view_1.buildLevel2Options)(pkg),
+            initialValues: [registry_view_1.ALL_SENTINEL],
+            required: true
+        });
+        handleCancel(skillChoice);
+        for (const a of (0, registry_view_1.resolveLevel2Selection)(pkg, skillChoice)) {
+            dedup.set((0, registry_view_1.artifactValue)(a), a);
+        }
+    }
+    const artifactsToInstall = Array.from(dedup.values()).map(a => ({ name: a.installName, sourcePath: a.sourcePath, type: a.type }));
+    if (artifactsToInstall.length === 0) {
+        (0, prompts_1.outro)(picocolors_1.default.yellow('No artifacts selected.'));
+        return;
+    }
+    // 6. Installation Method
+    let methodVal;
+    if (options.method) {
+        if (!['symlink', 'copy'].includes(options.method)) {
+            console.error(picocolors_1.default.red(`Invalid method "${options.method}". Use: symlink or copy.`));
+            process.exit(1);
+        }
+        methodVal = options.method;
+    }
+    else {
+        const recommendedMethod = scopeVal === 'local' ? 'copy' : 'symlink';
+        const methodChoice = await (0, prompts_1.select)({
+            message: 'Installation method',
+            options: [
+                { value: 'symlink', label: `Symlink (Updates instantly)${recommendedMethod === 'symlink' ? ' - Recommended' : ''}` },
+                { value: 'copy', label: `Copy to agent${recommendedMethod === 'copy' ? ' - Recommended for Git repos' : ''}` }
+            ],
+            initialValue: recommendedMethod
+        });
+        handleCancel(methodChoice);
+        methodVal = methodChoice;
+    }
+    // 7. Confirm (skip with --yes)
+    if (!options.yes) {
+        const agentLabels = targetAgents.join(', ');
+        const shouldProceed = await (0, prompts_1.confirm)({ message: `Install ${artifactsToInstall.length} artifact(s) to ${targetAgents.length} agent(s) (${agentLabels})?` });
+        handleCancel(shouldProceed);
+        if (!shouldProceed) {
+            (0, prompts_1.outro)('Installation cancelled.');
+            return;
+        }
+    }
+    const installSpinner = (0, prompts_1.spinner)();
+    installSpinner.start('Installing artifacts...');
+    try {
+        const installed = [];
+        const skipped = [];
+        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) {
+                    skipped.push(`${artifact.name} (${currentAgent})`);
+                    continue;
+                }
+                const targetDir = (0, providers_1.getTargetPath)(artifact.type, currentAgent, 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 });
+        installSpinner.stop('Installation complete!');
+        if (skipped.length > 0) {
+            for (const s of skipped) {
+                console.log(picocolors_1.default.yellow(`  ⚠️  Skipped: ${s} (not supported by target agent)`));
+            }
+        }
+        const names = installed.map(n => picocolors_1.default.green(n)).join('\n  ');
+        (0, prompts_1.outro)(`✅ Installed:\n  ${names}`);
+    }
+    catch (e) {
+        installSpinner.stop('Installation failed.');
+        console.error(picocolors_1.default.red(e.message));
+        process.exit(1);
+    }
+});
+program.command('update')
+    .description('Sync all configured registries with their remotes')
+    .action(async () => {
+    (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(`  ⚠  El registry ${f.name} requiere CLI ≥ ${f.min} (tenés ${(0, cli_version_1.cliVersion)()}) — corré: 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 y hooks actualizados.');
+});
+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('-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 ')));
+    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(`El registry ${f.name} requiere CLI ≥ ${f.min} (tenés ${(0, cli_version_1.cliVersion)()}).`));
+            console.error(picocolors_1.default.red('  Corré: 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(`La máquina tiene ${f.name} @ ${f.actual ? `v${f.actual}` : 'HEAD (sin tag)'} pero el proyecto requiere v${f.required}.`));
+                    console.error(picocolors_1.default.red(`  Corré: 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}`);
+});
+program.command('list [package]')
+    .description('List available artifacts. With no argument shows a package summary; pass a package name or --all for detail.')
+    .option('-a, --all', 'Expand every package')
+    .action(async (packageName, options) => {
+    (0, prompts_1.intro)(picocolors_1.default.bgCyan(picocolors_1.default.black(' AWM - Registry Listing ')));
+    const s = (0, prompts_1.spinner)();
+    s.start('Syncing registries...');
+    const listSyncResults = await (0, registries_1.syncRegistries)();
+    s.stop('Registries synced.');
+    for (const r of listSyncResults) {
+        if (r.action === 'error')
+            console.warn(picocolors_1.default.yellow(`  ⚠  registry ${r.name}: ${r.error}`));
+    }
+    const fullView = (0, registry_view_1.buildPackageView)((0, discovery_1.discoverSkills)(), (0, discovery_1.discoverWorkflows)(), (0, discovery_1.discoverAgents)(), (0, bundles_1.discoverAllBundles)());
+    const view = options.all ? fullView : fullView.filter((p) => p.visibility !== 'private');
+    if (view.length === 0) {
+        (0, prompts_1.outro)(picocolors_1.default.yellow('No artifacts found in the registry. Run `awm update` or check your registry content.'));
+        return;
+    }
+    if (packageName && options.all) {
+        console.log(picocolors_1.default.dim('(Ignoring --all when a package name is provided.)'));
+    }
+    // Detail for a single package.
+    if (packageName) {
+        const { match, suggestion } = (0, registry_view_1.findPackage)(fullView, packageName);
+        if (!match) {
+            const hint = suggestion
+                ? picocolors_1.default.dim(` Did you mean "${suggestion}"?`)
+                : picocolors_1.default.dim(' Run `awm list` to see available packages.');
+            console.error(picocolors_1.default.red(`No package named "${packageName}".`) + hint);
+            process.exit(1);
+        }
+        console.log();
+        for (const line of (0, registry_view_1.packageDetailLines)(match))
+            console.log(line);
+        console.log();
+        (0, prompts_1.outro)(`Run ${picocolors_1.default.green(`awm add`)} to install artifacts from ${picocolors_1.default.cyan(match.name)}.`);
+        return;
+    }
+    // Expand everything.
+    if (options.all) {
+        for (const pkg of view) {
+            console.log();
+            for (const line of (0, registry_view_1.packageDetailLines)(pkg))
+                console.log(line);
+        }
+        console.log();
+        (0, prompts_1.outro)(`Run ${picocolors_1.default.green('awm add')} to install any of these artifacts.`);
+        return;
+    }
+    // Default: compact summary.
+    console.log();
+    for (const line of (0, registry_view_1.packageSummaryLines)(view))
+        console.log(line);
+    console.log();
+    console.log(picocolors_1.default.dim(`  awm list <pkg>  ·  awm list --all`));
+    (0, prompts_1.outro)(`Run ${picocolors_1.default.green('awm add')} to install artifacts.`);
+});
+program.command('remove')
+    .description('Remove an installed skill or workflow')
+    .action(async () => {
+    (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;
+    const scopeChoice = await (0, prompts_1.select)({
+        message: 'Scope?',
+        options: [
+            { value: 'local', label: 'Project (Local)' },
+            { value: 'global', label: 'Global' }
+        ],
+        initialValue: prefs.defaultScope
+    });
+    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());
+    if (installed.length === 0) {
+        (0, prompts_1.outro)(picocolors_1.default.yellow('No installed artifacts found for the selected agents/scope.'));
+        process.exit(0);
+    }
+    const groupedOpts = (0, grouping_1.buildGroupedOptions)(installed, (0, bundles_1.discoverAllBundles)(), (c) => {
+        const hasSkill = c.artifacts.some(a => a.type === 'skill');
+        const hasWf = c.artifacts.some(a => a.type === 'workflow');
+        const hasAgent = c.artifacts.some(a => a.type === 'agent');
+        const icons = [hasSkill ? '🧠' : '', hasWf ? '⚡' : '', hasAgent ? '🤖' : ''].filter(Boolean).join(' ');
+        const locations = new Set();
+        for (const a of c.artifacts) {
+            for (const loc of a.installedIn)
+                locations.add(loc);
+        }
+        return `${icons} ${c.baseName} ${picocolors_1.default.dim(`(in: ${Array.from(locations).join(', ')})`)}`;
+    });
+    const toRemove = await (0, prompts_1.multiselect)({
+        message: 'Select artifact(s) to remove',
+        options: groupedOpts,
+        required: true
+    });
+    handleCancel(toRemove);
+    const resolved = resolveSelectedArtifacts(toRemove);
+    const names = resolved.map(a => picocolors_1.default.red(a.name)).join(', ');
+    const confirmRemove = await (0, prompts_1.confirm)({ message: `Remove ${names}?` });
+    handleCancel(confirmRemove);
+    if (confirmRemove) {
+        try {
+            for (const artifact of resolved) {
+                for (const p of artifact.fullPaths) {
+                    (0, executor_1.removeArtifact)(p);
+                }
+            }
+            (0, prompts_1.outro)(`✅ Removed ${resolved.map(a => picocolors_1.default.red(a.name)).join(', ')} (${scopeVal})`);
+        }
+        catch (e) {
+            console.error(picocolors_1.default.red(e.message));
+            process.exit(1);
+        }
+    }
+    else {
+        (0, prompts_1.outro)('Removal cancelled.');
+    }
+});
+function loadEnvFile(cwd) {
+    const envPath = path_1.default.join(cwd, '.env');
+    if (!fs_1.default.existsSync(envPath))
+        return {};
+    const env = {};
+    for (const line of fs_1.default.readFileSync(envPath, 'utf-8').split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const eqIdx = trimmed.indexOf('=');
+        if (eqIdx === -1)
+            continue;
+        const key = trimmed.slice(0, eqIdx).trim();
+        const value = trimmed.slice(eqIdx + 1).trim().replace(/^["']|["']$/g, '');
+        if (key)
+            env[key] = value;
+    }
+    return env;
+}
+const miroCmd = program.command('miro').description('Miro board integration');
+miroCmd.command('sync <storyMapPath>')
+    .description('Sync a story-map.md file to a Miro board frame')
+    .action(async (storyMapPath) => {
+    (0, prompts_1.intro)(picocolors_1.default.bgCyan(picocolors_1.default.black(' AWM - Miro Sync ')));
+    // 1. Load config from .env in cwd
+    const env = loadEnvFile(process.cwd());
+    const token = env['MIRO_TOKEN'];
+    const boardId = env['MIRO_BOARD_ID'];
+    if (!token || !boardId) {
+        console.error(picocolors_1.default.red('✗ Missing config. Add to .env in project root:'));
+        console.error(picocolors_1.default.dim('  MIRO_TOKEN=your_token_here'));
+        console.error(picocolors_1.default.dim('  MIRO_BOARD_ID=your_board_id_here'));
+        process.exit(1);
+    }
+    // 2. Read and parse story map
+    const resolvedPath = path_1.default.resolve(process.cwd(), storyMapPath);
+    if (!fs_1.default.existsSync(resolvedPath)) {
+        console.error(picocolors_1.default.red(`✗ File not found: ${resolvedPath}`));
+        process.exit(1);
+    }
+    const content = fs_1.default.readFileSync(resolvedPath, 'utf-8');
+    const storyMap = (0, story_map_parser_1.parseStoryMap)(content);
+    if (storyMap.activities.length === 0) {
+        console.error(picocolors_1.default.red('✗ No activities found in Backbone section. Check markdown format.'));
+        process.exit(1);
+    }
+    // 3. Sync to Miro
+    const s = (0, prompts_1.spinner)();
+    const isFirstSync = !storyMap.miro_frame_id;
+    s.start(isFirstSync ? 'Creating Miro frame...' : 'Updating Miro frame...');
+    try {
+        const result = await (0, miro_1.syncToMiro)({ token, boardId }, storyMap, storyMap.miro_frame_id);
+        // 4. Persist frame ID back to frontmatter on first sync
+        if (isFirstSync) {
+            const updated = (0, story_map_parser_1.updateMiroFrameId)(content, result.frameId);
+            fs_1.default.writeFileSync(resolvedPath, updated, 'utf-8');
+        }
+        s.stop('Sync complete!');
+        console.log(picocolors_1.default.green(`  ✓ Frame: ${result.frameId}`));
+        console.log(picocolors_1.default.green(`  ✓ Created: ${result.created} | Updated: ${result.updated} | Deleted: ${result.deleted}`));
+        (0, prompts_1.outro)('Story map synced to Miro. Open your board to view the frame.');
+    }
+    catch (e) {
+        s.stop('Sync failed.');
+        console.error(picocolors_1.default.red(`✗ ${e.message}`));
+        process.exit(1);
+    }
+});
+(0, hooks_1.registerHooksCommand)(program);
+(0, sensors_1.registerSensorsCommand)(program);
+(0, ledger_1.registerLedgerCommand)(program);
+(0, doctor_1.registerDoctorCommand)(program);
+(0, init_1.registerInitCommand)(program);
+(0, registry_1.registerRegistryCommand)(program);
+(0, pin_1.registerPinCommands)(program);
+program.parse();