As a nabledge-6 user, I want enriched search hints so that I can find relevant knowledge by class names

[kiyotis]

Situation

Current search hints focus on conceptual terms (ユニバーサルDAO, 排他制御) but lack concrete class/API names that users see in their code:

• Missing: SqlRow, VariableCondition, TransactionManagerConnection
• Missing: BasicBatchActionBase, DataReaderFactory, DatabaseTableQueueReader
• Missing: BeanValidation, Pagination, SelectOption
• Missing: Exception class names beyond OptimisticLockException (e.g., DuplicateKeyException, SqlStatementException)
• Missing: Error situations (一意制約違反, SQL実行エラー, カラム不一致)

Pain

Users who search by class names they see in import statements or stack traces get poor search results. They must manually browse knowledge files or try different conceptual terms.

Benefit

• Users can find relevant knowledge by searching with class names from their code
• Users can troubleshoot errors by searching with exception names from stack traces
• Developers can maintain more discoverable knowledge base

Success Criteria

Implementation (A1: Class/API Names)

• Add class and method names to .index[].hints in all 17 knowledge files
• Include commonly imported classes: SqlRow, VariableCondition, TransactionManagerConnection, etc.
• Include batch-specific classes: BasicBatchActionBase, DataReaderFactory, etc.
• Include validation/utility classes: BeanValidation, Pagination, SelectOption, etc.

Implementation (A2: Exception Names and Error Situations)

• Add exception class names to error-related sections: DuplicateKeyException, SqlStatementException, DbAccessException
• Add error situation terms: 一意制約違反, SQL実行エラー, カラム不一致

Performance Validation (minimum 10 simulation runs)

• Test with 10+ queries using class names (e.g., "SqlRow の使い方", "DuplicateKeyException の対処")
• Report includes: search accuracy improvement, recall rate, total execution time, phase-wise time distribution
• All test queries return relevant knowledge sections (100% recall)
• No regression in existing conceptual term searches
• Execution time not significantly impacted (within 5% variance)

Documentation

• Work notes document hint selection criteria and test results in .pr/xxxxx/notes.md
• Update CHANGELOG.md [Unreleased] section with improved discoverability

[kiyotis]

クローズ理由

全文検索（経路1）の導入により、このIssueで対応しようとしていた問題は実質的に解決されています。

判断根拠

全文検索で十分な理由:

• 全文検索は知識ファイルの本文全体を検索するため、クラス名が公式ドキュメント（RST）に記載されていれば自動的にヒットする
• hints はインデックス検索（経路2、フォールバック）のセクション選定にのみ使用されており、経路1では不要

RST の調査結果:

• DatabaseTableQueueReader → RST に存在するが messaging/db ドキュメントはまだ知識ファイル未作成（将来の知識ファイル追加時に自動対応）
• DuplicateKeyException, BasicBatchActionBase, DataReaderFactory, VariableCondition → 公式 RST ドキュメントに記載なし

公式ドキュメントに記載のないクラスについて:
Nablarch の公式ドキュメントで説明されていないクラスは、ユーザーが質問してくる可能性が低い。仮に質問された場合も、hints を追加しても知識ファイルにコンテンツがないため回答できない。

対応方針

hints への個別追加ではなく、知識ファイルの範囲拡充（messaging/db 等）を通じて自然に解決する。