qodfy 0.2.1 → 0.2.2

package/dist/index.js

@@ -13,7 +13,7 @@ import {
 } from "@qodfy/core";
 var DEFAULT_MAX_ISSUES = 20;
 var program = new Command();
-program.name("qodfy").description("Launch readiness scanner for AI-built apps.").version("0.2.1");
+program.name("qodfy").description("Launch readiness scanner for AI-built apps.").version("0.2.2");
 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) => {
   const pathResult = await resolveProjectPath(options.path);
   if (!pathResult.ok) {
@@ -52,6 +52,39 @@ 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
+  });
+  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",
@@ -276,6 +309,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);
@@ -337,14 +388,18 @@ function printReport(report, maxIssues, showPrompts, scanModeLabel) {
     console.log(`Showing ${maxIssues} of ${report.issues.length} issues.`);
     console.log(`Use --max-issues <number> to show more.`);
   }
-  printGroupedIssues(issuesToShow, showPrompts);
+  printGroupedIssues(issuesToShow, showPrompts, 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 --max-issues 50");
 }
 function printSummary(issues) {
   const criticalCount = countIssuesBySeverity(issues, "critical");
@@ -375,7 +430,7 @@ function printSummary(issues) {
   }
   console.log("");
 }
-function printGroupedIssues(issues, showPrompts) {
+function printGroupedIssues(issues, showPrompts, projectPath) {
   for (const category of categoryOrder) {
     const categoryIssues = issues.filter((issue) => issue.category === category);
     if (categoryIssues.length === 0) {
@@ -384,11 +439,11 @@ function printGroupedIssues(issues, showPrompts) {
     console.log("");
     console.log(pc.bold(categoryLabels[category]));
     for (const issue of categoryIssues) {
-      printIssue(issue, showPrompts);
+      printIssue(issue, showPrompts, projectPath);
     }
   }
 }
-function printIssue(issue, showPrompts) {
+function printIssue(issue, showPrompts, projectPath) {
   console.log("");
   console.log(`${pc.dim(`[${issue.id}]`)} ${getSeverityLabel(issue.severity)} ${pc.bold(issue.title)}`);
   console.log(issue.message);
@@ -402,7 +457,19 @@ function printIssue(issue, showPrompts) {
     console.log("");
     console.log(pc.bold("Fix Prompt:"));
     console.log(issue.fixPrompt);
+  } else if (issue.fixPrompt) {
+    console.log(pc.dim(`AI fix prompt: ${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)}`);
+  if (issue.file) {
+    console.log(pc.dim(`File: ${issue.file}`));
   }
+  console.log("");
+  console.log(issue.fixPrompt);
 }
 function getSeverityLabel(severity) {
   if (severity === "critical") {
@@ -483,6 +550,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 +580,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.2",
   "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.2"
   },
   "devDependencies": {
     "@types/node": "^25.7.0",