lumina-wiki 0.9.0 → 1.0.0

package/CHANGELOG.md

@@ -5,6 +5,45 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 ## [Unreleased]
 
+## [1.0.0] - 2026-05-06
+
+### Added
+
+- `lumina discover run` command for one-shot scheduled discovery runs from a workspace watchlist.
+- Research-pack watchlist configuration template at install time, with upgrade behavior that preserves user edits.
+- Scheduled discovery runner output under `raw/discovered/`, including scoring metadata, duplicate tracking, and run summaries.
+- `/lumi-research-watchlist` skill to help users configure research watchlists with an agent.
+- Advanced scheduled discovery guides in English, Vietnamese, and Simplified Chinese, covering GitHub Actions, macOS/Linux cron, and Windows Task Scheduler.
+
+### Changed
+
+- User guides now link to the advanced scheduled discovery guide from their guide menu.
+- Scheduled discovery documentation now explains what to do after new research is found, including reviewing candidates and ingesting useful sources.
+- GitHub Actions guidance now includes auto-commit behavior for discovered research output when a run finds changes.
+
+### Fixed
+
+- Scheduled discovery now exits non-zero when hard source fetch errors occur, so CI and cron jobs do not silently pass failed runs.
+- Scheduled discovery now deduplicates the same paper across arXiv and Semantic Scholar before falling back to source-specific IDs.
+
+### Migration
+
+- Existing workspaces can re-run `npx lumina-wiki@latest install --yes` to receive the scheduled discovery runner, watchlist template, and watchlist skill. Existing `wiki/`, `raw/`, and user-edited watchlists are preserved.
+
+## [0.9.1] - 2026-05-05
+
+### Changed
+
+- `/lumi-ingest` now uses selective human review: after the user accepts the draft, link cleanup and source checking continue automatically when clean. The skill asks again only when user judgment is needed, such as unresolved page issues, source-check findings, missing source files, overwrite/restart decisions, or saving with lower confidence.
+- Installed agent context now emphasizes plain, everyday communication for non-technical users. Agents should sound like helpful knowledge assistants, use the configured communication language consistently, translate workflow terms, and avoid coding-agent language in user-facing replies.
+- README-generated IDE stubs now explicitly point agents to the README's user communication rules while staying thin and regenerated.
+- `/lumi-research-prefill` prompts now follow the same language rule and avoid exposing internal tool terms in user-facing choices.
+- README and user guide docs in English, Vietnamese, and Simplified Chinese now describe the quieter ingest flow instead of four mandatory checkpoints.
+
+### Fixed
+
+- `package-lock.json` root package version is now aligned with `package.json`.
+
 ## [0.9.0] - 2026-05-05
 
 ### Added
@@ -189,7 +228,9 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 ---
 
-[Unreleased]: https://github.com/tronghieu/lumina-wiki/compare/v0.9.0...HEAD
+[Unreleased]: https://github.com/tronghieu/lumina-wiki/compare/v1.0.0...HEAD
+[1.0.0]: https://github.com/tronghieu/lumina-wiki/compare/v0.9.1...v1.0.0
+[0.9.1]: https://github.com/tronghieu/lumina-wiki/compare/v0.9.0...v0.9.1
 [0.9.0]: https://github.com/tronghieu/lumina-wiki/compare/v0.8.1...v0.9.0
 [0.8.1]: https://github.com/tronghieu/lumina-wiki/compare/v0.8.0...v0.8.1
 [0.8.0]: https://github.com/tronghieu/lumina-wiki/compare/v0.7.0...v0.8.0

package/README.md

@@ -106,7 +106,7 @@ Interact with your wiki using these commands in your AI chat interface, such as
 
 **Phase 1: Ingest and Build Knowledge**
 -   `/lumi-init`: Scan the `raw/` directory and perform the first wiki build.
--   `/lumi-ingest [path/to/file]`: Process a new document into the knowledge base, pausing at four checkpoints (write the draft, check structure, cross-check claims, save) for review.
+-   `/lumi-ingest [path/to/file]`: Process a new document into the knowledge base. It asks you to review the draft, then keeps going unless something needs your judgment.
 
 **Phase 2: Query and Maintain**
 -   `/lumi-ask [your question]`: Ask a question against the full knowledge base in `wiki/`.
@@ -161,13 +161,14 @@ These are the commands you can use when chatting with your AI agent.
 | Pack | Skill | Purpose |
 | :--- | :--- | :--- |
 | **Core** | `/lumi-init` | Initialize the wiki from all files in `raw/`. |
-| | `/lumi-ingest` | Read a document and write a wiki page. Pauses at four checkpoints — write the draft, check structure, cross-check claims, save — so you can review before each step commits. Resumable across sessions. |
+| | `/lumi-ingest` | Read a document and write a wiki page. It asks you to review the draft, then continues on its own unless something needs your judgment. Resumable across sessions. |
 | | `/lumi-ask` | Ask a question against the full knowledge base. |
 | | `/lumi-edit` | Request a manual edit to a wiki page. |
 | | `/lumi-check` | Check the wiki for errors, such as broken links. |
 | | `/lumi-reset` | Safely reset parts of the wiki. |
 | | `/lumi-verify` | Check that wiki notes match the sources they cite. Reports anything suspicious for your review; never edits notes for you. |
 | **Research** | `/lumi-research-discover` | Discover and rank relevant research papers. |
+| | `/lumi-research-watchlist` | Choose research topics for scheduled discovery with AI help. |
 | | `/lumi-research-survey` | Create a survey or summary from existing knowledge. |
 | | `/lumi-research-prefill` | Seed foundational concepts to avoid duplicates. |
 | | `/lumi-research-setup` | Help configure API keys for research tools. |
@@ -185,8 +186,8 @@ The scripts behind these skills live in `_lumina/scripts/` and `_lumina/tools/`;
 The current release is **v0.2** (preview). The full plan is in [`ROADMAP.md`](./ROADMAP.md). Headline items:
 
 **v1.0.0 - First Stable**
-- **Daily search and fetch** - watchlist queries (`_lumina/config/watchlist.yml`) run on a schedule; new arXiv / Semantic Scholar papers land automatically in `raw/discovered/<date>/`.
-- New `/lumi-daily` skill to triage newly collected papers.
+- **Scheduled discovery** - saved research topics can be checked on a schedule you choose.
+- New `/lumi-research-watchlist` skill to help you choose and update the topics to follow.
 - Stability lock for the v0.1 surface: CLI flags, exit codes, and schema field names.
 - Cross-platform CI matrix: macOS, Linux, and Windows on Node 20 and 22.
 

package/README.vi.md

@@ -106,7 +106,7 @@ Tương tác với wiki của bạn bằng cách sử dụng các lệnh này tr
 
 **Giai đoạn 1: Nạp và Xây dựng kiến thức**
 -   `/lumi-init`: Quét thư mục `raw/` và thực hiện xây dựng wiki lần đầu.
--   `/lumi-ingest [đường/dẫn/tới/file]`: Xử lý một tài liệu mới vào cơ sở kiến thức, dừng tại bốn điểm kiểm tra (viết bản nháp, kiểm cấu trúc, đối chiếu nguồn, lưu) để bạn xem lại.
+-   `/lumi-ingest [đường/dẫn/tới/file]`: Đưa một tài liệu mới vào wiki. AI cho bạn xem bản nháp trước, rồi tự tiếp tục nếu không có điểm cần bạn quyết định.
 
 **Giai đoạn 2: Khai thác và Bảo trì**
 -   `/lumi-ask [câu hỏi của bạn]`: Đặt câu hỏi dựa trên toàn bộ cơ sở kiến thức trong `wiki/`.
@@ -161,13 +161,14 @@ npx skills add https://github.com/tobi/qmd --skill qmd
 | Gói | Skill | Mục đích |
 | :--- | :--- | :--- |
 | **Core** | `/lumi-init` | Khởi tạo wiki từ tất cả các file trong `raw/`. |
-| | `/lumi-ingest` | Đọc một tài liệu và viết trang wiki. Dừng tại bốn điểm kiểm tra — viết bản nháp, kiểm cấu trúc, đối chiếu nguồn, lưu — để bạn xem lại trước mỗi bước. Có thể tiếp tục giữa các phiên. |
+| | `/lumi-ingest` | Đọc một tài liệu và viết trang wiki. AI cho bạn xem bản nháp trước, rồi tự tiếp tục nếu không có điểm cần bạn quyết định. Có thể tiếp tục giữa các phiên. |
 | | `/lumi-ask` | Đặt câu hỏi dựa trên toàn bộ cơ sở kiến thức. |
 | | `/lumi-edit` | Yêu cầu chỉnh sửa thủ công một trang wiki. |
 | | `/lumi-check` | Kiểm tra lỗi trong wiki (liên kết hỏng, v.v.). |
 | | `/lumi-reset` | Xóa các phần của wiki một cách an toàn. |
 | | `/lumi-verify` | Kiểm tra xem các trang wiki có khớp với nguồn đã trích dẫn không. Báo cáo những điểm đáng ngờ để bạn xem xét; không tự sửa ghi chú giúp bạn. |
 | **Research**| `/lumi-research-discover` | Khám phá và xếp hạng các bài báo nghiên cứu liên quan. |
+| | `/lumi-research-watchlist` | Giúp bạn chọn các chủ đề nghiên cứu để AI tìm định kỳ. |
 | | `/lumi-research-survey` | Tạo một bài tổng quan/khảo sát từ kiến thức hiện có. |
 | | `/lumi-research-prefill` | Tạo trước các khái niệm nền tảng để tránh trùng lặp. |
 | | `/lumi-research-setup` | Giúp cấu hình API key cho các công cụ nghiên cứu. |
@@ -185,16 +186,16 @@ Các script chạy nền nằm trong `_lumina/scripts/` và `_lumina/tools/`; th
 Phiên bản hiện tại là **v0.2** (preview). Kế hoạch đầy đủ ở [`ROADMAP.md`](./ROADMAP.md). Những hạng mục chính:
 
 **v1.0.0 — Bản ổn định đầu tiên**
-- **Daily search & fetch** — watchlist (`_lumina/config/watchlist.yml`) chạy theo lịch; paper mới từ arXiv / Semantic Scholar tự động đáp xuống `raw/discovered/<ngày>/`.
-- Skill mới `/lumi-daily` để triage những gì vừa thu thập kể từ lần chạy trước.
+- **Tìm tài liệu định kỳ** — các chủ đề nghiên cứu đã lưu có thể được kiểm tra lại theo lịch bạn chọn.
+- Skill mới `/lumi-research-watchlist` để giúp bạn chọn và cập nhật các chủ đề muốn theo dõi.
 - Khoá ổn định bề mặt v0.1 (CLI flags, exit codes, tên trường schema).
 - CI matrix đa nền tảng (macOS + Linux + Windows, Node 20 + 22).
 
-**v2.0.0 — Mở rộng nguồn paper cho Research Pack**
-- **Nguồn paper mới:** OpenAlex, Unpaywall, CORE (Ưu tiên 1) → OpenReview, Hugging Face Papers, Papers With Code (Ưu tiên 2) → Crossref, DOAJ, RSS từ các blog research lab (Ưu tiên 3).
-- **Đánh giá paper:** skill mới `/lumi-rank` đưa các chỉ số influential-citation count, xếp hạng theo lĩnh vực, Scite support/contrast, và Altmetric vào block `ranking:` trong frontmatter.
+**v2.0.0 — Mở rộng nguồn bài báo nghiên cứu cho Research Pack**
+- **Nguồn bài báo mới:** OpenAlex, Unpaywall, CORE (Ưu tiên 1) → OpenReview, Hugging Face Papers, Papers With Code (Ưu tiên 2) → Crossref, DOAJ, RSS từ các blog research lab (Ưu tiên 3).
+- **Đánh giá bài báo:** skill mới `/lumi-rank` đưa các chỉ số influential-citation count, xếp hạng theo lĩnh vực, Scite support/contrast, và Altmetric vào block `ranking:` trong frontmatter.
 
-**Muốn đóng góp?** Chọn bất kỳ hạng mục chưa tick trong `ROADMAP.md`, mở issue để nhận, rồi gửi PR. Các fetcher nguồn paper đều tuân theo cùng pattern trong `src/tools/` (CLI + JSON, no async, exit codes `0/2/3`) nên rất phù hợp cho lần contribute đầu tiên. Xem hướng dẫn dev cục bộ bên dưới.
+**Muốn đóng góp?** Chọn bất kỳ hạng mục chưa tick trong `ROADMAP.md`, mở issue để nhận, rồi gửi PR. Các fetcher nguồn bài báo đều tuân theo cùng pattern trong `src/tools/` (CLI + JSON, no async, exit codes `0/2/3`) nên rất phù hợp cho lần contribute đầu tiên. Xem hướng dẫn dev cục bộ bên dưới.
 
 ---
 

package/README.zh.md

@@ -106,7 +106,7 @@ node _lumina/scripts/wiki.mjs migrate --add-defaults
 
 **阶段一：导入与构建知识**
 -   `/lumi-init`: 扫描 `raw/` 目录并执行首次 wiki 构建。
--   `/lumi-ingest [path/to/file]`: 把一份新文档导入知识库，在四个检查点（撰写草稿、检查结构、核对来源、保存）暂停以供审阅。
+-   `/lumi-ingest [path/to/file]`: 把一份新文档加入知识库。AI 会先请你审阅草稿；如果没有需要你判断的问题，就会继续完成后续步骤。
 
 **阶段二：查询与维护**
 -   `/lumi-ask [您的问题]`: 基于 `wiki/` 中的完整知识库提问。
@@ -161,13 +161,14 @@ npx skills add https://github.com/tobi/qmd --skill qmd
 | Pack | Skill | 用途 |
 | :--- | :--- | :--- |
 | **Core** | `/lumi-init` | 从 `raw/` 中的所有文件初始化 wiki。 |
-| | `/lumi-ingest` | 阅读一份文档并撰写 wiki 页面。在四个检查点（撰写草稿、检查结构、核对来源、保存）暂停，让你在每一步落地前审阅。可跨会话续接。 |
+| | `/lumi-ingest` | 阅读一份文档并撰写 wiki 页面。AI 会先请你审阅草稿；如果没有需要你判断的问题，就会继续完成后续步骤。可跨会话续接。 |
 | | `/lumi-ask` | 基于整个知识库提问。 |
 | | `/lumi-edit` | 要求手动编辑 wiki 页面。 |
 | | `/lumi-check` | 检查 wiki 中的问题（断链等）。 |
 | | `/lumi-reset` | 安全地删除 wiki 的部分内容。 |
 | | `/lumi-verify` | 核查 wiki 里的笔记是否与引用的来源相符。把可疑之处报告给你审阅；不会替你修改笔记。 |
 | **Research**| `/lumi-research-discover` | 发现并排序相关研究论文。 |
+| | `/lumi-research-watchlist` | 帮你选择要定期查找的研究主题。 |
 | | `/lumi-research-survey` | 从现有知识创建综述/调研。 |
 | | `/lumi-research-prefill` | 预先生成基础概念，避免重复。 |
 | | `/lumi-research-setup` | 帮助配置研究工具的 API key。 |
@@ -185,8 +186,8 @@ npx skills add https://github.com/tobi/qmd --skill qmd
 当前版本是 **v0.2**（预览版）。完整计划见 [`ROADMAP.md`](./ROADMAP.md)。主要项目：
 
 **v1.0.0 — 首个稳定版**
-- **每日搜索与获取** — watchlist (`_lumina/config/watchlist.yml`) 按计划运行；来自 arXiv / Semantic Scholar 的新论文自动进入 `raw/discovered/<日期>/`。
-- 新技能 `/lumi-daily`，用于整理上次运行以来刚收集到的内容。
+- **定期查找新资料** — 已保存的研究主题可以按你选择的频率再次检查。
+- 新技能 `/lumi-research-watchlist`，帮助你选择和更新要跟踪的研究主题。
 - 锁定 v0.1 的稳定接口（CLI flags、退出码、schema 字段名）。
 - 跨平台 CI 矩阵（macOS + Linux + Windows，Node 20 + 22）。
 

package/bin/lumina.js

@@ -6,6 +6,7 @@
  * Commands:
  *   lumina install      — scaffold or upgrade a Lumina Wiki workspace
  *   lumina uninstall    — remove Lumina-managed files (preserve wiki/ and raw/)
+ *   lumina discover run — run scheduled discovery once
  *   lumina --version    — print version + optional update check
  *   lumina --help       — print usage
  *
@@ -101,6 +102,7 @@ Examples:
   lumina install --yes
   lumina install --yes --packs core,research,reading --ide-targets claude_code,codex
   lumina install --directory /path/to/project
+  lumina discover run --dry-run
   lumina uninstall
   lumina --version
 `);
@@ -196,6 +198,41 @@ program
     }
   });
 
+// ---------------------------------------------------------------------------
+// discover subcommand
+// ---------------------------------------------------------------------------
+const discover = program
+  .command('discover')
+  .description('scheduled discovery commands');
+
+discover
+  .command('run')
+  .description('run scheduled discovery once')
+  .option('--config <path>', 'watchlist config path')
+  .option('--schedule <value>', 'filter by schedule: manual,daily,weekly,monthly')
+  .option('--source <value>', 'filter by source: arxiv,s2')
+  .option('--limit <number>', 'override per-source fetch limit')
+  .option('--dry-run', 'show what would be written without changing files')
+  .option('--json', 'print machine-readable summary')
+  .action(async (cmdOpts) => {
+    try {
+      const { main } = await import('../src/scripts/discover-runner.mjs');
+      const args = [];
+      if (cmdOpts.config) args.push('--config', cmdOpts.config);
+      if (cmdOpts.schedule) args.push('--schedule', cmdOpts.schedule);
+      if (cmdOpts.source) args.push('--source', cmdOpts.source);
+      if (cmdOpts.limit) args.push('--limit', String(cmdOpts.limit));
+      if (cmdOpts.dryRun) args.push('--dry-run');
+      if (cmdOpts.json) args.push('--json');
+      const code = await main(args);
+      process.exit(code);
+    } catch (err) {
+      console.error(`[error] ${err.message}`);
+      if (process.env.DEBUG) console.error(err.stack);
+      process.exit(err.code === 2 ? 2 : 3);
+    }
+  });
+
 // ---------------------------------------------------------------------------
 // Parse argv
 // ---------------------------------------------------------------------------

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "lumina-wiki",
-  "version": "0.9.0",
+  "version": "1.0.0",
   "description": "Domain-agnostic, multi-IDE wiki scaffolder — Karpathy's LLM-Wiki vision, cross-platform and pack-based.",
   "keywords": [
     "llm-wiki",
@@ -44,6 +44,8 @@
     "src/scripts/lint.mjs",
     "src/scripts/reset.mjs",
     "src/scripts/schemas.mjs",
+    "src/scripts/discover-runner.mjs",
+    "src/scripts/lib/*.mjs",
     "src/skills/**/*.md",
     "src/tools/_env.py",
     "src/tools/extract_pdf.py",
@@ -74,7 +76,7 @@
   "scripts": {
     "test": "npm run test:installer",
     "test:installer": "node --test src/installer/commands.test.js src/installer/fs.test.js src/installer/manifest.test.js src/installer/template-engine.test.js src/installer/update-check.test.js",
-    "test:scripts": "node --test src/scripts/lint.test.mjs src/scripts/reset.test.mjs src/scripts/wiki.test.mjs",
+    "test:scripts": "node --test src/scripts/lint.test.mjs src/scripts/reset.test.mjs src/scripts/wiki.test.mjs src/scripts/discover-runner.test.mjs",
     "test:python": "python3 -m pytest src/tools/tests -q",
     "test:all": "npm run test:installer && npm run test:scripts && npm run test:python",
     "test:fs": "node --test src/installer/fs.test.js",

package/src/installer/commands.js

@@ -240,6 +240,7 @@ export async function installCommand(opts = {}) {
   // 12. Render .env.example (research pack only)
   if (hasResearch) {
     await renderEnvExample(projectRoot);
+    await writeWatchlistTemplate(projectRoot);
   }
 
   // 13. Write .gitignore (only if not exists)
@@ -751,17 +752,17 @@ function buildIdeStub(target, vars) {
   const name = vars.project_name || 'this wiki';
   switch (target) {
     case 'claude_code':
-      return `# Claude Code — Lumina Wiki\n\nYou are the wiki maintainer for **${name}**.\n\nRead \`README.md\` at the project root first — it contains the full schema, page types, link conventions, and skill list for this workspace.\n\nCommunicate with the user in **${vars.communication_language}**. Write wiki pages in **${vars.document_output_language}**.\n`;
+      return `# Claude Code — Lumina Wiki\n\nYou are the wiki maintainer for **${name}**.\n\nRead \`README.md\` at the project root first — it contains the full schema, page types, link conventions, skill list, and user communication rules for this workspace.\n\nCommunicate with the user in **${vars.communication_language}**. Write wiki pages in **${vars.document_output_language}**.\n`;
     case 'codex':
-      return `# AGENTS.md — Lumina Wiki\n\nThis file is the entry point for any CLI agent that reads \`AGENTS.md\` (Codex, Amp, Crush, Goose, Auggie, OpenCode, Kimi Code, Mistral Vibe, and other AGENTS.md-compatible tools).\n\nYou are the wiki maintainer for **${name}**.\n\nRead \`README.md\` at the project root first — it contains the full schema, page types, link conventions, and skill list for this workspace.\n\nCommunicate with the user in **${vars.communication_language}**. Write wiki pages in **${vars.document_output_language}**.\n`;
+      return `# AGENTS.md — Lumina Wiki\n\nThis file is the entry point for any CLI agent that reads \`AGENTS.md\` (Codex, Amp, Crush, Goose, Auggie, OpenCode, Kimi Code, Mistral Vibe, and other AGENTS.md-compatible tools).\n\nYou are the wiki maintainer for **${name}**.\n\nRead \`README.md\` at the project root first — it contains the full schema, page types, link conventions, skill list, and user communication rules for this workspace.\n\nCommunicate with the user in **${vars.communication_language}**. Write wiki pages in **${vars.document_output_language}**.\n`;
     case 'gemini_cli':
-      return `# Gemini CLI — Lumina Wiki\n\nYou are the wiki maintainer for **${name}**.\n\nRead \`README.md\` at the project root first — it contains the full schema, page types, link conventions, and skill list for this workspace.\n\nCommunicate with the user in **${vars.communication_language}**. Write wiki pages in **${vars.document_output_language}**.\n`;
+      return `# Gemini CLI — Lumina Wiki\n\nYou are the wiki maintainer for **${name}**.\n\nRead \`README.md\` at the project root first — it contains the full schema, page types, link conventions, skill list, and user communication rules for this workspace.\n\nCommunicate with the user in **${vars.communication_language}**. Write wiki pages in **${vars.document_output_language}**.\n`;
     case 'cursor':
-      return `---\ndescription: Lumina Wiki workspace rules for Cursor\nglobs: ["**/*.md"]\nalwaysApply: true\n---\n\n# Cursor — Lumina Wiki\n\nYou are the wiki maintainer for **${name}**.\n\nRead \`README.md\` at the project root first — it contains the full schema, page types, link conventions, and skill list for this workspace.\n\nCommunicate with the user in **${vars.communication_language}**. Write wiki pages in **${vars.document_output_language}**.\n`;
+      return `---\ndescription: Lumina Wiki workspace rules for Cursor\nglobs: ["**/*.md"]\nalwaysApply: true\n---\n\n# Cursor — Lumina Wiki\n\nYou are the wiki maintainer for **${name}**.\n\nRead \`README.md\` at the project root first — it contains the full schema, page types, link conventions, skill list, and user communication rules for this workspace.\n\nCommunicate with the user in **${vars.communication_language}**. Write wiki pages in **${vars.document_output_language}**.\n`;
     case 'qwen':
-      return `# Qwen Code — Lumina Wiki\n\nYou are the wiki maintainer for **${name}**.\n\nRead \`README.md\` at the project root first — it contains the full schema, page types, link conventions, and skill list for this workspace.\n\nCommunicate with the user in **${vars.communication_language}**. Write wiki pages in **${vars.document_output_language}**.\n`;
+      return `# Qwen Code — Lumina Wiki\n\nYou are the wiki maintainer for **${name}**.\n\nRead \`README.md\` at the project root first — it contains the full schema, page types, link conventions, skill list, and user communication rules for this workspace.\n\nCommunicate with the user in **${vars.communication_language}**. Write wiki pages in **${vars.document_output_language}**.\n`;
     case 'iflow':
-      return `# iFlow CLI — Lumina Wiki\n\nYou are the wiki maintainer for **${name}**.\n\nRead \`README.md\` at the project root first — it contains the full schema, page types, link conventions, and skill list for this workspace.\n\nCommunicate with the user in **${vars.communication_language}**. Write wiki pages in **${vars.document_output_language}**.\n`;
+      return `# iFlow CLI — Lumina Wiki\n\nYou are the wiki maintainer for **${name}**.\n\nRead \`README.md\` at the project root first — it contains the full schema, page types, link conventions, skill list, and user communication rules for this workspace.\n\nCommunicate with the user in **${vars.communication_language}**. Write wiki pages in **${vars.document_output_language}**.\n`;
     default:
       return null;
   }
@@ -769,7 +770,7 @@ function buildIdeStub(target, vars) {
 
 async function copyScripts(projectRoot) {
   const destDir = join(projectRoot, '_lumina', 'scripts');
-  const scriptFiles = ['wiki.mjs', 'lint.mjs', 'reset.mjs', 'schemas.mjs'];
+  const scriptFiles = ['wiki.mjs', 'lint.mjs', 'reset.mjs', 'schemas.mjs', 'discover-runner.mjs'];
   for (const file of scriptFiles) {
     const src = join(SCRIPTS_DIR, file);
     const dest = join(destDir, file);
@@ -779,6 +780,17 @@ async function copyScripts(projectRoot) {
       // Scripts may not exist yet (P4+ work); skip gracefully
     }
   }
+  const libFiles = ['watchlist-config.mjs', 'discovery-state.mjs'];
+  for (const file of libFiles) {
+    const src = join(SCRIPTS_DIR, 'lib', file);
+    const dest = join(destDir, 'lib', file);
+    try {
+      await ensureDir(dirname(dest));
+      await copyFile(src, dest);
+    } catch (_) {
+      // Script libs may not exist yet; skip gracefully
+    }
+  }
 }
 
 async function copyChangelog(projectRoot) {
@@ -856,6 +868,7 @@ function getSkillDefs(packs) {
       { name: 'survey',   canonicalId: 'lumi-research-survey',   displayName: '/lumi-research-survey' },
       { name: 'prefill',  canonicalId: 'lumi-research-prefill',  displayName: '/lumi-research-prefill' },
       { name: 'setup',    canonicalId: 'lumi-research-setup',    displayName: '/lumi-research-setup' },
+      { name: 'watchlist', canonicalId: 'lumi-research-watchlist', displayName: '/lumi-research-watchlist' },
     ];
     for (const s of researchSkills) {
       defs.push({ ...s, pack: 'research', srcPackPath: 'packs/research' });
@@ -937,6 +950,34 @@ async function renderEnvExample(projectRoot) {
   await atomicWrite(destPath, content);
 }
 
+async function writeWatchlistTemplate(projectRoot) {
+  const destPath = join(projectRoot, '_lumina', 'config', 'watchlist.yml');
+  let exists = false;
+  try {
+    await access(destPath, fsConstants.F_OK);
+    exists = true;
+  } catch (_) {}
+  if (exists) return;
+
+  const templatePath = join(TEMPLATES_DIR, '_lumina', 'config', 'watchlist.yml');
+  let content;
+  try {
+    content = await readFile(templatePath, 'utf8');
+  } catch (_) {
+    content = [
+      'version: 1',
+      'defaults:',
+      '  sources: [arxiv]',
+      '  schedule: weekly',
+      '  limit: 20',
+      '  max_new: 5',
+      'items: []',
+      '',
+    ].join('\n');
+  }
+  await atomicWrite(destPath, content);
+}
+
 async function writeGitignore(projectRoot) {
   const gitignorePath = join(projectRoot, '.gitignore');
   let exists = false;