qodfy 0.2.1 → 0.2.3

package/dist/index.js

@@ -11,10 +11,10 @@ import {
   scanProject,
   validScanChecks
 } from "@qodfy/core";
-var DEFAULT_MAX_ISSUES = 20;
+var DEFAULT_MAX_ISSUES = 5;
 var program = new Command();
-program.name("qodfy").description("Launch readiness scanner for AI-built apps.").version("0.2.1");
-program.command("scan").description("Scan a project for launch readiness issues.").option("-p, --path <path>", "Project path to scan", process.cwd()).option("--max-issues <number>", "Maximum number of issues to display", String(DEFAULT_MAX_ISSUES)).option("--prompts", "Show safe copy-paste fix prompts for displayed issues").option("--checks <checks>", "Comma-separated checks to run").option("--all", "Run all checks without prompting").option("--no-interactive", "Skip interactive prompts and run the recommended scan").action(async (options) => {
+program.name("qodfy").description("Launch readiness scanner for AI-built apps.").version("0.2.3");
+program.command("scan").description("Scan a project for launch readiness issues.").option("-p, --path <path>", "Project path to scan", process.cwd()).option("--max-issues <number>", "Maximum number of issues to display", String(DEFAULT_MAX_ISSUES)).option("--prompts", "Show safe copy-paste fix prompts for displayed issues").option("--prompt <issue-id>", "Show the safe AI fix prompt for one issue").option("--checks <checks>", "Comma-separated checks to run").option("--all", "Run all checks without prompting").option("--no-interactive", "Skip interactive prompts and run the recommended scan").action(async (options) => {
   const pathResult = await resolveProjectPath(options.path);
   if (!pathResult.ok) {
     printScanError(pathResult.reason);
@@ -35,13 +35,20 @@ program.command("scan").description("Scan a project for launch readiness issues.
     console.log(pc.cyan("Qodfy is scanning your project...\n"));
     const report = await scanProject({
       projectPath: pathResult.projectPath,
-      checks: scanModeResult.checks
+      checks: scanModeResult.checks,
+      includeLowConfidence: Boolean(scanModeResult.includeLowConfidence)
     });
+    if (options.prompt) {
+      printPromptFromReport(report, options.prompt);
+      return;
+    }
     printReport(
       report,
       parseMaxIssues(options.maxIssues),
       Boolean(options.prompts),
-      scanModeResult.label
+      scanModeResult.label,
+      Boolean(options.all),
+      Boolean(options.all)
     );
   } catch (error) {
     if (isPromptCancelError(error)) {
@@ -52,6 +59,40 @@ program.command("scan").description("Scan a project for launch readiness issues.
     process.exitCode = 1;
   }
 });
+program.command("prompt <issue-id>").description("Print the safe AI fix prompt for a specific issue.").option("-p, --path <path>", "Project path to scan", process.cwd()).option("--checks <checks>", "Comma-separated checks to search").option("--all", "Search all checks", true).action(async (issueId, options) => {
+  const pathResult = await resolveProjectPath(options.path);
+  if (!pathResult.ok) {
+    printScanError(pathResult.reason);
+    process.exitCode = 1;
+    return;
+  }
+  const checksResult = resolvePromptChecks(options);
+  if (!checksResult.ok) {
+    printPromptError(checksResult.reason);
+    process.exitCode = 1;
+    return;
+  }
+  const report = await scanProject({
+    projectPath: pathResult.projectPath,
+    checks: checksResult.checks,
+    includeLowConfidence: true
+  });
+  const issue = report.issues.find((scanIssue) => scanIssue.id === issueId);
+  if (!issue) {
+    printPromptError(
+      `Issue "${issueId}" was not found in this project scan.
+Run qodfy scan --all to see the current issue IDs.`
+    );
+    process.exitCode = 1;
+    return;
+  }
+  if (!issue.fixPrompt) {
+    printPromptError(`Issue "${issueId}" does not have an AI fix prompt yet.`);
+    process.exitCode = 1;
+    return;
+  }
+  printFixPrompt(issue);
+});
 var categoryOrder = [
   "security",
   "webhook",
@@ -87,7 +128,16 @@ async function resolveScanMode(options) {
     return {
       ok: true,
       checks: [...validScanChecks],
-      label: "All checks"
+      label: "All checks",
+      includeLowConfidence: true
+    };
+  }
+  if (options.prompt) {
+    return {
+      ok: true,
+      checks: [...validScanChecks],
+      label: "All checks",
+      includeLowConfidence: true
     };
   }
   if (options.interactive === false) {
@@ -276,6 +326,24 @@ function hasSameChecks(leftChecks, rightChecks) {
 function isNonInteractiveTerminal() {
   return Boolean(process.env.CI) || !process.stdin.isTTY || !process.stdout.isTTY;
 }
+function resolvePromptChecks(options) {
+  if (options.checks) {
+    const parsedChecks = parseChecks(options.checks);
+    if (!parsedChecks.ok) {
+      return parsedChecks;
+    }
+    return {
+      ok: true,
+      checks: parsedChecks.checks,
+      label: getScanModeLabel(parsedChecks.checks)
+    };
+  }
+  return {
+    ok: true,
+    checks: [...validScanChecks],
+    label: "All checks"
+  };
+}
 async function resolveProjectPath(projectPath) {
   const inputPath = projectPath.trim() || process.cwd();
   const resolvedPath = path.resolve(inputPath);
@@ -311,7 +379,7 @@ async function resolveProjectPath(projectPath) {
     };
   }
 }
-function printReport(report, maxIssues, showPrompts, scanModeLabel) {
+function printReport(report, maxIssues, showPrompts, scanModeLabel, showDetails, showAllIssues) {
   console.log(pc.bold("Qodfy Report"));
   console.log("");
   const scoreColor = report.score >= 80 ? pc.green : report.score >= 60 ? pc.yellow : pc.red;
@@ -330,21 +398,26 @@ function printReport(report, maxIssues, showPrompts, scanModeLabel) {
     console.log(pc.green("No issues found. Your project looks clean."));
     return;
   }
-  console.log(pc.bold("Issues"));
+  console.log(pc.bold(showAllIssues ? "Issues" : "Top issues"));
   const displayIssues = getSortedDisplayIssues(report.issues);
-  const issuesToShow = displayIssues.slice(0, maxIssues);
-  if (report.issues.length > maxIssues) {
-    console.log(`Showing ${maxIssues} of ${report.issues.length} issues.`);
-    console.log(`Use --max-issues <number> to show more.`);
+  const issueLimit = showAllIssues ? displayIssues.length : maxIssues;
+  const issuesToShow = displayIssues.slice(0, issueLimit);
+  if (report.issues.length > issueLimit) {
+    console.log(`Showing ${issueLimit} of ${report.issues.length} issues.`);
+    console.log(`Use --max-issues <number> to show more, or --all for full details.`);
   }
-  printGroupedIssues(issuesToShow, showPrompts);
+  printGroupedIssues(issuesToShow, showPrompts, showDetails, report.projectPath);
   console.log("");
   console.log(pc.bold("Recommended next step:"));
   console.log("Fix critical issues first, then warnings, then cleanup items.");
   console.log("");
   console.log(pc.bold("Next commands:"));
+  const firstPromptIssue = issuesToShow.find((issue) => issue.fixPrompt);
+  if (firstPromptIssue) {
+    console.log(getPromptCommand(firstPromptIssue.id, report.projectPath));
+  }
   console.log("qodfy scan --checks api,environment");
-  console.log("qodfy scan --prompts --max-issues 5");
+  console.log("qodfy scan --all");
 }
 function printSummary(issues) {
   const criticalCount = countIssuesBySeverity(issues, "critical");
@@ -375,7 +448,7 @@ function printSummary(issues) {
   }
   console.log("");
 }
-function printGroupedIssues(issues, showPrompts) {
+function printGroupedIssues(issues, showPrompts, showDetails, projectPath) {
   for (const category of categoryOrder) {
     const categoryIssues = issues.filter((issue) => issue.category === category);
     if (categoryIssues.length === 0) {
@@ -384,25 +457,56 @@ function printGroupedIssues(issues, showPrompts) {
     console.log("");
     console.log(pc.bold(categoryLabels[category]));
     for (const issue of categoryIssues) {
-      printIssue(issue, showPrompts);
+      printIssue(issue, showPrompts, showDetails, projectPath);
     }
   }
 }
-function printIssue(issue, showPrompts) {
+function printIssue(issue, showPrompts, showDetails, projectPath) {
   console.log("");
-  console.log(`${pc.dim(`[${issue.id}]`)} ${getSeverityLabel(issue.severity)} ${pc.bold(issue.title)}`);
-  console.log(issue.message);
+  console.log(`${pc.dim(`[${issue.id}]`)} ${getSeverityLabel(issue.severity)} ${pc.bold(issue.title)} ${pc.dim(`(${issue.confidence} confidence)`)}`);
   if (issue.file) {
     console.log(pc.dim(`File: ${issue.file}`));
   }
-  if (issue.suggestion) {
+  if (showDetails || showPrompts) {
+    console.log(issue.message);
+  }
+  if ((showDetails || showPrompts) && issue.suggestion) {
     console.log(pc.dim(`Suggestion: ${issue.suggestion}`));
   }
   if (showPrompts && issue.fixPrompt) {
     console.log("");
     console.log(pc.bold("Fix Prompt:"));
     console.log(issue.fixPrompt);
+  } else if (issue.fixPrompt) {
+    console.log(pc.dim(`Fix: ${getPromptCommand(issue.id, projectPath)}`));
+  }
+}
+function printFixPrompt(issue) {
+  console.log(pc.bold("Qodfy Fix Prompt"));
+  console.log("");
+  console.log(`${pc.dim(`[${issue.id}]`)} ${getSeverityLabel(issue.severity)} ${pc.bold(issue.title)} ${pc.dim(`(${issue.confidence} confidence)`)}`);
+  if (issue.file) {
+    console.log(pc.dim(`File: ${issue.file}`));
+  }
+  console.log("");
+  console.log(issue.fixPrompt);
+}
+function printPromptFromReport(report, issueId) {
+  const issue = report.issues.find((scanIssue) => scanIssue.id === issueId);
+  if (!issue) {
+    printPromptError(
+      `Issue "${issueId}" was not found in this project scan.
+Run qodfy scan --all to see the current issue IDs.`
+    );
+    process.exitCode = 1;
+    return;
+  }
+  if (!issue.fixPrompt) {
+    printPromptError(`Issue "${issueId}" does not have an AI fix prompt yet.`);
+    process.exitCode = 1;
+    return;
   }
+  printFixPrompt(issue);
 }
 function getSeverityLabel(severity) {
   if (severity === "critical") {
@@ -418,7 +522,7 @@ function countIssuesBySeverity(issues, severity) {
 }
 function getSortedDisplayIssues(issues) {
   return [...issues].sort((leftIssue, rightIssue) => {
-    return getSeverityRank(leftIssue.severity) - getSeverityRank(rightIssue.severity) || categoryOrder.indexOf(leftIssue.category) - categoryOrder.indexOf(rightIssue.category) || leftIssue.ruleId.localeCompare(rightIssue.ruleId) || getIssueNumber(leftIssue.id) - getIssueNumber(rightIssue.id) || (leftIssue.file ?? "").localeCompare(rightIssue.file ?? "") || leftIssue.id.localeCompare(rightIssue.id);
+    return getSeverityRank(leftIssue.severity) - getSeverityRank(rightIssue.severity) || getConfidenceRank(leftIssue.confidence) - getConfidenceRank(rightIssue.confidence) || categoryOrder.indexOf(leftIssue.category) - categoryOrder.indexOf(rightIssue.category) || leftIssue.ruleId.localeCompare(rightIssue.ruleId) || getIssueNumber(leftIssue.id) - getIssueNumber(rightIssue.id) || (leftIssue.file ?? "").localeCompare(rightIssue.file ?? "") || leftIssue.id.localeCompare(rightIssue.id);
   });
 }
 function getIssueNumber(issueId) {
@@ -434,6 +538,15 @@ function getSeverityRank(severity) {
   }
   return 2;
 }
+function getConfidenceRank(confidence) {
+  if (confidence === "high") {
+    return 0;
+  }
+  if (confidence === "medium") {
+    return 1;
+  }
+  return 2;
+}
 function getTopPriorities(issues) {
   const priorities = [
     {
@@ -483,6 +596,27 @@ function getTopPriorities(issues) {
     (priority) => issues.some((issue) => priority.ruleIds.includes(issue.ruleId))
   ).slice(0, 3).map((priority) => priority.message);
 }
+function getPromptCommand(issueId, projectPath) {
+  const relativeProjectPath = path.relative(process.cwd(), projectPath);
+  const promptPath = getPromptPath(projectPath, relativeProjectPath);
+  const pathOption = promptPath ? ` --path ${shellQuote(promptPath)}` : "";
+  return `qodfy prompt ${issueId}${pathOption}`;
+}
+function getPromptPath(projectPath, relativeProjectPath) {
+  if (!relativeProjectPath) {
+    return "";
+  }
+  if (!relativeProjectPath.startsWith("..") && !path.isAbsolute(relativeProjectPath)) {
+    return relativeProjectPath;
+  }
+  return projectPath;
+}
+function shellQuote(value) {
+  if (/^[A-Za-z0-9_./:-]+$/.test(value)) {
+    return value;
+  }
+  return `'${value.replaceAll("'", "'\\''")}'`;
+}
 function printScanError(reason) {
   console.error(pc.red("Qodfy could not scan this project."));
   console.error("");
@@ -492,6 +626,15 @@ function printScanError(reason) {
   console.error(pc.bold("Try:"));
   console.error("qodfy scan --path ./my-next-app");
 }
+function printPromptError(reason) {
+  console.error(pc.red("Qodfy could not create this fix prompt."));
+  console.error("");
+  console.error(pc.bold("Reason:"));
+  console.error(reason);
+  console.error("");
+  console.error(pc.bold("Try:"));
+  console.error("qodfy scan --all");
+}
 function getErrorMessage(error) {
   if (error instanceof Error && error.message) {
     return error.message;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qodfy",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Open-source launch readiness scanner for AI-built apps.",
   "keywords": [
     "qodfy",
@@ -52,7 +52,7 @@
     "@inquirer/prompts": "^8.4.3",
     "commander": "^14.0.3",
     "picocolors": "^1.1.1",
-    "@qodfy/core": "^0.2.1"
+    "@qodfy/core": "^0.2.3"
   },
   "devDependencies": {
     "@types/node": "^25.7.0",