device control surface

app.py

@@ -1,3 +1,9 @@
+
+
+
+
+
+
 #!/usr/bin/env python3
 """
 WSGI entry point for Linux Kernel Visualization Backend.

index.html

@@ -94,7 +94,7 @@ <h2>Linux Kernel Ring 0 Visualization</h2>
     <script src="/static/js/right-semicircle-menu.js?v=48"></script>
     <script src="/static/js/kernel-dna.js?v=31"></script>
     <script src="/static/js/network-stack.js?v=6"></script>
-    <script src="/static/js/devices-belt.js?v=14"></script>
+    <script src="/static/js/devices-belt.js?v=23"></script>
     <script src="/static/js/crypto-belt.js?v=50"></script>
     <script src="/static/js/security-belt.js?v=13"></script>
     <script src="/static/js/filesystem-map.js?v=10"></script>

kernel_ai/api/rest.py

@@ -1,3 +1,4 @@
+"""REST API under ``/api``."""
 from flask import Blueprint
 from kernel_ai.http import api as h
 

kernel_ai/collectors/proc_fs.py

@@ -1,3 +1,10 @@
+"""
+Filesystem collectors for kernel introspection.
+
+Tests should patch functions in ``kernel_ai.collectors.proc_fs`` (or this module's
+attributes) rather than the whole webapp.
+"""
+
 from __future__ import annotations
 
 

kernel_ai/hooks.py

@@ -1,3 +1,5 @@
+"""Global Flask hooks (CORS, cache headers, request id)."""
+
 import logging
 import time
 from uuid import uuid4

kernel_ai/http/__init__.py

@@ -1,3 +1,5 @@
+"""HTTP route registration."""
+
 from kernel_ai.http.register import register_http_routes
 
 __all__ = ["register_http_routes"]

kernel_ai/services/core_observability.py

@@ -1,3 +1,5 @@
+"""Core observability helpers extracted from webapp."""
+
 from __future__ import annotations
 
 import logging

kernel_ai/services/execution.py

@@ -1,3 +1,5 @@
+"""Execution context and kernel DNA services."""
+
 from __future__ import annotations
 
 import os

kernel_ai/services/infra_utils.py

@@ -1,3 +1,5 @@
+"""Shared infrastructure utilities."""
+
 from __future__ import annotations
 
 import os

kernel_ai/services/kernel_maps.py

@@ -1,3 +1,5 @@
+"""Kernel syscall maps and subsystem mapping helpers."""
+
 from __future__ import annotations
 
 

kernel_ai/services/syscalls.py

@@ -1,3 +1,5 @@
+"""Syscall and kernel telemetry helpers."""
+
 from __future__ import annotations
 
 import os

kernel_ai/views/__init__.py

@@ -1,3 +1,5 @@
+"""HTML and public page blueprints."""
+
 from kernel_ai.views.pages import bp as pages_bp
 
 __all__ = ["pages_bp"]

kernel_ai/views/pages.py

@@ -1,3 +1,4 @@
+"""Site pages: index, subsystem HTML, and health."""
 from flask import Blueprint
 from kernel_ai.http import pages as h
 

static/js/active-connections.js

@@ -1,6 +1,7 @@
+// Module for working with active network connections
 class ActiveConnectionsManager {
     constructor() {
         debugLog("ActiveConnectionsManager: constructor called");
         this.currentConnections = [];
         this.updateInterval = null;
         this.updateCallback = null;
@@ -11,14 +12,14 @@
     // Update active connections data
     async updateConnectionsTable() {
         try {
             debugLog("ActiveConnectionsManager: updateConnectionsTable called");
             const response = await fetch('/api/active-connections');
             const data = await response.json();
 
             debugLog("API response:", data);
 
             if (data.connections) {
                 debugLog("Total connections:", data.connections.length);
 
                 // Filter out local connections (127.0.0.1, 0.0.0.0)
                 const filteredConnections = data.connections.filter(conn => {
@@ -31,8 +32,8 @@
 
                 this.currentConnections = filteredConnections;
 
                 debugLog("Filtered connections:", this.currentConnections.length);
                 debugLog("Filtered out:", data.connections.length - this.currentConnections.length, "local connections");
 
                 this.renderConnectionsTable();
 
@@ -43,7 +44,7 @@
             }
         } catch (error) {
             console.error('Error getting active connections:', error);
             debugLog('Using fallback data...');
             this.useFallbackData();
         }
     }
@@ -66,11 +67,11 @@
     renderConnectionsTable() {
         // Do not render connections if Kernel Matrix View is active
         if (window.kernelContextMenu && window.kernelContextMenu.currentView === 'matrix') {
             debugLog('⏸️ Skipping active connections render - Matrix View is active');
             return;
         }
 
         const svg = d3.select('svg');
 
         // Clear old elements
         svg.selectAll('.connection-row, .connection-box, .connection-text, .connection-details, .connection-header').remove();
@@ -148,7 +149,7 @@
         const normalizedProtocol = String(protocol || "").toUpperCase();
         const normalizedState = String(stateCode).toUpperCase();
         if (normalizedProtocol.includes("UDP")) return "DATAGRAM";
         return tcpStates[normalizedState] || normalizedState;
     }
 
     buildSocketTooltipHtml(connection) {
@@ -215,7 +216,7 @@
     attachSocketTooltipHandlers(selection, connection) {
         selection
             .on("mouseover", (event) => {
                 d3.selectAll(".socket-tooltip").remove();
                 const tooltip = d3.select("body")
                     .append("div")
                     .attr("class", "tooltip socket-tooltip")