@follenfang/wowdoc 0.0.13 → 0.0.14

package/README.md

@@ -214,3 +214,19 @@ Tags follow `vMAJOR.MINOR.PATCH`. GitHub Actions tests Windows, Linux, and macOS
 ## License
 
 [MIT](LICENSE)
+
+## Search precision and index upgrade (v0.0.14)
+
+`query` and symbol `inspect` return the strongest available tier: exact definitions/facts, then prefixes only if there are no exact hits, then full text only if neither exists. Multiword full-text queries require all words in the indexed document. `explore` includes weaker tiers and matches any word for discovery. `%` and `_` are literal search characters, not SQL wildcards.
+
+`--topic api` filters generated API definitions; `lua`, `xml`, and `toc` filter source file types; `asset` searches indexed asset paths. Filtering and role ranking happen before the result limit. Duplicate evidence for the same definition is folded together; distinct definitions on one line are preserved. Both result and relation lists are individually bounded by `--limit`; query relations use exact names, while explore also finds substring relations. Invalid topics return `invalid_topic`.
+
+TOC validation caches repeated snapshot lookups, preserves every usage location, and returns at most five representative source matches per fact, with `matchCount` and `matchesTruncated` indicating omitted citations. This affects evidence size, not the validation coverage or verdict.
+
+The parser now indexes runtime event `LiteralName` values (for example `PLAYER_LOGIN`) as well as documentation aliases. Existing indexes need one refresh per source/product/ref used with the new parser:
+
+```powershell
+wowdoc index refresh --source wow-ui-source --product retail --ref 12.1.0
+```
+
+No repository resynchronization is needed when that commit is already local. Other snapshots are refreshed when needed; old parser indexes are not silently reused.

package/README.zh-CN.md

@@ -214,3 +214,19 @@ go run ./cmd/wowdoc --help
 ## License
 
 [MIT](LICENSE)
+
+## v0.0.14 查询与索引升级
+
+`query` 和符号 `inspect` 依次查找精确定义、前缀、全文，已有更强命中时不再填充弱结果。多词全文查询要求所有词出现在索引文档中。`explore` 保留跨层级、任意词匹配的发现能力。`%`、`_` 按普通字符处理。
+
+`--topic api` 只返回生成的 API 定义；`lua`、`xml`、`toc` 按文件类型过滤；`asset` 查找已索引资源路径。主题过滤和角色排序在限制条数之前执行，同一定义的重复证据合并，保留同一行上的不同定义。结果与关系列表分别受 `--limit` 限制；默认关系按完整名称匹配，`explore` 允许子串关系。错误主题返回 `invalid_topic`。
+
+TOC 校验复用快照查询，保留每个调用位置。每项事实最多附带五个代表性出处，使用 `matchCount`、`matchesTruncated` 明示总数和省略情况，不改变检查覆盖范围或结论。
+
+事件解析新增游戏实际使用的 `LiteralName`（例如 `PLAYER_LOGIN`），并保留文档名称别名。升级后，对需要使用的 source/product/ref 刷新一次索引：
+
+```powershell
+wowdoc index refresh --source wow-ui-source --product retail --ref 12.1.0
+```
+
+提交已在本地时无需重新同步仓库。其他快照按需刷新，旧解析器索引不会被静默复用。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@follenfang/wowdoc",
-  "version": "0.0.13",
+  "version": "0.0.14",
   "description": "Auditable WoW UI source intelligence CLI for coding agents",
   "license": "MIT",
   "type": "module",
@@ -21,11 +21,11 @@
     "LICENSE"
   ],
   "optionalDependencies": {
-    "@follenfang/wowdoc-darwin-arm64": "0.0.13",
-    "@follenfang/wowdoc-darwin-x64": "0.0.13",
-    "@follenfang/wowdoc-linux-arm64": "0.0.13",
-    "@follenfang/wowdoc-linux-x64": "0.0.13",
-    "@follenfang/wowdoc-win32-x64": "0.0.13"
+    "@follenfang/wowdoc-darwin-arm64": "0.0.14",
+    "@follenfang/wowdoc-darwin-x64": "0.0.14",
+    "@follenfang/wowdoc-linux-arm64": "0.0.14",
+    "@follenfang/wowdoc-linux-x64": "0.0.14",
+    "@follenfang/wowdoc-win32-x64": "0.0.14"
   },
   "scripts": {
     "postinstall": "node scripts/install.mjs",

package/skill/references/commands.md

@@ -50,3 +50,19 @@ wowdoc init
 ```
 
 The override applies to every wowdoc command launched from that environment. `wowdoc doctor` reports the resolved `home`. The npm package remains in the npm global prefix, and the Skill remains in `~/.agents/skills/wowdoc`.
+
+## Search precision and index upgrade (v0.0.14)
+
+`query` and symbol `inspect` return the strongest available tier: exact definitions/facts, then prefixes only if there are no exact hits, then full text only if neither exists. Multiword full-text queries require all words in the indexed document. `explore` includes weaker tiers and matches any word for discovery. `%` and `_` are literal search characters, not SQL wildcards.
+
+`--topic api` filters generated API definitions; `lua`, `xml`, and `toc` filter source file types; `asset` searches indexed asset paths. Filtering and role ranking happen before the result limit. Duplicate evidence for the same definition is folded together; distinct definitions on one line are preserved. Both result and relation lists are individually bounded by `--limit`; query relations use exact names, while explore also finds substring relations. Invalid topics return `invalid_topic`.
+
+TOC validation caches repeated snapshot lookups, preserves every usage location, and returns at most five representative source matches per fact, with `matchCount` and `matchesTruncated` indicating omitted citations. This affects evidence size, not the validation coverage or verdict.
+
+The parser now indexes runtime event `LiteralName` values (for example `PLAYER_LOGIN`) as well as documentation aliases. Existing indexes need one refresh per source/product/ref used with the new parser:
+
+```powershell
+wowdoc index refresh --source wow-ui-source --product retail --ref 12.1.0
+```
+
+No repository resynchronization is needed when that commit is already local. Other snapshots are refreshed when needed; old parser indexes are not silently reused.