create-hq 5.1.0 → 5.2.0

package/template/workers/dev-team/database-dev/src/mcp-server.ts

@@ -1,76 +0,0 @@
-#!/usr/bin/env node
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
-
-const server = new Server(
-  { name: 'database-dev', version: '1.0.0' },
-  { capabilities: { tools: {} } }
-);
-
-server.setRequestHandler(ListToolsRequestSchema, async () => ({
-  tools: [
-    {
-      name: 'create_schema',
-      description: 'Design database schema for feature',
-      inputSchema: {
-        type: 'object',
-        properties: {
-          entity: { type: 'string', description: 'Entity name' },
-          feature: { type: 'string', description: 'Feature description' },
-          repo: { type: 'string', description: 'Target repository' },
-          orm: { type: 'string', enum: ['prisma', 'drizzle'], description: 'ORM type' },
-        },
-      },
-    },
-    {
-      name: 'create_migration',
-      description: 'Create database migration',
-      inputSchema: {
-        type: 'object',
-        properties: {
-          name: { type: 'string', description: 'Migration name' },
-          repo: { type: 'string', description: 'Target repository' },
-        },
-        required: ['name'],
-      },
-    },
-    {
-      name: 'optimize_query',
-      description: 'Optimize slow query',
-      inputSchema: {
-        type: 'object',
-        properties: {
-          query: { type: 'string', description: 'Query to optimize' },
-          repo: { type: 'string', description: 'Target repository' },
-        },
-        required: ['query'],
-      },
-    },
-    {
-      name: 'add_indexes',
-      description: 'Add database indexes',
-      inputSchema: {
-        type: 'object',
-        properties: {
-          table: { type: 'string', description: 'Table name' },
-          columns: { type: 'string', description: 'Comma-separated columns' },
-          repo: { type: 'string', description: 'Target repository' },
-        },
-        required: ['table'],
-      },
-    },
-  ],
-}));
-
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-  const { name, arguments: args } = request.params;
-  return { content: [{ type: 'text', text: `Tool ${name} called with: ${JSON.stringify(args)}` }] };
-});
-
-async function main() {
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-}
-
-main().catch(console.error);

package/template/workers/dev-team/database-dev/tsconfig.json

@@ -1,18 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "commonjs",
-    "lib": ["ES2022"],
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true,
-    "declaration": true,
-    "sourceMap": true
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}

package/template/workers/dev-team/database-dev/worker.yaml

@@ -1,90 +0,0 @@
-worker:
-  id: database-dev
-  name: "Database Developer"
-  type: CodeWorker
-  version: "1.0"
-
-execution:
-  mode: on_demand
-  max_runtime: 15m
-  retry_attempts: 1
-
-context:
-  base:
-    - workers/public/dev-team/database-dev/
-    - workers/public/dev-team/database-dev/skills/
-    - knowledge/public/dev-team/patterns/database/
-  dynamic:
-    - pattern: "{target_repo}/prisma/"
-      when: "db.type == 'prisma'"
-    - pattern: "{target_repo}/drizzle/"
-      when: "db.type == 'drizzle'"
-    - pattern: "{target_repo}/migrations/"
-      when: always
-  exclude:
-    - node_modules/
-    - dist/
-    - "*.log"
-
-verification:
-  post_execute:
-    - check: typescript
-      command: npm run typecheck
-    - check: migration
-      command: npm run db:generate
-  approval_required: true
-
-output:
-  destination: workspace/reports/dev-team/
-  format: both
-  naming: "{date}-database-dev-{task}.{ext}"
-
-mcp:
-  server:
-    command: node
-    args:
-      - dist/mcp-server.js
-    cwd: workers/public/dev-team/database-dev
-  tools:
-    - create_schema
-    - create_migration
-    - optimize_query
-    - add_indexes
-
-# State Machine (Loom pattern)
-state_machine:
-  enabled: true
-  max_retries: 1
-  hooks:
-    post_execute:
-      - auto_checkpoint
-      - log_metrics
-    on_error:
-      - log_error
-      - checkpoint_error_state
-
-instructions: |
-  # Database Developer
-
-  Schema design, migrations, and query optimization.
-
-  ## Skills
-
-  | Skill | Description |
-  |-------|-------------|
-  | create-schema | Design database schema for feature |
-  | create-migration | Create database migration |
-  | optimize-query | Optimize slow query |
-  | add-indexes | Add database indexes |
-
-  ## Supported ORMs
-
-  - Prisma
-  - Drizzle
-  - Raw SQL
-
-  ## Human-in-the-loop
-
-  - Approve schema changes
-  - Review migration before running
-  - Confirm destructive operations

package/template/workers/dev-team/frontend-dev/package.json

@@ -1,22 +0,0 @@
-{
-  "name": "@hq/frontend-dev",
-  "version": "1.0.0",
-  "description": "React/Next.js components and pages",
-  "main": "dist/index.js",
-  "bin": { "frontend-dev": "dist/index.js" },
-  "scripts": {
-    "build": "tsc",
-    "typecheck": "tsc --noEmit",
-    "dev": "ts-node src/index.ts",
-    "mcp": "node dist/mcp-server.js"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "commander": "^12.1.0"
-  },
-  "devDependencies": {
-    "@types/node": "^22.10.0",
-    "typescript": "^5.7.2",
-    "ts-node": "^10.9.2"
-  }
-}

package/template/workers/dev-team/frontend-dev/skills/create-component.md

@@ -1,26 +0,0 @@
-# create-component
-
-Create a new React component.
-
-## Arguments
-
-`$ARGUMENTS` = `--name <ComponentName>` (required)
-
-Optional:
-- `--repo <path>` - Target repository
-- `--type <functional|class>` - Component type
-- `--with-test` - Include test file
-
-## Process
-
-1. Analyze existing component patterns
-2. Generate component file
-3. Add TypeScript types
-4. Include accessibility attributes
-5. Add tests if requested
-
-## Output
-
-- `src/components/{Name}/{Name}.tsx`
-- `src/components/{Name}/{Name}.test.tsx` (if --with-test)
-- `src/components/{Name}/index.ts` (barrel export)

package/template/workers/dev-team/frontend-dev/src/index.ts

@@ -1,50 +0,0 @@
-#!/usr/bin/env node
-import { Command } from 'commander';
-
-const program = new Command();
-
-program
-  .name('frontend-dev')
-  .description('React/Next.js components and pages')
-  .version('1.0.0');
-
-program
-  .command('create-component')
-  .description('Create new React component')
-  .requiredOption('--name <name>', 'Component name')
-  .option('--repo <path>', 'Target repository')
-  .option('--type <type>', 'Component type: functional|class')
-  .option('--with-test', 'Include test file')
-  .action(async (options) => {
-    console.log('create-component:', options);
-  });
-
-program
-  .command('create-page')
-  .description('Create new page/route')
-  .requiredOption('--path <path>', 'Page path (e.g., /dashboard)')
-  .option('--repo <path>', 'Target repository')
-  .action(async (options) => {
-    console.log('create-page:', options);
-  });
-
-program
-  .command('fix-ui-bug')
-  .description('Fix frontend bug')
-  .requiredOption('--issue <description>', 'Bug description')
-  .option('--repo <path>', 'Target repository')
-  .action(async (options) => {
-    console.log('fix-ui-bug:', options);
-  });
-
-program
-  .command('add-form')
-  .description('Add form with validation')
-  .requiredOption('--name <name>', 'Form name')
-  .option('--fields <list>', 'Comma-separated field names')
-  .option('--repo <path>', 'Target repository')
-  .action(async (options) => {
-    console.log('add-form:', options);
-  });
-
-program.parse();

package/template/workers/dev-team/frontend-dev/src/mcp-server.ts

@@ -1,77 +0,0 @@
-#!/usr/bin/env node
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
-
-const server = new Server(
-  { name: 'frontend-dev', version: '1.0.0' },
-  { capabilities: { tools: {} } }
-);
-
-server.setRequestHandler(ListToolsRequestSchema, async () => ({
-  tools: [
-    {
-      name: 'create_component',
-      description: 'Create new React component',
-      inputSchema: {
-        type: 'object',
-        properties: {
-          name: { type: 'string', description: 'Component name' },
-          repo: { type: 'string', description: 'Target repository' },
-          type: { type: 'string', enum: ['functional', 'class'], description: 'Component type' },
-          withTest: { type: 'boolean', description: 'Include test file' },
-        },
-        required: ['name'],
-      },
-    },
-    {
-      name: 'create_page',
-      description: 'Create new page/route',
-      inputSchema: {
-        type: 'object',
-        properties: {
-          path: { type: 'string', description: 'Page path' },
-          repo: { type: 'string', description: 'Target repository' },
-        },
-        required: ['path'],
-      },
-    },
-    {
-      name: 'fix_ui_bug',
-      description: 'Fix frontend bug',
-      inputSchema: {
-        type: 'object',
-        properties: {
-          issue: { type: 'string', description: 'Bug description' },
-          repo: { type: 'string', description: 'Target repository' },
-        },
-        required: ['issue'],
-      },
-    },
-    {
-      name: 'add_form',
-      description: 'Add form with validation',
-      inputSchema: {
-        type: 'object',
-        properties: {
-          name: { type: 'string', description: 'Form name' },
-          fields: { type: 'string', description: 'Comma-separated field names' },
-          repo: { type: 'string', description: 'Target repository' },
-        },
-        required: ['name'],
-      },
-    },
-  ],
-}));
-
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-  const { name, arguments: args } = request.params;
-  return { content: [{ type: 'text', text: `Tool ${name} called with: ${JSON.stringify(args)}` }] };
-});
-
-async function main() {
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-}
-
-main().catch(console.error);

package/template/workers/dev-team/frontend-dev/tsconfig.json

@@ -1,18 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "commonjs",
-    "lib": ["ES2022"],
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true,
-    "declaration": true,
-    "sourceMap": true
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}

package/template/workers/dev-team/frontend-dev/worker.yaml

@@ -1,132 +0,0 @@
-worker:
-  id: frontend-dev
-  name: "Frontend Developer"
-  type: CodeWorker
-  version: "1.0"
-
-execution:
-  mode: on_demand
-  max_runtime: 20m
-  retry_attempts: 2
-
-context:
-  base:
-    - workers/dev-team/frontend-dev/
-    - workers/dev-team/frontend-dev/skills/
-    - knowledge/dev-team/patterns/frontend/
-  dynamic:
-    - pattern: "{target_repo}/src/components/"
-      when: always
-    - pattern: "{target_repo}/src/app/"
-      when: always
-  exclude:
-    - node_modules/
-    - dist/
-    - api/
-    - server/
-
-verification:
-  post_execute:
-    - check: typescript
-      command: npm run typecheck
-    - check: lint
-      command: npm run lint
-  approval_required: true
-
-external_skills:
-  # Vercel React Best Practices (https://github.com/vercel-labs/agent-skills)
-  - vercel/react-best-practices  # Full skill set
-  # Key areas:
-  # - Eliminating waterfalls (defer await, parallel fetching, Suspense)
-  # - Bundle optimization (dynamic imports, avoid barrel files)
-  # - Server-side performance (RSC serialization, React.cache)
-  # - Re-render optimization (useMemo patterns, state management)
-  # - Rendering performance (hydration, CSS content-visibility)
-
-output:
-  destination: workspace/reports/dev-team/
-  format: both
-  naming: "{date}-frontend-dev-{task}.{ext}"
-
-mcp:
-  server:
-    command: node
-    args:
-      - dist/mcp-server.js
-    cwd: workers/dev-team/frontend-dev
-  tools:
-    - create_component
-    - create_page
-    - fix_ui_bug
-    - add_form
-
-# State Machine (Loom pattern)
-state_machine:
-  enabled: true
-  max_retries: 1
-  hooks:
-    post_execute:
-      - auto_checkpoint
-      - log_metrics
-    on_error:
-      - log_error
-      - checkpoint_error_state
-
-instructions: |
-  # Frontend Developer
-
-  React/Next.js components and pages.
-
-  ## Skills
-
-  | Skill | Description |
-  |-------|-------------|
-  | create-component | Create new React component |
-  | create-page | Create new page/route |
-  | fix-ui-bug | Fix frontend bug |
-  | add-form | Add form with validation |
-
-  ## Patterns
-
-  - Follow existing component structure
-  - Use TypeScript strict mode
-  - Include accessibility attributes
-  - Add responsive styles
-
-  ## React Best Practices (Vercel)
-
-  CRITICAL - Eliminating Waterfalls:
-  - Defer await until needed (don't await at top of function)
-  - Use Promise.all() for independent operations
-  - Strategic Suspense boundaries
-
-  CRITICAL - Bundle Optimization:
-  - Avoid barrel file imports (import from specific files)
-  - Dynamic imports for heavy components
-  - Preload based on user intent
-
-  HIGH - Server Components:
-  - Minimize serialization at RSC boundaries
-  - Use React.cache() for per-request deduplication
-  - Parallel data fetching with component composition
-
-  MEDIUM - Re-render Optimization:
-  - Don't wrap simple expressions in useMemo
-  - Extract to memoized components for isolation
-  - Use functional setState updates
-  - Use Transitions for non-urgent updates
-
-  ## E2E Requirements
-
-  When working in a project with E2E tests:
-  - Every new or modified page MUST have a corresponding E2E spec in `tests/e2e/pages/`
-  - After adding or modifying specs, run: `npm run generate-manifest`
-  - Commit the updated `tests/e2e/manifest.json` alongside your changes
-  - Run `npm run check-coverage` to verify no routes are uncovered
-  - Test categories: page-load, navigation, forms, components, accessibility, responsive, performance, visual
-
-  ## Human-in-the-loop
-
-  - Approve component design
-  - Review styling approach
-  - Confirm accessibility compliance

package/template/workers/dev-team/infra-dev/package.json

@@ -1,24 +0,0 @@
-{
-  "name": "@hq/infra-dev",
-  "version": "1.0.0",
-  "description": "Infrastructure developer worker - CI/CD, deployment, monitoring",
-  "type": "module",
-  "main": "dist/index.js",
-  "bin": {
-    "infra-dev": "dist/index.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "typecheck": "tsc --noEmit",
-    "start": "node dist/index.js",
-    "mcp": "node dist/mcp-server.js"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "commander": "^12.0.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "typescript": "^5.0.0"
-  }
-}

package/template/workers/dev-team/infra-dev/skills/add-monitoring.md

@@ -1,73 +0,0 @@
-# add-monitoring
-
-Add monitoring and observability to application.
-
-## Arguments
-
-`$ARGUMENTS` = `--repo <path>` (required)
-
-Optional:
-- `--type <metrics|logs|traces|all>` - Monitoring type
-- `--provider <datadog|newrelic|prometheus|otel>` - Monitoring provider
-- `--alerts` - Include alerting rules
-
-## Process
-
-1. Analyze application architecture
-2. Identify key metrics:
-   - Request latency
-   - Error rates
-   - Resource usage
-   - Business metrics
-3. Design instrumentation:
-   - HTTP middleware
-   - Database queries
-   - External API calls
-4. Configure logging:
-   - Structured JSON logs
-   - Log levels
-   - Correlation IDs
-5. Add health checks:
-   - Liveness probe
-   - Readiness probe
-6. Create alerting rules (if --alerts)
-7. Present for human approval
-
-## Output
-
-- Instrumentation code
-- Health check endpoints
-- Alert configuration
-- Dashboard templates (if available)
-
-## OpenTelemetry Setup
-
-```typescript
-import { NodeSDK } from '@opentelemetry/sdk-node';
-import { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node';
-
-const sdk = new NodeSDK({
-  serviceName: 'my-service',
-  instrumentations: [getNodeAutoInstrumentations()],
-});
-
-sdk.start();
-```
-
-## Health Check Pattern
-
-```typescript
-app.get('/health/live', (req, res) => {
-  res.json({ status: 'ok' });
-});
-
-app.get('/health/ready', async (req, res) => {
-  const dbOk = await checkDatabase();
-  const cacheOk = await checkCache();
-  if (dbOk && cacheOk) {
-    res.json({ status: 'ready' });
-  } else {
-    res.status(503).json({ status: 'not ready' });
-  }
-});
-```

package/template/workers/dev-team/infra-dev/skills/configure-deployment.md

@@ -1,80 +0,0 @@
-# configure-deployment
-
-Configure deployment for application.
-
-## Arguments
-
-`$ARGUMENTS` = `--repo <path>` (required)
-
-Optional:
-- `--platform <vercel|railway|fly|aws|gcp>` - Deployment platform
-- `--env <staging|production>` - Target environment
-- `--preview` - Enable preview deployments
-
-## Process
-
-1. Analyze project requirements:
-   - Runtime (Node, Python, Go, etc.)
-   - Environment variables needed
-   - External services (DB, cache, etc.)
-2. Choose deployment strategy:
-   - Blue-green
-   - Rolling
-   - Canary
-3. Configure platform:
-   - vercel.json / fly.toml / railway.json
-   - Environment variable templates
-   - Domain configuration
-4. Set up preview deployments (if --preview)
-5. Configure rollback strategy
-6. Present for human approval
-
-## Output
-
-- Platform configuration file
-- Environment variable template
-- Deployment documentation
-
-## Vercel Config
-
-```json
-{
-  "buildCommand": "npm run build",
-  "outputDirectory": "dist",
-  "framework": null,
-  "regions": ["iad1"],
-  "env": {
-    "DATABASE_URL": "@database-url"
-  }
-}
-```
-
-## Fly.io Config
-
-```toml
-app = "my-app"
-primary_region = "iad"
-
-[build]
-  dockerfile = "Dockerfile"
-
-[http_service]
-  internal_port = 3000
-  force_https = true
-  auto_stop_machines = true
-  auto_start_machines = true
-
-[[services.ports]]
-  handlers = ["http"]
-  port = 80
-
-[[services.ports]]
-  handlers = ["tls", "http"]
-  port = 443
-```
-
-## Human Checkpoints
-
-- Approve deployment configuration
-- Approve environment variables
-- Approve production deployments (always)