postgresai 0.15.0-dev.1 → 0.15.0-dev.2

package/dist/bin/postgres-ai.js

@@ -13064,7 +13064,7 @@ var {
 // package.json
 var package_default = {
   name: "postgresai",
-  version: "0.15.0-dev.1",
+  version: "0.15.0-dev.2",
   description: "postgres_ai CLI",
   license: "Apache-2.0",
   private: false,
@@ -15892,7 +15892,7 @@ var Result = import_lib.default.Result;
 var TypeOverrides = import_lib.default.TypeOverrides;
 var defaults = import_lib.default.defaults;
 // package.json
-var version = "0.15.0-dev.1";
+var version = "0.15.0-dev.2";
 var package_default2 = {
   name: "postgresai",
   version,
@@ -16709,6 +16709,192 @@ async function updateActionItem(params) {
   }
 }
 
+// lib/reports.ts
+function parseFlexibleDate(input) {
+  const s = input.trim();
+  const dotMatch = s.match(/^(\d{1,2})\.(\d{1,2})\.(\d{4})(?:\s+(\d{1,2}):(\d{2})(?::(\d{2}))?)?$/);
+  if (dotMatch) {
+    const [, dd, mm, yyyy, hh, min, ss] = dotMatch;
+    const iso = `${yyyy}-${mm.padStart(2, "0")}-${dd.padStart(2, "0")}T${(hh ?? "00").padStart(2, "0")}:${(min ?? "00").padStart(2, "0")}:${(ss ?? "00").padStart(2, "0")}Z`;
+    const d = new Date(iso);
+    if (isNaN(d.getTime()))
+      throw new Error(`Invalid date: ${input}`);
+    return d.toISOString();
+  }
+  const isoMatch = s.match(/^(\d{4})-(\d{2})-(\d{2})(?:[T ](\d{2}):(\d{2})(?::(\d{2}))?)?$/);
+  if (isoMatch) {
+    const [, yyyy, mm, dd, hh, min, ss] = isoMatch;
+    const iso = `${yyyy}-${mm}-${dd}T${hh ?? "00"}:${min ?? "00"}:${ss ?? "00"}Z`;
+    const d = new Date(iso);
+    if (isNaN(d.getTime()))
+      throw new Error(`Invalid date: ${input}`);
+    return d.toISOString();
+  }
+  throw new Error(`Unrecognized date format: ${input}. Use YYYY-MM-DD or DD.MM.YYYY`);
+}
+async function fetchReports(params) {
+  const { apiKey, apiBaseUrl, projectId, status, limit = 20, beforeDate, beforeId, debug } = params;
+  if (!apiKey) {
+    throw new Error("API key is required");
+  }
+  const base = normalizeBaseUrl(apiBaseUrl);
+  const url = new URL(`${base}/checkup_reports`);
+  url.searchParams.set("order", "id.desc");
+  url.searchParams.set("limit", String(limit));
+  if (typeof projectId === "number") {
+    url.searchParams.set("project_id", `eq.${projectId}`);
+  }
+  if (status) {
+    url.searchParams.set("status", `eq.${status}`);
+  }
+  if (beforeDate) {
+    url.searchParams.set("created_at", `lt.${beforeDate}`);
+  }
+  if (typeof beforeId === "number") {
+    url.searchParams.set("id", `lt.${beforeId}`);
+  }
+  const headers = {
+    "access-token": apiKey,
+    Prefer: "return=representation",
+    "Content-Type": "application/json",
+    Connection: "close"
+  };
+  if (debug) {
+    const debugHeaders = { ...headers, "access-token": maskSecret(apiKey) };
+    console.log(`Debug: Resolved API base URL: ${base}`);
+    console.log(`Debug: GET URL: ${url.toString()}`);
+    console.log(`Debug: Request headers: ${JSON.stringify(debugHeaders)}`);
+  }
+  const response = await fetch(url.toString(), { method: "GET", headers });
+  if (debug) {
+    console.log(`Debug: Response status: ${response.status}`);
+  }
+  const data = await response.text();
+  if (response.ok) {
+    try {
+      return JSON.parse(data);
+    } catch {
+      throw new Error(`Failed to parse reports response: ${data}`);
+    }
+  } else {
+    throw new Error(formatHttpError("Failed to fetch reports", response.status, data));
+  }
+}
+var MAX_ALL_REPORTS = 1e4;
+async function fetchAllReports(params) {
+  const pageSize = params.limit ?? 100;
+  const all = [];
+  let beforeId;
+  while (true) {
+    const page = await fetchReports({ ...params, limit: pageSize, beforeId });
+    if (page.length === 0)
+      break;
+    all.push(...page);
+    if (all.length >= MAX_ALL_REPORTS) {
+      console.warn(`Warning: reached maximum of ${MAX_ALL_REPORTS} reports, stopping pagination`);
+      break;
+    }
+    beforeId = page[page.length - 1].id;
+    if (page.length < pageSize)
+      break;
+  }
+  return all;
+}
+async function fetchReportFiles(params) {
+  const { apiKey, apiBaseUrl, reportId, type: type2, checkId, debug } = params;
+  if (!apiKey) {
+    throw new Error("API key is required");
+  }
+  if (reportId === undefined && !checkId) {
+    throw new Error("Either reportId or checkId is required");
+  }
+  const base = normalizeBaseUrl(apiBaseUrl);
+  const url = new URL(`${base}/checkup_report_files`);
+  if (typeof reportId === "number") {
+    url.searchParams.set("checkup_report_id", `eq.${reportId}`);
+  }
+  url.searchParams.set("order", "id.asc");
+  if (type2) {
+    url.searchParams.set("type", `eq.${type2}`);
+  }
+  if (checkId) {
+    url.searchParams.set("check_id", `eq.${checkId}`);
+  }
+  const headers = {
+    "access-token": apiKey,
+    Prefer: "return=representation",
+    "Content-Type": "application/json",
+    Connection: "close"
+  };
+  if (debug) {
+    const debugHeaders = { ...headers, "access-token": maskSecret(apiKey) };
+    console.log(`Debug: Resolved API base URL: ${base}`);
+    console.log(`Debug: GET URL: ${url.toString()}`);
+    console.log(`Debug: Request headers: ${JSON.stringify(debugHeaders)}`);
+  }
+  const response = await fetch(url.toString(), { method: "GET", headers });
+  if (debug) {
+    console.log(`Debug: Response status: ${response.status}`);
+  }
+  const data = await response.text();
+  if (response.ok) {
+    try {
+      return JSON.parse(data);
+    } catch {
+      throw new Error(`Failed to parse report files response: ${data}`);
+    }
+  } else {
+    throw new Error(formatHttpError("Failed to fetch report files", response.status, data));
+  }
+}
+async function fetchReportFileData(params) {
+  const { apiKey, apiBaseUrl, reportId, type: type2, checkId, debug } = params;
+  if (!apiKey) {
+    throw new Error("API key is required");
+  }
+  if (reportId === undefined && !checkId) {
+    throw new Error("Either reportId or checkId is required");
+  }
+  const base = normalizeBaseUrl(apiBaseUrl);
+  const url = new URL(`${base}/checkup_report_file_data`);
+  if (typeof reportId === "number") {
+    url.searchParams.set("checkup_report_id", `eq.${reportId}`);
+  }
+  url.searchParams.set("order", "id.asc");
+  if (type2) {
+    url.searchParams.set("type", `eq.${type2}`);
+  }
+  if (checkId) {
+    url.searchParams.set("check_id", `eq.${checkId}`);
+  }
+  const headers = {
+    "access-token": apiKey,
+    Prefer: "return=representation",
+    "Content-Type": "application/json",
+    Connection: "close"
+  };
+  if (debug) {
+    const debugHeaders = { ...headers, "access-token": maskSecret(apiKey) };
+    console.log(`Debug: Resolved API base URL: ${base}`);
+    console.log(`Debug: GET URL: ${url.toString()}`);
+    console.log(`Debug: Request headers: ${JSON.stringify(debugHeaders)}`);
+  }
+  const response = await fetch(url.toString(), { method: "GET", headers });
+  if (debug) {
+    console.log(`Debug: Response status: ${response.status}`);
+  }
+  const data = await response.text();
+  if (response.ok) {
+    try {
+      return JSON.parse(data);
+    } catch {
+      throw new Error(`Failed to parse report file data response: ${data}`);
+    }
+  } else {
+    throw new Error(formatHttpError("Failed to fetch report file data", response.status, data));
+  }
+}
+
 // node_modules/zod/v4/core/core.js
 var NEVER = Object.freeze({
   status: "aborted"
@@ -23770,6 +23956,46 @@ async function handleToolCall(req, rootOpts, extra) {
       await updateActionItem({ apiKey, apiBaseUrl, actionItemId, title, description, isDone, status, statusReason, debug });
       return { content: [{ type: "text", text: JSON.stringify({ success: true }, null, 2) }] };
     }
+    if (toolName === "list_reports") {
+      const projectId = args.project_id !== undefined ? Number(args.project_id) : undefined;
+      const status = args.status ? String(args.status) : undefined;
+      const limit = args.limit !== undefined ? Number(args.limit) : undefined;
+      const beforeDate = args.before_date ? parseFlexibleDate(String(args.before_date)) : undefined;
+      const all = args.all === true;
+      let reports;
+      if (all) {
+        reports = await fetchAllReports({ apiKey, apiBaseUrl, projectId, status, limit, debug });
+      } else {
+        reports = await fetchReports({ apiKey, apiBaseUrl, projectId, status, limit, beforeDate, debug });
+      }
+      return { content: [{ type: "text", text: JSON.stringify(reports, null, 2) }] };
+    }
+    if (toolName === "list_report_files") {
+      const reportId = args.report_id !== undefined ? Number(args.report_id) : undefined;
+      if (reportId !== undefined && isNaN(reportId)) {
+        return { content: [{ type: "text", text: "report_id must be a number" }], isError: true };
+      }
+      const type2 = args.type ? String(args.type) : undefined;
+      const checkId = args.check_id ? String(args.check_id) : undefined;
+      if (reportId === undefined && !checkId) {
+        return { content: [{ type: "text", text: "Either report_id or check_id is required" }], isError: true };
+      }
+      const files = await fetchReportFiles({ apiKey, apiBaseUrl, reportId, type: type2, checkId, debug });
+      return { content: [{ type: "text", text: JSON.stringify(files, null, 2) }] };
+    }
+    if (toolName === "get_report_data") {
+      const reportId = args.report_id !== undefined ? Number(args.report_id) : undefined;
+      if (reportId !== undefined && isNaN(reportId)) {
+        return { content: [{ type: "text", text: "report_id must be a number" }], isError: true };
+      }
+      const type2 = args.type ? String(args.type) : undefined;
+      const checkId = args.check_id ? String(args.check_id) : undefined;
+      if (reportId === undefined && !checkId) {
+        return { content: [{ type: "text", text: "Either report_id or check_id is required" }], isError: true };
+      }
+      const files = await fetchReportFileData({ apiKey, apiBaseUrl, reportId, type: type2, checkId, debug });
+      return { content: [{ type: "text", text: JSON.stringify(files, null, 2) }] };
+    }
     throw new Error(`Unknown tool: ${toolName}`);
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
@@ -23955,6 +24181,50 @@ async function startMcpServer(rootOpts, extra) {
             required: ["action_item_id"],
             additionalProperties: false
           }
+        },
+        {
+          name: "list_reports",
+          description: "List checkup reports. Returns report metadata: id, project, status, timestamps. Use get_report_data to fetch actual report content. Supports date-based filtering with before_date.",
+          inputSchema: {
+            type: "object",
+            properties: {
+              project_id: { type: "number", description: "Filter by project ID" },
+              status: { type: "string", description: "Filter by status (e.g., 'completed')" },
+              limit: { type: "number", description: "Max number of reports to return (default: 20)" },
+              before_date: { type: "string", description: "Show reports created before this date (YYYY-MM-DD, DD.MM.YYYY, YYYY-MM-DD HH:mm, etc.)" },
+              all: { type: "boolean", description: "Fetch all reports (paginated automatically)" },
+              debug: { type: "boolean", description: "Enable verbose debug logs" }
+            },
+            additionalProperties: false
+          }
+        },
+        {
+          name: "list_report_files",
+          description: "List files in a checkup report (metadata only, no content). Each report contains json (raw data) and md (markdown analysis) files per check. Either report_id or check_id must be provided.",
+          inputSchema: {
+            type: "object",
+            properties: {
+              report_id: { type: "number", description: "Checkup report ID (optional if check_id is provided)" },
+              type: { type: "string", description: "Filter by file type: 'json' or 'md'" },
+              check_id: { type: "string", description: "Filter by check ID (e.g., 'H002', 'F004')" },
+              debug: { type: "boolean", description: "Enable verbose debug logs" }
+            },
+            additionalProperties: false
+          }
+        },
+        {
+          name: "get_report_data",
+          description: "Get checkup report file content. Returns files with a 'data' field containing the actual content: markdown analysis or JSON raw data. Use type='md' for human-readable analysis with recommendations, type='json' for raw check data. Either report_id or check_id must be provided.",
+          inputSchema: {
+            type: "object",
+            properties: {
+              report_id: { type: "number", description: "Checkup report ID (optional if check_id is provided)" },
+              type: { type: "string", description: "Filter by file type: 'json' for raw data, 'md' for markdown analysis" },
+              check_id: { type: "string", description: "Filter by check ID (e.g., 'H002', 'F004')" },
+              debug: { type: "boolean", description: "Enable verbose debug logs" }
+            },
+            additionalProperties: false
+          }
         }
       ]
     };
@@ -24588,6 +24858,245 @@ async function updateActionItem2(params) {
   }
 }
 
+// lib/reports.ts
+function parseFlexibleDate2(input) {
+  const s = input.trim();
+  const dotMatch = s.match(/^(\d{1,2})\.(\d{1,2})\.(\d{4})(?:\s+(\d{1,2}):(\d{2})(?::(\d{2}))?)?$/);
+  if (dotMatch) {
+    const [, dd, mm, yyyy, hh, min, ss] = dotMatch;
+    const iso = `${yyyy}-${mm.padStart(2, "0")}-${dd.padStart(2, "0")}T${(hh ?? "00").padStart(2, "0")}:${(min ?? "00").padStart(2, "0")}:${(ss ?? "00").padStart(2, "0")}Z`;
+    const d = new Date(iso);
+    if (isNaN(d.getTime()))
+      throw new Error(`Invalid date: ${input}`);
+    return d.toISOString();
+  }
+  const isoMatch = s.match(/^(\d{4})-(\d{2})-(\d{2})(?:[T ](\d{2}):(\d{2})(?::(\d{2}))?)?$/);
+  if (isoMatch) {
+    const [, yyyy, mm, dd, hh, min, ss] = isoMatch;
+    const iso = `${yyyy}-${mm}-${dd}T${hh ?? "00"}:${min ?? "00"}:${ss ?? "00"}Z`;
+    const d = new Date(iso);
+    if (isNaN(d.getTime()))
+      throw new Error(`Invalid date: ${input}`);
+    return d.toISOString();
+  }
+  throw new Error(`Unrecognized date format: ${input}. Use YYYY-MM-DD or DD.MM.YYYY`);
+}
+async function fetchReports2(params) {
+  const { apiKey, apiBaseUrl, projectId, status, limit = 20, beforeDate, beforeId, debug } = params;
+  if (!apiKey) {
+    throw new Error("API key is required");
+  }
+  const base = normalizeBaseUrl(apiBaseUrl);
+  const url = new URL(`${base}/checkup_reports`);
+  url.searchParams.set("order", "id.desc");
+  url.searchParams.set("limit", String(limit));
+  if (typeof projectId === "number") {
+    url.searchParams.set("project_id", `eq.${projectId}`);
+  }
+  if (status) {
+    url.searchParams.set("status", `eq.${status}`);
+  }
+  if (beforeDate) {
+    url.searchParams.set("created_at", `lt.${beforeDate}`);
+  }
+  if (typeof beforeId === "number") {
+    url.searchParams.set("id", `lt.${beforeId}`);
+  }
+  const headers = {
+    "access-token": apiKey,
+    Prefer: "return=representation",
+    "Content-Type": "application/json",
+    Connection: "close"
+  };
+  if (debug) {
+    const debugHeaders = { ...headers, "access-token": maskSecret(apiKey) };
+    console.log(`Debug: Resolved API base URL: ${base}`);
+    console.log(`Debug: GET URL: ${url.toString()}`);
+    console.log(`Debug: Request headers: ${JSON.stringify(debugHeaders)}`);
+  }
+  const response = await fetch(url.toString(), { method: "GET", headers });
+  if (debug) {
+    console.log(`Debug: Response status: ${response.status}`);
+  }
+  const data = await response.text();
+  if (response.ok) {
+    try {
+      return JSON.parse(data);
+    } catch {
+      throw new Error(`Failed to parse reports response: ${data}`);
+    }
+  } else {
+    throw new Error(formatHttpError("Failed to fetch reports", response.status, data));
+  }
+}
+var MAX_ALL_REPORTS2 = 1e4;
+async function fetchAllReports2(params) {
+  const pageSize = params.limit ?? 100;
+  const all = [];
+  let beforeId;
+  while (true) {
+    const page = await fetchReports2({ ...params, limit: pageSize, beforeId });
+    if (page.length === 0)
+      break;
+    all.push(...page);
+    if (all.length >= MAX_ALL_REPORTS2) {
+      console.warn(`Warning: reached maximum of ${MAX_ALL_REPORTS2} reports, stopping pagination`);
+      break;
+    }
+    beforeId = page[page.length - 1].id;
+    if (page.length < pageSize)
+      break;
+  }
+  return all;
+}
+async function fetchReportFiles2(params) {
+  const { apiKey, apiBaseUrl, reportId, type: type2, checkId, debug } = params;
+  if (!apiKey) {
+    throw new Error("API key is required");
+  }
+  if (reportId === undefined && !checkId) {
+    throw new Error("Either reportId or checkId is required");
+  }
+  const base = normalizeBaseUrl(apiBaseUrl);
+  const url = new URL(`${base}/checkup_report_files`);
+  if (typeof reportId === "number") {
+    url.searchParams.set("checkup_report_id", `eq.${reportId}`);
+  }
+  url.searchParams.set("order", "id.asc");
+  if (type2) {
+    url.searchParams.set("type", `eq.${type2}`);
+  }
+  if (checkId) {
+    url.searchParams.set("check_id", `eq.${checkId}`);
+  }
+  const headers = {
+    "access-token": apiKey,
+    Prefer: "return=representation",
+    "Content-Type": "application/json",
+    Connection: "close"
+  };
+  if (debug) {
+    const debugHeaders = { ...headers, "access-token": maskSecret(apiKey) };
+    console.log(`Debug: Resolved API base URL: ${base}`);
+    console.log(`Debug: GET URL: ${url.toString()}`);
+    console.log(`Debug: Request headers: ${JSON.stringify(debugHeaders)}`);
+  }
+  const response = await fetch(url.toString(), { method: "GET", headers });
+  if (debug) {
+    console.log(`Debug: Response status: ${response.status}`);
+  }
+  const data = await response.text();
+  if (response.ok) {
+    try {
+      return JSON.parse(data);
+    } catch {
+      throw new Error(`Failed to parse report files response: ${data}`);
+    }
+  } else {
+    throw new Error(formatHttpError("Failed to fetch report files", response.status, data));
+  }
+}
+async function fetchReportFileData2(params) {
+  const { apiKey, apiBaseUrl, reportId, type: type2, checkId, debug } = params;
+  if (!apiKey) {
+    throw new Error("API key is required");
+  }
+  if (reportId === undefined && !checkId) {
+    throw new Error("Either reportId or checkId is required");
+  }
+  const base = normalizeBaseUrl(apiBaseUrl);
+  const url = new URL(`${base}/checkup_report_file_data`);
+  if (typeof reportId === "number") {
+    url.searchParams.set("checkup_report_id", `eq.${reportId}`);
+  }
+  url.searchParams.set("order", "id.asc");
+  if (type2) {
+    url.searchParams.set("type", `eq.${type2}`);
+  }
+  if (checkId) {
+    url.searchParams.set("check_id", `eq.${checkId}`);
+  }
+  const headers = {
+    "access-token": apiKey,
+    Prefer: "return=representation",
+    "Content-Type": "application/json",
+    Connection: "close"
+  };
+  if (debug) {
+    const debugHeaders = { ...headers, "access-token": maskSecret(apiKey) };
+    console.log(`Debug: Resolved API base URL: ${base}`);
+    console.log(`Debug: GET URL: ${url.toString()}`);
+    console.log(`Debug: Request headers: ${JSON.stringify(debugHeaders)}`);
+  }
+  const response = await fetch(url.toString(), { method: "GET", headers });
+  if (debug) {
+    console.log(`Debug: Response status: ${response.status}`);
+  }
+  const data = await response.text();
+  if (response.ok) {
+    try {
+      return JSON.parse(data);
+    } catch {
+      throw new Error(`Failed to parse report file data response: ${data}`);
+    }
+  } else {
+    throw new Error(formatHttpError("Failed to fetch report file data", response.status, data));
+  }
+}
+function renderMarkdownForTerminal(md) {
+  if (!md)
+    return "";
+  const RESET = "\x1B[0m";
+  const BOLD = "\x1B[1m";
+  const BOLD_UNDERLINE = "\x1B[1;4m";
+  const DIM = "\x1B[2m";
+  const ITALIC = "\x1B[3m";
+  const CYAN = "\x1B[36m";
+  const lines = md.split(`
+`);
+  const output = [];
+  let inCodeBlock = false;
+  for (const line of lines) {
+    if (line.trimStart().startsWith("```")) {
+      inCodeBlock = !inCodeBlock;
+      if (inCodeBlock) {
+        output.push(`${DIM}${"─".repeat(40)}${RESET}`);
+      } else {
+        output.push(`${DIM}${"─".repeat(40)}${RESET}`);
+      }
+      continue;
+    }
+    if (inCodeBlock) {
+      output.push(`${DIM}  ${line}${RESET}`);
+      continue;
+    }
+    if (/^-{3,}$/.test(line.trim()) || /^\*{3,}$/.test(line.trim()) || /^_{3,}$/.test(line.trim())) {
+      output.push(`${DIM}${"─".repeat(60)}${RESET}`);
+      continue;
+    }
+    const headingMatch = line.match(/^(#{1,6})\s+(.*)/);
+    if (headingMatch) {
+      const level = headingMatch[1].length;
+      const text = headingMatch[2];
+      if (level === 1) {
+        output.push(`${BOLD_UNDERLINE}${text}${RESET}`);
+      } else {
+        output.push(`${BOLD}${text}${RESET}`);
+      }
+      continue;
+    }
+    let formatted = line;
+    formatted = formatted.replace(/\*\*(.+?)\*\*/g, `${BOLD}$1${RESET}`);
+    formatted = formatted.replace(/__(.+?)__/g, `${BOLD}$1${RESET}`);
+    formatted = formatted.replace(/(?<!\*)\*(?!\*)(.+?)(?<!\*)\*(?!\*)/g, `${ITALIC}$1${RESET}`);
+    formatted = formatted.replace(/(?<=^|[\s(])_([^\s_](?:.*?[^\s_])?)_(?=$|[\s),.:;!?])/g, `${ITALIC}$1${RESET}`);
+    formatted = formatted.replace(/`([^`]+)`/g, `${CYAN}$1${RESET}`);
+    output.push(formatted);
+  }
+  return output.join(`
+`);
+}
+
 // lib/util.ts
 function maskSecret2(secret) {
   if (!secret)
@@ -32081,6 +32590,193 @@ issues.command("update-action-item <actionItemId>").description("update an actio
     process.exitCode = 1;
   }
 });
+var reports = program2.command("reports").description("checkup reports management");
+reports.command("list").description("list checkup reports").option("--project-id <id>", "filter by project id", (v) => parseInt(v, 10)).option("--status <status>", "filter by status (e.g., completed)").option("--limit <n>", "max number of reports to return (default: 20)", (v) => parseInt(v, 10)).option("--before <date>", "show reports created before this date (YYYY-MM-DD, DD.MM.YYYY, etc.)").option("--all", "fetch all reports (paginated automatically)").option("--debug", "enable debug output").option("--json", "output raw JSON").action(async (opts) => {
+  const spinner = createTtySpinner(process.stdout.isTTY ?? false, "Fetching reports...");
+  try {
+    const rootOpts = program2.opts();
+    const cfg = readConfig();
+    const { apiKey } = getConfig(rootOpts);
+    if (!apiKey) {
+      spinner.stop();
+      console.error("API key is required. Run 'pgai auth' first or set --api-key.");
+      process.exitCode = 1;
+      return;
+    }
+    if (opts.all && opts.before) {
+      spinner.stop();
+      console.error("--all and --before cannot be used together");
+      process.exitCode = 1;
+      return;
+    }
+    const { apiBaseUrl } = resolveBaseUrls2(rootOpts, cfg);
+    let result;
+    if (opts.all) {
+      result = await fetchAllReports2({
+        apiKey,
+        apiBaseUrl,
+        projectId: opts.projectId,
+        status: opts.status,
+        limit: opts.limit,
+        debug: !!opts.debug
+      });
+    } else {
+      result = await fetchReports2({
+        apiKey,
+        apiBaseUrl,
+        projectId: opts.projectId,
+        status: opts.status,
+        limit: opts.limit,
+        beforeDate: opts.before ? parseFlexibleDate2(opts.before) : undefined,
+        debug: !!opts.debug
+      });
+    }
+    spinner.stop();
+    printResult(result, opts.json);
+  } catch (err) {
+    spinner.stop();
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(message);
+    process.exitCode = 1;
+  }
+});
+reports.command("files [reportId]").description("list files of a checkup report (metadata only, no content)").option("--type <type>", "filter by file type: json, md").option("--check-id <id>", "filter by check ID (e.g., H002)").option("--debug", "enable debug output").option("--json", "output raw JSON").action(async (reportId, opts) => {
+  const spinner = createTtySpinner(process.stdout.isTTY ?? false, "Fetching report files...");
+  try {
+    const rootOpts = program2.opts();
+    const cfg = readConfig();
+    const { apiKey } = getConfig(rootOpts);
+    if (!apiKey) {
+      spinner.stop();
+      console.error("API key is required. Run 'pgai auth' first or set --api-key.");
+      process.exitCode = 1;
+      return;
+    }
+    let numericId;
+    if (reportId !== undefined) {
+      numericId = parseInt(reportId, 10);
+      if (isNaN(numericId)) {
+        spinner.stop();
+        console.error("reportId must be a number");
+        process.exitCode = 1;
+        return;
+      }
+    }
+    if (numericId === undefined && !opts.checkId) {
+      spinner.stop();
+      console.error("Either reportId or --check-id is required");
+      process.exitCode = 1;
+      return;
+    }
+    const { apiBaseUrl } = resolveBaseUrls2(rootOpts, cfg);
+    const result = await fetchReportFiles2({
+      apiKey,
+      apiBaseUrl,
+      reportId: numericId,
+      type: opts.type,
+      checkId: opts.checkId,
+      debug: !!opts.debug
+    });
+    spinner.stop();
+    printResult(result, opts.json);
+  } catch (err) {
+    spinner.stop();
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(message);
+    process.exitCode = 1;
+  }
+});
+reports.command("data [reportId]").description("get checkup report file data (includes content)").option("--type <type>", "filter by file type: json, md").option("--check-id <id>", "filter by check ID (e.g., H002)").option("--formatted", "render markdown with ANSI styling (experimental)").option("-o, --output <dir>", "save files to directory (uses original filenames)").option("--debug", "enable debug output").option("--json", "output raw JSON").action(async (reportId, opts) => {
+  const spinner = createTtySpinner(process.stdout.isTTY ?? false, "Fetching report data...");
+  try {
+    const rootOpts = program2.opts();
+    const cfg = readConfig();
+    const { apiKey } = getConfig(rootOpts);
+    if (!apiKey) {
+      spinner.stop();
+      console.error("API key is required. Run 'pgai auth' first or set --api-key.");
+      process.exitCode = 1;
+      return;
+    }
+    let numericId;
+    if (reportId !== undefined) {
+      numericId = parseInt(reportId, 10);
+      if (isNaN(numericId)) {
+        spinner.stop();
+        console.error("reportId must be a number");
+        process.exitCode = 1;
+        return;
+      }
+    }
+    if (numericId === undefined && !opts.checkId) {
+      spinner.stop();
+      console.error("Either reportId or --check-id is required");
+      process.exitCode = 1;
+      return;
+    }
+    const { apiBaseUrl } = resolveBaseUrls2(rootOpts, cfg);
+    const effectiveType = opts.type ?? (!opts.json && !opts.output ? "md" : undefined);
+    const result = await fetchReportFileData2({
+      apiKey,
+      apiBaseUrl,
+      reportId: numericId,
+      type: effectiveType,
+      checkId: opts.checkId,
+      debug: !!opts.debug
+    });
+    spinner.stop();
+    if (opts.output) {
+      const dir = path5.resolve(opts.output);
+      fs5.mkdirSync(dir, { recursive: true });
+      for (const f of result) {
+        const safeName = path5.basename(f.filename);
+        const filePath = path5.join(dir, safeName);
+        const content = f.type === "json" ? JSON.stringify(tryParseJson(f.data), null, 2) : f.data;
+        fs5.writeFileSync(filePath, content, "utf-8");
+        console.log(filePath);
+      }
+    } else if (opts.json) {
+      const processed = result.map((f) => ({
+        ...f,
+        data: f.type === "json" ? tryParseJson(f.data) : f.data
+      }));
+      printResult(processed, true);
+    } else if (opts.formatted && process.stdout.isTTY) {
+      for (const f of result) {
+        if (result.length > 1) {
+          console.log(`\x1B[1m--- ${f.filename} (${f.check_id}, ${f.type}) ---\x1B[0m`);
+        }
+        if (f.type === "md") {
+          console.log(renderMarkdownForTerminal(f.data));
+        } else if (f.type === "json") {
+          const parsed = tryParseJson(f.data);
+          console.log(typeof parsed === "string" ? parsed : JSON.stringify(parsed, null, 2));
+        } else {
+          console.log(f.data);
+        }
+      }
+    } else {
+      for (const f of result) {
+        if (result.length > 1) {
+          console.log(`--- ${f.filename} (${f.check_id}, ${f.type}) ---`);
+        }
+        console.log(f.data);
+      }
+    }
+  } catch (err) {
+    spinner.stop();
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(message);
+    process.exitCode = 1;
+  }
+});
+function tryParseJson(s) {
+  try {
+    return JSON.parse(s);
+  } catch {
+    return s;
+  }
+}
 var mcp = program2.command("mcp").description("MCP server integration");
 mcp.command("start").description("start MCP stdio server").option("--debug", "enable debug output").action(async (opts) => {
   const rootOpts = program2.opts();