@goodandready/dsh-context-lens 0.1.16 → 0.1.17

package/README.md

@@ -22,6 +22,16 @@
   <a href="README.zh.md"><b>🇨🇳 中文说明</b></a>
 </p>
 
+<table align="center">
+  <tr>
+    <td align="center">
+      ⭐ <strong>If you like this plugin, please star it on GitHub</strong> — it shows me that the plugin is useful to you and motivates me to keep developing it.
+      <br><br>
+      🐛 <strong>If you find a bug or would like to request a feature</strong>, open a GitHub issue in any language — I will review your proposal and implement useful suggestions in a future plugin version.
+    </td>
+  </tr>
+</table>
+
 </div>
 
 ---
@@ -32,7 +42,7 @@
 
 Large context windows are expensive, prone to model distraction, and vulnerable to rate limits. When agents inspect multi-file codebases or run bulky test suites, thousands of tokens are wasted on boilerplate function bodies, passing test logs, and build artifacts. 
 
-`dsh-context-lens` introduces **active path focusing, AST structural code skeletonization (JS/TS/Python/Go), and fast O(n) heuristic log compression**, shrinking context consumption by **up to 85%** while keeping 100% of essential architectural interfaces and failure traces.
+`dsh-context-lens` introduces **active path focusing, AST structural code skeletonization (JS/TS/Python/Go/Rust/Java/C/C++/SQL), and fast O(n) heuristic log compression**, shrinking context consumption by **up to 85%** while keeping 100% of essential architectural interfaces and failure traces.
 
 ```mermaid
 graph LR
@@ -148,7 +158,6 @@ dsh-context-lens:
 
 MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
 
-
 ## Changed in v0.1.11
 
 Audit fixes (#33–#47, #18):
@@ -161,19 +170,16 @@ Audit fixes (#33–#47, #18):
 - Python imports kept in skeletons; Java locals no longer mistaken for signatures.
 - Shared `estimateTokens` helper; unused `dsh-credentials` peer removed.
 
-
 ## Changed in v0.1.12
 
 #43: extract shared `StatusPanel` used by LensTab and HeaderChip popover (budget bar, history, refresh).
 
-
 ## Changed in v0.1.13
 
 - **Fix (#50)**: Guard optional `betterSidebar` tab registration via `ctx.inject(['betterSidebar'], ...)` instead of direct property access on Cordis context proxy, resolving `cannot get property "betterSidebar" without inject` on client boot.
 - **Fix (#50)**: Safely guard `_ctx.settingsScope` access in `PluginCard` with try/catch to prevent proxy property errors.
 - **Test**: Added regression test suite simulating strict Cordis Context Proxy behavior.
 
-
 ## Changed in v0.1.15
 
 - **Feature (#54)**: Support native DSH right sidebar (`ctx.sidebarRightTabs` + `sidebar.right.pane.tab` slot) introduced in DSH 0.1.5-alpha.1.

package/README.ru.md

@@ -22,6 +22,16 @@
   <a href="README.zh.md"><b>🇨🇳 中文说明</b></a>
 </p>
 
+<table align="center">
+  <tr>
+    <td align="center">
+      ⭐ <strong>Если вам нравится этот плагин, поставьте ему звезду на GitHub</strong> — это покажет мне, что плагин вам полезен, и будет мотивировать меня развивать его дальше.
+      <br><br>
+      🐛 <strong>Если вы нашли баг или хотите предложить новый функционал</strong>, создайте issue на GitHub на любом языке — я рассмотрю ваше предложение и реализую полезные идеи в одной из следующих версий плагина.
+    </td>
+  </tr>
+</table>
+
 </div>
 
 ---
@@ -32,7 +42,7 @@
 
 Большие объёмы контекста приводят к высоким затратам токенов, замедлению генерации и быстрой перегрузке лимитов. При изучении крупных репозиториев или прогоне тестов тысячи токенов тратятся на однотипные тела функций, логи успешных тестов и сборку.
 
-Плагин внедряет **фокусировку на активных файлах, AST-скелетонизацию исходного кода (JS/TS/Python/Go) и сверхбыструю эвристическую компрессию логов**, снижая расход контекста **до 85%** при сохранении 100% сигнатур типов, интерфейсов и сообщений об ошибках.
+Плагин внедряет **фокусировку на активных файлах, AST-скелетонизацию исходного кода (JS/TS/Python/Go/Rust/Java/C/C++/SQL) и сверхбыструю эвристическую компрессию логов**, снижая расход контекста **до 85%** при сохранении 100% сигнатур типов, интерфейсов и сообщений об ошибках.
 
 ```mermaid
 graph LR
@@ -145,24 +155,20 @@ dsh-context-lens:
 
 MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
 
-
 ## Changed in v0.1.11
 
 Исправления audit #33–#47 / #18: режим auto-compress не форсирует balanced; budgetLimit останавливает подсчёт; focus per-session; поля settings card; optional betterSidebar; серверный preview; Python imports / Java locals; общий estimateTokens; удалён unused peer dsh-credentials.
 
-
 ## Changed in v0.1.12
 
 #43: extract shared `StatusPanel` used by LensTab and HeaderChip popover (budget bar, history, refresh).
 
-
 ## Changed in v0.1.13
 
 - **Fix (#50)**: Безопасная регистрация вкладки BetterSidebar через `ctx.inject(['betterSidebar'], ...)` вместо прямого чтения свойства из Cordis Context Proxy. Устранена ошибка `cannot get property "betterSidebar" without inject` при загрузке клиентской половины в DSH.
 - **Fix (#50)**: Безопасное обращение к `_ctx.settingsScope` в `PluginCard` через try/catch.
 - **Тесты**: Добавлены регрессионные тесты со строгим Cordis Context Proxy.
 
-
 ## Changed in v0.1.15
 
 - **Функциональность (#54)**: Поддержка встроенной правой боковой панели DSH (`ctx.sidebarRightTabs` + слот `sidebar.right.pane.tab`) из DSH 0.1.5-alpha.1.

package/README.zh.md

@@ -22,6 +22,16 @@
   <a href="README.zh.md"><b>🇨🇳 中文说明</b></a>
 </p>
 
+<table align="center">
+  <tr>
+    <td align="center">
+      ⭐ <strong>如果您喜欢这个插件，请在 GitHub 上为它点亮 Star</strong> — 这能让我知道插件对您有用，并鼓励我继续开发和维护它。
+      <br><br>
+      🐛 <strong>如果您发现 Bug 或希望增加功能</strong>，请使用任意语言在 GitHub 上提交 Issue — 我会评估您的建议，并在后续版本中实现有价值的改进。
+    </td>
+  </tr>
+</table>
+
 </div>
 
 ---
@@ -30,7 +40,7 @@
 
 **`dsh-context-lens`** 为 **DeepSeek Harness** 智能体提供深度上下文窗口与 Token 预算优化。
 
-超长上下文不仅消耗高昂 Token 成本，还会导致模型注意力涣散并频繁触发限流。本插件通过**工作区文件焦点聚焦、跨语言 AST 结构骨架提取（支持 JS/TS/Python/Go）以及 $O(n)$ 终端测试日志启发式精简**，在保留 100% 架构接口与错误堆栈的前提下，将上下文体积削减**高达 85%**。
+超长上下文不仅消耗高昂 Token 成本，还会导致模型注意力涣散并频繁触发限流。本插件通过**工作区文件焦点聚焦、跨语言 AST 结构骨架提取（支持 JS/TS/Python/Go/Rust/Java/C/C++/SQL）以及 $O(n)$ 终端测试日志启发式精简**，在保留 100% 架构接口与错误堆栈的前提下，将上下文体积削减**高达 85%**。
 
 ```mermaid
 graph LR

package/lib/ast/skeletonizer.js

@@ -1,13 +1,17 @@
-// ponytail: regex skeletons, no tree-sitter — handles JS/TS/Python/Go/Rust/Java signatures + imports/comments + multiline signatures
+// ponytail: regex skeletons, no tree-sitter — handles JS/TS/Python/Go/Rust/Java/C/C++/SQL signatures + imports/comments + multiline signatures
 const JS_FUNC_RE = /^\s*(export\s+)?(async\s+)?(function\s+(\w+)|const\s+(\w+)\s*=\s*(async\s+)?\([^)]*\)\s*=>|(\w+)\s*:\s*\([^)]*\)\s*=>|class\s+(\w+)|interface\s+(\w+)|type\s+(\w+)\s*=)/;
 const PY_RE = /^\s*(def\s+(\w+)\s*\([^)]*\)|class\s+(\w+).*?:|async def\s+(\w+)\s*\([^)]*\))/;
 const GO_RE = /^\s*(func\s+(\([^)]+\)\s+)?(\w+)\s*\([^)]*\)|type\s+(\w+)\s+(struct|interface))/;
 const RUST_RE = /^\s*(pub(\([^)]+\))?\s+)?(async\s+)?(fn|struct|enum|impl|trait|type|const|static)\s+\w+/;
-const IMPORT_RE = /^\s*import\s+.*from\s+['"].*['"]|^\s*import\s+['"].*['"]|^\s*export\s+.*from\s+['"]|^\s*use\s+[a-zA-Z0-9_:]+|^\s*(from\s+\S+\s+)?import\s+\S+|^\s*from\s+\S+\s+import\s+/;
-const COMMENT_RE = /^\s*(\/\/.*|\/\*.*\*\/|\/\*.*|\*.*|#.*)/;
+const CPP_CLASS_RE = /^\s*(?:class|struct)\s+\w+(?:\s*:\s*(?:public|protected|private)\s+\w+)?/;
+const CPP_FUNC_RE = /^\s*(?:(?:virtual|inline|static|explicit|constexpr|friend)\s+)*(?:[\w:<>&*~]+\s+)+[\w:~]+\s*\([^)]*\)(?:\s*const)?(?:\s*override|\s*noexcept)?(?:\s*=\s*0)?/;
+const SQL_RE = /^\s*(?:CREATE|ALTER)\s+(?:TABLE|VIEW|INDEX|TRIGGER|FUNCTION|PROCEDURE)\s+(?:IF\s+NOT\s+EXISTS\s+)?[\w."`]+|^\s*CONSTRAINT\s+[\w."`]+|^\s*FOREIGN\s+KEY|^\s*PRIMARY\s+KEY/i;
+
+const IMPORT_RE = /^\s*#include\s+[<"][^>"]+[>"]|^\s*import\s+.*from\s+['"].*['"]|^\s*import\s+['"].*['"]|^\s*export\s+.*from\s+['"]|^\s*use\s+[a-zA-Z0-9_:]+|^\s*(from\s+\S+\s+)?import\s+\S+|^\s*from\s+\S+\s+import\s+/;
+const COMMENT_RE = /^\s*(\/\/.*|\/\*.*\*\/|\/\*.*|\*.*|#.*|--.*)/;
 
 // Multiline signature starters
-const MULTILINE_START_RE = /^\s*(export\s+)?(async\s+)?(function\b|const\s+\w+\s*=|\w+\s*:\s*(async\s+)?\(|def\b|async\s+def\b|func\b|(pub(\([^)]+\))?\s+)?(async\s+)?fn\b|(?:(?:public|protected|private|static|final|abstract|synchronized|native|default)\s+)+[\w.<>,\[\]?]+\s+\w+\s*\()/;
+const MULTILINE_START_RE = /^\s*(export\s+)?(async\s+)?(function\b|const\s+\w+\s*=|\w+\s*:\s*(async\s+)?\(|def\b|async\s+def\b|func\b|(pub(\([^)]+\))?\s+)?(async\s+)?fn\b|(?:(?:public|protected|private|static|final|abstract|synchronized|native|default)\s+)+[\w.<>,\[\]?]+\s+\w+\s*\(|(?:(?:virtual|inline|static|explicit|constexpr|friend)\s+)*(?:[\w:<>&*~]+\s+)+[\w:~]+\s*\()/;
 
 function indentDepth(line) {
   const m = line.match(/^(\s*)/);
@@ -28,7 +32,7 @@ export function skeletonize(text, { maxDepth = 3, language, includeImports = tru
     const d = indentDepth(raw);
     if (d > maxDepth) { pendingComment = null; continue; }
 
-    // Handle imports
+    // Handle imports & includes
     if (includeImports && IMPORT_RE.test(line)) {
       const sig = line.trim().slice(0, 120);
       if (!seen.has(sig)) {
@@ -39,19 +43,19 @@ export function skeletonize(text, { maxDepth = 3, language, includeImports = tru
       continue;
     }
 
-    // Handle comments (keep JSDoc or line comments directly above a definition)
+    // Handle comments (keep doc or line comments directly above a definition)
     if (includeComments && COMMENT_RE.test(line)) {
       let nextIdx = idx + 1;
       while (nextIdx < lines.length && !lines[nextIdx].trim()) nextIdx++;
       if (nextIdx < lines.length) {
         const nextLine = lines[nextIdx];
-        if (JS_FUNC_RE.test(nextLine) || PY_RE.test(nextLine) || GO_RE.test(nextLine) || RUST_RE.test(nextLine) || MULTILINE_START_RE.test(nextLine) || /^\s*(class|function|interface|type|def |func |pub |fn )/.test(nextLine)) {
+        if (JS_FUNC_RE.test(nextLine) || PY_RE.test(nextLine) || GO_RE.test(nextLine) || RUST_RE.test(nextLine) || CPP_CLASS_RE.test(nextLine) || CPP_FUNC_RE.test(nextLine) || SQL_RE.test(nextLine) || MULTILINE_START_RE.test(nextLine) || /^\s*(class|function|interface|type|def |func |pub |fn )/.test(nextLine)) {
           pendingComment = line.trim().slice(0, 120);
           continue;
         }
       }
       // Otherwise, keep top-level comments (up to 5)
-      if (out.length < 5 && (line.trim().startsWith('//') || line.trim().startsWith('#') || line.trim().startsWith('/*'))) {
+      if (out.length < 5 && (line.trim().startsWith('//') || line.trim().startsWith('#') || line.trim().startsWith('/*') || line.trim().startsWith('--'))) {
         const sig = line.trim().slice(0, 120);
         if (!seen.has(sig)) {
           seen.add(sig);
@@ -65,7 +69,7 @@ export function skeletonize(text, { maxDepth = 3, language, includeImports = tru
     // Multiline signature detection: if line starts a signature but doesn't finish with '{', '=>', or ':'
     let candidateLine = line;
     let accumulatedIdx = idx;
-    const isComplete = (s) => (s.includes('{') && s.includes(')')) || (s.includes('=>') && s.includes(')')) || (s.endsWith(':') && s.includes(')'));
+    const isComplete = (s) => (s.includes('{') && s.includes(')')) || (s.includes('=>') && s.includes(')')) || (s.endsWith(':') && s.includes(')')) || (s.includes(';') && s.includes(')'));
     if (MULTILINE_START_RE.test(candidateLine) && !isComplete(candidateLine)) {
       let buffer = candidateLine.trim();
       let scanIdx = idx + 1;
@@ -73,7 +77,7 @@ export function skeletonize(text, { maxDepth = 3, language, includeImports = tru
         const nextRaw = lines[scanIdx].trim();
         if (!nextRaw) { scanIdx++; continue; }
         buffer += ' ' + nextRaw;
-        if ((nextRaw.includes('{') || nextRaw.includes('=>') || nextRaw.endsWith(':')) && buffer.includes(')')) {
+        if ((nextRaw.includes('{') || nextRaw.includes('=>') || nextRaw.endsWith(':') || nextRaw.includes(';')) && buffer.includes(')')) {
           candidateLine = buffer;
           accumulatedIdx = scanIdx;
           break;
@@ -107,9 +111,21 @@ export function skeletonize(text, { maxDepth = 3, language, includeImports = tru
         || /^\s*(?:(?:public|protected|private|static|final|abstract|synchronized|native|default)\s+)+[\w.<>,\[\]?]+\s+\w+\s*\(/.test(candidateLine)
         || /^\s*(class|interface|enum|record)\s+\w+/.test(candidateLine)) sig = candidateLine.trim();
     }
+    if (!sig && (!language || language === 'cpp' || language === 'c')) {
+      if (CPP_CLASS_RE.test(candidateLine) || CPP_FUNC_RE.test(candidateLine)) {
+        sig = candidateLine.trim();
+      }
+    }
+    if (!sig && (!language || language === 'sql')) {
+      if (SQL_RE.test(candidateLine)) {
+        sig = candidateLine.trim();
+      }
+    }
     // generic fallback: if no specific language, try all
     if (!sig && !language) {
-      if (JS_FUNC_RE.test(candidateLine) || PY_RE.test(candidateLine) || GO_RE.test(candidateLine) || RUST_RE.test(candidateLine)) sig = candidateLine.trim();
+      if (JS_FUNC_RE.test(candidateLine) || PY_RE.test(candidateLine) || GO_RE.test(candidateLine) || RUST_RE.test(candidateLine) || CPP_CLASS_RE.test(candidateLine) || CPP_FUNC_RE.test(candidateLine) || SQL_RE.test(candidateLine)) {
+        sig = candidateLine.trim();
+      }
     }
 
     if (sig) {
@@ -125,8 +141,8 @@ export function skeletonize(text, { maxDepth = 3, language, includeImports = tru
         }
         pendingComment = null;
       }
-      // normalize: trim trailing { : etc, keep signature short
-      sig = sig.replace(/\s*\{\s*$/, '').replace(/:\s*$/, '').trim();
+      // normalize: trim trailing { : ; etc, keep signature short
+      sig = sig.replace(/\s*\{\s*$/, '').replace(/:\s*$/, '').replace(/;\s*$/, '').trim();
       if (sig.length > 180) sig = sig.slice(0, 177) + '...';
       const key = sig;
       if (!seen.has(key)) {
@@ -147,10 +163,10 @@ export function skeletonize(text, { maxDepth = 3, language, includeImports = tru
   const total = lines.filter(l => l.trim()).length;
   const removed = total - out.length;
   if (removed > 0 && out.length > 0) {
-    const commentPrefix = (language === 'py' || language === 'python') ? '# ' : '// ';
+    const commentPrefix = (language === 'py' || language === 'python') ? '# ' : (language === 'sql' ? '-- ' : '// ');
     out.push(`${commentPrefix}... ${removed} lines collapsed (skeleton, maxDepth=${maxDepth})`);
   }
   return out.join('\n');
 }
 
-export default { skeletonize };
+export default { skeletonize };

package/lib/client.js

@@ -5,7 +5,7 @@ window.__ModuleLoader__.load({
     const React = require('react');
     const NS = '@goodandready/dsh-context-lens';
 
-    const en = {
+        const en = {
       title: 'Context Lens & Token Guard',
       sub: 'AST compression, log filtering, token budget',
       mode: 'Compression mode',
@@ -23,39 +23,48 @@ window.__ModuleLoader__.load({
       lowBudget: 'Budget nearly exhausted',
       threshold: 'Auto-compress threshold (chars)',
       autoCollapse: 'Warn when budget is nearly exhausted',
+      budgetAlertPercent: 'Budget alert threshold (%)',
       previewApprox: 'Server preview',
       noData: 'No data yet',
       refresh: 'Refresh',
       ops: 'ops',
       active: 'Active',
       readyState: 'Ready',
-      lowBudgetBadge: 'Low Budget ⚠'
+      lowBudgetBadge: 'Low Budget ⚠',
+      focusPaths: 'Active focus',
+      noFocus: 'No focus paths set',
+      clearFocus: 'Clear focus'
     };
-    const ru = {
-      title: 'Context Lens & Token Guard',
-      sub: 'Сжатие AST, фильтрация логов, контроль токенов',
-      mode: 'Режим сжатия',
-      depth: 'Глубина AST',
-      tracking: 'Считать экономию',
-      preview: 'Предпросмотр лога',
-      compress: 'Сжать',
-      saved: 'Сэкономлено',
-      tokens: 'токенов',
-      placeholder: 'Вставьте лог Jest/Pytest…',
-      saving: 'Сохранение…',
-      ready: 'Готово',
-      budget: 'Бюджет',
-      history: 'Последние операции',
-      lowBudget: 'Бюджет почти исчерпан',
-      threshold: 'Порог авто-сжатия (символы)',
-      autoCollapse: 'Предупреждать при почти исчерпанном бюджете',
-      previewApprox: 'Серверный предпросмотр',
-      noData: 'Пока нет данных',
-      refresh: 'Обновить',
-      ops: 'оп.',
-      active: 'Активен',
-      readyState: 'Готов',
-      lowBudgetBadge: 'Мало бюджета ⚠'
+
+    const zh = {
+      title: 'Context Lens 上下文镜头与 Token 守卫',
+      sub: 'AST 代码精简、日志过滤与 Token 预算监控',
+      mode: '压缩模式',
+      depth: 'AST 最大深度',
+      tracking: '追踪 Token 节省',
+      preview: '日志预览',
+      compress: '压缩',
+      saved: '已节省',
+      tokens: 'Token',
+      placeholder: '在此粘贴 Jest/Pytest 等测试日志…',
+      saving: '保存中…',
+      ready: '已就绪',
+      budget: '预算',
+      history: '近期操作',
+      lowBudget: 'Token 预算即将耗尽',
+      threshold: '自动压缩阈值 (字符数)',
+      autoCollapse: '预算偏低时在界面提示警告',
+      budgetAlertPercent: '预算警告阈值 (%)',
+      previewApprox: '服务端压缩预览',
+      noData: '暂无数据',
+      refresh: '刷新',
+      ops: '次操作',
+      active: '运行中',
+      readyState: '已就绪',
+      lowBudgetBadge: '预算紧张 ⚠',
+      focusPaths: '当前聚焦路径',
+      noFocus: '未设置聚焦路径',
+      clearFocus: '清除聚焦'
     };
 
     function ensureCss() {
@@ -220,6 +229,18 @@ window.__ModuleLoader__.load({
 .cl-hist-item:last-child {
   border-bottom: none;
 }
+.cl-tag {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  padding: 2px 6px;
+  background: var(--dsw-alias-bg-layer-1);
+  border: 1px solid var(--dsw-alias-border-l2);
+  border-radius: 4px;
+  font-size: 11px;
+  font-family: monospace;
+  color: var(--dsw-alias-label-secondary);
+}
 .cl-error-box {
   padding: 12px;
   border-radius: 8px;
@@ -270,13 +291,13 @@ window.__ModuleLoader__.load({
       try {
         if (ctx && ctx.locale && typeof ctx.locale.getSnapshot === 'function') {
           const snap = ctx.locale.getSnapshot();
-          if (snap && snap.active && snap.active.startsWith('ru')) return ru;
+          if (snap && snap.active && snap.active.startsWith('zh')) return zh;
         }
       } catch {}
       return en;
     }
 
-    function StatusPanel({ stats, history, labels, onRefresh, title, showBadge, compact }) {
+    function StatusPanel({ stats, history, focus, sessionId, labels, onRefresh, onClearFocus, title, showBadge, compact }) {
       ensureCss();
       const L = labels || en;
       const warn = !!(stats && stats.lowBudget);
@@ -351,6 +372,33 @@ window.__ModuleLoader__.load({
         ));
       }
 
+            // Active focus paths section
+      const focusPaths = (focus && focus.paths) || [];
+      if (focusPaths.length > 0 || onClearFocus) {
+        children.push(React.createElement('div', {
+          key: 'focus',
+          style: { marginTop: 10, paddingTop: 8, borderTop: '1px solid var(--dsw-alias-border-l2)' }
+        },
+          React.createElement('div', {
+            style: { display: 'flex', justifyContent: 'space-between', alignItems: 'center', marginBottom: 4 }
+          },
+            React.createElement('span', { style: { fontSize: 11, fontWeight: 600, color: 'var(--dsw-alias-label-secondary)' } }, L.focusPaths),
+            focusPaths.length > 0 && onClearFocus
+              ? React.createElement('button', {
+                  type: 'button',
+                  onClick: onClearFocus,
+                  style: { background: 'none', border: 'none', padding: 0, fontSize: 10, color: 'var(--dsw-alias-label-tertiary)', cursor: 'pointer', textDecoration: 'underline' }
+                }, L.clearFocus)
+              : null
+          ),
+          focusPaths.length > 0
+            ? React.createElement('div', { style: { display: 'flex', flexWrap: 'wrap', gap: 4, marginTop: 4 } },
+                ...focusPaths.slice(0, 4).map((p, i) => React.createElement('span', { key: i, className: 'cl-tag' }, p))
+              )
+            : React.createElement('div', { style: { fontSize: 11, color: 'var(--dsw-alias-label-tertiary)', fontStyle: 'italic' } }, L.noFocus)
+        ));
+      }
+
       if (history && history.length) {
         children.push(React.createElement('div', {
           key: 'hist',
@@ -386,20 +434,31 @@ window.__ModuleLoader__.load({
         .then((r) => r.ok ? r.json() : null);
     }
 
+    function clearLensFocus(sessionId) {
+      const q = sessionId ? '?sessionId=' + encodeURIComponent(sessionId) : '';
+      return fetch('/dsh-context-lens/clear-focus' + q, { method: 'POST', headers: { accept: 'application/json' } })
+        .then((r) => r.ok ? r.json() : null);
+    }
+
     function LensTabInner({ ctx: _ctx, scope }) {
       ensureCss();
       const [stats, setStats] = React.useState(null);
       const [history, setHistory] = React.useState([]);
+      const [focus, setFocus] = React.useState(null);
+      const [sessionId, setSessionId] = React.useState(null);
       const L = React.useMemo(() => getActiveLocale(_ctx), [_ctx]);
       const apply = (j) => {
         if (j && j.stats) setStats(j.stats);
         if (j && j.history) setHistory(j.history || []);
+        if (j && j.focus) setFocus(j.focus);
+        if (j && j.sessionId) setSessionId(j.sessionId);
       };
       const refresh = () => fetchLensStatus().then(apply).catch(() => {});
+      const handleClearFocus = () => clearLensFocus(sessionId).then(() => refresh()).catch(() => {});
       React.useEffect(() => { refresh(); }, []);
       return React.createElement('div', { style: { padding: 12 } },
         React.createElement(StatusPanel, {
-          stats, history, labels: L, onRefresh: refresh, title: 'Context Lens', showBadge: false, compact: false
+          stats, history, focus, sessionId, labels: L, onRefresh: refresh, onClearFocus: handleClearFocus, title: 'Context Lens', showBadge: false, compact: false
         })
       );
     }
@@ -414,6 +473,8 @@ window.__ModuleLoader__.load({
       ensureCss();
       const [stats, setStats] = React.useState(null);
       const [history, setHistory] = React.useState([]);
+      const [focus, setFocus] = React.useState(null);
+      const [sessionId, setSessionId] = React.useState(null);
       const [open, setOpen] = React.useState(false);
       const ref = React.useRef(null);
       const L = React.useMemo(() => getActiveLocale(_ctx), [_ctx]);
@@ -421,8 +482,12 @@ window.__ModuleLoader__.load({
       const fetchStatus = () => fetchLensStatus().then((j) => {
         if (j && j.stats) setStats(j.stats);
         if (j && j.history) setHistory(j.history || []);
+        if (j && j.focus) setFocus(j.focus);
+        if (j && j.sessionId) setSessionId(j.sessionId);
       }).catch(() => {});
 
+      const handleClearFocus = () => clearLensFocus(sessionId).then(() => fetchStatus()).catch(() => {});
+
       React.useEffect(() => {
         let alive = true;
         fetchStatus();
@@ -475,7 +540,7 @@ window.__ModuleLoader__.load({
         onClick: (e) => e.stopPropagation()
       },
         React.createElement(StatusPanel, {
-          stats, history, labels: L, onRefresh: fetchStatus, title: 'Context Lens', showBadge: true, compact: true
+          stats, history, focus, sessionId, labels: L, onRefresh: fetchStatus, onClearFocus: handleClearFocus, title: 'Context Lens', showBadge: true, compact: true
         })
       ) : null;
 
@@ -507,6 +572,7 @@ window.__ModuleLoader__.load({
         astSkeletonMaxDepth: 3,
         tokenSavingsTracking: true,
         budgetLimit: 100000,
+        budgetAlertPercent: 90,
         autoCollapse: true,
         autoCompressThreshold: 4000
       });
@@ -696,6 +762,14 @@ window.__ModuleLoader__.load({
                 onChange: (e) => setDraft((d) => ({ ...d, budgetLimit: parseInt(e.target.value, 10) || 100000 }))
               })
             ),
+            React.createElement('div', { className: 'cl-field', style: { display: 'flex', flexDirection: 'column', gap: 6, padding: '8px 0' } },
+              React.createElement('label', { style: { fontSize: 13, color: 'var(--dsw-alias-label-secondary)' } }, tt('budgetAlertPercent')),
+              React.createElement('input', {
+                className: 'cl-input', type: 'number', min: 50, max: 99, step: 1,
+                value: draft.budgetAlertPercent,
+                onChange: (e) => setDraft((d) => ({ ...d, budgetAlertPercent: parseInt(e.target.value, 10) || 90 }))
+              })
+            ),
             React.createElement('div', { className: 'cl-field', style: { display: 'flex', flexDirection: 'column', gap: 6, padding: '8px 0' } },
               React.createElement('label', { style: { fontSize: 13, color: 'var(--dsw-alias-label-secondary)' } }, tt('threshold')),
               React.createElement('input', {
@@ -743,7 +817,7 @@ window.__ModuleLoader__.load({
 
     module.exports.inject = ['slots', 'locale'];
     module.exports.apply = function apply(ctx) {
-      try { ctx.locale.register(NS, { en, ru }); } catch (e) { console.warn('[dsh-context-lens] locale register failed', e && e.message || e); }
+      try { ctx.locale.register(NS, { en, zh }); } catch (e) { console.warn('[dsh-context-lens] locale register failed', e && e.message || e); }
       if (!ctx.slots) return;
       let registered = false;
       const doRegister = () => {

package/lib/index.js

@@ -13,6 +13,7 @@ export const Config = z.object({
   tokenSavingsTracking: z.boolean().default(true).description('Track and display token budget savings'),
   autoCompressThreshold: z.number().default(4000).description('Auto-compress threshold in chars (0 to disable)'),
   budgetLimit: z.number().default(100000).description('Session token budget; compressions stop counting after this limit'),
+  budgetAlertPercent: z.number().default(90).description('Budget percentage threshold (50-99%) for warning alert'),
   autoCollapse: z.boolean().default(true).description('Warn in UI when budget is nearly exhausted (does not force-close the settings card)')
 });
 
@@ -37,6 +38,14 @@ function getFocus(key) {
   return focusBySession.get(key);
 }
 
+function clearFocus(key) {
+  if (key) {
+    focusBySession.set(key, { paths: [], updatedAt: new Date().toISOString() });
+  } else {
+    focusBySession.clear();
+  }
+}
+
 const OUTPUT_SCHEMA = { type: 'object', properties: { success: { type: 'boolean' } }, additionalProperties: true };
 const renderOutput = (_args, result) => JSON.stringify(result, null, 2);
 
@@ -53,6 +62,7 @@ export function apply(ctx, config) {
       const cfg = getConfig();
       if (cfg && cfg.tokenSavingsTracking === false) return null;
       if (cfg && typeof cfg.budgetLimit === 'number') tracker.setBudgetLimit(cfg.budgetLimit);
+      if (cfg && typeof cfg.budgetAlertPercent === 'number') tracker.setBudgetAlertPercent(cfg.budgetAlertPercent);
       return tracker.record(original, compressed);
     } catch {
       // #39: never record on config/read errors
@@ -114,12 +124,12 @@ export function apply(ctx, config) {
 
     ctx.tools.register({
       name: 'context_lens_compress_code',
-      description: 'Generate AST skeleton for a large source file (JS/TS/Python/Go/Rust/Java) to save context',
+      description: 'Generate AST skeleton for a large source file (JS/TS/Python/Go/Rust/Java/C/C++/SQL) to save context',
       parameters: {
         type: 'object',
         properties: {
           code: { type: 'string', description: 'Source code to skeletonize' },
-          language: { type: 'string', enum: ['js', 'ts', 'py', 'python', 'go', 'rust', 'java'], description: 'Language hint' },
+          language: { type: 'string', enum: ['js', 'ts', 'py', 'python', 'go', 'rust', 'java', 'c', 'cpp', 'sql'], description: 'Language hint' },
           maxDepth: { type: 'number', description: 'Max depth' },
           filePath: { type: 'string', description: 'File path to check focus (if in focus, returns full code)' },
           sessionId: { type: 'string', description: 'Session id for focus lookup' }
@@ -178,7 +188,8 @@ export function apply(ctx, config) {
       execute: async (params, meta) => {
         const cfg = getConfig();
         if (typeof cfg.budgetLimit === 'number') tracker.setBudgetLimit(cfg.budgetLimit);
-        const stats = tracker.getStats(cfg.budgetLimit);
+        if (typeof cfg.budgetAlertPercent === 'number') tracker.setBudgetAlertPercent(cfg.budgetAlertPercent);
+        const stats = tracker.getStats(cfg.budgetLimit, cfg.budgetAlertPercent);
         const history = tracker.getHistory();
         const key = sessionKey(params || {}, meta);
         return {
@@ -189,7 +200,8 @@ export function apply(ctx, config) {
           autoCollapse: cfg.autoCollapse !== false,
           focus: getFocus(key),
           sessionId: key,
-          autoCompressThreshold: cfg.autoCompressThreshold
+          autoCompressThreshold: cfg.autoCompressThreshold,
+          budgetAlertPercent: cfg.budgetAlertPercent ?? 90
         };
       }
     });
@@ -202,6 +214,7 @@ export function apply(ctx, config) {
       handler: (req, res) => {
         const cfg = getConfig();
         if (typeof cfg.budgetLimit === 'number') tracker.setBudgetLimit(cfg.budgetLimit);
+        if (typeof cfg.budgetAlertPercent === 'number') tracker.setBudgetAlertPercent(cfg.budgetAlertPercent);
         let sId = '__default__';
         try {
           const u = new URL(req.url, 'http://127.0.0.1');
@@ -211,7 +224,7 @@ export function apply(ctx, config) {
         res.end(JSON.stringify({
           ok: true,
           plugin: 'dsh-context-lens',
-          stats: tracker.getStats(cfg.budgetLimit),
+          stats: tracker.getStats(cfg.budgetLimit, cfg.budgetAlertPercent),
           history: tracker.getHistory(),
           focus: getFocus(sId),
           sessionId: sId
@@ -219,6 +232,23 @@ export function apply(ctx, config) {
       }
     }), 'dsh-context-lens status route');
 
+    // Quick clear-focus API route
+    ctx.effect(() => ctx.webServer.register({
+      kind: 'exact',
+      path: '/dsh-context-lens/clear-focus',
+      handler: async (req, res) => {
+        let sId = lastActiveSession || '__default__';
+        try {
+          const u = new URL(req.url, 'http://127.0.0.1');
+          const qId = u.searchParams.get('sessionId') || u.searchParams.get('session_id');
+          if (qId) sId = qId;
+        } catch {}
+        clearFocus(sId);
+        res.setHeader('content-type', 'application/json');
+        res.end(JSON.stringify({ ok: true, sessionId: sId, focus: getFocus(sId) }));
+      }
+    }), 'dsh-context-lens clear-focus route');
+
     // #45: server-backed preview (same compressor as tools)
     ctx.effect(() => ctx.webServer.register({
       kind: 'exact',
@@ -242,6 +272,4 @@ export function apply(ctx, config) {
       }
     }), 'dsh-context-lens compress-preview route');
   }
-}
-
-export { compressLog, skeletonize, shouldAutoCompress };
+}

package/lib/tokens/tracker.js

@@ -7,6 +7,7 @@ let calls = 0;
 const history = []; // last 10
 const MAX_HISTORY = 10;
 let defaultBudgetLimit = 100000; // tokens
+let defaultBudgetAlertPercent = 90; // threshold percent for low budget warning
 
 export { estimateTokens };
 
@@ -16,6 +17,12 @@ export function setBudgetLimit(limit) {
   }
 }
 
+export function setBudgetAlertPercent(percent) {
+  if (typeof percent === 'number' && percent >= 50 && percent <= 99) {
+    defaultBudgetAlertPercent = percent;
+  }
+}
+
 export function record(originalText, compressedText) {
   const o = estimateTokens(originalText);
   const c = estimateTokens(compressedText);
@@ -41,16 +48,19 @@ export function record(originalText, compressedText) {
   return { originalTokens: o, compressedTokens: c, savedTokens: saved };
 }
 
-export function getStats(budgetLimitOverride) {
+export function getStats(budgetLimitOverride, budgetAlertPercentOverride) {
   const limit = (typeof budgetLimitOverride === 'number' && budgetLimitOverride > 0)
     ? budgetLimitOverride
     : defaultBudgetLimit;
+  const alertPercent = (typeof budgetAlertPercentOverride === 'number' && budgetAlertPercentOverride >= 50 && budgetAlertPercentOverride <= 99)
+    ? budgetAlertPercentOverride
+    : defaultBudgetAlertPercent;
   const saved = Math.max(0, totalOriginal - totalCompressed);
   const pct = totalOriginal ? Math.round((1 - totalCompressed / totalOriginal) * 100) : 0;
   const budgetUsed = totalCompressed;
   const budgetRemaining = Math.max(0, limit - budgetUsed);
   const budgetPercent = Math.min(100, Math.round((budgetUsed / limit) * 100));
-  const lowBudget = budgetPercent > 90;
+  const lowBudget = budgetPercent >= alertPercent;
   return {
     totalOriginal,
     totalCompressed,
@@ -62,6 +72,7 @@ export function getStats(budgetLimitOverride) {
     budgetPercent,
     lowBudget,
     budgetLimit: limit,
+    budgetAlertPercent: alertPercent,
     countingStopped: budgetUsed >= limit
   };
 }
@@ -79,7 +90,4 @@ export function reset() {
   totalCompressed = 0;
   calls = 0;
   history.length = 0;
-  defaultBudgetLimit = 100000;
-}
-
-export default { estimateTokens, setBudgetLimit, record, getStats, getHistory, clearHistory, reset };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-context-lens",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "description": "DSH plugin for AST context compression, test log filtering, and token budget guard",
   "type": "module",
   "main": "lib/index.js",
@@ -14,6 +14,8 @@
     "lib/",
     "cordis.patch.yml",
     "README.md",
+    "README.zh.md",
+    "README.ru.md",
     "LICENSE"
   ],
   "scripts": {