@aiwg/cli 2026.10.5 → 2026.10.7

package/dist/src/cli/handlers/subcommands.js

@@ -701,6 +701,33 @@ async function removeUserScopeDeploy(args) {
         message: linesOut.join('\n') + '\n',
     };
 }
+/** List only unrecorded paths; recorded decisions come from the ownership plan. */
+function previewUnrecordedSkillFiles(skillDir, owned, plan, skillRoots) {
+    // Some adapters (Hermes) put the bulk root directly inside the kernel root.
+    if (skillRoots.includes(skillDir))
+        return;
+    const recorded = new Set(plan.map(entry => entry.path));
+    const visit = (target) => {
+        if (recorded.has(path.resolve(target)))
+            return;
+        let reason = owned ? 'unrecorded operator file' : 'foreign or unverifiable ownership receipt';
+        try {
+            const stat = fsSync.lstatSync(target);
+            if (stat.isDirectory()) {
+                for (const name of fsSync.readdirSync(target).sort())
+                    visit(path.join(target, name));
+                return;
+            }
+            if (owned && stat.isSymbolicLink())
+                reason = 'symlink preserved';
+        }
+        catch {
+            reason = 'missing or unreadable path; cannot verify';
+        }
+        plan.push({ path: path.resolve(target), action: 'preserve', reason });
+    };
+    visit(skillDir);
+}
 /**
  * Remove framework handler
  *
@@ -712,6 +739,41 @@ export const removeHandler = {
     description: "Remove installed framework, plugin, or project-local bundle",
     category: "framework",
     aliases: [],
+    async help() {
+        return { exitCode: 0, rawOutput: true, message: [
+                'Usage: aiwg remove <id> [options]',
+                '',
+                'Remove an installed framework, plugin, or project-local bundle by id (for example all or sdlc).',
+                'Project scope is the default; without --provider, process all recorded provider deployments.',
+                '"all" is an installed bundle id, not a wildcard for every installed entry.',
+                'Bundled deployments release skill ownership receipts and delete only unchanged recorded files.',
+                'Project-local removal reverts deployed artifacts using recorded hashes; bundle source is preserved.',
+                '',
+                'Options:',
+                '  --dry-run          List planned removals and preserved paths with reasons; write nothing.',
+                '  --provider <p>     Select one recorded provider deployment.',
+                '  --keep-registry    Keep project installed/deployedTo records after removal. By default,',
+                '                     remove selected deployment records and drop the id when none remain.',
+                '                     Project-local partial reverts retain their registry records.',
+                '  --force            Override project-local mutation refusal or legacy plugin dependency checks;',
+                '                     does not override bundled skill hash/ownership preservation.',
+                '  --scope user       Remove the user-scope mirror using ~/.aiwg/installed.json instead.',
+                '  --user             Alias for --scope user; user mirror removal updates its own registry.',
+                '  --target <d>       Target a project directory (alias: --prefix; default: cwd).',
+                '  --help, -h         Show this help.',
+                '',
+                'Bundled skill removal preserves modified files, unrecorded operator files, foreign skills,',
+                'and symlinks inside skill directories. Project-local bundle source is never deleted.',
+                'User-scope legacy records without artifact manifests require manual file cleanup.',
+                'Unregistered ids fall back to the legacy plugin uninstaller (also supports --keep-data).',
+                '',
+                'Examples:',
+                '  aiwg remove all --dry-run',
+                '  aiwg remove sdlc --provider claude --dry-run',
+                '  aiwg remove my-bundle --keep-registry',
+                '  aiwg remove sdlc --scope user --provider codex --dry-run',
+            ].join('\n') };
+    },
     async execute(ctx) {
         // Explicit provider removal is separate from framework removal. The native
         // adapter validates receipt hashes and preserves operator modifications.
@@ -798,13 +860,29 @@ export const removeHandler = {
                         return { exitCode: 1, message: `Error: '${positionalArg}' is not deployed for provider '${providerParse.provider}'.` };
                     }
                     let released = 0;
+                    const lines = [];
                     for (const provider of providers) {
-                        for (const root of deployedSkillRoots(projectDir, provider)) {
-                            for (const name of await fs.readdir(root).catch(() => [])) {
-                                if (releaseSkillOwnership(path.join(root, name), { frameworkSlug }, { dryRun }) !== null)
+                        if (dryRun)
+                            lines.push(`  Provider ${provider}:`);
+                        const providerStart = lines.length;
+                        const skillRoots = deployedSkillRoots(projectDir, provider);
+                        for (const root of skillRoots) {
+                            for (const name of (await fs.readdir(root).catch(() => [])).sort()) {
+                                const skillDir = path.join(root, name);
+                                const plan = [];
+                                const owned = releaseSkillOwnership(skillDir, { frameworkSlug }, { dryRun, plan }) !== null;
+                                if (owned)
                                     released++;
+                                if (dryRun) {
+                                    previewUnrecordedSkillFiles(skillDir, owned, plan, skillRoots);
+                                    for (const entry of plan) {
+                                        lines.push(`    Would ${entry.action} ${path.relative(projectDir, entry.path)} — ${entry.reason}`);
+                                    }
+                                }
                             }
                         }
+                        if (dryRun && lines.length === providerStart)
+                            lines.push('    No deployed skill files found.');
                         if (!dryRun && !ctx.args.includes('--keep-registry'))
                             delete entry.deployedTo[provider];
                     }
@@ -813,7 +891,13 @@ export const removeHandler = {
                             delete config.installed[positionalArg];
                         await writeAiwgConfig(projectDir, config);
                     }
-                    return { exitCode: 0, message: `${dryRun ? 'Would release' : 'Released'} ${released} skill ownership receipt(s); operator files preserved.` };
+                    if (dryRun) {
+                        lines.push(ctx.args.includes('--keep-registry')
+                            ? '  Registry preserved (--keep-registry).'
+                            : `  Would update .aiwg/aiwg.config: release ${providers.join(', ')} deployment record(s) for '${positionalArg}'; drop the id if none remain.`);
+                    }
+                    lines.push(`${dryRun ? 'Would release' : 'Released'} ${released} skill ownership receipt(s); operator files preserved.`);
+                    return { exitCode: 0, message: lines.join('\n') };
                 }
                 if (config && entry?.source === 'project-local') {
                     const force = ctx.args.includes('--force');
@@ -1461,7 +1545,7 @@ export const featuresHandler = {
 export const showHandler = {
     id: "show",
     name: "Show",
-    description: "Print the full text of a specific AIWG skill, agent, command, or rule by name",
+    description: "Show an AIWG metadata card; --section or --body fetches content",
     category: "index",
     aliases: [],
     async execute(ctx) {
@@ -1700,17 +1784,43 @@ export const reflectionsHandler = {
 export const memoryHandler = {
     id: 'memory',
     name: 'Memory',
-    description: 'Memory subsystem storage operations (path, list, get, put, delete, append-log)',
+    description: 'Memory storage, project registry, read-only audit/cost/recommendations, and reviewed lifecycle operations',
     category: 'utility',
     aliases: [],
+    async help(ctx) {
+        if (ctx.args[0] === 'cost') {
+            const { MEMORY_COST_USAGE } = await import('../../memory/cli.js');
+            return { exitCode: 0, message: MEMORY_COST_USAGE, rawOutput: true };
+        }
+        if (ctx.args[0] === 'recommend') {
+            const { MEMORY_RECOMMEND_USAGE } = await import('../../memory/recommend-cli.js');
+            return { exitCode: 0, message: MEMORY_RECOMMEND_USAGE, rawOutput: true };
+        }
+        if (['plan', 'apply', 'verify', 'restore'].includes(ctx.args[0])) {
+            const { MEMORY_MAINTENANCE_USAGE } = await import('../../memory/maintenance-cli.js');
+            return { exitCode: 0, message: MEMORY_MAINTENANCE_USAGE, rawOutput: true };
+        }
+        const { MEMORY_AUDIT_USAGE } = await import('../../memory/cli.js');
+        return { exitCode: 0, message: MEMORY_AUDIT_USAGE, rawOutput: true };
+    },
     async execute(ctx) {
         try {
             const { main } = await import('../../memory/cli.js');
-            await main(ctx.args);
-            return { exitCode: 0 };
+            return { exitCode: (await main(ctx.args)) ?? 0 };
         }
         catch (error) {
             const result = handlerResultFromError(error);
+            if (['audit', 'cost', 'recommend', 'plan', 'apply', 'verify', 'restore'].includes(ctx.args[0])) {
+                const { isAiwgError } = await import('../errors.js');
+                const exitCode = isAiwgError(error) ? error.exitCode : 3;
+                const receipt = error && typeof error === 'object' && 'receipt' in error ? error.receipt : undefined;
+                if (ctx.args.includes('--json')) {
+                    console.log(JSON.stringify({ error: result.message, exitCode,
+                        ...(receipt !== undefined ? { receipt } : {}) }, null, 2));
+                    return { exitCode };
+                }
+                return { ...result, exitCode, message: `memory command failed: ${result.message}${receipt !== undefined ? `\n${JSON.stringify({ receipt }, null, 2)}` : ''}` };
+            }
             return { ...result, message: `memory command failed: ${result.message}` };
         }
     },