@helix3/helix-cli 0.1.14-helix3.192 → 0.1.14-helix3.193

package/dist/index.js

@@ -4580,7 +4580,52 @@ function registerUnrealValidationCommand(name, description) {
             process.exitCode = 1;
     });
 }
-registerUnrealValidationCommand('doctor', 'Check publish readiness plus safe editor-only Unreal MCP authoring setup');
+unreal
+    .command('doctor')
+    .description('Check publish readiness; with --engine or --fix, also run the in-editor HELIX Project Doctor')
+    .argument('[project]', 'project directory or .uproject file', '.')
+    .option('--engine', 'additionally run the SDK Project Doctor commandlet (needs UE_ROOT)')
+    .option('--fix', 'apply every automatable in-editor fix, then re-scan (implies --engine)')
+    .option('--json', 'machine-readable report')
+    .action(async (project, opts) => {
+    // Layer 1 — static validation, no editor required: the existing check.
+    const staticReport = (0, unreal_1.validateUnrealProject)(project, { includeMcp: true });
+    // Layer 2 — the SDK's in-editor Doctor, the same single implementation the
+    // Creator Kit panel calls (helix-unreal-runtime -run=HelixProjectDoctor).
+    let engineResult;
+    if (opts.engine || opts.fix) {
+        try {
+            const { runUnrealDoctor } = await Promise.resolve().then(() => __importStar(require('./unreal/doctor')));
+            const projectDir = project.endsWith('.uproject') ? (0, node_path_1.dirname)((0, node_path_1.resolve)(project)) : project;
+            engineResult = runUnrealDoctor({ projectDir, fix: opts.fix });
+        }
+        catch (error) {
+            fail(`✖ ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    if (opts.json) {
+        console.log(JSON.stringify({ static: staticReport, engine: engineResult?.report ?? null }, null, 2));
+    }
+    else {
+        console.log((0, unreal_1.formatUnrealValidationReport)(staticReport));
+        if (engineResult) {
+            if (engineResult.processExitMismatch !== undefined) {
+                console.error(`(editor process exited ${engineResult.processExitMismatch}; the report is authoritative — engine exit codes are polluted by error-logged asset loads)`);
+            }
+            const mark = { pass: '✔', fixable: '△', 'creator-action': '✖', unsupported: '⛔' };
+            for (const finding of engineResult.report.findings) {
+                console.log(`  ${mark[finding.status] ?? '?'} ${finding.checkId}: ${finding.message}${finding.fix ? ` Fix: ${finding.fix}` : ''}`);
+            }
+            console.log(`Project Doctor verdict: ${engineResult.report.verdict}`);
+        }
+    }
+    // Who-must-act ordinal end to end: static failure is a 1 at minimum, the
+    // engine verdict can only raise it.
+    const staticCode = staticReport.ok ? 0 : 1;
+    const code = Math.max(staticCode, engineResult?.exitCode ?? 0);
+    if (code !== 0)
+        process.exitCode = code;
+});
 registerUnrealValidationCommand('validate', 'Validate the project and HELIX publish manifest without requiring editor MCP');
 unreal
     .command('package')