Update Project

Author: weyderfs

.github/agents/flet-ui.agent.md

@@ -0,0 +1,39 @@
+---
+description: "Flet UI specialist. Use when: building Flet views, fixing Flet controls, navigation/routing, theming, layout issues, ft.Icon usage, ft.Page lifecycle, Flet desktop packaging with flet build."
+tools: [read, edit, search, execute]
+---
+You are a Flet UI engineer building desktop applications with **Flet** (Flutter renderer for Python). Your job is to create, fix, and improve Flet views and controls following project conventions.
+
+## Knowledge
+
+- **Flet ≥ 0.80**: Use `ft.run(main)` — `ft.app()` is deprecated.
+- `ft.Icon` takes the icon as the **first positional argument**: `ft.Icon(ft.Icons.HOME)`, never `ft.Icon(name=...)`.
+- Views extend `ft.Column` or `ft.Container` and receive `page: ft.Page` in `__init__`.
+- Navigation index → view mapping lives in `app.py`; views do not contain routing logic.
+- `page.update()` must be called after mutating controls for changes to render.
+- Theme: use `ft.Theme(color_scheme_seed=...)` and `ft.ThemeMode.DARK` / `LIGHT`.
+- Icons: reference via `ft.Icons.CONSTANT_NAME` (e.g., `ft.Icons.CLOUD`, `ft.Icons.SETTINGS`).
+- Colors: reference via `ft.Colors.CONSTANT_NAME` (e.g., `ft.Colors.BLUE_200`).
+- Packaging: `flet build <target> --yes src/` for desktop binaries.
+
+## Constraints
+
+- DO NOT use `ft.app()` — it is deprecated. Always use `ft.run()`.
+- DO NOT use `name=` keyword for `ft.Icon` — pass the icon as the first positional arg.
+- DO NOT import `kubernetes` or business logic directly in UI files — UI only talks to `core/`.
+- DO NOT embed routing logic inside individual views.
+- ONLY create views under `src/kubeidea/ui/views/`.
+
+## Approach
+
+1. Read the existing view and `app.py` to understand current navigation wiring.
+2. Create or modify Flet controls using the correct API for the installed Flet version.
+3. Verify the control hierarchy: `page` → `Row` → `NavigationRail` + content area.
+4. Run the app with `poetry run flet run src/kubeidea/app.py` to verify visually if possible.
+5. Report what was changed and any layout considerations.
+
+## Output Format
+
+- Code changes applied directly to files.
+- Brief description of the visual result the user should expect.
+- If a new view is created, confirm it was wired into the navigation index in `app.py`.

.github/agents/python-poetry.agent.md

@@ -0,0 +1,35 @@
+---
+description: "Python + Poetry specialist. Use when: writing Python modules, fixing imports, managing pyproject.toml dependencies, running pytest, configuring ruff/mypy, debugging Poetry virtualenvs, creating type-annotated code."
+tools: [read, edit, search, execute]
+---
+You are a senior Python engineer specializing in modern Python (≥ 3.11) projects managed with **Poetry**. Your job is to write, review, and fix Python code following strict quality standards.
+
+## Knowledge
+
+- Python 3.11+ features: `match`, `StrEnum`, `ExceptionGroup`, `type` aliases, `Self`, `override`.
+- Poetry workflows: `poetry add`, `poetry lock`, `poetry install`, `poetry run`, groups, extras.
+- `pyproject.toml` configuration for ruff, mypy, pytest, and build systems.
+- Type annotations: use `mypy --strict` conventions — `disallow_untyped_defs`, generic collections (`list[str]` not `List[str]`), `from __future__ import annotations` when needed.
+- Testing with `pytest` and `pytest-asyncio`; fixtures, parametrize, coverage.
+
+## Constraints
+
+- DO NOT edit `poetry.lock` manually — always use `poetry add` / `poetry lock`.
+- DO NOT use deprecated typing imports (`typing.List`, `typing.Dict`, `typing.Optional`) — use built-in generics and `X | None`.
+- DO NOT disable ruff or mypy rules without an inline comment explaining why.
+- DO NOT add dependencies without confirming they are needed for the current task.
+- ONLY write code that passes `ruff check` and `mypy --strict`.
+
+## Approach
+
+1. Read the relevant source files and understand the existing patterns.
+2. Write or fix code with full type annotations and idiomatic Python.
+3. Run `poetry run ruff check` and `poetry run mypy` to validate changes.
+4. Run `poetry run pytest` if tests are affected.
+5. Report what changed and any remaining warnings.
+
+## Output Format
+
+- Code changes applied directly to files.
+- After edits, run linter/type-checker and report results.
+- If a dependency change is needed, show the `poetry add` command and ask before running.

.github/copilot-instructions.md

@@ -0,0 +1,50 @@
+# Kube-IDEA — Copilot Instructions
+
+## Stack
+
+- **Language**: Python ≥ 3.11 with full type annotations (`mypy --strict`).
+- **UI**: [Flet](https://flet.dev) (Flutter renderer). Use `ft.run()` — `ft.app()` is deprecated since 0.80.
+- **Dependencies**: managed with Poetry (`pyproject.toml` + `poetry.lock`). Do not edit `poetry.lock` manually.
+- **Linter / formatter**: `ruff` (rules E, F, I, N, W, UP). Never disable rules without a comment explaining why.
+- **Testing**: `pytest` under `tests/`. Async tests use `pytest-asyncio`. Target coverage ≥ 80 %.
+
+## Project layout
+
+```
+src/kubeidea/
+  app.py          # Flet bootstrap — ft.run(main)
+  ui/             # All Flet views and navigation
+  core/           # AppContext, business logic, use-cases
+  kube/           # kubernetes-python API wrappers
+  metrics/        # metrics-server / Prometheus adapters
+  plugins/        # Plugin host and entry-point discovery
+  security/       # RBAC inspector, SubjectAccessReview
+  config/         # Settings persistence
+  utils/          # Logging, telemetry helpers
+tests/            # Mirrors src/kubeidea/ structure
+```
+
+See [docs/architecture.md](docs/architecture.md) for component boundaries.
+
+## Coding conventions
+
+- Views extend `ft.Column` or `ft.Container`; receive `page: ft.Page` in `__init__`.
+- Navigation index → view mapping lives in `app.py`; do not embed routing logic inside views.
+- `ft.Icon` takes the icon **as the first positional argument**, not `name=`.
+- All Kubernetes calls go through `kube/client.py` — never import `kubernetes` directly in UI code.
+- Secrets are never stored to disk; use the OS keyring (`keyring` lib) where persistence is required.
+- Telemetry is opt-in only; never collect data unless the user has explicitly enabled it in settings.
+
+## CI / build
+
+- `poetry run pytest` — must pass before any PR merge.
+- `poetry run ruff check src/ tests/` — zero warnings.
+- `poetry run mypy src/kubeidea/` — zero errors.
+- Desktop binaries are built with `flet build <target>` via the release workflow on `v*` tags.
+- Docs are deployed to `gh-pages` branch with `mkdocs gh-deploy --force`.
+
+## Security (DevSecOps)
+
+- All cluster actions must respect the user's RBAC via `SubjectAccessReview` — see `security/rbac.py`.
+- Never log kubeconfig tokens, credentials, or secret values.
+- Dependencies must stay pinned in `poetry.lock`; raise a PR to update them explicitly.

README.md

@@ -2,6 +2,11 @@
 
 [![CI](https://github.com/Ops-Talks/kubeidea/actions/workflows/ci.yml/badge.svg)](https://github.com/Ops-Talks/kubeidea/actions/workflows/ci.yml)
 [![Docs](https://github.com/Ops-Talks/kubeidea/actions/workflows/docs.yml/badge.svg)](https://ops-talks.github.io/kubeidea/)
+[![Release](https://github.com/Ops-Talks/kubeidea/actions/workflows/release.yml/badge.svg)](https://github.com/Ops-Talks/kubeidea/actions/workflows/release.yml)
+[![Python](https://img.shields.io/badge/python-%3E%3D3.11-blue?logo=python&logoColor=white)](https://www.python.org/)
+[![Flet](https://img.shields.io/badge/flet-UI-purple?logo=flutter&logoColor=white)](https://flet.dev)
+[![License](https://img.shields.io/github/license/Ops-Talks/kubeidea)](LICENSE)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
 
 > **Kubernetes desktop IDE built with Python (Flet + Poetry).**
 

src/kubeidea/app.py

@@ -5,6 +5,7 @@
 from kubeidea.ui.navigation import build_navigation
 from kubeidea.ui.theme import apply_theme
 from kubeidea.ui.views.home import HomeView
+from kubeidea.ui.views.placeholder import PlaceholderView
 
 
 def main(page: ft.Page) -> None:
@@ -15,16 +16,33 @@ def main(page: ft.Page) -> None:
 
     apply_theme(page)
 
-    navigation = build_navigation(page)
-    home_view = HomeView(page)
+    views: list[ft.Control] = [
+        HomeView(page),
+        PlaceholderView("Clusters", ft.Icons.CLOUD),
+        PlaceholderView("Logs", ft.Icons.TERMINAL),
+        PlaceholderView("Metrics", ft.Icons.MONITOR_HEART),
+        PlaceholderView("YAML Editor", ft.Icons.CODE),
+        PlaceholderView("RBAC Inspector", ft.Icons.SECURITY),
+        PlaceholderView("Plugins", ft.Icons.EXTENSION),
+        PlaceholderView("Settings", ft.Icons.SETTINGS),
+    ]
+
+    content_area = ft.Column(controls=[views[0]], expand=True)
+
+    def on_nav_change(index: int) -> None:
+        content_area.controls.clear()
+        content_area.controls.append(views[index])
+        page.update()
+
+    navigation = build_navigation(page, on_nav_change)
 
     page.add(
         ft.Row(
-            controls=[navigation, home_view],
+            controls=[navigation, content_area],
             expand=True,
         )
     )
 
 
 if __name__ == "__main__":
-    ft.app(target=main)
+    ft.run(main)

src/kubeidea/ui/navigation.py

@@ -2,24 +2,25 @@
 
 from __future__ import annotations
 
+from collections.abc import Callable
 from typing import Any
 
 import flet as ft
 
 
-def build_navigation(page: ft.Page) -> ft.NavigationRail:
+def build_navigation(page: ft.Page, on_change: Callable[[int], None]) -> ft.NavigationRail:
     """Build the main navigation rail.
 
     Args:
         page: The Flet page instance.
+        on_change: Callback invoked with the selected destination index.
 
     Returns:
         A configured NavigationRail control.
     """
 
     def _on_destination_change(e: Any) -> None:
-        _ = e
-        page.update()
+        on_change(e.control.selected_index)
 
     rail = ft.NavigationRail(
         selected_index=0,

src/kubeidea/ui/views/placeholder.py

@@ -0,0 +1,19 @@
+"""Generic placeholder view for sections not yet implemented."""
+
+import flet as ft
+
+
+class PlaceholderView(ft.Column):
+    """Temporary placeholder shown for features under development."""
+
+    def __init__(self, section: str, icon: str) -> None:
+        super().__init__(
+            expand=True,
+            alignment=ft.MainAxisAlignment.CENTER,
+            horizontal_alignment=ft.CrossAxisAlignment.CENTER,
+            controls=[
+                ft.Icon(icon, size=64, color=ft.Colors.BLUE_200),
+                ft.Text(section, size=22, weight=ft.FontWeight.BOLD),
+                ft.Text("This section is under development.", size=13, color=ft.Colors.GREY_500),
+            ],
+        )

src/main.py

@@ -4,4 +4,4 @@
 
 from kubeidea.app import main
 
-ft.app(target=main)
+ft.run(main)