@itradingai/aiwiki 0.2.19 → 0.2.21

package/examples/obsidian-vault-sample/_system/templates/source-card.md

@@ -0,0 +1,34 @@
+---
+aiwiki_id: ""
+type: "source_card"
+status: "to-review"
+slug: ""
+title: ""
+source_url: ""
+source_type: ""
+created_at: ""
+captured_at: ""
+run_id: ""
+source_card: ""
+raw_note: ""
+claims_note: ""
+assets_note: ""
+topics_note: ""
+outline_note: ""
+run_summary: ""
+tags: ["aiwiki/source-card"]
+---
+
+# 资料卡
+
+## Obsidian 链接
+
+- 原文：
+- Claim 建议：
+- 素材建议：
+- 选题：
+- 大纲：
+- 处理记录：
+
+## 摘要
+

package/examples/obsidian-vault-sample/aiwiki.yaml

@@ -0,0 +1,18 @@
+product: aiwiki
+schema_version: 1
+created_at: "2026-06-08T16:06:03.826Z"
+
+knowledge_base:
+  id: default
+  name: AIWiki
+  language: zh-CN
+
+agent:
+  url_first: true
+  fetch_owner: host_agent
+  cli_fetch_webpage: false
+
+review:
+  wiki_merge_policy: manual
+  claim_policy: suggest_only
+  asset_policy: suggest_only

package/examples/obsidian-vault-sample/dashboards/AIWiki Home.md

@@ -0,0 +1,31 @@
+# AIWiki 首页
+
+AIWiki 的 Obsidian 入口。Dataview 是可选增强；未安装时仍可使用下方普通链接、Properties、Backlinks 和 Graph View。
+
+## 原生链接入口
+
+- [[dashboards/Wiki Entries|Wiki 条目]]
+- [[dashboards/Source Cards|资料卡]]
+- [[dashboards/Review Queue|待审队列]]
+- [[dashboards/Recent Runs|最近处理]]
+- [[dashboards/Topic Pipeline|选题管线]]
+- [[dashboards/Lint Report|结构检查]]
+- [[_system/schemas/aiwiki-frontmatter|字段说明]]
+
+## 最近收录
+
+```dataview
+TABLE status, source_url, captured_at, run_summary
+FROM "03-sources/article-cards"
+WHERE type = "source_card"
+SORT captured_at DESC
+```
+
+## 待审队列
+
+```dataview
+TABLE type, status, source_card, raw_note, run_summary
+FROM "03-sources/article-cards" or "04-claims/_suggestions" or "06-assets/_suggestions" or "08-outputs/outlines"
+WHERE status = "to-review"
+SORT created_at DESC
+```

package/examples/obsidian-vault-sample/dashboards/Recent Runs.md

@@ -0,0 +1,10 @@
+# 最近处理
+
+处理记录用于追溯每次宿主 Agent 入库的 payload、产物和告警。
+
+```dataview
+TABLE status, source_url, source_card, raw_note, created_at
+FROM "09-runs"
+WHERE type = "processing_summary"
+SORT created_at DESC
+```

package/examples/obsidian-vault-sample/dashboards/Review Queue.md

@@ -0,0 +1,12 @@
+# 待审队列
+
+未安装 Dataview 时，可直接打开 [[03-sources/article-cards]]、[[04-claims/_suggestions]]、[[06-assets/_suggestions]] 和 [[08-outputs/outlines]] 手工审阅。
+
+## 待审内容
+
+```dataview
+TABLE type, source_url, source_card, raw_note, claims_note, assets_note, outline_note
+FROM "03-sources/article-cards" or "04-claims/_suggestions" or "06-assets/_suggestions" or "08-outputs/outlines"
+WHERE status = "to-review"
+SORT captured_at DESC
+```

package/examples/obsidian-vault-sample/dashboards/Source Cards.md

@@ -0,0 +1,10 @@
+# 资料卡
+
+资料卡用于追踪来源、原文、Claim 建议、素材建议、选题和大纲。
+
+```dataview
+TABLE status, source_url, wiki_entry, raw_note, captured_at
+FROM "03-sources/article-cards"
+WHERE type = "source_card"
+SORT captured_at DESC
+```

package/examples/obsidian-vault-sample/dashboards/Topic Pipeline.md

@@ -0,0 +1,10 @@
+# 选题管线
+
+选题和大纲是从资料卡继续写作的入口。
+
+```dataview
+TABLE status, source_card, outline_note, source_url, created_at
+FROM "07-topics/ready" or "08-outputs/outlines"
+WHERE type = "topic_candidates" or type = "draft_outline"
+SORT created_at DESC
+```

package/examples/obsidian-vault-sample/dashboards/Wiki Entries.md

@@ -0,0 +1,10 @@
+# Wiki 条目
+
+AIWiki 每次成功入库都会生成 Wiki Entry。这里是知识层入口，不要求先经过 Review Queue 才能查询。
+
+```dataview
+TABLE wiki_type, source_role, represents_user_view, quality, source_card, raw_file, updated_at
+FROM "05-wiki"
+WHERE type = "wiki_entry"
+SORT updated_at DESC
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itradingai/aiwiki",
-  "version": "0.2.19",
+  "version": "0.2.21",
   "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",
@@ -50,6 +50,7 @@
     "docs/USAGE.md",
     "docs/development-log.md",
     "docs/architecture.svg",
+    "examples",
     "skill"
   ],
   "bin": {

package/skill/SKILL.md

@@ -3,7 +3,7 @@ name: aiwiki
 description: Agent-first AIWiki workflow for turning one URL/body into local Wiki knowledge files.
 ---
 
-<!-- aiwiki-skill-version: 0.2.19 -->
+<!-- aiwiki-skill-version: 0.2.21 -->
 
 # AIWiki Skill
 
@@ -34,15 +34,42 @@ aiwiki agent sync --json --yes
 aiwiki agent check --json
 ```
 
+For a project or vault workspace, also sync root guidance so future Agents see the command contract before they inspect files:
+
+```bash
+aiwiki agent sync --path <workspace> --yes
+aiwiki agent check --path <workspace> --json
+```
+
 Sync behavior:
 
 - missing installed skill: install the packaged AIWiki skill
 - current installed skill: leave unchanged
 - different installed skill: backup the old file, then overwrite with the packaged skill
+- workspace `AGENTS.md`: append or refresh the marker-bounded AIWiki block without removing user instructions
 - unsupported host: do not write; use `aiwiki prompt agent` as a manual fallback
 
 After sync, tell the user the target path, any backup path, and that the target Agent may need to restart or reload before the new skill is active. Never edit Agent config during `npm install`; sync is the explicit safe step.
 
+## Required Command-First Loop
+
+When the user asks you to organize, inspect, ingest, query, reuse, or maintain an AIWiki workspace, run the AIWiki command surface before generic file search or ad hoc note edits:
+
+```bash
+aiwiki setup --path <workspace> --yes
+aiwiki agent sync --path <workspace> --yes
+aiwiki agent check --path <workspace> --json
+aiwiki lint --json --path <workspace>
+aiwiki lint --fix-empty-dirs --json --path <workspace>
+aiwiki ingest-file --file <file> --path <workspace>
+aiwiki ingest-agent --stdin --path <workspace>
+aiwiki status --path <workspace>
+aiwiki query <topic> --path <workspace>
+aiwiki context <topic> --path <workspace>
+```
+
+Use fallback shell/file search only after the relevant AIWiki command has been tried or when the command is unavailable. If you fall back, explain which AIWiki command was insufficient and why. If you skip the AIWiki commands entirely, the knowledge-base features are not being exercised.
+
 ## 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: