fix: preserve complete skill package snapshot

docs/BUG_HISTORY.md

@@ -3242,3 +3242,19 @@
 - 防复发：测试必须读取 canonical registry，不得重新硬编码派生业务真源；正式 V2 RPC 替代 legacy RPC 时必须保留完整成功、幂等、切换、失效和持久化业务覆盖，不能以“旧入口被拒绝”替代纵向链路；跨语言测试必须显式传递当前解释器，不得依赖 PATH 别名或 worktree 深度；类型 fixture 必须跟随共享列模型演进。
 - 相关记录：BUG-178、BUG-181、BUG-189、BUG-190
 - 修复版本：本次功能分支提交（精确 SHA 以提交、远程分支和 staging 发布核对结果为准）
+
+
+## BUG-192 | 外层 `.gitignore` 漏提交上游 `.agents`，clean staging package identity 不完整
+
+- 状态：resolved（本地候选，待 staging 精确 SHA 发布验收）
+- 首次发现：2026-08-15
+- 最近更新：2026-08-15
+- 影响面：`jyotish-vedic-astrology@6.9.14` 上游研究快照完整性、immutable package identity、Agent 模块导入与 Gitea 独立 staging 质量门禁。
+- 用户现象：本地全量前端测试通过，但同一提交在 Linux clean checkout 上有 5 个 Agent/registry 测试连锁失败；registry 期望 `d3d6d05c…`，runner 计算为 `ec528fc8…`，因此 Agent 在 import-time fail closed。
+- 触发条件：版本化 RishiAI 上游参考仓包含 `.agents/rules`、14 个 `.agents/skills` 和 14 个 `.agents/workflows` 文件，但仓库根 `.gitignore` 的非锚定 `.agents/` 规则也匹配该嵌套上游目录，使文件留在本地快照却没有进入 Git tree。
+- 根因：package hash 正确地覆盖完整磁盘树，但外层 ignore 规则把上游 README 明确列为仓库组成部分的 29 个文件静默漏提交。核对结果为本地 1175 files、tracked/clean archive 1146 files；差集正好是 `references/open_source_sources/rishi-ai-mcp/.agents/` 的 29 个上游文件。本地完整快照 hash 为 registry 已登记的 `d3d6d05c1da25bb684af3be591687f0321b9a3a69a9896454ea3e25b57b6071b`，残缺 clean tree 才产生 `ec528fc873aca4b971ca8e537d076fefdec47825a11be9572158f1274004d6d6`。
+- 修复：保留严格的完整 package hash 算法与既有 `d3d6…` identity；在根 `.gitignore` 中只为该精确版本化 RishiAI 路径增加反向例外，并提交 29 个上游 `.agents` 文件。没有全局放开 `.agents`，也没有把普通未知文件或上游源码排除在 identity 外。
+- 验证：检查 `git ls-files` 与本地 package traversal 均为 1175 files；当前树和由候选提交生成的 clean Git archive 必须得到同一 `d3d6…` hash。聚焦 Agent/registry 测试、全量前端测试、TypeScript、ESLint、quick gate 与正式 staging gate 均不得调用 Playwright/Chrome。
+- 防复发：版本化第三方研究快照必须检查外层 ignore 规则导致的漏文件；registry hash 必须从完整、可由 clean checkout 重建的 Git tree 生成，不能通过放宽 hash traversal 掩盖缺失源码。
+- 相关记录：BUG-190、BUG-191
+- 修复版本：本次功能分支提交（精确 SHA 以提交、远程分支和 staging 发布核对结果为准）