stably 4.12.2 → 4.12.4

package/dist/stably-plugin-cli/skills/{playwright-cli → stably-browser}/references/request-mocking.md

@@ -6,23 +6,23 @@ Intercept, mock, modify, and block network requests.
 
 ```bash
 # Mock with custom status
-playwright-cli route "**/*.jpg" --status=404
+stably-browser route "**/*.jpg" --status=404
 
 # Mock with JSON body
-playwright-cli route "**/api/users" --body='[{"id":1,"name":"Alice"}]' --content-type=application/json
+stably-browser route "**/api/users" --body='[{"id":1,"name":"Alice"}]' --content-type=application/json
 
 # Mock with custom headers
-playwright-cli route "**/api/data" --body='{"ok":true}' --header="X-Custom: value"
+stably-browser route "**/api/data" --body='{"ok":true}' --header="X-Custom: value"
 
 # Remove headers from requests
-playwright-cli route "**/*" --remove-header=cookie,authorization
+stably-browser route "**/*" --remove-header=cookie,authorization
 
 # List active routes
-playwright-cli route-list
+stably-browser route-list
 
 # Remove a route or all routes
-playwright-cli unroute "**/*.jpg"
-playwright-cli unroute
+stably-browser unroute "**/*.jpg"
+stably-browser unroute
 ```
 
 ## URL Patterns
@@ -41,7 +41,7 @@ For conditional responses, request body inspection, response modification, or de
 ### Conditional Response Based on Request
 
 ```bash
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   await page.route('**/api/login', route => {
     const body = route.request().postDataJSON();
     if (body.username === 'admin') {
@@ -56,7 +56,7 @@ playwright-cli run-code "async page => {
 ### Modify Real Response
 
 ```bash
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   await page.route('**/api/user', async route => {
     const response = await route.fetch();
     const json = await response.json();
@@ -69,7 +69,7 @@ playwright-cli run-code "async page => {
 ### Simulate Network Failures
 
 ```bash
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   await page.route('**/api/offline', route => route.abort('internetdisconnected'));
 }"
 # Options: connectionrefused, timedout, connectionreset, internetdisconnected
@@ -78,7 +78,7 @@ playwright-cli run-code "async page => {
 ### Delayed Response
 
 ```bash
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   await page.route('**/api/slow', async route => {
     await new Promise(r => setTimeout(r, 3000));
     route.fulfill({ body: JSON.stringify({ data: 'loaded' }) });

package/dist/stably-plugin-cli/skills/{playwright-cli → stably-browser}/references/running-code.md

@@ -5,7 +5,7 @@ Use `run-code` to execute arbitrary Playwright code for advanced scenarios not c
 ## Syntax
 
 ```bash
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   // Your Playwright code here
   // Access page.context() for browser context operations
 }"
@@ -15,19 +15,19 @@ playwright-cli run-code "async page => {
 
 ```bash
 # Grant geolocation permission and set location
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   await page.context().grantPermissions(['geolocation']);
   await page.context().setGeolocation({ latitude: 37.7749, longitude: -122.4194 });
 }"
 
 # Set location to London
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   await page.context().grantPermissions(['geolocation']);
   await page.context().setGeolocation({ latitude: 51.5074, longitude: -0.1278 });
 }"
 
 # Clear geolocation override
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   await page.context().clearPermissions();
 }"
 ```
@@ -36,7 +36,7 @@ playwright-cli run-code "async page => {
 
 ```bash
 # Grant multiple permissions
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   await page.context().grantPermissions([
     'geolocation',
     'notifications',
@@ -46,7 +46,7 @@ playwright-cli run-code "async page => {
 }"
 
 # Grant permissions for specific origin
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   await page.context().grantPermissions(['clipboard-read'], {
     origin: 'https://example.com'
   });
@@ -57,22 +57,22 @@ playwright-cli run-code "async page => {
 
 ```bash
 # Emulate dark color scheme
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   await page.emulateMedia({ colorScheme: 'dark' });
 }"
 
 # Emulate light color scheme
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   await page.emulateMedia({ colorScheme: 'light' });
 }"
 
 # Emulate reduced motion
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   await page.emulateMedia({ reducedMotion: 'reduce' });
 }"
 
 # Emulate print media
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   await page.emulateMedia({ media: 'print' });
 }"
 ```
@@ -81,22 +81,22 @@ playwright-cli run-code "async page => {
 
 ```bash
 # Wait for network idle
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   await page.waitForLoadState('networkidle');
 }"
 
 # Wait for specific element
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   await page.waitForSelector('.loading', { state: 'hidden' });
 }"
 
 # Wait for function to return true
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   await page.waitForFunction(() => window.appReady === true);
 }"
 
 # Wait with timeout
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   await page.waitForSelector('.result', { timeout: 10000 });
 }"
 ```
@@ -105,13 +105,13 @@ playwright-cli run-code "async page => {
 
 ```bash
 # Work with iframe
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   const frame = page.locator('iframe#my-iframe').contentFrame();
   await frame.locator('button').click();
 }"
 
 # Get all frames
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   const frames = page.frames();
   return frames.map(f => f.url());
 }"
@@ -121,7 +121,7 @@ playwright-cli run-code "async page => {
 
 ```bash
 # Handle file download
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   const [download] = await Promise.all([
     page.waitForEvent('download'),
     page.click('a.download-link')
@@ -135,13 +135,13 @@ playwright-cli run-code "async page => {
 
 ```bash
 # Read clipboard (requires permission)
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   await page.context().grantPermissions(['clipboard-read']);
   return await page.evaluate(() => navigator.clipboard.readText());
 }"
 
 # Write to clipboard
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   await page.evaluate(text => navigator.clipboard.writeText(text), 'Hello clipboard!');
 }"
 ```
@@ -150,22 +150,22 @@ playwright-cli run-code "async page => {
 
 ```bash
 # Get page title
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   return await page.title();
 }"
 
 # Get current URL
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   return page.url();
 }"
 
 # Get page content
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   return await page.content();
 }"
 
 # Get viewport size
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   return page.viewportSize();
 }"
 ```
@@ -174,7 +174,7 @@ playwright-cli run-code "async page => {
 
 ```bash
 # Execute JavaScript and return result
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   return await page.evaluate(() => {
     return {
       userAgent: navigator.userAgent,
@@ -185,7 +185,7 @@ playwright-cli run-code "async page => {
 }"
 
 # Pass arguments to evaluate
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   const multiplier = 5;
   return await page.evaluate(m => document.querySelectorAll('li').length * m, multiplier);
 }"
@@ -195,7 +195,7 @@ playwright-cli run-code "async page => {
 
 ```bash
 # Try-catch in run-code
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   try {
     await page.click('.maybe-missing', { timeout: 1000 });
     return 'clicked';
@@ -209,7 +209,7 @@ playwright-cli run-code "async page => {
 
 ```bash
 # Login and save state
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   await page.goto('https://example.com/login');
   await page.fill('input[name=email]', 'user@example.com');
   await page.fill('input[name=password]', 'secret');
@@ -220,7 +220,7 @@ playwright-cli run-code "async page => {
 }"
 
 # Scrape data from multiple pages
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   const results = [];
   for (let i = 1; i <= 3; i++) {
     await page.goto(\`https://example.com/page/\${i}\`);

package/dist/stably-plugin-cli/skills/{playwright-cli → stably-browser}/references/session-management.md

@@ -8,14 +8,14 @@ Use `-s` flag to isolate browser contexts:
 
 ```bash
 # Browser 1: Authentication flow
-playwright-cli -s=auth open https://app.example.com/login
+stably-browser -s=auth open https://app.example.com/login
 
 # Browser 2: Public browsing (separate cookies, storage)
-playwright-cli -s=public open https://example.com
+stably-browser -s=public open https://example.com
 
 # Commands are isolated by browser session
-playwright-cli -s=auth fill e1 "user@example.com"
-playwright-cli -s=public snapshot
+stably-browser -s=auth fill e1 "user@example.com"
+stably-browser -s=public snapshot
 ```
 
 ## Browser Session Isolation Properties
@@ -32,21 +32,21 @@ Each browser session has independent:
 
 ```bash
 # List all browser sessions
-playwright-cli list
+stably-browser list
 
 # Stop a browser session (close the browser)
-playwright-cli close                # stop the default browser
-playwright-cli -s=mysession close   # stop a named browser
+stably-browser close                # stop the default browser
+stably-browser -s=mysession close   # stop a named browser
 
 # Stop all browser sessions
-playwright-cli close-all
+stably-browser close-all
 
 # Forcefully kill all daemon processes (for stale/zombie processes)
-playwright-cli kill-all
+stably-browser kill-all
 
 # Delete browser session user data (profile directory)
-playwright-cli delete-data                # delete default browser data
-playwright-cli -s=mysession delete-data   # delete named browser data
+stably-browser delete-data                # delete default browser data
+stably-browser -s=mysession delete-data   # delete named browser data
 ```
 
 ## Environment Variable
@@ -55,7 +55,7 @@ Set a default browser session name via environment variable:
 
 ```bash
 export PLAYWRIGHT_CLI_SESSION="mysession"
-playwright-cli open example.com  # Uses "mysession" automatically
+stably-browser open example.com  # Uses "mysession" automatically
 ```
 
 ## Common Patterns
@@ -67,30 +67,30 @@ playwright-cli open example.com  # Uses "mysession" automatically
 # Scrape multiple sites concurrently
 
 # Start all browsers
-playwright-cli -s=site1 open https://site1.com &
-playwright-cli -s=site2 open https://site2.com &
-playwright-cli -s=site3 open https://site3.com &
+stably-browser -s=site1 open https://site1.com &
+stably-browser -s=site2 open https://site2.com &
+stably-browser -s=site3 open https://site3.com &
 wait
 
 # Take snapshots from each
-playwright-cli -s=site1 snapshot
-playwright-cli -s=site2 snapshot
-playwright-cli -s=site3 snapshot
+stably-browser -s=site1 snapshot
+stably-browser -s=site2 snapshot
+stably-browser -s=site3 snapshot
 
 # Cleanup
-playwright-cli close-all
+stably-browser close-all
 ```
 
 ### A/B Testing Sessions
 
 ```bash
 # Test different user experiences
-playwright-cli -s=variant-a open "https://app.com?variant=a"
-playwright-cli -s=variant-b open "https://app.com?variant=b"
+stably-browser -s=variant-a open "https://app.com?variant=a"
+stably-browser -s=variant-b open "https://app.com?variant=b"
 
 # Compare
-playwright-cli -s=variant-a screenshot
-playwright-cli -s=variant-b screenshot
+stably-browser -s=variant-a screenshot
+stably-browser -s=variant-b screenshot
 ```
 
 ### Persistent Profile
@@ -99,10 +99,10 @@ By default, browser profile is kept in memory only. Use `--persistent` flag on `
 
 ```bash
 # Use persistent profile (auto-generated location)
-playwright-cli open https://example.com --persistent
+stably-browser open https://example.com --persistent
 
 # Use persistent profile with custom directory
-playwright-cli open https://example.com --profile=/path/to/profile
+stably-browser open https://example.com --profile=/path/to/profile
 ```
 
 ## Default Browser Session
@@ -111,9 +111,9 @@ When `-s` is omitted, commands use the default browser session:
 
 ```bash
 # These use the same default browser session
-playwright-cli open https://example.com
-playwright-cli snapshot
-playwright-cli close  # Stops default browser
+stably-browser open https://example.com
+stably-browser snapshot
+stably-browser close  # Stops default browser
 ```
 
 ## Browser Session Configuration
@@ -122,16 +122,16 @@ Configure a browser session with specific settings when opening:
 
 ```bash
 # Open with config file
-playwright-cli open https://example.com --config=.playwright/my-cli.json
+stably-browser open https://example.com --config=.playwright/my-cli.json
 
 # Open with specific browser
-playwright-cli open https://example.com --browser=firefox
+stably-browser open https://example.com --browser=firefox
 
 # Open in headed mode
-playwright-cli open https://example.com --headed
+stably-browser open https://example.com --headed
 
 # Open with persistent profile
-playwright-cli open https://example.com --persistent
+stably-browser open https://example.com --persistent
 ```
 
 ## Best Practices
@@ -140,30 +140,30 @@ playwright-cli open https://example.com --persistent
 
 ```bash
 # GOOD: Clear purpose
-playwright-cli -s=github-auth open https://github.com
-playwright-cli -s=docs-scrape open https://docs.example.com
+stably-browser -s=github-auth open https://github.com
+stably-browser -s=docs-scrape open https://docs.example.com
 
 # AVOID: Generic names
-playwright-cli -s=s1 open https://github.com
+stably-browser -s=s1 open https://github.com
 ```
 
 ### 2. Always Clean Up
 
 ```bash
 # Stop browsers when done
-playwright-cli -s=auth close
-playwright-cli -s=scrape close
+stably-browser -s=auth close
+stably-browser -s=scrape close
 
 # Or stop all at once
-playwright-cli close-all
+stably-browser close-all
 
 # If browsers become unresponsive or zombie processes remain
-playwright-cli kill-all
+stably-browser kill-all
 ```
 
 ### 3. Delete Stale Browser Data
 
 ```bash
 # Remove old browser data to free disk space
-playwright-cli -s=oldsession delete-data
+stably-browser -s=oldsession delete-data
 ```