@evan_zhong/browser-attach 0.22.0 → 0.22.1

package/docs/ARCHITECTURE.md

@@ -1,6 +1,6 @@
 # 架构与设计边界
 
-当前实现为 **0.22.0**。本文说明 BrowserAttach 的组件、控制模型与设计取舍；工具参数见 [使用指南](USAGE.md)。
+当前实现为 **0.22.1**。本文说明 BrowserAttach 的组件、控制模型与设计取舍；工具参数见 [使用指南](USAGE.md)。
 
 ## 组件与数据流
 

package/docs/TEST-REPORT.md

@@ -1,9 +1,18 @@
 # 验证报告
 
-当前版本 **0.22.0**（2026-10-24）。浏览器验证使用本地 fixture 和临时 profile；测试链路在各项下说明。
+当前版本 **0.22.1**（2026-10-25）。浏览器验证使用本地 fixture 和临时 profile；测试链路在各项下说明。
 
 ## 当前版本
 
+- `npm test`：246 项通过。新增隔离世界选择器诊断经 CDP 异常对象读取、单步/read_text/wait/batch 传递及 frame 路径底层原因保留；诊断读取失败保留原异常并清理 wrapper。补充准备/派发超时分类、派发后不沿用准备诊断、fill 值不匹配保留未知结果且不回显字段值。后续新增的 click 目标变化原因断言另通过 15 项指针回归。
+- Chromium 156、Edge 155 headless 完整 stdio MCP `live-smoke`：各 267 次工具调用、29 项检查通过。新增真实 CSS/XPath 语法错误、CSS/AX role 歧义、缺失 selector、read_text/wait/batch 错误原因经过扩展 → Hub → MCP 的检查；原生 fill 同步格式化返回 value_not_retained、input_dispatched=true 及 post_action，真实 input 事件仅 1 次。保留上传、对话框、OOPIF、日志、后台输入与大 AX 树回归。
+- Edge 首次与 Chromium 并行执行时，原有遮挡检查在 500 ms 准备预算内超时，未派发输入；未修改该检查预算，独立复跑完整脚本通过。
+- `npm run test:package`：包外安装与 stdio MCP 通过，23 个工具、60 个发布文件，无配对密钥。未增加工具、参数、依赖或扩展权限，版本按诊断修复递增至 0.22.1。
+- 本机部署：协调升级因现有 MCP 连接拒绝后，使用项目 stop/start 重启；Hub 为 0.22.1 / ready，已配对 Chrome、Edge 均为 0.22.1。稳定扩展目录 `F:\.nosis\browser-attach\extension` 的 42 个文件已核对：manifest 版本一致，其余非生成文件 SHA-256 一致。
+- 当前边界：原因码不推断业务成功或服务端拒绝，也不授权重放；文档/上下文销毁导致异常诊断无法读取时保留原错误，diagnostics 可能缺失。已有 MCP 客户端需重连，重新发现和接管标签。
+
+## 0.22.0 验证
+
 - `npm test`：243 项通过。新增非活动标签的单次左键单击（ref / selector / viewport / document 坐标）仍取得可信回执且不激活标签；hover、拖拽、其他按键、双击与带修饰键的点击仍在派发前以 `TAB_NOT_READY` 拒绝；派发前的就绪检查允许左键单击期间的标签切换，仍拒绝视图冻结或目标丢弃，`page_state` 带 `tab_active`。
 - Chromium 156、Edge 155 headless：`interaction-smoke --regressions` 各 35 个场景通过。后台 ref / selector / viewport / document / offset 各 3 次（每浏览器 15 次，合计 30 次）均 `delivery_verified` 且标签激活与窗口焦点状态不变；连续两次后台 batch、后台回执丢失（1 次效果、不重放）、后台遮挡（未派发）、受限动作组、settle 期间切换标签等场景通过。
 - Chromium 156 `interaction-smoke` 默认场景 17 项通过，覆盖前台、后台 ref 与坐标、遮挡窗口、缩放、hover 偏移、闭合 Shadow DOM 与导航。

package/docs/USAGE.md

@@ -1,6 +1,6 @@
 # BrowserAttach 使用指南
 
-适用于 **0.22.0**：Node.js 22+、Chrome / Edge 125+、23 个 MCP 工具。安装、配对与升级见 [README](../README.md)，宿主配置见 [Agent 集成](AGENT-INTEGRATION.md)，内部机制见 [架构说明](ARCHITECTURE.md)。
+适用于 **0.22.1**：Node.js 22+、Chrome / Edge 125+、23 个 MCP 工具。安装、配对与升级见 [README](../README.md)，宿主配置见 [Agent 集成](AGENT-INTEGRATION.md)，内部机制见 [架构说明](ARCHITECTURE.md)。
 
 本文供按需查阅，不会自动通过 MCP 发送给 agent。MCP 初始化 `instructions` 提供通用规则，工具 description 与参数 schema 提供调用说明；宿主应把 instructions 纳入模型上下文。
 
@@ -71,6 +71,20 @@
 
 这些核验不代替业务检查。下拉过滤文字不等于选项已提交，字段值不等于框架状态已保存；按任务观察选中项、成功提示或业务接口。
 
+定位与输入失败可按 `diagnostics.reason` 区分，无须解析英文错误文案：
+
+| reason | 含义 |
+|---|---|
+| `selector_not_found` | 准备预算内未找到 selector/nth 目标，或直接读取时目标不存在 |
+| `selector_ambiguous` | CSS/XPath/label/placeholder/AX role 匹配不唯一；附有界候选与匹配总数 |
+| `selector_invalid` / `selector_not_element` | 选择器解析失败 / 结果不是元素 |
+| `value_not_retained` | fill 后实际文本与请求不一致；不回显请求值或实际值，不推断是格式化还是输入被吞 |
+| `delivery_unverified` | 可信输入事件回执未在回执预算内完成 |
+| `target_changed` | click/hover 派发期间的目标核验被拒绝，可能已有前序输入送达 |
+| `preparation_timeout` / `input_timeout` | 无更具体准备原因的超时 / 已进入派发阶段后操作超时 |
+
+已有 `stale_ref`、`frame_locator`、可操作性及遮挡原因保持各自语义。frame 路径查询失败仍以 `frame_locator` 为 reason，可在 cause 和 selector_diagnostics 中保留底层选择器原因。定位辅助脚本抛出的诊断通过 CDP 单独读取；文档已销毁或无法读取时保留原错误，诊断可能缺失。派发后超时不会沿用准备阶段的定位/可操作性原因。上述原因不是重放许可；结合 `input_dispatched` 与 `post_action` 判断下一步，不推断服务端业务拒绝。
+
 ### 结果未知时
 
 超时、回执丢失或派发中断可能发生在动作生效之后。先用快照、截图或日志观察，再决定下一步；不要自动重放或换模式补发。导航和异步 JavaScript 也可能在超时后继续。

package/extension/actionability.js

@@ -6,7 +6,7 @@ export function deadline(timeout_ms = 5000, phase = 'input', parentEnd = Infinit
   let dispatched = false, waiting, diagnostics;
   function error() {
     const result = timeoutError();
-    if (diagnostics) result.diagnostics = diagnostics;
+    if (diagnostics && !dispatched) result.diagnostics = diagnostics;
     return result;
   }
   function timeoutError() {
@@ -19,6 +19,7 @@ export function deadline(timeout_ms = 5000, phase = 'input', parentEnd = Infinit
       : `Target did not become actionable within ${timeout_ms} ms${waiting ? `; waiting for ${waiting}` : ''}; no input was dispatched.`);
     result.input_dispatched = dispatched;
     result.outcome_unknown = dispatched;
+    result.diagnostics = { reason: dispatched ? 'input_timeout' : 'preparation_timeout' };
     return result;
   }
   async function run(operation) {
@@ -91,6 +92,8 @@ export function inspectTarget(editable) {
 export async function delivery(operation, ms = 1250) {
   let timer;
   try { return await Promise.race([operation, new Promise((resolve, reject) => {
-    timer = setTimeout(() => reject(Object.assign(new Error('Native input has no verified receipt. Outcome is unknown. Browser UI may be capturing input; press Esc to dismiss a native menu, then observe. Never automatically replay or fall back.'), { outcome_unknown: true })), ms);
+    timer = setTimeout(() => reject(Object.assign(new Error('Native input has no verified receipt. Outcome is unknown. Browser UI may be capturing input; press Esc to dismiss a native menu, then observe. Never automatically replay or fall back.'), {
+      outcome_unknown: true, diagnostics: { reason: 'delivery_unverified' },
+    })), ms);
   })]); } finally { clearTimeout(timer); }
 }

package/extension/click.js

@@ -14,7 +14,9 @@ export function createClick(cdp, value, { prepare, assertReady }) {
     try {
       const receipt = JSON.parse(params.payload);
       if (receipt.matched === true) operation.resolve();
-      else operation.reject(Object.assign(new Error('Click target changed or became covered during mouse dispatch. Further incorrect target input was blocked; outcome is unknown. Observe again before retrying.'), { outcome_unknown: true }));
+      else operation.reject(Object.assign(new Error('Click target changed or became covered during mouse dispatch. Further incorrect target input was blocked; outcome is unknown. Observe again before retrying.'), {
+        outcome_unknown: true, diagnostics: { reason: 'target_changed' },
+      }));
     } catch (error) { operation.reject(error); }
   }
   function cancel(tabId) { pending.get(tabId)?.reject(Object.assign(new Error('Tab detached during click; outcome is unknown. Observe before retrying.'), { outcome_unknown: true })); }

package/extension/errors.js

@@ -11,3 +11,21 @@ export function errorFromData(data) {
   for (const key of fields) if (data[key] !== undefined) error[key] = data[key];
   return error;
 }
+
+// CDP exception descriptions omit custom properties on errors thrown by our
+// isolated-world helpers. Read their diagnostics only on the failure path.
+export async function checkedValue(result, send, value) {
+  if (!result.exceptionDetails) return value(result);
+  let diagnostics;
+  const objectId = result.exceptionDetails.exception?.objectId;
+  if (objectId) {
+    try {
+      const details = await send('Runtime.callFunctionOn', { objectId, returnByValue: true,
+        functionDeclaration: 'function() { return Object.getOwnPropertyDescriptor(this, "diagnostics")?.value; }' });
+      if (!details.exceptionDetails) diagnostics = details.result?.value;
+    } catch {}
+    finally { await send('Runtime.releaseObject', { objectId }).catch(() => {}); }
+  }
+  try { return value(result); }
+  catch (error) { if (typeof diagnostics?.reason === 'string') error.diagnostics = diagnostics; throw error; }
+}

package/extension/input.js

@@ -127,7 +127,9 @@ export function createInput(cdp, value, sessions) {
     if (mode === 'native') await send('Input.insertText', { text: args.text });
     const matches = value(await send('Runtime.callFunctionOn', { objectId: node.objectId, returnByValue: true,
       functionDeclaration: verifyFill.toString(), arguments: [{ value: args.text }] }));
-    if (matches !== true) throw Object.assign(new Error(`Fill did not retain the requested text. Input may have been swallowed, focus may have moved, or the page may have reformatted it. Outcome is unknown. ${BUSY}`), { outcome_unknown: true });
+    if (matches !== true) throw Object.assign(new Error(`Fill did not retain the requested text. Input may have been swallowed, focus may have moved, or the page may have reformatted it. Outcome is unknown. ${BUSY}`), {
+      outcome_unknown: true, diagnostics: { reason: 'value_not_retained', frame_id: node.frameId },
+    });
     return { filled: true, method: mode, value_verified: true, ...(mode === 'dom' ? { events_trusted: false } : {}), application_result: 'not_checked', observe_again: true };
   }
 

package/extension/locator.js

@@ -1,3 +1,5 @@
+import { checkedValue } from './errors.js';
+
 // Selectors are reusable queries, never identities inferred from old AX text.
 export function targetOptions(args, { coordinates = false, focused = false } = {}) {
   const hasRef = args.ref != null, hasSelector = args.selector != null;
@@ -19,19 +21,26 @@ export function targetOptions(args, { coordinates = false, focused = false } = {
 
 export function queryElement(selector, type = 'css', nth, waitForMatch = false) {
   if (nth != null && (!Number.isSafeInteger(nth) || nth < 0)) throw new Error('nth must be a nonnegative safe integer (zero-based)');
+  const failure = (message, reason, detail = {}) => Object.assign(new Error(message), {
+    diagnostics: { reason, selector_type: type, ...detail },
+  });
   let element, count, at;
-  if (type === 'xpath') {
-    const result = document.evaluate(selector, document, null, XPathResult.ORDERED_NODE_SNAPSHOT_TYPE, null);
-    count = result.snapshotLength; at = index => result.snapshotItem(index);
-  } else {
-    const normalize = text => text.replace(/\s+/g, ' ').trim();
-    const elements = type === 'label'
-      ? Array.from(document.querySelectorAll('input,textarea,select,button,meter,output,progress')).filter(element =>
-        Array.from(element.labels || []).some(label => normalize(label.textContent || '') === normalize(selector)))
-      : type === 'placeholder'
-        ? Array.from(document.querySelectorAll('[placeholder]')).filter(element => element.getAttribute('placeholder') === selector)
-        : document.querySelectorAll(selector);
-    count = elements.length; at = index => elements[index];
+  try {
+    if (type === 'xpath') {
+      const result = document.evaluate(selector, document, null, XPathResult.ORDERED_NODE_SNAPSHOT_TYPE, null);
+      count = result.snapshotLength; at = index => result.snapshotItem(index);
+    } else {
+      const normalize = text => text.replace(/\s+/g, ' ').trim();
+      const elements = type === 'label'
+        ? Array.from(document.querySelectorAll('input,textarea,select,button,meter,output,progress')).filter(element =>
+          Array.from(element.labels || []).some(label => normalize(label.textContent || '') === normalize(selector)))
+        : type === 'placeholder'
+          ? Array.from(document.querySelectorAll('[placeholder]')).filter(element => element.getAttribute('placeholder') === selector)
+          : document.querySelectorAll(selector);
+      count = elements.length; at = index => elements[index];
+    }
+  } catch (error) {
+    throw failure(error.message, 'selector_invalid');
   }
   if (waitForMatch && (count === 0 || (nth != null && nth >= count))) return null;
   if (nth == null && count !== 1) {
@@ -43,11 +52,12 @@ export function queryElement(selector, type = 'css', nth, waitForMatch = false)
         disabled: node.matches(':disabled') || !!node.closest('[inert], [aria-disabled="true"]'),
         visible: rect.width > 0 && rect.height > 0 && style.visibility === 'visible' };
     });
-    throw new Error(`Selector must match exactly one element; matched ${count}. Scope the selector or provide an explicit zero-based nth. Candidates: ${JSON.stringify(candidates)}${count > candidates.length ? ` (${count - candidates.length} more omitted)` : ''}`);
+    throw failure(`Selector must match exactly one element; matched ${count}. Scope the selector or provide an explicit zero-based nth. Candidates: ${JSON.stringify(candidates)}${count > candidates.length ? ` (${count - candidates.length} more omitted)` : ''}`,
+      count ? 'selector_ambiguous' : 'selector_not_found', { matched: count, candidates, omitted_candidates: Math.max(0, count - candidates.length) });
   }
-  if (nth != null && nth >= count) throw new Error(`Selector nth=${nth} is out of range; matched ${count}`);
+  if (nth != null && nth >= count) throw failure(`Selector nth=${nth} is out of range; matched ${count}`, 'selector_not_found', { matched: count, nth });
   element = at(nth ?? 0);
-  if (element.nodeType !== 1) throw new Error('Selector must resolve to an element');
+  if (element.nodeType !== 1) throw failure('Selector must resolve to an element', 'selector_not_element');
   return element;
 }
 
@@ -66,22 +76,27 @@ export async function resolveSelector(cdp, value, sessions, tabId, args, budget,
     } else {
       const result = await send('Runtime.evaluate', { contextId: context.executionContextId, objectGroup: 'browser-attach',
         expression: `(${queryElement.toString()})(${JSON.stringify(args.selector)},${JSON.stringify(args.selector_type ?? 'css')},${args.nth ?? 'undefined'},true)` });
-      value(result);
+      await checkedValue(result, send, value);
       if (result.result?.subtype !== 'null') {
-        if (!result.result?.objectId) throw new Error('Selector did not resolve to an element');
+        if (!result.result?.objectId) throw Object.assign(new Error('Selector did not resolve to an element'), {
+          diagnostics: { reason: 'selector_not_element', frame_id: frameId },
+        });
         const { node } = await send('DOM.describeNode', { objectId: result.result.objectId });
         backendNodeId = node.backendNodeId;
       }
     }
     if (backendNodeId != null) break;
     if (!wait) return null;
-    budget.describe?.(`selector ${JSON.stringify(args.selector)}${args.name == null ? '' : ` name=${JSON.stringify(args.name)}`}${args.nth == null ? '' : ` nth=${args.nth}`} to appear; current=no matching element`);
+    budget.describe?.(`selector ${JSON.stringify(args.selector)}${args.name == null ? '' : ` name=${JSON.stringify(args.name)}`}${args.nth == null ? '' : ` nth=${args.nth}`} to appear; current=no matching element`,
+      { reason: 'selector_not_found', selector_type: args.selector_type ?? 'css', frame_id: frameId, ...(args.nth == null ? {} : { nth: args.nth }) });
     await budget.run(() => new Promise(resolve => setTimeout(resolve, 20)));
   }
   // Hit-test refs resolve in the default world too. CDP forbids passing object
   // arguments between worlds, even when both wrappers refer to the same node.
   const resolved = await send('DOM.resolveNode', { backendNodeId, objectGroup: 'browser-attach' });
-  if (!resolved.object?.objectId) throw new Error('Selector target detached before resolution; no input was dispatched');
+  if (!resolved.object?.objectId) throw Object.assign(new Error('Selector target detached before resolution; no input was dispatched'), {
+    diagnostics: { reason: 'element_detached', frame_id: frameId },
+  });
   return { target, frameId, objectId: resolved.object.objectId, backendNodeId };
 }
 
@@ -98,7 +113,13 @@ export function matchRole(nodes, args) {
     for (let i = (node.childIds?.length || 0) - 1; i >= 0; i--) pending.push(byId.get(node.childIds[i]));
   }
   const candidates = [...matches.values()];
-  if (args.nth == null && candidates.length > 1) throw new Error(`Role selector must match exactly one element; matched ${candidates.length}. Provide name or an explicit zero-based nth. Candidates: ${JSON.stringify(candidates.slice(0, 10).map((node, nth) => ({ nth, role: node.role?.value, name: String(node.name?.value || '').slice(0, 120) })))}`);
+  if (args.nth == null && candidates.length > 1) {
+    const preview = candidates.slice(0, 10).map((node, nth) => ({ nth, role: node.role?.value, name: String(node.name?.value || '').slice(0, 120) }));
+    throw Object.assign(new Error(`Role selector must match exactly one element; matched ${candidates.length}. Provide name or an explicit zero-based nth. Candidates: ${JSON.stringify(preview)}`), {
+      diagnostics: { reason: 'selector_ambiguous', selector_type: 'role', matched: candidates.length,
+        candidates: preview, omitted_candidates: Math.max(0, candidates.length - preview.length) },
+    });
+  }
   return candidates[args.nth ?? 0] || null;
 }
 
@@ -116,7 +137,7 @@ async function resolveFrameOnce(cdp, value, sessions, tabId, args, budget) {
   const frames = await budget.run(() => sessions.frames(tabId));
   const failure = (error, scope = {}) => {
     const candidates = frames.slice(0, 10).map(frame => ({ frame_id: frame.id, parent_frame_id: frame.parentId ?? null, url: frame.url }));
-    error.diagnostics = { reason: 'frame_locator', ...scope, candidates, omitted_candidates: Math.max(0, frames.length - candidates.length) };
+    error.diagnostics = { reason: 'frame_locator', ...(error.diagnostics ? { cause: error.diagnostics.reason, selector_diagnostics: error.diagnostics } : {}), ...scope, candidates, omitted_candidates: Math.max(0, frames.length - candidates.length) };
     error.message += `; frame scope=${JSON.stringify(scope)}; current frames=${JSON.stringify(candidates)}${frames.length > candidates.length ? ` (${frames.length - candidates.length} more omitted)` : ''}`;
     return error;
   };
@@ -134,7 +155,7 @@ async function resolveFrameOnce(cdp, value, sessions, tabId, args, budget) {
       const send = (method, params) => budget.run(() => cdp(target, method, params));
       const { executionContextId } = await send('Page.createIsolatedWorld', { frameId, worldName: 'browser-attach-locator' });
       const result = await send('Runtime.evaluate', { contextId: executionContextId, expression: `(${queryElement.toString()})(${JSON.stringify(selector)},"css")`, objectGroup: 'browser-attach-frame' });
-      value(result);
+      await checkedValue(result, send, value);
       try {
         const { node } = await send('DOM.describeNode', { objectId: result.result.objectId });
         if (!['IFRAME', 'FRAME'].includes(node.nodeName)) throw new Error('frame.path must resolve to iframe/frame elements');

package/extension/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "BrowserAttach",
-  "version": "0.22.0",
+  "version": "0.22.1",
   "description": "Connect existing Chrome and Edge tabs to a locally paired MCP client.",
   "minimum_chrome_version": "125",
   "permissions": [

package/extension/text.js

@@ -1,4 +1,5 @@
 import { queryElement, targetOptions } from './locator.js';
+import { checkedValue } from './errors.js';
 
 export async function readText(cdp, value, tabId, args) {
   const max = args.max_chars ?? 20000, offset = args.offset ?? 0, mode = args.mode ?? 'visible';
@@ -12,8 +13,9 @@ export async function readText(cdp, value, tabId, args) {
   const options = { selector: args.selector, selector_type: args.selector_type, nth: args.nth, mode, offset, max_chars: max };
   if (args.node) return value(await cdp(tabId, 'Runtime.callFunctionOn', { objectId: args.node.objectId, returnByValue: true,
     functionDeclaration: `function(args) { return (${extractText.toString()})(args, () => this); }`, arguments: [{ value: options }] }));
-  return value(await cdp(tabId, 'Runtime.evaluate', { returnByValue: true, ...(args.context_id != null ? { contextId: args.context_id } : {}),
-    expression: `(${extractText.toString()})(${JSON.stringify(options)},${queryElement.toString()})` }));
+  const send = (method, params) => cdp(tabId, method, params);
+  return await checkedValue(await send('Runtime.evaluate', { returnByValue: true, ...(args.context_id != null ? { contextId: args.context_id } : {}),
+    expression: `(${extractText.toString()})(${JSON.stringify(options)},${queryElement.toString()})` }), send, value);
 }
 
 export function extractText(args, query) {

package/extension/wait.js

@@ -1,5 +1,6 @@
 import { deadline, inspectTarget } from './actionability.js';
 import { queryElement, targetOptions, resolveSelector, resolveFrame } from './locator.js';
+import { checkedValue } from './errors.js';
 
 export const WAIT_CONDITIONS = ['attached', 'absent', 'visible', 'actionable', 'text', 'value', 'checked', 'selected', 'expanded', 'url', 'network_idle'];
 
@@ -46,8 +47,9 @@ export async function waitFor(cdp, value, sessions, network, pointer, tabId, arg
             }
           } else {
             const { executionContextId } = await budget.run(() => cdp(target, 'Page.createIsolatedWorld', { frameId, worldName: 'browser-attach-locator' }));
-            current = value(await budget.run(() => cdp(target, 'Runtime.evaluate', { contextId: executionContextId, returnByValue: true,
-              expression: `(${inspectWait.toString()})((${queryElement.toString()}),(${inspectTarget.toString()}),${JSON.stringify(args)})` })));
+            const send = (method, params) => budget.run(() => cdp(target, method, params));
+            current = await checkedValue(await send('Runtime.evaluate', { contextId: executionContextId, returnByValue: true,
+              expression: `(${inspectWait.toString()})((${queryElement.toString()}),(${inspectTarget.toString()}),${JSON.stringify(args)})` }), send, value);
           }
           const stable = current?.ready && previous?.ready && JSON.stringify(current) === JSON.stringify(previous);
           if (current?.satisfied && (args.condition !== 'actionable' || stable)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evan_zhong/browser-attach",
-  "version": "0.22.0",
+  "version": "0.22.1",
   "description": "MCP for existing signed-in Chrome and Edge tabs through a locally paired extension",
   "type": "module",
   "license": "MIT",

package/src/config.mjs

@@ -15,7 +15,7 @@ export const DATA_DIR = configuredHome
   : process.platform === 'win32' ? join(homedir(), '.browser-attach')
     : join(process.env.XDG_DATA_HOME || join(homedir(), '.local', 'share'), 'browser-attach');
 export const DEFAULT_CONFIG = join(DATA_DIR, 'config.json');
-export const VERSION = '0.22.0';
+export const VERSION = '0.22.1';
 
 export async function loadConfig(path = DEFAULT_CONFIG) {
   let config;