@goodandready/dsh-usage-guard 0.1.4 → 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

@@ -229,10 +229,8 @@ window.__ModuleLoader__.load({
         });
       } catch (_) {}
 
-      // Try to register in the settings.plugin.item slot (DSH Settings → Plugins tab).
-      // The slot key must match the settings namespace (NS) for the tab to find our card.
-      // If the slot is not available (older DSH build), fall back to a top-level settings.section.
-      let primaryRegistered = 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.register === 'function') {
           ctx.slots.register(
@@ -244,29 +242,8 @@ window.__ModuleLoader__.load({
             },
             PluginCard,
           );
-          primaryRegistered = true;
         }
-      } catch (_) {
-        // slot not available in this build — fall through to section fallback
-      }
-
-      if (!primaryRegistered) {
-        try {
-          if (ctx.slots && typeof ctx.slots.register === 'function') {
-            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 (_) {}
-      }
+      } catch (_) {}
     };
 
     return module.exports;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-usage-guard",
-  "version": "0.1.4",
+  "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",