@weavetab/skills 1.0.1 → 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/.github/FUNDING.yml

@@ -1,2 +0,0 @@
-github:
-  - fy2ne

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,28 +0,0 @@
----
-name: Bug Report
-about: Report a broken or misbehaving skill
-title: "[BUG] "
-labels: bug
-assignees: fy2ne
----
-
-**Which skill is affected?**
-e.g. `general/login-flow.md`
-
-**Describe the bug**
-A clear and concise description of what went wrong.
-
-**Weavetab MCP version**
-e.g. v2.5.0
-
-**AI Agent being used**
-e.g. Antigravity, Cursor, Cline
-
-**To Reproduce**
-Steps to reproduce the behavior.
-
-**Expected behavior**
-What you expected the agent to do.
-
-**Additional context**
-Any logs, screenshots, or notes.

package/.github/ISSUE_TEMPLATE/skill_request.md

@@ -1,24 +0,0 @@
----
-name: Skill Request
-about: Request a new skill to be added to the library
-title: "[SKILL] "
-labels: enhancement
-assignees: fy2ne
----
-
-**What task pattern should this skill cover?**
-e.g. "Handling cookie consent banners automatically"
-
-**Which category should it go in?**
-- [ ] General (Tier 1)
-- [ ] Automation (Tier 2)
-- [ ] Advanced (Tier 3)
-
-**Which Weavetab MCP tools would it use?**
-e.g. `browser_click`, `browser_find`
-
-**Describe the skill behavior**
-What should the agent do when this skill is active?
-
-**Why is this useful?**
-Who would benefit from this skill?

package/.github/PULL_REQUEST_TEMPLATE.md

@@ -1,23 +0,0 @@
----
-name: Pull Request
-about: Contribute a new skill or fix
----
-
-## What does this PR do?
-
-- [ ] Adds a new skill
-- [ ] Fixes an existing skill
-- [ ] Improves the CLI installer
-- [ ] Other (describe below)
-
-## Skill file(s) changed
-
-List the files you added or modified:
-- `general/your-skill.md`
-
-## Checklist
-
-- [ ] Frontmatter includes `weavetab: ">=2.5.0"`
-- [ ] Ran `npm run build` and `skills.json` is updated
-- [ ] Skill is focused on a single task pattern
-- [ ] No emojis in skill content

package/CONTRIBUTING.md

@@ -1,34 +0,0 @@
-# Contributing to Weavetab MCP Skills
-
-Thank you for your interest in contributing! Here is how you can help.
-
-## Adding a New Skill
-
-1. Fork the repository.
-2. Create a new `.md` file in the appropriate category folder (`general/`, `automation/`, `advanced/`).
-3. Use the following frontmatter at the top of your file:
-
-```yaml
----
-id: your-skill-name
-tier: general
-triggers: [keyword1, keyword2]
-tools: [browser_navigate, browser_click]
-weavetab: ">=2.5.0"
----
-```
-
-4. Write clear, concise instructions for the AI agent below the frontmatter.
-5. Run `npm run build` to regenerate `skills.json`.
-6. Open a Pull Request with a description of what your skill does.
-
-## Rules
-
-- Skills must be specifically for **Weavetab MCP** — not generic AI instructions.
-- Skills must require **Weavetab MCP v2.5.0+**.
-- Keep skill files focused on a single task pattern.
-- No emojis in skill content (keep it clean and professional).
-
-## Code of Conduct
-
-Be respectful and constructive. This is a community project.

package/SECURITY.md

@@ -1,26 +0,0 @@
-# Security Policy
-
-## Supported Versions
-
-| Version | Supported |
-| ------- | --------- |
-| 1.0.x   | Yes       |
-
-## Reporting a Vulnerability
-
-If you discover a security vulnerability in this project, **please do not open a public GitHub issue.**
-
-Instead, contact the maintainer directly:
-
-- **GitHub:** [@fy2ne](https://github.com/fy2ne)
-
-Please include:
-- A clear description of the vulnerability
-- Steps to reproduce it
-- Any relevant logs or screenshots
-
-You can expect a response within **48 hours**. If the issue is confirmed, a patch will be released as soon as possible.
-
-## Scope
-
-This repository contains only **Markdown skill files** and a lightweight CLI installer. The attack surface is minimal, but we take any supply-chain or code injection concerns seriously.

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.