mcoda 0.1.26 → 0.1.28

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

@@ -1 +1 @@
-{"version":3,"file":"McodaEntrypoint.d.ts","sourceRoot":"","sources":["../../src/bin/McodaEntrypoint.ts"],"names":[],"mappings":";AA8BA,qBAAa,eAAe;WACb,GAAG,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;CA8LxE"}
+{"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"}

package/dist/bin/McodaEntrypoint.js

@@ -10,6 +10,7 @@ import { OpenapiCommands } from "../commands/openapi/OpenapiCommands.js";
 import { CreateTasksCommand } from "../commands/planning/CreateTasksCommand.js";
 import { RefineTasksCommand } from "../commands/planning/RefineTasksCommand.js";
 import { TaskSufficiencyAuditCommand } from "../commands/planning/TaskSufficiencyAuditCommand.js";
+import { SdsPreflightCommand } from "../commands/planning/SdsPreflightCommand.js";
 import { BacklogCommands } from "../commands/backlog/BacklogCommands.js";
 import { TaskShowCommands } from "../commands/backlog/TaskShowCommands.js";
 import { OrderTasksCommand } from "../commands/backlog/OrderTasksCommand.js";
@@ -82,7 +83,7 @@ export class McodaEntrypoint {
             return;
         }
         if (!command) {
-            throw new Error("Usage: mcoda <agent|gateway-agent|test-agent|agent-run|routing|docs|openapi|job|jobs|tokens|telemetry|create-tasks|migrate-tasks|refine-tasks|task-sufficiency-audit|order-tasks|tasks|add-tests|work-on-tasks|gateway-trio|code-review|qa-tasks|backlog|task|task-detail|estimate|update|set-workspace|project-guidance|pdr|sds> [...args]\n" +
+            throw new Error("Usage: mcoda <agent|gateway-agent|test-agent|agent-run|routing|docs|openapi|job|jobs|tokens|telemetry|create-tasks|migrate-tasks|refine-tasks|task-sufficiency-audit|sds-preflight|order-tasks|tasks|add-tests|work-on-tasks|gateway-trio|code-review|qa-tasks|backlog|task|task-detail|estimate|update|set-workspace|project-guidance|pdr|sds> [...args]\n" +
                 "Routing: use `mcoda routing defaults` to view/update workspace/global defaults, `mcoda routing preview|explain` to inspect agent selection/provenance (override → workspace_default → global_default).\n" +
                 "Aliases: `tasks order-by-deps` forwards to `order-tasks` (dependency-aware ordering), `task`/`task-detail` show a single task.\n" +
                 "Job commands (mcoda job --help for details): list|status|watch|logs|inspect|resume|cancel|tokens\n" +
@@ -152,6 +153,10 @@ export class McodaEntrypoint {
             await TaskSufficiencyAuditCommand.run(rest);
             return;
         }
+        if (command === "sds-preflight") {
+            await SdsPreflightCommand.run(rest);
+            return;
+        }
         if (command === "qa-tasks") {
             if (rest.includes("--help") || rest.includes("-h")) {
                 // eslint-disable-next-line no-console

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":"AA2TA,qBAAa,cAAc;WACZ,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAuThD"}
+{"version":3,"file":"AgentsCommands.d.ts","sourceRoot":"","sources":["../../../src/commands/agents/AgentsCommands.ts"],"names":[],"mappings":"AA6TA,qBAAa,cAAc;WACZ,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAqVhD"}

package/dist/commands/agents/AgentsCommands.js

@@ -38,11 +38,13 @@ const readSecret = async (promptText) => new Promise((resolve) => {
     });
 });
 const USAGE = `
-Usage: mcoda agent <list|details|add|update|delete|remove|auth|auth-status|set-default|use|ratings> ...
+Usage: mcoda agent <list|details|limits|add|update|delete|remove|auth|auth-status|set-default|use|ratings> ...
 
 Subcommands:
   list                       List agents (supports --json)
   details <NAME>             Show agent details (supports --json)
+  limits                     Show tracked usage-limit windows/reset times
+    --agent <NAME>           Filter by agent slug/id
   add <NAME>                 Create a global agent
     --adapter <TYPE>         Adapter slug (openai-api|zhipu-api|codex-cli|claude-cli|gemini-cli|local-model|qa-cli|ollama-remote)
     --model <MODEL>          Default model name
@@ -313,9 +315,11 @@ export class AgentsCommands {
             ? "set-default"
             : rawSubcommand === "remove"
                 ? "delete"
-                : rawSubcommand === "detail" || rawSubcommand === "show"
-                    ? "details"
-                    : rawSubcommand;
+                : rawSubcommand === "usage-limits" || rawSubcommand === "usage-limit" || rawSubcommand === "limit"
+                    ? "limits"
+                    : rawSubcommand === "detail" || rawSubcommand === "show"
+                        ? "details"
+                        : rawSubcommand;
         if (!subcommand || argv.includes("--help") || argv.includes("-h")) {
             // eslint-disable-next-line no-console
             console.log(USAGE);
@@ -441,6 +445,36 @@ export class AgentsCommands {
                     }
                     break;
                 }
+                case "limits": {
+                    const agentName = parsed.flags.agent ? String(parsed.flags.agent) : parsed.positionals[0];
+                    const limits = await api.listAgentUsageLimits(agentName);
+                    if (parsed.flags.json) {
+                        // eslint-disable-next-line no-console
+                        console.log(JSON.stringify(limits, null, 2));
+                    }
+                    else if (limits.length === 0) {
+                        // eslint-disable-next-line no-console
+                        console.log(agentName ? `No usage-limit records found for ${agentName}.` : "No usage-limit records found.");
+                    }
+                    else {
+                        const headers = ["AGENT", "SCOPE", "KEY", "WINDOW", "STATUS", "RESET", "EXACT", "OBSERVED", "SOURCE"];
+                        const maxWidths = [24, 8, 18, 10, 10, 16, 5, 16, 28];
+                        const rows = limits.map((entry) => [
+                            entry.agentSlug ?? entry.agentId,
+                            entry.limitScope,
+                            entry.limitKey,
+                            entry.windowType,
+                            entry.status,
+                            formatDate(entry.effectiveResetAt ?? entry.resetAt),
+                            entry.resetAtExact ? "yes" : "no",
+                            formatDate(entry.observedAt),
+                            entry.resetAtSource ?? entry.source ?? "-",
+                        ]);
+                        // eslint-disable-next-line no-console
+                        console.log(formatBoxTable(headers, rows, maxWidths));
+                    }
+                    break;
+                }
                 case "add": {
                     const name = parsed.positionals[0];
                     if (!name)

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

@@ -13,6 +13,8 @@ interface ParsedArgs {
     qaEntryUrl?: string;
     qaStartCommand?: string;
     qaRequires?: string[];
+    sdsPreflightCommit: boolean;
+    sdsPreflightCommitMessage?: string;
     inputs: string[];
 }
 type ProjectKeyCandidate = {

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,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,UAsIrD,CAAC;AAEF,qBAAa,kBAAkB;WAChB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAmEhD"}
+{"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"}

package/dist/commands/planning/CreateTasksCommand.js

@@ -2,7 +2,7 @@ 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>] [--quiet]`;
+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]`;
 const readWorkspaceConfig = async (mcodaDir) => {
     const configPath = path.join(mcodaDir, "config.json");
     try {
@@ -123,6 +123,8 @@ export const parseCreateTasksArgs = (argv) => {
     let qaEntryUrl;
     let qaStartCommand;
     let qaRequires;
+    let sdsPreflightCommit = false;
+    let sdsPreflightCommitMessage;
     for (let i = 0; i < argv.length; i += 1) {
         const arg = argv[i];
         if (arg.startsWith("--")) {
@@ -131,6 +133,11 @@ export const parseCreateTasksArgs = (argv) => {
                 rateAgents = parseBooleanFlag(raw, true);
                 continue;
             }
+            if (arg.startsWith("--sds-preflight-commit=")) {
+                const [, raw] = arg.split("=", 2);
+                sdsPreflightCommit = parseBooleanFlag(raw, true);
+                continue;
+            }
             switch (arg) {
                 case "--workspace-root":
                     workspaceRoot = argv[i + 1] ? path.resolve(argv[i + 1]) : undefined;
@@ -205,6 +212,21 @@ export const parseCreateTasksArgs = (argv) => {
                         : undefined;
                     i += 1;
                     break;
+                case "--sds-preflight-commit": {
+                    const next = argv[i + 1];
+                    if (next && !next.startsWith("--")) {
+                        sdsPreflightCommit = parseBooleanFlag(next, true);
+                        i += 1;
+                    }
+                    else {
+                        sdsPreflightCommit = true;
+                    }
+                    break;
+                }
+                case "--sds-preflight-commit-message":
+                    sdsPreflightCommitMessage = argv[i + 1];
+                    i += 1;
+                    break;
                 case "--quiet":
                     quiet = true;
                     break;
@@ -240,6 +262,8 @@ export const parseCreateTasksArgs = (argv) => {
         qaEntryUrl,
         qaStartCommand,
         qaRequires,
+        sdsPreflightCommit,
+        sdsPreflightCommitMessage,
         inputs,
     };
 };
@@ -288,6 +312,8 @@ export class CreateTasksCommand {
                 qaEntryUrl: parsed.qaEntryUrl,
                 qaStartCommand: parsed.qaStartCommand,
                 qaRequires: parsed.qaRequires,
+                sdsPreflightCommit: parsed.sdsPreflightCommit,
+                sdsPreflightCommitMessage: parsed.sdsPreflightCommitMessage,
             });
             const dbPath = PathHelper.getWorkspaceDbPath(workspace.workspaceRoot);
             if (!parsed.quiet) {

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

@@ -0,0 +1,16 @@
+interface ParsedSdsPreflightArgs {
+    workspaceRoot?: string;
+    projectKey?: string;
+    sdsPaths: string[];
+    apply: boolean;
+    commitAppliedChanges: boolean;
+    commitMessage?: string;
+    json: boolean;
+    quiet: boolean;
+}
+export declare const parseSdsPreflightArgs: (argv: string[]) => ParsedSdsPreflightArgs;
+export declare class SdsPreflightCommand {
+    static run(argv: string[]): Promise<void>;
+}
+export {};
+//# sourceMappingURL=SdsPreflightCommand.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SdsPreflightCommand.d.ts","sourceRoot":"","sources":["../../../src/commands/planning/SdsPreflightCommand.ts"],"names":[],"mappings":"AAGA,UAAU,sBAAsB;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,oBAAoB,EAAE,OAAO,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB;AAUD,eAAO,MAAM,qBAAqB,GAAI,MAAM,MAAM,EAAE,KAAG,sBAmEtD,CAAC;AAEF,qBAAa,mBAAmB;WACjB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAsFhD"}

package/dist/commands/planning/SdsPreflightCommand.js

@@ -0,0 +1,153 @@
+import path from "node:path";
+import { SdsPreflightService, WorkspaceResolver } from "@mcoda/core";
+const usage = "mcoda sds-preflight [--workspace-root <path>] [--project <PROJECT_KEY>] [--sds <path> ...] [--apply] [--commit] [--commit-message <text>] [--json] [--quiet]";
+const normalizeProjectKey = (workspaceRoot) => {
+    const derived = path.basename(workspaceRoot).replace(/[^a-z0-9]+/gi, "").toLowerCase();
+    return derived || "proj";
+};
+export const parseSdsPreflightArgs = (argv) => {
+    let workspaceRoot;
+    let projectKey;
+    const sdsPaths = [];
+    let apply = false;
+    let commitAppliedChanges = false;
+    let commitMessage;
+    let json = false;
+    let quiet = false;
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        switch (arg) {
+            case "--workspace-root":
+            case "--workspace":
+                workspaceRoot = argv[i + 1] ? path.resolve(argv[i + 1]) : undefined;
+                i += 1;
+                break;
+            case "--project":
+            case "--project-key":
+                projectKey = argv[i + 1];
+                i += 1;
+                break;
+            case "--sds":
+                if (argv[i + 1]) {
+                    sdsPaths.push(path.resolve(argv[i + 1]));
+                    i += 1;
+                }
+                break;
+            case "--apply":
+                apply = true;
+                break;
+            case "--commit":
+                commitAppliedChanges = true;
+                apply = true;
+                break;
+            case "--commit-message":
+                commitMessage = argv[i + 1];
+                i += 1;
+                break;
+            case "--json":
+                json = true;
+                break;
+            case "--quiet":
+                quiet = true;
+                break;
+            case "--help":
+            case "-h":
+                // eslint-disable-next-line no-console
+                console.log(usage);
+                process.exit(0);
+                break;
+            default:
+                break;
+        }
+    }
+    return {
+        workspaceRoot,
+        projectKey,
+        sdsPaths: Array.from(new Set(sdsPaths)),
+        apply,
+        commitAppliedChanges,
+        commitMessage,
+        json,
+        quiet,
+    };
+};
+export class SdsPreflightCommand {
+    static async run(argv) {
+        const parsed = parseSdsPreflightArgs(argv);
+        const workspace = await WorkspaceResolver.resolveWorkspace({
+            cwd: process.cwd(),
+            explicitWorkspace: parsed.workspaceRoot,
+        });
+        const configuredKey = typeof workspace.config?.projectKey === "string" && workspace.config.projectKey.trim().length > 0
+            ? workspace.config.projectKey
+            : undefined;
+        const projectKey = parsed.projectKey?.trim() || configuredKey || normalizeProjectKey(workspace.workspaceRoot);
+        const service = await SdsPreflightService.create(workspace);
+        try {
+            const result = await service.runPreflight({
+                workspace,
+                projectKey,
+                inputPaths: [],
+                sdsPaths: parsed.sdsPaths,
+                writeArtifacts: true,
+                applyToSds: parsed.apply,
+                commitAppliedChanges: parsed.commitAppliedChanges,
+                commitMessage: parsed.commitMessage,
+            });
+            if (parsed.json) {
+                // eslint-disable-next-line no-console
+                console.log(JSON.stringify({
+                    projectKey: result.projectKey,
+                    generatedAt: result.generatedAt,
+                    readyForPlanning: result.readyForPlanning,
+                    qualityStatus: result.qualityStatus,
+                    sourceSdsPaths: result.sourceSdsPaths,
+                    reportPath: result.reportPath,
+                    openQuestionsPath: result.openQuestionsPath,
+                    gapAddendumPath: result.gapAddendumPath,
+                    generatedDocPaths: result.generatedDocPaths,
+                    questionCount: result.questionCount,
+                    requiredQuestionCount: result.requiredQuestionCount,
+                    issueCount: result.issueCount,
+                    blockingIssueCount: result.blockingIssueCount,
+                    appliedToSds: result.appliedToSds,
+                    appliedSdsPaths: result.appliedSdsPaths,
+                    commitHash: result.commitHash,
+                    warnings: result.warnings,
+                }, null, 2));
+                return;
+            }
+            if (!parsed.quiet) {
+                const lines = [
+                    `sds-preflight project=${result.projectKey}`,
+                    `Ready for planning: ${result.readyForPlanning ? "yes" : "no"}`,
+                    `Quality status: ${result.qualityStatus}`,
+                    `SDS sources: ${result.sourceSdsPaths.length}`,
+                    `Open questions answered: ${result.questionCount} (required=${result.requiredQuestionCount})`,
+                    `Issues: ${result.issueCount} (blocking=${result.blockingIssueCount})`,
+                    `SDS apply mode: ${result.appliedToSds ? "on" : "off"}`,
+                    `SDS files updated: ${result.appliedSdsPaths.length}`,
+                    `Commit: ${result.commitHash ?? "n/a"}`,
+                    `Report: ${result.reportPath}`,
+                    `Q&A doc: ${result.openQuestionsPath}`,
+                    `Gap addendum: ${result.gapAddendumPath}`,
+                ];
+                // eslint-disable-next-line no-console
+                console.log(lines.join("\n"));
+            }
+            if (result.warnings.length > 0) {
+                // eslint-disable-next-line no-console
+                console.warn(result.warnings.map((warning) => `! ${warning}`).join("\n"));
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            // eslint-disable-next-line no-console
+            console.error(`sds-preflight failed: ${message}`);
+            process.exitCode = 1;
+        }
+        finally {
+            await service.close();
+        }
+    }
+}

package/dist/commands/planning/TaskSufficiencyAuditCommand.js

@@ -7,7 +7,7 @@ const listWorkspaceProjects = async (workspaceRoot) => {
     try {
         const rows = await repo
             .getDb()
-            .all(`SELECT key, created_at FROM projects ORDER BY created_at ASC, key ASC`);
+            .all(`SELECT key, created_at FROM projects ORDER BY datetime(created_at) DESC, key ASC`);
         return rows
             .map((row) => ({ key: String(row.key), createdAt: row.created_at ?? null }))
             .filter((row) => row.key.trim().length > 0);
@@ -24,25 +24,25 @@ export const pickTaskSufficiencyProjectKey = (options) => {
     const requestedKey = options.requestedKey?.trim() || undefined;
     const configuredKey = options.configuredKey?.trim() || undefined;
     const existing = options.existing ?? [];
-    const firstExisting = existing[0]?.key;
+    const latestExisting = existing[0]?.key;
     if (requestedKey) {
         if (configuredKey && configuredKey !== requestedKey) {
             warnings.push(`Using explicitly requested project key "${requestedKey}"; overriding configured project key "${configuredKey}".`);
         }
-        if (firstExisting && requestedKey !== firstExisting) {
-            warnings.push(`Using explicitly requested project key "${requestedKey}"; first workspace project is "${firstExisting}".`);
+        if (latestExisting && requestedKey !== latestExisting) {
+            warnings.push(`Using explicitly requested project key "${requestedKey}"; latest workspace project is "${latestExisting}".`);
         }
         return { projectKey: requestedKey, warnings };
     }
     if (configuredKey) {
-        if (firstExisting && configuredKey !== firstExisting) {
-            warnings.push(`Using configured project key "${configuredKey}" instead of first workspace project "${firstExisting}".`);
+        if (latestExisting && configuredKey !== latestExisting) {
+            warnings.push(`Using configured project key "${configuredKey}" instead of latest workspace project "${latestExisting}".`);
         }
         return { projectKey: configuredKey, warnings };
     }
-    if (firstExisting) {
-        warnings.push(`No --project provided; defaulting to first workspace project "${firstExisting}".`);
-        return { projectKey: firstExisting, warnings };
+    if (latestExisting) {
+        warnings.push(`No --project provided; defaulting to latest workspace project "${latestExisting}".`);
+        return { projectKey: latestExisting, warnings };
     }
     return { projectKey: undefined, warnings };
 };

package/dist/index.d.ts

@@ -11,6 +11,7 @@ export * from "./commands/estimate/EstimateCommands.js";
 export * from "./commands/telemetry/TelemetryCommands.js";
 export * from "./commands/planning/RefineTasksCommand.js";
 export * from "./commands/planning/TaskSufficiencyAuditCommand.js";
+export * from "./commands/planning/SdsPreflightCommand.js";
 export * from "./commands/work/WorkOnTasksCommand.js";
 export * from "./commands/work/GatewayTrioCommand.js";
 export * from "./commands/review/CodeReviewCommand.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC;AACpD,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AACtD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,uCAAuC,CAAC;AACtD,cAAc,wCAAwC,CAAC;AACvD,cAAc,yCAAyC,CAAC;AACxD,cAAc,yCAAyC,CAAC;AACxD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oDAAoD,CAAC;AACnE,cAAc,uCAAuC,CAAC;AACtD,cAAc,uCAAuC,CAAC;AACtD,cAAc,wCAAwC,CAAC;AACvD,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,uCAAuC,CAAC;AACtD,cAAc,uCAAuC,CAAC;AACtD,cAAc,gDAAgD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC;AACpD,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AACtD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,uCAAuC,CAAC;AACtD,cAAc,wCAAwC,CAAC;AACvD,cAAc,yCAAyC,CAAC;AACxD,cAAc,yCAAyC,CAAC;AACxD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oDAAoD,CAAC;AACnE,cAAc,4CAA4C,CAAC;AAC3D,cAAc,uCAAuC,CAAC;AACtD,cAAc,uCAAuC,CAAC;AACtD,cAAc,wCAAwC,CAAC;AACvD,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,uCAAuC,CAAC;AACtD,cAAc,uCAAuC,CAAC;AACtD,cAAc,gDAAgD,CAAC"}

package/dist/index.js

@@ -11,6 +11,7 @@ export * from "./commands/estimate/EstimateCommands.js";
 export * from "./commands/telemetry/TelemetryCommands.js";
 export * from "./commands/planning/RefineTasksCommand.js";
 export * from "./commands/planning/TaskSufficiencyAuditCommand.js";
+export * from "./commands/planning/SdsPreflightCommand.js";
 export * from "./commands/work/WorkOnTasksCommand.js";
 export * from "./commands/work/GatewayTrioCommand.js";
 export * from "./commands/review/CodeReviewCommand.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcoda",
-  "version": "0.1.26",
+  "version": "0.1.28",
   "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.26",
-    "@mcoda/shared": "0.1.26"
+    "@mcoda/core": "0.1.28",
+    "@mcoda/shared": "0.1.28"
   },
   "devDependencies": {
-    "@mcoda/db": "0.1.26",
-    "@mcoda/integrations": "0.1.26"
+    "@mcoda/db": "0.1.28",
+    "@mcoda/integrations": "0.1.28"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",