参考資料と出典

設定スキーマ

Lagune プロジェクトの設定ファイルに使う JSON Schema です。エディターでの自動補完と検証に使え、最新の Lagune に追従させることも、特定のバージョンに固定することもできます。

.lagune/configs.json は、プロジェクトが使う カテゴリ を記録し、プロジェクト独自の 専門知識 の索引を持つファイルです。この JSON Schema を使うと、ファイルを編集している間、エディターが各フィールドを自動補完し、タイプミスや存在しないカテゴリを指摘してくれます。

最新のスキーマ​

Lagune はこのファイルを書き込むとき、$schema が見つからなければ、ファイルが最新のスキーマを指すように設定します:

{
"$schema": "https://lagune.ai/schemas/configs.json",
"categories": ["owasp", "javascript"]
}

このアドレスは常に最新の Lagune に追従します。Lagune 0.16.0 より前に書かれたファイルには次に変更されるときに追加され、それまではどのフェーズもそのことを知らせます。

バージョンを固定する​

0.16.0 以降の Lagune の各リリースには、そのバージョン時点のスキーマが含まれており、npm で公開され、jsDelivr から配信されます。バージョンを固定するには、lagune@ の後ろにバージョンを書いたアドレスを $schema に指定します:

{
"$schema": "https://cdn.jsdelivr.net/npm/lagune@0.16.0/schemas/configs.json"
}

バージョンには任意の semver 範囲を指定できます:

バージョンスキーマ
0.16.00.16.0 のスキーマ
0.16.x または 0.160.16 系の最新リリースのスキーマ
0.x または 00.x 系の最新リリースのスキーマ
latest最新リリースのスキーマ

よくある質問

いいえ。スキーマはエディターを補助するだけで、$schema があってもなくても、Lagune はファイルを同じように読み込みます。

いいえ。Lagune が $schema を書き込むのはファイルにまだない場合だけで、設定済みのアドレスはそのまま残します。

プロジェクトで特定のバージョンの Lagune を使っているときです。そうすれば、エディターはそのバージョンが受け付ける内容に照らしてファイルを検証します。