@goodandready/dsh-key-rotation 0.7.34 → 0.7.36

package/README.md

@@ -251,4 +251,19 @@ All management routes require loopback authentication (`127.0.0.1` / `::1`) with
 
 ## 📄 License
 
-MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
+MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
+
+### v0.7.36
+- **Architecture de-bloat & hardening**: Removed 6 unused/overengineered modules (`shadow`, `incident`, `agent-budget`, `region`, `canary`, `maintenance`) and dead route registrations.
+- **High-throughput buildRuntime memoization**: Eliminates per-token deep-cloning and schema validation on every streaming chunk.
+- **Atomic round-robin pointer rotation**: Concurrent requests advance pointer immediately on candidate selection, eliminating race conditions on simultaneous tool calls.
+- **Enhanced switchable error detection**: Direct parsing of HTTP status codes (`429`, `401`, `403`, `5xx`) and gRPC codes (`RESOURCE_EXHAUSTED`, `UNAVAILABLE`) alongside regex fallback.
+- **Informative user exhaustion messaging**: Clear countdown notice with next key recovery ETA when all keys in a pool are cooling down.
+- **Smart polling**: Client background polling paused when browser tab is inactive (`document.visibilityState`).
+
+### v0.7.35
+- **Lifecycle Cleanups**: Wrapped `credentials.resolve` patch and `ctx.on` event handlers (`llm/stream`, `agent/request-error`) in `ctx.effect` scopes with guaranteed unmount cleanup (#238, #239).
+- **Settings & Secret Roles**: Added `.role('secret')` to `incidentGitHubToken` and `webhookActionToken` in `Config` schema for automatic UI masking (#237).
+- **Settings Architecture & UI**: Added native `settingsScope` snapshot reading/saving in settings card with graceful bridge fallback (#235).
+- **Localization**: Localized `settings.section` sidebar fallback label via `t('title')` and registered `zh` dictionary in `ctx.locale` alongside `en` and `ru` (#236).
+- **Dead Code Purge**: Removed obsolete `mountDashboard` routine after header-chip migration (#240).

package/README.ru.md

@@ -251,4 +251,19 @@ dsh-key-rotation:
 
 ## 📄 Лицензия
 
-MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
+MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
+
+### v0.7.36
+- **Глубокий рефакторинг и деблоатинг**: Удалены 6 неиспользуемых модулей оверинжиниринга (`shadow`, `incident`, `agent-budget`, `region`, `canary`, `maintenance`) и сопутствующие устаревшие эндпоинты.
+- **Мемоизация buildRuntime**: Устранено глубокое клонирование и повторный парсинг схемы на каждом токене/чанге стрима.
+- **Атомарная ротация указателя**: Устранено состояние гонки при параллельных вызовах инструментов — указатель смещается сразу при выборе кандидата.
+- **Точная детекция ошибок**: Прямая проверка кодов HTTP (`429`, `401`, `403`, `5xx`) и gRPC (`RESOURCE_EXHAUSTED`, `UNAVAILABLE`) с фоллбеком на регулярные выражения.
+- **Понятные сообщения при исчерпании пула**: Информативное уведомление с таймером восстановления ближайшего ключа.
+- **Энергоэффективный опрос (Smart Polling)**: Автоматическая приостановка фонового опроса при неактивной вкладке браузера (`document.visibilityState`).
+
+### v0.7.35
+- **Очистка жизненного цикла**: Патч `credentials.resolve` и слушатели событий `ctx.on` (`llm/stream`, `agent/request-error`) переведены в скоупы `ctx.effect` с автоматическим восстановлением функций и отпиской при выгрузке плагина (#238, #239).
+- **Роли секретов в схеме**: Полям `incidentGitHubToken` и `webhookActionToken` в схеме `Config` присвоена роль `.role('secret')` для маскирования в UI (#237).
+- **Архитектура настроек**: Добавлена нативная интеграция со снимками `settingsScope` в карточке настроек с безопасным фоллбеком на HTTP-мост (#235).
+- **Локализация**: Фоллбек секции настроек `settings.section` переведён на локализованную метку `t('title')` со слотом `locale: NS`, а китайский словарь `zh` зарегистрирован в `ctx.locale` наряду с `en` и `ru` (#236).
+- **Удаление мёртвого кода**: Удалена неиспользуемая функция `mountDashboard` после перехода на header chip (#240).

package/README.zh.md

@@ -212,4 +212,19 @@ dsh-key-rotation:
 
 ## 📄 开源许可
 
-MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
+MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
+
+### v0.7.36
+- **架构精简与稳定性加固**：移除 6 个过度设计的模块（`shadow`、`incident`、`agent-budget`、`region`、`canary`、`maintenance`）与废弃端点。
+- **buildRuntime 高性能记忆化**：消除每个流式 token/chunk 上的深拷贝与模式重解析开销。
+- **原子轮询指针推进**：并发请求在选定候选密钥时立即推进指针，消除并发工具调用中的竞争条件。
+- **增强的可切换错误检测**：直接解析 HTTP 状态码（`429`, `401`, `403`, `5xx`）与 gRPC 状态码（`RESOURCE_EXHAUSTED`, `UNAVAILABLE`）。
+- **用户友好的耗尽提示**：密钥池耗尽时返回带恢复倒计时的清晰通知。
+- **智能轮询（Smart Polling）**：标签页不活动时暂停客户端后台轮询。
+
+### v0.7.35
+- **生命周期清理**: 将 `credentials.resolve` 猴子补丁和 `ctx.on` 事件监听器 (`llm/stream`, `agent/request-error`) 封装在 `ctx.effect` 作用域内，确保卸载时自动注销并恢复原始方法 (#238, #239)。
+- **配置密钥角色**: 在 `Config` Schema 中为 `incidentGitHubToken` 和 `webhookActionToken` 增加 `.role('secret')`，避免明文泄露并在 UI 中掩码显示 (#237)。
+- **设置架构与状态**: 在设置卡片中增加原生 `settingsScope` 绑定支持，保留 HTTP 桥接安全回退机制 (#235)。
+- **本地化与文案**: 侧边栏备用项 `settings.section` 标签支持本地化 `t('title')` 并配置 `locale: NS`，并在 `ctx.locale` 中注册 `zh` 中文字典 (#236)。
+- **死代码清理**: 移除 header-chip 迁移后残留的废弃 `mountDashboard` 函数 (#240)。

package/lib/client.js

@@ -240,12 +240,13 @@ window.__ModuleLoader__.load({
     // отдельными отмеченными галочками, чтобы правило нельзя было потерять.
     const KNOWN_CODES = ['QUOTA', 'RATE_LIMIT', 'SERVER', 'TIMEOUT', 'TRANSPORT', 'EMPTY_RESPONSE', 'UNKNOWN_MODEL', 'AUTH'];
 
-    /** Опрос статуса ротации, пока раздел настроек открыт. */
+    /** Опрос статуса ротации, пока раздел настроек открыт (smart polling). */
     function useRotationStatus() {
       const [byProvider, setByProvider] = React.useState({});
       React.useEffect(() => {
         let alive = true;
         const pull = () => {
+          if (typeof document !== 'undefined' && document.visibilityState !== 'visible') return;
           fetch('/dsh-key-rotation/status', { headers: { accept: 'application/json' } })
             .then((r) => (r.ok ? r.json() : null))
             .then((data) => {
@@ -258,17 +259,24 @@ window.__ModuleLoader__.load({
         };
         pull();
         const id = setInterval(pull, 4000);
-        return () => { alive = false; clearInterval(id); };
+        const onVis = () => { if (typeof document !== 'undefined' && document.visibilityState === 'visible') pull(); };
+        if (typeof document !== 'undefined') document.addEventListener('visibilitychange', onVis);
+        return () => {
+          alive = false;
+          clearInterval(id);
+          if (typeof document !== 'undefined') document.removeEventListener('visibilitychange', onVis);
+        };
       }, []);
       return byProvider;
     }
 
-    /** Последний probe-результат по каждому ключу (#219): /sandbox-cache. */
+    /** Последний probe-результат по каждому ключу (#219): /sandbox-cache (smart polling). */
     function useProbeCache() {
       const [cache, setCache] = React.useState({});
       React.useEffect(() => {
         let alive = true;
         const pull = () => {
+          if (typeof document !== 'undefined' && document.visibilityState !== 'visible') return;
           fetch('/dsh-key-rotation/sandbox-cache', { headers: { accept: 'application/json' } })
             .then((r) => (r.ok ? r.json() : null))
             .then((data) => { if (alive && data) setCache(data); })
@@ -276,7 +284,13 @@ window.__ModuleLoader__.load({
         };
         pull();
         const id = setInterval(pull, 4000);
-        return () => { alive = false; clearInterval(id); };
+        const onVis = () => { if (typeof document !== 'undefined' && document.visibilityState === 'visible') pull(); };
+        if (typeof document !== 'undefined') document.addEventListener('visibilitychange', onVis);
+        return () => {
+          alive = false;
+          clearInterval(id);
+          if (typeof document !== 'undefined') document.removeEventListener('visibilitychange', onVis);
+        };
       }, []);
       return cache;
     }
@@ -390,6 +404,20 @@ window.__ModuleLoader__.load({
     function KeyRotationSection(props) {
       const DICT = props.locale === 'ru' ? ru : (props.locale === 'zh' ? zh : en);
       const t = makeT(DICT, en);
+      const settingsScope = React.useMemo(() => {
+        if (props.ctx && props.ctx.settingsScope) {
+          try {
+            return props.ctx.settingsScope.bind({ namespace: NS });
+          } catch (_) {
+            return null;
+          }
+        }
+        return null;
+      }, [props.ctx]);
+      const scopeSnapshot = React.useSyncExternalStore(
+        React.useMemo(() => (cb) => (settingsScope ? settingsScope.subscribe(cb) : () => {}), [settingsScope]),
+        React.useCallback(() => (settingsScope ? settingsScope.getSnapshot() : null), [settingsScope])
+      );
       const [state, setState] = React.useState({ status: 'loading', value: null, revision: 0, error: '', providers: [] });
       const [draft, setDraft] = React.useState(null);
       // ── all hooks live ABOVE any early return (React error 310 otherwise) ──
@@ -455,7 +483,18 @@ window.__ModuleLoader__.load({
           .catch((e) => setState((s) => ({ ...s, status: 'error', error: String(e) })));
       }, []);
 
-      React.useEffect(() => { load(); }, [load]);
+      React.useEffect(() => {
+        if (scopeSnapshot && scopeSnapshot.status === 'ready' && scopeSnapshot.value) {
+          setState((s) => ({
+            ...s,
+            status: 'ready',
+            value: scopeSnapshot.value,
+            revision: scopeSnapshot.revision ?? s.revision,
+          }));
+        } else {
+          load();
+        }
+      }, [load, scopeSnapshot]);
 
       const val = draft ?? state.value;
       const status = useRotationStatus();
@@ -650,21 +689,38 @@ window.__ModuleLoader__.load({
       const save = () => {
         if (!draft) return;
         setState((s) => ({ ...s, status: 'saving', error: '' }));
-        fetch(CONFIG_PATH, {
-          method: 'PUT',
-          headers: { 'content-type': 'application/json' },
-          body: JSON.stringify({ section: draft, expectedRevision: state.revision }),
-        })
-          .then((r) => r.json())
-          .then((data) => {
-            if (data.error) {
-              setState((s) => ({ ...s, status: 'error', error: data.error.message }));
-              return;
-            }
-            setState((s) => ({ status: 'ready', value: data.value ?? draft, revision: data.revision ?? s.revision, error: '', providers: s.providers }));
-            setDraft(null);
+        const saveViaBridge = () => {
+          fetch(CONFIG_PATH, {
+            method: 'PUT',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ section: draft, expectedRevision: state.revision }),
           })
-          .catch((e) => setState((s) => ({ ...s, status: 'error', error: String(e) })));
+            .then((r) => r.json())
+            .then((data) => {
+              if (data.error) {
+                setState((s) => ({ ...s, status: 'error', error: data.error.message }));
+                return;
+              }
+              setState((s) => ({ status: 'ready', value: data.value ?? draft, revision: data.revision ?? s.revision, error: '', providers: s.providers }));
+              setDraft(null);
+            })
+            .catch((e) => setState((s) => ({ ...s, status: 'error', error: String(e) })));
+        };
+        if (settingsScope && typeof settingsScope.set === 'function') {
+          (async () => {
+            try {
+              for (const [k, v] of Object.entries(draft)) {
+                await settingsScope.set(k, v);
+              }
+              setState((s) => ({ ...s, status: 'ready', value: draft, error: '' }));
+              setDraft(null);
+            } catch (_) {
+              saveViaBridge();
+            }
+          })();
+          return;
+        }
+        saveViaBridge();
       };
 
       
@@ -1021,13 +1077,7 @@ window.__ModuleLoader__.load({
       );
     }
 
-    function mountDashboard() {
-      // Floating dashboard disabled in favor of pinned header chip popover
-      if (typeof document !== 'undefined') {
-        var el = document.getElementById('krot-dash');
-        if (el) el.remove();
-      }
-    }
+
 
     // #201 header chip: one dot + counts for all pools. Green = all healthy,
     // amber = some keys cooling, red = a pool fully exhausted. Click opens the
@@ -1040,14 +1090,21 @@ window.__ModuleLoader__.load({
       React.useEffect(() => {
         let alive = true;
         const load = () => {
+          if (typeof document !== 'undefined' && document.visibilityState !== 'visible') return;
           fetch('/dsh-key-rotation/health', { headers: { accept: 'application/json' }, credentials: 'same-origin' })
             .then((r) => (r.ok ? r.json() : null))
             .then((d) => { if (alive) setSnap(d); })
             .catch(() => {});
         };
         load();
-        const id = setInterval(load, 4000);
-        return () => { alive = false; clearInterval(id); };
+        const id = setInterval(load, 5000);
+        const onVis = () => { if (typeof document !== 'undefined' && document.visibilityState === 'visible') load(); };
+        if (typeof document !== 'undefined') document.addEventListener('visibilitychange', onVis);
+        return () => {
+          alive = false;
+          clearInterval(id);
+          if (typeof document !== 'undefined') document.removeEventListener('visibilitychange', onVis);
+        };
       }, []);
 
       React.useEffect(() => {
@@ -1096,9 +1153,7 @@ window.__ModuleLoader__.load({
     }
 
     function apply(ctx) {
-      ctx.effect(() => ctx.locale.register(NS, { en, ru }), 'dsh-key-rotation: dictionaries');
-      // Dashboard widget: lives on every page, polls /health (#152).
-      ctx.effect(() => mountDashboard(), 'dsh-key-rotation: dashboard widget');
+      ctx.effect(() => ctx.locale.register(NS, { en, ru, zh }), 'dsh-key-rotation: dictionaries');
       // Header chip (#201): status dot in the session header utilities slot,
       // same slot dsh-gitea / dsh-subscriptions use for their header widgets.
       ctx.effect(() => {
@@ -1144,8 +1199,16 @@ window.__ModuleLoader__.load({
       };
       if (!tryPluginItem()) {
         // Fallback for builds without the Plugins tab slot: keep the sidebar section.
+        const t = ctx.locale ? ctx.locale.bind(NS) : null;
         ctx.slots.inject('settings.section', () => ctx.slots.register(
-          { name: 'settings.section', id: 'dsh-key-rotation', order: 20, label: () => 'Key Rotation' },
+          {
+            name: 'settings.section',
+            id: 'dsh-key-rotation',
+            order: 20,
+            locale: NS,
+            label: () => (t ? t('title') : 'Key Rotation') || 'Key Rotation',
+            inject: () => ({ ctx }),
+          },
           (props) => h(KeyRotationSection, { ...props, locale: useLocale() }),
         ));
       }