@goodandready/dsh-cost-meter 0.7.9 → 0.8.1

package/README.md

@@ -138,3 +138,10 @@ npm test
 ## 📄 License
 
 MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
+
+### Performance & Smart Cost Features (v0.8.1)
+- **O(K) Rate Change Calculation**: Next schedule transition is resolved in $O(K)$ boundary hops instead of full-day iterations.
+- **Server Cache & ETag**: High-throughput state polling with `304 Not Modified` support and internal tariff LRU cache.
+- **Manual Catalog Sync**: On-demand catalog fetch via `POST /dsh-cost-meter/refresh` or UI "Sync Now" button.
+- **Savings Advice & Budget Threshold**: Popover hints on impending off-peak discounts (50% off) and optional warning thresholds (`budgetThreshold`).
+- **Quick Summary Export**: Instant markdown/text summary copy to clipboard.

package/docs/README.ru.md

@@ -138,3 +138,9 @@ npm test
 ## 📄 Лицензия
 
 MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
+
+### Производительность и интеллектуальные подсказки (v0.8.1)
+- **Алгоритм O(K)**: Моментальный расчёт границ смены тарифов и мемоизация экстремумов без лишних циклов в браузере.
+- **Серверный кэш и ETag**: Поддержка заголовка `304 Not Modified` для маршрута `/state` и кэширование сопоставлений моделей.
+- **Ручная синхронизация**: Кнопка «Синхронизировать сейчас» в настройках с защитой от флуда (`POST /dsh-cost-meter/refresh`).
+- **Подсказки экономии и порог бюджета**: Отсчёт времени до льготного окна (скидка 50%), порог сессии (`budgetThreshold`) и экспорт сводки в буфер обмена.

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,6 +86,15 @@
   - Не допускать утечек локальных путей и инфраструктурных данных в коде или документации.
 
 ## History & Decisions
+- 2026-09-12 (v0.8.1):
+  - Оптимизация производительности расчёта тарифов: замена 1440-минутного цикла на алгоритм O(K) по точкам перехода и мемоизация экстремумов через WeakMap.
+  - Серверный кэш разрешения тарифов resolveTariffCache (Map) с автоматической очисткой при обновлении каталога.
+  - Поддержка ETag и ответа 304 Not Modified на эндпоинте /dsh-cost-meter/state.
+  - Кнопка ручной синхронизации каталога цен в секции OpenRouter с защитой от флуда (cooldown 30 сек).
+  - Интеллектуальные подсказки экономии: плашка скорого наступления льготного тарифа (скидка 50%) и отсчёт времени.
+  - Поддержка настраиваемого порога бюджета сессии (budgetThreshold) с предупреждающей подсветкой чипа.
+  - Кнопка быстрого копирования текстового отчёта о расходах в буфер обмена.
+  - Таблица нормализации алиасов вендоров (z-ai -> zai, deepseek-official -> deepseek, gemini -> google).
 - 2026-09-05 (v0.7.9):
   - Hotfix: исправлен ReferenceError (t is not defined) в объекте словаря ru (lib/client.js) (#15).
   - Добавлен автоматический тест на чистое исполнение фабрики client loader (`test/public-route.test.mjs`).

package/docs/plans/findings.md

@@ -1,22 +1,17 @@
-# Technical Findings (Issue #21)
+# Findings: Issue #25 (v0.8.1)
 
-## 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
+## 1. Клиентские вычисления расписания
+- В `lib/client.js`: `extremes()` и `minutesUntilChange()` вызывались на каждом тике таймера (15 сек) и перерисовывали 1440-минутный цикл:
+  `for (let minute = 0; minute < 1440; minute++)` с поиском в `windows`.
+- В сутках конечное число окон $K$ (обычно 2–4). Смена тарифа может происходить только на границах интервалов: `window.start` и `window.end`.
+- Замена на $O(K)$ даёт мгновенный расчёт без аллокации сотен объектов в секунду при активных сессиях.
 
-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. Разрешение тарифов на сервере
+- `resolveTariff(cfg, catalog.index, route)` перебирает регулярные выражения и суффиксы.
+- Кэширование в `Map<string, ResolvedTariff>` с очисткой при обновлении каталога полностью снимает нагрузку на CPU при частом пуллинге `/state` клиентами DSH.
 
-## 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`.
+## 3. Поддержка ETag
+- Для `/dsh-cost-meter/state` генерация слабого ETag (`W/"<hash>"`) на основе `updatedAt`, `fetchedAt` и счетчиков токенов позволяет клиентам передавать `If-None-Match` и получать `304 Not Modified`, экономя полосу пропускания и парсинг JSON.
+
+## 4. Алиасы вендоров
+- Разные провайдеры в DSH могут передавать вендоров как `z-ai`, `zai`, `google`, `gemini`, `deepseek-ai`, `deepseek`. Единая нормализация исключит ситуации fallback на generic тариф.

package/docs/plans/progress.md

@@ -1,17 +1,12 @@
-# Progress Log (Issue #21 / v0.7.9)
+# Progress: Issue #25 (v0.8.1)
 
-- [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
+- **2026-09-12 19:10**:
+  - Создана Gitea Issue #25.
+  - Создан worktree `.worktrees/issue-25` от `origin/main` (ветка `feat/issue-25-perf-and-smart-features`).
+  - Инициализированы планы в `docs/plans/`.
+
+- **2026-09-12 19:16**:
+  - Реализованы оптимизации в `lib/index.js` (resolveTariffCache, ETag / 304, POST /refresh, budgetThreshold, VENDOR_ALIASES).
+  - Реализованы улучшения в `lib/client.js` (O(K) minutesUntilChange, memoized extremes, кнопка синхронизации с cooldown, порог бюджета, плашка экономии, копирование сводки).
+  - Добавлены тесты в `test/v081-perf-smart.test.mjs` (все 20 тестов успешно пройдены).
+  - Версия поднята до `0.8.1`.

package/docs/plans/task_plan.md

@@ -1,32 +1,31 @@
-# Task Plan: Address Issue #21 (Settings Card Schema Fields & Service Access)
+# Task Plan: Issue #25 (v0.8.1) — Оптимизация производительности, ручная синхронизация каталога и подсказки экономии
 
-## 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.
+## Цели
+1. **Скорость**:
+   - Оптимизация алгоритма расчета времени смены тарифа (`minutesUntilChange`) и экстремумов (`extremes`) с $O(1440)$ до $O(K)$ без полного минутного цикла.
+   - Серверный кэш `resolveTariffCache` для быстрого разрешения моделей.
+   - Поддержка ETag / 304 Not Modified на эндпоинте `/dsh-cost-meter/state`.
+2. **Качество и управление**:
+   - Маршрут `POST /dsh-cost-meter/refresh` с rate limit (cooldown 30 сек) и кнопка «Синхронизировать сейчас» в настройках.
+   - Таблица нормализации алиасов вендоров (Smart Vendor Aliases).
+   - Индикация stale-кэша каталога в UI.
+3. **Экономия**:
+   - Подсказка в поповере о приближении льготного тарифа (50% скидка).
+   - Конфигурируемый порог сессии `budgetThreshold` с предупреждающей подсветкой чипа.
+   - Кнопка «Скопировать сводку» в поповере.
+4. **Стандарты и релиз**:
+   - 100% прохождение тестов `npm test`.
+   - Проверка размера файлов (< 256 KiB).
+   - Тестирование на test server (MiniPC :3082), затем на MiniAI candidate (:3080).
+   - Запрос подтверждения пользователя -> публикация v0.8.1 в npm/GitHub -> rollout на прод.
 
-## 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
+## Статус выполнения
+- [x] Issue #25 создана
+- [x] Worktree `.worktrees/issue-25` развёрнут
+- [x] Реализация серверной части (`lib/index.js`)
+- [x] Реализация клиентской части (`lib/client.js`)
+- [x] Добавление unit-тестов в `test/`
+- [x] Обновление документации (`DESIGN.md`, `README.md`, `README.ru.md`)
+- [ ] Тестирование на стендах (:3082, :3080)
+- [ ] Публикация релиза v0.8.1
+- [ ] Закрытие Issue #25 и очистка worktree