@doquflow/cli 1.5.1 → 1.6.0

package/dist/commands/init.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerInGlobalRegistry = registerInGlobalRegistry;
 exports.buildClaudeMd = buildClaudeMd;
 exports.buildAgentsMd = buildAgentsMd;
+exports.runInit = runInit;
 exports.run = run;
 const node_fs_1 = __importDefault(require("node:fs"));
 const promises_1 = __importDefault(require("node:fs/promises"));
@@ -153,11 +154,17 @@ lint_wiki({ project_path: "${projectDir}" })
 → fix orphans and broken refs
 \`\`\`
 
+### Maintenance — re-ingest with updated rules
+\`\`\`
+docuflow rewiki --dry-run   # preview cleanup
+docuflow rewiki             # apply (backs up wiki first)
+\`\`\`
+
 ## Storage Layout
 
 \`\`\`
 .docuflow/
-├── specs/           Legacy spec files written by write_spec
+├── specs/           Spec files written by write_spec
 ├── wiki/            LLM-generated wiki pages
 │   ├── entities/    Named things (services, APIs, databases)
 │   ├── concepts/    Design patterns, principles, integrations
@@ -276,7 +283,16 @@ async function writeAgentsMd(projectDir) {
         await promises_1.default.writeFile(agentsMdPath, newSection, "utf8");
     }
 }
-async function run() {
+/**
+ * Core init logic — creates the .docuflow/ structure, registers MCP configs,
+ * writes CLAUDE.md/AGENTS.md, installs git hook, and registers in global registry.
+ *
+ * Accepts the target projectDir explicitly so it can be called from both the CLI
+ * (which uses process.cwd()) and the API (/api/init which receives the path from
+ * the request body).
+ */
+async function runInit(projectDir) {
+    const details = [];
     const configPath = getClaudeDesktopConfigPath();
     const vscodeConfigPath = getVSCodeMcpConfigPath();
     const copilotCliConfigPath = getCopilotCliMcpConfigPath();
@@ -284,61 +300,59 @@ async function run() {
     const serverBin = resolveServerBin();
     const nodeBin = process.execPath;
     // Register in Claude Desktop config
-    let config = {};
     try {
-        const raw = await promises_1.default.readFile(configPath, "utf8");
-        config = JSON.parse(raw);
+        let config = {};
+        try {
+            const raw = await promises_1.default.readFile(configPath, "utf8");
+            config = JSON.parse(raw);
+        }
+        catch { /* File doesn't exist yet — that's fine */ }
+        if (!config.mcpServers)
+            config.mcpServers = {};
+        config.mcpServers.docuflow = { command: nodeBin, args: [serverBin] };
+        await promises_1.default.mkdir(node_path_1.default.dirname(configPath), { recursive: true });
+        await promises_1.default.writeFile(configPath, JSON.stringify(config, null, 2) + "\n", "utf8");
+        details.push("Claude Desktop MCP registered");
     }
     catch {
-        // File doesn't exist yet — that's fine, we'll create it
+        details.push("Claude Desktop — skipped (not installed)");
     }
-    if (!config.mcpServers)
-        config.mcpServers = {};
-    config.mcpServers.docuflow = { command: nodeBin, args: [serverBin] };
-    await promises_1.default.mkdir(node_path_1.default.dirname(configPath), { recursive: true });
-    await promises_1.default.writeFile(configPath, JSON.stringify(config, null, 2) + "\n", "utf8");
     // Register in VS Code (GitHub Copilot) user MCP config
     let vscodeRegistered = false;
-    let vscodeConfig = {};
-    try {
-        const raw = await promises_1.default.readFile(vscodeConfigPath, "utf8");
-        vscodeConfig = JSON.parse(raw);
-    }
-    catch {
-        // File may not exist — create it
-    }
-    if (!vscodeConfig.servers)
-        vscodeConfig.servers = {};
-    vscodeConfig.servers.docuflow = { command: nodeBin, args: [serverBin], type: "stdio" };
     try {
+        let vscodeConfig = {};
+        try {
+            const raw = await promises_1.default.readFile(vscodeConfigPath, "utf8");
+            vscodeConfig = JSON.parse(raw);
+        }
+        catch { /* File may not exist */ }
+        if (!vscodeConfig.servers)
+            vscodeConfig.servers = {};
+        vscodeConfig.servers.docuflow = { command: nodeBin, args: [serverBin], type: "stdio" };
         await promises_1.default.mkdir(node_path_1.default.dirname(vscodeConfigPath), { recursive: true });
         await promises_1.default.writeFile(vscodeConfigPath, JSON.stringify(vscodeConfig, null, 2) + "\n", "utf8");
         vscodeRegistered = true;
+        details.push("VS Code Copilot MCP registered");
     }
-    catch {
-        // VS Code not installed or config dir not writable — skip silently
-    }
+    catch { /* VS Code not installed — skip */ }
     // Register in GitHub Copilot CLI MCP config (~/.copilot/mcp-config.json)
     let copilotCliRegistered = false;
-    let copilotCliConfig = {};
-    try {
-        const raw = await promises_1.default.readFile(copilotCliConfigPath, "utf8");
-        copilotCliConfig = JSON.parse(raw);
-    }
-    catch {
-        // File may not exist yet
-    }
-    if (!copilotCliConfig.mcpServers)
-        copilotCliConfig.mcpServers = {};
-    copilotCliConfig.mcpServers.docuflow = { type: "local", command: nodeBin, args: [serverBin], tools: ["*"] };
     try {
+        let copilotCliConfig = {};
+        try {
+            const raw = await promises_1.default.readFile(copilotCliConfigPath, "utf8");
+            copilotCliConfig = JSON.parse(raw);
+        }
+        catch { /* File may not exist yet */ }
+        if (!copilotCliConfig.mcpServers)
+            copilotCliConfig.mcpServers = {};
+        copilotCliConfig.mcpServers.docuflow = { type: "local", command: nodeBin, args: [serverBin], tools: ["*"] };
         await promises_1.default.mkdir(node_path_1.default.dirname(copilotCliConfigPath), { recursive: true });
         await promises_1.default.writeFile(copilotCliConfigPath, JSON.stringify(copilotCliConfig, null, 2) + "\n", "utf8");
         copilotCliRegistered = true;
+        details.push("Copilot CLI MCP registered");
     }
-    catch {
-        // Copilot CLI not installed — skip silently
-    }
+    catch { /* Copilot CLI not installed — skip */ }
     // Register in OpenAI Codex CLI (~/.codex/config.toml in TOML format)
     let codexCliRegistered = false;
     try {
@@ -353,99 +367,107 @@ async function run() {
             await promises_1.default.writeFile(codexConfigPath, tomlContent + entry, "utf8");
         }
         codexCliRegistered = true;
+        details.push("Codex CLI MCP registered");
     }
-    catch {
-        // Codex CLI not installed — skip silently
-    }
+    catch { /* Codex CLI not installed — skip */ }
+    // Suppress unused-variable warnings when variables are only used in console.log branches
+    void vscodeRegistered;
+    void copilotCliRegistered;
+    void codexCliRegistered;
     // Create .docuflow/ directory structure
-    const projectDir = process.cwd();
     const docuflowDir = node_path_1.default.join(projectDir, ".docuflow");
     const specsDir = node_path_1.default.join(docuflowDir, "specs");
     const wikiDir = node_path_1.default.join(docuflowDir, "wiki");
     const sourcesDir = node_path_1.default.join(docuflowDir, "sources");
-    const entitiesDir = node_path_1.default.join(wikiDir, "entities");
-    const conceptsDir = node_path_1.default.join(wikiDir, "concepts");
-    const timelinesDir = node_path_1.default.join(wikiDir, "timelines");
-    const synthesesDir = node_path_1.default.join(wikiDir, "syntheses");
     await promises_1.default.mkdir(specsDir, { recursive: true });
-    await promises_1.default.mkdir(entitiesDir, { recursive: true });
-    await promises_1.default.mkdir(conceptsDir, { recursive: true });
-    await promises_1.default.mkdir(timelinesDir, { recursive: true });
-    await promises_1.default.mkdir(synthesesDir, { recursive: true });
+    await promises_1.default.mkdir(node_path_1.default.join(wikiDir, "entities"), { recursive: true });
+    await promises_1.default.mkdir(node_path_1.default.join(wikiDir, "concepts"), { recursive: true });
+    await promises_1.default.mkdir(node_path_1.default.join(wikiDir, "timelines"), { recursive: true });
+    await promises_1.default.mkdir(node_path_1.default.join(wikiDir, "syntheses"), { recursive: true });
     await promises_1.default.mkdir(sourcesDir, { recursive: true });
+    details.push("Created .docuflow/ directory structure");
     // Copy or create template files
     await copyTemplateFile("schema.md", node_path_1.default.join(docuflowDir, "schema.md"));
     await copyTemplateFile("index.md", node_path_1.default.join(docuflowDir, "index.md"));
     await copyTemplateFile("log.md", node_path_1.default.join(docuflowDir, "log.md"));
-    // Generate CLAUDE.md so Claude Code picks up DocuFlow automatically
+    details.push("Wrote schema.md, index.md, log.md");
+    // Generate CLAUDE.md
     await writeClaudeMd(projectDir);
-    // Generate AGENTS.md so OpenAI Codex picks up DocuFlow automatically
+    details.push("Wrote CLAUDE.md");
+    // Generate AGENTS.md
     await writeAgentsMd(projectDir);
-    // Write .vscode/mcp.json for project-level workspace MCP config (shareable via git)
-    // Uses npx so it works on any machine — safe to commit
-    const vscodeDirPath = node_path_1.default.join(projectDir, ".vscode");
-    const vscodeWorkspaceMcpPath = node_path_1.default.join(vscodeDirPath, "mcp.json");
-    let workspaceMcpConfig = {};
+    details.push("Wrote AGENTS.md");
+    // Write .vscode/mcp.json for project-level workspace MCP config
     try {
-        const raw = await promises_1.default.readFile(vscodeWorkspaceMcpPath, "utf8");
-        workspaceMcpConfig = JSON.parse(raw);
-    }
-    catch {
-        // File doesn't exist yet
+        const vscodeDirPath = node_path_1.default.join(projectDir, ".vscode");
+        const vscodeWorkspaceMcpPath = node_path_1.default.join(vscodeDirPath, "mcp.json");
+        let workspaceMcpConfig = {};
+        try {
+            const raw = await promises_1.default.readFile(vscodeWorkspaceMcpPath, "utf8");
+            workspaceMcpConfig = JSON.parse(raw);
+        }
+        catch { /* File doesn't exist yet */ }
+        if (!workspaceMcpConfig.servers)
+            workspaceMcpConfig.servers = {};
+        workspaceMcpConfig.servers.docuflow = {
+            command: "npx",
+            args: ["-y", "-p", "@doquflow/server", "docuflow-server"],
+            type: "stdio",
+        };
+        await promises_1.default.mkdir(vscodeDirPath, { recursive: true });
+        await promises_1.default.writeFile(vscodeWorkspaceMcpPath, JSON.stringify(workspaceMcpConfig, null, 2) + "\n", "utf8");
+        details.push("Wrote .vscode/mcp.json");
     }
-    if (!workspaceMcpConfig.servers)
-        workspaceMcpConfig.servers = {};
-    workspaceMcpConfig.servers.docuflow = {
-        command: "npx",
-        args: ["-y", "-p", "@doquflow/server", "docuflow-server"],
-        type: "stdio",
-    };
-    await promises_1.default.mkdir(vscodeDirPath, { recursive: true });
-    await promises_1.default.writeFile(vscodeWorkspaceMcpPath, JSON.stringify(workspaceMcpConfig, null, 2) + "\n", "utf8");
+    catch { /* non-fatal */ }
     // Add .docuflow/ to .gitignore if present and not already listed
-    const gitignorePath = node_path_1.default.join(process.cwd(), ".gitignore");
-    if (node_fs_1.default.existsSync(gitignorePath)) {
-        const gitignore = await promises_1.default.readFile(gitignorePath, "utf8");
-        if (!gitignore.includes(".docuflow/") && !gitignore.includes(".docuflow")) {
-            await promises_1.default.appendFile(gitignorePath, "\n# Docuflow\n.docuflow/\n");
+    try {
+        const gitignorePath = node_path_1.default.join(projectDir, ".gitignore");
+        if (node_fs_1.default.existsSync(gitignorePath)) {
+            const gitignore = await promises_1.default.readFile(gitignorePath, "utf8");
+            if (!gitignore.includes(".docuflow/") && !gitignore.includes(".docuflow")) {
+                await promises_1.default.appendFile(gitignorePath, "\n# Docuflow\n.docuflow/\n");
+                details.push("Added .docuflow/ to .gitignore");
+            }
         }
     }
-    // Install git post-commit hook (auto-sync on every commit)
+    catch { /* non-fatal */ }
+    // Install git post-commit hook
     await installGitHook(projectDir);
-    // Register in global project registry so `docuflow ui` always finds this project
+    details.push("Installed git post-commit hook");
+    // Register in global project registry
     await registerInGlobalRegistry(projectDir);
-    console.log("\u2713 DocuFlow initialised successfully.");
+    details.push("Registered in global project registry (~/.docuflow/projects.json)");
+    return { ok: true, path: projectDir, details };
+}
+async function run() {
+    const result = await runInit(process.cwd());
+    const docuflowDir = node_path_1.default.join(result.path, ".docuflow");
+    console.log("✓ DocuFlow initialised successfully.");
     console.log("");
-    console.log("\ud83d\udcc1 Structure created:");
+    console.log("📁 Structure created:");
     console.log(`  ${docuflowDir}/`);
-    console.log(`  \u251c\u2500\u2500 specs/              (code specs written by the agent)`);
-    console.log(`  \u251c\u2500\u2500 wiki/               (LLM-generated wiki pages)`);
-    console.log(`  \u2502   \u251c\u2500\u2500 entities/`);
-    console.log(`  \u2502   \u251c\u2500\u2500 concepts/`);
-    console.log(`  \u2502   \u251c\u2500\u2500 timelines/`);
-    console.log(`  \u2502   \u2514\u2500\u2500 syntheses/`);
-    console.log(`  \u251c\u2500\u2500 sources/            (raw markdown documents to ingest)`);
-    console.log(`  \u251c\u2500\u2500 schema.md           (wiki configuration)`);
-    console.log(`  \u251c\u2500\u2500 index.md            (auto-maintained catalog)`);
-    console.log(`  \u2514\u2500\u2500 log.md              (operation log)`);
+    console.log(`  ├── specs/              (code specs written by the agent)`);
+    console.log(`  ├── wiki/               (LLM-generated wiki pages)`);
+    console.log(`  │   ├── entities/`);
+    console.log(`  │   ├── concepts/`);
+    console.log(`  │   ├── timelines/`);
+    console.log(`  │   └── syntheses/`);
+    console.log(`  ├── sources/            (raw markdown documents to ingest)`);
+    console.log(`  ├── schema.md           (wiki configuration)`);
+    console.log(`  ├── index.md            (auto-maintained catalog)`);
+    console.log(`  └── log.md              (operation log)`);
     console.log("");
-    console.log("\ud83d\udcdd Instruction files:");
-    console.log(`  CLAUDE.md  ✓ ${node_path_1.default.join(projectDir, "CLAUDE.md")}`);
-    console.log(`  AGENTS.md  ✓ ${node_path_1.default.join(projectDir, "AGENTS.md")}`);
-    console.log("");
-    console.log("\ud83d\udd27 MCP Registration:");
-    console.log(`  Claude Desktop:  \u2713 registered`);
-    console.log(`  VS Code Copilot: ${vscodeRegistered ? "\u2713 registered (user-level)" : "\u2014 not detected"}`);
-    console.log(`  Copilot CLI:     ${copilotCliRegistered ? "\u2713 registered (~/.copilot/mcp-config.json)" : "\u2014 not detected"}`);
-    console.log(`  Codex CLI:       ${codexCliRegistered ? "\u2713 registered (~/.codex/config.toml)" : "\u2014 not detected"}`);
-    console.log(`  Workspace:       \u2713 .vscode/mcp.json written (commit to share with team)`);
+    console.log("📝 Steps completed:");
+    for (const line of result.details) {
+        console.log(`  ✓ ${line}`);
+    }
     console.log("");
-    console.log("\ud83d\udcd6 Next steps:");
+    console.log("📖 Next steps:");
     console.log("  1. Edit .docuflow/schema.md to customize your wiki domain");
     console.log("  2. Add markdown docs to .docuflow/sources/ then ingest them");
     console.log("  3. Restart Claude Desktop / reload VS Code / restart Copilot CLI");
     console.log("");
-    console.log("\u26a1 Auto-sync options:");
+    console.log("⚡ Auto-sync options:");
     console.log("  docuflow watch           # background daemon (watches for file changes)");
     console.log("  docuflow watch --ai      # + Claude/Codex documents code changes automatically");
     console.log("  docuflow sync            # one-shot sync (good for CI/CD)");

package/dist/commands/recent.js

@@ -0,0 +1,276 @@
+"use strict";
+/**
+ * docuflow recent
+ *
+ * Aggregates recent work by scanning .devloop/specs/TASK-*.md files,
+ * correlating git commits by task ID, reading .docuflow/log.md for wiki
+ * activity, and rendering a formatted dashboard in the terminal.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = run;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+// ── ANSI helpers ────────────────────────────────────────────────────────────
+const c = {
+    green: (s) => `\x1b[32m${s}\x1b[0m`,
+    yellow: (s) => `\x1b[33m${s}\x1b[0m`,
+    red: (s) => `\x1b[31m${s}\x1b[0m`,
+    dim: (s) => `\x1b[2m${s}\x1b[0m`,
+    bold: (s) => `\x1b[1m${s}\x1b[0m`,
+};
+function colourStatus(status, text) {
+    if (status === "approved")
+        return c.green(text);
+    if (status === "needs-work")
+        return c.yellow(text);
+    if (status === "rejected")
+        return c.red(text);
+    return c.dim(text);
+}
+function normaliseStatus(raw) {
+    // Strip emojis (✅ ⚠️ ⏳ ❌) and other non-printable/non-ASCII characters
+    const stripped = raw.replace(/[^\x20-\x7E]/g, " ").trim().toLowerCase();
+    if (stripped.includes("approved"))
+        return "approved";
+    if (stripped.includes("needs-work") || stripped.includes("needs_work"))
+        return "needs-work";
+    if (stripped.includes("rejected"))
+        return "rejected";
+    if (stripped.includes("pending"))
+        return "pending";
+    return stripped.split(/\s+/)[0] || "pending";
+}
+function truncate(s, max) {
+    return s.length > max ? s.slice(0, max - 1) + "…" : s;
+}
+function formatDateYMD(d) {
+    return d.toISOString().slice(0, 10);
+}
+// ── Git helper ───────────────────────────────────────────────────────────────
+function gitLog(taskId) {
+    try {
+        const out = (0, node_child_process_1.execSync)(`git log --oneline --all --grep="${taskId}"`, { encoding: "utf8", stdio: ["pipe", "pipe", "ignore"] });
+        return out.trim().split("\n").filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+// ── Spec parser ───────────────────────────────────────────────────────────────
+async function parseSpec(specPath) {
+    let content;
+    try {
+        content = await promises_1.default.readFile(specPath, "utf8");
+    }
+    catch {
+        return {};
+    }
+    let title = "";
+    let feature = "";
+    let status = "pending";
+    for (const line of content.split("\n")) {
+        // First H1 heading: "# TASK-YYYYMMDD-HHMMSS: <title>"
+        if (!title && line.startsWith("# TASK-")) {
+            const colonIdx = line.indexOf(":");
+            if (colonIdx !== -1) {
+                title = line.slice(colonIdx + 1).trim();
+            }
+        }
+        // **Feature**: value
+        if (!feature && line.startsWith("**Feature**:")) {
+            feature = line.slice("**Feature**:".length).trim().slice(0, 120).trimEnd();
+        }
+        // **Status**: value
+        if (line.startsWith("**Status**:")) {
+            const raw = line.slice("**Status**:".length).trim();
+            status = normaliseStatus(raw);
+        }
+    }
+    return { title, feature, status };
+}
+// ── Review parser ────────────────────────────────────────────────────────────
+async function parseReview(reviewPath) {
+    let content;
+    try {
+        content = await promises_1.default.readFile(reviewPath, "utf8");
+    }
+    catch {
+        return { score: null, reviewVerdict: null };
+    }
+    let score = null;
+    let reviewVerdict = null;
+    const scoreMatch = content.match(/Score:\s*(\d+\/\d+)/);
+    if (scoreMatch)
+        score = scoreMatch[1];
+    const verdictMatch = content.match(/Verdict:\s*(APPROVED|NEEDS[\s_]WORK|REJECTED)/i);
+    if (verdictMatch) {
+        reviewVerdict = verdictMatch[1].toUpperCase().replace(/[\s-]+/g, "_");
+    }
+    return { score, reviewVerdict };
+}
+// ── Wiki log parser ──────────────────────────────────────────────────────────
+// log.md format: ## [2026-05-01T13:49:38.141Z] operation | description
+async function parseWikiLog(logPath, since) {
+    let content;
+    try {
+        content = await promises_1.default.readFile(logPath, "utf8");
+    }
+    catch {
+        return [];
+    }
+    const entries = [];
+    const headingRe = /^##\s+\[([^\]]+)\]\s+([^|]+)\|\s*(.+)$/;
+    for (const line of content.split("\n")) {
+        const m = line.match(headingRe);
+        if (!m)
+            continue;
+        const rawDate = m[1].trim();
+        const operation = m[2].trim();
+        const file = m[3].trim();
+        const dateVal = new Date(rawDate);
+        if (!isNaN(dateVal.getTime()) && dateVal >= since) {
+            entries.push({ date: rawDate.slice(0, 10), operation, file });
+        }
+    }
+    return entries;
+}
+// ── Renderers ────────────────────────────────────────────────────────────────
+function renderTable(tasks, allCommits, wikiEntries, days, fromDate, toDate) {
+    const SEP = "─".repeat(72);
+    console.log(c.bold(`Recent Work — last ${days} days (${fromDate} → ${toDate})`));
+    console.log(SEP);
+    console.log(` ${"TASK".padEnd(24)} ${"TITLE".padEnd(40)} ${"STATUS".padEnd(12)} SCORE`);
+    console.log(SEP);
+    for (const t of tasks) {
+        const title = truncate(t.title || t.feature, 40).padEnd(40);
+        const status = t.status.padEnd(12);
+        const score = t.score ?? "—";
+        const row = ` ${t.id.padEnd(24)} ${title} ${status} ${score}`;
+        console.log(colourStatus(t.status, row));
+    }
+    console.log(SEP);
+    if (allCommits.length > 0) {
+        console.log("");
+        console.log(c.bold(`Git Commits (${allCommits.length} matching)`));
+        for (const line of allCommits) {
+            console.log(`  ${line}`);
+        }
+    }
+    if (wikiEntries.length > 0) {
+        console.log("");
+        console.log(c.bold(`Wiki Activity (last ${days} days)`));
+        for (const e of wikiEntries) {
+            console.log(`  ${e.date}  ${e.operation}  ${e.file}`);
+        }
+    }
+}
+function renderMarkdown(tasks, allCommits, wikiEntries, days, fromDate, toDate) {
+    console.log(`# Recent Work — last ${days} days (${fromDate} → ${toDate})`);
+    console.log("");
+    console.log("| TASK | TITLE | STATUS | SCORE |");
+    console.log("|------|-------|--------|-------|");
+    for (const t of tasks) {
+        const title = truncate(t.title || t.feature, 40);
+        const score = t.score ?? "—";
+        console.log(`| ${t.id} | ${title} | ${t.status} | ${score} |`);
+    }
+    if (allCommits.length > 0) {
+        console.log("");
+        console.log(`## Git Commits (${allCommits.length} matching)`);
+        console.log("");
+        for (const line of allCommits) {
+            console.log(`- ${line}`);
+        }
+    }
+    if (wikiEntries.length > 0) {
+        console.log("");
+        console.log(`## Wiki Activity (last ${days} days)`);
+        console.log("");
+        console.log("| Date | Operation | File |");
+        console.log("|------|-----------|------|");
+        for (const e of wikiEntries) {
+            console.log(`| ${e.date} | ${e.operation} | ${e.file} |`);
+        }
+    }
+}
+// ── Main entry point ─────────────────────────────────────────────────────────
+async function run(opts = { days: 7, format: "table" }) {
+    const days = Math.max(1, isNaN(opts.days) ? 7 : opts.days);
+    const format = opts.format ?? "table";
+    const isMd = format === "md";
+    const cwd = process.cwd();
+    const specsDir = node_path_1.default.join(cwd, ".devloop", "specs");
+    const logPath = node_path_1.default.join(cwd, ".docuflow", "log.md");
+    const now = new Date();
+    const since = new Date(now.getTime() - days * 24 * 60 * 60 * 1000);
+    // Collect spec files
+    let specFiles = [];
+    try {
+        const entries = await promises_1.default.readdir(specsDir);
+        specFiles = entries
+            .filter(f => /^TASK-\d{8}-\d{6}\.md$/.test(f))
+            .map(f => node_path_1.default.join(specsDir, f));
+    }
+    catch {
+        console.log(`No tasks found in the last ${days} days.`);
+        return;
+    }
+    // Filter by mtime and parse each spec
+    const tasks = [];
+    for (const specPath of specFiles) {
+        let stat;
+        try {
+            stat = await promises_1.default.stat(specPath);
+        }
+        catch {
+            continue;
+        }
+        if (stat.mtime < since)
+            continue;
+        const stem = node_path_1.default.basename(specPath, ".md"); // TASK-YYYYMMDD-HHMMSS
+        const specFields = await parseSpec(specPath);
+        if (!specFields.title && !specFields.feature)
+            continue; // unreadable
+        const reviewPath = node_path_1.default.join(specsDir, `${stem}-review.md`);
+        const { score, reviewVerdict } = await parseReview(reviewPath);
+        // Override status from review verdict if present
+        let status = specFields.status ?? "pending";
+        if (reviewVerdict === "APPROVED")
+            status = "approved";
+        else if (reviewVerdict === "NEEDS_WORK")
+            status = "needs-work";
+        else if (reviewVerdict === "REJECTED")
+            status = "rejected";
+        const commits = gitLog(stem);
+        tasks.push({
+            id: stem,
+            title: specFields.title ?? "",
+            feature: specFields.feature ?? "",
+            status,
+            score,
+            reviewVerdict,
+            commits,
+            specMtime: stat.mtime,
+        });
+    }
+    // Sort newest first
+    tasks.sort((a, b) => b.specMtime.getTime() - a.specMtime.getTime());
+    if (tasks.length === 0) {
+        console.log(`No tasks found in the last ${days} days.`);
+        return;
+    }
+    const fromDate = formatDateYMD(since);
+    const toDate = formatDateYMD(now);
+    const allCommits = tasks.flatMap(t => t.commits);
+    const wikiEntries = await parseWikiLog(logPath, since);
+    if (isMd) {
+        renderMarkdown(tasks, allCommits, wikiEntries, days, fromDate, toDate);
+    }
+    else {
+        renderTable(tasks, allCommits, wikiEntries, days, fromDate, toDate);
+    }
+}