qfai 1.0.1 → 1.0.2

package/README.md

@@ -79,7 +79,7 @@ QFAI が提供するプロンプト資産は次の 2 つに分離します。
 
 同じ相対パスのファイルがある場合は `.qfai/prompts.local` を優先して参照する運用とします。
 
-`report.json` / `doctor.json` は内部表現で互換非保証です。外部連携は `report.md` など Markdown 出力を推奨します。破壊的変更は SemVer で管理しますが、JSON schema を固定する約束はしません。短い例:
+`report.json` / `doctor.json` は内部表現で互換非保証です。外部連携は `report.md` など Markdown 出力を推奨します。破壊的変更は原則 SemVer で管理しますが、プロジェクト方針により例外的に minor/patch で破壊的変更を行う場合があります（CHANGELOG に明記）。JSON schema を固定する約束はしません。短い例:
 
 ```json
 {
@@ -239,7 +239,7 @@ qfai.config.yaml
     spec-0001/
       spec.md
       delta.md
-      scenario.md
+      scenario.feature
   rules/
     conventions.md
     pnpm.md

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

@@ -17,11 +17,11 @@ npx qfai report
 
 - `validation.traceability.testFileGlobs` に一致するテストコードで `QFAI:SC-xxxx` を参照する（コメント可）
 - Spec→Contract は `spec.md` の `QFAI-CONTRACT-REF` 行で宣言する
-- Scenario→Contract は `scenario.md` の `# QFAI-CONTRACT-REF` で宣言する（none 可）
+- Scenario→Contract は `scenario.feature` の `# QFAI-CONTRACT-REF` で宣言する（none 可）
 
 ## ディレクトリ概要
 
-- `specs/` : Spec Pack（spec.md / delta.md / scenario.md）
+- `specs/` : Spec Pack（spec.md / delta.md / scenario.feature）
 - `contracts/` : UI / API / DB 契約を置く場所
 - `require/` : 既存要件の集約（validate 対象外）
 - `rules/` : 規約・運用ルール

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

@@ -63,7 +63,7 @@ CREATE TABLE sample_table (
 ## 依存関係
 
 - Spec → Contracts（spec.md に `QFAI-CONTRACT-REF` を必ず1行以上宣言、0件は `none`。この行が SSOT）
-- Scenario → Contracts（scenario.md に `# QFAI-CONTRACT-REF` を必ず1行以上宣言、0件は `none`）
+- Scenario → Contracts（scenario.feature に `# QFAI-CONTRACT-REF` を必ず1行以上宣言、0件は `none`）
 
 ## 良い例 / 悪い例
 

package/assets/init/.qfai/prompts/makeBusinessFlow.md

@@ -5,7 +5,7 @@ Spec群を読み、Specに明示されている情報のみを根拠として、
 
 ## Inputs
 
-- 対象: `.qfai/specs/spec-*/spec.md` 形式のファイル（Spec Pack の `spec.md`。必要に応じて `scenario.md` / `delta.md` も補助参照）
+- 対象: `.qfai/specs/spec-*/spec.md` 形式のファイル（Spec Pack の `spec.md`。必要に応じて `scenario.feature` / `delta.md` も補助参照）
 
 ## Output (Option)
 

package/assets/init/.qfai/prompts/makeOverview.md

@@ -4,7 +4,7 @@
 
 ## Inputs
 
-- 対象: `.qfai/specs/spec-*/spec.md` 形式のファイル（Spec Pack の `spec.md`。必要に応じて `scenario.md` / `delta.md` も補助参照）
+- 対象: `.qfai/specs/spec-*/spec.md` 形式のファイル（Spec Pack の `spec.md`。必要に応じて `scenario.feature` / `delta.md` も補助参照）
 
 ## Output
 

package/assets/init/.qfai/prompts/qfai-maintain-traceability.md

@@ -9,7 +9,7 @@
 
 ## 必須入力
 
-- `.qfai/specs/**/spec.md` / `scenario.md` / `delta.md`
+- `.qfai/specs/**/spec.md` / `scenario.feature` / `delta.md`
 - `.qfai/out/validate.json`（あれば）
 - `.qfai/out/report.md`（あれば）
 - テストコード（`validation.traceability.testFileGlobs` に一致する範囲）

package/assets/init/.qfai/prompts/require-to-spec.md

@@ -11,7 +11,7 @@
 
 - `.qfai/specs/spec-0001/spec.md`
 - `.qfai/specs/spec-0001/delta.md`
-- `.qfai/specs/spec-0001/scenario.md`
+- `.qfai/specs/spec-0001/scenario.feature`
 - 必要に応じて `.qfai/contracts/{ui,api,db}` 配下
 
 > Spec は `spec-0001` から開始し、必要なら連番で増やすこと。
@@ -23,7 +23,7 @@
 - `spec.md` の必須セクションは `qfai.config.yaml` の設定に従う。
 - BR は `## 業務ルール` にのみ定義し、`- [BR-0001][P1] ...` 形式で書く。
 - `spec.md` に `QFAI-CONTRACT-REF:` を必ず記載する（不要なら `none`）。
-- `scenario.md` は Gherkin で書き、Feature に `@SPEC-xxxx` を付与する。
+- `scenario.feature` は Gherkin で書き、Feature に `@SPEC-xxxx` を付与する。
 - 各 Scenario は `@SC-xxxx` を **ちょうど1つ**、`@BR-xxxx` を **1つ以上**持つこと。
 - 契約ファイルには `QFAI-CONTRACT-ID: <ID>` を宣言する。
 - 契約 ID（UI/API/DB）を Scenario で参照する場合はタグまたは本文に明示する。

package/assets/init/.qfai/samples/analyze/analysis.md

@@ -12,7 +12,7 @@
 ## 入力（貼り付けたもの）
 
 - Spec: <spec.md / delta.md の該当範囲>
-- Scenario: <scenario.md の該当範囲>
+- Scenario: <scenario.feature の該当範囲>
 - Contract（任意）: <該当契約>
 - validate/report 要約: <report.md または validate.json の要約>
 - 差分: <PR diff / 変更ファイル一覧>

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

@@ -6,7 +6,7 @@
 
 - `spec-0001/spec.md`（必須）
 - `spec-0001/delta.md`（必須）
-- `spec-0001/scenario.md`（必須・Gherkin）
+- `spec-0001/scenario.feature`（必須・Gherkin）
 
 > `spec-0001` は **4桁連番**。Spec ID も **4桁（SPEC-0001）** です。
 
@@ -42,7 +42,7 @@ QFAI-CONTRACT-REF: UI-0001, API-0001, DB-0001
 - 互換維持 / 仕様変更の **どちらか1つ**に必ずチェックする
 - 根拠と影響範囲を明記する
 
-## Scenario（scenario.md）最小要件
+## Scenario（scenario.feature）最小要件
 
 - **Gherkin 記法**（Given/When/Then）
 - **1ファイル = 1 Scenario**（Scenario Outline 含む）

package/assets/init/.qfai/specs/spec-0001/delta.md

@@ -16,7 +16,7 @@
 ## 影響範囲（Impact）
 
 - 仕様（spec.md）:
-- シナリオ（scenario.md）:
+- シナリオ（scenario.feature）:
 - 契約（contracts）:
 - 実装（src）:
 - テスト（tests）:

package/dist/cli/index.cjs

@@ -650,7 +650,7 @@ async function collectSpecEntries(specsRoot) {
     dir,
     specPath: import_node_path4.default.join(dir, "spec.md"),
     deltaPath: import_node_path4.default.join(dir, "delta.md"),
-    scenarioPath: import_node_path4.default.join(dir, "scenario.md")
+    scenarioPath: import_node_path4.default.join(dir, "scenario.feature")
   }));
   return entries.sort((a, b) => a.dir.localeCompare(b.dir));
 }
@@ -1160,8 +1160,8 @@ var import_promises8 = require("fs/promises");
 var import_node_path9 = __toESM(require("path"), 1);
 var import_node_url2 = require("url");
 async function resolveToolVersion() {
-  if ("1.0.1".length > 0) {
-    return "1.0.1";
+  if ("1.0.2".length > 0) {
+    return "1.0.2";
   }
   try {
     const packagePath = resolvePackageJsonPath();
@@ -2625,12 +2625,11 @@ async function validateScenarios(root, config) {
   const specsRoot = resolvePath(root, config, "specsDir");
   const entries = await collectSpecEntries(specsRoot);
   if (entries.length === 0) {
-    const expected = "spec-0001/scenario.md";
-    const legacy = "spec-001/scenario.md";
+    const expected = "spec-0001/scenario.feature";
     return [
       issue4(
         "QFAI-SC-000",
-        `Scenario \u30D5\u30A1\u30A4\u30EB\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002\u914D\u7F6E\u5834\u6240: ${config.paths.specsDir} / \u671F\u5F85\u30D1\u30BF\u30FC\u30F3: ${expected} (${legacy} \u306F\u975E\u5BFE\u5FDC)`,
+        `Scenario \u30D5\u30A1\u30A4\u30EB\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002\u914D\u7F6E\u5834\u6240: ${config.paths.specsDir} / \u671F\u5F85\u30D1\u30BF\u30FC\u30F3: ${expected}`,
         "info",
         specsRoot,
         "scenario.files"
@@ -2647,7 +2646,7 @@ async function validateScenarios(root, config) {
         issues.push(
           issue4(
             "QFAI-SC-001",
-            "scenario.md \u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002",
+            "scenario.feature \u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002",
             "error",
             entry.scenarioPath,
             "scenario.exists"