@aiwg/cli 2026.10.3 → 2026.10.5

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

@@ -476,6 +476,45 @@ export const setupHandler = {
     description: 'CLI helper for agent-led repository policy and tracker setup',
     category: 'project',
     aliases: [],
+    async help() {
+        return {
+            exitCode: 0,
+            rawOutput: true,
+            message: `Usage: aiwg setup project [options]
+
+Options:
+  --target <dir>                  Project directory
+  --yes                           Confirm writes without prompting
+  --dry-run                       Preview the setup plan
+  --non-interactive               Disable prompts
+  --json                          Emit the plan as JSON
+  --primary <remote>              Primary repository remote
+  --issue-tracker <remote>        Internal issue tracker remote
+  --customer-issue-tracker <remote>  Customer issue tracker remote
+  --ci <remote>                   CI remote
+  --issue-provider <provider>     Internal tracker provider
+  --customer-issue-provider <provider>  Customer tracker provider
+  --delivery-mode <mode>          Delivery policy
+  --default-branch <branch>        Default branch
+  --require-ci-green <boolean>    Require passing CI
+  --auto-close-issues <boolean>   Close delivered issues
+  --issue-comment-on-cycle <boolean>  Report issue cycles
+  --force-push-policy <policy>    Force-push policy
+  --require-signed-commits <boolean>  Require signed commits
+  --committer-name <name>         Committer identity
+  --committer-email <email>       Committer email
+  --signing-format <format>       Signing format
+  --signing-key <key>             Signing key
+  --signing-enforce <commits|tags|all>  Signing enforcement
+  --tracker-actor-login <login>   Internal tracker actor
+  --tracker-actor-via <via>       Internal tracker access method
+  --customer-tracker-actor-login <login>  Customer tracker actor
+  --customer-tracker-actor-via <via>  Customer tracker access method
+  --worker-dispatch <choice>      Worker dispatch policy
+  --providers <ids>               Comma-separated provider IDs
+`,
+        };
+    },
     async execute(ctx) {
         const [subcommand] = ctx.args;
         if (subcommand && subcommand !== 'project' && !subcommand.startsWith('--')) {
@@ -560,6 +599,8 @@ export const setupHandler = {
         }
         else {
             printPlan(plan);
+            if (options.workerDispatchChoice === 'enable')
+                ui.info('Next: aiwg doctor --probe-workers --qualify.');
             if (plan.workerDispatchOffer.shouldOffer) {
                 ui.info(workerDispatchOfferHintWithArg(plan.workerDispatchOffer.detected));
             }

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

@@ -204,6 +204,7 @@ async function handleSteward(args, ctx) {
   aiwg steward — Provider capability awareness and command routing
 
   Usage:
+    aiwg steward decision-offload [--json]         Offline advisory readiness and adoption report
     aiwg steward capabilities --provider <name>   Capabilities for a specific provider
     aiwg steward capabilities --feature <name>    Provider support matrix for a feature
     aiwg steward capabilities --all               Full matrix (all providers x features)
@@ -231,6 +232,16 @@ async function handleSteward(args, ctx) {
 `);
         return;
     }
+    if (subcommand === 'decision-offload') {
+        const unknown = args.slice(1).filter(arg => arg !== '--json');
+        if (unknown.length)
+            throw new AiwgError({ code: 'ERR_USAGE_UNKNOWN_ARGUMENT',
+                message: `Unknown decision-offload argument: ${unknown[0]}`, exitCode: EXIT_CODES.USAGE });
+        const { buildDecisionOffloadSnapshot } = await import('../../decision/offload.js');
+        const decisionOffload = await buildDecisionOffloadSnapshot({ projectRoot: ctx?.cwd ?? process.cwd(), frameworkRoot: ctx?.frameworkRoot });
+        console.log(JSON.stringify(args.includes('--json') ? { decisionOffload } : decisionOffload, null, 2));
+        return;
+    }
     if (subcommand === 'permissions') {
         const operation = args[1];
         // `<namespace> --help` must reach the same usage block bare invocation prints (#2533).

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);