jfl 0.4.4 → 0.5.0

package/dist/lib/telemetry-agent-v2.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Telemetry Agent V2 - Real Platform Digest Consumer
+ *
+ * Fetches production telemetry from jfl-platform digest API,
+ * extracts real metrics, compares to previous runs, generates
+ * training tuples, and proposes scoped RL agents.
+ *
+ * @purpose Real telemetry agent consuming platform digest API for metrics-driven RL
+ */
+import type { PlatformDigest, MetricComparison, ProposedAgent, TelemetryAgentV2State } from '../types/platform-digest.js';
+type EventEmitter = (type: string, data: Record<string, unknown>, source?: string) => void;
+interface ProductInsight {
+    type: 'training' | 'product' | 'system' | 'performance';
+    severity: 'info' | 'warning' | 'critical';
+    title: string;
+    detail: string;
+}
+interface TelemetryAgentV2Options {
+    projectRoot: string;
+    platformUrl?: string;
+    installId?: string;
+    stratusUrl?: string;
+    stratusKey?: string;
+    emitEvent?: EventEmitter;
+}
+interface ExtractedMetrics {
+    command_success_rate: number;
+    command_p90_latency_ms: number;
+    hub_crash_rate: number;
+    session_crash_rate: number;
+    hook_hit_rate: number;
+    mcp_avg_latency_ms: number;
+    error_cluster_count: number;
+    flow_completion_rate: number;
+    cost_per_session_usd: number;
+    active_installs: number;
+}
+export declare class TelemetryAgentV2 {
+    private projectRoot;
+    private platformUrl;
+    private installId;
+    private stratusUrl;
+    private stratusKey;
+    private emitEvent;
+    private statePath;
+    private state;
+    constructor(opts: TelemetryAgentV2Options);
+    private loadPlatformUrl;
+    private loadInstallId;
+    private loadState;
+    private saveState;
+    /**
+     * Fetch digest from platform API
+     */
+    fetchDigest(hours?: number): Promise<PlatformDigest | null>;
+    private normalizeDigest;
+    /**
+     * Extract real metrics from platform digest
+     */
+    extractMetrics(digest: PlatformDigest): ExtractedMetrics;
+    /**
+     * Compare metrics to previous run
+     */
+    compareMetrics(current: ExtractedMetrics): MetricComparison[];
+    /**
+     * Generate training tuple from digest comparison
+     */
+    generateTrainingTuple(digest: PlatformDigest, metrics: ExtractedMetrics, comparisons: MetricComparison[]): void;
+    /**
+     * Propose scoped agents based on metric analysis
+     */
+    proposeAgents(metrics: ExtractedMetrics, comparisons: MetricComparison[]): ProposedAgent[];
+    /**
+     * Write proposed agents to .jfl/agents/proposed/
+     */
+    writeProposedAgents(agents: ProposedAgent[]): void;
+    private generateAgentToml;
+    /**
+     * Analyze ALL data sources — platform telemetry + local data — for product improvement insights
+     */
+    analyzeProduct(platformDigest?: PlatformDigest | null): Promise<{
+        insights: ProductInsight[];
+        claudeMdUpdates: string[];
+        staleDocs: string[];
+        trainingGaps: string[];
+        platformMetrics: Record<string, unknown> | null;
+    }>;
+    /**
+     * Run the telemetry agent
+     */
+    run(): Promise<{
+        digest24h: PlatformDigest | null;
+        digest7d: PlatformDigest | null;
+        metrics: ExtractedMetrics | null;
+        comparisons: MetricComparison[];
+        proposedAgents: ProposedAgent[];
+        alerts: MetricComparison[];
+        wins: MetricComparison[];
+        productAnalysis: {
+            insights: ProductInsight[];
+            claudeMdUpdates: string[];
+            staleDocs: string[];
+            trainingGaps: string[];
+        } | null;
+    }>;
+    /**
+     * Get current metrics (cached from last run or fetch fresh)
+     */
+    getMetrics(): Promise<ExtractedMetrics | null>;
+    /**
+     * Helper to get recent commits
+     */
+    private getRecentCommits;
+    /**
+     * Helper to get recent changed files
+     */
+    private getRecentChangedFiles;
+    /**
+     * Helper to get current branch
+     */
+    private getCurrentBranch;
+    /**
+     * Get agent status
+     */
+    getStatus(): TelemetryAgentV2State;
+}
+export {};
+//# sourceMappingURL=telemetry-agent-v2.d.ts.map

package/dist/lib/telemetry-agent-v2.d.ts.map

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