td-ai-tools 1.0.3 → 1.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "td-ai-tools",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Install agent skills and packs into your project",
   "scripts": {
     "smoke:install": "./scripts/smoke-install.sh"
@@ -18,6 +18,12 @@
   "engines": {
     "node": ">=16"
   },
-  "keywords": ["claude", "agents", "skills", "shopify", "theory-digital"],
+  "keywords": [
+    "claude",
+    "agents",
+    "skills",
+    "shopify",
+    "theory-digital"
+  ],
   "license": "MIT"
 }

package/skills/forge-cli/SKILL.md

@@ -0,0 +1,84 @@
+---
+name: forge-cli
+description: Manage Laravel Forge servers, sites, and provisioned resources from the terminal with the Laravel Forge CLI. Use when the user wants to inspect Forge state, switch active servers, deploy sites, update environment variables, view logs, run remote commands, use Tinker, or manage services like PHP, Nginx, daemons, and databases.
+---
+
+# Laravel Forge CLI
+
+## Core Workflow
+
+1. Start with `forge` to confirm the CLI is installed and to inspect available commands.
+2. Check the active server before making changes:
+
+```bash
+forge server:current
+forge server:list
+forge server:switch staging
+```
+
+3. If the task needs SSH access, verify connectivity first:
+
+```bash
+forge ssh:test
+forge ssh:configure --key=/path/to/public/key.pub --name=workstation-name
+```
+
+4. Run the smallest command that answers the question or performs the requested change.
+5. After environment changes, note that cached Laravel config or queue workers may require a fresh deployment before the new values take effect.
+
+## Common Tasks
+
+### Sites and Deployments
+
+```bash
+forge site:list
+forge deploy
+forge deploy example.com
+forge deploy:logs
+forge deploy:logs 12345
+```
+
+### Environment Variables
+
+Pull, edit locally, then push back:
+
+```bash
+forge env:pull
+forge env:pull example.com .env
+forge env:push
+forge env:push example.com .env
+```
+
+### Logs, Commands, and Tinker
+
+```bash
+forge site:logs
+forge site:logs example.com --follow
+forge command example.com --command="php artisan about"
+forge tinker example.com
+```
+
+### SSH and Resource Access
+
+```bash
+forge ssh
+forge ssh server-name
+forge database:status
+forge database:logs
+forge database:shell my-database-name --user=my-user
+forge php:status 8.5
+forge php:restart 8.5
+forge nginx:logs access
+forge daemon:restart
+```
+
+## Decision Guide
+
+- Need server context first: use `server:current`, `server:list`, or `server:switch`.
+- Need site-level work: use `site:list`, `deploy`, `env:*`, `site:logs`, `command`, or `tinker`.
+- Need service health or maintenance: use `{resource}:status`, `{resource}:logs`, `{resource}:restart`, or `{resource}:shell`.
+- Need a secure shell on the box: confirm `ssh:test`, then use `forge ssh`.
+
+## Reference
+
+Read [references/command-reference.md](references/command-reference.md) when you need the fuller command set, examples, or reminders about how the active server affects command behavior.

package/skills/forge-cli/references/command-reference.md

@@ -0,0 +1,176 @@
+# Forge CLI Command Reference
+
+This reference condenses the official Laravel Forge CLI documentation into the commands most likely to come up during support and operations work.
+
+## Installation and Authentication
+
+Requirements:
+
+- PHP 8.0 or newer
+- Composer available on the machine
+
+Install:
+
+```bash
+composer global require laravel/forge-cli
+```
+
+Basic checks:
+
+```bash
+forge
+```
+
+Authenticate:
+
+```bash
+forge login
+forge login --token=your-api-token
+```
+
+CI authentication:
+
+```bash
+export FORGE_API_TOKEN=your-api-token
+```
+
+## Active Server Model
+
+Most Forge CLI commands run against the current active server. Check or change it before acting:
+
+```bash
+forge server:current
+forge server:list
+forge server:switch
+forge server:switch production
+```
+
+Use this first when a task is ambiguous or when multiple Forge servers exist.
+
+## SSH Setup
+
+Validate or configure SSH access for the `forge` user:
+
+```bash
+forge ssh:test
+forge ssh:configure
+forge ssh:configure --key=/path/to/public/key.pub --name=laptop-key
+forge ssh
+forge ssh server-name
+```
+
+## Sites
+
+List sites on the active server:
+
+```bash
+forge site:list
+```
+
+Deploy a site:
+
+```bash
+forge deploy
+forge deploy example.com
+```
+
+Review deployment output:
+
+```bash
+forge deploy:logs
+forge deploy:logs 12345
+```
+
+Manage environment variables:
+
+```bash
+forge env:pull
+forge env:pull example.com
+forge env:pull example.com .env
+
+forge env:push
+forge env:push example.com
+forge env:push example.com .env
+```
+
+If the application uses Laravel config caching or queue workers, push alone is not enough. Redeploy so the new variables are actually loaded.
+
+View application logs:
+
+```bash
+forge site:logs
+forge site:logs --follow
+forge site:logs example.com
+forge site:logs example.com --follow
+```
+
+Run commands relative to the site's root:
+
+```bash
+forge command
+forge command example.com
+forge command example.com --command="php artisan migrate --force"
+```
+
+Open Tinker on a remote Laravel app:
+
+```bash
+forge tinker
+forge tinker example.com
+```
+
+## Resources
+
+Forge exposes service-oriented commands with the pattern `{resource}:status`, `{resource}:logs`, `{resource}:restart`, and sometimes `{resource}:shell`.
+
+### Status
+
+```bash
+forge daemon:status
+forge database:status
+forge nginx:status
+forge php:status
+forge php:status 8.5
+```
+
+### Logs
+
+```bash
+forge daemon:logs
+forge daemon:logs --follow
+forge database:logs
+forge nginx:logs
+forge nginx:logs access
+forge php:logs
+forge php:logs 8.5
+```
+
+### Restart
+
+```bash
+forge daemon:restart
+forge database:restart
+forge nginx:restart
+forge php:restart
+forge php:restart 8.5
+```
+
+### Local Shell Access to Resources
+
+```bash
+forge database:shell
+forge database:shell my-database-name
+forge database:shell my-database-name --user=my-user
+```
+
+## Practical Usage Notes
+
+- Prefer read-only commands first when the request is exploratory.
+- Confirm the active server before running deploys, restarts, or environment pushes.
+- Use explicit site names when there is any chance of ambiguity.
+- Use `--follow` only when the user wants a live log tail.
+- When sharing results back to the user, report the exact command run and whether it changed state.
+
+## Source
+
+Official documentation: https://forge.laravel.com/docs/cli

package/skills/playwright-cli/CODEX-CONFIG.md

@@ -0,0 +1,79 @@
+# Codex sandbox config bootstrap
+
+This directory contains a template + generator that produces `<repo>/.codex/config.toml`
+on demand, so the file does not need to be committed with hardcoded paths tied to one
+machine or one project clone location.
+
+## Files
+
+- `config.toml.template` — the source of truth. Uses two placeholders:
+  - `__PROJECT_ROOT__` — replaced with the absolute path to the repo root
+  - `__CHROME_PATH__` — replaced with the absolute path to the Chrome/Chromium binary
+- `setup-codex.sh` — reads the template, substitutes the placeholders, writes
+  `<repo>/.codex/config.toml`.
+
+The generated `.codex/` directory is gitignored, so each clone gets its own copy.
+
+## Usage
+
+Run once after cloning the repo (or after moving the clone to a new path):
+
+```bash
+.agents/skills/playwright-cli/setup-codex.sh
+```
+
+The script prints the values it resolved, e.g.:
+
+```
+wrote /home/you/code/lio/.codex/config.toml
+  PROJECT_ROOT=/home/you/code/lio
+  CHROME_PATH=/usr/bin/google-chrome
+```
+
+Re-run it any time the template changes or you move the repo.
+
+## How paths are resolved
+
+**`PROJECT_ROOT`** — derived in this order:
+
+1. `git rev-parse --show-toplevel` from the script's directory (works for any clone
+   location, on any machine, regardless of username)
+2. Falls back to walking three directories up from the script
+   (`.agents/skills/playwright-cli` → repo root) if the repo isn't a git checkout
+
+**`CHROME_PATH`** — derived in this order:
+
+1. The `CHROME_PATH` environment variable, if set
+2. First match from `PATH` of: `google-chrome`, `google-chrome-stable`, `chromium`,
+   `chromium-browser`
+3. Falls back to `/usr/bin/google-chrome` with a warning if nothing is found
+
+Override the Chrome binary explicitly when needed:
+
+```bash
+CHROME_PATH=/opt/google/chrome/chrome .agents/skills/playwright-cli/setup-codex.sh
+```
+
+## Why a generator instead of variable expansion
+
+Codex CLI parses `config.toml` as static TOML and does not expand `~`, `$HOME`, or
+`${VAR}` in path values — they would be treated as literal strings. Generating the
+file at setup time is the simplest way to keep the template portable while still
+producing the absolute paths Codex expects at runtime.
+
+## What the generated config does
+
+The output `.codex/config.toml` configures Codex's sandbox so Playwright can run
+inside it:
+
+- `sandbox_workspace_write.writable_roots` — directories Playwright is allowed to
+  write to (browser cache, artifacts, test reports, daemon sockets)
+- `shell_environment_policy.set` — pins `PLAYWRIGHT_*`, `XDG_*`, and `TMPDIR`-family
+  env vars to repo-local paths so Playwright stores its browser, cache, and runtime
+  state under the project rather than the user's home directory
+
+## Editing
+
+Edit `config.toml.template` (not the generated file) and re-run `setup-codex.sh`.
+Changes to `.codex/config.toml` directly will be overwritten the next time the
+generator runs.

package/skills/playwright-cli/SKILL.md

@@ -0,0 +1,278 @@
+---
+name: playwright-cli
+description: Automates browser interactions for web testing, screenshots, and data extraction. Use when the user needs to navigate websites, interact with web pages, take screenshots, test web applications, or extract information from web pages.
+allowed-tools: Bash(playwright-cli:*)
+---
+
+# Browser Automation with playwright-cli
+
+## Quick start
+
+```bash
+# open new browser
+playwright-cli open
+# navigate to a page
+playwright-cli goto https://playwright.dev
+# interact with the page using refs from the snapshot
+playwright-cli click e15
+playwright-cli type "page.click"
+playwright-cli press Enter
+# take a screenshot (rarely used, as snapshot is more common)
+playwright-cli screenshot
+# close the browser
+playwright-cli close
+```
+
+## Commands
+
+### Core
+
+```bash
+playwright-cli open
+# open and navigate right away
+playwright-cli open https://example.com/
+playwright-cli goto https://playwright.dev
+playwright-cli type "search query"
+playwright-cli click e3
+playwright-cli dblclick e7
+playwright-cli fill e5 "user@example.com"
+playwright-cli drag e2 e8
+playwright-cli hover e4
+playwright-cli select e9 "option-value"
+playwright-cli upload ./document.pdf
+playwright-cli check e12
+playwright-cli uncheck e12
+playwright-cli snapshot
+playwright-cli snapshot --filename=after-click.yaml
+playwright-cli eval "document.title"
+playwright-cli eval "el => el.textContent" e5
+playwright-cli dialog-accept
+playwright-cli dialog-accept "confirmation text"
+playwright-cli dialog-dismiss
+playwright-cli resize 1920 1080
+playwright-cli close
+```
+
+### Navigation
+
+```bash
+playwright-cli go-back
+playwright-cli go-forward
+playwright-cli reload
+```
+
+### Keyboard
+
+```bash
+playwright-cli press Enter
+playwright-cli press ArrowDown
+playwright-cli keydown Shift
+playwright-cli keyup Shift
+```
+
+### Mouse
+
+```bash
+playwright-cli mousemove 150 300
+playwright-cli mousedown
+playwright-cli mousedown right
+playwright-cli mouseup
+playwright-cli mouseup right
+playwright-cli mousewheel 0 100
+```
+
+### Save as
+
+```bash
+playwright-cli screenshot
+playwright-cli screenshot e5
+playwright-cli screenshot --filename=page.png
+playwright-cli pdf --filename=page.pdf
+```
+
+### Tabs
+
+```bash
+playwright-cli tab-list
+playwright-cli tab-new
+playwright-cli tab-new https://example.com/page
+playwright-cli tab-close
+playwright-cli tab-close 2
+playwright-cli tab-select 0
+```
+
+### Storage
+
+```bash
+playwright-cli state-save
+playwright-cli state-save auth.json
+playwright-cli state-load auth.json
+
+# Cookies
+playwright-cli cookie-list
+playwright-cli cookie-list --domain=example.com
+playwright-cli cookie-get session_id
+playwright-cli cookie-set session_id abc123
+playwright-cli cookie-set session_id abc123 --domain=example.com --httpOnly --secure
+playwright-cli cookie-delete session_id
+playwright-cli cookie-clear
+
+# LocalStorage
+playwright-cli localstorage-list
+playwright-cli localstorage-get theme
+playwright-cli localstorage-set theme dark
+playwright-cli localstorage-delete theme
+playwright-cli localstorage-clear
+
+# SessionStorage
+playwright-cli sessionstorage-list
+playwright-cli sessionstorage-get step
+playwright-cli sessionstorage-set step 3
+playwright-cli sessionstorage-delete step
+playwright-cli sessionstorage-clear
+```
+
+### Network
+
+```bash
+playwright-cli route "**/*.jpg" --status=404
+playwright-cli route "https://api.example.com/**" --body='{"mock": true}'
+playwright-cli route-list
+playwright-cli unroute "**/*.jpg"
+playwright-cli unroute
+```
+
+### DevTools
+
+```bash
+playwright-cli console
+playwright-cli console warning
+playwright-cli network
+playwright-cli run-code "async page => await page.context().grantPermissions(['geolocation'])"
+playwright-cli tracing-start
+playwright-cli tracing-stop
+playwright-cli video-start
+playwright-cli video-stop video.webm
+```
+
+## Open parameters
+```bash
+# Use specific browser when creating session
+playwright-cli open --browser=chrome
+playwright-cli open --browser=firefox
+playwright-cli open --browser=webkit
+playwright-cli open --browser=msedge
+# Connect to browser via extension
+playwright-cli open --extension
+
+# Use persistent profile (by default profile is in-memory)
+playwright-cli open --persistent
+# Use persistent profile with custom directory
+playwright-cli open --profile=/path/to/profile
+
+# Start with config file
+playwright-cli open --config=my-config.json
+
+# Close the browser
+playwright-cli close
+# Delete user data for the default session
+playwright-cli delete-data
+```
+
+## Snapshots
+
+After each command, playwright-cli provides a snapshot of the current browser state.
+
+```bash
+> playwright-cli goto https://example.com
+### Page
+- Page URL: https://example.com/
+- Page Title: Example Domain
+### Snapshot
+[Snapshot](.playwright-cli/page-2026-02-14T19-22-42-679Z.yml)
+```
+
+You can also take a snapshot on demand using `playwright-cli snapshot` command.
+
+If `--filename` is not provided, a new snapshot file is created with a timestamp. Default to automatic file naming, use `--filename=` when artifact is a part of the workflow result.
+
+## Browser Sessions
+
+```bash
+# create new browser session named "mysession" with persistent profile
+playwright-cli -s=mysession open example.com --persistent
+# same with manually specified profile directory (use when requested explicitly)
+playwright-cli -s=mysession open example.com --profile=/path/to/profile
+playwright-cli -s=mysession click e6
+playwright-cli -s=mysession close  # stop a named browser
+playwright-cli -s=mysession delete-data  # delete user data for persistent session
+
+playwright-cli list
+# Close all browsers
+playwright-cli close-all
+# Forcefully kill all browser processes
+playwright-cli kill-all
+```
+
+## Local installation
+
+In some cases user might want to install playwright-cli locally. If running globally available `playwright-cli` binary fails, use `npx playwright-cli` to run the commands. For example:
+
+```bash
+npx playwright-cli open https://example.com
+npx playwright-cli click e1
+```
+
+## Example: Form submission
+
+```bash
+playwright-cli open https://example.com/form
+playwright-cli snapshot
+
+playwright-cli fill e1 "user@example.com"
+playwright-cli fill e2 "password123"
+playwright-cli click e3
+playwright-cli snapshot
+playwright-cli close
+```
+
+## Example: Multi-tab workflow
+
+```bash
+playwright-cli open https://example.com
+playwright-cli tab-new https://example.com/other
+playwright-cli tab-list
+playwright-cli tab-select 0
+playwright-cli snapshot
+playwright-cli close
+```
+
+## Example: Debugging with DevTools
+
+```bash
+playwright-cli open https://example.com
+playwright-cli click e4
+playwright-cli fill e7 "test"
+playwright-cli console
+playwright-cli network
+playwright-cli close
+```
+
+```bash
+playwright-cli open https://example.com
+playwright-cli tracing-start
+playwright-cli click e4
+playwright-cli fill e7 "test"
+playwright-cli tracing-stop
+playwright-cli close
+```
+
+## Specific tasks
+
+* **Request mocking** [references/request-mocking.md](references/request-mocking.md)
+* **Running Playwright code** [references/running-code.md](references/running-code.md)
+* **Browser session management** [references/session-management.md](references/session-management.md)
+* **Storage state (cookies, localStorage)** [references/storage-state.md](references/storage-state.md)
+* **Test generation** [references/test-generation.md](references/test-generation.md)
+* **Tracing** [references/tracing.md](references/tracing.md)
+* **Video recording** [references/video-recording.md](references/video-recording.md)

package/skills/playwright-cli/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+    display_name: 'Playwright CLI'
+    short_description: 'Browser management for web testing, screenshots, and data extraction.'
+    default_prompt: 'Use the playwright-cli to evaluate'

package/skills/playwright-cli/config.toml.template

@@ -0,0 +1,32 @@
+sandbox_mode = "workspace-write"
+
+[sandbox_workspace_write]
+network_access = true
+exclude_tmpdir_env_var = true
+exclude_slash_tmp = true
+writable_roots = [
+  "__PROJECT_ROOT__/.cache/codex-playwright",
+  "__PROJECT_ROOT__/.artifacts/playwright/ms-playwright",
+  "__PROJECT_ROOT__/.tmp/codex-playwright",
+  "__PROJECT_ROOT__/.playwright-cli",
+  "__PROJECT_ROOT__/test-results",
+  "__PROJECT_ROOT__/playwright-report",
+  "__PROJECT_ROOT__/blob-report",
+]
+
+[shell_environment_policy]
+inherit = "all"
+
+[shell_environment_policy.set]
+PLAYWRIGHT_BROWSERS_PATH = "__PROJECT_ROOT__/.artifacts/playwright/ms-playwright"
+PLAYWRIGHT_MCP_BROWSER = "chrome"
+PLAYWRIGHT_MCP_EXECUTABLE_PATH = "__CHROME_PATH__"
+PLAYWRIGHT_DAEMON_SOCKETS_DIR = "__PROJECT_ROOT__/.pw"
+BROWSER = "google-chrome"
+HOME = "__PROJECT_ROOT__/.tmp/codex-playwright/home"
+XDG_CONFIG_HOME = "__PROJECT_ROOT__/.tmp/codex-playwright/config"
+XDG_STATE_HOME = "__PROJECT_ROOT__/.tmp/codex-playwright/state"
+TMPDIR = "__PROJECT_ROOT__/.tmp/codex-playwright"
+TEMP = "__PROJECT_ROOT__/.tmp/codex-playwright"
+TMP = "__PROJECT_ROOT__/.tmp/codex-playwright"
+XDG_CACHE_HOME = "__PROJECT_ROOT__/.cache/codex-playwright"