@weavetab/skills 2.5.1 → 2.5.2

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 fy2ne
+Copyright (c) 2026 fy2ne <hello@fy2ne.me>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -4,7 +4,7 @@
 [![GitHub stars](https://img.shields.io/github/stars/Weavetab/skills.svg?style=social)](https://github.com/Weavetab/skills)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
-Enterprise domain-driven agent intelligence for `@weavetab/mcp` (v2.5.1). Drop-in operational guides, failure recovery heuristics, and protocol rules for **Antigravity**, **Cursor**, **Cline**, **Windsurf**, and **OpenClaw**.
+Enterprise domain-driven agent intelligence for `@weavetab/mcp` (v2.5.2). Drop-in operational guides, failure recovery heuristics, and protocol rules for **Antigravity**, **Cursor**, **Cline**, **Windsurf**, and **OpenClaw**.
 
 - **Website:** [weavetab.dev](https://weavetab.dev)
 - **Core MCP Server:** [`@weavetab/mcp`](https://www.npmjs.com/package/@weavetab/mcp)

package/browser/dom-strategy.md

@@ -55,7 +55,7 @@ Always select the narrowest tool that satisfies your immediate objective:
 
 ### Tier 1: Targeted Keyword Jump (`browser_find`)
 Use `browser_find` when you already know the label, text snippet, placeholder, or aria-label of the target element.
-- **Latency**: Sub-5ms CDP search.
+- **Execution**: Leaf-optimized TreeWalker DOM query.
 - **Token Cost**: ~50–100 tokens (returns only matching candidate nodes).
 
 ```json

package/browser/form-automation.md

@@ -29,11 +29,11 @@ Submitting complex web forms one field at a time wastes agent turns and increase
   "fields": [
     {
       "ref": "w:12",
-      "value": "Anas"
+      "value": "Alex"
     },
     {
       "ref": "w:14",
-      "value": "Khezaz"
+      "value": "Rivera"
     },
     {
       "ref": "w:16",

package/browser/interaction-pipeline.md

@@ -144,8 +144,8 @@ Native operating system file picker dialogs block autonomous agent execution bec
 {
   "nodeId": 4821,
   "filePaths": [
-    "C:/Users/me/Documents/contract.pdf",
-    "C:/Users/me/Documents/financial_report.xlsx"
+    "./documents/contract.pdf",
+    "./documents/financial_report.xlsx"
   ]
 }
 ```

package/desktop/desktop-targeting.md

@@ -43,7 +43,7 @@ Pass `"app": "<application_name>"` to target the Electron application.
 {
   "app": "discord",
   "ref": "w:88",
-  "text": "Deployment v2.5.1 completed successfully."
+  "text": "Deployment v2.5.2 completed successfully."
 }
 ```
 

package/desktop/electron-discovery.md

@@ -44,13 +44,13 @@ Call `browser_detect` with empty parameters `{}`:
     {
       "name": "discord",
       "status": "running_no_debug",
-      "configuredPath": "C:\\Users\\username\\AppData\\Local\\Discord\\app-1.0.9256\\Discord.exe"
+      "configuredPath": "%LOCALAPPDATA%\\Discord\\app-<version>\\Discord.exe"
     },
     {
       "name": "slack",
       "status": "connected",
       "port": 9222,
-      "configuredPath": "C:\\Users\\username\\AppData\\Local\\slack\\app-4.38.125\\slack.exe",
+      "configuredPath": "%LOCALAPPDATA%\\slack\\app-<version>\\slack.exe",
       "activeTabs": [
         {
           "id": "PAGE_1",
@@ -62,7 +62,7 @@ Call `browser_detect` with empty parameters `{}`:
     {
       "name": "vscode",
       "status": "offline",
-      "configuredPath": "C:\\Users\\username\\AppData\\Local\\Programs\\Microsoft VS Code\\Code.exe"
+      "configuredPath": "%LOCALAPPDATA%\\Programs\\Microsoft VS Code\\Code.exe"
     }
   ],
   "toolCoverage": {

package/dist/bundled/weavetab-all.md

@@ -1,4 +1,4 @@
-# Weavetab Complete Enterprise Agent Suite (v2.5.1)
+# Weavetab Complete Enterprise Agent Suite (v2.5.2)
 
 
 
@@ -8,7 +8,7 @@
 
 # Weavetab Domain Profile: BROWSER
 
-Generated for @weavetab/skills v2.5.1
+Generated for @weavetab/skills v2.5.2
 
 
 ## dom-strategy
@@ -51,7 +51,7 @@ Always select the narrowest tool that satisfies your immediate objective:
 
 ### Tier 1: Targeted Keyword Jump (`browser_find`)
 Use `browser_find` when you already know the label, text snippet, placeholder, or aria-label of the target element.
-- **Latency**: Sub-5ms CDP search.
+- **Execution**: Leaf-optimized TreeWalker DOM query.
 - **Token Cost**: ~50–100 tokens (returns only matching candidate nodes).
 
 ```json
@@ -134,11 +134,11 @@ Submitting complex web forms one field at a time wastes agent turns and increase
   "fields": [
     {
       "ref": "w:12",
-      "value": "Anas"
+      "value": "Alex"
     },
     {
       "ref": "w:14",
-      "value": "Khezaz"
+      "value": "Rivera"
     },
     {
       "ref": "w:16",
@@ -313,8 +313,8 @@ Native operating system file picker dialogs block autonomous agent execution bec
 {
   "nodeId": 4821,
   "filePaths": [
-    "C:/Users/me/Documents/contract.pdf",
-    "C:/Users/me/Documents/financial_report.xlsx"
+    "./documents/contract.pdf",
+    "./documents/financial_report.xlsx"
   ]
 }
 ```
@@ -540,7 +540,7 @@ The auto-heal routine re-establishes CDP protocol sessions, reconnects event lis
 
 # Weavetab Domain Profile: DESKTOP
 
-Generated for @weavetab/skills v2.5.1
+Generated for @weavetab/skills v2.5.2
 
 
 ## desktop-targeting
@@ -570,7 +570,7 @@ Pass `"app": "<application_name>"` to target the Electron application.
 {
   "app": "discord",
   "ref": "w:88",
-  "text": "Deployment v2.5.1 completed successfully."
+  "text": "Deployment v2.5.2 completed successfully."
 }
 ```
 
@@ -645,13 +645,13 @@ Call `browser_detect` with empty parameters `{}`:
     {
       "name": "discord",
       "status": "running_no_debug",
-      "configuredPath": "C:\\Users\\username\\AppData\\Local\\Discord\\app-1.0.9256\\Discord.exe"
+      "configuredPath": "%LOCALAPPDATA%\\Discord\\app-<version>\\Discord.exe"
     },
     {
       "name": "slack",
       "status": "connected",
       "port": 9222,
-      "configuredPath": "C:\\Users\\username\\AppData\\Local\\slack\\app-4.38.125\\slack.exe",
+      "configuredPath": "%LOCALAPPDATA%\\slack\\app-<version>\\slack.exe",
       "activeTabs": [
         {
           "id": "PAGE_1",
@@ -663,7 +663,7 @@ Call `browser_detect` with empty parameters `{}`:
     {
       "name": "vscode",
       "status": "offline",
-      "configuredPath": "C:\\Users\\username\\AppData\\Local\\Programs\\Microsoft VS Code\\Code.exe"
+      "configuredPath": "%LOCALAPPDATA%\\Programs\\Microsoft VS Code\\Code.exe"
     }
   ],
   "toolCoverage": {
@@ -722,7 +722,7 @@ Once launched with `--remote-debugging-port`, `browser_detect` immediately refle
 
 # Weavetab Domain Profile: MEMORY
 
-Generated for @weavetab/skills v2.5.1
+Generated for @weavetab/skills v2.5.2
 
 
 ## selector-memory-system
@@ -1113,7 +1113,7 @@ Total agent turns for a known site: **3 tool calls** vs. potentially 12+ with fu
 
 # Weavetab Domain Profile: RESILIENCE
 
-Generated for @weavetab/skills v2.5.1
+Generated for @weavetab/skills v2.5.2
 
 
 ## loop-breaker
@@ -1215,7 +1215,7 @@ If a downstream step errors out, times out, or hits an invalid state, roll back
   "name": "pre_checkout_authenticated"
 }
 ```
-*Latency: ~15ms*. The page navigates back to the checkpoint URL with cookies and storage atomically injected.
+The page navigates back to the checkpoint URL with cookies and storage atomically injected.
 
 ### C. Listing Checkpoints (`list`)
 Inspect all active checkpoints for the current page target:
@@ -1318,7 +1318,7 @@ In modern Single Page Applications (built with React, Next.js, Vue, Nuxt, Svelte
 
 ## 1. The Multi-Tier Auto-Recovery Heuristic
 
-When a tool receives a detached or invalidated `ref`, Weavetab attempts to re-resolve it instead of failing immediately. The recovery runs a sub-5ms heuristic over these strategies (in order) and re-stamps `data-wt-id="NN"` onto the live node:
+When a tool receives a detached or invalidated `ref`, Weavetab attempts to re-resolve it instead of failing immediately. The recovery runs an in-memory heuristic over these strategies (in order) and re-stamps `data-wt-id="NN"` onto the live node:
 
 ```
   [Action on w:14 fails / handle detached]
@@ -1363,7 +1363,7 @@ Either way:
 
 # Weavetab Domain Profile: SECURITY
 
-Generated for @weavetab/skills v2.5.1
+Generated for @weavetab/skills v2.5.2
 
 
 ## rbac-and-policies
@@ -1462,7 +1462,7 @@ When `browser_type_secret` is invoked:
 
 # Weavetab Domain Profile: PLUGINS
 
-Generated for @weavetab/skills v2.5.1
+Generated for @weavetab/skills v2.5.2
 
 
 ## hooks-and-overrides
@@ -1556,7 +1556,7 @@ Unverified plugins are loaded but their permissions are logged visibly at startu
 
 # Weavetab Domain Profile: NETWORK-AND-PERF
 
-Generated for @weavetab/skills v2.5.1
+Generated for @weavetab/skills v2.5.2
 
 
 ## device-and-environment
@@ -1812,7 +1812,7 @@ Always synchronize with deterministic browser conditions:
 
 # Weavetab Domain Profile: DOCUMENTS
 
-Generated for @weavetab/skills v2.5.1
+Generated for @weavetab/skills v2.5.2
 
 
 ## canvas-and-visual-capture
@@ -2002,7 +2002,7 @@ Word and PDF extraction return text in `content` (truncated by `max_chars`). PDF
 
 # Weavetab Domain Profile: DEVELOPER
 
-Generated for @weavetab/skills v2.5.1
+Generated for @weavetab/skills v2.5.2
 
 
 ## github-forensics

package/dist/bundled/weavetab-browser.md

@@ -1,6 +1,6 @@
 # Weavetab Domain Profile: BROWSER
 
-Generated for @weavetab/skills v2.5.1
+Generated for @weavetab/skills v2.5.2
 
 
 ## dom-strategy
@@ -43,7 +43,7 @@ Always select the narrowest tool that satisfies your immediate objective:
 
 ### Tier 1: Targeted Keyword Jump (`browser_find`)
 Use `browser_find` when you already know the label, text snippet, placeholder, or aria-label of the target element.
-- **Latency**: Sub-5ms CDP search.
+- **Execution**: Leaf-optimized TreeWalker DOM query.
 - **Token Cost**: ~50–100 tokens (returns only matching candidate nodes).
 
 ```json
@@ -126,11 +126,11 @@ Submitting complex web forms one field at a time wastes agent turns and increase
   "fields": [
     {
       "ref": "w:12",
-      "value": "Anas"
+      "value": "Alex"
     },
     {
       "ref": "w:14",
-      "value": "Khezaz"
+      "value": "Rivera"
     },
     {
       "ref": "w:16",
@@ -305,8 +305,8 @@ Native operating system file picker dialogs block autonomous agent execution bec
 {
   "nodeId": 4821,
   "filePaths": [
-    "C:/Users/me/Documents/contract.pdf",
-    "C:/Users/me/Documents/financial_report.xlsx"
+    "./documents/contract.pdf",
+    "./documents/financial_report.xlsx"
   ]
 }
 ```

package/dist/bundled/weavetab-desktop.md

@@ -1,6 +1,6 @@
 # Weavetab Domain Profile: DESKTOP
 
-Generated for @weavetab/skills v2.5.1
+Generated for @weavetab/skills v2.5.2
 
 
 ## desktop-targeting
@@ -30,7 +30,7 @@ Pass `"app": "<application_name>"` to target the Electron application.
 {
   "app": "discord",
   "ref": "w:88",
-  "text": "Deployment v2.5.1 completed successfully."
+  "text": "Deployment v2.5.2 completed successfully."
 }
 ```
 
@@ -105,13 +105,13 @@ Call `browser_detect` with empty parameters `{}`:
     {
       "name": "discord",
       "status": "running_no_debug",
-      "configuredPath": "C:\\Users\\username\\AppData\\Local\\Discord\\app-1.0.9256\\Discord.exe"
+      "configuredPath": "%LOCALAPPDATA%\\Discord\\app-<version>\\Discord.exe"
     },
     {
       "name": "slack",
       "status": "connected",
       "port": 9222,
-      "configuredPath": "C:\\Users\\username\\AppData\\Local\\slack\\app-4.38.125\\slack.exe",
+      "configuredPath": "%LOCALAPPDATA%\\slack\\app-<version>\\slack.exe",
       "activeTabs": [
         {
           "id": "PAGE_1",
@@ -123,7 +123,7 @@ Call `browser_detect` with empty parameters `{}`:
     {
       "name": "vscode",
       "status": "offline",
-      "configuredPath": "C:\\Users\\username\\AppData\\Local\\Programs\\Microsoft VS Code\\Code.exe"
+      "configuredPath": "%LOCALAPPDATA%\\Programs\\Microsoft VS Code\\Code.exe"
     }
   ],
   "toolCoverage": {

package/dist/bundled/weavetab-developer.md

@@ -1,6 +1,6 @@
 # Weavetab Domain Profile: DEVELOPER
 
-Generated for @weavetab/skills v2.5.1
+Generated for @weavetab/skills v2.5.2
 
 
 ## github-forensics

package/dist/bundled/weavetab-documents.md

@@ -1,6 +1,6 @@
 # Weavetab Domain Profile: DOCUMENTS
 
-Generated for @weavetab/skills v2.5.1
+Generated for @weavetab/skills v2.5.2
 
 
 ## canvas-and-visual-capture

package/dist/bundled/weavetab-memory.md

@@ -1,6 +1,6 @@
 # Weavetab Domain Profile: MEMORY
 
-Generated for @weavetab/skills v2.5.1
+Generated for @weavetab/skills v2.5.2
 
 
 ## selector-memory-system

package/dist/bundled/weavetab-network-and-perf.md

@@ -1,6 +1,6 @@
 # Weavetab Domain Profile: NETWORK-AND-PERF
 
-Generated for @weavetab/skills v2.5.1
+Generated for @weavetab/skills v2.5.2
 
 
 ## device-and-environment

package/dist/bundled/weavetab-plugins.md

@@ -1,6 +1,6 @@
 # Weavetab Domain Profile: PLUGINS
 
-Generated for @weavetab/skills v2.5.1
+Generated for @weavetab/skills v2.5.2
 
 
 ## hooks-and-overrides

package/dist/bundled/weavetab-resilience.md

@@ -1,6 +1,6 @@
 # Weavetab Domain Profile: RESILIENCE
 
-Generated for @weavetab/skills v2.5.1
+Generated for @weavetab/skills v2.5.2
 
 
 ## loop-breaker
@@ -102,7 +102,7 @@ If a downstream step errors out, times out, or hits an invalid state, roll back
   "name": "pre_checkout_authenticated"
 }
 ```
-*Latency: ~15ms*. The page navigates back to the checkpoint URL with cookies and storage atomically injected.
+The page navigates back to the checkpoint URL with cookies and storage atomically injected.
 
 ### C. Listing Checkpoints (`list`)
 Inspect all active checkpoints for the current page target:
@@ -205,7 +205,7 @@ In modern Single Page Applications (built with React, Next.js, Vue, Nuxt, Svelte
 
 ## 1. The Multi-Tier Auto-Recovery Heuristic
 
-When a tool receives a detached or invalidated `ref`, Weavetab attempts to re-resolve it instead of failing immediately. The recovery runs a sub-5ms heuristic over these strategies (in order) and re-stamps `data-wt-id="NN"` onto the live node:
+When a tool receives a detached or invalidated `ref`, Weavetab attempts to re-resolve it instead of failing immediately. The recovery runs an in-memory heuristic over these strategies (in order) and re-stamps `data-wt-id="NN"` onto the live node:
 
 ```
   [Action on w:14 fails / handle detached]

package/dist/bundled/weavetab-security.md

@@ -1,6 +1,6 @@
 # Weavetab Domain Profile: SECURITY
 
-Generated for @weavetab/skills v2.5.1
+Generated for @weavetab/skills v2.5.2
 
 
 ## rbac-and-policies

package/dist/granular/browser_dom-strategy.md

@@ -55,7 +55,7 @@ Always select the narrowest tool that satisfies your immediate objective:
 
 ### Tier 1: Targeted Keyword Jump (`browser_find`)
 Use `browser_find` when you already know the label, text snippet, placeholder, or aria-label of the target element.
-- **Latency**: Sub-5ms CDP search.
+- **Execution**: Leaf-optimized TreeWalker DOM query.
 - **Token Cost**: ~50–100 tokens (returns only matching candidate nodes).
 
 ```json

package/dist/granular/browser_form-automation.md

@@ -29,11 +29,11 @@ Submitting complex web forms one field at a time wastes agent turns and increase
   "fields": [
     {
       "ref": "w:12",
-      "value": "Anas"
+      "value": "Alex"
     },
     {
       "ref": "w:14",
-      "value": "Khezaz"
+      "value": "Rivera"
     },
     {
       "ref": "w:16",

package/dist/granular/browser_interaction-pipeline.md

@@ -144,8 +144,8 @@ Native operating system file picker dialogs block autonomous agent execution bec
 {
   "nodeId": 4821,
   "filePaths": [
-    "C:/Users/me/Documents/contract.pdf",
-    "C:/Users/me/Documents/financial_report.xlsx"
+    "./documents/contract.pdf",
+    "./documents/financial_report.xlsx"
   ]
 }
 ```

package/dist/granular/desktop_desktop-targeting.md

@@ -43,7 +43,7 @@ Pass `"app": "<application_name>"` to target the Electron application.
 {
   "app": "discord",
   "ref": "w:88",
-  "text": "Deployment v2.5.1 completed successfully."
+  "text": "Deployment v2.5.2 completed successfully."
 }
 ```
 

package/dist/granular/desktop_electron-discovery.md

@@ -44,13 +44,13 @@ Call `browser_detect` with empty parameters `{}`:
     {
       "name": "discord",
       "status": "running_no_debug",
-      "configuredPath": "C:\\Users\\username\\AppData\\Local\\Discord\\app-1.0.9256\\Discord.exe"
+      "configuredPath": "%LOCALAPPDATA%\\Discord\\app-<version>\\Discord.exe"
     },
     {
       "name": "slack",
       "status": "connected",
       "port": 9222,
-      "configuredPath": "C:\\Users\\username\\AppData\\Local\\slack\\app-4.38.125\\slack.exe",
+      "configuredPath": "%LOCALAPPDATA%\\slack\\app-<version>\\slack.exe",
       "activeTabs": [
         {
           "id": "PAGE_1",
@@ -62,7 +62,7 @@ Call `browser_detect` with empty parameters `{}`:
     {
       "name": "vscode",
       "status": "offline",
-      "configuredPath": "C:\\Users\\username\\AppData\\Local\\Programs\\Microsoft VS Code\\Code.exe"
+      "configuredPath": "%LOCALAPPDATA%\\Programs\\Microsoft VS Code\\Code.exe"
     }
   ],
   "toolCoverage": {

package/dist/granular/resilience_session-time-travel.md

@@ -52,7 +52,7 @@ If a downstream step errors out, times out, or hits an invalid state, roll back
   "name": "pre_checkout_authenticated"
 }
 ```
-*Latency: ~15ms*. The page navigates back to the checkpoint URL with cookies and storage atomically injected.
+The page navigates back to the checkpoint URL with cookies and storage atomically injected.
 
 ### C. Listing Checkpoints (`list`)
 Inspect all active checkpoints for the current page target:

package/dist/granular/resilience_stale-ref-recovery.md

@@ -22,7 +22,7 @@ In modern Single Page Applications (built with React, Next.js, Vue, Nuxt, Svelte
 
 ## 1. The Multi-Tier Auto-Recovery Heuristic
 
-When a tool receives a detached or invalidated `ref`, Weavetab attempts to re-resolve it instead of failing immediately. The recovery runs a sub-5ms heuristic over these strategies (in order) and re-stamps `data-wt-id="NN"` onto the live node:
+When a tool receives a detached or invalidated `ref`, Weavetab attempts to re-resolve it instead of failing immediately. The recovery runs an in-memory heuristic over these strategies (in order) and re-stamps `data-wt-id="NN"` onto the live node:
 
 ```
   [Action on w:14 fails / handle detached]

package/evals/scenarios.json

@@ -1,5 +1,5 @@
 {
-  "version": "2.5.1",
+  "version": "2.5.2",
   "scenarios": [
     {
       "id": "spa_stale_ref_recovery",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@weavetab/skills",
-  "version": "2.5.1",
-  "description": "Supercharge your AI Agents with Weavetab MCP Skills. Domain-driven agent intelligence for Antigravity, Cursor, Cline, Windsurf, and more.",
+  "version": "2.5.2",
+  "description": "Domain-driven operational skills and execution playbooks for Weavetab MCP.",
   "author": {
     "name": "fy2ne",
     "email": "hello@fy2ne.me",
@@ -51,7 +51,7 @@
     "agentic"
   ],
   "peerDependencies": {
-    "@weavetab/mcp": "2.5.1"
+    "@weavetab/mcp": "2.5.2"
   },
   "peerDependenciesMeta": {
     "@weavetab/mcp": {

package/resilience/session-time-travel.md

@@ -52,7 +52,7 @@ If a downstream step errors out, times out, or hits an invalid state, roll back
   "name": "pre_checkout_authenticated"
 }
 ```
-*Latency: ~15ms*. The page navigates back to the checkpoint URL with cookies and storage atomically injected.
+The page navigates back to the checkpoint URL with cookies and storage atomically injected.
 
 ### C. Listing Checkpoints (`list`)
 Inspect all active checkpoints for the current page target:

package/resilience/stale-ref-recovery.md

@@ -22,7 +22,7 @@ In modern Single Page Applications (built with React, Next.js, Vue, Nuxt, Svelte
 
 ## 1. The Multi-Tier Auto-Recovery Heuristic
 
-When a tool receives a detached or invalidated `ref`, Weavetab attempts to re-resolve it instead of failing immediately. The recovery runs a sub-5ms heuristic over these strategies (in order) and re-stamps `data-wt-id="NN"` onto the live node:
+When a tool receives a detached or invalidated `ref`, Weavetab attempts to re-resolve it instead of failing immediately. The recovery runs an in-memory heuristic over these strategies (in order) and re-stamps `data-wt-id="NN"` onto the live node:
 
 ```
   [Action on w:14 fails / handle detached]

package/skills.json

@@ -1,5 +1,5 @@
 {
-  "version": "2.5.1",
+  "version": "2.5.2",
   "domains": [
     "browser",
     "desktop",