@itradingai/aiwiki 0.2.13 → 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/ingest.js

@@ -1,6 +1,6 @@
 import { promises as fs } from "node:fs";
 import path from "node:path";
-import { randomBytes } from "node:crypto";
+import { createHash, randomBytes } from "node:crypto";
 import { normalizePayload } from "./payload.js";
 import { buildGroundingReport, groundingFrontmatterLines, groundingWarnings } from "./grounding.js";
 import { appendRunIdBeforeExt, relativePath, safeJoin, slugify } from "./paths.js";
@@ -27,9 +27,11 @@ export async function ingestPayload(rootPath, rawPayload) {
     }
     const slug = slugify(payload.source.title ?? payload.source.url);
     const content = payload.source.content ?? "";
+    const contentFingerprint = createContentFingerprint(content);
     const collisionWarnings = [];
+    await detectDuplicateContent(root, payload, contentFingerprint, collisionWarnings);
     const longTermTargets = await chooseLongTermTargets(root, slug, runId, collisionWarnings);
-    const links = buildArtifactLinks(root, slug, runDirName, runStartedAt, longTermTargets);
+    const links = buildArtifactLinks(root, slug, runDirName, runStartedAt, contentFingerprint, longTermTargets);
     const grounding = buildGroundingReport(payload);
     await writeFile(path.join(runDir, "raw.md"), contentFile(payload, content, links), generatedFiles);
     await writeFile(path.join(runDir, "source-card.md"), sourceCard(payload, runDirName, links, grounding), generatedFiles);
@@ -102,6 +104,42 @@ async function chooseLongTermTarget(root, dir, fileName, runId, warnings) {
     warnings.push(`collision renamed: ${relativePath(root, target)} -> ${relativePath(root, renamedTarget)}`);
     return renamedTarget;
 }
+async function detectDuplicateContent(root, payload, contentFingerprint, warnings) {
+    const rawDir = safeJoin(root, "02-raw", "articles");
+    let entries;
+    try {
+        entries = await fs.readdir(rawDir);
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return;
+        }
+        throw error;
+    }
+    const sourceUrl = payload.source.url ?? "";
+    for (const entry of entries) {
+        if (!entry.toLowerCase().endsWith(".md")) {
+            continue;
+        }
+        const existingPath = path.join(rawDir, entry);
+        const existing = await fs.readFile(existingPath, "utf8");
+        if (!frontmatterValue(existing, "content_fingerprint", contentFingerprint)) {
+            continue;
+        }
+        const sameSource = sourceUrl
+            ? frontmatterValue(existing, "source_url", sourceUrl)
+            : frontmatterValue(existing, "title", payload.source.title ?? "Untitled");
+        if (sameSource) {
+            warnings.push(`duplicate content fingerprint: ${contentFingerprint} already exists at ${relativePath(root, existingPath)}; new run kept separate and long-term files will not overwrite existing files.`);
+            return;
+        }
+    }
+}
+function frontmatterValue(markdown, key, expected) {
+    const escapedKey = key.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const escapedExpected = expected.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    return new RegExp(`^${escapedKey}:\\s*"?${escapedExpected}"?\\s*$`, "m").test(markdown);
+}
 async function writeFile(target, content, generatedFiles) {
     try {
         await fs.writeFile(target, content, { encoding: "utf8", flag: "wx" });
@@ -132,6 +170,7 @@ async function writeSummary(root, runDir, payload, generatedFiles, warnings, lin
         `created_at: "${escapeYaml(createdAt)}"`,
         `captured_at: "${escapeYaml(payload.source.captured_at)}"`,
         `run_id: "${escapeYaml(runId)}"`,
+        ...(links ? [`content_fingerprint: "${escapeYaml(links.contentFingerprint)}"`] : []),
         ...(links ? relationshipFrontmatter(links) : []),
         ...groundingFrontmatterLines(grounding),
         `tags: ["aiwiki/run"]`,
@@ -176,6 +215,7 @@ function contentFile(payload, content, links) {
         `created_at: "${escapeYaml(links.createdAt)}"`,
         `captured_at: "${escapeYaml(payload.source.captured_at)}"`,
         `run_id: "${escapeYaml(links.runId)}"`,
+        `content_fingerprint: "${escapeYaml(links.contentFingerprint)}"`,
         ...relationshipFrontmatter(links),
         `tags: ["aiwiki/raw"]`,
         "---",
@@ -207,6 +247,7 @@ function sourceCard(payload, runId, links, grounding) {
         `created_at: "${escapeYaml(links.createdAt)}"`,
         `captured_at: "${escapeYaml(payload.source.captured_at)}"`,
         `run_id: "${escapeYaml(runId)}"`,
+        `content_fingerprint: "${escapeYaml(links.contentFingerprint)}"`,
         ...relationshipFrontmatter(links),
         ...groundingFrontmatterLines(grounding),
         `aliases: ["${escapeYaml(payload.source.title ?? "Untitled")}"]`,
@@ -229,6 +270,13 @@ function sourceCard(payload, runId, links, grounding) {
         "",
         trimPreview(payload.source.content ?? payload.source.fetch_notes ?? ""),
         "",
+        "## Problem / Evidence / Reuse",
+        "",
+        `- problem_solved: ${payload.analysis?.summary ?? "needs host Agent analysis"}`,
+        `- evidence_boundary: ${grounding.needs_review ? "review required before treating analysis as fact" : "host supplied evidence available"}`,
+        `- reuse_scenarios: ${payload.analysis?.use_cases.length ? payload.analysis.use_cases.join(", ") : "not specified"}`,
+        `- content_fingerprint: ${links.contentFingerprint}`,
+        "",
         "## Grounding 状态",
         "",
         `- 证据通道：${grounding.evidence_channel}`,
@@ -253,6 +301,7 @@ function claims(payload, links, grounding) {
         `created_at: "${escapeYaml(links.createdAt)}"`,
         `captured_at: "${escapeYaml(payload.source.captured_at)}"`,
         `run_id: "${escapeYaml(links.runId)}"`,
+        `content_fingerprint: "${escapeYaml(links.contentFingerprint)}"`,
         ...relationshipFrontmatter(links),
         ...groundingFrontmatterLines(grounding),
         `tags: ["aiwiki/claims"]`,
@@ -274,6 +323,11 @@ function claims(payload, links, grounding) {
         "## 建议",
         "",
         ...claimLines,
+        "## Evidence Boundary",
+        "",
+        "- Claims with a matching source_quote are traceable to the provided source content.",
+        "- Claims without a matching source_quote remain suggestions and need human or host-Agent review before reuse.",
+        "",
         ""
     ].join("\n");
 }
@@ -290,6 +344,7 @@ function creativeAssets(payload, links) {
         `created_at: "${escapeYaml(links.createdAt)}"`,
         `captured_at: "${escapeYaml(payload.source.captured_at)}"`,
         `run_id: "${escapeYaml(links.runId)}"`,
+        `content_fingerprint: "${escapeYaml(links.contentFingerprint)}"`,
         ...relationshipFrontmatter(links),
         `tags: ["aiwiki/assets"]`,
         "---",
@@ -316,6 +371,7 @@ function topics(payload, links) {
         `created_at: "${escapeYaml(links.createdAt)}"`,
         `captured_at: "${escapeYaml(payload.source.captured_at)}"`,
         `run_id: "${escapeYaml(links.runId)}"`,
+        `content_fingerprint: "${escapeYaml(links.contentFingerprint)}"`,
         ...relationshipFrontmatter(links),
         `tags: ["aiwiki/topics"]`,
         "---",
@@ -342,6 +398,7 @@ function outline(payload, links) {
         `created_at: "${escapeYaml(links.createdAt)}"`,
         `captured_at: "${escapeYaml(payload.source.captured_at)}"`,
         `run_id: "${escapeYaml(links.runId)}"`,
+        `content_fingerprint: "${escapeYaml(links.contentFingerprint)}"`,
         ...relationshipFrontmatter(links),
         `tags: ["aiwiki/outline"]`,
         "---",
@@ -354,11 +411,28 @@ function outline(payload, links) {
         "",
         "1. 背景",
         "2. 关键观点",
-        "3. 可复用方法",
-        `4. 来源：${payload.source.title ?? "Untitled"}`,
+        "3. 证据与推断边界",
+        "4. 可复用判断与方法",
+        "5. 适用场景",
+        "6. 可继续链接的条目",
+        `7. 来源：${payload.source.title ?? "Untitled"}`,
+        "",
+        "## Host Agent Outline Hints",
+        "",
+        ...outlineHintLines(payload),
         ""
     ].join("\n");
 }
+function outlineHintLines(payload) {
+    const outline = payload.analysis?.outline?.sections ?? [];
+    const links = payload.analysis?.suggested_links ?? [];
+    const lines = [
+        ...(outline.length ? outline.map((item) => `- outline_section: ${item}`) : []),
+        ...(payload.analysis?.reusable_judgments.length ? payload.analysis.reusable_judgments.map((item) => `- reusable_judgment: ${item.judgment}`) : []),
+        ...(links.length ? links.map((item) => `- suggested_link: ${item.title}${item.target ? ` -> ${item.target}` : ""}`) : [])
+    ];
+    return lines.length ? lines : ["- No enriched outline hints supplied by the host Agent."];
+}
 function claimSuggestionLines(index, claim, confidence, sourceQuote, content) {
     const quote = sourceQuote?.trim();
     const supported = Boolean(quote && content.includes(quote));
@@ -447,11 +521,12 @@ function findGeneratedFileInDir(root, files, dir) {
     const match = files.find((file) => relativePath(root, file).startsWith(`${dir}/`));
     return match ? relativePath(root, match) : undefined;
 }
-function buildArtifactLinks(root, slug, runDirName, createdAt, longTermTargets) {
+function buildArtifactLinks(root, slug, runDirName, createdAt, contentFingerprint, longTermTargets) {
     return {
         slug,
         runId: runDirName,
         createdAt,
+        contentFingerprint,
         raw: relativePath(root, longTermTargets.raw),
         sourceCard: relativePath(root, longTermTargets.sourceCard),
         wikiEntry: relativePath(root, longTermTargets.wikiEntry),
@@ -462,6 +537,9 @@ function buildArtifactLinks(root, slug, runDirName, createdAt, longTermTargets)
         runSummary: `09-runs/${runDirName}/processing-summary.md`
     };
 }
+function createContentFingerprint(content) {
+    return `sha256:${createHash("sha256").update(content.replace(/\r\n/g, "\n"), "utf8").digest("hex")}`;
+}
 function relationshipFrontmatter(links) {
     return [
         `wiki_entry: "${escapeYaml(obsidianLink(links.wikiEntry, "Wiki 条目"))}"`,

package/dist/src/payload.js

@@ -142,10 +142,15 @@ function normalizeAnalysis(value, warnings) {
         summary: stringValue(value.summary),
         key_points: stringArray(value.key_points, "analysis.key_points", warnings),
         reusable_knowledge: reusableKnowledgeArray(value.reusable_knowledge, warnings),
+        entities: stringArray(value.entities, "analysis.entities", warnings),
+        concepts: stringArray(value.concepts, "analysis.concepts", warnings),
+        tensions: stringArray(value.tensions, "analysis.tensions", warnings),
+        reusable_judgments: reusableJudgmentsArray(value.reusable_judgments, warnings),
         related_concepts: stringArray(value.related_concepts, "analysis.related_concepts", warnings),
         use_cases: stringArray(value.use_cases, "analysis.use_cases", warnings),
         topic_candidates: stringArray(value.topic_candidates, "analysis.topic_candidates", warnings),
         claims: claimsArray(value.claims, warnings),
+        suggested_links: suggestedLinksArray(value.suggested_links, warnings),
         outline: outlineValue(value.outline, warnings)
     };
     return hasAnalysisContent(analysis) ? analysis : undefined;
@@ -194,6 +199,51 @@ function reusableKnowledgeArray(value, warnings) {
         return [];
     });
 }
+function reusableJudgmentsArray(value, warnings) {
+    if (value === undefined) {
+        return [];
+    }
+    if (!Array.isArray(value)) {
+        warnings.push("analysis.reusable_judgments ignored: expected an array.");
+        return [];
+    }
+    return value.flatMap((item) => {
+        if (typeof item === "string" && item.trim()) {
+            return [{ judgment: item.trim() }];
+        }
+        if (isRecord(item) && typeof item.judgment === "string" && item.judgment.trim()) {
+            return [{
+                    title: stringValue(item.title),
+                    judgment: item.judgment.trim(),
+                    rationale: stringValue(item.rationale),
+                    source_quote: stringValue(item.source_quote)
+                }];
+        }
+        return [];
+    });
+}
+function suggestedLinksArray(value, warnings) {
+    if (value === undefined) {
+        return [];
+    }
+    if (!Array.isArray(value)) {
+        warnings.push("analysis.suggested_links ignored: expected an array.");
+        return [];
+    }
+    return value.flatMap((item) => {
+        if (typeof item === "string" && item.trim()) {
+            return [{ title: item.trim() }];
+        }
+        if (isRecord(item) && typeof item.title === "string" && item.title.trim()) {
+            return [{
+                    title: item.title.trim(),
+                    target: stringValue(item.target),
+                    reason: stringValue(item.reason)
+                }];
+        }
+        return [];
+    });
+}
 function claimsArray(value, warnings) {
     if (value === undefined) {
         return [];
@@ -252,10 +302,15 @@ function hasAnalysisContent(analysis) {
     return Boolean(analysis.summary ||
         analysis.key_points.length ||
         analysis.reusable_knowledge.length ||
+        analysis.entities.length ||
+        analysis.concepts.length ||
+        analysis.tensions.length ||
+        analysis.reusable_judgments.length ||
         analysis.related_concepts.length ||
         analysis.use_cases.length ||
         analysis.topic_candidates.length ||
         analysis.claims.length ||
+        analysis.suggested_links.length ||
         analysis.outline);
 }
 function hasCustomOutputRequest(outputs) {

package/dist/src/wiki-entry.js

@@ -37,10 +37,11 @@ function wikiFrontmatter(payload, links, title, mode, quality, grounding) {
         `outline_file: "${escapeYaml(links.outline)}"`,
         `run_summary: "${escapeYaml(links.runSummary)}"`,
         `run_id: "${escapeYaml(links.runId)}"`,
+        `content_fingerprint: "${escapeYaml(links.contentFingerprint)}"`,
         `created_at: "${escapeYaml(links.createdAt)}"`,
         `updated_at: "${escapeYaml(links.createdAt)}"`,
         ...(mode === "agent_enriched" ? [`summary: "${escapeYaml(payload.wiki_entry?.summary ?? payload.analysis?.summary ?? "")}"`] : []),
-        `topics: ${yamlStringArray(payload.analysis?.related_concepts ?? [])}`,
+        `topics: ${yamlStringArray([...(payload.analysis?.related_concepts ?? []), ...(payload.analysis?.concepts ?? [])])}`,
         `claims: ${yamlStringArray(payload.analysis?.claims.map((claim) => claim.claim) ?? [])}`,
         ...groundingFrontmatterLines(grounding),
         `tags: ["aiwiki/wiki-entry"]`,
@@ -83,9 +84,13 @@ function enrichedBody(payload, links, title, grounding) {
     else {
         sections.push("## 核心观点", "", ...listOrFallback(payload.analysis?.key_points ?? [], "待宿主 Agent 补充。"), "");
         sections.push("## 可复用知识点", "", ...knowledgeList(payload), "");
+        sections.push("## Reusable Judgments", "", ...judgmentList(payload), "");
+        sections.push("## Entities and Concepts", "", ...entityConceptList(payload), "");
+        sections.push("## Tensions", "", ...listOrFallback(payload.analysis?.tensions ?? [], "No explicit tension supplied by the host Agent."), "");
         sections.push("## 相关概念", "", ...listOrFallback(payload.analysis?.related_concepts ?? [], "待宿主 Agent 补充。"), "");
         sections.push("## 适合用于什么场景", "", ...listOrFallback(payload.analysis?.use_cases ?? [], "待宿主 Agent 补充。"), "");
         sections.push("## 可转化的选题", "", ...listOrFallback(payload.analysis?.topic_candidates ?? [], "待宿主 Agent 补充。"), "");
+        sections.push("## Suggested Links", "", ...suggestedLinkList(payload), "");
     }
     sections.push(sourceSection(links));
     return sections.join("\n");
@@ -137,6 +142,42 @@ function knowledgeList(payload) {
     }
     return items.flatMap((item) => item.title ? [`### ${item.title}`, "", item.content] : [`- ${item.content}`]);
 }
+function judgmentList(payload) {
+    const items = payload.analysis?.reusable_judgments ?? [];
+    if (!items.length) {
+        return ["No reusable judgment supplied by the host Agent."];
+    }
+    return items.flatMap((item) => [
+        item.title ? `### ${item.title}` : "### Judgment",
+        "",
+        `- judgment: ${item.judgment}`,
+        ...(item.rationale ? [`- rationale: ${item.rationale}`] : []),
+        ...(item.source_quote ? ["- evidence boundary: host supplied quote"] : ["- evidence boundary: needs review if reused as a factual claim"]),
+        ""
+    ]);
+}
+function entityConceptList(payload) {
+    const entities = payload.analysis?.entities ?? [];
+    const concepts = payload.analysis?.concepts ?? [];
+    if (!entities.length && !concepts.length) {
+        return ["No explicit entities or concepts supplied by the host Agent."];
+    }
+    return [
+        ...(entities.length ? [`- entities: ${entities.join(", ")}`] : []),
+        ...(concepts.length ? [`- concepts: ${concepts.join(", ")}`] : [])
+    ];
+}
+function suggestedLinkList(payload) {
+    const links = payload.analysis?.suggested_links ?? [];
+    if (!links.length) {
+        return ["No suggested links supplied by the host Agent."];
+    }
+    return links.map((link) => {
+        const target = link.target ? ` -> ${link.target}` : "";
+        const reason = link.reason ? ` (${link.reason})` : "";
+        return `- ${link.title}${target}${reason}`;
+    });
+}
 function listOrFallback(values, fallback) {
     return values.length ? values.map((value) => `- ${value}`) : [fallback];
 }

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/AGENT_HANDOFF.md

@@ -101,6 +101,18 @@ AIWiki 会修复常见 UTF-8 mojibake，但这只是兜底；宿主 Agent 仍应
 }
 ```
 
+## Analysis 增强字段
+
+`analysis` 仍然向后兼容；旧 payload 不需要修改。宿主 Agent 能提供时，可以额外写入这些可选字段：
+
+- `entities`：文章中可复查的人、产品、组织、地点等实体。
+- `concepts`：可沉淀为知识条目的概念、方法或框架。
+- `tensions`：原文中的冲突、取舍、不确定性或反常识点。
+- `reusable_judgments`：可复用判断，建议同时提供 `rationale` 和 `source_quote`。
+- `suggested_links`：建议关联到已有 Wiki 条目的线索和原因。
+
+不能确认的内容不要编造。AIWiki 会为成功入库的正文写入 `content_fingerprint`；重复入库同一来源同一正文时会保留新 run、输出 warning，并避免覆盖已有长期文件。
+
 ## 失败 payload
 
 ```json

package/docs/USAGE.md

@@ -12,6 +12,8 @@ AIWiki CLI 也不调用 LLM。高质量 Wiki Entry 来自宿主 Agent 提供的
 
 AIWiki 会把证据通道和疑似风险分开记录。`source_quote` 等宿主 Agent 提供的原文引用属于证据通道；`coverage_suspected_incomplete`、`unsupported_claims`、`needs_review` 等属于 AIWiki 生成的启发式复核信号，不等于已经证明内容遗漏。
 
+成功入库的正文会写入稳定的 `content_fingerprint`。如果同一来源同一正文重复入库，AIWiki 会保留新的 run 记录、给出重复 fingerprint warning，并把长期文件改名保存，避免静默覆盖已有知识资产。
+
 ## 1. 一次性设置
 
 发布后直接运行交互式 setup：
@@ -215,6 +217,8 @@ Wiki Entry 有两种质量模式：
 - `agent_enriched` / `enriched`：宿主 Agent 提供了 `analysis` 或 `wiki_entry`。
 - `deterministic_fallback` / `scaffold`：AIWiki 只生成来源、反链、正文预览和待补全区。
 
+`analysis` 可以继续只传旧字段，也可以补充 `entities`、`concepts`、`tensions`、`reusable_judgments`、`suggested_links`。这些字段会进入 Wiki Entry，帮助用户区分“实体/概念”“可复用判断”“证据边界”和“后续可链接条目”，但不会被 AIWiki 当作已经证实的事实。
+
 Artifact 角色保持固定：
 
 - `03-sources/article-cards` 是 trace-first 的资料卡：保留来源、反链、原文预览和 grounding 状态，不承担完整知识正文。
@@ -251,7 +255,7 @@ AIWiki 生成的 Markdown 按 Obsidian vault 内路径组织，文件正文会
 - `05-wiki/source-knowledge` 是默认知识入口；`03-sources/article-cards` 会链接到 Wiki 条目、原文、Claim 建议、素材建议、选题、大纲和本次处理记录。
 - `02-raw/articles`、`04-claims/_suggestions`、`06-assets/_suggestions`、`07-topics/ready`、`08-outputs/outlines` 会回链到资料卡，Obsidian 的 Backlinks/Graph View 可以串起同一篇资料。
 - `09-runs/<run-id>/processing-summary.md` 会把本次生成的 Markdown 文件列成可点击 wikilink；`payload.json` 不是 Markdown，保留普通路径。
-- frontmatter 会写入 `aiwiki_id`、`type`、`status`、`slug`、`source_url`、`created_at`、`captured_at`、`run_id`、`source_card`、`raw_note`、`claims_note`、`assets_note`、`topics_note`、`outline_note`、`run_summary`、`tags` 等字段，便于后续用 Obsidian Search / Properties / Dataview 做筛选。
+- frontmatter 会写入 `aiwiki_id`、`type`、`status`、`slug`、`source_url`、`content_fingerprint`、`created_at`、`captured_at`、`run_id`、`source_card`、`raw_note`、`claims_note`、`assets_note`、`topics_note`、`outline_note`、`run_summary`、`tags` 等字段，便于后续用 Obsidian Search / Properties / Dataview 做筛选。
 
 ### Obsidian 数据库入口
 
@@ -406,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.13",
+  "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",

package/skill/SKILL.md

@@ -9,14 +9,27 @@ Use this skill when the user asks an Agent to process one URL, article body, or
 
 AIWiki CLI does not fetch webpages and does not call an LLM. The host Agent reads and understands the source; AIWiki validates, writes, links, tracks, queries, and lints local Markdown knowledge files.
 
+## Knowledge Base Purpose
+
+Before ingesting, querying, linting, or reorganizing material, read `_system/purpose.md` in the target AIWiki workspace when it exists. Treat it as the local contract for:
+
+- what this knowledge base is trying to solve
+- what material belongs here
+- what material should stay out
+- how uncertain or off-scope material should be handled
+- how this knowledge base should remain separable from future knowledge bases
+
+If the material does not fit the purpose file, do not force it into the knowledge base as confirmed knowledge. Record the mismatch, ask for review when needed, or keep it as a traceable source rather than a claim.
+
 ## Ingest Flow
 
 1. Read the URL, message, attachment, or user-provided body.
-2. Build an `aiwiki.agent_payload.v1` payload with `source` and `request`.
-3. If you understand the source, also provide `analysis` and/or `wiki_entry`.
-4. Do not include output paths in the payload. The CLI decides where files are written.
-5. If webpage reading fails, still build a payload with `source.fetch_status` set to `failed` and include `source.fetch_notes`.
-6. Prefer stdin so the user does not need to save a payload file:
+2. Read `_system/purpose.md` and decide whether the material fits this knowledge base.
+3. Build an `aiwiki.agent_payload.v1` payload with `source` and `request`.
+4. If you understand the source, also provide `analysis` and/or `wiki_entry`.
+5. Do not include output paths in the payload. The CLI decides where files are written.
+6. If webpage reading fails, still build a payload with `source.fetch_status` set to `failed` and include `source.fetch_notes`.
+7. Prefer stdin so the user does not need to save a payload file:
 
 ```bash
 aiwiki ingest-agent --stdin