feat(metrics): enhance resource usage metrics for pods and nodes

- Introduced new functions to calculate total resource usage for pods by summing container metrics.
- Added support for resource ratios (cpu_ratio, memory_ratio) in ResourceUsage.
- Updated object_summary to include resource ratios based on requests and allocatable resources.
- Implemented quantity_as_f64 to handle Kubernetes resource suffixes.
- Added tests for pod usage calculations and resource ratio functionality.
- Added relevant keywords to the Aetheris desktop entry and metainfo XML for improved discoverability.
- Included multiple screenshots showcasing different features of the Aetheris application.

Author: leandromqrs

CONTRIBUTING.md

@@ -39,6 +39,17 @@ Use `cargo check -p aetheris-app` or `cargo check -p aetheris-kube` while iterat
 
 For documentation-only changes, a full Rust test run is usually not necessary. For workflow or Flatpak manifest changes, validate the affected file format and inspect shell scripts carefully.
 
+## AI-Assisted Contributions
+
+Contributions made with AI assistance are welcome, but the contributor remains
+responsible for the change. Do not submit code you do not understand. You must
+be able to explain what the code does, why it is correct, and what tradeoffs or
+risks it introduces.
+
+AI-assisted changes must be tested thoroughly. Maintainers may ask for evidence
+that the functionality works and was tested, such as test output, screenshots,
+screen recordings, logs, or clear reproduction steps.
+
 ## Project Architecture
 
 Aetheris has two Rust crates:

README.md

@@ -35,16 +35,17 @@ scale, cordon, drain, and port forwarding.
 
 ## Screenshots
 
-> Aetheris is under active development. Screenshots land here as the UI settles —
-> drop them in `data/screenshots/` and swap the placeholders below.
+| Resource browser |
+| :---: |
+| <img src="data/screenshots/resources.png" alt="Aetheris resource browser" /> |
 
-| Cluster overview | Resource browser |
+| Cluster overview | Pod terminal |
 | :---: | :---: |
-| <!-- <img src="data/screenshots/overview.png" alt="Cluster overview" /> --> *coming soon* | <!-- <img src="data/screenshots/resources.png" alt="Resource browser" /> --> *coming soon* |
+| <img src="data/screenshots/overview.png" alt="Aetheris cluster overview" /> | <img src="data/screenshots/terminal.png" alt="Aetheris pod terminal" /> |
 
-| YAML editor | Logs & pod terminal |
+| YAML editor | Live logs |
 | :---: | :---: |
-| <!-- <img src="data/screenshots/yaml.png" alt="YAML editor" /> --> *coming soon* | <!-- <img src="data/screenshots/terminal.png" alt="Logs and pod terminal" /> --> *coming soon* |
+| <img src="data/screenshots/yaml.png" alt="Aetheris YAML editor" /> | <img src="data/screenshots/logs.png" alt="Aetheris live logs" /> |
 
 ## Documentation
 

crates/aetheris-app/src/app.rs

@@ -7,7 +7,7 @@ use std::{
 use aetheris_kube::{
     AddClusterRequest, ClusterSummary, ContainerUsage, ContextInfo, KubeManager, ObjectCondition,
     ObjectDetail, ObjectEvent, ObjectSummary, ObjectWatchEvent, PodExecEvent, PodExecRequest,
-    PodLogRequest, PodPortForwardEvent, PodPortForwardRequest, ResourceKind,
+    PodLogRequest, PodPortForwardEvent, PodPortForwardRequest, ResourceKind, ResourceUsage,
 };
 use futures::future::{AbortHandle, Abortable};
 use futures::FutureExt;
@@ -197,6 +197,77 @@ flowboxchild.filter-chip-child:selected:hover {
 .filter-chip-active:hover {
   background-color: alpha(@accent_color, 0.24);
 }
+
+/* Object tables: rounded card look, matching the old boxed-list style —
+ * card background for rows, a distinct shaded header, hairline row
+ * separators. The frame class goes on the enclosing ScrolledWindow so the
+ * rounded corners wrap header and rows together. */
+scrolledwindow.aetheris-table-frame {
+  background-color: @card_bg_color;
+  border: 1px solid alpha(currentColor, 0.1);
+  border-radius: 12px;
+}
+
+columnview.aetheris-table,
+columnview.aetheris-table > listview {
+  background: transparent;
+}
+
+/* GNOME-style header: dimmed label at rest (like .dim-label), and on
+ * hover a genuinely darker surface (@shade_color is Adwaita's translucent
+ * black shading color in both light and dark) with the label brightening
+ * to full strength. */
+columnview.aetheris-table > header > button {
+  background-color: alpha(currentColor, 0.05);
+  border-bottom: 1px solid alpha(currentColor, 0.1);
+  padding: 8px 10px;
+  font-weight: 700;
+  font-size: 1em;
+  color: alpha(@window_fg_color, 0.75);
+}
+
+columnview.aetheris-table > header > button:first-child {
+  border-top-left-radius: 11px;
+}
+
+columnview.aetheris-table > header > button:last-child {
+  border-top-right-radius: 11px;
+}
+
+columnview.aetheris-table > header > button:hover {
+  background-color: @shade_color;
+  color: @window_fg_color;
+}
+
+columnview.aetheris-table > header > button.sorted {
+  background-color: alpha(@accent_color, 0.15);
+  color: @accent_color;
+}
+
+columnview.aetheris-table > listview > row {
+  background: transparent;
+  border-bottom: 1px solid alpha(currentColor, 0.06);
+  padding: 2px 6px;
+}
+
+columnview.aetheris-table > listview > row:hover {
+  background-color: alpha(currentColor, 0.05);
+}
+
+/* CPU/Memory usage bars (same thresholds as Seabird): the LevelBar picks
+ * the class of the smallest offset >= its value — up to 85% "lb-normal",
+ * up to 95% "lb-warning", above that "lb-error". */
+levelbar block.lb-normal {
+  background-color: @view_fg_color;
+}
+
+levelbar block.lb-warning {
+  background-color: @warning_bg_color;
+}
+
+levelbar block.lb-error {
+  background-color: @destructive_bg_color;
+}
 "#;
 
 #[derive(Debug, Clone)]
@@ -212,10 +283,15 @@ pub struct App {
     namespaces: Vec<String>,
     resources: Vec<ResourceKind>,
     objects: Vec<ObjectSummary>,
-    /// Bumped on every `rebuild_object_list` call so a still-running
-    /// chunked render of a stale list can detect it's obsolete and stop
-    /// instead of appending rows after a newer rebuild already started.
-    object_list_generation: std::rc::Rc<std::cell::Cell<u64>>,
+    /// True while a coalesced object-list refresh is pending. Watch events
+    /// can arrive thousands at a time while a namespace spins up; rebuilding
+    /// the list per event would freeze the UI, so events only mark the list
+    /// dirty and a single deferred refresh repaints it.
+    object_list_refresh_scheduled: bool,
+    /// True while a coalesced projects.json save is pending. Dragging a
+    /// column border emits a width change per pixel; saving on each would
+    /// hammer the disk, so width changes only schedule one deferred save.
+    project_save_scheduled: bool,
     selected_context: Option<String>,
     selected_namespace: String,
     selected_resource_section: ResourceSection,
@@ -258,7 +334,16 @@ pub struct App {
     status_label: gtk::Label,
     spinner: gtk::Spinner,
     resource_list: gtk::ListBox,
-    object_list: gtk::ListBox,
+    /// Backing model for `object_view`. The `ColumnView` only realizes
+    /// widgets for on-screen rows, so this can hold tens of thousands of
+    /// objects without the widget tree growing with it.
+    object_store: gtk::gio::ListStore,
+    /// The store as the view displays it (header-click sort applied);
+    /// activation positions index into this model.
+    object_sorted: gtk::SortListModel,
+    object_columns: Vec<(ObjectTableColumn, gtk::ColumnViewColumn)>,
+    /// Switches between the object table and the "No objects" placeholder.
+    object_list_stack: gtk::Stack,
     detail_stack: gtk::Stack,
     detail_name_label: gtk::Label,
     detail_namespace_label: gtk::Label,
@@ -281,7 +366,12 @@ pub struct App {
     detail_yaml_buffer: sourceview5::Buffer,
     detail_events_list: gtk::ListBox,
     detail_conditions_list: gtk::ListBox,
-    detail_related_pods_list: gtk::ListBox,
+    detail_related_pods_store: gtk::gio::ListStore,
+    detail_related_pods_sorted: gtk::SortListModel,
+    /// Switches the detail "Pods" tab between the pods table and an
+    /// informational message (non-Deployment kinds, empty selector match).
+    detail_related_pods_stack: gtk::Stack,
+    detail_related_pods_message: adw::StatusPage,
     detail_log_container_dropdown: gtk::DropDown,
     detail_log_follow_check: gtk::CheckButton,
     detail_log_timestamps_check: gtk::CheckButton,
@@ -302,7 +392,6 @@ pub struct App {
     detail_log_target: Option<PodLogTarget>,
     detail_exec_target: Option<PodLogTarget>,
     detail_port_forward_target: Option<PodLogTarget>,
-    detail_related_pods: Vec<ObjectSummary>,
     detail_node_unschedulable: Option<bool>,
     object_watch_token: u64,
     object_watch_abort_handle: Option<AbortHandle>,
@@ -398,6 +487,8 @@ pub enum AppMsg {
     ObjectCreated(Result<String, String>),
     ObjectWatchEvent(u64, ObjectWatchEvent),
     ObjectWatchFinished(u64, Result<(), String>),
+    ObjectListRefreshTick,
+    ProjectSaveTick,
     ScaleDeployment,
     ObjectScaled(u64, Result<ObjectDetail, String>),
     ToggleNodeScheduling,

crates/aetheris-app/src/app/component.rs

@@ -227,9 +227,46 @@ impl Component for App {
         let resource_list = gtk::ListBox::new();
         resource_list.add_css_class("boxed-list");
         resource_list.set_selection_mode(gtk::SelectionMode::None);
-        let object_list = gtk::ListBox::new();
-        object_list.add_css_class("boxed-list");
-        object_list.set_selection_mode(gtk::SelectionMode::None);
+        let object_store = gtk::gio::ListStore::new::<gtk::glib::BoxedAnyObject>();
+        let object_view = gtk::ColumnView::builder()
+            .single_click_activate(true)
+            .reorderable(false)
+            .build();
+        object_view.add_css_class("aetheris-table");
+        object_view.set_vexpand(true);
+
+        let mut object_columns: Vec<(ObjectTableColumn, gtk::ColumnViewColumn)> = Vec::new();
+        let name_column = gtk::ColumnViewColumn::new(
+            Some("Name"),
+            Some(super::widgets::object_name_column_factory()),
+        );
+        name_column.set_resizable(true);
+        name_column.set_fixed_width(OBJECT_NAME_WIDTH);
+        object_view.append_column(&name_column);
+        object_columns.push((ObjectTableColumn::Name, name_column));
+        for column in ObjectColumn::ALL {
+            let view_column = gtk::ColumnViewColumn::new(
+                Some(column.label()),
+                Some(super::widgets::object_data_column_factory(column)),
+            );
+            view_column.set_resizable(true);
+            view_column.set_fixed_width(column.default_width());
+            view_column.set_sorter(super::widgets::object_column_sorter(column).as_ref());
+            object_view.append_column(&view_column);
+            object_columns.push((ObjectTableColumn::Data(column), view_column));
+        }
+        super::widgets::append_filler_column(&object_view);
+        // Header-click sorting reorders the view, not the store, so
+        // activation positions must be resolved against this sorted model.
+        let object_sorted =
+            gtk::SortListModel::new(Some(object_store.clone()), object_view.sorter());
+        object_view.set_model(Some(&gtk::NoSelection::new(Some(object_sorted.clone()))));
+        super::widgets::connect_sorted_header_highlight(&object_view);
+
+        let object_list_stack = gtk::Stack::builder()
+            .hhomogeneous(false)
+            .vhomogeneous(false)
+            .build();
         let detail_name_label = detail_value_label();
         let detail_namespace_label = detail_value_label();
         let detail_status_label = detail_value_label();
@@ -319,9 +356,18 @@ impl Component for App {
         let detail_conditions_list = gtk::ListBox::new();
         detail_conditions_list.add_css_class("boxed-list");
         detail_conditions_list.set_selection_mode(gtk::SelectionMode::None);
-        let detail_related_pods_list = gtk::ListBox::new();
-        detail_related_pods_list.add_css_class("boxed-list");
-        detail_related_pods_list.set_selection_mode(gtk::SelectionMode::None);
+        let (detail_related_pods_view, detail_related_pods_store, detail_related_pods_sorted) =
+            super::widgets::related_pods_column_view();
+        let detail_related_pods_stack = gtk::Stack::builder()
+            .hhomogeneous(false)
+            .vhomogeneous(false)
+            .build();
+        let detail_related_pods_message = adw::StatusPage::builder()
+            .title("Pods are shown for Deployments")
+            .description("Open a Deployment to inspect its related Pods.")
+            .icon_name("dialog-information-symbolic")
+            .build();
+        detail_related_pods_message.add_css_class("compact");
         let detail_log_container_dropdown = gtk::DropDown::from_strings(&["No containers"]);
         detail_log_container_dropdown.set_sensitive(false);
         let detail_log_follow_check = gtk::CheckButton::builder().label("Follow").build();
@@ -413,7 +459,9 @@ impl Component for App {
             yaml_error_label: &detail_yaml_error_label,
             events_list: &detail_events_list,
             conditions_list: &detail_conditions_list,
-            related_pods_list: &detail_related_pods_list,
+            related_pods_view: &detail_related_pods_view,
+            related_pods_stack: &detail_related_pods_stack,
+            related_pods_message: &detail_related_pods_message,
             log_container_dropdown: &detail_log_container_dropdown,
             log_follow_check: &detail_log_follow_check,
             log_timestamps_check: &detail_log_timestamps_check,
@@ -539,7 +587,8 @@ impl Component for App {
             content_stack: &content_stack,
             status_label: &status_label,
             spinner: &spinner,
-            object_list: &object_list,
+            object_view: &object_view,
+            object_list_stack: &object_list_stack,
             detail_page: &detail_page,
         });
         split_view.set_sidebar(Some(&sidebar));
@@ -687,14 +736,17 @@ impl Component for App {
             let sender = sender.clone();
             move |entry| sender.input(AppMsg::SearchChanged(entry.text().to_string()))
         });
-        object_list.connect_row_activated({
+        object_view.connect_activate({
             let sender = sender.clone();
-            move |_, row| {
-                if row.index() > 0 {
-                    sender.input(AppMsg::ObjectActivated(row.index() - 1));
-                }
-            }
+            move |_, position| sender.input(AppMsg::ObjectActivated(position as i32))
         });
+        for (table_column, view_column) in &object_columns {
+            super::widgets::connect_object_column_persistence(
+                view_column,
+                *table_column,
+                sender.clone(),
+            );
+        }
         create_yaml_button.connect_clicked({
             let sender = sender.clone();
             move |_| sender.input(AppMsg::ShowCreateYamlDialog)
@@ -703,9 +755,9 @@ impl Component for App {
             let sender = sender.clone();
             move |_| sender.input(AppMsg::CreateYaml)
         });
-        detail_related_pods_list.connect_row_activated({
+        detail_related_pods_view.connect_activate({
             let sender = sender.clone();
-            move |_, row| sender.input(AppMsg::RelatedPodActivated(row.index()))
+            move |_, position| sender.input(AppMsg::RelatedPodActivated(position as i32))
         });
         detail_back_button.connect_clicked({
             let sender = sender.clone();
@@ -802,7 +854,8 @@ impl Component for App {
             namespaces: vec![String::from("default")],
             resources: Vec::new(),
             objects: Vec::new(),
-            object_list_generation: std::rc::Rc::new(std::cell::Cell::new(0)),
+            object_list_refresh_scheduled: false,
+            project_save_scheduled: false,
             selected_context: None,
             selected_namespace: String::from("default"),
             selected_resource_section: ResourceSection::Workloads,
@@ -842,7 +895,10 @@ impl Component for App {
             status_label,
             spinner,
             resource_list,
-            object_list,
+            object_store,
+            object_sorted,
+            object_columns,
+            object_list_stack,
             detail_stack,
             detail_name_label,
             detail_namespace_label,
@@ -865,7 +921,10 @@ impl Component for App {
             detail_yaml_buffer,
             detail_events_list,
             detail_conditions_list,
-            detail_related_pods_list,
+            detail_related_pods_store,
+            detail_related_pods_sorted,
+            detail_related_pods_stack,
+            detail_related_pods_message,
             detail_log_container_dropdown,
             detail_log_follow_check,
             detail_log_timestamps_check,
@@ -886,7 +945,6 @@ impl Component for App {
             detail_log_target: None,
             detail_exec_target: None,
             detail_port_forward_target: None,
-            detail_related_pods: Vec::new(),
             detail_node_unschedulable: None,
             object_watch_token: 0,
             object_watch_abort_handle: None,