検証エラーリファレンス Stable
パックバリデーターは、安定した名前空間付きの診断コードを発行します。契約となるのは
code です。ツールは code で分岐し、メッセージ文字列で分岐することは決してありません。
以下の表は、@tenkacloud/problem-sdk の ValidationDiagnosticCode レジストリから
導出された規範的リファレンスです。すべてのコードにはこのページにユーザー向けの
説明があり、説明のないコードが追加された場合はドリフトチェックがビルドを失敗させます。
コード
| Code | What it means / how to fix it |
|---|---|
PACK_ARTIFACT_MISSING | A problem declares an artifact (template / entry) that does not exist. |
PACK_ARTIFACT_TRAVERSAL | A problem references a deploy artifact outside its own directory. |
PACK_DIR_MISSING | The pack directory does not exist. Check the path passed to the validator. |
PACK_DUPLICATE_PROBLEM_ID | Two problems in the pack declare the same id; ids must be unique. |
PACK_MANIFEST_INVALID | tenkacloud-pack.json failed schema validation. The accompanying path points at the offending field. |
PACK_MANIFEST_MISSING | No tenkacloud-pack.json was found at the pack root. |
PACK_MANIFEST_UNREADABLE | tenkacloud-pack.json exists but could not be read or parsed as JSON. |
PACK_PROBLEMS_ROOT_MISSING | The directory named by problemsRoot does not exist inside the pack. |
PACK_PROBLEMS_ROOT_TRAVERSAL | problemsRoot escapes the pack root (absolute path or '..' traversal). |
PROBLEM_METADATA_INVALID | A problem's metadata.json is not a valid object or a required field is missing / malformed. |
RUNTIME_MISMATCH | A declared runtime '(provider/engine)' is not a supported runtime capability (a typo or an unsupported pair). |
コードは PACK_* / PROBLEM_* / RUNTIME_* の名前空間を持ちます。コードの追加は
加算的な（マイナー）変更であり、コードの削除や意味の変更はメジャー変更です。
診断の読み方
各診断には、安定した code、問題のある値の位置を示す path
（tenkacloud-pack.json:id や metadata.json:scoring）、および修復方法を示す
message が含まれます。機械可読な出力を得るには
tenkacloud pack validate <dir> --json を実行してください。
関連: CLI リファレンス および パックマニフェストリファレンス。