@doquflow/cli 1.3.0 → 1.4.0

package/dist/commands/ui.js

@@ -202,6 +202,7 @@ async function run(opts = {}) {
     const lintWikiTool = loadTool('lint-wiki', 'lintWiki');
     const queryWikiTool = loadTool('query-wiki', 'queryWiki');
     const wikiSearchTool = loadTool('wiki-search', 'wikiSearch');
+    const buildGraphTool = loadTool('build-graph', 'buildGraph');
     // ── 3. Express app ──────────────────────────────────────────────────────
     const app = (0, express_1.default)();
     app.use((0, cors_1.default)());
@@ -296,6 +297,17 @@ async function run(opts = {}) {
         }
         return res.status(404).json({ error: `Page not found: ${pageId}` });
     });
+    app.get('/api/graph', async (req, res) => {
+        const projectPath = req.query.path;
+        if (!projectPath)
+            return res.status(400).json({ error: 'path required' });
+        try {
+            return res.json(await buildGraphTool({ project_path: projectPath }));
+        }
+        catch (e) {
+            return res.status(500).json({ error: e.message });
+        }
+    });
     app.get('/api/health', async (req, res) => {
         const projectPath = req.query.path;
         if (!projectPath)

package/dist/commands/watch-stop.js

@@ -137,6 +137,31 @@ async function runStatus(projectPath) {
     console.log(`  Uptime:   ${formatUptime(data.started_at)}`);
     console.log(`  Started:  ${new Date(data.started_at).toLocaleString()}`);
     console.log(`  Bridge:   ${bridgeLabel}`);
+    // Active bridge — only shown when it differs from startup bridge (failover occurred)
+    const activeBridge = data.active_bridge ?? data.bridge;
+    if (activeBridge !== data.bridge) {
+        const activeBridgeLabel = activeBridge === "none" ? c.dim("sources-only (no AI)") :
+            activeBridge === "copilot" ? c.green("copilot — direct MCP ⚡") :
+                activeBridge === "claude" ? c.green("claude  — direct MCP ⚡") :
+                    activeBridge === "codex" ? c.yellow("codex   — doc-gen mode") :
+                        activeBridge === "api" ? c.yellow("api     — doc-gen mode") : activeBridge;
+        console.log(`  Active bridge: ${activeBridgeLabel} ${c.yellow("(failed over)")}`);
+    }
+    // Failover stats
+    const failover = data.failover ?? { count: 0, last_at: null, from: null, to: null, reason: null };
+    if (failover.count > 0) {
+        const lastAt = failover.last_at
+            ? new Date(failover.last_at).toLocaleTimeString()
+            : "unknown";
+        console.log(`  Failovers:     ${c.yellow(String(failover.count))} total`);
+        console.log(`  Last failover: ${lastAt} — ${failover.from} → ${failover.to}`);
+        if (failover.reason) {
+            console.log(`  Reason:        ${c.dim(failover.reason)}`);
+        }
+    }
+    else {
+        console.log(`  Failovers:     ${c.dim("none")}`);
+    }
     console.log(`  Project:  ${data.project_path}`);
     if (data.options.lintIntervalHours) {
         console.log(`  Lint:     every ${data.options.lintIntervalHours}h`);

package/dist/commands/watch.js

@@ -39,6 +39,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.detectBridge = detectBridge;
+exports.getNextBridge = getNextBridge;
+exports.recordFailover = recordFailover;
 exports.getPidFilePath = getPidFilePath;
 exports.writePidFile = writePidFile;
 exports.removePidFile = removePidFile;
@@ -282,7 +284,11 @@ function buildDocGenPrompt(projectPath, changedFiles) {
     ].join("\n");
 }
 // ─── Core sync dispatcher ─────────────────────────────────────────────────────
-async function syncWithAI(projectPath, changedFiles, bridge) {
+async function syncWithAI(projectPath, changedFiles, bridge, depth = 0) {
+    if (bridge === "none" || depth >= 4) {
+        await directIngestAll(projectPath);
+        return;
+    }
     const bridgeLabel = bridge === "copilot" ? "Copilot" : bridge === "claude" ? "Claude" : bridge === "codex" ? "Codex" : "API";
     log("🤖", `${changedFiles.length} file(s) changed — asking ${c.cyan(bridgeLabel)} to update wiki...`);
     // Copilot and Claude: DIRECT MCP tool calling
@@ -294,8 +300,10 @@ async function syncWithAI(projectPath, changedFiles, bridge) {
             console.log(c.dim(`     ${result.replace(/\n/g, "\n     ")}`));
         }
         else {
-            log("⚠️ ", c.yellow("Copilot returned no result — falling back to direct ingest"));
-            await directIngestAll(projectPath);
+            const next = getNextBridge(bridge);
+            await recordFailover(projectPath, bridge, next, "no output");
+            log("⚠️ ", c.yellow(`Copilot failed — falling over to ${next}`));
+            await syncWithAI(projectPath, changedFiles, next, depth + 1);
         }
         return;
     }
@@ -307,8 +315,10 @@ async function syncWithAI(projectPath, changedFiles, bridge) {
             console.log(c.dim(`     ${result.replace(/\n/g, "\n     ")}`));
         }
         else {
-            log("⚠️ ", c.yellow("Claude returned no result — falling back to direct ingest"));
-            await directIngestAll(projectPath);
+            const next = getNextBridge(bridge);
+            await recordFailover(projectPath, bridge, next, "no output");
+            log("⚠️ ", c.yellow(`Claude failed — falling over to ${next}`));
+            await syncWithAI(projectPath, changedFiles, next, depth + 1);
         }
         return;
     }
@@ -322,8 +332,10 @@ async function syncWithAI(projectPath, changedFiles, bridge) {
         docContent = await callAnthropicAPI(docPrompt);
     }
     if (!docContent) {
-        log("⚠️ ", c.yellow("AI returned no content — falling back to direct ingest"));
-        await directIngestAll(projectPath);
+        const next = getNextBridge(bridge);
+        await recordFailover(projectPath, bridge, next, "no output");
+        log("⚠️ ", c.yellow(`${bridgeLabel} failed — falling over to ${next}`));
+        await syncWithAI(projectPath, changedFiles, next, depth + 1);
         return;
     }
     // Save AI-generated doc to sources/
@@ -335,13 +347,23 @@ async function syncWithAI(projectPath, changedFiles, bridge) {
     log("💾", `AI doc saved → ${c.cyan(autoFilename)}`);
     await directIngest(projectPath, autoFilename);
 }
-async function scheduledLintWithAI(projectPath, bridge) {
+async function scheduledLintWithAI(projectPath, bridge, depth = 0) {
+    if (bridge === "none" || depth >= 4) {
+        // Lint is best-effort — silent return at terminal level (no directIngestAll)
+        return;
+    }
     if (bridge === "copilot") {
         log("🔍", `Running scheduled lint via ${c.cyan("Copilot")} (direct MCP call)...`);
         const result = runCopilotCLI(buildCopilotLintPrompt(projectPath));
         if (result) {
             console.log(c.dim(`     ${result.replace(/\n/g, "\n     ")}`));
         }
+        else {
+            const next = getNextBridge(bridge);
+            await recordFailover(projectPath, bridge, next, "no output during lint");
+            log("⚠️ ", c.yellow(`Copilot lint failed — falling over to ${next}`));
+            await scheduledLintWithAI(projectPath, next, depth + 1);
+        }
         return;
     }
     if (bridge === "claude") {
@@ -350,10 +372,17 @@ async function scheduledLintWithAI(projectPath, bridge) {
         if (result) {
             console.log(c.dim(`     ${result.replace(/\n/g, "\n     ")}`));
         }
+        else {
+            const next = getNextBridge(bridge);
+            await recordFailover(projectPath, bridge, next, "no output during lint");
+            log("⚠️ ", c.yellow(`Claude lint failed — falling over to ${next}`));
+            await scheduledLintWithAI(projectPath, next, depth + 1);
+        }
         return;
     }
-    // Fallback: call lint tool directly
-    await directLint(projectPath);
+    const next = getNextBridge(bridge);
+    log("ℹ️ ", c.dim(`${bridge} cannot perform MCP lint — escalating to ${next}`));
+    await scheduledLintWithAI(projectPath, next, depth + 1);
 }
 // ─── Direct tool calls (no AI) ───────────────────────────────────────────────
 async function directIngest(projectPath, filename) {
@@ -378,22 +407,6 @@ async function directIngestAll(projectPath) {
     }
     catch { }
 }
-async function directLint(projectPath) {
-    const { lintWiki } = loadServerTool("lint-wiki");
-    log("🔍", "Running scheduled lint check...");
-    const result = await lintWiki({ project_path: projectPath, check_type: "all" });
-    const score = result.health_score ?? 0;
-    const scoreLabel = score >= 90 ? c.green(`${score}/100`) : score >= 70 ? c.yellow(`${score}/100`) : c.red(`${score}/100`);
-    log("📊", `Health score: ${scoreLabel}`);
-    if (result.issues_found?.length > 0) {
-        const high = result.issues_found.filter((i) => i.severity === "high").length;
-        const med = result.issues_found.filter((i) => i.severity === "medium").length;
-        log("⚠️ ", `Issues: 🔴 ${high} high  🟡 ${med} medium`);
-        for (const rec of result.recommendations?.slice(0, 3) ?? []) {
-            console.log(c.dim(`     → ${rec}`));
-        }
-    }
-}
 // ─── Debounce helper ─────────────────────────────────────────────────────────
 function debounce(fn, ms) {
     let timer;
@@ -408,6 +421,32 @@ const DEFAULT_CODE_EXTS = new Set([
     ".py", ".go", ".rb", ".java", ".cs",
     ".php", ".rs", ".kt", ".swift", ".vue",
 ]);
+function getNextBridge(current) {
+    const chain = ["copilot", "claude", "codex", "api", "none"];
+    const idx = chain.indexOf(current);
+    return (idx !== -1 && idx + 1 < chain.length) ? chain[idx + 1] : "none";
+}
+async function recordFailover(projectPath, from, to, reason) {
+    try {
+        const data = await readPidFile(projectPath);
+        if (!data)
+            return;
+        if (!data.failover) {
+            data.failover = { count: 0, last_at: null, from: null, to: null, reason: null };
+        }
+        data.failover.count += 1;
+        data.failover.last_at = new Date().toISOString();
+        data.failover.from = from;
+        data.failover.to = to;
+        data.failover.reason = reason.slice(0, 120);
+        data.active_bridge = to;
+        try {
+            await writePidFile(projectPath, data);
+        }
+        catch { }
+    }
+    catch { }
+}
 function getPidFilePath(projectPath) {
     return node_path_1.default.join(projectPath, ".docuflow", "watch.pid");
 }
@@ -501,6 +540,7 @@ async function run(options = {}) {
         pid: process.pid,
         started_at: new Date().toISOString(),
         bridge,
+        active_bridge: bridge,
         project_path: projectPath,
         options: {
             ai: !!options.ai,
@@ -510,6 +550,13 @@ async function run(options = {}) {
             lintIntervalHours: options.lintIntervalHours ?? 24,
             codeExtensions: options.codeExtensions,
         },
+        failover: {
+            count: 0,
+            last_at: null,
+            from: null,
+            to: null,
+            reason: null,
+        },
     });
     log("💾", `PID ${process.pid} written to ${c.dim(".docuflow/watch.pid")}`);
     // ── Watch 1: .docuflow/sources/ ─────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doquflow/cli",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "CLI for setting up Docuflow in your project",
   "author": "Docuflow <hello@doquflows.dev>",
   "license": "MIT",
@@ -31,7 +31,7 @@
     "build": "tsc && node -e \"const fs=require('fs'),p=require('path'),src=p.join(process.cwd(),'../ui/dist'),dst=p.join(process.cwd(),'ui-dist');if(!fs.existsSync(src)){console.log('Warning: packages/ui/dist not found — run npm run build:ui first');process.exit(0)}fs.mkdirSync(dst,{recursive:true});fs.cpSync(src,dst,{recursive:true,force:true});console.log('  ✓ ui-dist synced from packages/ui/dist ('+(fs.readdirSync(dst).length)+' files at root)')\""
   },
   "dependencies": {
-    "@doquflow/server": "1.3.0",
+    "@doquflow/server": "1.4.0",
     "cors": "^2.8.5",
     "express": "^4.19.2"
   },