@goodandready/dsh-cost-meter 0.7.8 → 0.8.0

package/README.md

@@ -108,14 +108,20 @@ dsh-cost-meter:
 
 ### Configuration Parameters
 
-| Parameter | Type | Default | Description |
-|:---|:---|:---|:---|
-| `currency` | `string` | `"$"` | Display currency symbol or code |
-| `usdRate` | `number` | `1.0` | Exchange rate multiplier from USD |
-| `displayTimeZone` | `string` | `"UTC"` | Timezone for window schedule formatting (e.g. `Europe/London`, `Asia/Shanghai`) |
-| `useOpenRouter` | `boolean` | `true` | Fetch OpenRouter public catalog for fallback models |
-| `prices` | `object` | `{}` | Custom override rates per 1M tokens `{ prompt, completion, cacheRead?, cacheWrite? }` |
-| `modelMap` | `object` | `{}` | Model alias mappings `{ "alias": "target-model" }` |
+| Parameter | Scope / Location | Type | Default | Description |
+|:---|:---|:---|:---|:---|
+| `currency` | GUI / `settings.yaml` | `string` | `"$"` | Display currency symbol (e.g. `$`, `₽`, `€`) |
+| `usdRate` | GUI / `settings.yaml` | `number` | `1.0` | Exchange rate multiplier: units of currency per 1 USD |
+| `displayTimeZone` | GUI / `settings.yaml` | `string` | `"Europe/Moscow"` | IANA timezone for peak/off-peak windows formatting |
+| `useOpenRouter` | GUI / `settings.yaml` | `boolean` | `true` | Automatically fetch rates & discount windows from OpenRouter |
+| `refreshHours` | GUI / `settings.yaml` | `number` | `24` | Hours between periodic OpenRouter catalog updates |
+| `deepseekPeakPrices` | `settings.yaml` only | `object` | `{}` | Override built-in DeepSeek peak rates by model id |
+| `prices` | `settings.yaml` only | `object` | `{}` | Manual rates per 1M tokens `{ input, output, cacheHit?, cacheWrite? }` |
+| `modelMap` | `settings.yaml` only | `object` | `{}` | Route override: `"provider/model"` -> OpenRouter model id |
+| `manualPeakWindowsUtc` | `settings.yaml` only | `array` | `[]` | Manual peak windows HH:MM-HH:MM UTC used with manual prices |
+| `manualOffPeakMultiplier` | `settings.yaml` only | `number` | `1.0` | Multiplier applied outside manual peak windows |
+
+> **Note on GUI vs YAML**: Primary scalar parameters (`currency`, `usdRate`, `displayTimeZone`, `useOpenRouter`, `refreshHours`) are directly editable in the GUI Settings Card under **Settings → Plugins → Plugin Settings → Cost Meter**. Advanced structured rules (`prices`, `modelMap`, `deepseekPeakPrices`, `manualPeakWindowsUtc`, `manualOffPeakMultiplier`) are configured in `settings.yaml` due to their complex dictionary/array schema.
 
 ---
 

package/docs/README.ru.md

@@ -108,14 +108,20 @@ dsh-cost-meter:
 
 ### Параметры конфигурации
 
-| Параметр | Тип | По умолчанию | Описание |
-|:---|:---|:---|:---|
-| `currency` | `string` | `"₽"` | Символ или код валюты для отображения |
-| `usdRate` | `number` | `90.0` | Множитель пересчёта долларовых цен в валюту отображения |
-| `displayTimeZone` | `string` | `"UTC"` | Таймзона для отображения окон в панели |
-| `useOpenRouter` | `boolean` | `true` | Загружать ли каталог цен OpenRouter для сторонних моделей |
-| `prices` | `object` | `{}` | Ручные ставки за 1M токенов `{ prompt, completion, cacheRead?, cacheWrite? }` |
-| `modelMap` | `object` | `{}` | Алиасы моделей `{ "alias": "target-model" }` |
+| Параметр | Доступность | Тип | По умолчанию | Описание |
+|:---|:---|:---|:---|:---|
+| `currency` | GUI / `settings.yaml` | `string` | `"₽"` | Символ валюты в интерфейсе (например, `₽`, `$`, `€`) |
+| `usdRate` | GUI / `settings.yaml` | `number` | `80.0` | Курс обмена: единиц валюты за 1 USD |
+| `displayTimeZone` | GUI / `settings.yaml` | `string` | `"Europe/Moscow"` | IANA часовой пояс для отображения окон пика и не-пика |
+| `useOpenRouter` | GUI / `settings.yaml` | `boolean` | `true` | Загружать ли каталог тарифов и скидочных окон OpenRouter |
+| `refreshHours` | GUI / `settings.yaml` | `number` | `24` | Частота обновления каталога OpenRouter (в часах) |
+| `deepseekPeakPrices` | Только `settings.yaml` | `object` | `{}` | Переопределение встроенных пиковых ставок DeepSeek по id модели |
+| `prices` | Только `settings.yaml` | `object` | `{}` | Ручные ставки за 1M токенов `{ input, output, cacheHit?, cacheWrite? }` |
+| `modelMap` | Только `settings.yaml` | `object` | `{}` | Сопоставление маршрута `"provider/model"` на id в OpenRouter |
+| `manualPeakWindowsUtc` | Только `settings.yaml` | `array` | `[]` | Ручные окна пика HH:MM-HH:MM UTC для ручных ставок |
+| `manualOffPeakMultiplier` | Только `settings.yaml` | `number` | `1.0` | Коэффициент тарифа вне ручных окон пика |
+
+> **Интерфейс настроек (GUI) vs settings.yaml**: Основные параметры (`currency`, `usdRate`, `displayTimeZone`, `useOpenRouter`, `refreshHours`) настраиваются прямо в карточке интерфейса DSH (**Настройки → Плагины → Настройки плагинов → Cost Meter**). Расширенные структурированные правила сопоставления и ручных тарифов задаются через `settings.yaml` из-за сложной древовидной структуры.
 
 ---
 

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
 - Чип:
@@ -82,7 +86,7 @@
   - Не допускать утечек локальных путей и инфраструктурных данных в коде или документации.
 
 ## History & Decisions
-- 2026-09-05 (v0.7.8):
+- 2026-09-05 (v0.7.9):
   - Hotfix: исправлен ReferenceError (t is not defined) в объекте словаря ru (lib/client.js) (#15).
   - Добавлен автоматический тест на чистое исполнение фабрики client loader (`test/public-route.test.mjs`).
 - 2026-09-05 (v0.7.4):

package/docs/plans/findings.md

@@ -1,10 +1,13 @@
-# Findings & Architecture Decisions (v0.7.8)
+# Findings: Issue #23
 
-## 1. Browser Request Race Conditions
-In `CostMeter`, rapid model switches or toggling the popover calls `load(usedKeys)`. Since network latency varies, an older request might resolve after a newer one. By tracking an active request counter or cancellation token per effect invocation, we ensure only the most up-to-date state response mutates the component state.
+## Архитектурные паттерны 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`) позволяют пользователю моментально оценить состояние плагина.
 
-## 2. IANA TimeZone Validation
-`Intl.DateTimeFormat(undefined, { timeZone })` throws a `RangeError` if the timezone string is invalid. We can safely leverage this in `CostMeterCard` to reject typos (e.g. `Europe/Moskow` instead of `Europe/Moscow`) on the client before writing to `settingsScope`.
-
-## 3. Query Parameter Sanitization
-The endpoint `GET /dsh-cost-meter/state?models=...` accepts comma-separated model keys. Adding a length bound (e.g. <= 128 chars) and trimming ensures no malformed payloads cause unexpected overhead.
+## Найденные баги в 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 @@
-# Implementation Progress (v0.7.8)
+<!-- id: issue-23-progress -->
+# Progress: Issue #23 — Стабилизация кода и редизайн UI по стандарту dsh-clinebot
 
-- [x] Create Gitea Issue #19
-- [x] Create isolated worktree `stability-v078`
-- [x] Bump version to 0.7.8 in `package.json`
-- [x] Add monotonic request sequence guard in `lib/client.js` `CostMeter`
-- [x] Add IANA time zone validation in `lib/client.js` `CostMeterCard`
-- [x] Sanitize query parameters in `lib/index.js`
-- [x] Add automated unit tests (`test/timezone-sanitization.test.mjs`, 11/11 passing)
-- [x] Update design documentation in `docs/design/DESIGN.md`
-- [ ] 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.8 to npm and GitHub Release
-- [ ] Install v0.7.8 from npm on MiniAI and verify live health
-- [ ] Close Gitea Issue #19 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,24 +1,25 @@
-# Task Plan: Stability, Race Condition Prevention & TimeZone Validation (v0.7.8)
+# Task Plan: Issue #23 — Стабилизация кода и редизайн UI карточки настроек по стандарту dsh-clinebot
 
-## 1. Goal
-Strengthen `@goodandready/dsh-cost-meter` runtime resilience:
-- Prevent race condition response overwrites in browser `CostMeter` component.
-- Validate IANA TimeZone inputs in `CostMeterCard` settings before saving.
-- Sanitize `models` query parameter keys in `lib/index.js` route handler.
-- Maintain strict backward compatibility, zero regression in automated tests.
+## Цель
+Устранить дефекты стабильности (холодный старт, event.time, таймаут OpenRouter, модели без слэша) и обновить UI плагина до единого стандарта dsh-clinebot (ErrorBoundary, дизайн-токены, бейджи, секции, адаптивная сетка, поповер).
 
-## 2. Checklist
-- [ ] Bump version to `0.7.8` in `package.json`
-- [ ] Implement cancellation flag / abort protection in `lib/client.js` `CostMeter`
-- [ ] Implement `isValidTimeZone` helper and validation check in `CostMeterCard`
-- [ ] Implement key sanitization (length <= 128 chars, alphanumeric/dash/slash) in `lib/index.js`
-- [ ] Add unit tests for timezone check and query sanitization
-- [ ] Run test suite (`npm test`)
-- [ ] Update `docs/design/DESIGN.md`
-- [ ] Conventional Commit & Push
-- [ ] Gitea PR & Merge to `main`
-- [ ] Test on MiniPC test server (`192.168.1.123`)
-- [ ] Production Smoke Verification on MiniAI (`192.168.1.111`)
-- [ ] Publish Tag `v0.7.8`, GitHub Release & npm
-- [ ] Update production profile from npm
-- [ ] Close Gitea Issue #19 and clean up 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