@substrate-ai/core 0.19.54

package/dist/telemetry/task-baselines.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Per-task-type baseline profiles for efficiency scoring (Story 35-2).
+ *
+ * Calibrated from ynab cross-project validation run data (Epics 5-6, v0.5.8-v0.5.10).
+ * Used by EfficiencyScorer for task-type-aware io_ratio and token density scoring.
+ *
+ * Baseline data (ynab Epics 5-6):
+ *   dev-story:      400 turns, avg 544 output/turn, io mean 398 (totalIn/out)
+ *   create-story:    83 turns, avg 1522 output/turn, io mean 149
+ *   code-review:     59 turns, avg 3937 output/turn, io mean 79
+ *   minor-fixes:     48 turns, avg 714 output/turn,  io mean 169
+ *   test-plan:       15 turns, avg 1608 output/turn, io mean 28
+ *   test-expansion:   7 turns, avg 1953 output/turn, io mean 12
+ *
+ * Migrated to @substrate-ai/core in story 41-6b.
+ */
+export interface TaskBaseline {
+    /** Expected avg output tokens per turn (for token density sub-score) */
+    expectedOutputPerTurn: number;
+    /** Target output/freshInput ratio for io_ratio sub-score logarithmic curve */
+    targetIoRatio: number;
+}
+export declare const TASK_BASELINES: Readonly<Record<string, TaskBaseline>>;
+export declare const DEFAULT_BASELINE: Readonly<TaskBaseline>;
+/**
+ * Get the baseline for a task type, falling back to DEFAULT_BASELINE
+ * when taskType is undefined, empty, or unknown.
+ */
+export declare function getBaseline(taskType?: string): TaskBaseline;
+//# sourceMappingURL=task-baselines.d.ts.map

package/dist/telemetry/task-baselines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-baselines.d.ts","sourceRoot":"","sources":["../../src/telemetry/task-baselines.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,MAAM,WAAW,YAAY;IAC3B,wEAAwE;IACxE,qBAAqB,EAAE,MAAM,CAAA;IAC7B,8EAA8E;IAC9E,aAAa,EAAE,MAAM,CAAA;CACtB;AAMD,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAOjE,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,YAAY,CAGnD,CAAA;AAMD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY,CAG3D"}

package/dist/telemetry/task-baselines.js

@@ -0,0 +1,44 @@
+/**
+ * Per-task-type baseline profiles for efficiency scoring (Story 35-2).
+ *
+ * Calibrated from ynab cross-project validation run data (Epics 5-6, v0.5.8-v0.5.10).
+ * Used by EfficiencyScorer for task-type-aware io_ratio and token density scoring.
+ *
+ * Baseline data (ynab Epics 5-6):
+ *   dev-story:      400 turns, avg 544 output/turn, io mean 398 (totalIn/out)
+ *   create-story:    83 turns, avg 1522 output/turn, io mean 149
+ *   code-review:     59 turns, avg 3937 output/turn, io mean 79
+ *   minor-fixes:     48 turns, avg 714 output/turn,  io mean 169
+ *   test-plan:       15 turns, avg 1608 output/turn, io mean 28
+ *   test-expansion:   7 turns, avg 1953 output/turn, io mean 12
+ *
+ * Migrated to @substrate-ai/core in story 41-6b.
+ */
+// ---------------------------------------------------------------------------
+// Baselines
+// ---------------------------------------------------------------------------
+export const TASK_BASELINES = {
+    'dev-story': { expectedOutputPerTurn: 550, targetIoRatio: 100 },
+    'create-story': { expectedOutputPerTurn: 1500, targetIoRatio: 100 },
+    'code-review': { expectedOutputPerTurn: 3900, targetIoRatio: 50 },
+    'minor-fixes': { expectedOutputPerTurn: 700, targetIoRatio: 100 },
+    'test-plan': { expectedOutputPerTurn: 1600, targetIoRatio: 30 },
+    'test-expansion': { expectedOutputPerTurn: 1950, targetIoRatio: 15 },
+};
+export const DEFAULT_BASELINE = {
+    expectedOutputPerTurn: 800,
+    targetIoRatio: 100,
+};
+// ---------------------------------------------------------------------------
+// Lookup
+// ---------------------------------------------------------------------------
+/**
+ * Get the baseline for a task type, falling back to DEFAULT_BASELINE
+ * when taskType is undefined, empty, or unknown.
+ */
+export function getBaseline(taskType) {
+    if (taskType === undefined || taskType === '')
+        return DEFAULT_BASELINE;
+    return TASK_BASELINES[taskType] ?? DEFAULT_BASELINE;
+}
+//# sourceMappingURL=task-baselines.js.map

package/dist/telemetry/task-baselines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-baselines.js","sourceRoot":"","sources":["../../src/telemetry/task-baselines.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAaH,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,CAAC,MAAM,cAAc,GAA2C;IACpE,WAAW,EAAE,EAAE,qBAAqB,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE;IAC/D,cAAc,EAAE,EAAE,qBAAqB,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE;IACnE,aAAa,EAAE,EAAE,qBAAqB,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE;IACjE,aAAa,EAAE,EAAE,qBAAqB,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE;IACjE,WAAW,EAAE,EAAE,qBAAqB,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE;IAC/D,gBAAgB,EAAE,EAAE,qBAAqB,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE;CACrE,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACtD,qBAAqB,EAAE,GAAG;IAC1B,aAAa,EAAE,GAAG;CACnB,CAAA;AAED,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,QAAiB;IAC3C,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,gBAAgB,CAAA;IACtE,OAAO,cAAc,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAA;AACrD,CAAC"}

package/dist/telemetry/telemetry-pipeline.d.ts

@@ -0,0 +1,122 @@
+/**
+ * TelemetryPipeline — orchestrates the full telemetry analysis pipeline.
+ *
+ * Processing flow for each batch of raw OTLP payloads:
+ *   1. Normalize raw OTLP → NormalizedSpan[] / NormalizedLog[] (TelemetryNormalizer)
+ *   2. Analyze turns via dual-track:
+ *      a. Span-based: ITurnAnalyzer.analyze(spans) → TurnAnalysis[]
+ *      b. Log-based:  ILogTurnAnalyzer.analyze(logs) → TurnAnalysis[]
+ *      c. Merge & deduplicate by spanId (prefer span-derived)
+ *   3. Compute category stats → CategoryStats[] (ICategorizer)
+ *   4. Compute consumer stats → ConsumerStats[] (IConsumerAnalyzer)
+ *   5. Score efficiency → EfficiencyScore (IEfficiencyScorer) — from merged turns
+ *   6. Generate recommendations → Recommendation[] (IRecommender) — from merged turns
+ *   7. Persist all results (ITelemetryPersistence)
+ *
+ * Design invariants:
+ *   - Constructor injection for all dependencies
+ *   - Never throws from processBatch() — errors are caught per-item and logged
+ *   - Grouping by storyKey; payloads without a storyKey are skipped at the
+ *     analysis stage (normalised data is still stored)
+ *   - Log-only path: when no spans are present, ILogTurnAnalyzer produces turns.
+ *
+ * Duck-typed interfaces for scoring deps (implementations migrate in 41-6b).
+ * This allows the core package to be self-contained without importing from
+ * the monolith's scoring modules.
+ */
+import type { ILogger } from '../dispatch/types.js';
+import type { TelemetryNormalizer } from './normalizer.js';
+import type { NormalizedSpan, NormalizedLog, TurnAnalysis, CategoryStats, ConsumerStats, EfficiencyScore, RawOtlpPayload, ITelemetryPersistence, IRecommender } from './types.js';
+export interface ITurnAnalyzer {
+    analyze(spans: NormalizedSpan[]): TurnAnalysis[];
+}
+export interface ILogTurnAnalyzer {
+    analyze(logs: NormalizedLog[]): TurnAnalysis[];
+}
+export interface ICategorizer {
+    computeCategoryStats(spans: NormalizedSpan[], turns: TurnAnalysis[]): CategoryStats[];
+    computeCategoryStatsFromTurns(turns: TurnAnalysis[]): CategoryStats[];
+}
+export interface IConsumerAnalyzer {
+    analyze(spans: NormalizedSpan[]): ConsumerStats[];
+    analyzeFromTurns(turns: TurnAnalysis[]): ConsumerStats[];
+}
+export interface IEfficiencyScorer {
+    score(storyKey: string, turns: TurnAnalysis[]): EfficiencyScore;
+}
+/**
+ * All injected dependencies for the TelemetryPipeline.
+ * Concrete implementations satisfy these duck-typed interfaces structurally.
+ */
+export interface TelemetryPipelineDeps {
+    normalizer: TelemetryNormalizer;
+    turnAnalyzer: ITurnAnalyzer;
+    logTurnAnalyzer: ILogTurnAnalyzer;
+    categorizer: ICategorizer;
+    consumerAnalyzer: IConsumerAnalyzer;
+    efficiencyScorer: IEfficiencyScorer;
+    recommender: IRecommender;
+    persistence: ITelemetryPersistence;
+    logger?: ILogger;
+}
+/**
+ * Wires together the full OTLP analysis and persistence pipeline.
+ *
+ * Usage:
+ *   const pipeline = new TelemetryPipeline(deps)
+ *   await pipeline.processBatch(items)
+ */
+export declare class TelemetryPipeline {
+    private readonly _normalizer;
+    private readonly _turnAnalyzer;
+    private readonly _logTurnAnalyzer;
+    private readonly _categorizer;
+    private readonly _consumerAnalyzer;
+    private readonly _efficiencyScorer;
+    private readonly _recommender;
+    private readonly _persistence;
+    private readonly _logger;
+    /** Stories that have had stale telemetry purged this pipeline lifetime. */
+    private readonly _purgedStories;
+    constructor(deps: TelemetryPipelineDeps);
+    /**
+     * Process a batch of raw OTLP payloads through the full analysis pipeline.
+     *
+     * Each payload is normalized independently. Spans and logs are grouped by
+     * storyKey for per-story analysis. Items that fail normalization are skipped
+     * with a warning.
+     *
+     * Dual-track analysis:
+     *   - Span-derived turns via ITurnAnalyzer
+     *   - Log-derived turns via ILogTurnAnalyzer
+     *   - Merged (deduplicated by spanId) before downstream analysis
+     */
+    processBatch(items: RawOtlpPayload[]): Promise<void>;
+    /**
+     * Group turns by dispatchId for per-dispatch scoring.
+     * Only turns with a non-empty dispatchId are included.
+     */
+    private _groupTurnsByDispatchId;
+    /**
+     * Merge span-derived and log-derived turns, deduplicating by spanId.
+     * When a span and a log share the same spanId, the span-derived turn is preferred
+     * (richer data). The merged result is sorted chronologically and renumbered.
+     */
+    private _mergeTurns;
+    /**
+     * Full span-based analysis path.
+     */
+    private _processStory;
+    /**
+     * Log-only analysis path: processes turns from ILogTurnAnalyzer through full
+     * analysis and persistence.
+     */
+    private _processStoryFromTurns;
+    /**
+     * Shared persistence helper — called by both _processStory and _processStoryFromTurns.
+     * All 5 persistence calls are made here with individual error guards so a single
+     * failure does not abort the others.
+     */
+    private _persistStoryData;
+}
+//# sourceMappingURL=telemetry-pipeline.d.ts.map

package/dist/telemetry/telemetry-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-pipeline.d.ts","sourceRoot":"","sources":["../../src/telemetry/telemetry-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,YAAY,EAEZ,aAAa,EACb,aAAa,EAEb,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,YAAY,EACb,MAAM,YAAY,CAAA;AAMnB,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,YAAY,EAAE,CAAA;CACjD;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,YAAY,EAAE,CAAA;CAC/C;AAED,MAAM,WAAW,YAAY;IAC3B,oBAAoB,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,aAAa,EAAE,CAAA;IACrF,6BAA6B,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,aAAa,EAAE,CAAA;CACtE;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,aAAa,EAAE,CAAA;IACjD,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,aAAa,EAAE,CAAA;CACzD;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,eAAe,CAAA;CAChE;AAMD;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,mBAAmB,CAAA;IAC/B,YAAY,EAAE,aAAa,CAAA;IAC3B,eAAe,EAAE,gBAAgB,CAAA;IACjC,WAAW,EAAE,YAAY,CAAA;IACzB,gBAAgB,EAAE,iBAAiB,CAAA;IACnC,gBAAgB,EAAE,iBAAiB,CAAA;IACnC,WAAW,EAAE,YAAY,CAAA;IACzB,WAAW,EAAE,qBAAqB,CAAA;IAClC,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAsBD;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkB;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;IAC3C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAmB;IACrD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAmB;IACrD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuB;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoB;gBAEvC,IAAI,EAAE,qBAAqB;IAgBvC;;;;;;;;;;;OAWG;IACG,YAAY,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA6G1D;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAc/B;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAWnB;;OAEG;YACW,aAAa;IAuE3B;;;OAGG;YACW,sBAAsB;IAmEpC;;;;OAIG;YACW,iBAAiB;CAiDhC"}

package/dist/telemetry/telemetry-pipeline.js

@@ -0,0 +1,349 @@
+/**
+ * TelemetryPipeline — orchestrates the full telemetry analysis pipeline.
+ *
+ * Processing flow for each batch of raw OTLP payloads:
+ *   1. Normalize raw OTLP → NormalizedSpan[] / NormalizedLog[] (TelemetryNormalizer)
+ *   2. Analyze turns via dual-track:
+ *      a. Span-based: ITurnAnalyzer.analyze(spans) → TurnAnalysis[]
+ *      b. Log-based:  ILogTurnAnalyzer.analyze(logs) → TurnAnalysis[]
+ *      c. Merge & deduplicate by spanId (prefer span-derived)
+ *   3. Compute category stats → CategoryStats[] (ICategorizer)
+ *   4. Compute consumer stats → ConsumerStats[] (IConsumerAnalyzer)
+ *   5. Score efficiency → EfficiencyScore (IEfficiencyScorer) — from merged turns
+ *   6. Generate recommendations → Recommendation[] (IRecommender) — from merged turns
+ *   7. Persist all results (ITelemetryPersistence)
+ *
+ * Design invariants:
+ *   - Constructor injection for all dependencies
+ *   - Never throws from processBatch() — errors are caught per-item and logged
+ *   - Grouping by storyKey; payloads without a storyKey are skipped at the
+ *     analysis stage (normalised data is still stored)
+ *   - Log-only path: when no spans are present, ILogTurnAnalyzer produces turns.
+ *
+ * Duck-typed interfaces for scoring deps (implementations migrate in 41-6b).
+ * This allows the core package to be self-contained without importing from
+ * the monolith's scoring modules.
+ */
+// ---------------------------------------------------------------------------
+// TelemetryPipeline
+// ---------------------------------------------------------------------------
+/**
+ * Wires together the full OTLP analysis and persistence pipeline.
+ *
+ * Usage:
+ *   const pipeline = new TelemetryPipeline(deps)
+ *   await pipeline.processBatch(items)
+ */
+export class TelemetryPipeline {
+    _normalizer;
+    _turnAnalyzer;
+    _logTurnAnalyzer;
+    _categorizer;
+    _consumerAnalyzer;
+    _efficiencyScorer;
+    _recommender;
+    _persistence;
+    _logger;
+    /** Stories that have had stale telemetry purged this pipeline lifetime. */
+    _purgedStories = new Set();
+    constructor(deps) {
+        this._normalizer = deps.normalizer;
+        this._turnAnalyzer = deps.turnAnalyzer;
+        this._logTurnAnalyzer = deps.logTurnAnalyzer;
+        this._categorizer = deps.categorizer;
+        this._consumerAnalyzer = deps.consumerAnalyzer;
+        this._efficiencyScorer = deps.efficiencyScorer;
+        this._recommender = deps.recommender;
+        this._persistence = deps.persistence;
+        this._logger = deps.logger ?? console;
+    }
+    // ---------------------------------------------------------------------------
+    // processBatch
+    // ---------------------------------------------------------------------------
+    /**
+     * Process a batch of raw OTLP payloads through the full analysis pipeline.
+     *
+     * Each payload is normalized independently. Spans and logs are grouped by
+     * storyKey for per-story analysis. Items that fail normalization are skipped
+     * with a warning.
+     *
+     * Dual-track analysis:
+     *   - Span-derived turns via ITurnAnalyzer
+     *   - Log-derived turns via ILogTurnAnalyzer
+     *   - Merged (deduplicated by spanId) before downstream analysis
+     */
+    async processBatch(items) {
+        if (items.length === 0)
+            return;
+        this._logger.debug({ count: items.length }, 'TelemetryPipeline.processBatch start');
+        // -- Step 1: Normalize all payloads --
+        const allSpans = [];
+        const allLogs = [];
+        for (const item of items) {
+            try {
+                const spans = this._normalizer.normalizeSpan(item.body);
+                allSpans.push(...spans);
+            }
+            catch (err) {
+                this._logger.warn({ err }, 'TelemetryPipeline: normalizeSpan failed — skipping payload');
+            }
+            try {
+                const logs = this._normalizer.normalizeLog(item.body, item.dispatchContext);
+                allLogs.push(...logs);
+            }
+            catch (err) {
+                this._logger.warn({ err }, 'TelemetryPipeline: normalizeLog failed — skipping payload');
+            }
+        }
+        this._logger.debug({ spans: allSpans.length, logs: allLogs.length }, 'TelemetryPipeline: normalized batch');
+        // AC1: No early return on zero spans — only return if BOTH are empty
+        if (allSpans.length === 0 && allLogs.length === 0) {
+            this._logger.debug('TelemetryPipeline: no spans or logs normalized from batch');
+            return;
+        }
+        // -- Step 2: Group by storyKey --
+        const unknownStoryKey = '__unknown__';
+        const spansByStory = new Map();
+        for (const span of allSpans) {
+            const key = span.storyKey ?? unknownStoryKey;
+            const existing = spansByStory.get(key);
+            if (existing !== undefined) {
+                existing.push(span);
+            }
+            else {
+                spansByStory.set(key, [span]);
+            }
+        }
+        const logsByStory = new Map();
+        for (const log of allLogs) {
+            const key = log.storyKey ?? unknownStoryKey;
+            const existing = logsByStory.get(key);
+            if (existing !== undefined) {
+                existing.push(log);
+            }
+            else {
+                logsByStory.set(key, [log]);
+            }
+        }
+        // Collect all unique story keys from both sources
+        const allStoryKeys = new Set();
+        for (const key of spansByStory.keys())
+            allStoryKeys.add(key);
+        for (const key of logsByStory.keys())
+            allStoryKeys.add(key);
+        // -- Step 3: Per-story dual-track analysis and persistence --
+        for (const storyKey of allStoryKeys) {
+            // Skip data without a story key for the analysis stages
+            if (storyKey === unknownStoryKey) {
+                const spanCount = spansByStory.get(unknownStoryKey)?.length ?? 0;
+                const logCount = logsByStory.get(unknownStoryKey)?.length ?? 0;
+                this._logger.debug({ spanCount, logCount }, 'TelemetryPipeline: data without storyKey — skipping analysis');
+                continue;
+            }
+            try {
+                const spans = spansByStory.get(storyKey) ?? [];
+                const logs = logsByStory.get(storyKey) ?? [];
+                // Dual-track turn analysis
+                const spanTurns = spans.length > 0 ? this._turnAnalyzer.analyze(spans) : [];
+                const logTurns = logs.length > 0 ? this._logTurnAnalyzer.analyze(logs) : [];
+                const mergedTurns = this._mergeTurns(spanTurns, logTurns);
+                if (spans.length > 0) {
+                    // Has spans: full analysis with span-based categorizer/consumer
+                    await this._processStory(storyKey, spans, mergedTurns);
+                }
+                else {
+                    // Log-only path: efficiency + persistence only
+                    await this._processStoryFromTurns(storyKey, mergedTurns);
+                }
+            }
+            catch (err) {
+                this._logger.warn({ err, storyKey }, 'TelemetryPipeline: story processing failed — skipping');
+            }
+        }
+        this._logger.debug({ storyCount: allStoryKeys.size }, 'TelemetryPipeline.processBatch complete');
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Group turns by dispatchId for per-dispatch scoring.
+     * Only turns with a non-empty dispatchId are included.
+     */
+    _groupTurnsByDispatchId(turns) {
+        const groups = new Map();
+        for (const turn of turns) {
+            if (turn.dispatchId === undefined || turn.dispatchId === '')
+                continue;
+            const existing = groups.get(turn.dispatchId);
+            if (existing !== undefined) {
+                existing.push(turn);
+            }
+            else {
+                groups.set(turn.dispatchId, [turn]);
+            }
+        }
+        return groups;
+    }
+    /**
+     * Merge span-derived and log-derived turns, deduplicating by spanId.
+     * When a span and a log share the same spanId, the span-derived turn is preferred
+     * (richer data). The merged result is sorted chronologically and renumbered.
+     */
+    _mergeTurns(spanTurns, logTurns) {
+        if (logTurns.length === 0)
+            return spanTurns;
+        if (spanTurns.length === 0)
+            return logTurns;
+        const spanTurnIds = new Set(spanTurns.map((t) => t.spanId));
+        const uniqueLogTurns = logTurns.filter((t) => !spanTurnIds.has(t.spanId));
+        return [...spanTurns, ...uniqueLogTurns]
+            .sort((a, b) => a.timestamp - b.timestamp)
+            .map((t, i) => ({ ...t, turnNumber: i + 1 }));
+    }
+    /**
+     * Full span-based analysis path.
+     */
+    async _processStory(storyKey, spans, mergedTurns) {
+        // Step 2: Turn analysis — use pre-merged turns
+        const turns = mergedTurns;
+        // Step 3: Category stats (span-based)
+        const categories = this._categorizer.computeCategoryStats(spans, turns);
+        // Step 4: Consumer stats (span-based)
+        const consumers = this._consumerAnalyzer.analyze(spans);
+        // Step 5: Efficiency score (from merged turns)
+        const baseTimestamp = Date.now();
+        const storyScore = this._efficiencyScorer.score(storyKey, turns);
+        const efficiencyScore = { ...storyScore, timestamp: baseTimestamp };
+        // Per-dispatch scoring
+        const dispatchGroups = this._groupTurnsByDispatchId(turns);
+        const dispatchScores = Array.from(dispatchGroups.entries()).map(([dispatchId, dispatchTurns], idx) => {
+            const firstTurn = dispatchTurns[0];
+            const scored = this._efficiencyScorer.score(storyKey, dispatchTurns);
+            return {
+                ...scored,
+                timestamp: baseTimestamp + 1 + idx,
+                dispatchId,
+                taskType: firstTurn?.taskType,
+                phase: firstTurn?.phase,
+            };
+        });
+        // Step 6: Recommendations
+        const generatedAt = new Date().toISOString();
+        const context = {
+            storyKey,
+            generatedAt,
+            turns,
+            categories,
+            consumers,
+            efficiencyScore,
+            allSpans: spans,
+            dispatchScores,
+        };
+        const recommendations = this._recommender.analyze(context);
+        // Step 7: Persist (shared helper — mirrors log-only path)
+        await this._persistStoryData(storyKey, {
+            turns,
+            efficiencyScore,
+            categoryStats: categories,
+            consumerStats: consumers,
+            recommendations,
+            dispatchScores,
+        });
+        this._logger.info({
+            storyKey,
+            turns: turns.length,
+            compositeScore: efficiencyScore.compositeScore,
+            recommendations: recommendations.length,
+            dispatchScores: dispatchScores.length,
+        }, 'TelemetryPipeline: story analysis complete');
+    }
+    /**
+     * Log-only analysis path: processes turns from ILogTurnAnalyzer through full
+     * analysis and persistence.
+     */
+    async _processStoryFromTurns(storyKey, turns) {
+        if (turns.length === 0)
+            return;
+        // Efficiency score from log-derived turns
+        const baseTimestamp = Date.now();
+        const storyScore = this._efficiencyScorer.score(storyKey, turns);
+        const efficiencyScore = { ...storyScore, timestamp: baseTimestamp };
+        // Category stats from turns (no raw spans needed)
+        const categoryStats = this._categorizer.computeCategoryStatsFromTurns(turns);
+        // Consumer stats from turns
+        const consumerStats = this._consumerAnalyzer.analyzeFromTurns(turns);
+        // Per-dispatch scoring
+        const dispatchGroups = this._groupTurnsByDispatchId(turns);
+        const dispatchScores = Array.from(dispatchGroups.entries()).map(([dispatchId, dispatchTurns], idx) => {
+            const firstTurn = dispatchTurns[0];
+            const scored = this._efficiencyScorer.score(storyKey, dispatchTurns);
+            return {
+                ...scored,
+                timestamp: baseTimestamp + 1 + idx,
+                dispatchId,
+                taskType: firstTurn?.taskType,
+                phase: firstTurn?.phase,
+            };
+        });
+        // Recommendations via Recommender with allSpans: []
+        const generatedAt = new Date().toISOString();
+        const context = {
+            storyKey,
+            generatedAt,
+            turns,
+            categories: categoryStats,
+            consumers: consumerStats,
+            efficiencyScore,
+            allSpans: [],
+            dispatchScores,
+        };
+        const recommendations = this._recommender.analyze(context);
+        // Persist all 5 methods via shared helper
+        await this._persistStoryData(storyKey, {
+            turns,
+            efficiencyScore,
+            categoryStats,
+            consumerStats,
+            recommendations,
+            dispatchScores,
+        });
+        this._logger.info({
+            storyKey,
+            turns: turns.length,
+            compositeScore: efficiencyScore.compositeScore,
+            categories: categoryStats.length,
+            recommendations: recommendations.length,
+            dispatchScores: dispatchScores.length,
+        }, 'TelemetryPipeline: story analysis from turns complete');
+    }
+    /**
+     * Shared persistence helper — called by both _processStory and _processStoryFromTurns.
+     * All 5 persistence calls are made here with individual error guards so a single
+     * failure does not abort the others.
+     */
+    async _persistStoryData(storyKey, data) {
+        const { turns, efficiencyScore, categoryStats, consumerStats, recommendations, dispatchScores } = data;
+        // Purge stale telemetry from prior runs (once per story per pipeline lifetime)
+        if (!this._purgedStories.has(storyKey)) {
+            this._purgedStories.add(storyKey);
+            await this._persistence.purgeStoryTelemetry(storyKey).catch((err) => this._logger.warn({ err, storyKey }, 'Failed to purge stale telemetry — continuing with persist'));
+        }
+        await Promise.all([
+            turns.length > 0
+                ? this._persistence.storeTurnAnalysis(storyKey, turns).catch((err) => this._logger.warn({ err, storyKey }, 'Failed to store turn analysis'))
+                : Promise.resolve(),
+            this._persistence.storeEfficiencyScore(efficiencyScore).catch((err) => this._logger.warn({ err, storyKey }, 'Failed to store efficiency score')),
+            categoryStats.length > 0
+                ? this._persistence.storeCategoryStats(storyKey, categoryStats).catch((err) => this._logger.warn({ err, storyKey }, 'Failed to store category stats'))
+                : Promise.resolve(),
+            consumerStats.length > 0
+                ? this._persistence.storeConsumerStats(storyKey, consumerStats).catch((err) => this._logger.warn({ err, storyKey }, 'Failed to store consumer stats'))
+                : Promise.resolve(),
+            recommendations.length > 0
+                ? this._persistence.saveRecommendations(storyKey, recommendations).catch((err) => this._logger.warn({ err, storyKey }, 'Failed to save recommendations'))
+                : Promise.resolve(),
+            ...dispatchScores.map((ds) => this._persistence.storeEfficiencyScore(ds).catch((err) => this._logger.warn({ err, storyKey, dispatchId: ds.dispatchId }, 'Failed to store dispatch efficiency score'))),
+        ]);
+    }
+}
+//# sourceMappingURL=telemetry-pipeline.js.map

package/dist/telemetry/telemetry-pipeline.js.map

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

package/dist/telemetry/timestamp-normalizer.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Timestamp normalization for OTLP telemetry payloads.
+ *
+ * OTLP payloads use nanosecond integers for timestamps (e.g. `startTimeUnixNano`).
+ * Claude Code and other providers may emit timestamps in various formats.
+ *
+ * `normalizeTimestamp()` accepts any unknown value and returns a Unix millisecond
+ * number. Null/undefined/unparseable inputs fall back to `Date.now()`.
+ *
+ * Detection order (after ISO string check):
+ *   1. Nanoseconds  (>= 1e18)
+ *   2. Microseconds (>= 1e15)
+ *   3. Milliseconds (>= 1e12)
+ *   4. Seconds      (< 1e12)
+ */
+/**
+ * Normalize any timestamp value to Unix milliseconds.
+ *
+ * Handles:
+ *   - ISO 8601 strings (e.g. "2024-03-08T12:00:00Z")
+ *   - Nanosecond integers or numeric strings (>= 1e18)
+ *   - Microsecond integers or numeric strings (>= 1e15)
+ *   - Millisecond integers or numeric strings (>= 1e12)
+ *   - Second integers or numeric strings (< 1e12)
+ *   - BigInt string values from OTLP `startTimeUnixNano` (e.g. "1709900000000000000")
+ *   - null / undefined / unparseable → falls back to Date.now()
+ *
+ * @param value - Raw timestamp value of unknown type
+ * @returns Unix millisecond timestamp
+ */
+export declare function normalizeTimestamp(value: unknown): number;
+//# sourceMappingURL=timestamp-normalizer.d.ts.map

package/dist/telemetry/timestamp-normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestamp-normalizer.d.ts","sourceRoot":"","sources":["../../src/telemetry/timestamp-normalizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CA4CzD"}