lumina-wiki 0.1.0 → 0.3.0

package/README.md

@@ -4,7 +4,9 @@
 
 # Lumina-Wiki
 
-> **The LLM-maintained Knowledge Artifact for Technical Research.**
+> **Where Knowledge Starts to Glow.**
+>
+> The LLM-maintained Knowledge Artifact for Technical Research.
 
 Lumina-Wiki is a ready-to-use implementation of the **[LLM-Wiki vision](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f)** articulated by **Andrej Karpathy, founding member of OpenAI and former Director of AI at Tesla.**
 
@@ -161,7 +163,25 @@ These are the scripts that the agent's skills use to perform actions.
 
 ---
 
-## 6. Contributing & License
+## 6. What's Coming Next
+
+The current release is **v0.2** (preview). The full plan lives in [`ROADMAP.md`](./ROADMAP.md). Headline items:
+
+**v1.0.0 — First Stable**
+- **Daily search & fetch** — watchlist queries (`_lumina/config/watchlist.yml`) run on a cadence; new arXiv / Semantic Scholar hits land in `raw/discovered/<date>/` automatically.
+- New `/lumi-daily` skill to triage what landed since last run.
+- Stability lock for the v0.1 surface (CLI flags, exit codes, schema field names).
+- Cross-platform CI matrix (macOS + Linux + Windows, Node 20 + 22).
+
+**v2.0.0 — Research Pack Source Expansion**
+- **New paper sources:** OpenAlex, Unpaywall, CORE (Priority 1) → OpenReview, Hugging Face Papers, Papers With Code (Priority 2) → Crossref, DOAJ, research-blog RSS (Priority 3).
+- **Paper ranking:** new `/lumi-rank` skill surfacing influential-citation count, field-normalized citation rank, Scite support/contrast tally, and Altmetric attention — all into a `ranking:` block on the paper's frontmatter.
+
+**Want to help?** Pick any unchecked item in `ROADMAP.md`, open an issue to claim it, then send a PR. Source fetchers all follow the same pattern in `src/tools/` (CLI + JSON, no async, exit codes `0/2/3`) so they're a friendly first contribution. See the local-dev steps below.
+
+---
+
+## 7. Contributing & License
 
 <details>
 <summary>🛠️ Local Development (for contributors)</summary>
@@ -186,6 +206,10 @@ npm run test:all
 <a name="vietnamese"></a>
 ***README Tiếng Việt***
 
+> **Where Knowledge Starts to Glow.**
+>
+> Khối Tri thức được duy trì bởi LLM dành cho nghiên cứu kỹ thuật.
+
 ## 1. Luồng làm việc cốt lõi
 
 Lumina-Wiki hoạt động dựa trên một nguyên tắc đơn giản: tách biệt tài liệu thô của bạn khỏi khối kiến thức có cấu trúc của AI.
@@ -318,7 +342,25 @@ Lumina tạo ra một không gian làm việc với mục đích rõ ràng cho t
 
 ---
 
-## 6. Đóng góp & Giấy phép
+## 6. Lộ trình sắp tới
+
+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.
+- 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.
+
+**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, không 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.
+
+---
+
+## 7. Đóng góp & Giấy phép
 
 <details>
 <summary>🛠️ Phát triển cục bộ (dành cho người đóng góp)</summary>

package/bin/lumina.js

@@ -10,7 +10,8 @@
  *   lumina --help       — print usage
  *
  * Flags (all commands):
- *   --cwd <path>        — operate against a different project root
+ *   --directory <path>  — installation directory (defaults to current directory)
+ *   --cwd <path>        — backward-compat alias for --directory
  *   --yes, -y           — accept all defaults (non-interactive / CI)
  *   --no-update         — skip npm registry version check
  *   --re-link           — recompute symlink/junction/copy strategy
@@ -71,7 +72,7 @@ async function handleVersionOptionIfPresent(argv) {
 const handledVersion = await handleVersionOptionIfPresent(process.argv);
 if (handledVersion) process.exit(0);
 
-const { Command } = await import('commander');
+const { Command, Option } = await import('commander');
 const program = new Command();
 
 program
@@ -86,18 +87,20 @@ Exit codes:
   3  upgrade incompatibility (manifest references unknown pack)
 
 Flags applicable to all commands:
-  --cwd <path>     project root (defaults to current directory)
-  --yes, -y        accept all defaults; non-interactive (CI use)
-  --no-update      skip npm registry version check
-  --re-link        recompute symlink/junction/copy strategy from platform
-  --packs <list>   install packs: core,research,reading
-  --ide-targets <list>  target IDEs: claude_code,codex,cursor,gemini_cli,generic
+  --directory <path>  installation directory (defaults to current directory)
+  --yes, -y           accept all defaults; non-interactive (CI use)
+  --no-update         skip npm registry version check
+  --re-link           recompute symlink/junction/copy strategy from platform
+  --packs <list>      install packs: core,research,reading
+  --ide-targets <list>  target CLIs: claude_code,codex,gemini_cli,qwen,iflow,cursor,generic
+                          codex covers all AGENTS.md-compatible CLIs
+                          (Codex, Amp, Crush, Goose, Auggie, OpenCode, etc.)
 
 Examples:
   npx lumina-wiki install
   lumina install --yes
   lumina install --yes --packs core,research,reading --ide-targets claude_code,codex
-  lumina install --cwd /path/to/project
+  lumina install --directory /path/to/project
   lumina uninstall
   lumina --version
 `);
@@ -106,7 +109,8 @@ Examples:
 // Global options
 // ---------------------------------------------------------------------------
 program
-  .option('--cwd <path>', 'project root directory', process.cwd())
+  .option('--directory <path>', 'installation directory', process.cwd())
+  .addOption(new Option('--cwd <path>', 'alias for --directory').hideHelp())
   .option('-y, --yes', 'accept all defaults (non-interactive)')
   .option('--no-update', 'skip npm registry version check')
   .option('--re-link', 'recompute symlink strategy from current platform capabilities');
@@ -124,26 +128,29 @@ program
 program
   .command('install')
   .description('scaffold or upgrade a Lumina Wiki workspace')
-  .option('--cwd <path>', 'project root directory')
+  .option('--directory <path>', 'installation directory')
+  .addOption(new Option('--cwd <path>', 'alias for --directory').hideHelp())
   .option('-y, --yes', 'accept all defaults')
   .option('--no-update', 'skip update check')
   .option('--re-link', 'recompute symlink strategy')
   .option('--packs <list>', 'comma-separated packs to install: core,research,reading')
   .option('--ide-targets <list>', 'comma-separated IDE targets')
-  .option('--project-name <name>', 'project name for non-interactive install')
+  .addOption(new Option('--project-name <name>', 'override auto-derived project name').hideHelp())
   .option('--communication-language <language>', 'language agents use when talking to the user')
   .option('--document-output-language <language>', 'language used for wiki documents')
   .action(async (cmdOpts) => {
     const globalOpts = program.opts();
-    const mergedCwd      = cmdOpts.cwd      ?? globalOpts.cwd      ?? process.cwd();
+    const mergedDir      = cmdOpts.directory ?? cmdOpts.cwd ?? globalOpts.directory ?? globalOpts.cwd ?? process.cwd();
     const mergedYes      = cmdOpts.yes      ?? globalOpts.yes      ?? false;
     const mergedReLink   = cmdOpts.reLink   ?? globalOpts.reLink   ?? false;
     const mergedNoUpdate = cmdOpts.noUpdate ?? globalOpts.noUpdate ?? false;
 
     try {
+      const { displayBanner } = await import('../src/installer/banner.js');
+      await displayBanner();
       const { installCommand } = await import('../src/installer/commands.js');
       await installCommand({
-        cwd:      resolve(mergedCwd),
+        directory: resolve(mergedDir),
         yes:      Boolean(mergedYes),
         reLink:   Boolean(mergedReLink),
         noUpdate: Boolean(mergedNoUpdate),
@@ -168,17 +175,18 @@ program
 program
   .command('uninstall')
   .description('remove Lumina-managed files (wiki/ and raw/ are preserved)')
-  .option('--cwd <path>', 'project root directory')
+  .option('--directory <path>', 'installation directory')
+  .addOption(new Option('--cwd <path>', 'alias for --directory').hideHelp())
   .option('-y, --yes', 'skip confirmation prompt')
   .action(async (cmdOpts) => {
     const globalOpts = program.opts();
-    const mergedCwd = cmdOpts.cwd ?? globalOpts.cwd ?? process.cwd();
+    const mergedDir = cmdOpts.directory ?? cmdOpts.cwd ?? globalOpts.directory ?? globalOpts.cwd ?? process.cwd();
     const mergedYes = cmdOpts.yes ?? globalOpts.yes ?? false;
 
     try {
       const { uninstallCommand } = await import('../src/installer/commands.js');
       await uninstallCommand({
-        cwd: resolve(mergedCwd),
+        cwd: resolve(mergedDir),
         yes: Boolean(mergedYes),
       });
     } catch (err) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "lumina-wiki",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Domain-agnostic, multi-IDE wiki scaffolder — Karpathy's LLM-Wiki vision, cross-platform and pack-based.",
   "keywords": [
     "llm-wiki",
@@ -32,6 +32,7 @@
   },
   "files": [
     "bin/lumina.js",
+    "src/installer/banner.js",
     "src/installer/commands.js",
     "src/installer/fs.js",
     "src/installer/manifest.js",
@@ -45,6 +46,7 @@
     "src/scripts/schemas.mjs",
     "src/skills/**/*.md",
     "src/tools/_env.py",
+    "src/tools/extract_pdf.py",
     "src/tools/discover.py",
     "src/tools/init_discovery.py",
     "src/tools/prepare_source.py",
@@ -79,7 +81,9 @@
     "test:update": "node --test src/installer/update-check.test.js",
     "ci:idempotency": "node scripts/ci-idempotency.mjs",
     "ci:package": "node scripts/ci-package.mjs",
-    "pack:check": "npm run ci:package"
+    "pack:check": "npm run ci:package",
+    "dev:install": "node bin/lumina.js install",
+    "dev:sandbox": "node scripts/dev-sandbox.mjs"
   },
   "publishConfig": {
     "access": "public"

package/src/installer/banner.js

@@ -0,0 +1,83 @@
+/**
+ * @module installer/banner
+ * @description Render the Lumina Wiki install banner (logo + tagline + intro).
+ *
+ * Uses raw ANSI escape codes so the yellow logo renders consistently across
+ * all terminals that support colour, regardless of TTY detection quirks in
+ * subshells. Respects NO_COLOR by emitting plain text.
+ *
+ * Narrow terminals (<80 cols) get a compact fallback so lines do not wrap.
+ */
+
+const NO_COLOR = Boolean(process.env.NO_COLOR);
+
+const ANSI = {
+  reset:  NO_COLOR ? '' : '\x1b[0m',
+  yellow: NO_COLOR ? '' : '\x1b[33m',
+  bright: NO_COLOR ? '' : '\x1b[93m',
+  dim:    NO_COLOR ? '' : '\x1b[2m',
+};
+
+const yellow = (s) => `${ANSI.bright}${s}${ANSI.reset}`;
+const dim    = (s) => `${ANSI.dim}${s}${ANSI.reset}`;
+
+const LOGO_WIDE = [
+  '██╗     ██╗   ██╗███╗   ███╗██╗███╗   ██╗ █████╗   ██╗    ██╗██╗██╗  ██╗██╗',
+  '██║     ██║   ██║████╗ ████║██║████╗  ██║██╔══██╗  ██║    ██║██║██║ ██╔╝██║',
+  '██║     ██║   ██║██╔████╔██║██║██╔██╗ ██║███████║  ██║ █╗ ██║██║█████╔╝ ██║',
+  '██║     ██║   ██║██║╚██╔╝██║██║██║╚██╗██║██╔══██║  ██║███╗██║██║██╔═██╗ ██║',
+  '███████╗╚██████╔╝██║ ╚═╝ ██║██║██║ ╚████║██║  ██║  ╚███╔███╔╝██║██║  ██╗██║',
+  '╚══════╝ ╚═════╝ ╚═╝     ╚═╝╚═╝╚═╝  ╚═══╝╚═╝  ╚═╝   ╚══╝╚══╝ ╚═╝╚═╝  ╚═╝╚═╝',
+];
+
+const LOGO_NARROW = [
+  '██╗     ██╗   ██╗███╗   ███╗██╗███╗   ██╗ █████╗ ',
+  '██║     ██║   ██║████╗ ████║██║████╗  ██║██╔══██╗',
+  '██║     ██║   ██║██╔████╔██║██║██╔██╗ ██║███████║',
+  '██║     ██║   ██║██║╚██╔╝██║██║██║╚██╗██║██╔══██║',
+  '███████╗╚██████╔╝██║ ╚═╝ ██║██║██║ ╚████║██║  ██║',
+  '╚══════╝ ╚═════╝ ╚═╝     ╚═╝╚═╝╚═╝  ╚═══╝╚═╝  ╚═╝',
+];
+
+const SEPARATOR = '━'.repeat(72);
+
+/**
+ * Print the install-time banner to stdout.
+ * Safe to call unconditionally; respects NO_COLOR.
+ *
+ * @returns {Promise<void>}
+ */
+export async function displayBanner() {
+  const termWidth = process.stdout.columns || 80;
+  const lines = termWidth >= 80 ? LOGO_WIDE : LOGO_NARROW;
+
+  process.stdout.write('\n');
+  for (const line of lines) {
+    process.stdout.write(yellow(line) + '\n');
+  }
+  process.stdout.write('\n');
+  process.stdout.write('             ' + yellow('Where Knowledge Starts to Glow') + '\n');
+  process.stdout.write(dim('             © Lumina Wiki') + '\n');
+  process.stdout.write('\n');
+  process.stdout.write(dim(SEPARATOR) + '\n\n');
+
+  process.stdout.write(
+    'A self-maintaining research wiki, scaffolded into your project in one\n' +
+    'command. Realises Karpathy\'s LLM-Wiki pattern: the agent compiles\n' +
+    'knowledge into a persistent, structured wiki instead of re-deriving it\n' +
+    'from raw chunks on every query. Cross-platform, multi-IDE, pack-based.\n\n'
+  );
+
+  process.stdout.write(yellow('🌟 100% free. 100% open source. Always.') + '\n');
+  process.stdout.write('   No paywalls. No gated content. Knowledge shared, not sold.\n\n');
+
+  process.stdout.write(yellow('🌐 CONNECT:') + '\n');
+  process.stdout.write('   GitHub:   https://github.com/tronghieu/lumina-wiki\n');
+  process.stdout.write('   Issues:   https://github.com/tronghieu/lumina-wiki/issues\n');
+  process.stdout.write('   npm:      https://www.npmjs.com/package/lumina-wiki\n\n');
+
+  process.stdout.write(yellow('⭐ SUPPORT THE PROJECT:') + '\n');
+  process.stdout.write('   Star us:  https://github.com/tronghieu/lumina-wiki\n\n');
+
+  process.stdout.write(dim(SEPARATOR) + '\n\n');
+}

package/src/installer/commands.js

@@ -115,12 +115,12 @@ const LUMINA_DIRS = [
   '_lumina/config',
   '_lumina/schema',
   '_lumina/scripts',
+  '_lumina/tools',
   '_lumina/_state',
 ];
-const RESEARCH_LUMINA_DIRS = ['_lumina/tools'];
 
 const VALID_PACKS = new Set(['core', 'research', 'reading']);
-const VALID_IDE_TARGETS = new Set(['claude_code', 'codex', 'cursor', 'gemini_cli', 'generic']);
+const VALID_IDE_TARGETS = new Set(['claude_code', 'codex', 'cursor', 'gemini_cli', 'qwen', 'iflow', 'generic']);
 
 // ---------------------------------------------------------------------------
 // install command
@@ -128,22 +128,24 @@ const VALID_IDE_TARGETS = new Set(['claude_code', 'codex', 'cursor', 'gemini_cli
 
 /**
  * @param {object} opts
- * @param {string}  opts.cwd           - Project root
+ * @param {string}  [opts.directory]   - Installation directory (BMAD-style canonical flag)
+ * @param {string}  [opts.cwd]         - Backward-compat alias for `directory`
  * @param {boolean} opts.yes           - Accept defaults (--yes)
  * @param {boolean} opts.reLink        - Force re-compute symlink strategy
  * @param {boolean} opts.noUpdate      - Skip update check
  * @param {string|string[]} [opts.packs] - Pack override for non-interactive installs
  * @param {string|string[]} [opts.ideTargets] - IDE target override
- * @param {string} [opts.projectName]
+ * @param {string} [opts.projectName]  - Hidden escape hatch; default = basename(directory)
  * @param {string} [opts.communicationLang]
  * @param {string} [opts.documentOutputLang]
  */
 export async function installCommand(opts = {}) {
-  const { cwd = process.cwd(), yes = false, reLink = false } = opts;
-  const projectRoot = resolve(cwd);
+  const { yes = false, reLink = false } = opts;
+  const initialDir = opts.directory ?? opts.cwd ?? process.cwd();
+  let projectRoot = resolve(initialDir);
   const colors = await getColorFns();
 
-  // 1. Read existing manifest
+  // 1. Read existing manifest at the initial path (upgrade detection)
   let existingManifest = null;
   try {
     existingManifest = await readManifest(projectRoot);
@@ -161,6 +163,10 @@ export async function installCommand(opts = {}) {
     answers = await readAnswersFromConfig(projectRoot, existingManifest);
   } else {
     answers = await runInstallPrompts({ acceptDefaults: yes, cwd: projectRoot });
+    // Re-resolve projectRoot from the directory the user typed.
+    if (answers.directory) {
+      projectRoot = resolve(answers.directory);
+    }
   }
   answers = applyInstallOverrides(answers, opts);
 
@@ -180,15 +186,13 @@ export async function installCommand(opts = {}) {
     ...CORE_WIKI_DIRS,
     ...CORE_RAW_DIRS,
     ...LUMINA_DIRS,
-    '.agents/skills/core',
+    '.agents/skills',
   ];
   if (hasResearch) {
-    dirsToCreate.push(...RESEARCH_WIKI_DIRS, ...RESEARCH_RAW_DIRS, ...RESEARCH_LUMINA_DIRS);
-    dirsToCreate.push('.agents/skills/packs/research');
+    dirsToCreate.push(...RESEARCH_WIKI_DIRS, ...RESEARCH_RAW_DIRS);
   }
   if (hasReading) {
     dirsToCreate.push(...READING_WIKI_DIRS);
-    dirsToCreate.push('.agents/skills/packs/reading');
   }
 
   for (const dir of dirsToCreate) {
@@ -222,10 +226,8 @@ export async function installCommand(opts = {}) {
   // 9. Copy skills
   const skillRows = await copySkills(projectRoot, packs);
 
-  // 10. Copy Python tools (research pack)
-  if (hasResearch) {
-    await copyTools(projectRoot);
-  }
+  // 10. Copy Python tools (core: extract_pdf; research pack: discovery/fetchers)
+  await copyTools(projectRoot, { research: hasResearch });
 
   // 11. Render schema docs
   await renderSchemaDocs(projectRoot, templateVars);
@@ -410,7 +412,8 @@ async function readAnswersFromConfig(projectRoot, existingManifest) {
       .map(([k]) => k);
 
     return {
-      projectName:        config.project_name || 'My Wiki',
+      directory:          projectRoot,
+      projectName:        config.project_name || basename(projectRoot),
       researchPurpose:    '',
       ideTargets:         ideTargets.length ? ideTargets : ['claude_code'],
       packs:              packs.length ? packs : ['core'],
@@ -422,7 +425,8 @@ async function readAnswersFromConfig(projectRoot, existingManifest) {
     const ideTargets = existingManifest?.ideTargets ?? ['claude_code'];
     const packs = Object.keys(existingManifest?.packs ?? { core: true });
     return {
-      projectName:        'My Wiki',
+      directory:          projectRoot,
+      projectName:        basename(projectRoot),
       researchPurpose:    '',
       ideTargets,
       packs:              packs.length ? packs : ['core'],
@@ -497,6 +501,8 @@ async function renderAndWriteConfig(projectRoot, templateVars, answers) {
       codex:       answers.ideTargets.includes('codex'),
       cursor:      answers.ideTargets.includes('cursor'),
       gemini_cli:  answers.ideTargets.includes('gemini_cli'),
+      qwen:        answers.ideTargets.includes('qwen'),
+      iflow:       answers.ideTargets.includes('iflow'),
       generic:     answers.ideTargets.includes('generic'),
     },
     packs: {
@@ -627,6 +633,8 @@ function ideTargetFilePath(projectRoot, target) {
     case 'codex':       return join(projectRoot, 'AGENTS.md');
     case 'gemini_cli':  return join(projectRoot, 'GEMINI.md');
     case 'cursor':      return join(projectRoot, '.cursor', 'rules', 'lumina.mdc');
+    case 'qwen':        return join(projectRoot, 'QWEN.md');
+    case 'iflow':       return join(projectRoot, 'IFLOW.md');
     case 'generic':     return null; // No stub needed; README.md is the entry point
     default:            return null;
   }
@@ -640,6 +648,8 @@ function ideTargetStubFiles(ideTargets) {
         case 'codex':       return 'AGENTS.md';
         case 'gemini_cli':  return 'GEMINI.md';
         case 'cursor':      return '.cursor/rules/lumina.mdc';
+        case 'qwen':        return 'QWEN.md';
+        case 'iflow':       return 'IFLOW.md';
         default:            return null;
       }
     })
@@ -652,11 +662,15 @@ function buildIdeStub(target, vars) {
     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`;
     case 'codex':
-      return `# Codex — 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 `# 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`;
     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`;
     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`;
+    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`;
+    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`;
     default:
       return null;
   }
@@ -681,9 +695,9 @@ async function copySkills(projectRoot, packs) {
   const skillDefs = getSkillDefs(packs);
 
   for (const skill of skillDefs) {
-    // packPath uses forward slashes — join handles OS differences
-    const srcDir = join(SKILLS_DIR, ...skill.packPath.split('/'), skill.name);
-    const destDir = join(projectRoot, '.agents', 'skills', ...skill.packPath.split('/'), skill.name);
+    // srcPackPath uses forward slashes — join handles OS differences
+    const srcDir = join(SKILLS_DIR, ...skill.srcPackPath.split('/'), skill.name);
+    const destDir = join(projectRoot, '.agents', 'skills', skill.canonicalId);
 
     await access(join(srcDir, 'SKILL.md'), fsConstants.F_OK);
     await rm(destDir, { recursive: true, force: true });
@@ -695,7 +709,7 @@ async function copySkills(projectRoot, packs) {
       display_name:    skill.displayName,
       pack:            skill.pack,
       source:          'built-in',
-      relative_path:   ['.agents', 'skills', skill.packPath, skill.name].join('/'),
+      relative_path:   `.agents/skills/${skill.canonicalId}`,
       target_link_path: join('.claude', 'skills', skill.canonicalId),
       version:         PKG.version,
     });
@@ -729,43 +743,45 @@ function getSkillDefs(packs) {
       { name: 'reset',   canonicalId: 'lumi-reset',   displayName: '/lumi-reset' },
     ];
     for (const s of coreSkills) {
-      defs.push({ ...s, pack: 'core', packPath: 'core' });
+      defs.push({ ...s, pack: 'core', srcPackPath: 'core' });
     }
   }
 
   if (packs.includes('research')) {
     const researchSkills = [
-      { name: 'discover', canonicalId: 'lumi-discover', displayName: '/lumi-discover' },
-      { name: 'survey',   canonicalId: 'lumi-survey',   displayName: '/lumi-survey' },
-      { name: 'prefill',  canonicalId: 'lumi-prefill',  displayName: '/lumi-prefill' },
-      { name: 'setup',    canonicalId: 'lumi-setup',    displayName: '/lumi-setup' },
+      { name: 'discover', canonicalId: 'lumi-research-discover', displayName: '/lumi-research-discover' },
+      { 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' },
     ];
     for (const s of researchSkills) {
-      defs.push({ ...s, pack: 'research', packPath: 'packs/research' });
+      defs.push({ ...s, pack: 'research', srcPackPath: 'packs/research' });
     }
   }
 
   if (packs.includes('reading')) {
     const readingSkills = [
-      { name: 'chapter-ingest',   canonicalId: 'lumi-chapter-ingest',   displayName: '/lumi-chapter-ingest' },
-      { name: 'character-track',  canonicalId: 'lumi-character-track',  displayName: '/lumi-character-track' },
-      { name: 'theme-map',        canonicalId: 'lumi-theme-map',        displayName: '/lumi-theme-map' },
-      { name: 'plot-recap',       canonicalId: 'lumi-plot-recap',       displayName: '/lumi-plot-recap' },
+      { name: 'chapter-ingest',   canonicalId: 'lumi-reading-chapter-ingest',   displayName: '/lumi-reading-chapter-ingest' },
+      { name: 'character-track',  canonicalId: 'lumi-reading-character-track',  displayName: '/lumi-reading-character-track' },
+      { name: 'theme-map',        canonicalId: 'lumi-reading-theme-map',        displayName: '/lumi-reading-theme-map' },
+      { name: 'plot-recap',       canonicalId: 'lumi-reading-plot-recap',       displayName: '/lumi-reading-plot-recap' },
     ];
     for (const s of readingSkills) {
-      defs.push({ ...s, pack: 'reading', packPath: 'packs/reading' });
+      defs.push({ ...s, pack: 'reading', srcPackPath: 'packs/reading' });
     }
   }
 
   return defs;
 }
 
-async function copyTools(projectRoot) {
+async function copyTools(projectRoot, { research }) {
   const destDir = join(projectRoot, '_lumina', 'tools');
-  const toolFiles = [
+  const coreTools = ['extract_pdf.py'];
+  const researchTools = [
     '_env.py', 'discover.py', 'init_discovery.py', 'prepare_source.py',
     'fetch_arxiv.py', 'fetch_wikipedia.py', 'fetch_s2.py', 'fetch_deepxiv.py',
   ];
+  const toolFiles = research ? [...coreTools, ...researchTools] : coreTools;
   for (const file of toolFiles) {
     const src = join(TOOLS_DIR, file);
     const dest = join(destDir, file);
@@ -775,6 +791,11 @@ async function copyTools(projectRoot) {
       // Tool not yet authored; skip
     }
   }
+  try {
+    await copyFile(join(TOOLS_DIR, 'requirements.txt'), join(destDir, 'requirements.txt'));
+  } catch (_) {
+    // requirements.txt missing in dev; skip
+  }
 }
 
 async function renderSchemaDocs(projectRoot, templateVars) {
@@ -880,6 +901,8 @@ async function buildFilesManifest(projectRoot, packs, pkgVersion) {
     'CLAUDE.md',
     'AGENTS.md',
     'GEMINI.md',
+    'QWEN.md',
+    'IFLOW.md',
     '.cursor/rules/lumina.mdc',
   ];