@goodandready/dsh-cost-meter 0.8.1 → 0.8.3

package/lib/index.js

@@ -1,3 +1,4 @@
+import { registerPluginUpdater } from './updater.js'
 // dsh-cost-meter — host half.
 //
 // The harness prices nothing on purpose: pi-ai carries a `cost` field but
@@ -20,12 +21,38 @@ import { dirname, join } from 'node:path'
 import z from '@deepseek-ai/schemastery'
 import { z as zod } from 'zod'
 
-export const name = 'dsh-cost-meter'
+export const name = '@goodandready/dsh-cost-meter'
 export const inject = ['webServer']
 
 const NS = 'dsh-cost-meter'
 const STATE_PATH = '/dsh-cost-meter/state'
 const REFRESH_PATH = '/dsh-cost-meter/refresh'
+export function isLoopback(value) {
+  const address = value?.toLowerCase().replace(/^\[|\]$/g, '')
+  return address === 'localhost' || address === 'localhost.' || address === '::1'
+    || address?.startsWith('127.') === true
+    || address?.startsWith('::ffff:127.') === true
+}
+
+export function isTrustedCaller(request) {
+  const remote = request?.socket?.remoteAddress || request?.connection?.remoteAddress
+  if (isLoopback(remote)) return true
+  const site = request?.headers?.['sec-fetch-site']
+  if (site === 'same-origin' || site === 'same-site') return true
+  if (site === 'cross-site') return false
+  const origin = request?.headers?.['origin']
+  const host = request?.headers?.['host']
+  if (origin && host) {
+    try {
+      const url = new URL(origin)
+      if (url.host === host) return true
+    } catch (e) {
+      /* invalid url */
+    }
+  }
+  return false
+}
+
 const CATALOG_URL = 'https://openrouter.ai/api/v1/models'
 const CACHE_FILE = join(process.env.DSH_HOME || join(homedir(), '.dsh'), 'storages', 'dsh-cost-meter-catalog.json')
 
@@ -532,6 +559,11 @@ export function apply(ctx, config) {
             res.end(JSON.stringify({ error: 'method not allowed' }))
             return
           }
+          if (!isTrustedCaller(req)) {
+            res.writeHead(403, { 'Content-Type': 'application/json' })
+            res.end(JSON.stringify({ error: 'forbidden source origin' }))
+            return
+          }
           const now = Date.now()
           const COOLDOWN_MS = 30000
           if (now - lastManualRefreshAt < COOLDOWN_MS) {
@@ -627,4 +659,14 @@ export function apply(ctx, config) {
       }),
     'dsh-cost-meter: state route',
   )
+
+  // Route 3: /dsh-cost-meter/update (in-app one-click updater)
+  if (ctx.webServer?.register) {
+    ctx.effect(() => registerPluginUpdater(ctx, {
+      endpoint: '/dsh-cost-meter/update',
+      packageName: name,
+      manifestUrl: new URL('../package.json', import.meta.url),
+    }), 'dsh-cost-meter: updater')
+  }
+
 }

package/lib/updater.js

@@ -0,0 +1,270 @@
+import { spawn } from 'node:child_process'
+import { existsSync, readFileSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+import { homedir } from 'node:os'
+import { basename, dirname, isAbsolute, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const UPDATE_HEADER = 'x-dsh-plugin-update'
+const UPDATE_TIMEOUT_MS = 10 * 60_000
+const VERSION_CACHE_MS = 5 * 60_000
+let latestCache = undefined
+
+function header(request, name) {
+  const value = request?.headers?.[name]
+  return Array.isArray(value) ? value[0] : value
+}
+
+function isLoopback(value) {
+  const address = value?.toLowerCase().replace(/^\[|\]$/g, '')
+  return address === 'localhost' || address === 'localhost.' || address === '::1'
+    || address?.startsWith('127.') === true
+    || address?.startsWith('::ffff:127.') === true
+}
+
+export function isTrustedUpdateRequest(request) {
+  if (header(request, UPDATE_HEADER) !== '1') return false
+  if (!isLoopback(request?.socket?.remoteAddress)) return false
+  const site = header(request, 'sec-fetch-site')
+  if (site !== undefined && site !== 'same-origin') return false
+  const origin = header(request, 'origin')
+  const host = header(request, 'host')
+  if (origin === undefined || host === undefined) return false
+  try {
+    const url = new URL(origin)
+    return (url.protocol === 'http:' || url.protocol === 'https:')
+      && isLoopback(url.hostname) && url.host === host
+  } catch (e) {
+    return false
+  }
+}
+
+function validProfileName(value) {
+  return typeof value === 'string' && value !== '' && value !== '.' && value !== '..'
+    && !value.includes('/') && !value.includes('\\') && !/[\0-\x1f\x7f]/.test(value)
+}
+
+function profileNameFromArgv(argv) {
+  if (!Array.isArray(argv)) return undefined
+  for (let index = 2; index < argv.length; index += 1) {
+    if (argv[index] === '--profile') return argv[index + 1]
+    if (argv[index]?.startsWith('--profile=')) return argv[index].slice('--profile='.length)
+  }
+  return argv[2] === 'web' ? 'web' : undefined
+}
+
+function findDshCliEntry() {
+  const value = process.argv[1]
+  if (typeof value !== 'string' || value.length === 0) return undefined
+  const entry = value.startsWith('file:') ? fileURLToPath(value) : resolve(process.cwd(), value)
+  if (!existsSync(entry)) return undefined
+  for (let directory = dirname(entry); ; directory = dirname(directory)) {
+    const manifestPath = resolve(directory, 'package.json')
+    if (existsSync(manifestPath)) {
+      try {
+        const manifest = JSON.parse(readFileSync(manifestPath, 'utf8'))
+        const bin = typeof manifest.bin === 'string'
+          ? manifest.bin
+          : typeof manifest.bin === 'object' && manifest.bin !== null
+            ? manifest.bin.dsh
+            : undefined
+        if (manifest.name === '@deepseek-ai/dsh' && typeof bin === 'string'
+          && !isAbsolute(bin) && resolve(directory, bin) === resolve(entry)) return entry
+      } catch (e) {
+        /* continue */
+      }
+    }
+    const parent = dirname(directory)
+    if (parent === directory) return undefined
+  }
+}
+
+function detectRuntime() {
+  const profileDir = resolve(process.env.DSH_PROFILE_DIR
+    ?? resolve(homedir(), '.dsh', 'profiles', 'web'))
+  const selected = profileNameFromArgv(process.argv)
+  const profileName = validProfileName(selected)
+    ? selected
+    : validProfileName(basename(profileDir)) ? basename(profileDir) : 'web'
+  const cliEntry = findDshCliEntry()
+  return cliEntry === undefined ? { profileName, profileDir } : { profileName, profileDir, cliEntry }
+}
+
+function parseSemver(value) {
+  const match = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/.exec(String(value || ''))
+  if (match === null) return undefined
+  return {
+    core: [Number(match[1]), Number(match[2]), Number(match[3])],
+    prerelease: match[4]?.split('.') ?? [],
+  }
+}
+
+function comparePrerelease(candidateParts, currentParts) {
+  if (candidateParts.length === 0 && currentParts.length > 0) return 1
+  if (candidateParts.length > 0 && currentParts.length === 0) return -1
+  if (candidateParts.length === 0 && currentParts.length === 0) return 0
+
+  const len = Math.max(candidateParts.length, currentParts.length)
+  for (let i = 0; i < len; i += 1) {
+    const a = candidateParts[i]
+    const b = currentParts[i]
+    if (a === undefined) return -1
+    if (b === undefined) return 1
+    if (a === b) continue
+
+    const aNum = /^\d+$/.test(a) ? Number(a) : undefined
+    const bNum = /^\d+$/.test(b) ? Number(b) : undefined
+
+    if (aNum !== undefined && bNum !== undefined) {
+      return aNum > bNum ? 1 : -1
+    }
+    if (aNum !== undefined && bNum === undefined) {
+      return -1
+    }
+    if (aNum === undefined && bNum !== undefined) {
+      return 1
+    }
+    return a.localeCompare(b) > 0 ? 1 : -1
+  }
+  return 0
+}
+
+export function isNewerVersion(currentValue, candidateValue) {
+  const current = parseSemver(currentValue)
+  const candidate = parseSemver(candidateValue)
+  if (current === undefined || candidate === undefined) return false
+  for (let index = 0; index < 3; index += 1) {
+    if (candidate.core[index] !== current.core[index]) return candidate.core[index] > current.core[index]
+  }
+  return comparePrerelease(candidate.prerelease, current.prerelease) > 0
+}
+
+async function fetchLatestVersion(packageName, registry) {
+  if (latestCache?.packageName === packageName && latestCache.registry === registry && Date.now() < latestCache.expiresAt) {
+    return latestCache.version
+  }
+  try {
+    const reg = registry.replace(/\/+$/, '')
+    const response = await fetch(`${reg}/${encodeURIComponent(packageName)}/latest`, {
+      signal: AbortSignal.timeout(6000),
+    })
+    if (!response.ok) return undefined
+    const value = await response.json()
+    if (typeof value?.version !== 'string' || !value.version) return undefined
+    latestCache = { packageName, registry, version: value.version, expiresAt: Date.now() + VERSION_CACHE_MS }
+    return value.version
+  } catch (e) {
+    return undefined
+  }
+}
+
+async function readCurrentVersion(manifestUrl) {
+  const value = JSON.parse(await readFile(manifestUrl, 'utf8'))
+  if (typeof value?.version !== 'string' || !value.version) throw new Error('Cannot read current plugin version.')
+  return value.version
+}
+
+export async function checkUpdateStatus(options, target = detectRuntime()) {
+  const current = await readCurrentVersion(options.manifestUrl)
+  const latest = await fetchLatestVersion(options.packageName, options.registry || 'https://registry.npmjs.org')
+  return {
+    packageName: options.packageName,
+    currentVersion: current,
+    ...(latest === undefined ? {} : { latestVersion: latest }),
+    latestCheckFailed: latest === undefined,
+    updateAvailable: latest !== undefined && isNewerVersion(current, latest),
+    profileName: target.profileName,
+    canAutoUpdate: target.cliEntry !== undefined,
+  }
+}
+
+async function installExact(target, packageSpec, options) {
+  if (target.cliEntry === undefined) throw new Error('Automatic update is unavailable in this runtime.')
+  await new Promise((resolvePromise, reject) => {
+    const child = spawn(process.execPath, [
+      target.cliEntry, 'plugin', '--profile', target.profileName, 'add',
+      packageSpec,
+      `--registry=${options.registry || 'https://registry.npmjs.org/'}`,
+    ], {
+      cwd: target.profileDir,
+      windowsHide: true,
+      stdio: ['ignore', 'pipe', 'pipe'],
+      env: { ...process.env, NO_COLOR: '1' },
+    })
+    let detail = ''
+    child.stdout?.on('data', (chunk) => { detail = (detail + String(chunk)).slice(-4000) })
+    child.stderr?.on('data', (chunk) => { detail = (detail + String(chunk)).slice(-4000) })
+    const timer = setTimeout(() => {
+      child.kill()
+      reject(new Error('Update timed out.'))
+    }, UPDATE_TIMEOUT_MS)
+    child.once('error', (error) => { clearTimeout(timer); reject(error) })
+    child.once('exit', (code) => {
+      clearTimeout(timer)
+      if (code === 0) resolvePromise()
+      else reject(new Error(detail.trim() || `Update exited with code ${String(code)}.`))
+    })
+  })
+}
+
+function writeResponseJson(response, statusCode, value) {
+  response.writeHead(statusCode, {
+    'content-type': 'application/json; charset=utf-8',
+    'cache-control': 'no-store',
+  })
+  response.end(JSON.stringify(value))
+}
+
+export function registerPluginUpdater(ctx, options) {
+  if (!ctx?.webServer?.register) return () => {}
+  let installing = false
+  return ctx.webServer.register({
+    kind: 'exact',
+    path: options.endpoint,
+    handler: async (request, response) => {
+      try {
+        const target = detectRuntime()
+        if (request.method === 'GET' || request.method === 'HEAD') {
+          const payload = await checkUpdateStatus(options, target)
+          writeResponseJson(response, 200, payload)
+          return
+        }
+        if (request.method !== 'POST') {
+          response.writeHead(405, { allow: 'GET, HEAD, POST' })
+          response.end()
+          return
+        }
+        if (!isTrustedUpdateRequest(request)) {
+          writeResponseJson(response, 403, { ok: false, error: 'Rejected non-local or cross-origin update request.' })
+          return
+        }
+        if (installing) {
+          writeResponseJson(response, 409, { ok: false, error: 'This plugin is already updating.' })
+          return
+        }
+        installing = true
+        try {
+          const before = await checkUpdateStatus(options, target)
+          if (before.latestVersion === undefined) {
+            writeResponseJson(response, 503, { ok: false, error: 'The latest version is temporarily unavailable.' })
+            return
+          }
+          if (!before.updateAvailable) {
+            writeResponseJson(response, 200, before)
+            return
+          }
+          await installExact(target, `${options.packageName}@${before.latestVersion}`, options)
+          writeResponseJson(response, 200, {
+            ...before,
+            updatedVersion: before.latestVersion,
+            restartRequired: true,
+          })
+        } finally {
+          installing = false
+        }
+      } catch (error) {
+        writeResponseJson(response, 500, { ok: false, error: String(error?.message || error) })
+      }
+    },
+  })
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-cost-meter",
-  "version": "0.8.1",
+  "version": "0.8.3",
   "description": "DeepSeek Harness plugin: a session cost chip in the conversation header - live token usage by bucket, peak/off-peak tariff, and a countdown to the next tariff switch.",
   "type": "module",
   "main": "lib/index.js",
@@ -11,10 +11,11 @@
     "./package.json": "./package.json"
   },
   "files": [
-    "lib",
+    "lib/",
     "cordis.patch.yml",
     "README.md",
-    "docs",
+    "README.ru.md",
+    "README.zh.md",
     "LICENSE"
   ],
   "publishConfig": {
@@ -26,7 +27,9 @@
     },
     "client": {
       "platform": "web",
-      "inject": []
+      "inject": [
+        "@deepseek-ai/dsh-client-locale"
+      ]
     }
   },
   "keywords": [

package/docs/deployment/public-release.md

@@ -1,9 +0,0 @@
-# Публичный релиз и deployment
-
-Релизная версия повышается patch-изменением (v0.7.6). После merge в `main`
-создаются annotated tag, пакет в npm (`@goodandready/dsh-cost-meter`) и
-публичный GitHub release в `GooDAnDReaDY/dsh-cost-meter`.
-
-Production должен содержать exact package version из npm и не должен иметь
-локальной зависимости на исходный checkout. После restart проверяются
-service health, browser loader и `GET /dsh-cost-meter/state`.

package/docs/design/DESIGN.md

@@ -1,111 +0,0 @@
-# DESIGN.md — dsh-cost-meter
-
-## Product / Purpose
-- Назначение: Отображение стоимости активной сессии диалога в реальном времени, тарифов (пик / не-пик / единый) за 1M токенов, обратного отсчёта до смены окна, прозрачной детализации расходов по каждой задействованной модели и нативного управления конфигурацией плагина.
-- Аудитория: Пользователи и инженеры DeepSeek Harness, контролирующие потребление токенов и бюджет на LLM-провайдеров.
-- Статус: Активная публичная поставка (@goodandready/dsh-cost-meter).
-
-## User Surfaces
-- Web/UI:
-  - Компактный чип в слоте `conversation.session.header.utilities` (order: 10).
-  - Выпадающая панель детализации (width: 320px, absolute positioning, click-outside dismissal).
-  - Карточка настроек плагина в `settings.plugin.item` (слот `settings.plugin.item` с fallback на `settings.section`).
-- DSH UI / settings / slots:
-  - Слот чипа: `conversation.session.header.utilities`.
-  - Слот карточки настроек: `settings.plugin.item`.
-  - Настройки: реестр DSH `settings.register("dsh-cost-meter", Config)` (валюта `currency`, множитель курса `usdRate`, таймзона `displayTimeZone`, опрос OpenRouter `useOpenRouter`, ручные ставки `prices`, сопоставление `modelMap`).
-  - Локализация: регистрация словарей через `ctx.locale.register("dsh-cost-meter", { en, ru })` с поддержкой переключения языков через `useActiveLocale(ctx)`.
-- API:
-  - HTTP `GET /dsh-cost-meter/state` (параметр `?models=...` для получения тарифов по задействованным моделям).
-- CLI:
-  - Управление через CLI харнесса: `dsh plugin --profile web add @goodandready/dsh-cost-meter`.
-- Документация:
-  - README.md, index.md, docs/testing/public-route.md, docs/testing/projection-lifecycle.md, docs/deployment/public-release.md.
-
-## 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.
-- Не копировать: Избыточные градиенты, внешние модальные окна, тяжелые тени, кастомные несогласованные шрифты.
-
-## Foundations
-- Цвета и роли:
-  - `--dsw-alias-label-primary`: основной текст, заголовки, суммы.
-  - `--dsw-alias-label-tertiary`: второстепенные пояснения, метки столбцов, чип без тарифа.
-  - `--dsw-alias-border-l2`: разделители секций и обводка панели.
-  - `--dsw-alias-bg-layer-2` / `--dsw-alias-bg-base`: подложка всплывающей панели и карточки настроек.
-  - `--dsw-alias-state-success-primary` / `--dsw-alias-state-success-tertiary`: подсветка льготного окна (не-пик).
-  - `--dsw-alias-state-warn-primary` / `--dsw-alias-state-warn-tertiary`: подсветка полного тарифа (пик).
-- Типографика:
-  - Системный стек шрифтов DSH, размер 12px, интерлиньяж 1.5.
-  - Обязательно `fontVariantNumeric: "tabular-nums"` для всех числовых колонок, токенов и таймеров.
-- Сетка и отступы:
-  - Чип: высота 22px, padding: 0 8px, gap: 6px, border-radius: 6px.
-  - Панель: padding: 12px 14px, border-radius: 10px, ширина 320px.
-  - Карточка настроек: нативный складной контейнер (`.dcm-card`) с шапкой, статусами-бейджами (`dcm-badge-ok`, `dcm-badge-warn`, `dcm-badge-bad`), 3 структурированными секциями (`Основные параметры`, `Каталог OpenRouter`, `Диагностика и статус`), защитой ввода и кнопкой сохранения (`dcm-btn-primary`).
-
-## Components & States
-- Чип:
-  - `Unknown Tariff`: отображает «тариф ?» в приглушённом цвете `label-tertiary`.
-  - `Flat Tariff`: фон `--dsw-alias-state-warn-tertiary`, текст `--dsw-alias-state-warn-primary`, заголовок «Единый тариф».
-  - `Off-Peak`: зелёная плашка успеха (льготный тариф).
-  - `Peak`: оранжевая плашка предупреждения (полный тариф).
-  - Таймер: время до смены тарифа с пониженной непрозрачностью (`opacity: 0.75`).
-- Панель:
-  - Заголовок с текущей моделью и статусом окна.
-  - Сетка тарифов за 1M токенов (не-пик / пик / единая ставка).
-  - Блок «Из чего сложилась сумма»:
-    - Список всех моделей сессии с токенами и суммарной стоимостью.
-    - Для модели без тарифа отображается статус `не указана стоимость` (`rate_unspecified`).
-  - Итог сессии: `Сессия: ≈ <валюта><сумма>`.
-  - Отсутствие мусорных служебных плашек (строка источника OpenRouter исключена).
-- Карточка настроек (`CostMeterCard`):
-  - Сворачиваемый заголовок с шевроном и иконкой счётчика.
-  - Статус снимка: `ready` (зелёный бейдж), `loading` (нейтральный), `unavailable` (серый).
-  - Поля: выбор символа валюты (`currency`), курс к USD (`usdRate`), таймзона отображения (`displayTimeZone`).
-  - Локализованные лейблы и плейсхолдеры на русском и английском языках.
-
-## User Flows
-1. Пользователь ведёт диалог с ассистентом: чип в шапке инкрементально обновляет потраченную сумму прямо во время стриминга ответа ассистента.
-2. Пользователь нажимает на чип: открывается всплывающая панель с тарифной сеткой и расходами по каждой модели сессии.
-3. Если модель не тарифицирована: в списке моделей выводится статус `не указана стоимость`.
-4. Пользователь открывает настройки DSH (`Настройки` -> `Плагины`): карточка `dsh-cost-meter` позволяет изменить валюту, курс и таймзону с мгновенным сохранением в `settingsScope`.
-
-## Do / Don't
-- Do:
-  - Использовать CSS-переменные DSH для согласованности с тёмной и светлой темами.
-  - Всегда разделять расходы по задействованным моделям.
-  - Использовать табличные цифры (`tabular-nums`) для предотвращения дёргания вёрстки при стриме.
-  - Использовать `ctx.locale.register` и `useActiveLocale` для всех строк интерфейса.
-- Don't:
-  - Не выводить техническую служебную информацию о каталоге OpenRouter в интерфейс пользователя.
-  - Не заменять отсутствие тарифа обманчивым нулём или невнятным прочерком — писать прямо `не указана стоимость`.
-  - Не допускать утечек локальных путей и инфраструктурных данных в коде или документации.
-
-## 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`).
-- 2026-09-05 (v0.7.4):
-  - Добавлена нативная карточка настроек в слот `settings.plugin.item` (`#12`).
-  - Реализована полная локализация клиентской части через `ctx.locale.register` (`#2`).
-  - Реализовано provider-aware разрешение тарифов OpenRouter vs DeepSeek (`#3`).
-  - Добавлены всеобъемлющие регрессионные тесты на проекцию и сопоставление (`test/projection-lifecycle.test.mjs`, `#1`).
-  - Закрыт issue о согласовании публичного scope пакета (`#13`).
-- 2026-09-05 (v0.7.3):
-  - Удалена строка источника цен OpenRouter.
-  - Список моделей в блоке «Из чего сложилась сумма» унифицирован и отображается для всех задействованных моделей сессии.
-  - Для нетарифицированных моделей введён явный статус «не указана стоимость».
-  - Пакет переведён на публичный scope `@goodandready/dsh-cost-meter`.

package/docs/plans/findings.md

@@ -1,17 +0,0 @@
-# Findings: Issue #25 (v0.8.1)
-
-## 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)$ даёт мгновенный расчёт без аллокации сотен объектов в секунду при активных сессиях.
-
-## 2. Разрешение тарифов на сервере
-- `resolveTariff(cfg, catalog.index, route)` перебирает регулярные выражения и суффиксы.
-- Кэширование в `Map<string, ResolvedTariff>` с очисткой при обновлении каталога полностью снимает нагрузку на CPU при частом пуллинге `/state` клиентами DSH.
-
-## 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,12 +0,0 @@
-# Progress: Issue #25 (v0.8.1)
-
-- **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,31 +0,0 @@
-# Task Plan: Issue #25 (v0.8.1) — Оптимизация производительности, ручная синхронизация каталога и подсказки экономии
-
-## Цели
-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 на прод.
-
-## Статус выполнения
-- [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

package/docs/testing/projection-lifecycle.md

@@ -1,28 +0,0 @@
-# Регрессионное тестирование проекции тарифов и жизненного цикла
-
-Тесты проверяют логику тарификации, парсинг временных окон UTC, сопоставление моделей и provider-aware разрешение ставок.
-
-## Запуск тестов
-
-```bash
-npm test
-```
-
-## Проверяемые сценарии (`test/projection-lifecycle.test.mjs`)
-
-1. **`hhmmToMinutes` и `parseWindow`**:
-   - Корректный разбор диапазонов `HH:MM-HH:MM` в минуты от начала суток UTC.
-   - Граничные условия: переход через полночь (`23:00-02:00`), пустые или невалидные строки.
-
-2. **`slotOf`**:
-   - Вычисление 30-минутного слота суток (`0..47`) на основе переданного timestamp.
-   - Независимость накопления расхода от текущего момента времени (сохранение исторической ставки слота).
-
-3. **`indexCatalog` и `matchModel`**:
-   - Индексация моделей OpenRouter с поддержкой поиска без учета регистра.
-   - Нормализация суффиксов вендоров и версий (например, `vendor/model:variant`).
-
-4. **`resolveTariff` (Provider-aware)**:
-   - Если указан `provider: "openrouter"`, плагин в первую очередь обращается к каталогу OpenRouter, даже если имя модели содержит `deepseek`.
-   - Если провайдер не `openrouter` (или `deepseek`), DeepSeek модели тарифицируются по официальной зашитой сетке (пик / не-пик).
-   - Ручные ставки `prices` из конфигурации имеют высший приоритет над внешними каталогами.

package/docs/testing/public-route.md

@@ -1,12 +0,0 @@
-# Проверка публичного маршрута
-
-1. Выполнить `npm test`.
-2. Проверить `npm pack --dry-run` и отсутствие локальных установочных ссылок,
-   абсолютных infra-путей, IP-адресов и секретов в поставляемых файлах.
-3. Собрать tarball из проверенного Git worktree.
-4. Установить tarball на изолированный тестовый DSH web server (MiniPC).
-5. Для browser half проверить loader id `@goodandready/dsh-cost-meter`, HTTP route
-   состояния `GET /dsh-cost-meter/state` и smoke-сценарий тарификации (список моделей,
-   расчёт стоимости, статус «не указана стоимость»); для host half — bundle identity и host smoke.
-6. Выполнить cleanup тестовой установки и убедиться, что постоянные плагины
-   сохранили работоспособность.