@produtype/core 0.54.0 → 0.55.0

package/dist/report/categoryScores.d.ts

@@ -17,6 +17,8 @@ export interface CategoryScore {
     assessedCount: number;
     criticalCount: number;
     highCount: number;
+    /** Checks in this category that reached no verdict. */
+    unknownCount: number;
     /** True when nothing in the analysis touched this category, so the score is not evidence of health. */
     notAssessed: boolean;
 }

package/dist/report/categoryScores.js

@@ -112,6 +112,14 @@ function buildCategoryScores(findings) {
             verifiedCount: assessed.filter((finding) => finding.status === 'passed').length,
             /** Checks in this category that reached a verdict either way. */
             assessedCount: assessed.length,
+            /**
+             * Checks in this category that did not.
+             *
+             * "Taking payments: 1 check verified, nothing outstanding" appeared under "what
+             * already works" on the strength of one check out of eleven in that category.
+             * The count that stops the misreading is the one that was missing.
+             */
+            unknownCount: categoryFindings.filter((finding) => finding.status === 'unknown').length,
             criticalCount: actionable.filter((finding) => finding.severity === 'critical').length,
             highCount: actionable.filter((finding) => finding.severity === 'high').length,
             /**

package/dist/report/executiveSummary.js

@@ -211,7 +211,22 @@ function buildStrengths(categoryScores, findings) {
     const strengths = strongCategories.slice(0, 3).map((entry) => {
         const label = CATEGORY_LABEL[entry.category];
         const checks = entry.verifiedCount === 1 ? '1 check' : `${entry.verifiedCount} checks`;
-        return `${label}: ${checks} verified, nothing outstanding`;
+        /**
+         * The coverage, not a claim of completeness.
+         *
+         * "Taking payments: 1 check verified, nothing outstanding" told a reader their
+         * billing was in good shape on the strength of one check. Forty-nine of ninety
+         * strengths across the verification corpus read that way. "Nothing outstanding"
+         * means "no finding among the checks that ran", and in a category where one check
+         * ran and ten did not, that is a sentence about this analyzer rather than about
+         * the product.
+         *
+         * Saying how many did not run is what stops the misreading, and it costs four
+         * words.
+         */
+        return entry.unknownCount > 0
+            ? `${label}: ${checks} verified, ${entry.unknownCount} not assessed`
+            : `${label}: ${checks} verified`;
     });
     if (strengths.length === 0 && passed.length > 0) {
         strengths.push(`${passed.length} individual ${passed.length === 1 ? 'check' : 'checks'} already pass`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@produtype/core",
-  "version": "0.54.0",
+  "version": "0.55.0",
   "description": "Deterministic CLI and library that analyzes a web application repository and reports how far it is from production-ready for the kind of product it is meant to be.",
   "license": "MIT",
   "bin": {