juice094 · juice094 · Jun 13, 2026 · Jun 4, 2026 · Jun 4, 2026 · Jun 6, 2026
diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md
@@ -13,10 +13,10 @@
 |----|------|--------|--------|
 | F-001 | Version | `Cargo.toml` | **v0.20.1** |
 | F-002 | Edition | `Cargo.toml` | **Rust 2024** |
-| F-003 | Test Coverage | CI | **494 passed, 0 failed, 5 ignored** |
+| F-003 | Test Coverage | CI | **605 passed, 0 failed, 7 ignored** |
 | F-004 | Production Unwrap | Architecture Invariants | **0** (G5 rule enforced) |
-| F-005 | MCP Tools | `src/mcp/mod.rs` | **69** (5 Stable / 60 Beta / 4 Experimental) |
-| F-006 | Schema Version | `registry/migrate.rs` | **v34** |
+| F-005 | MCP Tools | `src/mcp/mod.rs` | **71** (5 Stable / 58 Beta / 8 Experimental) |
+| F-006 | Schema Version | `registry/migrate.rs` | **v36** |
 | F-007 | Entities Table | Schema v21+ | **唯一真相源** (`repos` 表已删除) |
 | F-008 | SQLite Mode | `storage.rs` | **WAL mode** |
 | F-009 | Clippy | CI | **`-D warnings` 全绿** |
@@ -51,9 +51,9 @@
 | ~~`relations` 表零生产读取路径~~ | ~~统一实体模型的图遍历能力未暴露~~ | ~~v0.21.0~~ | **已完成** — `devkit_relation_store/query/delete` 已存在，`project_context` 已读取 |
 | ~~Workflow 引擎零 MCP 暴露~~ | ~~AI 无法发现/触发工作流~~ | ~~v0.21.0~~ | **已完成** — `devkit_workflow_list/run/status` 已存在 |
 | ~~`project_context` 不完整~~ | ~~缺少 relations/limits/skills/workflows~~ | ~~v0.21.0~~ | **已完成** — 已补充 `known_limits` + `skills` |
-| 31/68 MCP 工具缺少调用测试 | 回归风险 | v0.21.0 | 待评估 |
-| ~~`mcp/tools/repo.rs` 2376 行~~ | ~~维护负担~~ | ~~v0.21.0~~ | **已完成** — 已拆分为 `tools/` 目录，`repo.rs` 现 730 行 |
-| ~~`init_db_at` 1214 行~~ | ~~迁移函数过大~~ | ~~v0.21.0~~ | **已完成** — 已拆分为 `registry/migrate.rs`（503 行）+ `repo.rs` + `vault.rs` + `links.rs` |
+| MCP 工具测试覆盖不均 | 部分 Beta 工具仅有 smoke test | v0.21.0 | 待评估 |
+| ~~`mcp/tools/repo.rs` 2376 行~~ | ~~维护负担~~ | ~~v0.21.0~~ | **已完成** — 已拆分为 `tools/` 目录 |
+| ~~`init_db_at` 1214 行~~ | ~~迁移函数过大~~ | ~~v0.21.0~~ | **已完成** — 已拆分为 `registry/migrate.rs` + 子模块 |
 
 ## 防失忆校验清单（每次会话启动）
 
@@ -89,5 +89,5 @@
 
 ---
 
-**Last Updated**: 2026-05-20 by Claude Opus 4.7
+**Last Updated**: 2026-06-13
 **Version**: v0.20.1
diff --git a/.editorconfig b/.editorconfig
@@ -0,0 +1,28 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 4
+max_line_length = 100
+
+[*.{rs,toml}]
+indent_size = 4
+max_line_length = 100
+
+[*.{md,yml,yaml,json}]
+indent_size = 2
+max_line_length = 100
+
+[*.{ps1}]
+end_of_line = crlf
+indent_size = 4
+
+[*.sh]
+indent_size = 2
+
+[Makefile]
+indent_style = tab
diff --git a/.gitattributes b/.gitattributes
@@ -0,0 +1,16 @@
+# Line ending normalization for cross-platform collaboration
+*.sh eol=lf
+*.ps1 eol=crlf
+
+# Binary files — do not treat as text
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.ico binary
+*.db binary
+*.db-wal binary
+*.db-journal binary
+*.zip binary
+*.tar binary
+*.gz binary
diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml
@@ -0,0 +1,7 @@
+# Funding and sponsorship configuration for devbase
+# https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/displaying-a-sponsor-button-in-your-repository
+
+github: [juice094]
+custom:
+  - "https://github.com/juice094/devbase"
+  - "mailto:juice094@protonmail.com"
diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -4,28 +4,39 @@ about: Create a report to help us improve devbase
 title: '[BUG] '
 labels: bug
 assignees: ''
-
 ---
 
-**Describe the bug**
-A clear and concise description of what the bug is.
+## Bug Description
+
+<!-- 清晰简洁地描述 bug 是什么 -->
+
+## Reproduction Steps
+
+<!-- 最小复现步骤。如果无法稳定复现，请说明发生频率 -->
 
-**To Reproduce**
-Steps to reproduce the behavior:
 1. Run `...`
-2. Click on '...'
+2. Run `...`
 3. See error
 
-**Expected behavior**
-A clear and concise description of what you expected to happen.
+## Expected Behavior
+
+<!-- 你期望发生什么 -->
+
+## Actual Behavior
+
+<!-- 实际发生了什么，包括完整的错误输出或截图 -->
+
+```text
+# 请粘贴完整的错误日志或命令输出
+```
+
+## Environment
 
-**Environment (please complete the following information):**
- - OS: [e.g. Windows 11, macOS 14, Ubuntu 22.04]
- - devbase version: [output of `devbase --version`]
- - Rust version: [output of `rustc --version`]
+- OS: [e.g. Windows 11, macOS 14, Ubuntu 22.04]
+- devbase version: [output of `devbase --version`]
+- Rust version: [output of `rustc --version`]
+- Installation method: [cargo install / install.ps1 / install.sh / GitHub release]
 
-**Screenshots / Logs**
-If applicable, add screenshots or console output to help explain your problem.
+## Additional Context
 
-**Additional context**
-Add any other context about the problem here.
+<!-- 其他上下文：是否为升级后出现、是否修改过 schema、是否使用自定义 feature 等 -->
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
@@ -6,3 +6,6 @@ contact_links:
   - name: Question or discussion
     url: https://github.com/juice094/devbase/discussions
     about: For Q&A, architecture debates, or show-and-tell, use GitHub Discussions.
+  - name: Commercial licensing inquiry
+    url: mailto:juice094@protonmail.com
+    about: For commercial / dual-licensing questions, please email the maintainer.
diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -4,20 +4,24 @@ about: Suggest an idea for devbase
 title: '[Feature] '
 labels: enhancement
 assignees: ''
-
 ---
 
-**Is your feature request related to a problem? Please describe.**
-A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+## Problem Statement
+
+<!-- 这个功能要解决什么问题？请描述你遇到的痛点或使用场景 -->
+
+## Proposed Solution
+
+<!-- 你希望 devbase 如何解决这个问题？如果涉及新 MCP tool 或 CLI 命令，请给出拟议的接口 -->
+
+## Use Case
+
+<!-- 谁会受益？在什么场景下使用？ -->
 
-**Describe the solution you'd like**
-A clear and concise description of what you want to happen.
+## Alternatives Considered
 
-**Describe alternatives you've considered**
-A clear and concise description of any alternative solutions or features you've considered.
+<!-- 你考虑过哪些替代方案？为什么它们不够好？ -->
 
-**Use case**
-Who would benefit from this feature? How would they use it?
+## Additional Context
 
-**Additional context**
-Add any other context, mockups, or references about the feature request here.
+<!-- 其他上下文：参考链接、mockup、相关 issue 等 -->
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
@@ -1,26 +1,51 @@
 ## Summary
 
-<!-- One-line description of what this PR does -->
+<!-- 必填：用一句话说明这个 PR 做了什么，解决了什么问题 -->
+
+## Motivation / Context
+
+<!-- 为什么需要这个改动？关联的 issue、讨论或用户场景是什么？ -->
 
 ## Type of Change
 
 - [ ] Bug fix (non-breaking)
 - [ ] New feature
 - [ ] Breaking change
-- [ ] Documentation
+- [ ] Documentation only
 - [ ] Performance improvement
 - [ ] Refactoring (no behavior change)
+- [ ] Test-only change
+- [ ] Build / CI / tooling
+
+## Testing
+
+<!-- 如何验证这个改动？列出你运行的命令和结果 -->
 
-## Checklist
+```bash
+# 本地验证命令示例
+cargo test --all-targets
+cargo clippy --all-targets -D warnings
+cargo fmt --check
+scripts/invariant-checks/run-checks.ps1   # Windows
+```
 
 - [ ] `cargo test --all-targets` passes locally
 - [ ] `cargo clippy --all-targets -D warnings` passes
 - [ ] `cargo fmt --check` passes
 - [ ] New code has no production `unwrap`/`expect`/`panic` (test code exempt)
-- [ ] Schema changes include migration in `src/registry/migrate.rs`
+- [ ] Schema changes include migration in `src/registry/migrate.rs` **and** `src/registry/test_helpers.rs`
 - [ ] New MCP tools include tests in `src/mcp/tests.rs`
-- [ ] README / AGENTS.md updated if user-facing behavior changed
+- [ ] README / AGENTS.md / docs/README.md updated if user-facing behavior changed
+- [ ] `scripts/invariant-checks/run-checks.ps1` passes (Windows)
+
+## Breaking Changes / Migration Notes
+
+<!-- 如果这是 Breaking change，说明用户/下游需要如何迁移。无则填 "None" -->
 
 ## Related Issues
 
-<!-- Link to related issues: Fixes #123, Closes #456 -->
+<!-- Fixes #123, Closes #456, Related to #789 -->
+
+## Additional Notes
+
+<!-- 其他需要审阅者知道的信息：设计取舍、已知限制、截图等 -->
diff --git a/.github/dependabot.yml b/.github/dependabot.yml
@@ -0,0 +1,24 @@
+version: 2
+updates:
+  - package-ecosystem: "cargo"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    open-pull-requests-limit: 10
+    labels:
+      - "dependencies"
+      - "rust"
+    commit-message:
+      prefix: "chore(deps)"
+      include: "scope"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    labels:
+      - "dependencies"
+      - "ci"
+    commit-message:
+      prefix: "chore(ci)"
diff --git a/.github/release.yml b/.github/release.yml
@@ -0,0 +1,32 @@
+# GitHub Release notes configuration
+# https://docs.github.com/en/repositories/releasing-projects-on-github/automatically-generated-release-notes
+
+changelog:
+  exclude:
+    labels:
+      - ignore-for-release
+      - "chore"
+    authors:
+      - dependabot[bot]
+  categories:
+    - title: ⚠️ Breaking Changes
+      labels:
+        - breaking-change
+    - title: 🚀 New Features
+      labels:
+        - enhancement
+        - feature
+    - title: 🐛 Bug Fixes
+      labels:
+        - bug
+    - title: 🛠️ Maintenance
+      labels:
+        - refactor
+        - perf
+        - test
+    - title: 📚 Documentation
+      labels:
+        - documentation
+    - title: Other Changes
+      labels:
+        - "*"