@goodandready/dsh-cost-meter 0.7.9 → 0.8.0

package/docs/design/DESIGN.md

@@ -22,7 +22,11 @@
 - Документация:
   - README.md, index.md, docs/testing/public-route.md, docs/testing/projection-lifecycle.md, docs/deployment/public-release.md.
 
-## Visual Direction
+## Visual Direction (Unified with dsh-clinebot)
+- Атмосфера: Строгий утилитарный нативный интерфейс DSH, высокая информационная плотность без визуального шума.
+- Утверждённые референсы: Эталонный плагин `@goodandready/dsh-clinebot`, дизайн-система DeepSeek Harness (`--dsw-alias-*`), карточки секций `.dcm-section-card`, бейджи статуса `.dcm-badge`, адаптивная сетка параметров `.dcm-grid-2`, чипы в шапке сессии.
+- Отказоустойчивость: Обязательный `ErrorBoundary` вокруг карточки настроек и поповера шапки (предотвращает исчезновение слотов ядра при исключениях рендеринга).
+- Синхронизация зеркал: `refreshMirrorUntilVisible(ctx)` для надёжного доступа к зеркалу `settingsScope`.
 - Атмосфера: Строгий утилитарный нативный интерфейс DSH, высокая информационная плотность без визуального шума.
 - Утверждённые референсы: Дизайн-система DeepSeek Harness (`--dsw-alias-*`), чипы в шапке сессии (`dsh-key-rotation`, `dsh-context-lens`), стандарт карточек настроек DSH.
 - Не копировать: Избыточные градиенты, внешние модальные окна, тяжелые тени, кастомные несогласованные шрифты.
@@ -41,7 +45,7 @@
 - Сетка и отступы:
   - Чип: высота 22px, padding: 0 8px, gap: 6px, border-radius: 6px.
   - Панель: padding: 12px 14px, border-radius: 10px, ширина 320px.
-  - Карточка настроек: нативный складной контейнер (`.dcm-settings-card`), отступы полей, бейдж статуса снимка (`ready`, `loading`, `unavailable`).
+  - Карточка настроек: нативный складной контейнер (`.dcm-card`) с шапкой, статусами-бейджами (`dcm-badge-ok`, `dcm-badge-warn`, `dcm-badge-bad`), 3 структурированными секциями (`Основные параметры`, `Каталог OpenRouter`, `Диагностика и статус`), защитой ввода и кнопкой сохранения (`dcm-btn-primary`).
 
 ## Components & States
 - Чип:

package/docs/plans/findings.md

@@ -1,22 +1,13 @@
-# Technical Findings (Issue #21)
+# Findings: Issue #23
 
-## 1. Config Fields Breakdown
-The plugin `Config` defines 10 fields:
-1. `currency` (string, default '$') -> Present in UI
-2. `usdRate` (number, default 1) -> Present in UI
-3. `displayTimeZone` (string, default 'Europe/Moscow') -> Present in UI
-4. `useOpenRouter` (boolean, default true) -> Missing in UI -> To be added as a checkbox in `CostMeterCard`
-5. `refreshHours` (number, default 24) -> Missing in UI -> To be added as a numeric input in `CostMeterCard`
-6. `modelMap` (dict of string -> string) -> Advanced JSON/YAML route mapping
-7. `prices` (dict of PriceRow) -> Advanced manual pricing rules
-8. `deepseekPeakPrices` (dict of PriceRow) -> Advanced DeepSeek peak overrides
-9. `manualPeakWindowsUtc` (array of string) -> Advanced manual time windows
-10. `manualOffPeakMultiplier` (number) -> Advanced discount multiplier for manual rates
+## Архитектурные паттерны dsh-clinebot
+- Изолированный тег `<style id="dsh-cost-meter-unified-css" data-dsh-plugin="dsh-cost-meter">` с переменными `--dsw-alias-...`.
+- `createErrorBoundary()` защищает слоты от падений при сбоях рендеринга.
+- `refreshMirrorUntilVisible(ctx)` обеспечивает доступность зеркала настроек в `settingsScope`.
+- Бейджи статуса (`cb-badge-ok`, `cb-badge-warn`, `cb-badge-bad`) позволяют пользователю моментально оценить состояние плагина.
 
-By adding `useOpenRouter` and `refreshHours` to `CostMeterCard`, all 5 primary scalar/control settings are directly configurable in the DSH Settings GUI. The 5 advanced structured override rules (`prices`, `modelMap`, `deepseekPeakPrices`, `manualPeakWindowsUtc`, `manualOffPeakMultiplier`) are explicitly documented in README.md and DESIGN.md as YAML configuration rows.
-
-## 2. Service Access Pattern
-In `lib/index.js`, we have:
-`const settings = ctx.get('settings')` (canonical).
-In `lib/client.js`, `ctx.settingsScope` is accessed directly. We should safely check `(ctx.get && ctx.get('settingsScope')) || ctx.settingsScope || (ctx.services && ctx.services.settingsScope)`.
-Same for `ctx.locale` and `ctx.slots`.
+## Найденные баги в dsh-cost-meter
+1. Строка 427 `lib/index.js`: `catalog = { index: { byId: {}, bySuffix: {} }, fetchedAt: 0, error: null }` не содержала `byLowerId`. При обращении к `matchModel` до первой загрузки каталога вызывался `index.byLowerId[lower]`, что приводило к `TypeError`.
+2. `slotOf(event.time)`: при `undefined` возвращал `NaN`, повреждая ключи слотов в проекции.
+3. `fetch(CATALOG_URL)`: без таймаута мог блокировать цикл обновлений при сетевых лагах.
+4. `splitRoute`: отбрасывал модели без слэша.

package/docs/plans/progress.md

@@ -1,17 +1,25 @@
-# Progress Log (Issue #21 / v0.7.9)
+<!-- id: issue-23-progress -->
+# Progress: Issue #23 — Стабилизация кода и редизайн UI по стандарту dsh-clinebot
 
-- [x] Analyze Issue #21
-- [x] Create worktree `.worktrees/issue-21`
-- [x] Initialize plans (`task_plan.md`, `findings.md`, `progress.md`)
-- [x] Bump version to 0.7.9 in `package.json`
-- [x] Implement settings card additions (`useOpenRouter`, `refreshHours`) in `lib/client.js`
-- [x] Safe service resolution with `ctx.get('...')` in `lib/client.js`
-- [x] Update documentation with full 10-field matrix (`README.md`, `docs/README.ru.md`, `docs/design/DESIGN.md`)
-- [x] Add regression test `test/settings-card-fields.test.mjs` (12/12 passing)
-- [ ] Commit changes with conventional commits (`git-antigravity`)
-- [ ] Create Pull Request and merge into `main`
-- [ ] Test package on MiniPC isolated test server (`192.168.1.123:3082`)
-- [ ] Smoke-test package on production candidate (`192.168.1.111:3080`)
-- [ ] Publish v0.7.9 to npm and GitHub Release
-- [ ] Install v0.7.9 from npm on MiniAI and verify live health
-- [ ] Close Gitea Issue #21 and clean up worktree
+- [x] Создана Issue #23 в Gitea
+- [x] Создан worktree `.worktrees/issue-23` на ветке `feat/stability-and-ui-clinebot`
+- [x] Инициализированы файлы планирования (`task_plan.md`, `findings.md`, `progress.md`)
+- [x] Применены серверные исправления (`lib/index.js`):
+  - [x] Инициализация `byLowerId` в начальном состоянии `catalog.index` (устранён крах холодного старта)
+  - [x] Защита `slotOf(timeMs)` от `NaN` при невалидных временных метках
+  - [x] Добавлен таймаут (15с) для внешних запросов к OpenRouter
+  - [x] Расширен `splitRoute` для поддержки моделей без слэша (`deepseek-chat`)
+  - [x] Экспорт `catalogModelsCount` в ответе `/dsh-cost-meter/state`
+- [x] Применён визуальный редизайн по стандарту `dsh-clinebot` (`lib/client.js`):
+  - [x] Внедрён `createErrorBoundary()` для защиты слотов от падений
+  - [x] Внедрён `refreshMirrorUntilVisible(ctx)` для синхронизации настроек
+  - [x] Внедрена нативная CSS-система дизайн-токенов (`--dsw-alias-*`)
+  - [x] Шапка карточки снабжена бейджами статуса каталога, тарифа и таймзоны
+  - [x] Настройки структурированы по 3 секциям (`Основные параметры`, `Каталог OpenRouter`, `Диагностика`)
+  - [x] Модернизирован поповер шапки сессии
+- [x] Обновлена документация (`DESIGN.md`, `README.md`, `docs/README.ru.md`)
+- [x] Поднята версия до `0.7.10` в `package.json`
+- [x] Написаны и успешно пройдены 16 тестов в `test/stability-and-visual.test.mjs` (`npm test` 16/16 pass)
+- [ ] Оформление коммита, push ветки и создание PR #24
+- [ ] Merge PR в `main` и сборка тарбола
+- [ ] Тестирование на проде, публикация релиза v0.7.10 и закрытие Issue #23

package/docs/plans/task_plan.md

@@ -1,32 +1,25 @@
-# Task Plan: Address Issue #21 (Settings Card Schema Fields & Service Access)
+# Task Plan: Issue #23 — Стабилизация кода и редизайн UI карточки настроек по стандарту dsh-clinebot
 
-## 1. Goal
-Fulfill Gitea Issue #21 requirements:
-1. **Schema Fields Availability in Settings Card**:
-   - Audit all 10 fields of `Config`:
-     - UI fields: `currency`, `usdRate`, `displayTimeZone`.
-     - Boolean toggle: `useOpenRouter` (checkbox / toggle in settings card).
-     - Numeric: `refreshHours` (catalog refresh frequency, e.g. 24 hours).
-     - Complex structured overrides: `prices` (dict), `modelMap` (dict), `deepseekPeakPrices` (dict), `manualPeakWindowsUtc` (array), `manualOffPeakMultiplier` (number).
-     - Add `useOpenRouter` and `refreshHours` directly to the `CostMeterCard` form so all scalar/toggle configuration is editable in GUI.
-     - Document structured dict/array fields (`prices`, `modelMap`, `deepseekPeakPrices`, `manualPeakWindowsUtc`, `manualOffPeakMultiplier`) in documentation, READMEs and DESIGN.md as YAML-only/advanced configuration rows.
-2. **Context Service Access Hygiene**:
-   - Inspect all `ctx.settings` / `ctx.settingsScope` / `ctx.locale` / `ctx.webServer` calls.
-   - Use `ctx.get('...')` or inject where appropriate, or guard against undefined proxiable properties.
-3. **Locale & Translations**:
-   - Provide clean English locale strings as canonical with ru dictionaries, and hint descriptions for all new fields.
+## Цель
+Устранить дефекты стабильности (холодный старт, event.time, таймаут OpenRouter, модели без слэша) и обновить UI плагина до единого стандарта dsh-clinebot (ErrorBoundary, дизайн-токены, бейджи, секции, адаптивная сетка, поповер).
 
-## 2. Checklist
-- [ ] Bump version to 0.7.9 in `package.json`
-- [ ] Add `useOpenRouter` and `refreshHours` fields to `CostMeterCard` in `lib/client.js`
-- [ ] Update `en` and `ru` dictionaries for new fields
-- [ ] Audit and refine service accesses in `lib/index.js` and `lib/client.js`
-- [ ] Update `README.md`, `docs/README.ru.md`, `docs/README.zh.md`, and `docs/design/DESIGN.md`
-- [ ] Add unit test verifying settings card field contract
-- [ ] Run `npm test` (all tests passing)
-- [ ] Conventional commit & push
-- [ ] Gitea PR & merge
-- [ ] Test on MiniPC test server (`192.168.1.123`)
-- [ ] Install on production MiniAI (`192.168.1.111`) & verify
-- [ ] Release v0.7.9 on GitHub & npm
-- [ ] Close Issue #21 & cleanup worktree
+## Задачи
+- [ ] 1. Исправление серверной части (`lib/index.js`):
+  - [ ] Инициализация `byLowerId` в начальном состоянии каталога
+  - [ ] Валидация `timeMs` в `slotOf(timeMs)`
+  - [ ] Добавление таймаута (15с) для запросов к `openrouter.ai`
+  - [ ] Поддержка моделей без префикса в `splitRoute`
+  - [ ] Экспорт диагностических метаданных (`catalogModelsCount`, `fetchedAt`, `error`) в `/dsh-cost-meter/state`
+- [ ] 2. Обновление клиентской части (`lib/client.js`):
+  - [ ] Внедрение `createErrorBoundary()` и обёртка карточки и поповера
+  - [ ] Внедрение `refreshMirrorUntilVisible(ctx)`
+  - [ ] Единая CSS-система дизайн-токенов (`.dcm-section-card`, `.dcm-badge`, `.dcm-grid-2`, `.dcm-btn`, `.dcm-alert-*`)
+  - [ ] Структурирование настроек по 3 логическим секциям с бейджами статуса в шапке
+  - [ ] Модернизация поповера шапки на классы дизайн-системы
+  - [ ] Локализация новых ключей (`ru`, `en`)
+- [ ] 3. Обновление документации:
+  - [ ] Актуализация `docs/design/DESIGN.md`, `README.md`, `docs/README.ru.md`
+- [ ] 4. Тестирование:
+  - [ ] Написание юнит-тестов `test/stability-and-visual.test.mjs`
+  - [ ] Прогон всех тестов (`npm test`)
+- [ ] 5. Сборка, PR, релиз v0.7.10, верификация на MiniAI и закрытие Issue #23