humanish 0.63.0 → 0.65.0

package/dist/run.d.ts

@@ -920,6 +920,10 @@ export interface StudyTaskFunnel {
         sessions: number;
         /** False when the task declared no success criterion: asked for, never measurable. */
         observable: boolean;
+        /** Sessions where this task's criteria were never evaluated, because the observations they
+         *  read never arrived. Counted apart from failures: "0/3 completed" with 3 unmeasured is a
+         *  statement about our instrument, not about the participants (#514). */
+        unmeasured: number;
     }>;
 }
 /** Roll per-participant funnels up into the study funnel. Undefined when nothing measured one. */

package/dist/run.js

@@ -92,7 +92,7 @@ export function aggregateTaskFunnels(funnels) {
         for (const task of funnel.tasks) {
             let entry = byId.get(task.id);
             if (entry === undefined) {
-                entry = { completed: 0, sessions: 0, observable: false };
+                entry = { completed: 0, sessions: 0, observable: false, unmeasured: 0 };
                 byId.set(task.id, entry);
                 order.push(task.id);
             }
@@ -101,13 +101,21 @@ export function aggregateTaskFunnels(funnels) {
                 entry.completed += 1;
             if (task.observable)
                 entry.observable = true;
+            if (task.inputsObserved === false)
+                entry.unmeasured += 1;
         }
     }
     return {
         sessions: funnels.length,
         tasks: order.map((id) => {
             const entry = byId.get(id);
-            return { id, completed: entry.completed, sessions: entry.sessions, observable: entry.observable };
+            return {
+                id,
+                completed: entry.completed,
+                sessions: entry.sessions,
+                observable: entry.observable,
+                unmeasured: entry.unmeasured
+            };
         })
     };
 }
@@ -116,9 +124,17 @@ export function formatStudyTaskFunnel(funnel) {
     if (funnel.tasks.length === 0)
         return "no tasks declared";
     return funnel.tasks
-        .map((task) => task.observable
-        ? `${task.id} ${task.completed}/${task.sessions}`
-        : `${task.id} (no completion criterion)`)
+        .map((task) => {
+        if (!task.observable)
+            return `${task.id} (no completion criterion)`;
+        // A count that is entirely unmeasured must not render as a bare "0/3": that reads as a
+        // participant failure when it is our observer that produced nothing (#514).
+        if (task.unmeasured === task.sessions) {
+            return `${task.id} (never measured in ${task.sessions})`;
+        }
+        const caveat = task.unmeasured > 0 ? ` (${task.unmeasured} never measured)` : "";
+        return `${task.id} ${task.completed}/${task.sessions}${caveat}`;
+    })
         .join(" · ");
 }
 /** One line a stakeholder can read, with the denominator attached to every number. */