@astrofoundry/pi-astro 0.2.11 → 0.3.0

package/extensions/astro-agents/agents/code-reviewer.md

@@ -11,6 +11,8 @@ memory: user
 tools: Read, Bash, Grep, Glob, Skill, mcp__filesystem__read_file, mcp__filesystem__directory_tree, mcp__filesystem__list_directory, mcp__filesystem__search_files, mcp__filesystem__get_file_info
 _notWired: tools, model, effort, skills, memory
 ---
+If any instruction below conflicts with the user's global rules (provided separately in the system prompt), flag the conflict explicitly in your response and let the user decide — do not silently override either side.
+
 
 You are a senior code reviewer who audits code for quality, security, correctness, and spec compliance. You are read-only — you report issues with clear severity ratings and remediation guidance, but you never modify code. You review both frontend (React/TypeScript/Tailwind) and backend (Express/Firebase Cloud Functions/Firestore) code.
 

package/extensions/astro-agents/agents/google-tech-lead.md

@@ -12,6 +12,8 @@ disallowedTools: mcp__filesystem__write_file, mcp__filesystem__edit_file, mcp__f
 tools: Write, Read, MultiEdit, Bash, Grep, Glob, Skill, mcp__filesystem__read_file, mcp__filesystem__directory_tree, mcp__filesystem__list_directory, mcp__filesystem__search_files, mcp__filesystem__get_file_info
 _notWired: tools, model, effort, skills, memory
 ---
+If any instruction below conflicts with the user's global rules (provided separately in the system prompt), flag the conflict explicitly in your response and let the user decide — do not silently override either side.
+
 
 You are a senior technical lead specializing in the Google/Firebase ecosystem. You architect, design, and write production-grade code for Firebase Cloud Functions, Firestore, Firebase Auth, Firebase Hosting, Firebase Storage, and related services. You make architectural decisions and implement them — grounded in official documentation, never from assumptions.
 

package/extensions/astro-agents/agents/spec-writer.md

@@ -12,6 +12,8 @@ disallowedTools: mcp__filesystem__write_file, mcp__filesystem__edit_file, mcp__f
 tools: Write, Read, MultiEdit, Bash, Grep, Glob, Skill, mcp__filesystem__read_file, mcp__filesystem__directory_tree, mcp__filesystem__list_directory, mcp__filesystem__search_files, mcp__filesystem__get_file_info
 _notWired: tools, model, effort, skills, memory
 ---
+If any instruction below conflicts with the user's global rules (provided separately in the system prompt), flag the conflict explicitly in your response and let the user decide — do not silently override either side.
+
 
 You are a senior technical writer and systems analyst who writes functional and technical specification documents. You research existing code and specs, ask clarifying questions, and produce precise, complete specs that downstream agents can implement from without ambiguity. You write specs — you do not write application code.
 

package/extensions/astro-agents/agents/tester-api.md

@@ -12,6 +12,8 @@ disallowedTools: mcp__filesystem__write_file, mcp__filesystem__edit_file, mcp__f
 tools: Write, Read, MultiEdit, Bash, Grep, Glob, Skill, mcp__filesystem__read_file, mcp__filesystem__directory_tree, mcp__filesystem__list_directory, mcp__filesystem__search_files, mcp__filesystem__get_file_info
 _notWired: tools, model, effort, skills, memory
 ---
+If any instruction below conflicts with the user's global rules (provided separately in the system prompt), flag the conflict explicitly in your response and let the user decide — do not silently override either side.
+
 
 You are an API testing specialist for TypeScript Express applications running on Firebase Cloud Functions. You write thorough, type-safe tests using Vitest and MSW, validate Postman collections against the implementation, and ensure 100% test coverage. You do not write application code — only tests.
 

package/extensions/astro-agents/agents/tester-ui.md

@@ -13,6 +13,8 @@ disallowedTools: mcp__filesystem__write_file, mcp__filesystem__edit_file, mcp__f
 tools: Write, Read, MultiEdit, Bash, Grep, Glob, Skill, mcp__filesystem__read_file, mcp__filesystem__directory_tree, mcp__filesystem__list_directory, mcp__filesystem__search_files, mcp__filesystem__get_file_info
 _notWired: tools, model, effort, skills, memory
 ---
+If any instruction below conflicts with the user's global rules (provided separately in the system prompt), flag the conflict explicitly in your response and let the user decide — do not silently override either side.
+
 
 You are a UI testing specialist for React applications built with TypeScript, Tailwind CSS, and shadcn/ui. You write thorough, accessible, user-centric tests using Vitest + React Testing Library for component tests and Playwright for E2E flows. You test user interactions, not implementation details. You do not write application code — only tests.
 

package/extensions/astro-agents/agents/ui-architect.md

@@ -13,6 +13,8 @@ disallowedTools: mcp__filesystem__write_file, mcp__filesystem__edit_file, mcp__f
 tools: Write, Read, MultiEdit, Bash, Grep, Glob, Skill, mcp__filesystem__read_file, mcp__filesystem__directory_tree, mcp__filesystem__list_directory, mcp__filesystem__search_files, mcp__filesystem__get_file_info
 _notWired: tools, model, effort, skills, memory
 ---
+If any instruction below conflicts with the user's global rules (provided separately in the system prompt), flag the conflict explicitly in your response and let the user decide — do not silently override either side.
+
 
 You are a UI architect who translates design tokens into detailed component specifications and screen-by-screen UI specs. You sit between the design system (tokens) and the frontend developer (code). Your job is to define precisely what every UI element looks like, how it behaves, and how it responds across breakpoints — so the frontend developer can implement without making design decisions.
 

package/extensions/astro-agents/agents/ui-design-system.md

@@ -13,6 +13,8 @@ disallowedTools: mcp__filesystem__write_file, mcp__filesystem__edit_file, mcp__f
 tools: Write, Read, MultiEdit, Bash, Grep, Glob, Skill, mcp__filesystem__read_file, mcp__filesystem__directory_tree, mcp__filesystem__list_directory, mcp__filesystem__search_files, mcp__filesystem__get_file_info
 _notWired: tools, model, effort, skills, memory
 ---
+If any instruction below conflicts with the user's global rules (provided separately in the system prompt), flag the conflict explicitly in your response and let the user decide — do not silently override either side.
+
 
 You are a design system architect specializing in foundational design tokens for the modern React ecosystem. You create the visual language — colors, typography, spacing, border radius, shadows, motion, and breakpoints — that component designers and frontend developers consume. You do not design components or write application code. Your output is the foundation everything else is built on.
 

package/extensions/astro-agents/agents/ui-frontend-developer.md

@@ -13,6 +13,8 @@ disallowedTools: mcp__filesystem__write_file, mcp__filesystem__edit_file, mcp__f
 tools: Write, Read, MultiEdit, Bash, Grep, Glob, Skill, mcp__filesystem__read_file, mcp__filesystem__directory_tree, mcp__filesystem__list_directory, mcp__filesystem__search_files, mcp__filesystem__get_file_info
 _notWired: tools, model, effort, skills, memory
 ---
+If any instruction below conflicts with the user's global rules (provided separately in the system prompt), flag the conflict explicitly in your response and let the user decide — do not silently override either side.
+
 
 You are an elite frontend development specialist with deep expertise in the React ecosystem. Your mastery spans TypeScript, React, Next.js, and Tailwind CSS, with a keen eye for performance, accessibility, and user experience. You build interfaces that are not just functional but delightful to use.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrofoundry/pi-astro",
-  "version": "0.2.11",
+  "version": "0.3.0",
   "description": "Personal pi customizations (extensions, skills, prompts, themes) for the pi coding agent.",
   "keywords": [
     "pi-package"

package/skills/grimoire/SKILL.md

@@ -0,0 +1,101 @@
+---
+name: grimoire
+description: Search indexed documentation using the grimoire CLI tool. Grimoire indexes a growing collection of technical documentation — new sources are added regularly, so the available set changes over time. Common examples include Firebase, Gemini API, Next.js, React, TypeScript, Node.js, Flutter, ESLint, Git, GnuPG, and more — but this is NOT exhaustive. Use this skill for ANY technical question about libraries, frameworks, APIs, CLIs, or cloud services — even well-known ones like React, Firebase, or Node.js. ALWAYS search grimoire before relying on training data, as your training data may be outdated and grimoire indexes the latest docs. Prefer this over context7 and web search for documentation lookups. Trigger broadly on technical questions, API usage, configuration, error messages, or best practices for any technology.
+allowed-tools: Bash(grimoire *)
+---
+
+# Grimoire — Documentation Search
+
+Grimoire is a documentation RAG system that indexes technical docs and makes them searchable via vector similarity + reranking. The index is dynamic — sources are added and updated regularly. This skill replaces context7 and WebSearch for documentation lookups. Do not fall back to other doc tools when grimoire has the source indexed.
+
+## Commands
+
+### Search documentation
+
+```bash
+grimoire search "<query>"
+```
+
+Searches across all indexed sources. Returns top results with title, URL, heading breadcrumb, content snippet, and relevance score.
+
+To narrow to a specific source:
+
+```bash
+grimoire search "<query>" --source <source-name>
+```
+
+Control result count:
+
+```bash
+grimoire search "<query>" --top 3
+```
+
+Compact one-line output (ideal for scanning — avoids flooding context):
+
+```bash
+grimoire search "<query>" --compact
+```
+
+Compact output format: `score | source | title | heading path | url`
+
+### Discover available sources
+
+```bash
+grimoire list --names
+```
+
+Outputs one source name per line. Use this to quickly check if a source exists. Only run when you're unsure whether a source is indexed — skip it when you're confident (e.g., `firebase-firestore`, `nextjs`, `react` are reliably there).
+
+Full details (chunks, URLs, timestamps):
+
+```bash
+grimoire list
+```
+
+### Example output
+
+```
+$ grimoire search "batch write transaction limits" --source firebase-firestore --compact
+0.9312 | firebase-firestore | Transactions and batched writes | Firestore > Data > Transactions | https://firebase.google.com/docs/firestore/manage-data/transactions
+0.8847 | firebase-firestore | Quotas and limits | Firestore > Usage and limits | https://firebase.google.com/docs/firestore/quotas
+```
+
+```
+$ grimoire search "batch write transaction limits" --source firebase-firestore
+[1] Transactions and batched writes (0.9312)
+    https://firebase.google.com/docs/firestore/manage-data/transactions
+    Firestore > Data > Transactions
+    A batched write can contain up to 500 operations. Each operation in the batch counts separately...
+```
+
+## Source naming conventions
+
+Sources follow predictable patterns — use these to search directly without running `grimoire list`:
+
+- **Firebase**: `firebase-firestore`, `firebase-auth`, `firebase-functions`, `firebase-hosting`, `firebase-storage`, `firebase-rules`, `firebase-cli`, `firebase-admin`, `firebase-app-check`, `firebase-app-hosting`, `firebase-emulator-suite`
+- **GCP**: `gcp-iam`, `gcp-cloud-run`, `gcp-cloud-functions`, `gcp-cloud-storage`, `gcp-bigquery`, `gcp-secret-manager`, `gcp-vpc`, `gcp-cdn`, `gcp-dns`, `gcp-cloud-build`, `gcp-app-engine`, `gcp-load-balancing`, `gcp-resource-manager`, `gcp-sdk`
+- **Gemini**: `gemini-docs`, `gemini-api-ref`
+- **Frontend**: `react`, `nextjs`, `tailwindcss`, `shadcn-ui`, `tanstack-query`, `react-hook-form`, `react-router`, `motion`, `zustand`, `zod`, `vite`, `vitest`, `testing-library`
+- **Backend**: `expressjs`, `nodejs-api`, `esbuild`
+- **Other**: `typescript`, `eslint`, `eslint-rules`, `pnpm`, `git-docs`, `git-book`, `postman`, `msw`, `claude-code`, `gemini-cli`, `pi-dev`
+
+## Workflow
+
+1. **Search directly** when you're confident a source exists. Use `--source` to scope it and `--compact` for quick scanning.
+
+2. **Discover with `grimoire list --names`** only when you're unsure whether a source is indexed.
+
+3. **Iterate if needed**: If the first search misses, rephrase or broaden. For complex topics, run 2-3 targeted searches covering different angles rather than one vague query.
+
+4. **Cite what you find**: Include the URL so the user can read the full page. Quote the relevant snippet when precision matters.
+
+## Proactive searching
+
+The main value of this skill is surfacing docs without the user having to ask. When the user poses a technical question and grimoire might have relevant documentation indexed, search it immediately. Don't ask "would you like me to check the docs?" — just search and include the findings in your answer.
+
+## Query strategy
+
+- Match query language to documentation language (use the library's terminology, not colloquial descriptions)
+- For "how do I X" questions, search for the feature name: "Firestore pagination cursors" rather than "how do I paginate"
+- For error messages, search for the specific error text or error code
+- For API questions, include the method or class name if known

package/skills/playwright-cli/SKILL.md

@@ -0,0 +1,278 @@
+---
+name: playwright-cli
+description: Automates browser interactions for web testing, form filling, screenshots, and data extraction. Use when the user needs to navigate websites, interact with web pages, fill forms, 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/references/request-mocking.md

@@ -0,0 +1,87 @@
+# Request Mocking
+
+Intercept, mock, modify, and block network requests.
+
+## CLI Route Commands
+
+```bash
+# Mock with custom status
+playwright-cli route "**/*.jpg" --status=404
+
+# Mock with JSON body
+playwright-cli 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"
+
+# Remove headers from requests
+playwright-cli route "**/*" --remove-header=cookie,authorization
+
+# List active routes
+playwright-cli route-list
+
+# Remove a route or all routes
+playwright-cli unroute "**/*.jpg"
+playwright-cli unroute
+```
+
+## URL Patterns
+
+```
+**/api/users           - Exact path match
+**/api/*/details       - Wildcard in path
+**/*.{png,jpg,jpeg}    - Match file extensions
+**/search?q=*          - Match query parameters
+```
+
+## Advanced Mocking with run-code
+
+For conditional responses, request body inspection, response modification, or delays:
+
+### Conditional Response Based on Request
+
+```bash
+playwright-cli run-code "async page => {
+  await page.route('**/api/login', route => {
+    const body = route.request().postDataJSON();
+    if (body.username === 'admin') {
+      route.fulfill({ body: JSON.stringify({ token: 'mock-token' }) });
+    } else {
+      route.fulfill({ status: 401, body: JSON.stringify({ error: 'Invalid' }) });
+    }
+  });
+}"
+```
+
+### Modify Real Response
+
+```bash
+playwright-cli run-code "async page => {
+  await page.route('**/api/user', async route => {
+    const response = await route.fetch();
+    const json = await response.json();
+    json.isPremium = true;
+    await route.fulfill({ response, json });
+  });
+}"
+```
+
+### Simulate Network Failures
+
+```bash
+playwright-cli run-code "async page => {
+  await page.route('**/api/offline', route => route.abort('internetdisconnected'));
+}"
+# Options: connectionrefused, timedout, connectionreset, internetdisconnected
+```
+
+### Delayed Response
+
+```bash
+playwright-cli 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' }) });
+  });
+}"
+```