mcoda 0.1.2 → 0.1.4

package/packages/cli/src/commands/openapi/OpenapiCommands.ts

@@ -1,167 +0,0 @@
-import path from "node:path";
-import { createRequire } from "node:module";
-import { OpenApiService, WorkspaceResolver } from "@mcoda/core";
-
-const usage =
-  "mcoda openapi-from-docs [--workspace-root <PATH>] [--agent <NAME>] [--agent-stream <true|false>] [--force] [--dry-run] [--validate-only] [--no-telemetry]";
-
-export interface ParsedOpenapiArgs {
-  workspaceRoot?: string;
-  agentName?: string;
-  agentStream: boolean;
-  force: boolean;
-  dryRun: boolean;
-  validateOnly: boolean;
-  noTelemetry: boolean;
-}
-
-const parseBooleanFlag = (value: string | undefined, defaultValue: boolean): boolean => {
-  if (value === undefined) return defaultValue;
-  const normalized = value.toLowerCase();
-  if (["false", "0", "no"].includes(normalized)) return false;
-  if (["true", "1", "yes"].includes(normalized)) return true;
-  return defaultValue;
-};
-
-export const parseOpenapiArgs = (argv: string[]): ParsedOpenapiArgs => {
-  let workspaceRoot: string | undefined;
-  let agentName: string | undefined;
-  let agentStream: boolean | undefined;
-  let force = false;
-  let dryRun = false;
-  let validateOnly = false;
-  let noTelemetry = false;
-
-  for (let i = 0; i < argv.length; i += 1) {
-    const arg = argv[i];
-    if (arg.startsWith("--agent-stream=")) {
-      const [, raw] = arg.split("=", 2);
-      agentStream = parseBooleanFlag(raw, true);
-      continue;
-    }
-    switch (arg) {
-      case "--workspace-root":
-        workspaceRoot = argv[i + 1] ? path.resolve(argv[i + 1]) : undefined;
-        i += 1;
-        break;
-      case "--agent":
-        agentName = argv[i + 1];
-        i += 1;
-        break;
-      case "--agent-stream": {
-        const next = argv[i + 1];
-        if (next && !next.startsWith("--")) {
-          agentStream = parseBooleanFlag(next, true);
-          i += 1;
-        } else {
-          agentStream = true;
-        }
-        break;
-      }
-      case "--force":
-        force = true;
-        break;
-      case "--dry-run":
-        dryRun = true;
-        break;
-      case "--validate-only":
-        validateOnly = true;
-        break;
-      case "--no-telemetry":
-        noTelemetry = true;
-        break;
-      case "--help":
-      case "-h":
-        // eslint-disable-next-line no-console
-        console.log(usage);
-        process.exit(0);
-        break;
-      default:
-        break;
-    }
-  }
-
-  return {
-    workspaceRoot,
-    agentName,
-    agentStream: agentStream ?? true,
-    force,
-    dryRun,
-    validateOnly,
-    noTelemetry,
-  };
-};
-
-const readCliVersion = (): string => {
-  const require = createRequire(import.meta.url);
-  try {
-    // Resolve the package version from the CLI package.json
-    // eslint-disable-next-line @typescript-eslint/no-var-requires
-    const pkg = require("../../package.json") as { version?: string };
-    return pkg.version ?? "0.0.0";
-  } catch {
-    return "0.0.0";
-  }
-};
-
-export class OpenapiCommands {
-  static async run(argv: string[]): Promise<void> {
-    const parsed = parseOpenapiArgs(argv);
-    const workspace = await WorkspaceResolver.resolveWorkspace({
-      cwd: process.cwd(),
-      explicitWorkspace: parsed.workspaceRoot,
-    });
-    const service = await OpenApiService.create(workspace, { noTelemetry: parsed.noTelemetry });
-    try {
-      const cliVersion = readCliVersion();
-      const shouldStream = parsed.agentStream;
-      const onToken = shouldStream ? (token: string) => process.stdout.write(token) : undefined;
-      const result = await service.generateFromDocs({
-        workspace,
-        agentName: parsed.agentName,
-        agentStream: parsed.agentStream,
-        force: parsed.force,
-        dryRun: parsed.dryRun,
-        validateOnly: parsed.validateOnly,
-        cliVersion,
-        onToken,
-      });
-      if (shouldStream) {
-        // separate streamed content from the summary
-        // eslint-disable-next-line no-console
-        console.log("\n");
-      }
-      // eslint-disable-next-line no-console
-      console.log(`OpenAPI job ${result.jobId} ${parsed.validateOnly ? "validated" : "completed"}.`);
-      if (result.outputPath) {
-        // eslint-disable-next-line no-console
-        console.log(`Output: ${result.outputPath}${parsed.dryRun ? " (dry run, not written)" : ""}`);
-      } else if (parsed.dryRun) {
-        // eslint-disable-next-line no-console
-        console.log("Dry run: spec not written to disk.");
-      }
-      if (result.docdexId) {
-        // eslint-disable-next-line no-console
-        console.log(`Docdex ID: ${result.docdexId}`);
-      }
-      if (result.warnings.length) {
-        const banner = result.warnings.map((w) => `! ${w}`).join("\n");
-        // eslint-disable-next-line no-console
-        console.warn(banner);
-      }
-      if (parsed.dryRun) {
-        // eslint-disable-next-line no-console
-        console.log("\n--- Generated OpenAPI ---\n");
-        // eslint-disable-next-line no-console
-        console.log(result.spec);
-      }
-    } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      // eslint-disable-next-line no-console
-      console.error(`ERROR: ${message}`);
-      process.exitCode = 1;
-    } finally {
-      await service.close();
-    }
-  }
-}

package/packages/cli/src/commands/planning/CreateTasksCommand.ts

@@ -1,149 +0,0 @@
-import path from "node:path";
-import { CreateTasksService, WorkspaceResolver } from "@mcoda/core";
-import { PathHelper } from "@mcoda/shared";
-
-interface ParsedArgs {
-  workspaceRoot?: string;
-  projectKey?: string;
-  agentName?: string;
-  agentStream: boolean;
-  maxEpics?: number;
-  maxStoriesPerEpic?: number;
-  maxTasksPerStory?: number;
-  quiet?: boolean;
-  inputs: string[];
-}
-
-const usage = `mcoda create-tasks [INPUT...] [--workspace-root <path>] [--project-key <key>] [--agent <name>] [--agent-stream [true|false]] [--max-epics N] [--max-stories-per-epic N] [--max-tasks-per-story N] [--quiet]`;
-
-const parseBooleanFlag = (value: string | undefined, defaultValue: boolean): boolean => {
-  if (value === undefined) return defaultValue;
-  const normalized = value.toLowerCase();
-  if (["false", "0", "no"].includes(normalized)) return false;
-  if (["true", "1", "yes"].includes(normalized)) return true;
-  return defaultValue;
-};
-
-export const parseCreateTasksArgs = (argv: string[]): ParsedArgs => {
-  const inputs: string[] = [];
-  let workspaceRoot: string | undefined;
-  let projectKey: string | undefined;
-  let agentName: string | undefined;
-  let agentStream: boolean | undefined;
-  let maxEpics: number | undefined;
-  let maxStoriesPerEpic: number | undefined;
-  let maxTasksPerStory: number | undefined;
-  let quiet = false;
-
-  for (let i = 0; i < argv.length; i += 1) {
-    const arg = argv[i];
-    if (arg.startsWith("--")) {
-      switch (arg) {
-        case "--workspace-root":
-          workspaceRoot = argv[i + 1] ? path.resolve(argv[i + 1]) : undefined;
-          i += 1;
-          break;
-        case "--project-key":
-        case "--project":
-          projectKey = argv[i + 1];
-          i += 1;
-          break;
-        case "--agent":
-          agentName = argv[i + 1];
-          i += 1;
-          break;
-        case "--agent-stream": {
-          const next = argv[i + 1];
-          if (next && !next.startsWith("--")) {
-            agentStream = parseBooleanFlag(next, true);
-            i += 1;
-          } else {
-            agentStream = true;
-          }
-          break;
-        }
-        case "--max-epics":
-          maxEpics = Number(argv[i + 1]);
-          i += 1;
-          break;
-        case "--max-stories-per-epic":
-          maxStoriesPerEpic = Number(argv[i + 1]);
-          i += 1;
-          break;
-        case "--max-tasks-per-story":
-          maxTasksPerStory = Number(argv[i + 1]);
-          i += 1;
-          break;
-        case "--quiet":
-          quiet = true;
-          break;
-        case "--help":
-        case "-h":
-          // eslint-disable-next-line no-console
-          console.log(usage);
-          process.exit(0);
-          break;
-        default:
-          break;
-      }
-    } else {
-      inputs.push(arg);
-    }
-  }
-
-  return {
-    workspaceRoot,
-    projectKey,
-    agentName,
-    agentStream: agentStream ?? true,
-    maxEpics: Number.isFinite(maxEpics) ? maxEpics : undefined,
-    maxStoriesPerEpic: Number.isFinite(maxStoriesPerEpic) ? maxStoriesPerEpic : undefined,
-    maxTasksPerStory: Number.isFinite(maxTasksPerStory) ? maxTasksPerStory : undefined,
-    quiet,
-    inputs,
-  };
-};
-
-export class CreateTasksCommand {
-  static async run(argv: string[]): Promise<void> {
-    const parsed = parseCreateTasksArgs(argv);
-    const workspace = await WorkspaceResolver.resolveWorkspace({
-      cwd: process.cwd(),
-      explicitWorkspace: parsed.workspaceRoot,
-    });
-    const derivedKey = path.basename(workspace.workspaceRoot).replace(/[^a-z0-9]+/gi, "").toLowerCase();
-    const projectKey = parsed.projectKey ?? (derivedKey || "proj");
-    const service = await CreateTasksService.create(workspace);
-
-    try {
-      const result = await service.createTasks({
-        workspace,
-        projectKey,
-        inputs: parsed.inputs,
-        agentName: parsed.agentName,
-        agentStream: parsed.agentStream,
-        maxEpics: parsed.maxEpics,
-        maxStoriesPerEpic: parsed.maxStoriesPerEpic,
-        maxTasksPerStory: parsed.maxTasksPerStory,
-      });
-
-      const dbPath = PathHelper.getWorkspaceDbPath(workspace.workspaceRoot);
-      if (!parsed.quiet) {
-        // eslint-disable-next-line no-console
-        console.log(
-          [
-            `Created ${result.epics.length} epics, ${result.stories.length} stories, ${result.tasks.length} tasks, ${result.dependencies.length} dependencies.`,
-            `Stored in ${dbPath}.`,
-            `Job ID: ${result.jobId}, Command Run: ${result.commandRunId}`,
-          ].join("\n"),
-        );
-      }
-    } catch (error) {
-      // eslint-disable-next-line no-console
-      console.error(`create-tasks failed: ${(error as Error).message}`);
-      process.exitCode = 1;
-    } finally {
-      await service.close();
-    }
-  }
-}

package/packages/cli/src/commands/planning/MigrateTasksCommand.ts

@@ -1,105 +0,0 @@
-import path from "node:path";
-import { CreateTasksService, WorkspaceResolver } from "@mcoda/core";
-
-const usage = `mcoda migrate-tasks [--workspace-root <path>] [--project-key <key>] [--plan-dir <path>] [--refine-plan <path>] [--refine-plans-dir <path>] [--quiet]`;
-
-export interface ParsedMigrateTasksArgs {
-  workspaceRoot?: string;
-  projectKey?: string;
-  planDir?: string;
-  refinePlans: string[];
-  refinePlansDir?: string;
-  force: boolean;
-  quiet: boolean;
-  help: boolean;
-}
-
-export const parseMigrateTasksArgs = (argv: string[]): ParsedMigrateTasksArgs => {
-  const args: ParsedMigrateTasksArgs = {
-    refinePlans: [],
-    force: false,
-    quiet: false,
-    help: false,
-  };
-  for (let i = 0; i < argv.length; i++) {
-    const arg = argv[i];
-    if (arg === "--workspace-root" && argv[i + 1]) {
-      args.workspaceRoot = argv[++i];
-    } else if ((arg === "--project" || arg === "--project-key") && argv[i + 1]) {
-      args.projectKey = argv[++i];
-    } else if (arg === "--plan-dir" && argv[i + 1]) {
-      args.planDir = argv[++i];
-    } else if (arg === "--refine-plan" && argv[i + 1]) {
-      args.refinePlans.push(argv[++i]);
-    } else if (arg === "--refine-plans-dir" && argv[i + 1]) {
-      args.refinePlansDir = argv[++i];
-    } else if (arg === "--force") {
-      args.force = true;
-    } else if (arg === "--quiet") {
-      args.quiet = true;
-    } else if (arg === "--help" || arg === "-h") {
-      args.help = true;
-    }
-  }
-  return args;
-};
-
-export class MigrateTasksCommand {
-  static async run(argv: string[]): Promise<void> {
-    const args = parseMigrateTasksArgs(argv);
-    if (args.help) {
-      console.log(usage);
-      return;
-    }
-
-    const workspace = await WorkspaceResolver.resolveWorkspace({
-      cwd: process.cwd(),
-      explicitWorkspace: args.workspaceRoot ?? undefined,
-    });
-    const workspaceRoot = workspace.workspaceRoot;
-    const derivedKey = path.basename(workspaceRoot).replace(/[^a-z0-9]+/gi, "").toLowerCase();
-    const projectKey = args.projectKey ?? (derivedKey || "proj");
-    const planDir = args.planDir;
-
-    if (!projectKey) {
-      console.error("Project key is required. Use --project-key <key>.");
-      process.exitCode = 1;
-      return;
-    }
-
-    const service = await CreateTasksService.create(workspace);
-
-    try {
-      const result = await service.migratePlanFromFolder({
-        projectKey,
-        planDir,
-        force: args.force,
-        refinePlanPaths: args.refinePlans.length ? args.refinePlans : undefined,
-        refinePlansDir: args.refinePlansDir,
-      });
-      if (!args.quiet) {
-        console.log(
-          [
-            `Migrated plan from ${planDir ?? path.join(workspaceRoot, ".mcoda", "tasks", projectKey)}`,
-            `Epics: ${result.epics.length}`,
-            `Stories: ${result.stories.length}`,
-            `Tasks: ${result.tasks.length}`,
-            `Dependencies: ${result.dependencies.length}`,
-          ].join("\n"),
-        );
-      }
-    } catch (error) {
-      console.error(`migrate-tasks failed: ${(error as Error).message}`);
-      process.exitCode = 1;
-    } finally {
-      try {
-        await service.close();
-      } catch (error) {
-        const msg = (error as Error).message ?? "";
-        if (!msg.includes("database is closed")) {
-          throw error;
-        }
-      }
-    }
-  }
-}

package/packages/cli/src/commands/planning/PlanningCommands.ts

@@ -1 +0,0 @@
-export class PlanningCommands {}