トラブルシューティング

まずエラーの code を確認してください。 LangDriftError.issues には、検証に失敗した JSON Pointer パスが含まれます。 SetupError.files と .fields は、セットアップの競合と不足する入力を示します。

プロジェクトの読み込み

`PROJECT_NOT_FOUND`

上位への探索で .git ルートが見つからなかったか、.drifts/project.json がありません。対象の既存ルートを明示的に指定するか、そこでローカルセットアップを実行してください。

`PROJECT_INVALID`

プロジェクトファイルが不正な JSON か、プロジェクトスキーマと一致しません。手動で確認してください。セットアップは競合する内容を保持し、置き換えません。

`SCHEMA_UNSUPPORTED`

イベント、成果物、プロジェクト、推論エンベロープが 1 以外のスキーマバージョンを宣言しています。このリリース候補には移行経路がありません。バージョン 1 のスキーマに対してデータを確認せずに、番号だけを変更しないでください。

成果物と参照

`ARTIFACT_INVALID`

現在の原因には次があります。

不正な JSON、または欠落・不正な langdrift フロントマター
未対応の .md / .json の使用、または種別とディレクトリの不一致
未知のフィールドや、その他のスキーマ不一致
1 MiB を超えるファイルまたは本文
無効な探索上限、またはファイル数・ディレクトリ数の上限超過
ローカルの (type, id) 識別情報の重複
整合しない Drift の影響値、または Evidence の出所の欠落
不正な GitHub マージ済みプルリクエストのフィクスチャ

issues 内のフィールドパスを確認してください。パーサーは、見出しやファイル名から不足する識別情報を推測しません。

`PATH_OUTSIDE_ROOT`

パスが絶対パス、上位への移動、禁止された要素や文字を含むか、シンボリックリンクに到達しています。プロジェクトの .drifts ツリー配下の通常の相対パスを使ってください。探索はシンボリックリンクをたどりません。

参照の問題

REFERENCE_NOT_FOUND と REFERENCE_CYCLE は resolveReferences(...).issues に返され、例外としては送出されません。転送前に、明示的に既知の外部識別情報を登録する、正確な種別・ID・パスを修正する、またはローカル循環を除去してください。

認証情報と転送

`CREDENTIAL_MISSING`

参照が env:NAME 形式でないか、環境変数の値が欠落している、改行またはヌルバイトを含んでいます。渡すのは参照だけにし、値は実行環境に設定してください。

`REMOTE_UNAUTHORIZED`

注入した転送処理が 401 または 403 を報告しました。ルーティング用の account_id と project_id は認可を付与しません。実行時の認証情報と送信先のポリシーを確認してください。

`REMOTE_REJECTED`

注入した転送処理が、別の 4xx ステータスを報告しました。検証済みエンベロープと送信先の契約を確認してください。

`MCP_UNAVAILABLE`

分類可能な 4xx 応答なしで転送が失敗しました。ローカルのキューには何も保存されません。呼び出し側が提供したアダプターを確認してから再試行してください。

セットアップ

ROOT_INVALID — --root が既存のディレクトリを指していません。
SETUP_ARGUMENT_MISSING — 非対話実行では、プロジェクト ID、アカウント ID、名前を指定してください。
SETUP_ARGUMENT_INVALID — 対応フラグ、競合する真偽値フラグ、数値の GitHub インストール ID と owner/repository の組を確認してください。
SETUP_CONFLICT — 各ファイルの状態と理由を確認してください。事前確認では何も書き込まれていません。
SETUP_PATH_CONFLICT — 管理対象パスがシンボリックリンクであるか、親がディレクトリではありません。
SETUP_CONCURRENT_CHANGE — 事前確認後に出力先が変更され、その内容は保持されました。
SETUP_WRITE_FAILED — I/O エラーで作成が中断しました。先に作成したファイルが残る場合があるため、確認して再実行してください。

このバージョンは Loop を使い、旧形式の移行を行わないため、.drifts/execution は意図的に競合とみなします。

安全なアプリケーション診断のため、reportError(error, logger) はコード、汎用的なメッセージ、検証の問題を出力します。未知の例外本文とスタックは省略します。