mcoda 0.1.16 → 0.1.18

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

@@ -18,6 +18,7 @@ interface ParsedArgs {
     debug: boolean;
 }
 export declare const parseEstimateArgs: (argv: string[]) => ParsedArgs;
+export declare const formatTimeLeft: (hours: number | null | undefined) => string;
 export declare class EstimateCommands {
     static run(argv: string[]): Promise<void>;
 }

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

@@ -1 +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,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,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;AA6BD,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,EAAE,KAAG,UAkHlD,CAAC;AA4IF,qBAAa,gBAAgB;WACd,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAgEhD"}
+{"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,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,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;AA6BD,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,EAAE,KAAG,UA4HlD,CAAC;AAkBF,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,MAwBjE,CAAC;AA4HF,qBAAa,gBAAgB;WACd,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAgEhD"}

package/dist/commands/estimate/EstimateCommands.js

@@ -34,6 +34,8 @@ export const parseEstimateArgs = (argv) => {
         quiet: false,
         noColor: false,
         noTelemetry: false,
+        velocityMode: "empirical",
+        velocityWindow: 50,
     };
     for (let i = 0; i < argv.length; i += 1) {
         const arg = argv[i];
@@ -87,7 +89,12 @@ export const parseEstimateArgs = (argv) => {
                 i += 1;
                 break;
             case "--velocity-mode":
-                parsed.velocityMode = parseVelocityMode(argv[i + 1]);
+                {
+                    const mode = parseVelocityMode(argv[i + 1]);
+                    if (mode) {
+                        parsed.velocityMode = mode;
+                    }
+                }
                 i += 1;
                 break;
             case "--velocity-window":
@@ -133,7 +140,10 @@ export const parseEstimateArgs = (argv) => {
                     parsed.assignee = arg.split("=")[1];
                 }
                 else if (arg.startsWith("--velocity-mode=")) {
-                    parsed.velocityMode = parseVelocityMode(arg.split("=")[1]);
+                    const mode = parseVelocityMode(arg.split("=")[1]);
+                    if (mode) {
+                        parsed.velocityMode = mode;
+                    }
                 }
                 else if (arg.startsWith("--velocity-window=") || arg.startsWith("--window=")) {
                     const value = parseNumber(arg.split("=")[1]);
@@ -173,6 +183,32 @@ const fmt = (value) => {
         return `${value}`;
     return value.toFixed(2);
 };
+export const formatTimeLeft = (hours) => {
+    if (hours === null || hours === undefined)
+        return "N/A";
+    if (!Number.isFinite(hours) || hours <= 0)
+        return "0h";
+    let remainingHours = Math.max(1, Math.round(hours));
+    const monthHours = 24 * 30;
+    const weekHours = 24 * 7;
+    const dayHours = 24;
+    const months = Math.floor(remainingHours / monthHours);
+    remainingHours -= months * monthHours;
+    const weeks = Math.floor(remainingHours / weekHours);
+    remainingHours -= weeks * weekHours;
+    const days = Math.floor(remainingHours / dayHours);
+    remainingHours -= days * dayHours;
+    const parts = [];
+    if (months > 0)
+        parts.push(`${months}mo`);
+    if (weeks > 0)
+        parts.push(`${weeks}w`);
+    if (days > 0)
+        parts.push(`${days}d`);
+    if (remainingHours > 0 || parts.length === 0)
+        parts.push(`${remainingHours}h`);
+    return parts.join("");
+};
 const pad2 = (value) => `${value}`.padStart(2, "0");
 const formatLocalDateTime = (date) => `${date.getFullYear()}-${pad2(date.getMonth() + 1)}-${pad2(date.getDate())} ${pad2(date.getHours())}:${pad2(date.getMinutes())}`;
 const formatRelativeDuration = (targetMs, nowMs) => {
@@ -226,35 +262,35 @@ const renderResult = (result) => {
             "Implementation",
             fmt(result.backlogTotals.implementation.story_points),
             fmt(result.effectiveVelocity.implementationSpPerHour),
-            fmt(result.durationsHours.implementationHours),
+            formatTimeLeft(result.durationsHours.implementationHours),
         ],
         [
             "Review",
             fmt(result.backlogTotals.review.story_points),
             fmt(result.effectiveVelocity.reviewSpPerHour),
-            fmt(result.durationsHours.reviewHours),
+            formatTimeLeft(result.durationsHours.reviewHours),
         ],
         [
             "QA",
             fmt(result.backlogTotals.qa.story_points),
             fmt(result.effectiveVelocity.qaSpPerHour),
-            fmt(result.durationsHours.qaHours),
+            formatTimeLeft(result.durationsHours.qaHours),
         ],
         [
             "Done",
             fmt(result.backlogTotals.done.story_points),
             fmt(null),
-            fmt(0),
+            formatTimeLeft(0),
         ],
         [
             "Total",
             fmt(totalSp),
             fmt(null),
-            fmt(result.durationsHours.totalHours),
+            formatTimeLeft(result.durationsHours.totalHours),
         ],
     ];
     // eslint-disable-next-line no-console
-    console.log(formatTable(["LANE", "STORY_POINTS", spHeader, "HOURS"], rows));
+    console.log(formatTable(["LANE", "STORY_POINTS", spHeader, "TIME_LEFT"], rows));
     const samples = velocity.samples ?? { implementation: 0, review: 0, qa: 0 };
     const windowLabel = velocity.windowTasks ? ` (window ${velocity.windowTasks})` : "";
     const fallbackNote = velocity.requestedMode && velocity.requestedMode !== velocity.source

package/package.json

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