mcoda 0.1.2 → 0.1.4

package/dist/commands/backlog/TaskShowCommands.js

@@ -0,0 +1,275 @@
+import path from "node:path";
+import YAML from "yaml";
+import { JobService, TaskDetailService, WorkspaceResolver } from "@mcoda/core";
+const usage = `mcoda task show <TASK_KEY> \\
+  [--project <PROJECT_KEY>] \\
+  [--include-logs] \\
+  [--include-history] \\
+  [--format <table|json|yaml>] (yaml output is experimental) \\
+  [--no-telemetry] \\
+  [--workspace-root <PATH>]
+
+Aliases:
+  mcoda task <TASK_KEY>
+  mcoda task-detail --project <PROJECT_KEY> --task <TASK_KEY>`;
+const parseFormat = (value) => {
+    if (!value)
+        return "table";
+    const normalized = value.toLowerCase();
+    if (normalized === "table" || normalized === "json" || normalized === "yaml")
+        return normalized;
+    throw new Error(`Unknown format "${value}". Allowed: table, json, yaml.`);
+};
+const cleanSnippet = (value, max = 180) => {
+    const condensed = value.replace(/\s+/g, " ").trim();
+    if (!condensed)
+        return "(empty)";
+    return condensed.length > max ? `${condensed.slice(0, max - 3)}...` : condensed;
+};
+const shortSha = (value) => {
+    if (!value)
+        return "-";
+    return value.length > 8 ? value.slice(0, 8) : value;
+};
+export const parseTaskShowArgs = (argv) => {
+    const parsed = {
+        includeLogs: false,
+        includeHistory: false,
+        format: "table",
+        noTelemetry: false,
+    };
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === "show" && !parsed.taskKey)
+            continue;
+        if (!arg.startsWith("-") && !parsed.taskKey) {
+            parsed.taskKey = arg;
+            continue;
+        }
+        switch (arg) {
+            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 "--task":
+                parsed.taskKey = argv[i + 1];
+                i += 1;
+                break;
+            case "--include-logs":
+                parsed.includeLogs = true;
+                break;
+            case "--include-history":
+                parsed.includeHistory = true;
+                break;
+            case "--no-telemetry":
+                parsed.noTelemetry = true;
+                break;
+            case "--format":
+                parsed.format = parseFormat(argv[i + 1]);
+                i += 1;
+                break;
+            case "--help":
+            case "-h":
+                // eslint-disable-next-line no-console
+                console.log(usage);
+                process.exit(0);
+                break;
+            default:
+                if (arg.startsWith("--project=")) {
+                    parsed.project = arg.split("=")[1];
+                }
+                else if (arg.startsWith("--task=")) {
+                    parsed.taskKey = arg.split("=")[1];
+                }
+                else if (arg.startsWith("--format=")) {
+                    parsed.format = parseFormat(arg.split("=")[1]);
+                }
+                else if (arg === "--json") {
+                    parsed.format = "json";
+                }
+                else if (arg === "--yaml") {
+                    parsed.format = "yaml";
+                }
+                else if (arg === "--include-logs=true") {
+                    parsed.includeLogs = true;
+                }
+                else if (arg === "--include-history=true") {
+                    parsed.includeHistory = true;
+                }
+                else if (arg === "--no-telemetry") {
+                    parsed.noTelemetry = true;
+                }
+                break;
+        }
+    }
+    return parsed;
+};
+const renderDependencies = (label, deps) => {
+    if (!deps.length)
+        return `${label}: none`;
+    const items = deps.map((dep) => `${dep.key} (${dep.status}; ${dep.relationType || "relation"})`);
+    return `${label}: ${items.join(", ")}`;
+};
+const renderTable = (detail) => {
+    const { task, dependencies, comments, logs, history } = detail;
+    const metadata = task.metadata;
+    const prUrl = typeof metadata?.pr_url === "string" ? metadata.pr_url : undefined;
+    const lines = [
+        `[${task.key}] ${task.title} — ${task.status} (Type: ${task.type ?? "-"}, SP: ${task.storyPoints ?? "-"}, Priority: ${task.priority ?? "-"})`,
+        `Project: ${task.project.key}${task.project.name ? ` – ${task.project.name}` : ""}`,
+        `Epic: ${task.epic.key} – ${task.epic.title}`,
+        `Story: ${task.story.key} – ${task.story.title}`,
+        `Assignee: ${task.assigneeHuman
+            ? `human:${task.assigneeHuman}`
+            : task.assignedAgentSlug
+                ? `agent:${task.assignedAgentSlug}`
+                : task.assignedAgentId
+                    ? `agent-id:${task.assignedAgentId}`
+                    : "-"}`,
+        "",
+        "Description:",
+        task.description ?? "(none)",
+        "",
+        "VCS:",
+        `  Branch: ${task.vcsBranch ?? "-"}`,
+        `  Base: ${task.vcsBaseBranch ?? "-"}`,
+        `  Last commit: ${shortSha(task.vcsLastCommitSha)}`,
+        prUrl ? `  PR: ${prUrl}` : "",
+        "",
+        "Dependencies:",
+        dependencies.upstream.length === 0 && dependencies.downstream.length === 0
+            ? "  No dependencies recorded."
+            : [
+                `  ${renderDependencies("Upstream", dependencies.upstream)}`,
+                `  ${renderDependencies("Downstream", dependencies.downstream)}`,
+            ].join("\n"),
+        "",
+        "Recent comments:",
+    ];
+    if (comments.length === 0) {
+        lines.push("  None.");
+    }
+    else {
+        for (const comment of comments) {
+            const origin = [comment.authorType, comment.sourceCommand, comment.category].filter(Boolean).join("/");
+            lines.push(`  - ${comment.createdAt} [${origin || "comment"}] ${cleanSnippet(comment.body)}`);
+        }
+    }
+    if (logs) {
+        lines.push("", "Recent logs:");
+        if (logs.length === 0) {
+            lines.push("  None.");
+        }
+        else {
+            for (const log of logs) {
+                const parts = [
+                    log.timestamp,
+                    log.command ? `cmd=${log.command}` : undefined,
+                    log.status ? `status=${log.status}` : undefined,
+                    log.level ? log.level.toUpperCase() : undefined,
+                    cleanSnippet(log.message ?? "", 120),
+                ].filter(Boolean);
+                lines.push(`  - ${parts.join(" | ")}`);
+            }
+        }
+    }
+    if (history) {
+        lines.push("", "History:");
+        if (history.length === 0) {
+            lines.push("  None.");
+        }
+        else {
+            for (const revision of history) {
+                const statusChange = revision.statusBefore || revision.statusAfter
+                    ? `${revision.statusBefore ?? "-"} → ${revision.statusAfter ?? "-"}`
+                    : undefined;
+                const spChange = revision.storyPointsBefore !== undefined || revision.storyPointsAfter !== undefined
+                    ? `${revision.storyPointsBefore ?? "-"} → ${revision.storyPointsAfter ?? "-"}`
+                    : undefined;
+                const parts = [
+                    revision.changedAt,
+                    statusChange ? `status ${statusChange}` : undefined,
+                    spChange ? `SP ${spChange}` : undefined,
+                    revision.changedFields?.length ? `fields: ${revision.changedFields.join(", ")}` : undefined,
+                ].filter(Boolean);
+                lines.push(`  - ${parts.join(" | ")}`);
+            }
+        }
+    }
+    // eslint-disable-next-line no-console
+    console.log(lines.join("\n"));
+};
+export class TaskShowCommands {
+    static async run(argv) {
+        let parsed;
+        try {
+            parsed = parseTaskShowArgs(argv);
+        }
+        catch (error) {
+            // eslint-disable-next-line no-console
+            console.error(error.message);
+            process.exitCode = 1;
+            return;
+        }
+        if (!parsed.taskKey) {
+            // eslint-disable-next-line no-console
+            console.error("Missing task key.\n");
+            // eslint-disable-next-line no-console
+            console.log(usage);
+            process.exitCode = 1;
+            return;
+        }
+        let service;
+        let jobService;
+        let commandRunId;
+        try {
+            const workspace = await WorkspaceResolver.resolveWorkspace({
+                cwd: process.cwd(),
+                explicitWorkspace: parsed.workspaceRoot,
+            });
+            service = await TaskDetailService.create(workspace);
+            jobService = new JobService(workspace, service.getRepository(), { noTelemetry: parsed.noTelemetry });
+            const commandRun = await jobService.startCommandRun("task-show", parsed.project);
+            commandRunId = commandRun.id;
+            const detail = await service.getTaskDetail({
+                taskKey: parsed.taskKey,
+                projectKey: parsed.project,
+                includeLogs: parsed.includeLogs,
+                includeHistory: parsed.includeHistory,
+            });
+            if (commandRunId) {
+                await jobService.finishCommandRun(commandRunId, "succeeded");
+            }
+            if (parsed.format === "json") {
+                // eslint-disable-next-line no-console
+                console.log(JSON.stringify(detail, null, 2));
+                return;
+            }
+            if (parsed.format === "yaml") {
+                // eslint-disable-next-line no-console
+                console.error("Note: YAML output is experimental; table/json are the primary supported formats.");
+                // eslint-disable-next-line no-console
+                console.log(YAML.stringify(detail));
+                return;
+            }
+            renderTable(detail);
+        }
+        catch (error) {
+            if (jobService && commandRunId) {
+                await jobService.finishCommandRun(commandRunId, "failed", error.message);
+            }
+            // eslint-disable-next-line no-console
+            console.error(`task show failed: ${error.message}`);
+            process.exitCode = 1;
+        }
+        finally {
+            if (service) {
+                await service.close();
+            }
+        }
+    }
+}

package/dist/commands/docs/DocsCommands.d.ts

@@ -0,0 +1,37 @@
+export interface ParsedPdrArgs {
+    workspaceRoot?: string;
+    projectKey?: string;
+    rfpId?: string;
+    rfpPath?: string;
+    outPath?: string;
+    agentName?: string;
+    agentStream: boolean;
+    dryRun: boolean;
+    json: boolean;
+    quiet: boolean;
+    debug: boolean;
+    noColor: boolean;
+    noTelemetry: boolean;
+}
+export interface ParsedSdsArgs {
+    workspaceRoot?: string;
+    projectKey?: string;
+    outPath?: string;
+    agentName?: string;
+    templateName?: string;
+    agentStream: boolean;
+    force: boolean;
+    resumeJobId?: string;
+    dryRun: boolean;
+    json: boolean;
+    quiet: boolean;
+    debug: boolean;
+    noColor: boolean;
+    noTelemetry: boolean;
+}
+export declare const parsePdrArgs: (argv: string[]) => ParsedPdrArgs;
+export declare const parseSdsArgs: (argv: string[]) => ParsedSdsArgs;
+export declare class DocsCommands {
+    static run(argv: string[]): Promise<void>;
+}
+//# sourceMappingURL=DocsCommands.d.ts.map

package/dist/commands/docs/DocsCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocsCommands.d.ts","sourceRoot":"","sources":["../../../src/commands/docs/DocsCommands.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,aAAa;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;CACtB;AAUD,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,EAAE,KAAG,aAkG7C,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,EAAE,KAAG,aAkG7C,CAAC;AASF,qBAAa,YAAY;WACV,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CA6JhD"}

package/dist/commands/docs/DocsCommands.js

@@ -0,0 +1,381 @@
+import path from "node:path";
+import { DocsService, WorkspaceResolver } from "@mcoda/core";
+const pdrUsage = `mcoda docs pdr generate --rfp-path <FILE> [--workspace-root <PATH>] [--project <KEY>] [--out <FILE>] [--agent <NAME>] [--agent-stream <true|false>] [--rfp-id <ID>] [--json] [--dry-run] [--debug] [--no-color] [--quiet] [--no-telemetry]`;
+const sdsUsage = `mcoda docs sds generate [--workspace-root <PATH>] [--project <KEY>] [--out <FILE>] [--agent <NAME>] [--template <NAME>] [--agent-stream <true|false>] [--force] [--resume <JOB_ID>] [--json] [--dry-run] [--debug] [--no-color] [--quiet] [--no-telemetry]`;
+const parseBooleanFlag = (value, defaultValue) => {
+    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 parsePdrArgs = (argv) => {
+    let workspaceRoot;
+    let projectKey;
+    let rfpId;
+    let rfpPath;
+    let outPath;
+    let agentName;
+    let agentStream;
+    let dryRun = false;
+    let json = false;
+    let quiet = false;
+    let debug = false;
+    let noColor = false;
+    let noTelemetry = false;
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        switch (arg) {
+            case "--workspace-root":
+                workspaceRoot = argv[i + 1] ? path.resolve(argv[i + 1]) : undefined;
+                i += 1;
+                break;
+            case "--project":
+                projectKey = argv[i + 1];
+                i += 1;
+                break;
+            case "--rfp-id":
+                rfpId = argv[i + 1];
+                i += 1;
+                break;
+            case "--rfp-path":
+                rfpPath = argv[i + 1];
+                i += 1;
+                break;
+            case "--out":
+                outPath = 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 "--json":
+                json = true;
+                break;
+            case "--dry-run":
+                dryRun = true;
+                break;
+            case "--quiet":
+                quiet = true;
+                break;
+            case "--debug":
+                debug = true;
+                break;
+            case "--no-color":
+                noColor = true;
+                break;
+            case "--no-telemetry":
+                noTelemetry = true;
+                break;
+            case "--no-telemetry":
+                noTelemetry = true;
+                break;
+            case "--help":
+            case "-h":
+                // eslint-disable-next-line no-console
+                console.log(pdrUsage);
+                process.exit(0);
+            default:
+                break;
+        }
+    }
+    return {
+        workspaceRoot,
+        projectKey,
+        rfpId,
+        rfpPath,
+        outPath,
+        agentName,
+        agentStream: agentStream ?? true,
+        dryRun,
+        json,
+        quiet,
+        debug,
+        noColor,
+        noTelemetry,
+    };
+};
+export const parseSdsArgs = (argv) => {
+    let workspaceRoot;
+    let projectKey;
+    let outPath;
+    let agentName;
+    let templateName;
+    let agentStream;
+    let force = false;
+    let resumeJobId;
+    let dryRun = false;
+    let json = false;
+    let quiet = false;
+    let debug = false;
+    let noColor = false;
+    let noTelemetry = false;
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        switch (arg) {
+            case "--workspace-root":
+                workspaceRoot = argv[i + 1] ? path.resolve(argv[i + 1]) : undefined;
+                i += 1;
+                break;
+            case "--project":
+                projectKey = argv[i + 1];
+                i += 1;
+                break;
+            case "--out":
+                outPath = argv[i + 1];
+                i += 1;
+                break;
+            case "--agent":
+                agentName = argv[i + 1];
+                i += 1;
+                break;
+            case "--template":
+                templateName = 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 "--resume":
+            case "--job-id":
+                resumeJobId = argv[i + 1];
+                i += 1;
+                break;
+            case "--json":
+                json = true;
+                break;
+            case "--dry-run":
+                dryRun = true;
+                break;
+            case "--quiet":
+                quiet = true;
+                break;
+            case "--debug":
+                debug = true;
+                break;
+            case "--no-color":
+                noColor = true;
+                break;
+            case "--help":
+            case "-h":
+                // eslint-disable-next-line no-console
+                console.log(sdsUsage);
+                process.exit(0);
+            default:
+                break;
+        }
+    }
+    return {
+        workspaceRoot,
+        projectKey,
+        outPath,
+        agentName,
+        templateName,
+        agentStream: agentStream ?? true,
+        force,
+        resumeJobId,
+        dryRun,
+        json,
+        quiet,
+        debug,
+        noColor,
+        noTelemetry,
+    };
+};
+const printWarnings = (warnings) => {
+    if (warnings.length === 0)
+        return;
+    const banner = warnings.map((w) => `! ${w}`).join("\n");
+    // eslint-disable-next-line no-console
+    console.warn(banner);
+};
+export class DocsCommands {
+    static async run(argv) {
+        let service;
+        try {
+            let args = [...argv];
+            if (args[0] === "sds") {
+                args = args.slice(1);
+                if (args[0] === "generate")
+                    args = args.slice(1);
+                const parsed = parseSdsArgs(args);
+                const workspace = await WorkspaceResolver.resolveWorkspace({
+                    cwd: process.cwd(),
+                    explicitWorkspace: parsed.workspaceRoot,
+                });
+                if (parsed.debug) {
+                    // eslint-disable-next-line no-console
+                    console.error(`[debug] workspace resolved: ${workspace.workspaceRoot}`);
+                }
+                service = await DocsService.create(workspace, { noTelemetry: parsed.noTelemetry });
+                const shouldStream = parsed.agentStream && !parsed.json && !parsed.quiet;
+                const onToken = shouldStream ? (token) => process.stdout.write(token) : undefined;
+                const result = await service.generateSds({
+                    workspace,
+                    projectKey: parsed.projectKey,
+                    outPath: parsed.outPath,
+                    agentName: parsed.agentName,
+                    templateName: parsed.templateName,
+                    agentStream: parsed.agentStream,
+                    dryRun: parsed.dryRun,
+                    json: parsed.json,
+                    force: parsed.force,
+                    resumeJobId: parsed.resumeJobId,
+                    onToken,
+                });
+                if (parsed.json) {
+                    const payload = {
+                        jobId: result.jobId,
+                        commandRunId: result.commandRunId,
+                        outputPath: result.outputPath,
+                        docdexId: result.docdexId,
+                        warnings: result.warnings,
+                    };
+                    // eslint-disable-next-line no-console
+                    console.log(JSON.stringify(payload, null, 2));
+                    return;
+                }
+                if (shouldStream) {
+                    // eslint-disable-next-line no-console
+                    console.log("\n");
+                }
+                // eslint-disable-next-line no-console
+                console.log(`SDS job ${result.jobId} completed.`);
+                if (result.outputPath) {
+                    // eslint-disable-next-line no-console
+                    console.log(`Output: ${result.outputPath}${parsed.dryRun ? " (dry run, not written)" : ""}`);
+                }
+                else {
+                    // eslint-disable-next-line no-console
+                    console.log("Dry run: draft not written to disk.");
+                }
+                if (result.docdexId) {
+                    // eslint-disable-next-line no-console
+                    console.log(`Docdex ID: ${result.docdexId}`);
+                }
+                printWarnings(result.warnings);
+                if (parsed.dryRun && !parsed.quiet) {
+                    // eslint-disable-next-line no-console
+                    console.log("\n--- Draft Preview ---\n");
+                    // eslint-disable-next-line no-console
+                    console.log(result.draft);
+                }
+                if (parsed.debug) {
+                    // eslint-disable-next-line no-console
+                    console.error("[debug] Completed docs:sds generate");
+                }
+                return;
+            }
+            if (args[0] === "pdr")
+                args = args.slice(1);
+            if (args[0] === "generate")
+                args = args.slice(1);
+            const parsed = parsePdrArgs(args);
+            if (!parsed.rfpId && !parsed.rfpPath) {
+                throw new Error(`Missing --rfp-id or --rfp-path\n\n${pdrUsage}`);
+            }
+            const workspace = await WorkspaceResolver.resolveWorkspace({
+                cwd: process.cwd(),
+                explicitWorkspace: parsed.workspaceRoot,
+            });
+            if (parsed.debug) {
+                // eslint-disable-next-line no-console
+                console.error(`[debug] workspace resolved: ${workspace.workspaceRoot}`);
+            }
+            service = await DocsService.create(workspace, { noTelemetry: parsed.noTelemetry });
+            const shouldStream = parsed.agentStream && !parsed.json && !parsed.quiet;
+            const onToken = shouldStream ? (token) => process.stdout.write(token) : undefined;
+            const result = await service.generatePdr({
+                workspace,
+                projectKey: parsed.projectKey,
+                rfpId: parsed.rfpId,
+                rfpPath: parsed.rfpPath,
+                outPath: parsed.outPath,
+                agentName: parsed.agentName,
+                agentStream: parsed.agentStream,
+                dryRun: parsed.dryRun,
+                json: parsed.json,
+                onToken,
+            });
+            if (parsed.json) {
+                const payload = {
+                    jobId: result.jobId,
+                    commandRunId: result.commandRunId,
+                    outputPath: result.outputPath,
+                    docdexId: result.docdexId,
+                    warnings: result.warnings,
+                };
+                // eslint-disable-next-line no-console
+                console.log(JSON.stringify(payload, null, 2));
+                return;
+            }
+            if (shouldStream) {
+                // separate streamed content from summary
+                // eslint-disable-next-line no-console
+                console.log("\n");
+            }
+            // eslint-disable-next-line no-console
+            console.log(`PDR job ${result.jobId} completed.`);
+            if (result.outputPath) {
+                // eslint-disable-next-line no-console
+                console.log(`Output: ${result.outputPath}${parsed.dryRun ? " (dry run, not written)" : ""}`);
+            }
+            else {
+                // eslint-disable-next-line no-console
+                console.log("Dry run: draft not written to disk.");
+            }
+            if (result.docdexId) {
+                // eslint-disable-next-line no-console
+                console.log(`Docdex ID: ${result.docdexId}`);
+            }
+            printWarnings(result.warnings);
+            if (parsed.dryRun && !parsed.quiet) {
+                // eslint-disable-next-line no-console
+                console.log("\n--- Draft Preview ---\n");
+                // eslint-disable-next-line no-console
+                console.log(result.draft);
+            }
+            if (parsed.debug) {
+                // eslint-disable-next-line no-console
+                console.error("[debug] Completed docs:pdr generate");
+            }
+        }
+        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 {
+            if (service) {
+                await service.close();
+            }
+        }
+    }
+}