@cubis/foundry 0.3.10

package/Ai Agent Workflow/workflows/agent-environment-setup/platforms/cursor/skills/playwright-expert/references/page-object-model.md

@@ -0,0 +1,152 @@
+# Page Object Model
+
+## Basic Page Object
+
+```typescript
+// pages/LoginPage.ts
+import { Page, Locator } from '@playwright/test';
+
+export class LoginPage {
+  readonly page: Page;
+  readonly emailInput: Locator;
+  readonly passwordInput: Locator;
+  readonly submitButton: Locator;
+  readonly errorMessage: Locator;
+
+  constructor(page: Page) {
+    this.page = page;
+    this.emailInput = page.getByLabel('Email');
+    this.passwordInput = page.getByLabel('Password');
+    this.submitButton = page.getByRole('button', { name: 'Log in' });
+    this.errorMessage = page.getByRole('alert');
+  }
+
+  async goto() {
+    await this.page.goto('/login');
+  }
+
+  async login(email: string, password: string) {
+    await this.emailInput.fill(email);
+    await this.passwordInput.fill(password);
+    await this.submitButton.click();
+  }
+
+  async getErrorMessage() {
+    return this.errorMessage.textContent();
+  }
+}
+```
+
+## Using Page Objects in Tests
+
+```typescript
+// tests/login.spec.ts
+import { test, expect } from '@playwright/test';
+import { LoginPage } from '../pages/LoginPage';
+
+test('successful login redirects to dashboard', async ({ page }) => {
+  const loginPage = new LoginPage(page);
+
+  await loginPage.goto();
+  await loginPage.login('user@test.com', 'password123');
+
+  await expect(page).toHaveURL(/dashboard/);
+});
+
+test('invalid credentials show error', async ({ page }) => {
+  const loginPage = new LoginPage(page);
+
+  await loginPage.goto();
+  await loginPage.login('user@test.com', 'wrongpassword');
+
+  await expect(loginPage.errorMessage).toBeVisible();
+});
+```
+
+## Custom Fixtures
+
+```typescript
+// fixtures.ts
+import { test as base } from '@playwright/test';
+import { LoginPage } from './pages/LoginPage';
+import { DashboardPage } from './pages/DashboardPage';
+
+type Fixtures = {
+  loginPage: LoginPage;
+  dashboardPage: DashboardPage;
+  authenticatedPage: Page;
+};
+
+export const test = base.extend<Fixtures>({
+  loginPage: async ({ page }, use) => {
+    await use(new LoginPage(page));
+  },
+
+  dashboardPage: async ({ page }, use) => {
+    await use(new DashboardPage(page));
+  },
+
+  authenticatedPage: async ({ page }, use) => {
+    const loginPage = new LoginPage(page);
+    await loginPage.goto();
+    await loginPage.login('user@test.com', 'password123');
+    await page.waitForURL(/dashboard/);
+    await use(page);
+  },
+});
+
+export { expect } from '@playwright/test';
+```
+
+## Using Fixtures
+
+```typescript
+// tests/dashboard.spec.ts
+import { test, expect } from '../fixtures';
+
+test('shows user profile', async ({ authenticatedPage, dashboardPage }) => {
+  await expect(dashboardPage.userProfile).toBeVisible();
+});
+```
+
+## Component Page Objects
+
+```typescript
+// components/NavBar.ts
+export class NavBar {
+  constructor(private page: Page) {}
+
+  readonly homeLink = () => this.page.getByRole('link', { name: 'Home' });
+  readonly profileLink = () => this.page.getByRole('link', { name: 'Profile' });
+  readonly logoutButton = () => this.page.getByRole('button', { name: 'Logout' });
+
+  async logout() {
+    await this.logoutButton().click();
+  }
+}
+
+// pages/DashboardPage.ts
+export class DashboardPage {
+  readonly navBar: NavBar;
+
+  constructor(private page: Page) {
+    this.navBar = new NavBar(page);
+  }
+}
+```
+
+## Quick Reference
+
+| Pattern | Purpose |
+|---------|---------|
+| Page Object | Encapsulate page interactions |
+| Fixture | Share setup across tests |
+| Component PO | Reusable UI components |
+| Locator methods | Lazy evaluation |
+
+| Best Practice | Reason |
+|---------------|--------|
+| Methods for actions | Readable tests |
+| Locators as getters | Lazy evaluation |
+| No assertions in PO | Flexibility |
+| Fixtures for setup | DRY, maintainable |

package/Ai Agent Workflow/workflows/agent-environment-setup/platforms/cursor/skills/playwright-expert/references/selectors-locators.md

@@ -0,0 +1,119 @@
+# Selectors & Locators
+
+## Selector Priority (Best to Worst)
+
+```typescript
+// 1. Role-based (BEST - accessible)
+await page.getByRole('button', { name: 'Submit' });
+await page.getByRole('textbox', { name: 'Email' });
+await page.getByRole('link', { name: 'Home' });
+await page.getByRole('heading', { level: 1 });
+
+// 2. Label/placeholder (good for forms)
+await page.getByLabel('Email address');
+await page.getByPlaceholder('Enter your email');
+
+// 3. Test ID (good for non-semantic elements)
+await page.getByTestId('user-avatar');
+await page.getByTestId('submit-button');
+
+// 4. Text content
+await page.getByText('Welcome back');
+await page.getByText(/welcome/i);  // Case insensitive
+
+// 5. CSS/XPath (AVOID - brittle)
+await page.locator('.submit-btn');  // Last resort
+await page.locator('#email-input');
+```
+
+## Role-Based Selectors
+
+```typescript
+// Buttons
+page.getByRole('button', { name: 'Submit' });
+page.getByRole('button', { name: /save/i });
+
+// Links
+page.getByRole('link', { name: 'Documentation' });
+
+// Inputs
+page.getByRole('textbox', { name: 'Username' });
+page.getByRole('checkbox', { name: 'Remember me' });
+page.getByRole('combobox', { name: 'Country' });
+
+// Navigation
+page.getByRole('navigation');
+page.getByRole('main');
+page.getByRole('banner');
+
+// Tables
+page.getByRole('row', { name: 'John Doe' });
+page.getByRole('cell', { name: 'Active' });
+```
+
+## Filtering Locators
+
+```typescript
+// Filter by text
+page.getByRole('listitem').filter({ hasText: 'Product A' });
+
+// Filter by child locator
+page.getByRole('listitem').filter({
+  has: page.getByRole('button', { name: 'Delete' })
+});
+
+// Filter by NOT having
+page.getByRole('listitem').filter({
+  hasNot: page.getByText('Sold out')
+});
+
+// Chain locators
+page.getByTestId('product-card').getByRole('button', { name: 'Buy' });
+```
+
+## Handling Multiple Elements
+
+```typescript
+// Get nth element (0-indexed)
+page.getByRole('listitem').nth(0);
+page.getByRole('listitem').first();
+page.getByRole('listitem').last();
+
+// Count elements
+const count = await page.getByRole('listitem').count();
+
+// Iterate
+for (const item of await page.getByRole('listitem').all()) {
+  console.log(await item.textContent());
+}
+```
+
+## Test IDs
+
+```html
+<!-- Add in HTML -->
+<button data-testid="submit-button">Submit</button>
+```
+
+```typescript
+// Configure custom attribute
+// playwright.config.ts
+use: {
+  testIdAttribute: 'data-test-id'
+}
+
+// Use in tests
+page.getByTestId('submit-button');
+```
+
+## Quick Reference
+
+| Locator | Best For |
+|---------|----------|
+| `getByRole()` | Buttons, links, inputs |
+| `getByLabel()` | Form fields |
+| `getByPlaceholder()` | Inputs without labels |
+| `getByTestId()` | Non-semantic elements |
+| `getByText()` | Static text |
+| `filter()` | Narrowing results |
+| `nth()` / `first()` | Multiple matches |

package/Ai Agent Workflow/workflows/agent-environment-setup/platforms/cursor/skills/postgres-pro/SKILL.md

@@ -0,0 +1,87 @@
+---
+name: postgres-pro
+description: "Use for PostgreSQL-specific internals and operations: EXPLAIN ANALYZE, JSONB/index types, replication, extensions, VACUUM/autovacuum, and pg_stat monitoring."
+license: MIT
+metadata:
+  author: https://github.com/Jeffallan
+  version: "1.0.0"
+  domain: infrastructure
+  triggers: PostgreSQL, Postgres, EXPLAIN ANALYZE, pg_stat, JSONB, streaming replication, logical replication, VACUUM, PostGIS, pgvector
+  role: specialist
+  scope: implementation
+  output-format: code
+  related-skills: database-optimizer, devops-engineer, sre-engineer
+---
+
+# PostgreSQL Pro
+
+Senior PostgreSQL expert with deep expertise in database administration, performance optimization, and advanced PostgreSQL features.
+
+## Role Definition
+
+You are a senior PostgreSQL DBA with 10+ years of production experience. You specialize in query optimization, replication strategies, JSONB operations, extension usage, and database maintenance. You build reliable, high-performance PostgreSQL systems that scale.
+
+## When to Use This Skill
+
+- Analyzing and optimizing slow queries with EXPLAIN
+- Implementing JSONB storage and indexing strategies
+- Setting up streaming or logical replication
+- Configuring and using PostgreSQL extensions
+- Tuning VACUUM, ANALYZE, and autovacuum
+- Monitoring database health with pg_stat views
+- Designing indexes for optimal performance
+
+## Core Workflow
+
+1. **Analyze performance** - Use EXPLAIN ANALYZE, pg_stat_statements
+2. **Design indexes** - B-tree, GIN, GiST, BRIN based on workload
+3. **Optimize queries** - Rewrite inefficient queries, update statistics
+4. **Setup replication** - Streaming or logical based on requirements
+5. **Monitor and maintain** - VACUUM, ANALYZE, bloat tracking
+
+## Reference Guide
+
+Load detailed guidance based on context:
+
+| Topic | Reference | Load When |
+|-------|-----------|-----------|
+| Performance | `references/performance.md` | EXPLAIN ANALYZE, indexes, statistics, query tuning |
+| JSONB | `references/jsonb.md` | JSONB operators, indexing, GIN indexes, containment |
+| Extensions | `references/extensions.md` | PostGIS, pg_trgm, pgvector, uuid-ossp, pg_stat_statements |
+| Replication | `references/replication.md` | Streaming replication, logical replication, failover |
+| Maintenance | `references/maintenance.md` | VACUUM, ANALYZE, pg_stat views, monitoring, bloat |
+
+## Constraints
+
+### MUST DO
+- Use EXPLAIN ANALYZE for query optimization
+- Create appropriate indexes (B-tree, GIN, GiST, BRIN)
+- Update statistics with ANALYZE after bulk changes
+- Monitor autovacuum and tune if needed
+- Use connection pooling (pgBouncer, pgPool)
+- Setup replication for high availability
+- Monitor with pg_stat_statements, pg_stat_user_tables
+- Use prepared statements to prevent SQL injection
+
+### MUST NOT DO
+- Disable autovacuum globally
+- Create indexes without analyzing query patterns
+- Use SELECT * in production queries
+- Ignore replication lag monitoring
+- Skip VACUUM on high-churn tables
+- Use text for UUID storage (use uuid type)
+- Store large BLOBs in database (use object storage)
+- Ignore pg_stat_statements warnings
+
+## Output Templates
+
+When implementing PostgreSQL solutions, provide:
+1. Query with EXPLAIN ANALYZE output
+2. Index definitions with rationale
+3. Configuration changes with before/after values
+4. Monitoring queries for ongoing health checks
+5. Brief explanation of performance impact
+
+## Knowledge Reference
+
+PostgreSQL 12-16, EXPLAIN ANALYZE, B-tree/GIN/GiST/BRIN indexes, JSONB operators, streaming replication, logical replication, VACUUM/ANALYZE, pg_stat views, PostGIS, pgvector, pg_trgm, WAL archiving, PITR