Skip to content

refactor(tool): rename search_issues to search across all surfaces (patch)#127

Merged
liplus-lin-lay merged 1 commit into
mainfrom
126-tool-rename-search_issues-to-search-across-all-surfaces
Apr 25, 2026
Merged

refactor(tool): rename search_issues to search across all surfaces (patch)#127
liplus-lin-lay merged 1 commit into
mainfrom
126-tool-rename-search_issues-to-search-across-all-surfaces

Conversation

@liplus-lin-lay
Copy link
Copy Markdown
Member

概要

統合検索ツールの命名を実態に合わせて修正する。search_issuessearch、表示名 Search IssuesSearch GitHub、関連 docs / manifest / コメント / エラーメッセージも全て同期。

過去に「search だけに変えて」要望があった際に「_issues」suffix が誤って残った経緯。今回完全 rename で解消。

変更内容

  • 関数名: `search_issues` → `search`
  • 表示名: `Search Issues` → `Search GitHub`
  • .mcpb manifest description (broaden scope phrasing)
  • Worker tool 登録 (`src/mcp.ts` L108) + local bridge dispatch (`mcp-server/server/index.js` L420)
  • エラーメッセージ / コメント / 移行 SQL コメント / README / docs 全箇所

影響範囲

  • 関数名変更は breaking change(AI / tool consumer の `mcp__github-rag-mcp__search_issues` 呼び出しは無効になる、新名 `mcp__github-rag-mcp__search` に切り替え必要)
  • v0.x 初期開発期 (`Anything may change`) のため許容、patch 扱い
  • データ schema (D1 / Vectorize / KV) には影響なし
  • 既存 transcript / RAG index / docs 内の `search_issues` 表記は履歴として残るが、tool として callable な name は新名のみ

テスト

`mcp-server/npm test` (= `node --check server/index.js`) syntax check pass。Worker 側に既存テストは無し、syntax check + 既存 CI に依存。

バージョン

patch (v0.8.3 milestone)。v0.x 初期開発期で breaking 許容、scope は命名修正のみで実装ロジック変更なし。

関連

Tool name was misleading — the unified tool searches issues, PRs, releases,
docs, commit diffs, comments, reviews, and inline review comments, not just
issues. Originally requested as "search" only; the "_issues" suffix was added
in error and persisted across iterations.

Rename:
- function name: `search_issues` → `search`
- display title: `Search Issues` → `Search GitHub`
- .mcpb manifest description / long_description: tool reference + scope phrasing
- Worker tool registration (src/mcp.ts L108) + bridge dispatch (mcp-server/server/index.js L420)
- error messages (src/mcp.ts L698) + comments (src/index.ts, src/mcp.ts header)
- migration SQL comment (migrations/0002_fts5_rebuild.sql)
- README / docs / manifest 全箇所

データ schema (D1 / Vectorize / KV) には影響なし。tool 名のみの公開インタフェース変更。
v0.x 初期開発期 (Anything may change) のため breaking 容認、patch 扱い。

Closes #126
@liplus-lin-lay liplus-lin-lay linked an issue Apr 25, 2026 that may be closed by this pull request
@cloudflare-workers-and-pages
Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Updated (UTC)
✅ Deployment successful!
View logs
github-rag-mcp d57b0b7 Apr 25 2026, 03:46 PM

Copy link
Copy Markdown
Member Author

@liplus-lin-lay liplus-lin-lay left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 自己レビュー (auto, patch)

仕様適合

  • #126 の target_files 11 個すべて反映確認 (grep で残存 `search_issues` / `Search Issues` / `searchIssues` ゼロ)
  • 関数名 / 表示名 / manifest description / Worker tool 登録 / bridge dispatch / error 文字列 / コメント / 移行 SQL コメント / README / docs 全網羅
  • v0.x 初期開発期で breaking 容認、patch 判定 (`rules/operations/release-version.md` の "Anything may change" 範囲)

内容整合

  • function name と display name が manifest / 内部コード / docs で一致
  • Worker tool 名 (`src/mcp.ts` L108) と local bridge (`mcp-server/server/index.js` L420) を同期更新済み、protocol-level 整合性確保
  • D1 / Vectorize / KV schema には未触
  • manifest description は scope 拡大に合わせて "issues and PRs" → "issues, PRs, releases, docs, commit diffs, and review threads" に更新(命名と説明の semantic 整合)

自己リスク申告

  • Breaking change 周知: 既存 transcript / docs に残る `search_issues` 表記を読んだ後続セッションが古い tool 名で呼び出すと 404。AI 側 tool reload で解決するが、過去 transcript の literal は不可逆
  • CI 緑だが Worker 統合テスト無し: syntax check のみ通過、Worker 配備後の実機 search 動作は未検証。release/deploy 段階で要確認
  • 本 session workspace の `mcp__github-rag-mcp__search_issues` tool は MCP server 再起動 (= Claude Code 再起動 + 次回 npx pull) で `mcp__github-rag-mcp__search` に切り替わる予定。現セッション中は古い名で残存

判定

auto patch self-review 承認、`gh pr merge --squash` で進める。

@liplus-lin-lay liplus-lin-lay merged commit 53d8fee into main Apr 25, 2026
3 checks passed
@liplus-lin-lay liplus-lin-lay deleted the 126-tool-rename-search_issues-to-search-across-all-surfaces branch April 25, 2026 15:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

tool: rename search_issues to search across all surfaces

1 participant