トラブルシューティング
dagayn install がエディタに反映されない
Section titled “dagayn install がエディタに反映されない”--dry-run で生成内容を確認し、対象 --platform が検出されているか見る。一部統合はリポジトリローカル設定のみで、該当ディレクトリが存在しないと書き込まれない。
dagayn install --dry-run --platform cursorグラフが空、または古い
Section titled “グラフが空、または古い”dagayn builddagayn statusリポジトリをディスク上で移動した場合はフル再構築が必要。
dagayn build --force-full-buildMCP ツールがドキュメントセクションを見つけられない
Section titled “MCP ツールがドキュメントセクションを見つけられない”リポジトリまたはインストールパッケージに docs/LLM-OPTIMIZED-REFERENCE.md があるか確認する。自前リポジトリではMarkdown directiveと見出しslugが正しいか Markdown / Terraform 連携 を参照。
dagayn._core が見つからない
Section titled “dagayn._core が見つからない”wheelにRust拡張が含まれていない、またはsource checkoutで未ビルド。
pip install git+https://github.com/manji-0/dagayn.gitsource checkout:
uvx maturin develop --release旧Pythonパーサ実装は削除済み。_core なしでは動作しない。
hook が重い / 保存が遅い
Section titled “hook が重い / 保存が遅い”hookは既定で dagayn update --skip-flows を実行する。それでも重い場合：
- 対象リポジトリが非常に大きい
- 一度に大量ファイルを保存した
対処： 日常は --skip-flows のまま、週次や大変更後に dagayn build でフロー込み再計算。
セマンティック検索が効かない
Section titled “セマンティック検索が効かない”dagayn status埋め込みが empty / partial なら生成する。
dagayn build --local-embeddingfts-only インストールの場合はFTSのみが正常動作。 セマンティック検索 を参照。
型チェックがローカルだけ失敗する
Section titled “型チェックがローカルだけ失敗する”CIと同じコマンドを使う。
ty check dagayn --python-version 3.13 --ignore unresolved-importNotebook のセル番号がずれる
Section titled “Notebook のセル番号がずれる”notebook修正後に再ビルドする。パーサはspan overlapでセル帰属を安定化しているが、大幅なフォーマット変更後は dagayn build --force-full-build が確実。