@itradingai/aiwiki 0.2.12 → 0.2.13

package/dist/src/app.js

@@ -416,6 +416,7 @@ function printAgentPrompt(stream) {
     writeLine(stream, "- 收录 <url>");
     writeLine(stream, "- 存一下 <url>");
     writeLine(stream, "- aiwiki <url>");
+    writeLine(stream, "Before ingesting, querying, or reorganizing, read `_system/purpose.md` and keep material aligned with the knowledge-base goal, scope, and unsuitable-content rules.");
     writeLine(stream, "");
     writeLine(stream, "如果当前会话被用户明确设定为 AIWiki 入库助手，则用户只发送 URL 也默认触发入库。普通会话中不要把所有 URL 都自动入库。");
     writeLine(stream, "");

package/dist/src/workspace.js

@@ -21,6 +21,94 @@ export const REQUIRED_DIRS = [
     "_system/logs"
 ];
 const WORKSPACE_SEEDS = [
+    {
+        path: "_system/purpose.md",
+        content: `# AIWiki Knowledge Base Purpose
+
+This file defines what this knowledge base is for. Host Agents should read it before ingesting, querying, or reorganizing content.
+
+## Goal
+
+Build a local, traceable AI knowledge base that turns useful articles, notes, and source material into Obsidian-ready Markdown.
+
+## Suitable Materials
+
+- Articles, notes, transcripts, and references that can become source cards, wiki entries, claims, topics, outlines, or reusable assets.
+- External materials with clear source information.
+- User-owned drafts or published work when the user explicitly says the material represents their own output.
+
+## Unsuitable Materials
+
+- Content without a usable source or context.
+- Purely private, sensitive, illegal, or unsafe material.
+- Generic web noise that cannot become reusable knowledge.
+- Claims that cannot be tied back to evidence.
+
+## Multi-Knowledge-Base Boundary
+
+This base AIWiki workspace is a single knowledge base. If the user later creates multiple knowledge bases, each one should have its own purpose file and Agents should route material according to that local purpose.
+
+## Agent Rules
+
+- Respect this purpose before ingesting material.
+- Keep evidence and inference separate.
+- Do not treat external input as the user's own view unless the user says so.
+- Prefer traceable source cards and wiki entries over unsupported summaries.
+`
+    },
+    {
+        path: "_system/index.md",
+        content: `# AIWiki System Index
+
+Use this file as the human and Agent entry point for the knowledge base.
+
+## Core Areas
+
+- [[02-raw/articles|Raw Articles]]
+- [[03-sources/article-cards|Source Cards]]
+- [[04-claims/_suggestions|Claim Suggestions]]
+- [[05-wiki|Wiki Entries]]
+- [[06-assets/_suggestions|Asset Suggestions]]
+- [[07-topics/ready|Topic Pipeline]]
+- [[08-outputs/outlines|Draft Outlines]]
+- [[09-runs|Processing Runs]]
+
+## Dashboards
+
+- [[dashboards/AIWiki Home|AIWiki Home]]
+- [[dashboards/Review Queue|Review Queue]]
+- [[dashboards/Recent Runs|Recent Runs]]
+- [[dashboards/Lint Report|Lint Report]]
+
+## System Files
+
+- [[_system/purpose|Purpose]]
+- [[_system/log|Log]]
+- [[_system/schemas/aiwiki-frontmatter|Frontmatter Schema]]
+
+## Common Commands
+
+\`\`\`bash
+aiwiki status
+aiwiki next
+aiwiki query "<topic>"
+aiwiki context "<topic>"
+aiwiki lint
+\`\`\`
+`
+    },
+    {
+        path: "_system/log.md",
+        content: `# AIWiki System Log
+
+This lightweight log is reserved for important workspace events. It keeps the base edition file-first and does not require a database.
+
+## Entries
+
+<!-- Add manual or future automated events below. -->
+
+`
+    },
     {
         path: "dashboards/AIWiki Home.md",
         content: `# AIWiki 首页

package/docs/AGENT_HANDOFF.md

@@ -208,3 +208,8 @@ aiwiki lint
 ```
 
 不要把外部资料标成代表用户观点。
+# Knowledge Base Purpose
+
+Before ingesting, querying, or reorganizing material, read `_system/purpose.md` in the target AIWiki workspace. Treat it as the local contract for what belongs in this knowledge base, what should stay out, and how future multi-knowledge-base routing should be handled.
+
+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.

package/docs/USAGE.md

@@ -403,3 +403,6 @@ aiwiki status
 - 成功读取时，`03-sources/article-cards` 下出现资料卡。
 - 成功读取时，`05-wiki/source-knowledge` 下出现 Wiki Entry。
 - 抓取失败时，`09-runs/<run-id>-fetch-failed` 下出现失败记录。
+# 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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itradingai/aiwiki",
-  "version": "0.2.12",
+  "version": "0.2.13",
   "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",