@goodandready/dsh-usage-guard 0.1.2 → 0.1.3

package/README.md

@@ -92,23 +92,41 @@ Before substituting zero, `dsh-usage-guard` scans an extensive dictionary of ind
 | `cacheReadTokens` | `cache_read_tokens`, `cachedTokens`, `cached_tokens`, `cache_read_input_tokens`, `cachedContentTokenCount`, `prompt_tokens_details.cached_tokens` |
 | `cacheWriteTokens` | `cache_write_tokens`, `cacheCreationTokens`, `cache_creation_input_tokens` |
 
-### 3. Finite Non-Negative Soundness Validation (`sound`)
-Strictly validates `typeof value === 'number' && Number.isFinite(value) && value >= 0` to filter out `NaN`, `Infinity`, `null`, `undefined`, negative error codes (e.g. `-1`), and malformed strings before they reach arithmetic operations.
+### 3. Finite Non-Negative Integer Soundness Validation (`sound`)
+Strictly validates `typeof value === 'number' && Number.isFinite(value) && value >= 0 && Number.isInteger(value)` to filter out `NaN`, `Infinity`, `null`, `undefined`, negative error codes (e.g. `-1`), non-integer floats, and malformed strings.
 
-### 4. Safe Zero Fallback (`repaired`)
-If a counter cannot be resolved from aliases, it is safely initialized to `0`. The choice is not between exact and approximate numbers, but between approximate token counts and an unreadable dead session.
+### 4. Safe Zero Fallback & Float Rounding (`repaired`)
+If a counter cannot be resolved from aliases, it is safely initialized to `0`. Fractional tokens or decimal strings are safely rounded via `Math.round()`, strictly satisfying the core DSH contract `z.number().int().nonnegative()`.
 
 ### 5. In-Memory Registry Monkey-Patching (`lib/patch.js`)
 * **Pre-existing Projections**: Wraps all `.apply` methods currently registered in `sessionProjections.registrations` while preserving full `this` context.
 * **Late-Binding Projections**: Traps future projection registrations via `map.set` wrapping, guaranteeing 100% coverage regardless of plugin loading order.
 * **Universal Projection Protection**: Protects not only token counters, but also context pressure calculators and busy-state analyzers.
-* **Zero Performance Overhead**: Uses shallow event cloning only along the usage path; all other event data references remain untouched.
+* **Zero Performance Overhead**: Uses shallow event cloning only along the usage path, while a high-performance `WeakMap` cache ensures single execution across all 10–15 parallel DSH projections.
 
 ### 6. Deduplicated Diagnostic Reporting (`told`)
-Logs informative diagnostic warnings naming the exact session, turn, step, raw payload, and recovery action (e.g. `inputTokens borrowed from alias` vs `inputTokens zeroed`). Incidents are deduplicated in memory so logs are not flooded during replays, and the cache is capped at 1,000 items to prevent memory leaks.
+Logs informative diagnostic warnings naming the exact session, turn, step, raw payload, and recovery action (e.g. `inputTokens borrowed from alias` vs `inputTokens zeroed`). Incidents are deduplicated in memory so logs are not flooded during replays, and the cache is bounded to 1,000 entries with O(1) FIFO eviction.
 
 ### 7. Native Web UI Settings Card (`lib/client.js`)
-* Mounts into the native Settings tab under `Settings → Plugins → Plugin Settings` (`settings.plugin.item`) with real-time status badge and full localization.
+* Mounts into the native Settings tab under `Settings → Plugins → Plugin Settings` (`settings.plugin.item`) with real-time status badge, auto-dismissing save feedback, and full localization.
+
+---
+
+## 🚀 Changed in v0.1.3
+
+* **Fractional Token Protection (Floats & Decimals)**:
+  - DeepSeek Harness `@deepseek-ai/dsh-token-meter` projection schema enforces strict integers (`z.number().int().nonnegative()`). Fractional tokens (e.g. `42.5` or `"1540.2"` produced by routing proxies or weighted estimators) previously broke Zod schema validation.
+  - `sound()` now strictly validates `Number.isInteger(value)`.
+  - Floating-point numbers and decimal strings are now safely rounded to non-negative integers via `Math.round()` (`42.6` $\rightarrow$ `43`), protecting session history from schema rejections.
+* **High-Performance WeakMap Cache (`guard`)**:
+  - DSH executes 10–15 parallel projection folds for every session event.
+  - A `WeakMap<event, guardedEvent>` cache sanitizes each incoming event exactly once on the first projection, returning the cached normalized reference to all subsequent projections in $O(1)$ without re-parsing or memory leak risks.
+* **Strict O(1) FIFO Eviction in `told` Warning Cache**:
+  - Replaced bulk `told.clear()` with individual oldest key eviction `told.delete(oldest)` at 1,000 entries, maintaining continuous deduplication without sudden re-logging storms.
+* **Web UI Settings Card UX & A11y Polish**:
+  - Save status confirmation ("Saved") now automatically auto-dismisses after 3 seconds and clears immediately upon toggle adjustment.
+  - Added reactive external synchronization with server-side config changes when the user has no uncommitted draft.
+  - Enhanced accessibility: connected inputs to labels via `htmlFor`/`id` and tagged the chevron icon with `aria-hidden="true"`.
 
 ---
 

package/README.ru.md

@@ -92,23 +92,41 @@ graph LR
 | `cacheReadTokens` | `cache_read_tokens`, `cachedTokens`, `cached_tokens`, `cache_read_input_tokens`, `cachedContentTokenCount`, `prompt_tokens_details.cached_tokens` |
 | `cacheWriteTokens` | `cache_write_tokens`, `cacheCreationTokens`, `cache_creation_input_tokens` |
 
-### 3. Проверка на конечное неотрицательное число (`sound`)
-Проверка `typeof value === 'number' && Number.isFinite(value) && value >= 0` гарантирует отсечение `NaN`, `Infinity`, `null`, `undefined`, отрицательных чисел (напр. `-1` при ошибках прокси) и строк.
+### 3. Проверка на конечное неотрицательное целое число (`sound`)
+Проверка `typeof value === 'number' && Number.isFinite(value) && value >= 0 && Number.isInteger(value)` гарантирует отсечение `NaN`, `Infinity`, `null`, `undefined`, отрицательных чисел (напр. `-1`), нецелых дробей (floats) и строк.
 
-### 4. Безопасная подстановка нуля (`repaired`)
-Если число найти не удалось, подставляется `0`. Выбор делается в пользу приблизительного счёта вместо полностью заблокированной истории.
+### 4. Безопасная подстановка нуля и округление (`repaired`)
+Если число найти не удалось, подставляется `0`. Валидные дробные токены или числовые строки округляются до целых через `Math.round()`, строго удовлетворяя Zod-контракту ядра DSH `z.number().int().nonnegative()`.
 
 ### 5. Безопасный перехват в памяти (`lib/patch.js`)
 * **Существующие проекции**: оборачивает все методы `.apply` в `sessionProjections.registrations` с полным сохранением контекста `this`.
 * **Поздние проекции**: перехватывает будущие регистрации через хук `map.set`.
 * **Комплексная защита**: защищает не только токены, но и формулы давления на контекст и разбор занятости.
-* **Нулевой оверхед**: поверхностное клонирование применяется только к объекту расхода.
+* **Нулевой оверхед**: поверхностное клонирование применяется только к объекту расхода, а `WeakMap` устраняет повторные вызовы при обходе 10–15 проекций DSH.
 
 ### 6. Дедуплицированное журналирование (`told`)
-Выводит предупреждение с идентификатором сессии, номером хода, шагом и способом починки (взят по синониму или обнулён). Одинаковые инциденты не спамят в лог при повторных проигрываниях, а размер кэша ограничен 1000 записей для предотвращения утечек памяти.
+Выводит предупреждение с идентификатором сессии, номером хода, шагом и способом починки (взят по синониму или обнулён). Одинаковые инциденты не спамят в лог при повторных проигрываниях, а размер кэша ограничен 1000 записями с честным O(1) FIFO-вытеснением для предотвращения утечек памяти.
 
 ### 7. Нативная карточка в Web UI (`lib/client.js`)
-* Карточка настроек встроена во вкладку «Настройки → Плагины → Настройки плагинов» (`settings.plugin.item`) с динамическим бейджем статуса и полной локализацией.
+* Карточка настроек встроена во вкладку «Настройки → Плагины → Настройки плагинов» (`settings.plugin.item`) с динамическим бейджем статуса, плавно исчезающим подтверждением сохранения и полной локализацией.
+
+---
+
+## 🚀 Изменения в версии v0.1.3 (Changed in v0.1.3)
+
+* **Защита от дробных токенов (Floats & Decimals)**:
+  - Схема валидации DSH ядра `@deepseek-ai/dsh-token-meter` требует строго целые числа (`z.number().int().nonnegative()`). Дробные токены (например, `42.5` или `"1540.2"` при усреднении или конвертации весов моделями) ранее приводили к падению схемы Zod.
+  - В v0.1.3 функция `sound()` строго требует `Number.isInteger(value)`.
+  - Все дробные числа и числовые строки с плавающей точкой теперь безопасно и корректно округляются через `Math.round()` (`42.6` $\rightarrow$ `43`), сохраняя читаемость истории сессий.
+* **Высокопроизводительное WeakMap-кэширование (`guard`)**:
+  - В DSH активно 10–15 параллельных проекций, каждая из которых вызывала перехватчик `apply()`.
+  - Внедрён микрокэш на базе `WeakMap<event, guardedEvent>`. Санитизация события выполняется ровно 1 раз при первой проекции, а остальные 14 проекций получают уже нормализованное событие за $O(1)$ без лишнего клонирования и без риска утечек памяти.
+* **Честное FIFO-вытеснение в кэше логов (`told`)**:
+  - Заменена полная очистка `told.clear()` на удаление старейшей записи `told.delete(oldest)` за $O(1)$ при достижении лимита в 1000 записей, что предотвращает повторные лавины логов при открытии старых диалогов.
+* **Улучшение UX и доступности Web UI карточки настроек**:
+  - Сообщение об успешном сохранении («Сохранено») теперь плавно исчезает через 3 секунды и мгновенно сбрасывается при любом изменении переключателей.
+  - Добавлена реактивная синхронизация настроек с фоновыми изменениями сервера при нередактируемом драфте.
+  - Улучшена доступность: добавлены атрибуты `id` и `htmlFor` к полям формы, а иконке шеврона проставлен `aria-hidden="true"`.
 
 ---
 

package/README.zh.md

@@ -77,11 +77,29 @@ graph LR
 
 1. **已损坏历史记录免修文件即刻复活**：不修改磁盘日志，在内存重放链路拦截修复；
 2. **主流别名字典智能提取 (`borrowed`)**：覆盖 `prompt_tokens`、`completion_tokens`、`cached_tokens`、`promptTokenCount`、`prompt_eval_count` 等；
-3. **非负有限数字安全性校验 (`sound`)**：剔除 `NaN`、`Infinity`、负数错误码（如 `-1`）与非法格式；
-4. **安全 0 值兜底 (`repaired`)**：彻底阻断算术污染；
-5. **内存投影注册表动态切入 (`lib/patch.js`)**：无缝覆盖前置与后置投影，完整保留 `this` 上下文；
-6. **防刷屏告警与内存保护 (`told`)**：集成会话识别与容量上限（1,000 项），杜绝内存泄漏与误抑制；
-7. **原生 Web UI 设置卡片 (`lib/client.js`)**：嵌入 DSH 原生设置中心（`settings.plugin.item`），实时状态徽章与多语言支持。
+3. **严格非负整数有效性校验 (`sound`)**：剔除 `NaN`、`Infinity`、负数错误码（如 `-1`）、非整数浮点数与非法字符串；
+4. **安全 0 值兜底与浮点自动取整 (`repaired`)**：浮点数值与带小数数字字符串通过 `Math.round()` 转换为有效非负整数，彻底满足 Zod `z.number().int().nonnegative()` 模式校验；
+5. **内存投影注册表动态切入与 WeakMap 高性能缓存 (`lib/patch.js`, `lib/index.js`)**：无缝覆盖全部 10–15 个并发投影，同一事件仅处理一次，其余投影 $O(1)$ 快速返回；
+6. **防刷屏告警与 O(1) FIFO 内存保护 (`told`)**：容量上限为 1,000 项，达到上限时平滑淘汰最老记录，杜绝内存泄漏与误抑制；
+7. **原生 Web UI 设置卡片 (`lib/client.js`)**：嵌入 DSH 原生设置中心（`settings.plugin.item`），实时状态徽章、3 秒自动消失保存提示与多语言支持。
+
+---
+
+## 🚀 v0.1.3 版本更新说明 (Changed in v0.1.3)
+
+* **浮点与小数 Token 防崩保护 (Floats & Decimals)**：
+  - DeepSeek Harness `@deepseek-ai/dsh-token-meter` 的投影模式严格要求整数 (`z.number().int().nonnegative()`)。部分路由网关返回的非整数计数（如 `42.5`）此前会导致 Zod 校验失败。
+  - `sound()` 函数在 v0.1.3 中严格要求 `Number.isInteger(value)`。
+  - 浮点数及带小数点的数字字符串通过 `Math.round()` 自动四舍五入为有效非负整数（`42.6` $\rightarrow$ `43`），确保会话历史永不白屏。
+* **WeakMap 高性能事件缓存 (`guard`)**：
+  - 会话重放时有 10–15 个并发投影同时调用拦截器。
+  - 引入 `WeakMap<event, guardedEvent>` 微缓存：事件在首次调用时清洗并缓存，其余并发投影直接以 $O(1)$ 获取结果，消除重复克隆并杜绝内存泄漏。
+* **日志告警缓存 FIFO 平滑淘汰 (`told`)**：
+  - 将达到 1,000 条上限时的全量清空 `told.clear()` 改为 $O(1)$ 单条最旧数据淘汰 `told.delete(oldest)`，避免重新打开历史会话时日志重复刷屏。
+* **Web UI 设置卡片交互体验与无障碍优化**：
+  - 保存成功提示（"已保存"）支持 3 秒自动平滑淡出，且在修改任一复选框时立即重置。
+  - 支持在无未提交草稿时平滑同步服务端后台配置。
+  - 为表单项绑定 `id`/`htmlFor` 关联，并为折叠图标补充 `aria-hidden="true"` 无障碍属性。
 
 ---
 

package/lib/client.js

@@ -22,6 +22,8 @@ window.__ModuleLoader__.load({
         stroke: 'currentColor',
         strokeWidth: 1.5,
         style: props.style,
+        className: props.className,
+        'aria-hidden': true,
       }, React.createElement('path', { d: 'M3.5 5.25L7 8.75L10.5 5.25' }));
     }
     const Chevron = ChevronIcon || FallbackChevron;
@@ -34,6 +36,14 @@ window.__ModuleLoader__.load({
       const [msg, setMsg] = React.useState('');
 
       const initializedRef = React.useRef(false);
+      const isDirtyRef = React.useRef(false);
+      const msgTimerRef = React.useRef(null);
+
+      React.useEffect(() => {
+        return () => {
+          if (msgTimerRef.current) clearTimeout(msgTimerRef.current);
+        };
+      }, []);
 
       React.useEffect(() => {
         let off = null;
@@ -46,7 +56,7 @@ window.__ModuleLoader__.load({
           const update = () => {
             const s = scope.getSnapshot ? scope.getSnapshot() : { status: 'unavailable', value: null };
             setSnap(s);
-            if (s.status === 'ready' && s.value && !initializedRef.current) {
+            if (s.status === 'ready' && s.value && (!initializedRef.current || !isDirtyRef.current)) {
               initializedRef.current = true;
               setDraft({
                 repair: s.value.repair ?? true,
@@ -72,12 +82,22 @@ window.__ModuleLoader__.load({
         }
       })();
 
+      const showMessage = (text, autoDismiss = false) => {
+        if (msgTimerRef.current) clearTimeout(msgTimerRef.current);
+        setMsg(text);
+        if (autoDismiss) {
+          msgTimerRef.current = setTimeout(() => {
+            setMsg('');
+          }, 3000);
+        }
+      };
+
       const onSave = async () => {
         setSaving(true);
         setMsg('');
         try {
           if (!ctx.settingsScope || !ctx.settingsScope.bind) {
-            setMsg('settingsScope unavailable');
+            showMessage('settingsScope unavailable', false);
             setSaving(false);
             return;
           }
@@ -91,16 +111,26 @@ window.__ModuleLoader__.load({
             }
           }
           if (errs.length) {
-            setMsg(errs.join('; '));
+            showMessage(errs.join('; '), false);
           } else {
-            setMsg(t('saved') || 'Saved');
+            isDirtyRef.current = false;
+            showMessage(t('saved') || 'Saved', true);
           }
         } catch (e) {
-          setMsg(String(e && e.message ? e.message : e));
+          showMessage(String(e && e.message ? e.message : e), false);
         }
         setSaving(false);
       };
 
+      const handleToggle = (field, checked) => {
+        isDirtyRef.current = true;
+        if (msg) {
+          if (msgTimerRef.current) clearTimeout(msgTimerRef.current);
+          setMsg('');
+        }
+        setDraft((prev) => ({ ...prev, [field]: checked }));
+      };
+
       const isRepairActive = draft.repair !== false;
       const badgeLabel = isRepairActive ? (t('active') || 'ACTIVE') : (t('reportOnly') || 'REPORT ONLY');
       const badgeClass = isRepairActive ? 'ug-badge ug-badge-green' : 'ug-badge ug-badge-yellow';
@@ -132,32 +162,34 @@ window.__ModuleLoader__.load({
           React.createElement('span', { className: 'ug-title' }, t('title') || 'Usage Guard'),
           React.createElement('span', { className: 'ug-sub' }, t('subtitle') || 'Token-usage sanitizer & session crash protection'),
           React.createElement('span', { className: badgeClass }, badgeLabel),
-          React.createElement(Chevron, { className: 'ug-chev' + (expanded ? ' ug-chev-open' : '') })
+          React.createElement(Chevron, { className: 'ug-chev' + (expanded ? ' ug-chev-open' : ''), 'aria-hidden': true })
         ),
         expanded ? React.createElement('div', { className: 'ug-body' },
           snap.status === 'loading' ? React.createElement('div', { className: 'ug-field', style: { color: 'var(--dsw-alias-label-secondary)', fontSize: 13 } }, t('loading') || 'Loading…') : null,
           snap.status === 'unavailable' ? React.createElement('div', { className: 'ug-field', style: { color: 'var(--dsw-alias-label-secondary)', fontSize: 13 } }, t('unavailable') || 'Settings scope unavailable') : null,
           snap.status === 'ready' ? React.createElement('div', null,
             React.createElement('div', { className: 'ug-field' },
-              React.createElement('label', { className: 'ug-row' },
+              React.createElement('label', { className: 'ug-row', htmlFor: 'ug-repair-toggle' },
                 React.createElement('span', null, t('repair') || 'Auto-repair token counters'),
                 React.createElement('input', {
+                  id: 'ug-repair-toggle',
                   type: 'checkbox',
                   className: 'ug-checkbox',
                   checked: !!draft.repair,
-                  onChange: (e) => setDraft({ ...draft, repair: e.target.checked }),
+                  onChange: (e) => handleToggle('repair', e.target.checked),
                 })
               ),
               React.createElement('div', { className: 'ug-sub' }, t('repairDesc') || 'Replace missing or non-numeric counters with 0 before summing to prevent NaN history lockups')
             ),
             React.createElement('div', { className: 'ug-field' },
-              React.createElement('label', { className: 'ug-row' },
+              React.createElement('label', { className: 'ug-row', htmlFor: 'ug-report-toggle' },
                 React.createElement('span', null, t('report') || 'Log diagnostic warnings'),
                 React.createElement('input', {
+                  id: 'ug-report-toggle',
                   type: 'checkbox',
                   className: 'ug-checkbox',
                   checked: !!draft.report,
-                  onChange: (e) => setDraft({ ...draft, report: e.target.checked }),
+                  onChange: (e) => handleToggle('report', e.target.checked),
                 })
               ),
               React.createElement('div', { className: 'ug-sub' }, t('reportDesc') || 'Log a line naming the turn, step, and raw sample whenever damaged usage arrives')

package/lib/index.js

@@ -59,22 +59,39 @@ export function apply(ctx, config) {
   // О каждом сочетании сессии, хода, шага и набора полей жалуемся один раз:
   // выжимка считается проигрыванием журнала заново, и без этого одна и та же
   // порция въезжала бы в журнал при каждом открытии истории.
-  // Ограничиваем размер (до 1000 записей), чтобы исключить утечку памяти.
+  // Честное FIFO-вытеснение с ограничением в 1000 записей предотвращает утечку
+  // памяти при длительной работе без сброса всей накопленной дедупликации.
   const told = new Set()
   const MAX_TOLD = 1000
 
+  // Кэш санитизированных событий: каждое событие проходит через 10-15 проекций DSH.
+  // WeakMap позволяет обработать событие один раз, отдавая остальным проекциям
+  // готовый результат за O(1) без повторного парсинга и без утечек памяти.
+  const eventCache = new WeakMap()
+
   const guard = (event) => {
+    if (!event || typeof event !== 'object') return event
+    const cached = eventCache.get(event)
+    if (cached !== undefined) return cached
+
     const found = usageOf(event)
-    if (!found) return event
+    if (!found) {
+      eventCache.set(event, event)
+      return event
+    }
     const bad = damage(found.usage)
-    if (bad.length === 0) return event
+    if (bad.length === 0) {
+      eventCache.set(event, event)
+      return event
+    }
 
     if (live.report !== false) {
       const sessionTag = event?.sessionId ?? event?.data?.sessionId ?? event?.data?.turn ?? 'global'
       const seen = `${String(sessionTag)}/${String(found.turn)}/${String(found.step)}/${bad.join(',')}`
       if (!told.has(seen)) {
         if (told.size >= MAX_TOLD) {
-          told.clear()
+          const oldest = told.values().next().value
+          told.delete(oldest)
         }
         told.add(seen)
         try {
@@ -86,7 +103,9 @@ export function apply(ctx, config) {
       }
     }
 
-    return live.repair === false ? event : healed(event, bad)
+    const result = live.repair === false ? event : healed(event, bad)
+    eventCache.set(event, result)
+    return result
   }
 
   ctx.inject(['sessionProjections'], (pctx) => {

package/lib/usage.js

@@ -1,13 +1,16 @@
-// Чистая часть заплатки: что считать испорченной порцией расхода и во что её
-// превращать. Ни контекста, ни сети — поэтому проверяется тестами целиком.
-
-/**
- * Поля, из которых харнесс собирает свои четыре ведра.
- *
- * Два первых он берёт как есть, два вторых подстраховывает нулём. Отсюда и весь
- * сыр-бор: провайдер, приславший порцию без `inputTokens`, роняет не свой
- * счётчик, а всю историю сессии.
- */
+// Счётчики токенов: что проверяем и как чиним.
+//
+// Харнесс складывает расход в четыре ведра:
+//
+//     uncachedInputTokens: usage.inputTokens,
+//     outputTokens:        usage.outputTokens,
+//     cacheReadTokens:     usage.cacheReadTokens ?? 0,
+//     cacheWriteTokens:    usage.cacheWriteTokens ?? 0,
+//
+// Первые два он берёт без проверки. Сложение `total += undefined` даёт NaN,
+// а проверка схемы в ядре требует неотрицательное целое число (zod.int().nonnegative()).
+// Из-за этого одна битая порция валит не просто
+// счётчик, а всю историю сессии.
 export const FIELDS = ['inputTokens', 'outputTokens', 'cacheReadTokens', 'cacheWriteTokens']
 
 /**
@@ -51,25 +54,28 @@ const ALIASES = {
 }
 
 /**
- * Годное значение счётчика: конечное неотрицательное число.
- * Значения меньше нуля (-1 и т.д.) или нечисловые не признаются годными,
- * так как схема DSH требует nonnegative integer.
+ * Годное значение счётчика: конечное неотрицательное ЦЕЛОЕ число.
+ * Значения меньше нуля (-1 и т.д.), нечисловые, а также дробные числа (floats)
+ * не признаются годными, так как схема ядра DSH требует z.number().int().nonnegative().
  */
 function sound(value) {
-  return typeof value === 'number' && Number.isFinite(value) && value >= 0
+  return typeof value === 'number' && Number.isFinite(value) && value >= 0 && Number.isInteger(value)
 }
 
 /**
- * Приведение значения к корректному неотрицательному числу.
- * Поддерживает числа и строковые представления целых неотрицательных чисел (напр. "1540").
+ * Безопасное приведение значения к корректному неотрицательному целому числу.
+ * Округляет дробные числа и парсит числовые строки (в т.ч. с десятичной точкой).
  */
 function coerceNumber(value) {
   if (typeof value === 'number') {
-    return Number.isFinite(value) && value >= 0 ? value : undefined
+    return Number.isFinite(value) && value >= 0 ? Math.round(value) : undefined
   }
-  if (typeof value === 'string' && /^\d+$/.test(value.trim())) {
-    const num = Number(value.trim())
-    return Number.isFinite(num) && num >= 0 ? num : undefined
+  if (typeof value === 'string') {
+    const trimmed = value.trim()
+    if (/^\d+(\.\d+)?$/.test(trimmed)) {
+      const num = Number(trimmed)
+      return Number.isFinite(num) && num >= 0 ? Math.round(num) : undefined
+    }
   }
   return undefined
 }
@@ -100,8 +106,8 @@ export function usageOf(event) {
  *
  * Отсутствие кэш-полей нарушением не считается: их не присылает добрая половина
  * провайдеров, и харнесс сам подставляет там ноль. Ругаемся только на то, что
- * действительно ломает сложение, — на пропущенные, нечисловые или отрицательные
- * значения тех полей, которые харнесс берёт без оглядки, либо на невалидные кэш-поля.
+ * действительно ломает сложение, — на пропущенные, нечисловые, нецелые или
+ * отрицательные значения.
  */
 export function damage(usage) {
   if (!usage || typeof usage !== 'object') return FIELDS.slice(0, 2)
@@ -116,8 +122,8 @@ export function damage(usage) {
 }
 
 /**
- * Число под одним из привычных чужих имён, вложенных структур или строковых чисел.
- * Возвращает валидное неотрицательное число или `undefined`, если его там нет.
+ * Число под одним из привычных чужих имён, вложенных структур или числовых строк/дробей.
+ * Возвращает валидное целое неотрицательное число или `undefined`, если его там нет.
  */
 export function borrowed(usage, field) {
   if (!usage || typeof usage !== 'object') return undefined
@@ -135,7 +141,7 @@ export function borrowed(usage, field) {
     if (num !== undefined) return num
   }
 
-  // 3. Само поле, если оно было передано валидной строкой (напр. "123")
+  // 3. Само поле, если оно было передано валидной строкой или нецелым числом (напр. "123" или 15.4)
   const selfNum = coerceNumber(usage[field])
   if (selfNum !== undefined) return selfNum
 
@@ -145,11 +151,9 @@ export function borrowed(usage, field) {
 /**
  * Порция с обезвреженными счётчиками.
  *
- * Сначала ищем число под чужим именем, и только если его нет — ставим ноль.
- * Ноль здесь заведомо неправда, но выбор не между точным счётом и
- * приблизительным, а между приблизительным и нечитаемой историей. Остальные
- * поля порции остаются как были: чиним арифметику, а не переписываем ответ
- * провайдера.
+ * Сначала ищем число под чужим именем или нормализуем само поле (округление float/string),
+ * и только если его нет — ставим ноль.
+ * Чиним арифметику, а не переписываем остальной ответ провайдера.
  */
 export function repaired(usage, bad) {
   const fixed = usage && typeof usage === 'object' ? { ...usage } : {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-usage-guard",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Keeps a malformed token-usage sample from taking a whole session history down with it: a missing or non-numeric counter becomes zero before the harness adds it up, so the fold never yields NaN and already-broken sessions open again.",
   "keywords": [
     "deepseek-harness",