@vforsh/argus 0.3.0 → 0.3.1

package/dist/extension/manifest.json

@@ -1,7 +1,7 @@
 {
 	"manifest_version": 3,
 	"name": "Argus CDP Bridge",
-	"version": "0.1.0",
+	"version": "0.1.1",
 	"description": "Bridge CDP access for Argus without --remote-debugging-port",
 	"permissions": ["cookies", "debugger", "tabs", "nativeMessaging", "storage"],
 	"host_permissions": ["<all_urls>"],

package/dist/skill/argus/SKILL.md

@@ -112,6 +112,8 @@ argus ext doctor --watcher "$WATCHER_ID"
 
 `--iframe auto` is a convenience heuristic and should fail closed when multiple iframes look equally plausible. Prefer `--iframe-url` or `--iframe-title` when correctness matters.
 
+Reload remains tab-scoped. A selected iframe stays selected while detached: commands wait up to 3s for recovery, then fail with `extension_frame_not_ready` instead of running on the host. `ext targets --tree` shows the missing selection as `pending`; use `ext select <id> --page` explicitly to work on the host.
+
 ---
 
 ## Inspect Loop
@@ -137,12 +139,15 @@ argus click app --selector "button.submit"
 argus click app --ref e5
 argus drag app --selector "canvas" --pos 320,240 --by 80,-30
 argus fill app --selector "#email" "user@example.com"
+argus fill app --selector "#email" --value "user@example.com"
 argus keydown app --key Enter
 argus keydown app --key G
 argus keydown app --code KeyG --print-event
 argus scroll-to app --selector "#footer"
 ```
 
+For generated commands, `argus eval app --expression "document.title"` is equivalent to the positional expression form.
+
 For iframe-active extension watchers, commands run against the selected iframe target. Screenshots, recordings, selectors, and eval are resolved relative to that iframe.
 Network mocks default to the top-level page; pass `--scope selected` (or `--frame selected`) to intercept requests from the selected iframe.
 
@@ -177,6 +182,8 @@ Keep these commands in the background in agent shells. See [START.md](./referenc
 
 **No extension-control watcher** — First time? Run `argus extension install`. Otherwise open/reload the extension, then run `argus ext doctor --json`.
 
+**Debugger attach rejected** — Popup and CLI return Chrome's original error; the failed session is cleaned up. Release the conflicting debugger and retry. `ext doctor --watcher <id>` checks actual target attachment/readiness separately from native bridge connectivity.
+
 **Multiple tabs matched** — Use `argus ext tabs --url <url> --json`, choose a `tabId`, then pass `--tab <tabId>`.
 
 **Iframe not found** — `argus ext show <id>`, `argus reload <id>`, wait for iframes, then `argus ext targets <id> --tree`.

package/dist/skill/argus/reference/EXTENSION.md

@@ -34,6 +34,14 @@ argus logs extension
 argus eval extension "document.title"
 ```
 
+Attachment failures surface Chrome's original error in both popup and CLI; no successful attachment is reported and the failed tab bridge is removed. A connected control bridge does not mean a tab is attached: `argus ext doctor --watcher <id>` flags detached, disconnected, or pending selected targets.
+
+### Iframe Recovery
+
+`argus reload <id>` reloads the whole tab. A requested iframe remains selected while missing or booting; eval, DOM, and capture wait up to 3s for readiness, then fail with `extension_frame_not_ready`. They never fall back to the host page. Recovery requires a unique URL/hint match; `ext targets <id> --tree` keeps a `pending` placeholder visible (`attached: true` denotes selection, `targetReady: false` denotes pending readiness in JSON).
+
+Retry once the iframe loads, or explicitly select the host with `argus ext select <id> --page`. Use `argus ext doctor --watcher <id>` to distinguish target readiness from bridge health.
+
 ### Limitations
 
 - Debugging bar can't be hidden (Chrome security)

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vforsh/argus",
-	"version": "0.3.0",
+	"version": "0.3.1",
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/vforsh/argus.git",
@@ -29,7 +29,7 @@
 		"@vforsh/argus-client": "^0.3.0",
 		"@vforsh/argus-core": "^0.3.0",
 		"@vforsh/argus-plugin-api": "^0.3.0",
-		"@vforsh/argus-watcher": "^0.3.0",
+		"@vforsh/argus-watcher": "^0.3.1",
 		"commander": "14.0.2",
 		"esbuild": "0.25.12",
 		"prettier": "3.7.4"