@cardenelabs/cdl 0.41.0 → 0.41.1

package/CHANGELOG.md

@@ -5,6 +5,34 @@ CDL (Chainome Diagram Language) の主要変更履歴。
 
 ## [Unreleased]
 
+## [0.41.1] - 2026-09-10
+
+### Changed
+
+- **検査の速さの判定を、1 枚ごとの壁時計から全図の合計へ移した** (#776)
+
+  同じ図を同じ process で 3 周すると答えが変わっていた。
+
+  | 図 | 1 周目 | 2 周目 | 3 周目 |
+  |---|---|---|---|
+  | `interactive-social-share-buttons` | 53ms | 0ms | 1ms |
+  | `interactive-traffic-sankey` | 50ms | 159ms | 115ms |
+
+  1 つ目は最初の 1 回だけ掛かる下準備、2 つ目は機械の混み具合で、どちらも図の性質ではない。
+  100ms の境で数えると **入力が同じなのに超過が 0 / 1 / 1 件** と周ごとに変わり、
+  測れなかったことを「遅い」 に倒していた。
+
+  合計は同じ 3 周で 559 / 877 / 858 ms と 1.6 倍の幅に収まり、境の 5000ms から充分離れて
+  いるので判定が安定する。 **合計だけを見る**。
+
+  **報告を 1 件に丸めるのもやめた**。 旧実装は `findIndex` で最初に当たった 1 枚しか
+  出しておらず、20 枚が超過した周でも報告は 1 枚だった。 超過した時は重い順の内訳を文面へ
+  載せ、出し切れない分は「残り N 図は出していない」 と件数で残す。
+
+  判定は `perfBudgetViolations` として切り出した。 合計が 5000ms を超える状況を実際に作ると
+  確かめる検査そのものが 5 秒以上掛かるため、時間の配列を直接渡せる形にしている。
+  `index.ts` からは出していないので、公開する API は変わらない。
+
 ## [0.41.0] - 2026-09-10
 
 ### Removed (破壊的変更)
@@ -2111,7 +2139,8 @@ Initial OSS release.
 使わない = annotated tag を push しても GitHub Release は作られず、 Release を作っていない版で
 行き止まりになる。
 
-[Unreleased]: https://github.com/cardene777/cdl/compare/v0.41.0...HEAD
+[Unreleased]: https://github.com/cardene777/cdl/compare/v0.41.1...HEAD
+[0.41.1]: https://github.com/cardene777/cdl/compare/v0.41.0...v0.41.1
 [0.41.0]: https://github.com/cardene777/cdl/compare/v0.40.12...v0.41.0
 [0.40.12]: https://github.com/cardene777/cdl/compare/v0.40.11...v0.40.12
 [0.40.11]: https://github.com/cardene777/cdl/compare/v0.40.10...v0.40.11

package/dist/index.cjs

@@ -17707,6 +17707,24 @@ function visualValidateAll(diagrams, opts) {
     metaViolations
   };
 }
+var PERF_BUDGET_TOTAL_MS = 5e3;
+var PERF_SLOWEST_SAMPLE = 5;
+function perfBudgetViolations(durations, diagrams = []) {
+  const total = durations.reduce((s, d) => s + d, 0);
+  if (total <= PERF_BUDGET_TOTAL_MS) return [];
+  const \u91CD\u3044\u9806 = durations.map((ms, i) => ({ id: diagrams[i]?.id ?? "?", ms })).sort((a, b) => b.ms - a.ms);
+  const \u629C\u7C8B = \u91CD\u3044\u9806.slice(0, PERF_SLOWEST_SAMPLE);
+  const \u6B8B\u308A = \u91CD\u3044\u9806.length - \u629C\u7C8B.length;
+  const \u5185\u8A33 = \u629C\u7C8B.map((d) => `"${d.id}" ${d.ms}ms`).join(" / ") + (\u6B8B\u308A > 0 ? `\u3001 \u6B8B\u308A ${\u6B8B\u308A} \u56F3\u306F\u51FA\u3057\u3066\u3044\u306A\u3044` : "");
+  return [
+    {
+      axis: "validate-performance-budget",
+      diagramId: "__meta__",
+      detail: `visualValidateAll \u5168 ${durations.length} \u56F3\u306E\u7D2F\u8A08 ${total}ms > ${PERF_BUDGET_TOTAL_MS}ms budget (\u91CD\u3044\u9806 ${\u5185\u8A33})`,
+      severity: "warn"
+    }
+  ];
+}
 function validateMetaAxes(totalCounts, diagrams = [], durations = [], reports = []) {
   const out = [];
   const totalErrors = reports.reduce(
@@ -17722,27 +17740,7 @@ function validateMetaAxes(totalCounts, diagrams = [], durations = [], reports =
       severity: "warn"
     });
   }
-  const PERF_BUDGET_PER_DIAGRAM_MS = 100;
-  const PERF_BUDGET_TOTAL_MS = 5e3;
-  const overBudgetIdx = durations.findIndex((d) => d > PERF_BUDGET_PER_DIAGRAM_MS);
-  if (overBudgetIdx >= 0) {
-    const did = diagrams[overBudgetIdx]?.id ?? "?";
-    out.push({
-      axis: "validate-performance-budget",
-      diagramId: did,
-      detail: `diagram "${did}" validate ${durations[overBudgetIdx]}ms > ${PERF_BUDGET_PER_DIAGRAM_MS}ms budget`,
-      severity: "warn"
-    });
-  }
-  const totalDur = durations.reduce((s, d) => s + d, 0);
-  if (totalDur > PERF_BUDGET_TOTAL_MS) {
-    out.push({
-      axis: "validate-performance-budget",
-      diagramId: "__meta__",
-      detail: `visualValidateAll \u5168 diagram \u7D2F\u8A08 ${totalDur}ms > ${PERF_BUDGET_TOTAL_MS}ms budget`,
-      severity: "warn"
-    });
-  }
+  out.push(...perfBudgetViolations(durations, diagrams));
   const DEAD_ALLOWLIST = [
     // catalog で自然発火なしを許容する security / migration / performance / meta / dev-quality axis 群。
     // 実 diagram に該当データ (XSS / migration list / oversized / broken doc) が混入するのが稀なため。