Function buildPrompt

extensions/java-modernization-studio/prompts.mjs:32–155

(kind, payload, repoPath)

 * @returns {string|null} prompt text, or null for unknown actions / unknown task ids.
 */
export function buildPrompt(kind, payload, repoPath) {
    const p = payload || {};
    switch (kind) {
        case "start_assessment":
            return (
                APPMOD_PREAMBLE +
                "\n\nRun an App Modernization assessment of this Java project at " + repoPath + ". " +
                "Report the current Java runtime, build tool, framework versions, outdated/vulnerable dependencies, " +
                "and cloud-readiness issues for Azure. Summarize findings and write a prioritized plan.md of remediation steps. Do not change code yet." +
                "\n\nAlso write the findings as structured JSON to .appmod/assessment.json so the cockpit can render them. Use this shape:\n" +
                "{\n" +
                '  "generatedAt": "<ISO 8601 timestamp>",\n' +
                '  "headline": "<one-line stack summary>",\n' +
                '  "summary": "<2-3 sentence plain-language verdict>",\n' +
                '  "stack": { "buildTool": "", "java": "", "framework": "", "database": "", "container": "" },\n' +
                '  "findings": [\n' +
                '    { "id": "kebab-id", "severity": "P0|P1|P2|P3", "title": "", "detail": "", "files": ["path"],\n' +
                '      "action": { "kind": "run_task|generate_plan|run_cve|generate_tests|fix_finding", "payload": {}, "label": "" } }\n' +
                "  ],\n" +
                '  "strengths": ["<things already done well>"]\n' +
                "}\n" +
                "Order findings by severity (P0 first). For action.kind, use run_task with payload {\"taskId\":\"...\"} when a Microsoft predefined task fits, " +
                "generate_plan/run_cve/generate_tests when those fit, otherwise use fix_finding (the cockpit turns it into a 'Help me fix this' button). Omit action only if there is genuinely nothing to do."
            );
        case "generate_plan":
            return (
                APPMOD_PREAMBLE +
                "\n\nCreate a step-by-step modernization plan to upgrade this project to Java " + (p.targetJava || 21) + ". " +
                "Cover build-file changes, removed/replaced APIs, dependency upgrades, and required test updates. " +
                "Write the plan as a checklist in plan.md and create an empty progress.md mirroring those steps. Do not change code yet."
            );
        case "run_task": {
            const t = PREDEFINED_TASKS.find((x) => x.id === p.taskId);
            if (!t) return null;
            return (
                APPMOD_PREAMBLE +
                "\n\nApply the App Modernization predefined task \"" + t.name + "\": " + t.summary + "\n" +
                "Steps: (1) record the plan in plan.md and progress.md; (2) check out a migration branch; " +
                "(3) make the code changes for this task; (4) validate by building, running unit tests, and a CVE check; " +
                "(5) write a summary.md of what changed. Pause for my confirmation before committing."
            );
        }
        case "run_skill":
            if (!p.folder) return null;
            return (
                APPMOD_PREAMBLE +
                "\n\nRun the custom modernization skill in .github/skills/" + p.folder + "/SKILL.md. " +
                "Follow its instructions and referenced resources exactly, updating plan.md and progress.md as you go, " +
                "and write summary.md when finished."
            );
        case "run_cve":
            return "Check this Java project for known CVE issues using #appmod-validate-cves-for-java and report which dependencies need upgrading, then update progress.md.";
        case "generate_tests":
            return "Generate unit tests for this Java project using #appmod-generate-tests-for-java, then run them and record the result in progress.md.";
        case "run_build_tests":
            return "Build this project and run its unit tests. Report failures with root-cause analysis and update the Build and Unit Tests entries in progress.md.";
        case "run_consistency":
            return "Run a consistency check comparing the modernized code against the original behavior (APIs, SQL, wire format). List any behavioral differences and update progress.md.";