mcoda 0.1.33 → 0.1.35

package/dist/bin/McodaEntrypoint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"McodaEntrypoint.d.ts","sourceRoot":"","sources":["../../src/bin/McodaEntrypoint.ts"],"names":[],"mappings":";AA+BA,qBAAa,eAAe;WACb,GAAG,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;CAkMxE"}
+{"version":3,"file":"McodaEntrypoint.d.ts","sourceRoot":"","sources":["../../src/bin/McodaEntrypoint.ts"],"names":[],"mappings":";AA+BA,qBAAa,eAAe;WACb,GAAG,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;CAuMxE"}

package/dist/bin/McodaEntrypoint.js

@@ -134,7 +134,13 @@ export class McodaEntrypoint {
             return;
         }
         if (command === "sds" || command === "mcoda:sds") {
-            await DocsCommands.run(["sds", "generate", ...rest]);
+            const [subcommand, ...tail] = rest;
+            if (subcommand === "generate" || subcommand === "suggestions") {
+                await DocsCommands.run(["sds", subcommand, ...tail]);
+            }
+            else {
+                await DocsCommands.run(["sds", "generate", ...rest]);
+            }
             return;
         }
         if (command === "create-tasks") {

package/dist/commands/agents/AgentsCommands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentsCommands.d.ts","sourceRoot":"","sources":["../../../src/commands/agents/AgentsCommands.ts"],"names":[],"mappings":"AA0WA,qBAAa,cAAc;WACZ,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAqWhD"}
+{"version":3,"file":"AgentsCommands.d.ts","sourceRoot":"","sources":["../../../src/commands/agents/AgentsCommands.ts"],"names":[],"mappings":"AAwXA,qBAAa,cAAc;WACZ,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAsWhD"}

package/dist/commands/agents/AgentsCommands.js

@@ -42,6 +42,9 @@ Usage: mcoda agent <list|details|limits|add|update|delete|remove|auth|auth-statu
 
 Subcommands:
   list                       List agents (supports --json)
+    --refresh-health         Force health checks before listing
+    --no-refresh-health      Skip health checks before listing
+                             (default: enabled for --json, disabled for table output)
   details <NAME>             Show agent details (supports --json)
   limits                     Show tracked usage-limit windows/reset times
     --agent <NAME>           Filter by agent slug/id
@@ -158,6 +161,18 @@ const parseBooleanFlag = (value, label) => {
         return false;
     throw new Error(`Invalid ${label}; expected true/false`);
 };
+const resolveListRefreshHealth = (flags) => {
+    const refreshHealth = parseBooleanFlag(flags["refresh-health"], "--refresh-health");
+    const noRefreshHealth = parseBooleanFlag(flags["no-refresh-health"], "--no-refresh-health");
+    if (refreshHealth === true && noRefreshHealth === true) {
+        throw new Error("Conflicting flags: --refresh-health and --no-refresh-health");
+    }
+    if (noRefreshHealth === true)
+        return false;
+    if (refreshHealth === true)
+        return true;
+    return Boolean(flags.json);
+};
 const parseCostPerMillion = (value) => {
     if (value === undefined)
         return undefined;
@@ -374,7 +389,8 @@ export class AgentsCommands {
         try {
             switch (subcommand) {
                 case "list": {
-                    const agents = await api.listAgents();
+                    const refreshHealth = resolveListRefreshHealth(parsed.flags);
+                    const agents = await api.listAgents({ refreshHealth });
                     if (parsed.flags.json) {
                         const detailed = await Promise.all(agents.map((agent) => api.getAgent(agent.id ?? agent.slug)));
                         // eslint-disable-next-line no-console

package/dist/commands/docs/DocsCommands.d.ts

@@ -47,8 +47,25 @@ export interface ParsedSdsArgs {
     noColor: boolean;
     noTelemetry: boolean;
 }
+export interface ParsedSdsSuggestionsArgs {
+    workspaceRoot?: string;
+    projectKey?: string;
+    sdsPath?: string;
+    reviewAgentName?: string;
+    fixAgentName?: string;
+    agentStream: boolean;
+    rateAgents: boolean;
+    maxIterations: number;
+    dryRun: boolean;
+    json: boolean;
+    quiet: boolean;
+    debug: boolean;
+    noColor: boolean;
+    noTelemetry: boolean;
+}
 export declare const parsePdrArgs: (argv: string[]) => ParsedPdrArgs;
 export declare const parseSdsArgs: (argv: string[]) => ParsedSdsArgs;
+export declare const parseSdsSuggestionsArgs: (argv: string[]) => ParsedSdsSuggestionsArgs;
 export declare class DocsCommands {
     static run(argv: string[]): Promise<void>;
 }

package/dist/commands/docs/DocsCommands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DocsCommands.d.ts","sourceRoot":"","sources":["../../../src/commands/docs/DocsCommands.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,aAAa;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;CACtB;AAUD,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,EAAE,KAAG,aA8N7C,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,EAAE,KAAG,aAoO7C,CAAC;AAoBF,qBAAa,YAAY;WACV,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CA+KhD"}
+{"version":3,"file":"DocsCommands.d.ts","sourceRoot":"","sources":["../../../src/commands/docs/DocsCommands.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,aAAa;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;CACtB;AAiBD,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,EAAE,KAAG,aA8N7C,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,EAAE,KAAG,aAoO7C,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,MAAM,MAAM,EAAE,KAAG,wBA4HxD,CAAC;AAoBF,qBAAa,YAAY;WACV,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CA0PhD"}

package/dist/commands/docs/DocsCommands.js

@@ -2,6 +2,7 @@ import path from "node:path";
 import { DocsService, WorkspaceResolver } from "@mcoda/core";
 const pdrUsage = `mcoda docs pdr generate --rfp-path <FILE> [--workspace-root <PATH>] [--project <KEY>] [--out <FILE>] [--agent <NAME>] [--agent-stream <true|false>] [--rate-agents] [--rfp-id <ID>] [--fast] [--iterate] [--quality <build-ready>] [--resolve-open-questions] [--no-placeholders] [--no-maybes] [--cross-align] [--json] [--dry-run] [--debug] [--no-color] [--quiet] [--no-telemetry]`;
 const sdsUsage = `mcoda docs sds generate [--workspace-root <PATH>] [--project <KEY>] [--out <FILE>] [--agent <NAME>] [--template <NAME>] [--agent-stream <true|false>] [--rate-agents] [--fast] [--iterate] [--quality <build-ready>] [--resolve-open-questions] [--no-placeholders] [--no-maybes] [--cross-align] [--force] [--resume <JOB_ID>] [--json] [--dry-run] [--debug] [--no-color] [--quiet] [--no-telemetry]`;
+const sdsSuggestionsUsage = `mcoda docs sds suggestions [--workspace-root <PATH>] [--project <KEY>] [--sds-path <FILE>] [--review-agent <NAME>] [--fix-agent <NAME>] [--agent-stream <true|false>] [--rate-agents] [--max-iterations <N>] [--json] [--dry-run] [--debug] [--no-color] [--quiet] [--no-telemetry]`;
 const parseBooleanFlag = (value, defaultValue) => {
     if (value === undefined)
         return defaultValue;
@@ -12,6 +13,15 @@ const parseBooleanFlag = (value, defaultValue) => {
         return true;
     return defaultValue;
 };
+const clampIterations = (value) => {
+    if (!Number.isFinite(value))
+        return 100;
+    if (value < 1)
+        return 1;
+    if (value > 100)
+        return 100;
+    return Math.floor(value);
+};
 export const parsePdrArgs = (argv) => {
     let workspaceRoot;
     let projectKey;
@@ -476,6 +486,131 @@ export const parseSdsArgs = (argv) => {
         noTelemetry,
     };
 };
+export const parseSdsSuggestionsArgs = (argv) => {
+    let workspaceRoot;
+    let projectKey;
+    let sdsPath;
+    let reviewAgentName;
+    let fixAgentName;
+    let agentStream;
+    let rateAgents = false;
+    let maxIterations = 100;
+    let dryRun = false;
+    let json = false;
+    let quiet = false;
+    let debug = false;
+    let noColor = false;
+    let noTelemetry = false;
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg.startsWith("--rate-agents=")) {
+            const [, raw] = arg.split("=", 2);
+            rateAgents = parseBooleanFlag(raw, true);
+            continue;
+        }
+        if (arg.startsWith("--max-iterations=")) {
+            const [, raw] = arg.split("=", 2);
+            const parsed = Number.parseInt(raw ?? "", 10);
+            maxIterations = clampIterations(parsed);
+            continue;
+        }
+        switch (arg) {
+            case "--workspace-root":
+                workspaceRoot = argv[i + 1] ? path.resolve(argv[i + 1]) : undefined;
+                i += 1;
+                break;
+            case "--project":
+                projectKey = argv[i + 1];
+                i += 1;
+                break;
+            case "--sds-path":
+                sdsPath = argv[i + 1];
+                i += 1;
+                break;
+            case "--agent":
+            case "--review-agent":
+                reviewAgentName = argv[i + 1];
+                i += 1;
+                break;
+            case "--fix-agent":
+                fixAgentName = argv[i + 1];
+                i += 1;
+                break;
+            case "--agent-stream": {
+                const next = argv[i + 1];
+                if (next && !next.startsWith("--")) {
+                    agentStream = parseBooleanFlag(next, true);
+                    i += 1;
+                }
+                else {
+                    agentStream = true;
+                }
+                break;
+            }
+            case "--rate-agents": {
+                const next = argv[i + 1];
+                if (next && !next.startsWith("--")) {
+                    rateAgents = parseBooleanFlag(next, true);
+                    i += 1;
+                }
+                else {
+                    rateAgents = true;
+                }
+                break;
+            }
+            case "--max-iterations": {
+                const next = argv[i + 1];
+                if (next && !next.startsWith("--")) {
+                    const parsed = Number.parseInt(next, 10);
+                    maxIterations = clampIterations(parsed);
+                    i += 1;
+                }
+                break;
+            }
+            case "--json":
+                json = true;
+                break;
+            case "--dry-run":
+                dryRun = true;
+                break;
+            case "--quiet":
+                quiet = true;
+                break;
+            case "--debug":
+                debug = true;
+                break;
+            case "--no-color":
+                noColor = true;
+                break;
+            case "--no-telemetry":
+                noTelemetry = true;
+                break;
+            case "--help":
+            case "-h":
+                // eslint-disable-next-line no-console
+                console.log(sdsSuggestionsUsage);
+                process.exit(0);
+            default:
+                break;
+        }
+    }
+    return {
+        workspaceRoot,
+        projectKey,
+        sdsPath,
+        reviewAgentName,
+        fixAgentName,
+        agentStream: agentStream ?? false,
+        rateAgents,
+        maxIterations,
+        dryRun,
+        json,
+        quiet,
+        debug,
+        noColor,
+        noTelemetry,
+    };
+};
 const printWarnings = (warnings) => {
     if (warnings.length === 0)
         return;
@@ -502,6 +637,75 @@ export class DocsCommands {
             let args = [...argv];
             if (args[0] === "sds") {
                 args = args.slice(1);
+                const subcommand = args[0];
+                if (subcommand === "suggestions") {
+                    args = args.slice(1);
+                    const parsed = parseSdsSuggestionsArgs(args);
+                    const workspace = await WorkspaceResolver.resolveWorkspace({
+                        cwd: process.cwd(),
+                        explicitWorkspace: parsed.workspaceRoot,
+                    });
+                    if (parsed.debug) {
+                        // eslint-disable-next-line no-console
+                        console.error(`[debug] workspace resolved: ${workspace.workspaceRoot}`);
+                    }
+                    service = await DocsService.create(workspace, { noTelemetry: parsed.noTelemetry });
+                    const shouldStream = parsed.agentStream && !parsed.json && !parsed.quiet;
+                    const onToken = shouldStream ? (token) => process.stdout.write(token) : undefined;
+                    const result = await service.generateSdsSuggestions({
+                        workspace,
+                        projectKey: parsed.projectKey,
+                        sdsPath: parsed.sdsPath,
+                        reviewAgentName: parsed.reviewAgentName,
+                        fixAgentName: parsed.fixAgentName,
+                        agentStream: parsed.agentStream,
+                        rateAgents: parsed.rateAgents,
+                        maxIterations: parsed.maxIterations,
+                        dryRun: parsed.dryRun,
+                        json: parsed.json,
+                        onToken,
+                    });
+                    if (parsed.json) {
+                        // eslint-disable-next-line no-console
+                        console.log(JSON.stringify({
+                            jobId: result.jobId,
+                            commandRunId: result.commandRunId,
+                            sdsPath: result.sdsPath,
+                            suggestionsDir: result.suggestionsDir,
+                            suggestionFiles: result.suggestionFiles,
+                            reviewerAgentId: result.reviewerAgentId,
+                            fixerAgentId: result.fixerAgentId,
+                            iterations: result.iterations,
+                            finalStatus: result.finalStatus,
+                            warnings: result.warnings,
+                        }, null, 2));
+                        return;
+                    }
+                    if (shouldStream) {
+                        // eslint-disable-next-line no-console
+                        console.log("\n");
+                    }
+                    // eslint-disable-next-line no-console
+                    console.log(`SDS suggestions job ${result.jobId} completed.`);
+                    // eslint-disable-next-line no-console
+                    console.log(`Final status: ${result.finalStatus}`);
+                    // eslint-disable-next-line no-console
+                    console.log(`Iterations: ${result.iterations}`);
+                    // eslint-disable-next-line no-console
+                    console.log(`SDS: ${result.sdsPath}${parsed.dryRun ? " (dry run, not modified)" : ""}`);
+                    // eslint-disable-next-line no-console
+                    console.log(`Suggestions directory: ${result.suggestionsDir}`);
+                    if (result.suggestionFiles.length > 0) {
+                        // eslint-disable-next-line no-console
+                        console.log(`Suggestions files: ${result.suggestionFiles.join(", ")}`);
+                    }
+                    printWarnings(result.warnings);
+                    if (parsed.debug) {
+                        // eslint-disable-next-line no-console
+                        console.error("[debug] Completed docs:sds suggestions");
+                    }
+                    return;
+                }
                 if (args[0] === "generate")
                     args = args.slice(1);
                 const parsed = parseSdsArgs(args);

package/dist/commands/planning/CreateTasksCommand.d.ts

@@ -13,14 +13,17 @@ interface ParsedArgs {
     qaEntryUrl?: string;
     qaStartCommand?: string;
     qaRequires?: string[];
+    sdsPreflightApplyToSds: boolean;
     sdsPreflightCommit: boolean;
     sdsPreflightCommitMessage?: string;
+    unknownEpicServicePolicy?: "auto-remediate" | "fail";
     inputs: string[];
 }
 type ProjectKeyCandidate = {
     key: string;
     mtimeMs: number;
 };
+export declare const createTasksUsage: string;
 export declare const pickCreateTasksProjectKey: (options: {
     requestedKey?: string;
     configuredKey?: string;

package/dist/commands/planning/CreateTasksCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CreateTasksCommand.d.ts","sourceRoot":"","sources":["../../../src/commands/planning/CreateTasksCommand.ts"],"names":[],"mappings":"AAKA,UAAU,UAAU;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,KAAK,mBAAmB,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AA2D5D,eAAO,MAAM,yBAAyB,GAAI,SAAS;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC,KAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAmD3C,CAAC;AAUF,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,EAAE,KAAG,UA6JrD,CAAC;AAEF,qBAAa,kBAAkB;WAChB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAqEhD"}
+{"version":3,"file":"CreateTasksCommand.d.ts","sourceRoot":"","sources":["../../../src/commands/planning/CreateTasksCommand.ts"],"names":[],"mappings":"AAKA,UAAU,UAAU;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,sBAAsB,EAAE,OAAO,CAAC;IAChC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,wBAAwB,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;IACrD,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,KAAK,mBAAmB,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5D,eAAO,MAAM,gBAAgB,QAIjB,CAAC;AAyDb,eAAO,MAAM,yBAAyB,GAAI,SAAS;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC,KAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAiD3C,CAAC;AAUF,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,EAAE,KAAG,UAkNrD,CAAC;AAEF,qBAAa,kBAAkB;WAChB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAuEhD"}

package/dist/commands/planning/CreateTasksCommand.js

@@ -2,7 +2,11 @@ import path from "node:path";
 import { promises as fs } from "node:fs";
 import { CreateTasksService, WorkspaceResolver } from "@mcoda/core";
 import { PathHelper } from "@mcoda/shared";
-const usage = `mcoda create-tasks [INPUT...] [--workspace-root <path>] [--project-key <key>] [--agent <name>] [--agent-stream [true|false]] [--rate-agents] [--force] [--max-epics N] [--max-stories-per-epic N] [--max-tasks-per-story N] [--qa-profile <csv>] [--qa-entry-url <url>] [--qa-start-command <cmd>] [--qa-requires <csv>] [--sds-preflight-commit [true|false]] [--sds-preflight-commit-message <text>] [--quiet]`;
+export const createTasksUsage = [
+    "mcoda create-tasks [INPUT...] [--workspace-root <path>] [--project-key <key>] [--agent <name>] [--agent-stream [true|false]] [--rate-agents] [--force] [--max-epics N] [--max-stories-per-epic N] [--max-tasks-per-story N] [--qa-profile <csv>] [--qa-entry-url <url>] [--qa-start-command <cmd>] [--qa-requires <csv>] [--sds-preflight-apply [true|false]] [--sds-preflight-commit [true|false]] [--sds-preflight-commit-message <text>] [--unknown-epic-service-policy <auto-remediate|fail>] [--quiet]",
+    "Default: SDS preflight runs in sidecar mode. Use --sds-preflight-apply to write remediations back to SDS sources.",
+    "Use --sds-preflight-commit only together with --sds-preflight-apply.",
+].join("\n");
 const readWorkspaceConfig = async (mcodaDir) => {
     const configPath = path.join(mcodaDir, "config.json");
     try {
@@ -85,17 +89,13 @@ export const pickCreateTasksProjectKey = (options) => {
         }
         return { projectKey: configuredKey, warnings };
     }
-    if (latestExisting) {
-        const selected = latestExisting;
-        if (!options.requestedKey && selected !== derivedKey) {
-            warnings.push(`Reusing existing project key "${selected}" from workspace task plans.`);
-        }
-        if (existing.length > 1) {
-            warnings.push(`Multiple task plan folders detected (${existing.map((item) => item.key).join(", ")}); using "${selected}".`);
-        }
-        return { projectKey: selected, warnings };
+    if (latestExisting && latestExisting !== derivedKey) {
+        warnings.push(`Existing task plans were found for "${latestExisting}", but using derived project key "${derivedKey}" to avoid accidental cross-project reuse. Pass --project-key to reuse an existing project.`);
+    }
+    if (existing.length > 1) {
+        warnings.push(`Multiple task plan folders detected (${existing.map((item) => item.key).join(", ")}); using derived project key "${derivedKey}".`);
     }
-    return { projectKey: options.requestedKey ?? derivedKey, warnings };
+    return { projectKey: derivedKey, warnings };
 };
 const parseBooleanFlag = (value, defaultValue) => {
     if (value === undefined)
@@ -123,8 +123,18 @@ export const parseCreateTasksArgs = (argv) => {
     let qaEntryUrl;
     let qaStartCommand;
     let qaRequires;
+    let sdsPreflightApplyToSds = false;
     let sdsPreflightCommit = false;
     let sdsPreflightCommitMessage;
+    let unknownEpicServicePolicy;
+    const normalizePolicy = (value) => {
+        if (!value)
+            return undefined;
+        const normalized = value.trim().toLowerCase();
+        if (normalized === "auto-remediate" || normalized === "fail")
+            return normalized;
+        return undefined;
+    };
     for (let i = 0; i < argv.length; i += 1) {
         const arg = argv[i];
         if (arg.startsWith("--")) {
@@ -138,6 +148,20 @@ export const parseCreateTasksArgs = (argv) => {
                 sdsPreflightCommit = parseBooleanFlag(raw, true);
                 continue;
             }
+            if (arg.startsWith("--sds-preflight-apply=")) {
+                const [, raw] = arg.split("=", 2);
+                sdsPreflightApplyToSds = parseBooleanFlag(raw, true);
+                continue;
+            }
+            if (arg.startsWith("--unknown-epic-service-policy=")) {
+                const [, raw] = arg.split("=", 2);
+                const normalizedPolicy = normalizePolicy(raw);
+                if (!normalizedPolicy) {
+                    throw new Error(`Invalid --unknown-epic-service-policy value: ${raw}. Expected auto-remediate or fail.`);
+                }
+                unknownEpicServicePolicy = normalizedPolicy;
+                continue;
+            }
             switch (arg) {
                 case "--workspace-root":
                     workspaceRoot = argv[i + 1] ? path.resolve(argv[i + 1]) : undefined;
@@ -227,6 +251,27 @@ export const parseCreateTasksArgs = (argv) => {
                     sdsPreflightCommitMessage = argv[i + 1];
                     i += 1;
                     break;
+                case "--sds-preflight-apply": {
+                    const next = argv[i + 1];
+                    if (next && !next.startsWith("--")) {
+                        sdsPreflightApplyToSds = parseBooleanFlag(next, true);
+                        i += 1;
+                    }
+                    else {
+                        sdsPreflightApplyToSds = true;
+                    }
+                    break;
+                }
+                case "--unknown-epic-service-policy": {
+                    const value = argv[i + 1];
+                    const normalizedPolicy = normalizePolicy(value);
+                    if (!normalizedPolicy) {
+                        throw new Error(`Invalid --unknown-epic-service-policy value: ${value ?? "(missing)"}. Expected auto-remediate or fail.`);
+                    }
+                    unknownEpicServicePolicy = normalizedPolicy;
+                    i += 1;
+                    break;
+                }
                 case "--quiet":
                     quiet = true;
                     break;
@@ -236,7 +281,7 @@ export const parseCreateTasksArgs = (argv) => {
                 case "--help":
                 case "-h":
                     // eslint-disable-next-line no-console
-                    console.log(usage);
+                    console.log(createTasksUsage);
                     process.exit(0);
                     break;
                 default:
@@ -247,6 +292,12 @@ export const parseCreateTasksArgs = (argv) => {
             inputs.push(arg);
         }
     }
+    if (sdsPreflightCommit && !sdsPreflightApplyToSds) {
+        throw new Error("--sds-preflight-commit requires --sds-preflight-apply.");
+    }
+    if (sdsPreflightCommitMessage && !sdsPreflightCommit) {
+        throw new Error("--sds-preflight-commit-message requires --sds-preflight-commit.");
+    }
     return {
         workspaceRoot,
         projectKey,
@@ -262,8 +313,10 @@ export const parseCreateTasksArgs = (argv) => {
         qaEntryUrl,
         qaStartCommand,
         qaRequires,
+        sdsPreflightApplyToSds,
         sdsPreflightCommit,
         sdsPreflightCommitMessage,
+        unknownEpicServicePolicy,
         inputs,
     };
 };
@@ -312,8 +365,10 @@ export class CreateTasksCommand {
                 qaEntryUrl: parsed.qaEntryUrl,
                 qaStartCommand: parsed.qaStartCommand,
                 qaRequires: parsed.qaRequires,
+                sdsPreflightApplyToSds: parsed.sdsPreflightApplyToSds,
                 sdsPreflightCommit: parsed.sdsPreflightCommit,
                 sdsPreflightCommitMessage: parsed.sdsPreflightCommitMessage,
+                unknownEpicServicePolicy: parsed.unknownEpicServicePolicy,
             });
             const dbPath = PathHelper.getWorkspaceDbPath(workspace.workspaceRoot);
             if (!parsed.quiet) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcoda",
-  "version": "0.1.33",
+  "version": "0.1.35",
   "description": "Local-first CLI for planning, documentation, and execution workflows with agent assistance.",
   "type": "module",
   "main": "dist/index.js",
@@ -45,12 +45,12 @@
   },
   "dependencies": {
     "yaml": "^2.4.2",
-    "@mcoda/core": "0.1.33",
-    "@mcoda/shared": "0.1.33"
+    "@mcoda/core": "0.1.35",
+    "@mcoda/shared": "0.1.35"
   },
   "devDependencies": {
-    "@mcoda/db": "0.1.33",
-    "@mcoda/integrations": "0.1.33"
+    "@mcoda/db": "0.1.35",
+    "@mcoda/integrations": "0.1.35"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",