@weavetab/skills 1.0.3 → 2.5.0-beta.4

package/src/api.js

@@ -1,128 +1,239 @@
-const fs = require('fs');
-const path = require('path');
-
-/**
- * Programmatically install Weavetab MCP skills into a target project.
- * 
- * @param {Object} options
- * @param {string} options.targetFramework - '.agents', '.cursor', '.clinerules', or 'generic'
- * @param {string[]} options.categories - Array of categories to install (e.g. ['general'])
- * @param {string} options.projectRoot - The root directory to install into (defaults to process.cwd())
- * @returns {Promise<string>} - A message indicating success and the path where skills were installed.
- */
-async function installSkills({ targetFramework, categories, projectRoot = process.cwd() }) {
-  const packageRoot = path.join(__dirname, '..');
-  
-  if (!categories || categories.length === 0) {
-    throw new Error("No categories selected for installation.");
-  }
-
-  // Gather all markdown files from the selected categories
-  let allMarkdownFiles = [];
-  for (const category of categories) {
-    const categoryDir = path.join(packageRoot, category);
-    if (!fs.existsSync(categoryDir)) continue;
-    
-    const files = fs.readdirSync(categoryDir).filter(f => f.endsWith('.md'));
-    for (const file of files) {
-      allMarkdownFiles.push({
-        name: file,
-        content: fs.readFileSync(path.join(categoryDir, file), 'utf8')
-      });
-    }
-  }
-
-  if (allMarkdownFiles.length === 0) {
-    throw new Error("No skills found in the selected categories.");
-  }
-
-  // Process and inject based on the framework
-  if (targetFramework === '.clinerules') {
-    // Cline uses a single file at the root
-    const clineFile = path.join(projectRoot, '.clinerules');
-    let combinedContent = "\n\n# --- Weavetab MCP Skills ---\n\n";
-    for (const file of allMarkdownFiles) {
-      combinedContent += `## ${file.name}\n${file.content}\n\n`;
-    }
-    fs.appendFileSync(clineFile, combinedContent);
-    return `Successfully appended ${allMarkdownFiles.length} skills to ${clineFile}`;
-  } 
-  
-  else if (targetFramework === '.cursor') {
-    // Cursor uses .mdc files in .cursor/rules
-    const cursorRulesDir = path.join(projectRoot, '.cursor', 'rules');
-    fs.mkdirSync(cursorRulesDir, { recursive: true });
-    
-    for (const file of allMarkdownFiles) {
-      const destFile = path.join(cursorRulesDir, file.name.replace('.md', '.mdc'));
-      fs.writeFileSync(destFile, file.content);
-    }
-    return `Successfully installed ${allMarkdownFiles.length} skills to ${cursorRulesDir}`;
-  } 
-  
-  else if (targetFramework === '.agents') {
-    // Standard agent customizations folder
-    const agentsDir = path.join(projectRoot, '.agents', 'skills', 'weavetab');
-    fs.mkdirSync(agentsDir, { recursive: true });
-    
-    for (const file of allMarkdownFiles) {
-      fs.writeFileSync(path.join(agentsDir, file.name), file.content);
-    }
-    return `Successfully installed ${allMarkdownFiles.length} skills to ${agentsDir}`;
-  } 
-  
-  else if (targetFramework === '.openclaw') {
-    // OpenClaw AI folder
-    const openClawDir = path.join(projectRoot, '.openclaw', 'skills');
-    fs.mkdirSync(openClawDir, { recursive: true });
-    
-    for (const file of allMarkdownFiles) {
-      fs.writeFileSync(path.join(openClawDir, file.name), file.content);
-    }
-    return `Successfully installed ${allMarkdownFiles.length} skills to ${openClawDir}`;
-  } 
-  
-  else if (targetFramework === '.roocode') {
-    const rooDir = path.join(projectRoot, '.roocode', 'rules');
-    fs.mkdirSync(rooDir, { recursive: true });
-    
-    for (const file of allMarkdownFiles) {
-      fs.writeFileSync(path.join(rooDir, file.name), file.content);
-    }
-    return `Successfully installed ${allMarkdownFiles.length} skills to ${rooDir}`;
-  } 
-  
-  else if (targetFramework === '.windsurf') {
-    const windsurfDir = path.join(projectRoot, '.windsurf', 'rules');
-    fs.mkdirSync(windsurfDir, { recursive: true });
-    
-    for (const file of allMarkdownFiles) {
-      fs.writeFileSync(path.join(windsurfDir, file.name), file.content);
-    }
-    return `Successfully installed ${allMarkdownFiles.length} skills to ${windsurfDir}`;
-  } 
-  
-  else if (targetFramework === '.aider') {
-    const aiderFile = path.join(projectRoot, '.aider.conf.yml');
-    let combinedContent = "\n# --- Weavetab MCP Skills ---\n";
-    for (const file of allMarkdownFiles) {
-      // Very basic formatting for appending to Aider conf
-      combinedContent += `# ${file.name}\n# ${file.content.split('\n').join('\n# ')}\n\n`;
-    }
-    fs.appendFileSync(aiderFile, combinedContent);
-    return `Successfully appended ${allMarkdownFiles.length} skills to ${aiderFile}`;
-  } 
-  
-  else {
-    // Generic folder
-    const genericDir = path.join(projectRoot, 'weavetab-skills');
-    fs.mkdirSync(genericDir, { recursive: true });
-    
-    for (const file of allMarkdownFiles) {
-      fs.writeFileSync(path.join(genericDir, file.name), file.content);
-    }
-    return `Successfully installed ${allMarkdownFiles.length} skills to ${genericDir}`;
-  }
-}
-
-module.exports = { installSkills };
+const fs = require('fs');
+const path = require('path');
+
+const packageRoot = path.join(__dirname, '..');
+const pkg = JSON.parse(fs.readFileSync(path.join(packageRoot, 'package.json'), 'utf8'));
+const WEAVETAB_VERSION = pkg.version;
+const skillsJsonPath = path.join(packageRoot, 'skills.json');
+const routerPath = path.join(packageRoot, 'ROUTER.md');
+const distBundledDir = path.join(packageRoot, 'dist', 'bundled');
+
+const ALL_DOMAINS = [
+  'browser',
+  'desktop',
+  'memory',
+  'resilience',
+  'security',
+  'plugins',
+  'network-and-perf',
+  'documents',
+  'developer'
+];
+
+/**
+ * Read the pre-compiled skills catalog.
+ */
+function getSkills() {
+  if (!fs.existsSync(skillsJsonPath)) {
+    throw new Error("skills.json not found. Run 'npm run build' first.");
+  }
+  return JSON.parse(fs.readFileSync(skillsJsonPath, 'utf8'));
+}
+
+/**
+ * Retrieve a specific skill by its ID.
+ */
+function getSkill(id) {
+  const data = getSkills();
+  return data.skills.find(s => s.id === id) || null;
+}
+
+/**
+ * Retrieve all skills belonging to a domain.
+ */
+function getSkillsByDomain(domain) {
+  const data = getSkills();
+  return data.skills.filter(s => s.domain === domain);
+}
+
+/**
+ * Read the universal intent decision matrix (ROUTER.md).
+ */
+function getRouterMatrix() {
+  if (!fs.existsSync(routerPath)) return "";
+  return fs.readFileSync(routerPath, 'utf8');
+}
+
+/**
+ * Programmatically install Weavetab MCP skills into a target project.
+ * 
+ * @param {Object} options
+ * @param {string} options.targetFramework - '.agents', '.cursor', '.clinerules', '.windsurf', '.openclaw', '.roocode', '.aider', or 'generic'
+ * @param {string[]} [options.domains] - Domains to install (e.g. ['browser', 'security']). Defaults to all domains.
+ * @param {string} [options.projectRoot] - Root directory to install into (defaults to process.cwd())
+ * @param {boolean} [options.includeRouter=true] - Whether to include the Step-0 ROUTER.md matrix.
+ * @returns {Promise<string>} - Confirmation message and target path.
+ */
+async function installSkills({
+  targetFramework,
+  domains = ALL_DOMAINS,
+  projectRoot = process.cwd(),
+  includeRouter = true
+}) {
+  if (!targetFramework) {
+    throw new Error("targetFramework is required (e.g. '.agents', '.cursor', '.clinerules').");
+  }
+
+  if (!domains || domains.length === 0) {
+    domains = ALL_DOMAINS;
+  }
+
+  const routerContent = getRouterMatrix();
+
+  // Load domain bundled content
+  const domainBundles = {};
+  for (const domain of domains) {
+    const bundleFile = path.join(distBundledDir, `weavetab-${domain}.md`);
+    if (fs.existsSync(bundleFile)) {
+      domainBundles[domain] = fs.readFileSync(bundleFile, 'utf8');
+    }
+  }
+
+  // 1. Antigravity & Standard Agent Tree (.agent/skills/<skill-name>/SKILL.md)
+  if (targetFramework === '.agents' || targetFramework === '.agent') {
+    const baseSkillsDir = path.join(projectRoot, '.agent', 'skills');
+    fs.mkdirSync(baseSkillsDir, { recursive: true });
+
+    if (includeRouter) {
+      const routerDir = path.join(baseSkillsDir, 'weavetab-router');
+      fs.mkdirSync(routerDir, { recursive: true });
+      const routerFrontmatter = [
+        "---",
+        "name: weavetab-router",
+        "description: Step-0 Universal Intent Decision Matrix for Weavetab MCP automation",
+        "---",
+        "",
+        routerContent
+      ].join('\n');
+      fs.writeFileSync(path.join(routerDir, 'SKILL.md'), routerFrontmatter);
+    }
+
+    for (const [domain, content] of Object.entries(domainBundles)) {
+      const skillDir = path.join(baseSkillsDir, `weavetab-${domain}`);
+      fs.mkdirSync(skillDir, { recursive: true });
+      const frontmatter = [
+        "---",
+        `name: weavetab-${domain}`,
+        `description: Operational guidance for Weavetab MCP ${domain} domain automation and tool protocols.`,
+        "---",
+        "",
+        content
+      ].join('\n');
+      fs.writeFileSync(path.join(skillDir, 'SKILL.md'), frontmatter);
+    }
+
+    return `Successfully installed ${domains.length} domain skills to ${baseSkillsDir}`;
+  }
+
+  // 2. Cursor IDE (.cursor/rules/weavetab-<domain>.mdc)
+  else if (targetFramework === '.cursor') {
+    const cursorRulesDir = path.join(projectRoot, '.cursor', 'rules');
+    fs.mkdirSync(cursorRulesDir, { recursive: true });
+
+    if (includeRouter) {
+      const routerMdc = [
+        "---",
+        "description: Universal Agent Intent Decision Matrix for Weavetab MCP",
+        "globs: *",
+        "alwaysApply: false",
+        "---",
+        "",
+        routerContent
+      ].join('\n');
+      fs.writeFileSync(path.join(cursorRulesDir, 'weavetab-router.mdc'), routerMdc);
+    }
+
+    for (const [domain, content] of Object.entries(domainBundles)) {
+      const mdcContent = [
+        "---",
+        `description: Weavetab MCP operational rules for ${domain}`,
+        "globs: *",
+        "alwaysApply: false",
+        "---",
+        "",
+        content
+      ].join('\n');
+      fs.writeFileSync(path.join(cursorRulesDir, `weavetab-${domain}.mdc`), mdcContent);
+    }
+
+    return `Successfully installed ${domains.length} Cursor rules to ${cursorRulesDir}`;
+  }
+
+  // 3. Cline (.clinerules single file)
+  else if (targetFramework === '.clinerules') {
+    const clineFile = path.join(projectRoot, '.clinerules');
+    let combined = `\n\n# ====================================================\n# Weavetab MCP Skills (v${WEAVETAB_VERSION})\n# ====================================================\n\n`;
+    if (includeRouter) {
+      combined += routerContent + "\n\n";
+    }
+    for (const [domain, content] of Object.entries(domainBundles)) {
+      combined += `\n\n# --- DOMAIN: ${domain.toUpperCase()} ---\n\n${content}\n`;
+    }
+    fs.appendFileSync(clineFile, combined);
+    return `Successfully appended ${domains.length} domains to ${clineFile}`;
+  }
+
+  // 4. Windsurf IDE (.windsurf/rules/weavetab-<domain>.md)
+  else if (targetFramework === '.windsurf') {
+    const windsurfDir = path.join(projectRoot, '.windsurf', 'rules');
+    fs.mkdirSync(windsurfDir, { recursive: true });
+
+    if (includeRouter) {
+      fs.writeFileSync(path.join(windsurfDir, 'weavetab-router.md'), routerContent);
+    }
+
+    for (const [domain, content] of Object.entries(domainBundles)) {
+      fs.writeFileSync(path.join(windsurfDir, `weavetab-${domain}.md`), content);
+    }
+    return `Successfully installed ${domains.length} rules to ${windsurfDir}`;
+  }
+
+  // 5. OpenClaw (.openclaw/skills/weavetab-<domain>/SKILL.md)
+  else if (targetFramework === '.openclaw') {
+    const openClawDir = path.join(projectRoot, '.openclaw', 'skills');
+    fs.mkdirSync(openClawDir, { recursive: true });
+
+    for (const [domain, content] of Object.entries(domainBundles)) {
+      const dir = path.join(openClawDir, `weavetab-${domain}`);
+      fs.mkdirSync(dir, { recursive: true });
+      fs.writeFileSync(path.join(dir, 'SKILL.md'), content);
+    }
+    return `Successfully installed ${domains.length} skills to ${openClawDir}`;
+  }
+
+  // 6. RooCode (.roocode/rules/weavetab-<domain>.md)
+  else if (targetFramework === '.roocode') {
+    const rooDir = path.join(projectRoot, '.roocode', 'rules');
+    fs.mkdirSync(rooDir, { recursive: true });
+
+    for (const [domain, content] of Object.entries(domainBundles)) {
+      fs.writeFileSync(path.join(rooDir, `weavetab-${domain}.md`), content);
+    }
+    return `Successfully installed ${domains.length} rules to ${rooDir}`;
+  }
+
+  // 7. Generic / Raw Markdown
+  else {
+    const genericDir = path.join(projectRoot, 'weavetab-skills');
+    fs.mkdirSync(genericDir, { recursive: true });
+
+    if (includeRouter) {
+      fs.writeFileSync(path.join(genericDir, 'ROUTER.md'), routerContent);
+    }
+
+    for (const [domain, content] of Object.entries(domainBundles)) {
+      fs.writeFileSync(path.join(genericDir, `weavetab-${domain}.md`), content);
+    }
+    return `Successfully installed ${domains.length} domain bundles to ${genericDir}`;
+  }
+}
+
+module.exports = {
+  WEAVETAB_VERSION,
+  installSkills,
+  getSkills,
+  getSkill,
+  getSkillsByDomain,
+  getRouterMatrix,
+  ALL_DOMAINS
+};

package/advanced/README.md

@@ -1,2 +0,0 @@
-# Advanced Skills
-Coming soon.

package/automation/README.md

@@ -1,2 +0,0 @@
-# Automation Skills
-Coming soon.

package/general/captcha-evasion.md

@@ -1,13 +0,0 @@
----
-id: captcha-evasion
-tier: general
-triggers: ["captcha", "recaptcha", "hcaptcha", "bot check", "verification"]
-tools: ["browser_wait", "browser_click", "browser_map", "browser_snapshot", "browser_ask"]
-weavetab: ">=2.5.0"
----
-# 🤖 Bot Challenge Handling
-**Core Philosophy:** You will encounter anti-bot systems. Handle them gracefully.
-
-- **Identify the Threat:** If a page suddenly looks weird, check for Cloudflare, reCAPTCHA, or hCaptcha challenge screens.
-- **Attempt Resolution:** Some captchas are simple "Click to verify you are human" checkboxes. You can often `browser_click` these successfully.
-- **Know Your Limits:** If you hit a complex image grid captcha, do not guess blindly. Use `browser_ask` to prompt the user for help, or wait and see if the challenge resolves itself. You are autonomous, but you know when to ask for human assistance.

package/general/context-awareness.md

@@ -1,13 +0,0 @@
----
-id: context-awareness
-tier: general
-triggers: ["analyze page", "understand context", "what is on the page", "read page", "visualize"]
-tools: ["browser_snapshot", "browser_map", "browser_evaluate"]
-weavetab: ">=2.5.0"
----
-# 👁️ Deep Context Awareness
-**Core Philosophy:** Don't just look at the DOM; understand the semantic meaning of the page.
-
-- **Holistic Understanding:** Before taking action on a complex page, take a moment to understand its structure. Where is the navigation? Where is the main content? Where is the sidebar?
-- **Visual vs. Semantic:** Remember that what is visually prominent might be buried deep in the DOM. Use `browser_snapshot` to reconcile the visual layout with the structural DOM.
-- **Read Between the Lines:** If a user asks you to "buy the cheapest item", you need to autonomously scan the page, extract prices, compare them, and then take action. Be smart.

package/general/cookie-consent.md

@@ -1,13 +0,0 @@
----
-id: cookie-consent
-tier: general
-triggers: ["cookie banner", "consent", "gdpr", "accept cookies", "popup", "overlay"]
-tools: ["browser_find", "browser_click", "browser_map"]
-weavetab: ">=2.5.0"
----
-# 🍪 Autonomous Consent Handling
-**Core Philosophy:** Cookie banners and popups are the bane of web automation. Destroy them.
-
-- **Detect and Destroy:** When you land on a new site, the very first thing you should look for is a giant overlay blocking the content. 
-- **Accept or Reject:** If the user hasn't specified a preference, you have the autonomy to click "Accept All", "Got it", or "Reject All" just to get the banner out of the way so you can do your actual job.
-- **Don't Let Them Stop You:** If a modal overlay prevents you from clicking the element you actually want, prioritize dismissing the modal first.

package/general/data-extraction.md

@@ -1,13 +0,0 @@
----
-id: data-extraction
-tier: general
-triggers: ["extract", "scrape", "get data", "read data", "fetch info", "parse"]
-tools: ["browser_scrape", "browser_evaluate", "browser_snapshot", "browser_map"]
-weavetab: ">=2.5.0"
----
-# 🗃️ Intelligent Data Extraction
-**Core Philosophy:** You are a master of transforming messy web pages into structured data.
-
-- **Go Beyond the Surface:** Don't just scrape text. Look for hidden metadata, `aria-labels`, and data attributes that might contain cleaner information.
-- **Use JavaScript:** If the DOM is too chaotic to scrape cleanly using standard tools, you have the autonomy to use `browser_evaluate` to run a custom JavaScript snippet to extract exactly what you need.
-- **Synthesize:** If the user asks for a summary of a product, don't just dump the raw description. Extract the price, the reviews, the specs, and synthesize it into a clean, easy-to-read report.

package/general/dynamic-interaction.md

@@ -1,13 +0,0 @@
----
-id: dynamic-interaction
-tier: general
-triggers: ["hover", "drag", "complex interaction", "dropdown", "menu", "slider"]
-tools: ["browser_pointer", "browser_map", "browser_click", "browser_evaluate"]
-weavetab: ">=2.5.0"
----
-# 🖱️ Complex UI Interactions
-**Core Philosophy:** Modern web apps require more than just clicking and typing.
-
-- **Hover States:** Mega-menus and tooltips require hovering. Use `browser_pointer` to move the mouse over elements to reveal hidden interactions.
-- **Drag and Drop:** Sliders, kanban boards, and reorderable lists require drag-and-drop. Calculate the coordinates and execute smooth pointer movements.
-- **Be Human-Like:** When interacting with highly dynamic UI components, sometimes it helps to pause briefly between actions to allow animations and transitions to complete.

package/general/error-recovery.md

@@ -1,13 +0,0 @@
----
-id: error-recovery
-tier: general
-triggers: ["error", "fail", "timeout", "crash", "not found", "stuck", "fix"]
-tools: ["browser_snapshot", "browser_map", "browser_console", "browser_wait"]
-weavetab: ">=2.5.0"
----
-# 🚑 Autonomous Error Recovery
-**Core Philosophy:** Errors are inevitable. Your strength is in how you recover from them.
-
-- **Don't Panic:** If a tool call fails (e.g., element not found, timeout), do not immediately give up and ask the user. 
-- **Investigate:** Take a `browser_snapshot` to see what the page actually looks like. Check the `browser_console` for JavaScript errors that might explain why the page is broken.
-- **Pivot and Retry:** Did the page layout change? Find the new selector. Did a modal pop up and steal focus? Close it. You have the autonomy to troubleshoot and try alternative approaches before admitting defeat.

package/general/file-upload.md

@@ -1,13 +0,0 @@
----
-id: file-upload
-tier: general
-triggers: ["upload", "file upload", "attach file", "drag and drop", "input file"]
-tools: ["browser_upload", "browser_map", "browser_click", "browser_find"]
-weavetab: ">=2.5.0"
----
-# 📤 Resilient File Uploading
-**Core Philosophy:** File uploads can be triggered via hidden inputs, drag-and-drop zones, or complex JS widgets.
-
-- **Find the Real Input:** Often, the visible "Upload" button is just a styled div. You need to find the actual `<input type="file">`. Use `browser_find` or `browser_map` to hunt it down.
-- **Use the Native Tool:** Once found, use `browser_upload` to attach the file directly to the input element.
-- **Creative Fallbacks:** If `browser_upload` fails because the input is deeply obscured, look for alternative ways to upload (e.g., providing a URL if the site allows it, or alerting the user that manual intervention is needed for this specific widget).

package/general/form-filling.md

@@ -1,16 +0,0 @@
----
-id: form-filling
-tier: general
-triggers: ["fill form", "submit form", "form", "input", "textarea", "dropdown", "select", "checkbox"]
-tools: ["browser_map", "browser_fill", "browser_type", "browser_select", "browser_click"]
-weavetab: ">=2.5.0"
----
-# 📝 Dynamic Form Handling
-**Core Philosophy:** Forms are often dynamic, fragile, and aggressively validated. Handle them with care and intelligence.
-
-- **Map and Plan:** Use `browser_map({ scope: "form" })` to get the lay of the land. Plan your data entry.
-- **Adapt to the UI:** 
-  - For standard fields, `browser_fill` is fast and efficient.
-  - For tricky rich-text editors or masked inputs, fall back to `browser_type`.
-  - Use `browser_select` for dropdowns, but be prepared to use `browser_click` if it's a custom div-based dropdown.
-- **Validation Awareness:** Pay attention to the DOM! If a field turns red, stop and fix it. Don't blindly submit a form with errors. If you see a disabled submit button, figure out which required field you missed.

package/general/guardrails.md

@@ -1,13 +0,0 @@
----
-id: guardrails
-tier: general
-triggers: ["search", "browse", "github", "web", "navigate", "read repo"]
-tools: ["browser_navigate", "browser_map", "github_analyze", "github_read"]
-weavetab: ">=2.5.0"
----
-# 🛡️ Guardrails & Autonomy
-**Core Philosophy:** You are a highly capable agent. Use your best judgment when deciding whether to use Weavetab MCP or your native tools.
-
-- **Native Tools First:** If you need to do a simple web search or read a local codebase, rely on your native capabilities first. They are often faster.
-- **When to Engage Weavetab:** Activate Weavetab MCP when you need deep, interactive browsing, rendering complex SPA pages, interacting with forms, or scraping structured data.
-- **Creative Problem Solving:** Don't just follow paths blindly. If a site blocks you, pivot. Try a different search term, a different URL, or evaluate the DOM to find alternative routes. You have the autonomy to solve the problem how you see fit.

package/general/iframe-handling.md

@@ -1,13 +0,0 @@
----
-id: iframe-handling
-tier: general
-triggers: ["iframe", "frame", "embed", "embedded content", "cross origin"]
-tools: ["browser_map", "browser_find", "browser_click", "browser_snapshot", "browser_navigate"]
-weavetab: ">=2.5.0"
----
-# 🖼️ iFrame & Embedded Contexts
-**Core Philosophy:** iFrames are websites within websites. You must traverse them intelligently.
-
-- **Spot the Frame:** Payment gateways, video players, and embedded widgets live in iFrames. If you can't find an element that you *know* is on screen, it's probably in an iFrame.
-- **Navigate the Hierarchy:** Use your tools to target elements *inside* the iFrame context. 
-- **Creative Extraction:** If an iFrame is being particularly stubborn, consider extracting its `src` attribute and using `browser_navigate` to visit the embedded page directly in a new tab.

package/general/infinite-scroll.md

@@ -1,13 +0,0 @@
----
-id: infinite-scroll
-tier: general
-triggers: ["infinite scroll", "load more", "scroll", "pagination", "lazy load"]
-tools: ["browser_scroll", "browser_map", "browser_snapshot", "browser_wait"]
-weavetab: ">=2.5.0"
----
-# 📜 Infinite Scroll Navigation
-**Core Philosophy:** Some data is hidden behind the scrollbar. You must be proactive in revealing it.
-
-- **Scroll and Observe:** Use `browser_scroll` to move down the page. Don't just scroll once—if you're looking for a specific item, loop your scroll and `browser_wait` until the network fetches the new items.
-- **Know When to Stop:** Monitor the DOM. If you scroll and the total height of the page doesn't change after a few seconds, you've likely hit the bottom.
-- **Load More Buttons:** Infinite scroll is sometimes replaced by "Load More" buttons. Be vigilant—if scrolling isn't working, look for a button to click instead.

package/general/login-flow.md

@@ -1,16 +0,0 @@
----
-id: login-flow
-tier: general
-triggers: ["login", "sign in", "authenticate", "credentials", "log in", "username", "password"]
-tools: ["browser_navigate", "browser_map", "browser_fill", "browser_type", "browser_click"]
-weavetab: ">=2.5.0"
----
-# 🔑 Autonomous Login Flow
-**Core Philosophy:** Authentication flows vary wildly across the web. You must adapt to the specific site's architecture.
-
-1. **Assess the Landscape:** When you land on a login page, use `browser_map` to understand the layout. Is it a single form? A multi-step flow? A social login?
-2. **Execute Creatively:**
-   - Use `browser_fill` for standard forms.
-   - If inputs are hidden or complex, use `browser_type` to simulate human keystrokes.
-3. **Handle Friction:** Expect captchas, 2FA prompts, or weird redirects. If the submit button doesn't work, try pressing Enter natively or looking for hidden validation errors.
-4. **Verify State:** Always confirm you actually logged in by checking for authenticated UI elements (like a dashboard or avatar) before declaring success.

package/general/multi-tab-management.md

@@ -1,13 +0,0 @@
----
-id: multi-tab-management
-tier: general
-triggers: ["new tab", "open tab", "switch tab", "multiple tabs", "popup", "window"]
-tools: ["browser_tabs", "browser_navigate", "browser_click", "browser_map"]
-weavetab: ">=2.5.0"
----
-# 🗂️ Advanced Tab Management
-**Core Philosophy:** Modern workflows require multitasking. Manage your browser tabs like a pro.
-
-- **Keep Context:** If you need to reference documentation while interacting with an app, open it in a new tab. Use `browser_tabs` to seamlessly switch between them.
-- **Handle Popups:** Sites will often open OAuth flows or external links in new tabs automatically. Be aware of your current active tab and switch contexts when necessary.
-- **Clean Up:** Don't leave 50 tabs open. Close tabs you no longer need to keep your working memory and the browser clean.

package/general/spa-navigation.md

@@ -1,13 +0,0 @@
----
-id: spa-navigation
-tier: general
-triggers: ["spa", "single page", "react", "vue", "angular", "navigate", "route", "dynamic page"]
-tools: ["browser_navigate", "browser_wait", "browser_map", "browser_snapshot", "browser_click"]
-weavetab: ">=2.5.0"
----
-# 🧭 Single Page Application (SPA) Mastery
-**Core Philosophy:** SPAs mutate the DOM asynchronously. You cannot rely on traditional page loads.
-
-- **Patience is Key:** After clicking a link or a button in an SPA, the URL might change, but the network request might still be pending. Use `browser_wait` to ensure the DOM has settled.
-- **Watch the DOM:** Instead of waiting blindly, look for loading spinners or skeleton screens. When they disappear, the content is ready.
-- **State Awareness:** SPAs maintain state. If you get lost, you can often use the browser's back button or look for breadcrumbs to re-orient yourself.

package/general/table-scraping.md

@@ -1,13 +0,0 @@
----
-id: table-scraping
-tier: general
-triggers: ["scrape table", "extract table", "table data", "csv", "rows", "columns", "spreadsheet"]
-tools: ["browser_scrape", "browser_map", "browser_snapshot", "browser_navigate"]
-weavetab: ">=2.5.0"
----
-# 📊 Intelligent Table Scraping
-**Core Philosophy:** Data rarely looks exactly how you want it to. Be a smart data extractor.
-
-- **Identify the Target:** Tables aren't always `<table>` elements. Look for CSS grids, flexboxes, and repeating list structures.
-- **Scrape Smartly:** Use `browser_scrape` to pull structured data. If the table is paginated, you have the autonomy to loop through pages and compile the data into a single comprehensive dataset.
-- **Data Cleanup:** When you extract the data, don't just dump it. Clean it up. Format it nicely (e.g., Markdown tables or CSV) for the user. If headers are weird, infer what they mean and rename them.