feat(tools): ripgrep 子进程替换 glob 性能 (fix #10) · Pull Request !11 · andershsueh/alice-cli

## 对应 issue
- IK8MWP #10 ripgrep 子进程替换 glob 性能

## 变更
- **新增** `src/utils/ripgrepRunner.ts`:Bun.spawn 封装 `rg --files` / `rg --json`,
  进程内缓存 rg 可用性探测,失败一律 `ok:false` 让调用方决定降级,不抛"缺依赖"错
- **修改** `src/tools/builtin/searchFiles.ts`:优先走 `rg --files --glob PATTERN --glob !IGNORE`,
  ripgrep 不可用或 exit ≥ 2 时降级回 `glob` 库;rg 健康地返回 0 匹配不触发降级,避免重复全目录扫描
- **新增** `test-case/test-issue-010.ts`:27 断言,覆盖 NDJSON 解析 / 空 PATH 降级 / ignore 对齐 / CI 基准
- **追加** `test-case/test-list.md`:issue #10 行(PR 号待回填)

## 设计决策
- 探测机制用 `rg --version` 直接 spawn,而非 `which rg` —— macOS `/usr/bin/which` 在 PATH 为空时会回退 `confstr(_CS_PATH)`,无法模拟"PATH 中无 rg"的状态,测试改 `process.env.PATH = ""` 才能准确触发降级路径
- `runRipgrepFiles` 返回判别联合 `{ ok: true; files: string[] } | { ok: false; reason }`,
  而非简单 `string[]` —— 避免把"rg 健康返回 0 匹配"误判为"rg 失败"导致每次合法空结果都触发 glob 全量重扫
- `isRipgrepAvailable` 同步返回(仅读缓存),无需 microtask 开销
- `runRipgrepJson` 暴露但不强行配套 `searchContent` 工具,留作后续扩展

## 测试
- `bun run test-case/test-issue-010.ts` —— 27 PASS / 0 FAIL
- 全量回归:001(27) + 002(36) + 003(34) + 004(25) + 005(9) + 019(37) + 010(27) = **195 PASS / 0 FAIL**
- `bun build.ts` —— 构建成功

## 验收对照
| 验收项 | 状态 |
|--------|------|
| ① ripgrepRunner 解析 `rg --json` NDJSON,产出 `{path,line,text}[]` | ✓ |
| ② 移除 PATH 中 rg 时,自动降级到 glob 路径,不抛"缺依赖"错 | ✓ |
| ③ 默认 ignore 列表与现有行为对齐的回归断言 | ✓ |
| ④ CI 基准:searchFiles 在 repo 内跑通;rg 路径 p50 < 500ms | ✓(实测 ~7ms) |

## 风险点
- `src/config/settingsSchema.ts:999-1017` 的 `useRipgrep` / `useBuiltinRipgrep` 仍是死代码:
  `useRipgrep` 是合理的 kill-switch,后续 PR 可接入;
  `useBuiltinRipgrep` 暗示内置二进制(`@vscode/ripgrep` 等),但本仓库未打包,建议下一轮或清理
- `src/utils/userStartupWarnings.ts:63-80` 的 `ripgrepAvailabilityCheck` 通过死 shim
  `canUseRipgrep()` 永远返回 false,启动警告会误报"Ripgrep not available" —— 等真接入时一并修
- `rg --glob` 用 gitignore 风格(非 shell glob),与 `glob` 库有微妙差异;
  已在 test ③ 用集合相等性断言覆盖,当前 fixture 一致
- 仓库现有 `glob` 库使用点还有 `src/services/FileCommandLoader.ts` 与
  `src/services/command-migration-tool.ts`,本 PR 未动(范围控制);后续可单独 PR 迁移

Generated with [Claude Code](https://claude.com/claude-code)

Type	Assign personnel	Status
Reviewer	andershsueh Pass review	Completed (1/1 )
Tester	andershsueh Pass test	Completed (1/1 )

andershsueh / alice-cli .gitee-modal { width: 500px !important; }

Search

andershsueh / alice-cli