jfl 0.8.1 → 0.9.1

package/dist/lib/surface-agent.js

@@ -0,0 +1,105 @@
+/**
+ * @purpose Surface Agent - Subway-based agent that manages a specific product surface area
+ *
+ * Each Tenet surface (IDE, Board, Notes, Flow) gets its own Subway agent that:
+ * - Manages the surface UX and intelligence
+ * - Coordinates with domain-specific RL agents
+ * - Learns from user behavior patterns
+ * - Collaborates with other surface agents
+ */
+export class SurfaceAgent {
+    surfaceType;
+    subwayId;
+    policyHead; // PolicyHead
+    associatedRLAgents;
+    constructor(surfaceType, subwayId) {
+        this.surfaceType = surfaceType;
+        this.subwayId = subwayId;
+        this.associatedRLAgents = [];
+        // Each surface has its own policy head trained on domain-specific patterns
+        // this.policyHead = new PolicyHead(`surface_${surfaceType}`)
+    }
+    /**
+     * Learn from user behavior on this surface
+     */
+    async updateLearning(userAction, outcome, context) {
+        // Update surface-specific policy head
+        await this.policyHead.updateFromFeedback({
+            state: this.serializeContext(context),
+            action: userAction,
+            reward: outcome === 'positive' ? 1 : outcome === 'negative' ? -1 : 0,
+            surfaceType: this.surfaceType
+        });
+    }
+    /**
+     * Coordinate with other surfaces
+     */
+    async coordinateWithSurface(targetSurface, method, payload) {
+        // This would use the subway_call tool in practice
+        console.log(`[${this.subwayId}] Calling ${targetSurface}.${method}(${JSON.stringify(payload)})`);
+        // Placeholder for actual Subway coordination
+        return { success: true, data: {} };
+    }
+    /**
+     * Spawn domain-specific RL agent
+     */
+    async spawnRLAgent(agentType, task) {
+        const agentId = `${this.surfaceType}_${agentType}_${Date.now()}`;
+        console.log(`[${this.subwayId}] Spawning RL agent: ${agentId} for ${agentType}`);
+        // This would integrate with the existing RL agent infrastructure
+        // For now, just track that we spawned it
+        this.associatedRLAgents.push(agentId);
+        return agentId;
+    }
+    /**
+     * Share learning insights across surfaces
+     */
+    async broadcastLearning(insight) {
+        // This would use subway_broadcast tool
+        console.log(`[${this.subwayId}] Broadcasting learning: ${insight.pattern} (${insight.optimization})`);
+        // Track cross-surface learning impact
+        await this.updateCrossSurfaceLearning(insight);
+    }
+    /**
+     * Convert surface context to state representation for policy head
+     */
+    serializeContext(context) {
+        return {
+            surface: context.surfaceType,
+            userId: context.userId,
+            session: context.sessionId,
+            capabilities: context.capabilities,
+            preferences: context.userPreferences,
+            crossSurfaceSignals: Object.keys(context.crossSurfaceData).length
+        };
+    }
+    /**
+     * Update learning that spans multiple surfaces
+     */
+    async updateCrossSurfaceLearning(insight) {
+        // Store cross-surface patterns for coordination optimization
+        // This helps surfaces learn when and how to work together
+        const crossSurfacePattern = {
+            pattern: insight.pattern,
+            surfaces: insight.surfaces,
+            optimization: insight.optimization,
+            timestamp: new Date().toISOString(),
+            confidence: insight.confidence
+        };
+        // Would be stored in shared learning database
+        console.log('Cross-surface learning update:', crossSurfacePattern);
+    }
+    /**
+     * Get current surface metrics for coordination decisions
+     */
+    async getSurfaceMetrics() {
+        return {
+            activeUsers: Math.floor(Math.random() * 100),
+            avgSessionLength: Math.floor(Math.random() * 30) + 10,
+            engagementScore: Math.random() * 100,
+            errorRate: Math.random() * 0.1,
+            optimizationOpportunities: Math.floor(Math.random() * 5)
+        };
+    }
+}
+//# sourceMappingURL=surface-agent.js.map

package/dist/lib/surface-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-agent.js","sourceRoot":"","sources":["../../src/lib/surface-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgCH,MAAM,OAAgB,YAAY;IACtB,WAAW,CAAQ;IACnB,QAAQ,CAAQ;IAChB,UAAU,CAAK,CAAC,aAAa;IAC7B,kBAAkB,CAAU;IAEtC,YAAY,WAAmB,EAAE,QAAgB;QAC/C,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;QAC9B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,kBAAkB,GAAG,EAAE,CAAA;QAE5B,2EAA2E;QAC3E,6DAA6D;IAC/D,CAAC;IAYD;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,UAAkB,EAAE,OAA4C,EAAE,OAAuB;QAC5G,sCAAsC;QACtC,MAAM,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC;YACvC,KAAK,EAAE,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC;YACrC,MAAM,EAAE,UAAU;YAClB,MAAM,EAAE,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACpE,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,qBAAqB,CAAC,aAAqB,EAAE,MAAc,EAAE,OAAY;QACvF,kDAAkD;QAClD,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,aAAa,aAAa,IAAI,MAAM,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAEhG,6CAA6C;QAC7C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAA;IACpC,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,YAAY,CAAC,SAAiB,EAAE,IAAS;QACvD,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,WAAW,IAAI,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAA;QAEhE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,wBAAwB,OAAO,QAAQ,SAAS,EAAE,CAAC,CAAA;QAEhF,iEAAiE;QACjE,yCAAyC;QACzC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAErC,OAAO,OAAO,CAAA;IAChB,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,iBAAiB,CAAC,OAAuB;QACvD,uCAAuC;QACvC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,4BAA4B,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,YAAY,GAAG,CAAC,CAAA;QAErG,sCAAsC;QACtC,MAAM,IAAI,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAA;IAChD,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,OAAuB;QAC9C,OAAO;YACL,OAAO,EAAE,OAAO,CAAC,WAAW;YAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,OAAO,CAAC,SAAS;YAC1B,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,WAAW,EAAE,OAAO,CAAC,eAAe;YACpC,mBAAmB,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,MAAM;SAClE,CAAA;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,0BAA0B,CAAC,OAAuB;QAC9D,6DAA6D;QAC7D,0DAA0D;QAE1D,MAAM,mBAAmB,GAAG;YAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B,CAAA;QAED,8CAA8C;QAC9C,OAAO,CAAC,GAAG,CAAC,gCAAgC,EAAE,mBAAmB,CAAC,CAAA;IACpE,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,iBAAiB;QAC/B,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC;YAC5C,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE;YACrD,eAAe,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG;YACpC,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG;YAC9B,yBAAyB,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;SACzD,CAAA;IACH,CAAC;CACF"}

package/dist/lib/surface-coordination-example.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @purpose Example of how Surface Agents coordinate via Subway P2P mesh
+ *
+ * Scenario: User files GitHub issue → Multi-surface intelligent response
+ */
+/**
+ * Example coordination flow between surface agents
+ */
+export declare class SurfaceCoordinationExample {
+    private ideAgent;
+    private boardAgent;
+    constructor();
+    /**
+     * Simulate the full coordination flow
+     */
+    demonstrateCoordination(): Promise<void>;
+    /**
+     * Simulate an RL agent working on the fix
+     */
+    private simulateFixAgent;
+    /**
+     * Example of learning insights being shared across surfaces
+     */
+    demonstrateCrossSurfaceLearning(): Promise<void>;
+}
+/**
+ * Run the example
+ */
+export declare function runSurfaceCoordinationDemo(): Promise<void>;
+//# sourceMappingURL=surface-coordination-example.d.ts.map

package/dist/lib/surface-coordination-example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-coordination-example.d.ts","sourceRoot":"","sources":["../../src/lib/surface-coordination-example.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;GAEG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,UAAU,CAAiB;;IAOnC;;OAEG;IACG,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC;IA0F9C;;OAEG;YACW,gBAAgB;IAiB9B;;OAEG;IACG,+BAA+B,IAAI,OAAO,CAAC,IAAI,CAAC;CAsCvD;AAED;;GAEG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC,CAYhE"}

package/dist/lib/surface-coordination-example.js

@@ -0,0 +1,164 @@
+/**
+ * @purpose Example of how Surface Agents coordinate via Subway P2P mesh
+ *
+ * Scenario: User files GitHub issue → Multi-surface intelligent response
+ */
+import { TenetIDEAgent } from './tenet-ide-agent.js';
+import { TenetBoardAgent } from './tenet-board-agent.js';
+/**
+ * Example coordination flow between surface agents
+ */
+export class SurfaceCoordinationExample {
+    ideAgent;
+    boardAgent;
+    constructor() {
+        this.ideAgent = new TenetIDEAgent();
+        this.boardAgent = new TenetBoardAgent();
+    }
+    /**
+     * Simulate the full coordination flow
+     */
+    async demonstrateCoordination() {
+        console.log('🚀 Surface Agent Coordination Example');
+        console.log('===================================');
+        // 1. User files a new issue
+        const newIssue = {
+            id: 'issue-42',
+            title: 'CLI startup latency regression',
+            body: 'The jfl command takes 500ms+ to start, used to be <200ms',
+            priority: 'high',
+            labels: ['bug', 'performance'],
+            createdAt: new Date().toISOString()
+        };
+        console.log(`\n📋 New issue filed: ${newIssue.title}`);
+        // 2. Board agent receives the issue
+        console.log(`\n[tenet-board.relay] Processing new issue...`);
+        const boardContext = {
+            surfaceType: 'board',
+            userId: 'user123',
+            sessionId: 'session456',
+            capabilities: ['issue_tracking', 'project_management'],
+            userPreferences: { autoAssignment: true },
+            crossSurfaceData: {
+                newIssues: 1,
+                backlogItems: 5,
+                availableAgents: 2
+            }
+        };
+        const boardAction = await this.boardAgent.decide(boardContext);
+        console.log(`[tenet-board.relay] Decision:`, boardAction);
+        // 3. Board agent notifies IDE agent about technical issue
+        console.log(`\n[tenet-board.relay] → [tenet-ide.relay] Sending issue for analysis...`);
+        await this.boardAgent.handleCrossSurfaceEvent('new_issue_filed', {
+            issue: newIssue
+        });
+        // Simulate IDE agent receiving the issue
+        await this.ideAgent.handleCrossSurfaceEvent('new_issue_filed', {
+            issue: newIssue
+        });
+        // 4. IDE agent analyzes and potentially spawns RL agent
+        console.log(`\n[tenet-ide.relay] Analyzing issue fixability...`);
+        const ideContext = {
+            surfaceType: 'ide',
+            userId: 'user123',
+            sessionId: 'session456',
+            capabilities: ['code_analysis', 'performance_tuning'],
+            userPreferences: {
+                autoFix: true,
+                cliSlowness: 520 // Current latency
+            },
+            crossSurfaceData: {
+                newIssues: 1,
+                performanceAlerts: 1
+            }
+        };
+        const ideAction = await this.ideAgent.decide(ideContext);
+        console.log(`[tenet-ide.relay] Decision:`, ideAction);
+        // 5. Coordination between surfaces
+        console.log(`\n🤝 Cross-surface coordination happening...`);
+        // IDE assigns a fix agent
+        await this.simulateFixAgent(newIssue);
+        // Board updates issue status
+        await this.boardAgent.handleCrossSurfaceEvent('agent_assigned', {
+            issue: newIssue.id,
+            agent: 'cli-speed-agent-123',
+            estimatedTime: 15
+        });
+        // 6. Learning and optimization
+        console.log(`\n🧠 Cross-surface learning...`);
+        await this.ideAgent.learnFromIDEUsage('issue_auto_assigned', ideContext);
+        await this.boardAgent.learnFromBoardUsage('issue_prioritized', boardContext);
+        console.log(`\n✅ Coordination complete! Issue moving through automated pipeline.`);
+    }
+    /**
+     * Simulate an RL agent working on the fix
+     */
+    async simulateFixAgent(issue) {
+        console.log(`\n[cli-speed-agent] Working on: ${issue.title}`);
+        console.log(`[cli-speed-agent] Analyzing startup performance...`);
+        console.log(`[cli-speed-agent] Found: Unnecessary import loading`);
+        console.log(`[cli-speed-agent] Applying fix: Lazy import optimization`);
+        console.log(`[cli-speed-agent] Testing: New startup time 180ms ✅`);
+        console.log(`[cli-speed-agent] Creating PR...`);
+        // Notify board agent of completion
+        await this.boardAgent.handleCrossSurfaceEvent('fix_completed', {
+            issue: issue.id,
+            agent: 'cli-speed-agent-123',
+            improvement: '65% faster startup',
+            prUrl: 'https://github.com/user/repo/pull/123'
+        });
+    }
+    /**
+     * Example of learning insights being shared across surfaces
+     */
+    async demonstrateCrossSurfaceLearning() {
+        console.log('\n🎓 Cross-surface Learning Example');
+        console.log('=================================');
+        const learningInsights = [
+            {
+                pattern: 'performance_issues_auto_fixable',
+                surfaces: ['board', 'ide'],
+                optimization: '+80% performance issues resolved automatically',
+                userImpact: '+25% developer velocity',
+                confidence: 0.9
+            },
+            {
+                pattern: 'issue_priority_correlation',
+                surfaces: ['board', 'ide'],
+                optimization: 'High priority issues fixed 3x faster',
+                userImpact: '+30% customer satisfaction',
+                confidence: 0.85
+            },
+            {
+                pattern: 'cross_surface_handoff_timing',
+                surfaces: ['board', 'ide'],
+                optimization: 'Optimal handoff: <2min from issue creation',
+                userImpact: '+15% issue resolution speed',
+                confidence: 0.78
+            }
+        ];
+        for (const insight of learningInsights) {
+            console.log(`\n📊 Learning Insight: ${insight.pattern}`);
+            console.log(`   Optimization: ${insight.optimization}`);
+            console.log(`   User Impact: ${insight.userImpact}`);
+            console.log(`   Confidence: ${(insight.confidence * 100).toFixed(0)}%`);
+            console.log(`   Surfaces: ${insight.surfaces.join(', ')}`);
+        }
+        console.log(`\n🚀 Result: Each surface gets smarter at its domain AND coordination`);
+    }
+}
+/**
+ * Run the example
+ */
+export async function runSurfaceCoordinationDemo() {
+    const example = new SurfaceCoordinationExample();
+    await example.demonstrateCoordination();
+    await example.demonstrateCrossSurfaceLearning();
+    console.log(`\n🎯 Key Benefits of Surface Agent Architecture:`);
+    console.log(`• Specialized intelligence per product surface`);
+    console.log(`• Distributed learning and optimization`);
+    console.log(`• Cross-surface coordination via Subway mesh`);
+    console.log(`• Each agent owns and evolves its domain`);
+    console.log(`• Scalable to new surfaces (Notes, Flow, etc.)`);
+}
+//# sourceMappingURL=surface-coordination-example.js.map

package/dist/lib/surface-coordination-example.js.map

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

package/dist/lib/telemetry/physical-world-collector.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @purpose Physical-World Data Engine — System telemetry collection
+ * Captures hardware, system, and workflow context that web UIs can't access
+ */
+import type { TelemetryEvent } from '../../types/telemetry.js';
+export declare class PhysicalWorldCollector {
+    private startTime;
+    collect(baseEvent: Partial<TelemetryEvent>): Promise<Partial<TelemetryEvent>>;
+    private collectSystemMetrics;
+    private collectWorkflowMetrics;
+    private collectNetworkMetrics;
+    private extractVmStatValue;
+}
+export declare const physicalWorldCollector: PhysicalWorldCollector;
+//# sourceMappingURL=physical-world-collector.d.ts.map

package/dist/lib/telemetry/physical-world-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"physical-world-collector.d.ts","sourceRoot":"","sources":["../../../src/lib/telemetry/physical-world-collector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AA4B9D,qBAAa,sBAAsB;IACjC,OAAO,CAAC,SAAS,CAAa;IAExB,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YAcrE,oBAAoB;YA0EpB,sBAAsB;YAgDtB,qBAAqB;IAoCnC,OAAO,CAAC,kBAAkB;CAK3B;AAGD,eAAO,MAAM,sBAAsB,wBAA+B,CAAA"}

package/dist/lib/telemetry/physical-world-collector.js

@@ -0,0 +1,177 @@
+/**
+ * @purpose Physical-World Data Engine — System telemetry collection
+ * Captures hardware, system, and workflow context that web UIs can't access
+ */
+import { execSync } from 'child_process';
+import { existsSync } from 'fs';
+export class PhysicalWorldCollector {
+    startTime = Date.now();
+    async collect(baseEvent) {
+        const systemMetrics = await this.collectSystemMetrics();
+        const workflowMetrics = await this.collectWorkflowMetrics();
+        const networkMetrics = await this.collectNetworkMetrics();
+        return {
+            ...baseEvent,
+            ...systemMetrics,
+            ...workflowMetrics,
+            ...networkMetrics,
+            session_uptime_s: Math.floor((Date.now() - this.startTime) / 1000)
+        };
+    }
+    async collectSystemMetrics() {
+        const metrics = {};
+        try {
+            // CPU usage (macOS)
+            if (process.platform === 'darwin') {
+                const cpuUsage = execSync("top -l 1 | grep 'CPU usage:' | awk '{print $3}' | sed 's/%//'", {
+                    encoding: 'utf-8', timeout: 3000
+                }).trim();
+                if (cpuUsage)
+                    metrics.cpu_usage_percent = parseFloat(cpuUsage);
+                // Memory stats
+                const vmStat = execSync('vm_stat', { encoding: 'utf-8', timeout: 3000 });
+                const freePages = this.extractVmStatValue(vmStat, 'Pages free:');
+                const activePages = this.extractVmStatValue(vmStat, 'Pages active:');
+                const inactivePages = this.extractVmStatValue(vmStat, 'Pages inactive:');
+                const wiredPages = this.extractVmStatValue(vmStat, 'Pages wired down:');
+                if (freePages && activePages && inactivePages && wiredPages) {
+                    const totalPages = freePages + activePages + inactivePages + wiredPages;
+                    const pageSize = 4096; // 4KB pages on macOS
+                    metrics.memory_available_mb = Math.round((freePages * pageSize) / (1024 * 1024));
+                    metrics.memory_usage_mb = Math.round(((totalPages - freePages) * pageSize) / (1024 * 1024));
+                }
+                // System load
+                const uptime = execSync('uptime', { encoding: 'utf-8', timeout: 3000 });
+                const loadMatch = uptime.match(/load averages?:\s*([0-9.]+)/);
+                if (loadMatch)
+                    metrics.system_load_1m = parseFloat(loadMatch[1]);
+                // Disk space
+                const diskInfo = execSync("df -h / | tail -1 | awk '{print $4}'", {
+                    encoding: 'utf-8', timeout: 3000
+                }).trim();
+                if (diskInfo) {
+                    const sizeMatch = diskInfo.match(/([0-9.]+)([KMGT])i?/);
+                    if (sizeMatch) {
+                        const [, size, unit] = sizeMatch;
+                        const multiplier = { K: 0.001, M: 1 / 1024, G: 1, T: 1024 }[unit] || 1;
+                        metrics.disk_free_gb = Math.round(parseFloat(size) * multiplier * 10) / 10;
+                    }
+                }
+                // Battery info
+                try {
+                    const batteryInfo = execSync('pmset -g batt', { encoding: 'utf-8', timeout: 3000 });
+                    if (batteryInfo.includes('Battery')) {
+                        const pctMatch = batteryInfo.match(/([0-9]+)%/);
+                        if (pctMatch)
+                            metrics.battery_level = parseInt(pctMatch[1]);
+                        metrics.battery_charging = batteryInfo.includes('charging');
+                    }
+                }
+                catch {
+                    // No battery (desktop)
+                }
+                // Thermal state (basic heuristic based on CPU usage and system load)
+                const cpuPct = metrics.cpu_usage_percent || 0;
+                const load = metrics.system_load_1m || 0;
+                if (cpuPct > 80 || load > 3.0) {
+                    metrics.thermal_state = 'hot';
+                }
+                else if (cpuPct > 60 || load > 2.0) {
+                    metrics.thermal_state = 'warm';
+                }
+                else {
+                    metrics.thermal_state = 'nominal';
+                }
+            }
+        }
+        catch (error) {
+            // Fail silently - telemetry shouldn't break functionality
+        }
+        return metrics;
+    }
+    async collectWorkflowMetrics() {
+        const metrics = {};
+        try {
+            // Git information
+            if (existsSync('.git')) {
+                try {
+                    metrics.git_branch = execSync('git branch --show-current', {
+                        encoding: 'utf-8', timeout: 2000
+                    }).trim();
+                    const gitStatus = execSync('git status --porcelain', {
+                        encoding: 'utf-8', timeout: 2000
+                    });
+                    metrics.git_dirty_files = gitStatus.split('\n').filter(line => line.trim()).length;
+                }
+                catch {
+                    // Not in a git repo or git not available
+                }
+            }
+            // Tmux sessions (indicator of terminal workflows)
+            try {
+                const tmuxSessions = execSync('tmux list-sessions 2>/dev/null || echo ""', {
+                    encoding: 'utf-8', timeout: 2000
+                });
+                metrics.concurrent_terminals = tmuxSessions.split('\n').filter(line => line.trim()).length;
+            }
+            catch {
+                metrics.concurrent_terminals = 1; // Default single terminal
+            }
+            // Current workspace path
+            metrics.workspace_path = process.cwd();
+            // Detect IDE (basic heuristics)
+            const processes = execSync('ps aux | grep -E "(code|cursor|nvim|vim|emacs)" | grep -v grep | wc -l', {
+                encoding: 'utf-8', timeout: 2000
+            }).trim();
+            if (parseInt(processes) > 0) {
+                // Could be enhanced to detect specific IDE
+                metrics.active_ide = 'detected';
+            }
+        }
+        catch (error) {
+            // Fail silently
+        }
+        return metrics;
+    }
+    async collectNetworkMetrics() {
+        const metrics = {};
+        try {
+            // Network latency test
+            const pingResult = execSync('ping -c 1 -W 2000 8.8.8.8 | grep "time=" | awk -F"time=" \'{print $2}\' | awk \'{print $1}\'', {
+                encoding: 'utf-8', timeout: 5000
+            }).trim();
+            if (pingResult) {
+                metrics.network_latency_ms = Math.round(parseFloat(pingResult));
+                metrics.internet_connectivity = true;
+            }
+        }
+        catch {
+            metrics.internet_connectivity = false;
+        }
+        try {
+            // Active localhost ports (development servers)
+            const portsOutput = execSync("lsof -i :3000-9000 -sTCP:LISTEN 2>/dev/null | awk 'NR>1 {print $9}' | cut -d: -f2 | sort -n", {
+                encoding: 'utf-8', timeout: 3000
+            });
+            const ports = portsOutput.split('\n')
+                .filter(line => line.trim())
+                .map(port => parseInt(port))
+                .filter(port => !isNaN(port));
+            if (ports.length > 0) {
+                metrics.localhost_ports_active = ports;
+            }
+        }
+        catch {
+            // Command failed - no ports or lsof not available
+        }
+        return metrics;
+    }
+    extractVmStatValue(vmStat, label) {
+        const regex = new RegExp(`${label.replace(':', '\\:')}\\s+(\\d+)\\.?`);
+        const match = vmStat.match(regex);
+        return match ? parseInt(match[1]) : null;
+    }
+}
+// Singleton instance
+export const physicalWorldCollector = new PhysicalWorldCollector();
+//# sourceMappingURL=physical-world-collector.js.map

package/dist/lib/telemetry/physical-world-collector.js.map

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

package/dist/lib/telemetry/training-bridge.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @purpose Bridge between physical-world telemetry and RL training pipeline
+ * Converts telemetry events into training data for RL agents
+ */
+import type { TelemetryEvent } from '../../types/telemetry.js';
+interface TrainingTuple {
+    agent: string;
+    state: PhysicalWorldState;
+    action: string;
+    reward: number;
+    next_state: PhysicalWorldState;
+    terminal: boolean;
+    timestamp: string;
+}
+interface PhysicalWorldState {
+    cpu_usage_percent: number;
+    memory_usage_mb: number;
+    thermal_state: 'nominal' | 'warm' | 'hot' | 'critical';
+    system_load_1m: number;
+    git_dirty_files: number;
+    concurrent_terminals: number;
+    active_ide: boolean;
+    avg_command_duration_ms: number;
+    recent_build_time_ms?: number;
+    recent_test_time_ms?: number;
+}
+export declare class PhysicalWorldTrainingBridge {
+    private stateHistory;
+    private readonly STATE_WINDOW_SIZE;
+    /**
+     * Convert telemetry events into RL training tuples
+     */
+    processEventForTraining(event: TelemetryEvent, agentName: string, action: string): TrainingTuple | null;
+    private extractPhysicalWorldState;
+    private calculatePhysicalWorldReward;
+    private getThermalScore;
+    private isTerminalState;
+    private updateStateHistory;
+    /**
+     * Export training data for RL pipeline
+     */
+    exportTrainingData(): TrainingTuple[];
+    /**
+     * Get physical-world state summary for current system
+     */
+    getCurrentPhysicalWorldSummary(): Partial<PhysicalWorldState>;
+    private average;
+}
+export declare const physicalWorldTrainingBridge: PhysicalWorldTrainingBridge;
+export {};
+//# sourceMappingURL=training-bridge.d.ts.map

package/dist/lib/telemetry/training-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"training-bridge.d.ts","sourceRoot":"","sources":["../../../src/lib/telemetry/training-bridge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAE9D,UAAU,aAAa;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,kBAAkB,CAAA;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,kBAAkB,CAAA;IAC9B,QAAQ,EAAE,OAAO,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,UAAU,kBAAkB;IAE1B,iBAAiB,EAAE,MAAM,CAAA;IACzB,eAAe,EAAE,MAAM,CAAA;IACvB,aAAa,EAAE,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,CAAA;IACtD,cAAc,EAAE,MAAM,CAAA;IAGtB,eAAe,EAAE,MAAM,CAAA;IACvB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,UAAU,EAAE,OAAO,CAAA;IAGnB,uBAAuB,EAAE,MAAM,CAAA;IAC/B,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAC7B;AAQD,qBAAa,2BAA2B;IACtC,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAK;IAEvC;;OAEG;IACH,uBAAuB,CACrB,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,aAAa,GAAG,IAAI;IA6BvB,OAAO,CAAC,yBAAyB;IAoBjC,OAAO,CAAC,4BAA4B;IA+FpC,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,kBAAkB,IAAI,aAAa,EAAE;IAMrC;;OAEG;IACH,8BAA8B,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAY7D,OAAO,CAAC,OAAO;CAGhB;AAGD,eAAO,MAAM,2BAA2B,6BAAoC,CAAA"}