Labs 記述子を確認する

Labs カタログを読み、ローカルの boundary-health 記述子を検証します。

Linux 上の Altifigence CLI 0.1.9 は、ローカルの Labs 記述子ワークフローを提供します。固定のワークフローカタログの確認、記述子のステータスの読み取り、および JSON boundary-health サマリーのチェックに使用します。コマンドは、レビューとともに保存できるメタデータを返します。まずカタログとステータスを確認し、どの記述子を検査しているかを明確にしてください。

保存した結果を読む前に、終了ステータスが 0 であることを確認してください。標準エラー出力は別に保存し、以下で説明する結果フィールドを確認します。

カタログを読む

alti labs inspect
alti labs status

小さな検証例として、以下の JSON を既存のプロジェクト内に boundary-health.json として保存します。この例には、空の health-card 配列と source-reference 配列が含まれており、バリデーターが受け入れる記述子構造を示しています。実質的な健全性レビューが必要な場合は、確認済みのインベントリに基づいて作業用サマリーを記入してください。識別情報、カバレッジ、および安全性のフィールドも、検査対象の構造に含まれます。

記述子を保存する

{
  "schemaVersion": "altifigence.lab.json-boundary-health-summary.v0",
  "tool": "alti-lab",
  "healthSummaryId": "local-example",
  "summaryState": "descriptor_only",
  "inventoryState": "checked_fixture",
  "sourceInventoryRef": {},
  "coverageSummary": {
    "overallState": "checked",
    "summaryOnly": true,
    "descriptorOnly": true
  },
  "consumerPolicy": {},
  "safetyFlags": {
    "dataOnly": true,
    "descriptorOnly": true,
    "readOnly": true,
    "summaryOnly": true,
    "commandExecution": false,
    "shellExecution": false,
    "runtimeExecution": false,
    "networkCalls": false,
    "repositoryMutation": false
  },
  "sourceCheckRefs": [],
  "healthCards": [],
  "driftGates": [],
  "blockedActions": [],
  "limitations": [],
  "issueRefs": []
}

保存したファイルを検証する

alti labs validate --project /absolute/project boundary-health.json

プロジェクトの絶対パスと、そのプロジェクトからの記述子の相対パスを使用します。コマンドが成功すると、検証済みの記述子が JSON として出力されます。返されたサマリーの識別情報を保存した入力と比較し、ファイルと出力を一緒に保持してください。検証では、記述子で宣言された構造を確認します。

検証出力を確認する

検証成功時の出力から、一部のフィールドを以下に示します。完全な出力では、他の記述子フィールドも保持されます。

{"schemaVersion":"altifigence.lab.json-boundary-health-summary.v0","tool":"alti-lab","healthSummaryId":"local-example","summaryState":"descriptor_only","inventoryState":"checked_fixture"}

unsupported JSON boundary health summary schema エラーが出た場合は、入力例のとおり schemaVersion を altifigence.lab.json-boundary-health-summary.v0 に設定して、検証を再実行してください。