@produtype/core 0.53.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

@@ -154,6 +154,24 @@ function buildVerdict(args) {
         };
     }
     const { gap, profileTitle } = args.profile;
+    /**
+     * A profile that requires nothing cannot be satisfied by having nothing.
+     *
+     * `static-site` marks every capability recommended or optional, so
+     * `requiredMissing === 0 && requiredPartial === 0` is true before anything is
+     * measured. Five static sites in the verification corpus were told they covered
+     * everything expected of them while satisfying one applicable capability out of six
+     * — the verdict and the coverage line disagreeing on the same page.
+     *
+     * The same answer as no profile at all, because it is the same situation: launch
+     * readiness is a question about requirements, and this profile states none.
+     */
+    if (gap.requiredTotal === 0) {
+        return {
+            verdict: `Nothing is strictly required of ${profileTitle}, so nothing is blocking a launch. ${gap.satisfied} of ${gap.applicableTotal} expected ${gap.applicableTotal === 1 ? 'capability is' : 'capabilities are'} in place.`,
+            launchReady: null,
+        };
+    }
     const launchReady = gap.requiredMissing === 0 && gap.requiredPartial === 0;
     if (launchReady) {
         return {
@@ -193,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.53.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": {