qfai 0.2.9 → 0.3.0

package/dist/cli/index.cjs

@@ -160,7 +160,7 @@ function report(copied, skipped, dryRun, label) {
 }
 
 // src/cli/commands/report.ts
-var import_promises12 = require("fs/promises");
+var import_promises13 = require("fs/promises");
 var import_node_path10 = __toESM(require("path"), 1);
 
 // src/core/config.ts
@@ -535,7 +535,7 @@ function isRecord(value) {
 }
 
 // src/core/report.ts
-var import_promises11 = require("fs/promises");
+var import_promises12 = require("fs/promises");
 
 // src/core/discovery.ts
 var import_node_path6 = __toESM(require("path"), 1);
@@ -684,8 +684,8 @@ var import_promises4 = require("fs/promises");
 var import_node_path7 = __toESM(require("path"), 1);
 var import_node_url2 = require("url");
 async function resolveToolVersion() {
-  if ("0.2.9".length > 0) {
-    return "0.2.9";
+  if ("0.3.0".length > 0) {
+    return "0.3.0";
   }
   try {
     const packagePath = resolvePackageJsonPath();
@@ -988,29 +988,113 @@ function formatError2(error2) {
   return String(error2);
 }
 function issue(code, message, severity, file, rule, refs) {
-  const issue6 = {
+  const issue7 = {
+    code,
+    severity,
+    message
+  };
+  if (file) {
+    issue7.file = file;
+  }
+  if (rule) {
+    issue7.rule = rule;
+  }
+  if (refs && refs.length > 0) {
+    issue7.refs = refs;
+  }
+  return issue7;
+}
+
+// src/core/validators/decisions.ts
+var import_promises6 = require("fs/promises");
+
+// src/core/parse/adr.ts
+var ADR_ID_RE = /\bADR-\d{4}\b/;
+function extractField(md, key) {
+  const pattern = new RegExp(`^\\s*-\\s*${key}:\\s*(.+)\\s*$`, "m");
+  return md.match(pattern)?.[1]?.trim();
+}
+function parseAdr(md, file) {
+  const adrId = md.match(ADR_ID_RE)?.[0];
+  const fields = {};
+  const status = extractField(md, "Status");
+  const context = extractField(md, "Context");
+  const decision = extractField(md, "Decision");
+  const consequences = extractField(md, "Consequences");
+  const related = extractField(md, "Related");
+  if (status) fields.status = status;
+  if (context) fields.context = context;
+  if (decision) fields.decision = decision;
+  if (consequences) fields.consequences = consequences;
+  if (related) fields.related = related;
+  const parsed = {
+    file,
+    fields
+  };
+  if (adrId) {
+    parsed.adrId = adrId;
+  }
+  return parsed;
+}
+
+// src/core/validators/decisions.ts
+var REQUIRED_FIELDS = [
+  { key: "status", label: "Status" },
+  { key: "context", label: "Context" },
+  { key: "decision", label: "Decision" },
+  { key: "consequences", label: "Consequences" }
+];
+async function validateDecisions(root, config) {
+  const decisionsRoot = resolvePath(root, config, "decisionsDir");
+  const files = await collectFiles(decisionsRoot, { extensions: [".md"] });
+  if (files.length === 0) {
+    return [];
+  }
+  const issues = [];
+  for (const file of files) {
+    const text = await (0, import_promises6.readFile)(file, "utf-8");
+    const parsed = parseAdr(text, file);
+    const missing = REQUIRED_FIELDS.filter(
+      (field) => !parsed.fields[field.key]
+    );
+    if (missing.length > 0) {
+      issues.push(
+        issue2(
+          "QFAI-ADR-001",
+          `ADR \u5FC5\u9808\u30D5\u30A3\u30FC\u30EB\u30C9\u304C\u4E0D\u8DB3\u3057\u3066\u3044\u307E\u3059: ${missing.map((field) => field.label).join(", ")}`,
+          "error",
+          file,
+          "adr.requiredFields"
+        )
+      );
+    }
+  }
+  return issues;
+}
+function issue2(code, message, severity, file, rule, refs) {
+  const issue7 = {
     code,
     severity,
     message
   };
   if (file) {
-    issue6.file = file;
+    issue7.file = file;
   }
   if (rule) {
-    issue6.rule = rule;
+    issue7.rule = rule;
   }
   if (refs && refs.length > 0) {
-    issue6.refs = refs;
+    issue7.refs = refs;
   }
-  return issue6;
+  return issue7;
 }
 
 // src/core/validators/ids.ts
-var import_promises7 = require("fs/promises");
+var import_promises8 = require("fs/promises");
 var import_node_path9 = __toESM(require("path"), 1);
 
 // src/core/contractIndex.ts
-var import_promises6 = require("fs/promises");
+var import_promises7 = require("fs/promises");
 async function buildContractIndex(root, config) {
   const uiRoot = resolvePath(root, config, "uiContractsDir");
   const apiRoot = resolvePath(root, config, "apiContractsDir");
@@ -1033,7 +1117,7 @@ async function buildContractIndex(root, config) {
 }
 async function indexUiContracts(files, index) {
   for (const file of files) {
-    const text = await (0, import_promises6.readFile)(file, "utf-8");
+    const text = await (0, import_promises7.readFile)(file, "utf-8");
     try {
       const doc = parseStructuredContract(file, text);
       extractUiContractIds(doc).forEach((id) => record(index, id, file));
@@ -1045,7 +1129,7 @@ async function indexUiContracts(files, index) {
 }
 async function indexApiContracts(files, index) {
   for (const file of files) {
-    const text = await (0, import_promises6.readFile)(file, "utf-8");
+    const text = await (0, import_promises7.readFile)(file, "utf-8");
     try {
       const doc = parseStructuredContract(file, text);
       extractApiContractIds(doc).forEach((id) => record(index, id, file));
@@ -1057,7 +1141,7 @@ async function indexApiContracts(files, index) {
 }
 async function indexDataContracts(files, index) {
   for (const file of files) {
-    const text = await (0, import_promises6.readFile)(file, "utf-8");
+    const text = await (0, import_promises7.readFile)(file, "utf-8");
     extractIds(text, "DATA").forEach((id) => record(index, id, file));
   }
 }
@@ -1068,7 +1152,158 @@ function record(index, id, file) {
   index.idToFiles.set(id, current);
 }
 
+// src/core/parse/gherkin.ts
+var FEATURE_RE = /^\s*Feature:\s+/;
+var SCENARIO_RE = /^\s*Scenario:\s*(.+)\s*$/;
+var TAG_LINE_RE = /^\s*@/;
+function parseTags(line) {
+  return line.trim().split(/\s+/).filter((tag) => tag.startsWith("@")).map((tag) => tag.replace(/^@/, ""));
+}
+function parseGherkinFeature(text, file) {
+  const lines = text.split(/\r?\n/);
+  const scenarios = [];
+  let featurePresent = false;
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i] ?? "";
+    if (FEATURE_RE.test(line)) {
+      featurePresent = true;
+    }
+    const match = line.match(SCENARIO_RE);
+    if (!match) continue;
+    const scenarioName = match[1];
+    if (!scenarioName) continue;
+    const tags = [];
+    for (let j = i - 1; j >= 0; j--) {
+      const previous = lines[j] ?? "";
+      if (previous.trim() === "") continue;
+      if (!TAG_LINE_RE.test(previous)) break;
+      tags.unshift(...parseTags(previous));
+    }
+    scenarios.push({ name: scenarioName, line: i + 1, tags });
+  }
+  return { file, featurePresent, scenarios };
+}
+
+// src/core/parse/markdown.ts
+var HEADING_RE = /^(#{1,6})\s+(.+?)\s*$/;
+function parseHeadings(md) {
+  const lines = md.split(/\r?\n/);
+  const headings = [];
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i] ?? "";
+    const match = line.match(HEADING_RE);
+    if (!match) continue;
+    const levelToken = match[1];
+    const title = match[2];
+    if (!levelToken || !title) continue;
+    headings.push({
+      level: levelToken.length,
+      title: title.trim(),
+      line: i + 1
+    });
+  }
+  return headings;
+}
+function extractH2Sections(md) {
+  const lines = md.split(/\r?\n/);
+  const headings = parseHeadings(md).filter((heading) => heading.level === 2);
+  const sections = /* @__PURE__ */ new Map();
+  for (let i = 0; i < headings.length; i++) {
+    const current = headings[i];
+    if (!current) continue;
+    const next = headings[i + 1];
+    const startLine = current.line + 1;
+    const endLine = (next?.line ?? lines.length + 1) - 1;
+    const body = startLine <= endLine ? lines.slice(startLine - 1, endLine).join("\n") : "";
+    sections.set(current.title.trim(), {
+      title: current.title.trim(),
+      startLine,
+      endLine,
+      body
+    });
+  }
+  return sections;
+}
+
+// src/core/parse/spec.ts
+var SPEC_ID_RE = /\bSPEC-\d{4}\b/;
+var BR_LINE_RE = /^\s*-\s*\[?(BR-\d{4})\]?\s*\((P[0-3])\)\s*(.+)$/;
+var BR_LINE_ANY_PRIORITY_RE = /^\s*-\s*\[?(BR-\d{4})\]?\s*\((P[^)]+)\)\s*(.+)$/;
+var BR_LINE_NO_PRIORITY_RE = /^\s*-\s*\[?(BR-\d{4})\]?\s+(?!\()(.*\S.*)$/;
+var BR_SECTION_TITLE = "\u696D\u52D9\u30EB\u30FC\u30EB";
+var VALID_PRIORITIES = /* @__PURE__ */ new Set(["P0", "P1", "P2", "P3"]);
+function parseSpec(md, file) {
+  const headings = parseHeadings(md);
+  const h1 = headings.find((heading) => heading.level === 1);
+  const specId = h1?.title.match(SPEC_ID_RE)?.[0];
+  const sections = extractH2Sections(md);
+  const sectionNames = new Set(Array.from(sections.keys()));
+  const brSection = sections.get(BR_SECTION_TITLE);
+  const brLines = brSection ? brSection.body.split(/\r?\n/) : [];
+  const startLine = brSection?.startLine ?? 1;
+  const brs = [];
+  const brsWithoutPriority = [];
+  const brsWithInvalidPriority = [];
+  for (let i = 0; i < brLines.length; i++) {
+    const lineText = brLines[i] ?? "";
+    const lineNumber = startLine + i;
+    const validMatch = lineText.match(BR_LINE_RE);
+    if (validMatch) {
+      const id = validMatch[1];
+      const priority = validMatch[2];
+      const text = validMatch[3];
+      if (!id || !priority || !text) continue;
+      brs.push({
+        id,
+        priority,
+        text: text.trim(),
+        line: lineNumber
+      });
+      continue;
+    }
+    const anyPriorityMatch = lineText.match(BR_LINE_ANY_PRIORITY_RE);
+    if (anyPriorityMatch) {
+      const id = anyPriorityMatch[1];
+      const priority = anyPriorityMatch[2];
+      const text = anyPriorityMatch[3];
+      if (!id || !priority || !text) continue;
+      if (!VALID_PRIORITIES.has(priority)) {
+        brsWithInvalidPriority.push({
+          id,
+          priority,
+          text: text.trim(),
+          line: lineNumber
+        });
+      }
+      continue;
+    }
+    const noPriorityMatch = lineText.match(BR_LINE_NO_PRIORITY_RE);
+    if (noPriorityMatch) {
+      const id = noPriorityMatch[1];
+      const text = noPriorityMatch[2];
+      if (!id || !text) continue;
+      brsWithoutPriority.push({
+        id,
+        text: text.trim(),
+        line: lineNumber
+      });
+    }
+  }
+  const parsed = {
+    file,
+    sections: sectionNames,
+    brs,
+    brsWithoutPriority,
+    brsWithInvalidPriority
+  };
+  if (specId) {
+    parsed.specId = specId;
+  }
+  return parsed;
+}
+
 // src/core/validators/ids.ts
+var SC_TAG_RE = /^SC-\d{4}$/;
 async function validateDefinedIds(root, config) {
   const issues = [];
   const specRoot = resolvePath(root, config, "specDir");
@@ -1092,7 +1327,7 @@ async function validateDefinedIds(root, config) {
     }
     const sorted = Array.from(files).sort();
     issues.push(
-      issue2(
+      issue3(
         "QFAI-ID-001",
         `ID \u304C\u91CD\u8907\u3057\u3066\u3044\u307E\u3059: ${id} (${formatFileList(sorted, root)})`,
         "error",
@@ -1105,15 +1340,25 @@ async function validateDefinedIds(root, config) {
 }
 async function collectSpecDefinitionIds(files, out) {
   for (const file of files) {
-    const text = await (0, import_promises7.readFile)(file, "utf-8");
-    extractIds(text, "SPEC").forEach((id) => recordId(out, id, file));
-    extractIds(text, "BR").forEach((id) => recordId(out, id, file));
+    const text = await (0, import_promises8.readFile)(file, "utf-8");
+    const parsed = parseSpec(text, file);
+    if (parsed.specId) {
+      recordId(out, parsed.specId, file);
+    }
+    parsed.brs.forEach((br) => recordId(out, br.id, file));
   }
 }
 async function collectScenarioDefinitionIds(files, out) {
   for (const file of files) {
-    const text = await (0, import_promises7.readFile)(file, "utf-8");
-    extractIds(text, "SC").forEach((id) => recordId(out, id, file));
+    const text = await (0, import_promises8.readFile)(file, "utf-8");
+    const parsed = parseGherkinFeature(text, file);
+    for (const scenario of parsed.scenarios) {
+      for (const tag of scenario.tags) {
+        if (SC_TAG_RE.test(tag)) {
+          recordId(out, tag, file);
+        }
+      }
+    }
   }
 }
 function recordId(out, id, file) {
@@ -1127,29 +1372,32 @@ function formatFileList(files, root) {
     return relative.length > 0 ? relative : file;
   }).join(", ");
 }
-function issue2(code, message, severity, file, rule, refs) {
-  const issue6 = {
+function issue3(code, message, severity, file, rule, refs) {
+  const issue7 = {
     code,
     severity,
     message
   };
   if (file) {
-    issue6.file = file;
+    issue7.file = file;
   }
   if (rule) {
-    issue6.rule = rule;
+    issue7.rule = rule;
   }
   if (refs && refs.length > 0) {
-    issue6.refs = refs;
+    issue7.refs = refs;
   }
-  return issue6;
+  return issue7;
 }
 
 // src/core/validators/scenario.ts
-var import_promises8 = require("fs/promises");
+var import_promises9 = require("fs/promises");
 var GIVEN_PATTERN = /\bGiven\b/;
 var WHEN_PATTERN = /\bWhen\b/;
 var THEN_PATTERN = /\bThen\b/;
+var SC_TAG_RE2 = /^SC-\d{4}$/;
+var SPEC_TAG_RE = /^SPEC-\d{4}$/;
+var BR_TAG_RE = /^BR-\d{4}$/;
 async function validateScenarios(root, config) {
   const scenariosRoot = resolvePath(root, config, "scenariosDir");
   const files = await collectFiles(scenariosRoot, {
@@ -1157,7 +1405,7 @@ async function validateScenarios(root, config) {
   });
   if (files.length === 0) {
     return [
-      issue3(
+      issue4(
         "QFAI-SC-000",
         "Scenario \u30D5\u30A1\u30A4\u30EB\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002",
         "info",
@@ -1168,13 +1416,14 @@ async function validateScenarios(root, config) {
   }
   const issues = [];
   for (const file of files) {
-    const text = await (0, import_promises8.readFile)(file, "utf-8");
+    const text = await (0, import_promises9.readFile)(file, "utf-8");
     issues.push(...validateScenarioContent(text, file));
   }
   return issues;
 }
 function validateScenarioContent(text, file) {
   const issues = [];
+  const parsed = parseGherkinFeature(text, file);
   const invalidIds = extractInvalidIds(text, [
     "SPEC",
     "BR",
@@ -1186,7 +1435,7 @@ function validateScenarioContent(text, file) {
   ]);
   if (invalidIds.length > 0) {
     issues.push(
-      issue3(
+      issue4(
         "QFAI-ID-002",
         `ID \u30D5\u30A9\u30FC\u30DE\u30C3\u30C8\u304C\u4E0D\u6B63\u3067\u3059: ${invalidIds.join(", ")}`,
         "error",
@@ -1196,41 +1445,56 @@ function validateScenarioContent(text, file) {
       )
     );
   }
-  const scIds = extractIds(text, "SC");
-  if (scIds.length === 0) {
-    issues.push(
-      issue3(
-        "QFAI-SC-001",
-        "SC ID \u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002",
-        "error",
-        file,
-        "scenario.id"
-      )
-    );
-  }
-  const specIds = extractIds(text, "SPEC");
-  if (specIds.length === 0) {
+  const missingStructure = [];
+  if (!parsed.featurePresent) missingStructure.push("Feature");
+  if (parsed.scenarios.length === 0) missingStructure.push("Scenario");
+  if (missingStructure.length > 0) {
     issues.push(
-      issue3(
-        "QFAI-SC-002",
-        "SC \u306F SPEC \u3092\u53C2\u7167\u3059\u308B\u5FC5\u8981\u304C\u3042\u308A\u307E\u3059\u3002",
+      issue4(
+        "QFAI-SC-006",
+        `Scenario \u30D5\u30A1\u30A4\u30EB\u306B\u5FC5\u8981\u306A\u69CB\u9020\u304C\u3042\u308A\u307E\u305B\u3093: ${missingStructure.join(
+          ", "
+        )}`,
         "error",
         file,
-        "scenario.spec"
+        "scenario.structure"
       )
     );
   }
-  const brIds = extractIds(text, "BR");
-  if (brIds.length === 0) {
-    issues.push(
-      issue3(
-        "QFAI-SC-003",
-        "SC \u306F BR \u3092\u53C2\u7167\u3059\u308B\u5FC5\u8981\u304C\u3042\u308A\u307E\u3059\u3002",
-        "error",
-        file,
-        "scenario.br"
-      )
-    );
+  for (const scenario of parsed.scenarios) {
+    if (scenario.tags.length === 0) {
+      issues.push(
+        issue4(
+          "QFAI-SC-007",
+          `Scenario \u30BF\u30B0\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093: ${scenario.name}`,
+          "error",
+          file,
+          "scenario.tags"
+        )
+      );
+      continue;
+    }
+    const missingTags = [];
+    if (!scenario.tags.some((tag) => SC_TAG_RE2.test(tag))) {
+      missingTags.push("SC");
+    }
+    if (!scenario.tags.some((tag) => SPEC_TAG_RE.test(tag))) {
+      missingTags.push("SPEC");
+    }
+    if (!scenario.tags.some((tag) => BR_TAG_RE.test(tag))) {
+      missingTags.push("BR");
+    }
+    if (missingTags.length > 0) {
+      issues.push(
+        issue4(
+          "QFAI-SC-008",
+          `Scenario \u30BF\u30B0\u306B\u4E0D\u8DB3\u304C\u3042\u308A\u307E\u3059: ${missingTags.join(", ")} (${scenario.name})`,
+          "error",
+          file,
+          "scenario.tagIds"
+        )
+      );
+    }
   }
   const missingSteps = [];
   if (!GIVEN_PATTERN.test(text)) {
@@ -1244,7 +1508,7 @@ function validateScenarioContent(text, file) {
   }
   if (missingSteps.length > 0) {
     issues.push(
-      issue3(
+      issue4(
         "QFAI-SC-005",
         `Given/When/Then \u304C\u4E0D\u8DB3\u3057\u3066\u3044\u307E\u3059: ${missingSteps.join(", ")}`,
         "warning",
@@ -1255,33 +1519,33 @@ function validateScenarioContent(text, file) {
   }
   return issues;
 }
-function issue3(code, message, severity, file, rule, refs) {
-  const issue6 = {
+function issue4(code, message, severity, file, rule, refs) {
+  const issue7 = {
     code,
     severity,
     message
   };
   if (file) {
-    issue6.file = file;
+    issue7.file = file;
   }
   if (rule) {
-    issue6.rule = rule;
+    issue7.rule = rule;
   }
   if (refs && refs.length > 0) {
-    issue6.refs = refs;
+    issue7.refs = refs;
   }
-  return issue6;
+  return issue7;
 }
 
 // src/core/validators/spec.ts
-var import_promises9 = require("fs/promises");
+var import_promises10 = require("fs/promises");
 async function validateSpecs(root, config) {
   const specsRoot = resolvePath(root, config, "specDir");
   const files = await collectSpecFiles(specsRoot);
   if (files.length === 0) {
     const expected = "spec-0001-<slug>.md";
     return [
-      issue4(
+      issue5(
         "QFAI-SPEC-000",
         `Spec \u30D5\u30A1\u30A4\u30EB\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002\u914D\u7F6E\u5834\u6240: ${config.paths.specDir} / \u671F\u5F85\u30D1\u30BF\u30FC\u30F3: ${expected}`,
         "info",
@@ -1292,7 +1556,7 @@ async function validateSpecs(root, config) {
   }
   const issues = [];
   for (const file of files) {
-    const text = await (0, import_promises9.readFile)(file, "utf-8");
+    const text = await (0, import_promises10.readFile)(file, "utf-8");
     issues.push(
       ...validateSpecContent(
         text,
@@ -1305,6 +1569,7 @@ async function validateSpecs(root, config) {
 }
 function validateSpecContent(text, file, requiredSections) {
   const issues = [];
+  const parsed = parseSpec(text, file);
   const invalidIds = extractInvalidIds(text, [
     "SPEC",
     "BR",
@@ -1316,7 +1581,7 @@ function validateSpecContent(text, file, requiredSections) {
   ]);
   if (invalidIds.length > 0) {
     issues.push(
-      issue4(
+      issue5(
         "QFAI-ID-002",
         `ID \u30D5\u30A9\u30FC\u30DE\u30C3\u30C8\u304C\u4E0D\u6B63\u3067\u3059: ${invalidIds.join(", ")}`,
         "error",
@@ -1326,10 +1591,9 @@ function validateSpecContent(text, file, requiredSections) {
       )
     );
   }
-  const specIds = extractIds(text, "SPEC");
-  if (specIds.length === 0) {
+  if (!parsed.specId) {
     issues.push(
-      issue4(
+      issue5(
         "QFAI-SPEC-001",
         "SPEC ID \u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002",
         "error",
@@ -1338,10 +1602,9 @@ function validateSpecContent(text, file, requiredSections) {
       )
     );
   }
-  const brIds = extractIds(text, "BR");
-  if (brIds.length === 0) {
+  if (parsed.brs.length === 0) {
     issues.push(
-      issue4(
+      issue5(
         "QFAI-SPEC-002",
         "BR ID \u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002",
         "error",
@@ -1350,10 +1613,34 @@ function validateSpecContent(text, file, requiredSections) {
       )
     );
   }
+  for (const br of parsed.brsWithoutPriority) {
+    issues.push(
+      issue5(
+        "QFAI-BR-001",
+        `BR \u884C\u306B Priority \u304C\u3042\u308A\u307E\u305B\u3093: ${br.id}`,
+        "error",
+        file,
+        "spec.brPriority",
+        [br.id]
+      )
+    );
+  }
+  for (const br of parsed.brsWithInvalidPriority) {
+    issues.push(
+      issue5(
+        "QFAI-BR-002",
+        `BR Priority \u304C\u4E0D\u6B63\u3067\u3059: ${br.id} (${br.priority})`,
+        "error",
+        file,
+        "spec.brPriority",
+        [br.id]
+      )
+    );
+  }
   const scIds = extractIds(text, "SC");
   if (scIds.length > 0) {
     issues.push(
-      issue4(
+      issue5(
         "QFAI-SPEC-003",
         "Spec \u306F SC \u3092\u53C2\u7167\u3057\u306A\u3044\u30EB\u30FC\u30EB\u3067\u3059\u3002",
         "warning",
@@ -1364,9 +1651,9 @@ function validateSpecContent(text, file, requiredSections) {
     );
   }
   for (const section of requiredSections) {
-    if (!text.includes(section)) {
+    if (!parsed.sections.has(section)) {
       issues.push(
-        issue4(
+        issue5(
           "QFAI-SPEC-004",
           `\u5FC5\u9808\u30BB\u30AF\u30B7\u30E7\u30F3\u304C\u4E0D\u8DB3\u3057\u3066\u3044\u307E\u3059: ${section}`,
           "error",
@@ -1378,26 +1665,32 @@ function validateSpecContent(text, file, requiredSections) {
   }
   return issues;
 }
-function issue4(code, message, severity, file, rule, refs) {
-  const issue6 = {
+function issue5(code, message, severity, file, rule, refs) {
+  const issue7 = {
     code,
     severity,
     message
   };
   if (file) {
-    issue6.file = file;
+    issue7.file = file;
   }
   if (rule) {
-    issue6.rule = rule;
+    issue7.rule = rule;
   }
   if (refs && refs.length > 0) {
-    issue6.refs = refs;
+    issue7.refs = refs;
   }
-  return issue6;
+  return issue7;
 }
 
 // src/core/validators/traceability.ts
-var import_promises10 = require("fs/promises");
+var import_promises11 = require("fs/promises");
+var SC_TAG_RE3 = /^SC-\d{4}$/;
+var SPEC_TAG_RE2 = /^SPEC-\d{4}$/;
+var BR_TAG_RE2 = /^BR-\d{4}$/;
+var UI_TAG_RE = /^UI-\d{4}$/;
+var API_TAG_RE = /^API-\d{4}$/;
+var DATA_TAG_RE = /^DATA-\d{4}$/;
 async function validateTraceability(root, config) {
   const issues = [];
   const specsRoot = resolvePath(root, config, "specDir");
@@ -1423,11 +1716,13 @@ async function validateTraceability(root, config) {
   const contractIndex = await buildContractIndex(root, config);
   const contractIds = contractIndex.ids;
   for (const file of specFiles) {
-    const text = await (0, import_promises10.readFile)(file, "utf-8");
+    const text = await (0, import_promises11.readFile)(file, "utf-8");
     extractAllIds(text).forEach((id) => upstreamIds.add(id));
-    const specIdsInFile = extractIds(text, "SPEC");
-    specIdsInFile.forEach((id) => specIds.add(id));
-    const brIds = extractIds(text, "BR");
+    const parsed = parseSpec(text, file);
+    if (parsed.specId) {
+      specIds.add(parsed.specId);
+    }
+    const brIds = parsed.brs.map((br) => br.id);
     brIds.forEach((id) => brIdsInSpecs.add(id));
     const referencedContractIds = /* @__PURE__ */ new Set([
       ...extractIds(text, "UI"),
@@ -1439,7 +1734,7 @@ async function validateTraceability(root, config) {
     );
     if (unknownContractIds.length > 0) {
       issues.push(
-        issue5(
+        issue6(
           "QFAI-TRACE-009",
           `Spec \u304C\u5B58\u5728\u3057\u306A\u3044\u5951\u7D04 ID \u3092\u53C2\u7167\u3057\u3066\u3044\u307E\u3059: ${unknownContractIds.join(
             ", "
@@ -1451,37 +1746,54 @@ async function validateTraceability(root, config) {
         )
       );
     }
-    for (const specId of specIdsInFile) {
-      const current = specToBrIds.get(specId) ?? /* @__PURE__ */ new Set();
+    if (parsed.specId) {
+      const current = specToBrIds.get(parsed.specId) ?? /* @__PURE__ */ new Set();
       brIds.forEach((id) => current.add(id));
-      specToBrIds.set(specId, current);
+      specToBrIds.set(parsed.specId, current);
     }
   }
   for (const file of decisionFiles) {
-    const text = await (0, import_promises10.readFile)(file, "utf-8");
+    const text = await (0, import_promises11.readFile)(file, "utf-8");
     extractAllIds(text).forEach((id) => upstreamIds.add(id));
   }
   for (const file of scenarioFiles) {
-    const text = await (0, import_promises10.readFile)(file, "utf-8");
+    const text = await (0, import_promises11.readFile)(file, "utf-8");
     extractAllIds(text).forEach((id) => upstreamIds.add(id));
-    const specIdsInScenario = extractIds(text, "SPEC");
-    const brIds = extractIds(text, "BR");
-    const scIds = extractIds(text, "SC");
-    const scenarioIds = [
-      ...extractIds(text, "UI"),
-      ...extractIds(text, "API"),
-      ...extractIds(text, "DATA")
-    ];
-    brIds.forEach((id) => brIdsInScenarios.add(id));
-    scIds.forEach((id) => scIdsInScenarios.add(id));
-    scenarioIds.forEach((id) => scenarioContractIds.add(id));
-    if (scenarioIds.length > 0) {
-      scIds.forEach((id) => scWithContracts.add(id));
+    const parsed = parseGherkinFeature(text, file);
+    const specIdsInScenario = /* @__PURE__ */ new Set();
+    const brIds = /* @__PURE__ */ new Set();
+    const scIds = /* @__PURE__ */ new Set();
+    const scenarioIds = /* @__PURE__ */ new Set();
+    for (const scenario of parsed.scenarios) {
+      for (const tag of scenario.tags) {
+        if (SPEC_TAG_RE2.test(tag)) {
+          specIdsInScenario.add(tag);
+        }
+        if (BR_TAG_RE2.test(tag)) {
+          brIds.add(tag);
+        }
+        if (SC_TAG_RE3.test(tag)) {
+          scIds.add(tag);
+        }
+        if (UI_TAG_RE.test(tag) || API_TAG_RE.test(tag) || DATA_TAG_RE.test(tag)) {
+          scenarioIds.add(tag);
+        }
+      }
     }
-    const unknownSpecIds = specIdsInScenario.filter((id) => !specIds.has(id));
+    const specIdsList = Array.from(specIdsInScenario);
+    const brIdsList = Array.from(brIds);
+    const scIdsList = Array.from(scIds);
+    const scenarioIdsList = Array.from(scenarioIds);
+    brIdsList.forEach((id) => brIdsInScenarios.add(id));
+    scIdsList.forEach((id) => scIdsInScenarios.add(id));
+    scenarioIdsList.forEach((id) => scenarioContractIds.add(id));
+    if (scenarioIdsList.length > 0) {
+      scIdsList.forEach((id) => scWithContracts.add(id));
+    }
+    const unknownSpecIds = specIdsList.filter((id) => !specIds.has(id));
     if (unknownSpecIds.length > 0) {
       issues.push(
-        issue5(
+        issue6(
           "QFAI-TRACE-005",
           `Scenario \u304C\u5B58\u5728\u3057\u306A\u3044 SPEC \u3092\u53C2\u7167\u3057\u3066\u3044\u307E\u3059: ${unknownSpecIds.join(", ")}`,
           "error",
@@ -1491,10 +1803,10 @@ async function validateTraceability(root, config) {
         )
       );
     }
-    const unknownBrIds = brIds.filter((id) => !brIdsInSpecs.has(id));
+    const unknownBrIds = brIdsList.filter((id) => !brIdsInSpecs.has(id));
     if (unknownBrIds.length > 0) {
       issues.push(
-        issue5(
+        issue6(
           "QFAI-TRACE-006",
           `Scenario \u304C\u5B58\u5728\u3057\u306A\u3044 BR \u3092\u53C2\u7167\u3057\u3066\u3044\u307E\u3059: ${unknownBrIds.join(", ")}`,
           "error",
@@ -1504,10 +1816,12 @@ async function validateTraceability(root, config) {
         )
       );
     }
-    const unknownContractIds = scenarioIds.filter((id) => !contractIds.has(id));
+    const unknownContractIds = scenarioIdsList.filter(
+      (id) => !contractIds.has(id)
+    );
     if (unknownContractIds.length > 0) {
       issues.push(
-        issue5(
+        issue6(
           "QFAI-TRACE-008",
           `Scenario \u304C\u5B58\u5728\u3057\u306A\u3044\u5951\u7D04 ID \u3092\u53C2\u7167\u3057\u3066\u3044\u307E\u3059: ${unknownContractIds.join(
             ", "
@@ -1519,23 +1833,23 @@ async function validateTraceability(root, config) {
         )
       );
     }
-    if (specIdsInScenario.length > 0) {
+    if (specIdsList.length > 0) {
       const allowedBrIds = /* @__PURE__ */ new Set();
-      for (const specId of specIdsInScenario) {
+      for (const specId of specIdsList) {
         const brIdsForSpec = specToBrIds.get(specId);
         if (!brIdsForSpec) {
           continue;
         }
         brIdsForSpec.forEach((id) => allowedBrIds.add(id));
       }
-      const invalidBrIds = brIds.filter((id) => !allowedBrIds.has(id));
+      const invalidBrIds = brIdsList.filter((id) => !allowedBrIds.has(id));
       if (invalidBrIds.length > 0) {
         issues.push(
-          issue5(
+          issue6(
             "QFAI-TRACE-007",
             `Scenario \u306E BR \u304C\u53C2\u7167 SPEC \u306B\u5C5E\u3057\u3066\u3044\u307E\u305B\u3093: ${invalidBrIds.join(
               ", "
-            )} (SPEC: ${specIdsInScenario.join(", ")})`,
+            )} (SPEC: ${specIdsList.join(", ")})`,
             "error",
             file,
             "traceability.scenarioBrUnderSpec",
@@ -1547,7 +1861,7 @@ async function validateTraceability(root, config) {
   }
   if (upstreamIds.size === 0) {
     return [
-      issue5(
+      issue6(
         "QFAI-TRACE-000",
         "\u4E0A\u6D41 ID \u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002",
         "info",
@@ -1562,7 +1876,7 @@ async function validateTraceability(root, config) {
     );
     if (orphanBrIds.length > 0) {
       issues.push(
-        issue5(
+        issue6(
           "QFAI_TRACE_BR_ORPHAN",
           `BR \u304C SC \u306B\u7D10\u3065\u3044\u3066\u3044\u307E\u305B\u3093: ${orphanBrIds.join(", ")}`,
           "error",
@@ -1579,7 +1893,7 @@ async function validateTraceability(root, config) {
     );
     if (scWithoutContracts.length > 0) {
       issues.push(
-        issue5(
+        issue6(
           "QFAI_TRACE_SC_NO_CONTRACT",
           `SC \u304C\u5951\u7D04(UI/API/DATA)\u306B\u63A5\u7D9A\u3057\u3066\u3044\u307E\u305B\u3093: ${scWithoutContracts.join(
             ", "
@@ -1599,7 +1913,7 @@ async function validateTraceability(root, config) {
       );
       if (orphanContracts.length > 0) {
         issues.push(
-          issue5(
+          issue6(
             "QFAI_CONTRACT_ORPHAN",
             `\u5951\u7D04\u304C SC \u304B\u3089\u53C2\u7167\u3055\u308C\u3066\u3044\u307E\u305B\u3093: ${orphanContracts.join(", ")}`,
             "error",
@@ -1627,7 +1941,7 @@ async function validateCodeReferences(upstreamIds, srcRoot, testsRoot) {
   const targetFiles = [...codeFiles, ...testFiles];
   if (targetFiles.length === 0) {
     issues.push(
-      issue5(
+      issue6(
         "QFAI-TRACE-001",
         "\u53C2\u7167\u5BFE\u8C61\u306E\u30B3\u30FC\u30C9/\u30C6\u30B9\u30C8\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002",
         "info",
@@ -1640,7 +1954,7 @@ async function validateCodeReferences(upstreamIds, srcRoot, testsRoot) {
   const pattern = buildIdPattern(Array.from(upstreamIds));
   let found = false;
   for (const file of targetFiles) {
-    const text = await (0, import_promises10.readFile)(file, "utf-8");
+    const text = await (0, import_promises11.readFile)(file, "utf-8");
     if (pattern.test(text)) {
       found = true;
       break;
@@ -1648,7 +1962,7 @@ async function validateCodeReferences(upstreamIds, srcRoot, testsRoot) {
   }
   if (!found) {
     issues.push(
-      issue5(
+      issue6(
         "QFAI-TRACE-002",
         "\u4E0A\u6D41 ID \u304C\u30B3\u30FC\u30C9/\u30C6\u30B9\u30C8\u306B\u53C2\u7167\u3055\u308C\u3066\u3044\u307E\u305B\u3093\u3002",
         "warning",
@@ -1663,22 +1977,22 @@ function buildIdPattern(ids) {
   const escaped = ids.map((id) => id.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"));
   return new RegExp(`\\b(${escaped.join("|")})\\b`);
 }
-function issue5(code, message, severity, file, rule, refs) {
-  const issue6 = {
+function issue6(code, message, severity, file, rule, refs) {
+  const issue7 = {
     code,
     severity,
     message
   };
   if (file) {
-    issue6.file = file;
+    issue7.file = file;
   }
   if (rule) {
-    issue6.rule = rule;
+    issue7.rule = rule;
   }
   if (refs && refs.length > 0) {
-    issue6.refs = refs;
+    issue7.refs = refs;
   }
-  return issue6;
+  return issue7;
 }
 
 // src/core/validate.ts
@@ -1689,6 +2003,7 @@ async function validateProject(root, configResult) {
     ...configIssues,
     ...await validateSpecs(root, config),
     ...await validateScenarios(root, config),
+    ...await validateDecisions(root, config),
     ...await validateContracts(root, config),
     ...await validateDefinedIds(root, config),
     ...await validateTraceability(root, config)
@@ -1703,8 +2018,8 @@ async function validateProject(root, configResult) {
 }
 function countIssues(issues) {
   return issues.reduce(
-    (acc, issue6) => {
-      acc[issue6.severity] += 1;
+    (acc, issue7) => {
+      acc[issue7.severity] += 1;
       return acc;
     },
     { info: 0, warning: 0, error: 0 }
@@ -1875,7 +2190,7 @@ async function collectIds(files) {
     DATA: /* @__PURE__ */ new Set()
   };
   for (const file of files) {
-    const text = await (0, import_promises11.readFile)(file, "utf-8");
+    const text = await (0, import_promises12.readFile)(file, "utf-8");
     for (const prefix of ID_PREFIXES2) {
       const ids = extractIds(text, prefix);
       ids.forEach((id) => result[prefix].add(id));
@@ -1893,7 +2208,7 @@ async function collectIds(files) {
 async function collectUpstreamIds(files) {
   const ids = /* @__PURE__ */ new Set();
   for (const file of files) {
-    const text = await (0, import_promises11.readFile)(file, "utf-8");
+    const text = await (0, import_promises12.readFile)(file, "utf-8");
     extractAllIds(text).forEach((id) => ids.add(id));
   }
   return ids;
@@ -1914,7 +2229,7 @@ async function evaluateTraceability(upstreamIds, srcRoot, testsRoot) {
   }
   const pattern = buildIdPattern2(Array.from(upstreamIds));
   for (const file of targetFiles) {
-    const text = await (0, import_promises11.readFile)(file, "utf-8");
+    const text = await (0, import_promises12.readFile)(file, "utf-8");
     if (pattern.test(text)) {
       return true;
     }
@@ -1936,20 +2251,20 @@ function toSortedArray(values) {
 }
 function buildHotspots(issues) {
   const map = /* @__PURE__ */ new Map();
-  for (const issue6 of issues) {
-    if (!issue6.file) {
+  for (const issue7 of issues) {
+    if (!issue7.file) {
       continue;
     }
-    const current = map.get(issue6.file) ?? {
-      file: issue6.file,
+    const current = map.get(issue7.file) ?? {
+      file: issue7.file,
       total: 0,
       error: 0,
       warning: 0,
       info: 0
     };
     current.total += 1;
-    current[issue6.severity] += 1;
-    map.set(issue6.file, current);
+    current[issue7.severity] += 1;
+    map.set(issue7.file, current);
   }
   return Array.from(map.values()).sort(
     (a, b) => b.total !== a.total ? b.total - a.total : a.file.localeCompare(b.file)
@@ -1987,8 +2302,8 @@ async function runReport(options) {
   const defaultOut = options.format === "json" ? ".qfai/out/report.json" : ".qfai/out/report.md";
   const out = options.outPath ?? defaultOut;
   const outPath = import_node_path10.default.isAbsolute(out) ? out : import_node_path10.default.resolve(root, out);
-  await (0, import_promises12.mkdir)(import_node_path10.default.dirname(outPath), { recursive: true });
-  await (0, import_promises12.writeFile)(outPath, `${output}
+  await (0, import_promises13.mkdir)(import_node_path10.default.dirname(outPath), { recursive: true });
+  await (0, import_promises13.writeFile)(outPath, `${output}
 `, "utf-8");
   info(
     `report: info=${validation.counts.info} warning=${validation.counts.warning} error=${validation.counts.error}`
@@ -1996,7 +2311,7 @@ async function runReport(options) {
   info(`wrote report: ${outPath}`);
 }
 async function readValidationResult(inputPath) {
-  const raw = await (0, import_promises12.readFile)(inputPath, "utf-8");
+  const raw = await (0, import_promises13.readFile)(inputPath, "utf-8");
   const parsed = JSON.parse(raw);
   if (!isValidationResult(parsed)) {
     throw new Error(`validate.json \u306E\u5F62\u5F0F\u304C\u4E0D\u6B63\u3067\u3059: ${inputPath}`);
@@ -2037,7 +2352,7 @@ function isMissingFileError(error2) {
 }
 
 // src/cli/commands/validate.ts
-var import_promises13 = require("fs/promises");
+var import_promises14 = require("fs/promises");
 var import_node_path11 = __toESM(require("path"), 1);
 
 // src/cli/lib/failOn.ts
@@ -2097,21 +2412,21 @@ function emitText(result) {
 `
   );
 }
-function emitGitHub(issue6) {
-  const level = issue6.severity === "error" ? "error" : issue6.severity === "warning" ? "warning" : "notice";
-  const file = issue6.file ? `file=${issue6.file}` : "";
-  const line = issue6.loc?.line ? `,line=${issue6.loc.line}` : "";
-  const column = issue6.loc?.column ? `,col=${issue6.loc.column}` : "";
+function emitGitHub(issue7) {
+  const level = issue7.severity === "error" ? "error" : issue7.severity === "warning" ? "warning" : "notice";
+  const file = issue7.file ? `file=${issue7.file}` : "";
+  const line = issue7.loc?.line ? `,line=${issue7.loc.line}` : "";
+  const column = issue7.loc?.column ? `,col=${issue7.loc.column}` : "";
   const location = file ? ` ${file}${line}${column}` : "";
   process.stdout.write(
-    `::${level}${location}::${issue6.code}: ${issue6.message}
+    `::${level}${location}::${issue7.code}: ${issue7.message}
 `
   );
 }
 async function emitJson(result, root, jsonPath) {
   const abs = import_node_path11.default.isAbsolute(jsonPath) ? jsonPath : import_node_path11.default.resolve(root, jsonPath);
-  await (0, import_promises13.mkdir)(import_node_path11.default.dirname(abs), { recursive: true });
-  await (0, import_promises13.writeFile)(abs, `${JSON.stringify(result, null, 2)}
+  await (0, import_promises14.mkdir)(import_node_path11.default.dirname(abs), { recursive: true });
+  await (0, import_promises14.writeFile)(abs, `${JSON.stringify(result, null, 2)}
 `, "utf-8");
 }