@mozole/cli 1.3.1 → 1.4.0

package/dist/commands/doctor.js

@@ -8,7 +8,7 @@ import { inspectAntigravityWorkspace } from "../integrations/antigravity.js";
 import { resolveExecutable } from "../platform/executable.js";
 import { run } from "../platform/process.js";
 import { TaskProgress } from "../progress.js";
-import { inspectAdminScaffold } from "../scaffold/admin.js";
+import { inspectBackendScaffold } from "../scaffold/backend.js";
 async function executable(name, args = ["--version"], required = false) {
     const resolved = await resolveExecutable(name);
     if (!resolved)
@@ -49,301 +49,342 @@ export async function doctorCommand(cwd, output = console, options = {}) {
         output,
         onUpdate: options.onProgress,
     });
-    progress.step("Probing platform & runtime executables", "Node, npm, Git");
-    const node = await executable("node", ["--version"], true);
-    const nodeMajor = Number(node.value?.match(/\d+/)?.[0] ?? 0);
-    node.healthy = node.healthy && nodeMajor >= 22;
-    const npm = await executable("npm", ["--version"], true);
-    const git = await executable("git");
-    progress.logVerbose(`Node: ${node.value}, npm: ${npm.value}, git: ${git.value}`);
-    progress.step("Probing AI agent toolchains", "Codex, Claude Code, Antigravity");
-    const codex = await executable("codex");
-    const claude = await executable("claude");
-    const antigravityPath = await detectAntigravityRuntime();
-    let antigravity = {
-        group: "Agents",
-        name: "Antigravity",
-        healthy: false,
-        value: "optional runtime not found",
-        required: false,
-    };
-    if (antigravityPath) {
-        const result = await run(antigravityPath, ["--version"], {
-            cwd,
-            timeoutMs: 5_000,
-        });
-        antigravity = {
+    try {
+        const selectedConfig = await findProjectRoot(cwd)
+            .then(readConfig)
+            .catch(() => undefined);
+        const plain = selectedConfig !== undefined && !selectedConfig.cce?.enabled;
+        progress.step("Probing platform & runtime executables", "Node, npm, Git");
+        const node = await executable("node", ["--version"], true);
+        const nodeMajor = Number(node.value?.match(/\d+/)?.[0] ?? 0);
+        node.healthy = node.healthy && nodeMajor >= 22;
+        const npm = await executable("npm", ["--version"], true);
+        const git = await executable("git");
+        progress.logVerbose(`Node: ${node.value}, npm: ${npm.value}, git: ${git.value}`);
+        progress.step("Probing AI agent toolchains", "Codex, Claude Code, Antigravity");
+        const codex = plain
+            ? { healthy: true, required: false }
+            : await executable("codex");
+        const claude = plain
+            ? { healthy: true, required: false }
+            : await executable("claude");
+        const antigravityPath = plain
+            ? undefined
+            : await detectAntigravityRuntime();
+        let antigravity = {
             group: "Agents",
             name: "Antigravity",
-            healthy: result.exitCode === 0,
-            value: (result.stdout || result.stderr).trim().split(/\r?\n/)[0],
+            healthy: false,
+            value: "optional runtime not found",
             required: false,
         };
-    }
-    progress.logVerbose(`Agents: Codex=${codex.healthy}, Claude=${claude.healthy}, Antigravity=${antigravity.healthy}`);
-    progress.step("Verifying headless browser environment", "Chromium");
-    progress.logVerbose("Checking Playwright Chromium executable");
-    const cceInspection = await inspectCceRuntime(resolveExecutable, cwd);
-    const cceRuntime = cceInspection.runtime;
-    const cceDiagnostic = {
-        group: "Context",
-        name: "CCE runtime",
-        healthy: cceInspection.healthy,
-        value: cceInspection.value,
-        required: false,
-    };
-    const diagnostics = [
-        {
-            group: "Platform",
-            name: "OS",
-            healthy: true,
-            value: os.platform(),
-            required: true,
-        },
-        {
-            group: "Platform",
-            name: "Architecture",
-            healthy: true,
-            value: os.arch(),
-            required: true,
-        },
-        { ...node, group: "Runtime", name: "Node" },
-        { ...npm, group: "Runtime", name: "npm" },
-        { ...git, group: "Runtime", name: "Git" },
-        { ...codex, group: "Agents", name: "Codex", required: false },
-        { ...claude, group: "Agents", name: "Claude Code", required: false },
-        antigravity,
-    ];
-    try {
-        await access(chromium.executablePath());
-        diagnostics.push({
-            group: "Browser",
-            name: "Chromium",
-            healthy: true,
-            required: true,
-        });
-    }
-    catch {
-        diagnostics.push({
-            group: "Browser",
-            name: "Chromium",
-            healthy: false,
-            required: true,
-        });
-    }
-    try {
-        progress.step("Inspecting project structure & dependencies", "package.json, configs");
-        const root = await findProjectRoot(cwd);
-        const mozoleConfig = await readConfig(root);
-        const antigravityWorkspace = await inspectAntigravityWorkspace(root);
-        progress.logVerbose(`Found project root: ${root}`);
-        progress.step("Testing context retrieval & workspace integration", "CCE index, MCP & retrieval probe");
-        const cceRequired = mozoleConfig.cce.enabled;
-        let indexHealthy = !mozoleConfig.cce.enabled;
-        let indexValue;
-        if (mozoleConfig.cce.enabled) {
-            if (cceDiagnostic.healthy && cceRuntime) {
-                progress.logVerbose("Checking CCE status");
-                const status = await run(cceRuntime.command, [...cceRuntime.prefix, "status"], { cwd: root, timeoutMs: 5_000 });
-                if (status.signal === "SIGTERM" || status.signal === "SIGKILL") {
-                    indexHealthy = false;
-                    indexValue = "timed out";
-                }
-                else {
-                    const statusText = `${status.stdout}\n${status.stderr}`;
-                    if (isBrokenUvTrampoline(statusText)) {
+        if (antigravityPath) {
+            const result = await run(antigravityPath, ["--version"], {
+                cwd,
+                timeoutMs: 5_000,
+            });
+            antigravity = {
+                group: "Agents",
+                name: "Antigravity",
+                healthy: result.exitCode === 0,
+                value: (result.stdout || result.stderr).trim().split(/\r?\n/)[0],
+                required: false,
+            };
+        }
+        progress.logVerbose(`Agents: Codex=${codex.healthy}, Claude=${claude.healthy}, Antigravity=${antigravity.healthy}`);
+        progress.step("Verifying headless browser environment", "Chromium");
+        progress.logVerbose("Checking Playwright Chromium executable");
+        const cceInspection = plain
+            ? {
+                healthy: false,
+                value: "disabled",
+                runtime: undefined,
+                brokenTrampoline: false,
+            }
+            : await inspectCceRuntime(resolveExecutable, cwd);
+        const cceRuntime = cceInspection.runtime;
+        const cceDiagnostic = {
+            group: "Context",
+            name: "CCE runtime",
+            healthy: cceInspection.healthy,
+            value: cceInspection.value,
+            required: false,
+        };
+        const diagnostics = [
+            {
+                group: "Platform",
+                name: "OS",
+                healthy: true,
+                value: os.platform(),
+                required: true,
+            },
+            {
+                group: "Platform",
+                name: "Architecture",
+                healthy: true,
+                value: os.arch(),
+                required: true,
+            },
+            { ...node, group: "Runtime", name: "Node" },
+            { ...npm, group: "Runtime", name: "npm" },
+            { ...git, group: "Runtime", name: "Git" },
+            { ...codex, group: "Agents", name: "Codex", required: false },
+            { ...claude, group: "Agents", name: "Claude Code", required: false },
+            antigravity,
+        ];
+        try {
+            await access(chromium.executablePath());
+            diagnostics.push({
+                group: "Browser",
+                name: "Chromium",
+                healthy: true,
+                required: true,
+            });
+        }
+        catch {
+            diagnostics.push({
+                group: "Browser",
+                name: "Chromium",
+                healthy: false,
+                required: true,
+            });
+        }
+        try {
+            progress.step("Inspecting project structure & dependencies", "package.json, configs");
+            const root = await findProjectRoot(cwd);
+            const mozoleConfig = await readConfig(root);
+            const antigravityWorkspace = await inspectAntigravityWorkspace(root);
+            progress.logVerbose(`Found project root: ${root}`);
+            progress.step("Testing context retrieval & workspace integration", "CCE index, MCP & retrieval probe");
+            const cceRequired = Boolean(mozoleConfig.cce?.enabled);
+            let indexHealthy = !mozoleConfig.cce?.enabled;
+            let indexValue;
+            if (mozoleConfig.cce?.enabled) {
+                if (cceDiagnostic.healthy && cceRuntime) {
+                    progress.logVerbose("Checking CCE status");
+                    const status = await run(cceRuntime.command, [...cceRuntime.prefix, "status"], { cwd: root, timeoutMs: 5_000 });
+                    if (status.signal === "SIGTERM" || status.signal === "SIGKILL") {
                         indexHealthy = false;
-                        indexValue = "uv trampoline broken";
+                        indexValue = "timed out";
                     }
                     else {
-                        indexHealthy =
-                            status.exitCode === 0 &&
-                                !statusText.includes("Project not indexed yet") &&
-                                !statusText.includes("Not indexed yet") &&
-                                mozoleConfig.cce.initialized;
-                        if (!indexHealthy) {
-                            indexValue = "not indexed";
+                        const statusText = `${status.stdout}\n${status.stderr}`;
+                        if (isBrokenUvTrampoline(statusText)) {
+                            indexHealthy = false;
+                            indexValue = "uv trampoline broken";
+                        }
+                        else {
+                            indexHealthy =
+                                status.exitCode === 0 &&
+                                    !statusText.includes("Project not indexed yet") &&
+                                    !statusText.includes("Not indexed yet") &&
+                                    mozoleConfig.cce.initialized;
+                            if (!indexHealthy) {
+                                indexValue = "not indexed";
+                            }
                         }
                     }
                 }
+                else {
+                    indexHealthy = false;
+                    indexValue = cceInspection.brokenTrampoline
+                        ? "uv trampoline broken"
+                        : "cce unavailable";
+                }
             }
-            else {
-                indexHealthy = false;
-                indexValue = cceInspection.brokenTrampoline
-                    ? "uv trampoline broken"
-                    : "cce unavailable";
+            let mcpHealthy = !mozoleConfig.cce?.enabled;
+            let mcpValue;
+            if (mozoleConfig.cce?.enabled) {
+                mcpHealthy = antigravityWorkspace.cceMcp;
+                if (!mcpHealthy)
+                    mcpValue = "not configured";
             }
-        }
-        let mcpHealthy = !mozoleConfig.cce.enabled;
-        let mcpValue;
-        if (mozoleConfig.cce.enabled) {
-            mcpHealthy = antigravityWorkspace.cceMcp;
-            if (!mcpHealthy)
-                mcpValue = "not configured";
-        }
-        let retrievalHealthy = !mozoleConfig.cce.enabled;
-        let retrievalValue;
-        if (mozoleConfig.cce.enabled) {
-            if (!cceDiagnostic.healthy || !cceRuntime) {
-                retrievalHealthy = false;
-                retrievalValue = cceInspection.brokenTrampoline
-                    ? "uv trampoline broken"
-                    : "cce unavailable";
+            let retrievalHealthy = !mozoleConfig.cce?.enabled;
+            let retrievalValue;
+            if (mozoleConfig.cce?.enabled) {
+                if (!cceDiagnostic.healthy || !cceRuntime) {
+                    retrievalHealthy = false;
+                    retrievalValue = cceInspection.brokenTrampoline
+                        ? "uv trampoline broken"
+                        : "cce unavailable";
+                }
+                else if (!indexHealthy) {
+                    retrievalHealthy = false;
+                    retrievalValue = indexValue ?? "not indexed";
+                }
+                else {
+                    progress.logVerbose("Probing CCE retrieval");
+                    const probe = await probeCceRetrieval(root, cceRuntime, 5_000);
+                    retrievalHealthy = probe.healthy;
+                    retrievalValue = probe.value;
+                }
             }
-            else if (!indexHealthy) {
-                retrievalHealthy = false;
-                retrievalValue = indexValue ?? "not indexed";
+            diagnostics.push({
+                group: "Context",
+                name: "CCE runtime",
+                healthy: cceDiagnostic.healthy,
+                value: cceDiagnostic.value,
+                required: cceRequired,
+            });
+            diagnostics.push({
+                group: "Context",
+                name: "CCE index",
+                healthy: indexHealthy,
+                value: indexValue,
+                required: cceRequired,
+            });
+            diagnostics.push({
+                group: "Context",
+                name: "CCE MCP",
+                healthy: mcpHealthy,
+                value: mcpValue,
+                required: cceRequired,
+            });
+            diagnostics.push({
+                group: "Context",
+                name: "CCE retrieval",
+                healthy: retrievalHealthy,
+                value: retrievalValue,
+                required: cceRequired,
+            });
+            let pkg = {};
+            let pkgError;
+            try {
+                pkg = JSON.parse(await readFile(path.join(root, "package.json"), "utf8"));
             }
-            else {
-                progress.logVerbose("Probing CCE retrieval");
-                const probe = await probeCceRetrieval(root, cceRuntime, 5_000);
-                retrievalHealthy = probe.healthy;
-                retrievalValue = probe.value;
+            catch (error) {
+                pkgError =
+                    error instanceof SyntaxError
+                        ? "invalid package.json"
+                        : "missing package.json";
             }
-        }
-        diagnostics.push({
-            group: "Context",
-            name: "CCE runtime",
-            healthy: cceDiagnostic.healthy,
-            value: cceDiagnostic.value,
-            required: cceRequired,
-        });
-        diagnostics.push({
-            group: "Context",
-            name: "CCE index",
-            healthy: indexHealthy,
-            value: indexValue,
-            required: cceRequired,
-        });
-        diagnostics.push({
-            group: "Context",
-            name: "CCE MCP",
-            healthy: mcpHealthy,
-            value: mcpValue,
-            required: cceRequired,
-        });
-        diagnostics.push({
-            group: "Context",
-            name: "CCE retrieval",
-            healthy: retrievalHealthy,
-            value: retrievalValue,
-            required: cceRequired,
-        });
-        const pkg = JSON.parse(await readFile(path.join(root, "package.json"), "utf8"));
-        const hasReactRouter = Boolean(packageVersion(pkg, "react-router") ||
-            packageVersion(pkg, "@react-router/dev"));
-        const hasVite = Boolean(packageVersion(pkg, "vite") ||
-            packageVersion(pkg, "@vitejs/plugin-react"));
-        for (const [label, key, required, opt] of [
-            [
-                "React Router",
-                "react-router",
-                hasReactRouter || !hasVite,
-                !hasReactRouter && hasVite,
-            ],
-            ["React", "react", true, false],
-            ["Vite", "vite", hasVite || !hasReactRouter, false],
-            ["TypeScript", "typescript", true, false],
-            ["Biome", "@biomejs/biome", true, false],
-            ["Vitest", "vitest", true, false],
-        ])
+            const hasReactRouter = Boolean(packageVersion(pkg, "react-router") ||
+                packageVersion(pkg, "@react-router/dev"));
+            const hasVite = Boolean(packageVersion(pkg, "vite") ||
+                packageVersion(pkg, "@vitejs/plugin-react"));
+            for (const [label, key, required, opt] of [
+                [
+                    "React Router",
+                    "react-router",
+                    hasReactRouter || !hasVite,
+                    !hasReactRouter && hasVite,
+                ],
+                ["React", "react", true, false],
+                ["Vite", "vite", hasVite || !hasReactRouter, false],
+                ["TypeScript", "typescript", true, false],
+                ["Biome", "@biomejs/biome", true, false],
+                ["Vitest", "vitest", true, false],
+            ])
+                diagnostics.push({
+                    group: "Project",
+                    name: label,
+                    healthy: Boolean(packageVersion(pkg, key)),
+                    value: packageVersion(pkg, key) ?? (opt ? "optional" : undefined),
+                    required,
+                });
             diagnostics.push({
                 group: "Project",
-                name: label,
-                healthy: Boolean(packageVersion(pkg, key)),
-                value: packageVersion(pkg, key) ?? (opt ? "optional" : undefined),
-                required,
+                name: "Mozole metadata",
+                healthy: !pkgError,
+                value: pkgError,
+                required: true,
             });
-        diagnostics.push({
-            group: "Project",
-            name: "Mozole metadata",
-            healthy: true,
-            required: true,
-        });
-        const admin = await inspectAdminScaffold(root, mozoleConfig);
-        diagnostics.push({
-            group: "Project",
-            name: "Admin runtime",
-            healthy: admin.healthy,
-            value: admin.detail,
-            required: admin.enabled,
-        });
-        for (const [name, healthy] of [
-            ["Workspace", antigravityWorkspace.workspace],
-            ["CCE MCP", antigravityWorkspace.cceMcp],
-            ["Rule", antigravityWorkspace.rule],
-            ["Workflows", antigravityWorkspace.workflows],
-        ])
+            const backend = await inspectBackendScaffold(root, mozoleConfig);
             diagnostics.push({
-                group: "Antigravity",
-                name,
-                healthy,
-                value: !healthy && name === "Workspace"
-                    ? antigravityWorkspace.detail
-                    : undefined,
-                required: false,
+                group: "Project",
+                name: "PHP Backend",
+                healthy: backend.healthy,
+                value: backend.detail,
+                required: backend.enabled,
             });
-        diagnostics.push({
-            group: "Governor",
-            name: "State cache",
-            healthy: mozoleConfig.governor.enabled,
-            value: mozoleConfig.governor.enabled
-                ? mozoleConfig.governor.mode
-                : "disabled",
-            required: mozoleConfig.governor.enabled,
-        });
-        for (const [name, relative, enabled] of [
-            [
-                "Codex hook",
-                [".codex", "hooks.json"],
-                mozoleConfig.governor.hooks.codex,
-            ],
-            [
-                "Claude hook",
-                [".claude", "settings.json"],
-                mozoleConfig.governor.hooks.claude,
-            ],
-        ]) {
-            let installed = !enabled;
-            try {
-                installed = (await readFile(path.join(root, ...relative), "utf8")).includes("mozole governor hook");
-            }
-            catch { }
+            for (const [name, healthy] of [
+                ["Workspace", antigravityWorkspace.workspace],
+                ["CCE MCP", antigravityWorkspace.cceMcp],
+                ["Rule", antigravityWorkspace.rule],
+                ["Workflows", antigravityWorkspace.workflows],
+            ])
+                diagnostics.push({
+                    group: "Antigravity",
+                    name,
+                    healthy,
+                    value: !healthy && name === "Workspace"
+                        ? antigravityWorkspace.detail
+                        : undefined,
+                    required: false,
+                });
             diagnostics.push({
                 group: "Governor",
-                name,
-                healthy: installed,
-                required: enabled,
+                name: "State cache",
+                healthy: Boolean(mozoleConfig.governor?.enabled),
+                value: mozoleConfig.governor?.enabled
+                    ? mozoleConfig.governor.mode
+                    : "disabled",
+                required: Boolean(mozoleConfig.governor?.enabled),
             });
+            for (const [name, relative, enabled] of [
+                [
+                    "Codex hook",
+                    [".codex", "hooks.json"],
+                    Boolean(mozoleConfig.governor?.hooks.codex),
+                ],
+                [
+                    "Claude hook",
+                    [".claude", "settings.json"],
+                    Boolean(mozoleConfig.governor?.hooks.claude),
+                ],
+            ]) {
+                let installed = !enabled;
+                try {
+                    installed = (await readFile(path.join(root, ...relative), "utf8")).includes("mozole governor hook");
+                }
+                catch { }
+                diagnostics.push({
+                    group: "Governor",
+                    name,
+                    healthy: installed,
+                    required: enabled,
+                });
+            }
         }
-    }
-    catch {
-        diagnostics.push(cceDiagnostic);
-        diagnostics.push({
-            group: "Project",
-            name: "Mozole project",
-            healthy: false,
-            value: "not found",
-            required: false,
-        });
-    }
-    let current = "";
-    const lines = ["Mozole", ""];
-    for (const item of diagnostics) {
-        if (item.group !== current) {
-            if (current)
-                lines.push("");
-            current = item.group;
-            lines.push(current);
+        catch {
+            diagnostics.push(cceDiagnostic);
+            diagnostics.push({
+                group: "Project",
+                name: "Mozole project",
+                healthy: false,
+                value: "not found",
+                required: false,
+            });
+        }
+        if (plain) {
+            for (let index = diagnostics.length - 1; index >= 0; index--) {
+                if (["Context", "Governor", "Antigravity", "Agents"].includes(diagnostics[index]?.group ?? ""))
+                    diagnostics.splice(index, 1);
+            }
+        }
+        let current = "";
+        const lines = ["Mozole", ""];
+        for (const item of diagnostics) {
+            if (item.group !== current) {
+                if (current)
+                    lines.push("");
+                current = item.group;
+                lines.push(current);
+            }
+            lines.push(`  ${item.name.padEnd(16)} ${item.healthy ? "✓" : "✗"}${item.value ? `  ${item.value}` : ""}`);
         }
-        lines.push(`  ${item.name.padEnd(16)} ${item.healthy ? "✓" : "✗"}${item.value ? `  ${item.value}` : ""}`);
+        const healthy = diagnostics
+            .filter((item) => item.required)
+            .every((item) => item.healthy);
+        lines.push("", `Status: ${healthy ? "HEALTHY" : "NEEDS ATTENTION"}`);
+        progress.done();
+        output.log(lines.join("\n"));
+        return healthy ? 0 : 1;
+    }
+    catch (error) {
+        progress.done();
+        output.error(`DOCTOR FAIL\n\n${error instanceof Error ? error.message : String(error)}`);
+        return 2;
     }
-    const healthy = diagnostics
-        .filter((item) => item.required)
-        .every((item) => item.healthy);
-    lines.push("", `Status: ${healthy ? "HEALTHY" : "NEEDS ATTENTION"}`);
-    progress.done();
-    output.log(lines.join("\n"));
-    return healthy ? 0 : 1;
 }
 //# sourceMappingURL=doctor.js.map