humanish 0.86.0 → 0.87.0

package/dist/run.d.ts

@@ -937,7 +937,7 @@ export interface ParticipantOutcomes {
     reachedGoal: number;
     /** Stopped trying. A finding about the product. */
     abandoned: number;
-    /** Ran out of session or budget before reaching the goal. */
+    /** Interrupted before reaching the goal, including session, spend and provider limits. */
     ranOut: number;
     /** Needed an approval the run could not give. */
     blocked: number;
@@ -1012,7 +1012,10 @@ export declare function aggregateTaskFunnels(funnels: readonly TaskFunnel[]): St
 /** The funnel as one line, denominator on every number: `signup 2/2 · verify-email 1/2`. */
 export declare function formatStudyTaskFunnel(funnel: StudyTaskFunnel): string;
 /** One line a stakeholder can read, with the denominator attached to every number. */
-export declare function formatParticipantOutcomes(outcomes: ParticipantOutcomes): string;
+export declare function formatParticipantOutcomes(outcomes: ParticipantOutcomes, terminalCauses?: readonly {
+    status: ActorStatus;
+    label?: string;
+}[]): string;
 export declare function buildRunSource(args: {
     cwd: string;
     capturedAt?: Date | string;
@@ -1032,7 +1035,7 @@ export interface RunResult {
     latestPath?: string;
     warnings: string[];
     error?: {
-        code: "HUMANISH_ACTOR_FANOUT_UNIMPLEMENTED" | "HUMANISH_APP_URL_OPTION_CONFLICT" | "HUMANISH_BROWSER_APP_CAPTURE_FAILED" | "HUMANISH_CODEX_APP_SERVER_FAILED" | "HUMANISH_LIVE_RUN_UNIMPLEMENTED" | "HUMANISH_LOCAL_CODEX_EXEC_FAILED" | "HUMANISH_LOCAL_CODEX_TUI_FAILED" | "HUMANISH_INVALID_APP_URL" | "HUMANISH_INVALID_ACTOR_CONCURRENCY" | "HUMANISH_INVALID_CWD" | "HUMANISH_INVALID_SIM_COUNT" | "HUMANISH_INVALID_TIMEOUT" | "HUMANISH_INVALID_PORT" | "HUMANISH_UNSUPPORTED_ACTOR" | "HUMANISH_UNSUPPORTED_RERUN_FLAGS" | "HUMANISH_WATCH_OPTION_CONFLICT" | "HUMANISH_LAB_SCORER_BAD_REF" | "HUMANISH_LAB_SCORER_NOT_FOUND" | "HUMANISH_LAB_SCORER_LOAD_FAILED" | "HUMANISH_LAB_SCORER_NO_HOOKS" | "HUMANISH_LAB_SCORER_UNSUPPORTED_BACKEND";
+        code: "HUMANISH_LAB_TASKS_UNSUPPORTED" | "HUMANISH_ACTOR_FANOUT_UNIMPLEMENTED" | "HUMANISH_APP_URL_OPTION_CONFLICT" | "HUMANISH_BROWSER_APP_CAPTURE_FAILED" | "HUMANISH_CODEX_APP_SERVER_FAILED" | "HUMANISH_LIVE_RUN_UNIMPLEMENTED" | "HUMANISH_LOCAL_CODEX_EXEC_FAILED" | "HUMANISH_LOCAL_CODEX_TUI_FAILED" | "HUMANISH_INVALID_APP_URL" | "HUMANISH_INVALID_ACTOR_CONCURRENCY" | "HUMANISH_INVALID_CWD" | "HUMANISH_INVALID_SIM_COUNT" | "HUMANISH_INVALID_TIMEOUT" | "HUMANISH_INVALID_PORT" | "HUMANISH_UNSUPPORTED_ACTOR" | "HUMANISH_UNSUPPORTED_RERUN_FLAGS" | "HUMANISH_WATCH_OPTION_CONFLICT" | "HUMANISH_LAB_SCORER_BAD_REF" | "HUMANISH_LAB_SCORER_NOT_FOUND" | "HUMANISH_LAB_SCORER_LOAD_FAILED" | "HUMANISH_LAB_SCORER_NO_HOOKS" | "HUMANISH_LAB_SCORER_UNSUPPORTED_BACKEND";
         message: string;
     };
 }

package/dist/run.js

@@ -138,21 +138,36 @@ export function formatStudyTaskFunnel(funnel) {
         .join(" · ");
 }
 /** One line a stakeholder can read, with the denominator attached to every number. */
-export function formatParticipantOutcomes(outcomes) {
+export function formatParticipantOutcomes(outcomes, terminalCauses = []) {
     if (outcomes.total === 0)
         return "no participants reached a terminal state";
     const parts = [`${outcomes.reachedGoal}/${outcomes.total} reached the goal`];
-    if (outcomes.abandoned > 0)
-        parts.push(`${outcomes.abandoned} gave up`);
-    if (outcomes.ranOut > 0)
-        parts.push(`${outcomes.ranOut} ran out of session`);
+    // Detail may explain a recorded outcome, but must never change its count or invent a match
+    // between a tally and an incomplete set of traces.
+    const append = (count, statuses, fallback) => {
+        if (count === 0)
+            return;
+        const matching = terminalCauses.filter((entry) => statuses.includes(entry.status));
+        if (matching.length !== count) {
+            parts.push(`${count} ${fallback}`);
+            return;
+        }
+        const counts = new Map();
+        for (const entry of matching) {
+            const description = entry.label === undefined ? fallback : `interrupted (${entry.label})`;
+            counts.set(description, (counts.get(description) ?? 0) + 1);
+        }
+        for (const [description, n] of counts)
+            parts.push(`${n} ${description}`);
+    };
+    append(outcomes.abandoned, ["abandoned"], "gave up");
+    append(outcomes.ranOut, ["incomplete", "timed_out"], "interrupted (stop details unavailable)");
     // "blocked" covers an approval the run could not give AND a blocker the participant reported in
     // its own words (#476); the old "on an approval" read wrongly on a keyboard-first participant who
     // wrote "Blocked before diagram creation" about a mouse-only modal.
     if (outcomes.blocked > 0)
         parts.push(`${outcomes.blocked} blocked`);
-    if (outcomes.harnessFailed > 0)
-        parts.push(`${outcomes.harnessFailed} lost to a harness failure`);
+    append(outcomes.harnessFailed, ["failed"], "lost to a harness failure");
     // Last, and separate, because it cuts across the outcomes rather than partitioning them: someone
     // can reach the goal and still have found the road there broken.
     if (outcomes.reportedFriction > 0)