sparkforensics-mcp 0.1.0 → 0.2.2

package/vendor-core/core-time-series.js

@@ -1,11 +1,7 @@
-// Sweep-line "busy cores over time" computation. Pure and side-effect-free so
-// it can run inside parser-worker.js (over retained task launch/finish
-// timestamps) or on the main thread (scaling simulator). One core per task:
-// Spark's default task-to-core mapping.
-//
-// `hypotheticalCores` clamps the concurrent busy-core count to N (the
-// deterministic "utilization at N cores" curve). It does NOT re-schedule tasks;
-// makespan re-estimation is the scaling simulator's job, layered on this signal.
+// Sweep-line "busy cores over time". Pure so it runs in parser-worker (over retained task
+// timestamps) or on the main thread (scaling simulator). One core per task: Spark's default.
+// `hypotheticalCores` clamps the concurrent busy-core count to N; it does NOT re-schedule
+// tasks (makespan re-estimation is the scaling simulator's job, layered on this signal).
 
                     
                  
@@ -19,18 +15,16 @@
  
 
 function buildStepFunction(intervals            , hypotheticalCores               )            {
-  // Emit +1 at launch, -1 at finish. Skip empty/negative intervals.
   const events                                      = [];
   for (const { launch, finish } of intervals) {
     if (!(finish > launch)) continue;
     events.push({ t: launch, delta: 1 });
     events.push({ t: finish, delta: -1 });
   }
-  // Sort by time; at equal time process -1 before +1 so [launch, finish) is
-  // half-open (a task finishing exactly as another launches does not overlap).
+  // At equal time process -1 before +1 so [launch, finish) is half-open (a task finishing
+  // exactly as another launches does not overlap).
   events.sort((a, b) => (a.t - b.t) || (a.delta - b.delta));
 
-  // Walk consecutive timestamps, emitting the busy level held on each interval.
   const segments            = [];
   let busy = 0;
   for (let i = 0; i < events.length; i++) {

package/vendor-core/core-usage-locality.js

@@ -1,7 +1,6 @@
-// Stage-granular approximation of core-usage-by-locality over time. See the
-// plan's Task 6 DEVIATION note: per-task locality is not retained, so this
-// distributes each stage's executorRunTime across its wall-clock window,
-// split by localityStats proportions. Not exact; approximate by construction.
+// Stage-granular approximation of core-usage-by-locality over time. Per-task locality is not
+// retained, so this distributes each stage's executorRunTime across its wall-clock window,
+// split by localityStats proportions. Approximate by construction.
 export const LOCALITY_TIERS           = ['PROCESS_LOCAL', 'NODE_LOCAL', 'RACK_LOCAL', 'NO_PREF', 'ANY'];