mcoda 0.1.7 → 0.1.9

package/CHANGELOG.md

@@ -3,5 +3,8 @@
 ## Unreleased
 - Initial npm packaging scaffold for the mcoda CLI.
 
-## 0.1.7
+## 0.1.9
+- Release v0.1.9.
+
+## 0.1.8
 - Initial public release of the mcoda CLI.

package/README.md

@@ -13,6 +13,41 @@ mcoda set-workspace --workspace-root .
 mcoda docs pdr generate --workspace-root . --project WEB --rfp-path docs/rfp/web.md --agent codex
 ```
 
+## Docdex & QA
+- mcoda depends on the `docdex` CLI for doc search and context stitching.
+- Run `docdex setup` to install Playwright and at least one browser for `qa-tasks`.
+- Docdex stores state under `~/.docdex`; mcoda does not create repo-local `.docdex` folders.
+- If `~/.docdex/agents.md` exists, it is prepended to every agent run.
+
+## Workspace layout
+- `.mcoda/config.json` for defaults (docdex URL, branch metadata, telemetry preferences).
+- `.mcoda/mcoda.db` for backlog, jobs, and telemetry.
+- `.mcoda/docs/` for generated artifacts.
+
+## Common commands
+- Docs: `mcoda docs pdr generate`, `mcoda docs sds generate`
+- Specs: `mcoda openapi-from-docs`
+- Planning: `mcoda create-tasks`, `mcoda refine-tasks`, `mcoda order-tasks`
+- Execution: `mcoda work-on-tasks`, `mcoda code-review`, `mcoda qa-tasks`
+- Backlog: `mcoda backlog`, `mcoda task`
+- Jobs/telemetry: `mcoda jobs`, `mcoda tokens`, `mcoda telemetry`
+- Agents: `mcoda test-agent`, `mcoda agent-run`
+- Updates: `mcoda update --check`
+
+## Configuration
+Environment variables are optional overrides for workspace settings:
+- `MCODA_DOCDEX_URL` to point at a docdex server.
+- `MCODA_API_BASE_URL` or `MCODA_JOBS_API_URL` for job APIs.
+- `MCODA_TELEMETRY` set to `off` to disable telemetry.
+- `MCODA_STREAM_IO=1` to emit agent I/O lines to stderr.
+
+## Programmatic usage
+```ts
+import { McodaEntrypoint } from "mcoda";
+
+await McodaEntrypoint.run(["--version"]);
+```
+
 ## Documentation
 Full docs live in the repository:
 - README: https://github.com/bekirdag/mcoda

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

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

package/dist/bin/McodaEntrypoint.js

@@ -15,12 +15,14 @@ import { OrderTasksCommand } from "../commands/backlog/OrderTasksCommand.js";
 import { EstimateCommands } from "../commands/estimate/EstimateCommands.js";
 import { TelemetryCommands } from "../commands/telemetry/TelemetryCommands.js";
 import { WorkOnTasksCommand } from "../commands/work/WorkOnTasksCommand.js";
+import { GatewayTrioCommand } from "../commands/work/GatewayTrioCommand.js";
 import { CodeReviewCommand } from "../commands/review/CodeReviewCommand.js";
 import { QaTasksCommand } from "../commands/planning/QaTasksCommand.js";
 import { MigrateTasksCommand } from "../commands/planning/MigrateTasksCommand.js";
 import { UpdateCommands } from "../commands/update/UpdateCommands.js";
 import { RoutingCommands } from "../commands/routing/RoutingCommands.js";
 import { TestAgentCommand } from "../commands/agents/TestAgentCommand.js";
+import { AgentRunCommand } from "../commands/agents/AgentRunCommand.js";
 import { SetWorkspaceCommand } from "../commands/workspace/SetWorkspaceCommand.js";
 export class McodaEntrypoint {
     static async run(argv = process.argv.slice(2)) {
@@ -40,7 +42,7 @@ export class McodaEntrypoint {
             return;
         }
         if (!command) {
-            throw new Error("Usage: mcoda <agent|gateway-agent|routing|docs|openapi|job|jobs|tokens|telemetry|create-tasks|migrate-tasks|refine-tasks|order-tasks|tasks|work-on-tasks|code-review|qa-tasks|backlog|task|task-detail|estimate|update|set-workspace|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|order-tasks|tasks|work-on-tasks|gateway-trio|code-review|qa-tasks|backlog|task|task-detail|estimate|update|set-workspace|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" +
@@ -58,6 +60,10 @@ export class McodaEntrypoint {
             await TestAgentCommand.run(rest);
             return;
         }
+        if (command === "agent-run") {
+            await AgentRunCommand.run(rest);
+            return;
+        }
         if (command === "routing") {
             await RoutingCommands.run(rest);
             return;
@@ -126,6 +132,10 @@ export class McodaEntrypoint {
             await WorkOnTasksCommand.run(rest);
             return;
         }
+        if (command === "gateway-trio") {
+            await GatewayTrioCommand.run(rest);
+            return;
+        }
         if (command === "code-review") {
             await CodeReviewCommand.run(rest);
             return;

package/dist/commands/agents/AgentRunCommand.d.ts

@@ -0,0 +1,4 @@
+export declare class AgentRunCommand {
+    static run(argv: string[]): Promise<void>;
+}
+//# sourceMappingURL=AgentRunCommand.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRunCommand.d.ts","sourceRoot":"","sources":["../../../src/commands/agents/AgentRunCommand.ts"],"names":[],"mappings":"AAyDA,qBAAa,eAAe;WACb,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CA0EhD"}

package/dist/commands/agents/AgentRunCommand.js

@@ -0,0 +1,126 @@
+import fs from "node:fs/promises";
+import { AgentsApi } from "@mcoda/core";
+const USAGE = "Usage: mcoda agent-run <NAME> [--prompt \"<text>\"] [--prompt-file <PATH>] [--task-file <PATH>] [--json]";
+const parseArgs = (argv) => {
+    const flags = {};
+    const positionals = [];
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg.startsWith("--")) {
+            const key = arg.replace(/^--/, "");
+            const next = argv[i + 1];
+            if (next && !next.startsWith("--")) {
+                const existing = flags[key];
+                if (Array.isArray(existing)) {
+                    flags[key] = [...existing, next];
+                }
+                else if (typeof existing === "string") {
+                    flags[key] = [existing, next];
+                }
+                else {
+                    flags[key] = next;
+                }
+                i += 1;
+            }
+            else {
+                flags[key] = true;
+            }
+        }
+        else {
+            positionals.push(arg);
+        }
+    }
+    return { flags, positionals };
+};
+const readTaskFile = async (filePath) => {
+    const raw = await fs.readFile(filePath, "utf8");
+    return raw
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0 && !line.startsWith("#"));
+};
+const toArray = (value) => {
+    if (!value || typeof value === "boolean")
+        return [];
+    return Array.isArray(value) ? value : [value];
+};
+const readStdinIfProvided = async () => {
+    if (process.stdin.isTTY)
+        return undefined;
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    }
+    const input = Buffer.concat(chunks).toString("utf8").trim();
+    return input.length ? input : undefined;
+};
+export class AgentRunCommand {
+    static async run(argv) {
+        const parsed = parseArgs(argv);
+        const name = parsed.positionals[0];
+        if (!name || parsed.flags.help) {
+            throw new Error(USAGE);
+        }
+        const prompts = [];
+        const inlinePrompts = toArray(parsed.flags.prompt);
+        for (const prompt of inlinePrompts) {
+            const trimmed = prompt.trim();
+            if (trimmed)
+                prompts.push(trimmed);
+        }
+        const promptFiles = toArray(parsed.flags["prompt-file"]);
+        for (const filePath of promptFiles) {
+            const content = await fs.readFile(String(filePath), "utf8");
+            const trimmed = content.trim();
+            if (trimmed)
+                prompts.push(trimmed);
+        }
+        const taskFiles = toArray(parsed.flags["task-file"]);
+        for (const filePath of taskFiles) {
+            const entries = await readTaskFile(String(filePath));
+            for (const entry of entries) {
+                if (entry)
+                    prompts.push(entry);
+            }
+        }
+        if (prompts.length === 0) {
+            const stdinPrompt = await readStdinIfProvided();
+            if (stdinPrompt)
+                prompts.push(stdinPrompt);
+        }
+        if (prompts.length === 0) {
+            throw new Error("agent-run: at least one prompt is required via --prompt, --prompt-file, --task-file, or stdin");
+        }
+        const api = await AgentsApi.create();
+        try {
+            const result = await api.runAgent(name, prompts);
+            if (parsed.flags.json) {
+                // eslint-disable-next-line no-console
+                console.log(JSON.stringify({
+                    agent: result.agent,
+                    responses: result.responses.map((response, index) => ({
+                        prompt: result.prompts[index],
+                        output: response.output,
+                        adapter: response.adapter,
+                        model: response.model,
+                        metadata: response.metadata,
+                    })),
+                }, null, 2));
+            }
+            else {
+                // eslint-disable-next-line no-console
+                console.log(`Agent ${result.agent.slug} responded to ${result.responses.length} prompt(s).`);
+                result.responses.forEach((response, index) => {
+                    const label = `${response.adapter}${response.model ? `:${response.model}` : ""}`;
+                    // eslint-disable-next-line no-console
+                    console.log(`\n--- Prompt ${index + 1} ---\n${result.prompts[index]}`);
+                    // eslint-disable-next-line no-console
+                    console.log(`--- Response ${index + 1} (${label}) ---\n${response.output}`);
+                });
+            }
+        }
+        finally {
+            await api.close();
+        }
+    }
+}

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

package/dist/commands/agents/AgentsCommands.js

@@ -38,7 +38,7 @@ const readSecret = async (promptText) => new Promise((resolve) => {
     });
 });
 const USAGE = `
-Usage: mcoda agent <list|add|update|delete|remove|auth|auth-status|set-default|use> ...
+Usage: mcoda agent <list|add|update|delete|remove|auth|auth-status|set-default|use|ratings> ...
 
 Subcommands:
   list                       List agents (supports --json)
@@ -63,6 +63,9 @@ Subcommands:
   auth-status <NAME>         Show redacted auth status (supports --json)
   set-default|use <NAME>     Set workspace default agent (use --workspace to override detection)
     --workspace <PATH>       Workspace root to bind defaults
+  ratings                    Show recent rating runs
+    --agent <NAME>           Agent slug/id (required)
+    --last <N>               Number of runs (default 50)
   --json                     Emit JSON for supported commands
   --help                     Show this help
 `.trim();
@@ -170,6 +173,16 @@ const formatCost = (value) => {
         return "-";
     return Number(value).toFixed(2);
 };
+const formatNumber = (value) => {
+    if (value === undefined || value === null || Number.isNaN(value))
+        return "-";
+    return `${value}`;
+};
+const formatDuration = (value) => {
+    if (value === undefined || value === null || Number.isNaN(value))
+        return "-";
+    return `${Number(value).toFixed(1)}s`;
+};
 const formatCapabilities = (caps) => {
     const list = (caps ?? []).slice().sort();
     if (list.length === 0)
@@ -365,6 +378,43 @@ export class AgentsCommands {
                     console.log(`Default agent set to ${name} for workspace ${workspace.workspaceRoot}`);
                     break;
                 }
+                case "ratings": {
+                    const agentName = parsed.flags.agent ? String(parsed.flags.agent) : parsed.positionals[0];
+                    if (!agentName)
+                        throw new Error("Usage: mcoda agent ratings --agent <NAME> [--last <N>] [--json]");
+                    const lastRaw = parsed.flags.last ?? parsed.flags.limit;
+                    const last = lastRaw !== undefined ? Number.parseInt(String(lastRaw), 10) : 50;
+                    if (Number.isNaN(last) || last <= 0) {
+                        throw new Error("Invalid --last; expected a positive number");
+                    }
+                    const ratings = await api.listAgentRunRatings(agentName, last);
+                    if (parsed.flags.json) {
+                        // eslint-disable-next-line no-console
+                        console.log(JSON.stringify(ratings, null, 2));
+                    }
+                    else if (ratings.length === 0) {
+                        // eslint-disable-next-line no-console
+                        console.log(`No ratings found for ${agentName}.`);
+                    }
+                    else {
+                        const headers = ["CREATED", "COMMAND", "TASK", "SCORE", "QUALITY", "TOKENS", "DURATION", "ITER", "COST"];
+                        const maxWidths = [16, 18, 24, 6, 7, 8, 9, 6, 8];
+                        const rows = ratings.map((row) => [
+                            formatDate(row.createdAt),
+                            row.commandName ?? "-",
+                            row.taskKey ?? row.taskId ?? "-",
+                            formatNumber(row.runScore),
+                            formatNumber(row.qualityScore),
+                            formatNumber(row.tokensTotal),
+                            formatDuration(row.durationSeconds),
+                            formatNumber(row.iterations),
+                            formatCost(row.totalCost ?? undefined),
+                        ]);
+                        // eslint-disable-next-line no-console
+                        console.log(formatBoxTable(headers, rows, maxWidths));
+                    }
+                    break;
+                }
                 default:
                     throw new Error(`Unknown agent subcommand: ${subcommand}`);
             }

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

@@ -1 +1 @@
-{"version":3,"file":"GatewayAgentCommand.d.ts","sourceRoot":"","sources":["../../../src/commands/agents/GatewayAgentCommand.ts"],"names":[],"mappings":"AA6ZA,qBAAa,mBAAmB;WACjB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CA8MhD"}
+{"version":3,"file":"GatewayAgentCommand.d.ts","sourceRoot":"","sources":["../../../src/commands/agents/GatewayAgentCommand.ts"],"names":[],"mappings":"AA+WA,qBAAa,mBAAmB;WACjB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAoMhD"}

package/dist/commands/agents/GatewayAgentCommand.js

@@ -1,6 +1,6 @@
 import fs from "node:fs/promises";
 import path from "node:path";
-import { GatewayAgentService, WorkspaceResolver, } from "@mcoda/core";
+import { GatewayAgentService, buildGatewayHandoffContent, withGatewayHandoff, writeGatewayHandoffFile, WorkspaceResolver, } from "@mcoda/core";
 import { canonicalizeCommandName } from "@mcoda/shared";
 import { CreateTasksCommand } from "../planning/CreateTasksCommand.js";
 import { RefineTasksCommand } from "../planning/RefineTasksCommand.js";
@@ -18,10 +18,10 @@ const usage = `mcoda gateway-agent <job> \\
   [--gateway-agent <NAME>] \\
   [--max-docs <N>] \\
   [--agent-stream <true|false>] \\
+  [--rate-agents] \\
   [--no-offload] \\
   [--json] \\
   [--] [job args...]`;
-const HANDOFF_ENV_PATH = "MCODA_GATEWAY_HANDOFF_PATH";
 const DOC_ONLY_JOBS = new Set(["sds", "openapi-from-docs"]);
 const parseBooleanFlag = (value, defaultValue) => {
     if (value === undefined)
@@ -40,71 +40,6 @@ const isIoEnabled = () => {
     const normalized = raw.trim().toLowerCase();
     return !["0", "false", "off", "no"].includes(normalized);
 };
-const buildHandoffContent = (result) => {
-    const lines = [];
-    lines.push(`# Gateway Handoff`);
-    lines.push("");
-    lines.push(`Job: ${result.job}`);
-    lines.push(`Gateway agent: ${result.gatewayAgent.slug}`);
-    lines.push(`Chosen agent: ${result.chosenAgent.agentSlug}`);
-    lines.push("");
-    if (result.analysis.reasoningSummary?.trim()) {
-        lines.push("## Reasoning Summary");
-        lines.push(result.analysis.reasoningSummary.trim());
-        lines.push("");
-    }
-    lines.push("## Summary");
-    lines.push(result.analysis.summary || "(none)");
-    lines.push("");
-    lines.push("## Current State");
-    lines.push(result.analysis.currentState || "(none)");
-    lines.push("");
-    lines.push("## Todo");
-    lines.push(result.analysis.todo || "(none)");
-    lines.push("");
-    lines.push("## Understanding");
-    lines.push(result.analysis.understanding || "(none)");
-    lines.push("");
-    lines.push("## Plan");
-    if (result.analysis.plan.length) {
-        result.analysis.plan.forEach((step, idx) => lines.push(`${idx + 1}. ${step}`));
-    }
-    else {
-        lines.push("(none)");
-    }
-    lines.push("");
-    lines.push("## Files Likely Touched");
-    if (result.analysis.filesLikelyTouched.length) {
-        result.analysis.filesLikelyTouched.forEach((file) => lines.push(`- ${file}`));
-    }
-    else {
-        lines.push("(none)");
-    }
-    lines.push("");
-    lines.push("## Files To Create");
-    if (result.analysis.filesToCreate.length) {
-        result.analysis.filesToCreate.forEach((file) => lines.push(`- ${file}`));
-    }
-    else {
-        lines.push("(none)");
-    }
-    if (result.analysis.assumptions.length) {
-        lines.push("");
-        lines.push("## Assumptions");
-        result.analysis.assumptions.forEach((item) => lines.push(`- ${item}`));
-    }
-    if (result.analysis.risks.length) {
-        lines.push("");
-        lines.push("## Risks");
-        result.analysis.risks.forEach((item) => lines.push(`- ${item}`));
-    }
-    if (result.analysis.docdexNotes.length) {
-        lines.push("");
-        lines.push("## Docdex Notes");
-        result.analysis.docdexNotes.forEach((item) => lines.push(`- ${item}`));
-    }
-    return lines.join("\n");
-};
 const isSameAgent = (result) => result.chosenAgent.agentId === result.gatewayAgent.id || result.chosenAgent.agentSlug === result.gatewayAgent.slug;
 const collectOffloadBlockers = (result) => {
     const blockers = [];
@@ -141,7 +76,7 @@ const collectOffloadBlockers = (result) => {
     return blockers;
 };
 const parseGatewayArgs = (argv) => {
-    const args = { noOffload: false, json: false };
+    const args = { noOffload: false, rateAgents: false, json: false };
     for (let i = 0; i < argv.length; i += 1) {
         const arg = argv[i];
         if (arg.startsWith("--workspace=") || arg.startsWith("--workspace-root=")) {
@@ -173,6 +108,10 @@ const parseGatewayArgs = (argv) => {
             args.agentStream = parseBooleanFlag(arg.split("=", 2)[1], true);
             continue;
         }
+        if (arg.startsWith("--rate-agents=")) {
+            args.rateAgents = parseBooleanFlag(arg.split("=", 2)[1], true);
+            continue;
+        }
         switch (arg) {
             case "--workspace":
             case "--workspace-root":
@@ -211,6 +150,17 @@ const parseGatewayArgs = (argv) => {
                 }
                 break;
             }
+            case "--rate-agents": {
+                const next = argv[i + 1];
+                if (next && !next.startsWith("-")) {
+                    args.rateAgents = parseBooleanFlag(next, true);
+                    i += 1;
+                }
+                else {
+                    args.rateAgents = true;
+                }
+                break;
+            }
             case "--no-offload":
             case "--plan-only":
                 args.noOffload = true;
@@ -472,6 +422,7 @@ export class GatewayAgentCommand {
                 maxDocs: gatewayArgs.maxDocs,
                 agentStream: streamEnabled,
                 onStreamChunk,
+                rateAgents: gatewayArgs.rateAgents,
             });
             if (shouldPrintStream && streamStarted && !streamEndedWithNewline) {
                 process.stdout.write("\n");
@@ -538,13 +489,6 @@ export class GatewayAgentCommand {
                 process.exitCode = 1;
                 return;
             }
-            const handoffContent = buildHandoffContent(result);
-            const handoffDir = path.join(workspace.workspaceRoot, ".mcoda", "handoffs");
-            await fs.mkdir(handoffDir, { recursive: true });
-            const handoffPath = path.join(handoffDir, `gateway-${result.commandRunId}.md`);
-            await fs.writeFile(handoffPath, handoffContent, "utf8");
-            const previousHandoff = process.env[HANDOFF_ENV_PATH];
-            process.env[HANDOFF_ENV_PATH] = handoffPath;
             const forwarded = stripAgentArgs(jobArgs);
             const hasAgentStream = forwarded.some((arg) => arg === "--agent-stream" || arg.startsWith("--agent-stream="));
             const argsWithAgent = [...forwarded];
@@ -553,22 +497,16 @@ export class GatewayAgentCommand {
             }
             argsWithAgent.push("--agent", result.chosenAgent.agentSlug);
             const sameAgent = isSameAgent(result);
+            const handoffContent = buildGatewayHandoffContent(result);
+            const handoffPath = await writeGatewayHandoffFile(workspace.workspaceRoot, result.commandRunId, handoffContent);
             const actionLabel = sameAgent
                 ? `Continuing ${result.job} with gateway agent ${result.gatewayAgent.slug}`
                 : `Offloading ${result.job} to ${result.chosenAgent.agentSlug}`;
             // eslint-disable-next-line no-console
             console.log(`\n${actionLabel}...`);
-            try {
+            await withGatewayHandoff(handoffPath, async () => {
                 await runner(argsWithAgent);
-            }
-            finally {
-                if (previousHandoff === undefined) {
-                    delete process.env[HANDOFF_ENV_PATH];
-                }
-                else {
-                    process.env[HANDOFF_ENV_PATH] = previousHandoff;
-                }
-            }
+            });
         }
         catch (error) {
             const message = error instanceof Error ? error.message : String(error);

package/dist/commands/backlog/OrderTasksCommand.d.ts

@@ -6,6 +6,7 @@ interface ParsedArgs {
     includeBlocked: boolean;
     agentName?: string;
     agentStream?: boolean;
+    rateAgents: boolean;
     json: boolean;
 }
 export declare const parseOrderTasksArgs: (argv: string[]) => ParsedArgs;

package/dist/commands/backlog/OrderTasksCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OrderTasksCommand.d.ts","sourceRoot":"","sources":["../../../src/commands/backlog/OrderTasksCommand.ts"],"names":[],"mappings":"AAGA,UAAU,UAAU;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;CACf;AA6BD,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,EAAE,KAAG,UAwEpD,CAAC;AA4EF,qBAAa,iBAAiB;WACf,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CA8ChD"}
+{"version":3,"file":"OrderTasksCommand.d.ts","sourceRoot":"","sources":["../../../src/commands/backlog/OrderTasksCommand.ts"],"names":[],"mappings":"AAGA,UAAU,UAAU;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;CACf;AA8BD,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,EAAE,KAAG,UAuFpD,CAAC;AA4EF,qBAAa,iBAAiB;WACf,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CA+ChD"}

package/dist/commands/backlog/OrderTasksCommand.js

@@ -8,6 +8,7 @@ const usage = `mcoda order-tasks \\
   [--include-blocked] \\
   [--agent <NAME>] \\
   [--agent-stream <true|false>] \\
+  [--rate-agents] \\
   [--json]`;
 const parseBooleanFlag = (value, defaultValue) => {
     if (value === undefined)
@@ -31,6 +32,7 @@ const parseStatuses = (value) => {
 export const parseOrderTasksArgs = (argv) => {
     const parsed = {
         includeBlocked: false,
+        rateAgents: false,
         json: false,
     };
     for (let i = 0; i < argv.length; i += 1) {
@@ -43,6 +45,10 @@ export const parseOrderTasksArgs = (argv) => {
             parsed.agentStream = parseBooleanFlag(arg.split("=")[1], true);
             continue;
         }
+        if (arg.startsWith("--rate-agents=")) {
+            parsed.rateAgents = parseBooleanFlag(arg.split("=")[1], true);
+            continue;
+        }
         switch (arg) {
             case "--workspace-root":
                 parsed.workspaceRoot = argv[i + 1] ? path.resolve(argv[i + 1]) : undefined;
@@ -78,6 +84,17 @@ export const parseOrderTasksArgs = (argv) => {
                 }
                 break;
             }
+            case "--rate-agents": {
+                const next = argv[i + 1];
+                if (next && !next.startsWith("-")) {
+                    parsed.rateAgents = parseBooleanFlag(next, true);
+                    i += 1;
+                }
+                else {
+                    parsed.rateAgents = true;
+                }
+                break;
+            }
             case "--json":
                 parsed.json = true;
                 break;
@@ -180,6 +197,7 @@ export class OrderTasksCommand {
                 includeBlocked: parsed.includeBlocked,
                 agentName: parsed.agentName,
                 agentStream: parsed.agentStream,
+                rateAgents: parsed.rateAgents,
             });
             if (parsed.json) {
                 const payload = {

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

@@ -6,6 +6,8 @@ export interface ParsedPdrArgs {
     outPath?: string;
     agentName?: string;
     agentStream: boolean;
+    rateAgents: boolean;
+    fast: boolean;
     dryRun: boolean;
     json: boolean;
     quiet: boolean;
@@ -20,6 +22,8 @@ export interface ParsedSdsArgs {
     agentName?: string;
     templateName?: string;
     agentStream: boolean;
+    rateAgents: boolean;
+    fast: boolean;
     force: boolean;
     resumeJobId?: string;
     dryRun: boolean;

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,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,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,aAkG7C,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,EAAE,KAAG,aAkG7C,CAAC;AASF,qBAAa,YAAY;WACV,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CA6JhD"}
+{"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,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,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,aAwH7C,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,EAAE,KAAG,aAwH7C,CAAC;AASF,qBAAa,YAAY;WACV,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAiKhD"}