musubix2 0.5.0 → 0.5.1

package/.claude/.musubix-managed

@@ -1 +1 @@
-{"generator":"musubix2","version":"0.5.0","timestamp":"2026-07-09T07:25:14.091Z"}
+{"generator":"musubix2","version":"0.5.1","timestamp":"2026-07-09T07:56:54.900Z"}

package/dist/assets/skills-manifest.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0",
-  "generatedAt": "2026-07-09T07:25:14.122Z",
+  "generatedAt": "2026-07-09T07:56:54.927Z",
   "entries": [
     {
       "platform": "copilot",

package/dist/cli.d.ts

@@ -32,7 +32,7 @@ export interface CLICommand {
         description: string;
         default?: unknown;
     }>;
-    action: (args: Record<string, unknown>) => Promise<void>;
+    action: (args: Record<string, unknown>) => Promise<ExitCodeValue | void>;
 }
 export interface CLIConfig {
     name: string;
@@ -48,7 +48,7 @@ export declare class CLIDispatcher {
     registerBatch(commands: CLICommand[]): void;
     getCommand(name: string): CLICommand | undefined;
     listCommands(): CLICommand[];
-    dispatch(commandName: string, args?: Record<string, unknown>): Promise<void>;
+    dispatch(commandName: string, args?: Record<string, unknown>): Promise<ExitCodeValue | void>;
     getHelp(): string;
     getVersion(): string;
     /**
@@ -93,6 +93,14 @@ export declare function handleExplain(input: string | undefined): Promise<ExitCo
 export declare function handleLearn(sub: string | undefined, args: string[]): Promise<ExitCodeValue>;
 export declare function handleSynthesis(sub: string | undefined, args: string[]): Promise<ExitCodeValue>;
 export declare function handleWatch(pattern: string | undefined): Promise<ExitCodeValue>;
+/**
+ * Resolve the file/name target for a command, tolerating an optional leading
+ * verb subcommand (e.g. `design generate <file>`, `codegen generate <name>`,
+ * `requirements analyze <file>`). When the parsed subcommand is one of the
+ * known verbs, it is treated as syntactic sugar and the real target is taken
+ * from the first positional argument instead.
+ */
+export declare function resolveTarget(args: Record<string, unknown>, verbs: string[]): string | undefined;
 export declare function getDefaultCommands(): CLICommand[];
 export declare function createCLIDispatcher(): CLIDispatcher;
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/cli.js

@@ -11780,8 +11780,8 @@ __export(init_command_handler_exports, {
   InitCommandHandler: () => InitCommandHandler,
   createInitCommandHandler: () => createInitCommandHandler
 });
-import { readdirSync } from "node:fs";
-import { basename } from "node:path";
+import { mkdirSync as mkdirSync2, writeFileSync as writeFileSync2, existsSync as existsSync10 } from "node:fs";
+import { basename, join as join5 } from "node:path";
 function createInitCommandHandler() {
   const locator = new PackageRootLocator();
   const catalog = new PackageAssetCatalog(locator);
@@ -11800,7 +11800,7 @@ function createInitCommandHandler() {
   const dryRunReporter = new DryRunReporter();
   return new InitCommandHandler(detector, confirmation, planner, copilotSetup, claudeSetup, merger, writer, updateService, dryRunReporter);
 }
-var InitCommandHandler;
+var STARTER_REQUIREMENTS, InitCommandHandler;
 var init_init_command_handler = __esm({
   "dist/interface/cli/init-command-handler.js"() {
     "use strict";
@@ -11819,6 +11819,20 @@ var init_init_command_handler = __esm({
     init_workspace_writer();
     init_confirmation_resolver();
     init_dry_run_reporter();
+    STARTER_REQUIREMENTS = `# \u8981\u4EF6\u5B9A\u7FA9\u66F8
+
+> \`musubix requirements analyze storage/specs/requirements.md\` \u3067\u89E3\u6790\u3067\u304D\u307E\u3059\u3002
+> \u8981\u4EF6\u306F\u898B\u51FA\u3057\u5F62\u5F0F\u30FBID \u306F \`REQ-<3\u6587\u5B57\u30C9\u30E1\u30A4\u30F3>-<3\u6841\u9023\u756A>\` \u3067\u8A18\u8FF0\u3057\u3066\u304F\u3060\u3055\u3044\u3002
+
+## REQ-SMP-001: \u30B5\u30F3\u30D7\u30EB\u8981\u4EF6
+**\u7A2E\u5225**: UBIQUITOUS
+**\u512A\u5148\u5EA6**: P1
+**\u8981\u4EF6**:
+THE \u30B7\u30B9\u30C6\u30E0 SHALL \u30E6\u30FC\u30B6\u30FC\u306B\u30B5\u30F3\u30D7\u30EB\u6A5F\u80FD\u3092\u63D0\u4F9B\u3059\u308B\u3002
+
+**\u53D7\u5165\u57FA\u6E96**:
+- [ ] \u30B5\u30F3\u30D7\u30EB\u6A5F\u80FD\u304C\u52D5\u4F5C\u3059\u308B
+`;
     InitCommandHandler = class {
       detector;
       confirmation;
@@ -11886,22 +11900,49 @@ var init_init_command_handler = __esm({
           await this.writer.execute(copilotOps, false);
         }
         const summary = await this.writer.execute([], true);
+        const scaffolded = options.dryRun ? [] : this.scaffoldSddWorkspace(options.projectPath);
         return {
           detectedPlatforms: selection,
-          created: summary.created,
+          created: [...summary.created, ...scaffolded],
           updated: summary.updated,
           skipped: summary.skipped,
           warnings,
           durationMs: Date.now() - start
         };
       }
-      buildProjectContext(projectPath) {
-        const name = basename(projectPath);
-        let rootStructure = [];
+      /**
+       * Create the SDD directory skeleton and a parseable starter requirements
+       * document. Idempotent and non-destructive — existing files are left as-is.
+       * Returns the relative paths of files/dirs actually created.
+       */
+      scaffoldSddWorkspace(projectPath) {
+        const created = [];
         try {
-          rootStructure = readdirSync(projectPath, { withFileTypes: true }).slice(0, 20).map((d) => d.isDirectory() ? `${d.name}/` : d.name);
+          for (const dir of ["steering", "storage/specs"]) {
+            const abs = join5(projectPath, dir);
+            if (!existsSync10(abs)) {
+              mkdirSync2(abs, { recursive: true });
+              created.push(`${dir}/`);
+            }
+          }
+          const reqPath = join5(projectPath, "storage/specs/requirements.md");
+          if (!existsSync10(reqPath)) {
+            writeFileSync2(reqPath, STARTER_REQUIREMENTS, "utf-8");
+            created.push("storage/specs/requirements.md");
+          }
         } catch {
         }
+        return created;
+      }
+      buildProjectContext(projectPath) {
+        const name = basename(projectPath);
+        const rootStructure = [
+          "steering/            # \u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u30E1\u30E2\u30EA\uFF08\u6C7A\u5B9A\u524D\u306B\u53C2\u7167\uFF09",
+          "storage/specs/       # requirements / design / tasks \u4ED5\u69D8",
+          ".claude/skills/      # SDD Agent Skills",
+          "src/                 # \u5B9F\u88C5\u30B3\u30FC\u30C9",
+          "tests/               # \u30C6\u30B9\u30C8\u30B3\u30FC\u30C9"
+        ];
         return {
           projectName: name,
           packageManager: "npm",
@@ -12903,7 +12944,7 @@ __export(dist_exports16, {
 import { execFile } from "node:child_process";
 import { writeFile as writeFile3, unlink } from "node:fs/promises";
 import { tmpdir as tmpdir2 } from "node:os";
-import { join as join5 } from "node:path";
+import { join as join6 } from "node:path";
 import { promisify } from "node:util";
 import { randomBytes } from "node:crypto";
 function sanitizeName(raw) {
@@ -13106,7 +13147,7 @@ var init_dist16 = __esm({
       }
       async realSolve(smtScript) {
         const start = Date.now();
-        const tmpFile = join5(tmpdir2(), `musubix2-z3-${randomBytes(8).toString("hex")}.smt2`);
+        const tmpFile = join6(tmpdir2(), `musubix2-z3-${randomBytes(8).toString("hex")}.smt2`);
         try {
           await writeFile3(tmpFile, smtScript, "utf-8");
           const { stdout, stderr } = await execFileAsync(this.z3Path, ["-smt2", tmpFile], {
@@ -13330,7 +13371,7 @@ __export(dist_exports17, {
 import { execFile as execFile2 } from "node:child_process";
 import { writeFile as writeFile4, unlink as unlink2 } from "node:fs/promises";
 import { tmpdir as tmpdir3 } from "node:os";
-import { join as join6 } from "node:path";
+import { join as join7 } from "node:path";
 import { promisify as promisify2 } from "node:util";
 import { randomBytes as randomBytes2 } from "node:crypto";
 function createLeanIntegration() {
@@ -13454,7 +13495,7 @@ var init_dist17 = __esm({
             time: Date.now() - start
           };
         }
-        const tmpFile = join6(tmpdir3(), `musubix2-lean-${randomBytes2(8).toString("hex")}.lean`);
+        const tmpFile = join7(tmpdir3(), `musubix2-lean-${randomBytes2(8).toString("hex")}.lean`);
         try {
           await writeFile4(tmpFile, leanCode, "utf-8");
           const timeout = timeoutMs ?? this.defaultTimeoutMs;
@@ -15215,7 +15256,7 @@ init_dist5();
 init_dist6();
 init_dist();
 init_dist();
-import { readFileSync as readFileSync6, existsSync as existsSync10 } from "node:fs";
+import { readFileSync as readFileSync6, existsSync as existsSync11 } from "node:fs";
 function parseArgs(argv) {
   const command = argv[0] ?? "";
   let subcommand;
@@ -15275,7 +15316,7 @@ var COMMAND_HELP = {
     description: "\u8A2D\u8A08\u751F\u6210"
   },
   codegen: {
-    usage: "musubix codegen [options]",
+    usage: "musubix codegen [generate] <name> [--type class|interface|function|...]",
     description: "\u30B3\u30FC\u30C9\u751F\u6210"
   },
   tasks: {
@@ -15407,7 +15448,7 @@ var CLIDispatcher = class {
     if (!command) {
       throw new Error(`Unknown command: ${commandName}. Available: ${[...this.commands.keys()].join(", ")}`);
     }
-    await command.action(args);
+    return await command.action(args);
   }
   getHelp() {
     const lines = [
@@ -15445,12 +15486,12 @@ var CLIDispatcher = class {
       return ExitCode.SUCCESS;
     }
     try {
-      await this.dispatch(parsed.command, {
+      const result = await this.dispatch(parsed.command, {
         subcommand: parsed.subcommand,
         args: parsed.args,
         ...parsed.flags
       });
-      return ExitCode.SUCCESS;
+      return result ?? ExitCode.SUCCESS;
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
       console.error(message);
@@ -15552,21 +15593,21 @@ async function handleInit(targetPath = ".", name, force) {
     console.log(`  ${f}`);
   }
   try {
-    const { cpSync, existsSync: existsSync11, mkdirSync: mkdirSync2 } = await import("node:fs");
+    const { cpSync, existsSync: existsSync12, mkdirSync: mkdirSync3 } = await import("node:fs");
     const { resolve: resolve9, dirname: dirname4 } = await import("node:path");
     const { fileURLToPath: fileURLToPath2 } = await import("node:url");
     const thisDir = typeof __dirname !== "undefined" ? __dirname : dirname4(fileURLToPath2(import.meta.url));
     const pkgGithub = resolve9(thisDir, "..", ".github");
     const destGithub = resolve9(targetPath, ".github");
-    if (existsSync11(pkgGithub)) {
-      mkdirSync2(destGithub, { recursive: true });
+    if (existsSync12(pkgGithub)) {
+      mkdirSync3(destGithub, { recursive: true });
       const skillsSrc = resolve9(pkgGithub, "skills");
-      if (existsSync11(skillsSrc)) {
+      if (existsSync12(skillsSrc)) {
         cpSync(skillsSrc, resolve9(destGithub, "skills"), { recursive: true });
         console.log("  .github/skills/ (SDD skills)");
       }
       const instrSrc = resolve9(pkgGithub, "copilot-instructions.md");
-      if (existsSync11(instrSrc)) {
+      if (existsSync12(instrSrc)) {
         cpSync(instrSrc, resolve9(destGithub, "copilot-instructions.md"));
         console.log("  .github/copilot-instructions.md");
       }
@@ -15786,7 +15827,7 @@ async function handleCodegraph(sub, args) {
 }
 async function handleSecurity(filePath) {
   try {
-    if (!existsSync10(filePath)) {
+    if (!existsSync11(filePath)) {
       console.error(`\u274C File not found: ${filePath}`);
       return ExitCode.GENERAL_ERROR;
     }
@@ -15904,6 +15945,17 @@ async function handleReqValidate(filePath) {
     }
     if (requirements.length === 0) {
       console.log("No requirements found in file");
+      if (/REQ-/i.test(content)) {
+        const headingLike = /^#{1,4}\s+REQ-[A-Z]{3}-\d{3}:/m.test(content);
+        console.error('\u26A0 Found "REQ-" text but no parseable requirements. Requirements must be Markdown headings shaped like:');
+        console.error("    ## REQ-XXX-000: <title>   (XXX = 3-letter domain code)");
+        console.error("    **\u8981\u4EF6**:");
+        console.error("    THE \u30B7\u30B9\u30C6\u30E0 SHALL ...");
+        if (!headingLike) {
+          console.error('\u2139 Hint: list items (e.g. "- REQ-001: ...") and IDs without a 3-letter domain code are not recognized.');
+        }
+        return ExitCode.VALIDATION_ERROR;
+      }
     }
     return hasIssues ? ExitCode.VALIDATION_ERROR : ExitCode.SUCCESS;
   } catch (err) {
@@ -16494,7 +16546,7 @@ async function handleExplain(input) {
   const recorder = new ReasoningChainRecorder2();
   const generator = new ExplanationGenerator2();
   let code;
-  if (existsSync10(input)) {
+  if (existsSync11(input)) {
     code = readFileSync6(input, "utf-8");
   } else {
     code = input;
@@ -16622,6 +16674,29 @@ async function handleWatch(pattern) {
   });
   return ExitCode.SUCCESS;
 }
+function resolveTarget(args, verbs) {
+  const positional = args["args"] ?? [];
+  const sub = args["subcommand"];
+  const explicitFile = args["file"];
+  if (explicitFile)
+    return explicitFile;
+  if (sub && verbs.includes(sub.toLowerCase())) {
+    return positional[0];
+  }
+  return sub ?? positional[0];
+}
+async function reqAction(args) {
+  if (args["help"] === true || args["h"] === true) {
+    console.log(showHelp("requirements"));
+    return;
+  }
+  const filePath = resolveTarget(args, ["analyze", "validate"]);
+  if (!filePath) {
+    console.error("\u274C Usage: musubix requirements [analyze|validate] <file>");
+    return ExitCode.VALIDATION_ERROR;
+  }
+  return await handleReqValidate(filePath);
+}
 function getDefaultCommands() {
   return [
     {
@@ -16671,7 +16746,7 @@ function getDefaultCommands() {
           return;
         }
         const targetPath = args["subcommand"] ?? args["args"]?.[0] ?? ".";
-        await handleInit(targetPath, args["name"], args["force"] === true);
+        return await handleInit(targetPath, args["name"], args["force"] === true);
       }
     },
     {
@@ -16689,37 +16764,32 @@ function getDefaultCommands() {
           case "validate":
             if (!filePath) {
               console.error("\u274C Usage: musubix tasks validate <file>");
-              return;
+              return ExitCode.VALIDATION_ERROR;
             }
-            await handleTasksValidate(filePath);
+            return await handleTasksValidate(filePath);
             break;
           case "list":
-            await handleTasksList(filePath);
+            return await handleTasksList(filePath);
             break;
           case "stats":
-            await handleTasksStats(filePath);
+            return await handleTasksStats(filePath);
             break;
           default:
             console.log(showHelp("tasks"));
+            return;
         }
       }
     },
     {
       name: "req",
       description: "Analyze requirements (EARS validation)",
-      action: async (args) => {
-        if (args["help"] === true || args["h"] === true) {
-          console.log(showHelp("requirements"));
-          return;
-        }
-        const positionalArgs = args["args"] ?? [];
-        const filePath = args["file"] ?? args["subcommand"] ?? positionalArgs[0];
-        if (!filePath) {
-          console.error("\u274C Usage: musubix req <file>");
-          return;
-        }
-        await handleReqValidate(filePath);
-      }
+      action: reqAction
+    },
+    {
+      // Alias matching the documented `musubix requirements <analyze|validate> <file>` form.
+      name: "requirements",
+      description: "Analyze/validate requirements (EARS validation)",
+      action: reqAction
     },
     {
       name: "req:wizard",
@@ -16729,7 +16799,7 @@ function getDefaultCommands() {
           console.log(showHelp("requirements"));
           return;
         }
-        await handleReqWizard();
+        return await handleReqWizard();
       }
     },
     {
@@ -16740,7 +16810,7 @@ function getDefaultCommands() {
           console.log(showHelp("requirements"));
           return;
         }
-        await handleReqInterview(args);
+        return await handleReqInterview(args);
       }
     },
     {
@@ -16751,13 +16821,20 @@ function getDefaultCommands() {
           console.log(showHelp("design"));
           return;
         }
-        const positionalArgs = args["args"] ?? [];
-        const filePath = args["file"] ?? args["subcommand"] ?? positionalArgs[0];
+        if (args["subcommand"]?.toLowerCase() === "verify") {
+          const vf = resolveTarget(args, ["verify"]);
+          if (!vf) {
+            console.error("\u274C Usage: musubix design verify <design-file>");
+            return ExitCode.VALIDATION_ERROR;
+          }
+          return await handleDesignVerify(vf);
+        }
+        const filePath = resolveTarget(args, ["generate"]);
         if (!filePath) {
-          console.error("\u274C Usage: musubix design <requirements-file>");
-          return;
+          console.error("\u274C Usage: musubix design [generate] <requirements-file>");
+          return ExitCode.VALIDATION_ERROR;
         }
-        await handleDesignGenerate(filePath);
+        return await handleDesignGenerate(filePath);
       }
     },
     {
@@ -16772,10 +16849,10 @@ function getDefaultCommands() {
         const filePath = args["file"] ?? args["subcommand"] ?? positionalArgs[0];
         if (!filePath) {
           console.error("\u274C Usage: musubix design:c4 <file> [--level context|container|component]");
-          return;
+          return ExitCode.VALIDATION_ERROR;
         }
         const level = args["level"] ?? "context";
-        await handleDesignC4(filePath, level);
+        return await handleDesignC4(filePath, level);
       }
     },
     {
@@ -16790,9 +16867,9 @@ function getDefaultCommands() {
         const filePath = args["file"] ?? args["subcommand"] ?? positionalArgs[0];
         if (!filePath) {
           console.error("\u274C Usage: musubix design:verify <design-file>");
-          return;
+          return ExitCode.VALIDATION_ERROR;
         }
-        await handleDesignVerify(filePath);
+        return await handleDesignVerify(filePath);
       }
     },
     {
@@ -16803,14 +16880,13 @@ function getDefaultCommands() {
           console.log(showHelp("codegen"));
           return;
         }
-        const positionalArgs = args["args"] ?? [];
-        const name = args["subcommand"] ?? positionalArgs[0];
+        const name = resolveTarget(args, ["generate"]);
         if (!name) {
-          console.error("\u274C Usage: musubix codegen <name> [--type class|interface|function|...]");
-          return;
+          console.error("\u274C Usage: musubix codegen [generate] <name> [--type class|interface|function|...]");
+          return ExitCode.VALIDATION_ERROR;
         }
         const type = args["type"] ?? "class";
-        await handleCodegen(name, type);
+        return await handleCodegen(name, type);
       }
     },
     {
@@ -16825,9 +16901,9 @@ function getDefaultCommands() {
         const filePath = args["file"] ?? args["subcommand"] ?? positionalArgs[0];
         if (!filePath) {
           console.error("\u274C Usage: musubix test:gen <source-file>");
-          return;
+          return ExitCode.VALIDATION_ERROR;
         }
-        await handleTestGen(filePath);
+        return await handleTestGen(filePath);
       }
     },
     {
@@ -16840,7 +16916,7 @@ function getDefaultCommands() {
         }
         const sub = args["subcommand"];
         const positionalArgs = args["args"] ?? [];
-        await handleTrace(sub, positionalArgs);
+        return await handleTrace(sub, positionalArgs);
       }
     },
     {
@@ -16851,7 +16927,7 @@ function getDefaultCommands() {
           console.log(showHelp("trace:verify"));
           return;
         }
-        await handleTraceVerify();
+        return await handleTraceVerify();
       }
     },
     {
@@ -16864,7 +16940,7 @@ function getDefaultCommands() {
         }
         const sub = args["subcommand"];
         const positionalArgs = args["args"] ?? [];
-        await handlePolicy(sub, positionalArgs);
+        return await handlePolicy(sub, positionalArgs);
       }
     },
     {
@@ -16876,7 +16952,7 @@ function getDefaultCommands() {
           return;
         }
         const sub = args["subcommand"];
-        await handleOntology(sub);
+        return await handleOntology(sub);
       }
     },
     {
@@ -16889,7 +16965,7 @@ function getDefaultCommands() {
         }
         const sub = args["subcommand"];
         const positionalArgs = args["args"] ?? [];
-        await handleCodegraph(sub, positionalArgs);
+        return await handleCodegraph(sub, positionalArgs);
       }
     },
     {
@@ -16904,9 +16980,9 @@ function getDefaultCommands() {
         const filePath = args["subcommand"] ?? positionalArgs[0];
         if (!filePath) {
           console.error("\u274C Usage: musubix security <path>");
-          return;
+          return ExitCode.VALIDATION_ERROR;
         }
-        await handleSecurity(filePath);
+        return await handleSecurity(filePath);
       }
     },
     {
@@ -16919,7 +16995,7 @@ function getDefaultCommands() {
         }
         const sub = args["subcommand"];
         const positionalArgs = args["args"] ?? [];
-        await handleWorkflow(sub, positionalArgs);
+        return await handleWorkflow(sub, positionalArgs);
       }
     },
     {
@@ -16930,7 +17006,7 @@ function getDefaultCommands() {
           console.log(showHelp("status"));
           return;
         }
-        await handleStatus();
+        return await handleStatus();
       }
     },
     {
@@ -16943,7 +17019,7 @@ function getDefaultCommands() {
         }
         const sub = args["subcommand"];
         const positionalArgs = args["args"] ?? [];
-        await handleSkills(sub, positionalArgs);
+        return await handleSkills(sub, positionalArgs);
       }
     },
     {
@@ -16956,7 +17032,7 @@ function getDefaultCommands() {
         }
         const sub = args["subcommand"];
         const positionalArgs = args["args"] ?? [];
-        await handleKnowledge(sub, positionalArgs, args);
+        return await handleKnowledge(sub, positionalArgs, args);
       }
     },
     {
@@ -16969,7 +17045,7 @@ function getDefaultCommands() {
         }
         const sub = args["subcommand"];
         const positionalArgs = args["args"] ?? [];
-        await handleDecision(sub, positionalArgs, args);
+        return await handleDecision(sub, positionalArgs, args);
       }
     },
     {
@@ -16982,7 +17058,7 @@ function getDefaultCommands() {
         }
         const sub = args["subcommand"];
         const positionalArgs = args["args"] ?? [];
-        await handleDeepResearch(sub, positionalArgs);
+        return await handleDeepResearch(sub, positionalArgs);
       }
     },
     {
@@ -16993,7 +17069,7 @@ function getDefaultCommands() {
           console.log(showHelp("repl"));
           return;
         }
-        await handleRepl();
+        return await handleRepl();
       }
     },
     {
@@ -17006,7 +17082,7 @@ function getDefaultCommands() {
         }
         const sub = args["subcommand"];
         const positionalArgs = args["args"] ?? [];
-        await handleScaffold(sub, positionalArgs);
+        return await handleScaffold(sub, positionalArgs);
       }
     },
     {
@@ -17019,7 +17095,7 @@ function getDefaultCommands() {
         }
         const positionalArgs = args["args"] ?? [];
         const input = args["subcommand"] ?? positionalArgs[0];
-        await handleExplain(input);
+        return await handleExplain(input);
       }
     },
     {
@@ -17032,7 +17108,7 @@ function getDefaultCommands() {
         }
         const sub = args["subcommand"];
         const positionalArgs = args["args"] ?? [];
-        await handleLearn(sub, positionalArgs);
+        return await handleLearn(sub, positionalArgs);
       }
     },
     {
@@ -17045,7 +17121,7 @@ function getDefaultCommands() {
         }
         const sub = args["subcommand"];
         const positionalArgs = args["args"] ?? [];
-        await handleSynthesis(sub, positionalArgs);
+        return await handleSynthesis(sub, positionalArgs);
       }
     },
     {
@@ -17058,7 +17134,7 @@ function getDefaultCommands() {
         }
         const positionalArgs = args["args"] ?? [];
         const pattern = args["subcommand"] ?? positionalArgs[0];
-        await handleWatch(pattern);
+        return await handleWatch(pattern);
       }
     },
     // P3-07: MCP server launcher
@@ -17129,5 +17205,6 @@ export {
   handleWorkflow,
   parseArgs,
   parseTaskFile,
+  resolveTarget,
   showHelp
 };