project-librarian 0.2.0 → 0.2.1

package/README.zh.md

@@ -5,7 +5,7 @@
 [![Node.js](https://img.shields.io/badge/Node.js-%3E%3D22.13-brightgreen.svg)](https://nodejs.org/)
 [![代码依据索引](https://img.shields.io/badge/code%20evidence-node%3Asqlite-blue.svg)](https://nodejs.org/api/sqlite.html)
 
-面向 Codex 和 Claude Code 的简洁项目记忆与代码依据。
+面向 Codex、Claude Code、Cursor 和 Gemini CLI 的简洁项目记忆与代码依据。
 
 Project Librarian 会创建仓库本地规划 wiki、简洁启动 hook，以及可选 SQLite 代码依据索引。代理可以从项目计划开始，被路由到正确文档，并在不反复扫描整个仓库的情况下查看由代码支撑的依据。
 
@@ -21,7 +21,8 @@ Project Librarian 给代理两个本地事实来源。
 | --- | --- |
 | `wiki/startup.md` + `wiki/index.md` | 简短的会话启动摘要和路由器，只读取相关规划页面。 |
 | `wiki/canonical/` 和 `wiki/decisions/` | 当前项目事实、约束、风险、包契约、CLI 行为和持久决策。 |
-| `.codex/` 和 `.claude/` hooks | 不加载整个 wiki 的 Codex/Claude Code 启动上下文。 |
+| `.codex/`、`.claude/`、`.cursor/` 和 `.gemini/` hooks | 不加载整个 wiki 的 Codex/Claude Code/Cursor/Gemini CLI 启动上下文。 |
+| `GEMINI.md` 和 `.cursor/rules/` | 将 Gemini CLI 和 Cursor 路由到同一个紧凑 wiki-first 契约的 instruction 文件。 |
 | `.project-wiki/code-evidence.sqlite` | 可再生成的代码依据，用于文件、符号、import、route、所有权、工作区图、报告和影响检查。 |
 | 诊断和迁移模式 | 链接检查、质量检查、迁移收件箱、过期信号报告，以及工作流暴露问题时的 issue draft。 |
 
@@ -31,64 +32,41 @@ Project Librarian 给代理两个本地事实来源。
 
 基准是维护者发布依据，不是公开用户工作流。它让 README 和发布说明用有边界的数字说明价值，而不是使用模糊性能描述。
 
-最新 clean 大规模报告：`benchmarks/reports/current-large.json`，生成于 2026-06-09T08:08:07.238Z，Node v22.19.0，darwin arm64，Apple M4 Pro，commit `18e730882c4f`，5 次测量运行和 1 次丢弃的预热运行。时间测量状态为 `stable`；unstable metrics 为 `none`；git 状态指纹为 clean。
-
-| 指标 | 结果 |
-| --- | ---: |
-| Markdown 上下文估算避免量中位数 | 99.61% |
-| Markdown 上下文估算避免量最小值 | 99.43% |
-| 读取时间降低中位数 | 99.47% |
-| 读取时间降低最小值 | 99.26% |
-| 测量的 wiki 页面 | 1,601 |
-| 代码索引文件 | 1,608 |
-| 代码索引时间 | 336.312ms |
-| 代码索引吞吐量 | 4,781.27 files/sec |
-| 增量索引时间 | 186.776ms |
-| 全量到增量的时间降低 | 45.52% |
-| 架构报告时间 | 251.175ms |
-| 架构报告依据表 | 6 |
-| 架构报告 route | 24 |
-| 样本仓库 | 3 |
-| 基准运行 | 5 |
-| 预热运行 | 1 |
-| 时间测量状态 | stable |
-| 不稳定指标 | none |
-
-场景摘要：
-
-| 场景 | 规模 | 结果 |
-| --- | ---: | --- |
-| 文档密集 wiki | 500页 | 99.74% Markdown 上下文估算避免，99.47% 读取降低，43.83ms query |
-| Monorepo wiki | 320页 | 99.43% Markdown 上下文估算避免，99.26% 读取降低，81.12ms doctor |
-| 分范围路由 wiki | 720页 | 99.61% Markdown 上下文估算避免，99.55% 读取降低，67.684ms refresh |
-| 代码密集混合索引 | 1,608个文件 | 336.312ms 全量索引，186.776ms 增量，251.175ms 报告，626.969ms Tree-sitter 索引 |
-| 样本仓库验证 | 3个仓库、16个文件 | 132.363ms 代码索引中位数，135.694ms 架构报告中位数 |
-
-声明边界：token 估算值是使用 `ceil(characters / 4)` 得到的 Markdown 上下文大小估算。它不是模型 tokenizer 输出，也不是 API 计费计数器，更不是实际 LLM token 使用量。基准比较 targeted retrieval 读取的 wiki 上下文，相比读取 fixture 中所有 wiki Markdown 文件的 naive full-wiki scan，能避免多少 Markdown 上下文输入。代码索引指标是在生成/样本仓库上测得的本地 CLI 子进程时间。
+当前本地测量报告：`benchmarks/reports/llm/current-local.json` 和 `benchmarks/reports/llm/current-local.md`，生成于 2026-06-10，ChatGPT/Codex auth，`gpt-5.5`，`decision_lookup`，每个条件 1 次测量运行，无预热。以下值是真实 Codex JSONL usage 和本地 wall-clock 测量。正 delta 表示 Project Librarian 条件比 no-Project-Librarian control 使用更多。
+
+| Scale | 未使用 Project Librarian | 使用 Project Librarian | 实测 delta |
+| --- | ---: | ---: | ---: |
+| Small | total 102,655 tokens; input 101,226; 37.15s; command 9次 | total 176,104 tokens; input 173,733; 61.04s; command 15次 | tokens +71.55%; time +64.33%; commands +66.67% |
+| Medium | total 79,340 tokens; input 78,348; 44.28s; command 5次 | total 165,840 tokens; input 163,856; 48.48s; command 10次 | tokens +109.02%; time +9.5%; commands +100% |
+| Large | total 197,097 tokens; input 195,278; 45.87s; command 10次 | total 183,959 tokens; input 181,897; 49.42s; command 13次 | tokens -6.67%; time +7.72%; commands +30% |
+
+声明边界：这次经批准的本地运行通过了 benchmark claim gate，但不是 clean release baseline。它基于 dirty worktree、每个条件只运行 1 次，而且 runtime state files 触碰了生成的 fixture 目录，因此 post-run fixture fingerprint validator 需要 clean isolated rerun。在重复的 clean actual-LLM 运行显示稳定 delta 前，不声明 Project Librarian 改善 token 或时间。
 
 ## 安装
 
 只在初始 skill 安装时使用 `npx`。
 
 ```bash
-npx project-librarian install-skill --scope user --agents both
+npx project-librarian install-skill --scope user --agents all
 ```
 
 安装到当前仓库:
 
 ```bash
-npx project-librarian install-skill --scope project --agents both
+npx project-librarian install-skill --scope project --agents all
 ```
 
-`install-skill` 只复制可复用的 skill 文件。它不会创建或更新 `AGENTS.md`、`CLAUDE.md`、`wiki/`、`.codex/hooks.json` 或 `.claude/settings.json`。
+`install-skill` 只复制可复用的 skill 文件。它不会创建或更新 `AGENTS.md`、`CLAUDE.md`、`GEMINI.md`、`wiki/`、`.cursor/rules/`、`.cursor/hooks.json`、`.gemini/settings.json`、`.codex/hooks.json` 或 `.claude/settings.json`。
 
 | 场景 | 命令 |
 | --- | --- |
-| 为 Codex 和 Claude Code 全局安装 | `npx project-librarian install-skill --scope user --agents both` |
-| 安装到当前仓库 | `npx project-librarian install-skill --scope project --agents both` |
+| 为所有支持的 agent 全局安装 | `npx project-librarian install-skill --scope user --agents all` |
+| 安装到当前仓库 | `npx project-librarian install-skill --scope project --agents all` |
 | 只安装 Codex | `npx project-librarian install-skill --agents codex` |
 | 只安装 Claude Code | `npx project-librarian install-skill --agents claude` |
-| 预览安装结果 | `npx project-librarian install-skill --scope project --agents both --dry-run` |
+| 只安装 Cursor | `npx project-librarian install-skill --agents cursor` |
+| 只安装 Gemini CLI | `npx project-librarian install-skill --agents gemini` |
+| 预览安装结果 | `npx project-librarian install-skill --scope project --agents all --dry-run` |
 
 ## 代理运行路径
 
@@ -98,8 +76,12 @@ npx project-librarian install-skill --scope project --agents both
 | --- | --- |
 | 项目范围 Codex skill | `node .codex/skills/project-librarian/dist/init-project-wiki.js` |
 | 项目范围 Claude skill | `node .claude/skills/project-librarian/dist/init-project-wiki.js` |
+| 项目范围 Cursor skill | `node .cursor/skills/project-librarian/dist/init-project-wiki.js` |
+| 项目范围 Gemini skill | `node .gemini/skills/project-librarian/dist/init-project-wiki.js` |
 | 用户范围 Codex skill | `node ~/.codex/skills/project-librarian/dist/init-project-wiki.js` |
 | 用户范围 Claude skill | `node ~/.claude/skills/project-librarian/dist/init-project-wiki.js` |
+| 用户范围 Cursor skill | `node ~/.cursor/skills/project-librarian/dist/init-project-wiki.js` |
+| 用户范围 Gemini skill | `node ~/.gemini/skills/project-librarian/dist/init-project-wiki.js` |
 
 下面示例使用:
 
@@ -154,11 +136,17 @@ Wiki 验证和维护：
 
 - `AGENTS.md`
 - `CLAUDE.md`
+- `GEMINI.md`
 - `wiki/AGENTS.md`
+- `.cursor/rules/project-librarian.mdc`
 - `.codex/hooks.json`
 - `.codex/hooks/wiki-session-start.js`
 - `.claude/settings.json`
 - `.claude/hooks/wiki-session-start.js`
+- `.cursor/hooks.json`
+- `.cursor/hooks/wiki-session-start.js`
+- `.gemini/settings.json`
+- `.gemini/hooks/wiki-session-start.js`
 - `.githooks/prepare-commit-msg`
 - `.githooks/wiki-commit-trailers.js`
 - `wiki/canonical/`, `wiki/decisions/`, `wiki/inbox/`, `wiki/meta/`, `wiki/sources/`, `wiki/migration/`
@@ -172,9 +160,9 @@ Wiki 验证和维护：
 4. `--refresh-index` 路由新的 wiki page；route 很多时拆分到 `wiki/indexes/auto-*.md` 分范围路由器。
 5. `--code-index` 在 `.project-wiki/` 下创建可丢弃 SQLite 依据缓存。
 6. `--code-report`、`--code-impact`、`--code-search-symbol`、`--code-query` 为规划更新提供代码依据。
-7. 诊断报告坏链接、重复 route、orphan page、过期页面、缺少 TL;DR、依据 gap 和迁移复制风险。
+7. 诊断报告坏链接、重复 route、orphan page、过期页面、缺少 TL;DR、依据 gap 和迁移策略违规。
 
-迁移以审查为先。`--migrate` 会把已有 `wiki/` 保存为 `wiki_legacy*`，写入 migration inbox，并避免把 legacy Markdown 直接复制到新的 canonical truth。
+迁移以审查为先。`--migrate` 会把已有 `wiki/` 保存为 `wiki_legacy*`，写入 migration inbox 和 unit-level coverage ledger，并把 legacy 含义按当前 wiki 规则重构。保留或复制的 legacy 内容只要符合新 wiki 的策略和结构即可接受；新的 wiki 不应依赖引用 `wiki_legacy*` 才能被理解。
 
 ## 语言支持表
 
@@ -201,10 +189,10 @@ Wiki 验证和维护：
 
 ```bash
 $PROJECT_LIBRARIAN [init] [options]
-$PROJECT_LIBRARIAN install-skill [--scope user|project] [--agents codex|claude|both]
+$PROJECT_LIBRARIAN install-skill [--scope user|project] [--agents codex|claude|cursor|gemini|all|both]
 ```
 
-重要选项：`--migrate`, `--lint`, `--link-check`, `--quality-check`, `--doctor`, `--doctor --fix`, `--query`, `--refresh-index`, `--capture-inbox`, `--issue-draft`, `--issue-create`, `--glossary-init`, `--prune-check`, `--review-migration`, `--no-git-config`, `--code-index`, `--code-report`, `--code-impact`, `--code-search-symbol`, `--code-query`.
+重要选项：`--migrate`, `--lint`, `--link-check`, `--quality-check`, `--doctor`, `--doctor --fix`, `--migration-lint`, `--migration-quality-check`, `--migration-doctor`, `--query`, `--refresh-index`, `--capture-inbox`, `--issue-draft`, `--issue-create`, `--glossary-init`, `--prune-check`, `--review-migration`, `--no-git-config`, `--code-index`, `--code-report`, `--code-impact`, `--code-search-symbol`, `--code-query`.
 
 ## 开发
 

package/SKILL.md

@@ -37,8 +37,12 @@ Prefer an already installed local runner over network package execution:
 - In the project-librarian source repository, use `node dist/init-project-wiki.js` when `dist/init-project-wiki.js` exists.
 - In a target repository with a project-scoped Codex skill install, use `node .codex/skills/project-librarian/dist/init-project-wiki.js`.
 - In a target repository with a project-scoped Claude skill install, use `node .claude/skills/project-librarian/dist/init-project-wiki.js`.
+- In a target repository with a project-scoped Cursor skill install, use `node .cursor/skills/project-librarian/dist/init-project-wiki.js`.
+- In a target repository with a project-scoped Gemini skill install, use `node .gemini/skills/project-librarian/dist/init-project-wiki.js`.
 - In a user-scoped Codex skill install, use `node ~/.codex/skills/project-librarian/dist/init-project-wiki.js`.
 - In a user-scoped Claude skill install, use `node ~/.claude/skills/project-librarian/dist/init-project-wiki.js`.
+- In a user-scoped Cursor skill install, use `node ~/.cursor/skills/project-librarian/dist/init-project-wiki.js`.
+- In a user-scoped Gemini skill install, use `node ~/.gemini/skills/project-librarian/dist/init-project-wiki.js`.
 
 Use `npx` or `npm exec` only when no local runner exists and registry access is explicitly acceptable for the environment. When using npm package execution, pin the package version instead of running an unpinned public package.
 
@@ -68,6 +72,7 @@ Map lifecycle requests to these internal operations:
 - Check wiki links and routing: `$PROJECT_LIBRARIAN --link-check`.
 - Check document quality signals: `$PROJECT_LIBRARIAN --quality-check`.
 - Run all wiki diagnostics: `$PROJECT_LIBRARIAN --doctor`.
+- Check migration-specific review signals: `$PROJECT_LIBRARIAN --migration-doctor`.
 - Safely refresh generated routing before diagnostics: `$PROJECT_LIBRARIAN --doctor --fix`.
 - Search the wiki: `$PROJECT_LIBRARIAN --query "search terms"`.
 - Refresh wiki routing/index: `$PROJECT_LIBRARIAN --refresh-index`.
@@ -89,9 +94,11 @@ Skill problem reporting contract:
 ```bash
 node .codex/hooks/wiki-session-start.js
 node .claude/hooks/wiki-session-start.js
+node .cursor/hooks/wiki-session-start.js
+GEMINI_PROJECT_DIR="$PWD" node .gemini/hooks/wiki-session-start.js
 $PROJECT_LIBRARIAN --lint
 $PROJECT_LIBRARIAN --doctor
-node -e 'JSON.parse(require("fs").readFileSync(".codex/hooks.json","utf8")); JSON.parse(require("fs").readFileSync(".claude/settings.json","utf8")); console.log("project librarian ok")'
+node -e 'const fs=require("fs"); JSON.parse(fs.readFileSync(".codex/hooks.json","utf8")); JSON.parse(fs.readFileSync(".claude/settings.json","utf8")); JSON.parse(fs.readFileSync(".cursor/hooks.json","utf8")); JSON.parse(fs.readFileSync(".gemini/settings.json","utf8")); if (!fs.readFileSync("GEMINI.md","utf8").includes("@AGENTS.md")) process.exit(1); if (!fs.readFileSync(".cursor/rules/project-librarian.mdc","utf8").includes("@AGENTS.md")) process.exit(1); console.log("project librarian ok")'
 ```
 
 4. Report the files created or updated.
@@ -102,7 +109,7 @@ The script is idempotent. It creates missing files, updates the managed startup/
 
 Existing root instruction files are preservation-first:
 
-- Existing `AGENTS.md`, `CLAUDE.md`, and `wiki/AGENTS.md` files are not overwritten wholesale.
+- Existing `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, and `wiki/AGENTS.md` files are not overwritten wholesale.
 - If no managed project-wiki section exists, bootstrap appends its marker-bounded section to the existing file.
 - On rerun, bootstrap replaces only content between its own `PROJECT-WIKI-*` markers and preserves surrounding project-specific content.
 
@@ -112,7 +119,7 @@ Use `--lint` for read-only validation:
 $PROJECT_LIBRARIAN --lint
 ```
 
-Use `--query`, `--prune-check`, `--issue-draft`, `--link-check`, `--quality-check`, and `--doctor` for read-only inspection/output through the resolved runner. Use `--doctor --fix` when safe generated routing refresh is intended. Use `--refresh-index`, `--capture-inbox`, `--glossary-init`, and `--migrate` only when updating wiki files is intended.
+Use `--query`, `--prune-check`, `--issue-draft`, `--link-check`, `--quality-check`, `--doctor`, `--migration-lint`, `--migration-quality-check`, and `--migration-doctor` for read-only inspection/output through the resolved runner. Use `--doctor --fix` when safe generated routing refresh is intended. Use `--refresh-index`, `--capture-inbox`, `--glossary-init`, and `--migrate` only when updating wiki files is intended.
 
 Use `--review-migration` or `--semantic-migrate` after migration inbox rows are processed. It syncs inbox statuses into `wiki/migration/review.md` and `wiki/migration/verification.md`.
 
@@ -204,13 +211,19 @@ It installs:
 
 - `AGENTS.md` compact project-wide wiki-first planning instructions.
 - `CLAUDE.md` compact Claude Code compatibility file that imports `AGENTS.md`.
+- `GEMINI.md` compact Gemini CLI compatibility file that imports `AGENTS.md`.
 - `wiki/AGENTS.md` detailed wiki-internal editing and boundary rules.
+- `.cursor/rules/project-librarian.mdc` compact always-applied Cursor rule that references `AGENTS.md`.
 - `.githooks/prepare-commit-msg` wiki commit trailer hook.
 - `.githooks/wiki-commit-trailers.js` staged-file based trailer generator.
 - `.codex/hooks.json` `SessionStart` hook.
 - `.codex/hooks/wiki-session-start.js` compact startup context injector.
 - `.claude/settings.json` Claude Code `SessionStart` hook.
 - `.claude/hooks/wiki-session-start.js` compact startup context injector for Claude Code.
+- `.cursor/hooks.json` Cursor `sessionStart` hook.
+- `.cursor/hooks/wiki-session-start.js` compact startup context injector for Cursor.
+- `.gemini/settings.json` Gemini CLI `SessionStart` hook.
+- `.gemini/hooks/wiki-session-start.js` compact startup context injector for Gemini CLI.
 - `wiki/startup.md` compact session-start context.
 - `wiki/index.md` router with read/update/token-budget hints.
 - `wiki/canonical/` project-current-truth starter documents.
@@ -219,7 +232,7 @@ It installs:
 - `wiki/meta/` wiki operating rules, project decision policy, and wiki-operations Decision Pack.
 - `wiki/sources/` source summary starter documents.
 
-The Codex and Claude Code startup hooks inject only `wiki/startup.md` and `wiki/index.md`. Codex uses `.codex/hooks.json` plus `.codex/hooks/wiki-session-start.js`; Claude Code uses `.claude/settings.json` plus `.claude/hooks/wiki-session-start.js`. `CLAUDE.md` still imports `AGENTS.md` so Claude Code shares the same compact wiki-first instruction contract without duplicating the rules. `AGENTS.md` should stay compact and project-wide; `wiki/AGENTS.md` should carry detailed wiki editing rules. `wiki/startup.md` should route detailed canonical and decision files as Read On Demand, not Always Read First, so detailed files are read only when the current question needs them.
+The Codex, Claude Code, Cursor, and Gemini CLI startup hooks inject only `wiki/startup.md` and `wiki/index.md`. Codex uses `.codex/hooks.json` plus `.codex/hooks/wiki-session-start.js`; Claude Code uses `.claude/settings.json` plus `.claude/hooks/wiki-session-start.js`; Cursor uses `.cursor/hooks.json` plus `.cursor/hooks/wiki-session-start.js`; Gemini CLI uses `.gemini/settings.json` plus `.gemini/hooks/wiki-session-start.js`. `CLAUDE.md` and `GEMINI.md` import `AGENTS.md`, and `.cursor/rules/project-librarian.mdc` references `AGENTS.md`, so Claude Code, Gemini CLI, and Cursor share the same compact wiki-first instruction contract without duplicating the rules. `AGENTS.md` should stay compact and project-wide; `wiki/AGENTS.md` should carry detailed wiki editing rules. `wiki/startup.md` should route detailed canonical and decision files as Read On Demand, not Always Read First, so detailed files are read only when the current question needs them.
 
 When the project is a git repository, the script configures `git config core.hooksPath .githooks` by default only when `core.hooksPath` is unset, so wiki commit trailers are generated automatically without replacing an existing hook chain. Use `--no-git-config` to install hook files without changing git config. If the project is not a git repository yet, the hook files are still installed and will work after `core.hooksPath` is set.
 
@@ -249,7 +262,7 @@ Every wiki markdown file should include a compact metadata header with `status`,
 
 Wiki-specific commit trailers are automated through `.githooks/prepare-commit-msg`.
 
-The hook runs when staged files include `wiki/`, `AGENTS.md`, `CLAUDE.md`, `.codex/hooks.json`, `.codex/hooks/`, `.claude/settings.json`, `.claude/hooks/`, `.githooks/`, or `tools/project-librarian/`.
+The hook runs when staged files include `wiki/`, `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, `.cursor/rules/`, `.cursor/hooks.json`, `.cursor/hooks/`, `.gemini/settings.json`, `.gemini/hooks/`, `.codex/hooks.json`, `.codex/hooks/`, `.claude/settings.json`, `.claude/hooks/`, `.githooks/`, or `tools/project-librarian/`.
 
 It appends these trailers when they are missing:
 
@@ -264,7 +277,7 @@ It appends these trailers when they are missing:
 
 Do not hand-write wiki trailers unless the hook is unavailable or the generated value needs correction.
 
-`--lint` verifies the Codex and Claude hook files/settings, git hook files, executable bits, trailer phrases, and `core.hooksPath` when the project is a git repository. If `--no-git-config` was used, an unset or different `core.hooksPath` is expected until the project owner configures it manually.
+`--lint` verifies the Codex, Claude, Cursor, and Gemini hook files/settings, Cursor and Gemini instruction files, git hook files, executable bits, trailer phrases, and `core.hooksPath` when the project is a git repository. If `--no-git-config` was used, an unset or different `core.hooksPath` is expected until the project owner configures it manually.
 
 ## Glossary Mode
 
@@ -297,20 +310,22 @@ Captured inbox entries are not canonical. Fold them into `wiki/canonical/`, `wik
 
 `--migrate` and `--adopt-existing` are aliases.
 
-Migration mode is a reset-and-rewrite flow:
+Migration mode is a reset-and-restructure flow:
 
 - If `./wiki` exists, renames it to `./wiki_legacy`.
 - If `./wiki_legacy` already exists, preserves both by using a timestamped `wiki_legacy_...` directory for the current wiki.
 - Creates a fresh `./wiki` using the current standard rules.
 - Scans markdown files under the legacy wiki directory.
-- Writes `wiki/migration/inventory.md`, `wiki/migration/plan.md`, and `wiki/migration/verification.md`.
+- Writes `wiki/migration/inventory.md`, `wiki/migration/coverage.md`, `wiki/migration/plan.md`, and `wiki/migration/verification.md`.
 - Writes rewrite inboxes:
   - `wiki/canonical/migration-inbox.md`
   - `wiki/decisions/migration-inbox.md`
   - `wiki/sources/migration-inbox.md`
 - Adds migration routing to `wiki/startup.md` and `wiki/index.md`.
 
-After migration mode, inspect inboxes and fold legacy content into canonical docs, Decision Packs, ADRs, source summaries, or meta docs. Do not copy legacy markdown files directly into `wiki/canonical/`, `wiki/decisions/`, or `wiki/sources/`; rewrite only the useful project meaning, cite current-project evidence when possible, and keep ambiguous material in the migration inbox or mark it `needs-human-review`.
+After migration mode, inspect inboxes and fold legacy content into canonical docs, Decision Packs, ADRs, source summaries, or meta docs. Minimize information loss while converting useful legacy meaning to the current wiki structure and rules. Legacy files, sections, blocks, and wording may be retained when review confirms each retained unit belongs in the new topic shape and remains current project truth. Do not link to or cite `wiki_legacy*` from the new wiki; cite current-project evidence when possible, and keep ambiguous material in the migration inbox or mark it `needs-human-review`.
+
+`wiki/migration/coverage.md` is the unit-level coverage ledger. It accounts for legacy headings, paragraphs, list items, table rows, and code blocks with stable unit IDs. Every unit should end as `adopted`, `merged`, `superseded`, `rejected`, `resolved`, or `needs-human-review`; `pending` means the unit is still open. `adopted` and `merged` rows require a new-wiki target under `wiki/canonical/`, `wiki/decisions/`, `wiki/sources/`, or `wiki/meta/`. Deleting a unit row is treated as possible information loss and `--migration-lint` reports it as `migration-unaccounted-unit`.
 
 Inbox rows use these statuses:
 
@@ -326,10 +341,10 @@ Run semantic review sync after LLM or human processing:
 $PROJECT_LIBRARIAN --review-migration
 ```
 
-`wiki/migration/verification.md` verifies file coverage: every legacy markdown file should be mapped to a new-wiki migration target. This is not a semantic-completeness proof. Semantic migration is complete only after inbox rows are marked adopted/rejected/resolved and `needs-human-review` is 0.
+`wiki/migration/verification.md` verifies file coverage: every legacy markdown file should be mapped to a new-wiki migration target. `wiki/migration/coverage.md` verifies unit coverage: every extracted legacy meaning unit should remain accounted for. Semantic migration is complete only after inbox rows are marked adopted/rejected/resolved and `needs-human-review` is 0, and unit coverage has no unaccounted rows.
 
 Human review is not required for every inbox item. LLM may process ordinary rows and close them as adopted/rejected/resolved. Human review is reserved for `needs-human-review`.
 
-Run `$PROJECT_LIBRARIAN --doctor` after migration review. `--quality-check` and `--doctor` report `migration-copy-risk` when a new project wiki document appears to be copied from `wiki_legacy*`, and report `migration-filename-reuse` when a legacy filename is reused and needs rewrite verification.
+Run `$PROJECT_LIBRARIAN --migration-doctor` after migration review. Normal `--quality-check` and `--doctor` intentionally omit migration-only policy/structure signals so accepted migration decisions do not pollute later non-migration document checks. `--migration-quality-check` and `--migration-doctor` report `migration-legacy-reference` as an error when active project truth links to or cites `wiki_legacy*`. They do not warn merely because a new wiki document copies legacy wording, blocks, whole documents, or filenames; those are acceptable when the result follows the current wiki policy and structure. Use `--migration-lint` and `wiki/migration/coverage.md` to prevent information loss.
 
-Do not delete `wiki_legacy` until migration verification passes, semantic review is complete, and migration copy diagnostics are clear.
+Do not delete `wiki_legacy` until migration verification passes, semantic review is complete, and migration policy/structure diagnostics are clear.

package/dist/args.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.issueDraftTitle = exports.issueBodyFile = exports.captureCategory = exports.captureContent = exports.captureTitle = exports.codeIndexScopes = exports.codeParser = exports.codeIndexOutput = exports.codeSearchSymbol = exports.codeReportSection = exports.codeQuerySql = exports.codeImpactTarget = exports.queryTerm = exports.codeSearchSymbolMode = exports.codeQueryMode = exports.codeImpactMode = exports.codeParserMode = exports.codeFilesMode = exports.codeStatusMode = exports.codeReportMode = exports.codeIndexFullMode = exports.codeIndexIncrementalMode = exports.codeIndexMode = exports.noGitConfigMode = exports.reviewMigrationMode = exports.pruneCheckMode = exports.captureInboxMode = exports.refreshIndexMode = exports.issueDraftMode = exports.issueCreateMode = exports.glossaryMode = exports.fixMode = exports.doctorMode = exports.qualityCheckMode = exports.linkCheckMode = exports.lintMode = exports.migrateMode = exports.missingValueOptions = exports.unexpectedValueOptions = exports.unknownOptions = exports.args = exports.commandArgs = exports.command = exports.unknownCommand = exports.helpMode = exports.parsedArgs = exports.rawArgs = void 0;
+exports.issueDraftTitle = exports.issueBodyFile = exports.captureCategory = exports.captureContent = exports.captureTitle = exports.codeIndexScopes = exports.codeParser = exports.codeIndexOutput = exports.codeSearchSymbol = exports.codeReportSection = exports.codeQuerySql = exports.codeImpactTarget = exports.queryTerm = exports.codeSearchSymbolMode = exports.codeQueryMode = exports.codeImpactMode = exports.codeParserMode = exports.codeFilesMode = exports.codeStatusMode = exports.codeReportMode = exports.codeIndexFullMode = exports.codeIndexIncrementalMode = exports.codeIndexMode = exports.noGitConfigMode = exports.reviewMigrationMode = exports.pruneCheckMode = exports.captureInboxMode = exports.refreshIndexMode = exports.issueDraftMode = exports.issueCreateMode = exports.glossaryMode = exports.fixMode = exports.doctorMode = exports.qualityCheckMode = exports.linkCheckMode = exports.migrationQualityCheckMode = exports.migrationLintMode = exports.migrationDoctorMode = exports.lintMode = exports.migrateMode = exports.missingValueOptions = exports.unexpectedValueOptions = exports.unknownOptions = exports.args = exports.commandArgs = exports.command = exports.unknownCommand = exports.helpMode = exports.parsedArgs = exports.rawArgs = void 0;
 exports.parseArgs = parseArgs;
 exports.argValue = argValue;
 exports.argValues = argValues;
@@ -32,6 +32,9 @@ const flagsWithoutValues = new Set([
     "--link-check",
     "--lint",
     "--migrate",
+    "--migration-doctor",
+    "--migration-lint",
+    "--migration-quality-check",
     "--no-git-config",
     "--prune-check",
     "--quality-check",
@@ -161,6 +164,9 @@ function parseArgs(argv) {
         issueDraftTitle: argValue("--issue-title"),
         linkCheckMode: args.has("--link-check"),
         lintMode: args.has("--lint"),
+        migrationDoctorMode: args.has("--migration-doctor"),
+        migrationLintMode: args.has("--migration-lint"),
+        migrationQualityCheckMode: args.has("--migration-quality-check"),
         migrateMode: args.has("--migrate") || args.has("--adopt-existing"),
         missingValueOptions: Array.from(flagsWithValues).filter((flag) => hasFlag(flag) && !flagHasValue(commandArgs, flag)),
         noGitConfigMode: args.has("--no-git-config"),
@@ -192,6 +198,9 @@ exports.unexpectedValueOptions = exports.parsedArgs.unexpectedValueOptions;
 exports.missingValueOptions = exports.parsedArgs.missingValueOptions;
 exports.migrateMode = exports.parsedArgs.migrateMode;
 exports.lintMode = exports.parsedArgs.lintMode;
+exports.migrationDoctorMode = exports.parsedArgs.migrationDoctorMode;
+exports.migrationLintMode = exports.parsedArgs.migrationLintMode;
+exports.migrationQualityCheckMode = exports.parsedArgs.migrationQualityCheckMode;
 exports.linkCheckMode = exports.parsedArgs.linkCheckMode;
 exports.qualityCheckMode = exports.parsedArgs.qualityCheckMode;
 exports.doctorMode = exports.parsedArgs.doctorMode;

package/dist/code-index-file-policy.js

@@ -44,6 +44,8 @@ exports.ignoredDirectories = new Set([
     ".git",
     ".codex",
     ".claude",
+    ".cursor",
+    ".gemini",
     ".project-wiki",
     "node_modules",
     ".next",

package/dist/hooks.js

@@ -33,10 +33,12 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.gitWikiCommitTrailersScript = exports.gitPrepareCommitMsgHook = exports.hookScript = void 0;
+exports.gitWikiCommitTrailersScript = exports.gitPrepareCommitMsgHook = exports.cursorHookScript = exports.hookScript = void 0;
 exports.upsertGitHooksPath = upsertGitHooksPath;
 exports.upsertHookConfig = upsertHookConfig;
 exports.upsertClaudeHookConfig = upsertClaudeHookConfig;
+exports.upsertGeminiHookConfig = upsertGeminiHookConfig;
+exports.upsertCursorHookConfig = upsertCursorHookConfig;
 const childProcess = __importStar(require("node:child_process"));
 const args_1 = require("./args");
 const workspace_1 = require("./workspace");
@@ -109,7 +111,33 @@ function upsertHookConfig() {
 function upsertClaudeHookConfig() {
     return upsertSessionStartHookConfig(".claude/settings.json", "node .claude/hooks/wiki-session-start.js", ["startup", "resume", "clear", "compact"]);
 }
-exports.hookScript = `#!/usr/bin/env node
+function upsertGeminiHookConfig() {
+    return upsertSessionStartHookConfig(".gemini/settings.json", 'node "$GEMINI_PROJECT_DIR/.gemini/hooks/wiki-session-start.js"', ["startup", "resume", "clear"]);
+}
+function isCursorHookCommand(value) {
+    return Boolean(value) && typeof value === "object" && typeof value.command === "string";
+}
+function upsertCursorHookConfig() {
+    const relativePath = ".cursor/hooks.json";
+    const command = "node .cursor/hooks/wiki-session-start.js";
+    const config = (0, workspace_1.parseJson)(relativePath, { version: 1, hooks: {} });
+    if (typeof config.version !== "number")
+        config.version = 1;
+    if (!config.hooks || typeof config.hooks !== "object" || Array.isArray(config.hooks)) {
+        config.hooks = {};
+    }
+    const existing = Array.isArray(config.hooks.sessionStart) ? config.hooks.sessionStart.filter(isCursorHookCommand) : [];
+    config.hooks.sessionStart = [
+        ...existing.filter((hook) => hook.command !== command),
+        { command },
+    ];
+    const next = `${JSON.stringify(config, null, 2)}\n`;
+    const previous = (0, workspace_1.exists)(relativePath) ? (0, workspace_1.read)(relativePath) : "";
+    (0, workspace_1.write)(relativePath, next);
+    return previous === next ? "exists" : previous ? "updated" : "created";
+}
+function buildStartupHookScript(output) {
+    return `#!/usr/bin/env node
 
 const fs = require("fs");
 const path = require("path");
@@ -127,7 +155,7 @@ function readHookInput() {
 }
 
 const hookInput = readHookInput();
-const cwd = process.env.CODEX_WORKSPACE_DIR || hookInput.cwd || process.cwd();
+const cwd = process.env.GEMINI_PROJECT_DIR || process.env.CODEX_WORKSPACE_DIR || process.env.CLAUDE_PROJECT_DIR || hookInput.cwd || process.cwd();
 
 function readIfExists(relativePath, maxChars) {
   const filePath = path.join(cwd, relativePath);
@@ -164,10 +192,15 @@ const additionalContext = [
 ].join("\\n");
 
 process.stdout.write(JSON.stringify({
-  continue: true,
-  hookSpecificOutput: { hookEventName: "SessionStart", additionalContext },
+${output}
 }));
 `;
+}
+exports.hookScript = buildStartupHookScript(`  continue: true,
+  hookSpecificOutput: { hookEventName: "SessionStart", additionalContext },
+`);
+exports.cursorHookScript = buildStartupHookScript(`  additional_context: additionalContext,
+`);
 exports.gitPrepareCommitMsgHook = `#!/bin/sh
 MSG_FILE="$1"
 SOURCE="$2"
@@ -253,7 +286,10 @@ function wikiScope(files) {
     else if (file === "wiki/index.md") add("index");
     else if (file.startsWith(".codex/hooks/") || file === ".codex/hooks.json") add("codex-hooks");
     else if (file.startsWith(".claude/hooks/") || file === ".claude/settings.json") add("claude-hooks");
-    else if (file === "AGENTS.md" || file === "CLAUDE.md") add("agents");
+    else if (file.startsWith(".cursor/hooks/") || file === ".cursor/hooks.json") add("cursor-hooks");
+    else if (file.startsWith(".cursor/rules/")) add("cursor-rules");
+    else if (file.startsWith(".gemini/hooks/") || file === ".gemini/settings.json") add("gemini-hooks");
+    else if (file === "AGENTS.md" || file === "CLAUDE.md" || file === "GEMINI.md") add("agents");
     else if (file.startsWith(".githooks/")) add("git-hooks");
     else if (file.startsWith("tools/project-librarian/")) add("skill");
   }
@@ -266,15 +302,31 @@ function validationTrailers() {
     "tools/project-librarian/dist/init-project-wiki.js",
     path.join(home, ".codex/skills/project-librarian/dist/init-project-wiki.js"),
     path.join(home, ".claude/skills/project-librarian/dist/init-project-wiki.js"),
+    path.join(home, ".cursor/skills/project-librarian/dist/init-project-wiki.js"),
+    path.join(home, ".gemini/skills/project-librarian/dist/init-project-wiki.js"),
   ].find((candidate) => fs.existsSync(candidate));
   const lintOk = Boolean(lintScript) && commandOk("node", [lintScript, "--lint"]);
   const codexSessionHookOk = fs.existsSync(".codex/hooks/wiki-session-start.js") && commandOk("node", [".codex/hooks/wiki-session-start.js"]);
   const claudeSessionHookOk = fs.existsSync(".claude/hooks/wiki-session-start.js") && commandOk("node", [".claude/hooks/wiki-session-start.js"]);
-  if (lintOk && codexSessionHookOk && claudeSessionHookOk) return { tested: "project wiki lint; Codex and Claude wiki session-start hooks", notTested: "none" };
+  const cursorSessionHookOk = fs.existsSync(".cursor/hooks/wiki-session-start.js") && commandOk("node", [".cursor/hooks/wiki-session-start.js"]);
+  const cursorHookConfigOk = fs.existsSync(".cursor/hooks.json") && existingFile(".cursor/hooks.json").includes("node .cursor/hooks/wiki-session-start.js");
+  const geminiSessionHookOk = fs.existsSync(".gemini/hooks/wiki-session-start.js") && commandOk("node", [".gemini/hooks/wiki-session-start.js"]);
+  const geminiHookConfigOk = fs.existsSync(".gemini/settings.json") && existingFile(".gemini/settings.json").includes('node "$GEMINI_PROJECT_DIR/.gemini/hooks/wiki-session-start.js"');
+  const geminiInstructionsOk = fs.existsSync("GEMINI.md") && existingFile("GEMINI.md").includes("@AGENTS.md");
+  const cursorRuleOk = fs.existsSync(".cursor/rules/project-librarian.mdc") && existingFile(".cursor/rules/project-librarian.mdc").includes("@AGENTS.md");
+  if (lintOk && codexSessionHookOk && claudeSessionHookOk && cursorSessionHookOk && cursorHookConfigOk && geminiSessionHookOk && geminiHookConfigOk && geminiInstructionsOk && cursorRuleOk) {
+    return { tested: "project wiki lint; Codex, Claude, Cursor, and Gemini wiki session-start hooks; Cursor and Gemini instruction files", notTested: "none" };
+  }
   const gaps = [];
   if (!lintOk) gaps.push("project wiki lint");
   if (!codexSessionHookOk) gaps.push("Codex wiki session-start hook");
   if (!claudeSessionHookOk) gaps.push("Claude wiki session-start hook");
+  if (!cursorSessionHookOk) gaps.push("Cursor wiki session-start hook");
+  if (!cursorHookConfigOk) gaps.push("Cursor hook config");
+  if (!geminiSessionHookOk) gaps.push("Gemini wiki SessionStart hook");
+  if (!geminiHookConfigOk) gaps.push("Gemini hook config");
+  if (!cursorRuleOk) gaps.push("Cursor project rule");
+  if (!geminiInstructionsOk) gaps.push("Gemini instructions");
   return { tested: "prepare-commit-msg generated wiki trailers", notTested: gaps.join("; ") || "unknown" };
 }
 
@@ -287,10 +339,16 @@ const wikiFiles = staged.filter((file) => {
   return file.startsWith("wiki/")
     || file === "AGENTS.md"
     || file === "CLAUDE.md"
+    || file === "GEMINI.md"
     || file === ".codex/hooks.json"
     || file.startsWith(".codex/hooks/")
     || file === ".claude/settings.json"
     || file.startsWith(".claude/hooks/")
+    || file.startsWith(".cursor/rules/")
+    || file === ".cursor/hooks.json"
+    || file.startsWith(".cursor/hooks/")
+    || file === ".gemini/settings.json"
+    || file.startsWith(".gemini/hooks/")
     || file.startsWith(".githooks/")
     || file.startsWith("tools/project-librarian/");
 });

package/dist/init-project-wiki.js

@@ -15,7 +15,7 @@ function codeIndex() {
 function printUsage() {
     console.log(`Usage:
   project-librarian [init] [options]
-  project-librarian install-skill [--scope user|project] [--agents codex|claude|both]
+  project-librarian install-skill [--scope user|project] [--agents codex|claude|cursor|gemini|all|both]
 
 Options:
   --migrate, --adopt-existing      Preserve an existing wiki as wiki_legacy and create migration inboxes.
@@ -24,6 +24,9 @@ Options:
   --quality-check                  Report stale, conflicting, and low-quality wiki document signals.
   --doctor                         Run lint, link-check, and quality-check together.
   --fix                            With --doctor, safely refresh generated index routing.
+  --migration-lint                 Validate migration review scaffolding separately from normal lint.
+  --migration-quality-check        Report migration policy/structure signals separately from normal quality-check.
+  --migration-doctor               Run migration-lint and migration-quality-check together.
   --issue-create                   Create a GitHub issue with gh issue create after explicit user approval.
   --issue-draft                    Print a problem/side-effect GitHub issue body draft.
   --issue-body-file <path>         With --issue-create, use an existing Markdown body file.
@@ -156,6 +159,18 @@ if (args_1.reviewMigrationMode) {
     (0, migration_1.runReviewMigrationMode)();
     process.exit(0);
 }
+if (args_1.migrationDoctorMode) {
+    (0, modes_1.runMigrationDoctorMode)();
+    process.exit(0);
+}
+if (args_1.migrationQualityCheckMode) {
+    (0, modes_1.runMigrationQualityCheckMode)();
+    process.exit(0);
+}
+if (args_1.migrationLintMode) {
+    (0, modes_1.runMigrationLintMode)();
+    process.exit(0);
+}
 if (args_1.doctorMode) {
     (0, modes_1.runDoctorMode)(args_1.fixMode);
     process.exit(0);
@@ -183,9 +198,14 @@ if (migrationState)
 (0, workspace_1.mkdirp)("wiki/sources");
 (0, workspace_1.mkdirp)(".codex/hooks");
 (0, workspace_1.mkdirp)(".claude/hooks");
+(0, workspace_1.mkdirp)(".cursor/hooks");
+(0, workspace_1.mkdirp)(".cursor/rules");
+(0, workspace_1.mkdirp)(".gemini/hooks");
 (0, workspace_1.mkdirp)(".githooks");
 results.push(["AGENTS.md", (0, workspace_1.upsertMarkedSection)("AGENTS.md", "<!-- PROJECT-WIKI-FIRST:START -->", "<!-- PROJECT-WIKI-FIRST:END -->", templates_1.agentsSection)]);
 results.push(["CLAUDE.md", (0, workspace_1.upsertMarkedSection)("CLAUDE.md", "<!-- PROJECT-WIKI-CLAUDE:START -->", "<!-- PROJECT-WIKI-CLAUDE:END -->", templates_1.claudeSection)]);
+results.push(["GEMINI.md", (0, workspace_1.upsertMarkedSection)("GEMINI.md", "<!-- PROJECT-WIKI-GEMINI:START -->", "<!-- PROJECT-WIKI-GEMINI:END -->", templates_1.geminiSection)]);
+results.push([".cursor/rules/project-librarian.mdc", (0, workspace_1.writeManaged)(".cursor/rules/project-librarian.mdc", templates_1.cursorRule)]);
 results.push(["wiki/AGENTS.md", (0, workspace_1.upsertMarkedSection)("wiki/AGENTS.md", "<!-- PROJECT-WIKI-INTERNAL:START -->", "<!-- PROJECT-WIKI-INTERNAL:END -->", templates_1.wikiAgentsSection)]);
 results.push([".githooks/prepare-commit-msg", (0, workspace_1.writeManaged)(".githooks/prepare-commit-msg", hooks_1.gitPrepareCommitMsgHook)]);
 (0, workspace_1.makeExecutable)(".githooks/prepare-commit-msg");
@@ -196,6 +216,10 @@ results.push([".codex/hooks.json", (0, hooks_1.upsertHookConfig)()]);
 results.push([".codex/hooks/wiki-session-start.js", (0, workspace_1.writeManaged)(".codex/hooks/wiki-session-start.js", hooks_1.hookScript)]);
 results.push([".claude/settings.json", (0, hooks_1.upsertClaudeHookConfig)()]);
 results.push([".claude/hooks/wiki-session-start.js", (0, workspace_1.writeManaged)(".claude/hooks/wiki-session-start.js", hooks_1.hookScript)]);
+results.push([".cursor/hooks.json", (0, hooks_1.upsertCursorHookConfig)()]);
+results.push([".cursor/hooks/wiki-session-start.js", (0, workspace_1.writeManaged)(".cursor/hooks/wiki-session-start.js", hooks_1.cursorHookScript)]);
+results.push([".gemini/settings.json", (0, hooks_1.upsertGeminiHookConfig)()]);
+results.push([".gemini/hooks/wiki-session-start.js", (0, workspace_1.writeManaged)(".gemini/hooks/wiki-session-start.js", hooks_1.hookScript)]);
 results.push(["wiki/startup.md", (0, workspace_1.writeManaged)("wiki/startup.md", (0, wiki_files_1.withPreservedMarkedSections)("wiki/startup.md", templates_1.startup, [["<!-- PROJECT-WIKI-MIGRATION:START -->", "<!-- PROJECT-WIKI-MIGRATION:END -->"]]))]);
 results.push(["wiki/index.md", (0, workspace_1.writeManaged)("wiki/index.md", (0, wiki_files_1.withPreservedMarkedSections)("wiki/index.md", templates_1.index, [
         ["<!-- PROJECT-WIKI-MIGRATION:START -->", "<!-- PROJECT-WIKI-MIGRATION:END -->"],