mcoda 0.1.2 → 0.1.4

package/dist/commands/estimate/EstimateCommands.d.ts

@@ -0,0 +1,24 @@
+import { VelocitySource } from "@mcoda/core";
+interface ParsedArgs {
+    workspaceRoot?: string;
+    project?: string;
+    epic?: string;
+    story?: string;
+    assignee?: string;
+    quiet: boolean;
+    noColor: boolean;
+    noTelemetry: boolean;
+    spPerHour?: number;
+    spPerHourReview?: number;
+    spPerHourQa?: number;
+    velocityMode?: VelocitySource;
+    velocityWindow?: 10 | 20 | 50;
+    json: boolean;
+    debug: boolean;
+}
+export declare const parseEstimateArgs: (argv: string[]) => ParsedArgs;
+export declare class EstimateCommands {
+    static run(argv: string[]): Promise<void>;
+}
+export {};
+//# sourceMappingURL=EstimateCommands.d.ts.map

package/dist/commands/estimate/EstimateCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EstimateCommands.d.ts","sourceRoot":"","sources":["../../../src/commands/estimate/EstimateCommands.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,cAAc,EAGf,MAAM,aAAa,CAAC;AAErB,UAAU,UAAU;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B,cAAc,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB;AA4BD,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,EAAE,KAAG,UA4GlD,CAAC;AA6DF,qBAAa,gBAAgB;WACd,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAkEhD"}

package/dist/commands/estimate/EstimateCommands.js

@@ -0,0 +1,259 @@
+import path from "node:path";
+import { EstimateService, JobService, WorkspaceResolver, } from "@mcoda/core";
+const usage = `mcoda estimate \\
+  [--workspace <PATH>] \\
+  [--project <PROJECT_KEY>] \\
+  [--epic <EPIC_KEY>] \\
+  [--story <STORY_KEY>] \\
+  [--assignee <USER>] \\
+  [--sp-per-hour <FLOAT>] \\
+  [--sp-per-hour-review <FLOAT>] \\
+  [--sp-per-hour-qa <FLOAT>] \\
+  [--velocity-mode config|empirical|mixed] \\
+  [--velocity-window 10|20|50] \\
+  [--quiet] [--no-color] [--no-telemetry] \\
+  [--json]`;
+const parseNumber = (value) => {
+    if (value === undefined)
+        return undefined;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+};
+const parseVelocityMode = (value) => {
+    if (!value)
+        return undefined;
+    if (value === "config" || value === "empirical" || value === "mixed")
+        return value;
+    return undefined;
+};
+export const parseEstimateArgs = (argv) => {
+    const parsed = {
+        json: false,
+        debug: false,
+        quiet: false,
+        noColor: false,
+        noTelemetry: false,
+    };
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (!arg.startsWith("-"))
+            continue;
+        switch (arg) {
+            case "--workspace":
+            case "--workspace-root":
+                parsed.workspaceRoot = argv[i + 1] ? path.resolve(argv[i + 1]) : undefined;
+                i += 1;
+                break;
+            case "--project":
+                parsed.project = argv[i + 1];
+                i += 1;
+                break;
+            case "--epic":
+                parsed.epic = argv[i + 1];
+                i += 1;
+                break;
+            case "--story":
+                parsed.story = argv[i + 1];
+                i += 1;
+                break;
+            case "--assignee":
+                parsed.assignee = argv[i + 1];
+                i += 1;
+                break;
+            case "--quiet":
+                parsed.quiet = true;
+                break;
+            case "--no-color":
+                parsed.noColor = true;
+                break;
+            case "--no-telemetry":
+                parsed.noTelemetry = true;
+                break;
+            case "--sp-per-hour":
+                parsed.spPerHour = parseNumber(argv[i + 1]);
+                i += 1;
+                break;
+            case "--sp-per-hour-review":
+                parsed.spPerHourReview = parseNumber(argv[i + 1]);
+                i += 1;
+                break;
+            case "--sp-per-hour-qa":
+                parsed.spPerHourQa = parseNumber(argv[i + 1]);
+                i += 1;
+                break;
+            case "--velocity-mode":
+                parsed.velocityMode = parseVelocityMode(argv[i + 1]);
+                i += 1;
+                break;
+            case "--velocity-window":
+            case "--window": {
+                const value = parseNumber(argv[i + 1]);
+                if (value === 10 || value === 20 || value === 50) {
+                    parsed.velocityWindow = value;
+                }
+                i += 1;
+                break;
+            }
+            default:
+                if (arg === "--json") {
+                    parsed.json = true;
+                }
+                else if (arg === "--debug") {
+                    parsed.debug = true;
+                }
+                else if (arg === "--quiet") {
+                    parsed.quiet = true;
+                }
+                else if (arg === "--no-color") {
+                    parsed.noColor = true;
+                }
+                else if (arg === "--no-telemetry") {
+                    parsed.noTelemetry = true;
+                }
+                else if (arg === "--help" || arg === "-h") {
+                    // eslint-disable-next-line no-console
+                    console.log(usage);
+                    process.exit(0);
+                }
+                else if (arg.startsWith("--project=")) {
+                    parsed.project = arg.split("=")[1];
+                }
+                else if (arg.startsWith("--epic=")) {
+                    parsed.epic = arg.split("=")[1];
+                }
+                else if (arg.startsWith("--story=")) {
+                    parsed.story = arg.split("=")[1];
+                }
+                else if (arg.startsWith("--assignee=")) {
+                    parsed.assignee = arg.split("=")[1];
+                }
+                else if (arg.startsWith("--velocity-mode=")) {
+                    parsed.velocityMode = parseVelocityMode(arg.split("=")[1]);
+                }
+                else if (arg.startsWith("--velocity-window=") || arg.startsWith("--window=")) {
+                    const value = parseNumber(arg.split("=")[1]);
+                    if (value === 10 || value === 20 || value === 50) {
+                        parsed.velocityWindow = value;
+                    }
+                }
+                else if (arg.startsWith("--sp-per-hour=")) {
+                    parsed.spPerHour = parseNumber(arg.split("=")[1]);
+                }
+                else if (arg.startsWith("--sp-per-hour-review=")) {
+                    parsed.spPerHourReview = parseNumber(arg.split("=")[1]);
+                }
+                else if (arg.startsWith("--sp-per-hour-qa=")) {
+                    parsed.spPerHourQa = parseNumber(arg.split("=")[1]);
+                }
+                break;
+        }
+    }
+    return parsed;
+};
+const pad = (value, width) => value.padEnd(width, " ");
+const formatTable = (headers, rows) => {
+    const widths = headers.map((header, idx) => Math.max(header.length, ...rows.map((row) => (row[idx] ?? "").length)));
+    const headerLine = headers.map((h, idx) => pad(h, widths[idx])).join(" | ");
+    const sepLine = widths.map((w) => "-".repeat(w)).join("-+-");
+    const body = rows.map((row) => row.map((cell, idx) => pad(cell ?? "", widths[idx])).join(" | ")).join("\n");
+    return [headerLine, sepLine, body].filter(Boolean).join("\n");
+};
+const fmt = (value) => {
+    if (value === null || value === undefined)
+        return "N/A";
+    if (Number.isInteger(value))
+        return `${value}`;
+    return value.toFixed(2);
+};
+const renderResult = (result) => {
+    const source = result.effectiveVelocity.source;
+    const spHeader = `SP/H (${source})`;
+    const rows = [
+        [
+            "Implementation",
+            fmt(result.backlogTotals.implementation.story_points),
+            fmt(result.effectiveVelocity.implementationSpPerHour),
+            fmt(result.durationsHours.implementationHours),
+        ],
+        [
+            "Review",
+            fmt(result.backlogTotals.review.story_points),
+            fmt(result.effectiveVelocity.reviewSpPerHour),
+            fmt(result.durationsHours.reviewHours),
+        ],
+        [
+            "QA",
+            fmt(result.backlogTotals.qa.story_points),
+            fmt(result.effectiveVelocity.qaSpPerHour),
+            fmt(result.durationsHours.qaHours),
+        ],
+    ];
+    // eslint-disable-next-line no-console
+    console.log(formatTable(["LANE", "STORY_POINTS", spHeader, "HOURS"], rows));
+    // eslint-disable-next-line no-console
+    console.log(`\nVelocity source: ${result.effectiveVelocity.source}${result.effectiveVelocity.windowTasks ? ` (window ${result.effectiveVelocity.windowTasks})` : ""}`);
+    // eslint-disable-next-line no-console
+    console.log("ETAs:");
+    // eslint-disable-next-line no-console
+    console.log(formatTable(["READY_TO_REVIEW", "READY_TO_QA", "COMPLETE"], [[result.etas.readyToReviewEta ?? "N/A", result.etas.readyToQaEta ?? "N/A", result.etas.completeEta ?? "N/A"]]));
+};
+export class EstimateCommands {
+    static async run(argv) {
+        const parsed = parseEstimateArgs(argv);
+        const workspace = await WorkspaceResolver.resolveWorkspace({
+            cwd: process.cwd(),
+            explicitWorkspace: parsed.workspaceRoot,
+        });
+        const service = await EstimateService.create(workspace);
+        const jobService = new JobService(workspace, undefined, { noTelemetry: parsed.noTelemetry });
+        const commandRun = await jobService.startCommandRun("estimate", parsed.project);
+        try {
+            const result = await service.estimate({
+                projectKey: parsed.project,
+                epicKey: parsed.epic,
+                storyKey: parsed.story,
+                assignee: parsed.assignee,
+                mode: parsed.velocityMode,
+                windowTasks: parsed.velocityWindow,
+                spPerHourAll: parsed.spPerHour,
+                spPerHourReview: parsed.spPerHourReview,
+                spPerHourQa: parsed.spPerHourQa,
+            });
+            const totalSp = result.backlogTotals.implementation.story_points +
+                result.backlogTotals.review.story_points +
+                result.backlogTotals.qa.story_points +
+                result.backlogTotals.done.story_points;
+            await jobService.finishCommandRun(commandRun.id, "succeeded", undefined, totalSp);
+            if (parsed.json) {
+                // eslint-disable-next-line no-console
+                console.log(JSON.stringify(result, null, 2));
+            }
+            else if (!parsed.quiet) {
+                const totalTasks = result.backlogTotals.implementation.tasks +
+                    result.backlogTotals.review.tasks +
+                    result.backlogTotals.qa.tasks +
+                    result.backlogTotals.done.tasks;
+                // eslint-disable-next-line no-console
+                console.log(`Scope: project=${parsed.project ?? "all"}${parsed.epic ? `, epic=${parsed.epic}` : ""}${parsed.story ? `, story=${parsed.story}` : ""}${parsed.assignee ? `, assignee=${parsed.assignee}` : ""}`);
+                if (totalTasks === 0) {
+                    // eslint-disable-next-line no-console
+                    console.log("No tasks found in the selected scope. Showing zeroed estimate.");
+                }
+                renderResult(result);
+                if (parsed.debug && result.effectiveVelocity.samples) {
+                    // eslint-disable-next-line no-console
+                    console.error(`Samples: impl=${result.effectiveVelocity.samples.implementation ?? 0}, review=${result.effectiveVelocity.samples.review ?? 0}, qa=${result.effectiveVelocity.samples.qa ?? 0}`);
+                }
+            }
+        }
+        catch (error) {
+            await jobService.finishCommandRun(commandRun.id, "failed", error.message);
+            // eslint-disable-next-line no-console
+            console.error(`estimate failed: ${error.message}`);
+            process.exitCode = 1;
+        }
+        finally {
+            await service.close?.();
+        }
+    }
+}

package/dist/commands/jobs/JobsCommands.d.ts

@@ -0,0 +1,24 @@
+type JobSubcommand = "list" | "status" | "watch" | "logs" | "inspect" | "resume" | "cancel" | "tokens";
+export interface ParsedJobArgs {
+    subcommand: JobSubcommand;
+    jobId?: string;
+    workspaceRoot?: string;
+    project?: string;
+    status?: string;
+    type?: string;
+    since?: string;
+    limit?: number;
+    json?: boolean;
+    intervalSeconds?: number;
+    noLogs?: boolean;
+    follow?: boolean;
+    agent?: string;
+    noTelemetry?: boolean;
+    force?: boolean;
+}
+export declare const parseJobArgs: (argv: string[]) => ParsedJobArgs;
+export declare class JobsCommands {
+    static run(argv: string[]): Promise<void>;
+}
+export {};
+//# sourceMappingURL=JobsCommands.d.ts.map

package/dist/commands/jobs/JobsCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobsCommands.d.ts","sourceRoot":"","sources":["../../../src/commands/jobs/JobsCommands.ts"],"names":[],"mappings":"AAIA,KAAK,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEvG,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,aAAa,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAuCD,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,EAAE,KAAG,aAyH7C,CAAC;AAiMF,qBAAa,YAAY;WACV,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CA0NhD"}