@weavetab/skills 2.5.0-beta.5 → 2.5.1

package/dist/granular/developer_github-forensics.md

@@ -1,74 +1,89 @@
----
-id: github-forensics
-domain: developer
-triggers:
-  - "analyze github"
-  - "read repository"
-  - "check pull request"
-  - "github issues"
-  - "inspect repo"
-tools:
-  - "browser_github"
-weavetab: ">=2.5.0-beta.5"
----
-
-# GitHub Forensics & Repository Architecture Inspection
-
-Navigating GitHub repositories via web browsing burns massive token budgets loading HTML chrome, comment threads, and diff trees. Weavetab includes a dedicated `browser_github` tool that interacts directly with git metadata and raw endpoints.
-
----
-
-## 1. High-Level Repository Analysis (action: "analyze")
-
-Quickly summarize repo structure, languages, dependency graphs, and recent commit frequency:
-
-```json
-{
-  "action": "analyze",
-  "repo": "Weavetab/MCP"
-}
-```
-
----
-
-## 2. Reading Repository Source Files (action: "read")
-
-Directly stream files and directories from any public or authenticated GitHub repo without cloning or burning API rate limits:
-
-```json
-{
-  "action": "read",
-  "repo": "Weavetab/MCP",
-  "paths": ["src/server.ts"],
-  "line_range": [1, 200]
-}
-```
-
----
-
-## 3. Pull Request Forensics (action: "pr")
-
-Retrieve PR diffs, changed files, review comments, CI checks, and mergeability status:
-
-```json
-{
-  "action": "pr",
-  "repo": "Weavetab/MCP",
-  "number": 42
-}
-```
-
----
-
-## 4. Issue Triage & Search (action: "issues")
-
-Query repository issue trackers with state, label, and keyword filters:
-
-```json
-{
-  "action": "issues",
-  "repo": "Weavetab/MCP",
-  "state": "open",
-  "labels": ["bug", "priority"]
-}
-```
+---
+id: github-forensics
+domain: developer
+triggers:
+  - "analyze github"
+  - "read repository"
+  - "check pull request"
+  - "github issues"
+  - "inspect repo"
+weavetab: ">=2.5.0"
+---
+
+# GitHub Forensics & Repository Architecture Inspection
+
+Navigating GitHub repositories via web browsing burns massive token budgets loading HTML chrome, comment threads, and diff trees. The official `@weavetab/plugin-github` plugin provides a dedicated `github` tool that talks to the GitHub REST API and raw content endpoints directly — no browser DOM, no cloning.
+
+Responses are cached on disk (`~/.weavetab-system/github_cache`) and subject to GitHub's API rate limits.
+
+---
+
+## 1. High-Level Repository Analysis (action: "analyze")
+
+Fetches repo metadata, the default branch, a flat recursive file tree, and a README snippet (first 100 lines). Results are cached and reused by `read`:
+
+```json
+{
+  "action": "analyze",
+  "repo": "Weavetab/MCP"
+}
+```
+
+Returns fields such as `owner`, `repo`, `default_branch`, `description`, `language`, `file_tree` (array of `{path, type, size, sha}`), and `readme_snippet`.
+
+If `repo` is omitted, the active tab's repository is used.
+
+---
+
+## 2. Reading Repository Source Files (action: "read")
+
+Stream specific files from a public or authenticated repo via `raw.githubusercontent.com`. Requires a prior `analyze` (to cache the default branch and tree), or it will run one automatically:
+
+```json
+{
+  "action": "read",
+  "repo": "Weavetab/MCP",
+  "paths": ["src/server.ts"],
+  "line_range": [1, 200]
+}
+```
+
+`paths` is relative to the repo root; `line_range` is an optional `[start, end]` (1-indexed).
+
+---
+
+## 3. Pull Request Forensics (action: "pr")
+
+Retrieve PR details, changed files, and review comments:
+
+```json
+{
+  "action": "pr",
+  "repo": "Weavetab/MCP",
+  "number": 42
+}
+```
+
+Passing `number` fetches that PR; omitting it lists recent PRs.
+
+---
+
+## 4. Issue Triage & Search (action: "issues")
+
+Query the issue tracker with state, label, keyword, and limit filters:
+
+```json
+{
+  "action": "issues",
+  "repo": "Weavetab/MCP",
+  "state": "open",
+  "labels": ["bug"],
+  "limit": 5
+}
+```
+
+- **`number`** fetches a single issue plus its comments.
+- **`search`** runs a keyword search across issues.
+- **`state`** (`open`/`closed`/`all`) and **`labels`** filter the listing; `limit` caps results (default 5).
+
+> The GitHub **search** API is rate-limited more aggressively than raw/GET reads. `read` and `analyze` file fetches do not consume search-quota calls. If a call fails with a rate-limit message, wait until the reported reset time before retrying.

package/dist/granular/documents_canvas-and-visual-capture.md

@@ -1,103 +1,117 @@
----
-id: canvas-and-visual-capture
-domain: documents
-triggers:
-  - "take screenshot"
-  - "capture viewport"
-  - "export pdf"
-  - "canvas inspection"
-  - "extract design tokens"
-tools:
-  - "browser_screenshot"
-  - "browser_viewport"
-  - "browser_canvas"
-  - "browser_pdf"
-  - "browser_extract_design"
-  - "browser_map"
-  - "browser_click"
-weavetab: ">=2.5.0-beta.5"
----
-
-# Visual Capture, Canvas Forensics & Design Extraction
-
-Beyond textual DOM manipulation, modern web applications contain dynamic HTML5 canvas renderings (charts, maps, WebGL games), and agents often need high-fidelity visual artifacts.
-
----
-
-## 1. Targeted Screenshots (`browser_screenshot`)
-
-Capture full page layouts, the visible viewport, or specific element bounding boxes:
-
-```json
-{
-  "fullPage": true,
-  "format": "png"
-}
-```
-
-Or target a specific element ref:
-```json
-{
-  "ref": "w:55",
-  "format": "jpeg",
-  "quality": 80
-}
-```
-
----
-
-## 2. PDF Document Generation (`browser_pdf`)
-
-Render the current page into a print-ready PDF document with print CSS styles applied:
-
-```json
-{
-  "landscape": false,
-  "printBackground": true,
-  "paperWidth": 8.5,
-  "paperHeight": 11
-}
-```
-
----
-
-## 3. HTML5 Canvas Pixel Inspection & Visual Grounding (`browser_canvas` & `browser_map`)
-
-When a chart or graphic is rendered via `<canvas>`, standard DOM reading tools cannot see individual buttons or nodes. You have two strategies:
-
-### A. Set-of-Marks Visual Grounding (Recommended for Canvas UIs & WebGL)
-Run `browser_map({ visual: "auto" })`. It detects canvas elements and high-contrast regions, attaches numbered badges `[1]…[N]`, and returns an annotated image:
-```json
-{
-  "visual": "auto"
-}
-```
-Then interact directly by mark number without guessing pixel coordinates:
-```json
-{
-  "mark": 3
-}
-```
-
-### B. Direct Canvas Pixel Export (`browser_canvas`)
-To extract the raw image data or draw programmatic gesture paths:
-```json
-{
-  "ref": "w:19",
-  "action": "toDataURL"
-}
-```
-
----
-
-## 4. Design System Extraction (`browser_extract_design`)
-
-Reverse-engineer UI stylesheets, active CSS custom properties (variables), typography scales, and color palettes:
-
-```json
-{
-  "selector": ".antigravity-hud-panel"
-}
-```
-
-Returns structured JSON representing colors, font families, shadows, and spacing tokens.
+---
+id: canvas-and-visual-capture
+domain: documents
+triggers:
+  - "take screenshot"
+  - "capture viewport"
+  - "export pdf"
+  - "canvas inspection"
+  - "extract design tokens"
+tools:
+  - "browser_screenshot"
+  - "browser_viewport"
+  - "browser_canvas"
+  - "browser_pdf"
+  - "browser_extract_design"
+  - "browser_map"
+  - "browser_click"
+weavetab: ">=2.5.0"
+---
+
+# Visual Capture, Canvas Forensics & Design Extraction
+
+Beyond textual DOM manipulation, modern web applications contain dynamic HTML5 canvas renderings (charts, maps, WebGL games), and agents often need high-fidelity visual artifacts.
+
+---
+
+## 1. Targeted Screenshots (`browser_screenshot`)
+
+Capture full page layouts, the visible viewport, or specific element bounding boxes:
+
+```json
+{
+  "fullPage": true,
+  "format": "png"
+}
+```
+
+Or crop to a specific element by CSS selector, or to a pixel rectangle with `clip`:
+```json
+{
+  "selector": "#pricing-table",
+  "format": "jpeg",
+  "quality": 80
+}
+```
+
+Options: `format` (`png` default, or `jpeg`), `quality` (JPEG only), `fullPage`, `selector`, and `clip` (`{x, y, width, height}`).
+
+---
+
+## 2. PDF Document Generation (`browser_pdf`)
+
+Render the current page into a print-ready PDF file:
+
+```json
+{
+  "filename": "report.pdf",
+  "landscape": false,
+  "scale": 1.0,
+  "pageRanges": "1-5",
+  "margin": { "top": 0.4, "bottom": 0.4, "left": 0.4, "right": 0.4 }
+}
+```
+
+Options: `filename` (defaults to `capture_<timestamp>.pdf`), `landscape`, `scale` (default 1.0), `pageRanges` (e.g. `"1-5"`, empty for all), and `margin` — either a single number in inches or a `{top,bottom,left,right}` object (default 0.4).
+
+---
+
+## 3. HTML5 Canvas Pixel Inspection & Visual Grounding (`browser_canvas` & `browser_map`)
+
+When a chart or graphic is rendered via `<canvas>`, standard DOM reading tools cannot see individual buttons or nodes. You have two strategies:
+
+### A. Set-of-Marks Visual Grounding (Recommended for Canvas UIs & WebGL)
+Run `browser_map({ visual: "auto" })`. It detects canvas elements and high-contrast regions, attaches numbered badges `[1]…[N]`, and returns an annotated image:
+```json
+{
+  "visual": "auto"
+}
+```
+Then interact directly by mark number without guessing pixel coordinates:
+```json
+{
+  "mark": 3
+}
+```
+
+### B. Direct Canvas Pixel Export (`browser_canvas`)
+To export the raw canvas as an image, or simulate a drag/gesture path across it:
+```json
+{
+  "ref": "w:19",
+  "action": "get_image"
+}
+```
+
+For drawing or selecting a region, pass `"action": "draw"` with a `points` array of `{x, y}` positions (relative to the canvas):
+```json
+{
+  "action": "draw",
+  "selector": "canvas#chart",
+  "points": [ { "x": 40, "y": 10 }, { "x": 200, "y": 120 } ]
+}
+```
+
+---
+
+## 4. Design System Extraction (`browser_extract_design`)
+
+Reverse-engineer UI stylesheets, active CSS custom properties (variables), typography scales, and color palettes:
+
+```json
+{
+  "selector": ".antigravity-hud-panel"
+}
+```
+
+Returns structured JSON representing colors, font families, shadows, and spacing tokens.

package/dist/granular/documents_office-document-ingestion.md

@@ -1,63 +1,91 @@
----
-id: office-document-ingestion
-domain: documents
-triggers:
-  - "read excel"
-  - "read docx"
-  - "parse csv"
-  - "spreadsheet"
-  - "word document"
-  - "parse table"
-tools:
-  - "browser_office"
-weavetab: ">=2.5.0-beta.5"
----
-
-# Office Document Ingestion: Word, Excel & CSV Parsing
-
-Agents frequently need to parse structured spreadsheets or corporate documents downloaded during automation runs. `browser_office` parses `.docx`, `.xlsx`, `.xls`, and `.csv` files directly into clean JSON structures.
-
----
-
-## 1. Parsing Spreadsheets (`.xlsx`, `.csv`)
-
-Stream structured sheet data, headers, and cell values:
-
-```json
-{
-  "filePath": "C:/Users/fy2ne/Downloads/quarterly_revenue.xlsx",
-  "sheet": "Q3_Summary",
-  "headerRow": 1,
-  "maxRows": 100
-}
-```
-
-### Response Example:
-```json
-{
-  "fileType": "xlsx",
-  "sheets": ["Q1", "Q2", "Q3_Summary"],
-  "rowCount": 45,
-  "data": [
-    { "Department": "Engineering", "Budget": 1250000, "Actual": 1180000 },
-    { "Department": "Marketing", "Budget": 600000, "Actual": 620000 }
-  ]
-}
-```
-
----
-
-## 2. Ingesting Word Documents (`.docx`)
-
-Extract semantic paragraphs, document headings, tables, and lists:
-
-```json
-{
-  "filePath": "C:/Users/fy2ne/Documents/service_agreement.docx",
-  "extractTables": true
-}
-```
-
-### Operational Advantages:
-- Eliminates the need for heavy external Python libraries or microservices.
-- Safely sanitizes binary formats before passing content into LLM context.
+---
+id: office-document-ingestion
+domain: documents
+triggers:
+  - "read excel"
+  - "read docx"
+  - "parse csv"
+  - "spreadsheet"
+  - "word document"
+  - "parse table"
+tools:
+  - "browser_office"
+weavetab: ">=2.5.0"
+---
+
+# Office Document Ingestion: Word, Excel, PDF & CSV Parsing
+
+Agents frequently need to parse structured spreadsheets or corporate documents downloaded during automation runs. `browser_office` reads `.xlsx`, `.xls`, `.docx`, `.pdf`, and `.csv` content directly into JSON.
+
+---
+
+## 1. Two Modes: `url` and `file`
+
+`browser_office({ action: "read" })` accepts exactly one source:
+
+- **`url`** — fetch a document URL in-browser using the active session cookies. Ideal for authenticated downloads, SharePoint links, and Google Drive exports. The format is auto-detected from the URL path or MIME type (and magic bytes as a fallback).
+- **`file`** — parse a file already present in the local downloads directory. Pass a **bare filename** only (e.g. `"report.xlsx"`); path separators are rejected.
+
+`max_rows` (default 500) caps Excel/CSV rows; `max_chars` (default 50000) caps PDF/Word text.
+
+Use `action: "list"` first if you don't know what files are in the downloads directory.
+
+---
+
+## 2. Parsing Spreadsheets (`.xlsx`, `.xls`, `.csv`)
+
+```json
+{
+  "action": "read",
+  "file": "quarterly_revenue.xlsx",
+  "max_rows": 100
+}
+```
+
+Excel returns per-sheet tables (rows as objects keyed by header):
+
+```json
+{
+  "success": true,
+  "source": "quarterly_revenue.xlsx",
+  "type": "excel",
+  "data": {
+    "Q3_Summary": [
+      { "Department": "Engineering", "Budget": 1250000, "Actual": 1180000 },
+      { "Department": "Marketing", "Budget": 600000, "Actual": 620000 }
+    ]
+  },
+  "truncated": false
+}
+```
+
+CSV returns `type: "csv"` with a flat `data` array of row objects.
+
+---
+
+## 3. Ingesting Word & PDF Documents (`.docx`, `.pdf`)
+
+Word and PDF extraction return text in `content` (truncated by `max_chars`). PDF additionally reports page metadata under `data`:
+
+```json
+{
+  "action": "read",
+  "url": "https://intranet.example.com/docs/service_agreement.pdf"
+}
+```
+
+```json
+{
+  "success": true,
+  "source": "https://intranet.example.com/docs/service_agreement.pdf",
+  "type": "pdf",
+  "content": "SERVICE AGREEMENT ...",
+  "truncated": true,
+  "data": { "numpages": 12, "info": { "Title": "Service Agreement" } }
+}
+```
+
+### Operational Notes:
+- PDF/Word parsing relies on local binary dependencies (e.g. poppler); if unavailable the call returns `success: false` with an explanatory `error`.
+- If the URL resolves to an HTML login page rather than a document, `type` is `"html"` and `success` is `false` — the link is likely gated.
+- Never point `browser_scrape` or `browser_map` at binary documents; they cannot read inside Excel, Word, or PDF files.