@doquflow/cli 1.6.0 → 2.0.0

package/dist/index.js

@@ -45,169 +45,170 @@ function getFlagValue(flag) {
     const idx = rest.indexOf(flag);
     return idx !== -1 ? rest[idx + 1] : undefined;
 }
-if (cmd === '--version' || cmd === '-v') {
-    console.log(version);
+// ── hasFlagIn / getFlagValueIn — scoped to a specific args array ─────────────
+function hasFlagIn(arr, ...flags) {
+    return flags.some(f => arr.includes(f));
 }
-else if (cmd === 'init') {
-    if (hasFlag('--interactive', '-i')) {
-        Promise.resolve().then(() => __importStar(require('./commands/init-interactive'))).then(m => m.runInteractive());
+function getFlagValueIn(arr, flag) {
+    const idx = arr.indexOf(flag);
+    return idx !== -1 ? arr[idx + 1] : undefined;
+}
+// ── dispatch — routes a (cmd, cmdRest) pair to the right handler ──────────────
+function dispatch(c, r) {
+    if (c === '--version' || c === '-v') {
+        console.log(version);
+        // ── CORE ──────────────────────────────────────────────────────────────────
     }
-    else {
-        Promise.resolve().then(() => __importStar(require('./commands/init'))).then(m => m.run());
+    else if (c === 'init') {
+        if (hasFlagIn(r, '--interactive', '-i')) {
+            Promise.resolve().then(() => __importStar(require('./commands/init-interactive'))).then(m => m.runInteractive());
+        }
+        else {
+            Promise.resolve().then(() => __importStar(require('./commands/init'))).then(m => m.run());
+        }
     }
-}
-else if (cmd === 'status') {
-    Promise.resolve().then(() => __importStar(require('./commands/status'))).then(m => m.run());
-}
-else if (cmd === 'suggest') {
-    Promise.resolve().then(() => __importStar(require('./commands/suggest'))).then(m => m.run());
-    // ── ui / start — web interface ───────────────────────────────────────────────
-}
-else if (cmd === 'ui' || cmd === 'start') {
-    const portFlag = getFlagValue('--port');
-    Promise.resolve().then(() => __importStar(require('./commands/ui'))).then(m => m.run({
-        port: portFlag ? parseInt(portFlag, 10) : undefined,
-        noOpen: hasFlag('--no-open'),
-    }));
-    // ── watch — auto-sync daemon ─────────────────────────────────────────────────
-}
-else if (cmd === 'watch') {
-    const subCmd = rest[0];
-    if (subCmd === 'stop') {
-        Promise.resolve().then(() => __importStar(require('./commands/watch-stop'))).then(m => m.runStop(process.cwd()));
+    else if (c === 'status') {
+        Promise.resolve().then(() => __importStar(require('./commands/status'))).then(m => m.run());
+        // ── query — ask the wiki ──────────────────────────────────────────────────
+    }
+    else if (c === 'query') {
+        const question = r[0] && !r[0].startsWith('--') ? r[0] : '';
+        const maxSourcesFlag = getFlagValueIn(r, '--max-sources');
+        Promise.resolve().then(() => __importStar(require('./commands/query'))).then(m => m.run({
+            question,
+            maxSources: maxSourcesFlag ? parseInt(maxSourcesFlag, 10) : 5,
+            json: hasFlagIn(r, '--json'),
+            noCite: hasFlagIn(r, '--no-cite'),
+            saveAs: getFlagValueIn(r, '--save-as'),
+            quiet: hasFlagIn(r, '--quiet', '-q'),
+        }));
+        // ── ingest — ingest a source file into the wiki ───────────────────────────
     }
-    else if (subCmd === 'status') {
-        Promise.resolve().then(() => __importStar(require('./commands/watch-stop'))).then(m => m.runStatus(process.cwd()));
+    else if (c === 'ingest') {
+        const sourceFile = r[0] && !r[0].startsWith('--') ? r[0] : undefined;
+        Promise.resolve().then(() => __importStar(require('./commands/ingest'))).then(m => m.run({
+            sourceFile,
+            all: hasFlagIn(r, '--all'),
+            dryRun: hasFlagIn(r, '--dry-run'),
+            quiet: hasFlagIn(r, '--quiet', '-q'),
+        }));
+        // ── rewiki — re-ingest all sources with new extractor rules ──────────────
     }
-    else if (subCmd === 'restart') {
-        Promise.resolve().then(() => __importStar(require('./commands/watch-stop'))).then(m => m.runRestart(process.cwd()));
+    else if (c === 'rewiki') {
+        Promise.resolve().then(() => __importStar(require('./commands/rewiki'))).then(m => m.run({
+            dryRun: hasFlagIn(r, '--dry-run'),
+            noBackup: hasFlagIn(r, '--no-backup'),
+            quiet: hasFlagIn(r, '--quiet', '-q'),
+        }));
+        // ── doctor — diagnose install, MCP registration, and wiki health ──────────
     }
-    else {
-        const lintHours = getFlagValue('--lint-interval');
-        const codeExt = getFlagValue('--code-ext');
-        Promise.resolve().then(() => __importStar(require('./commands/watch'))).then(m => m.run({
-            ai: hasFlag('--ai'),
-            forceCopilot: hasFlag('--copilot'),
-            forceClaude: hasFlag('--claude'),
-            forceCodex: hasFlag('--codex'),
-            lintIntervalHours: lintHours ? Number(lintHours) : 24,
-            codeExtensions: codeExt ? codeExt.split(',') : undefined,
-            allowDangerousPermissions: hasFlag('--allow-dangerous-permissions'),
+    else if (c === 'doctor') {
+        Promise.resolve().then(() => __importStar(require('./commands/doctor'))).then(m => m.run({
+            json: hasFlagIn(r, '--json'),
+            quiet: hasFlagIn(r, '--quiet', '-q'),
         }));
+        // ── ADVANCED ──────────────────────────────────────────────────────────────
+    }
+    else if (c === 'suggest') {
+        Promise.resolve().then(() => __importStar(require('./commands/suggest'))).then(m => m.run());
+        // ── ui / start — web interface ────────────────────────────────────────────
+    }
+    else if (c === 'ui' || c === 'start') {
+        const portFlag = getFlagValueIn(r, '--port');
+        Promise.resolve().then(() => __importStar(require('./commands/ui'))).then(m => m.run({
+            port: portFlag ? parseInt(portFlag, 10) : undefined,
+            noOpen: hasFlagIn(r, '--no-open'),
+        }));
+        // ── watch — auto-sync daemon ──────────────────────────────────────────────
+    }
+    else if (c === 'watch') {
+        const subCmd = r[0];
+        if (subCmd === 'stop') {
+            Promise.resolve().then(() => __importStar(require('./commands/watch-stop'))).then(m => m.runStop(process.cwd()));
+        }
+        else if (subCmd === 'status') {
+            Promise.resolve().then(() => __importStar(require('./commands/watch-stop'))).then(m => m.runStatus(process.cwd()));
+        }
+        else if (subCmd === 'restart') {
+            Promise.resolve().then(() => __importStar(require('./commands/watch-stop'))).then(m => m.runRestart(process.cwd()));
+        }
+        else {
+            const lintHours = getFlagValueIn(r, '--lint-interval');
+            const codeExt = getFlagValueIn(r, '--code-ext');
+            Promise.resolve().then(() => __importStar(require('./commands/watch'))).then(m => m.run({
+                ai: hasFlagIn(r, '--ai'),
+                forceCopilot: hasFlagIn(r, '--copilot'),
+                forceClaude: hasFlagIn(r, '--claude'),
+                forceCodex: hasFlagIn(r, '--codex'),
+                lintIntervalHours: lintHours ? Number(lintHours) : 24,
+                codeExtensions: codeExt ? codeExt.split(',') : undefined,
+                allowDangerousPermissions: hasFlagIn(r, '--allow-dangerous-permissions'),
+            }));
+        }
+        // ── sync — one-shot sync for CI/CD and git hooks ──────────────────────────
+    }
+    else if (c === 'sync') {
+        const sinceCommit = getFlagValueIn(r, '--since-commit');
+        const sourceFile = getFlagValueIn(r, '--source');
+        const failScore = getFlagValueIn(r, '--fail-on-score');
+        Promise.resolve().then(() => __importStar(require('./commands/sync'))).then(m => m.run({
+            ai: hasFlagIn(r, '--ai'),
+            forceCopilot: hasFlagIn(r, '--copilot'),
+            forceClaude: hasFlagIn(r, '--claude'),
+            forceCodex: hasFlagIn(r, '--codex'),
+            sinceCommit,
+            sourceFile,
+            noLint: hasFlagIn(r, '--no-lint'),
+            failOnScore: failScore ? Number(failScore) : 70,
+            quiet: hasFlagIn(r, '--quiet', '-q'),
+            allowDangerousPermissions: hasFlagIn(r, '--allow-dangerous-permissions'),
+        }));
+        // ── review — git change review & improvement suggestions ──────────────────
+    }
+    else if (c === 'review') {
+        Promise.resolve().then(() => __importStar(require('./commands/review'))).then(m => m.run({
+            staged: hasFlagIn(r, '--staged'),
+            sinceCommit: getFlagValueIn(r, '--since-commit'),
+            ai: hasFlagIn(r, '--ai'),
+            failOnCritical: hasFlagIn(r, '--fail-on-critical'),
+            quiet: hasFlagIn(r, '--quiet', '-q'),
+        }));
+        // ── update — reinstall latest @doquflow/cli globally ─────────────────────
+    }
+    else if (c === 'update' || c === 'upgrade') {
+        Promise.resolve().then(() => __importStar(require('./commands/update'))).then(m => m.run({
+            check: hasFlagIn(r, '--check'),
+            force: hasFlagIn(r, '--force'),
+        }));
+        // ── recent — show recent task activity ────────────────────────────────────
+    }
+    else if (c === 'recent') {
+        const daysFlag = getFlagValueIn(r, '--days');
+        const fmt = getFlagValueIn(r, '--format');
+        Promise.resolve().then(() => __importStar(require('./commands/recent'))).then(m => m.run({
+            days: daysFlag ? (isNaN(parseInt(daysFlag, 10)) ? 7 : parseInt(daysFlag, 10)) : 7,
+            format: fmt ?? 'table',
+        }));
+        // ── unknown command ───────────────────────────────────────────────────────
+    }
+    else {
+        Promise.resolve().then(() => __importStar(require('./commands/help'))).then(m => m.printCoreHelp());
     }
-    // ── sync — one-shot sync for CI/CD and git hooks ─────────────────────────────
-}
-else if (cmd === 'sync') {
-    const sinceCommit = getFlagValue('--since-commit');
-    const sourceFile = getFlagValue('--source');
-    const failScore = getFlagValue('--fail-on-score');
-    Promise.resolve().then(() => __importStar(require('./commands/sync'))).then(m => m.run({
-        ai: hasFlag('--ai'),
-        forceCopilot: hasFlag('--copilot'),
-        forceClaude: hasFlag('--claude'),
-        forceCodex: hasFlag('--codex'),
-        sinceCommit,
-        sourceFile,
-        noLint: hasFlag('--no-lint'),
-        failOnScore: failScore ? Number(failScore) : 70,
-        quiet: hasFlag('--quiet', '-q'),
-        allowDangerousPermissions: hasFlag('--allow-dangerous-permissions'),
-    }));
-    // ── review — git change review & improvement suggestions ───────────────────────
-}
-else if (cmd === 'review') {
-    Promise.resolve().then(() => __importStar(require('./commands/review'))).then(m => m.run({
-        staged: hasFlag('--staged'),
-        sinceCommit: getFlagValue('--since-commit'),
-        ai: hasFlag('--ai'),
-        failOnCritical: hasFlag('--fail-on-critical'),
-        quiet: hasFlag('--quiet', '-q'),
-    }));
-    // ── update — reinstall latest @doquflow/cli globally ─────────────────────────
-}
-else if (cmd === 'update' || cmd === 'upgrade') {
-    Promise.resolve().then(() => __importStar(require('./commands/update'))).then(m => m.run({
-        check: hasFlag('--check'),
-        force: hasFlag('--force'),
-    }));
-    // ── recent — show recent DevLoop task activity ────────────────────────────────
 }
-else if (cmd === 'recent') {
-    const daysFlag = getFlagValue('--days');
-    const fmt = getFlagValue('--format');
-    Promise.resolve().then(() => __importStar(require('./commands/recent'))).then(m => m.run({
-        days: daysFlag ? (isNaN(parseInt(daysFlag, 10)) ? 7 : parseInt(daysFlag, 10)) : 7,
-        format: fmt ?? 'table',
-    }));
-    // ── rewiki — re-ingest all sources with new extractor rules ──────────────────
+// ── Entry point ───────────────────────────────────────────────────────────────
+if (!cmd || cmd === '--help' || cmd === '-h') {
+    Promise.resolve().then(() => __importStar(require('./commands/help'))).then(m => m.printCoreHelp());
+    // ── advanced — optional prefix for the advanced surface ──────────────────────
 }
-else if (cmd === 'rewiki') {
-    Promise.resolve().then(() => __importStar(require('./commands/rewiki'))).then(m => m.run({
-        dryRun: hasFlag('--dry-run'),
-        noBackup: hasFlag('--no-backup'),
-        quiet: hasFlag('--quiet', '-q'),
-    }));
+else if (cmd === 'advanced') {
+    const [advCmd, ...advRest] = rest;
+    if (!advCmd || advCmd === '--help' || advCmd === '-h') {
+        Promise.resolve().then(() => __importStar(require('./commands/help'))).then(m => m.printAdvancedHelp());
+    }
+    else {
+        dispatch(advCmd, advRest);
+    }
 }
 else {
-    console.log(`DocuFlow v${version}`);
-    console.log('');
-    console.log('Usage: docuflow <command> [options]');
-    console.log('');
-    console.log('Commands:');
-    console.log('  init                    Register DocuFlow MCP and generate CLAUDE.md');
-    console.log('  init --interactive      Interactive setup wizard');
-    console.log('  status                  Show wiki health, page counts, and MCP status');
-    console.log('  suggest                 Show what to document first (domain-specific)');
-    console.log('  ui                      Start the DocuFlow web interface (API + UI on port 48821)');
-    console.log('  start                   Alias for "ui" — same web interface');
-    console.log('  ui --port <n>           Use a custom port (default: 48821)');
-    console.log('  ui --no-open            Start server without auto-opening the browser');
-    console.log('  watch                   Start auto-sync daemon (watches for changes)');
-    console.log('  watch --ai              Auto-detect best AI bridge (copilot > claude > codex > api)');
-    console.log('  watch --ai --copilot    Force @github/copilot CLI (direct MCP tool calling ⚡)');
-    console.log('  watch --ai --claude     Force Claude Code CLI    (direct MCP tool calling ⚡)');
-    console.log('  watch --ai --codex      Force Codex CLI          (generates doc → ingest)');
-    console.log('  watch --lint-interval N Run lint every N hours (default: 24)');
-    console.log('  watch --code-ext ts,py  Watch only these file extensions');
-    console.log('  watch stop              Stop the running watch daemon for this project');
-    console.log('  watch status            Show daemon state: running/stopped, PID, uptime, bridge');
-    console.log('  watch restart           Stop current daemon and restart with same options');
-    console.log('  sync                    One-shot sync: ingest all sources + rebuild index');
-    console.log('  sync --ai               AI-powered sync (auto-detects bridge)');
-    console.log('  sync --ai --copilot     Copilot drives DocuFlow MCP tools directly ⚡');
-    console.log('  sync --ai --claude      Claude drives DocuFlow MCP tools directly ⚡');
-    console.log('  sync --ai --codex       Codex generates doc → ingest');
-    console.log('  sync --since-commit REF Diff code changes since git ref (e.g. HEAD~1)');
-    console.log('  sync --source FILE      Sync a single source file');
-    console.log('  sync --no-lint          Skip health check (faster)');
-    console.log('  sync --fail-on-score N  Exit 1 if health score < N (default: 70)');
-    console.log('  sync --quiet            Suppress output (CI mode)');
-    console.log('  review                  Review current git changes and suggest improvements');
-    console.log('  review --staged         Review staged changes only');
-    console.log('  review --since-commit REF Review changes since git ref (e.g. HEAD~1)');
-    console.log('  review --ai             Append Copilot AI review to deterministic findings');
-    console.log('  review --fail-on-critical Exit 1 if critical findings are detected');
-    console.log('  review --quiet          Compact output for CI/scripting');
-    console.log('  update                  Reinstall latest @doquflow/cli globally (refreshes UI + server)');
-    console.log('  update --check          Check whether a newer version is published (no install)');
-    console.log('  update --force          Reinstall even when already on the latest version');
-    console.log('  upgrade                 Alias for "update"');
-    console.log('  recent [--days N] [--format table|md]   Show recent DevLoop task activity');
-    console.log('  rewiki                  Re-ingest all sources with current extractor rules (migration)');
-    console.log('  rewiki --dry-run        Preview what would change without writing anything');
-    console.log('  rewiki --no-backup      Skip wiki backup (faster, irreversible)');
-    console.log('  rewiki --quiet          Suppress output (CI mode)');
-    console.log('');
-    console.log('Options:');
-    console.log('  --version, -v                    Print version number');
-    console.log('  --allow-dangerous-permissions    Pass --dangerously-skip-permissions to Claude CLI');
-    console.log('                                   Required for Claude bridge in non-interactive use.');
-    console.log('                                   Only use when file content in this project is trusted.');
-    console.log('');
-    console.log('AI bridge priority (for --ai flag):');
-    console.log('  1. copilot  (@github/copilot) — calls DocuFlow MCP tools directly ⚡');
-    console.log('  2. claude   (Claude Code CLI) — calls DocuFlow MCP tools directly ⚡');
-    console.log('  3. codex    (OpenAI Codex CLI) — generates doc text, then ingests');
-    console.log('  4. api      (ANTHROPIC_API_KEY env) — generates doc text, then ingests');
-    console.log('  Use --copilot / --claude / --codex to override auto-detection.');
+    dispatch(cmd, rest);
 }

package/package.json

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