@produtype/core 0.17.0 → 0.18.0

package/dist/report/buildReport.js

@@ -127,15 +127,6 @@ function buildReport(analysis, options) {
         || analysis.stack.databases.length > 0
         || mobileDetected
         || gameEngineDetected;
-    const inconclusive = !stackDetected && analysis.workspaceStacks.length === 0;
-    const inconclusiveReasons = [];
-    if (inconclusive) {
-        inconclusiveReasons.push('No frontend, backend, or database stack signals were detected.');
-        inconclusiveReasons.push('No package manifest was found in any format this analyzer reads.');
-        if (analysis.files.source.length === 0) {
-            inconclusiveReasons.push('No recognizable source files were found.');
-        }
-    }
     /**
      * Coverage counts the expectations too, not only the observed rules.
      *
@@ -150,6 +141,35 @@ function buildReport(analysis, options) {
     const assessedChecks = findings.filter((f) => f.status !== 'unknown').length
         + Math.max(applicableExpectations - expectationFindings.length, 0);
     const coverage = { passed: passedChecksForMaturity, assessed: assessedChecks };
+    const nothingIdentified = !stackDetected && analysis.workspaceStacks.length === 0;
+    /**
+     * Too little reached a verdict to say anything about this project.
+     *
+     * The flag used to ask whether a manifest existed, and the claim it makes is about
+     * what was learned. Two repositories with the same three verdicts came out at 39 and
+     * at 84, and the only difference between them was a `requirements.txt`: a Python
+     * script with one was judged, an equally small one without it was called unreadable.
+     *
+     * Five is where the corpus splits. Of seventy-eight repositories, eleven reach four
+     * verdicts or fewer and thirty reach ten or more; not one lands in between. Four
+     * verdicts cannot characterise a product, however many files it has.
+     */
+    const tooLittleAssessed = assessedChecks < score_1.MIN_ASSESSED_FOR_A_READING;
+    const inconclusive = nothingIdentified || tooLittleAssessed;
+    // Each reason says which of the two it was, because they call for different things:
+    // one is a repository this analyzer cannot read, the other is one there is barely
+    // anything to read.
+    const inconclusiveReasons = [];
+    if (nothingIdentified) {
+        inconclusiveReasons.push('No frontend, backend, or database stack signals were detected.');
+        inconclusiveReasons.push('No package manifest was found in any format this analyzer reads.');
+        if (analysis.files.source.length === 0) {
+            inconclusiveReasons.push('No recognizable source files were found.');
+        }
+    }
+    if (tooLittleAssessed) {
+        inconclusiveReasons.push(`Only ${assessedChecks} check${assessedChecks === 1 ? '' : 's'} reached a verdict, which is too few to characterise this project.`);
+    }
     // An unrecognized project has almost no applicable detectors, so the absence
     // of findings must not be rewarded with a high score: cap it at prototype.
     const scoreAfterInconclusive = inconclusive ? Math.min(combinedScore, 39) : combinedScore;

package/dist/report/score.d.ts

@@ -10,6 +10,16 @@ export interface ScoreCoverage {
     passed: number;
     assessed: number;
 }
+/**
+ * The fewest verdicts that can carry a reading at all.
+ *
+ * Below this the report has nothing to characterise: not a weak product, but a project
+ * this analyzer barely had anything to say about. In a corpus of seventy-eight
+ * repositories, eleven reach four verdicts or fewer and thirty reach ten or more —
+ * nothing lands in between, so the line sits in the gap rather than in the middle of a
+ * distribution.
+ */
+export declare const MIN_ASSESSED_FOR_A_READING = 5;
 /**
  * The highest score a report can reach when it may not claim the top band.
  *

package/dist/report/score.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TOP_BAND_CEILING = void 0;
+exports.TOP_BAND_CEILING = exports.MIN_ASSESSED_FOR_A_READING = void 0;
 exports.computeScore = computeScore;
 exports.coverageSupportsTopBand = coverageSupportsTopBand;
 exports.mayClaimTopBand = mayClaimTopBand;
@@ -28,6 +28,16 @@ function computeScore(findings) {
  * nothing.
  */
 const MIN_VERIFIED_FOR_PRODUCTION = 6;
+/**
+ * The fewest verdicts that can carry a reading at all.
+ *
+ * Below this the report has nothing to characterise: not a weak product, but a project
+ * this analyzer barely had anything to say about. In a corpus of seventy-eight
+ * repositories, eleven reach four verdicts or fewer and thirty reach ten or more —
+ * nothing lands in between, so the line sits in the gap rather than in the middle of a
+ * distribution.
+ */
+exports.MIN_ASSESSED_FOR_A_READING = 5;
 /**
  * The highest score a report can reach when it may not claim the top band.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@produtype/core",
-  "version": "0.17.0",
+  "version": "0.18.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": {