@aiwg/cli 2026.10.3 → 2026.10.4

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

@@ -21,6 +21,8 @@ import { sessionHandler } from "./session.js";
 import { feedbackHandler } from "./feedback.js";
 import { handlerResultFromError } from "../errors.js";
 import { getProjectDir } from "../../config/aiwg-config.js";
+import { deployedSkillRoots } from "../../providers/deployed-skill-roots.js";
+import { releaseSkillOwnership } from "../../providers/skill-ownership.mjs";
 import { formatDeployedWorkspaceSignalPlan, readWorkspaceSignalPlan } from "../workspace-signals.js";
 import * as path from "node:path";
 import * as fsSync from "node:fs";
@@ -32,6 +34,9 @@ export const quickrefHandler = {
     description: 'Generate and deploy an always-visible project quickref',
     category: 'project',
     aliases: [],
+    async help() {
+        return { exitCode: 0, message: 'Usage: aiwg quickref generate|deploy --project [--provider <id>] [--dry-run]', rawOutput: true };
+    },
     async execute(ctx) {
         const action = ctx.args.find(arg => !arg.startsWith('-')) ?? 'generate';
         if (!ctx.args.includes('--project')) {
@@ -147,6 +152,11 @@ export const mcpHandler = {
     description: "AIWG MCP server commands (serve, install, add, remove, update, list, inject, info)",
     category: "mcp",
     aliases: ["mcp", "aiwg-mcp"],
+    async help() {
+        const { main } = await import("../../mcp/cli.mjs");
+        await main(["--help"]);
+        return { exitCode: 0 };
+    },
     async execute(ctx) {
         try {
             // Dynamic import to avoid loading MCP dependencies unless needed
@@ -647,7 +657,15 @@ async function removeUserScopeDeploy(args) {
                     continue;
                 }
                 try {
-                    await fs.rm(target, { recursive: true, force: true });
+                    if (type === 'skills') {
+                        const { resolveFrameworkDir } = await import('./use.js');
+                        const released = releaseSkillOwnership(target, { frameworkSlug: resolveFrameworkDir(positional) ?? positional });
+                        if (released === null)
+                            continue;
+                    }
+                    else {
+                        await fs.rm(target, { recursive: true, force: true });
+                    }
                     deletedHere++;
                     totalDeleted++;
                 }
@@ -770,6 +788,33 @@ export const removeHandler = {
                 const projectDir = getProjectDir({ cwd: ctx.cwd }, ctx.args);
                 const config = await readAiwgConfig(projectDir);
                 const entry = config?.installed?.[positionalArg];
+                if (config && entry && entry.source !== 'project-local') {
+                    const fs = await import('node:fs/promises');
+                    const { resolveFrameworkDir } = await import('./use.js');
+                    const frameworkSlug = resolveFrameworkDir(positionalArg) ?? positionalArg;
+                    const dryRun = ctx.args.includes('--dry-run');
+                    const providers = Object.keys(entry.deployedTo).filter(p => !providerParse.provider || p === providerParse.provider);
+                    if (providerParse.provider && providers.length === 0) {
+                        return { exitCode: 1, message: `Error: '${positionalArg}' is not deployed for provider '${providerParse.provider}'.` };
+                    }
+                    let released = 0;
+                    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)
+                                    released++;
+                            }
+                        }
+                        if (!dryRun && !ctx.args.includes('--keep-registry'))
+                            delete entry.deployedTo[provider];
+                    }
+                    if (!dryRun && !ctx.args.includes('--keep-registry')) {
+                        if (Object.keys(entry.deployedTo).length === 0)
+                            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 (config && entry?.source === 'project-local') {
                     const force = ctx.args.includes('--force');
                     const dryRun = ctx.args.includes('--dry-run');
@@ -1302,12 +1347,17 @@ export const indexHandler = {
     description: "Artifact index commands (build, query, deps, stats)",
     category: "index",
     aliases: [],
+    async help() {
+        const { printIndexUsage } = await import("../../artifacts/cli.js");
+        printIndexUsage();
+        return { exitCode: 0 };
+    },
     async execute(ctx) {
         try {
             const { main } = await import("../../artifacts/cli.js");
             await main(ctx.args);
             return {
-                exitCode: 0,
+                exitCode: Number(process.exitCode ?? 0),
             };
         }
         catch (error) {
@@ -1326,6 +1376,11 @@ export const corpusHandler = {
     description: "Research-corpus tools (radar-init, radar-status, radar-report)",
     category: "index",
     aliases: [],
+    async help() {
+        const { corpusMain } = await import("../../artifacts/corpus-tools/cli.js");
+        await corpusMain(["--help"]);
+        return { exitCode: 0 };
+    },
     async execute(ctx) {
         try {
             const { corpusMain } = await import("../../artifacts/corpus-tools/cli.js");

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

@@ -76,6 +76,9 @@ export const uhpHandler = {
     description: 'Inspect and smoke-test an explicitly selected experimental UHP endpoint profile',
     category: 'toolsmith',
     aliases: [],
+    async help() {
+        return { exitCode: 0, message: usage(), rawOutput: true };
+    },
     async execute(ctx) {
         try {
             return await executeUhp(ctx);