@goodandready/dsh-usage-guard 0.1.3 → 0.1.5

package/README.md

@@ -112,6 +112,24 @@ Logs informative diagnostic warnings naming the exact session, turn, step, raw p
 
 ---
 
+## 🚀 Changed in v0.1.5
+
+* **Strict `settings.plugin.item` Registration (#3)**:
+  Completely removed the deprecated fallback registration into `settings.section`. In compliance with DSH Plugin Authoring guidelines, settings are rendered exclusively in the "Settings → Plugins" tab (`settings.plugin.item`) with key `dsh-usage-guard` without cluttering the global sidebar.
+* **Refined Client Architecture**:
+  Cleaned up the browser bundle to register strictly one slot entry with zero runtime fallback delays.
+
+## 🚀 Changed in v0.1.4
+
+* **Style Isolation with `data-dsh-plugin`**:
+  Dynamic `<style>` element is explicitly tagged with `data-dsh-plugin="dsh-usage-guard"`, preventing style purging during neighbor plugin reloads or HMR.
+* **Direct Slot Registration**:
+  Replaced broken invocation pattern with standard `ctx.slots.register('settings.plugin.item', ...)`.
+* **Canonical Localization Standard**:
+  Streamlined client registration to strictly register the canonical English locale dictionary, delegating localized user interfaces to DSH translation plugins.
+* **Safe Configuration Loading & English Diagnostics**:
+  Protected `Config()` initialization with `try...catch` and migrated diagnostic log messages to English.
+
 ## 🚀 Changed in v0.1.3
 
 * **Fractional Token Protection (Floats & Decimals)**:

package/README.ru.md

@@ -112,6 +112,24 @@ graph LR
 
 ---
 
+## 🚀 Изменения в версии v0.1.5 (Changed in v0.1.5)
+
+* **Строгая регистрация в `settings.plugin.item` (#3)**:
+  Полностью удалена устаревшая ветка регистрации в боковом меню `settings.section`. По канону DSH Plugin Authoring карточка настроек размещается исключительно во вкладке «Настройки → Плагины» (`settings.plugin.item`) с ключом `dsh-usage-guard`, не занимая ограниченный ресурс бокового списка.
+* **Очистка клиентской архитектуры**:
+  Регистрация интерфейса упрощена до единственного прямого вызова без задержек и fallback-таймеров.
+
+## 🚀 Изменения в версии v0.1.4 (Changed in v0.1.4)
+
+* **Изоляция стилей через `data-dsh-plugin`**:
+  Динамический тег `<style>` помечен атрибутом `data-dsh-plugin="dsh-usage-guard"`, предотвращая сброс стилей карточки при HMR или обновлении соседних плагинов.
+* **Прямая регистрация слота**:
+  Заменён некорректный вызов `ctx.slots.inject()` на прямой `ctx.slots.register('settings.plugin.item', ...)`.
+* **Канонический стандарт локализации**:
+  Клиентский модуль регистрирует только канонический словарь `en`, передавая управление переводами системному translation-плагину.
+* **Безопасная инициализация и англоязычные логи**:
+  Вызов `Config()` защищён блоком `try...catch`, а системные предупреждения в консоли переведены на английский язык.
+
 ## 🚀 Изменения в версии v0.1.3 (Changed in v0.1.3)
 
 * **Защита от дробных токенов (Floats & Decimals)**:

package/README.zh.md

@@ -85,6 +85,24 @@ graph LR
 
 ---
 
+## 🚀 v0.1.5 版本更新说明 (Changed in v0.1.5)
+
+* **规范设置卡片插槽注册 (#3)**:
+  彻底移除废弃的顶层侧边栏 `settings.section` 回退逻辑。严格遵循 DSH Plugin Authoring 规范，卡片仅注册至“设置 → 插件”标签页（`settings.plugin.item`），键名与命名空间一致为 `dsh-usage-guard`，不再占用全局侧边栏资源。
+* **精简前端注册流**:
+  客户端模块仅保留标准单一插槽注册，无任何额外回退延时。
+
+## 🚀 v0.1.4 版本更新说明 (Changed in v0.1.4)
+
+* **样式隔离标记 `data-dsh-plugin`**:
+  动态 `<style>` 标签附加 `data-dsh-plugin="dsh-usage-guard"` 属性，避免被相邻插件的热重载清理机制误删。
+* **修复插槽直接注册**:
+  替换无效的 `ctx.slots.inject()` 调用为直接标准 `ctx.slots.register('settings.plugin.item', ...)`。
+* **规范化单一英文字典**:
+  客户端仅保留基础英语字典，翻译工作完全交由 DSH 核心翻译插件运行时接管。
+* **安全配置初始化与全英文诊断**:
+  `Config()` 初始化增加 `try...catch` 防护，控制台输出全面切换为标准英语日志。
+
 ## 🚀 v0.1.3 版本更新说明 (Changed in v0.1.3)
 
 * **浮点与小数 Token 防崩保护 (Floats & Decimals)**：

package/lib/client.js

@@ -136,7 +136,7 @@ window.__ModuleLoader__.load({
       const badgeClass = isRepairActive ? 'ug-badge ug-badge-green' : 'ug-badge ug-badge-yellow';
 
       return React.createElement('div', { className: 'ug-card' },
-        React.createElement('style', null, `
+        React.createElement('style', {'data-dsh-plugin': 'dsh-usage-guard'}, `
           .ug-card { border:1px solid var(--dsw-alias-border-l2); background:var(--dsw-alias-bg-layer-3); border-radius:12px; list-style:none }
           .ug-head { appearance:none; width:100%; font:inherit; color:inherit; text-align:left; cursor:pointer; background:0 0; border:0; border-radius:12px; display:flex; align-items:center; gap:12px; padding:14px 16px }
           .ug-title { color:var(--dsw-alias-label-primary); font-size:15px; font-weight:600; line-height:1.4 }
@@ -226,81 +226,24 @@ window.__ModuleLoader__.load({
             report: 'Log diagnostic warnings',
             reportDesc: 'Log a line naming the turn, step, and raw sample whenever damaged usage arrives.',
           },
-          ru: {
-            title: 'Защита истории токенов',
-            subtitle: 'Санитайзер расхода токенов и защита от сбоев истории',
-            active: 'АКТИВЕН',
-            reportOnly: 'ТОЛЬКО ЛОГ',
-            saved: 'Сохранено',
-            loading: 'Загрузка…',
-            unavailable: 'Пространство настроек недоступно',
-            save: 'Сохранить',
-            saving: 'Сохранение…',
-            repair: 'Автоматическое исправление расхода',
-            repairDesc: 'Подставлять ноль вместо повреждённых счётчиков до сложения для предотвращения блокировки истории диалогов.',
-            report: 'Диагностические предупреждения',
-            reportDesc: 'Логировать номер хода, шага и исходные данные при обнаружении битой порции расхода.',
-          },
-          zh: {
-            title: '用量与会话防崩守卫',
-            subtitle: 'Token 用量数据清洗与历史记录防白屏保护',
-            active: '已激活',
-            reportOnly: '仅记录',
-            saved: '已保存',
-            loading: '加载中…',
-            unavailable: '设置作用域不可用',
-            save: '保存',
-            saving: '保存中…',
-            repair: '自动修复用量计数',
-            repairDesc: '在累加前将缺失或非数字计数置为 0，彻底防止 NaN 导致会话历史永久白屏。',
-            report: '记录诊断告警',
-            reportDesc: '当检测到异常用量数据包时，在控制台记录轮次、步骤和原始数据。',
-          },
         });
       } catch (_) {}
 
-      let placed = false;
+      // Register exclusively in settings.plugin.item (DSH Settings → Plugins tab).
+      // Custom top-level sidebar sections (settings.section) are forbidden for simple plugin settings cards.
       try {
-        if (ctx.slots && typeof ctx.slots.inject === 'function') {
-          ctx.slots.inject('settings.plugin.item', () => {
-            placed = true;
-            ctx.slots.register(
-              {
-                name: 'settings.plugin.item',
-                key: NS,
-                locale: NS,
-                inject: () => ({ ctx }),
-              },
-              PluginCard,
-            );
-          });
+        if (ctx.slots && typeof ctx.slots.register === 'function') {
+          ctx.slots.register(
+            {
+              name: 'settings.plugin.item',
+              key: NS,
+              locale: NS,
+              inject: () => ({ ctx }),
+            },
+            PluginCard,
+          );
         }
       } catch (_) {}
-
-      const timer = setTimeout(() => {
-        if (placed) return;
-        try {
-          if (ctx.slots && typeof ctx.slots.inject === 'function') {
-            ctx.slots.inject('settings.section', () => {
-              ctx.slots.register(
-                {
-                  name: 'settings.section',
-                  id: '@goodandready/dsh-usage-guard',
-                  order: 50,
-                  locale: NS,
-                  label: () => (ctx.locale && ctx.locale.bind ? ctx.locale.bind(NS)('title') : 'Usage Guard'),
-                  inject: () => ({ ctx }),
-                },
-                PluginCard,
-              );
-            });
-          }
-        } catch (_) {}
-      }, 3000);
-
-      if (typeof ctx.effect === 'function') {
-        ctx.effect(() => () => clearTimeout(timer), 'dsh-usage-guard: fallback section');
-      }
     };
 
     return module.exports;

package/lib/index.js

@@ -48,7 +48,12 @@ export const Config = z.object({
 })
 
 export function apply(ctx, config) {
-  let live = Config(structuredClone(config ?? {})) ?? config
+  let live
+  try {
+    live = Config(structuredClone(config ?? {})) ?? config
+  } catch (_) {
+    live = Config({}) ?? {}
+  }
 
   ctx.inject(['settings'], (sctx) => {
     const scope = sctx.settings.register(name, Config, { base: config })

package/lib/patch.js

@@ -58,16 +58,19 @@ export function patchRegistry(registry, guard) {
   }
 
   // Заведутся позже — поймаем на укладке в карту.
-  const set = map.set
-  if (!set[PATCHED]) {
+  // Save the current map.set (may be the prototype method or a previous patched version).
+  // We restore via explicit assignment — relying on `delete` to restore the prototype method
+  // is fragile when the environment mutates Map.prototype.
+  const originalSet = map.set
+  if (!originalSet[PATCHED]) {
     const patched = function (key, value) {
       if (value && value.def) undo.push(wrapApply(value.def, guard))
-      return set.call(this, key, value)
+      return originalSet.call(this, key, value)
     }
     patched[PATCHED] = true
     map.set = patched
     undo.push(() => {
-      if (map.set === patched) delete map.set
+      if (map.set === patched) map.set = originalSet
     })
   }
 

package/lib/usage.js

@@ -194,16 +194,16 @@ function safeStringify(value) {
     try {
       return String(value)
     } catch {
-      return '[не сериализуется]'
+      return '[not serializable]'
     }
   }
 }
 
 /** Короткая строка для журнала: по ней видно, кого звать к ответу. */
 export function complaint(found, bad) {
-  const where = `ход ${String(found.turn)}, шаг ${String(found.step)}`
+  const where = `turn ${String(found.turn)}, step ${String(found.step)}`
   const taken = bad
-    .map((field) => (found.usage && borrowed(found.usage, field) !== undefined ? `${field} взят по синониму` : `${field} обнулён`))
+    .map((field) => (found.usage && borrowed(found.usage, field) !== undefined ? `${field} recovered via alias` : `${field} zeroed`))
     .join('; ')
-  return `порция расхода не по форме — ${where}; пришло: ${safeStringify(found.usage)}; ${taken}`
+  return `malformed usage sample — ${where}; received: ${safeStringify(found.usage)}; ${taken}`
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-usage-guard",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "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",
@@ -54,4 +54,4 @@
   "scripts": {
     "test": "node --test test/*.test.mjs"
   }
-}
+}