qfai 0.4.0 → 0.4.2

package/dist/cli/index.mjs

@@ -155,7 +155,7 @@ function report(copied, skipped, dryRun, label) {
 
 // src/cli/commands/report.ts
 import { mkdir as mkdir2, readFile as readFile12, writeFile } from "fs/promises";
-import path14 from "path";
+import path15 from "path";
 
 // src/core/config.ts
 import { readFile } from "fs/promises";
@@ -188,6 +188,8 @@ var defaultConfig = {
       brMustHaveSc: true,
       scMustTouchContracts: true,
       scMustHaveTest: true,
+      testFileGlobs: [],
+      testFileExcludeGlobs: [],
       scNoTestSeverity: "error",
       allowOrphanContracts: false,
       unknownContractIdSeverity: "error"
@@ -375,6 +377,20 @@ function normalizeValidation(raw, configPath, issues) {
         configPath,
         issues
       ),
+      testFileGlobs: readStringArray(
+        traceabilityRaw?.testFileGlobs,
+        base.traceability.testFileGlobs,
+        "validation.traceability.testFileGlobs",
+        configPath,
+        issues
+      ),
+      testFileExcludeGlobs: readStringArray(
+        traceabilityRaw?.testFileExcludeGlobs,
+        base.traceability.testFileExcludeGlobs,
+        "validation.traceability.testFileExcludeGlobs",
+        configPath,
+        issues
+      ),
       scNoTestSeverity: readTraceabilitySeverity(
         traceabilityRaw?.scNoTestSeverity,
         base.traceability.scNoTestSeverity,
@@ -508,7 +524,7 @@ function isRecord(value) {
 
 // src/core/report.ts
 import { readFile as readFile11 } from "fs/promises";
-import path13 from "path";
+import path14 from "path";
 
 // src/core/discovery.ts
 import { access as access3 } from "fs/promises";
@@ -516,6 +532,7 @@ import { access as access3 } from "fs/promises";
 // src/core/fs.ts
 import { access as access2, readdir as readdir2 } from "fs/promises";
 import path5 from "path";
+import fg from "fast-glob";
 var DEFAULT_IGNORE_DIRS = /* @__PURE__ */ new Set([
   "node_modules",
   ".git",
@@ -537,6 +554,18 @@ async function collectFiles(root, options = {}) {
   await walk(root, root, ignoreDirs, extensions, entries);
   return entries;
 }
+async function collectFilesByGlobs(root, options) {
+  if (options.globs.length === 0) {
+    return [];
+  }
+  return fg(options.globs, {
+    cwd: root,
+    ignore: options.ignore ?? [],
+    onlyFiles: true,
+    absolute: true,
+    unique: true
+  });
+}
 async function walk(base, current, ignoreDirs, extensions, out) {
   const items = await readdir2(current, { withFileTypes: true });
   for (const item of items) {
@@ -703,6 +732,7 @@ function isValidId(value, prefix) {
 
 // src/core/traceability.ts
 import { readFile as readFile2 } from "fs/promises";
+import path7 from "path";
 
 // src/core/gherkin/parse.ts
 import {
@@ -864,6 +894,27 @@ function unique2(values) {
 
 // src/core/traceability.ts
 var SC_TAG_RE2 = /^SC-\d{4}$/;
+var SC_TEST_ANNOTATION_RE = /\bQFAI:SC-(\d{4})\b/g;
+var DEFAULT_TEST_FILE_EXCLUDE_GLOBS = [
+  "**/node_modules/**",
+  "**/.git/**",
+  "**/.qfai/**",
+  "**/dist/**",
+  "**/build/**",
+  "**/coverage/**",
+  "**/.next/**",
+  "**/out/**"
+];
+function extractAnnotatedScIds(text) {
+  const ids = /* @__PURE__ */ new Set();
+  for (const match of text.matchAll(SC_TEST_ANNOTATION_RE)) {
+    const suffix = match[1];
+    if (suffix) {
+      ids.add(`SC-${suffix}`);
+    }
+  }
+  return Array.from(ids);
+}
 async function collectScIdsFromScenarioFiles(scenarioFiles) {
   const scIds = /* @__PURE__ */ new Set();
   for (const file of scenarioFiles) {
@@ -882,14 +933,67 @@ async function collectScIdsFromScenarioFiles(scenarioFiles) {
   }
   return scIds;
 }
-async function collectScTestReferences(testsRoot) {
+async function collectScIdSourcesFromScenarioFiles(scenarioFiles) {
+  const sources = /* @__PURE__ */ new Map();
+  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)) {
+          continue;
+        }
+        const current = sources.get(tag) ?? /* @__PURE__ */ new Set();
+        current.add(file);
+        sources.set(tag, current);
+      }
+    }
+  }
+  return sources;
+}
+async function collectScTestReferences(root, globs, excludeGlobs) {
   const refs = /* @__PURE__ */ new Map();
-  const testFiles = await collectFiles(testsRoot, {
-    extensions: [".ts", ".tsx", ".js", ".jsx"]
-  });
-  for (const file of testFiles) {
+  const normalizedGlobs = normalizeGlobs(globs);
+  const normalizedExcludeGlobs = normalizeGlobs(excludeGlobs);
+  const mergedExcludeGlobs = Array.from(
+    /* @__PURE__ */ new Set([...DEFAULT_TEST_FILE_EXCLUDE_GLOBS, ...normalizedExcludeGlobs])
+  );
+  if (normalizedGlobs.length === 0) {
+    return {
+      refs,
+      scan: {
+        globs: normalizedGlobs,
+        excludeGlobs: mergedExcludeGlobs,
+        matchedFileCount: 0
+      }
+    };
+  }
+  let files = [];
+  try {
+    files = await collectFilesByGlobs(root, {
+      globs: normalizedGlobs,
+      ignore: mergedExcludeGlobs
+    });
+  } catch (error2) {
+    return {
+      refs,
+      scan: {
+        globs: normalizedGlobs,
+        excludeGlobs: mergedExcludeGlobs,
+        matchedFileCount: 0
+      },
+      error: formatError3(error2)
+    };
+  }
+  const normalizedFiles = Array.from(
+    new Set(files.map((file) => path7.normalize(file)))
+  );
+  for (const file of normalizedFiles) {
     const text = await readFile2(file, "utf-8");
-    const scIds = extractIds(text, "SC");
+    const scIds = extractAnnotatedScIds(text);
     if (scIds.length === 0) {
       continue;
     }
@@ -899,7 +1003,14 @@ async function collectScTestReferences(testsRoot) {
       refs.set(scId, current);
     }
   }
-  return refs;
+  return {
+    refs,
+    scan: {
+      globs: normalizedGlobs,
+      excludeGlobs: mergedExcludeGlobs,
+      matchedFileCount: normalizedFiles.length
+    }
+  };
 }
 function buildScCoverage(scIds, refs) {
   const sortedScIds = toSortedArray(scIds);
@@ -927,14 +1038,23 @@ function buildScCoverage(scIds, refs) {
 function toSortedArray(values) {
   return Array.from(new Set(values)).sort((a, b) => a.localeCompare(b));
 }
+function normalizeGlobs(globs) {
+  return globs.map((glob) => glob.trim()).filter((glob) => glob.length > 0);
+}
+function formatError3(error2) {
+  if (error2 instanceof Error) {
+    return error2.message;
+  }
+  return String(error2);
+}
 
 // src/core/version.ts
 import { readFile as readFile3 } from "fs/promises";
-import path7 from "path";
+import path8 from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 async function resolveToolVersion() {
-  if ("0.4.0".length > 0) {
-    return "0.4.0";
+  if ("0.4.2".length > 0) {
+    return "0.4.2";
   }
   try {
     const packagePath = resolvePackageJsonPath();
@@ -949,18 +1069,18 @@ async function resolveToolVersion() {
 function resolvePackageJsonPath() {
   const base = import.meta.url;
   const basePath = base.startsWith("file:") ? fileURLToPath2(base) : base;
-  return path7.resolve(path7.dirname(basePath), "../../package.json");
+  return path8.resolve(path8.dirname(basePath), "../../package.json");
 }
 
 // src/core/validators/contracts.ts
 import { readFile as readFile4 } from "fs/promises";
-import path9 from "path";
+import path10 from "path";
 
 // src/core/contracts.ts
-import path8 from "path";
+import path9 from "path";
 import { parse as parseYaml2 } from "yaml";
 function parseStructuredContract(file, text) {
-  const ext = path8.extname(file).toLowerCase();
+  const ext = path9.extname(file).toLowerCase();
   if (ext === ".json") {
     return JSON.parse(text);
   }
@@ -1011,9 +1131,9 @@ var SQL_DANGEROUS_PATTERNS = [
 async function validateContracts(root, config) {
   const issues = [];
   const contractsRoot = resolvePath(root, config, "contractsDir");
-  issues.push(...await validateUiContracts(path9.join(contractsRoot, "ui")));
-  issues.push(...await validateApiContracts(path9.join(contractsRoot, "api")));
-  issues.push(...await validateDataContracts(path9.join(contractsRoot, "db")));
+  issues.push(...await validateUiContracts(path10.join(contractsRoot, "ui")));
+  issues.push(...await validateApiContracts(path10.join(contractsRoot, "api")));
+  issues.push(...await validateDataContracts(path10.join(contractsRoot, "db")));
   return issues;
 }
 async function validateUiContracts(uiRoot) {
@@ -1060,7 +1180,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} (${formatError3(error2)})`,
+          `UI \u5951\u7D04\u30D5\u30A1\u30A4\u30EB\u306E\u89E3\u6790\u306B\u5931\u6557\u3057\u307E\u3057\u305F: ${file} (${formatError4(error2)})`,
           "error",
           file,
           "contracts.ui.parse"
@@ -1127,7 +1247,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} (${formatError3(error2)})`,
+          `API \u5951\u7D04\u30D5\u30A1\u30A4\u30EB\u306E\u89E3\u6790\u306B\u5931\u6557\u3057\u307E\u3057\u305F: ${file} (${formatError4(error2)})`,
           "error",
           file,
           "contracts.api.parse"
@@ -1222,7 +1342,7 @@ function lintSql(text, file) {
 function hasOpenApi(doc) {
   return typeof doc.openapi === "string" && doc.openapi.length > 0;
 }
-function formatError3(error2) {
+function formatError4(error2) {
   if (error2 instanceof Error) {
     return error2.message;
   }
@@ -1248,7 +1368,7 @@ function issue(code, message, severity, file, rule, refs) {
 
 // src/core/validators/delta.ts
 import { readFile as readFile5 } from "fs/promises";
-import path10 from "path";
+import path11 from "path";
 var SECTION_RE = /^##\s+変更区分/m;
 var COMPAT_LINE_RE = /^\s*-\s*\[[ xX]\]\s*Compatibility\b/m;
 var CHANGE_LINE_RE = /^\s*-\s*\[[ xX]\]\s*Change\/Improvement\b/m;
@@ -1262,7 +1382,7 @@ async function validateDeltas(root, config) {
   }
   const issues = [];
   for (const pack of packs) {
-    const deltaPath = path10.join(pack, "delta.md");
+    const deltaPath = path11.join(pack, "delta.md");
     let text;
     try {
       text = await readFile5(deltaPath, "utf-8");
@@ -1338,16 +1458,16 @@ function issue2(code, message, severity, file, rule, refs) {
 
 // src/core/validators/ids.ts
 import { readFile as readFile7 } from "fs/promises";
-import path12 from "path";
+import path13 from "path";
 
 // src/core/contractIndex.ts
 import { readFile as readFile6 } from "fs/promises";
-import path11 from "path";
+import path12 from "path";
 async function buildContractIndex(root, config) {
   const contractsRoot = resolvePath(root, config, "contractsDir");
-  const uiRoot = path11.join(contractsRoot, "ui");
-  const apiRoot = path11.join(contractsRoot, "api");
-  const dataRoot = path11.join(contractsRoot, "db");
+  const uiRoot = path12.join(contractsRoot, "ui");
+  const apiRoot = path12.join(contractsRoot, "api");
+  const dataRoot = path12.join(contractsRoot, "db");
   const [uiFiles, apiFiles, dataFiles] = await Promise.all([
     collectUiContractFiles(uiRoot),
     collectApiContractFiles(apiRoot),
@@ -1585,7 +1705,7 @@ function recordId(out, id, file) {
 }
 function formatFileList(files, root) {
   return files.map((file) => {
-    const relative = path12.relative(root, file);
+    const relative = path13.relative(root, file);
     return relative.length > 0 ? relative : file;
   }).join(", ");
 }
@@ -1614,7 +1734,6 @@ var WHEN_PATTERN = /\bWhen\b/;
 var THEN_PATTERN = /\bThen\b/;
 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) {
   const specsRoot = resolvePath(root, config, "specsDir");
   const entries = await collectSpecEntries(specsRoot);
@@ -1694,17 +1813,7 @@ function validateScenarioContent(text, file) {
   const featureSpecTags = document.featureTags.filter(
     (tag) => SPEC_TAG_RE2.test(tag)
   );
-  if (featureSpecTags.length === 0) {
-    issues.push(
-      issue4(
-        "QFAI-SC-009",
-        "Feature \u30BF\u30B0\u306B SPEC \u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002",
-        "error",
-        file,
-        "scenario.featureSpec"
-      )
-    );
-  } else if (featureSpecTags.length > 1) {
+  if (featureSpecTags.length > 1) {
     issues.push(
       issue4(
         "QFAI-SC-009",
@@ -1732,17 +1841,6 @@ 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(
@@ -1763,12 +1861,6 @@ function validateScenarioContent(text, file) {
     } else if (scTags.length > 1) {
       missingTags.push(`SC(${scTags.length}\u4EF6/1\u4EF6\u5FC5\u9808)`);
     }
-    if (!scenario.tags.some((tag) => SPEC_TAG_RE2.test(tag))) {
-      missingTags.push("SPEC");
-    }
-    if (!scenario.tags.some((tag) => BR_TAG_RE2.test(tag))) {
-      missingTags.push("BR");
-    }
     if (missingTags.length > 0) {
       issues.push(
         issue4(
@@ -2003,9 +2095,8 @@ function isMissingFileError4(error2) {
 
 // src/core/validators/traceability.ts
 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}$/;
+var BR_TAG_RE2 = /^BR-\d{4}$/;
 async function validateTraceability(root, config) {
   const issues = [];
   const specsRoot = resolvePath(root, config, "specsDir");
@@ -2032,28 +2123,6 @@ async function validateTraceability(root, config) {
     }
     const brIds = parsed.brs.map((br) => br.id);
     brIds.forEach((id) => brIdsInSpecs.add(id));
-    const referencedContractIds = /* @__PURE__ */ new Set([
-      ...extractIds(text, "UI"),
-      ...extractIds(text, "API"),
-      ...extractIds(text, "DATA")
-    ]);
-    const unknownContractIds = Array.from(referencedContractIds).filter(
-      (id) => !contractIds.has(id)
-    );
-    if (unknownContractIds.length > 0) {
-      issues.push(
-        issue6(
-          "QFAI-TRACE-009",
-          `Spec \u304C\u5B58\u5728\u3057\u306A\u3044\u5951\u7D04 ID \u3092\u53C2\u7167\u3057\u3066\u3044\u307E\u3059: ${unknownContractIds.join(
-            ", "
-          )}`,
-          "error",
-          file,
-          "traceability.specContractExists",
-          unknownContractIds
-        )
-      );
-    }
     if (parsed.specId) {
       const current = specToBrIds.get(parsed.specId) ?? /* @__PURE__ */ new Set();
       brIds.forEach((id) => current.add(id));
@@ -2068,16 +2137,42 @@ async function validateTraceability(root, config) {
       continue;
     }
     const atoms = buildScenarioAtoms(document);
+    const scIdsInFile = /* @__PURE__ */ new Set();
     for (const [index, scenario] of document.scenarios.entries()) {
       const atom = atoms[index];
       if (!atom) {
         continue;
       }
       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_RE5.test(tag));
+      const brTags = scenario.tags.filter((tag) => BR_TAG_RE2.test(tag));
+      const scTags = scenario.tags.filter((tag) => SC_TAG_RE2.test(tag));
+      if (specTags.length === 0) {
+        issues.push(
+          issue6(
+            "QFAI-TRACE-014",
+            `Scenario \u304C SPEC \u30BF\u30B0\u3092\u6301\u3063\u3066\u3044\u307E\u305B\u3093: ${scenario.name}`,
+            "error",
+            file,
+            "traceability.scenarioSpecRequired"
+          )
+        );
+      }
+      if (brTags.length === 0) {
+        issues.push(
+          issue6(
+            "QFAI-TRACE-015",
+            `Scenario \u304C BR \u30BF\u30B0\u3092\u6301\u3063\u3066\u3044\u307E\u305B\u3093: ${scenario.name}`,
+            "error",
+            file,
+            "traceability.scenarioBrRequired"
+          )
+        );
+      }
       brTags.forEach((id) => brIdsInScenarios.add(id));
-      scTags.forEach((id) => scIdsInScenarios.add(id));
+      scTags.forEach((id) => {
+        scIdsInScenarios.add(id);
+        scIdsInFile.add(id);
+      });
       atom.contractIds.forEach((id) => scenarioContractIds.add(id));
       if (atom.contractIds.length > 0) {
         scTags.forEach((id) => scWithContracts.add(id));
@@ -2155,6 +2250,22 @@ async function validateTraceability(root, config) {
         }
       }
     }
+    if (scIdsInFile.size !== 1) {
+      const invalidScIds = Array.from(scIdsInFile).sort(
+        (a, b) => a.localeCompare(b)
+      );
+      const detail = invalidScIds.length === 0 ? "SC \u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093" : `\u8907\u6570\u306E SC \u304C\u5B58\u5728\u3057\u307E\u3059: ${invalidScIds.join(", ")}`;
+      issues.push(
+        issue6(
+          "QFAI-TRACE-012",
+          `Spec entry \u304C Spec:SC=1:1 \u3092\u6E80\u305F\u3057\u3066\u3044\u307E\u305B\u3093: ${detail}`,
+          "error",
+          file,
+          "traceability.specScOneToOne",
+          invalidScIds
+        )
+      );
+    }
   }
   if (upstreamIds.size === 0) {
     return [
@@ -2203,21 +2314,62 @@ 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) {
+  const scRefsResult = await collectScTestReferences(
+    root,
+    config.validation.traceability.testFileGlobs,
+    config.validation.traceability.testFileExcludeGlobs
+  );
+  const scTestRefs = scRefsResult.refs;
+  const testFileScan = scRefsResult.scan;
+  const hasScenarios = scIdsInScenarios.size > 0;
+  const hasGlobConfig = testFileScan.globs.length > 0;
+  const hasMatchedTests = testFileScan.matchedFileCount > 0;
+  if (hasScenarios && (!hasGlobConfig || !hasMatchedTests || scRefsResult.error)) {
+    const detail = scRefsResult.error ? `\uFF08\u8A73\u7D30: ${scRefsResult.error}\uFF09` : "";
+    issues.push(
+      issue6(
+        "QFAI-TRACE-013",
+        `\u30C6\u30B9\u30C8\u63A2\u7D22 glob \u304C\u672A\u8A2D\u5B9A/\u4E0D\u6B63/\u4E00\u81F4\u30D5\u30A1\u30A4\u30EB0\u306E\u305F\u3081 SC\u2192Test \u3092\u5224\u5B9A\u3067\u304D\u307E\u305B\u3093\u3002${detail}`,
+        "error",
+        testsRoot,
+        "traceability.testFileGlobs"
+      )
+    );
+  } else {
+    if (config.validation.traceability.scMustHaveTest && scIdsInScenarios.size) {
+      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\u30C6\u30B9\u30C8\u3067\u53C2\u7167\u3055\u308C\u3066\u3044\u307E\u305B\u3093: ${scWithoutTests.join(
+              ", "
+            )}\u3002testFileGlobs \u306B\u4E00\u81F4\u3059\u308B\u30C6\u30B9\u30C8\u30D5\u30A1\u30A4\u30EB\u3078 QFAI:SC-xxxx \u3092\u8A18\u8F09\u3057\u3066\u304F\u3060\u3055\u3044\u3002`,
+            config.validation.traceability.scNoTestSeverity,
+            testsRoot,
+            "traceability.scMustHaveTest",
+            scWithoutTests
+          )
+        );
+      }
+    }
+    const unknownScIds = Array.from(scTestRefs.keys()).filter(
+      (id) => !scIdsInScenarios.has(id)
+    );
+    if (unknownScIds.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,
+          "QFAI-TRACE-011",
+          `\u30C6\u30B9\u30C8\u304C\u672A\u77E5\u306E SC \u3092\u30A2\u30CE\u30C6\u30FC\u30B7\u30E7\u30F3\u53C2\u7167\u3057\u3066\u3044\u307E\u3059: ${unknownScIds.join(
+            ", "
+          )}`,
+          "error",
           testsRoot,
-          "traceability.scMustHaveTest",
-          scWithoutTests
+          "traceability.scUnknownInTests",
+          unknownScIds
         )
       );
     }
@@ -2280,8 +2432,8 @@ async function validateCodeReferences(upstreamIds, srcRoot, testsRoot) {
     issues.push(
       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",
+        "\u4E0A\u6D41 ID \u304C\u30B3\u30FC\u30C9/\u30C6\u30B9\u30C8\u306B\u53C2\u7167\u3055\u308C\u3066\u3044\u307E\u305B\u3093\uFF08\u53C2\u8003\u60C5\u5831\uFF09\u3002",
+        "info",
         srcRoot,
         "traceability.codeReferences"
       )
@@ -2324,11 +2476,24 @@ async function validateProject(root, configResult) {
     ...await validateDefinedIds(root, config),
     ...await validateTraceability(root, config)
   ];
+  const specsRoot = resolvePath(root, config, "specsDir");
+  const scenarioFiles = await collectScenarioFiles(specsRoot);
+  const scIds = await collectScIdsFromScenarioFiles(scenarioFiles);
+  const { refs: scTestRefs, scan: testFiles } = await collectScTestReferences(
+    root,
+    config.validation.traceability.testFileGlobs,
+    config.validation.traceability.testFileExcludeGlobs
+  );
+  const scCoverage = buildScCoverage(scIds, scTestRefs);
   const toolVersion = await resolveToolVersion();
   return {
     toolVersion,
     issues,
-    counts: countIssues(issues)
+    counts: countIssues(issues),
+    traceability: {
+      sc: scCoverage,
+      testFiles
+    }
   };
 }
 function countIssues(issues) {
@@ -2349,9 +2514,9 @@ async function createReportData(root, validation, configResult) {
   const configPath = resolved.configPath;
   const specsRoot = resolvePath(root, config, "specsDir");
   const contractsRoot = resolvePath(root, config, "contractsDir");
-  const apiRoot = path13.join(contractsRoot, "api");
-  const uiRoot = path13.join(contractsRoot, "ui");
-  const dbRoot = path13.join(contractsRoot, "db");
+  const apiRoot = path14.join(contractsRoot, "api");
+  const uiRoot = path14.join(contractsRoot, "ui");
+  const dbRoot = path14.join(contractsRoot, "db");
   const srcRoot = resolvePath(root, config, "srcDir");
   const testsRoot = resolvePath(root, config, "testsDir");
   const specFiles = await collectSpecFiles(specsRoot);
@@ -2378,8 +2543,15 @@ async function createReportData(root, validation, configResult) {
     testsRoot
   );
   const scIds = await collectScIdsFromScenarioFiles(scenarioFiles);
-  const scTestRefs = await collectScTestReferences(testsRoot);
-  const scCoverage = buildScCoverage(scIds, scTestRefs);
+  const scRefsResult = await collectScTestReferences(
+    root,
+    config.validation.traceability.testFileGlobs,
+    config.validation.traceability.testFileExcludeGlobs
+  );
+  const scCoverage = validation?.traceability?.sc ?? buildScCoverage(scIds, scRefsResult.refs);
+  const testFiles = validation?.traceability?.testFiles ?? scRefsResult.scan;
+  const scSources = await collectScIdSourcesFromScenarioFiles(scenarioFiles);
+  const scSourceRecord = mapToSortedRecord(scSources);
   const resolvedValidation = validation ?? await validateProject(root, resolved);
   const version = await resolveToolVersion();
   return {
@@ -2409,7 +2581,9 @@ async function createReportData(root, validation, configResult) {
     traceability: {
       upstreamIdsFound: upstreamIds.size,
       referencedInCodeOrTests: traceability,
-      sc: scCoverage
+      sc: scCoverage,
+      scSources: scSourceRecord,
+      testFiles
     },
     issues: resolvedValidation.issues
   };
@@ -2450,10 +2624,29 @@ function formatReportMarkdown(data) {
   lines.push(`- total: ${data.traceability.sc.total}`);
   lines.push(`- covered: ${data.traceability.sc.covered}`);
   lines.push(`- missing: ${data.traceability.sc.missing}`);
+  lines.push(
+    `- testFileGlobs: ${formatList(data.traceability.testFiles.globs)}`
+  );
+  lines.push(
+    `- testFileExcludeGlobs: ${formatList(
+      data.traceability.testFiles.excludeGlobs
+    )}`
+  );
+  lines.push(
+    `- testFileCount: ${data.traceability.testFiles.matchedFileCount}`
+  );
   if (data.traceability.sc.missingIds.length === 0) {
     lines.push("- missingIds: (none)");
   } else {
-    lines.push(`- missingIds: ${data.traceability.sc.missingIds.join(", ")}`);
+    const sources = data.traceability.scSources;
+    const missingWithSources = data.traceability.sc.missingIds.map((id) => {
+      const files = sources[id] ?? [];
+      if (files.length === 0) {
+        return id;
+      }
+      return `${id} (${files.join(", ")})`;
+    });
+    lines.push(`- missingIds: ${missingWithSources.join(", ")}`);
   }
   lines.push("");
   lines.push("## SC\u2192\u53C2\u7167\u30C6\u30B9\u30C8");
@@ -2472,6 +2665,20 @@ function formatReportMarkdown(data) {
     }
   }
   lines.push("");
+  lines.push("## Spec:SC=1:1 \u9055\u53CD");
+  const specScIssues = data.issues.filter(
+    (item) => item.code === "QFAI-TRACE-012"
+  );
+  if (specScIssues.length === 0) {
+    lines.push("- (none)");
+  } else {
+    for (const item of specScIssues) {
+      const location = item.file ?? "(unknown)";
+      const refs = item.refs && item.refs.length > 0 ? item.refs.join(", ") : item.message;
+      lines.push(`- ${location}: ${refs}`);
+    }
+  }
+  lines.push("");
   lines.push("## Hotspots");
   const hotspots = buildHotspots(data.issues);
   if (hotspots.length === 0) {
@@ -2582,9 +2789,22 @@ function formatIdLine(label, values) {
   }
   return `- ${label}: ${values.join(", ")}`;
 }
+function formatList(values) {
+  if (values.length === 0) {
+    return "(none)";
+  }
+  return values.join(", ");
+}
 function toSortedArray2(values) {
   return Array.from(values).sort((a, b) => a.localeCompare(b));
 }
+function mapToSortedRecord(values) {
+  const record2 = {};
+  for (const [key, files] of values.entries()) {
+    record2[key] = Array.from(files).sort((a, b) => a.localeCompare(b));
+  }
+  return record2;
+}
 function buildHotspots(issues) {
   const map = /* @__PURE__ */ new Map();
   for (const issue7 of issues) {
@@ -2609,10 +2829,10 @@ function buildHotspots(issues) {
 
 // src/cli/commands/report.ts
 async function runReport(options) {
-  const root = path14.resolve(options.root);
+  const root = path15.resolve(options.root);
   const configResult = await loadConfig(root);
   const input = configResult.config.output.validateJsonPath;
-  const inputPath = path14.isAbsolute(input) ? input : path14.resolve(root, input);
+  const inputPath = path15.isAbsolute(input) ? input : path15.resolve(root, input);
   let validation;
   try {
     validation = await readValidationResult(inputPath);
@@ -2637,10 +2857,10 @@ async function runReport(options) {
   const data = await createReportData(root, validation, configResult);
   const output = options.format === "json" ? formatReportJson(data) : formatReportMarkdown(data);
   const outRoot = resolvePath(root, configResult.config, "outDir");
-  const defaultOut = options.format === "json" ? path14.join(outRoot, "report.json") : path14.join(outRoot, "report.md");
+  const defaultOut = options.format === "json" ? path15.join(outRoot, "report.json") : path15.join(outRoot, "report.md");
   const out = options.outPath ?? defaultOut;
-  const outPath = path14.isAbsolute(out) ? out : path14.resolve(root, out);
-  await mkdir2(path14.dirname(outPath), { recursive: true });
+  const outPath = path15.isAbsolute(out) ? out : path15.resolve(root, out);
+  await mkdir2(path15.dirname(outPath), { recursive: true });
   await writeFile(outPath, `${output}
 `, "utf-8");
   info(
@@ -2683,7 +2903,7 @@ function isMissingFileError5(error2) {
 
 // src/cli/commands/validate.ts
 import { mkdir as mkdir3, writeFile as writeFile2 } from "fs/promises";
-import path15 from "path";
+import path16 from "path";
 
 // src/cli/lib/failOn.ts
 function shouldFail(result, failOn) {
@@ -2698,7 +2918,7 @@ function shouldFail(result, failOn) {
 
 // src/cli/commands/validate.ts
 async function runValidate(options) {
-  const root = path15.resolve(options.root);
+  const root = path16.resolve(options.root);
   const configResult = await loadConfig(root);
   const result = await validateProject(root, configResult);
   const format = options.format ?? "text";
@@ -2747,8 +2967,8 @@ function emitGitHub(issue7) {
   );
 }
 async function emitJson(result, root, jsonPath) {
-  const abs = path15.isAbsolute(jsonPath) ? jsonPath : path15.resolve(root, jsonPath);
-  await mkdir3(path15.dirname(abs), { recursive: true });
+  const abs = path16.isAbsolute(jsonPath) ? jsonPath : path16.resolve(root, jsonPath);
+  await mkdir3(path16.dirname(abs), { recursive: true });
   await writeFile2(abs, `${JSON.stringify(result, null, 2)}
 `, "utf-8");
 }