@stacksjs/defaults 0.75.302 → 0.75.307

package/ai/skills/stacks-browse/SKILL.md

@@ -28,7 +28,7 @@ The driver finds a browser at runtime in this order, and falls through to the ne
 won't launch:
 
 1. `$BROWSE_BROWSER` (explicit override — set to an absolute browser path)
-2. PATH: `chromium`, `google-chrome`, `brave-browser`, `microsoft-edge`, …
+2. PATH: `google-chrome-stable`, `google-chrome`, `chromium`, `chromium-browser`, `brave-browser`, `microsoft-edge`, …
 3. macOS app bundles (Google Chrome, Chromium, Brave, Edge)
 4. A Chromium binary already cached on disk (e.g. under `~/Library/Caches/ms-playwright`) —
    the **binary only** is borrowed; Playwright is never imported.
@@ -121,6 +121,10 @@ bun storage/framework/defaults/ai/skills/stacks-browse/scripts/browse.ts scenari
 Steps run in order within one isolated browser page, preserving reactive STX state and SPA navigation. Supported actions are `click`, `fill`, `focus`, `press`, `wait`, `evaluate`, and `assert`. Each step is a JSON object passed through a repeatable `--step` flag. Click and focus steps may include `text` to select the matching control from their CSS selector. They scroll matched controls into view before interacting, including controls inside horizontal overflow regions. Evaluate steps run a JavaScript expression in the isolated page and return its serialized value, which is useful for inspecting STX signals and DevTools state between interactions. The command reports every completed step, the final URL and page text, console messages, console exceptions, failed requests, and an optional screenshot. It exits nonzero when the scenario assertion, evaluation, browser console, or network fails.
 On a failed step, execution stops and the report retains its number and error,
 the completed steps, final page state and requested screenshot.
+If final page or screenshot collection fails, the report keeps the completed
+steps and available console/network observations, sets the missing result to
+`null`, and records its phase and error in `collectionErrors`. The command still
+exits nonzero. A missing capture does not qualify an older raster as evidence.
 Use `{"action":"assert","selector":"...","absent":true}` to verify that an element is missing or hidden after an interaction.
 Use `{"action":"assert","selector":"button","text":"Save","focused":true}` to verify keyboard focus and focus restoration.
 `press` sends native virtual key codes for Enter, Escape, Tab, the arrow keys,

package/ai/skills/stacks-browse/scripts/browse.ts

@@ -45,7 +45,9 @@ function collectCandidates(): string[] {
   if (process.env.BROWSE_BROWSER)
     add(process.env.BROWSE_BROWSER)
 
-  for (const bin of ['chromium', 'chromium-browser', 'google-chrome-stable', 'google-chrome', 'brave-browser', 'microsoft-edge', 'chrome'])
+  // Some distribution Chromium launchers answer --version but cannot open a
+  // DevTools target. Prefer an installed Chrome before spending their bounds.
+  for (const bin of ['google-chrome-stable', 'google-chrome', 'chromium', 'chromium-browser', 'brave-browser', 'microsoft-edge', 'chrome'])
     add(which(bin))
 
   for (const p of [
@@ -1001,8 +1003,11 @@ async function main() {
           await Bun.sleep(step.settle ?? 250)
       }
 
-      const finalState = await cdp.send('Runtime.evaluate', {
-        expression: `({
+      const collectionErrors: { phase: string, error: string }[] = []
+      let finalState: unknown = null
+      try {
+        const collected = await cdp.send('Runtime.evaluate', {
+          expression: `({
           url: location.href,
           title: document.title,
           focusHistory: window.__browseFocusHistory || [],
@@ -1016,26 +1021,38 @@ async function main() {
           } : null,
           bodyText: (document.body.innerText || '').replace(/\\s+/g, ' ').trim().slice(0, 500),
         })`,
-        returnByValue: true,
-      })
+          returnByValue: true,
+        })
+        finalState = collected.result?.value ?? null
+      }
+      catch (error) {
+        collectionErrors.push({ phase: 'final-state', error: error instanceof Error ? error.message : String(error) })
+      }
       let screenshot: string | null = null
       if (typeof flags.out === 'string') {
-        screenshot = flags.out
-        mkdirSync(screenshot.split('/').slice(0, -1).join('/') || '.', { recursive: true })
-        await Bun.write(screenshot, await captureScreenshot(cdp, { full: !!flags.full }))
+        try {
+          const output = flags.out
+          mkdirSync(output.split('/').slice(0, -1).join('/') || '.', { recursive: true })
+          await Bun.write(output, await captureScreenshot(cdp, { full: !!flags.full }))
+          screenshot = output
+        }
+        catch (error) {
+          collectionErrors.push({ phase: 'screenshot', error: error instanceof Error ? error.message : String(error) })
+        }
       }
       const failedRequests = state.responses.filter(response => response.status >= 400)
       console.log(JSON.stringify({
         url,
         viewport: `${viewport.w}x${viewport.h}`,
         steps: results,
-        final: finalState.result?.value,
+        final: finalState,
         screenshot,
+        collectionErrors,
         consoleMessages: state.console,
         consoleErrors: state.consoleErrors,
         failedRequests,
       }, null, 2))
-      if (scenarioFailed || state.consoleErrors.length || failedRequests.length)
+      if (scenarioFailed || collectionErrors.length || state.consoleErrors.length || failedRequests.length)
         process.exitCode = 1
       state.dispose()
       cdp.close()

package/ide/vscode/package.json

@@ -2,7 +2,7 @@
   "publisher": "Stacks",
   "name": "vscode-stacks",
   "displayName": "Stacks",
-  "version": "0.75.302",
+  "version": "0.75.307",
   "description": "Stacks, built into VS Code: stx templates, pickier linting and formatting, encrypted env files, the dev server preview and every buddy command. No other extensions required.",
   "license": "MIT",
   "funding": "https://github.com/sponsors/chrisbbreuer",

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/defaults",
   "type": "module",
   "sideEffects": false,
-  "version": "0.75.302",
+  "version": "0.75.307",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/stacksjs/stacks.git",
@@ -45,9 +45,9 @@
   "dependencies": {
     "@iconify-json/f7": "^1.2.2",
     "@iconify-json/hugeicons": "^1.2.35",
-    "@stacksjs/mobile": "0.75.302",
-    "@stacksjs/sanitizer": "0.2.687",
-    "@stacksjs/stx": "0.2.687",
+    "@stacksjs/mobile": "0.75.307",
+    "@stacksjs/sanitizer": "0.2.691",
+    "@stacksjs/stx": "0.2.691",
     "@xterm/addon-fit": "^0.11.0",
     "@xterm/xterm": "^6.0.0",
     "ts-qr-codes": "^0.1.8"