cyborg-hunter 0.8.0 → 0.9.1

package/src/cli/renderers/trajectories-core.js

@@ -26,6 +26,7 @@
 //   - Title with trial ID, RT, mouse count, tab-away count + total duration
 
 import { ruleChronologicalCompare } from '../extract-core.js';
+import { formatScore } from '../analyzers/score-weights.js';
 
 // Panel dimensions (pixels).
 const PANEL_W = 400;
@@ -121,7 +122,7 @@ export function drawTrajectoryGrid(p, triageEntry, config, createCanvas) {
   ctx.fillRect(0, 0, canvasW, canvasH);
 
   // Header
-  const headerText = `${p.participantId} — Score: ${triageEntry?.score ?? '?'} — ${triageEntry?.reason ?? ''}`;
+  const headerText = `${p.participantId} — Score: ${formatScore(triageEntry?.score ?? '?')} — ${triageEntry?.reason ?? ''}`;
   ctx.fillStyle = COLORS.headerText;
   ctx.font = 'bold 16px sans-serif';
   ctx.fillText(headerText, PANEL_PAD, 30);

package/src/cli/renderers/triage-md.js

@@ -4,8 +4,15 @@
 
 import { writeFileSync } from 'fs';
 import { join } from 'path';
+import { resolveScoreWeights, formulaText, formatScore } from '../analyzers/score-weights.js';
 
 export async function renderTriage(triage, config) {
+  // Default weights keep the 0.8.0 sentence verbatim; custom ones state the
+  // formula that was actually applied (config.scoreWeights).
+  const { weights, isDefault } = resolveScoreWeights(config?.scoreWeights);
+  const formula = isDefault
+    ? 'heuristic (5×paste + 5×copy + 3×sidebar + 1×tab-away) — it orders rows'
+    : `heuristic (${formulaText(weights)}, set by scoreWeights) — it orders rows`;
   const lines = [
     '# Participant Triage — Ranked by Suspiciousness',
     '',
@@ -14,7 +21,7 @@ export async function renderTriage(triage, config) {
     '**Tier** is the library\'s two-tier screening verdict: `HARD` = a hard signal',
     '(paste/drop/copy) crossed its count threshold; `soft` = library soft score ≥',
     'its threshold; `clean` = neither. **Score** is the CLI\'s separate ranking',
-    'heuristic (5×paste + 5×copy + 3×sidebar + 1×tab-away) — it orders rows',
+    formula,
     '*within* a tier and is not the library soft score.',
     '',
     '| Rank | Participant | Tier | Score | Reason |',
@@ -25,7 +32,7 @@ export async function renderTriage(triage, config) {
     const tier = t.hardTriggered ? '**HARD**' : t.softFlagged ? 'soft' : 'clean';
     // Escape pipe characters in reason text to avoid breaking the table
     const reason = t.reason.replace(/\|/g, '\\|');
-    lines.push(`| ${i + 1} | ${t.participantId} | ${tier} | ${t.score} | ${reason} |`);
+    lines.push(`| ${i + 1} | ${t.participantId} | ${tier} | ${formatScore(t.score)} | ${reason} |`);
   });
 
   lines.push('');

package/src/cli/report.js

@@ -12,6 +12,7 @@ import { ingest } from './ingest.js';
 import { computeSummary } from './analyzers/summary.js';
 import { detectEdgeExits } from './analyzers/edge-exit.js';
 import { rankTriage } from './analyzers/triage.js';
+import { resolveScoreWeights, formulaText } from './analyzers/score-weights.js';
 import { applyPhaseScope, describePhaseScope, findUnmatchedPhaseScopePhases } from './analyzers/phase-scope.js';
 import { VERSION } from '../shared/constants.js';
 import { checkForUpdate, formatUpdateNotice, formatCollectedVersionNotice } from './update-check.js';
@@ -86,14 +87,18 @@ export async function run(args) {
   // "flagged": the tier counts below come from the LIBRARY's two-tier
   // screening (hard count thresholds / soft score vs its threshold), while
   // triage.md is ORDERED by the CLI's separate composite triage score
-  // (5×paste + 5×copy + 3×sidebar + 1×tab-away) within each tier. Label both
-  // explicitly so the console summary can't be read as "top N of triage.md".
+  // (by default 5×paste + 5×copy + 3×sidebar + 1×tab-away; config.scoreWeights
+  // can change it) within each tier. Label both explicitly so the console
+  // summary can't be read as "top N of triage.md".
+  const scoreWeights = resolveScoreWeights(config.scoreWeights);
   console.log(`\nAnalyzing...`);
   console.log(`  Hard-flagged (hard signal crossed its count threshold): ${flaggedHard}`);
   console.log(`  Soft-flagged (library soft score >= its threshold):     ${flaggedSoft}`);
   console.log(`  Clean:                                                  ${clean}`);
   console.log(`  Triage.md orders tier-first (hard > soft > clean), then by the CLI`);
-  console.log(`  triage score (5xpaste + 5xcopy + 3xsidebar + 1xtab-away) within a tier.`);
+  console.log(scoreWeights.isDefault
+    ? `  triage score (5xpaste + 5xcopy + 3xsidebar + 1xtab-away) within a tier.`
+    : `  triage score (${formulaText(scoreWeights.weights, 'x')}, from scoreWeights) within a tier.`);
 
   // 4. Render outputs
   console.log(`\nRendering...`);
@@ -107,6 +112,8 @@ export async function run(args) {
   const { renderExtensions } = await import('./renderers/extensions.js');
 
   await renderSummaryCSV(summaries, triage, config);
+  const { renderScoreWeights } = await import('./renderers/score-weights.js');
+  renderScoreWeights(config);
   await renderTriage(triage, config);
   await renderEventLog(participants, config);
   await renderExtensions(participants, config);

package/src/jspsych/extension-cyborg-hunter-replay.js

@@ -35,7 +35,7 @@ import { buildReplayMeta } from '../replay/persistence.js';
 class CyborgHunterReplayExtension {
   static info = {
     name: 'cyborg-hunter-replay',
-    version: '0.8.0',
+    version: '0.9.1',
     data: {}   // per-trial return is {}; session meta goes via addProperties
   };
 

package/src/jspsych/extension-cyborg-hunter.js

@@ -10,7 +10,7 @@ class CyborgHunterExtension {
     // and package.json). Hand-bumped on each release; if you forget, the
     // jsPsych developer console shows a stale number — the actual version
     // attached to data is read from window.CyborgHunter.VERSION at runtime.
-    version: '0.8.0',
+    version: '0.9.1',
     data: { integrity: { type: 'object' } }
   };
 

package/src/shared/constants.js

@@ -2,7 +2,7 @@
 // Default thresholds and preset configurations for Cyborg Hunter.
 // Single source of truth — used by both the browser library and CLI report tool.
 
-export const VERSION = "0.8.0";
+export const VERSION = "0.9.1";
 
 // Default detection thresholds shared across presets.
 // Researchers can override any value at init() time.

package/src/shared/schema.js

@@ -34,6 +34,7 @@ export const TRIAL_REPORT_FIELDS = {
 export const DEFAULT_CLI_CONFIG = {
   dataDir: "./data",
   replayDir: null,             // replay artifacts dir; defaults to dataDir
+  scoreWeights: null,          // report-score weights, merged per key onto the defaults (cli/analyzers/score-weights.js)
   filePattern: "*.json",
   participantIdField: "participantId",
   trialIdField: "trialId",

package/src/shared/validation.js

@@ -95,7 +95,7 @@ function safeStr(v) {
  * Finds the closest matching key using Levenshtein distance.
  * Returns null if no key is within edit distance 3 (too different to suggest).
  */
-function findClosestKey(input, keys) {
+export function findClosestKey(input, keys) {
   let best = null;
   let bestDist = Infinity;
   for (const key of keys) {