@substrate-ai/core 0.19.54

package/dist/supervisor/analysis.js

@@ -0,0 +1,420 @@
+/**
+ * Supervisor Analysis Engine — migrated to @substrate-ai/core (Story 41-7)
+ *
+ * Pure analysis functions that compare completed pipeline runs against baselines
+ * and produce actionable optimization recommendations.
+ *
+ * Architecture:
+ *   - All functions are pure: no DB access, no file I/O, no side effects
+ *   - Callers inject pre-fetched RunMetricsRow / StoryMetricsRow data
+ *   - generateAnalysisReport() produces both markdown and JSON output
+ *   - writeAnalysisReport() handles file I/O (separate from pure functions)
+ *
+ * Note: analyzeReviewCycles, ReviewCycleFinding, and ReviewCycleAnalysis are
+ * SDLC-specific (story-phase semantics) and remain in the monolith at
+ * src/modules/supervisor/review-cycle-analysis.ts.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+// ---------------------------------------------------------------------------
+// Token Efficiency Analysis
+// ---------------------------------------------------------------------------
+/**
+ * Analyse token usage for each story in the current run, comparing against
+ * the corresponding story in the baseline run.
+ *
+ * Returns findings only for stories where total tokens exceeded the baseline
+ * by more than 20%.
+ */
+export function analyzeTokenEfficiency(stories, baselineStories) {
+    const baselineMap = new Map();
+    for (const bs of baselineStories) {
+        baselineMap.set(bs.story_key, bs);
+    }
+    const findings = [];
+    for (const story of stories) {
+        const baseline = baselineMap.get(story.story_key);
+        if (!baseline)
+            continue;
+        const actual = (story.input_tokens ?? 0) + (story.output_tokens ?? 0);
+        const base = (baseline.input_tokens ?? 0) + (baseline.output_tokens ?? 0);
+        if (base === 0)
+            continue; // can't compute a meaningful delta
+        const delta_pct = Math.round(((actual - base) / base) * 100 * 10) / 10;
+        if (delta_pct > 20) {
+            findings.push({
+                story_key: story.story_key,
+                phase: 'total',
+                tokens_actual: actual,
+                tokens_baseline: base,
+                delta_pct,
+            });
+        }
+    }
+    // Sort descending by delta_pct so worst offenders appear first
+    findings.sort((a, b) => b.delta_pct - a.delta_pct);
+    return findings;
+}
+// ---------------------------------------------------------------------------
+// Timing Analysis
+// ---------------------------------------------------------------------------
+/**
+ * Analyse phase timing across all stories to identify:
+ *   1. The bottleneck phase (highest total wall-clock contribution).
+ *   2. Stories where a single phase used >50% of their total wall-clock.
+ *   3. Effective concurrency estimate.
+ */
+export function analyzeTimings(stories, concurrencySetting) {
+    const phaseTotal = {};
+    const highConcentrationStories = [];
+    let totalWallClock = 0;
+    let maxStoryWallClock = 0;
+    for (const story of stories) {
+        const storySeconds = story.wall_clock_seconds ?? 0;
+        totalWallClock += storySeconds;
+        if (storySeconds > maxStoryWallClock)
+            maxStoryWallClock = storySeconds;
+        const phases = parsePhaseDurations(story.phase_durations_json ?? null);
+        if (!phases)
+            continue;
+        let storyPhaseTotal = 0;
+        for (const [phase, dur] of Object.entries(phases)) {
+            const d = dur ?? 0;
+            phaseTotal[phase] = (phaseTotal[phase] ?? 0) + d;
+            storyPhaseTotal += d;
+        }
+        if (storyPhaseTotal === 0)
+            continue;
+        // Find the dominant phase for this story
+        let dominantPhase = '';
+        let dominantSeconds = 0;
+        for (const [phase, dur] of Object.entries(phases)) {
+            const d = dur ?? 0;
+            if (d > dominantSeconds) {
+                dominantSeconds = d;
+                dominantPhase = phase;
+            }
+        }
+        const dominantPct = Math.round((dominantSeconds / storyPhaseTotal) * 100 * 10) / 10;
+        if (dominantPct > 50) {
+            highConcentrationStories.push({
+                story_key: story.story_key,
+                dominant_phase: dominantPhase,
+                dominant_phase_seconds: dominantSeconds,
+                total_seconds: storyPhaseTotal,
+                dominant_phase_pct: dominantPct,
+            });
+        }
+    }
+    // Sort by dominant_phase_pct descending
+    highConcentrationStories.sort((a, b) => b.dominant_phase_pct - a.dominant_phase_pct);
+    // Find global bottleneck phase
+    let bottleneckPhase = null;
+    let bottleneckSeconds = 0;
+    for (const [phase, total] of Object.entries(phaseTotal)) {
+        if (total > bottleneckSeconds) {
+            bottleneckSeconds = total;
+            bottleneckPhase = phase;
+        }
+    }
+    const totalPhaseTime = Object.values(phaseTotal).reduce((s, v) => s + (v ?? 0), 0);
+    const bottleneckPct = totalPhaseTime > 0
+        ? Math.round((bottleneckSeconds / totalPhaseTime) * 100 * 10) / 10
+        : 0;
+    // Effective concurrency = (sum of story wall-clocks) / (total elapsed)
+    let effective_concurrency = null;
+    if (maxStoryWallClock > 0 && stories.length > 0) {
+        effective_concurrency = Math.round((totalWallClock / maxStoryWallClock) * 10) / 10;
+    }
+    const configured_concurrency = concurrencySetting ?? null;
+    const concurrency_ratio = effective_concurrency !== null && configured_concurrency !== null && configured_concurrency > 0
+        ? Math.round((effective_concurrency / configured_concurrency) * 100) / 100
+        : null;
+    return {
+        bottleneck_phase: bottleneckPhase,
+        bottleneck_phase_seconds: bottleneckSeconds,
+        bottleneck_phase_pct: bottleneckPct,
+        high_phase_concentration_stories: highConcentrationStories,
+        effective_concurrency,
+        configured_concurrency,
+        concurrency_ratio,
+    };
+}
+// ---------------------------------------------------------------------------
+// Recommendation Generation
+// ---------------------------------------------------------------------------
+/**
+ * Generate machine-readable recommendations from analysis findings.
+ */
+export function generateRecommendations(tokenFindings, reviewCycles, timing) {
+    const recs = [];
+    // Token regression recommendations
+    for (const f of tokenFindings) {
+        recs.push({
+            type: 'token_regression',
+            story_key: f.story_key,
+            phase: f.phase,
+            metric: 'tokens',
+            actual: f.tokens_actual,
+            baseline: f.tokens_baseline,
+            delta_pct: f.delta_pct,
+            recommendation: `Prompt in ${f.phase} phase for story ${f.story_key} is ${f.delta_pct}% over baseline — consider compressing context injection`,
+        });
+    }
+    // Review cycle recommendations
+    for (const f of reviewCycles.high_cycle_stories) {
+        recs.push({
+            type: 'review_cycles',
+            story_key: f.story_key,
+            phase: f.phase,
+            metric: 'review_cycles',
+            actual: f.review_cycles,
+            recommendation: `Story ${f.story_key} failed code review ${f.review_cycles} times — review prompt quality or acceptance criteria clarity`,
+        });
+    }
+    // Timing bottleneck recommendation
+    if (timing.bottleneck_phase !== null && timing.bottleneck_phase_pct > 40) {
+        recs.push({
+            type: 'timing_bottleneck',
+            phase: timing.bottleneck_phase,
+            metric: 'wall_clock',
+            actual: timing.bottleneck_phase_seconds,
+            delta_pct: timing.bottleneck_phase_pct,
+            recommendation: `Phase ${timing.bottleneck_phase} accounts for ${timing.bottleneck_phase_pct}% of wall clock — consider increasing concurrency or splitting work`,
+        });
+    }
+    return recs;
+}
+// ---------------------------------------------------------------------------
+// Report Generation
+// ---------------------------------------------------------------------------
+/**
+ * Run a full analysis on a completed pipeline run and produce a structured report.
+ *
+ * Note: review_cycles.high_cycle_stories will be empty because analyzeReviewCycles
+ * is SDLC-specific and is not in core. Use analyzeReviewCycles from the monolith
+ * (src/modules/supervisor/review-cycle-analysis.ts) for the full review cycle analysis.
+ */
+export function generateAnalysisReport(run, stories, baseline, baselineStories) {
+    const generated_at = new Date().toISOString();
+    // --- Summary ---
+    const total_tokens = (run.total_input_tokens ?? 0) + (run.total_output_tokens ?? 0);
+    const total_tokens_baseline = baseline !== undefined
+        ? (baseline.total_input_tokens ?? 0) + (baseline.total_output_tokens ?? 0)
+        : null;
+    const token_delta_pct = total_tokens_baseline !== null && total_tokens_baseline > 0
+        ? Math.round(((total_tokens - total_tokens_baseline) / total_tokens_baseline) * 100 * 10) / 10
+        : null;
+    const wall_clock_seconds = run.wall_clock_seconds ?? 0;
+    const wall_clock_baseline = baseline?.wall_clock_seconds ?? null;
+    const wall_clock_delta_pct = wall_clock_baseline !== null && wall_clock_baseline > 0
+        ? Math.round(((wall_clock_seconds - wall_clock_baseline) / wall_clock_baseline) * 100 * 10) / 10
+        : null;
+    const avg_review_cycles = computeAvg(stories.map(s => s.review_cycles ?? 0));
+    const avg_review_cycles_baseline = baselineStories.length > 0
+        ? computeAvg(baselineStories.map(s => s.review_cycles ?? 0))
+        : null;
+    const review_cycles_delta_pct = avg_review_cycles_baseline !== null && avg_review_cycles_baseline > 0
+        ? Math.round(((avg_review_cycles - avg_review_cycles_baseline) / avg_review_cycles_baseline) *
+            100 *
+            10) / 10
+        : null;
+    const summary = {
+        total_tokens,
+        total_tokens_baseline,
+        token_delta_pct,
+        wall_clock_seconds,
+        wall_clock_baseline,
+        wall_clock_delta_pct,
+        stories_succeeded: run.stories_succeeded ?? 0,
+        stories_failed: run.stories_failed ?? 0,
+        stories_escalated: run.stories_escalated ?? 0,
+        avg_review_cycles,
+        avg_review_cycles_baseline,
+        review_cycles_delta_pct,
+    };
+    // --- Analysis ---
+    const token_efficiency = analyzeTokenEfficiency(stories, baselineStories);
+    // Build review_cycles analysis inline.
+    // high_cycle_stories: detect stories with >2 cycles using a generic threshold.
+    // analyzeReviewCycles (in the monolith) adds SDLC-specific issue_patterns extraction;
+    // here we produce a structurally correct result with empty issue_patterns.
+    const highCycleStories = stories
+        .filter(s => (s.review_cycles ?? 0) > 2)
+        .sort((a, b) => (b.review_cycles ?? 0) - (a.review_cycles ?? 0))
+        .map(s => ({
+        story_key: s.story_key,
+        phase: 'code-review',
+        review_cycles: s.review_cycles ?? 0,
+        issue_patterns: [],
+    }));
+    const review_cycles = {
+        high_cycle_stories: highCycleStories,
+        avg_cycles: avg_review_cycles,
+        avg_cycles_baseline: avg_review_cycles_baseline,
+        delta_pct: review_cycles_delta_pct,
+    };
+    const timing = analyzeTimings(stories, run.concurrency_setting);
+    const recommendations = generateRecommendations(token_efficiency, review_cycles, timing);
+    const findings = {
+        token_efficiency,
+        review_cycles,
+        timing,
+        recommendations,
+    };
+    // --- Markdown ---
+    const markdown = buildMarkdownReport(run.run_id, generated_at, baseline?.run_id, summary, findings);
+    return {
+        run_id: run.run_id,
+        generated_at,
+        baseline_run_id: baseline?.run_id,
+        summary,
+        findings,
+        markdown,
+    };
+}
+/**
+ * Write the analysis report to the filesystem.
+ *
+ * Writes:
+ *   - `<projectRoot>/_bmad-output/supervisor-reports/<run-id>-analysis.md`
+ *   - `<projectRoot>/_bmad-output/supervisor-reports/<run-id>-analysis.json`
+ */
+export function writeAnalysisReport(report, projectRoot) {
+    const dir = path.join(projectRoot, '_bmad-output', 'supervisor-reports');
+    fs.mkdirSync(dir, { recursive: true });
+    const mdPath = path.join(dir, `${report.run_id}-analysis.md`);
+    const jsonPath = path.join(dir, `${report.run_id}-analysis.json`);
+    fs.writeFileSync(mdPath, report.markdown, 'utf8');
+    fs.writeFileSync(jsonPath, JSON.stringify({
+        run_id: report.run_id,
+        generated_at: report.generated_at,
+        baseline_run_id: report.baseline_run_id ?? null,
+        summary: report.summary,
+        findings: report.findings,
+    }, null, 2), 'utf8');
+    return { mdPath, jsonPath };
+}
+// ---------------------------------------------------------------------------
+// Private helpers
+// ---------------------------------------------------------------------------
+function parsePhaseDurations(json) {
+    if (!json)
+        return null;
+    try {
+        const parsed = JSON.parse(json);
+        if (parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+function computeAvg(values) {
+    if (values.length === 0)
+        return 0;
+    const sum = values.reduce((a, b) => a + b, 0);
+    return Math.round((sum / values.length) * 100) / 100;
+}
+// ---------------------------------------------------------------------------
+// Markdown report builder
+// ---------------------------------------------------------------------------
+function buildMarkdownReport(runId, generatedAt, baselineRunId, summary, findings) {
+    const lines = [];
+    lines.push(`# Pipeline Run Analysis: ${runId}`);
+    lines.push(`Generated: ${generatedAt}`);
+    if (baselineRunId) {
+        lines.push(`Baseline: ${baselineRunId}`);
+    }
+    else {
+        lines.push('Baseline: none');
+    }
+    lines.push('');
+    // Summary
+    lines.push('## Summary');
+    const tokenDeltaStr = summary.token_delta_pct !== null ? `, delta: ${fmtPct(summary.token_delta_pct)}` : '';
+    const baselineTokenStr = summary.total_tokens_baseline !== null ? ` (baseline: ${summary.total_tokens_baseline}${tokenDeltaStr})` : '';
+    lines.push(`- Total tokens: ${summary.total_tokens}${baselineTokenStr}`);
+    const clockMin = (summary.wall_clock_seconds / 60).toFixed(1);
+    const baselineClockStr = summary.wall_clock_baseline !== null
+        ? ` (baseline: ${(summary.wall_clock_baseline / 60).toFixed(1)}m${summary.wall_clock_delta_pct !== null ? `, delta: ${fmtPct(summary.wall_clock_delta_pct)}` : ''})`
+        : '';
+    lines.push(`- Wall clock: ${clockMin}m${baselineClockStr}`);
+    lines.push(`- Stories: ${summary.stories_succeeded} succeeded, ${summary.stories_failed} failed, ${summary.stories_escalated} escalated`);
+    const baselineCycleStr = summary.avg_review_cycles_baseline !== null
+        ? ` (baseline: ${summary.avg_review_cycles_baseline}${summary.review_cycles_delta_pct !== null ? `, delta: ${fmtPct(summary.review_cycles_delta_pct)}` : ''})`
+        : '';
+    lines.push(`- Avg review cycles: ${summary.avg_review_cycles}${baselineCycleStr}`);
+    lines.push('');
+    // Regressions
+    if (findings.token_efficiency.length > 0 || findings.review_cycles.high_cycle_stories.length > 0) {
+        lines.push('## Regressions');
+        if (findings.token_efficiency.length > 0) {
+            lines.push('');
+            lines.push('### Token Regressions (>20% above baseline)');
+            lines.push('| Story | Phase | Actual | Baseline | Delta |');
+            lines.push('|-------|-------|--------|----------|-------|');
+            for (const f of findings.token_efficiency) {
+                lines.push(`| ${f.story_key} | ${f.phase} | ${f.tokens_actual} | ${f.tokens_baseline} | ${fmtPct(f.delta_pct)} |`);
+            }
+        }
+        if (findings.review_cycles.high_cycle_stories.length > 0) {
+            lines.push('');
+            lines.push('### Review Cycle Regressions (>2 cycles)');
+            lines.push('| Story | Phase | Cycles |');
+            lines.push('|-------|-------|--------|');
+            for (const f of findings.review_cycles.high_cycle_stories) {
+                lines.push(`| ${f.story_key} | ${f.phase} | ${f.review_cycles} |`);
+            }
+        }
+        lines.push('');
+    }
+    // Timing
+    if (findings.timing.bottleneck_phase !== null || findings.timing.high_phase_concentration_stories.length > 0) {
+        lines.push('## Timing Analysis');
+        if (findings.timing.bottleneck_phase !== null) {
+            lines.push(`- Bottleneck phase: **${findings.timing.bottleneck_phase}** (${findings.timing.bottleneck_phase_seconds.toFixed(1)}s, ${findings.timing.bottleneck_phase_pct}% of total phase time)`);
+        }
+        if (findings.timing.effective_concurrency !== null) {
+            const configuredStr = findings.timing.configured_concurrency !== null
+                ? ` (configured: ${findings.timing.configured_concurrency}, ratio: ${findings.timing.concurrency_ratio ?? 'N/A'})`
+                : '';
+            lines.push(`- Effective concurrency: ${findings.timing.effective_concurrency}x${configuredStr}`);
+        }
+        if (findings.timing.high_phase_concentration_stories.length > 0) {
+            lines.push('');
+            lines.push('### High Phase Concentration Stories (>50% in one phase)');
+            lines.push('| Story | Dominant Phase | Phase Time | Total Time | % |');
+            lines.push('|-------|---------------|------------|------------|---|');
+            for (const f of findings.timing.high_phase_concentration_stories) {
+                lines.push(`| ${f.story_key} | ${f.dominant_phase} | ${f.dominant_phase_seconds.toFixed(1)}s | ${f.total_seconds.toFixed(1)}s | ${f.dominant_phase_pct}% |`);
+            }
+        }
+        lines.push('');
+    }
+    // Recommendations
+    if (findings.recommendations.length > 0) {
+        lines.push('## Recommendations');
+        lines.push('');
+        for (let i = 0; i < findings.recommendations.length; i++) {
+            const r = findings.recommendations[i];
+            const label = r?.story_key ? `${r.type} in ${r.story_key}` : r?.type ?? '';
+            lines.push(`${i + 1}. **${label}**: ${r?.recommendation ?? ''}`);
+        }
+        lines.push('');
+    }
+    // Raw Data
+    lines.push('## Raw Data');
+    lines.push('');
+    lines.push('```json');
+    lines.push(JSON.stringify({ summary, findings: { token_efficiency: findings.token_efficiency, review_cycles: findings.review_cycles, timing: findings.timing } }, null, 2));
+    lines.push('```');
+    lines.push('');
+    return lines.join('\n');
+}
+function fmtPct(pct) {
+    return pct >= 0 ? `+${pct}%` : `${pct}%`;
+}
+//# sourceMappingURL=analysis.js.map

package/dist/supervisor/analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.js","sourceRoot":"","sources":["../../src/supervisor/analysis.ts"],"names":[],"mappings":"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"}

package/dist/supervisor/experimenter.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Experimenter — automated experimentation engine for the pipeline supervisor.
+ * Migrated to @substrate-ai/core (Story 41-7)
+ *
+ * Implements the experiment state machine:
+ *   SELECTING → BRANCHING → MODIFYING → RUNNING → COMPARING → REPORTING
+ *
+ * Architecture:
+ *   - spawnGit is NOT imported — git dependency is caller-supplied via ExperimenterDeps
+ *   - story 41-8 will supply a concrete git spawn implementation
+ *   - All persistence imports use core-relative paths
+ */
+import type { RunMetricsRow, StoryMetricsRow } from '../persistence/queries/metrics.js';
+import type { DatabaseAdapter } from '../persistence/types.js';
+import type { RecommendationType } from './analysis.js';
+interface SpawnResult {
+    stdout: string;
+    stderr: string;
+    code: number;
+}
+interface LocalSpawnOptions {
+    cwd?: string;
+    env?: Record<string, string | undefined>;
+}
+/**
+ * Injectable function type for spawning arbitrary processes (e.g., `gh pr create`).
+ */
+export type SpawnFn = (cmd: string, args: string[], opts?: LocalSpawnOptions) => Promise<SpawnResult>;
+/**
+ * A machine-readable recommendation produced by the supervisor analysis engine.
+ */
+export interface SupervisorRecommendation {
+    /** Category of finding */
+    type: RecommendationType;
+    /** The story key that exhibited the regression or bottleneck */
+    story_key: string;
+    /**
+     * The phase where the issue occurred.
+     */
+    phase: string;
+    /** Human-readable description of the finding */
+    description: string;
+    /**
+     * Short slug used in branch naming (safe chars: [a-z0-9-] only, max 40 chars).
+     */
+    short_desc: string;
+    tokens_actual?: number;
+    tokens_baseline?: number;
+    delta_pct?: number;
+    review_cycles?: number;
+    avg_review_cycles_baseline?: number;
+    timing_seconds?: number;
+}
+export type ExperimentPhase = 'SELECTING' | 'BRANCHING' | 'MODIFYING' | 'RUNNING' | 'COMPARING' | 'REPORTING';
+export type ExperimentVerdict = 'IMPROVED' | 'MIXED' | 'REGRESSED';
+export interface ExperimentMetricDeltas {
+    tokens_pct: number | null;
+    cost_pct: number | null;
+    review_cycles_pct: number | null;
+    wall_clock_pct: number | null;
+}
+export interface ExperimentResult {
+    recommendation: SupervisorRecommendation;
+    branchName: string;
+    baselineRunId: string;
+    experimentRunId: string | null;
+    verdict: ExperimentVerdict;
+    deltas: ExperimentMetricDeltas;
+    currentPhase: ExperimentPhase;
+    error?: string;
+    prLink?: string | null;
+}
+export interface ExperimentConfig {
+    projectRoot: string;
+    pack: string;
+    maxExperiments: number;
+    tokenBudgetMultiplier: number;
+}
+export interface ExperimentRunOptions {
+    stories: string;
+    projectRoot: string;
+    pack: string;
+}
+export type RunStoryFn = (opts: ExperimentRunOptions) => Promise<{
+    runId: string;
+    exitCode: number;
+}>;
+/**
+ * Injectable dependencies for the Experimenter.
+ * git must be provided by the caller (spawnGit is not yet in core).
+ */
+export interface ExperimenterDeps {
+    /** Git spawn function — caller-supplied (story 41-8 will provide a concrete impl) */
+    git: (args: string[], opts?: LocalSpawnOptions) => Promise<SpawnResult>;
+    spawn: SpawnFn;
+    runStory: RunStoryFn;
+    getRunMetrics: (db: DatabaseAdapter, runId: string) => Promise<RunMetricsRow | undefined>;
+    getStoryMetrics: (db: DatabaseAdapter, runId: string) => Promise<StoryMetricsRow[]>;
+    readFile: (path: string) => Promise<string>;
+    writeFile: (path: string, content: string) => Promise<void>;
+    mkdir: (path: string, opts?: {
+        recursive: boolean;
+    }) => Promise<void>;
+    log: (msg: string) => void;
+}
+export interface Experimenter {
+    runExperiments(db: DatabaseAdapter, recommendations: SupervisorRecommendation[], baselineRunId: string): Promise<ExperimentResult[]>;
+}
+export declare function buildBranchName(runId: string, shortDesc: string): string;
+export declare function buildWorktreePath(projectRoot: string, baselineRunId: string, shortDesc: string): string;
+export declare function buildModificationDirective(rec: SupervisorRecommendation): string;
+export declare function resolvePromptFile(rec: SupervisorRecommendation, projectRoot: string, pack: string): string;
+export declare function determineVerdict(rec: SupervisorRecommendation, deltas: ExperimentMetricDeltas): ExperimentVerdict;
+export declare function buildPRBody(result: ExperimentResult): string;
+export declare function buildAuditLogEntry(result: ExperimentResult, timestamp?: string): string;
+export declare function createExperimenter(config: ExperimentConfig, deps?: Partial<ExperimenterDeps>): Experimenter;
+export {};
+//# sourceMappingURL=experimenter.d.ts.map

package/dist/supervisor/experimenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"experimenter.d.ts","sourceRoot":"","sources":["../../src/supervisor/experimenter.ts"],"names":[],"mappings":"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"}