@produtype/core 0.55.0 → 0.56.0

package/dist/planner/buildPlan.js

@@ -167,9 +167,18 @@ function sortStates(states) {
     }
     return ordered;
 }
-function summarizePlan(tasks, actionableFindingCount) {
+function summarizePlan(tasks, actionableFindingCount, inconclusive) {
     if (tasks.length === 0) {
-        return 'ProdKit found no actionable remediation tasks from the current deterministic findings.';
+        /**
+         * An empty plan means two different things and said one sentence for both.
+         *
+         * "Found no actionable remediation tasks" reads as "there is nothing to do". On a
+         * repository this analyzer could not read, there is nothing to do *because it
+         * could not look* — and that is the opposite advice.
+         */
+        return inconclusive
+            ? 'No plan: too little of this repository could be read to say what it needs.'
+            : 'ProdKit found no actionable remediation tasks from the current deterministic findings.';
     }
     const quickWins = tasks.filter((task) => task.effort === 'small' && (task.risk === 'low' || task.risk === 'medium')).length;
     const highRisk = tasks.filter((task) => task.risk === 'high').length;
@@ -234,7 +243,7 @@ function buildPlan(report) {
         generatedAt: new Date().toISOString(),
         score: report.overallScore,
         maturityLevel: report.maturityLevel,
-        summary: summarizePlan(tasks, actionableFindings.length),
+        summary: summarizePlan(tasks, actionableFindings.length, report.inconclusive),
         phases,
         tasks,
         quickWins,

package/dist/report/executiveSummary.js

@@ -66,8 +66,26 @@ const DAYS_BY_SEVERITY = {
     low: 0.5,
     info: 0,
 };
-function estimateEffort(findings, profile) {
-    if (!profile)
+function estimateEffort(findings, profile, inconclusive) {
+    /**
+     * "Nothing outstanding to estimate" is a claim about the work, and a report that
+     * could not read the repository has no basis for it.
+     *
+     * A Python transcription script whose verdict says "ProdKit could not judge this
+     * project" was told there was nothing to do. It is the last number in the report and
+     * the same mistake as all the others: an empty list of findings read as an empty
+     * list of problems.
+     */
+    if (inconclusive)
+        return 'Not estimated: too little of this repository could be read.';
+    /**
+     * The inconclusive-inference profile is no profile.
+     *
+     * It carries an empty capability set, so estimating against it measures the observed
+     * findings and calls the answer an estimate of the gap. The sentence for having no
+     * profile already exists and is the true one.
+     */
+    if (!profile || profile.selectedProfile === 'auto')
         return 'Not estimated without a product profile.';
     const open = findings.filter((f) => f.status !== 'passed' && f.status !== 'unknown');
     if (open.length === 0)
@@ -265,7 +283,7 @@ function buildExecutiveSummary(args) {
          * the same praise.
          */
         strengths: args.inconclusive ? [] : buildStrengths(args.categoryScores, args.findings),
-        estimatedEffort: estimateEffort(args.findings, args.profile),
+        estimatedEffort: estimateEffort(args.findings, args.profile, args.inconclusive),
         scoreExplanation,
     };
 }

package/package.json

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