stably 4.12.3 → 4.12.4

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
 ```

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

@@ -10,20 +10,20 @@ Save and restore complete browser state including cookies and storage.
 
 ```bash
 # Save to auto-generated filename (storage-state-{timestamp}.json)
-playwright-cli state-save
+stably-browser state-save
 
 # Save to specific filename
-playwright-cli state-save my-auth-state.json
+stably-browser state-save my-auth-state.json
 ```
 
 ### Restore Storage State
 
 ```bash
 # Load storage state from file
-playwright-cli state-load my-auth-state.json
+stably-browser state-load my-auth-state.json
 
 # Reload page to apply cookies
-playwright-cli open https://example.com
+stably-browser open https://example.com
 ```
 
 ### Storage State File Format
@@ -61,50 +61,50 @@ The saved file contains:
 ### List All Cookies
 
 ```bash
-playwright-cli cookie-list
+stably-browser cookie-list
 ```
 
 ### Filter Cookies by Domain
 
 ```bash
-playwright-cli cookie-list --domain=example.com
+stably-browser cookie-list --domain=example.com
 ```
 
 ### Filter Cookies by Path
 
 ```bash
-playwright-cli cookie-list --path=/api
+stably-browser cookie-list --path=/api
 ```
 
 ### Get Specific Cookie
 
 ```bash
-playwright-cli cookie-get session_id
+stably-browser cookie-get session_id
 ```
 
 ### Set a Cookie
 
 ```bash
 # Basic cookie
-playwright-cli cookie-set session abc123
+stably-browser cookie-set session abc123
 
 # Cookie with options
-playwright-cli cookie-set session abc123 --domain=example.com --path=/ --httpOnly --secure --sameSite=Lax
+stably-browser cookie-set session abc123 --domain=example.com --path=/ --httpOnly --secure --sameSite=Lax
 
 # Cookie with expiration (Unix timestamp)
-playwright-cli cookie-set remember_me token123 --expires=1735689600
+stably-browser cookie-set remember_me token123 --expires=1735689600
 ```
 
 ### Delete a Cookie
 
 ```bash
-playwright-cli cookie-delete session_id
+stably-browser cookie-delete session_id
 ```
 
 ### Clear All Cookies
 
 ```bash
-playwright-cli cookie-clear
+stably-browser cookie-clear
 ```
 
 ### Advanced: Multiple Cookies or Custom Options
@@ -112,7 +112,7 @@ playwright-cli cookie-clear
 For complex scenarios like adding multiple cookies at once, use `run-code`:
 
 ```bash
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   await page.context().addCookies([
     { name: 'session_id', value: 'sess_abc123', domain: 'example.com', path: '/', httpOnly: true },
     { name: 'preferences', value: JSON.stringify({ theme: 'dark' }), domain: 'example.com', path: '/' }
@@ -125,37 +125,37 @@ playwright-cli run-code "async page => {
 ### List All localStorage Items
 
 ```bash
-playwright-cli localstorage-list
+stably-browser localstorage-list
 ```
 
 ### Get Single Value
 
 ```bash
-playwright-cli localstorage-get token
+stably-browser localstorage-get token
 ```
 
 ### Set Value
 
 ```bash
-playwright-cli localstorage-set theme dark
+stably-browser localstorage-set theme dark
 ```
 
 ### Set JSON Value
 
 ```bash
-playwright-cli localstorage-set user_settings '{"theme":"dark","language":"en"}'
+stably-browser localstorage-set user_settings '{"theme":"dark","language":"en"}'
 ```
 
 ### Delete Single Item
 
 ```bash
-playwright-cli localstorage-delete token
+stably-browser localstorage-delete token
 ```
 
 ### Clear All localStorage
 
 ```bash
-playwright-cli localstorage-clear
+stably-browser localstorage-clear
 ```
 
 ### Advanced: Multiple Operations
@@ -163,7 +163,7 @@ playwright-cli localstorage-clear
 For complex scenarios like setting multiple values at once, use `run-code`:
 
 ```bash
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   await page.evaluate(() => {
     localStorage.setItem('token', 'jwt_abc123');
     localStorage.setItem('user_id', '12345');
@@ -177,31 +177,31 @@ playwright-cli run-code "async page => {
 ### List All sessionStorage Items
 
 ```bash
-playwright-cli sessionstorage-list
+stably-browser sessionstorage-list
 ```
 
 ### Get Single Value
 
 ```bash
-playwright-cli sessionstorage-get form_data
+stably-browser sessionstorage-get form_data
 ```
 
 ### Set Value
 
 ```bash
-playwright-cli sessionstorage-set step 3
+stably-browser sessionstorage-set step 3
 ```
 
 ### Delete Single Item
 
 ```bash
-playwright-cli sessionstorage-delete step
+stably-browser sessionstorage-delete step
 ```
 
 ### Clear sessionStorage
 
 ```bash
-playwright-cli sessionstorage-clear
+stably-browser sessionstorage-clear
 ```
 
 ## IndexedDB
@@ -209,7 +209,7 @@ playwright-cli sessionstorage-clear
 ### List Databases
 
 ```bash
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   return await page.evaluate(async () => {
     const databases = await indexedDB.databases();
     return databases;
@@ -220,7 +220,7 @@ playwright-cli run-code "async page => {
 ### Delete Database
 
 ```bash
-playwright-cli run-code "async page => {
+stably-browser run-code "async page => {
   await page.evaluate(() => {
     indexedDB.deleteDatabase('myDatabase');
   });
@@ -233,18 +233,18 @@ playwright-cli run-code "async page => {
 
 ```bash
 # Step 1: Login and save state
-playwright-cli open https://app.example.com/login
-playwright-cli snapshot
-playwright-cli fill e1 "user@example.com"
-playwright-cli fill e2 "password123"
-playwright-cli click e3
+stably-browser open https://app.example.com/login
+stably-browser snapshot
+stably-browser fill e1 "user@example.com"
+stably-browser fill e2 "password123"
+stably-browser click e3
 
 # Save the authenticated state
-playwright-cli state-save auth.json
+stably-browser state-save auth.json
 
 # Step 2: Later, restore state and skip login
-playwright-cli state-load auth.json
-playwright-cli open https://app.example.com/dashboard
+stably-browser state-load auth.json
+stably-browser open https://app.example.com/dashboard
 # Already logged in!
 ```
 
@@ -252,17 +252,17 @@ playwright-cli open https://app.example.com/dashboard
 
 ```bash
 # Set up authentication state
-playwright-cli open https://example.com
-playwright-cli eval "() => { document.cookie = 'session=abc123'; localStorage.setItem('user', 'john'); }"
+stably-browser open https://example.com
+stably-browser eval "() => { document.cookie = 'session=abc123'; localStorage.setItem('user', 'john'); }"
 
 # Save state to file
-playwright-cli state-save my-session.json
+stably-browser state-save my-session.json
 
 # ... later, in a new session ...
 
 # Restore state
-playwright-cli state-load my-session.json
-playwright-cli open https://example.com
+stably-browser state-load my-session.json
+stably-browser open https://example.com
 # Cookies and localStorage are restored!
 ```