@weavetab/skills 1.0.1 → 2.5.0-beta.4

package/README.md

@@ -1,50 +1,108 @@
-# 🚀 Weavetab MCP Skills
-
-Welcome to the official **Weavetab MCP Skills** repository! This package provides powerful, native drop-in Agent Skills to supercharge your AI (like Antigravity, Cursor, Cline, RooCode, OpenClaw, and more) with browser automation capabilities.
-
-🌐 **Official Website:** [weavetab.dev](https://weavetab.dev)
-📦 **Core MCP Package:** [`weavetab`](https://www.npmjs.com/package/weavetab)
-
-## ⚠️ Prerequisites
-
-These advanced skills are designed specifically for **Weavetab MCP v2.5.0+**.
-Make sure you have installed the core Weavetab MCP server first:
-
-```bash
-npm install -g weavetab
-```
-
-## 🛠️ Installation
-
-We provide a beautiful, interactive CLI installer that seamlessly injects the pure markdown skills into your specific AI agent's configuration folder without cluttering your project with `node_modules`.
-
-Run the following command anywhere:
-
-```bash
-npx @weavetab/skills
-```
-
-The interactive menu will guide you to select your agent framework (`.agents`, `.cursor`, `.clinerules`, `.roocode`, etc.) and the categories of skills you want to install.
-
-## 📚 Skill Categories
-
-- **General (Tier 1):** Essential browser navigation, DOM interaction, guards against abuse, form filling, tab management, and more.
-- **Automation (Tier 2):** *Coming Soon*
-- **Advanced (Tier 3):** *Coming Soon*
-
-## 💻 Programmatic API
-
-If you are building your own CLI or using the core `wt setup` command, you can install skills programmatically:
-
-```javascript
-const { installSkills } = require('@weavetab/skills');
-
-await installSkills({
-  targetFramework: '.cursor', // or '.agents', '.clinerules', etc.
-  categories: ['general']
-});
-```
-
----
-
-*Built with ❤️ by [fy2ne](https://github.com/fy2ne) for the Weavetab Community.*
+# Weavetab MCP Skills (`@weavetab/skills`)
+
+[![npm version](https://img.shields.io/npm/v/@weavetab/skills.svg)](https://www.npmjs.com/package/@weavetab/skills)
+[![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.0-beta.4). Drop-in operational guides, failure recovery heuristics, and protocol rules for **Antigravity**, **Cursor**, **Cline**, **Windsurf**, and **OpenClaw**.
+
+- **Website:** [weavetab.pages.dev](https://weavetab.pages.dev)
+- **Core MCP Server:** [`@weavetab/mcp`](https://www.npmjs.com/package/@weavetab/mcp)
+- **Plugin SDK:** [`@weavetab/sdk`](https://www.npmjs.com/package/@weavetab/sdk)
+
+---
+
+## 1. Architectural Philosophy: The Step-0 Router
+
+Rather than forcing LLMs to read dozens of flat files or guess between vague difficulty tiers, `@weavetab/skills` provides a deterministic Step-0 decision engine via [`ROUTER.md`](ROUTER.md). 
+
+Agents classify their immediate intent in one turn and jump directly to the target domain guide:
+
+```
+@weavetab/skills/
+├── ROUTER.md                   # Universal Intent Decision Matrix (Step-0)
+├── browser/                    # Web & Chromium DOM Navigation Engine
+├── desktop/                    # Native Desktop & Electron Application Automation
+├── memory/                     # Cross-Session Adaptive Selector Learning & History
+├── resilience/                 # Time-Travel Checkpoints, Stale Refs, Loops & Captchas
+├── security/                   # Zero-Leak Secret Containment & RBAC Guardrails
+├── plugins/                    # Dynamic Extension Loading, Hooks & Custom Tools
+├── network-and-perf/           # TLS Forensics, Interception, Core Web Vitals & Emulation
+├── documents/                  # Word, Excel, CSV, PDF & Canvas Ingestion
+├── developer/                  # GitHub Local Clone & API Repository Forensics
+├── evals/                      # Executable Agent Evaluation & Benchmark Harness
+├── dist/                       # Compiled targets (granular + bundled domain profiles)
+├── bin/cli.js                  # Interactive Multi-Agent Installer
+└── src/api.js                  # Programmatic Framework Generator & Adapter Engine
+```
+
+---
+
+## 2. The 9 Operational Domains & 44-Tool Matrix
+
+Every single one of the **44 official tools** in `@weavetab/mcp` is documented with verified parameters and runtime patterns:
+
+| Domain | Primary Tools | Operational Capabilities |
+| :--- | :--- | :--- |
+| **`browser/`** | `browser_map`, `browser_find`, `browser_click`, `browser_type`, `browser_fill`, `browser_key`, `browser_pointer`, `browser_upload`, `browser_tabs`, `browser_scroll`, `browser_dialog`, `browser_burst`, `browser_highlight`, `browser_clipboard` | Token-conserving DOM walks (`lite: true`), volatile `w:NN` handles, atomic multi-field inputs, OS file upload bypass. |
+| **`desktop/`** | `browser_detect`, any tool with `app` argument | Zero-terminal scanning for Slack, Discord, VS Code, Notion, Obsidian; routing actions directly to native Electron windows. |
+| **`memory/`** | `browser_pattern_learn`, `browser_thoughts`, `browser_automation`, `browser_recording` | Cross-session origin selector decay, compiling manual interaction trails into deterministic macros via `browser_burst`. |
+| **`resilience/`**| `browser_checkpoint`, `browser_cookies`, `browser_storage`, `browser_captcha` | Time-travel state snapshots (`save`, `restore`) for instant rollbacks, 4-tier SPA stale ref healing, loop breaker (`browser_map`, `browser_wait`). |
+| **`security/`** | `browser_type_secret`, RBAC tiers | Hardware-grade zero-bleed guarantee (passwords masked in HUD, CDP logs, and conversation transcripts). |
+| **`plugins/`**  | `list_plugins`, `load_plugin` | Runtime discovery and dynamic loading of verified npm community plugins into the active MCP session. |
+| **`network-and-perf/`** | `browser_network_intercept`, `browser_performance`, `browser_wait`, `browser_emulate` | API mocking, TLS certificate chain audits, Core Web Vitals (LCP/CLS), device presets & 3G throttling. |
+| **`documents/`**| `browser_office`, `browser_pdf`, `browser_canvas`, `browser_screenshot`, `browser_viewport`, `browser_extract_design` | Ingesting Excel spreadsheets, Word `.docx`, and CSVs into structured JSON; full-page screenshots and canvas inspection. |
+| **`developer/`**| `browser_github` | Sub-millisecond local repo inspection, PR diffs, and issue triage without burning browser turns. |
+
+---
+
+## 3. Interactive Installation
+
+Inject formatted skills and rules directly into your AI agent environment:
+
+```bash
+npx @weavetab/skills
+```
+
+The interactive installer prompts you for:
+1. **Domain Scope**: Full Enterprise Suite (All 9 Domains), Web Core, Desktop, Resilience, or Forensics.
+2. **Target Agent Framework**:
+   - **Antigravity**: Generates `.agent/skills/weavetab-<domain>/SKILL.md` with standard YAML frontmatter.
+   - **Cursor**: Generates `.cursor/rules/weavetab-<domain>.mdc` with MDC frontmatter.
+   - **Cline**: Appends formatted sections to `.clinerules`.
+   - **Windsurf**: Generates `.windsurf/rules/weavetab-<domain>.md`.
+   - **OpenClaw & RooCode**: Generates respective agent rules.
+   - **Raw Markdown**: Generates portable `weavetab-skills/`.
+
+---
+
+## 4. Programmatic API
+
+Install skills programmatically from setup scripts or custom CLIs:
+
+```javascript
+const { installSkills, getSkills, getSkill, getRouterMatrix } = require('@weavetab/skills');
+
+// Install targeted domains into Cursor
+await installSkills({
+  targetFramework: '.cursor',
+  domains: ['browser', 'resilience', 'security']
+});
+
+// Query skills catalog
+const webSkills = getSkillsByDomain('browser');
+```
+
+---
+
+## 5. Automated Benchmark & Evaluation Suite (`evals/`)
+
+Run the automated evaluation harness to verify that all 48 tools are covered and that skill guidance strictly passes test scenarios without legacy hallucinations:
+
+```bash
+npm test
+```
+
+---
+
+*Built with precision for the Weavetab Ecosystem.*

package/ROUTER.md

@@ -0,0 +1,43 @@
+# Weavetab Agent Intent Decision Matrix (Step-0 Router)
+
+Welcome to the **Weavetab MCP Skills Routing Engine**. 
+
+When executing browser or desktop automation via `@weavetab/mcp`, **do not read the entire skills directory**. Match your immediate intent against the matrix below and jump directly to the target domain guide.
+
+---
+
+## Intent Routing Table
+
+| If your objective is... | Read Domain Guide | Primary MCP Tools |
+| :--- | :--- | :--- |
+| **Inspect DOM, extract text, locate elements, save tokens** | [`browser/dom-strategy.md`](file:///c:/Users/fy2ne/Music/Weavetab/skills/browser/dom-strategy.md) | `browser_map`, `browser_find`, `browser_scrape`, `browser_snapshot` |
+| **Click, type, press keys, pointer trajectories, file upload** | [`browser/interaction-pipeline.md`](file:///c:/Users/fy2ne/Music/Weavetab/skills/browser/interaction-pipeline.md) | `browser_click`, `browser_type`, `browser_key`, `browser_pointer`, `browser_upload` |
+| **Fill multi-field forms, select dropdowns, checkboxes** | [`browser/form-automation.md`](file:///c:/Users/fy2ne/Music/Weavetab/skills/browser/form-automation.md) | `browser_fill`, `browser_select` |
+| **Manage tabs, window creation, tab crash recovery** | [`browser/tab-and-window.md`](file:///c:/Users/fy2ne/Music/Weavetab/skills/browser/tab-and-window.md) | `browser_tabs` |
+| **Discover running Electron apps (Slack, Discord, VS Code)** | [`desktop/electron-discovery.md`](file:///c:/Users/fy2ne/Music/Weavetab/skills/desktop/electron-discovery.md) | `browser_detect` |
+| **Control native desktop applications with MCP tools** | [`desktop/desktop-targeting.md`](file:///c:/Users/fy2ne/Music/Weavetab/skills/desktop/desktop-targeting.md) | Any tool passing `app: "<name>"` |
+| **Bypass DOM walks using learned & cached selectors** | [`memory/selector-memory-system.md`](file:///c:/Users/fy2ne/Music/Weavetab/skills/memory/selector-memory-system.md) | Telemetry & selector history |
+| **Recall multi-step site workflows, quirks & fast-path replay** | [`memory/site-learning.md`](file:///c:/Users/fy2ne/Music/Weavetab/skills/memory/site-learning.md) | `browser_pattern_learn` |
+| **Compile manual action history into reusable macros** | [`memory/session-trail.md`](file:///c:/Users/fy2ne/Music/Weavetab/skills/memory/session-trail.md) | `browser_burst` (`compile_from_history`) |
+| **Handle React/Next/Vue detached elements & re-renders** | [`resilience/stale-ref-recovery.md`](file:///c:/Users/fy2ne/Music/Weavetab/skills/resilience/stale-ref-recovery.md) | 4-tier auto-recovery heuristic |
+| **Save/restore checkpoints & rollback failed workflows** | [`resilience/session-time-travel.md`](file:///c:/Users/fy2ne/Music/Weavetab/skills/resilience/session-time-travel.md) | `browser_checkpoint` |
+| **Break infinite interaction loops or handle CAPTCHAs** | [`resilience/loop-breaker.md`](file:///c:/Users/fy2ne/Music/Weavetab/skills/resilience/loop-breaker.md) | `browser_map`, `browser_captcha` |
+| **Enter passwords, API keys, or sensitive credentials** | [`security/secret-containment-protocol.md`](file:///c:/Users/fy2ne/Music/Weavetab/skills/security/secret-containment-protocol.md) | `browser_type_secret` |
+| **Enforce RBAC boundaries & sandbox viewer agents** | [`security/rbac-and-policies.md`](file:///c:/Users/fy2ne/Music/Weavetab/skills/security/rbac-and-policies.md) | RBAC security layer |
+| **Discover & dynamically load community plugins** | [`plugins/plugin-runtime.md`](file:///c:/Users/fy2ne/Music/Weavetab/skills/plugins/plugin-runtime.md) | `list_plugins`, `load_plugin` |
+| **Intercept tool execution pipelines via SDK hooks** | [`plugins/hooks-and-overrides.md`](file:///c:/Users/fy2ne/Music/Weavetab/skills/plugins/hooks-and-overrides.md) | SDK Plugin Hooks |
+| **Mock API endpoints, stub tracking, analyze TLS certs** | [`network-and-perf/network-intercept-and-mock.md`](file:///c:/Users/fy2ne/Music/Weavetab/skills/network-and-perf/network-intercept-and-mock.md) | `browser_network_intercept` |
+| **Measure Core Web Vitals (LCP, CLS) & wait conditions** | [`network-and-perf/performance-and-vitals.md`](file:///c:/Users/fy2ne/Music/Weavetab/skills/network-and-perf/performance-and-vitals.md) | `browser_performance`, `browser_wait` |
+| **Emulate mobile devices, CPU throttle, mock location** | [`network-and-perf/device-and-environment.md`](file:///c:/Users/fy2ne/Music/Weavetab/skills/network-and-perf/device-and-environment.md) | `browser_emulate` |
+| **Ingest Word (.docx), Excel (.xlsx), CSV files** | [`documents/office-document-ingestion.md`](file:///c:/Users/fy2ne/Music/Weavetab/skills/documents/office-document-ingestion.md) | `browser_office` |
+| **Capture screenshots, PDF exports, canvas pixels & visual marks** | [`documents/canvas-and-visual-capture.md`](file:///c:/Users/fy2ne/Music/Weavetab/skills/documents/canvas-and-visual-capture.md) | `browser_screenshot`, `browser_canvas`, `browser_pdf`, `browser_map` |
+| **Sub-ms local Git repo parsing & PR/issue triage** | [`developer/github-forensics.md`](file:///c:/Users/fy2ne/Music/Weavetab/skills/developer/github-forensics.md) | `browser_github` |
+
+---
+
+## The 4 Golden Operational Rules for Weavetab Agents
+
+1. **Environment Handshake First**: Always call `browser_detect` at the start of a session to discover available browsers and configured desktop apps (Discord, Slack, etc.) and check their live connection status (`connected`, `running_no_debug`, `offline`).
+2. **Token Conservation**: NEVER call `browser_map` on large modern web apps without `lite: true` unless you strictly require full hierarchy data. For keyword navigation, always prefer `browser_find`.
+3. **Volatile Handle Discipline**: Always use the returned volatile ref IDs (`w:NN`) directly. Do NOT attempt to construct speculative CSS selectors from scratch.
+4. **Zero Secret Leakage**: Pass all authentication credentials, API keys, and sensitive tokens through `browser_type_secret`. Never use `browser_type` or `browser_fill` for credentials.

package/bin/cli.js

@@ -1,132 +1,232 @@
-#!/usr/bin/env node
-
-const { select, confirm } = require('@inquirer/prompts');
-const { installSkills } = require('../src/api.js');
-
-// Blue theme colors via ANSI
-const B  = '\x1b[34m';   // blue
-const CB = '\x1b[96m';   // bright cyan
-const W  = '\x1b[97m';   // bright white
-const DM = '\x1b[2m';    // dim
-const Y  = '\x1b[33m';   // yellow
-const G  = '\x1b[32m';   // green
-const R  = '\x1b[31m';   // red
-const X  = '\x1b[0m';    // reset
-
-const line = `${B}${'─'.repeat(52)}${X}`;
-
-async function run() {
-  console.log('');
-  console.log(line);
-  console.log(`${B}  Weavetab MCP Skills${X}  ${DM}v1.0.1${X}`);
-  console.log(`${DM}  Interactive skill installer for AI agents${X}`);
-  console.log(line);
-  console.log('');
-  console.log(`${Y}  ! IMPORTANT${X}  These skills require Weavetab MCP v2.5.0+`);
-  console.log(`${DM}  Install the MCP first: npm install -g weavetab${X}`);
-  console.log(`${DM}  Website: https://weavetab.dev${X}`);
-  console.log('');
-
-  const proceed = await confirm({
-    message: 'Does your agent have Weavetab MCP v2.5.0+ installed?',
-    default: true
-  });
-
-  if (!proceed) {
-    console.log('');
-    console.log(`${DM}  Run: npm install -g weavetab${X}`);
-    console.log(`${DM}  Then run this installer again.${X}`);
-    console.log('');
-    process.exit(0);
-  }
-
-  console.log('');
-
-  // Step 1 — Select category
-  console.log(`${B}  Available tiers:${X}`);
-  console.log(`${G}    [1] General${X}    Core browser automation patterns (15 skills)`);
-  console.log(`${DM}    [2] Automation   Coming soon${X}`);
-  console.log(`${DM}    [3] Advanced     Coming soon${X}`);
-  console.log('');
-
-  const categoryChoice = await select({
-    message: 'Select a skill tier to install',
-    choices: [
-      {
-        name: 'General',
-        value: 'general',
-        description: '15 skills  ->  login, forms, scraping, navigation, uploads, and more'
-      }
-    ]
-  });
-
-  const categories = [categoryChoice];
-  console.log('');
-
-  // Step 2 — Select agent framework
-  const targetFramework = await select({
-    message: 'Select your AI agent format',
-    choices: [
-      {
-        name: '.agents',
-        value: '.agents',
-        description: 'Antigravity, Copilot, OpenCode  ->  .agents/skills/weavetab/'
-      },
-      {
-        name: '.cursor',
-        value: '.cursor',
-        description: 'Cursor IDE  ->  .cursor/rules/'
-      },
-      {
-        name: '.clinerules',
-        value: '.clinerules',
-        description: 'Cline AI  ->  .clinerules'
-      },
-      {
-        name: '.openclaw',
-        value: '.openclaw',
-        description: 'OpenClaw AI  ->  .openclaw/skills/'
-      },
-      {
-        name: '.roocode',
-        value: '.roocode',
-        description: 'RooCode  ->  .roocode/rules/'
-      },
-      {
-        name: '.windsurf',
-        value: '.windsurf',
-        description: 'Windsurf IDE  ->  .windsurf/rules/'
-      },
-      {
-        name: 'aider',
-        value: '.aider',
-        description: 'Aider  ->  .aider.conf.yml'
-      },
-      {
-        name: 'generic',
-        value: 'generic',
-        description: 'Other agents  ->  weavetab-skills/'
-      }
-    ]
-  });
-
-  console.log('');
-  console.log(`${DM}  Installing skills...${X}`);
-
-  try {
-    const result = await installSkills({ targetFramework, categories });
-    console.log('');
-    console.log(line);
-    console.log(`${G}  Done!${X}  ${result}`);
-    console.log(`${B}  Your agent is ready for Weavetab MCP.${X}`);
-    console.log(line);
-    console.log('');
-  } catch (e) {
-    console.log('');
-    console.error(`${R}  Error:${X}  ${e.message}`);
-    console.log('');
-    process.exit(1);
-  }
-}
-
-run();
+#!/usr/bin/env node
+
+const { select, confirm, checkbox } = require('@inquirer/prompts');
+const { installSkills, ALL_DOMAINS, WEAVETAB_VERSION } = require('../src/api.js');
+
+// High-contrast modern ANSI styling
+const B  = '\x1b[38;2;99;102;241m'; // indigo primary
+const CB = '\x1b[38;2;147;197;253m'; // sky cyan
+const W  = '\x1b[97m'; // bright white
+const DM = '\x1b[2m';  // dim
+const Y  = '\x1b[33m'; // yellow
+const G  = '\x1b[32m'; // green
+const R  = '\x1b[31m'; // red
+const X  = '\x1b[0m';  // reset
+
+const line = `${B}${'━'.repeat(58)}${X}`;
+
+function normalizeFramework(fw) {
+  if (!fw) return null;
+  const f = fw.toLowerCase().trim();
+  if (f === 'antigravity' || f === '.agent' || f === 'agent') return '.agent';
+  if (f === 'cursor' || f === '.cursor') return '.cursor';
+  if (f === 'cline' || f === '.clinerules' || f === 'clinerules') return '.clinerules';
+  if (f === 'windsurf' || f === '.windsurf') return '.windsurf';
+  if (f === 'openclaw' || f === '.openclaw') return '.openclaw';
+  if (f === 'roocode' || f === '.roocode' || f === 'roo') return '.roocode';
+  if (f === 'generic' || f === 'markdown' || f === 'raw') return 'generic';
+  return fw;
+}
+
+function mapScope(scope) {
+  if (!scope || scope === 'all' || scope === 'full') return ALL_DOMAINS;
+  if (scope.includes(',')) {
+    const list = scope.split(',').map(s => s.trim().toLowerCase()).filter(Boolean);
+    const valid = list.filter(d => ALL_DOMAINS.includes(d));
+    return valid.length > 0 ? valid : ALL_DOMAINS;
+  }
+  const single = scope.trim().toLowerCase();
+  if (ALL_DOMAINS.includes(single)) return [single];
+  return ALL_DOMAINS;
+}
+
+async function run() {
+  const rawArgs = process.argv.slice(2);
+  let cliFramework = null;
+  let cliScope = null;
+  let skipConfirm = false;
+
+  for (let i = 0; i < rawArgs.length; i++) {
+    const a = rawArgs[i];
+    if (a === '--framework' || a === '-f' || a === '--agent') {
+      cliFramework = normalizeFramework(rawArgs[++i]);
+    } else if (a === '--scope' || a === '-s' || a === '--domains') {
+      cliScope = rawArgs[++i];
+    } else if (a === '--yes' || a === '-y') {
+      skipConfirm = true;
+    } else if (a === '--help' || a === '-h') {
+      console.log(`
+Usage: npx @weavetab/skills@latest [options]
+
+Options:
+  -f, --framework <name>   Target agent framework (.agent, .cursor, .clinerules, .windsurf, .openclaw, .roocode, generic)
+  -s, --scope <folders>    Folders to install (e.g. browser,security, or 'all')
+  -y, --yes                Skip confirmation prompts (installs all folders)
+  -h, --help               Show help
+`);
+      process.exit(0);
+    }
+  }
+
+  console.log('');
+  console.log(line);
+  console.log(`${B}  Weavetab MCP Skills Engine${X}  ${CB}v${WEAVETAB_VERSION}${X}`);
+  console.log(`${DM}  Enterprise Domain-Driven Agent Intelligence${X}`);
+  console.log(line);
+  console.log('');
+  console.log(`${CB}  ✦ 44 Official MCP Tools Mapped${X}`);
+  console.log(`${CB}  ✦ Universal Step-0 ROUTER.md Decision Matrix${X}`);
+  console.log(`${CB}  ✦ Multi-Agent Adapters (Antigravity, Cursor, Cline, Windsurf)${X}`);
+  console.log('');
+
+  if (!skipConfirm && !cliFramework) {
+    const proceed = await confirm({
+      message: 'Does your workspace have @weavetab/mcp installed or configured?',
+      default: true
+    });
+
+    if (!proceed) {
+      console.log('');
+      console.log(`${DM}  Run: npm install -g @weavetab/mcp${X}`);
+      console.log(`${DM}  Documentation: https://weavetab.pages.dev${X}`);
+      console.log('');
+      process.exit(0);
+    }
+  }
+
+  console.log('');
+
+  // Step 1 — Select Domain Folders
+  let selectedDomains = ALL_DOMAINS;
+  if (cliScope) {
+    selectedDomains = mapScope(cliScope);
+  } else if (!skipConfirm) {
+    selectedDomains = await checkbox({
+      message: 'Select Domain Folders to Install (all selected by default, press Space to unselect)',
+      choices: [
+        {
+          name: 'browser (/browser) — Core DOM interaction, navigation, wait, tabs, input',
+          value: 'browser',
+          checked: true
+        },
+        {
+          name: 'desktop (/desktop) — Desktop & Electron apps, Slack, Discord, VS Code',
+          value: 'desktop',
+          checked: true
+        },
+        {
+          name: 'memory (/memory) — Site profiles, selector memory, session trails',
+          value: 'memory',
+          checked: true
+        },
+        {
+          name: 'resilience (/resilience) — Loop breaker, checkpoints, anti-captcha, recovery',
+          value: 'resilience',
+          checked: true
+        },
+        {
+          name: 'security (/security) — Permission boundaries, domain filters, secret injection',
+          value: 'security',
+          checked: true
+        },
+        {
+          name: 'plugins (/plugins) — Plugin management, discovery, dynamic tool loading',
+          value: 'plugins',
+          checked: true
+        },
+        {
+          name: 'network-and-perf (/network-and-perf) — HAR, network intercept, cookies, performance',
+          value: 'network-and-perf',
+          checked: true
+        },
+        {
+          name: 'documents (/documents) — Office documents, Word, Excel, PowerPoint, PDF',
+          value: 'documents',
+          checked: true
+        },
+        {
+          name: 'developer (/developer) — GitHub forensics, issue/PR inspection',
+          value: 'developer',
+          checked: true
+        }
+      ]
+    });
+
+    if (!selectedDomains || selectedDomains.length === 0) {
+      console.log(`${Y}  No folders selected, defaulting to all domain folders.${X}`);
+      selectedDomains = ALL_DOMAINS;
+    }
+  }
+
+  console.log('');
+
+  // Step 2 — Select AI Agent Ecosystem
+  let targetFramework = cliFramework;
+  if (!targetFramework) {
+    targetFramework = await select({
+      message: 'Select Target AI Agent Framework',
+      choices: [
+        {
+          name: 'Antigravity (.agent/skills/<domain>/SKILL.md)',
+          value: '.agent',
+          description: 'Native Antigravity standard with YAML frontmatter discovery'
+        },
+        {
+          name: 'Cursor IDE (.cursor/rules/weavetab-<domain>.mdc)',
+          value: '.cursor',
+          description: 'Cursor rules with MDC frontmatter and glob matching'
+        },
+        {
+          name: 'Cline (.clinerules)',
+          value: '.clinerules',
+          description: 'Consolidated markdown file with domain dividers'
+        },
+        {
+          name: 'Windsurf IDE (.windsurf/rules/)',
+          value: '.windsurf',
+          description: 'Cascade / Windsurf project rules directory'
+        },
+        {
+          name: 'OpenClaw (.openclaw/skills/)',
+          value: '.openclaw',
+          description: 'OpenClaw autonomous agent skill packages'
+        },
+        {
+          name: 'RooCode (.roocode/rules/)',
+          value: '.roocode',
+          description: 'RooCode extension rules directory'
+        },
+        {
+          name: 'Raw Markdown (weavetab-skills/)',
+          value: 'generic',
+          description: 'Portable markdown directory for any LLM prompt'
+        }
+      ]
+    });
+  }
+
+  console.log('');
+  console.log(`${DM}  Installing ${selectedDomains.length} domain bundles...${X}`);
+
+  try {
+    const result = await installSkills({
+      targetFramework,
+      domains: selectedDomains,
+      includeRouter: true
+    });
+
+    console.log('');
+    console.log(line);
+    console.log(`${G}  ✔ Success!${X}  ${result}`);
+    console.log(`${CB}  Step-0 ROUTER.md matrix ready for your AI agent.${X}`);
+    console.log(line);
+    console.log('');
+  } catch (e) {
+    console.log('');
+    console.error(`${R}  Error:${X}  ${e.message}`);
+    console.log('');
+    process.exit(1);
+  }
+}
+
+run();