@itradingai/aiwiki 0.2.14 → 0.2.15

package/dist/src/app.js

@@ -430,18 +430,29 @@ function printAgentPrompt(stream) {
 }
 async function printStatusDetails(stream, root, runCount) {
     const counts = await contentCounts(root);
+    const summary = await statusSummary(root);
     const lintPath = path.join(root, "dashboards", "Lint Report.md");
     writeLine(stream, "");
-    writeLine(stream, "内容统计:");
-    writeLine(stream, `Wiki 条目: ${counts.wikiEntries}`);
-    writeLine(stream, `资料卡: ${counts.sourceCards}`);
-    writeLine(stream, `原文: ${counts.rawFiles}`);
-    writeLine(stream, `选题: ${counts.topics}`);
-    writeLine(stream, `大纲: ${counts.outlines}`);
-    writeLine(stream, `最近 lint: ${await exists(lintPath) ? await relativeMtime(root, lintPath) : "无"}`);
+    writeLine(stream, "Content stats:");
+    writeLine(stream, `Wiki entries: ${counts.wikiEntries}`);
+    writeLine(stream, `Source cards: ${counts.sourceCards}`);
+    writeLine(stream, `Raw files: ${counts.rawFiles}`);
+    writeLine(stream, `Topics: ${counts.topics}`);
+    writeLine(stream, `Outlines: ${counts.outlines}`);
+    writeLine(stream, `fallback_entries: ${summary.fallbackCount}`);
+    writeLine(stream, `grounding_review_entries: ${summary.groundingReviewCount}`);
+    writeLine(stream, `recent_lint: ${await exists(lintPath) ? await relativeMtime(root, lintPath) : "none"}`);
+    writeLine(stream, `lint_status: ${summary.lintStatus}`);
+    if (summary.lastSuccessRunId) {
+        writeLine(stream, `last_success: ${summary.lastSuccessRunId}`);
+    }
+    if (summary.lastFailureRunId) {
+        writeLine(stream, `last_failure: ${summary.lastFailureRunId}`);
+    }
+    writeLine(stream, `system_files: ${summary.systemFiles.map((item) => `${item.path}=${item.status}`).join(", ")}`);
     writeLine(stream, "");
-    writeLine(stream, "下一步建议:");
-    writeLine(stream, runCount === 0 ? "运行 `aiwiki agent install` 接入宿主 Agent，然后发送 `入库 <url>`。" : "运行 `aiwiki query <主题>` 查询知识，或运行 `aiwiki lint` 检查结构。");
+    writeLine(stream, "Next action:");
+    writeLine(stream, recommendedNextAction(runCount, summary.lintStatus, summary.systemFiles.some((item) => item.status !== "ok")));
 }
 async function printNext(stream, root, runCount, checks, targets, report) {
     const missing = checks.filter((check) => check.status !== "ok");
@@ -452,42 +463,67 @@ async function printNext(stream, root, runCount, checks, targets, report) {
         }
     }
     writeLine(stream, "AIWiki 下一步建议");
-    writeLine(stream, `知识库路径: ${root}`);
+    writeLine(stream, `workspace: ${root}`);
     if (missing.length) {
         writeLine(stream, "");
-        writeLine(stream, "先修复知识库结构:");
+        writeLine(stream, "Repair workspace structure first:");
         writeLine(stream, `- aiwiki setup --path "${root}" --yes`);
+        writeLine(stream, "- repair_order: structure");
         return;
     }
-    if (runCount === 0) {
+    const actionableIssues = report?.issues.filter((issue) => issue.severity !== "info") ?? [];
+    const errorCount = actionableIssues.filter((issue) => issue.severity === "error").length;
+    const warningCount = actionableIssues.filter((issue) => issue.severity === "warning").length;
+    if (errorCount > 0) {
         writeLine(stream, "");
-        writeLine(stream, "还没有入库记录。");
-        writeLine(stream, "- aiwiki agent install");
-        writeLine(stream, "- 然后向宿主 Agent 发送 `入库 <url>`");
-        writeLine(stream, "- CLI 不抓网页；网页正文由宿主 Agent 提供。");
+        writeLine(stream, `结构检查发现 ${errorCount} 个 error 问题。`);
+        writeLine(stream, "- aiwiki lint");
+        writeLine(stream, "- report: dashboards/Lint Report.md");
+        writeLine(stream, "- repair_order: lint_errors");
         return;
     }
-    const actionableIssues = report?.issues.filter((issue) => issue.severity !== "info") ?? [];
-    if (actionableIssues.length) {
+    if (warningCount > 0) {
         writeLine(stream, "");
-        writeLine(stream, `结构检查发现 ${actionableIssues.length} 个需要处理的问题。`);
+        writeLine(stream, `结构检查发现 ${warningCount} 个 warning 问题。`);
         writeLine(stream, "- aiwiki lint");
-        writeLine(stream, `- 查看报告: dashboards/Lint Report.md`);
-        writeLine(stream, "- 先处理 error / warning，再继续扩展查询或入库。");
+        writeLine(stream, "- report: dashboards/Lint Report.md");
+        writeLine(stream, "- repair_order: lint_warnings");
+        return;
+    }
+    if (runCount === 0) {
+        writeLine(stream, "");
+        writeLine(stream, "No ingest records yet.");
+        writeLine(stream, "- aiwiki agent install");
+        writeLine(stream, "- Then ask the host Agent to ingest a URL.");
+        writeLine(stream, "- AIWiki CLI does not fetch webpages; the host Agent supplies content.");
+        writeLine(stream, "- repair_order: empty_workspace");
         return;
     }
     writeLine(stream, "");
-    writeLine(stream, "已有入库记录，可以继续：");
-    writeLine(stream, "- aiwiki query <主题>");
+    writeLine(stream, "Workspace is healthy enough for retrieval:");
+    writeLine(stream, "- aiwiki query <topic>");
     writeLine(stream, "- aiwiki lint");
+    writeLine(stream, "- repair_order: healthy_query");
     if (installableMissing.length) {
         writeLine(stream, "");
-        writeLine(stream, "可补充宿主 Agent 接入:");
+        writeLine(stream, "Optional host Agent setup:");
         for (const target of installableMissing) {
             writeLine(stream, `- aiwiki agent install --agent ${target.id} --yes`);
         }
     }
 }
+function recommendedNextAction(runCount, lintStatus, hasMissingSystemFiles) {
+    if (hasMissingSystemFiles) {
+        return "next_action: aiwiki setup --path <workspace> --yes";
+    }
+    if (lintStatus === "needs_attention") {
+        return "next_action: aiwiki lint";
+    }
+    if (runCount === 0) {
+        return "next_action: aiwiki agent install";
+    }
+    return "next_action: aiwiki query <topic>";
+}
 function renderQuery(context) {
     const lines = [`AIWiki 查询: ${context.query}`, ""];
     appendQueryGroup(lines, "Wiki 条目", context.matches.wiki_entries);

package/dist/src/workspace.js

@@ -3,7 +3,9 @@ import os from "node:os";
 import path from "node:path";
 import { createInterface } from "node:readline/promises";
 import { stdin as input, stdout as output } from "node:process";
+import { frontmatterBoolean, frontmatterString, parseMarkdown } from "./frontmatter.js";
 import { CliError } from "./output.js";
+import { relativePath } from "./paths.js";
 export const CONFIG_FILE = "aiwiki.yaml";
 export const REQUIRED_DIRS = [
     "02-raw/articles",
@@ -551,6 +553,14 @@ export async function doctor(rootPath) {
             detail: absolute
         });
     }
+    for (const file of REQUIRED_FILES) {
+        const absolute = path.join(root, file);
+        checks.push({
+            name: file,
+            status: (await exists(absolute)) ? "ok" : "missing",
+            detail: absolute
+        });
+    }
     const writeTarget = path.join(root, "_system", "logs", ".doctor-write-test");
     try {
         await fs.writeFile(writeTarget, "ok", "utf8");
@@ -566,7 +576,16 @@ export async function statusSummary(rootPath) {
     const root = resolveRoot(rootPath);
     const runsRoot = path.join(root, "09-runs");
     if (!(await exists(runsRoot))) {
-        return { root, runCount: 0, failedCount: 0 };
+        return {
+            root,
+            runCount: 0,
+            failedCount: 0,
+            fallbackCount: await countWikiEntries(root, "deterministic_fallback"),
+            groundingReviewCount: await countGroundingReviewEntries(root),
+            lintStatus: await readLintStatus(root),
+            lintReportPath: await lintReportPath(root),
+            systemFiles: await systemFileSummary(root)
+        };
     }
     const entries = await fs.readdir(runsRoot, { withFileTypes: true });
     const dirs = entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
@@ -590,11 +609,20 @@ export async function statusSummary(rootPath) {
         stats.push({ dir, mtimeMs: (await fs.stat(path.join(runsRoot, dir))).mtimeMs });
     }
     stats.sort((a, b) => b.mtimeMs - a.mtimeMs);
+    const successDirs = dirs.filter((dir) => !dir.endsWith("-fetch-failed"));
+    const failureDirs = dirs.filter((dir) => dir.endsWith("-fetch-failed"));
     return {
         root,
         runCount: dirs.length,
         failedCount,
-        lastRunId: stats[0]?.dir
+        lastRunId: stats[0]?.dir,
+        lastSuccessRunId: await newestDir(root, successDirs),
+        lastFailureRunId: await newestDir(root, failureDirs),
+        fallbackCount: await countWikiEntries(root, "deterministic_fallback"),
+        groundingReviewCount: await countGroundingReviewEntries(root),
+        lintStatus: await readLintStatus(root),
+        lintReportPath: await lintReportPath(root),
+        systemFiles: await systemFileSummary(root)
     };
 }
 export async function exists(target) {
@@ -613,3 +641,73 @@ function readScalar(text, key) {
 function unquote(value) {
     return value.replace(/^["']|["']$/g, "");
 }
+const REQUIRED_FILES = ["_system/purpose.md", "_system/index.md", "_system/log.md"];
+async function systemFileSummary(root) {
+    const files = [];
+    for (const file of REQUIRED_FILES) {
+        files.push({ path: file, status: await exists(path.join(root, file)) ? "ok" : "missing" });
+    }
+    return files;
+}
+async function newestDir(root, dirs) {
+    const stats = [];
+    for (const dir of dirs) {
+        stats.push({ dir, mtimeMs: (await fs.stat(path.join(root, "09-runs", dir))).mtimeMs });
+    }
+    stats.sort((a, b) => b.mtimeMs - a.mtimeMs);
+    return stats[0]?.dir;
+}
+async function countWikiEntries(root, generationMode) {
+    const files = await markdownFiles(path.join(root, "05-wiki", "source-knowledge"));
+    let count = 0;
+    for (const file of files) {
+        const parsed = parseMarkdown(await fs.readFile(file, "utf8"));
+        if (frontmatterString(parsed.frontmatter, "generation_mode") === generationMode) {
+            count += 1;
+        }
+    }
+    return count;
+}
+async function countGroundingReviewEntries(root) {
+    const files = await markdownFiles(path.join(root, "05-wiki", "source-knowledge"));
+    let count = 0;
+    for (const file of files) {
+        const parsed = parseMarkdown(await fs.readFile(file, "utf8"));
+        if (frontmatterBoolean(parsed.frontmatter, "grounding_needs_review") === true) {
+            count += 1;
+        }
+    }
+    return count;
+}
+async function readLintStatus(root) {
+    const reportPath = await lintReportPath(root);
+    if (!reportPath) {
+        return "missing";
+    }
+    const text = await fs.readFile(path.join(root, reportPath), "utf8");
+    if (/\[(error|warning)\]/.test(text)) {
+        return "needs_attention";
+    }
+    return "ok";
+}
+async function lintReportPath(root) {
+    const absolute = path.join(root, "dashboards", "Lint Report.md");
+    return await exists(absolute) ? relativePath(root, absolute) : undefined;
+}
+async function markdownFiles(dir) {
+    if (!(await exists(dir))) {
+        return [];
+    }
+    const entries = await fs.readdir(dir, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        const target = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...await markdownFiles(target));
+        }
+        else if (entry.isFile() && entry.name.toLowerCase().endsWith(".md")) {
+            files.push(target);
+        }
+    }
+    return files;
+}

package/docs/USAGE.md

@@ -410,3 +410,17 @@ aiwiki status
 # System Purpose Files
 
 `aiwiki setup` now also seeds `_system/purpose.md`, `_system/index.md`, and `_system/log.md` when they are missing. These files give humans and host Agents a stable entry point for the knowledge-base goal, scope, common folders, common commands, and lightweight event notes. Re-running setup preserves user edits.
+
+## Diagnostic Commands
+
+`aiwiki doctor` checks the workspace directories, write permission, and required system files: `_system/purpose.md`, `_system/index.md`, and `_system/log.md`.
+
+`aiwiki status` keeps the existing run-count summary and also reports:
+
+- `fallback_entries`: Wiki entries generated as deterministic fallback/scaffold.
+- `grounding_review_entries`: Wiki entries marked for grounding review.
+- `lint_status`: whether a lint report is missing, clean, or needs attention.
+- `system_files`: readiness of purpose, index, and log files.
+- `next_action`: the recommended next command.
+
+`aiwiki next` uses the same repair order: fix workspace structure first, then lint errors, lint warnings, empty-workspace onboarding, and finally healthy-state query guidance.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itradingai/aiwiki",
-  "version": "0.2.14",
+  "version": "0.2.15",
   "type": "module",
   "description": "Agent-first AI knowledge base CLI for turning articles, links and notes into Obsidian-ready source cards, topics, outlines and reusable knowledge assets.",
   "license": "MIT",