@pennyfarthing/core 6.6.0

package/packages/core/dist/scripts/job-fair-aggregator.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Job-Fair Aggregator Module
+ *
+ * Story 7-4: Aggregate Job-Fair Results into Benchmark Statistics
+ * Story 7-5: Add Persona Differential Dimensions to Benchmarking
+ *
+ * Aggregates job-fair results across multiple themes into unified benchmark
+ * statistics with historical trend tracking and dimension-based analysis.
+ *
+ * Design decisions (from brainstorm):
+ * - Latest run per theme only (avoids duplicate counting)
+ * - Single-pass with pure functions (simple, testable)
+ * - Single history file for trends (aggregate/history.yaml)
+ * - Self-contained baseline (mean score as baseline reference)
+ * - Dimension grouping for comparative analysis (7-5)
+ */
+export interface Performer {
+    character: string;
+    theme: string;
+    score: number;
+}
+export interface RoleStats {
+    mean_score: number;
+    std_dev: number;
+    baseline_comparison: number | null;
+    top_performers: Performer[];
+}
+export interface OverallChampion {
+    character: string;
+    theme: string;
+    avg_score: number;
+}
+export interface TrendPoint {
+    date: string;
+    mean: number;
+    variance: number;
+    role?: string;
+}
+export interface AggregateStats {
+    themes_included: string[];
+    last_updated: string;
+    by_role: Record<string, RoleStats>;
+    overall_champions: OverallChampion[];
+    historical_trend: TrendPoint[];
+}
+/** Valid dimension names for theme categorization */
+export type DimensionName = 'tone' | 'era' | 'genre' | 'energy';
+/** Valid values for each dimension */
+export interface DimensionValues {
+    tone: 'comedic' | 'serious' | 'satirical' | 'dramatic';
+    era: 'historical' | 'contemporary' | 'futuristic' | 'timeless';
+    genre: 'action' | 'drama' | 'sci-fi' | 'fantasy' | 'literary' | 'comedy';
+    energy: 'high-energy' | 'measured' | 'contemplative';
+}
+/** Dimensions block in theme YAML */
+export interface ThemeDimensions {
+    tone?: DimensionValues['tone'];
+    era?: DimensionValues['era'];
+    genre?: DimensionValues['genre'];
+    energy?: DimensionValues['energy'];
+}
+/** Stats for a specific dimension value (e.g., tone: "comedic") */
+export interface DimensionValueStats {
+    value: string;
+    themes: string[];
+    sample_size: number;
+    by_role: Record<string, {
+        mean_score: number;
+        std_dev: number;
+        n: number;
+    }>;
+    overall_mean: number;
+}
+/** Comparison between two dimension values */
+export interface DimensionComparison {
+    dimension: DimensionName;
+    value_a: string;
+    value_b: string;
+    delta: number;
+    significance: 'significant' | 'marginal' | 'not_significant';
+    by_role: Record<string, {
+        delta: number;
+        significance: 'significant' | 'marginal' | 'not_significant';
+    }>;
+}
+/** Full dimension aggregation result */
+export interface DimensionStats {
+    dimension: DimensionName;
+    last_updated: string;
+    values: DimensionValueStats[];
+    comparisons: DimensionComparison[];
+}
+/**
+ * Aggregate job-fair results from all themes
+ *
+ * AC1: Job-fair results contribute to overall benchmark statistics
+ */
+export declare function aggregateJobFairResults(resultsDir: string): Promise<AggregateStats>;
+/**
+ * Get baseline comparison for a specific role
+ *
+ * AC2: Baseline calculations incorporate job-fair control runs
+ */
+export declare function getBaselineComparison(role: string, resultsDir: string): Promise<number | null>;
+/**
+ * Get statistics for a specific role
+ *
+ * AC3: Scenario performance tracked across themes
+ */
+export declare function getRoleStatistics(role: string, resultsDir: string): Promise<RoleStats>;
+/**
+ * Get top performers for a specific role
+ *
+ * AC4: Summary statistics available (mean by role, variance, top performers)
+ */
+export declare function getTopPerformers(role: string, limit: number, resultsDir: string): Promise<Performer[]>;
+/**
+ * Get historical trend data, optionally filtered by role
+ *
+ * AC5: Historical trend tracking for benchmark quality
+ */
+export declare function getHistoricalTrend(role: string | undefined, resultsDir: string): Promise<TrendPoint[]>;
+/**
+ * Save a historical snapshot of current aggregate stats
+ *
+ * AC5: Historical trend tracking for benchmark quality
+ */
+export declare function saveHistoricalSnapshot(resultsDir: string): Promise<void>;
+/**
+ * Aggregate job-fair results by a specific dimension
+ *
+ * Story 7-5: AC - Job-fair aggregator groups results by dimension
+ */
+export declare function aggregateByDimension(dimension: DimensionName, resultsDir: string, themesDir?: string): Promise<DimensionStats>;
+/**
+ * Get all available dimension values with theme counts
+ *
+ * Useful for API endpoints to show available filter options
+ */
+export declare function getDimensionValues(dimension: DimensionName, themesDir?: string): Promise<Array<{
+    value: string;
+    theme_count: number;
+}>>;
+/**
+ * Generate a differential report comparing dimension values
+ *
+ * Story 7-5: AC - Differential report shows performance by dimension value
+ */
+export declare function generateDifferentialReport(dimension: DimensionName, resultsDir: string, themesDir?: string): Promise<string>;
+//# sourceMappingURL=job-fair-aggregator.d.ts.map

package/packages/core/dist/scripts/job-fair-aggregator.d.ts.map

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