mcoda 0.1.2 → 0.1.4

package/packages/cli/src/__tests__/UpdateCommands.test.ts

@@ -1,292 +0,0 @@
-import assert from "node:assert/strict";
-import os from "node:os";
-import path from "node:path";
-import fs from "node:fs/promises";
-import { test } from "node:test";
-import { UpdateCommands } from "../commands/update/UpdateCommands.js";
-import { Connection } from "@mcoda/db";
-import { PathHelper } from "@mcoda/shared";
-import { SystemClient } from "@mcoda/integrations";
-import { SystemUpdateService } from "@mcoda/core";
-
-const withPatched = <T, K extends keyof T>(
-  target: T,
-  key: K,
-  impl: T[K],
-  fn: () => Promise<void> | void,
-): Promise<void> => {
-  const original = target[key];
-  // @ts-ignore override for testing
-  target[key] = impl;
-  return (async () => {
-    try {
-      await fn();
-    } finally {
-      // @ts-ignore restore original
-      target[key] = original;
-    }
-  })();
-};
-
-const captureLogs = async (fn: () => Promise<void> | void): Promise<string[]> => {
-  const logs: string[] = [];
-  const originalLog = console.log;
-  // @ts-ignore override
-  console.log = (...args: any[]) => {
-    logs.push(args.join(" "));
-  };
-  try {
-    await fn();
-  } finally {
-    // @ts-ignore restore
-    console.log = originalLog;
-  }
-  return logs;
-};
-
-const withTempHome = async (fn: (home: string) => Promise<void>): Promise<void> => {
-  const originalHome = process.env.HOME;
-  const tempHome = await fs.mkdtemp(path.join(os.tmpdir(), "mcoda-update-"));
-  process.env.HOME = tempHome;
-  try {
-    await fn(tempHome);
-  } finally {
-    process.env.HOME = originalHome;
-    await fs.rm(tempHome, { recursive: true, force: true });
-  }
-};
-
-const readCommandRuns = async (): Promise<Array<{ command_name: string; status: string; exit_code: number | null; error_summary: string | null }>> => {
-  const dbPath = PathHelper.getGlobalDbPath();
-  const conn = await Connection.open(dbPath);
-  try {
-    const rows = await conn.db.all(
-      "SELECT command_name, status, exit_code, error_summary FROM command_runs ORDER BY started_at ASC",
-    );
-    return rows as any[];
-  } finally {
-    await conn.close();
-  }
-};
-
-test("update --check writes releases.json and outputs json", async () => {
-  await withTempHome(async (home) => {
-    const originalExit = process.exitCode;
-    process.exitCode = undefined;
-    await withPatched(
-      SystemClient.prototype as any,
-      "checkUpdate",
-      async () => ({
-        currentVersion: "0.1.2",
-        latestVersion: "0.2.0",
-        channel: "stable",
-        updateAvailable: true,
-        notes: "Changelog",
-      }),
-      async () => {
-        const logs = await captureLogs(async () => {
-          await UpdateCommands.run(["--check", "--json"]);
-        });
-        const parsed = JSON.parse(logs.join("\n"));
-        assert.equal(parsed.latestVersion, "0.2.0");
-        assert.equal(parsed.updateAvailable, true);
-        const releasesRaw = await fs.readFile(path.join(home, ".mcoda", "releases.json"), "utf8");
-        const releases = JSON.parse(releasesRaw);
-        assert.equal(releases.lastCheck.latestVersion, "0.2.0");
-        assert.ok(releases.lastCheck.checkedAt);
-      },
-    );
-    process.exitCode = originalExit;
-  });
-});
-
-test("update apply succeeds and records state", async () => {
-  await withTempHome(async (home) => {
-    const originalExit = process.exitCode;
-    process.exitCode = undefined;
-    await withPatched(
-      SystemClient.prototype as any,
-      "checkUpdate",
-      async () => ({
-        currentVersion: "0.1.2",
-        latestVersion: "0.3.0",
-        channel: "stable",
-        updateAvailable: true,
-      }),
-      async () => {
-        await withPatched(
-          SystemClient.prototype as any,
-          "applyUpdate",
-          async () => ({ status: "completed", logFile: "/tmp/log" }),
-          async () => {
-            await UpdateCommands.run(["--force"]);
-            const releasesRaw = await fs.readFile(path.join(home, ".mcoda", "releases.json"), "utf8");
-            const releases = JSON.parse(releasesRaw);
-            assert.equal(releases.lastCheck.currentVersion, "0.3.0");
-            assert.equal(releases.lastCheck.updateAvailable, false);
-            assert.equal(process.exitCode ?? 0, 0);
-          },
-        );
-      },
-    );
-    process.exitCode = originalExit;
-  });
-});
-
-test("requires --force when CI is set", async () => {
-  await withTempHome(async () => {
-    const originalExit = process.exitCode;
-    const originalCi = process.env.CI;
-    process.exitCode = undefined;
-    process.env.CI = "true";
-    let applyCalled = 0;
-    await withPatched(
-      SystemClient.prototype as any,
-      "checkUpdate",
-      async () => ({
-        currentVersion: "0.1.2",
-        latestVersion: "0.3.0",
-        channel: "stable",
-        updateAvailable: true,
-      }),
-      async () => {
-        await withPatched(
-          SystemClient.prototype as any,
-          "applyUpdate",
-          async () => {
-            applyCalled += 1;
-            return { status: "completed" };
-          },
-          async () => {
-            await UpdateCommands.run([]);
-            assert.equal(applyCalled, 0);
-            assert.equal(process.exitCode, 2);
-          },
-        );
-      },
-    );
-    process.exitCode = originalExit;
-    process.env.CI = originalCi;
-  });
-});
-
-test("invalid channel yields usage error", async () => {
-  await withTempHome(async () => {
-    const originalExit = process.exitCode;
-    process.exitCode = undefined;
-    await UpdateCommands.run(["--channel", "bogus"]);
-    assert.equal(process.exitCode, 1);
-    process.exitCode = originalExit;
-  });
-});
-
-test("writes command_runs row with exit code 4 on network failure", async () => {
-  await withTempHome(async () => {
-    const originalExit = process.exitCode;
-    process.exitCode = undefined;
-    await withPatched(
-      SystemClient.prototype as any,
-      "checkUpdate",
-      async () => {
-        throw new Error("network down");
-      },
-      async () => {
-        await UpdateCommands.run(["--check"]);
-        const runs = await readCommandRuns();
-        assert.equal(runs.length, 1);
-        assert.equal(runs[0].command_name, "update");
-        assert.equal(runs[0].status, "failed");
-        assert.equal(runs[0].exit_code, 4);
-        assert.match(runs[0].error_summary ?? "", /network down/);
-        assert.equal(process.exitCode, 4);
-      },
-    );
-    process.exitCode = originalExit;
-  });
-});
-
-test("writes command_runs row with exit code 6 on install failure", async () => {
-  await withTempHome(async () => {
-    const originalExit = process.exitCode;
-    process.exitCode = undefined;
-    await withPatched(
-      SystemClient.prototype as any,
-      "checkUpdate",
-      async () => ({
-        currentVersion: "0.1.2",
-        latestVersion: "0.3.0",
-        channel: "stable",
-        updateAvailable: true,
-      }),
-      async () => {
-        await withPatched(
-          SystemClient.prototype as any,
-          "applyUpdate",
-          async () => {
-            throw new Error("apply failed");
-          },
-          async () => {
-            await withPatched(
-              (SystemUpdateService.prototype as any) as { runNpmInstall: any },
-              "runNpmInstall",
-              async () => ({ code: 1 }),
-              async () => {
-                await UpdateCommands.run(["--force"]);
-                const runs = await readCommandRuns();
-                assert.equal(runs.length, 1);
-                assert.equal(runs[0].status, "failed");
-                assert.equal(runs[0].exit_code, 6);
-                assert.match(runs[0].error_summary ?? "", /npm install exited with code 1/);
-                assert.equal(process.exitCode, 6);
-              },
-            );
-          },
-        );
-      },
-    );
-    process.exitCode = originalExit;
-  });
-});
-
-test("falls back to npm on apply failure and succeeds", async () => {
-  await withTempHome(async () => {
-    const originalExit = process.exitCode;
-    process.exitCode = undefined;
-    await withPatched(
-      SystemClient.prototype as any,
-      "checkUpdate",
-      async () => ({
-        currentVersion: "0.1.2",
-        latestVersion: "0.3.0",
-        channel: "beta",
-        updateAvailable: true,
-      }),
-      async () => {
-        await withPatched(
-          SystemClient.prototype as any,
-          "applyUpdate",
-          async () => {
-            throw new Error("apply failed");
-          },
-          async () => {
-            await withPatched(
-              (SystemUpdateService.prototype as any) as { runNpmInstall: any },
-              "runNpmInstall",
-              async () => ({ code: 0 }),
-              async () => {
-                await UpdateCommands.run(["--force", "--channel", "beta"]);
-                const runs = await readCommandRuns();
-                assert.equal(runs.length, 1);
-                assert.equal(runs[0].status, "succeeded");
-                assert.equal(runs[0].exit_code, 0);
-                assert.equal(runs[0].error_summary, null);
-                assert.equal(process.exitCode ?? 0, 0);
-              },
-            );
-          },
-        );
-      },
-    );
-    process.exitCode = originalExit;
-  });
-});

package/packages/cli/src/__tests__/WorkOnTasksCommand.test.ts

@@ -1,42 +0,0 @@
-import { describe, it } from "node:test";
-import assert from "node:assert/strict";
-import path from "node:path";
-import { parseWorkOnTasksArgs } from "../commands/work/WorkOnTasksCommand.js";
-
-describe("work-on-tasks argument parsing", () => {
-  it("applies defaults for booleans and statuses", () => {
-    const parsed = parseWorkOnTasksArgs([]);
-    assert.equal(parsed.agentStream, true);
-    assert.equal(parsed.noCommit, false);
-    assert.equal(parsed.dryRun, false);
-    assert.deepEqual(parsed.statusFilter, ["not_started", "in_progress"]);
-  });
-
-  it("captures tasks and explicit statuses", () => {
-    const parsed = parseWorkOnTasksArgs([
-      "--task",
-      "alpha",
-      "--task=beta",
-      "--status",
-      "blocked,in_progress",
-    ]);
-    assert.deepEqual(parsed.taskKeys, ["alpha", "beta"]);
-    assert.deepEqual(parsed.statusFilter, ["blocked", "in_progress"]);
-  });
-
-  it("parses numeric flags and agent stream overrides", () => {
-    const parsed = parseWorkOnTasksArgs(["--agent-stream=false", "--limit", "5", "--parallel", "2", "--no-commit", "--dry-run"]);
-    assert.equal(parsed.agentStream, false);
-    assert.equal(parsed.limit, 5);
-    assert.equal(parsed.parallel, 2);
-    assert.equal(parsed.noCommit, true);
-    assert.equal(parsed.dryRun, true);
-  });
-
-  it("accepts workspace alias flags", () => {
-    const root = path.resolve("/tmp/demo");
-    const parsed = parseWorkOnTasksArgs(["--workspace-root", root, "--project", "proj"]);
-    assert.equal(parsed.workspaceRoot, root);
-    assert.equal(parsed.projectKey, "proj");
-  });
-});

package/packages/cli/src/bin/McodaEntrypoint.ts

@@ -1,180 +0,0 @@
-#!/usr/bin/env node
-import { realpathSync } from "node:fs";
-import { fileURLToPath } from "node:url";
-import packageJson from "../../package.json" with { type: "json" };
-import { AgentsCommands } from "../commands/agents/AgentsCommands.js";
-import { GatewayAgentCommand } from "../commands/agents/GatewayAgentCommand.js";
-import { DocsCommands } from "../commands/docs/DocsCommands.js";
-import { JobsCommands } from "../commands/jobs/JobsCommands.js";
-import { OpenapiCommands } from "../commands/openapi/OpenapiCommands.js";
-import { CreateTasksCommand } from "../commands/planning/CreateTasksCommand.js";
-import { RefineTasksCommand } from "../commands/planning/RefineTasksCommand.js";
-import { BacklogCommands } from "../commands/backlog/BacklogCommands.js";
-import { TaskShowCommands } from "../commands/backlog/TaskShowCommands.js";
-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 { 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 { SetWorkspaceCommand } from "../commands/workspace/SetWorkspaceCommand.js";
-
-export class McodaEntrypoint {
-  static async run(argv: string[] = process.argv.slice(2)): Promise<void> {
-    const [command, ...rest] = argv;
-    const wantsJson = argv.some((arg) => arg === "--json" || arg.startsWith("--json="));
-    const wantsQuiet = argv.some((arg) => arg === "--quiet" || arg.startsWith("--quiet="));
-    if (wantsJson || wantsQuiet) {
-      process.env.MCODA_STREAM_IO = "0";
-    } else if (process.env.MCODA_STREAM_IO === undefined) {
-      process.env.MCODA_STREAM_IO = "1";
-    }
-    if (command === "--version" || command === "-v" || command === "version") {
-      // Keep this simple so `mcoda --version` works even in thin installs.
-      // eslint-disable-next-line no-console
-      console.log((packageJson as { version?: string }).version ?? "dev");
-      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" +
-          "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" +
-          "Jobs API required for job commands (set MCODA_API_BASE_URL/MCODA_JOBS_API_URL or workspace api.baseUrl). status/watch/logs exit non-zero on failed/cancelled jobs per SDS.",
-      );
-    }
-    if (command === "agent") {
-      await AgentsCommands.run(rest);
-      return;
-    }
-    if (command === "gateway-agent") {
-      await GatewayAgentCommand.run(rest);
-      return;
-    }
-    if (command === "test-agent") {
-      await TestAgentCommand.run(rest);
-      return;
-    }
-    if (command === "routing") {
-      await RoutingCommands.run(rest);
-      return;
-    }
-    if (command === "docs") {
-      await DocsCommands.run(rest);
-      return;
-    }
-    if (command === "openapi-from-docs" || command === "openapi") {
-      await OpenapiCommands.run(rest);
-      return;
-    }
-    if (command === "job" || command === "jobs") {
-      await JobsCommands.run(rest);
-      return;
-    }
-    if (command === "tokens") {
-      await TelemetryCommands.runTokens(rest);
-      return;
-    }
-    if (command === "telemetry") {
-      await TelemetryCommands.runTelemetry(rest);
-      return;
-    }
-    if (command === "pdr" || command === "mcoda:pdr") {
-      await DocsCommands.run(["pdr", "generate", ...rest]);
-      return;
-    }
-    if (command === "sds" || command === "mcoda:sds") {
-      await DocsCommands.run(["sds", "generate", ...rest]);
-      return;
-    }
-    if (command === "create-tasks") {
-      await CreateTasksCommand.run(rest);
-      return;
-    }
-    if (command === "migrate-tasks") {
-      await MigrateTasksCommand.run(rest);
-      return;
-    }
-    if (command === "refine-tasks") {
-      await RefineTasksCommand.run(rest);
-      return;
-    }
-    if (command === "qa-tasks") {
-      if (rest.includes("--help") || rest.includes("-h")) {
-        // eslint-disable-next-line no-console
-        console.log(
-          "Usage: mcoda qa-tasks [--workspace-root <path>] --project <PROJECT_KEY> [--task <TASK_KEY> ... | --epic <EPIC_KEY> | --story <STORY_KEY>] [--status <STATUS_FILTER>] [--mode auto|manual] [--profile <PROFILE_NAME>] [--level unit|integration|acceptance] [--test-command \"<CMD>\"] [--agent <NAME>] [--agent-stream true|false] [--resume <JOB_ID>] [--create-followup-tasks auto|none|prompt] [--result pass|fail|blocked] [--notes \"<text>\"] [--evidence-url \"<url>\"] [--dry-run] [--json]",
-        );
-        return;
-      }
-      await QaTasksCommand.run(rest);
-      return;
-    }
-    if (command === "order-tasks") {
-      await OrderTasksCommand.run(rest);
-      return;
-    }
-    if (command === "tasks") {
-      const [sub, ...tail] = rest;
-      if (sub === "order-by-deps" || sub === "order-by-dependencies") {
-        await OrderTasksCommand.run(tail);
-        return;
-      }
-    }
-    if (command === "work-on-tasks") {
-      await WorkOnTasksCommand.run(rest);
-      return;
-    }
-    if (command === "code-review") {
-      await CodeReviewCommand.run(rest);
-      return;
-    }
-    if (command === "backlog") {
-      await BacklogCommands.run(rest);
-      return;
-    }
-    if (command === "task" || command === "task-detail") {
-      await TaskShowCommands.run(rest);
-      return;
-    }
-    if (command === "estimate") {
-      await EstimateCommands.run(rest);
-      return;
-    }
-    if (command === "update") {
-      await UpdateCommands.run(rest);
-      return;
-    }
-    if (command === "set-workspace") {
-      await SetWorkspaceCommand.run(rest);
-      return;
-    }
-    throw new Error(`Unknown command: ${command}`);
-  }
-}
-
-const isDirectRun = (() => {
-  if (typeof process.argv[1] !== "string") {
-    return false;
-  }
-  try {
-    const invokedPath = realpathSync(process.argv[1]);
-    const modulePath = realpathSync(fileURLToPath(import.meta.url));
-    return invokedPath === modulePath;
-  } catch {
-    return false;
-  }
-})();
-
-if (isDirectRun) {
-  McodaEntrypoint.run().catch((error) => {
-    // eslint-disable-next-line no-console
-    console.error(error instanceof Error ? error.message : error);
-    process.exitCode = 1;
-  });
-}