opencastle 0.10.0 → 0.10.2

package/src/orchestrator/plugins/convex/config.ts

@@ -27,7 +27,7 @@ export const config: PluginConfig = {
       'convex/envList', 'convex/envGet', 'convex/logs', 'convex/insights',
     ],
   },
-  docsUrl: null,
+  docsUrl: 'https://www.opencastle.dev/docs/plugins#convex',
   officialDocs: 'https://docs.convex.dev/',
   mcpPackage: 'convex',
 };

package/src/orchestrator/plugins/cypress/SKILL.md

@@ -0,0 +1,145 @@
+---
+name: cypress-testing
+description: "Cypress E2E and component testing patterns, commands, selectors, and CI configuration. Use when writing E2E tests, component tests, or configuring Cypress in CI pipelines."
+---
+
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .github/customizations/ directory instead. -->
+
+# Cypress Testing
+
+Cypress-specific E2E and component testing patterns. For project-specific test configuration and breakpoints, see [testing-config.md](../../customizations/stack/testing-config.md).
+
+## Commands
+
+```bash
+npx cypress open                   # Open interactive test runner
+npx cypress run                    # Run tests headlessly (CI)
+npx cypress run --spec "cypress/e2e/auth/**"  # Run specific specs
+npx cypress run --browser chrome   # Specify browser
+npx cypress run --headed           # Run with visible browser
+npx cypress run --component        # Run component tests only
+npx cypress run --record           # Record to Cypress Cloud
+```
+
+## Test Structure
+
+```
+cypress/
+├── e2e/                     # E2E test specs
+│   ├── auth/
+│   │   ├── login.cy.ts
+│   │   └── signup.cy.ts
+│   └── dashboard/
+│       └── overview.cy.ts
+├── fixtures/                # Test data (JSON)
+│   └── users.json
+├── support/
+│   ├── commands.ts          # Custom commands
+│   ├── e2e.ts               # E2E support file
+│   └── component.ts         # Component test support
+└── downloads/               # Downloaded files during tests
+```
+
+## Writing Tests
+
+### E2E Test Pattern
+
+```typescript
+// cypress/e2e/auth/login.cy.ts
+describe('Login', () => {
+  beforeEach(() => {
+    cy.visit('/login');
+  });
+
+  it('should log in with valid credentials', () => {
+    cy.get('[data-testid="email-input"]').type('user@example.com');
+    cy.get('[data-testid="password-input"]').type('password123');
+    cy.get('[data-testid="login-button"]').click();
+
+    cy.url().should('include', '/dashboard');
+    cy.get('[data-testid="user-menu"]').should('be.visible');
+  });
+
+  it('should show error for invalid credentials', () => {
+    cy.get('[data-testid="email-input"]').type('wrong@example.com');
+    cy.get('[data-testid="password-input"]').type('wrong');
+    cy.get('[data-testid="login-button"]').click();
+
+    cy.get('[data-testid="error-message"]').should('contain', 'Invalid credentials');
+  });
+});
+```
+
+### Custom Commands
+
+```typescript
+// cypress/support/commands.ts
+Cypress.Commands.add('login', (email: string, password: string) => {
+  cy.session([email, password], () => {
+    cy.visit('/login');
+    cy.get('[data-testid="email-input"]').type(email);
+    cy.get('[data-testid="password-input"]').type(password);
+    cy.get('[data-testid="login-button"]').click();
+    cy.url().should('include', '/dashboard');
+  });
+});
+```
+
+## Selector Strategy
+
+Priority order for selecting elements:
+
+1. `data-testid` attributes — most resilient to UI changes
+2. `aria-label` or `role` — accessible and meaningful
+3. Dedicated CSS classes — avoid styling classes
+4. **Never** use tag names, auto-generated classes, or fragile CSS paths
+
+## Best Practices
+
+- Use `cy.intercept()` to stub/spy on API calls — don't depend on backend state
+- Use `cy.session()` for authentication — avoid logging in before every test
+- Avoid `cy.wait(ms)` — use `cy.intercept()` with aliases instead
+- Assert on visible elements — Cypress auto-retries, so assertions are resilient
+- Keep tests independent — each test should set up its own state
+- Use fixtures for test data — avoid hardcoding values in tests
+- Add `data-testid` attributes to components during development, not retroactively
+
+## CI Configuration
+
+```yaml
+# GitHub Actions example
+cypress:
+  runs-on: ubuntu-latest
+  steps:
+    - uses: actions/checkout@v4
+    - uses: cypress-io/github-action@v6
+      with:
+        build: npm run build
+        start: npm run start
+        wait-on: 'http://localhost:3000'
+        browser: chrome
+```
+
+## Configuration (cypress.config.ts)
+
+```typescript
+import { defineConfig } from 'cypress';
+
+export default defineConfig({
+  e2e: {
+    baseUrl: 'http://localhost:3000',
+    viewportWidth: 1280,
+    viewportHeight: 720,
+    video: false,
+    screenshotOnRunFailure: true,
+    defaultCommandTimeout: 10000,
+    retries: { runMode: 2, openMode: 0 },
+  },
+  component: {
+    devServer: {
+      framework: 'next',
+      bundler: 'webpack',
+    },
+  },
+});
+```

package/src/orchestrator/plugins/cypress/config.ts

@@ -0,0 +1,16 @@
+import type { PluginConfig } from '../types.js';
+
+export const config: PluginConfig = {
+  id: 'cypress',
+  name: 'Cypress',
+  category: 'tech',
+  subCategory: 'e2e-testing',
+  label: 'Cypress',
+  hint: 'E2E and component testing in the browser',
+  skillName: 'cypress-testing',
+  authType: 'none',
+  envVars: [],
+  agentToolMap: {},
+  docsUrl: 'https://www.opencastle.dev/docs/plugins#cypress',
+  officialDocs: 'https://docs.cypress.io',
+};

package/src/orchestrator/plugins/figma/SKILL.md

@@ -0,0 +1,85 @@
+---
+name: figma-design
+description: "Figma design-to-code workflows, design token extraction, component inspection, and asset export. Use when translating Figma designs into code, extracting design tokens, or referencing component specs."
+---
+
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .github/customizations/ directory instead. -->
+
+# Figma Design
+
+Figma-specific design-to-code patterns and MCP tool usage. For project-specific design system details, see the **frontend-design** skill.
+
+## MCP Tools
+
+The Figma MCP server enables AI agents to inspect designs directly:
+
+| Tool | Purpose | Primary Agents |
+|------|---------|----------------|
+| `figma/get_file` | Retrieve full Figma file structure | UI/UX Expert |
+| `figma/get_file_nodes` | Get specific nodes/frames | UI/UX Expert, Developer |
+| `figma/get_images` | Export nodes as images | UI/UX Expert |
+| `figma/get_comments` | Read design review comments | UI/UX Expert |
+| `figma/get_styles` | Extract color/text/effect styles | Developer |
+| `figma/get_components` | List reusable components | Developer |
+
+## Design-to-Code Workflow
+
+1. **Identify the frame** — get the Figma file URL or node ID from the task
+2. **Inspect the design** — use `get_file_nodes` to retrieve layout, spacing, colors, typography
+3. **Extract tokens** — map Figma styles to CSS custom properties or design tokens
+4. **Build components** — translate Figma components to React/framework components
+5. **Verify** — compare the implementation against the original design visually
+
+## Design Token Extraction
+
+### From Figma Styles to CSS
+
+```css
+/* Map Figma color styles to CSS custom properties */
+:root {
+  /* Primary */
+  --color-primary-50: #eff6ff;
+  --color-primary-500: #3b82f6;
+  --color-primary-900: #1e3a8a;
+
+  /* Typography (from Figma text styles) */
+  --font-heading: 'Inter', sans-serif;
+  --font-body: 'Inter', sans-serif;
+  --font-size-sm: 0.875rem;    /* 14px */
+  --font-size-base: 1rem;       /* 16px */
+  --font-size-lg: 1.125rem;     /* 18px */
+  --font-size-xl: 1.25rem;      /* 20px */
+
+  /* Spacing (from Figma auto-layout) */
+  --space-xs: 4px;
+  --space-sm: 8px;
+  --space-md: 16px;
+  --space-lg: 24px;
+  --space-xl: 32px;
+}
+```
+
+### Translation Rules
+
+| Figma Concept | Code Equivalent |
+|---------------|----------------|
+| Auto Layout → horizontal | `display: flex; flex-direction: row` |
+| Auto Layout → vertical | `display: flex; flex-direction: column` |
+| Auto Layout gap | `gap: Npx` |
+| Auto Layout padding | `padding: top right bottom left` |
+| Fill → Hug contents | `width: auto` or `width: fit-content` |
+| Fill → Fixed | `width: Npx` |
+| Fill → Fill container | `flex: 1` or `width: 100%` |
+| Corner radius | `border-radius: Npx` |
+| Drop shadow | `box-shadow: x y blur spread color` |
+| Opacity | `opacity: N` |
+
+## Best Practices
+
+- Always extract design tokens systematically — don't hardcode values from visual inspection
+- Use Figma's auto-layout values directly for flex/grid properties
+- Match Figma's responsive breakpoints to the project's breakpoint system
+- Export SVG assets directly from Figma via `get_images` — don't recreate manually
+- Cross-reference Figma component names with the codebase component library
+- When in doubt about values, inspect the Figma node — don't approximate
+- Keep a mapping document between Figma styles and CSS custom properties

package/src/orchestrator/plugins/figma/config.ts

@@ -0,0 +1,32 @@
+import type { PluginConfig } from '../types.js';
+
+export const config: PluginConfig = {
+  id: 'figma',
+  name: 'Figma',
+  category: 'tech',
+  subCategory: 'design',
+  label: 'Figma',
+  hint: 'Design tokens, component specs, asset export',
+  skillName: 'figma-design',
+  mcpServerKey: 'Figma',
+  mcpConfig: {
+    type: 'stdio',
+    command: 'npx',
+    args: ['-y', '@anthropic/figma-mcp@latest'],
+    envFile: '${workspaceFolder}/.env'
+  },
+  authType: 'env-token',
+  envVars: [
+    {
+      name: 'FIGMA_ACCESS_TOKEN',
+      hint: 'Generate at figma.com → Settings → Personal access tokens',
+    },
+  ],
+  agentToolMap: {
+    'ui-ux-expert': ['figma/*'],
+    'developer': ['figma/*'],
+  },
+  docsUrl: 'https://www.opencastle.dev/docs/plugins#figma',
+  officialDocs: 'https://www.figma.com/developers/api',
+  mcpPackage: '@anthropic/figma-mcp',
+};

package/src/orchestrator/plugins/index.ts

@@ -11,6 +11,16 @@ import { config as jira } from './jira/config.js';
 import { config as slack } from './slack/config.js';
 import { config as teams } from './teams/config.js';
 import { config as chromeDevtools } from './chrome-devtools/config.js';
+import { config as netlify } from './netlify/config.js';
+import { config as turborepo } from './turborepo/config.js';
+import { config as prisma } from './prisma/config.js';
+import { config as cypress } from './cypress/config.js';
+import { config as playwright } from './playwright/config.js';
+import { config as vitest } from './vitest/config.js';
+import { config as figma } from './figma/config.js';
+import { config as resend } from './resend/config.js';
+import { config as nextjs } from './nextjs/config.js';
+import { config as astro } from './astro/config.js';
 
 export type { PluginConfig, McpServerConfig, McpInput, EnvVarRequirement } from './types.js';
 
@@ -24,6 +34,16 @@ export const PLUGINS: Record<string, PluginConfig> = {
   vercel,
   nx,
   'chrome-devtools': chromeDevtools,
+  netlify,
+  turborepo,
+  prisma,
+  cypress,
+  playwright,
+  vitest,
+  figma,
+  resend,
+  nextjs,
+  astro,
   linear,
   jira,
   slack,

package/src/orchestrator/plugins/jira/config.ts

@@ -4,7 +4,7 @@ export const config: PluginConfig = {
   id: 'jira',
   name: 'Jira',
   category: 'team',
-  subCategory: 'tracker',
+  subCategory: 'task-management',
   label: 'Jira',
   hint: 'Atlassian issue tracking via Rovo MCP',
   skillName: 'jira-management',
@@ -24,7 +24,6 @@ export const config: PluginConfig = {
       'Jira/getAccessibleAtlassianResources',
     ],
   },
-  docsUrl: null,
+  docsUrl: 'https://www.opencastle.dev/docs/plugins#jira',
   officialDocs: 'https://developer.atlassian.com/cloud/jira/platform/',
-  mcpPackage: null,
 };

package/src/orchestrator/plugins/linear/config.ts

@@ -4,7 +4,7 @@ export const config: PluginConfig = {
   id: 'linear',
   name: 'Linear',
   category: 'team',
-  subCategory: 'tracker',
+  subCategory: 'task-management',
   label: 'Linear',
   hint: 'Issue tracking with MCP integration',
   skillName: 'linear-task-management',
@@ -28,7 +28,7 @@ export const config: PluginConfig = {
       'linear/list_teams', 'linear/list_projects', 'linear/get_issue', 'linear/search_issues',
     ],
   },
-  docsUrl: '/guides/linear-setup',
+  docsUrl: 'https://www.opencastle.dev/guides/linear-setup',
   officialDocs: 'https://linear.app/docs',
   mcpPackage: '@mseep/linear-mcp',
 };

package/src/orchestrator/plugins/netlify/SKILL.md

@@ -0,0 +1,134 @@
+---
+name: netlify-deployment
+description: "Netlify deployment workflows, serverless functions, edge functions, environment management, and build configuration. Use when deploying to Netlify, writing serverless/edge functions, or troubleshooting builds."
+---
+
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .github/customizations/ directory instead. -->
+
+# Netlify Deployment
+
+Netlify-specific deployment patterns and conventions. For project-specific deployment architecture, environment variables, and key files, see [deployment-config.md](../../customizations/stack/deployment-config.md).
+
+## Deployment Model
+
+Netlify uses Git-based continuous deployment:
+
+```
+main branch    → Production deployment (auto)
+feature/*      → Deploy preview (auto, unique URL)
+fix/*          → Deploy preview (auto, unique URL)
+```
+
+- Every push triggers a build — no manual deploys needed
+- Deploy previews get unique URLs for PR-based testing
+- Instant rollback to any previous deploy from the dashboard
+- Branch deploys can be configured for specific branches beyond `main`
+
+## Build Configuration (netlify.toml)
+
+```toml
+[build]
+  command = "npm run build"
+  publish = "dist"              # or ".next", "out", "build"
+
+[build.environment]
+  NODE_VERSION = "20"
+
+[[redirects]]
+  from = "/*"
+  to = "/index.html"
+  status = 200
+  conditions = {Role = ["admin"]}
+
+[[headers]]
+  for = "/*"
+  [headers.values]
+    X-Frame-Options = "DENY"
+    X-Content-Type-Options = "nosniff"
+    Referrer-Policy = "strict-origin-when-cross-origin"
+```
+
+## Serverless Functions
+
+Place functions in `netlify/functions/`:
+
+```typescript
+// netlify/functions/hello.ts
+import type { Handler } from '@netlify/functions';
+
+export const handler: Handler = async (event) => {
+  return {
+    statusCode: 200,
+    body: JSON.stringify({ message: 'Hello from Netlify Functions' }),
+  };
+};
+```
+
+- Functions are available at `/.netlify/functions/<name>`
+- Supports TypeScript out of the box
+- Default timeout: 10s (extendable to 26s on Pro)
+- Use background functions for long-running tasks (up to 15 min)
+
+## Edge Functions
+
+Place edge functions in `netlify/edge-functions/`:
+
+```typescript
+// netlify/edge-functions/geolocation.ts
+import type { Context } from '@netlify/edge-functions';
+
+export default async (request: Request, context: Context) => {
+  const { country } = context.geo;
+  return new Response(`You're visiting from ${country}`);
+};
+
+export const config = { path: '/geo' };
+```
+
+- Run at the CDN edge, sub-millisecond cold starts
+- Use for personalization, A/B testing, geo-routing
+- Deno runtime (not Node.js)
+
+## Environment Variables
+
+### Scoping
+
+| Scope | When Applied | Use For |
+|-------|-------------|---------|
+| **Production** | `main` deploys | Live secrets, production API keys |
+| **Deploy previews** | All PR/branch builds | Staging/test API keys |
+| **Branch deploy** | Specific branch deploys | Branch-specific overrides |
+| **Local** | `netlify dev` | Local development |
+
+### Best Practices
+
+- Set secrets via Netlify UI or CLI (`netlify env:set`) — never commit them
+- Use `netlify dev` to run locally with injected env vars
+- Validate required vars at build time in `netlify.toml`
+
+## Scheduled Functions (Cron)
+
+```typescript
+// netlify/functions/daily-task.ts
+import type { Handler } from '@netlify/functions';
+
+export const handler: Handler = async () => {
+  // Run daily task
+  return { statusCode: 200, body: 'OK' };
+};
+
+export const config = {
+  schedule: '0 0 * * *', // Daily at midnight UTC
+};
+```
+
+## Build Troubleshooting
+
+1. **Check build logs** — Netlify UI → Deploys → click failed deploy
+2. **Common causes:**
+   - Missing environment variables
+   - Node.js version mismatch (set in `netlify.toml` or `.node-version`)
+   - Build command or publish directory mismatch
+   - Dependency install failures (check lockfile)
+3. **Local debugging** — run `netlify build` locally to reproduce
+4. **Clear cache** — Netlify UI → Deploys → Trigger deploy → Clear cache and deploy

package/src/orchestrator/plugins/netlify/config.ts

@@ -0,0 +1,31 @@
+import type { PluginConfig } from '../types.js';
+
+export const config: PluginConfig = {
+  id: 'netlify',
+  name: 'Netlify',
+  category: 'tech',
+  subCategory: 'deployment',
+  label: 'Netlify',
+  hint: 'Deployment, serverless functions, edge config',
+  skillName: 'netlify-deployment',
+  mcpServerKey: 'Netlify',
+  mcpConfig: {
+    type: 'stdio',
+    command: 'npx',
+    args: ['-y', 'netlify-mcp@latest'],
+  },
+  authType: 'env-token',
+  envVars: [
+    {
+      name: 'NETLIFY_AUTH_TOKEN',
+      hint: 'Generate at app.netlify.com → User Settings → Applications → Personal access tokens',
+    },
+  ],
+  agentToolMap: {
+    'devops-expert': ['netlify/*'],
+    'release-manager': ['netlify/*'],
+  },
+  docsUrl: 'https://www.opencastle.dev/docs/plugins#netlify',
+  officialDocs: 'https://docs.netlify.com',
+  mcpPackage: 'netlify-mcp',
+};