qfai 0.3.8 → 0.4.0

package/README.md

@@ -20,6 +20,7 @@ npx qfai report
 
 - `npx qfai init` によるテンプレート生成（specs/contracts に加え、`.qfai/require/README.md`、`.qfai/rules/pnpm.md`、`.qfai/prompts/require-to-spec.md`、`.qfai/promptpack/` を含む）
 - `npx qfai validate` による `.qfai/` 内ドキュメントの整合性・トレーサビリティ検査
+- `npx qfai validate` による SC→Test 参照の検証（`tests/` 配下を走査）
 - `npx qfai report` によるレポート出力
 
 ## Usage
@@ -30,3 +31,9 @@ npx qfai report
 
 設定はリポジトリ直下の `qfai.config.yaml` で行います。
 命名規約は `docs/rules/naming.md` を参照してください。
+
+SC→Test 検証は `validation.traceability.scMustHaveTest` と
+`validation.traceability.scNoTestSeverity` で制御できます。
+
+- `validation.traceability.scMustHaveTest`: SC→Test 検証の有効/無効を制御（`true` で有効、`false` で無効）
+- `validation.traceability.scNoTestSeverity`: SC 未参照時の重要度を指定（`error` / `warning`）

package/assets/init/.qfai/README.md

@@ -9,6 +9,10 @@ npx qfai validate --fail-on error --format github
 npx qfai report
 ```
 
+## トレーサビリティ（SC→Test）
+
+- `tests/` 配下のテストコードで `SC-xxxx` を参照する（コメント可）
+
 ## ディレクトリ概要
 
 - `specs/` : Spec Pack（spec.md / delta.md / scenario.md）

package/assets/init/.qfai/specs/README.md

@@ -47,5 +47,5 @@
 - Spec: 必須セクション、SPEC/BR ID、BR Priority、ID 形式、Contract 参照の実在性
 - Delta: 変更区分（互換/変更）のチェック状態
 - Scenario: Feature/Scenario の存在、タグ要件、Given/When/Then
-- Traceability: BR→SC、SC→契約（UI/API/DATA）の接続、BR の所属 SPEC 整合
+- Traceability: BR→SC、SC→契約（UI/API/DATA）、SC→Test の接続、BR の所属 SPEC 整合
 - IDs: 定義 ID の重複検知（Spec/Scenario/Contracts）

package/assets/init/root/qfai.config.yaml

@@ -20,6 +20,8 @@ validation:
   traceability:
     brMustHaveSc: true
     scMustTouchContracts: true
+    scMustHaveTest: true
+    scNoTestSeverity: error
     allowOrphanContracts: false
     unknownContractIdSeverity: error
 output:

package/assets/init/root/tests/qfai-traceability.sample.test.ts

@@ -0,0 +1,2 @@
+// Traceability sample: reference SC IDs in tests (comments are enough).
+// SC-0001