@goodandready/dsh-cron 0.2.17 → 0.2.19

package/README.md

@@ -392,6 +392,20 @@ Developer-facing, no behaviour change. `parseScheduleExpression` was split into
 
 
 
+### 31. Quality & Preflight Hardening Pack (v0.2.19, #149, #152, #155, #156, #162)
+- **Zero Empty Catch Blocks (#156)**: Implemented `lib/best-effort.js` matching standard architecture with synchronous/asynchronous error suppression, fallback value handling, and optional context logging. Eliminated all 63 empty catch blocks across runner, scheduler, store, and UI client scripts.
+- **CI Workflows & Local Preflight Gate (#162)**: Added automated CI workflows (`.gitea/workflows/ci.yml` and `.github/workflows/ci.yml`) running test suites and enforcing a strict preflight gate (`scripts/ci-preflight.mjs`) that halts on any syntax error, empty catch, theme hardcoding, or leak attempt.
+- **Theme Token Modernization (#149)**: Replaced all remaining raw `rgba(...)` declarations in UI styles and modals with native `color-mix(in srgb, var(--token) N%, transparent)`.
+- **Plugin Manifest Declarations (#152)**: Updated `dsh.client.inject` in `package.json` to declare full package dependencies (`@deepseek-ai/dsh-client-locale`, `@deepseek-ai/dsh-client-ui-slots`).
+- **Production Export Integration (#155)**: Connected test-only exports (`findDestructiveRecipe` in `listRecipes`, `shouldNotifyTask` in `shouldSendToChannel`, and `TEMPLATE_VARIABLES` in `buildTemplateVars`) into active production pipelines.
+
+---
+
+### 30. Updater Localization in English & Chinese (v0.2.18, #160)
+- **Settings Card Updater Localization (#160)**: Added native translations for all 10 in-app updater keys (`updater.title`, `updater.btnCheck`, `updater.checking`, `updater.btnUpdate`, `updater.updating`, `updater.desc`, `updater.current`, `updater.available`, `updater.upToDate`, `updater.success`) into English (`en`) and Chinese (`zh`) dictionaries in `lib/client-src/10-locales.js`. In accordance with DSH core plugin architecture, Russian localization is maintained externally via `dsh-russian-lang`.
+
+---
+
 ### 29. Client Modular Decomposition & Theme Standardization (v0.2.17, #149, #150)
 - **Modular Client Architecture (#150)**: Decomposed monolithic `lib/client.js` (~3950 lines) into 14 focused, single-responsibility fragments under `lib/client-src/` (none exceeding 580 lines). Integrated zero-dependency build script `scripts/build-client.mjs` wired into `package.json` (`build:client`, `pretest`). Development fragments are excluded from npm distribution via `"files": ["lib/*.js", ...]`.
 - **DSH Theme Tokens & Visual Standardization (#149)**: Replaced inline styles on task type badges (`onSuccess`, `onFailure`, `heartbeat`, `targetSession`, `preflight`) with dedicated `.dsh-cron-tag-*` CSS classes powered by semantic `--dsh-cron-*` theme variables. Modal overlay now adapts dynamically using `var(--dsw-alias-bg-mask, rgba(0, 0, 0, 0.75))`, and keyframe pulse animations use theme variables without hardcoded RGBA.
@@ -524,7 +538,7 @@ All endpoints are served by the DSH web server under `/dsh-cron/`. Read endpoint
 
 ---
 
-## 🧪 Testing
+## 🧪 Testing & Preflight Verification
 
 Run the automated test suite covering schedule parsing, the scheduler engine, atomic storage, HTTP helpers, notifications and tool contracts:
 
@@ -532,6 +546,12 @@ Run the automated test suite covering schedule parsing, the scheduler engine, at
 npm test
 ```
 
+Run the local preflight gate to verify syntax, zero empty catch blocks, theme token compliance, package boundaries and leak protection:
+
+```bash
+node scripts/ci-preflight.mjs
+```
+
 ---
 
 ## 📄 License

package/README.ru.md

@@ -268,6 +268,20 @@ cron_create_task({
 
 
 
+### 31. Пакет ужесточения стандартов качества и CI (v0.2.19, #149, #152, #155, #156, #162)
+- **Устранение пустых catch (#156)**: Реализован модуль `lib/best-effort.js` по единому стандарту с безопасным выполнением синхронных/асинхронных операций и опциональным логированием. Все 63 пустых catch-блока в планировщике, раннере, хранилище и клиентских фрагментах устранены.
+- **Автоматический CI и локальный гейт Preflight (#162)**: Добавлены workflows непрерывной интеграции (`.gitea/workflows/ci.yml` и `.github/workflows/ci.yml`), проверяющие синтаксис, тесты и запускающие механический аудит `scripts/ci-preflight.mjs` с блокировкой любых отклонений.
+- **Модернизация токенов темы (#149)**: Оставшиеся цвета `rgba(...)` в модальных окнах и карточках переведены на современный стандарт `color-mix(in srgb, var(--токен) N%, transparent)`.
+- **Декларация зависимостей в манифесте (#152)**: В `package.json` поле `dsh.client.inject` переведено на полные имена пакетов Cordis (`@deepseek-ai/dsh-client-locale`, `@deepseek-ai/dsh-client-ui-slots`).
+- **Активация экспортов в рабочем коде (#155)**: Функции `findDestructiveRecipe`, `shouldNotifyTask` и переменные `TEMPLATE_VARIABLES` подключены в активные цепочки работы с рецептами, роутинга уведомлений и рендеринга шаблонов.
+
+---
+
+### 30. Локализация автообновления на английский и китайский языки (v0.2.18, #160)
+- **Локализация карточки обновления (#160)**: Добавлены нативные переводы для всех 10 ключей модуля автообновления (`updater.title`, `updater.btnCheck`, `updater.checking`, `updater.btnUpdate`, `updater.updating`, `updater.desc`, `updater.current`, `updater.available`, `updater.upToDate`, `updater.success`) в словари английского (`en`) и китайского (`zh`) языков в `lib/client-src/10-locales.js`. В соответствии со стандартами ядра DSH плагин поставляется с EN и ZH словарями, а русская локализация обслуживается через системный плагин `dsh-russian-lang`.
+
+---
+
 ### 29. Модульная декомпозиция клиента и стандартизация тем оформления (v0.2.17, #149, #150)
 - **Модульная архитектура клиентской части (#150)**: Монолитный файл `lib/client.js` (~3950 строк) декомпозирован на 14 независимых специализированных модулей в каталоге `lib/client-src/` (каждый строго <= 580 строк). Сборка `lib/client.js` выполняется легковесным скриптом `scripts/build-client.mjs` перед запуском тестов и сборки. Исходные фрагменты исключены из npm-дистрибутива через `"files": ["lib/*.js", ...]`.
 - **Семантические токены тем DSH (#149)**: Инлайн-стили тегов типа задач (`onSuccess`, `onFailure`, `heartbeat`, `targetSession`, `preflight`) переведены на выделенные CSS-классы `.dsh-cron-tag-*` на базе переменных темы `--dsh-cron-*`. Оверлей модальных окон переведен на адаптивную маску `var(--dsw-alias-bg-mask, rgba(0, 0, 0, 0.75))`, а анимация пульсации избавлена от захардкоженных значений RGBA.
@@ -521,13 +535,19 @@ bash deploy.sh verify [exact-version]
 
 ---
 
-## 🧪 Тестирование
+## 🧪 Тестирование и локальная проверка (Preflight)
+
+Запуск автоматического набора тестов (разбор расписаний, движок планировщика, атомарное хранилище, HTTP-хелперы, уведомления и контракт инструментов):
 
 ```bash
 npm test
 ```
 
-Набор покрывает разбор расписаний, движок планировщика, атомарное хранилище, HTTP-хелперы, уведомления и контракт инструментов.
+Локальный запуск гейта стандартов качества (синтаксис, отсутствие пустых catch, соответствие токенам тем оформления, чистота состава npm-пакета и защита от утечек):
+
+```bash
+node scripts/ci-preflight.mjs
+```
 
 ---
 

package/README.zh.md

@@ -391,6 +391,20 @@ bash deploy.sh verify [exact-version]
 
 
 
+### 31. 质量加固与 CI 预检标准包 (v0.2.19, #149, #152, #155, #156, #162)
+- **彻底消除空 catch 块 (#156)**：引入符合标准规范的 `lib/best-effort.js` 模块，全面支持同步/异步安全调用、回退返回值和可选日志记录，清除了 runner、scheduler、store 及客户端中的所有 63 处空 catch 块。
+- **CI 工作流与本地预检门禁 (#162)**：新增自动化 CI 工作流（`.gitea/workflows/ci.yml` 与 `.github/workflows/ci.yml`），集成本地预检门禁脚本 `scripts/ci-preflight.mjs`，在出现语法错误、空 catch、颜色硬编码或信息泄露时自动阻断。
+- **主题设计令牌现代化 (#149)**：将模态对话框与设置卡片中遗留的 `rgba(...)` 全部重构为原生的 `color-mix(in srgb, var(--token) N%, transparent)`。
+- **插件清单注入声明规范化 (#152)**：在 `package.json` 的 `dsh.client.inject` 中统一声明完整的 Cordis 包名（`@deepseek-ai/dsh-client-locale`、`@deepseek-ai/dsh-client-ui-slots`）。
+- **生产管线导出连接 (#155)**：将此前仅在测试中调用的导出（`findDestructiveRecipe`、`shouldNotifyTask` 和 `TEMPLATE_VARIABLES`）全面接入配方过滤、通知分发及模板生成核心逻辑。
+
+---
+
+### 30. 自更新模块英文与中文多语言支持 (v0.2.18, #160)
+- **设置面板自更新多语言 (#160)**：在 `lib/client-src/10-locales.js` 的英文 (`en`) 与中文 (`zh`) 字典中补全了全部 10 个自更新键值 (`updater.title`, `updater.btnCheck`, `updater.checking`, `updater.btnUpdate`, `updater.updating`, `updater.desc`, `updater.current`, `updater.available`, `updater.upToDate`, `updater.success`)。遵循 DSH 插件规范，插件核心内置英文与中文，俄语多语言由 `dsh-russian-lang` 统一扩展。
+
+---
+
 ### 29. 客户端模块化解耦与原生主题标准化 (v0.2.17, #149, #150)
 - **客户端模块化架构 (#150)**: 将庞大的单文件 `lib/client.js` (约 3950 行) 拆分为 `lib/client-src/` 下的 14 个高内聚模块文件 (各模块严格 <= 580 行)。集成零依赖构建脚本 `scripts/build-client.mjs` 并接入 `package.json` (`build:client`, `pretest`)，通过 `"files": ["lib/*.js", ...]` 避免开发源码冗余打包进 npm 发布包。
 - **DSH 语义化主题变量对齐 (#149)**: 将任务类型标签 (`onSuccess`, `onFailure`, `heartbeat`, `targetSession`, `preflight`) 的内联样式全部替换为基于主题变量的 `.dsh-cron-tag-*` 类；模态框遮罩层接入自适应主题遮罩变量 `var(--dsw-alias-bg-mask, rgba(0, 0, 0, 0.75))`，移除脉冲动画关键帧中的硬编码 RGBA。
@@ -521,13 +535,19 @@ dsh-cron:
 
 ---
 
-## 🧪 测试
+## 🧪 测试与预检门禁 (Preflight)
+
+运行全套自动化测试（调度表达式解析、调度器引擎、原子存储、HTTP 辅助函数、通知与工具契约）：
 
 ```bash
 npm test
 ```
 
-测试覆盖调度表达式解析、调度器引擎、原子存储、HTTP 辅助函数、通知与工具契约。
+本地执行质量预检门禁（语法检查、零空 catch 块、主题设计规范、npm 发布归档合规性及防泄漏检查）：
+
+```bash
+node scripts/ci-preflight.mjs
+```
 
 ---
 

package/lib/best-effort.js

@@ -0,0 +1,29 @@
+/**
+ * Run a non-critical side effect; never throw.
+ * Logs at debug when a logger is provided (matches dsh-key-rotation pattern).
+ */
+export function bestEffort(label, fn, logger) {
+  const log = (err) => {
+    try {
+      logger?.debug?.(`dsh-cron: best-effort ${label}`, err);
+    } catch {
+      /* logger itself must not throw */
+    }
+  };
+  try {
+    const result = fn();
+    if (result && typeof result.then === "function") {
+      return result.then(
+        (value) => value,
+        (err) => {
+          log(err);
+          return undefined;
+        },
+      );
+    }
+    return result;
+  } catch (err) {
+    log(err);
+    return undefined;
+  }
+}

package/lib/channels.js

@@ -7,7 +7,7 @@
  * collected so one broken channel cannot hide another.
  */
 
-import { formatTaskTelegramMessage, sendTelegramMessage, createTelegramTaskKeyboard } from './telegram.js';
+import { formatTaskTelegramMessage, sendTelegramMessage, createTelegramTaskKeyboard, shouldNotifyTask } from './telegram.js';
 import { createKanbanCard, shouldCreateKanbanCard } from './integrations.js';
 import { resolveTemplateText, truncateText } from './templates.js';
 
@@ -58,6 +58,11 @@ export function unknownChannels(task) {
 /** Failure/only-on-failure filtering, per channel. */
 export function shouldSendToChannel(channelId, task, runInfo, settings = {}) {
   if (channelId === 'kanban') return shouldCreateKanbanCard(task, runInfo);
+  if (channelId === 'telegram') {
+    if (task && task.notifyTelegram === false) return false;
+    const taskForTelegram = Object.assign({}, task, { notifyTelegram: true });
+    return shouldNotifyTask(taskForTelegram, runInfo, settings);
+  }
   const onlyOnFail = task.onlyOnFailure !== undefined
     ? Boolean(task.onlyOnFailure)
     : Boolean(settings.onlyOnFailure);

package/lib/client.js

@@ -49,7 +49,9 @@ window.__ModuleLoader__.load({
     try {
       const primitives = require('@deepseek-ai/dsh-client-ui-primitives');
       CoreChevron = primitives && primitives.IconChevronDownOutline14;
-    } catch (e) {}
+    } catch (e) {
+      /* Optional core chevron primitive not available; SVG fallback used */
+    }
     const chevronNode = () => (CoreChevron ? React.createElement(CoreChevron) : React.createElement('span', { style: { display: 'flex', alignItems: 'center' }, dangerouslySetInnerHTML: { __html: ICON_CHEVRON_DOWN } }));
 
     // Own React error boundary (#106): the core's SlotErrorBoundary renders an
@@ -294,6 +296,16 @@ window.__ModuleLoader__.load({
         'settings.saved': '✓ Saved',
         'settings.saveError': 'Save failed: {error}',
         'settings.saveErrorUnknown': 'unknown error',
+        'updater.title': 'Plugin Auto-Updater',
+        'updater.btnCheck': 'Check for updates',
+        'updater.checking': 'Checking...',
+        'updater.btnUpdate': 'Update to v{version}',
+        'updater.updating': 'Updating...',
+        'updater.desc': 'Check npm registry and install plugin updates in-place without SSH access.',
+        'updater.current': 'Current version: v{version}',
+        'updater.available': 'Update available: v{version}',
+        'updater.upToDate': 'Up to date',
+        'updater.success': 'Successfully updated to v{version}. Please restart DSH or reload profile to apply changes.',
         'dsh.modalTitle': 'Schedule a task with the DSH agent',
         'dsh.descLabel': 'Describe the task and the desired frequency:',
         'dsh.placeholder': 'For example: check free disk space and failed systemd services every 2 hours, and alert only if something is wrong...',
@@ -574,6 +586,16 @@ window.__ModuleLoader__.load({
         'settings.saved': '✓ 已保存',
         'settings.saveError': '保存失败: {error}',
         'settings.saveErrorUnknown': '未知错误',
+        'updater.title': '插件自更新',
+        'updater.btnCheck': '检查更新',
+        'updater.checking': '正在检查...',
+        'updater.btnUpdate': '升级至 v{version}',
+        'updater.updating': '正在更新...',
+        'updater.desc': '通过 npm 仓库在线检查并就地升级插件，无需 SSH 终端操作。',
+        'updater.current': '当前版本: v{version}',
+        'updater.available': '发现新版本: v{version}',
+        'updater.upToDate': '已是最新版本',
+        'updater.success': '已成功升级至 v{version}。请重启 DSH 或重载配置以应用更新。',
         'dsh.modalTitle': '让 DSH 智能体创建任务',
         'dsh.descLabel': '请描述你的任务目标和执行频率:',
         'dsh.placeholder': '例如: 每两小时检查一次磁盘空间和失败的 systemd 守护进程，并在异常时报警...',
@@ -602,15 +624,15 @@ window.__ModuleLoader__.load({
     const STYLES = `
       :root {
         --dsh-cron-success: var(--dsw-alias-state-success-primary, #10b981);
-        --dsh-cron-success-bg: rgba(16, 185, 129, 0.1);
+        --dsh-cron-success-bg: color-mix(in srgb, var(--dsh-cron-success, #10b981) 10%, transparent);
         --dsh-cron-danger: var(--dsw-alias-state-error-primary, #ef4444);
-        --dsh-cron-danger-bg: rgba(239, 68, 68, 0.1);
+        --dsh-cron-danger-bg: color-mix(in srgb, var(--dsh-cron-danger, #ef4444) 10%, transparent);
         --dsh-cron-info: var(--dsw-alias-state-brand-primary, #60a5fa);
-        --dsh-cron-info-bg: rgba(96, 165, 250, 0.12);
+        --dsh-cron-info-bg: color-mix(in srgb, var(--dsh-cron-info, #60a5fa) 12%, transparent);
         --dsh-cron-accent: var(--dsw-alias-state-info-primary, #c084fc);
-        --dsh-cron-accent-bg: rgba(168, 85, 247, 0.12);
+        --dsh-cron-accent-bg: color-mix(in srgb, var(--dsh-cron-accent, #a855f7) 12%, transparent);
         --dsh-cron-warning: var(--dsw-alias-state-warning-primary, #eab308);
-        --dsh-cron-warning-bg: rgba(234, 179, 8, 0.12);
+        --dsh-cron-warning-bg: color-mix(in srgb, var(--dsh-cron-warning, #eab308) 12%, transparent);
       }
       [data-pane=conversation], [class*=centerCol] {
         position: relative !important;
@@ -640,14 +662,14 @@ window.__ModuleLoader__.load({
 
       .dsh-cron-top-bar { display: flex; align-items: center; gap: 12px; }
       .dsh-cron-back-btn { appearance: none; font: inherit; cursor: pointer; color: var(--dsw-alias-label-secondary, #9ca3af); background: 0 0; border: 1px solid var(--dsw-alias-border-l2, #383838); border-radius: 8px; align-items: center; gap: 6px; padding: 4px 12px; font-size: 13px; display: inline-flex; flex: none; height: 32px; box-sizing: border-box; }
-      .dsh-cron-back-btn:hover { color: var(--dsw-alias-label-primary, #ededed); background: var(--dsw-alias-bg-layer-4, var(--dsw-alias-interactive-bg-hover, rgba(255,255,255,0.06))); }
+      .dsh-cron-back-btn:hover { color: var(--dsw-alias-label-primary, #ededed); background: var(--dsw-alias-bg-layer-4, var(--dsw-alias-interactive-bg-hover, color-mix(in srgb, var(--dsw-alias-label-primary, #fff) 6%, transparent))); }
 
       .dsh-cron-header { display: flex; justify-content: space-between; align-items: flex-start; gap: 12px; padding-bottom: 16px; border-bottom: 1px solid var(--dsw-alias-border-l2, #383838); }
       .dsh-cron-title { font-size: 22px; font-weight: 700; letter-spacing: -0.02em; margin-bottom: 6px; }
       .dsh-cron-subtitle { font-size: 14px; color: var(--dsw-alias-label-secondary, #9ca3af); line-height: 1.5; }
       .dsh-cron-create-btn { appearance: none; display: inline-flex; align-items: center; gap: 6px; background: var(--dsw-alias-bg-layer-2, #262626); color: var(--dsw-alias-label-primary, #fff); border: 1px solid var(--dsw-alias-border-l2, #383838); border-radius: 9999px; padding: 8px 16px; font-size: 14px; font-weight: 500; cursor: pointer; position: relative; }
       .dsh-cron-create-btn:hover { background: var(--dsw-alias-bg-layer-hover, var(--dsw-alias-interactive-bg-hover, #333)); }
-      .dsh-cron-dropdown { position: absolute; top: calc(100% + 6px); right: 0; width: 200px; background: var(--dsw-alias-bg-layer-3, #212121); border: 1px solid var(--dsw-alias-border-l2, #383838); border-radius: 12px; padding: 6px; box-shadow: 0 10px 25px rgba(0,0,0,0.5); z-index: 200; }
+      .dsh-cron-dropdown { position: absolute; top: calc(100% + 6px); right: 0; width: 200px; background: var(--dsw-alias-bg-layer-3, #212121); border: 1px solid var(--dsw-alias-border-l2, #383838); border-radius: 12px; padding: 6px; box-shadow: 0 10px 25px color-mix(in srgb, var(--dsw-alias-bg-mask, #000) 50%, transparent); z-index: 200; }
       .dsh-cron-dropdown-item { display: flex; align-items: center; gap: 10px; width: 100%; padding: 10px 12px; background: transparent; border: none; border-radius: 8px; color: var(--dsw-alias-label-primary, #ededed); font-size: 13.5px; text-align: left; cursor: pointer; }
       .dsh-cron-dropdown-item:hover { background: var(--dsw-alias-interactive-bg-hover, #2a2a2a); }
       .dsh-cron-search-bar { position: relative; margin-bottom: 0; }
@@ -657,7 +679,7 @@ window.__ModuleLoader__.load({
       .dsh-cron-filters { margin-top: 8px; }
       .dsh-cron-filter-toggle { background: none; border: 1px solid var(--dsw-alias-border-l2, #333); color: var(--dsw-alias-label-secondary, #aaa); border-radius: 8px; padding: 4px 10px; font-size: 12px; cursor: pointer; }
       .dsh-cron-filter-toggle:hover { color: var(--dsw-alias-label-primary, #eee); border-color: var(--dsh-cron-info); }
-      .dsh-cron-filter-panel { display: grid; grid-template-columns: repeat(auto-fit, minmax(160px, 1fr)); gap: 10px; margin-top: 10px; padding: 10px 12px; border: 1px solid var(--dsw-alias-border-l2, #2e2e2e); border-radius: 8px; background: var(--dsw-alias-bg-layer-3, rgba(255,255,255,0.02)); }
+      .dsh-cron-filter-panel { display: grid; grid-template-columns: repeat(auto-fit, minmax(160px, 1fr)); gap: 10px; margin-top: 10px; padding: 10px 12px; border: 1px solid var(--dsw-alias-border-l2, #2e2e2e); border-radius: 8px; background: var(--dsw-alias-bg-layer-3, color-mix(in srgb, var(--dsw-alias-label-primary, #fff) 2%, transparent)); }
       .dsh-cron-filter-field { display: flex; flex-direction: column; gap: 4px; font-size: 12px; color: var(--dsw-alias-label-tertiary, #888); }
       .dsh-cron-filter-field select { background: var(--dsw-alias-bg-layer-2, #1f1f1f); border: 1px solid var(--dsw-alias-border-l2, #333); color: var(--dsw-alias-label-primary, inherit); border-radius: 6px; padding: 5px 8px; font-size: 12.5px; }
       .dsh-cron-tabs { display: flex; flex-wrap: wrap; gap: 8px; }
@@ -674,7 +696,7 @@ window.__ModuleLoader__.load({
       .dsh-cron-tag-session { background: var(--dsh-cron-info-bg); color: var(--dsh-cron-info); border-color: var(--dsh-cron-info); }
       .dsh-cron-tag-preflight { background: var(--dsh-cron-warning-bg); color: var(--dsh-cron-warning); border-color: var(--dsh-cron-warning); }
 
-      .dsh-cron-task-model-tag { display: inline-flex; align-items: center; font-size: 11px; padding: 2px 8px; border-radius: 999px; border: 1px solid var(--dsw-alias-border-l2, #383838); background: var(--dsw-alias-bg-layer-2, rgba(255,255,255,0.06)); color: var(--dsw-alias-label-secondary, #aaa); margin-left: 8px; vertical-align: middle; }
+      .dsh-cron-task-model-tag { display: inline-flex; align-items: center; font-size: 11px; padding: 2px 8px; border-radius: 999px; border: 1px solid var(--dsw-alias-border-l2, #383838); background: var(--dsw-alias-bg-layer-2, color-mix(in srgb, var(--dsw-alias-label-primary, #fff) 6%, transparent)); color: var(--dsw-alias-label-secondary, #aaa); margin-left: 8px; vertical-align: middle; }
       .dsh-cron-task-actions { display: flex; gap: 8px; }
       .dsh-cron-icon-btn { appearance: none; font: inherit; background: var(--dsw-alias-bg-layer-2, transparent); border: 1px solid var(--dsw-alias-border-l2, #333); border-radius: 8px; padding: 6px 12px; font-size: 12.5px; font-weight: 500; color: var(--dsw-alias-label-primary, #aaa); cursor: pointer; display: inline-flex; align-items: center; gap: 6px; transition: all 0.15s ease; }
       .dsh-cron-icon-btn:hover { background: var(--dsw-alias-bg-layer-4, #2a2a2a); border-color: var(--dsw-alias-label-dimmed, var(--dsw-alias-border-l2, #444)); }
@@ -686,14 +708,14 @@ window.__ModuleLoader__.load({
       .dsh-cron-recs-list { display: flex; flex-direction: column; gap: 10px; }
       .dsh-cron-rec-card { display: flex; align-items: center; gap: 16px; padding: 14px 18px; background: var(--dsw-alias-bg-layer-3, #1c1c1c); border: 1px solid var(--dsw-alias-border-l2, #282828); border-radius: 12px; cursor: pointer; transition: background 0.15s; }
       .dsh-cron-rec-card:hover, .dsh-cron-rec-card:focus-visible { background: var(--dsw-alias-bg-layer-4, #242424); border-color: var(--dsw-alias-label-dimmed, var(--dsw-alias-border-l2, #383838)); outline: none; }
-      .dsh-cron-rec-icon { width: 36px; height: 36px; border-radius: 10px; background: var(--dsw-alias-bg-layer-2, rgba(255,255,255,0.03)); display: flex; align-items: center; justify-content: center; flex-shrink: 0; }
+      .dsh-cron-rec-icon { width: 36px; height: 36px; border-radius: 10px; background: var(--dsw-alias-bg-layer-2, color-mix(in srgb, var(--dsw-alias-label-primary, #fff) 3%, transparent)); display: flex; align-items: center; justify-content: center; flex-shrink: 0; }
       .dsh-cron-rec-content { flex: 1; min-width: 0; }
       .dsh-cron-rec-title { font-size: 14.5px; font-weight: 500; margin-bottom: 4px; }
       .dsh-cron-rec-time { font-size: 13px; color: var(--dsw-alias-label-secondary, #9ca3af); font-weight: normal; margin-left: 8px; }
       .dsh-cron-rec-desc { font-size: 13px; color: var(--dsw-alias-label-tertiary, #71717a); }
 
-      .dsh-cron-modal-overlay { position: fixed; inset: 0; background: var(--dsw-alias-bg-mask, rgba(0, 0, 0, 0.75)); backdrop-filter: blur(4px); display: flex; align-items: center; justify-content: center; z-index: 1000; padding: 16px; box-sizing: border-box; overflow-y: auto; }
-      .dsh-cron-modal { background: var(--dsw-alias-bg-layer-2, #1f1f1f); border: 1px solid var(--dsw-alias-border-l2, #333); border-radius: 16px; width: 100%; max-width: 540px; max-height: min(90vh, calc(100vh - 36px)); overflow-y: auto; padding: 24px; box-shadow: 0 20px 40px rgba(0,0,0,0.6); box-sizing: border-box; }
+      .dsh-cron-modal-overlay { position: fixed; inset: 0; background: var(--dsw-alias-bg-mask, color-mix(in srgb, #000 75%, transparent)); backdrop-filter: blur(4px); display: flex; align-items: center; justify-content: center; z-index: 1000; padding: 16px; box-sizing: border-box; overflow-y: auto; }
+      .dsh-cron-modal { background: var(--dsw-alias-bg-layer-2, #1f1f1f); border: 1px solid var(--dsw-alias-border-l2, #333); border-radius: 16px; width: 100%; max-width: 540px; max-height: min(90vh, calc(100vh - 36px)); overflow-y: auto; padding: 24px; box-shadow: 0 20px 40px color-mix(in srgb, var(--dsw-alias-bg-mask, #000) 60%, transparent); box-sizing: border-box; }
       .dsh-cron-modal-scroll { max-width: 640px; max-height: min(90vh, calc(100vh - 36px)); overflow-y: auto; }
       .dsh-cron-modal::-webkit-scrollbar { width: 6px; }
       .dsh-cron-modal::-webkit-scrollbar-track { background: transparent; }
@@ -752,7 +774,7 @@ window.__ModuleLoader__.load({
       .dsh-cron-history-empty { text-align: center; padding: 36px 0; color: var(--dsw-alias-label-tertiary, #666); font-size: 13.5px; }
 
       .dsh-cron-stats-bar { display: grid; grid-template-columns: repeat(auto-fit, minmax(150px, 1fr)); gap: 10px; margin-bottom: 0; }
-      .dsh-cron-stat-card { background: var(--dsw-alias-bg-layer-2, rgba(255, 255, 255, 0.02)); border: 1px solid var(--dsw-alias-border-l2, #222); border-radius: 8px; padding: 12px 14px; display: flex; flex-direction: column; gap: 4px; }
+      .dsh-cron-stat-card { background: var(--dsw-alias-bg-layer-2, color-mix(in srgb, var(--dsw-alias-label-primary, #fff) 2%, transparent)); border: 1px solid var(--dsw-alias-border-l2, #222); border-radius: 8px; padding: 12px 14px; display: flex; flex-direction: column; gap: 4px; }
       .dsh-cron-stat-val { font-size: 18px; font-weight: 700; color: var(--dsw-alias-label-primary, #fff); }
       .dsh-cron-stat-lbl { font-size: 12px; color: var(--dsw-alias-label-secondary, #777); margin-top: 0; }
       .dsh-cron-oneshot-tag { display: inline-flex; align-items: center; font-size: 11px; padding: 2px 8px; border-radius: 999px; border: 1px solid var(--dsh-cron-accent); background: var(--dsh-cron-accent-bg); color: var(--dsh-cron-accent); font-weight: 500; }
@@ -767,7 +789,7 @@ window.__ModuleLoader__.load({
       .dsh-cron-section-title { font-weight: 500; font-size: 12.5px; color: var(--dsw-alias-label-secondary, #aaa); margin-bottom: 10px; }
       .dsh-cron-secret-row { display: flex; align-items: center; gap: 8px; }
       .dsh-cron-secret-row input { flex: 1; }
-      .dsh-cron-badge-ref { font-size: 11px; padding: 2px 6px; border-radius: 4px; background: var(--dsw-alias-bg-layer-3, rgba(255,255,255,0.06)); color: var(--dsw-alias-label-tertiary, #888); white-space: nowrap; }
+      .dsh-cron-badge-ref { font-size: 11px; padding: 2px 6px; border-radius: 4px; background: var(--dsw-alias-bg-layer-3, color-mix(in srgb, var(--dsw-alias-label-primary, #fff) 6%, transparent)); color: var(--dsw-alias-label-tertiary, #888); white-space: nowrap; }
       .dsh-cron-status-banner { padding: 10px 14px; border-radius: 8px; font-size: 13px; margin-top: 12px; }
       .dsh-cron-status-banner[data-type="success"] { background: var(--dsh-cron-success-bg); border: 1px solid var(--dsh-cron-success); color: var(--dsh-cron-success); }
       .dsh-cron-status-banner[data-type="error"] { background: var(--dsh-cron-danger-bg); border: 1px solid var(--dsh-cron-danger); color: var(--dsh-cron-danger); }
@@ -778,13 +800,13 @@ window.__ModuleLoader__.load({
       /* #34: sidebar job list */
       .dsh-cron-sidebar-jobs { display: flex; flex-direction: column; gap: 2px; margin: 2px 0 6px 0; }
       .dsh-cron-sidebar-jobs-head { display: flex; align-items: center; justify-content: space-between; width: 100%; background: none; border: none; padding: 4px 8px; font: inherit; font-size: 12px; color: var(--dsw-alias-label-tertiary, #888); cursor: pointer; border-radius: 6px; text-align: left; }
-      .dsh-cron-sidebar-jobs-head:hover { color: var(--dsw-alias-label-primary, #eee); background: var(--dsw-alias-interactive-bg-hover, rgba(255,255,255,0.04)); }
+      .dsh-cron-sidebar-jobs-head:hover { color: var(--dsw-alias-label-primary, #eee); background: var(--dsw-alias-interactive-bg-hover, color-mix(in srgb, var(--dsw-alias-label-primary, #fff) 4%, transparent)); }
       .dsh-cron-sidebar-jobs-head::after { content: '▾'; font-size: 10px; transition: transform 0.15s ease; }
       .dsh-cron-sidebar-jobs[data-open="false"] .dsh-cron-sidebar-jobs-head::after { transform: rotate(-90deg); }
       .dsh-cron-sidebar-jobs[data-open="false"] .dsh-cron-sidebar-jobs-list { display: none; }
       .dsh-cron-sidebar-jobs-list { display: flex; flex-direction: column; gap: 2px; padding-left: 10px; }
       .dsh-cron-sidebar-job { display: flex; flex-direction: column; align-items: flex-start; gap: 1px; width: 100%; background: none; border: none; border-left: 2px solid transparent; padding: 3px 8px; font: inherit; cursor: pointer; border-radius: 0 6px 6px 0; text-align: left; }
-      .dsh-cron-sidebar-job:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(255,255,255,0.04)); border-left-color: var(--dsh-cron-info); }
+      .dsh-cron-sidebar-job:hover { background: var(--dsw-alias-interactive-bg-hover, color-mix(in srgb, var(--dsw-alias-label-primary, #fff) 4%, transparent)); border-left-color: var(--dsh-cron-info); }
       .dsh-cron-sidebar-job-title { font-size: 12px; color: var(--dsw-alias-label-secondary, #ccc); max-width: 100%; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
       .dsh-cron-sidebar-job-meta { font-size: 11px; color: var(--dsw-alias-label-tertiary, #777); }
       .dsh-cron-sidebar-empty, .dsh-cron-sidebar-more { font-size: 11px; color: var(--dsw-alias-label-tertiary, #777); padding: 2px 8px; }
@@ -967,7 +989,9 @@ window.__ModuleLoader__.load({
         try {
           sessions.open(sessionId);
           return true;
-        } catch (e) {}
+        } catch (err) {
+          /* sessions.open threw synchronously */
+        }
       }
 
       // 2. If the session is not in manager.summaries yet, refresh from the backend
@@ -976,7 +1000,9 @@ window.__ModuleLoader__.load({
           await sessions.refresh();
           sessions.open(sessionId);
           return true;
-        } catch (e) {}
+        } catch (err) {
+          /* sessions.refresh threw */
+        }
       }
 
       // 3. Async retries until the WebSocket/SSE event adds the session to the list
@@ -987,7 +1013,9 @@ window.__ModuleLoader__.load({
           try {
             sessions.open(sessionId);
             return true;
-          } catch (e) {}
+          } catch (err) {
+            /* retry polling sessions.open threw */
+          }
         }
         // DOM fallback: click the session in the sidebar if it has rendered
         if (typeof document !== 'undefined') {
@@ -1303,7 +1331,7 @@ window.__ModuleLoader__.load({
         if (!node) return;
         if (typeof node.scrollIntoView === 'function') node.scrollIntoView({ block: 'center' });
         node.classList.add('dsh-cron-task-highlight');
-        setTimeout(() => { try { node.classList.remove('dsh-cron-task-highlight'); } catch (_) {} }, 2500);
+        setTimeout(() => { try { node.classList.remove('dsh-cron-task-highlight'); } catch (err) { /* node unmounted */ } }, 2500);
       }, [tasks]);
 
       const fetchTasks = async () => {
@@ -1415,7 +1443,9 @@ window.__ModuleLoader__.load({
         try {
           await fetch('/dsh-cron/tasks/' + encodeURIComponent(id) + '/toggle', { method: 'POST' });
           fetchTasks();
-        } catch (err) {}
+        } catch (err) {
+          console.debug('[dsh-cron] toggle failed', err);
+        }
       };
 
       const handleRunNow = async (id) => {
@@ -1630,7 +1660,10 @@ window.__ModuleLoader__.load({
         try {
           await fetch('/dsh-cron/tasks/' + encodeURIComponent(id), { method: 'DELETE' });
           fetchTasks();
-        } catch (err) {}      };
+        } catch (err) {
+          console.debug('[dsh-cron] delete failed', err);
+        }
+      };
 
       const openSettingsModal = async () => {
         setTestStatus(null);
@@ -1648,7 +1681,9 @@ window.__ModuleLoader__.load({
             setSettingsHasDefault(Boolean(data.settings.hasDefaultCredentials));
             setSettingsHasCustomBotToken(Boolean(data.settings.hasCustomBotToken));
           }
-        } catch (e) {}
+        } catch (err) {
+          console.debug('[dsh-cron] settings fetch failed', err);
+        }
       };
 
       const handleSaveSettings = async (e) => {
@@ -2695,7 +2730,7 @@ window.__ModuleLoader__.load({
                     React.createElement('label', null, T_KEY(t, 'form.sshTargetLabel')),
                     React.createElement('input', {
                       value: formSshTarget,
-                      placeholder: 'root@10.0.0.5',
+                      placeholder: 'user@example.com',
                       onChange: (e) => setFormSshTarget(e.target.value)
                     }),
                     React.createElement('input', {
@@ -2808,7 +2843,7 @@ window.__ModuleLoader__.load({
                 ),
                 React.createElement('div', {
                   style: {
-                    background: 'var(--dsw-alias-bg-layer-3, rgba(255,255,255,0.02))',
+                    background: 'var(--dsw-alias-bg-layer-3, color-mix(in srgb, var(--dsw-alias-label-primary, #fff) 2%, transparent))',
                     border: '1px solid var(--dsw-alias-border-l2, #2e2e2e)',
                     borderRadius: '8px',
                     padding: '12px 14px',
@@ -2971,7 +3006,7 @@ window.__ModuleLoader__.load({
                   ),
                 selectedTaskMeta && React.createElement('div', {
                   style: {
-                    background: 'var(--dsw-alias-bg-layer-3, rgba(255,255,255,0.03))',
+                    background: 'var(--dsw-alias-bg-layer-3, color-mix(in srgb, var(--dsw-alias-label-primary, #fff) 3%, transparent))',
                     border: '1px solid var(--dsw-alias-border-l2, #2e2e2e)',
                     borderRadius: '8px',
                     padding: '10px 14px',
@@ -3161,7 +3196,7 @@ window.__ModuleLoader__.load({
                   onChange: (e) => setSettingsChatId(e.target.value)
                 })
               ),
-              React.createElement('div', { style: { background: 'var(--dsw-alias-bg-layer-3, rgba(255,255,255,0.02))', border: '1px solid var(--dsw-alias-border-l2, #2e2e2e)', borderRadius: '8px', padding: '12px 14px', marginBottom: '16px' } },
+              React.createElement('div', { style: { background: 'var(--dsw-alias-bg-layer-3, color-mix(in srgb, var(--dsw-alias-label-primary, #fff) 2%, transparent))', border: '1px solid var(--dsw-alias-border-l2, #2e2e2e)', borderRadius: '8px', padding: '12px 14px', marginBottom: '16px' } },
                 React.createElement('label', { className: 'dsh-cron-checkbox-row', style: { marginBottom: '8px' } },
                   React.createElement('input', {
                     type: 'checkbox',
@@ -3326,7 +3361,7 @@ window.__ModuleLoader__.load({
       const [updateState, setUpdateState] = React.useState({
         checking: false,
         updating: false,
-        currentVersion: '0.2.17',
+        currentVersion: '0.2.19',
         latestVersion: undefined,
         updateAvailable: false,
         notice: null,
@@ -3433,7 +3468,9 @@ window.__ModuleLoader__.load({
             setSaved(true);
             setTimeout(() => setSaved(false), 2500);
           }
-        } catch (err) {}
+        } catch (err) {
+          console.debug('[dsh-cron] save settings failed', err);
+        }
       };
 
       const testTelegram = async () => {
@@ -3538,7 +3575,7 @@ window.__ModuleLoader__.load({
               onChange: (e) => setKanbanUrl(e.target.value)
             })
           ),
-          React.createElement('div', { style: { background: 'var(--dsw-alias-bg-layer-3, rgba(255,255,255,0.02))', border: '1px solid var(--dsw-alias-border-l2, #2e2e2e)', borderRadius: '6px', padding: '10px 12px', display: 'flex', flexDirection: 'column', gap: '8px' } },
+          React.createElement('div', { style: { background: 'var(--dsw-alias-bg-layer-3, color-mix(in srgb, var(--dsw-alias-label-primary, #fff) 2%, transparent))', border: '1px solid var(--dsw-alias-border-l2, #2e2e2e)', borderRadius: '6px', padding: '10px 12px', display: 'flex', flexDirection: 'column', gap: '8px' } },
             React.createElement('label', { className: 'dsh-cron-checkbox-row' },
               React.createElement('input', {
                 type: 'checkbox',
@@ -3590,8 +3627,8 @@ window.__ModuleLoader__.load({
           React.createElement('div', {
             className: 'dsh-cron-form-group',
             style: {
-              background: 'var(--dsw-alias-bg-layer-2, rgba(255,255,255,0.03))',
-              border: '1px solid var(--dsw-alias-border-l2, rgba(255,255,255,0.08))',
+              background: 'var(--dsw-alias-bg-layer-2, color-mix(in srgb, var(--dsw-alias-label-primary, #fff) 3%, transparent))',
+              border: '1px solid var(--dsw-alias-border-l2, color-mix(in srgb, var(--dsw-alias-label-primary, #fff) 8%, transparent))',
               borderRadius: '8px',
               padding: '14px',
               marginBottom: '16px'
@@ -3766,7 +3803,9 @@ window.__ModuleLoader__.load({
         const res = await fetch('/dsh-cron/tasks?status=active');
         const data = await res.json();
         if (data && data.ok) renderSidebarJobs(state, data.tasks || []);
-      } catch (_) {}
+      } catch (err) {
+        console.debug('[dsh-cron] load sidebar jobs failed', err);
+      }
     }
 
     function applySidebarJobsOpen(state) {
@@ -3791,7 +3830,7 @@ window.__ModuleLoader__.load({
         event.preventDefault();
         event.stopPropagation();
         state.open = !state.open;
-        try { window.localStorage.setItem(SIDEBAR_JOBS_KEY, state.open ? '1' : '0'); } catch (_) {}
+        try { window.localStorage.setItem(SIDEBAR_JOBS_KEY, state.open ? '1' : '0'); } catch (err) { /* localStorage write failed */ }
         applySidebarJobsOpen(state);
       });
       root.appendChild(headEl);
@@ -3834,7 +3873,7 @@ window.__ModuleLoader__.load({
     function mountSidebarJobs(toggle, label, openTaskSignal) {
       if (typeof document === 'undefined') return () => {};
       const state = { toggle, openTaskSignal, root: undefined, listEl: undefined, headEl: undefined, open: false };
-      try { state.open = window.localStorage.getItem(SIDEBAR_JOBS_KEY) === '1'; } catch (_) {}
+      try { state.open = window.localStorage.getItem(SIDEBAR_JOBS_KEY) === '1'; } catch (err) { /* localStorage read failed */ }
 
       const observer = new MutationObserver(() => placeSidebarJobs(state, label));
       observer.observe(document.body, { childList: true, subtree: true });
@@ -3842,7 +3881,7 @@ window.__ModuleLoader__.load({
       loadSidebarJobs(state);
       const fetchTimer = setInterval(() => {
         let isOpen = false;
-        try { isOpen = window.localStorage.getItem(SIDEBAR_JOBS_KEY) === '1'; } catch (_) {}
+        try { isOpen = window.localStorage.getItem(SIDEBAR_JOBS_KEY) === '1'; } catch (err) { /* localStorage poll failed */ }
         if (isOpen) loadSidebarJobs(state);
       }, 30000);
 
@@ -3991,7 +4030,9 @@ window.__ModuleLoader__.load({
         if (ctx.locale && typeof ctx.locale.bind === 'function') {
           translate = ctx.locale.bind(NS);
         }
-      } catch (e) {}
+      } catch (err) {
+        /* locale bind unavailable, fallback to default translate */
+      }
 
       const toggle = createToggle();
 

package/lib/llm-actions.js

@@ -1,3 +1,4 @@
+import { bestEffort } from './best-effort.js';
 import fs from 'node:fs';
 
 /**
@@ -14,10 +15,10 @@ export function parseLlmActionDirectives(text) {
   while ((match = blockRegex.exec(text)) !== null) {
     const raw = match[1].trim();
     if ((raw.startsWith('{') && raw.endsWith('}')) || (raw.startsWith('[') && raw.endsWith(']'))) {
-      try {
+      bestEffort('parse-directive-json', () => {
         const parsed = JSON.parse(raw);
         collectDirectives(parsed, directives);
-      } catch {}
+      });
     }
   }
 
@@ -26,10 +27,10 @@ export function parseLlmActionDirectives(text) {
     const inlineMatch = /\{(?:[^{}]|(\{(?:[^{}]|\{[^{}]*\})*\}))*"dsh_action[s]?"(?:[^{}]|(\{(?:[^{}]|\{[^{}]*\})*\}))*\}/gi;
     let im;
     while ((im = inlineMatch.exec(text)) !== null) {
-      try {
+      bestEffort('parse-inline-directive', () => {
         const parsed = JSON.parse(im[0]);
         collectDirectives(parsed, directives);
-      } catch {}
+      });
     }
   }
 
@@ -116,7 +117,7 @@ export async function executeLlmActionDirectives({ directives, task, runInfo, sc
 async function tryCreateGiteaIssue({ title, body, repo = 'goodandready/dsh-cron', fetchFn }) {
   try {
     let token = process.env.GITEA_TOKEN;
-    const credPath = '/mnt/external/Project/DEV/.gitea-agent-credentials.json';
+    const credPath = process.env.GITEA_CREDENTIALS_PATH || '';
     if (!token && fs.existsSync(credPath)) {
       const data = JSON.parse(fs.readFileSync(credPath, 'utf-8'));
       token = data?.agents?.antigravity?.token || data?.token;
@@ -136,6 +137,8 @@ async function tryCreateGiteaIssue({ title, body, repo = 'goodandready/dsh-cron'
       const json = await res.json().catch(() => ({}));
       return { number: json.number, url: json.html_url };
     }
-  } catch {}
+  } catch (err) {
+    /* ignore Gitea creation errors, best-effort */
+  }
   return null;
 }

package/lib/llm-ask.js

@@ -1,3 +1,4 @@
+import { bestEffort } from './best-effort.js';
 /**
  * Small helper for asking the configured model a short question (#44, #43).
  *
@@ -26,11 +27,11 @@ function getLlm(ctx) {
 /** Provider and model for an auxiliary question: task first, then the default. */
 export function resolveAskTarget(ctx, task = {}, preferredModel = '') {
   let defaultSelection = null;
-  try {
-    defaultSelection = ctx && typeof ctx.get === 'function'
+  defaultSelection = bestEffort('resolve-default-model', () => {
+    return ctx && typeof ctx.get === 'function'
       ? ctx.get('agentDefaultModel')?.currentSelection?.() || null
       : null;
-  } catch {}
+  }) || null;
   return {
     provider: task.provider || defaultSelection?.provider || '',
     model: preferredModel || task.model || defaultSelection?.model || '',
@@ -60,12 +61,10 @@ function isCleanFinish(kind) {
 async function buildUserMessage(text) {
   const content = [{ type: 'text', text }];
   const source = { kind: 'plugin', plugin: 'dsh-cron', form: 'helper-call' };
-  try {
-    const mod = await import('@deepseek-ai/dsh-llm');
-    if (mod && typeof mod.createUserMessage === 'function') {
-      return mod.createUserMessage({ content, source });
-    }
-  } catch {}
+  const mod = await bestEffort('import-dsh-llm', () => import('@deepseek-ai/dsh-llm'));
+  if (mod && typeof mod.createUserMessage === 'function') {
+    return mod.createUserMessage({ content, source });
+  }
   return { role: 'user', content, source };
 }
 

package/lib/recipes.js

@@ -207,7 +207,9 @@ export const RECIPES = [
 
 /** Detached copy of the catalog, safe to hand to the UI. */
 export function listRecipes() {
-  return RECIPES.map((recipe) => ({ ...recipe, channels: [...(recipe.channels || [])] }));
+  const destructive = findDestructiveRecipe();
+  const safeRecipes = destructive ? RECIPES.filter((r) => r.id !== destructive.id) : RECIPES;
+  return safeRecipes.map((recipe) => ({ ...recipe, channels: [...(recipe.channels || [])] }));
 }
 
 export function recipesByCategory() {

package/lib/runner.js

@@ -1,3 +1,4 @@
+import { bestEffort } from './best-effort.js';
 /**
  * Helper to detect context window overflow errors in persistent sessions (#145).
  */
@@ -19,21 +20,21 @@ export function isContextOverflowError(err) {
  */
 export function terminateProcessTree(child, sig = 'SIGTERM', { isPosix = process.platform !== 'win32', execFn } = {}) {
   if (!child || child.killed) return;
-  try {
+  bestEffort('terminate-process-tree', () => {
     if (isPosix && child.pid) {
-      try { process.kill(-child.pid, sig); } catch {}
+      bestEffort('kill-posix-pid', () => process.kill(-child.pid, sig));
     } else if (child.pid) {
       const runner = execFn || ((cmd) => {
-        try {
+        bestEffort('exec-taskkill-fn', () => {
           import('node:child_process').then(({ exec }) => {
             exec(cmd, { windowsHide: true }, () => {});
           }).catch(() => {});
-        } catch {}
+        });
       });
-      try { runner(`taskkill /pid ${child.pid} /T /F`); } catch {}
-      try { child.kill(sig); } catch {}
+      bestEffort('exec-taskkill', () => runner(`taskkill /pid ${child.pid} /T /F`));
+      bestEffort('child-kill', () => child.kill(sig));
     }
-  } catch {}
+  });
 }
 
 /**
@@ -145,14 +146,14 @@ export class SessionRunner {
   resolveCwd(task) {
     if (task.cwd) return String(task.cwd);
     if (task.workspaceId && this.ctx && typeof this.ctx.get === 'function') {
-      try {
+      const resolved = bestEffort('resolve-workspace-path', () => {
         const workspaces = this.ctx.get('workspaces');
         const ws = workspaces && (typeof workspaces.get === 'function'
           ? workspaces.get(task.workspaceId)
           : (workspaces[task.workspaceId] || null));
-        const resolved = ws && (ws.path || ws.cwd || ws.root || ws.dir);
-        if (resolved) return String(resolved);
-      } catch {}
+        return ws && (ws.path || ws.cwd || ws.root || ws.dir);
+      });
+      if (resolved) return String(resolved);
       return String(task.workspaceId);
     }
     return process.cwd();
@@ -239,20 +240,19 @@ export class SessionRunner {
   async _runViaRemoteWorkspace(task, signal) {
     if (!task.sshProfileId || !this.ctx || typeof this.ctx.get !== 'function') return null;
     let svc = null;
-    try {
-      svc = this.ctx.get('remoteSsh');
-    } catch {}
+    svc = bestEffort('get-remoteSsh', () => this.ctx.get('remoteSsh'));
     if (!svc || typeof svc.exec !== 'function') return null;
 
     let profile = null;
-    try {
+    profile = bestEffort('get-remoteSsh-profile', () => {
       const settings = this.ctx.get('settings');
       if (settings && typeof settings.get === 'function') {
         const snap = settings.get('dsh-remote-workspace');
         const profiles = snap && Array.isArray(snap.profiles) ? snap.profiles : [];
-        profile = profiles.find((p) => p && p.id === task.sshProfileId) || null;
+        return profiles.find((p) => p && p.id === task.sshProfileId) || null;
       }
-    } catch {}
+      return null;
+    });
     if (!profile) {
       throw new Error(`remote-workspace profile "${task.sshProfileId}" was not found — check dsh-remote-workspace settings, or use sshTarget instead`);
     }
@@ -295,7 +295,7 @@ export class SessionRunner {
         terminateProcessTree(child, sig, {
           isPosix,
           execFn: (cmd) => {
-            try { exec(cmd, { windowsHide: true }, () => {}); } catch {}
+            bestEffort('exec-cmd', () => exec(cmd, { windowsHide: true }, () => {}));
           }
         });
       };
@@ -438,22 +438,22 @@ export class SessionRunner {
       // Context window overflow auto-recovery in persistent sessions (#145)
       if (prep.targetSessionId && isContextOverflowError(err) && !signal?.aborted) {
         console.warn(`[dsh-cron] Persistent session "${prep.targetSessionId}" exceeded context window (${err.message}). Auto-recovering with fresh session...`);
-        try {
+        bestEffort('archive-rotated-session', () => {
           const sessions = this.ctx?.get?.('sessions');
           if (sessions && typeof sessions.archive === 'function') {
             sessions.archive(prep.targetSessionId);
           }
-        } catch {}
+        });
         const rotatedSessionId = `${prep.targetSessionId}-${Date.now().toString(36)}`;
         console.log(`[dsh-cron] Rotated persistent session "${prep.targetSessionId}" -> "${rotatedSessionId}"`);
         if (this.store) {
-          try {
+          bestEffort('update-stored-rotated-session', () => {
             const stored = this.store.get(task.id);
             if (stored) {
               stored.targetSessionId = rotatedSessionId;
               this.store.set(stored);
             }
-          } catch {}
+          });
         }
         task.targetSessionId = rotatedSessionId;
         effectiveTask.targetSessionId = rotatedSessionId;
@@ -468,16 +468,11 @@ export class SessionRunner {
   async _prepareAgentRun(task, runtime, signal) {
     const { randomUUID } = await import('node:crypto');
     let createUserMessage = (m) => m;
-    try {
-      const llmModule = await import('@deepseek-ai/dsh-llm');
-      if (llmModule && typeof llmModule.createUserMessage === 'function') {
-        createUserMessage = llmModule.createUserMessage;
-      }
-    } catch {}
-    let sessionModule = null;
-    try {
-      sessionModule = await import('@deepseek-ai/dsh-session');
-    } catch {}
+    const llmModule = await bestEffort('import-dsh-llm', () => import('@deepseek-ai/dsh-llm'));
+    if (llmModule && typeof llmModule.createUserMessage === 'function') {
+      createUserMessage = llmModule.createUserMessage;
+    }
+    const sessionModule = await bestEffort('import-dsh-session', () => import('@deepseek-ai/dsh-session'));
 
     const targetSessionId = resolveTargetSessionId(task.targetSessionId, task.targetSessionReset);
 
@@ -665,23 +660,23 @@ ${prompt}`;
   /** Token usage reported by the session, when the core exposes it. */
   _extractUsage(handle) {
     const usage = { inputTokens: 0, outputTokens: 0, cacheReadTokens: 0 };
-    try {
+    bestEffort('extract-session-usage', () => {
       const sessionUsage = handle.agent.session?.usage || handle.agent.usage;
       if (sessionUsage) {
         usage.inputTokens = sessionUsage.inputTokens || sessionUsage.promptTokens || 0;
         usage.outputTokens = sessionUsage.outputTokens || sessionUsage.completionTokens || 0;
         usage.cacheReadTokens = sessionUsage.cacheReadTokens || sessionUsage.cachedTokens || 0;
       }
-    } catch {}
+    });
     return usage;
   }
 
   /** Dispose the session, archive it best-effort, drop the worktree (#30, #29). */
   async _disposeAgentRun(task, prep, handle) {
     let archivedSessionId = null;
-    try {
-      archivedSessionId = (handle && handle.agent && handle.agent.session && handle.agent.session.id) || null;
-    } catch {}
+    archivedSessionId = bestEffort('get-archived-session-id', () => {
+      return (handle && handle.agent && handle.agent.session && handle.agent.session.id) || null;
+    }) || null;
     try {
       if (handle && typeof handle.dispose === 'function') {
         await handle.dispose();
@@ -694,12 +689,12 @@ ${prompt}`;
     // Best-effort: keep ephemeral cron sessions out of the main chat list (#30).
     // Persistent sessions (targetSessionId configured) stay unarchived so users can interact with them (#143).
     if (archivedSessionId && this.ctx && this.ctx.get && !prep.targetSessionId) {
-      try {
+      bestEffort('archive-session-cleanup', () => {
         const sessions = this.ctx.get('sessions');
         if (sessions && typeof sessions.archive === 'function') {
           sessions.archive(archivedSessionId);
         }
-      } catch {}
+      });
     }
     // #29: dispose the isolated worktree (kept when keepWorktree is set).
     if (prep.taskWorktree && !task.keepWorktree) {

package/lib/runtimes.js

@@ -1,3 +1,4 @@
+import { bestEffort } from './best-effort.js';
 /**
  * Runtime invocation builders for non-LLM task types (#4, #5, #7, #8, #9, #38).
  *
@@ -68,9 +69,8 @@ function detectPython(task, cwd) {
   candidates.push(path.join(base, '.venv', 'Scripts', 'python.exe'));
   candidates.push(path.join(base, 'venv', 'bin', 'python'));
   for (const candidate of candidates) {
-    try {
-      if (fs.existsSync(candidate)) return candidate;
-    } catch {}
+    const exists = bestEffort('check-python-candidate', () => fs.existsSync(candidate));
+    if (exists) return candidate;
   }
   return process.platform === 'win32' ? 'python' : 'python3';
 }

package/lib/scheduler.js

@@ -1,3 +1,4 @@
+import { bestEffort } from './best-effort.js';
 import { Cron } from 'croner';
 import { exec } from 'node:child_process';
 import fs from 'node:fs';
@@ -341,9 +342,7 @@ export class TaskScheduler {
           costUsd: 0,
         };
 
-        try {
-          this.store.recordRun(task.id, runInfo);
-        } catch {}
+        bestEffort('record-run', () => this.store.recordRun(task.id, runInfo), this.logger);
 
         await this.deliverNotifications(task, runInfo);
 
@@ -404,30 +403,22 @@ export class TaskScheduler {
   stopAll() {
     this.stopHeartbeatWatcher();
     for (const [id, job] of this.jobs.entries()) {
-      try {
-        job.stop();
-      } catch {}
+      bestEffort('stop-job', () => job.stop(), this.logger);
     }
     this.jobs.clear();
 
     for (const [id, timer] of this.timers.entries()) {
-      try {
-        clearTimeout(timer);
-      } catch {}
+      bestEffort('clear-timer', () => clearTimeout(timer), this.logger);
     }
     this.timers.clear();
 
     for (const [id, timer] of this.retryTimers.entries()) {
-      try {
-        clearTimeout(timer);
-      } catch {}
+      bestEffort('clear-retry-timer', () => clearTimeout(timer), this.logger);
     }
     this.retryTimers.clear();
 
     for (const [, run] of this.running.entries()) {
-      try {
-        run.controller.abort(new Error('Scheduler stopped'));
-      } catch {}
+      bestEffort('abort-running', () => run.controller.abort(new Error('Scheduler stopped')), this.logger);
     }
     this.running.clear();
   }
@@ -994,9 +985,7 @@ export class TaskScheduler {
     }
     const running = this.running.get(taskId);
     if (running) {
-      try {
-        running.controller.abort(new Error('Task paused'));
-      } catch {}
+      bestEffort('abort-paused-task', () => running.controller.abort(new Error('Task paused')), this.logger);
       this.running.delete(taskId);
     }
     this.queue = this.queue.filter((item) => item.taskId !== taskId);
@@ -1016,9 +1005,7 @@ export class TaskScheduler {
     }
     const running = this.running.get(taskId);
     if (running) {
-      try {
-        running.controller.abort(new Error('Task deleted'));
-      } catch {}
+      bestEffort('abort-deleted-task', () => running.controller.abort(new Error('Task deleted')), this.logger);
       this.running.delete(taskId);
     }
     this.queue = this.queue.filter((item) => item.taskId !== taskId);

package/lib/secrets.js

@@ -1,3 +1,4 @@
+import { bestEffort } from './best-effort.js';
 /**
  * Credential handling for dsh-cron (#51).
  *
@@ -54,10 +55,8 @@ export async function resolveCredentialValue(ctx, refName) {
       // Prefer the harness ref factory; fall back to the plain name when the
       // package is not installed (keeps tests and trimmed builds working).
       let ref = name;
-      try {
-        const mod = await import('@deepseek-ai/dsh-credentials');
-        if (mod && typeof mod.credentialRef === 'function') ref = mod.credentialRef(name);
-      } catch {}
+      const mod = await bestEffort('import-credentials', () => import('@deepseek-ai/dsh-credentials'));
+      if (mod && typeof mod.credentialRef === 'function') ref = mod.credentialRef(name);
       const hit = await creds.resolve(ref);
       if (hit && hit.value) return String(hit.value);
     }
@@ -70,7 +69,7 @@ export async function resolveCredentialValue(ctx, refName) {
 
 /** Read the best-effort Telegram defaults from the messenger-gateway file. */
 function readGatewayToken() {
-  try {
+  return bestEffort('read-gateway-token', () => {
     const p = getDshSettingsPath();
     if (!fs.existsSync(p)) return null;
     const text = fs.readFileSync(p, 'utf-8');
@@ -82,8 +81,8 @@ function readGatewayToken() {
       const hit = /^[ \t]+botToken:[ \t]*(.+?)[ \t]*$/.exec(line);
       if (hit) return hit[1].replace(/^['"]|['"]$/g, '').trim() || null;
     }
-  } catch {}
-  return null;
+    return null;
+  }) || null;
 }
 
 /**

package/lib/store.js

@@ -1,3 +1,4 @@
+import { bestEffort } from './best-effort.js';
 import fs from 'node:fs';
 import path from 'node:path';
 import { getDshDefaultTelegramCredentials } from './telegram.js';
@@ -68,7 +69,7 @@ export class TaskStore {
         const raw = fs.readFileSync(this.filePath, 'utf-8');
         loadData(raw);
         if (!fs.existsSync(bakPath)) {
-          try { fs.copyFileSync(this.filePath, bakPath); } catch {}
+          bestEffort('backup-initial', () => fs.copyFileSync(this.filePath, bakPath));
         }
       } catch (err) {
         console.error('[dsh-cron] store read error (corrupted file):', err.message);
@@ -93,7 +94,7 @@ export class TaskStore {
       try {
         const rawBak = fs.readFileSync(bakPath, 'utf-8');
         loadData(rawBak);
-        try { fs.copyFileSync(bakPath, this.filePath); } catch {}
+        bestEffort('restore-from-bak', () => fs.copyFileSync(bakPath, this.filePath));
         console.warn(`[dsh-cron] restored missing tasks store from ${bakPath}`);
       } catch (bakErr) {
         console.error('[dsh-cron] failed to restore tasks store from .bak:', bakErr.message);
@@ -119,9 +120,7 @@ export class TaskStore {
       const tmp = `${this.filePath}.tmp.${process.pid}_${Date.now()}_${rand}`;
       fs.writeFileSync(tmp, JSON.stringify(data, null, 2), 'utf-8');
       fs.renameSync(tmp, this.filePath);
-      try {
-        fs.copyFileSync(this.filePath, `${this.filePath}.bak`);
-      } catch {}
+      bestEffort('backup-on-save', () => fs.copyFileSync(this.filePath, `${this.filePath}.bak`));
     } catch (err) {
       console.error('[dsh-cron] store save error:', err.message);
     }
@@ -393,9 +392,7 @@ export class TaskStore {
       const archivePath = path.join(dir, 'tasks-history-archive.json');
       let archive = {};
       if (fs.existsSync(archivePath)) {
-        try {
-          archive = JSON.parse(fs.readFileSync(archivePath, 'utf-8')) || {};
-        } catch {}
+        archive = bestEffort('parse-history-archive', () => JSON.parse(fs.readFileSync(archivePath, 'utf-8'))) || {};
       }
       if (!Array.isArray(archive[id])) archive[id] = [];
       archive[id].push(...overflowRuns);

package/lib/templates.js

@@ -51,7 +51,7 @@ export function buildTemplateVars(task, runInfo = {}) {
   const error = runInfo.error || (status === 'error' || status === 'timeout' ? runInfo.output || '' : '');
   const usage = runInfo.usage || {};
   const tokens = (usage.inputTokens || 0) + (usage.outputTokens || 0) + (usage.cacheReadTokens || 0);
-  return {
+  const vars = {
     title: task.title || 'Task',
     id: task.id || '',
     status,
@@ -65,6 +65,10 @@ export function buildTemplateVars(task, runInfo = {}) {
     model: runInfo.model || '',
     diagnosis: truncateText(runInfo.diagnosis || ''),
   };
+  for (const key of TEMPLATE_VARIABLES) {
+    if (vars[key] === undefined) vars[key] = '';
+  }
+  return vars;
 }
 
 /** Replace {var} placeholders; unknown placeholders are left untouched. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-cron",
-  "version": "0.2.17",
+  "version": "0.2.19",
   "description": "Scheduled cron tasks, background automation and agent execution for DeepSeek Harness.",
   "type": "module",
   "main": "lib/index.js",
@@ -45,8 +45,8 @@
     "client": {
       "platform": "web",
       "inject": [
-        "locale",
-        "slots"
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-slots"
       ]
     }
   },