@rine-kit/pubg-intelligence 0.0.0-stage → 0.1.0

package/dist/src/evaluation.d.ts

@@ -0,0 +1,140 @@
+export declare const EVALUATION_MANIFEST_VERSION: 1;
+export declare const EVALUATION_ENGINE_VERSION: "pubg-intelligence-evaluation-v1";
+export type BenchmarkSplit = 'development' | 'holdout';
+export type BenchmarkPrediction = boolean | null;
+export type BenchmarkErrorKind = 'false_positive' | 'false_negative';
+export interface BenchmarkEvidenceRef {
+    matchId: string;
+    eventId: string | null;
+    timeSeconds: number | null;
+    kind: string;
+}
+export interface BenchmarkCaseResult {
+    caseId: string;
+    split: BenchmarkSplit;
+    stratum: string;
+    expected: boolean | null;
+    baseline: BenchmarkPrediction;
+    candidate: BenchmarkPrediction;
+    baselineEvidence: BenchmarkEvidenceRef[];
+    candidateEvidence: BenchmarkEvidenceRef[];
+    baselineError: BenchmarkErrorKind | null;
+    candidateError: BenchmarkErrorKind | null;
+    comparison: 'improved' | 'regressed' | 'unchanged' | 'unresolved';
+}
+export interface BinaryBenchmarkMetrics {
+    labeledCases: number;
+    unresolvedLabels: number;
+    abstainedPredictions: number;
+    truePositive: number;
+    falsePositive: number;
+    falseNegative: number;
+    trueNegative: number;
+    precision: number | null;
+    recall: number | null;
+    f1: number | null;
+}
+export interface EvaluationExperimentReport {
+    manifestVersion: typeof EVALUATION_MANIFEST_VERSION;
+    evaluationEngineVersion: typeof EVALUATION_ENGINE_VERSION;
+    experimentName: string;
+    dataset: {
+        id: string;
+        fingerprint: string;
+        caseCount: number;
+        holdoutCaseCount: number;
+        strata: Array<{
+            name: string;
+            count: number;
+        }>;
+    };
+    algorithm: {
+        ruleId: string;
+        baselineVersion: string;
+        candidateVersion: string;
+        parserVersion: string;
+        thresholds: Record<string, number | string | boolean | null>;
+    };
+    provenance: {
+        source: 'sanitized-fixture';
+        annotation: 'fixture-ground-truth';
+        runtimeMs: number;
+        startedAt: string;
+        resourceUsage: {
+            heapUsedBytesBefore: number;
+            heapUsedBytesAfter: number;
+            heapUsedDeltaBytes: number;
+            rssBytesAfter: number;
+        };
+    };
+    baseline: {
+        all: BinaryBenchmarkMetrics;
+        development: BinaryBenchmarkMetrics;
+        holdout: BinaryBenchmarkMetrics;
+    };
+    candidate: {
+        all: BinaryBenchmarkMetrics;
+        development: BinaryBenchmarkMetrics;
+        holdout: BinaryBenchmarkMetrics;
+    };
+    templateEvaluation: {
+        templateCount: number;
+        numericFactParity: boolean;
+        uniqueWordingCount: number;
+        humanPreferenceLabels: number;
+        humanPreferenceStatus: 'not_collected';
+    };
+    comparison: {
+        holdoutFalsePositiveDelta: number;
+        holdoutFalseNegativeDelta: number;
+        baselineNotRegressed: boolean;
+        fixtureLabeledHoldoutCaseCount: number;
+    };
+    promotionGate: {
+        baselineNotRegressed: boolean;
+        fixtureLabeledHoldoutAvailable: boolean;
+        humanReviewedHoldoutAvailable: false;
+        historicalHoldoutAvailable: false;
+        ready: boolean;
+        reasons: string[];
+    };
+    caseOutcomes: BenchmarkCaseResult[];
+    counterexamples: BenchmarkCaseResult[];
+}
+export interface BenchmarkPredictionInput {
+    caseId: string;
+    split: BenchmarkSplit;
+    stratum: string;
+    expected: boolean | null;
+    baseline: BenchmarkPrediction;
+    candidate: BenchmarkPrediction;
+    baselineEvidence?: readonly BenchmarkEvidenceRef[];
+    candidateEvidence?: readonly BenchmarkEvidenceRef[];
+}
+export interface EvaluationExperimentInput {
+    experimentName: string;
+    datasetId: string;
+    datasetFingerprint: string;
+    ruleId: string;
+    baselineVersion: string;
+    candidateVersion: string;
+    parserVersion: string;
+    thresholds: Record<string, number | string | boolean | null>;
+    startedAt: string;
+    runtimeMs: number;
+    resourceUsage: {
+        heapUsedBytesBefore: number;
+        heapUsedBytesAfter: number;
+        heapUsedDeltaBytes: number;
+        rssBytesAfter: number;
+    };
+    predictions: readonly BenchmarkPredictionInput[];
+    templateEvaluation: {
+        templateCount: number;
+        numericFactParity: boolean;
+        uniqueWordingCount: number;
+        humanPreferenceLabels: number;
+    };
+}
+export declare function fingerprintBenchmarkDataset(dataset: unknown): string;
+export declare function buildEvaluationExperiment(input: EvaluationExperimentInput): EvaluationExperimentReport;

package/dist/src/evaluation.js

@@ -0,0 +1,180 @@
+import { createHash } from 'node:crypto';
+export const EVALUATION_MANIFEST_VERSION = 1;
+export const EVALUATION_ENGINE_VERSION = 'pubg-intelligence-evaluation-v1';
+function errorFor(expected, prediction) {
+    if (expected === null)
+        return null;
+    if (expected && prediction !== true)
+        return 'false_negative';
+    if (!expected && prediction === true)
+        return 'false_positive';
+    return null;
+}
+function metricsFor(rows, which) {
+    let labeledCases = 0;
+    let unresolvedLabels = 0;
+    let abstainedPredictions = 0;
+    let truePositive = 0;
+    let falsePositive = 0;
+    let falseNegative = 0;
+    let trueNegative = 0;
+    for (const row of rows) {
+        if (row.expected === null) {
+            unresolvedLabels += 1;
+            continue;
+        }
+        labeledCases += 1;
+        const prediction = row[which];
+        if (prediction === null)
+            abstainedPredictions += 1;
+        if (row.expected && prediction === true)
+            truePositive += 1;
+        else if (row.expected)
+            falseNegative += 1;
+        else if (prediction === true)
+            falsePositive += 1;
+        else if (prediction === false)
+            trueNegative += 1;
+    }
+    const precision = truePositive + falsePositive ? truePositive / (truePositive + falsePositive) : null;
+    const recall = truePositive + falseNegative ? truePositive / (truePositive + falseNegative) : null;
+    const f1 = precision !== null && recall !== null && precision + recall > 0
+        ? (2 * precision * recall) / (precision + recall)
+        : null;
+    return {
+        labeledCases,
+        unresolvedLabels,
+        abstainedPredictions,
+        truePositive,
+        falsePositive,
+        falseNegative,
+        trueNegative,
+        precision,
+        recall,
+        f1,
+    };
+}
+export function fingerprintBenchmarkDataset(dataset) {
+    return createHash('sha256').update(JSON.stringify(dataset)).digest('hex');
+}
+export function buildEvaluationExperiment(input) {
+    if (!input.predictions.length)
+        throw new Error('benchmark_corpus_empty');
+    const caseIds = new Set();
+    for (const row of input.predictions) {
+        if (caseIds.has(row.caseId))
+            throw new Error('benchmark_case_id_duplicate');
+        caseIds.add(row.caseId);
+    }
+    const caseOutcomes = input.predictions
+        .map((row) => {
+        const baselineError = errorFor(row.expected, row.baseline);
+        const candidateError = errorFor(row.expected, row.candidate);
+        const comparison = row.expected === null
+            ? 'unresolved'
+            : candidateError === null && baselineError !== null
+                ? 'improved'
+                : candidateError !== null && baselineError === null
+                    ? 'regressed'
+                    : 'unchanged';
+        return {
+            caseId: row.caseId,
+            split: row.split,
+            stratum: row.stratum,
+            expected: row.expected,
+            baseline: row.baseline,
+            candidate: row.candidate,
+            baselineEvidence: [...(row.baselineEvidence ?? [])],
+            candidateEvidence: [...(row.candidateEvidence ?? [])],
+            baselineError,
+            candidateError,
+            comparison,
+        };
+    })
+        .sort((left, right) => left.split.localeCompare(right.split) || left.caseId.localeCompare(right.caseId));
+    const all = caseOutcomes;
+    const development = all.filter((row) => row.split === 'development');
+    const holdout = all.filter((row) => row.split === 'holdout');
+    if (!development.length || !holdout.length)
+        throw new Error('benchmark_requires_development_and_holdout');
+    const baselineHoldout = metricsFor(holdout, 'baseline');
+    const candidateHoldout = metricsFor(holdout, 'candidate');
+    const baselineNotRegressed = candidateHoldout.falsePositive <= baselineHoldout.falsePositive &&
+        candidateHoldout.falseNegative <= baselineHoldout.falseNegative;
+    const fixtureLabeledHoldoutCaseCount = holdout.filter((row) => row.expected !== null).length;
+    const reasons = [
+        ...(!baselineNotRegressed
+            ? ['Candidate increases a labeled holdout false positive or false negative.']
+            : []),
+        ...(fixtureLabeledHoldoutCaseCount === 0
+            ? ['Holdout has no fixture ground-truth labels.']
+            : []),
+        'No analyst review labels have been collected for this benchmark run.',
+        'This replay uses sanitized fixtures only; a historical holdout has not been independently labeled.',
+    ];
+    const strata = new Map();
+    for (const row of caseOutcomes)
+        strata.set(row.stratum, (strata.get(row.stratum) ?? 0) + 1);
+    return {
+        manifestVersion: EVALUATION_MANIFEST_VERSION,
+        evaluationEngineVersion: EVALUATION_ENGINE_VERSION,
+        experimentName: input.experimentName,
+        dataset: {
+            id: input.datasetId,
+            fingerprint: input.datasetFingerprint ||
+                fingerprintBenchmarkDataset({
+                    datasetId: input.datasetId,
+                    cases: input.predictions
+                        .map(({ caseId, split, stratum, expected }) => ({ caseId, split, stratum, expected }))
+                        .sort((left, right) => left.caseId.localeCompare(right.caseId)),
+                }),
+            caseCount: caseOutcomes.length,
+            holdoutCaseCount: holdout.length,
+            strata: [...strata.entries()]
+                .sort(([left], [right]) => left.localeCompare(right))
+                .map(([name, count]) => ({ name, count })),
+        },
+        algorithm: {
+            ruleId: input.ruleId,
+            baselineVersion: input.baselineVersion,
+            candidateVersion: input.candidateVersion,
+            parserVersion: input.parserVersion,
+            thresholds: { ...input.thresholds },
+        },
+        provenance: {
+            source: 'sanitized-fixture',
+            annotation: 'fixture-ground-truth',
+            runtimeMs: Math.max(0, input.runtimeMs),
+            startedAt: input.startedAt,
+            resourceUsage: { ...input.resourceUsage },
+        },
+        baseline: {
+            all: metricsFor(all, 'baseline'),
+            development: metricsFor(development, 'baseline'),
+            holdout: baselineHoldout,
+        },
+        candidate: {
+            all: metricsFor(all, 'candidate'),
+            development: metricsFor(development, 'candidate'),
+            holdout: candidateHoldout,
+        },
+        templateEvaluation: { ...input.templateEvaluation, humanPreferenceStatus: 'not_collected' },
+        comparison: {
+            holdoutFalsePositiveDelta: candidateHoldout.falsePositive - baselineHoldout.falsePositive,
+            holdoutFalseNegativeDelta: candidateHoldout.falseNegative - baselineHoldout.falseNegative,
+            baselineNotRegressed,
+            fixtureLabeledHoldoutCaseCount,
+        },
+        promotionGate: {
+            baselineNotRegressed,
+            fixtureLabeledHoldoutAvailable: fixtureLabeledHoldoutCaseCount > 0,
+            humanReviewedHoldoutAvailable: false,
+            historicalHoldoutAvailable: false,
+            ready: false,
+            reasons,
+        },
+        caseOutcomes,
+        counterexamples: caseOutcomes.filter((row) => row.candidateError !== null || row.baselineError !== null || row.expected === null),
+    };
+}
+//# sourceMappingURL=evaluation.js.map

package/dist/src/evaluation.js.map

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

package/dist/src/experiment-store.d.ts

@@ -0,0 +1,56 @@
+import type { EvaluationExperimentReport } from './evaluation.js';
+export interface StoredResearchRun {
+    question: string;
+    intent: unknown;
+    source: string;
+    report: unknown;
+    assistant?: unknown;
+}
+export type EvaluationReviewLabel = 'confirm' | 'reject' | 'unresolved' | 'wrong_evidence';
+export type BattleReviewLabel = 'correct' | 'insufficient_inference' | 'wrong' | 'unknown';
+export interface EvaluationRunSummary {
+    runId: string;
+    createdAt: string;
+    experimentName: string;
+    datasetFingerprint: string;
+    candidateVersion: string;
+    caseCount: number;
+    runtimeMs: number;
+    reviewedLabels: number;
+}
+export interface EvaluationReview {
+    caseId: string;
+    ruleId: string;
+    label: EvaluationReviewLabel;
+    createdAt: string;
+}
+export interface BattleReview {
+    matchId: string;
+    battleId: string;
+    label: BattleReviewLabel;
+    createdAt: string;
+}
+/** Persistent experiment output lives outside the production PUBG database. */
+export declare class ExperimentRunStore {
+    readonly filename: string;
+    private readonly db;
+    constructor(filename: string);
+    save(run: StoredResearchRun): string;
+    saveEvaluation(report: EvaluationExperimentReport): string;
+    listEvaluations(limit?: number): EvaluationRunSummary[];
+    getEvaluation(runId: string): EvaluationExperimentReport | null;
+    saveEvaluationReview(input: {
+        runId: string;
+        caseId: string;
+        ruleId: string;
+        label: EvaluationReviewLabel;
+    }): EvaluationReview;
+    listEvaluationReviews(runId: string): EvaluationReview[];
+    saveBattleReview(input: {
+        matchId: string;
+        battleId: string;
+        label: BattleReviewLabel;
+    }): BattleReview;
+    listBattleReviews(matchId: string): BattleReview[];
+    close(): void;
+}

package/dist/src/experiment-store.js

@@ -0,0 +1,159 @@
+import { chmodSync, mkdirSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { redactSensitiveText } from './intent.js';
+const require = createRequire(import.meta.url);
+const { DatabaseSync } = require('node:sqlite');
+/** Persistent experiment output lives outside the production PUBG database. */
+export class ExperimentRunStore {
+    filename;
+    db;
+    constructor(filename) {
+        this.filename = filename;
+        mkdirSync(dirname(filename), { recursive: true, mode: 0o700 });
+        this.db = new DatabaseSync(filename);
+        chmodSync(filename, 0o600);
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS research_runs (
+        run_id TEXT PRIMARY KEY,
+        created_at TEXT NOT NULL,
+        question TEXT NOT NULL,
+        intent_json TEXT NOT NULL,
+        planner_source TEXT NOT NULL,
+        report_json TEXT NOT NULL
+      );
+      CREATE INDEX IF NOT EXISTS idx_research_runs_created ON research_runs(created_at DESC);
+      CREATE TABLE IF NOT EXISTS battle_reviews (
+        match_id TEXT NOT NULL,
+        battle_id TEXT NOT NULL,
+        label TEXT NOT NULL CHECK (label IN ('correct', 'insufficient_inference', 'wrong', 'unknown')),
+        created_at TEXT NOT NULL,
+        PRIMARY KEY (match_id, battle_id)
+      );
+      CREATE TABLE IF NOT EXISTS evaluation_experiments (
+        run_id TEXT PRIMARY KEY,
+        created_at TEXT NOT NULL,
+        experiment_name TEXT NOT NULL,
+        dataset_fingerprint TEXT NOT NULL,
+        candidate_version TEXT NOT NULL,
+        case_count INTEGER NOT NULL,
+        runtime_ms REAL NOT NULL,
+        report_json TEXT NOT NULL
+      );
+      CREATE INDEX IF NOT EXISTS idx_evaluation_experiments_created ON evaluation_experiments(created_at DESC);
+      CREATE TABLE IF NOT EXISTS evaluation_reviews (
+        run_id TEXT NOT NULL,
+        case_id TEXT NOT NULL,
+        rule_id TEXT NOT NULL,
+        label TEXT NOT NULL CHECK (label IN ('confirm', 'reject', 'unresolved', 'wrong_evidence')),
+        created_at TEXT NOT NULL,
+        PRIMARY KEY (run_id, case_id, rule_id),
+        FOREIGN KEY (run_id) REFERENCES evaluation_experiments(run_id) ON DELETE CASCADE
+      );
+    `);
+    }
+    save(run) {
+        const id = randomUUID();
+        this.db
+            .prepare(`
+      INSERT INTO research_runs(run_id, created_at, question, intent_json, planner_source, report_json)
+      VALUES (?, ?, ?, ?, ?, ?)
+    `)
+            .run(id, new Date().toISOString(), redactSensitiveText(run.question), JSON.stringify(run.intent), run.source, JSON.stringify({ report: run.report, assistant: run.assistant ?? null }));
+        return id;
+    }
+    saveEvaluation(report) {
+        const runId = randomUUID();
+        this.db
+            .prepare(`
+      INSERT INTO evaluation_experiments(run_id, created_at, experiment_name, dataset_fingerprint, candidate_version, case_count, runtime_ms, report_json)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+    `)
+            .run(runId, report.provenance.startedAt, report.experimentName, report.dataset.fingerprint, report.algorithm.candidateVersion, report.dataset.caseCount, report.provenance.runtimeMs, JSON.stringify(report));
+        return runId;
+    }
+    listEvaluations(limit = 20) {
+        const bounded = Math.max(1, Math.min(100, Math.floor(limit)));
+        const rows = this.db
+            .prepare(`
+      SELECT e.run_id, e.created_at, e.experiment_name, e.dataset_fingerprint, e.candidate_version, e.case_count, e.runtime_ms,
+        (SELECT COUNT(*) FROM evaluation_reviews r WHERE r.run_id = e.run_id) AS reviewed_labels
+      FROM evaluation_experiments e ORDER BY e.created_at DESC, e.run_id DESC LIMIT ?
+    `)
+            .all(bounded);
+        return rows.map((row) => ({
+            runId: row.run_id,
+            createdAt: row.created_at,
+            experimentName: row.experiment_name,
+            datasetFingerprint: row.dataset_fingerprint,
+            candidateVersion: row.candidate_version,
+            caseCount: row.case_count,
+            runtimeMs: row.runtime_ms,
+            reviewedLabels: row.reviewed_labels,
+        }));
+    }
+    getEvaluation(runId) {
+        const row = this.db
+            .prepare('SELECT report_json FROM evaluation_experiments WHERE run_id = ?')
+            .get(runId);
+        if (!row?.report_json)
+            return null;
+        return JSON.parse(row.report_json);
+    }
+    saveEvaluationReview(input) {
+        const report = this.getEvaluation(input.runId);
+        if (!report)
+            throw new Error('evaluation_run_not_found');
+        if (input.ruleId !== report.algorithm.ruleId ||
+            !report.caseOutcomes.some((row) => row.caseId === input.caseId)) {
+            throw new Error('evaluation_review_outside_run');
+        }
+        const createdAt = new Date().toISOString();
+        this.db
+            .prepare(`
+      INSERT INTO evaluation_reviews(run_id, case_id, rule_id, label, created_at) VALUES (?, ?, ?, ?, ?)
+      ON CONFLICT(run_id, case_id, rule_id) DO UPDATE SET label = excluded.label, created_at = excluded.created_at
+    `)
+            .run(input.runId, input.caseId, input.ruleId, input.label, createdAt);
+        return { caseId: input.caseId, ruleId: input.ruleId, label: input.label, createdAt };
+    }
+    listEvaluationReviews(runId) {
+        return this.db
+            .prepare(`
+      SELECT case_id, rule_id, label, created_at FROM evaluation_reviews WHERE run_id = ? ORDER BY case_id, rule_id
+    `)
+            .all(runId).map((row) => ({
+            caseId: row.case_id,
+            ruleId: row.rule_id,
+            label: row.label,
+            createdAt: row.created_at,
+        }));
+    }
+    saveBattleReview(input) {
+        const createdAt = new Date().toISOString();
+        this.db
+            .prepare(`
+      INSERT INTO battle_reviews(match_id, battle_id, label, created_at) VALUES (?, ?, ?, ?)
+      ON CONFLICT(match_id, battle_id) DO UPDATE SET label = excluded.label, created_at = excluded.created_at
+    `)
+            .run(input.matchId, input.battleId, input.label, createdAt);
+        return { ...input, createdAt };
+    }
+    listBattleReviews(matchId) {
+        return this.db
+            .prepare(`
+      SELECT match_id, battle_id, label, created_at FROM battle_reviews WHERE match_id = ? ORDER BY battle_id
+    `)
+            .all(matchId).map((row) => ({
+            matchId: row.match_id,
+            battleId: row.battle_id,
+            label: row.label,
+            createdAt: row.created_at,
+        }));
+    }
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=experiment-store.js.map

package/dist/src/experiment-store.js.map

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

package/dist/src/field.d.ts

@@ -0,0 +1,103 @@
+import { type RateEstimate } from './analytics.js';
+export declare const FIELD_SCHEMA_VERSION: 1;
+/** Engagement distance bands in metres; the last band is open ended. */
+export declare const DISTANCE_BANDS: readonly [{
+    readonly id: "close";
+    readonly label: "近距 <25m";
+    readonly maxMeters: 25;
+}, {
+    readonly id: "mid";
+    readonly label: "中近 25–75m";
+    readonly maxMeters: 75;
+}, {
+    readonly id: "far";
+    readonly label: "中远 75–150m";
+    readonly maxMeters: 150;
+}, {
+    readonly id: "long";
+    readonly label: "远距 ≥150m";
+    readonly maxMeters: number;
+}];
+export declare const DISTANCE_MIN_DAMAGE = 600;
+export declare const DISTANCE_GAP_POINTS = 0.1;
+export declare const ZONE_MAX_PHASE = 9;
+export declare const ZONE_MIN_SAMPLES = 150;
+export declare const ZONE_BIN_EDGES: readonly [0.5, 0.85, 1];
+export declare const CONTEST_RADIUS_METERS = 500;
+export declare const CONTEST_MIN_MATCHES = 8;
+export declare function distanceBandOf(meters: number): number;
+export interface ZonePhaseStats {
+    samples: number;
+    blueSamples: number;
+    /** Position samples by distance from the safe-zone centre divided by its radius: <0.5, 0.5-0.85, 0.85-1, outside. */
+    bins: [number, number, number, number];
+    blueDamage: number;
+}
+export interface FieldMatchStats {
+    distance: {
+        dealt: number[];
+        dealtHead: number[];
+        taken: number[];
+        takenHead: number[];
+        weapons: Record<string, number[]>;
+    };
+    zone: {
+        phases: Record<number, ZonePhaseStats>;
+        blueDamage: number;
+        damageTaken: number;
+    };
+    landing: {
+        /** Other teams whose nearest member landed within the contest radius of the squad centre; null without landings. */
+        contestedTeams: number | null;
+        nearestEnemyMeters: number | null;
+        /** Most common named map area reported after landing. */
+        region: string | null;
+    };
+}
+/**
+ * One pass over a raw telemetry payload for the tracked squad: damage by engagement distance, time spent
+ * outside the safe zone, blue-zone damage and how crowded the landing spot was.
+ */
+export declare function analyzeFieldTelemetry(payload: unknown, trackedIds: ReadonlySet<string>): FieldMatchStats;
+export interface DistanceBandSummary {
+    id: string;
+    label: string;
+    dealt: number;
+    taken: number;
+    dealtShare: number | null;
+    takenShare: number | null;
+    /** Share of dealt damage that was headshot damage. */
+    headshotShare: number | null;
+}
+export interface WeaponDistanceSummary {
+    weapon: string;
+    damage: number;
+    shares: number[];
+    mainBand: string;
+}
+export interface DistanceSummary {
+    matches: number;
+    totalDealt: number;
+    totalTaken: number;
+    bands: DistanceBandSummary[];
+    weapons: WeaponDistanceSummary[];
+    /** Taken minus dealt share in the two long bands; positive means the squad absorbs more long-range damage than it deals. */
+    longRangeGap: number | null;
+}
+export declare function summarizeDistance(items: readonly FieldMatchStats[]): DistanceSummary;
+export interface ZonePhaseSummary {
+    phase: number;
+    samples: number;
+    /** Share of position samples flagged as inside the blue zone. */
+    outsideRate: RateEstimate;
+    /** Share of position samples by distance from the safe-zone centre: inner, middle, edge, outside. */
+    binShares: [number, number, number, number] | null;
+    blueDamage: number;
+}
+export interface ZoneSummary {
+    matches: number;
+    blueDamagePerMatch: number | null;
+    blueDamageShare: number | null;
+    phases: ZonePhaseSummary[];
+}
+export declare function summarizeZone(items: readonly FieldMatchStats[]): ZoneSummary;