refresh-subsystem

Documents Guinea pig-safe modification of refresh and streaming subsystems for GUI Kubernetes applications.

411|21|Updated Dec 18, 2025
One-click install
npx skills add https://github.com/luxury-yacht/app --skill refresh-subsystem
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refresh-subsystem
Source: https://github.com/luxury-yacht/app/tree/main/.agents/skills/refresh-subsystem
Command: npx skills add https://github.com/luxury-yacht/app --skill refresh-subsystem

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers make safe, correct changes to a fragile Kubernetes refresh/streaming subsystem by documenting the full lifecycle, registration order, permission gating, and the most common breakpoints that cause cascading failures.

Core Features & Use Cases

  • End-to-end lifecycle guidance: Covers initialization sequencing, per-cluster runtime structure, and aggregate multiplexing wiring for the HTTP/API layer.
  • Domain registration guardrails: Explains fixed registration ordering, the different permission-gate kinds (direct/list/listWatch), and the two-layer permission checking model (preflight vs per-domain runtime checks).
  • Snapshot and stream parity requirements: Highlights how streamed row behavior must match snapshot construction via parity tests and shared domain contracts.
  • Stream transport and resume semantics: Documents SSE and WebSocket stream behaviors, including resume/cold-start fallbacks and single-cluster scope restrictions.

Quick Start

Use the refresh-subsystem skill to safely update refresh, streaming, or domain code by following the required initialization order and keeping backend domain registration, shared contracts, and frontend mappings synchronized.

Frequently Asked Questions about refresh-subsystem

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely modify Kubernetes streaming endpoints without breaking domain registration?

To safely modify Kubernetes streaming endpoints, follow the required initialization order, enforce single-cluster scope, and keep backend domain registration synchronized with shared contracts and frontend mappings to prevent data flow regressions.

What is the correct initialization order for per-cluster refresh runtimes in a Kubernetes UI?

The correct initialization order for per-cluster refresh runtimes involves strict sequencing of domain registration, permission gates, and aggregate multiplexing wiring to ensure snapshot building and SSE/WebSocket streaming endpoints function correctly.

How do permission gates work with direct, list, and listWatch checks in Kubernetes refresh subsystems?

Permission gates in Kubernetes refresh subsystems use a two-layer checking model: preflight checks validate access upfront, while per-domain runtime checks enforce direct, list, and listWatch permission kinds during streaming and snapshot operations.

Why do streamed rows mismatch snapshot data after updating SSE or WebSocket endpoints?

Streamed rows mismatch snapshot data when backend and frontend contracts fall out of sync. Maintaining snapshot and stream parity requires shared domain contracts and parity tests to ensure row behavior matches snapshot construction.

Can I use SSE and WebSocket streaming interchangeably for Kubernetes UI resume semantics?

SSE and WebSocket streaming both support resume and cold-start fallbacks in Kubernetes UIs, but they require strict single-cluster scope enforcement and correct orchestration order to maintain snapshot and stream parity during refresh operations.

What causes cascading failures when changing Kubernetes GUI refresh subsystems?

Cascading failures occur when the fixed domain registration ordering is violated, permission gating is misconfigured, or backend/frontend contracts desynchronize, breaking the fragile orchestration order required for per-cluster refresh runtimes.