qfai 0.3.6 → 0.4.0

package/dist/cli/index.mjs

@@ -154,7 +154,7 @@ function report(copied, skipped, dryRun, label) {
 }
 
 // src/cli/commands/report.ts
-import { mkdir as mkdir2, readFile as readFile11, writeFile } from "fs/promises";
+import { mkdir as mkdir2, readFile as readFile12, writeFile } from "fs/promises";
 import path14 from "path";
 
 // src/core/config.ts
@@ -187,6 +187,8 @@ var defaultConfig = {
     traceability: {
       brMustHaveSc: true,
       scMustTouchContracts: true,
+      scMustHaveTest: true,
+      scNoTestSeverity: "error",
       allowOrphanContracts: false,
       unknownContractIdSeverity: "error"
     }
@@ -366,6 +368,20 @@ function normalizeValidation(raw, configPath, issues) {
         configPath,
         issues
       ),
+      scMustHaveTest: readBoolean(
+        traceabilityRaw?.scMustHaveTest,
+        base.traceability.scMustHaveTest,
+        "validation.traceability.scMustHaveTest",
+        configPath,
+        issues
+      ),
+      scNoTestSeverity: readTraceabilitySeverity(
+        traceabilityRaw?.scNoTestSeverity,
+        base.traceability.scNoTestSeverity,
+        "validation.traceability.scNoTestSeverity",
+        configPath,
+        issues
+      ),
       allowOrphanContracts: readBoolean(
         traceabilityRaw?.allowOrphanContracts,
         base.traceability.allowOrphanContracts,
@@ -491,7 +507,7 @@ function isRecord(value) {
 }
 
 // src/core/report.ts
-import { readFile as readFile10 } from "fs/promises";
+import { readFile as readFile11 } from "fs/promises";
 import path13 from "path";
 
 // src/core/discovery.ts
@@ -685,20 +701,244 @@ function isValidId(value, prefix) {
   return strict.test(value);
 }
 
-// src/core/types.ts
-var VALIDATION_SCHEMA_VERSION = "0.2";
+// src/core/traceability.ts
+import { readFile as readFile2 } from "fs/promises";
+
+// src/core/gherkin/parse.ts
+import {
+  AstBuilder,
+  GherkinClassicTokenMatcher,
+  Parser
+} from "@cucumber/gherkin";
+import { randomUUID } from "crypto";
+function parseGherkin(source, uri) {
+  const errors = [];
+  const uuidFn = () => randomUUID();
+  const builder = new AstBuilder(uuidFn);
+  const matcher = new GherkinClassicTokenMatcher();
+  const parser = new Parser(builder, matcher);
+  try {
+    const gherkinDocument = parser.parse(source);
+    gherkinDocument.uri = uri;
+    return { gherkinDocument, errors };
+  } catch (error2) {
+    errors.push(formatError2(error2));
+    return { gherkinDocument: null, errors };
+  }
+}
+function formatError2(error2) {
+  if (error2 instanceof Error) {
+    return error2.message;
+  }
+  return String(error2);
+}
+
+// src/core/scenarioModel.ts
+var SPEC_TAG_RE = /^SPEC-\d{4}$/;
+var SC_TAG_RE = /^SC-\d{4}$/;
+var BR_TAG_RE = /^BR-\d{4}$/;
+var UI_TAG_RE = /^UI-\d{4}$/;
+var API_TAG_RE = /^API-\d{4}$/;
+var DATA_TAG_RE = /^DATA-\d{4}$/;
+function parseScenarioDocument(text, uri) {
+  const { gherkinDocument, errors } = parseGherkin(text, uri);
+  if (!gherkinDocument) {
+    return { document: null, errors };
+  }
+  const feature = gherkinDocument.feature;
+  if (!feature) {
+    return {
+      document: { uri, featureTags: [], scenarios: [] },
+      errors
+    };
+  }
+  const featureTags = collectTagNames(feature.tags);
+  const scenarios = collectScenarioNodes(feature, featureTags);
+  return {
+    document: {
+      uri,
+      featureName: feature.name,
+      featureTags,
+      scenarios
+    },
+    errors
+  };
+}
+function buildScenarioAtoms(document) {
+  return document.scenarios.map((scenario) => {
+    const specIds = scenario.tags.filter((tag) => SPEC_TAG_RE.test(tag));
+    const scIds = scenario.tags.filter((tag) => SC_TAG_RE.test(tag));
+    const brIds = unique2(scenario.tags.filter((tag) => BR_TAG_RE.test(tag)));
+    const contractIds = /* @__PURE__ */ new Set();
+    scenario.tags.forEach((tag) => {
+      if (UI_TAG_RE.test(tag) || API_TAG_RE.test(tag) || DATA_TAG_RE.test(tag)) {
+        contractIds.add(tag);
+      }
+    });
+    for (const step of scenario.steps) {
+      for (const text of collectStepTexts(step)) {
+        extractIds(text, "UI").forEach((id) => contractIds.add(id));
+        extractIds(text, "API").forEach((id) => contractIds.add(id));
+        extractIds(text, "DATA").forEach((id) => contractIds.add(id));
+      }
+    }
+    const atom = {
+      uri: document.uri,
+      featureName: document.featureName ?? "",
+      scenarioName: scenario.name,
+      kind: scenario.kind,
+      brIds,
+      contractIds: Array.from(contractIds).sort()
+    };
+    if (scenario.line !== void 0) {
+      atom.line = scenario.line;
+    }
+    if (specIds.length === 1) {
+      const specId = specIds[0];
+      if (specId) {
+        atom.specId = specId;
+      }
+    }
+    if (scIds.length === 1) {
+      const scId = scIds[0];
+      if (scId) {
+        atom.scId = scId;
+      }
+    }
+    return atom;
+  });
+}
+function collectScenarioNodes(feature, featureTags) {
+  const scenarios = [];
+  for (const child of feature.children) {
+    if (child.scenario) {
+      scenarios.push(buildScenarioNode(child.scenario, featureTags, []));
+    }
+    if (child.rule) {
+      const ruleTags = collectTagNames(child.rule.tags);
+      for (const ruleChild of child.rule.children) {
+        if (ruleChild.scenario) {
+          scenarios.push(
+            buildScenarioNode(ruleChild.scenario, featureTags, ruleTags)
+          );
+        }
+      }
+    }
+  }
+  return scenarios;
+}
+function buildScenarioNode(scenario, featureTags, ruleTags) {
+  const tags = [...featureTags, ...ruleTags, ...collectTagNames(scenario.tags)];
+  const kind = scenario.examples.length > 0 ? "ScenarioOutline" : "Scenario";
+  return {
+    name: scenario.name,
+    kind,
+    line: scenario.location?.line,
+    tags,
+    steps: scenario.steps
+  };
+}
+function collectTagNames(tags) {
+  return tags.map((tag) => tag.name.replace(/^@/, ""));
+}
+function collectStepTexts(step) {
+  const texts = [];
+  if (step.text) {
+    texts.push(step.text);
+  }
+  if (step.docString?.content) {
+    texts.push(step.docString.content);
+  }
+  if (step.dataTable?.rows) {
+    for (const row of step.dataTable.rows) {
+      for (const cell of row.cells) {
+        texts.push(cell.value);
+      }
+    }
+  }
+  return texts;
+}
+function unique2(values) {
+  return Array.from(new Set(values));
+}
+
+// src/core/traceability.ts
+var SC_TAG_RE2 = /^SC-\d{4}$/;
+async function collectScIdsFromScenarioFiles(scenarioFiles) {
+  const scIds = /* @__PURE__ */ new Set();
+  for (const file of scenarioFiles) {
+    const text = await readFile2(file, "utf-8");
+    const { document, errors } = parseScenarioDocument(text, file);
+    if (!document || errors.length > 0) {
+      continue;
+    }
+    for (const scenario of document.scenarios) {
+      for (const tag of scenario.tags) {
+        if (SC_TAG_RE2.test(tag)) {
+          scIds.add(tag);
+        }
+      }
+    }
+  }
+  return scIds;
+}
+async function collectScTestReferences(testsRoot) {
+  const refs = /* @__PURE__ */ new Map();
+  const testFiles = await collectFiles(testsRoot, {
+    extensions: [".ts", ".tsx", ".js", ".jsx"]
+  });
+  for (const file of testFiles) {
+    const text = await readFile2(file, "utf-8");
+    const scIds = extractIds(text, "SC");
+    if (scIds.length === 0) {
+      continue;
+    }
+    for (const scId of scIds) {
+      const current = refs.get(scId) ?? /* @__PURE__ */ new Set();
+      current.add(file);
+      refs.set(scId, current);
+    }
+  }
+  return refs;
+}
+function buildScCoverage(scIds, refs) {
+  const sortedScIds = toSortedArray(scIds);
+  const refsRecord = {};
+  const missingIds = [];
+  let covered = 0;
+  for (const scId of sortedScIds) {
+    const files = refs.get(scId);
+    const sortedFiles = files ? toSortedArray(files) : [];
+    refsRecord[scId] = sortedFiles;
+    if (sortedFiles.length === 0) {
+      missingIds.push(scId);
+    } else {
+      covered += 1;
+    }
+  }
+  return {
+    total: sortedScIds.length,
+    covered,
+    missing: missingIds.length,
+    missingIds,
+    refs: refsRecord
+  };
+}
+function toSortedArray(values) {
+  return Array.from(new Set(values)).sort((a, b) => a.localeCompare(b));
+}
 
 // src/core/version.ts
-import { readFile as readFile2 } from "fs/promises";
+import { readFile as readFile3 } from "fs/promises";
 import path7 from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 async function resolveToolVersion() {
-  if ("0.3.5".length > 0) {
-    return "0.3.5";
+  if ("0.4.0".length > 0) {
+    return "0.4.0";
   }
   try {
     const packagePath = resolvePackageJsonPath();
-    const raw = await readFile2(packagePath, "utf-8");
+    const raw = await readFile3(packagePath, "utf-8");
     const parsed = JSON.parse(raw);
     const version = typeof parsed.version === "string" ? parsed.version : "";
     return version.length > 0 ? version : "unknown";
@@ -713,7 +953,7 @@ function resolvePackageJsonPath() {
 }
 
 // src/core/validators/contracts.ts
-import { readFile as readFile3 } from "fs/promises";
+import { readFile as readFile4 } from "fs/promises";
 import path9 from "path";
 
 // src/core/contracts.ts
@@ -791,7 +1031,7 @@ async function validateUiContracts(uiRoot) {
   }
   const issues = [];
   for (const file of files) {
-    const text = await readFile3(file, "utf-8");
+    const text = await readFile4(file, "utf-8");
     const invalidIds = extractInvalidIds(text, [
       "SPEC",
       "BR",
@@ -820,7 +1060,7 @@ async function validateUiContracts(uiRoot) {
       issues.push(
         issue(
           "QFAI-CONTRACT-001",
-          `UI \u5951\u7D04\u30D5\u30A1\u30A4\u30EB\u306E\u89E3\u6790\u306B\u5931\u6557\u3057\u307E\u3057\u305F: ${file} (${formatError2(error2)})`,
+          `UI \u5951\u7D04\u30D5\u30A1\u30A4\u30EB\u306E\u89E3\u6790\u306B\u5931\u6557\u3057\u307E\u3057\u305F: ${file} (${formatError3(error2)})`,
           "error",
           file,
           "contracts.ui.parse"
@@ -858,7 +1098,7 @@ async function validateApiContracts(apiRoot) {
   }
   const issues = [];
   for (const file of files) {
-    const text = await readFile3(file, "utf-8");
+    const text = await readFile4(file, "utf-8");
     const invalidIds = extractInvalidIds(text, [
       "SPEC",
       "BR",
@@ -887,7 +1127,7 @@ async function validateApiContracts(apiRoot) {
       issues.push(
         issue(
           "QFAI-CONTRACT-001",
-          `API \u5951\u7D04\u30D5\u30A1\u30A4\u30EB\u306E\u89E3\u6790\u306B\u5931\u6557\u3057\u307E\u3057\u305F: ${file} (${formatError2(error2)})`,
+          `API \u5951\u7D04\u30D5\u30A1\u30A4\u30EB\u306E\u89E3\u6790\u306B\u5931\u6557\u3057\u307E\u3057\u305F: ${file} (${formatError3(error2)})`,
           "error",
           file,
           "contracts.api.parse"
@@ -936,7 +1176,7 @@ async function validateDataContracts(dataRoot) {
   }
   const issues = [];
   for (const file of files) {
-    const text = await readFile3(file, "utf-8");
+    const text = await readFile4(file, "utf-8");
     const invalidIds = extractInvalidIds(text, [
       "SPEC",
       "BR",
@@ -982,7 +1222,7 @@ function lintSql(text, file) {
 function hasOpenApi(doc) {
   return typeof doc.openapi === "string" && doc.openapi.length > 0;
 }
-function formatError2(error2) {
+function formatError3(error2) {
   if (error2 instanceof Error) {
     return error2.message;
   }
@@ -1007,7 +1247,7 @@ function issue(code, message, severity, file, rule, refs) {
 }
 
 // src/core/validators/delta.ts
-import { readFile as readFile4 } from "fs/promises";
+import { readFile as readFile5 } from "fs/promises";
 import path10 from "path";
 var SECTION_RE = /^##\s+変更区分/m;
 var COMPAT_LINE_RE = /^\s*-\s*\[[ xX]\]\s*Compatibility\b/m;
@@ -1025,7 +1265,7 @@ async function validateDeltas(root, config) {
     const deltaPath = path10.join(pack, "delta.md");
     let text;
     try {
-      text = await readFile4(deltaPath, "utf-8");
+      text = await readFile5(deltaPath, "utf-8");
     } catch (error2) {
       if (isMissingFileError2(error2)) {
         issues.push(
@@ -1097,11 +1337,11 @@ function issue2(code, message, severity, file, rule, refs) {
 }
 
 // src/core/validators/ids.ts
-import { readFile as readFile6 } from "fs/promises";
+import { readFile as readFile7 } from "fs/promises";
 import path12 from "path";
 
 // src/core/contractIndex.ts
-import { readFile as readFile5 } from "fs/promises";
+import { readFile as readFile6 } from "fs/promises";
 import path11 from "path";
 async function buildContractIndex(root, config) {
   const contractsRoot = resolvePath(root, config, "contractsDir");
@@ -1126,7 +1366,7 @@ async function buildContractIndex(root, config) {
 }
 async function indexUiContracts(files, index) {
   for (const file of files) {
-    const text = await readFile5(file, "utf-8");
+    const text = await readFile6(file, "utf-8");
     try {
       const doc = parseStructuredContract(file, text);
       extractUiContractIds(doc).forEach((id) => record(index, id, file));
@@ -1138,7 +1378,7 @@ async function indexUiContracts(files, index) {
 }
 async function indexApiContracts(files, index) {
   for (const file of files) {
-    const text = await readFile5(file, "utf-8");
+    const text = await readFile6(file, "utf-8");
     try {
       const doc = parseStructuredContract(file, text);
       extractApiContractIds(doc).forEach((id) => record(index, id, file));
@@ -1150,7 +1390,7 @@ async function indexApiContracts(files, index) {
 }
 async function indexDataContracts(files, index) {
   for (const file of files) {
-    const text = await readFile5(file, "utf-8");
+    const text = await readFile6(file, "utf-8");
     extractIds(text, "DATA").forEach((id) => record(index, id, file));
   }
 }
@@ -1279,166 +1519,8 @@ function parseSpec(md, file) {
   return parsed;
 }
 
-// src/core/gherkin/parse.ts
-import {
-  AstBuilder,
-  GherkinClassicTokenMatcher,
-  Parser
-} from "@cucumber/gherkin";
-import { randomUUID } from "crypto";
-function parseGherkin(source, uri) {
-  const errors = [];
-  const uuidFn = () => randomUUID();
-  const builder = new AstBuilder(uuidFn);
-  const matcher = new GherkinClassicTokenMatcher();
-  const parser = new Parser(builder, matcher);
-  try {
-    const gherkinDocument = parser.parse(source);
-    gherkinDocument.uri = uri;
-    return { gherkinDocument, errors };
-  } catch (error2) {
-    errors.push(formatError3(error2));
-    return { gherkinDocument: null, errors };
-  }
-}
-function formatError3(error2) {
-  if (error2 instanceof Error) {
-    return error2.message;
-  }
-  return String(error2);
-}
-
-// src/core/scenarioModel.ts
-var SPEC_TAG_RE = /^SPEC-\d{4}$/;
-var SC_TAG_RE = /^SC-\d{4}$/;
-var BR_TAG_RE = /^BR-\d{4}$/;
-var UI_TAG_RE = /^UI-\d{4}$/;
-var API_TAG_RE = /^API-\d{4}$/;
-var DATA_TAG_RE = /^DATA-\d{4}$/;
-function parseScenarioDocument(text, uri) {
-  const { gherkinDocument, errors } = parseGherkin(text, uri);
-  if (!gherkinDocument) {
-    return { document: null, errors };
-  }
-  const feature = gherkinDocument.feature;
-  if (!feature) {
-    return {
-      document: { uri, featureTags: [], scenarios: [] },
-      errors
-    };
-  }
-  const featureTags = collectTagNames(feature.tags);
-  const scenarios = collectScenarioNodes(feature, featureTags);
-  return {
-    document: {
-      uri,
-      featureName: feature.name,
-      featureTags,
-      scenarios
-    },
-    errors
-  };
-}
-function buildScenarioAtoms(document) {
-  return document.scenarios.map((scenario) => {
-    const specIds = scenario.tags.filter((tag) => SPEC_TAG_RE.test(tag));
-    const scIds = scenario.tags.filter((tag) => SC_TAG_RE.test(tag));
-    const brIds = unique2(scenario.tags.filter((tag) => BR_TAG_RE.test(tag)));
-    const contractIds = /* @__PURE__ */ new Set();
-    scenario.tags.forEach((tag) => {
-      if (UI_TAG_RE.test(tag) || API_TAG_RE.test(tag) || DATA_TAG_RE.test(tag)) {
-        contractIds.add(tag);
-      }
-    });
-    for (const step of scenario.steps) {
-      for (const text of collectStepTexts(step)) {
-        extractIds(text, "UI").forEach((id) => contractIds.add(id));
-        extractIds(text, "API").forEach((id) => contractIds.add(id));
-        extractIds(text, "DATA").forEach((id) => contractIds.add(id));
-      }
-    }
-    const atom = {
-      uri: document.uri,
-      featureName: document.featureName ?? "",
-      scenarioName: scenario.name,
-      kind: scenario.kind,
-      brIds,
-      contractIds: Array.from(contractIds).sort()
-    };
-    if (scenario.line !== void 0) {
-      atom.line = scenario.line;
-    }
-    if (specIds.length === 1) {
-      const specId = specIds[0];
-      if (specId) {
-        atom.specId = specId;
-      }
-    }
-    if (scIds.length === 1) {
-      const scId = scIds[0];
-      if (scId) {
-        atom.scId = scId;
-      }
-    }
-    return atom;
-  });
-}
-function collectScenarioNodes(feature, featureTags) {
-  const scenarios = [];
-  for (const child of feature.children) {
-    if (child.scenario) {
-      scenarios.push(buildScenarioNode(child.scenario, featureTags, []));
-    }
-    if (child.rule) {
-      const ruleTags = collectTagNames(child.rule.tags);
-      for (const ruleChild of child.rule.children) {
-        if (ruleChild.scenario) {
-          scenarios.push(
-            buildScenarioNode(ruleChild.scenario, featureTags, ruleTags)
-          );
-        }
-      }
-    }
-  }
-  return scenarios;
-}
-function buildScenarioNode(scenario, featureTags, ruleTags) {
-  const tags = [...featureTags, ...ruleTags, ...collectTagNames(scenario.tags)];
-  const kind = scenario.examples.length > 0 ? "ScenarioOutline" : "Scenario";
-  return {
-    name: scenario.name,
-    kind,
-    line: scenario.location?.line,
-    tags,
-    steps: scenario.steps
-  };
-}
-function collectTagNames(tags) {
-  return tags.map((tag) => tag.name.replace(/^@/, ""));
-}
-function collectStepTexts(step) {
-  const texts = [];
-  if (step.text) {
-    texts.push(step.text);
-  }
-  if (step.docString?.content) {
-    texts.push(step.docString.content);
-  }
-  if (step.dataTable?.rows) {
-    for (const row of step.dataTable.rows) {
-      for (const cell of row.cells) {
-        texts.push(cell.value);
-      }
-    }
-  }
-  return texts;
-}
-function unique2(values) {
-  return Array.from(new Set(values));
-}
-
 // src/core/validators/ids.ts
-var SC_TAG_RE2 = /^SC-\d{4}$/;
+var SC_TAG_RE3 = /^SC-\d{4}$/;
 async function validateDefinedIds(root, config) {
   const issues = [];
   const specsRoot = resolvePath(root, config, "specsDir");
@@ -1472,7 +1554,7 @@ async function validateDefinedIds(root, config) {
 }
 async function collectSpecDefinitionIds(files, out) {
   for (const file of files) {
-    const text = await readFile6(file, "utf-8");
+    const text = await readFile7(file, "utf-8");
     const parsed = parseSpec(text, file);
     if (parsed.specId) {
       recordId(out, parsed.specId, file);
@@ -1482,14 +1564,14 @@ async function collectSpecDefinitionIds(files, out) {
 }
 async function collectScenarioDefinitionIds(files, out) {
   for (const file of files) {
-    const text = await readFile6(file, "utf-8");
+    const text = await readFile7(file, "utf-8");
     const { document, errors } = parseScenarioDocument(text, file);
     if (!document || errors.length > 0) {
       continue;
     }
     for (const scenario of document.scenarios) {
       for (const tag of scenario.tags) {
-        if (SC_TAG_RE2.test(tag)) {
+        if (SC_TAG_RE3.test(tag)) {
           recordId(out, tag, file);
         }
       }
@@ -1526,11 +1608,11 @@ function issue3(code, message, severity, file, rule, refs) {
 }
 
 // src/core/validators/scenario.ts
-import { readFile as readFile7 } from "fs/promises";
+import { readFile as readFile8 } from "fs/promises";
 var GIVEN_PATTERN = /\bGiven\b/;
 var WHEN_PATTERN = /\bWhen\b/;
 var THEN_PATTERN = /\bThen\b/;
-var SC_TAG_RE3 = /^SC-\d{4}$/;
+var SC_TAG_RE4 = /^SC-\d{4}$/;
 var SPEC_TAG_RE2 = /^SPEC-\d{4}$/;
 var BR_TAG_RE2 = /^BR-\d{4}$/;
 async function validateScenarios(root, config) {
@@ -1553,7 +1635,7 @@ async function validateScenarios(root, config) {
   for (const entry of entries) {
     let text;
     try {
-      text = await readFile7(entry.scenarioPath, "utf-8");
+      text = await readFile8(entry.scenarioPath, "utf-8");
     } catch (error2) {
       if (isMissingFileError3(error2)) {
         issues.push(
@@ -1650,6 +1732,17 @@ function validateScenarioContent(text, file) {
       )
     );
   }
+  if (document.scenarios.length > 1) {
+    issues.push(
+      issue4(
+        "QFAI-SC-011",
+        `Scenario \u306F1\u3064\u306E\u307F\u8A31\u53EF\u3055\u308C\u3066\u3044\u307E\u3059\uFF08\u691C\u51FA: ${document.scenarios.length}\u4EF6\uFF09`,
+        "error",
+        file,
+        "scenario.single"
+      )
+    );
+  }
   for (const scenario of document.scenarios) {
     if (scenario.tags.length === 0) {
       issues.push(
@@ -1664,7 +1757,7 @@ function validateScenarioContent(text, file) {
       continue;
     }
     const missingTags = [];
-    const scTags = scenario.tags.filter((tag) => SC_TAG_RE3.test(tag));
+    const scTags = scenario.tags.filter((tag) => SC_TAG_RE4.test(tag));
     if (scTags.length === 0) {
       missingTags.push("SC(0\u4EF6)");
     } else if (scTags.length > 1) {
@@ -1739,7 +1832,7 @@ function isMissingFileError3(error2) {
 }
 
 // src/core/validators/spec.ts
-import { readFile as readFile8 } from "fs/promises";
+import { readFile as readFile9 } from "fs/promises";
 async function validateSpecs(root, config) {
   const specsRoot = resolvePath(root, config, "specsDir");
   const entries = await collectSpecEntries(specsRoot);
@@ -1760,7 +1853,7 @@ async function validateSpecs(root, config) {
   for (const entry of entries) {
     let text;
     try {
-      text = await readFile8(entry.specPath, "utf-8");
+      text = await readFile9(entry.specPath, "utf-8");
     } catch (error2) {
       if (isMissingFileError4(error2)) {
         issues.push(
@@ -1909,8 +2002,8 @@ function isMissingFileError4(error2) {
 }
 
 // src/core/validators/traceability.ts
-import { readFile as readFile9 } from "fs/promises";
-var SC_TAG_RE4 = /^SC-\d{4}$/;
+import { readFile as readFile10 } from "fs/promises";
+var SC_TAG_RE5 = /^SC-\d{4}$/;
 var SPEC_TAG_RE3 = /^SPEC-\d{4}$/;
 var BR_TAG_RE3 = /^BR-\d{4}$/;
 async function validateTraceability(root, config) {
@@ -1931,7 +2024,7 @@ async function validateTraceability(root, config) {
   const contractIndex = await buildContractIndex(root, config);
   const contractIds = contractIndex.ids;
   for (const file of specFiles) {
-    const text = await readFile9(file, "utf-8");
+    const text = await readFile10(file, "utf-8");
     extractAllIds(text).forEach((id) => upstreamIds.add(id));
     const parsed = parseSpec(text, file);
     if (parsed.specId) {
@@ -1968,7 +2061,7 @@ async function validateTraceability(root, config) {
     }
   }
   for (const file of scenarioFiles) {
-    const text = await readFile9(file, "utf-8");
+    const text = await readFile10(file, "utf-8");
     extractAllIds(text).forEach((id) => upstreamIds.add(id));
     const { document, errors } = parseScenarioDocument(text, file);
     if (!document || errors.length > 0) {
@@ -1982,7 +2075,7 @@ async function validateTraceability(root, config) {
       }
       const specTags = scenario.tags.filter((tag) => SPEC_TAG_RE3.test(tag));
       const brTags = scenario.tags.filter((tag) => BR_TAG_RE3.test(tag));
-      const scTags = scenario.tags.filter((tag) => SC_TAG_RE4.test(tag));
+      const scTags = scenario.tags.filter((tag) => SC_TAG_RE5.test(tag));
       brTags.forEach((id) => brIdsInScenarios.add(id));
       scTags.forEach((id) => scIdsInScenarios.add(id));
       atom.contractIds.forEach((id) => scenarioContractIds.add(id));
@@ -2110,6 +2203,25 @@ async function validateTraceability(root, config) {
       );
     }
   }
+  if (config.validation.traceability.scMustHaveTest && scIdsInScenarios.size) {
+    const scTestRefs = await collectScTestReferences(testsRoot);
+    const scWithoutTests = Array.from(scIdsInScenarios).filter((id) => {
+      const refs = scTestRefs.get(id);
+      return !refs || refs.size === 0;
+    });
+    if (scWithoutTests.length > 0) {
+      issues.push(
+        issue6(
+          "QFAI-TRACE-010",
+          `SC \u304C tests \u306B\u53C2\u7167\u3055\u308C\u3066\u3044\u307E\u305B\u3093: ${scWithoutTests.join(", ")}\u3002tests/ \u914D\u4E0B\u306E\u30C6\u30B9\u30C8\u30D5\u30A1\u30A4\u30EB\uFF08.ts/.tsx/.js/.jsx\uFF09\u306B SC ID \u3092\u30B3\u30E1\u30F3\u30C8\u307E\u305F\u306F\u30B3\u30FC\u30C9\u3067\u8FFD\u52A0\u3057\u3066\u304F\u3060\u3055\u3044\u3002`,
+          config.validation.traceability.scNoTestSeverity,
+          testsRoot,
+          "traceability.scMustHaveTest",
+          scWithoutTests
+        )
+      );
+    }
+  }
   if (!config.validation.traceability.allowOrphanContracts) {
     if (contractIds.size > 0) {
       const orphanContracts = Array.from(contractIds).filter(
@@ -2158,7 +2270,7 @@ async function validateCodeReferences(upstreamIds, srcRoot, testsRoot) {
   const pattern = buildIdPattern(Array.from(upstreamIds));
   let found = false;
   for (const file of targetFiles) {
-    const text = await readFile9(file, "utf-8");
+    const text = await readFile10(file, "utf-8");
     if (pattern.test(text)) {
       found = true;
       break;
@@ -2214,7 +2326,6 @@ async function validateProject(root, configResult) {
   ];
   const toolVersion = await resolveToolVersion();
   return {
-    schemaVersion: VALIDATION_SCHEMA_VERSION,
     toolVersion,
     issues,
     counts: countIssues(issues)
@@ -2266,6 +2377,9 @@ async function createReportData(root, validation, configResult) {
     srcRoot,
     testsRoot
   );
+  const scIds = await collectScIdsFromScenarioFiles(scenarioFiles);
+  const scTestRefs = await collectScTestReferences(testsRoot);
+  const scCoverage = buildScCoverage(scIds, scTestRefs);
   const resolvedValidation = validation ?? await validateProject(root, resolved);
   const version = await resolveToolVersion();
   return {
@@ -2294,7 +2408,8 @@ async function createReportData(root, validation, configResult) {
     },
     traceability: {
       upstreamIdsFound: upstreamIds.size,
-      referencedInCodeOrTests: traceability
+      referencedInCodeOrTests: traceability,
+      sc: scCoverage
     },
     issues: resolvedValidation.issues
   };
@@ -2331,6 +2446,32 @@ function formatReportMarkdown(data) {
     `- \u30B3\u30FC\u30C9/\u30C6\u30B9\u30C8\u53C2\u7167: ${data.traceability.referencedInCodeOrTests ? "\u3042\u308A" : "\u306A\u3057"}`
   );
   lines.push("");
+  lines.push("## SC\u30AB\u30D0\u30EC\u30C3\u30B8");
+  lines.push(`- total: ${data.traceability.sc.total}`);
+  lines.push(`- covered: ${data.traceability.sc.covered}`);
+  lines.push(`- missing: ${data.traceability.sc.missing}`);
+  if (data.traceability.sc.missingIds.length === 0) {
+    lines.push("- missingIds: (none)");
+  } else {
+    lines.push(`- missingIds: ${data.traceability.sc.missingIds.join(", ")}`);
+  }
+  lines.push("");
+  lines.push("## SC\u2192\u53C2\u7167\u30C6\u30B9\u30C8");
+  const scRefs = data.traceability.sc.refs;
+  const scIds = Object.keys(scRefs).sort((a, b) => a.localeCompare(b));
+  if (scIds.length === 0) {
+    lines.push("- (none)");
+  } else {
+    for (const scId of scIds) {
+      const refs = scRefs[scId] ?? [];
+      if (refs.length === 0) {
+        lines.push(`- ${scId}: (none)`);
+      } else {
+        lines.push(`- ${scId}: ${refs.join(", ")}`);
+      }
+    }
+  }
+  lines.push("");
   lines.push("## Hotspots");
   const hotspots = buildHotspots(data.issues);
   if (hotspots.length === 0) {
@@ -2385,25 +2526,25 @@ async function collectIds(files) {
     DATA: /* @__PURE__ */ new Set()
   };
   for (const file of files) {
-    const text = await readFile10(file, "utf-8");
+    const text = await readFile11(file, "utf-8");
     for (const prefix of ID_PREFIXES2) {
       const ids = extractIds(text, prefix);
       ids.forEach((id) => result[prefix].add(id));
     }
   }
   return {
-    SPEC: toSortedArray(result.SPEC),
-    BR: toSortedArray(result.BR),
-    SC: toSortedArray(result.SC),
-    UI: toSortedArray(result.UI),
-    API: toSortedArray(result.API),
-    DATA: toSortedArray(result.DATA)
+    SPEC: toSortedArray2(result.SPEC),
+    BR: toSortedArray2(result.BR),
+    SC: toSortedArray2(result.SC),
+    UI: toSortedArray2(result.UI),
+    API: toSortedArray2(result.API),
+    DATA: toSortedArray2(result.DATA)
   };
 }
 async function collectUpstreamIds(files) {
   const ids = /* @__PURE__ */ new Set();
   for (const file of files) {
-    const text = await readFile10(file, "utf-8");
+    const text = await readFile11(file, "utf-8");
     extractAllIds(text).forEach((id) => ids.add(id));
   }
   return ids;
@@ -2424,7 +2565,7 @@ async function evaluateTraceability(upstreamIds, srcRoot, testsRoot) {
   }
   const pattern = buildIdPattern2(Array.from(upstreamIds));
   for (const file of targetFiles) {
-    const text = await readFile10(file, "utf-8");
+    const text = await readFile11(file, "utf-8");
     if (pattern.test(text)) {
       return true;
     }
@@ -2441,7 +2582,7 @@ function formatIdLine(label, values) {
   }
   return `- ${label}: ${values.join(", ")}`;
 }
-function toSortedArray(values) {
+function toSortedArray2(values) {
   return Array.from(values).sort((a, b) => a.localeCompare(b));
 }
 function buildHotspots(issues) {
@@ -2508,16 +2649,11 @@ async function runReport(options) {
   info(`wrote report: ${outPath}`);
 }
 async function readValidationResult(inputPath) {
-  const raw = await readFile11(inputPath, "utf-8");
+  const raw = await readFile12(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}`);
   }
-  if (parsed.schemaVersion !== VALIDATION_SCHEMA_VERSION) {
-    throw new Error(
-      `validate.json \u306E schemaVersion \u304C\u4E0D\u4E00\u81F4\u3067\u3059: expected ${VALIDATION_SCHEMA_VERSION}, actual ${parsed.schemaVersion}`
-    );
-  }
   return parsed;
 }
 function isValidationResult(value) {
@@ -2525,9 +2661,6 @@ function isValidationResult(value) {
     return false;
   }
   const record2 = value;
-  if (typeof record2.schemaVersion !== "string") {
-    return false;
-  }
   if (typeof record2.toolVersion !== "string") {
     return false;
   }