mcoda 0.1.21 → 0.1.22

package/README.md

@@ -28,12 +28,14 @@ mcoda docs pdr generate --workspace-root . --project WEB --rfp-path docs/rfp/web
 - 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`
+- Execution: `mcoda add-tests`, `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`
 
+`mcoda work-on-tasks` auto-runs the same test-harness bootstrap logic as `mcoda add-tests` when selected tasks require tests but no runnable harness exists.
+
 ## Configuration
 Environment variables are optional overrides for workspace settings:
 - `MCODA_DOCDEX_URL` to point at a docdex server.

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

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

package/dist/bin/McodaEntrypoint.js

@@ -16,6 +16,7 @@ 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 { AddTestsCommand } from "../commands/work/AddTestsCommand.js";
 import { CodeReviewCommand } from "../commands/review/CodeReviewCommand.js";
 import { QaTasksCommand } from "../commands/planning/QaTasksCommand.js";
 import { MigrateTasksCommand } from "../commands/planning/MigrateTasksCommand.js";
@@ -80,7 +81,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|order-tasks|tasks|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|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" +
@@ -170,6 +171,10 @@ export class McodaEntrypoint {
             await WorkOnTasksCommand.run(rest);
             return;
         }
+        if (command === "add-tests") {
+            await AddTestsCommand.run(rest);
+            return;
+        }
         if (command === "gateway-trio") {
             await GatewayTrioCommand.run(rest);
             return;

package/dist/commands/work/AddTestsCommand.d.ts

@@ -0,0 +1,31 @@
+interface ParsedArgs {
+    workspaceRoot?: string;
+    projectKey?: string;
+    epicKey?: string;
+    storyKey?: string;
+    taskKeys: string[];
+    statusFilter: string[];
+    limit?: number;
+    noCommit: boolean;
+    dryRun: boolean;
+    baseBranch?: string;
+    json: boolean;
+}
+type ProjectKeyCandidate = {
+    key: string;
+    createdAt?: string | null;
+};
+export declare const parseAddTestsArgs: (argv: string[]) => ParsedArgs;
+export declare const pickAddTestsProjectKey: (options: {
+    requestedKey?: string;
+    configuredKey?: string;
+    existing: ProjectKeyCandidate[];
+}) => {
+    projectKey?: string;
+    warnings: string[];
+};
+export declare class AddTestsCommand {
+    static run(argv: string[]): Promise<void>;
+}
+export {};
+//# sourceMappingURL=AddTestsCommand.d.ts.map

package/dist/commands/work/AddTestsCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddTestsCommand.d.ts","sourceRoot":"","sources":["../../../src/commands/work/AddTestsCommand.ts"],"names":[],"mappings":"AAKA,UAAU,UAAU;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,KAAK,mBAAmB,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAqBtE,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,EAAE,KAAG,UAsGlD,CAAC;AAoBF,eAAO,MAAM,sBAAsB,GAAI,SAAS;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC,KAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAkC5C,CAAC;AAEF,qBAAa,eAAe;WACb,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CA2GhD"}

package/dist/commands/work/AddTestsCommand.js

@@ -0,0 +1,263 @@
+import path from "node:path";
+import { WorkspaceRepository } from "@mcoda/db";
+import { AddTestsService, WorkspaceResolver } from "@mcoda/core";
+import { WORK_ALLOWED_STATUSES, filterTaskStatuses } from "@mcoda/shared";
+const usage = `mcoda add-tests \\
+  [--workspace <PATH>] \\
+  [--project <PROJECT_KEY>] \\
+  [--task <TASK_KEY> ... | --epic <EPIC_KEY> | --story <STORY_KEY>] \\
+  [--status not_started,in_progress,changes_requested] \\
+  [--limit N] \\
+  [--base-branch <BRANCH>] \\
+  [--no-commit] \\
+  [--dry-run] \\
+  [--json]`;
+const parseCsv = (value) => {
+    if (!value)
+        return [];
+    return value
+        .split(",")
+        .map((item) => item.trim())
+        .filter(Boolean);
+};
+export const parseAddTestsArgs = (argv) => {
+    let workspaceRoot;
+    let projectKey;
+    let epicKey;
+    let storyKey;
+    const taskKeys = [];
+    const statusFilter = [];
+    let limit;
+    let noCommit = false;
+    let dryRun = false;
+    let baseBranch;
+    let json = false;
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg.startsWith("--status=")) {
+            const [, raw] = arg.split("=", 2);
+            statusFilter.push(...parseCsv(raw));
+            continue;
+        }
+        if (arg.startsWith("--task=")) {
+            const [, raw] = arg.split("=", 2);
+            if (raw)
+                taskKeys.push(raw);
+            continue;
+        }
+        switch (arg) {
+            case "--workspace":
+            case "--workspace-root":
+                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 "--epic":
+                epicKey = argv[i + 1];
+                i += 1;
+                break;
+            case "--story":
+                storyKey = argv[i + 1];
+                i += 1;
+                break;
+            case "--task":
+                if (argv[i + 1]) {
+                    taskKeys.push(argv[i + 1]);
+                    i += 1;
+                }
+                break;
+            case "--status":
+                statusFilter.push(...parseCsv(argv[i + 1]));
+                i += 1;
+                break;
+            case "--limit":
+                limit = Number(argv[i + 1]);
+                i += 1;
+                break;
+            case "--base-branch":
+            case "--branch":
+                baseBranch = argv[i + 1];
+                i += 1;
+                break;
+            case "--no-commit":
+                noCommit = true;
+                break;
+            case "--dry-run":
+                dryRun = true;
+                break;
+            case "--json":
+                json = true;
+                break;
+            case "--help":
+            case "-h":
+                // eslint-disable-next-line no-console
+                console.log(usage);
+                process.exit(0);
+                break;
+            default:
+                break;
+        }
+    }
+    const { filtered } = filterTaskStatuses(statusFilter.length ? statusFilter : undefined, WORK_ALLOWED_STATUSES, WORK_ALLOWED_STATUSES);
+    return {
+        workspaceRoot,
+        projectKey,
+        epicKey,
+        storyKey,
+        taskKeys,
+        statusFilter: filtered,
+        limit: Number.isFinite(limit) ? limit : undefined,
+        noCommit,
+        dryRun,
+        baseBranch: baseBranch?.trim() || undefined,
+        json,
+    };
+};
+const listWorkspaceProjects = async (workspaceRoot) => {
+    const repo = await WorkspaceRepository.create(workspaceRoot);
+    try {
+        const rows = await repo
+            .getDb()
+            .all(`SELECT key, created_at FROM projects ORDER BY created_at ASC, key ASC`);
+        return rows
+            .map((row) => ({ key: String(row.key), createdAt: row.created_at ?? null }))
+            .filter((row) => row.key.trim().length > 0);
+    }
+    catch {
+        return [];
+    }
+    finally {
+        await repo.close();
+    }
+};
+export const pickAddTestsProjectKey = (options) => {
+    const warnings = [];
+    const requestedKey = options.requestedKey?.trim() || undefined;
+    const configuredKey = options.configuredKey?.trim() || undefined;
+    const existing = options.existing ?? [];
+    const firstExisting = 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}".`);
+        }
+        return { projectKey: requestedKey, warnings };
+    }
+    if (configuredKey) {
+        if (firstExisting && configuredKey !== firstExisting) {
+            warnings.push(`Using configured project key "${configuredKey}" instead of first workspace project "${firstExisting}".`);
+        }
+        return { projectKey: configuredKey, warnings };
+    }
+    if (firstExisting) {
+        warnings.push(`No --project provided; defaulting to first workspace project "${firstExisting}".`);
+        return { projectKey: firstExisting, warnings };
+    }
+    return { projectKey: undefined, warnings };
+};
+export class AddTestsCommand {
+    static async run(argv) {
+        const parsed = parseAddTestsArgs(argv);
+        const workspace = await WorkspaceResolver.resolveWorkspace({
+            cwd: process.cwd(),
+            explicitWorkspace: parsed.workspaceRoot,
+        });
+        const existingProjects = parsed.projectKey ? [] : await listWorkspaceProjects(workspace.workspaceRoot);
+        const configuredKey = typeof workspace.config?.projectKey === "string" && workspace.config.projectKey.trim().length > 0
+            ? workspace.config.projectKey
+            : undefined;
+        const projectResolution = pickAddTestsProjectKey({
+            requestedKey: parsed.projectKey,
+            configuredKey,
+            existing: existingProjects,
+        });
+        const commandWarnings = [...projectResolution.warnings];
+        if (!projectResolution.projectKey) {
+            // eslint-disable-next-line no-console
+            console.error("add-tests could not resolve a project key. Provide --project <PROJECT_KEY> or create tasks first.");
+            process.exitCode = 1;
+            return;
+        }
+        if (commandWarnings.length > 0 && !parsed.json) {
+            // eslint-disable-next-line no-console
+            console.warn(commandWarnings.map((warning) => `! ${warning}`).join("\n"));
+        }
+        const service = await AddTestsService.create(workspace);
+        try {
+            const result = await service.addTests({
+                projectKey: projectResolution.projectKey,
+                epicKey: parsed.epicKey,
+                storyKey: parsed.storyKey,
+                taskKeys: parsed.taskKeys.length ? parsed.taskKeys : undefined,
+                statusFilter: parsed.statusFilter,
+                ignoreStatusFilter: parsed.taskKeys.length > 0 ? true : undefined,
+                ignoreDependencies: true,
+                limit: parsed.limit,
+                dryRun: parsed.dryRun,
+                commit: !parsed.noCommit,
+                baseBranch: parsed.baseBranch,
+            });
+            const warnings = [...commandWarnings, ...result.warnings];
+            if (parsed.json) {
+                // eslint-disable-next-line no-console
+                console.log(JSON.stringify({
+                    projectKey: result.projectKey,
+                    selectedTaskCount: result.selectedTaskKeys.length,
+                    tasksRequiringTests: result.tasksRequiringTests,
+                    updatedTaskKeys: result.updatedTaskKeys,
+                    skippedTaskKeys: result.skippedTaskKeys,
+                    createdFiles: result.createdFiles,
+                    runAllScriptPath: result.runAllScriptPath ?? null,
+                    runAllCommand: result.runAllCommand ?? null,
+                    branch: result.branch ?? null,
+                    commitSha: result.commitSha ?? null,
+                    warnings,
+                }, null, 2));
+                return;
+            }
+            // eslint-disable-next-line no-console
+            console.log([
+                `add-tests project=${result.projectKey}`,
+                `selected=${result.selectedTaskKeys.length}`,
+                `requires_tests=${result.tasksRequiringTests.length}`,
+                `updated=${result.updatedTaskKeys.length}`,
+                `skipped=${result.skippedTaskKeys.length}`,
+            ].join(" "));
+            if (result.createdFiles.length > 0) {
+                // eslint-disable-next-line no-console
+                console.log(`Created: ${result.createdFiles.join(", ")}`);
+            }
+            if (result.runAllCommand) {
+                // eslint-disable-next-line no-console
+                console.log(`Run-all command: ${result.runAllCommand}`);
+            }
+            if (result.commitSha) {
+                // eslint-disable-next-line no-console
+                console.log(`Committed on ${result.branch ?? "current branch"}: ${result.commitSha}`);
+            }
+            else if (!parsed.noCommit && !parsed.dryRun && result.createdFiles.length > 0) {
+                // eslint-disable-next-line no-console
+                console.log("No commit was created.");
+            }
+            if (warnings.length > 0) {
+                // eslint-disable-next-line no-console
+                console.warn(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(`add-tests failed: ${message}`);
+            process.exitCode = 1;
+        }
+        finally {
+            await service.close();
+        }
+    }
+}

package/package.json

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